intentkit 1.2.10__tar.gz → 1.2.12__tar.gz

{intentkit-1.2.10 → intentkit-1.2.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 1.2.10
+Version: 1.2.12
 Summary: Intent-based AI Agent Platform - Core Package
 Project-URL: Homepage, https://github.com/crestalnetwork/intentkit
 Project-URL: Repository, https://github.com/crestalnetwork/intentkit
@@ -40,6 +40,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: ==3.13.*
 Requires-Dist: aiohttp>=3.11.16
 Requires-Dist: aiosqlite>=0.21.0
+Requires-Dist: akshare>=1.16.0
 Requires-Dist: asyncpg>=0.30.0
 Requires-Dist: aws-secretsmanager-caching>=1.1.3
 Requires-Dist: boto3<2.0.0,>=1.37.23
@@ -54,20 +55,20 @@ Requires-Dist: fastapi>=0.115.8
 Requires-Dist: filetype<2.0.0,>=1.2.0
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: jsonref>=1.1.0
-Requires-Dist: langchain-anthropic>=0.3.12
-Requires-Dist: langchain-community>=0.3.19
-Requires-Dist: langchain-core>=0.3.43
-Requires-Dist: langchain-deepseek>=0.1.4
-Requires-Dist: langchain-google-genai>=3.2.0
-Requires-Dist: langchain-openai>=0.3.8
-Requires-Dist: langchain-openrouter>=0.2.1
-Requires-Dist: langchain-text-splitters>=0.3.8
-Requires-Dist: langchain-xai>=0.2.1
-Requires-Dist: langchain>=0.3.25
-Requires-Dist: langgraph-checkpoint-postgres>=2.0.16
-Requires-Dist: langgraph-checkpoint>=2.0.18
-Requires-Dist: langgraph-prebuilt>=0.6.1
-Requires-Dist: langgraph>=0.6.1
+Requires-Dist: langchain-anthropic<2,>=1.4
+Requires-Dist: langchain-community<1,>=0.4
+Requires-Dist: langchain-core<2,>=1.4
+Requires-Dist: langchain-deepseek<2,>=1.0
+Requires-Dist: langchain-google-genai<5,>=4.2
+Requires-Dist: langchain-openai<2,>=1.2
+Requires-Dist: langchain-openrouter<1,>=0.2.3
+Requires-Dist: langchain-text-splitters<2,>=1.1
+Requires-Dist: langchain-xai<2,>=1.2
+Requires-Dist: langchain<2,>=1.3
+Requires-Dist: langgraph-checkpoint-postgres<4,>=3.1
+Requires-Dist: langgraph-checkpoint<5,>=4.1
+Requires-Dist: langgraph-prebuilt<2,>=1.1
+Requires-Dist: langgraph<2,>=1.2
 Requires-Dist: mcp>=1.0.0
 Requires-Dist: mypy-boto3-s3<2.0.0,>=1.37.24
 Requires-Dist: openai>=1.59.6

{intentkit-1.2.10 → intentkit-1.2.12}/intentkit/__init__.py

@@ -3,7 +3,7 @@
 A powerful platform for building AI agents with blockchain and cryptocurrency capabilities.
 """
 
-__version__ = "1.2.10"
+__version__ = "1.2.12"
 __author__ = "Ruihua"
 __email__ = "ruihua@crestal.network"
 

intentkit-1.2.12/intentkit/abstracts/graph.py

@@ -0,0 +1,108 @@
+from collections.abc import Callable, Sequence
+from enum import Enum
+from typing import Annotated, Any, NotRequired
+
+from langchain.agents import AgentState as BaseAgentState
+from langchain_core.messages import AnyMessage, RemoveMessage
+from langgraph.channels.delta import DeltaChannel
+
+# `_messages_delta_reducer` is upstream's batching-invariant counterpart of
+# `add_messages` for use with `DeltaChannel`. It is private (leading underscore)
+# but is documented in its own docstring with a `DeltaChannel` usage example —
+# treat as semi-public within the `langgraph>=1.2,<2` pin.
+from langgraph.graph.message import (
+    REMOVE_ALL_MESSAGES,
+    _messages_delta_reducer,  # pyright: ignore[reportPrivateUsage]
+)
+from pydantic import BaseModel
+
+from intentkit.models.agent import Agent
+from intentkit.models.chat import AuthorType, ChatMessageAttachment
+
+
+class AgentError(str, Enum):
+    """The error types that can be raised by the agent."""
+
+    INSUFFICIENT_CREDITS = "insufficient_credits"
+
+
+def _messages_reducer(
+    state: list[AnyMessage], writes: Sequence[Any]
+) -> list[AnyMessage]:
+    """Batching-invariant messages reducer for `DeltaChannel`.
+
+    Wraps `_messages_delta_reducer` to add `REMOVE_ALL_MESSAGES` handling,
+    which the upstream batched reducer documents as out-of-scope. Without
+    this wrapper, `SummarizationMiddleware` (which emits
+    `[RemoveMessage(REMOVE_ALL_MESSAGES), summary, ...preserved]`) silently
+    no-ops the reset and the message list grows unbounded.
+
+    Strategy: flatten writes once, find the *last* `REMOVE_ALL_MESSAGES`
+    sentinel. If present, reset state to empty and delegate to the upstream
+    reducer with only the post-sentinel writes — preserves batching
+    invariance (`reduce(reduce(s, A), B) == reduce(s, A+B)`) across all
+    combinations of resets and normal writes.
+    """
+    flat: list[Any] = []
+    for w in writes:
+        if isinstance(w, list):
+            flat.extend(w)
+        else:
+            flat.append(w)
+    last_reset = -1
+    for i, m in enumerate(flat):
+        if isinstance(m, RemoveMessage) and m.id == REMOVE_ALL_MESSAGES:
+            last_reset = i
+    if last_reset >= 0:
+        return _messages_delta_reducer([], [flat[last_reset + 1 :]])
+    return _messages_delta_reducer(state, writes)  # pyright: ignore[reportArgumentType]
+
+
+class AgentState(BaseAgentState[Any]):
+    """The state of the agent.
+
+    `messages` is overridden to use `DeltaChannel` so checkpointing stores
+    incremental writes rather than a full snapshot per step — for long chat
+    threads this turns O(N^2) checkpoint growth into O(N). `_messages_reducer`
+    delegates to the upstream batching-invariant `_messages_delta_reducer`
+    but adds `REMOVE_ALL_MESSAGES` handling so the bundled
+    `SummarizationMiddleware` reset path still works.
+
+    `snapshot_frequency=50` is tuned for chat workloads (a few-to-dozens of
+    steps per thread) rather than the upstream default of 1000 which targets
+    long workflow graphs. 50 caps resume-replay cost at one short reducer
+    pass while keeping snapshot writes rare for typical conversations.
+    """
+
+    messages: Annotated[
+        list[AnyMessage],
+        DeltaChannel(_messages_reducer, snapshot_frequency=50),
+    ]
+    context: dict[str, Any]
+    error: NotRequired[AgentError]
+    step_count: NotRequired[int]
+    __extra__: NotRequired[dict[str, Any]]
+
+
+class AgentContext(BaseModel):
+    agent_id: str
+    get_agent: Callable[[], Agent]
+    chat_id: str
+    user_id: str | None = None
+    team_id: str | None = None
+    app_id: str | None = None
+    entrypoint: AuthorType
+    is_private: bool
+    thinking: bool = False
+    payer: str | None = None
+    start_message_id: str = ""
+    start_message_attachments: list[ChatMessageAttachment] | None = None
+    call_depth: int = 0
+
+    @property
+    def agent(self) -> Agent:
+        return self.get_agent()
+
+    @property
+    def thread_id(self) -> str:
+        return f"{self.agent_id}-{self.chat_id}"

{intentkit-1.2.10 → intentkit-1.2.12}/intentkit/core/executor.py

@@ -88,6 +88,7 @@ async def build_executor(
         TodoListMiddleware,
         ToolRetryMiddleware,
     )
+    from langchain_anthropic.middleware import AnthropicPromptCachingMiddleware
 
     from intentkit.core.middleware import (
         DynamicPromptMiddleware,
@@ -257,6 +258,11 @@ async def build_executor(
         ModelRetryMiddleware(),
     ]
 
+    # Anthropic prompt caching: 5m ephemeral cache slashes input-token cost on
+    # long system prompts + repeated history. No-op for non-Anthropic providers.
+    if model_provider == LLMProvider.ANTHROPIC_COMPATIBLE:
+        middleware.append(AnthropicPromptCachingMiddleware())
+
     if agent.enable_todo:
         middleware.append(TodoListMiddleware())
 

{intentkit-1.2.10 → intentkit-1.2.12}/intentkit/core/manager/engine.py

@@ -28,6 +28,7 @@ from intentkit.core.manager.skills import (
 from intentkit.models.agent import Agent
 from intentkit.models.agent_data import AgentData
 from intentkit.models.chat import ChatMessage, ChatMessageCreate
+from intentkit.models.llm_picker import pick_default_model
 
 logger = logging.getLogger(__name__)
 
@@ -141,7 +142,7 @@ def _build_manager_agent(agent_id: str, user_id: str) -> Agent:
             "5. When updating a draft, try to select the right skills. Don't pick too many, just enough to meet user needs.\n"
             "6. Update skill is override update, you must put the whole fields to input data, not only changed fields."
         ),
-        "model": "grok-code-fast-1",
+        "model": pick_default_model(),
         "prompt": prompt,
         "prompt_append": None,
         "temperature": 0.2,

{intentkit-1.2.10 → intentkit-1.2.12}/intentkit/models/llm.csv

@@ -30,10 +30,8 @@ deepseek-v4-flash,Deepseek V4 Flash,deepseek,TRUE,0.14,0.028,0.28,1,1048576,3200
 deepseek/deepseek-v4-flash,Deepseek V4 Flash,openrouter,TRUE,0.14,0.028,0.28,1,1048576,32000,4,4,FALSE,FALSE,FALSE,FALSE,none,TRUE,TRUE,TRUE,300
 deepseek-v4-pro,Deepseek V4 Pro,deepseek,TRUE,1.74,0.145,3.48,3,1048576,64000,5,2,FALSE,FALSE,FALSE,FALSE,high,TRUE,TRUE,TRUE,300
 deepseek/deepseek-v4-pro,Deepseek V4 Pro,openrouter,TRUE,1.74,0.145,3.48,3,1048576,64000,5,2,FALSE,FALSE,FALSE,FALSE,high,TRUE,TRUE,TRUE,300
-grok-4.20-0309-reasoning,Grok 4.20,xai,TRUE,2,0.2,6,3,2000000,4096,5,3,TRUE,FALSE,FALSE,TRUE,high,TRUE,FALSE,FALSE,180
-x-ai/grok-4.20,Grok 4.20,openrouter,TRUE,2,0.2,6,3,2000000,4096,5,3,TRUE,FALSE,FALSE,TRUE,high,TRUE,TRUE,TRUE,180
-grok-4-1-fast-non-reasoning,Grok 4.1 Fast,xai,TRUE,0.2,0.05,0.5,2,2000000,4096,3,4,TRUE,FALSE,FALSE,TRUE,none,TRUE,FALSE,FALSE,180
-x-ai/grok-4.1-fast,Grok 4.1 Fast,openrouter,TRUE,0.2,0.05,0.5,2,2000000,4096,3,4,TRUE,FALSE,FALSE,TRUE,none,TRUE,TRUE,TRUE,180
-grok-4-1-fast-reasoning,Grok 4.1 Fast Reasoning,xai,TRUE,0.2,0.05,0.5,2,2000000,4096,3,4,TRUE,FALSE,FALSE,TRUE,high,TRUE,FALSE,FALSE,180
-x-ai/grok-4.1-fast-reasoning,Grok 4.1 Fast Reasoning,openrouter,TRUE,0.2,0.05,0.5,2,2000000,4096,3,4,TRUE,FALSE,FALSE,TRUE,high,TRUE,TRUE,TRUE,180
+grok-4.3,Grok 4.3,xai,TRUE,1.25,0.125,2.5,2,1000000,128000,5,4,TRUE,FALSE,FALSE,TRUE,high,TRUE,FALSE,FALSE,180
+x-ai/grok-4.3,Grok 4.3,openrouter,TRUE,1.25,0.125,2.5,2,1000000,128000,5,4,TRUE,FALSE,FALSE,TRUE,high,TRUE,TRUE,TRUE,180
+grok-4.20-non-reasoning,Grok 4.20,xai,TRUE,1.25,0.125,2.5,2,2000000,128000,4,4,TRUE,FALSE,FALSE,TRUE,none,TRUE,FALSE,FALSE,180
+x-ai/grok-4.20,Grok 4.20,openrouter,TRUE,1.25,0.125,2.5,2,2000000,128000,4,4,TRUE,FALSE,FALSE,TRUE,none,TRUE,TRUE,TRUE,180
 MiniMax-M2.7,MiniMax M2.7,minimax,TRUE,0.1,0.01,0.4,1,204800,131072,5,3,FALSE,FALSE,FALSE,FALSE,high,TRUE,TRUE,TRUE,300

{intentkit-1.2.10 → intentkit-1.2.12}/intentkit/models/llm_picker.py

@@ -14,7 +14,7 @@ def pick_summarize_model() -> str:
         ("gemini-3.1-flash-lite-preview", LLMProvider.GOOGLE),
         ("deepseek/deepseek-v4-flash", LLMProvider.OPENROUTER),
         ("gpt-5.4-mini", LLMProvider.OPENAI),
-        ("grok-4-1-fast-non-reasoning", LLMProvider.XAI),
+        ("grok-4.20-non-reasoning", LLMProvider.XAI),
         ("deepseek-v4-flash", LLMProvider.DEEPSEEK),
         ("MiniMax-M2.7", LLMProvider.MINIMAX),
         ("mimo-v2.5", LLMProvider.MIMO_PLAN),
@@ -51,7 +51,7 @@ def pick_default_model() -> str:
         ("MiniMax-M2.7", LLMProvider.MINIMAX),
         ("minimax/minimax-m2.7", LLMProvider.OPENROUTER),
         ("gpt-5.4-mini", LLMProvider.OPENAI),
-        ("grok-4-1-fast-non-reasoning", LLMProvider.XAI),
+        ("grok-4.20-non-reasoning", LLMProvider.XAI),
         ("deepseek-v4-flash", LLMProvider.DEEPSEEK),
         ("mimo-v2.5", LLMProvider.MIMO_PLAN),
     ]
@@ -106,7 +106,7 @@ def pick_long_context_model() -> str:
     # Priority order based on cost (cheapest first), one per provider:
     order: list[tuple[str, LLMProvider]] = [
         ("gemini-3.1-flash-lite-preview", LLMProvider.GOOGLE),
-        ("grok-4-1-fast-non-reasoning", LLMProvider.XAI),
+        ("grok-4.20-non-reasoning", LLMProvider.XAI),
         ("deepseek/deepseek-v4-flash", LLMProvider.OPENROUTER),
         ("gpt-5.4-nano", LLMProvider.OPENAI),
         ("deepseek-v4-flash", LLMProvider.DEEPSEEK),

intentkit-1.2.12/intentkit/skills/cn_stock/README.md

@@ -0,0 +1,34 @@
+# cn_stock — China A-Share Market Data
+
+Skill package providing real-time and historical market data for Chinese A-shares
+(Shanghai / Shenzhen / Beijing exchanges), backed by [akshare](https://akshare.akfamily.xyz/).
+
+## Tools
+
+| Skill | Purpose |
+|---|---|
+| `get_quote` | Real-time spot quote for one or more A-shares (price, change %, volume, P/E, P/B, market cap). |
+| `get_kline` | Daily / weekly / monthly OHLCV bars for a single A-share, with forward/back adjustment. |
+| `get_index` | Spot value (and optional 30-day history) for major Chinese stock indices (上证, 深证, 创业板, 沪深300, ...). |
+| `get_board` | Industry / concept board snapshot ranked by intraday % change. |
+| `get_capital_flow` | Net capital inflow/outflow for an individual stock or the whole market. |
+| `get_news` | Recent news for a specific A-share, or top macro financial headlines. |
+| `get_announcement` | Listed-company announcements (公告) for a given trading day. |
+| `get_financials` | Key financial metrics (EPS, ROE, revenue, margins) by reporting period. |
+| `is_trading_day` | Whether a given calendar date is an A-share trading day. Always call at the start of a scheduled task — cron triggers do not skip holidays. |
+
+## Operational notes
+
+- All akshare calls are blocking; the base class wraps them in `asyncio.to_thread`.
+- Results are short-TTL cached in Redis (5–60s for live quotes, longer for kline/financials)
+  to absorb retry storms — akshare scrapes free public endpoints which rate-limit by IP.
+- A category-level global rate limit of 60 calls/min protects shared infrastructure.
+- Stock codes are normalized: accepts `600519`, `sh600519`, `SH600519`, `600519.SH`.
+- Symbols not yet listed or recently delisted may return empty data; tools raise
+  `ToolException` with a clear message rather than silently returning empty results.
+
+## Composition
+
+These tools are designed to be used by **leaf** public agents (one per data domain),
+which a team-built monitor agent can orchestrate via `lead_call_agent`. See the
+public-agent YAMLs in `public_agents/base/cn-*.yaml` for working examples.

intentkit-1.2.12/intentkit/skills/cn_stock/__init__.py

@@ -0,0 +1,69 @@
+"""Chinese A-share market data skills (akshare-backed)."""
+
+import logging
+from typing import TypedDict
+
+from intentkit.skills.base import SkillConfig, SkillState
+from intentkit.skills.cn_stock.base import CNStockBaseTool
+from intentkit.skills.cn_stock.get_announcement import GetAnnouncement
+from intentkit.skills.cn_stock.get_board import GetBoard
+from intentkit.skills.cn_stock.get_capital_flow import GetCapitalFlow
+from intentkit.skills.cn_stock.get_financials import GetFinancials
+from intentkit.skills.cn_stock.get_index import GetIndex
+from intentkit.skills.cn_stock.get_kline import GetKLine
+from intentkit.skills.cn_stock.get_news import GetNews
+from intentkit.skills.cn_stock.get_quote import GetQuote
+from intentkit.skills.cn_stock.is_trading_day import IsTradingDay
+
+logger = logging.getLogger(__name__)
+
+
+class SkillStates(TypedDict, total=False):
+    get_quote: SkillState
+    get_kline: SkillState
+    get_index: SkillState
+    get_board: SkillState
+    get_capital_flow: SkillState
+    get_news: SkillState
+    get_announcement: SkillState
+    get_financials: SkillState
+    is_trading_day: SkillState
+
+
+class Config(SkillConfig):
+    """Configuration for cn_stock skills."""
+
+    states: SkillStates
+
+
+# Tool instances are stateless across calls; build once at import and reuse.
+_TOOLS: dict[str, CNStockBaseTool] = {
+    "get_quote": GetQuote(),
+    "get_kline": GetKLine(),
+    "get_index": GetIndex(),
+    "get_board": GetBoard(),
+    "get_capital_flow": GetCapitalFlow(),
+    "get_news": GetNews(),
+    "get_announcement": GetAnnouncement(),
+    "get_financials": GetFinancials(),
+    "is_trading_day": IsTradingDay(),
+}
+
+
+async def get_skills(
+    config: "Config",
+    is_private: bool,
+    **_,
+) -> list[CNStockBaseTool]:
+    available: list[CNStockBaseTool] = []
+    for name, state in config["states"].items():
+        if state == "disabled":
+            continue
+        if state == "private" and not is_private:
+            continue
+        tool = _TOOLS.get(name)
+        if tool is None:
+            logger.warning("Unknown cn_stock skill: %s", name)
+            continue
+        available.append(tool)
+    return available

intentkit-1.2.12/intentkit/skills/cn_stock/base.py

@@ -0,0 +1,107 @@
+"""Base class for cn_stock (Chinese A-share) tools backed by akshare."""
+
+import asyncio
+import json
+import logging
+from datetime import date, datetime
+from typing import Any, Callable
+
+import pytz
+from langchain_core.tools.base import ToolException
+
+from intentkit.config.redis import get_redis
+from intentkit.skills.base import IntentKitSkill
+
+logger = logging.getLogger(__name__)
+
+# A-share exchanges all run on Asia/Shanghai. Defaults must follow that wall clock,
+# regardless of the server's local timezone (typically UTC in production).
+_CN_TZ = pytz.timezone("Asia/Shanghai")
+
+
+def today_cn() -> date:
+    """Return today's date in the Asia/Shanghai timezone."""
+    return datetime.now(_CN_TZ).date()
+
+
+def normalize_a_share_symbol(symbol: str) -> str:
+    """Strip exchange prefix/suffix and return a bare 6-digit A-share code.
+
+    Accepts formats like "600519", "sh600519", "SH600519", "600519.SH", "600519.sh".
+    """
+    s = symbol.strip().upper()
+    for prefix in ("SH", "SZ", "BJ"):
+        if s.startswith(prefix):
+            s = s[len(prefix) :]
+            break
+    if "." in s:
+        s = s.split(".", 1)[0]
+    if len(s) != 6 or not s.isdigit():
+        raise ToolException(f"Invalid A-share code: {symbol!r} (expect 6 digits)")
+    return s
+
+
+def market_of(symbol: str) -> str:
+    """Return the exchange code ("sh"/"sz"/"bj") for a normalized 6-digit code."""
+    code = normalize_a_share_symbol(symbol)
+    # 920xxx is the BSE prefix introduced in 2025 for new listings; treat it as bj
+    # rather than letting all 9xxxxx through (900xxx are SSE B-shares, not A-shares).
+    if code.startswith("92"):
+        return "bj"
+    head = code[0]
+    if head == "6":
+        return "sh"
+    if head in ("0", "3"):
+        return "sz"
+    if head in ("4", "8"):
+        return "bj"
+    raise ToolException(f"Cannot infer market for code {code}")
+
+
+class CNStockBaseTool(IntentKitSkill):
+    category: str = "cn_stock"
+
+    async def run_blocking(
+        self,
+        cache_key: str | None,
+        cache_ttl: int,
+        func: Callable[..., Any],
+        *args: Any,
+        **kwargs: Any,
+    ) -> Any:
+        """Execute a blocking akshare call off the event loop with optional caching.
+
+        Pass cache_key=None to skip the cache for live data that must never be stale.
+        """
+        redis = get_redis() if cache_key is not None else None
+        if redis is not None:
+            cached = await redis.get(f"cn_stock:{cache_key}")
+            if cached:
+                try:
+                    return json.loads(cached)
+                except (TypeError, ValueError):
+                    logger.warning("Bad cache payload for %s, refetching", cache_key)
+
+        # akshare scrapes free public endpoints which rate-limit by IP; cap shared use.
+        await self.global_rate_limit_by_category(limit=60, seconds=60)
+
+        try:
+            result = await asyncio.to_thread(func, *args, **kwargs)
+        except Exception as e:
+            raise ToolException(f"akshare call failed: {e}") from e
+
+        if hasattr(result, "to_json"):
+            payload_str = result.to_json(
+                orient="records", date_format="iso", force_ascii=False
+            )
+            payload: Any = json.loads(payload_str)
+        elif isinstance(result, (str, int, float, bool, list, dict)) or result is None:
+            payload = result
+            payload_str = json.dumps(payload, ensure_ascii=False, default=str)
+        else:
+            payload = str(result)
+            payload_str = json.dumps(payload, ensure_ascii=False)
+
+        if redis is not None:
+            await redis.set(f"cn_stock:{cache_key}", payload_str, ex=cache_ttl)
+        return payload

intentkit-1.2.12/intentkit/skills/cn_stock/get_announcement.py

@@ -0,0 +1,47 @@
+"""Listed-company announcements (公告) via akshare."""
+
+from typing import Any
+
+import akshare as ak
+from langchain_core.tools import ArgsSchema
+from pydantic import BaseModel, Field
+
+from intentkit.skills.cn_stock.base import CNStockBaseTool, today_cn
+
+
+class GetAnnouncementInput(BaseModel):
+    on_date: str | None = Field(
+        default=None,
+        description="Date in YYYYMMDD; defaults to today. Announcements are released after market close.",
+    )
+    limit: int = Field(
+        default=20,
+        description="Maximum number of items to return (1-100).",
+        ge=1,
+        le=100,
+    )
+
+
+class GetAnnouncement(CNStockBaseTool):
+    name: str = "cn_stock_get_announcement"
+    description: str = (
+        "Get the day's listed-company announcements (财报、重大事项、增持减持、停复牌等). "
+        "Use to surface material disclosures that may move stock prices."
+    )
+    args_schema: ArgsSchema | None = GetAnnouncementInput
+
+    async def _arun(
+        self,
+        on_date: str | None = None,
+        limit: int = 20,
+        **_: Any,
+    ) -> list[dict[str, Any]]:
+        d = on_date or today_cn().strftime("%Y%m%d")
+        rows: list[dict[str, Any]] = await self.run_blocking(
+            f"announce:{d}",
+            900,
+            ak.stock_notice_report,
+            symbol="全部",
+            date=d,
+        )
+        return rows[:limit] if rows else []

intentkit-1.2.12/intentkit/skills/cn_stock/get_board.py

@@ -0,0 +1,63 @@
+"""Industry/concept board snapshot via akshare."""
+
+from typing import Any, Literal
+
+import akshare as ak
+from langchain_core.tools import ArgsSchema
+from pydantic import BaseModel, Field
+
+from intentkit.skills.cn_stock.base import CNStockBaseTool
+
+
+class GetBoardInput(BaseModel):
+    kind: Literal["industry", "concept"] = Field(
+        default="industry",
+        description="'industry' (行业板块) or 'concept' (概念板块).",
+    )
+    top: int = Field(
+        default=20,
+        description="Return top-N gainers and bottom-N losers by % change (1-50).",
+        ge=1,
+        le=50,
+    )
+
+
+class GetBoard(CNStockBaseTool):
+    name: str = "cn_stock_get_board"
+    description: str = (
+        "Get a snapshot of industry or concept boards, sorted by intraday percentage "
+        "change. Use to identify hot sectors and rotation. Returns top gainers and "
+        "top losers."
+    )
+    args_schema: ArgsSchema | None = GetBoardInput
+
+    async def _arun(
+        self,
+        kind: Literal["industry", "concept"] = "industry",
+        top: int = 20,
+        **_: Any,
+    ) -> dict[str, Any]:
+        fetcher = (
+            ak.stock_board_industry_name_em
+            if kind == "industry"
+            else ak.stock_board_concept_name_em
+        )
+        rows: list[dict[str, Any]] = await self.run_blocking(
+            f"board:{kind}",
+            60,
+            fetcher,
+        )
+
+        def pct(r: dict[str, Any]) -> float:
+            v = r.get("涨跌幅")
+            try:
+                return float(v) if v is not None else 0.0
+            except (TypeError, ValueError):
+                return 0.0
+
+        ranked = sorted(rows, key=pct, reverse=True)
+        return {
+            "kind": kind,
+            "gainers": ranked[:top],
+            "losers": ranked[-top:][::-1],
+        }

intentkit-1.2.12/intentkit/skills/cn_stock/get_capital_flow.py

@@ -0,0 +1,69 @@
+"""Capital flow (资金流向) for an individual stock or the whole market."""
+
+from typing import Any, Literal
+
+import akshare as ak
+from langchain_core.tools import ArgsSchema
+from langchain_core.tools.base import ToolException
+from pydantic import BaseModel, Field
+
+from intentkit.skills.cn_stock.base import (
+    CNStockBaseTool,
+    market_of,
+    normalize_a_share_symbol,
+)
+
+
+class GetCapitalFlowInput(BaseModel):
+    scope: Literal["stock", "market"] = Field(
+        ...,
+        description="'stock' for individual flow (requires symbol); 'market' for whole-market flow.",
+    )
+    symbol: str | None = Field(
+        default=None,
+        description="6-digit A-share code; required when scope='stock'.",
+    )
+    days: int = Field(
+        default=5,
+        description="Number of recent trading days to return (1-30).",
+        ge=1,
+        le=30,
+    )
+
+
+class GetCapitalFlow(CNStockBaseTool):
+    name: str = "cn_stock_get_capital_flow"
+    description: str = (
+        "Get net capital inflow / outflow data. For an individual stock returns recent "
+        "main / retail / institutional flows; for the whole market returns aggregate "
+        "north-bound and main-fund flows. Use to gauge smart-money positioning."
+    )
+    args_schema: ArgsSchema | None = GetCapitalFlowInput
+
+    async def _arun(
+        self,
+        scope: Literal["stock", "market"],
+        symbol: str | None = None,
+        days: int = 5,
+        **_: Any,
+    ) -> list[dict[str, Any]]:
+        if scope == "stock":
+            if not symbol:
+                raise ToolException("symbol is required when scope='stock'")
+            code = normalize_a_share_symbol(symbol)
+            mkt = market_of(symbol)
+            rows: list[dict[str, Any]] = await self.run_blocking(
+                f"flow:stock:{code}",
+                300,
+                ak.stock_individual_fund_flow,
+                stock=code,
+                market=mkt,
+            )
+            return rows[-days:] if rows else []
+
+        rows = await self.run_blocking(
+            "flow:market",
+            300,
+            ak.stock_market_fund_flow,
+        )
+        return rows[-days:] if rows else []