@migor/agentia 0.4.2 → 0.6.0

package/dist/engine/errors.js

@@ -1,25 +1,58 @@
-import Anthropic from '@anthropic-ai/sdk';
+/**
+ * Agentia —— 异常分类（engine 对厂商 SDK 零运行时 import）。
+ *
+ * 分类是**鸭子类型**：默认 client（`integrations/anthropic.ts`）自研化后抛的是
+ * 带数值 `status` 的 `AnthropicApiError` 与 fetch 的原生网络错误（TypeError 带 cause），
+ * 不再是 SDK 错误类。同套判法对第三方 SDK 错误同样适用（它们的错误类也带 `status`）。
+ *
+ * 历史教训（2026-09-13 实测，当时因此保留 instanceof）：厂商 SDK 的错误类
+ * `name` 恒为 `'Error'`、`type` 为 null，鸭子类型只能靠 `constructor.name` ——
+ * **压缩即失效**。所以这里只认**数据属性**（`status` 数值 / `cause` / errno `code` /
+ * 内建 DOMException 的 `name`），一概不碰构造函数名。
+ */
 /** 是否中断异常（DOMException / 普通 Error 都可能是，靠 name 判定） */
 export function isAbortError(e) {
     return typeof e === 'object' && e !== null && e.name === 'AbortError';
 }
+/** 取错误的可读 message（Error 取 .message，其余 String 兜底） */
+function messageOf(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+/** errno 形态的连接错误码（Node 网络层稳定产出，不靠 message 文案） */
+const CONNECTION_CODES = /^(ECONNRESET|ECONNREFUSED|ETIMEDOUT|EAI_AGAIN|ENOTFOUND|EPIPE|ENETUNREACH|EHOSTUNREACH|ECONNABORTED)$/;
+/**
+ * 无 status 的网络型错误 → connection。
+ * 稳的判法（不过拟合 message 字符串）：
+ * - fetch 的网络失败是 `TypeError` 且带 `cause`（undici 保证，cause 里常有 errno）；
+ * - 带 errno `code` 属性的 Error（Node 网络层直接抛的形态）；
+ * - `name === 'TimeoutError'` 的 DOMException（`AbortSignal.timeout` / 默认 client 的
+ *   timeout 合成信号）—— 内建 name 是规范值，不受压缩影响。
+ */
+function isConnectionError(e) {
+    if (e instanceof TypeError && e.cause != null)
+        return true;
+    const code = e.code;
+    if (typeof code === 'string' && CONNECTION_CODES.test(code))
+        return true;
+    return e.name === 'TimeoutError';
+}
 /** 把任意异常分类成 trace 可用的 SpanError（可重试 vs 不可重试）。 */
 export function classifyError(e) {
     if (isAbortError(e)) {
         return { type: 'aborted', message: 'run 已被取消', retryable: false };
     }
-    if (e instanceof Anthropic.RateLimitError) {
-        return { type: 'rate_limit', message: e.message, retryable: true };
-    }
-    if (e instanceof Anthropic.APIConnectionError) {
-        return { type: 'connection', message: e.message, retryable: true };
-    }
-    if (e instanceof Anthropic.InternalServerError) {
-        return { type: 'server', message: e.message, retryable: true };
-    }
-    if (e instanceof Anthropic.APIError) {
-        const status = e.status ?? 0;
-        return { type: 'api', message: e.message, retryable: status >= 500 || status === 429 };
+    if (typeof e === 'object' && e !== null) {
+        const status = e.status;
+        if (typeof status === 'number' && Number.isFinite(status)) {
+            if (status === 429)
+                return { type: 'rate_limit', message: messageOf(e), retryable: true };
+            if (status >= 500)
+                return { type: 'server', message: messageOf(e), retryable: true };
+            return { type: 'api', message: messageOf(e), retryable: false };
+        }
+        if (isConnectionError(e)) {
+            return { type: 'connection', message: messageOf(e), retryable: true };
+        }
     }
     if (e instanceof Error) {
         return { type: 'unknown', message: e.message, retryable: false };

package/dist/engine/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/engine/errors.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAG1C,qDAAqD;AACrD,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAK,CAAwB,CAAC,IAAI,KAAK,YAAY,CAAC;AAChG,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpE,CAAC;IACD,IAAI,CAAC,YAAY,SAAS,CAAC,cAAc,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,YAAY,SAAS,CAAC,kBAAkB,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,YAAY,SAAS,CAAC,mBAAmB,EAAE,CAAC;QAC/C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,YAAY,SAAS,CAAC,QAAQ,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;IACzF,CAAC;IACD,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACnE,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/engine/errors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,qDAAqD;AACrD,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAK,CAAwB,CAAC,IAAI,KAAK,YAAY,CAAC;AAChG,CAAC;AAED,oDAAoD;AACpD,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,iDAAiD;AACjD,MAAM,gBAAgB,GACpB,uGAAuG,CAAC;AAE1G;;;;;;;GAOG;AACH,SAAS,iBAAiB,CAAC,CAAS;IAClC,IAAI,CAAC,YAAY,SAAS,IAAK,CAAyB,CAAC,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACpF,MAAM,IAAI,GAAI,CAAwB,CAAC,IAAI,CAAC;IAC5C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,OAAQ,CAAwB,CAAC,IAAI,KAAK,cAAc,CAAC;AAC3D,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpE,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,MAAM,MAAM,GAAI,CAA0B,CAAC,MAAM,CAAC;QAClD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1D,IAAI,MAAM,KAAK,GAAG;gBAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YAC1F,IAAI,MAAM,IAAI,GAAG;gBAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YACrF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAClE,CAAC;QACD,IAAI,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACxE,CAAC;IACH,CAAC;IACD,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACnE,CAAC"}

package/dist/engine/loop.d.ts

@@ -1,4 +1,4 @@
-import type Anthropic from '@anthropic-ai/sdk';
+import type { MessageParam } from '../core/message.js';
 import type { AgentTool, JsonSchema, ModelClient, ModelPricing, RecorderBackend, SchemaType } from '../core/tool.js';
 import type { SpanError, SpanId } from '../core/trace.js';
 import type { RetryOptions } from './retry.js';
@@ -9,6 +9,21 @@ import type { AgentRunResult, AgentStopReason, ContextPolicy, RunAgentOptions, S
  * export AGENTIA_MODEL=deepseek-… 即可全局覆盖，无需逐处传 model。
  */
 export declare function resolveDefaultModel(over?: string): string;
+/**
+ * Agentia —— 主循环（manual loop，流式）—— spec §5。
+ *
+ * 结构：核心是 `agentLoop` —— 不自开 run 根，所有 llm.turn 挂在给定的
+ * parentSpanId 下。同一套循环既能当主 agent（run 根为其父，由 runAgent 开），
+ * 也能当子 agent（capability span 为其父，见 toolkit/subagent.ts），llm.turn 与 usage
+ * 递归进同一条 trace（spec §9：子 agent = 一个 capability span，内部能力递归成它的子孙）。
+ *
+ * 工具执行经 ctx: ToolRunContext 把 {client, recorder, parentSpanId: 当前 turn}
+ * 交给 tool.run —— 普通工具忽略；子 agent 用它在正确位置开 capability span。
+ *
+ * 文件分工：本文件只留入口（runAgent / runAgentScoped）与 agentLoop 编排骨架 +
+ * 缺省旋钮；「一回合执行步骤」的实现机（回合上下文、请求/重试、记账、stop_reason
+ * 分流、工具执行）拆在同层 turn.ts，依赖方向单向 loop.ts → turn.ts。
+ */
 export interface AgentLoopResult<T = unknown> {
     stopReason: AgentStopReason;
     finalText: string;
@@ -28,7 +43,7 @@ export declare function runAgent<S extends JsonSchema = JsonSchema>(options: Run
 export declare function runAgentScoped<S extends JsonSchema = JsonSchema>(opts: {
     client?: ModelClient;
     system?: SystemParam;
-    messages: Anthropic.MessageParam[];
+    messages: MessageParam[];
     tools?: AgentTool[];
     model?: string;
     maxTokens?: number;
@@ -66,12 +81,3 @@ export declare function runAgentScoped<S extends JsonSchema = JsonSchema>(opts:
     /** 成本硬管控（C1）：累计成本（美元）上限；同 maxTotalTokens */
     maxCostUsd?: number;
 }): Promise<AgentLoopResult<SchemaType<S>>>;
-/**
- * 用 `next` 原地替换 `target` 的全部内容（保持数组引用不变 —— 循环各处持同一数组）。
- *
- * **不要**写回 `target.splice(0, target.length, ...next)`：展开传参受 V8 实参个数上限
- * 约束，`next` 超过约 12 万项即抛 `RangeError: Maximum call stack size exceeded`
- * （实测 12 万 ok、30 万抛）。`next` 来自调用方注入的 `contextPolicy`，长度不受框架
- * 控制，所以用循环逐项写，彻底没有这个上限。
- */
-export declare function replaceMessages(target: Anthropic.MessageParam[], next: readonly Anthropic.MessageParam[]): void;