@zmzai/agent-framework 0.5.2 → 0.9.0

package/dist/core/tools/task-block.js

@@ -0,0 +1,76 @@
+import { z } from "zod";
+/** 任务级「需要用户介入」的声明工具（规格 3 §11 / §17.3 场景 B）。
+ *
+ * 【为什么必须有这个工具】规格 §11 列了五种允许要求用户介入的场景，其中三种
+ * （缺信息、要在两个不可逆方案里选、外部登录/验证码/付款）在实现上需要**模型
+ * 自己说出来**。在此之前，`CompletionRuntimeState` 的 `inputRequired` /
+ * `choiceRequired` / `externalAuthRequired` 三个字段只有单测会填，运行时一律写
+ * null——任务契约里那句「只有确实需要用户…时才停下，并说明卡在哪里」因此是一句
+ * **无法执行的指示**：模型照做，停下来说明，而运行时只看到「这一轮结束了、步骤
+ * 还剩着」，于是把它当成续跑，再跑一遍，再停……一直到连续三轮无进展，用户收到
+ * 的是一句「连续 3 轮没有实质进展」。真实原因（缺一个域名）被掩盖成了一个
+ * 性能问题。
+ *
+ * 【为什么是个工具而不是对最终文本做启发式】在模型最后一段话里找问号、「请提供」
+ * 之类的模式，会在正常交付里误判——「要不要我顺便加上移动端适配？」是一句礼貌的
+ * 收尾，不是阻塞。误判的代价是把一个已经能继续的任务冻结住等用户，而用户可能
+ * 根本没在看。工具调用是一个明确的、结构化的动作：模型**主动**声明「我卡住了，
+ * 原因是 X，需要你做 Y」。§19 的精神也是这个方向——不许把「无法继续」包装成
+ * 别的样子。
+ *
+ * 【它不是逃生舱】声明阻塞会让任务停下来等用户，是不便宜的。所以：
+ * - description 里写清使用边界，并明确「不要为了让用户确认计划而调用」；
+ * - 同一个任务里模型若反复用它来回避工作，用户会直接看到它在等什么——
+ *   每次都要写 message 与 requiredAction，编不出理由就没法用；
+ * - 它自己不产生任何副作用，因此不需要授权（`permission: () => null`）。 */
+export const TASK_BLOCK_TOOL_ID = "task_block";
+export const taskBlockKinds = ["input", "choice", "external_auth"];
+export const taskBlockInputSchema = z.object({
+    kind: z.enum(taskBlockKinds),
+    /** 卡在哪里——会原样显示在任务卡上，必须具体到「缺什么」。 */
+    message: z.string().trim().min(1).max(600),
+    /** 用户做完什么之后任务能继续。§14.4 禁止只说「请继续」。 */
+    requiredAction: z.string().trim().min(1).max(400),
+    /** `kind: "choice"` 时的候选项，会给界面用来渲染可选项。
+     *
+     *  【为什么是 `.optional()` 而不是 `.default([])`】`default` 在推导出的
+     *  JSON Schema 里会变成**必填**字段，而模型在 `input` / `external_auth` 两种
+     *  情况下根本不会传它——于是每一次声明都因为「缺少 options」被挡在工具校验，
+     *  `task_block` 成了个永远调不通的工具。这正是它存在的意义所在，所以这里
+     *  宁可让 `undefined` 一路传下来，在 `execute` 里归一。 */
+    options: z.array(z.string().trim().min(1).max(200)).max(6).optional(),
+});
+/** 三类各自对应的用户动作，用来生成工具结果回执。 */
+const KIND_HINT = {
+    input: "缺少必要信息",
+    choice: "需要用户在两个方案之间选择",
+    external_auth: "需要用户完成外部登录、验证码或付款",
+};
+export const taskBlockTool = {
+    id: TASK_BLOCK_TOOL_ID,
+    label: "声明任务受阻",
+    description: "声明这个任务被卡住了，必须由用户介入才能继续。仅在以下情况调用：① 缺少的信息确实无法从工作区、工具或已有上下文中获得；② 有两个会产生明显不同且不可逆结果的方案，必须由用户选；③ 需要用户完成外部登录、验证码或付款。不要为了让用户确认计划而调用——计划默认直接执行。调用后本轮就结束，请用一句话说明卡在哪里以及需要用户做什么。",
+    parameters: taskBlockInputSchema,
+    // 无副作用：它只声明状态，让任务停在等待上——这不是一次写操作，不需要授权。
+    permission: () => null,
+    async execute(args) {
+        const options = args.options?.length ? `\n候选方案：${args.options.join(" / ")}` : "";
+        return {
+            title: `任务受阻：${KIND_HINT[args.kind]}`,
+            output: [
+                "已记录这个阻塞。任务现在停在等待用户处理的状态，不会自动继续。",
+                `原因：${args.message}`,
+                `需要用户做：${args.requiredAction}${options}`,
+                "请用一句话向用户说明卡在哪里以及需要他做什么，然后结束本轮。用户处理完之后任务会从当前步骤接着做，不必重做已经完成的部分。",
+            ].join("\n"),
+            metadata: { taskBlock: args },
+        };
+    },
+};
+/** 从工具调用参数里取回声明（runner 用；参数来自模型，必须过 schema）。
+ *  非法参数按「没有声明」处理——一个格式不对的工具调用不该把任务冻住。 */
+export function readTaskBlock(args) {
+    const parsed = taskBlockInputSchema.safeParse(args);
+    return parsed.success ? parsed.data : null;
+}
+//# sourceMappingURL=task-block.js.map

package/dist/core/tools/task-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-block.js","sourceRoot":"","sources":["../../../src/core/tools/task-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;;;;;;;;;;;;;;sDAuBsD;AACtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE/C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAU,CAAC;AAE5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAC5B,mCAAmC;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC1C,qCAAqC;IACrC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACjD;;;;;;iDAM6C;IAC7C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtE,CAAC,CAAC;AAIH,8BAA8B;AAC9B,MAAM,SAAS,GAA2C;IACxD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,eAAe;IACvB,aAAa,EAAE,mBAAmB;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAyC;IACjE,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,QAAQ;IACf,WAAW,EACT,sKAAsK;IACxK,UAAU,EAAE,oBAAoB;IAChC,wCAAwC;IACxC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI;IACtB,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,OAAO;YACL,KAAK,EAAE,QAAQ,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACrC,MAAM,EAAE;gBACN,iCAAiC;gBACjC,MAAM,IAAI,CAAC,OAAO,EAAE;gBACpB,SAAS,IAAI,CAAC,cAAc,GAAG,OAAO,EAAE;gBACxC,+DAA+D;aAChE,CAAC,IAAI,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;SAC9B,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;yCACyC;AACzC,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC"}

package/dist/core/tools/task-deliver.d.ts

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import type { ToolDef } from "./def.js";
+/** 任务级「我交付了」的**显式声明**工具（规格 3 §9 / §14.1）。
+ *
+ * 【为什么必须有这个工具】Completion Gate 的五条条件里，「验收条件是否通过」
+ * 这一条在运行时没有任何独立事实可依——验收条件写的是用户的目标，达成与否
+ * 只有做事的那个人知道。在它之前，这一步是靠**推导**补上的：
+ * `projectImplicitCriterion` 看「模型这轮有没有输出文本」，有文本就把隐式条件
+ * 判 passed。那是一条从「文本非空」到「目标已实现」的跳跃，于是模型的任何
+ * 一句收尾话都能换到 delivered。
+ *
+ * 真实事故的形状是这样的：用户发「继续执行」，模型回「继续。跑自检验证前面
+ * 改动的正确性：」——**一句话停在冒号上、零工具调用、28 个输出 token**——
+ * 然后框架照常发 `task.delivered`，交付卡上写着「完成了 0 个步骤、0 次工具
+ * 调用」「剩余项：无」。任务进了终态，用户那句「继续执行」被彻底吞掉。
+ *
+ * 【为什么不是把启发式写得更聪明】在最终文本里找「已完成」「剩余项」之类的
+ * 模式，会在正常交付里误判，也会被模型的口癖绕过。`task_block` 的注释里已经
+ * 写过同一条判断：**不猜，让模型显式声明**。交付也一样——它是一次动作，不是
+ * 一种可以被推断出来的语气。
+ *
+ * 【它不是逃生舱】声明交付不会绕过门：模型给的是**输入**（每条验收条件的结论、
+ * 怎么验证的、还剩什么），门仍然独立检查阻塞、未完成步骤、证据是否对得上号、
+ * 有没有最终文本。模型无法用一次 `task_deliver` 换来一个 delivered——它只能
+ * 把「达成与否」这个只有它知道的事实说出来，然后由门决定能不能交付。
+ *
+ * 【四问答的来源】规格 §14.1 的交付卡固定回答四个问题，§18.7 要求「无剩余项时
+ * 明确为『无』」。这里让模型直接按这四个问题填，而不是让框架事后从统计数字里
+ * 编一段——旧实现里那句「完成了 0 个步骤、0 次工具调用。」就是这么编出来的。 */
+export declare const TASK_DELIVER_TOOL_ID = "task_deliver";
+/** 逐条验收条件的状态。与 `AcceptanceCriterionStatus` 同值域，但**不含**
+ *  `pending`：交付声明里说「还没结论」是没有意义的。 */
+export declare const taskDeliverCriterionStatuses: readonly ["passed", "failed", "not_applicable"];
+export declare const taskDeliverInputSchema: z.ZodObject<{
+    summary: z.ZodString;
+    changes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    verification: z.ZodArray<z.ZodString>;
+    remaining: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    criteria: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            passed: "passed";
+            not_applicable: "not_applicable";
+        }>;
+        evidence: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type TaskDeliverInput = z.infer<typeof taskDeliverInputSchema>;
+export declare const taskDeliverTool: ToolDef<typeof taskDeliverInputSchema>;
+/** 从工具调用参数里取回交付声明（runner 用；参数来自模型，必须过 schema）。
+ *  非法参数按「没有声明」处理——一次格式不对的调用不该把任务判成已交付，
+ *  也不该让这一轮白跑：门会继续要求交付，模型下一次调用时改正即可。 */
+export declare function readTaskDelivery(args: unknown): TaskDeliverInput | null;
+//# sourceMappingURL=task-deliver.d.ts.map

package/dist/core/tools/task-deliver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-deliver.d.ts","sourceRoot":"","sources":["../../../src/core/tools/task-deliver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;8CA0B8C;AAC9C,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AAEnD;oCACoC;AACpC,eAAO,MAAM,4BAA4B,iDAAkD,CAAC;AAE5F,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;iBA8BjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,OAAO,sBAAsB,CA6BlE,CAAC;AAEF;;uCAEuC;AACvC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAGvE"}

package/dist/core/tools/task-deliver.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+/** 任务级「我交付了」的**显式声明**工具（规格 3 §9 / §14.1）。
+ *
+ * 【为什么必须有这个工具】Completion Gate 的五条条件里，「验收条件是否通过」
+ * 这一条在运行时没有任何独立事实可依——验收条件写的是用户的目标，达成与否
+ * 只有做事的那个人知道。在它之前，这一步是靠**推导**补上的：
+ * `projectImplicitCriterion` 看「模型这轮有没有输出文本」，有文本就把隐式条件
+ * 判 passed。那是一条从「文本非空」到「目标已实现」的跳跃，于是模型的任何
+ * 一句收尾话都能换到 delivered。
+ *
+ * 真实事故的形状是这样的：用户发「继续执行」，模型回「继续。跑自检验证前面
+ * 改动的正确性：」——**一句话停在冒号上、零工具调用、28 个输出 token**——
+ * 然后框架照常发 `task.delivered`，交付卡上写着「完成了 0 个步骤、0 次工具
+ * 调用」「剩余项：无」。任务进了终态，用户那句「继续执行」被彻底吞掉。
+ *
+ * 【为什么不是把启发式写得更聪明】在最终文本里找「已完成」「剩余项」之类的
+ * 模式，会在正常交付里误判，也会被模型的口癖绕过。`task_block` 的注释里已经
+ * 写过同一条判断：**不猜，让模型显式声明**。交付也一样——它是一次动作，不是
+ * 一种可以被推断出来的语气。
+ *
+ * 【它不是逃生舱】声明交付不会绕过门：模型给的是**输入**（每条验收条件的结论、
+ * 怎么验证的、还剩什么），门仍然独立检查阻塞、未完成步骤、证据是否对得上号、
+ * 有没有最终文本。模型无法用一次 `task_deliver` 换来一个 delivered——它只能
+ * 把「达成与否」这个只有它知道的事实说出来，然后由门决定能不能交付。
+ *
+ * 【四问答的来源】规格 §14.1 的交付卡固定回答四个问题，§18.7 要求「无剩余项时
+ * 明确为『无』」。这里让模型直接按这四个问题填，而不是让框架事后从统计数字里
+ * 编一段——旧实现里那句「完成了 0 个步骤、0 次工具调用。」就是这么编出来的。 */
+export const TASK_DELIVER_TOOL_ID = "task_deliver";
+/** 逐条验收条件的状态。与 `AcceptanceCriterionStatus` 同值域，但**不含**
+ *  `pending`：交付声明里说「还没结论」是没有意义的。 */
+export const taskDeliverCriterionStatuses = ["passed", "failed", "not_applicable"];
+export const taskDeliverInputSchema = z.object({
+    /** 问 1：做成了什么。给用户看的一句话，不要复述目标。 */
+    summary: z.string().trim().min(1).max(1200),
+    /** 问 2：改了哪些主要内容。省略时框架用本轮实际编辑过的文件补。 */
+    changes: z.array(z.string().trim().min(1).max(200)).max(12).optional(),
+    /** 问 3：怎么验证的。**至少一条**——这正是旧实现里最容易空掉的一格：
+     *  「有验证」是交付的底线，声明里连一句验证都写不出来，就不该交付。 */
+    verification: z.array(z.string().trim().min(1).max(400)).min(1).max(12),
+    /** 问 4：还有哪些没做完。**必须显式给**（空数组也算给了）——规格 §18.7
+     *  禁止让「没写」和「没有」两种含义糊在一起。 */
+    remaining: z.array(z.string().trim().min(1).max(200)).max(12).optional(),
+    /** 逐条验收条件的结论。id 用任务契约里印出来的那一个
+     *  （`<task-contract>` 的验收条件列表带方括号 id）。
+     *
+     *  【为什么 optional】任务只有隐式条件（`crit_implicit`，描述就是用户的
+     *  目标）时，`summary` + `verification` 已经回答了同一个问题，再要求模型
+     *  抄一遍 id 只是形式。省略即「隐式条件按 passed 处理」；给了就逐条按声明
+     *  走，**未覆盖的 required 条件保持 pending**，门会因为「验收条件未通过」
+     *  把它打回续跑，并在 advisory 里点名缺哪一条。 */
+    criteria: z
+        .array(z.object({
+        id: z.string().trim().min(1).max(80),
+        status: z.enum(taskDeliverCriterionStatuses),
+        /** 这条结论的依据。写清「看到/跑了什么」，不要写「已完成」。 */
+        evidence: z.string().trim().min(1).max(400),
+    }))
+        .max(12)
+        .optional(),
+});
+export const taskDeliverTool = {
+    id: TASK_DELIVER_TOOL_ID,
+    label: "提交交付",
+    description: "声明这个任务已经完成，并按四个问题提交交付信息：做成了什么、改了哪些主要内容、怎么验证的、还有哪些没做完。**任务只有在你调用它之后才会结束**——结束本轮、给出一段收尾文字、把 todo 标记完成都不能交付。调用时机：验收条件真的都满足了，而且你能说清是怎么验证的。如果你的答复还没达到目标，不要调用它，继续做事或用 task_block 说明卡在哪里。",
+    parameters: taskDeliverInputSchema,
+    // 无副作用：它只提交一份结构化声明，真正的判定仍由 Completion Gate 做。
+    permission: () => null,
+    async execute(args) {
+        const criteria = args.criteria?.length
+            ? args.criteria.map((item) => `- [${item.id}] ${item.status}：${item.evidence}`).join("\n")
+            : "（未逐条声明，隐式验收条件按通过处理）";
+        const changes = args.changes?.length ? args.changes.join("、") : "（由框架按本轮实际改动的文件补）";
+        const remaining = args.remaining?.length ? args.remaining.join("、") : "无";
+        return {
+            title: "提交交付信息",
+            output: [
+                "已提交交付信息。系统会独立核对验收条件、未完成步骤与证据，再决定任务是否结束。",
+                `做成了什么：${args.summary}`,
+                `改动：${changes}`,
+                `验证：${args.verification.join("；")}`,
+                `剩余项：${remaining}`,
+                "验收结论：",
+                criteria,
+                "请用一段话把上面这些告诉用户，然后结束本轮。不要再启动新的大段工作——如果你发现还有没做完的，继续做，等做完再交付。",
+            ].join("\n"),
+            metadata: { taskDelivery: args },
+        };
+    },
+};
+/** 从工具调用参数里取回交付声明（runner 用；参数来自模型，必须过 schema）。
+ *  非法参数按「没有声明」处理——一次格式不对的调用不该把任务判成已交付，
+ *  也不该让这一轮白跑：门会继续要求交付，模型下一次调用时改正即可。 */
+export function readTaskDelivery(args) {
+    const parsed = taskDeliverInputSchema.safeParse(args);
+    return parsed.success ? parsed.data : null;
+}
+//# sourceMappingURL=task-deliver.js.map

package/dist/core/tools/task-deliver.js.map

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

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /** @zmzai/agent-framework — PI-based agent framework (OpenCode-style).
  *  Storage/backend-agnostic: sessions, permissions, tools, runner, events.
  *  Assemble with createServer() (or wire SessionRunner directly). */
-export type { MessageInfo, MessageWithParts, Part, QueuedPrompt, SelectedSkill, SessionInfo, SessionStatus, ModelRef, ToolState, ThinkingEffort } from "./core/session/types.js";
+export type { MessageInfo, MessageWithParts, Part, FilePart, QueuedPrompt, SelectedSkill, SessionInfo, SessionStatus, ModelRef, ToolState, ThinkingEffort } from "./core/session/types.js";
 export type { SessionStore } from "./core/session/store.js";
 export { newSessionId, newMessageId, newPartId, newPermissionRequestId, newEventId } from "./core/session/ids.js";
 export { createJsonlSessionStore } from "./core/session/jsonl-store.js";
@@ -43,7 +43,13 @@ export { createHostTerminalBackend } from "./adapters/terminal-backend.js";
 export { createRepoMapTool } from "./core/tools/repomap.js";
 export { renderRepoMap, resolveFrameworkVendorDirs, setWasmDirs, type RepoMapOptions, type RepoMapResult } from "./core/repomap/repomap.js";
 export { SessionRunner, createFrameworkSession, isSessionActive, isSessionAwaitingPermission, listActiveSessions, type RunnerDeps, type PromptInput } from "./core/runtime/runner.js";
-export { validateAttachments, type InputAttachment } from "./core/runtime/attachments.js";
+export { validateAttachments, validateAttachmentRefs, attachmentContent, attachmentManifest, attachmentDataBlock, attachmentRefContent, ATTACHMENT_KINDS, INLINE_TEXT_LIMIT, MAX_ATTACHMENT_REFS, type AttachmentKind, type AttachmentContentRef, type AttachmentAccessScope, type AttachmentSummary, type AttachmentProvider, type InputAttachment, type InputAttachmentRef, type PiContentPart, } from "./core/runtime/attachments.js";
+export { EXTRACTION_LIMITS, EXTRACTION_VERSION, READ_ATTACHMENT_MAX_CHARS, SEARCH_ATTACHMENT_DEFAULT_HITS, SEARCH_ATTACHMENT_MAX_HITS, compactionAttachmentNote, formatLocator, searchSections, sectionsForLocator, selectInitialSections, validateExtractedDocument, type ExtractedDocument, type ExtractedSection, type ExtractionLocator, type SectionHit, } from "./core/runtime/extraction.js";
+export type { TaskLifecycleStatus, TaskStepStatus, AcceptanceCriterionStatus, AcceptanceCriterion, TaskStep, TaskEvidence, TaskEvidenceKind, TaskBlocker, TaskBlockerKind, TaskRecord, TaskResult, TaskDeliveryDeclaration, TaskPatch, CreateTaskInput, TaskStore, CompletionRuntimeState, CompletionVerdict, NoProgressPolicy, ProgressAdvance, } from "./core/task/index.js";
+export { newTaskId, newTaskStepId, newCriterionId, newEvidenceId, isTerminalStatus, isWaitingStatus, isActiveStatus, createMemoryTaskStore, createTaskRecord, applyTaskPatch, TASK_REVISION_CONFLICT, IMPLICIT_CRITERION_ID, MAX_EVIDENCE, defaultCriteriaFor, stepIdForContent, projectTodos, applyDelivery, evidenceKindForTool, appendEvidence, pruneEvidenceRefs, fallbackStep, evaluateTaskCompletion, lifecycleForBlocker, normalizeNoProgressPolicy, normalizeMaxDurationMs, durationBudgetBlocker, DEFAULT_NO_PROGRESS_POLICY, DEFAULT_MAX_ATTEMPTS, DEFAULT_MAX_DURATION_MS, taskFingerprint, advanceProgress, taskContractText, initialTaskContract, fallbackResult, renderResult, remainingSteps, } from "./core/task/index.js";
+export type { PromptDisposition, PromptReceipt, WorkflowRunKind, WorkflowState, WorkflowRun, WorkflowStore, AcceptedPrompt } from "./core/session/workflow.js";
+export { promptHash } from "./core/session/workflow.js";
+export { createAttachmentTools } from "./core/tools/attachments.js";
 export type { LifecycleHook } from "./core/runtime/lifecycle.js";
 export { extractRunTranscript, RETRY_PLACEHOLDER_TEXT, type RunTranscriptMessage } from "./core/runtime/run-transcript.js";
 export { PartProjector, serializeEmit } from "./core/runtime/pi-bridge.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -29,7 +29,11 @@ export { createRepoMapTool } from "./core/tools/repomap.js";
 export { renderRepoMap, resolveFrameworkVendorDirs, setWasmDirs } from "./core/repomap/repomap.js";
 // core: runtime
 export { SessionRunner, createFrameworkSession, isSessionActive, isSessionAwaitingPermission, listActiveSessions } from "./core/runtime/runner.js";
-export { validateAttachments } from "./core/runtime/attachments.js";
+export { validateAttachments, validateAttachmentRefs, attachmentContent, attachmentManifest, attachmentDataBlock, attachmentRefContent, ATTACHMENT_KINDS, INLINE_TEXT_LIMIT, MAX_ATTACHMENT_REFS, } from "./core/runtime/attachments.js";
+export { EXTRACTION_LIMITS, EXTRACTION_VERSION, READ_ATTACHMENT_MAX_CHARS, SEARCH_ATTACHMENT_DEFAULT_HITS, SEARCH_ATTACHMENT_MAX_HITS, compactionAttachmentNote, formatLocator, searchSections, sectionsForLocator, selectInitialSections, validateExtractedDocument, } from "./core/runtime/extraction.js";
+export { newTaskId, newTaskStepId, newCriterionId, newEvidenceId, isTerminalStatus, isWaitingStatus, isActiveStatus, createMemoryTaskStore, createTaskRecord, applyTaskPatch, TASK_REVISION_CONFLICT, IMPLICIT_CRITERION_ID, MAX_EVIDENCE, defaultCriteriaFor, stepIdForContent, projectTodos, applyDelivery, evidenceKindForTool, appendEvidence, pruneEvidenceRefs, fallbackStep, evaluateTaskCompletion, lifecycleForBlocker, normalizeNoProgressPolicy, normalizeMaxDurationMs, durationBudgetBlocker, DEFAULT_NO_PROGRESS_POLICY, DEFAULT_MAX_ATTEMPTS, DEFAULT_MAX_DURATION_MS, taskFingerprint, advanceProgress, taskContractText, initialTaskContract, fallbackResult, renderResult, remainingSteps, } from "./core/task/index.js";
+export { promptHash } from "./core/session/workflow.js";
+export { createAttachmentTools } from "./core/tools/attachments.js";
 export { extractRunTranscript, RETRY_PLACEHOLDER_TEXT } from "./core/runtime/run-transcript.js";
 export { PartProjector, serializeEmit } from "./core/runtime/pi-bridge.js";
 export { buildCompactionTransform, createCompactionTransform, streamOneText } from "./core/runtime/compaction.js";

package/dist/index.js.map

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

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "@zmzai/agent-framework",
-  "version": "0.5.2",
-  "packageManager": "pnpm@10.34.5",
+  "version": "0.9.0",
   "description": "PI-based agent framework — sessions, permissions, tools, runner, events (OpenCode-style).",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,15 +18,6 @@
     "dist",
     "openapi.yaml"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "build:watch": "tsc -p tsconfig.build.json --watch",
-    "changeset": "changeset",
-    "changeset:version": "changeset version",
-    "release": "pnpm build && changeset publish"
-  },
   "dependencies": {
     "@earendil-works/pi-agent-core": "0.84.1",
     "@earendil-works/pi-ai": "0.84.1",
@@ -43,5 +33,14 @@
   },
   "optionalDependencies": {
     "node-pty": "1.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "changeset": "changeset",
+    "changeset:version": "changeset version",
+    "release": "pnpm build && changeset publish"
   }
-}
+}