Merge branch 'main' into release

Author: sunli829

.github/workflows/release-mcp.yml

@@ -12,4 +12,9 @@ build
 
 
 .DS_Store
-*/.DS_Store
+*/.DS_Store
+*.dylib
+*.so
+*.node
+.venv/
+python/.venv/

.gitignore

@@ -38,6 +38,18 @@ cargo make protoc
 The generated `*.rs` files under `rust/crates/proto/src/` are **auto-generated** — never edit
 them by hand.
 
+## After modifying the Python SDK API (`python/`)
+
+`python/pysrc/longbridge/openapi.pyi` is a **manually maintained** type-stub
+file that provides type hints and docstrings for the native Rust/PyO3 extension
+module. IDEs and type checkers (mypy/pyright) rely on it for autocompletion and
+static analysis.
+
+When you add, remove, or change any `#[pyclass]`/`#[pymethods]` definitions in
+`python/src/`, you **must** update `openapi.pyi` accordingly — keeping
+signatures, type annotations, and docstrings in sync with the Rust
+implementation.
+
 ## After modifying the C SDK (`c/`)
 
 `c/csrc/include/longbridge.h` is **auto-generated** by `cbindgen` during the
@@ -46,3 +58,12 @@ build — never edit it by hand. Rebuild the C crate to update it:
 ```bash
 cargo build -p longbridge-c
 ```
+
+## After any change
+
+Update `CHANGELOG.md` in the workspace root to document notable changes. The
+format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). Add an
+entry under the `[Unreleased]` section in the appropriate subsection (`Added`,
+`Changed`, `Fixed`, `Breaking changes`, etc.). If the `[Unreleased]` section
+does not yet exist, create it at the top of the changelog (above the latest
+versioned block).

AGENTS.md

@@ -4,6 +4,48 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+# [4.0.6]
+
+## Added
+
+- **All languages (Rust, Python, Node.js, Java, C, C++):** Seven new context types covering all major data APIs:
+  - `FundamentalContext` — financial reports, analyst ratings, dividends, EPS forecasts, consensus estimates, valuation (PE/PB/PS), industry valuation, company overview, executives, shareholders, fund holders, corporate actions, investor relations, operating reports, buyback data, stock ratings.
+  - `MarketContext` — market status, broker holding (top/detail/daily), A/H premium (klines/intraday), trade statistics, market anomalies, index constituents.
+  - `CalendarContext` — finance calendar (earnings, dividends, splits, IPOs, macro data, market closures, meetings, mergers).
+  - `PortfolioContext` — exchange rates, P&L analysis (summary/detail/by-market/flows).
+  - `AlertContext` — price alert management (list/add/delete/enable/disable).
+  - `DCAContext` — dollar-cost-averaging plan management (list/create/update/pause/resume/stop/history/stats/check-support/calc-date/set-reminder).
+  - `SharelistContext` — community sharelist management (list/detail/popular/create/delete/add-securities/remove-securities/sort-securities).
+- **All languages:** `QuoteContext` gains `short_positions`, `option_volume`, `option_volume_daily`, and `update_pinned`.
+- **All languages:** `ContentContext` gains `topic_detail`, `list_topic_replies`, and `create_topic_reply`.
+- **Rust:** `Config::header(key, value)` builder method for injecting custom HTTP/WebSocket headers.
+- **All languages (Rust, Python, Node.js, Java, C, C++):** Restore `Config::refresh_access_token` (and `refresh_access_token_blocking` in Rust). Refreshes the access token via the Longbridge token-refresh API. Only available with **Legacy API Key** authentication (`Config::from_apikey`); not supported in OAuth 2.0 mode.
+
+## Changed
+
+- **All languages:** Method parameters now use typed enums instead of raw integers: `DCAFrequency`, `DCAStatus`, `AlertCondition`, `AlertFrequency`, `CalendarCategory`, `FinancialReportKind`, `FinancialReportPeriod`, `BrokerHoldingPeriod`, `AhPremiumPeriod`.
+- **All languages:** Response struct fields are typed enums where applicable: `DcaPlan.status` / `invest_frequency` / `market`, `MarketTimeItem.market`, `FlowItem.direction`, `ProfitSummaryInfo.asset_type`, `InstitutionRatingSummary.recommend`.
+- **All languages:** All SDK responses are fully typed structs — no method returns a raw JSON string.
+- **All languages:** Monetary/numeric fields use `Decimal`/`Option<Decimal>` (Rust) or `BigDecimal` (Java). Non-parseable values such as `""` or `"--"` deserialize as `None`/`null`.
+
+## Fixed
+
+- **Rust:** Fix incorrect cache expiry checks in `QuoteContext`.
+
+# [4.0.6]
+
+## Added
+
+- **All bindings:** `ContentContext` adds two new methods (Rust, Go, C, C++, Java, Python, Node.js):
+  - `my_topics(opts)` — get topics created by the current authenticated user, with optional page/size/topic_type filtering.
+  - `create_topic(opts)` — create a new topic; returns the topic ID (`String`) on success.
+- **All bindings:** New types `OwnedTopic`, `MyTopicsOptions`, and `CreateTopicOptions` to support the above methods.
+- **Python:** Added type stubs (`openapi.pyi`) for `ContentContext`, `AsyncContentContext`, `OwnedTopic`, `TopicReply`, `TopicAuthor`, and `TopicImage`.
+
+## Fixed
+
+- **C++:** `create_topic` callback now correctly yields `std::string` (topic ID) instead of `OwnedTopic`.
+
 # [4.0.5]
 
 ## Changed

CHANGELOG.md

@@ -0,0 +1,69 @@
+# Agent Guidelines
+
+## After modifying Rust code
+
+Run the following commands from the workspace root:
+
+```bash
+cargo clippy --all --all-features
+cargo +nightly fmt --all
+```
+
+> **Note:** `cargo +nightly fmt` may reflow doc comments (e.g. `/// @param …`
+> lines). Do **not** revert those changes — they are intentional formatting
+> output and should be committed as-is.
+
+## After modifying the Node.js SDK (`nodejs/`)
+
+Build the native `.node` binary from the `nodejs/` directory:
+
+```bash
+npm run build:debug
+```
+
+`nodejs/index.d.ts` and `nodejs/index.js` are **auto-generated** by
+`npm run build:debug` — never edit them by hand.
+
+## After updating the proto submodule (`rust/crates/proto/openapi-protobufs/`)
+
+Run the following command from the workspace root to regenerate the Rust proto source files
+(e.g. `rust/crates/proto/src/longbridge.control.v1.rs`,
+`rust/crates/proto/src/longbridge.quote.v1.rs`,
+`rust/crates/proto/src/longbridge.trade.v1.rs`):
+
+```bash
+cargo make protoc
+```
+
+The generated `*.rs` files under `rust/crates/proto/src/` are **auto-generated** — never edit
+them by hand.
+
+## After modifying the Python SDK API (`python/`)
+
+`python/pysrc/longbridge/openapi.pyi` is a **manually maintained** type-stub
+file that provides type hints and docstrings for the native Rust/PyO3 extension
+module. IDEs and type checkers (mypy/pyright) rely on it for autocompletion and
+static analysis.
+
+When you add, remove, or change any `#[pyclass]`/`#[pymethods]` definitions in
+`python/src/`, you **must** update `openapi.pyi` accordingly — keeping
+signatures, type annotations, and docstrings in sync with the Rust
+implementation.
+
+## After modifying the C SDK (`c/`)
+
+`c/csrc/include/longbridge.h` is **auto-generated** by `cbindgen` during the
+build — never edit it by hand. Rebuild the C crate to update it:
+
+```bash
+cargo build -p longbridge-c
+```
+
+## After any change
+
+Update `CHANGELOG.md` in the workspace root to document notable changes. The
+format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). Add an
+entry under the `[Unreleased]` section in the appropriate subsection (`Added`,
+`Changed`, `Fixed`, `Breaking changes`, etc.). If the `[Unreleased]` section
+does not yet exist, create it at the top of the changelog (above the latest
+versioned block).

CLAUDE.md

@@ -1,6 +1,6 @@
 [workspace]
 resolver = "3"
-members = ["rust", "python", "nodejs", "java", "c", "mcp"]
+members = ["rust", "python", "nodejs", "java", "c"]
 
 [workspace.package]
 version = "4.0.5"
@@ -59,12 +59,7 @@ napi = { version = "3.8.3", default-features = false }
 napi-derive = "3.5.2"
 napi-build = "2.3.1"
 chrono = "0.4.41"
-poem-mcpserver = "0.3.1"
-poem-mcpserver-macros = "0.3.1"
 poem = "3.1.12"
-schemars = "1.0.4"
-clap = "4.5.45"
-dotenvy = "0.15.7"
 jni = "0.21.1"
 proc-macro2 = "1.0.101"
 quote = "1.0.40"

Cargo.toml

@@ -23,6 +23,23 @@ Longbridge OpenAPI provides programmatic quote trading interfaces for investors
 | Go                          |                                                                       | https://github.com/longbridge/openapi-go         |
 | [MCP](mcp/README.md)        |                                                                       | An MCP server implementation for Longbridge OpenAPI |
 
+
+## Context Types
+
+| Context | Description |
+|---------|-------------|
+| `QuoteContext` | Real-time quotes, candlesticks, options, warrants, watchlists, push subscriptions |
+| `TradeContext` | Orders, positions, account balance, executions, cash flow |
+| `AssetContext` | Account statement download |
+| `ContentContext` | News, community topics |
+| `FundamentalContext` | Financial reports, analyst ratings, dividends, valuation, company overview, shareholders |
+| `MarketContext` | Market status, broker holdings, A/H premium, trade statistics, anomaly alerts, index constituents |
+| `CalendarContext` | Financial calendar (earnings, dividends, splits, IPOs, macro data, market closures) |
+| `PortfolioContext` | Exchange rates, portfolio P&L analysis |
+| `AlertContext` | Price alert management (add/enable/disable/delete) |
+| `DCAContext` | Dollar-cost averaging plan management |
+| `SharelistContext` | Community sharelist management |
+
 ## Quickstart
 
 Pick a language SDK from the table above and follow its README for install and first request. Full reference docs: https://longbridge.github.io/openapi

README.md

@@ -18,6 +18,7 @@ longbridge.workspace = true
 longbridge-c-macros = { path = "crates/macros" }
 
 rust_decimal = { workspace = true, features = ["maths"] }
+serde_json.workspace = true
 tokio = { workspace = true, features = ["rt-multi-thread"] }
 parking_lot.workspace = true
 time.workspace = true

c/Cargo.toml

@@ -2,6 +2,23 @@
 
 `longbridge` provides an easy-to-use interface for invoking [`Longbridge OpenAPI`](https://open.longbridge.com/en/).
 
+
+## Context Types
+
+| Context | Description |
+|---------|-------------|
+| `QuoteContext` | Real-time quotes, candlesticks, options, warrants, watchlists, push subscriptions |
+| `TradeContext` | Orders, positions, account balance, executions, cash flow |
+| `AssetContext` | Account statement download |
+| `ContentContext` | News, community topics |
+| `FundamentalContext` | Financial reports, analyst ratings, dividends, valuation, company overview, shareholders |
+| `MarketContext` | Market status, broker holdings, A/H premium, trade statistics, anomaly alerts, index constituents |
+| `CalendarContext` | Financial calendar (earnings, dividends, splits, IPOs, macro data, market closures) |
+| `PortfolioContext` | Exchange rates, portfolio P&L analysis |
+| `AlertContext` | Price alert management (add/enable/disable/delete) |
+| `DCAContext` | Dollar-cost averaging plan management |
+| `SharelistContext` | Community sharelist management |
+
 ## Documentation
 
 - SDK docs: https://longbridge.github.io/openapi/c/index.html