@zmzai/agent-framework 0.1.0 → 0.2.1

package/dist/core/repomap/tags.js

@@ -0,0 +1,191 @@
+import { readdir, stat } from "node:fs/promises";
+import path from "node:path";
+import { Language, Parser } from "web-tree-sitter";
+/** wasm 资源目录。bundler 环境（Next 等）下包会被打卷、createRequire 被 shim，
+ *  相对包路径解析必失败——消费方在那种环境下用 setWasmDirs 注入真实目录
+ *  （如 require.resolve 包后取 dirname）；Node 直跑用默认 resolve 路径。 */
+let wasmDirs = {};
+export function setWasmDirs(dirs) {
+    wasmDirs = { ...dirs };
+    parserInit = null; // 已初始化的 Parser 绑定旧 locateFile，重置以让新目录生效
+    languageCache.clear();
+}
+function nodeRequire() {
+    // getBuiltinModule 是运行时真 API，不会被 bundler shim；顶层 createRequire
+    // 在 bundle 里可能是空壳，故这里动态取并 fallback
+    const mod = process.getBuiltinModule?.("node:module");
+    const createRequireFn = mod?.createRequire;
+    if (typeof createRequireFn !== "function") {
+        throw new Error("无法获取 node:module.createRequire（bundler 环境请用 setWasmDirs 注入 wasm 目录）");
+    }
+    return createRequireFn(path.join(process.cwd(), "index.js"));
+}
+const SKIP_DIRS = new Set([
+    "node_modules", ".git", ".next", "dist", "build", "out", "coverage",
+    ".zmzai", ".venv", "venv", "__pycache__", "vendor", ".cache", ".turbo",
+]);
+const CODE_EXTS = new Set([".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs", ".py", ".go"]);
+const MAX_FILE_BYTES = 512 * 1024;
+const LANG_BY_EXT = {
+    ".ts": { wasm: "tree-sitter-typescript.wasm", defs: ["function_declaration", "class_declaration", "method_definition", "interface_declaration", "enum_declaration", "type_alias_declaration", "abstract_class_declaration", "generator_function_declaration"], refs: ["identifier", "property_identifier", "type_identifier"] },
+    ".mts": { wasm: "tree-sitter-typescript.wasm", defs: ["function_declaration", "class_declaration", "method_definition", "interface_declaration", "enum_declaration", "type_alias_declaration"], refs: ["identifier", "property_identifier", "type_identifier"] },
+    ".cts": { wasm: "tree-sitter-typescript.wasm", defs: ["function_declaration", "class_declaration", "method_definition", "interface_declaration", "enum_declaration", "type_alias_declaration"], refs: ["identifier", "property_identifier", "type_identifier"] },
+    ".tsx": { wasm: "tree-sitter-tsx.wasm", defs: ["function_declaration", "class_declaration", "method_definition", "interface_declaration", "enum_declaration", "type_alias_declaration"], refs: ["identifier", "property_identifier", "type_identifier"] },
+    ".js": { wasm: "tree-sitter-javascript.wasm", defs: ["function_declaration", "class_declaration", "method_definition", "generator_function_declaration"], refs: ["identifier", "property_identifier", "shorthand_property_identifier"] },
+    ".jsx": { wasm: "tree-sitter-javascript.wasm", defs: ["function_declaration", "class_declaration", "method_definition"], refs: ["identifier", "property_identifier", "shorthand_property_identifier"] },
+    ".mjs": { wasm: "tree-sitter-javascript.wasm", defs: ["function_declaration", "class_declaration", "method_definition"], refs: ["identifier", "property_identifier", "shorthand_property_identifier"] },
+    ".cjs": { wasm: "tree-sitter-javascript.wasm", defs: ["function_declaration", "class_declaration", "method_definition"], refs: ["identifier", "property_identifier", "shorthand_property_identifier"] },
+    ".py": { wasm: "tree-sitter-python.wasm", defs: ["function_definition", "class_definition"], refs: ["identifier"] },
+    ".go": { wasm: "tree-sitter-go.wasm", defs: ["function_declaration", "method_declaration", "type_spec"], refs: ["identifier", "field_identifier", "type_identifier", "package_identifier"] },
+};
+let parserInit = null;
+const languageCache = new Map();
+const parserByLang = new Map();
+function pkgDir(moduleName) {
+    // 包 exports 各有缺口（web-tree-sitter 不暴露 wasm/package.json 子路径，
+    // tree-sitter-wasms 的 main 坏了），双策略：先 package.json 锚点，fallback 主入口
+    const require_ = nodeRequire();
+    try {
+        return path.dirname(require_.resolve(`${moduleName}/package.json`));
+    }
+    catch {
+        return path.dirname(require_.resolve(moduleName));
+    }
+}
+function runtimeWasmDir() {
+    return wasmDirs.runtime ?? pkgDir("web-tree-sitter");
+}
+function grammarWasmDir() {
+    return wasmDirs.grammar ?? path.join(pkgDir("tree-sitter-wasms"), "out");
+}
+function ensureParserInit() {
+    parserInit ??= Parser.init({
+        locateFile(scriptName) {
+            // web-tree-sitter 的运行时 wasm（tree-sitter.wasm）随包分发
+            return path.join(runtimeWasmDir(), scriptName);
+        },
+    });
+    return parserInit;
+}
+async function languageFor(wasmFile) {
+    const cached = languageCache.get(wasmFile);
+    if (cached)
+        return cached;
+    const pending = (async () => {
+        await ensureParserInit();
+        return Language.load(path.join(grammarWasmDir(), wasmFile));
+    })();
+    languageCache.set(wasmFile, pending);
+    return pending;
+}
+function collectTags(file, content, spec) {
+    const tags = [];
+    let parser = parserByLang.get(spec.wasm);
+    if (!parser) {
+        parser = new Parser();
+        parserByLang.set(spec.wasm, parser);
+    }
+    const tree = parser.parse(content);
+    if (!tree)
+        return tags;
+    const root = tree.rootNode;
+    for (const defType of spec.defs) {
+        for (const node of root.descendantsOfType(defType)) {
+            if (!node)
+                continue;
+            const nameNode = node.childForFieldName("name");
+            if (!nameNode)
+                continue;
+            tags.push({ file, line: node.startPosition.row + 1, name: nameNode.text, kind: "def" });
+        }
+    }
+    for (const refType of spec.refs) {
+        for (const node of root.descendantsOfType(refType)) {
+            if (!node)
+                continue;
+            const name = node.text;
+            if (name && name.length <= 64)
+                tags.push({ file, line: node.startPosition.row + 1, name, kind: "ref" });
+        }
+    }
+    tree.delete();
+    return tags;
+}
+/** 解析单文件为标签（缓存未命中路径）。语言不支持或解析失败返回空。 */
+export async function extractTags(relFile, absFile) {
+    const ext = path.extname(relFile).toLowerCase();
+    const spec = LANG_BY_EXT[ext];
+    if (!spec)
+        return [];
+    const { readFile } = await import("node:fs/promises");
+    let content;
+    try {
+        const info = await stat(absFile);
+        if (info.size > MAX_FILE_BYTES)
+            return [];
+        content = await readFile(absFile, "utf8");
+    }
+    catch {
+        return [];
+    }
+    if (content.includes("\u0000"))
+        return []; // 二进制嗅探
+    try {
+        const lang = await languageFor(spec.wasm);
+        let parser = parserByLang.get(spec.wasm);
+        if (!parser) {
+            parser = new Parser();
+            parserByLang.set(spec.wasm, parser);
+        }
+        parser.setLanguage(lang);
+        return collectTags(relFile, content, spec);
+    }
+    catch (error) {
+        // 抽取失败必须向编排层报错（而非静默空数组）：空结果会被 mtime 缓存、
+        // 污染后续调用；由编排层决定跳过与重试。Next 等 bundler 环境下 wasm
+        // 解析可能失败（import.meta.url 被重写），用 serverExternalPackages 解决。
+        if (process.env.ZMZAI_REPOMAP_DEBUG)
+            console.error("[repomap] extract failed:", error);
+        throw error instanceof Error ? error : new Error(String(error));
+    }
+}
+/** 递归列出工作区内的代码文件（跳重目录，cap 防爆）。 */
+export async function listCodeFiles(root, opts = {}) {
+    const maxFiles = opts.maxFiles ?? 5000;
+    const files = [];
+    let skipped = 0;
+    const walk = async (dir) => {
+        if (files.length >= maxFiles)
+            return;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (files.length >= maxFiles)
+                return;
+            const abs = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (SKIP_DIRS.has(entry.name) || entry.name.startsWith("."))
+                    continue;
+                await walk(abs);
+            }
+            else if (entry.isFile()) {
+                const rel = path.relative(root, abs).split(path.sep).join("/");
+                if (!CODE_EXTS.has(path.extname(entry.name).toLowerCase()))
+                    continue;
+                if (opts.filter && !opts.filter(rel))
+                    continue;
+                files.push(rel);
+            }
+        }
+    };
+    await walk(root);
+    if (files.length >= maxFiles)
+        skipped = files.length; // 达到 cap：未知总数，标记触顶
+    return { files: files.sort(), skipped };
+}
+//# sourceMappingURL=tags.js.map

package/dist/core/repomap/tags.js.map

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

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

@@ -1,11 +1,25 @@
 import type { AgentMessage } from "@earendil-works/pi-agent-core";
 import type { Api, Model } from "@earendil-works/pi-ai";
-/** Framework compaction (spec §8.3): when the PI-visible context approaches the
- *  model's window, replace the older history with a generated summary and keep
- *  a recent tail. Wired through PI's transformContext — the loop calls it
- *  before every LLM request. The emitted `compaction` part marks the boundary
- *  in the transcript (the full pre-compaction messages stay persisted in the
- *  framework store; only the model's working context is condensed). */
+/** Framework compaction (spec §8.3) — projection style (tutorial-advanced 06):
+ *  canonical history (PI state.messages) is never mutated; the transform keeps
+ *  closure state {anchor, summary} and projects the model's view as
+ *  [summaryMessage, ...messages.slice(anchor)]. PI's transformContext result is
+ *  request-only (never written back to state), so the previous stateless
+ *  version re-summarized the whole history on every LLM request — the anchor
+ *  turns compaction into an incremental, idempotent projection.
+ *  Known limitation: closure state lives per-run (the runner builds a fresh
+ *  transform for each runLoop), so a new run re-summarizes once when it next
+ *  crosses the threshold; cross-run persistence belongs in the store later.
+ *
+ *  Harness-course retrofits (tutorial-harness 05/07) preserved:
+ *  - 膨胀拒绝：新摘要比它替代的内容（新折叠段 + 旧摘要）还长时作废本次压缩。
+ *  - 失败记忆：摘要调用失败或膨胀后，本轮不再反复烧摘要 token。
+ *  Projection retrofit adds (tutorial-advanced 06):
+ *  - 滞回带：已有摘要时，只有投影尾部自上次压缩后长够摘要体量的一半才再压，
+ *    防止超窗后每个请求都重摘一遍。
+ *  - 增量摘要：摘要提示词带【已有摘要】+ 新折叠段，反复压缩是续写不是重启。
+ *  - 摘要消息固定 timestamp: 0：投影前缀跨请求逐字节稳定，provider 的
+ *    prompt cache（前缀逐字节匹配）在两次压缩之间持续命中。 */
 export type CompactionOptions = {
     /** Cheap model used to write the summary (the relay's small model). */
     summaryModel: Model<Api>;
@@ -22,15 +36,12 @@ export type CompactionOptions = {
     /** Called when a compaction attempt fails ("summary-empty" | "summary-inflated");
      *  after any failure the transform stops retrying for this run (失败记忆). */
     onCompactionFailed?: (reason: "summary-empty" | "summary-inflated") => void | Promise<void>;
+    /** 无条件压缩（UI「压缩当前会话」）：跳过阈值与滞回早退，其余保护（膨胀拒绝等）不变。 */
+    force?: boolean;
 };
-/** Returns a transformContext that compacts when over threshold.
- *
- * Harness-course retrofits (tutorial-harness 05/07):
- *  - 膨胀拒绝（Gemini chatCompressionService）：摘要比被压区还长时作废本次压缩，
- *    宁可用全量上下文也不换一份负收益的摘要。
- *  - 失败记忆（Gemini hasFailedCompressionAttempt）：摘要调用失败或膨胀后记住这次
- *    失败，后续不再反复烧摘要 token；失败不静默，通过 onCompactionFailed 上报。
- */
+/** Returns a transformContext that projects the model's view as
+ *  [summaryMessage?, ...messages.slice(anchor)] and compacts incrementally
+ *  when the projection crosses the window. */
 export declare function createCompactionTransform(options: CompactionOptions): (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;
 /** One-shot completion via an AssistantMessageEventStream (relay streamFn
  *  shape): drives the stream to completion and returns its full text. Used for
@@ -55,5 +66,6 @@ export declare function buildCompactionTransform(input: {
     summaryModel: Model<Api> | null;
     streamOne: (model: Model<Api>, messages: AgentMessage[]) => Promise<string>;
     onCompacted?: (summary: string, tokensBefore: number) => void;
+    force?: boolean;
 }): ((messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>) | undefined;
 //# sourceMappingURL=compaction.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;;uEAKuE;AAEvE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,uEAAuE;IACvE,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,wEAAwE;IACxE,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D;8EAC0E;IAC1E,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,GAAG,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7F,CAAC;AAiCF;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAuCjJ;AAED;;kEAEkE;AAClE,wBAAsB,aAAa,CACjC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,KAAK,OAAO,CAAC;IAAE,MAAM,IAAI,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,GAAG;IAAE,MAAM,IAAI,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,EAClM,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,YAAY,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED;6EAC6E;AAC7E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/D,GAAG,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,GAAG,SAAS,CAQ5F"}
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;0CAmB0C;AAE1C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,uEAAuE;IACvE,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,wEAAwE;IACxE,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D;8EAC0E;IAC1E,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,GAAG,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAwCF;;8CAE8C;AAC9C,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAoDjJ;AAED;;kEAEkE;AAClE,wBAAsB,aAAa,CACjC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,KAAK,OAAO,CAAC;IAAE,MAAM,IAAI,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,GAAG;IAAE,MAAM,IAAI,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,EAClM,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,YAAY,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED;6EAC6E;AAC7E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,GAAG,SAAS,CAS5F"}

package/dist/core/runtime/compaction.js

@@ -27,53 +27,64 @@ function estimateTokens(messages) {
     return total;
 }
 const SUMMARY_INSTRUCTION = "把以下对话压缩成一份中文工作摘要，保留：任务目标、已完成的关键步骤与工具结果、当前进度、待办事项、重要的文件路径/命令/产物。不要续写对话，只输出结构化摘要。";
-/** Returns a transformContext that compacts when over threshold.
- *
- * Harness-course retrofits (tutorial-harness 05/07):
- *  - 膨胀拒绝（Gemini chatCompressionService）：摘要比被压区还长时作废本次压缩，
- *    宁可用全量上下文也不换一份负收益的摘要。
- *  - 失败记忆（Gemini hasFailedCompressionAttempt）：摘要调用失败或膨胀后记住这次
- *    失败，后续不再反复烧摘要 token；失败不静默，通过 onCompactionFailed 上报。
- */
+/** The summary message is deterministic (fixed shape, timestamp 0) so the
+ *  projected prefix is byte-stable across requests — this is what lets the
+ *  provider's prompt cache keep hitting between two compactions. */
+function summaryMessage(text) {
+    return { role: "user", content: `【早期对话摘要】\n${text}`, timestamp: 0 };
+}
+/** Returns a transformContext that projects the model's view as
+ *  [summaryMessage?, ...messages.slice(anchor)] and compacts incrementally
+ *  when the projection crosses the window. */
 export function createCompactionTransform(options) {
     const reserve = options.reserveTokens ?? 4096;
     const keepRecent = options.keepRecentMessages ?? 8;
-    let hasFailed = false;
+    let summary = null; // 投影的唯一状态：当前摘要
+    let anchor = 0; // canonical 历史中已折叠的前缀长度
+    let tailTokensAtCompaction = 0; // 上次压缩时投影尾部的 token 量（滞回带基准）
+    let hasFailed = false; // 失败记忆：本轮不再重试摘要
     return async (messages, signal) => {
         void signal;
-        const tokens = estimateTokens(messages);
-        if (tokens + reserve < options.contextWindow)
-            return messages;
-        if (hasFailed)
-            return messages; // 失败记忆：不再反复尝试摘要
-        if (messages.length <= keepRecent + 1)
-            return messages; // nothing worth compacting
-        const tail = messages.slice(-keepRecent);
-        const head = messages.slice(0, -keepRecent);
+        // 投影：canonical 不可变，模型看到的永远是 [摘要?, slice(anchor)]
+        const projected = summary === null ? messages : [summaryMessage(summary), ...messages.slice(anchor)];
+        const projectedTokens = estimateTokens(projected);
+        if (!options.force && projectedTokens + reserve < options.contextWindow)
+            return projected;
+        // 滞回带：已有摘要但尾部自上次压缩后没长够摘要的一半——再压不划算
+        const tailTokens = estimateTokens(messages.slice(anchor));
+        const summaryTokens = summary === null ? 0 : estimateTokens([summaryMessage(summary)]);
+        const grownEnough = summary === null || tailTokens >= tailTokensAtCompaction + Math.ceil(summaryTokens / 2);
+        if (!options.force && (hasFailed || !grownEnough))
+            return projected;
+        if (messages.length - anchor <= keepRecent + 1)
+            return projected; // nothing new worth folding
+        const tailCount = Math.min(keepRecent, messages.length - anchor);
+        const fold = messages.slice(anchor, messages.length - tailCount);
+        const foldTokens = estimateTokens(fold);
+        // 增量摘要：旧摘要作为上下文带入，只对新折叠段续写
+        const priorSection = summary === null ? "" : `【已有摘要】\n${summary}\n\n`;
         const summaryInput = [
-            ...head,
-            { role: "user", content: SUMMARY_INSTRUCTION, timestamp: Date.now() },
+            ...fold,
+            { role: "user", content: `${priorSection}${SUMMARY_INSTRUCTION}`, timestamp: Date.now() },
         ];
-        const summary = await options.streamSummary(summaryInput).catch(() => "");
-        if (!summary) {
+        const next = await options.streamSummary(summaryInput).catch(() => "");
+        if (!next) {
             hasFailed = true;
             await options.onCompactionFailed?.("summary-empty");
-            return messages; // compaction failed — degrade to full context
+            return projected; // compaction failed — degrade to the current projection
         }
-        // 膨胀拒绝：摘要比被压区还长，压了不如不压
-        const headTokens = estimateTokens(head);
-        if (estimateTokens([{ role: "user", content: summary, timestamp: Date.now() }]) >= headTokens) {
+        // 膨胀拒绝：新摘要比它替代的内容（新折叠段 + 旧摘要）还长，压了不如不压
+        const nextTokens = estimateTokens([summaryMessage(next)]);
+        if (nextTokens >= foldTokens + summaryTokens) {
             hasFailed = true;
             await options.onCompactionFailed?.("summary-inflated");
-            return messages;
+            return projected;
         }
-        options.onCompacted?.(summary, tokens);
-        const compactionMessage = {
-            role: "user",
-            content: `【早期对话摘要】\n${summary}`,
-            timestamp: Date.now(),
-        };
-        return [compactionMessage, ...tail];
+        summary = next;
+        anchor = messages.length - tailCount;
+        tailTokensAtCompaction = estimateTokens(messages.slice(anchor));
+        options.onCompacted?.(summary, projectedTokens);
+        return [summaryMessage(summary), ...messages.slice(anchor)];
     };
 }
 /** One-shot completion via an AssistantMessageEventStream (relay streamFn
@@ -103,6 +114,7 @@ export function buildCompactionTransform(input) {
         contextWindow: input.contextWindow,
         streamSummary: (messages) => input.streamOne(input.summaryModel, messages),
         ...(input.onCompacted ? { onCompacted: input.onCompacted } : {}),
+        ...(input.force ? { force: true } : {}),
     });
 }
 //# sourceMappingURL=compaction.js.map

package/dist/core/runtime/compaction.js.map

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

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

@@ -0,0 +1,79 @@
+/** 生命周期钩子（P0）：宿主/插件在不侵入 runner 的前提下观察并约束运行。
+ *  参考 codex hooks/ 与 gemini hooks/ 的最小面——四个挂点：
+ *
+ *  - onRunStart      一次 run 开始（收到 prompt，尚未调模型）
+ *  - onBeforeToolCall  权限审批通过后、工具执行前；可 {block:true,reason}
+ *                      拦截（reason 会作为结果反馈给模型）
+ *  - onAfterToolCall   工具执行结束（含 isError）；只读，不可改结果
+ *  - onRunEnd        run 终态（ok/aborted）
+ *
+ *  约定：钩子抛错只告警不中断运行；block 是唯一有副作用的出口。多个 hook
+ *  依次调用，第一个返回 block 的生效。 */
+import type { RunTranscriptMessage } from "./run-transcript.js";
+export type LifecycleHook = {
+    /** 诊断名（日志用） */
+    name?: string;
+    onRunStart?(input: {
+        sessionId: string;
+        agent: string;
+        text: string;
+    }): void | Promise<void>;
+    onBeforeToolCall?(input: {
+        sessionId: string;
+        agent: string;
+        tool: string;
+        args: unknown;
+    }): {
+        block: true;
+        reason: string;
+    } | undefined | void | Promise<{
+        block: true;
+        reason: string;
+    } | undefined | void>;
+    onAfterToolCall?(input: {
+        sessionId: string;
+        agent: string;
+        tool: string;
+        isError: boolean;
+        title?: string;
+    }): void | Promise<void>;
+    onRunEnd?(input: {
+        sessionId: string;
+        agent: string;
+        ok: boolean;
+        aborted: boolean;
+        workspaceId?: string;
+        newMessages?: RunTranscriptMessage[];
+    }): void | Promise<void>;
+};
+export declare function fireRunStart(hooks: LifecycleHook[], input: {
+    sessionId: string;
+    agent: string;
+    text: string;
+}): Promise<void>[];
+/** 返回第一个生效的 block；钩子抛错视同放行。 */
+export declare function firstToolBlock(hooks: LifecycleHook[], input: {
+    sessionId: string;
+    agent: string;
+    tool: string;
+    args: unknown;
+}): Promise<{
+    block: true;
+    reason: string;
+} | undefined>;
+export declare function fireAfterToolCall(hooks: LifecycleHook[], input: {
+    sessionId: string;
+    agent: string;
+    tool: string;
+    isError: boolean;
+    title?: string;
+}): Promise<void>[];
+export declare function fireRunEnd(hooks: LifecycleHook[], input: {
+    sessionId: string;
+    agent: string;
+    ok: boolean;
+    aborted: boolean;
+    workspaceId?: string;
+    newMessages?: RunTranscriptMessage[];
+}): Promise<void>[];
+//# sourceMappingURL=lifecycle.d.ts.map

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

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

package/dist/core/runtime/lifecycle.js

@@ -0,0 +1,71 @@
+/** 生命周期钩子（P0）：宿主/插件在不侵入 runner 的前提下观察并约束运行。
+ *  参考 codex hooks/ 与 gemini hooks/ 的最小面——四个挂点：
+ *
+ *  - onRunStart      一次 run 开始（收到 prompt，尚未调模型）
+ *  - onBeforeToolCall  权限审批通过后、工具执行前；可 {block:true,reason}
+ *                      拦截（reason 会作为结果反馈给模型）
+ *  - onAfterToolCall   工具执行结束（含 isError）；只读，不可改结果
+ *  - onRunEnd        run 终态（ok/aborted）
+ *
+ *  约定：钩子抛错只告警不中断运行；block 是唯一有副作用的出口。多个 hook
+ *  依次调用，第一个返回 block 的生效。 */
+function warn(hook, phase, error) {
+    console.warn(`[zmzai-agent-framework] lifecycle hook ${hook.name ?? "anonymous"}#${phase} 抛错已忽略：`, error);
+}
+export function fireRunStart(hooks, input) {
+    return hooks.map((hook) => {
+        if (!hook.onRunStart)
+            return Promise.resolve();
+        try {
+            return Promise.resolve(hook.onRunStart(input)).catch((error) => warn(hook, "onRunStart", error));
+        }
+        catch (error) {
+            warn(hook, "onRunStart", error);
+            return Promise.resolve();
+        }
+    });
+}
+/** 返回第一个生效的 block；钩子抛错视同放行。 */
+export async function firstToolBlock(hooks, input) {
+    for (const hook of hooks) {
+        if (!hook.onBeforeToolCall)
+            continue;
+        try {
+            const result = await hook.onBeforeToolCall(input);
+            if (result && "block" in result && result.block === true) {
+                return { block: true, reason: result.reason };
+            }
+        }
+        catch (error) {
+            warn(hook, "onBeforeToolCall", error);
+        }
+    }
+    return undefined;
+}
+export function fireAfterToolCall(hooks, input) {
+    return hooks.map((hook) => {
+        if (!hook.onAfterToolCall)
+            return Promise.resolve();
+        try {
+            return Promise.resolve(hook.onAfterToolCall(input)).catch((error) => warn(hook, "onAfterToolCall", error));
+        }
+        catch (error) {
+            warn(hook, "onAfterToolCall", error);
+            return Promise.resolve();
+        }
+    });
+}
+export function fireRunEnd(hooks, input) {
+    return hooks.map((hook) => {
+        if (!hook.onRunEnd)
+            return Promise.resolve();
+        try {
+            return Promise.resolve(hook.onRunEnd(input)).catch((error) => warn(hook, "onRunEnd", error));
+        }
+        catch (error) {
+            warn(hook, "onRunEnd", error);
+            return Promise.resolve();
+        }
+    });
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/core/runtime/lifecycle.js.map

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

package/dist/core/runtime/pi-bridge.d.ts

@@ -40,7 +40,10 @@ export declare class PartProjector {
     private flushText;
     private flushAllText;
     private assistantPart;
-    onUserPrompt(emit: Emit, text: string): MessageInfo;
+    onUserPrompt(emit: Emit, text: string, images?: readonly {
+        url: string;
+        mediaType: string;
+    }[]): MessageInfo;
     onAssistantStart(emit: Emit): void;
     onTextDelta(emit: Emit, contentIndex: number, delta: string): void;
     onThinkingDelta(emit: Emit, contentIndex: number, delta: string): void;

package/dist/core/runtime/pi-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pi-bridge.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/pi-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAmB,MAAM,qBAAqB,CAAC;AAElF;;yEAEyE;AAEzE,MAAM,MAAM,cAAc,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEnF,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAY5C;;oEAEoE;AACpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAQ1H;AAED,qBAAa,aAAa;IAoBZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAnBrC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAC9D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAgC;IACnE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAK;IACxB;;8EAE0E;IAC1E,OAAO,CAAC,mBAAmB,CAAuB;IAElD;mCAC+B;IAC/B,IAAI,yBAAyB,IAAI,MAAM,GAAG,IAAI,CAE7C;gBAE4B,QAAQ,EAAE,cAAc;IAErD,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,aAAa;IAarB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW;IA0BnD,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAqBlC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAWlE,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAWtE,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAe3G,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAU7E,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAuB3F,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;CA6BxD"}
+{"version":3,"file":"pi-bridge.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/pi-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAmB,MAAM,qBAAqB,CAAC;AAElF;;yEAEyE;AAEzE,MAAM,MAAM,cAAc,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEnF,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAY5C;;oEAEoE;AACpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAQ1H;AAED,qBAAa,aAAa;IAoBZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAnBrC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAC9D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAgC;IACnE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAK;IACxB;;8EAE0E;IAC1E,OAAO,CAAC,mBAAmB,CAAuB;IAElD;mCAC+B;IAC/B,IAAI,yBAAyB,IAAI,MAAM,GAAG,IAAI,CAE7C;gBAE4B,QAAQ,EAAE,cAAc;IAErD,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,aAAa;IAarB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,WAAW;IAwC3G,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAqBlC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAWlE,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAWtE,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAe3G,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAU7E,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAuB3F,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;CA6BxD"}