@zmzai/agent-framework 0.5.1 → 0.8.0

package/dist/adapters/terminal-backend.d.ts

@@ -2,6 +2,17 @@ import type { TerminalBackend } from "../core/tools/terminal.js";
 /** 宿主终端后端单例：优先真 PTY，node-pty 不可用或 spawn 探测失败时降级管道模式。
  *  首次调用即锁定后端种类（同步），session 标签从此不存在竞态。 */
 export declare function createHostTerminalBackend(): TerminalBackend;
+/** pty 探测命令（纯函数，便于跨平台单测）。
+ *  `exit 0` 在 sh -c / pwsh -Command / cmd /c 下语义一致：立即退出且退出码 0，
+ *  绝不能换成交互式变体（会话永不退出，见 shellSpecFor 的 -NoExit 教训）。 */
+export declare function probeCommandFor(platform: NodeJS.Platform, availability: {
+    hasPwsh: boolean;
+    hasPowershell: boolean;
+    comSpec?: string | undefined;
+}): {
+    file: string;
+    args: string[];
+};
 /** 一次性执行型 shell 规格（纯函数，便于跨平台单测）。
  *
  *  语义必须与 POSIX 的 `sh -c "<command>"` 对齐：命令跑完 shell 即退出。

package/dist/adapters/terminal-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-backend.d.ts","sourceRoot":"","sources":["../../src/adapters/terminal-backend.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AA4DjE;yCACyC;AACzC,wBAAgB,yBAAyB,IAAI,eAAe,CAQ3D;AAkBD;;;;;gDAKgD;AAChD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,YAAY,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAWxC"}
+{"version":3,"file":"terminal-backend.d.ts","sourceRoot":"","sources":["../../src/adapters/terminal-backend.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AA4DjE;yCACyC;AACzC,wBAAgB,yBAAyB,IAAI,eAAe,CAQ3D;AAuBD;;sDAEsD;AACtD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,YAAY,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAGlC;AAED;;;;;gDAKgD;AAChD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,YAAY,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAWxC"}

package/dist/adapters/terminal-backend.js

@@ -49,10 +49,15 @@ export function createHostTerminalBackend() {
     }
     return cachedBackend;
 }
-/** 同步 spawn 探测：能 fork /bin/sh -c true 即认为 pty 可用。 */
+/** 同步 spawn 探测：用宿主一次性 shell 规格跑 `exit 0`，能起 pty 即认为可用。
+ *
+ *  回归锚点：这里曾硬编码 `/bin/sh -c true`——Windows 上没有 /bin/sh，探测必失败，
+ *  导致打包版在真实 Windows 上**永久静默降级 pipe**（macOS 一直绿，CI 冒烟首次
+ *  跑到 backend === "pty" 断言才暴露）。探测必须走 shell() 的跨平台规格。 */
 function probePtySpawn(mod) {
     try {
-        const term = mod.spawn("/bin/sh", ["-c", "true"], {
+        const { file, prefixArgs } = shell();
+        const term = mod.spawn(file, [...prefixArgs, "exit 0"], {
             name: "xterm-256color",
             cols: 20,
             rows: 5,
@@ -65,6 +70,13 @@ function probePtySpawn(mod) {
         return false;
     }
 }
+/** pty 探测命令（纯函数，便于跨平台单测）。
+ *  `exit 0` 在 sh -c / pwsh -Command / cmd /c 下语义一致：立即退出且退出码 0，
+ *  绝不能换成交互式变体（会话永不退出，见 shellSpecFor 的 -NoExit 教训）。 */
+export function probeCommandFor(platform, availability) {
+    const { file, prefixArgs } = shellSpecFor(platform, availability);
+    return { file, args: [...prefixArgs, "exit 0"] };
+}
 /** 一次性执行型 shell 规格（纯函数，便于跨平台单测）。
  *
  *  语义必须与 POSIX 的 `sh -c "<command>"` 对齐：命令跑完 shell 即退出。

package/dist/adapters/terminal-backend.js.map

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

package/dist/core/events/bus.js

@@ -1,4 +1,4 @@
-import { frameworkEventSchemas } from "./manifest.js";
+import { frameworkEventSchemas, toPersistedEvent } from "./manifest.js";
 import { newEventId } from "../session/ids.js";
 // ---- In-memory implementation (single-process demo/tests) ----
 export function createMemoryEventLog() {
@@ -10,14 +10,14 @@ export function createMemoryEventLog() {
             if (!parsed.success)
                 throw new Error(`INVALID_FRAMEWORK_EVENT: ${event.type} ${parsed.error.issues[0]?.message ?? ""}`);
             const list = store.get(event.sessionId) ?? [];
-            const persisted = {
+            const persisted = toPersistedEvent({
                 id: newEventId(),
                 sessionId: event.sessionId,
                 seq: list.length + 1,
                 type: event.type,
                 data: parsed.data,
                 at: new Date().toISOString(),
-            };
+            });
             list.push(persisted);
             store.set(event.sessionId, list);
             return persisted;

package/dist/core/events/bus.js.map

@@ -1 +1 @@
-{"version":3,"file":"bus.js","sourceRoot":"","sources":["../../../src/core/events/bus.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bus.js","sourceRoot":"","sources":["../../../src/core/events/bus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAgB/C,iEAAiE;AAEjE,MAAM,UAAU,oBAAoB;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqC,CAAC;IAC3D,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,KAAK;YAChB,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAA0B,CAAC,CAAC;YACvE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;YACxH,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAC9C,MAAM,SAAS,GAAG,gBAAgB,CAAC;gBACjC,EAAE,EAAE,UAAU,EAAE;gBAChB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,GAAG,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC;gBACpB,IAAI,EAAE,KAAK,CAAC,IAA0B;gBACtC,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC7B,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACjC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK;YACnC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,SAAS;YACnB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAC7C,CAAC;KACF,CAAC;AACJ,CAAC;AAYD;;4EAE4E;AAC5E,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,iBAAiB,CAAC,GAAa,EAAE,SAAiB,EAAE,UAA4B,EAAE;IACvG,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;IACvD,IAAI,MAAM,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmC,CAAC;IACzD,IAAI,IAAI,GAAwB,IAAI,CAAC;IACrC,IAAI,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,KAAK,CAAC;IAE5C,MAAM,QAAQ,GAAG,CAAC,KAA8B,EAAE,EAAE;QAClD,IAAI,KAAK,CAAC,GAAG,IAAI,MAAM;YAAE,OAAO;QAChC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5B,IAAI,EAAE,EAAE,CAAC;IACX,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,EAAgB,CAAC;IACvE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzB,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAErC,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,GAAG,IAAI,CAAC;QACZ,IAAI,EAAE,EAAE,CAAC;IACX,CAAC,CAAC;IACF,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnE,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;YACtD,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;gBAC5B,IAAI,MAAM,CAAC,GAAG,IAAI,MAAM;oBAAE,SAAS;gBACnC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAChC,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtE,IAAI,IAAI;oBAAE,MAAM;gBAChB,IAAI,KAAK,CAAC,GAAG,IAAI,MAAM,EAAE,CAAC;oBAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAAC,SAAS;gBAAC,CAAC;gBAC/D,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM,GAAG,CAAC;oBAAE,MAAM;gBACpC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACxB,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC;gBACnB,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,IAAI;gBAAE,MAAM;YAChB,wEAAwE;YACxE,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,GAAG,IAAI,MAAM;gBAAE,SAAS;YAEhF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC5B,IAAI,GAAG,IAAI,CAAC;oBACZ,OAAO,EAAE,CAAC;gBACZ,CAAC,EAAE,cAAc,CAAC,CAAC;gBACnB,IAAI,GAAG,GAAG,EAAE;oBACV,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,IAAI,GAAG,IAAI,CAAC;oBACZ,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;gBACF,IAAI,IAAI,EAAE,CAAC;oBACT,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtD,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC;YAAE,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;;oDAGoD;AACpD,MAAM,SAAS,GAAG,CAAE,UAAyE,CAAC,qBAAqB,KAAK,IAAI,GAAG,EAA6B,CAAC,CAAC;AAE9J;mDACmD;AACnD,MAAM,UAAU,uBAAuB,CAAC,KAA8B;IACpE,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/events/manifest.d.ts

@@ -106,6 +106,144 @@ export declare const frameworkEventSchemas: {
             }>>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
+    readonly "task.started": z.ZodObject<{
+        taskId: z.ZodString;
+        revision: z.ZodNumber;
+        goal: z.ZodString;
+        steps: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            status: z.ZodEnum<{
+                completed: "completed";
+                pending: "pending";
+                in_progress: "in_progress";
+                cancelled: "cancelled";
+                blocked: "blocked";
+            }>;
+        }, z.core.$strip>>;
+        acceptanceCriteria: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+            status: z.ZodEnum<{
+                pending: "pending";
+                failed: "failed";
+                passed: "passed";
+                not_applicable: "not_applicable";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    readonly "task.plan.updated": z.ZodObject<{
+        taskId: z.ZodString;
+        revision: z.ZodNumber;
+        goal: z.ZodString;
+        steps: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            status: z.ZodEnum<{
+                completed: "completed";
+                pending: "pending";
+                in_progress: "in_progress";
+                cancelled: "cancelled";
+                blocked: "blocked";
+            }>;
+        }, z.core.$strip>>;
+        completedSteps: z.ZodNumber;
+        totalSteps: z.ZodNumber;
+    }, z.core.$strip>;
+    readonly "task.step.started": z.ZodObject<{
+        taskId: z.ZodString;
+        revision: z.ZodNumber;
+        stepId: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        completedSteps: z.ZodNumber;
+        totalSteps: z.ZodNumber;
+        evidenceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly "task.step.progress": z.ZodObject<{
+        taskId: z.ZodString;
+        revision: z.ZodNumber;
+        stepId: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        completedSteps: z.ZodNumber;
+        totalSteps: z.ZodNumber;
+        evidenceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly "task.step.completed": z.ZodObject<{
+        taskId: z.ZodString;
+        revision: z.ZodNumber;
+        stepId: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        completedSteps: z.ZodNumber;
+        totalSteps: z.ZodNumber;
+        evidenceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    /** 一次 Attempt（内部运行）结束。**不是任务完成**——规格 §8.3 把
+     *  「agent.prompt() resolve」「finish_reason: stop」「status 进 idle」
+     *  逐条列为不能触发交付的依据，本事件就是那些信号的正确归处：
+     *  它们只描述一次运行，UI 只能拿去画执行轨迹。 */
+    readonly "task.attempt.finished": z.ZodObject<{
+        taskId: z.ZodString;
+        revision: z.ZodNumber;
+        attempt: z.ZodNumber;
+        outcome: z.ZodEnum<{
+            completed: "completed";
+            aborted: "aborted";
+            error: "error";
+        }>;
+        summary: z.ZodOptional<z.ZodString>;
+        toolCalls: z.ZodNumber;
+        filesEdited: z.ZodNumber;
+        durationMs: z.ZodNumber;
+    }, z.core.$strip>;
+    readonly "task.recovery.started": z.ZodObject<{
+        taskId: z.ZodString;
+        revision: z.ZodNumber;
+        message: z.ZodString;
+        attempt: z.ZodNumber;
+    }, z.core.$strip>;
+    readonly "task.blocked": z.ZodObject<{
+        taskId: z.ZodString;
+        revision: z.ZodNumber;
+        blocker: z.ZodObject<{
+            kind: z.ZodEnum<{
+                permission: "permission";
+                input: "input";
+                choice: "choice";
+                external_auth: "external_auth";
+                unsafe_replay: "unsafe_replay";
+                budget: "budget";
+                no_progress: "no_progress";
+            }>;
+            message: z.ZodString;
+            requiredAction: z.ZodString;
+            resumable: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    readonly "task.verification.started": z.ZodObject<{
+        taskId: z.ZodString;
+        revision: z.ZodNumber;
+        message: z.ZodString;
+    }, z.core.$strip>;
+    readonly "task.delivered": z.ZodObject<{
+        taskId: z.ZodString;
+        revision: z.ZodNumber;
+        result: z.ZodString;
+        evidenceIds: z.ZodArray<z.ZodString>;
+        filesEdited: z.ZodNumber;
+        toolCalls: z.ZodNumber;
+        durationMs: z.ZodNumber;
+    }, z.core.$strip>;
+    readonly "task.failed": z.ZodObject<{
+        taskId: z.ZodString;
+        revision: z.ZodNumber;
+        reason: z.ZodString;
+    }, z.core.$strip>;
+    readonly "task.cancelled": z.ZodObject<{
+        taskId: z.ZodString;
+        revision: z.ZodNumber;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
     readonly "file.edited": z.ZodObject<{
         path: z.ZodString;
         revisionId: z.ZodString;
@@ -161,5 +299,27 @@ export type PersistedFrameworkEvent = FrameworkEvent & {
 export type TodoItem = z.infer<typeof todoItemSchema>;
 /** Narrows an unknown payload (e.g. from an SSE frame) to a FrameworkEvent. */
 export declare function parseFrameworkEvent(value: unknown): FrameworkEvent | null;
+/** 构造一条持久化事件记录。
+ *
+ * 【为什么需要集中在这里】运行时的 `data` 已由上面的 schema 校验，但类型层面
+ * TypeScript 无法从「宽联合的 type」反推出对应的 data——`PersistedFrameworkEvent`
+ * 是 `FrameworkEvent & {...}`，其中 `FrameworkEvent` 又是一个映射联合，逐成员
+ * 匹配要求 `type` 恰好是那个成员的字面量。于是各调用点只能断言。
+ *
+ * 断言本身不可避免，但**散落在各处会出问题**：原本三处都写 `data: parsed.data
+ * as never`，而 `never` 可赋给一切，看起来永远成立——直到联合成员增减到某个
+ * 规模，TypeScript 的整体赋值检查行为改变，三处同时报错（规格 3 新增 11 个
+ * task 事件时就撞上了）。收敛到一个函数后，联合怎么变都只影响这里，且
+ * `unknown` 而不是 `never` 如实表达了「这里放的是未定类型的载荷」。
+ *
+ * 调用方必须先过对应 schema 的 `safeParse`；本函数不做校验。 */
+export declare function toPersistedEvent(input: {
+    id: string;
+    sessionId: string;
+    seq: number;
+    type: FrameworkEventType;
+    data: unknown;
+    at: string;
+}): PersistedFrameworkEvent;
 export {};
 //# sourceMappingURL=manifest.d.ts.map

package/dist/core/events/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/core/events/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAU1E,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAczB,CAAC;AAE7B,eAAO,MAAM,iBAAiB,uCAO7B,CAAC;AAEF,eAAO,MAAM,UAAU,yBAGtB,CAAC;AAYF,QAAA,MAAM,cAAc;;;;;;;;;;;;;iBAIlB,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqExB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG;KAC1B,CAAC,IAAI,kBAAkB,GAAG;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE;CACzF,CAAC,kBAAkB,CAAC,CAAC;AAEtB,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAOzE"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/core/events/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAU1E,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAczB,CAAC;AAE7B,eAAO,MAAM,iBAAiB,uCAO7B,CAAC;AAEF,eAAO,MAAM,UAAU,yBAGtB,CAAC;AAYF,QAAA,MAAM,cAAc;;;;;;;;;;;;;iBAIlB,CAAC;AAuCH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyDhC;;;kCAG8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDtB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG;KAC1B,CAAC,IAAI,kBAAkB,GAAG;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE;CACzF,CAAC,kBAAkB,CAAC,CAAC;AAEtB,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAOzE;AAED;;;;;;;;;;;;;6CAa6C;AAC7C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,uBAAuB,CAE1B"}

package/dist/core/events/manifest.js

@@ -38,6 +38,38 @@ const todoItemSchema = z.object({
     status: z.enum(["pending", "in_progress", "completed", "cancelled"]),
     priority: z.enum(["high", "medium", "low"]).optional(),
 });
+/** 任务事件（规格 3 §7）：所有事件都带 taskId + revision。
+ *
+ * 【为什么 revision 要进每个事件而不是只在 task.updated 里】客户端可能从任意
+ * 中间位置开始重放（断线重连的 `?since=`），也可能乱序到达。带着 revision
+ * 的事件可以被独立地去重、排序与丢弃旧值——规格 §13.3 要求「客户端以
+ * seq + taskId + revision 去重、排序和重放」。 */
+const taskEventBase = z.object({ taskId: z.string(), revision: z.number() });
+const taskStepSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    status: z.enum(["pending", "in_progress", "completed", "blocked", "cancelled"]),
+});
+const taskCriterionSchema = z.object({
+    id: z.string(),
+    description: z.string(),
+    required: z.boolean(),
+    status: z.enum(["pending", "passed", "failed", "not_applicable"]),
+});
+const taskBlockerSchema = z.object({
+    kind: z.enum(["permission", "input", "choice", "external_auth", "unsafe_replay", "budget", "no_progress"]),
+    message: z.string(),
+    requiredAction: z.string(),
+    resumable: z.boolean(),
+});
+/** 任务进度事件的公共载荷（规格 §7 建议形状）。 */
+const taskProgressData = taskEventBase.extend({
+    stepId: z.string().optional(),
+    message: z.string(),
+    completedSteps: z.number(),
+    totalSteps: z.number(),
+    evidenceId: z.string().optional(),
+});
 export const frameworkEventSchemas = {
     "session.updated": z.object({ session: sessionInfoSchema }),
     "session.status": z.object({ status: z.enum(["idle", "running", "waiting_permission", "waiting_input"]) }),
@@ -77,6 +109,48 @@ export const frameworkEventSchemas = {
     "permission.asked": z.object({ request: permissionRequestSchema }),
     "permission.replied": z.object({ id: z.string(), reply: z.enum(["once", "always", "reject"]) }),
     "todo.updated": z.object({ todos: z.array(todoItemSchema) }),
+    // ---- 持续任务（规格 3 §7）--------------------------------------------------
+    // 任务从「用户一条指令」到「可信交付」的生命周期事件。与 session.summary
+    // 的分工：summary 是**一次运行的**收尾陈述，task.* 是**用户目标的**状态。
+    // UI 只允许 task.delivered 显示「任务完成」（规格 §14.3 / §18.4）。
+    "task.started": taskEventBase.extend({
+        goal: z.string(),
+        steps: z.array(taskStepSchema),
+        acceptanceCriteria: z.array(taskCriterionSchema),
+    }),
+    "task.plan.updated": taskEventBase.extend({
+        goal: z.string(),
+        steps: z.array(taskStepSchema),
+        completedSteps: z.number(),
+        totalSteps: z.number(),
+    }),
+    "task.step.started": taskProgressData,
+    "task.step.progress": taskProgressData,
+    "task.step.completed": taskProgressData,
+    /** 一次 Attempt（内部运行）结束。**不是任务完成**——规格 §8.3 把
+     *  「agent.prompt() resolve」「finish_reason: stop」「status 进 idle」
+     *  逐条列为不能触发交付的依据，本事件就是那些信号的正确归处：
+     *  它们只描述一次运行，UI 只能拿去画执行轨迹。 */
+    "task.attempt.finished": taskEventBase.extend({
+        attempt: z.number(),
+        outcome: z.enum(["completed", "error", "aborted"]),
+        summary: z.string().optional(),
+        toolCalls: z.number(),
+        filesEdited: z.number(),
+        durationMs: z.number(),
+    }),
+    "task.recovery.started": taskEventBase.extend({ message: z.string(), attempt: z.number() }),
+    "task.blocked": taskEventBase.extend({ blocker: taskBlockerSchema }),
+    "task.verification.started": taskEventBase.extend({ message: z.string() }),
+    "task.delivered": taskEventBase.extend({
+        result: z.string(),
+        evidenceIds: z.array(z.string()),
+        filesEdited: z.number(),
+        toolCalls: z.number(),
+        durationMs: z.number(),
+    }),
+    "task.failed": taskEventBase.extend({ reason: z.string() }),
+    "task.cancelled": taskEventBase.extend({ reason: z.string().optional() }),
     "file.edited": z.object({ path: z.string(), revisionId: z.string(), diff: z.string() }),
     "artifact.created": z.object({
         artifactId: z.string(),
@@ -119,4 +193,21 @@ export function parseFrameworkEvent(value) {
     const parsed = schema.safeParse(data);
     return parsed.success ? { type, data: parsed.data } : null;
 }
+/** 构造一条持久化事件记录。
+ *
+ * 【为什么需要集中在这里】运行时的 `data` 已由上面的 schema 校验，但类型层面
+ * TypeScript 无法从「宽联合的 type」反推出对应的 data——`PersistedFrameworkEvent`
+ * 是 `FrameworkEvent & {...}`，其中 `FrameworkEvent` 又是一个映射联合，逐成员
+ * 匹配要求 `type` 恰好是那个成员的字面量。于是各调用点只能断言。
+ *
+ * 断言本身不可避免，但**散落在各处会出问题**：原本三处都写 `data: parsed.data
+ * as never`，而 `never` 可赋给一切，看起来永远成立——直到联合成员增减到某个
+ * 规模，TypeScript 的整体赋值检查行为改变，三处同时报错（规格 3 新增 11 个
+ * task 事件时就撞上了）。收敛到一个函数后，联合怎么变都只影响这里，且
+ * `unknown` 而不是 `never` 如实表达了「这里放的是未定类型的载荷」。
+ *
+ * 调用方必须先过对应 schema 的 `safeParse`；本函数不做校验。 */
+export function toPersistedEvent(input) {
+    return input;
+}
 //# sourceMappingURL=manifest.js.map

package/dist/core/events/manifest.js.map

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

package/dist/core/events/sqlite-event-log.js

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { DatabaseSync } from "node:sqlite";
-import { frameworkEventSchemas } from "./manifest.js";
+import { frameworkEventSchemas, toPersistedEvent } from "./manifest.js";
 import { newEventId } from "../session/ids.js";
 export function createSqliteEventLog(options) {
     const db = new DatabaseSync(path.join(options.dataDir, "zmzai.db"));
@@ -42,11 +42,11 @@ export function createSqliteEventLog(options) {
                 throw new Error(`INVALID_FRAMEWORK_EVENT: ${event.type} ${parsed.error.issues[0]?.message ?? ""}`);
             return transaction(() => {
                 const seq = nextSeq.get(event.sessionId).n;
-                const persisted = {
+                const persisted = toPersistedEvent({
                     id: newEventId(), sessionId: event.sessionId, seq,
                     type: event.type, data: parsed.data,
                     at: new Date().toISOString(),
-                };
+                });
                 insert.run(event.sessionId, seq, persisted.id, persisted.type, persisted.at, JSON.stringify(persisted));
                 return persisted;
             });

package/dist/core/events/sqlite-event-log.js.map

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

package/dist/core/runtime/attachments.d.ts

@@ -1,14 +1,124 @@
+import type { ExtractedDocument } from "./extraction.js";
 export type InputAttachment = {
     name: string;
     mediaType: string;
     data: string;
     size: number;
 };
+/** 支持的文件大类（规格 2 §8）。`kind` 决定模型侧的处理方式（图片走视觉输入，
+ *  其余走文本清单），也决定 UI 图标。 */
+export type AttachmentKind = "image" | "document" | "text" | "spreadsheet" | "presentation";
+export declare const ATTACHMENT_KINDS: readonly AttachmentKind[];
+/**
+ * 附件描述符（规格 2 §11）。**这是 v2 契约**：只描述文件，不携带内容。
+ * 旧契约 `InputAttachment` 把整个文件 base64 塞进 data URL，随 prompt 写进事件与
+ * 消息 part——1MB 文件变 1.33MB 文本，撑爆存储。内容现在由 host 的 blob store 持有，
+ * framework 只拿 id，需要正文时经 `AttachmentProvider` 读。
+ */
+export type InputAttachmentRef = {
+    id: string;
+    name: string;
+    mediaType: string;
+    size: number;
+    sha256: string;
+    kind: AttachmentKind;
+};
+/** 附件访问的授权范围（规格 2 §13）。
+ *
+ *  **必填**而不是可选：一个「省略就等于不校验」的参数迟早会被某个调用点省掉，
+ *  而它的失效方式（读到别的会话的文件）是静默的。framework 自己无法判断某个 id
+ *  属于谁——那必须由能访问存储的一侧按这个范围判定。 */
+export type AttachmentAccessScope = {
+    sessionId: string;
+};
+/** 清单与搜索结果里的附件摘要（不含内容）。 */
+export type AttachmentSummary = {
+    id: string;
+    name: string;
+    kind: AttachmentKind;
+};
+/**
+ * Host 提供的附件读取器（规格 2 §9.2 / §10.2）。framework 自己不碰文件系统：
+ * 桌面端读本地 blob store，服务端读对象存储，同一接口两种实现。
+ */
+export interface AttachmentProvider {
+    /** 返回原始字节；附件不存在、**不属于该会话**或已清理时返回 null（历史消息仍要能渲染）。 */
+    read(id: string, scope: AttachmentAccessScope): Promise<{
+        ref: InputAttachmentRef;
+        bytes: Uint8Array;
+    } | null>;
+    /** 返回结构化提取结果（带 locator，规格 §10.1）。未实现时 `read_attachment`
+     *  会明确说「这个附件没有结构化正文」，而不是让模型自己猜内容。 */
+    extract?(id: string, scope: AttachmentAccessScope): Promise<ExtractedDocument | null>;
+    /** 列出该会话的附件（供跨附件搜索）。未实现时 `search_attachments` 必须显式要求
+     *  attachmentId——不允许退化成「搜索全项目」。 */
+    list?(scope: AttachmentAccessScope): Promise<readonly AttachmentSummary[]>;
+}
 /** Validate before queuing or persisting. Never fetch user-supplied URLs. */
 export declare function validateAttachments(value: unknown): InputAttachment[];
+/** 附件总数上限（与产品侧 `ATTACHMENT_LIMITS.maxLocalPerMessage` 对齐）。 */
+export declare const MAX_ATTACHMENT_REFS = 10;
+/**
+ * 校验描述符（规格 2 §11 / §17.2.2）。
+ * 【边界】framework 无法判断某个 id 是否属于当前用户——那是 host 的职责（所有权校验
+ * 必须在能访问存储的一侧做）。这里只保证**形状**合法，避免畸形 id 进入执行路径。
+ */
+export declare function validateAttachmentRefs(value: unknown): InputAttachmentRef[];
 /** Model-only projection: persisted user text is never modified. */
 export declare function attachmentContent(files: readonly InputAttachment[]): {
     type: "text";
     text: string;
 }[];
+/** 内联文本附件的体积上限（规格 2 §10.2「小型文本附件可在 token 预算内完整注入」）。 */
+export declare const INLINE_TEXT_LIMIT: number;
+/**
+ * 读取正文所需的最小描述符（规格 2 §10.2）。
+ *
+ * 【为什么不能直接用 `InputAttachmentRef`】历史重建时消息 part 里只有
+ * id / 文件名 / 类型 / 大小，**没有 sha256**（摘要是上传回执的产物，part 不落它）。
+ * 为了让类型通过而硬编一个假摘要（`sha256: ""`）会破坏 `InputAttachmentRef`
+ * 自身的不变量：将来任何一次校验都会在「重放老会话」这条路径上炸掉。
+ * 所以正文读取真正需要的字段单独抽出来，`InputAttachmentRef` 天然满足它。
+ */
+export type AttachmentContentRef = {
+    id: string;
+    name: string;
+    kind: AttachmentKind;
+    /** 清单展示用；part 里没有时可缺省（渲染成 unknown，不编造）。 */
+    mediaType?: string;
+    size?: number;
+};
+/**
+ * 模型上下文里的附件清单（**不含正文**，规格 2 §10.2）。
+ * 仅在正文不可用时出现——长文档、图片之外的二进制、或 blob 已丢失。
+ */
+export declare function attachmentManifest(refs: readonly AttachmentContentRef[], options?: {
+    canReadStructured?: boolean;
+}): string;
+/**
+ * 带**不可信边界**的附件正文块（规格 2 §10.2 / §13）。
+ * 文件里的提示词、脚本、命令一律是用户数据，不是 system/developer 指令；
+ * 边界文字必须随内容一起下发，否则模型会把文档正文当指令执行。
+ */
+export declare function attachmentDataBlock(ref: AttachmentContentRef, content: string): string;
+/** 模型可消费的内容片段（文本 / 视觉输入）。 */
+export type PiContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
+/**
+ * 把附件描述符变成模型可见的内容（规格 2 §10.2）。
+ *
+ * - 图片 → 视觉输入，字节从 host 的附件存储读（不再走 data URL 事件）；
+ * - 小型文本 → 内联，但**包在不可信边界里**（文档正文不是指令）；
+ * - 其余（PDF/Office/大文本/blob 已丢失）→ 只进清单，不内联正文。
+ *
+ * 同一个函数同时服务「本轮 prompt」与「历史重建」，因此后续 turn 与首轮看到的
+ * 附件信息一致，不会出现「第一轮能读到、第二轮失忆」的割裂。
+ */
+export declare function attachmentRefContent(provider: AttachmentProvider | undefined, refs: readonly AttachmentContentRef[], scope: AttachmentAccessScope): Promise<PiContentPart[]>;
 //# sourceMappingURL=attachments.d.ts.map

package/dist/core/runtime/attachments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/attachments.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9F,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAerE;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE;;;IAElE"}
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/attachments.ts"],"names":[],"mappings":"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"}