@migor/agentia 0.2.1 → 0.2.2

package/dist/eval/defineEval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineEval.js","sourceRoot":"","sources":["../../src/eval/defineEval.ts"],"names":[],"mappings":"AAwEA,SAAS,SAAS,CAAC,CAAU;IAC3B,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,GAAsB;IAEtB,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,CAAC,GAAG;YACP,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAqB,EAAE,CAAC;YAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACvB,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxC,MAAM,QAAQ,GAA6B,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBAChF,IAAI,MAAM,GAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;gBACxD,IAAI,CAAC;oBACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;oBAC5E,MAAM,KAAK,GAAG,MAA2B,CAAC;oBAC1C,+CAA+C;oBAC/C,MAAM,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;oBACvF,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;gBACnD,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,CAAC;YAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;YAChD,OAAO;gBACL,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,MAAM;gBACN,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM;gBAC7B,EAAE,EAAE,MAAM,KAAK,KAAK,CAAC,MAAM;gBAC3B,KAAK;aACN,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/eval/scripted.d.ts

@@ -0,0 +1,26 @@
+import type { ModelClient } from '../core/tool.js';
+/**
+ * Agentia —— 脚本化模型客户端（D2，evals）。
+ *
+ * 把测试里那个手写的 `mockClient` 提升为一等能力：按脚本依次返回**模型响应**，
+ * 于是「改 prompt / 换模型 / 加工具之后有没有回归」可以写成断言，而不是靠人眼看。
+ * 这是 agent 服务最缺的一环 —— 单测覆盖的是框架语义，evals 覆盖的是**你的 agent 语义**。
+ *
+ * 与 `tests/helpers.ts` 的 mockClient 的差别（为什么不是同一个东西）：
+ * - 这里是**公共 API**，走 `ModelClient` 类型，能在用户项目里用（mockClient 是测试夹具）；
+ * - 这里会**真的把文本块逐块通过 `on('text')` 吐出去** —— 于是 `onText` / SSE 链路
+ *   在 eval 里也真实走一遍（mockClient 直接忽略 `on`）；副作用是「已吐字不重试」这类
+ *   与流式相关的分支在 eval 里也按真实路径走；
+ * - 步骤耗尽会抛错（而不是静默返回 undefined），脚本与 agent 行为不匹配时立刻可见。
+ */
+/** 一步脚本：直接给响应对象，或按本次请求参数现算（`(params) => message`） */
+export type ScriptedStep = Record<string, unknown> | ((params: unknown) => Record<string, unknown> | Promise<Record<string, unknown>>);
+/**
+ * 按脚本依次返回模型响应。
+ *
+ * 消费时机：**在 `finalMessage()` 成功返回之后**才前进到下一步 —— 于是
+ * ① 抛错的步骤（用函数步骤 `throw` 模拟 429 / 网络失败）会在重试时**重放同一步**，
+ * 想验重试就写 `(params) => { if (++n === 1) throw ...; return msg; }`；
+ * ② 脚本耗尽时报错指向「第几次调用」，一眼看出 agent 多调了一轮模型。
+ */
+export declare function scriptedClient(steps: ScriptedStep[]): ModelClient;

package/dist/eval/scripted.js

@@ -0,0 +1,43 @@
+/**
+ * 按脚本依次返回模型响应。
+ *
+ * 消费时机：**在 `finalMessage()` 成功返回之后**才前进到下一步 —— 于是
+ * ① 抛错的步骤（用函数步骤 `throw` 模拟 429 / 网络失败）会在重试时**重放同一步**，
+ * 想验重试就写 `(params) => { if (++n === 1) throw ...; return msg; }`；
+ * ② 脚本耗尽时报错指向「第几次调用」，一眼看出 agent 多调了一轮模型。
+ */
+export function scriptedClient(steps) {
+    let cursor = 0;
+    return {
+        messages: {
+            stream(params) {
+                const handlers = [];
+                return {
+                    on(event, cb) {
+                        if (event === 'text')
+                            handlers.push(cb);
+                    },
+                    async finalMessage() {
+                        const step = steps[cursor];
+                        if (step === undefined) {
+                            throw new Error(`scriptedClient 脚本耗尽：第 ${cursor + 1} 次调用模型，但只给了 ${steps.length} 步`);
+                        }
+                        const message = (await (typeof step === 'function'
+                            ? step(params)
+                            : step));
+                        // 真的逐块吐文本 —— onText / SSE 链路在 eval 里按真实路径走一遍
+                        for (const block of (message.content ?? [])) {
+                            if (block.type === 'text' && block.text) {
+                                for (const h of handlers)
+                                    h(block.text);
+                            }
+                        }
+                        cursor++;
+                        return message;
+                    },
+                };
+            },
+        },
+    };
+}
+//# sourceMappingURL=scripted.js.map

package/dist/eval/scripted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted.js","sourceRoot":"","sources":["../../src/eval/scripted.ts"],"names":[],"mappings":"AAuBA;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAAqB;IAClD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO;QACL,QAAQ,EAAE;YACR,MAAM,CAAC,MAAe;gBACpB,MAAM,QAAQ,GAAmC,EAAE,CAAC;gBACpD,OAAO;oBACL,EAAE,CAAC,KAAa,EAAE,EAA2B;wBAC3C,IAAI,KAAK,KAAK,MAAM;4BAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAC1C,CAAC;oBACD,KAAK,CAAC,YAAY;wBAChB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;wBAC3B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;4BACvB,MAAM,IAAI,KAAK,CACb,yBAAyB,MAAM,GAAG,CAAC,eAAe,KAAK,CAAC,MAAM,IAAI,CACnE,CAAC;wBACJ,CAAC;wBACD,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,KAAK,UAAU;4BAChD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;4BACd,CAAC,CAAC,IAAI,CAAC,CAAiC,CAAC;wBAC3C,6CAA6C;wBAC7C,KAAK,MAAM,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAGxC,EAAE,CAAC;4BACH,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gCACxC,KAAK,MAAM,CAAC,IAAI,QAAQ;oCAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;4BAC1C,CAAC;wBACH,CAAC;wBACD,MAAM,EAAE,CAAC;wBACT,OAAO,OAAO,CAAC;oBACjB,CAAC;iBACF,CAAC;YACJ,CAAC;SACF;KACa,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -1,58 +1,83 @@
-export declare const AGENTIA_VERSION = "0.2.1";
-export type { Trace, Span, SpanEvent, SpanError, SpanId, SpanKind, SpanStatus, TraceId, UnitType, Usage, } from './core/trace.js';
-export type { AgentTool, JsonSchema, ModelClient, RecorderBackend, ToolRunContext } from './core/tool.js';
+export declare const AGENTIA_VERSION = "0.2.2";
+export type { Trace, Span, SpanEvent, SpanError, SpanId, SpanKind, SpanStatus, TraceId, TraceSink, CapabilityType, Usage, } from './core/trace.js';
+export type { AgentTool, JsonSchema, ModelClient, RecorderBackend, SchemaInput, SchemaType, ToolRunContext, TypedSchema, } from './core/tool.js';
 export { validateJsonSchema } from './core/schema.js';
+export { combineSignals } from './core/abort.js';
 export { runAgent, resolveDefaultModel } from './engine/loop.js';
 export { TraceRecorder } from './engine/tracer.js';
-export { classifyError } from './engine/errors.js';
+export { classifyError, isAbortError } from './engine/errors.js';
+export { isSuccessStopReason } from './engine/types.js';
 export type { AgentRunResult, AgentStopReason, ContextPolicy, RunAgentOptions, SystemParam, SystemTextBlock, } from './engine/types.js';
-export { defaultEstimateTokens, estimateMessages, renderMessages, trimToolPairs, compactMessages, } from './engine/context.js';
-export type { CompactOptions, TrimOptions } from './engine/context.js';
+export { defaultEstimateTokens, estimateMessages, renderMessages, trimToolPairs, compactMessages, } from './engine/trimming.js';
+export type { CompactOptions, TrimOptions } from './engine/trimming.js';
 export { createBudgetPolicy } from './engine/policy.js';
 export type { BudgetPolicyOptions } from './engine/policy.js';
-export { Run, executeRun } from './run/run.js';
-export { RunContext, withRunContext } from './run/context.js';
-export { SystemPrompt } from './run/systemPrompt.js';
-export type { SystemSection } from './run/systemPrompt.js';
-export type { ExecuteRunOptions } from './run/run.js';
-export type { RunMeta, RunStatus } from './run/types.js';
+export { createBudgetGuard } from './engine/budget.js';
+export type { BudgetGuard, BudgetGuardOptions, BudgetSnapshot } from './engine/budget.js';
+export { DEFAULT_PRICING, buildPricing } from './engine/usage.js';
+export type { ModelPricing } from './core/tool.js';
+export { mapWithConcurrency } from './engine/concurrency.js';
+export { DEFAULT_RETRY } from './engine/retry.js';
+export type { RetryOptions } from './engine/retry.js';
+export { Run, executeRun } from './runtime/run.js';
+export { RunContext, withRunContext } from './runtime/context.js';
+export type { Blackboard, BlackboardKey, BlackboardSeed, BlackboardValue, } from './core/blackboard.js';
+export { SystemPrompt } from './runtime/systemPrompt.js';
+export type { SystemPromptOptions, SystemSection } from './runtime/systemPrompt.js';
+export type { ExecuteRunOptions } from './runtime/run.js';
+export type { RunMeta, RunStatus } from './core/run.js';
 export { Container } from './container/container.js';
 export type { Provider, ClassProvider, ValueProvider, FactoryProvider, Token, } from './container/container.js';
 export { asset } from './toolkit/asset.js';
 export { discoverProviders } from './toolkit/discover.js';
 export { applyMiddleware } from './toolkit/middleware.js';
-export type { UnitCall, UnitMiddleware, UnitNext } from './toolkit/middleware.js';
+export type { CapabilityCall, CapabilityMiddleware, CapabilityNext } from './toolkit/middleware.js';
 export { Tool, collectTools } from './toolkit/tool.js';
 export type { ToolSpec } from './toolkit/tool.js';
 export { SubAgent, collectSubAgents, subagentToTool } from './toolkit/subagent.js';
-export type { SubAgentSpec, SubAgentUnit } from './toolkit/subagent.js';
+export type { SubAgentSpec, SubAgentCapability } from './toolkit/subagent.js';
 export { Skill, collectSkills, skillToTool } from './toolkit/skill.js';
-export type { SkillContext, SkillLlmOptions, SkillLlmResult, SkillSpec, SkillUnit, } from './toolkit/skill.js';
+export type { SkillContext, SkillLlmOptions, SkillLlmResult, SkillSpec, SkillCapability, } from './toolkit/skill.js';
 export { Prompt, collectPrompts } from './toolkit/prompt.js';
 export type { PromptSpec } from './toolkit/prompt.js';
-export { createApp, AgentApp } from './toolkit/module.js';
+export { createApp, AgentApp, registerDefaultTraceSink } from './toolkit/module.js';
 export type { AppOptions, RunAppOptions, AgentRunOutput } from './toolkit/module.js';
 export { defineModule } from './toolkit/module.js';
 export type { AgentModule } from './toolkit/module.js';
 export { fromZod } from './toolkit/zod.js';
-export { normalizeMessages } from './run/spec.js';
-export type { RunInput, RunSpec, RunInvocationOptions } from './run/spec.js';
-export { InMemoryTaskStore } from './run/store.js';
-export type { TaskRecord, TaskStore } from './run/store.js';
-export { FileTaskStore } from './run/fsStore.js';
-export { AsyncRunner } from './run/async.js';
-export type { AsyncRunnerOptions, AppCallable } from './run/async.js';
-export { Scheduler } from './run/scheduler.js';
-export type { ScheduleEveryOptions, ScheduleHandle } from './run/scheduler.js';
-export { runSync, createSyncHandler } from './run/transport.js';
-export { createHttpHandler } from './run/http.js';
-export { SqliteTaskStore } from './run/sqliteStore.js';
-export { createOtlpExporter } from './run/otlp.js';
-export { createOpenAIClient } from './run/openai.js';
-export { InMemoryMemoryStore } from './run/memory.js';
-export type { MemoryStore } from './run/memory.js';
-export { RedisTaskStore } from './run/redisStore.js';
-export type { RedisLike } from './run/redisStore.js';
-export type { MaybePromise } from './run/store.js';
+export { normalizeMessages } from './engine/spec.js';
+export type { RunInput, RunSpec, RunInvocationOptions } from './engine/spec.js';
+export { InMemoryTaskStore } from './store/store.js';
+export type { TaskRecord, TaskStore } from './store/store.js';
+export { FileTaskStore } from './store/fsStore.js';
+export { AsyncRunner } from './transport/async.js';
+export type { AppCallable, AsyncRunnerOptions, ResumePendingOptions, TaskSink, } from './transport/async.js';
+export { Scheduler } from './transport/scheduler.js';
+export type { ScheduleEveryOptions, ScheduleHandle } from './transport/scheduler.js';
+export { runSync, createSyncHandler } from './transport/transport.js';
+export { createHttpHandler, HttpException } from './transport/http.js';
+export type { HttpHandlerOptions, HttpHandler, HealthResponse, RunHttpResponse, TaskSubmitBody, } from './transport/http.js';
+export { SqliteTaskStore } from './store/sqliteStore.js';
+export { createOtlpExporter } from './integrations/otlp.js';
+export { createOpenAIClient } from './integrations/openai.js';
+export { createAnthropicClient } from './integrations/anthropic.js';
+export type { AnthropicClientOptions } from './integrations/anthropic.js';
+export { InMemoryMemoryStore } from './runtime/memory.js';
+export type { MemoryStore } from './runtime/memory.js';
+export { InMemorySessionStore } from './runtime/session.js';
+export type { SessionStore } from './runtime/session.js';
+export { RedisTaskStore } from './store/redisStore.js';
+export type { RedisLike, RedisSetOptions, RedisTaskStoreOptions } from './store/redisStore.js';
+export type { MaybePromise } from './store/store.js';
 export { traceToMessages } from './engine/replay.js';
 export type { ReplayOptions } from './engine/replay.js';
+export { mcpTools, MCP_DEFAULT_TIMEOUT_MS } from './integrations/mcp.js';
+export type { McpClientLike, McpToolInfo, McpToolsOptions } from './integrations/mcp.js';
+export { metricsSink, DEFAULT_BUCKETS } from './integrations/metrics.js';
+export type { MetricsSink, MetricsSinkOptions, MetricsSnapshot, ModelMetrics, CapabilityMetrics, } from './integrations/metrics.js';
+export { buildRunReport, mergeRunReports, renderRunReport } from './integrations/report.js';
+export type { DurationReport, ModelReport, RunReport, CapabilityReport, } from './integrations/report.js';
+export { scriptedClient } from './eval/scripted.js';
+export type { ScriptedStep } from './eval/scripted.js';
+export { defineEval } from './eval/defineEval.js';
+export type { EvalCase, EvalCaseReport, EvalContext, EvalDefinition, EvalReport, } from './eval/defineEval.js';

package/dist/index.js

@@ -1,19 +1,26 @@
-export const AGENTIA_VERSION = '0.2.1';
+export const AGENTIA_VERSION = '0.2.2';
 export { validateJsonSchema } from './core/schema.js';
+export { combineSignals } from './core/abort.js';
 // engine：运行时内核
 export { runAgent, resolveDefaultModel } from './engine/loop.js';
 export { TraceRecorder } from './engine/tracer.js';
-export { classifyError } from './engine/errors.js';
+export { classifyError, isAbortError } from './engine/errors.js';
+export { isSuccessStopReason } from './engine/types.js';
 // engine：长上下文策略
-export { defaultEstimateTokens, estimateMessages, renderMessages, trimToolPairs, compactMessages, } from './engine/context.js';
+export { defaultEstimateTokens, estimateMessages, renderMessages, trimToolPairs, compactMessages, } from './engine/trimming.js';
 export { createBudgetPolicy } from './engine/policy.js';
+export { createBudgetGuard } from './engine/budget.js';
+// engine：用量与成本（F1 价格表可注入 / F2 未定价显式）
+export { DEFAULT_PRICING, buildPricing } from './engine/usage.js';
+export { mapWithConcurrency } from './engine/concurrency.js';
+export { DEFAULT_RETRY } from './engine/retry.js';
 // run：run 生命周期
-export { Run, executeRun } from './run/run.js';
-export { RunContext, withRunContext } from './run/context.js';
-export { SystemPrompt } from './run/systemPrompt.js';
+export { Run, executeRun } from './runtime/run.js';
+export { RunContext, withRunContext } from './runtime/context.js';
+export { SystemPrompt } from './runtime/systemPrompt.js';
 // container：显式 DI
 export { Container } from './container/container.js';
-// toolkit：声明式单元 + 应用装配
+// toolkit：声明式能力 + 应用装配
 export { asset } from './toolkit/asset.js';
 export { discoverProviders } from './toolkit/discover.js';
 export { applyMiddleware } from './toolkit/middleware.js';
@@ -21,22 +28,33 @@ export { Tool, collectTools } from './toolkit/tool.js';
 export { SubAgent, collectSubAgents, subagentToTool } from './toolkit/subagent.js';
 export { Skill, collectSkills, skillToTool } from './toolkit/skill.js';
 export { Prompt, collectPrompts } from './toolkit/prompt.js';
-export { createApp, AgentApp } from './toolkit/module.js';
+export { createApp, AgentApp, registerDefaultTraceSink } from './toolkit/module.js';
 export { defineModule } from './toolkit/module.js';
 export { fromZod } from './toolkit/zod.js';
 // run：触发传输 + run 存储
-export { normalizeMessages } from './run/spec.js';
-export { InMemoryTaskStore } from './run/store.js';
-export { FileTaskStore } from './run/fsStore.js';
-export { AsyncRunner } from './run/async.js';
-export { Scheduler } from './run/scheduler.js';
-export { runSync, createSyncHandler } from './run/transport.js';
+export { normalizeMessages } from './engine/spec.js';
+export { InMemoryTaskStore } from './store/store.js';
+export { FileTaskStore } from './store/fsStore.js';
+export { AsyncRunner } from './transport/async.js';
+export { Scheduler } from './transport/scheduler.js';
+export { runSync, createSyncHandler } from './transport/transport.js';
 // run：宿主与导出（R3/R4）
-export { createHttpHandler } from './run/http.js';
-export { SqliteTaskStore } from './run/sqliteStore.js';
-export { createOtlpExporter } from './run/otlp.js';
-export { createOpenAIClient } from './run/openai.js';
-export { InMemoryMemoryStore } from './run/memory.js';
-export { RedisTaskStore } from './run/redisStore.js';
+export { createHttpHandler, HttpException } from './transport/http.js';
+export { SqliteTaskStore } from './store/sqliteStore.js';
+export { createOtlpExporter } from './integrations/otlp.js';
+export { createOpenAIClient } from './integrations/openai.js';
+export { createAnthropicClient } from './integrations/anthropic.js';
+export { InMemoryMemoryStore } from './runtime/memory.js';
+export { InMemorySessionStore } from './runtime/session.js';
+export { RedisTaskStore } from './store/redisStore.js';
 export { traceToMessages } from './engine/replay.js';
+// integrations：MCP 桥（D1）—— duck-typed，框架零依赖；连接器在独立包 @migor/mcp
+export { mcpTools, MCP_DEFAULT_TIMEOUT_MS } from './integrations/mcp.js';
+// integrations：指标（D3 → E2/E3/E4/E5）—— 满足 TraceSink 即可接入，能力零新出口
+export { metricsSink, DEFAULT_BUCKETS } from './integrations/metrics.js';
+// integrations：调优报告（G1）—— 纯函数，从 trace 派生「哪个能力慢/贵/爱失败」
+export { buildRunReport, mergeRunReports, renderRunReport } from './integrations/report.js';
+// eval：把 mockClient 提升为一等能力（D2）—— 叶子消费模块，只依赖公共面
+export { scriptedClient } from './eval/scripted.js';
+export { defineEval } from './eval/defineEval.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAgBvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,eAAe;AACf,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAUnD,gBAAgB;AAChB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,eAAe;AACf,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAKrD,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AASrD,uBAAuB;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQvE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,mBAAmB;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/integrations/anthropic.d.ts

@@ -0,0 +1,53 @@
+import type { ModelClient } from '../core/tool.js';
+/**
+ * Agentia —— 默认 ModelClient：Anthropic Messages API。
+ *
+ * **为什么要有这个工厂**：这是 `@anthropic-ai/sdk` 在框架内的**唯一实例化点**。
+ * 引擎（`engine/loop.ts`）只经由此处取默认 client，不再散落 `new Anthropic()`。两个好处：
+ *
+ * ① **使用者不必接触厂商 SDK 的类** —— 想自定义只传 `apiKey` / `baseURL`
+ *    （或直接用环境变量 `ANTHROPIC_API_KEY` / `ANTHROPIC_BASE_URL`）；
+ * ② 厂商 SDK 成为一个**可替换的实现细节** —— 将来若换自研 fetch 实现（去掉依赖），
+ *    只动这一个文件，引擎与公共契约都不变。
+ *
+ * 契约：返回值必须满足 `core` 的 `ModelClient` 结构面。
+ *
+ * ⚠️ **不能直接 `return new Anthropic(...)`**（2026-09-14 修）：`ModelClient` 契约把 `signal`
+ * 放在 **params 内部**，而 SDK 的签名是 `stream(body, options?)`，`signal` **只在 `RequestOptions`
+ * 里认**。把 signal 放 body 里会被 SDK **静默丢弃** ⇒ 调用方无法中止在飞请求。
+ * 真端点实测（`scripts/e2e-live.ts` 步骤 ⑤）：
+ *
+ * | signal 位置 | abort 后的实测结果 |
+ * |---|---|
+ * | body 内（旧实现） | 收到 **599 个分片后仍跑完**，1.4s 才结束 —— 中止被吞 |
+ * | RequestOptions（现实现） | 2 个分片即断，**1ms** 内以 `Request was aborted.` 收场 |
+ *
+ * 这不只是「少个功能」：`transport/async.ts` 的 `runTimeoutMs` 对外承诺「到点真中止、
+ * token 不再继续烧」，靠的就是这个 signal。旧实现下超时的 run 会在后台**继续烧 token**
+ * 直到模型自己说完。`integrations/openai.ts` 是手写 fetch，本来就转发 signal（无此问题）。
+ */
+export interface AnthropicClientOptions {
+    /** 缺省读环境变量 `ANTHROPIC_API_KEY` */
+    apiKey?: string;
+    /** 缺省读环境变量 `ANTHROPIC_BASE_URL`（兼容端点 / 网关） */
+    baseURL?: string;
+    /** 其余构造参数原样透传给 SDK（高级用法） */
+    [key: string]: unknown;
+}
+/**
+ * 把 `ModelClient` 契约里的 `signal`（在 params 内部）拆到 SDK 的 `RequestOptions` 上。
+ *
+ * 单独导出只为**可测**：这是「默认 client 到底能不能中止在飞请求」的唯一分界点，
+ * 白盒探查 SDK 内部不现实，但这一步的输入/输出可以钉死（见 `tests/integrations/anthropic.test.ts`）。
+ */
+export declare function splitSignal(params: {
+    signal?: AbortSignal | null;
+    [key: string]: unknown;
+}): {
+    body: Record<string, unknown>;
+    options: {
+        signal?: AbortSignal;
+    };
+};
+/** 创建默认 ModelClient（Anthropic）。不传则完全走 SDK 的默认凭据解析。 */
+export declare function createAnthropicClient(options?: AnthropicClientOptions): ModelClient;

package/dist/integrations/anthropic.js

@@ -0,0 +1,24 @@
+import Anthropic from '@anthropic-ai/sdk';
+/**
+ * 把 `ModelClient` 契约里的 `signal`（在 params 内部）拆到 SDK 的 `RequestOptions` 上。
+ *
+ * 单独导出只为**可测**：这是「默认 client 到底能不能中止在飞请求」的唯一分界点，
+ * 白盒探查 SDK 内部不现实，但这一步的输入/输出可以钉死（见 `tests/integrations/anthropic.test.ts`）。
+ */
+export function splitSignal(params) {
+    const { signal, ...body } = params;
+    return { body, options: signal ? { signal } : {} };
+}
+/** 创建默认 ModelClient（Anthropic）。不传则完全走 SDK 的默认凭据解析。 */
+export function createAnthropicClient(options = {}) {
+    const client = new Anthropic(options);
+    const messages = client.messages;
+    const nativeStream = messages.stream.bind(messages);
+    // 包一层：把契约里的 signal 搬到 RequestOptions（详见文件头注释里的实测对照表）。
+    messages.stream = ((body, requestOptions) => {
+        const { body: cleanBody, options: signalOptions } = splitSignal(body);
+        return nativeStream(cleanBody, { ...requestOptions, ...signalOptions });
+    });
+    return client;
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/integrations/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/integrations/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAuC1C;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAA+D;IAIzF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACnC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACrD,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,qBAAqB,CAAC,OAAO,GAA2B,EAAE;IACxE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,OAAqD,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpD,sDAAsD;IACtD,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAA6B,EAAE,cAAwC,EAAE,EAAE;QAC7F,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,YAAY,CAAC,SAAkB,EAAE,EAAE,GAAG,cAAc,EAAE,GAAG,aAAa,EAAE,CAAC,CAAC;IACnF,CAAC,CAA2B,CAAC;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/integrations/mcp.d.ts

@@ -0,0 +1,79 @@
+import type { AgentTool } from '../core/tool.js';
+/**
+ * Agentia —— MCP 桥（D1，spec §10 决策记录）。
+ *
+ * 设计原则同 `RedisLike`：框架只定义**结构面**，不 import `@modelcontextprotocol/sdk`，
+ * 也**不含任何传输实现**（stdio spawn / StreamableHTTP 都在独立可选包 `@migor/mcp`，
+ * 或用户自己接 SDK 后实现 `McpClientLike`）。本文件只依赖 core，符合分层约定
+ * （`integrations` → `core`）。
+ *
+ * 用法：在 `createApp({ providers })` 里放一个 provider 即可 ——
+ * ```ts
+ * createApp({
+ *   system: '…',
+ *   providers: [{ provide: 'mcp', useFactory: () => mcpTools(client, { server: 'time' }) }],
+ * });
+ * ```
+ * 复用既有装配 / 查重 / 中间件，**零新机制**（MCP 工具与本地 @Tool 同处一个命名空间，
+ * 重名由 AgentApp 的装配期查重拦下）。
+ *
+ * 不做（YAGNI，见 spec §10）：`sampling`（server 反向请求模型）、`resources` / `prompts`
+ * 原语（只做 tools）、连接池。
+ */
+/** MCP server 的 `tools/list` 条目（结构面子集：多出来的字段一律忽略） */
+export interface McpToolInfo {
+    name: string;
+    description?: string;
+    /** MCP 协议里已是 JSON Schema → 直接当框架的 `inputSchema` 用 */
+    inputSchema?: unknown;
+}
+/**
+ * MCP client 的最小结构面：任何实现了 `tools/list` + `tools/call` 的客户端都能接，
+ * 无需继承、无需 import 任何 SDK（duck-typed，与 `RedisLike` 同款）。
+ *
+ * 约定：`callTool` 失败请**抛错**（框架会包成 `is_error` 的 tool_result 回给模型，
+ * 不中断 run —— 与本地工具抛错同语义）。MCP 协议层的 `isError: true` 请由连接器
+ * 转成抛错，否则模型看不到失败。
+ */
+export interface McpClientLike {
+    listTools(): Promise<McpToolInfo[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+}
+export interface McpToolsOptions {
+    /**
+     * 工具名前缀，避免与本地能力撞名。缺省 `mcp_<server>_`；没给 `server` 时缺省 `mcp_`。
+     * 传 `''` 表示不加前缀（此时 MCP 原名直接进菜单，撞名风险自负）。
+     */
+    prefix?: string;
+    /** server 标识，只用于拼缺省前缀（不会发给 server） */
+    server?: string;
+    /**
+     * 单次 `callTool` 超时（毫秒），缺省 60000；非正数 = 不限。
+     * 超时**不杀 run**：该条 tool_result 记 `is_error` 回模型（与 engine 的
+     * `toolTimeoutMs` 同语义，只是这里由桥自己兜 —— 双保险，谁短谁生效）。
+     */
+    timeoutMs?: number;
+}
+/** 缺省超时：MCP server 可能去连外部系统，60s 是「明显卡死」与「慢但正常」的分界 */
+export declare const MCP_DEFAULT_TIMEOUT_MS = 60000;
+/**
+ * 给一次 MCP 调用套超时。⚠️ 与 engine 的 `withTimeout` 同样是**放弃等待**而非取消 ——
+ * MCP 的 `notifications/cancelled` 属于连接器职责，桥这一层拿不到取消句柄。
+ *
+ * 转导导出（module 级，**不进公共面**）只为可测：`tests/timeoutLiveness.test.ts` 拿它验
+ * 「截止计时器不得 unref」—— 那是「被 await 的超时到底会不会触发」的唯一分界点。
+ */
+export declare function withDeadline<T>(p: Promise<T>, timeoutMs: number, label: string): Promise<T>;
+/**
+ * 把一个 MCP server 的工具映射成框架的 `AgentTool[]`（可直接进 `tools` / providers）。
+ *
+ * - **名字**：`prefix + 归一化原名`；归一化后同名的两条直接抛错（否则装配期查重只会报
+ *   「菜单能力重名」，看不出根因是 MCP 名撞了）；
+ * - **原名**：每次调用时写进发起 turn 的 `mcp.tool` attribute（审计 / 回放要还原出
+ *   回调 server 用的原名）；
+ * - **入参 schema**：MCP 的 `inputSchema` 已是 JSON Schema → 原样透传，由 engine 的
+ *   子集校验器在 `callTool` 之前先校验（非法入参根本不会发出，模型自己会改）；
+ * - **返回结构**：MCP 的结果对象（`content` 数组等）原样交给 engine 序列化，
+ *   不做「把 content 拼成字符串」这类有损加工 —— 需要塑形请自行包一层工具。
+ */
+export declare function mcpTools(client: McpClientLike, opts?: McpToolsOptions): Promise<AgentTool[]>;

package/dist/integrations/mcp.js

@@ -0,0 +1,108 @@
+/** 缺省超时：MCP server 可能去连外部系统，60s 是「明显卡死」与「慢但正常」的分界 */
+export const MCP_DEFAULT_TIMEOUT_MS = 60_000;
+/**
+ * 工具名归一化：MCP 名可含 `-` / `.` / `/` / 空格等（对 LLM API 不友好或非法）
+ * → 一律转 `_`，并把连续分隔符收成一个（`foo..bar` → `foo_bar`）。
+ * 归一化后仍非法（空名 / 超长）直接抛错，**不静默改名** —— 静默截断会得到一个
+ * 调用不回去的名字，比启动期报错难查得多。
+ */
+function normalizeToolName(raw) {
+    const cleaned = raw
+        .trim()
+        .replace(/[^A-Za-z0-9_]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+    return cleaned;
+}
+/** 超时哨兵：区分「超时」与「工具恰好返回了 undefined」（同 engine 的 TIMED_OUT） */
+const TIMED_OUT = Symbol('agentia.mcp.timed-out');
+/**
+ * 给一次 MCP 调用套超时。⚠️ 与 engine 的 `withTimeout` 同样是**放弃等待**而非取消 ——
+ * MCP 的 `notifications/cancelled` 属于连接器职责，桥这一层拿不到取消句柄。
+ *
+ * 转导导出（module 级，**不进公共面**）只为可测：`tests/timeoutLiveness.test.ts` 拿它验
+ * 「截止计时器不得 unref」—— 那是「被 await 的超时到底会不会触发」的唯一分界点。
+ */
+export async function withDeadline(p, timeoutMs, label) {
+    if (!(timeoutMs > 0))
+        return p;
+    let timer;
+    try {
+        const raced = await Promise.race([
+            p,
+            new Promise((resolve) => {
+                timer = setTimeout(() => resolve(TIMED_OUT), timeoutMs);
+                // ⚠️ 不 unref：同 engine 的 `withTimeout` —— 它的触发是「这个 await 得以结束」的条件。
+                // unref 过它 ⇒ 空事件循环下进程先退出，挂起的 MCP 调用让整段代码静默消失。
+            }),
+        ]);
+        if (raced === TIMED_OUT) {
+            throw new Error(`MCP 工具 "${label}" 调用超时（超过 ${timeoutMs}ms）`);
+        }
+        return raced;
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+/**
+ * 把一个 MCP server 的工具映射成框架的 `AgentTool[]`（可直接进 `tools` / providers）。
+ *
+ * - **名字**：`prefix + 归一化原名`；归一化后同名的两条直接抛错（否则装配期查重只会报
+ *   「菜单能力重名」，看不出根因是 MCP 名撞了）；
+ * - **原名**：每次调用时写进发起 turn 的 `mcp.tool` attribute（审计 / 回放要还原出
+ *   回调 server 用的原名）；
+ * - **入参 schema**：MCP 的 `inputSchema` 已是 JSON Schema → 原样透传，由 engine 的
+ *   子集校验器在 `callTool` 之前先校验（非法入参根本不会发出，模型自己会改）；
+ * - **返回结构**：MCP 的结果对象（`content` 数组等）原样交给 engine 序列化，
+ *   不做「把 content 拼成字符串」这类有损加工 —— 需要塑形请自行包一层工具。
+ */
+export async function mcpTools(client, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? MCP_DEFAULT_TIMEOUT_MS;
+    const prefix = opts.prefix ?? (opts.server === undefined ? 'mcp_' : `mcp_${normalizeToolName(opts.server)}_`);
+    const listed = await client.listTools();
+    const seen = new Map(); // 归一化名 → 首个占位的 MCP 原名
+    const tools = [];
+    for (const info of listed) {
+        const original = info.name;
+        if (typeof original !== 'string' || original.trim() === '') {
+            throw new Error(`MCP server 返回了空工具名：${JSON.stringify(info.name)}`);
+        }
+        const name = `${prefix}${normalizeToolName(original)}`;
+        if (!/^[A-Za-z0-9_-]{1,64}$/.test(name)) {
+            throw new Error(`MCP 工具名 "${original}" 归一化后为 "${name}"，不满足 ^[A-Za-z0-9_-]{1,64}$` +
+                `（前缀 "${prefix}" 过长或原名含过多非法字符）—— 请换个更短的 prefix`);
+        }
+        const dup = seen.get(name);
+        if (dup !== undefined) {
+            throw new Error(`MCP 工具名归一化后撞名：${JSON.stringify(dup)} 与 ${JSON.stringify(original)} ` +
+                `都变成 "${name}" —— 请给其中一个在 server 侧改名，或用 prefix 区分`);
+        }
+        seen.set(name, original);
+        const schema = info.inputSchema && typeof info.inputSchema === 'object' && !Array.isArray(info.inputSchema)
+            ? info.inputSchema
+            : { type: 'object' };
+        tools.push({
+            name,
+            description: info.description?.trim() || `MCP 工具 ${original}`,
+            inputSchema: schema,
+            run: async (input, ctx) => {
+                // 原名先落账再调用：连接器抛错/超时时，trace 里仍留得下「本想调谁」
+                if (ctx) {
+                    try {
+                        ctx.recorder.setAttribute(ctx.parentSpanId, 'mcp.tool', original);
+                    }
+                    catch {
+                        /* 观测是辅助动作：记账失败不得把一次正常调用变成失败 */
+                    }
+                }
+                const args = input && typeof input === 'object' && !Array.isArray(input)
+                    ? input
+                    : {};
+                return withDeadline(client.callTool(original, args), timeoutMs, original);
+            },
+        });
+    }
+    return tools;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/integrations/mcp.js.map

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