@migor/agentia 0.2.1 → 0.3.0

package/dist/toolkit/module.d.ts

@@ -1,36 +1,31 @@
 import type Anthropic from '@anthropic-ai/sdk';
-import type { AgentTool } from '../core/tool.js';
+import type { AgentTool, JsonSchema, ModelPricing, SchemaType } from '../core/tool.js';
 import type { SystemParam } from '../engine/types.js';
-import { SystemPrompt } from '../run/systemPrompt.js';
-import type { RunInvocationOptions } from '../run/spec.js';
+import { SystemPrompt } from '../runtime/systemPrompt.js';
+import type { RunInvocationOptions } from '../engine/spec.js';
+import type { SessionStore } from '../runtime/session.js';
 import type { AgentRunResult } from '../engine/types.js';
+import type { TraceSink } from '../core/trace.js';
 import { Container } from '../container/container.js';
 import type { Provider, Token } from '../container/container.js';
-import type { UnitMiddleware } from './middleware.js';
+import type { CapabilityMiddleware } from './middleware.js';
 import type { ContextPolicy } from '../engine/types.js';
+import type { RetryOptions } from '../engine/retry.js';
 /**
- * Agentia —— 应用装配（spec §4/§6：主 agent + 可调工具菜单）。
- *
- * createApp 组装：DI 容器注册 providers（手动和/或 discover 目录发现）→
- * 从容器实例自动扫描 @Tool / @SubAgent / @Skill / @Prompt 收集成本 app 的工具菜单
- * → agent.run(messages) 带着菜单走 executeRun。装配期统一静态校验（§7）：
- * 菜单查重、tools 引用存在性、toolSources 指向。
- * 主 agent 的 system 可由 SystemPrompt 实例给出（内部 build({cache:true})
- * 打稳定前缀 breakpoint），也接受已拼好的 SystemParam 原样透传。
- */
-/**
- * 能力包（roadmap R5）：第三方包把「单元 providers + 中间件」打包成 AgentModule 分发，
+ * 能力包（roadmap R5）：第三方包把「能力 providers + 中间件」打包成 AgentModule 分发，
  * 应用侧经 AppOptions.modules 一次性装配。模块的 providers 先于应用级 providers 注册
  *（同 token 应用级覆盖模块级）；中间件拼接顺序同样模块在前。
  */
 export interface AgentModule {
-    /** 模块携带的 DI providers（单元类 / 值 / 工厂） */
+    /** 模块携带的 DI providers（能力类 / 值 / 工厂） */
     providers: Provider[];
-    /** 模块级单元调用中间件（拼在应用级 middleware 之前，即更外层） */
-    middleware?: UnitMiddleware[];
+    /** 模块级能力调用中间件（拼在应用级 middleware 之前，即更外层） */
+    middleware?: CapabilityMiddleware[];
 }
 /** 定义能力包：identity 函数，仅给第三方包一个类型锚点与导出约定 */
 export declare function defineModule(m: AgentModule): AgentModule;
+/** 注册全局默认 trace sink（观测 / dev 工具用）。createApp 构造期快照合并，已建应用不受后续注册影响。 */
+export declare function registerDefaultTraceSink(sink: TraceSink): void;
 export interface AppOptions {
     /** 应用名；同时作为 run 名写入 trace */
     name?: string;
@@ -39,11 +34,12 @@ export interface AppOptions {
     /** 能力包：providers 并入（在 providers 之前注册）、middleware 拼接（在 middleware 之前） */
     modules?: AgentModule[];
     /**
-     * 单元目录发现：units/<name>/ 目录约定（一单元一文件夹，index.ts 入口）。
-     * 给目录路径（相对 cwd）即启动期扫描装配；因动态 import，带 discover 的
-     * createApp 返回 Promise<AgentApp>。
+     * 能力目录发现：`<目录>/<name>/index.ts` 约定（一能力一文件夹）。
+     * 给**一个目录**或**一组目录**（数组顺序即装配顺序）——典型布局是四分类目录
+     * `src/tools` / `src/skills` / `src/prompts` / `src/subagents`。
+     * 启动期扫描装配；因动态 import，带 discover 的 createApp 返回 Promise<AgentApp>。
      */
-    discover?: string;
+    discover?: string | string[];
     /** 主 agent system：SystemPrompt 实例（自动打缓存）或拼好的 SystemParam */
     system: SystemPrompt | SystemParam;
     /** 缺省模型；不给则走 engine 默认（claude-opus-5） */
@@ -54,39 +50,109 @@ export interface AppOptions {
     maxIterations?: number;
     /** 缺省上下文预算策略（compaction / context editing） */
     contextPolicy?: ContextPolicy;
+    /** 缺省模型请求重试策略（可被单次 run 覆盖）；见 RunAgentOptions.retry */
+    retry?: RetryOptions | false;
+    /** 缺省成本硬管控：整条 run 累计 token 上限（可被单次 run 覆盖） */
+    maxTotalTokens?: number;
+    /** 缺省成本硬管控：累计成本（美元）上限（可被单次 run 覆盖） */
+    maxCostUsd?: number;
+    /**
+     * 价格表覆盖/追加（$/1M tokens，可被单次 run 覆盖）；见 `RunAgentOptions.priceOverrides`。
+     * 给非 Anthropic 端点（DeepSeek / 自建）定价，否则 `maxCostUsd` 会静默不生效。
+     */
+    priceOverrides?: Record<string, ModelPricing>;
+    /** 未定价模型回调（可被单次 run 覆盖）；见 `RunAgentOptions.onUnpricedModel` */
+    onUnpricedModel?: (info: {
+        model: string;
+        spanId: string;
+    }) => void;
+    /** 缺省单个工具执行超时（毫秒，可被单次 run 覆盖）；0/不设 = 不限 */
+    toolTimeoutMs?: number;
+    /** 缺省同回合并行工具上限（可被单次 run 覆盖）；不设 = 不限 */
+    maxToolConcurrency?: number;
     /** 只扫这些 token 的 provider 上的 @Tool；缺省扫全部 providers */
     toolSources?: Token[];
-    /** 单元调用中间件（洋葱模型，链序 = 注册顺序）；装配期包裹整个菜单 */
-    middleware?: UnitMiddleware[];
+    /**
+     * 直接追加到主菜单的**裸工具**（`AgentTool[]`）—— 给「构造期才知道有哪些工具」的场景
+     * （典型：MCP 桥 `mcpTools()` 的返回值，见 integrations/mcp.ts）。
+     *
+     * 与装饰器收集来的能力**完全同等**：同样过中间件链、同样进重名查重、同样受
+     * `toolSources` 之外的一切装配规则约束（不受 `toolSources` 收窄影响 —— 这是显式追加）。
+     * 不经装饰器、不进 DI 容器（它没有 provider token，也不是任何能力的 tools 引用目标）。
+     */
+    tools?: AgentTool[];
+    /** 能力调用中间件（洋葱模型，链序 = 注册顺序）；装配期包裹整个菜单 */
+    middleware?: CapabilityMiddleware[];
+    /** trace 出口（观测）：每次 run 收尾投递；与全局默认 sink 合并（本字段在前） */
+    sinks?: TraceSink[];
 }
 /** 单次调用参数 = 通用调用参数 + 单次可覆盖 system（spec.ts 的 RunInvocationOptions 为单源） */
-export interface RunAppOptions extends RunInvocationOptions {
+export interface RunAppOptions<S extends JsonSchema = JsonSchema> extends RunInvocationOptions {
     /** 单次覆盖 system（volatile 段建议每 run 重建以拾取最新值） */
     system?: SystemPrompt | SystemParam;
+    /**
+     * 结构化结果 schema（R2）：语义同 `RunAgentOptions.resultSchema`（engine 追加隐藏
+     * submit_result 工具，校验通过的结果写入 `result.typed`）。
+     * 传 `fromZod<T>(...)` 时 `app.run` 的返回类型自动带上 `typed: T | undefined`。
+     */
+    resultSchema?: S;
+    /**
+     * 会话持久化（C4）：语义同 `ExecuteRunOptions.session` —— run 开始把历史拼在传入
+     * messages 之前，成功收尾把本轮消息 + 回复追加回去。与 `blackboard`（键值黑板）正交。
+     *
+     * 只在程序内直接 `app.run` 时可用（store 实例不可序列化，因此**不在**
+     * transport 的 `RunInvocationOptions` 里 —— 异步宿主不会替你传它）。
+     */
+    session?: {
+        store: SessionStore;
+        id: string;
+    };
+    /**
+     * 未定价模型回调（单次覆盖应用级）；见 `RunAgentOptions.onUnpricedModel`。
+     * 是函数，因此**不在** transport 的 `RunInvocationOptions` 里（异步宿主不替你传）。
+     */
+    onUnpricedModel?: (info: {
+        model: string;
+        spanId: string;
+    }) => void;
 }
-export interface AgentRunOutput {
-    run: import('../run/run.js').Run;
-    result: AgentRunResult;
+export interface AgentRunOutput<T = unknown> {
+    run: import('../runtime/run.js').Run;
+    result: AgentRunResult<T>;
 }
+/**
+ * Agentia —— 应用装配（spec §4/§6：主 agent + 可调工具菜单）。
+ *
+ * createApp 组装：DI 容器注册 providers（手动和/或 discover 目录发现）→
+ * 从容器实例自动扫描 @Tool / @SubAgent / @Skill / @Prompt 收集成本 app 的工具菜单
+ * → agent.run(messages) 带着菜单走 executeRun。装配期统一静态校验（§7）：
+ * 菜单查重、tools 引用存在性、toolSources 指向。
+ * 主 agent 的 system 可由 SystemPrompt 实例给出（内部 build({cache:true})
+ * 打稳定前缀 breakpoint），也接受已拼好的 SystemParam 原样透传。
+ */
 export declare class AgentApp {
     readonly name: string;
     private readonly di;
     private readonly system;
     private readonly base;
-    private _tools?;
+    private _tools;
+    private readonly sinks;
     constructor(opts: AppOptions);
     /** app 已装配好的工具菜单（构建期即从容器解析，静态稳定） */
     get tools(): AgentTool[];
-    /** 容器访问点（后续 trace 拦截器/生命周期回调可用） */
+    /** 容器访问点 */
     get container(): Container;
-    /** 执行一次主 agent run。system 每 run 从 SystemPrompt 重建，保证 volatile 新鲜。 */
-    run(messages: Anthropic.MessageParam[], opts?: RunAppOptions): Promise<AgentRunOutput>;
+    /**
+     * 执行一次主 agent run。system 每 run 从 SystemPrompt 重建，保证 volatile 新鲜。
+     * 传 `resultSchema: fromZod<T>(...)` 时返回值 `result.typed` 为 `T | undefined`。
+     */
+    run<S extends JsonSchema = JsonSchema>(messages: Anthropic.MessageParam[], opts?: RunAppOptions<S>): Promise<AgentRunOutput<SchemaType<S>>>;
 }
 /**
- * 装配应用。不带 discover 时同步返回 AgentApp；带 discover（单元目录路径）时
+ * 装配应用。不带 discover 时同步返回 AgentApp；带 discover（能力目录路径，一个或一组）时
  * 先扫描装配，返回 Promise<AgentApp>（动态 import 决定）。
  */
 export declare function createApp(opts: AppOptions & {
-    discover: string;
+    discover: string | string[];
 }): Promise<AgentApp>;
 export declare function createApp(opts: AppOptions): AgentApp;

package/dist/toolkit/module.js

@@ -1,5 +1,5 @@
-import { SystemPrompt } from '../run/systemPrompt.js';
-import { executeRun } from '../run/run.js';
+import { SystemPrompt } from '../runtime/systemPrompt.js';
+import { executeRun } from '../runtime/run.js';
 import { Container } from '../container/container.js';
 import { discoverProviders } from './discover.js';
 import { collectTools } from './tool.js';
@@ -11,12 +11,28 @@ import { applyMiddleware } from './middleware.js';
 export function defineModule(m) {
     return m;
 }
+const defaultSinks = [];
+/** 注册全局默认 trace sink（观测 / dev 工具用）。createApp 构造期快照合并，已建应用不受后续注册影响。 */
+export function registerDefaultTraceSink(sink) {
+    defaultSinks.push(sink);
+}
+/**
+ * Agentia —— 应用装配（spec §4/§6：主 agent + 可调工具菜单）。
+ *
+ * createApp 组装：DI 容器注册 providers（手动和/或 discover 目录发现）→
+ * 从容器实例自动扫描 @Tool / @SubAgent / @Skill / @Prompt 收集成本 app 的工具菜单
+ * → agent.run(messages) 带着菜单走 executeRun。装配期统一静态校验（§7）：
+ * 菜单查重、tools 引用存在性、toolSources 指向。
+ * 主 agent 的 system 可由 SystemPrompt 实例给出（内部 build({cache:true})
+ * 打稳定前缀 breakpoint），也接受已拼好的 SystemParam 原样透传。
+ */
 export class AgentApp {
     name;
     di;
     system;
     base;
-    _tools;
+    _tools = [];
+    sinks;
     constructor(opts) {
         this.name = opts.name ?? 'app';
         const modules = opts.modules ?? [];
@@ -31,87 +47,127 @@ export class AgentApp {
         ];
         this.di = new Container().register(...providerList);
         this.system = opts.system;
+        // trace 出口：应用级 sinks 在前，全局默认 sink 在后（构造期快照，注册表后续变化不影响本应用）
+        this.sinks = [...(opts.sinks ?? []), ...defaultSinks];
         this.base = {
             model: opts.model,
             maxTokens: opts.maxTokens,
             maxIterations: opts.maxIterations,
             contextPolicy: opts.contextPolicy,
+            retry: opts.retry,
+            maxTotalTokens: opts.maxTotalTokens,
+            maxCostUsd: opts.maxCostUsd,
+            priceOverrides: opts.priceOverrides,
+            onUnpricedModel: opts.onUnpricedModel,
+            toolTimeoutMs: opts.toolTimeoutMs,
+            maxToolConcurrency: opts.maxToolConcurrency,
         };
         // 先为每个 provider 解析实例并预收集它的 @Tool / @SubAgent / @Skill / @Prompt；
         // 子 agent / skill 的 tools token 在装配期即解析到该 provider 的 @Tool 菜单（静态校验）。
         const plainByToken = new Map();
-        const unitsByToken = new Map();
+        const capabilitiesByToken = new Map();
         const skillsByToken = new Map();
         const promptsByToken = new Map();
         for (const p of providerList) {
             const inst = this.di.resolve(p.provide);
             plainByToken.set(p.provide, collectTools(inst));
-            unitsByToken.set(p.provide, collectSubAgents(inst));
+            capabilitiesByToken.set(p.provide, collectSubAgents(inst));
             skillsByToken.set(p.provide, collectSkills(inst));
             promptsByToken.set(p.provide, collectPrompts(inst));
         }
+        // 能力调用中间件：装配期包裹整个菜单（洋葱模型，对 engine 零侵入）；
+        // 模块级中间件在前（更外层），应用级在后。
+        const middleware = [...modules.flatMap((m) => m.middleware ?? []), ...(opts.middleware ?? [])];
+        const wrap = (tools) => middleware.length ? applyMiddleware(tools, middleware) : tools;
+        /**
+         * 中间件包装**之后**的每 provider 菜单。
+         *
+         * 嵌套能力（子 agent / skill）解析自身 tools 引用时必须从这里取 —— 若取
+         * 「中间件包装之前的原始菜单」，子 agent 内部调用的每一个工具都会绕过中间件
+         * （鉴权 / 限流 / 审计 / 结果缓存全部失效），是 spec §10 记录在案的既知问题。
+         * 该 map 在 resolveRefTools 的 thunk 被真正调用（运行时）前已填充完毕。
+         */
+        const wrappedByToken = new Map();
         // 装配期立即解析 tools 引用（§7 启动期静态校验）：引用未注册 provider 在
-        // createApp 即抛错，不延迟到模型调用该单元的运行时。
+        // createApp 即抛错，不延迟到模型调用该能力的运行时。实际取值延迟到运行时
+        // （惰性 thunk）—— 那时 wrappedByToken 已就绪。
         const resolveRefTools = (owner, refs) => {
-            const resolved = (refs ?? []).flatMap((t) => {
-                const inner = plainByToken.get(t);
-                if (!inner) {
+            for (const t of refs ?? []) {
+                if (!plainByToken.has(t)) {
                     throw new Error(`${owner} tools 引用未注册 provider: "${t}"`);
                 }
-                return inner;
-            });
-            return () => resolved;
-        };
-        const sources = opts.toolSources ?? providerList.map((p) => p.provide);
-        this._tools = sources.flatMap((token) => {
-            if (!this.di.has(token)) {
-                throw new Error(`toolSources 指向未注册 provider: "${token}"`);
             }
+            return () => (refs ?? []).flatMap((t) => wrappedByToken.get(t) ?? []);
+        };
+        const buildSlice = (token) => {
             const plain = plainByToken.get(token) ?? [];
-            const subTools = (unitsByToken.get(token) ?? []).map((unit) => subagentToTool(unit, resolveRefTools(`@SubAgent "${unit.name}"`, unit.spec.tools)));
-            const skillTools = (skillsByToken.get(token) ?? []).map((unit) => skillToTool(unit, resolveRefTools(`@Skill "${unit.name}"`, unit.spec.tools)));
+            const subTools = (capabilitiesByToken.get(token) ?? []).map((capability) => subagentToTool(capability, resolveRefTools(`@SubAgent "${capability.name}"`, capability.spec.tools)));
+            const skillTools = (skillsByToken.get(token) ?? []).map((capability) => skillToTool(capability, resolveRefTools(`@Skill "${capability.name}"`, capability.spec.tools)));
             const promptTools = promptsByToken.get(token) ?? [];
             return [...plain, ...subTools, ...skillTools, ...promptTools];
-        });
+        };
+        // 全部 provider 都切片并包装：主菜单只取 sources，但被 toolSources 排除的
+        // provider 上的能力仍可被其他能力的 tools 引用（引用是作者显式声明，不受收窄影响）——
+        // 因此包装必须覆盖全部 provider，否则 ref 解析会拿到未包装（可绕过中间件）的工具。
+        for (const p of providerList) {
+            wrappedByToken.set(p.provide, wrap(buildSlice(p.provide)));
+        }
+        // toolSources 是「取哪些 provider 的能力」的白名单，同一 token 写重只该取一次：
+        // 不去重则会 flatMap 收两遍该 provider 的能力，最后撞上「菜单能力重名」——
+        // 报错指向能力定义（错误来源），而真正的问题是这份清单里重复写了 token。
+        const sources = opts.toolSources
+            ? [...new Set(opts.toolSources)]
+            : providerList.map((p) => p.provide);
+        this._tools = [
+            ...sources.flatMap((token) => {
+                if (!this.di.has(token)) {
+                    throw new Error(`toolSources 指向未注册 provider: "${token}"`);
+                }
+                return wrappedByToken.get(token) ?? [];
+            }),
+            // 裸工具（AppOptions.tools）：与装饰器收集来的能力同等 —— 一样过中间件、
+            // 一样进下面的重名查重。**不是旁路**（旁路会绕过鉴权/限流/审计）。
+            ...wrap(opts.tools ?? []),
+        ];
         // §7 静态校验（最小落地）：菜单统一查重 —— 重名会让模型在歧义菜单里猜，直接报错。
         const dup = new Map();
         for (const t of this._tools)
             dup.set(t.name, (dup.get(t.name) ?? 0) + 1);
         const dupNames = [...dup.entries()].filter(([, n]) => n > 1).map(([n]) => n);
         if (dupNames.length > 0) {
-            throw new Error(`菜单单元重名（tool/skill/subagent/prompt 共用命名空间）: ${dupNames.join(', ')}`);
+            throw new Error(`菜单能力重名（tool/skill/subagent/prompt 共用命名空间）: ${dupNames.join(', ')}`);
         }
-        // 孤儿单元告警：toolSources 显式收窄时，被排除 provider 上的单元不可达
+        // 孤儿能力告警：toolSources 显式收窄时，被排除 provider 上的能力不在主菜单
+        // （模型无法直接调用）；但**仍可被其他能力的 tools 引用**（引用是作者显式声明），
+        // 所以只是「不在主菜单」而非「不可达」。
         if (opts.toolSources) {
             const included = new Set(opts.toolSources);
             for (const p of providerList) {
                 if (included.has(p.provide))
                     continue;
                 const orphanCount = (plainByToken.get(p.provide)?.length ?? 0) +
-                    (unitsByToken.get(p.provide)?.length ?? 0) +
+                    (capabilitiesByToken.get(p.provide)?.length ?? 0) +
                     (skillsByToken.get(p.provide)?.length ?? 0) +
                     (promptsByToken.get(p.provide)?.length ?? 0);
                 if (orphanCount > 0) {
-                    console.warn(`[agentia] 孤儿单元告警：provider "${p.provide}" 上的 ${orphanCount} 个单元不在 toolSources 内，不可达`);
+                    console.warn(`[agentia] 孤儿能力告警：provider "${p.provide}" 上的 ${orphanCount} 个能力不在 toolSources 内，` +
+                        `不进主菜单（模型无法直接调用）；若被其他能力的 tools 引用仍可被调用`);
                 }
             }
         }
-        // 单元调用中间件：装配期包裹整个菜单（洋葱模型，对 engine 零侵入）；
-        // 模块级中间件在前（更外层），应用级在后。
-        const middleware = [...modules.flatMap((m) => m.middleware ?? []), ...(opts.middleware ?? [])];
-        if (middleware.length) {
-            this._tools = applyMiddleware(this._tools, middleware);
-        }
     }
     /** app 已装配好的工具菜单（构建期即从容器解析，静态稳定） */
     get tools() {
-        return this._tools ?? [];
+        return this._tools;
     }
-    /** 容器访问点（后续 trace 拦截器/生命周期回调可用） */
+    /** 容器访问点 */
     get container() {
         return this.di;
     }
-    /** 执行一次主 agent run。system 每 run 从 SystemPrompt 重建，保证 volatile 新鲜。 */
+    /**
+     * 执行一次主 agent run。system 每 run 从 SystemPrompt 重建，保证 volatile 新鲜。
+     * 传 `resultSchema: fromZod<T>(...)` 时返回值 `result.typed` 为 `T | undefined`。
+     */
     run(messages, opts = {}) {
         const sys = opts.system ?? this.system;
         const system = sys instanceof SystemPrompt ? sys.build({ cache: true }) : sys;
@@ -128,11 +184,27 @@ export class AgentApp {
             runName: this.name,
             idempotencyKey: opts.idempotencyKey,
             contextPolicy: opts.contextPolicy ?? this.base.contextPolicy,
+            retry: opts.retry ?? this.base.retry,
+            maxTotalTokens: opts.maxTotalTokens ?? this.base.maxTotalTokens,
+            maxCostUsd: opts.maxCostUsd ?? this.base.maxCostUsd,
+            priceOverrides: opts.priceOverrides ?? this.base.priceOverrides,
+            onUnpricedModel: opts.onUnpricedModel ?? this.base.onUnpricedModel,
+            toolTimeoutMs: opts.toolTimeoutMs ?? this.base.toolTimeoutMs,
+            maxToolConcurrency: opts.maxToolConcurrency ?? this.base.maxToolConcurrency,
+            resultSchema: opts.resultSchema,
+            // 提示词版本化（D4）：system 是 SystemPrompt 实例时自动带上它的 version
+            // （run 根 attribute `system.version`）；传已拼好的 SystemParam 则无版本可记。
+            systemVersion: sys instanceof SystemPrompt ? sys.version : undefined,
+            session: opts.session,
             rethrow: opts.rethrow,
+            sinks: this.sinks,
             contextInit: (ctx) => {
                 if (seed) {
-                    for (const key of Object.keys(seed))
-                        ctx.set(key, seed[key]);
+                    // 种子键是运行期字符串，类型上无从与「用户声明的 Blackboard」对齐 ——
+                    // 走文档里给用户的同一条逃生口：断言为 BlackboardKey。
+                    const entries = seed;
+                    for (const key of Object.keys(entries))
+                        ctx.set(key, entries[key]);
                 }
             },
         });
@@ -140,7 +212,11 @@ export class AgentApp {
 }
 export function createApp(opts) {
     if (opts.discover) {
-        return discoverProviders(opts.discover).then((found) => new AgentApp({ ...opts, providers: [...(opts.providers ?? []), ...found] }));
+        return discoverProviders(opts.discover).then(
+        // 显式 providers 放在发现结果**之后**：AppOptions.providers 是应用级显式声明，
+        // 同 token 时应覆盖「目录里扫出来的」（后注册覆盖先注册）。反过来会让
+        // capabilities/ 下一个同名文件夹悄悄顶掉调用方手写的 provider。
+        (found) => new AgentApp({ ...opts, providers: [...found, ...(opts.providers ?? [])] }));
     }
     return new AgentApp(opts);
 }

package/dist/toolkit/module.js.map

@@ -1 +1 @@
-{"version":3,"file":"module.js","sourceRoot":"","sources":["../../src/toolkit/module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../src/toolkit/module.ts"],"names":[],"mappings":"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"}

package/dist/toolkit/prompt.d.ts

@@ -1,10 +1,11 @@
+import type { CapabilityDecoratorContext } from './collect.js';
 import type { AgentTool, JsonSchema } from '../core/tool.js';
 /**
- * Agentia —— Prompt 单元（spec §3：纯文本资产 —— 模板/宏/playbook，被选中时注入上下文）。
+ * Agentia —— Prompt 能力（spec §3：纯文本资产 —— 模板/宏/playbook，被选中时注入上下文）。
  *
  * 运行时本质：把 prompt 编译成主 agent 菜单里一个**无副作用拉取型 AgentTool** ——
  * 模型判定“这活儿需要该资产”时调用它，返回文本以 tool_result 进上下文。这是
- * 我们现成唯一的“被选中”机制（unit 本身不跑循环、不调模型）。
+ * 我们现成唯一的“被选中”机制（capability 本身不跑循环、不调模型）。
  *
  * 声明形态（标准装饰器下字段装饰器拿不到值/类引用，故只支持方法形态，与
  * spec §4 草图的 `static brand = '…'` 用 `static method` 同效表达）：
@@ -21,10 +22,7 @@ export interface PromptSpec {
     schema?: JsonSchema;
 }
 /** 方法装饰器（实例或 static 均可）：登记 prompt spec。返回值 = 资产文本。 */
-export declare function Prompt(spec: PromptSpec): (value: Function, context: {
-    kind: string;
-    name: string | symbol;
-}) => void;
+export declare function Prompt(spec: PromptSpec): (value: Function, context: CapabilityDecoratorContext) => void;
 /**
  * 收集容器实例（+ 其类上的静态方法）里所有 @Prompt，产出 AgentTool[]。
  * 实例方法沿原型链（含继承）；静态方法扫描 instance.constructor 自身属性。

package/dist/toolkit/prompt.js

@@ -1,4 +1,4 @@
-import { scanDecoratedMethods, unitName } from './collect.js';
+import { assertMethodTarget, scanDecoratedMethods, capabilityName } from './collect.js';
 const promptSpecs = new WeakMap();
 const EMPTY_SCHEMA = {
     type: 'object',
@@ -7,10 +7,8 @@ const EMPTY_SCHEMA = {
 };
 /** 方法装饰器（实例或 static 均可）：登记 prompt spec。返回值 = 资产文本。 */
 export function Prompt(spec) {
-    return function (value, context) {
-        if (context.kind !== 'method') {
-            throw new Error(`@Prompt 只能修饰方法（static 方法亦可），收到 kind=${String(context.kind)}`);
-        }
+    return (value, context) => {
+        assertMethodTarget(context, '@Prompt');
         promptSpecs.set(value, spec);
     };
 }
@@ -20,18 +18,21 @@ export function Prompt(spec) {
  */
 export function collectPrompts(instance) {
     const tools = [];
-    const pushTool = (name, fn, thisArg, spec) => {
+    // 传 key 而非捕获的 fn：子类「未装饰地 override」时 spec 继承自父类，
+    // 但实现必须取**实例/类上**的（否则会绕开子类实现，与 @Tool 语义不一致）。
+    const pushTool = (name, target, key, spec) => {
         tools.push({
             name: spec.name ?? name,
             description: spec.description,
             inputSchema: spec.schema ?? EMPTY_SCHEMA,
-            run: (input) => Reflect.apply(fn, thisArg, [input]),
+            run: (input) => Reflect.apply(target[key], target, [input]),
         });
     };
     // 实例方法（沿原型链）
     const found = scanDecoratedMethods(instance, promptSpecs);
-    for (const { key, fn, spec } of found) {
-        pushTool(unitName(spec, key, '@Prompt'), fn, instance, spec);
+    const inst = instance;
+    for (const { key, spec } of found) {
+        pushTool(capabilityName(spec, key, '@Prompt'), inst, key, spec);
     }
     // 静态方法（类自身属性）；已被实例方法占用的 key 跳过
     const seen = new Set(found.map((f) => f.key));
@@ -48,7 +49,7 @@ export function collectPrompts(instance) {
             if (!spec)
                 continue;
             seen.add(key);
-            pushTool(key, fn, cls, spec);
+            pushTool(key, ctor, key, spec);
         }
     }
     return tools;

package/dist/toolkit/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/toolkit/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAyB9D,MAAM,WAAW,GAAG,IAAI,OAAO,EAAwB,CAAC;AAExD,MAAM,YAAY,GAAe;IAC/B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE;IACd,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,sDAAsD;AACtD,MAAM,UAAU,MAAM,CAAC,IAAgB;IACrC,OAAO,UACL,KAAe,EACf,OAAgD;QAEhD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,uCAAuC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAY,EAAE,OAAgB,EAAE,IAAgB,EAAQ,EAAE;QACxF,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,MAAM,IAAI,YAAY;YACxC,GAAG,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,aAAa;IACb,MAAM,KAAK,GAAG,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC1D,KAAK,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QACtC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,+BAA+B;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAkB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAa,QAAsC,CAAC,WAAW,CAAC;IACzE,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,GAAyC,CAAC;QACvD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,IAAI,OAAO,EAAE,KAAK,UAAU;gBAAE,SAAS;YACvC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,EAAc,CAAC,CAAC;YAC7C,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,QAAQ,CAAC,GAAG,EAAE,EAAc,EAAE,GAAa,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/toolkit/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AA0BxF,MAAM,WAAW,GAAG,IAAI,OAAO,EAAwB,CAAC;AAExD,MAAM,YAAY,GAAe;IAC/B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE;IACd,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,sDAAsD;AACtD,MAAM,UAAU,MAAM,CAAC,IAAgB;IACrC,OAAO,CAAC,KAAe,EAAE,OAAmC,EAAQ,EAAE;QACpE,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACvC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,gDAAgD;IAChD,6CAA6C;IAC7C,MAAM,QAAQ,GAAG,CACf,IAAY,EACZ,MAAwC,EACxC,GAAoB,EACpB,IAAgB,EACV,EAAE;QACR,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,MAAM,IAAI,YAAY;YACxC,GAAG,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAa,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;SACjF,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,aAAa;IACb,MAAM,KAAK,GAAG,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,QAA4C,CAAC;IAC1D,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QAClC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;IAED,+BAA+B;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAkB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAa,QAAsC,CAAC,WAAW,CAAC;IACzE,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,GAAyC,CAAC;QACvD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,IAAI,OAAO,EAAE,KAAK,UAAU;gBAAE,SAAS;YACvC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,EAAc,CAAC,CAAC;YAC7C,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,QAAQ,CAAC,GAAG,EAAE,IAAwC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/toolkit/skill.d.ts

@@ -1,18 +1,19 @@
+import type { CapabilityDecoratorContext } from './collect.js';
 import type Anthropic from '@anthropic-ai/sdk';
 import type { AgentTool, JsonSchema } from '../core/tool.js';
 import type { AgentStopReason } from '../engine/types.js';
-import { SystemPrompt } from '../run/systemPrompt.js';
+import { SystemPrompt } from '../runtime/systemPrompt.js';
 /**
- * Agentia —— Skill 单元（spec §3：指令 + 脚本，受限子运行，回产物/结论）。
+ * Agentia —— Skill 能力（spec §3：指令 + 脚本，受限子运行，回产物/结论）。
  *
  * 与 @SubAgent 的可感知区别：
  * - 子 agent = **模型自主循环**：你只给 role/任务/工具，走几步、何时停由模型决定；
  * - Skill     = **代码控制的流程**：方法体是确定性脚本，把“要不要调模型、调几次、
  *   拿结果怎么算”写死在代码里 —— 模型调用只在你显式 `ctx.llm()` 时发生（受限子运行），
- *   每次都在 skill 自己的 `unit` span 下开 llm.turn 记账，中间结果可继续加工，
+ *   每次都在 skill 自己的 `capability` span 下开 llm.turn 记账，中间结果可继续加工，
  *   方法返回值即产物/结论，以 tool_result 交回主 agent。
  *
- * trace：skill = 主 trace 里一个 `unit` span（attribute `skill`），内部 ctx.llm() 的
+ * trace：skill = 主 trace 里一个 `capability` span（attribute `skill`），内部 ctx.llm() 的
  * llm.turn 递归成它的子孙 —— 与 @SubAgent 同款 parentSpanId 传播，不双开 run 根。
  */
 export interface SkillSpec {
@@ -47,10 +48,10 @@ export interface SkillLlmResult {
 export interface SkillContext {
     /** 本次 skill 的缺省模型（spec.model 或 undefined → engine 缺省） */
     readonly model?: string;
-    /** 受限子运行：每次调用在 skill unit span 下开一轮独立 agent 循环（无工具则纯文本）。 */
+    /** 受限子运行：每次调用在 skill capability span 下开一轮独立 agent 循环（无工具则纯文本）。 */
     llm(opts: SkillLlmOptions): Promise<SkillLlmResult>;
 }
-export interface SkillUnit {
+export interface SkillCapability {
     name: string;
     description: string;
     inputSchema: JsonSchema;
@@ -59,16 +60,13 @@ export interface SkillUnit {
     invoke: (input: unknown, skillCtx: SkillContext) => unknown | Promise<unknown>;
 }
 /** 方法装饰器：登记 skill spec。被装饰方法体由运行时以 (input, skillCtx) 调用。 */
-export declare function Skill(spec: SkillSpec): (value: Function, context: {
-    kind: string;
-    name: string | symbol;
-}) => void;
-/** 把容器实例上所有 @Skill 方法收集成 SkillUnit[]（沿原型链）。 */
-export declare function collectSkills(instance: object): SkillUnit[];
+export declare function Skill(spec: SkillSpec): (value: Function, context: CapabilityDecoratorContext) => void;
+/** 把容器实例上所有 @Skill 方法收集成 SkillCapability[]（沿原型链）。 */
+export declare function collectSkills(instance: object): SkillCapability[];
 /**
- * 把 SkillUnit 变成主 agent 菜单里的 AgentTool。
+ * 把 SkillCapability 变成主 agent 菜单里的 AgentTool。
  * run(input, ctx) 需要 ToolRunContext（engine 调用时必有）；手动直调会抛错提示。
- * 开 `unit` span → 构造 SkillContext（llm 闭包挂 unit 下）→ 执行方法体 →
- * 返回值字符串化交回；抛错关 unit error 后重抛（引擎包成 is_error，不中断 run）。
+ * 开 `capability` span → 构造 SkillContext（llm 闭包挂 capability 下）→ 执行方法体 →
+ * 返回值字符串化交回；抛错关 capability error 后重抛（引擎包成 is_error，不中断 run）。
  */
-export declare function skillToTool(unit: SkillUnit, resolveTools: () => AgentTool[]): AgentTool;
+export declare function skillToTool(capability: SkillCapability, resolveTools: () => AgentTool[]): AgentTool;