@whispering233/ai-editor-agent 0.0.30 → 0.0.33

package/dist/runtime/system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/runtime/system-prompt.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,EAAE;AACF,kEAAkE;AAClE,+CAA+C;AAC/C,EAAE;AACF,0CAA0C;AAE1C,gEAAgE;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;gBAWb,CAAC;AAEjB,+CAA+C;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC"}

package/dist/runtime/tool-result.d.ts

@@ -0,0 +1,12 @@
+/** 单条工具结果 token 上限（不可配——失控保护常量，见 docs/design/config.md） */
+export declare const TOOL_RESULT_MAX_TOKENS = 8000;
+/**
+ * 保守 token 估算：ASCII 按 4 字符 ≈ 1 token，非 ASCII（CJK 等）按 1 字符 ≈ 1 token。
+ * 中文真实密度约 1 字 ≈ 0.6 token——**故意高估**：预算宁可保守（截断偏早优于超窗）。
+ */
+export declare function estimateTokens(text: string): number;
+/** 工具返回值 → 回填文本（字符串原样；其余 JSON 序列化；不可序列化 → String()） */
+export declare function stringifyToolResult(result: unknown): string;
+/** 超上限 → 截断 + 结构化提示（未超限原样返回） */
+export declare function truncateToolResultText(text: string, maxTokens?: number): string;
+//# sourceMappingURL=tool-result.d.ts.map

package/dist/runtime/tool-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.d.ts","sourceRoot":"","sources":["../../src/runtime/tool-result.ts"],"names":[],"mappings":"AAMA,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAQ3D;AAYD,gCAAgC;AAChC,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAA+B,GAAG,MAAM,CAKvG"}

package/dist/runtime/tool-result.js

@@ -0,0 +1,53 @@
+// pi 运行时：工具结果文本化与截断
+//
+// pi 只对内置工具做输出截断；自定义工具必须自己控制回填给模型的文本量，
+// 否则 `get_outline` 整树 / `query_relationships` depth=3 会撑爆上下文。
+// 契约（docs/design/20-context.md §2）：超上限即截断 + **显式告知**（模型必须知道数据不完整）。
+/** 单条工具结果 token 上限（不可配——失控保护常量，见 docs/design/config.md） */
+export const TOOL_RESULT_MAX_TOKENS = 8000;
+/**
+ * 保守 token 估算：ASCII 按 4 字符 ≈ 1 token，非 ASCII（CJK 等）按 1 字符 ≈ 1 token。
+ * 中文真实密度约 1 字 ≈ 0.6 token——**故意高估**：预算宁可保守（截断偏早优于超窗）。
+ */
+export function estimateTokens(text) {
+    let ascii = 0;
+    let wide = 0;
+    for (let i = 0; i < text.length; i++) {
+        if (text.charCodeAt(i) < 128)
+            ascii++;
+        else
+            wide++;
+    }
+    return Math.ceil(ascii / 4) + wide;
+}
+/** 工具返回值 → 回填文本（字符串原样；其余 JSON 序列化；不可序列化 → String()） */
+export function stringifyToolResult(result) {
+    if (typeof result === "string")
+        return result;
+    try {
+        const json = JSON.stringify(result);
+        return json === undefined ? String(result) : json;
+    }
+    catch {
+        return String(result);
+    }
+}
+/** 按 token 预算截断前缀（宽字符按 1 token 计，逐字符累计） */
+function cutToTokenBudget(text, maxTokens) {
+    let tokens = 0;
+    for (let i = 0; i < text.length; i++) {
+        tokens += text.charCodeAt(i) < 128 ? 0.25 : 1;
+        if (tokens > maxTokens)
+            return text.slice(0, i);
+    }
+    return text;
+}
+/** 超上限 → 截断 + 结构化提示（未超限原样返回） */
+export function truncateToolResultText(text, maxTokens = TOOL_RESULT_MAX_TOKENS) {
+    const tokens = estimateTokens(text);
+    if (tokens <= maxTokens)
+        return text;
+    const head = cutToTokenBudget(text, maxTokens);
+    return `${head}\n\n[工具结果已截断：原始约 ${tokens} tokens，超出单条上限 ${maxTokens} tokens，当前数据不完整。请缩小查询范围或分页获取后重试。]`;
+}
+//# sourceMappingURL=tool-result.js.map

package/dist/runtime/tool-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.js","sourceRoot":"","sources":["../../src/runtime/tool-result.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,EAAE;AACF,uCAAuC;AACvC,8DAA8D;AAC9D,mEAAmE;AAEnE,2DAA2D;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG;YAAE,KAAK,EAAE,CAAC;;YACjC,IAAI,EAAE,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;AACrC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,2CAA2C;AAC3C,SAAS,gBAAgB,CAAC,IAAY,EAAE,SAAiB;IACvD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,MAAM,GAAG,SAAS;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,YAAoB,sBAAsB;IAC7F,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,MAAM,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC/C,OAAO,GAAG,IAAI,oBAAoB,MAAM,kBAAkB,SAAS,mCAAmC,CAAC;AACzG,CAAC"}

package/dist/runtime/tools.d.ts

@@ -0,0 +1,28 @@
+import type { ToolDefinition as PiToolDefinition } from "@earendil-works/pi-coding-agent";
+import { type ToolContext } from "@whispering233/ai-editor-tools";
+/** 提案载荷（`propose_*` 工具的 details；推送前端的形态见 docs/api/80-api-chat.md） */
+export interface ProposalPayload {
+    proposal_id: string;
+    type: string;
+    preview: Record<string, unknown>;
+}
+/** 提案登记入参（K3 的提案仓消费：可据此重建完整 Proposal 并入仓；未接线返回 undefined） */
+export interface ProposalSinkInput {
+    toolName: string;
+    toolCallId: string;
+    /** 校验/coerce 后的工具参数（重建 Proposal 需要，与 run 内部同源） */
+    params: unknown;
+    /** run 的返回值（propose_* 为 `{ proposal_id, summary }`，不含预览细节） */
+    result: unknown;
+    toolContext: ToolContext;
+}
+/** 提案登记回调（K2 只留接线点，缺省 no-op；K3 接提案仓） */
+export type ProposalSink = (input: ProposalSinkInput) => ProposalPayload | undefined;
+export interface CreateCustomToolsOptions {
+    toolContext: ToolContext;
+    proposalSink?: ProposalSink;
+}
+/** registry 全部工具 → pi 工具定义（顺序 = listTools 的稳定序） */
+export declare function createCustomTools(options: CreateCustomToolsOptions): PiToolDefinition[];
+/** 工具参数 schema 类型（测试/调用方按需引用） */
+//# sourceMappingURL=tools.d.ts.map

package/dist/runtime/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/runtime/tools.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,IAAI,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAE1F,OAAO,EAAa,KAAK,WAAW,EAA+C,MAAM,gCAAgC,CAAC;AAG1H,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,MAAM,EAAE,OAAO,CAAC;IAChB,8DAA8D;IAC9D,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,wCAAwC;AACxC,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,eAAe,GAAG,SAAS,CAAC;AAErF,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AA4CD,mDAAmD;AACnD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,gBAAgB,EAAE,CAEvF;AAED,iCAAiC"}

package/dist/runtime/tools.js

@@ -0,0 +1,54 @@
+// pi 运行时：领域工具 → pi 工具定义（TypeBox 直通，不转换）
+//
+// 适配面很薄：name/label/description/parameters 直通；execute 注入 ToolContext（db/outlineDir/projectId），
+// 把 tools 包的返回值文本化回填并做截断；PROPOSAL 权限工具的提案载荷走 `details`（K3 接提案仓）。
+//
+// 契约见 docs/api/tool-calling.md：抛错即失败（不把失败编码进 content）；提案 content 只给
+// 「提案已发出」提示，预览细节在 details 里随 SSE 推给 GUI。
+import { TOOL_PERMISSION } from "@whispering233/ai-editor-shared";
+import { listTools } from "@whispering233/ai-editor-tools";
+import { stringifyToolResult, truncateToolResultText } from "./tool-result.js";
+/** 提案已发出提示（content 不含预览细节——避免模型误以为提案已生效）
+ * 一句话摘要取自 preview.summary（结构化 preview 的提案没有该字段，则只给 id） */
+function proposalAckText(payload) {
+    const summary = payload.preview.summary;
+    const summaryText = typeof summary === "string" && summary !== "" ? `${summary}；` : "";
+    return `提案已发出（proposal_id=${payload.proposal_id}）：${summaryText}需用户确认后才会生效；确认前不要假设任何修改已发生。`;
+}
+/** 单个领域工具 → pi 工具定义 */
+function toPiTool(tool, options) {
+    return {
+        name: tool.name,
+        label: tool.name,
+        description: tool.description,
+        parameters: tool.parameters,
+        execute: async (toolCallId, params, signal) => {
+            const result = await tool.run(options.toolContext, params, signal);
+            if (tool.permission === TOOL_PERMISSION.PROPOSAL) {
+                const proposal = options.proposalSink?.({
+                    toolName: tool.name,
+                    toolCallId,
+                    params,
+                    result,
+                    toolContext: options.toolContext,
+                });
+                if (proposal !== undefined) {
+                    return {
+                        content: [{ type: "text", text: proposalAckText(proposal) }],
+                        details: proposal,
+                    };
+                }
+            }
+            return {
+                content: [{ type: "text", text: truncateToolResultText(stringifyToolResult(result)) }],
+                details: result,
+            };
+        },
+    };
+}
+/** registry 全部工具 → pi 工具定义（顺序 = listTools 的稳定序） */
+export function createCustomTools(options) {
+    return listTools().map((tool) => toPiTool(tool, options));
+}
+/** 工具参数 schema 类型（测试/调用方按需引用） */
+//# sourceMappingURL=tools.js.map

package/dist/runtime/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/runtime/tools.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,EAAE;AACF,8FAA8F;AAC9F,iEAAiE;AACjE,EAAE;AACF,oEAAoE;AACpE,yCAAyC;AAGzC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAiE,MAAM,gCAAgC,CAAC;AAC1H,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AA4B/E;0DAC0D;AAC1D,SAAS,eAAe,CAAC,OAAwB;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;IACxC,MAAM,WAAW,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,OAAO,qBAAqB,OAAO,CAAC,WAAW,KAAK,WAAW,4BAA4B,CAAC;AAC9F,CAAC;AAED,uBAAuB;AACvB,SAAS,QAAQ,CAAC,IAA0B,EAAE,OAAiC;IAC7E,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,IAAI;QAChB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC5C,MAAM,MAAM,GAAY,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,MAAe,EAAE,MAAM,CAAC,CAAC;YAErF,IAAI,IAAI,CAAC,UAAU,KAAK,eAAe,CAAC,QAAQ,EAAE,CAAC;gBACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;oBACtC,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,UAAU;oBACV,MAAM;oBACN,MAAM;oBACN,WAAW,EAAE,OAAO,CAAC,WAAW;iBACjC,CAAC,CAAC;gBACH,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,OAAO;wBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACrE,OAAO,EAAE,QAAQ;qBAClB,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sBAAsB,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBAC/F,OAAO,EAAE,MAAM;aAChB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,OAAO,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,iCAAiC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whispering233/ai-editor-agent",
-  "version": "0.0.30",
+  "version": "0.0.33",
   "license": "MIT",
   "description": "AI 对话循环：会话管理 / 上下文组装 / 工具调度",
   "type": "module",
@@ -26,9 +26,10 @@
     "postpack": "node ../../scripts/restore-package-json.mjs"
   },
   "dependencies": {
-    "@whispering233/ai-editor-llm": "0.0.30",
-    "@whispering233/ai-editor-shared": "0.0.30",
-    "@whispering233/ai-editor-tools": "0.0.30"
+    "@earendil-works/pi-ai": "0.85.1",
+    "@earendil-works/pi-coding-agent": "0.85.1",
+    "@whispering233/ai-editor-shared": "0.0.33",
+    "@whispering233/ai-editor-tools": "0.0.33"
   },
   "devDependencies": {
     "typescript": "^5.8.0"

package/dist/context.d.ts

@@ -1,96 +0,0 @@
-import type { LLMMessage, LLMUsage } from "@whispering233/ai-editor-llm";
-import { type ToolDefinition } from "@whispering233/ai-editor-tools";
-import { type SessionMessage } from "./session.js";
-/** 分层 token 预算（系统 ~500 / 聚焦 ~3000 / 历史 ~6000；可整体或单项覆盖）。
- * 分层合计约 11.5K，远低于 DeepSeek 64K 窗口——各层独立校验、不设总预算校验（YAGNI：
- * 分层裁剪已保证各层在其预算内，窗口余量充足） */
-export interface ContextBudgets {
-    /** 基础 system 层：内核 + 项目提示词 + 临时指令（~500；超限仅记录不裁剪——用户内容不可裁） */
-    system: number;
-    /** 聚焦上下文层（~3000；超限截断并显式告知） */
-    focus: number;
-    /** 对话历史层（~6000；超限走 session 成对裁剪——同裁同留不拆对） */
-    history: number;
-}
-export declare const DEFAULT_CONTEXT_BUDGETS: ContextBudgets;
-/** 工具清单注入所需的工具形态（仅消费 name/description，不依赖 registry 全量定义） */
-export type ToolListEntry = Pick<ToolDefinition, "name" | "description">;
-/** buildContext 输入：除 history 外全部可空（无聚焦 / 无项目提示词 / 无临时指令均为合法态） */
-export interface BuildContextInput {
-    /**
-    * 会话历史（session 状态；本层负责超预算成对裁剪 + 末条约束收尾）。
-    * **前置条件**：必须含至少一条 user/tool 消息（末条约束）；空历史属调用方错误——
-    * S7.3 应在 history 为空时走引导分支（不发请求），勿传入空数组（buildPayload 空数组
-    * 语义同源：空历史 = 无有效上下文，两者互相印证）
-    */
-    history: SessionMessage[];
-    /** 内核提示词（默认 KERNEL_PROMPT；测试可覆盖） */
-    kernelPrompt?: string;
-    /** 项目提示词（项目层；起数据源 = 项目目录 文件内容，调用方读取后传入；可空） */
-    projectPrompt?: string;
-    /** 临时指令（临时层，即时输入不持久化；可空） */
-    instruction?: string;
-    /** 聚焦上下文文本（聚焦层，调用方查询实体/大纲节点后拼好传入；空/缺省 = 无聚焦） */
-    focus?: string;
-    /** 工具清单（默认内部 listTools()；测试可注入 mock） */
-    tools?: ToolListEntry[];
-    /**
-    * 最近一次成功响应的 usage 基线（本层触发裁剪后重置为 null）。
-    * **口径**（ora S7.3 审核 S1，与 run.ts toHistoryBaseline / llm token.ts 三处等价表述）：
-    * 调用方（S7.3）须换算为「历史段」真实分量传入——以 usage.prompt_tokens 为起点减
-    * system + toolList + focus 估算（completion 属输出、不占 prompt_tokens，无需扣除）；
-    * 若以 total_tokens 为起点则再减 completion（两式等价）。meta.tokens 已提供
-    * system/toolList/focus 各层估算可供换算；直接传原始 total_tokens 会与非历史层重复计费
-    */
-    lastUsage?: LLMUsage | null;
-    /** 分层预算覆盖（缺省用 常量） */
-    budgets?: Partial<ContextBudgets>;
-}
-/** buildContext 输出：完整喂回 messages + 各层估算 + 裁剪/截断/基线记录 */
-export interface AssembledContext {
-    /** 完整喂回数组：[system(基础+工具清单), (system(聚焦) 若有), ...历史]；末条恒 user/tool 或为空 */
-    messages: LLMMessage[];
-    /** 各层估算 token（history 为裁剪后、无基线重置后的估算） */
-    tokens: {
-        /** 基础 system（内核+项目+临时） */
-        system: number;
-        /** 工具清单（独立于 system 层计，不参与裁剪——LLM 需完整工具表） */
-        toolList: number;
-        /** 聚焦层（截断后；无聚焦为 0） */
-        focus: number;
-        /** 历史层（裁剪后） */
-        history: number;
-        /** 四层合计 */
-        total: number;
-    };
-    meta: {
-        /** 基础 system 超限（仅记录不裁剪——用户内容不可裁） */
-        systemOverBudget: boolean;
-        /** 聚焦被截断（含截断提示） */
-        focusTruncated: boolean;
-        /** 历史被成对裁剪（同裁同留不拆对） */
-        historyTrimmed: boolean;
-        /** 裁剪后历史条数 */
-        historyMessageCount: number;
-        /** 基线被重置（触发裁剪/重排后旧 usage 不再可信—— 防预算漂移） */
-        lastUsageReset: boolean;
-        /**
-        * 生效基线：未触发裁剪时保留换算后的 lastUsage；触发后为 null。
-        * **回写（S7.3 接线）**：本层消费的 lastUsage 是「历史段」口径（见
-        * BuildContextInput.lastUsage）；effectiveLastUsage 仅回写「是否重置」这一决策，
-        * S7.3 下一轮组装时仍须按换算公式从最新 usage 重新计算历史段分量传入
-        */
-        effectiveLastUsage: LLMUsage | null;
-    };
-}
-/**
- * 组装完整喂回上下文：
- * 1. 基础 system = 内核 + 项目提示词 + 临时指令 + 工具清单（超 system 预算仅记录不裁剪）
- * 2. 聚焦注入 = 独立 system 消息（有 focus 时；超预算截断并显式告知）
- * 3. 历史 = 超预算成对裁剪（同裁同留）+ 末条约束收尾（buildPayload——输出末条恒 user/tool）
- * 4. usage 基线：未触发裁剪时保留 lastUsage（真实用量优先）；一旦触发裁剪即重置为
- * null（旧 usage 描述裁剪前前缀，沿用会导致预算漂移）——meta.effectiveLastUsage 反映
- * 生效基线，S7.3 应回写该值作为下一轮输入
- */
-export declare function buildContext(input: BuildContextInput): AssembledContext;
-//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAEzE,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAShF,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9E;;4BAE4B;AAC5B,MAAM,WAAW,cAAc;IAC9B,4DAA4D;IAC3D,MAAM,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,uBAAuB,EAAE,cAIrC,CAAC;AAIF,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC;AAEzE,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IACjC;;;;;MAKE;IACD,OAAO,EAAE,cAAc,EAAE,CAAC;IAC3B,oCAAoC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACvC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB;;;;;;;MAOE;IACD,SAAS,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC7B,qBAAqB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACnC;AAED,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAChC,yEAAyE;IACxE,QAAQ,EAAE,UAAU,EAAE,CAAC;IACxB,yCAAyC;IACxC,MAAM,EAAE;QACT,0BAA0B;QACvB,MAAM,EAAE,MAAM,CAAC;QAClB,4CAA4C;QACzC,QAAQ,EAAE,MAAM,CAAC;QACpB,sBAAsB;QACnB,KAAK,EAAE,MAAM,CAAC;QACjB,eAAe;QACZ,OAAO,EAAE,MAAM,CAAC;QACnB,WAAW;QACR,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,IAAI,EAAE;QACP,oCAAoC;QACjC,gBAAgB,EAAE,OAAO,CAAC;QAC7B,mBAAmB;QAChB,cAAc,EAAE,OAAO,CAAC;QAC3B,uBAAuB;QACpB,cAAc,EAAE,OAAO,CAAC;QAC3B,cAAc;QACX,mBAAmB,EAAE,MAAM,CAAC;QAC/B,0CAA0C;QACvC,cAAc,EAAE,OAAO,CAAC;QAC3B;;;;;UAKE;QACC,kBAAkB,EAAE,QAAQ,GAAG,IAAI,CAAC;KACrC,CAAC;CACH;AAsED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,CA2DvE"}

package/dist/context.js

@@ -1,149 +0,0 @@
-// @whispering233/ai-editor-agent 上下文组装（S7.2）
-//
-// 历史 ~6000；usage 基线——优先最近真实 usage，裁剪历史后重置基线防预算漂移）、
-// （提示词三层注入：内核 + 项目 + 临时）、（POST /api/v1/chat 的
-// context 字段 focus_entity_type/focus_entity_id/focus_node_id——聚焦数据由调用方查询后
-// 以文本传入）、packages/llm/src/token.ts（estimateTokens / estimateMessagesTokens）、
-// packages/tools/src/registry.ts（listTools 工具清单）。
-//
-// 架构边界：本模块**不依赖 db**——聚焦上下文文本与项目提示词均由调用方（S7.6 server 层）
-// 查询后传入，context.ts 只做组装与预算控制；工具列表默认内部取 registry（agent 依赖 tools ✓）。
-//
-// 消费链（S7.3 主循环）：SessionState → buildContext（本层成对裁剪 + 基线重置）→
-// 输出 LLMMessage[]（system + 可选聚焦 system + 历史）直接喂给模型。
-import { estimateMessagesTokens, estimateTokens } from "@whispering233/ai-editor-llm";
-import { listTools } from "@whispering233/ai-editor-tools";
-import { FOCUS_TITLE, FOCUS_TRUNCATION_NOTICE, INSTRUCTION_TITLE, KERNEL_PROMPT, PROJECT_PROMPT_TITLE, TOOL_LIST_TITLE, } from "./prompts.js";
-import { buildPayload, trimSession } from "./session.js";
-export const DEFAULT_CONTEXT_BUDGETS = {
-    system: 500,
-    focus: 3000,
-    history: 6000,
-};
-// ============ 内部组装辅助（纯函数） ============
-/** 基础 system 文本：内核 + 项目提示词 + 临时指令（三层注入，空层跳过） */
-function buildSystemBase(kernel, project, instruction) {
-    const parts = [kernel];
-    if (project !== undefined && project.trim() !== "") {
-        parts.push(`${PROJECT_PROMPT_TITLE}\n${project}`);
-    }
-    if (instruction !== undefined && instruction.trim() !== "") {
-        parts.push(`${INSTRUCTION_TITLE}\n${instruction}`);
-    }
-    return parts.join("\n\n");
-}
-/** 工具清单文本：name + description 一行（registry listTools 形态；空清单返回空串） */
-function buildToolListText(tools) {
-    if (tools.length === 0)
-        return "";
-    const lines = tools.map((t) => `- ${t.name}：${t.description}`);
-    return `${TOOL_LIST_TITLE}\n${lines.join("\n")}`;
-}
-/**
- * 聚焦文本按预算截断（显式告知，不静默丢数据）：
- * 按 chars/4 反推可保留字符数（预留截断提示空间），保留前缀 + 截断提示。
- */
-function trimFocus(focus, maxTokens) {
-    if (estimateTokens(focus) <= maxTokens) {
-        return { text: focus, truncated: false };
-    }
-    const maxChars = Math.max(0, Math.floor(maxTokens * 4));
-    const keptChars = Math.max(0, maxChars - FOCUS_TRUNCATION_NOTICE.length);
-    return { text: focus.slice(0, keptChars) + FOCUS_TRUNCATION_NOTICE, truncated: true };
-}
-/**
- * 历史按 token 预算成对裁剪：
- * 用 trimSession 以「配对块」为单位裁剪（同裁同留不拆对），二分找预算内尽量多保留的
- * 最大条数。裁剪后的估算**一律不带 usage 基线**——旧基线描述裁剪前前缀，沿用即预算漂移。
- * 返回 { messages, trimmed }：trimmed=true 表示至少裁掉一条消息。
- */
-function trimHistoryToBudget(history, maxTokens) {
-    if (estimateMessagesTokens(history) <= maxTokens) {
-        return { messages: history, trimmed: false };
-    }
-    // 二分最大可行条数 n：f(n) = estimate(trimSession(history, n))，f(0)=0 ≤ 预算。
-    // 单调性论证：n 增大时原放不下的块可能变得可放（swap）——新纳入块的条数严格大于
-    // 被其挤出的更早块（否则此前不会被拒），保留**条数**单调不减；条数分布均匀时
-    // f(n) 即近似单调不减，二分求最大可行 n 正确。
-    // 兜底：即使极端大小构造破坏 token 单调性，lo 不变式（f(lo) ≤ 预算恒成立）保证
-    // 二分终止时输出不超预算——最坏只是保留条数略少于最优，绝无超预算风险。
-    let lo = 0;
-    let hi = history.length;
-    while (lo < hi) {
-        const mid = Math.ceil((lo + hi) / 2);
-        if (estimateMessagesTokens(trimSession(history, mid)) <= maxTokens) {
-            lo = mid;
-        }
-        else {
-            hi = mid - 1;
-        }
-    }
-    return { messages: trimSession(history, lo), trimmed: lo < history.length };
-}
-// ============ 主组装 ============
-/**
- * 组装完整喂回上下文：
- * 1. 基础 system = 内核 + 项目提示词 + 临时指令 + 工具清单（超 system 预算仅记录不裁剪）
- * 2. 聚焦注入 = 独立 system 消息（有 focus 时；超预算截断并显式告知）
- * 3. 历史 = 超预算成对裁剪（同裁同留）+ 末条约束收尾（buildPayload——输出末条恒 user/tool）
- * 4. usage 基线：未触发裁剪时保留 lastUsage（真实用量优先）；一旦触发裁剪即重置为
- * null（旧 usage 描述裁剪前前缀，沿用会导致预算漂移）——meta.effectiveLastUsage 反映
- * 生效基线，S7.3 应回写该值作为下一轮输入
- */
-export function buildContext(input) {
-    const budgets = { ...DEFAULT_CONTEXT_BUDGETS, ...input.budgets };
-    const kernel = input.kernelPrompt ?? KERNEL_PROMPT;
-    const tools = input.tools ?? listTools();
-    // ---- 1. 基础 system 层（内核 + 项目 + 临时 + 工具清单） ----
-    const baseText = buildSystemBase(kernel, input.projectPrompt, input.instruction);
-    const toolListText = buildToolListText(tools);
-    const systemContent = toolListText === "" ? baseText : `${baseText}\n\n${toolListText}`;
-    const systemTokens = estimateTokens(baseText);
-    const toolListTokens = estimateTokens(toolListText);
-    const systemOverBudget = systemTokens > budgets.system;
-    // ---- 2. 聚焦层（独立 system 消息；超预算截断） ----
-    let focusMessage = null;
-    let focusTokens = 0;
-    let focusTruncated = false;
-    if (input.focus !== undefined && input.focus !== "") {
-        const trimmed = trimFocus(input.focus, budgets.focus);
-        focusTruncated = trimmed.truncated;
-        focusTokens = estimateTokens(`${FOCUS_TITLE}\n${trimmed.text}`);
-        focusMessage = { role: "system", content: `${FOCUS_TITLE}\n${trimmed.text}` };
-    }
-    // ---- 3. 历史层（超预算成对裁剪 + 末条约束收尾） ----
-    // 预算判定优先真实 usage 基线；一旦判定超限触发裁剪，基线即重置
-    const withBaseline = estimateMessagesTokens(input.history, {
-        lastUsage: input.lastUsage ?? null,
-    });
-    const lastUsageReset = withBaseline > budgets.history;
-    const trimmedHistory = lastUsageReset
-        ? trimHistoryToBudget(input.history, budgets.history)
-        : { messages: input.history, trimmed: false };
-    const historyPayload = buildPayload(trimmedHistory.messages);
-    const historyTokens = estimateMessagesTokens(historyPayload);
-    // ---- 4. 汇总 ----
-    const messages = [{ role: "system", content: systemContent }];
-    if (focusMessage !== null)
-        messages.push(focusMessage);
-    messages.push(...historyPayload);
-    return {
-        messages,
-        tokens: {
-            system: systemTokens,
-            toolList: toolListTokens,
-            focus: focusTokens,
-            history: historyTokens,
-            total: systemTokens + toolListTokens + focusTokens + historyTokens,
-        },
-        meta: {
-            systemOverBudget,
-            focusTruncated,
-            historyTrimmed: trimmedHistory.trimmed,
-            historyMessageCount: historyPayload.length,
-            lastUsageReset,
-            effectiveLastUsage: lastUsageReset ? null : (input.lastUsage ?? null),
-        },
-    };
-}
-//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/executor.d.ts

@@ -1,86 +0,0 @@
-import { type Proposal, type ToolContext } from "@whispering233/ai-editor-tools";
-import type { ToolDispatcher } from "./run.js";
-/** 提案 TTL（10 分钟；S7.5 confirm/reject 引用——超期按不存在处理） */
-export declare const PROPOSAL_TTL_MS: number;
-/**
- * 提案条数上限（超限淘汰 createdAt 最旧）。
- * 决策原文未定数——取 200 为数量级防御：正常会话一轮最多 15 个提案、挂卡不确认的
- * 残留按 TTL 自动过期，200 足以覆盖极端多轮场景且内存占用可忽略（防无限增长）。
- */
-export declare const PROPOSAL_MAX_COUNT = 200;
-/** 提案仓接口（S7.5 路由消费：confirm/reject 经 get/peek；S7.6 切换项目调 clear） */
-export interface ProposalStore {
-    /** 存入提案（TTL 从 createdAt 起算；先清过期、超限淘汰最旧） */
-    set(proposal: Proposal): void;
-    /**
-    * 按 id + 项目取：不存在 / 过期 / **跨项目** → null。
-    * 跨项目返回 null 即防御 PROPOSAL_PROJECT_MISMATCH 语义（
-    * 提案绑定 project_id，确认时校验与当前项目一致）。
-    */
-    get(proposalId: string, projectId: string): Proposal | null;
-    /**
-    * 仅按 id 取（不校验项目）：S7.5 区分「404 PROPOSAL_NOT_FOUND」与
-    * 「409 PROPOSAL_PROJECT_MISMATCH」用——get 返回 null 后 peek 仍可见 ⇒ 跨项目误操作。
-    * 过期条目同样视为不存在（惰性清理）。
-    */
-    peek(proposalId: string): Proposal | null;
-    /**
-    * 按 id 移除单条（S7.5 一次性消费：confirm/reject 终态后移除—— 瞬态交互对象，
-    * 确认/拒绝动作即消费，残留只会让重复 confirm 产生重复执行或反复 409）。
-    * 与 clear 的区别：clear 清空全部（S7.6 切换项目用），remove 只移除指定提案。
-    */
-    remove(proposalId: string): void;
-    /** 清空全部项目提案（create/open/close 切换项目时由 S7.6 调用） */
-    clear(): void;
-    /** 当前仓内提案数（测试/诊断） */
-    size(): number;
-}
-/** createProposalStore 选项（测试覆盖 TTL/上限用；缺省取导出的常量） */
-export interface ProposalStoreOptions {
-    /** TTL 覆盖 ms（缺省 PROPOSAL_TTL_MS） */
-    ttlMs?: number;
-    /** 条数上限覆盖（缺省 PROPOSAL_MAX_COUNT） */
-    maxCount?: number;
-}
-/**
- * 创建提案仓实例。
- * 过期策略：**惰性过期 + 按需清理**（「超期自动清除」落地）——get/peek 只清理命中的
- * 单条，set 前扫全仓清理；无定时器（定时器引入时钟耦合且小仓无必要，测试用假时钟直接断言）。
- * 淘汰策略：条数超限时淘汰 createdAt **最旧**的提案（sweep 过期后仍满则循环淘汰最旧）。
- */
-export declare function createProposalStore(options?: ProposalStoreOptions): ProposalStore;
-/** 默认提案仓单例（S7.5 confirm/reject 与 S7.6 切换项目 clear 直接引用；测试用 createProposalStore 独立实例） */
-export declare const defaultProposalStore: ProposalStore;
-/**
- * 提案 build 层入口签名（args 已过 argsSchema 校验——执行前 safeParse 的 parsed.data）。
- * run 层裁剪只返回 { proposal_id, summary }（「提案类」2026-08 修订），
- * 完整 Proposal 对象须经 build 层重建（与 run 内部产出同源确定：同 ctx + 同 args 结果一致）。
- */
-type ProposalBuilder = (ctx: ToolContext, args: unknown) => Proposal;
-/**
- * 15 个 propose_* 工具名 → build 层函数。
- * 运行时查表缺失（非 propose 工具）走普通结果路径；完整性由测试断言覆盖
- * （Object.keys(PROPOSAL_BUILDERS) === PROPOSAL_TOOLS）——S6.6 后续新增提案工具须同步登记。
- * 导出仅为完整性测试断言；业务侧经 createToolDispatcher 间接使用。
- */
-export declare const PROPOSAL_BUILDERS: Record<string, ProposalBuilder>;
-/** createToolDispatcher 选项 */
-export interface CreateToolDispatcherOptions {
-    /** 提案仓（缺省 defaultProposalStore 单例——S7.5 confirm/reject 与调度同仓消费） */
-    store?: ProposalStore;
-}
-/**
- * 创建工具调度器（run.ts ToolDispatcher 真实现）：
- * 1. **批量校验 fail fast**（「工具执行」）：先全部 getTool(name).argsSchema
- * safeParse——工具不存在 / 参数非法 → 该调用合成 isError 结果（**不中断其他调用**，
- * 「fail fast」指校验先于执行，错误编码进 isError 喂回 LLM 自纠）；全部校验完再逐个执行
- * 2. **执行中检查 signal**：调度前 + 每个工具执行前 throwIfAborted，run 调用
- * 透传 signal（长分析工具内部周期检查）；命中取消抛 AbortedError **按取消语义传播**
- * （原样抛穿，run.ts 识别后按用户取消终止——不喂回、不视为工具失败）
- * 3. 工具执行抛错（非 AbortedError）→ 统一 isError 结构化（工具名+参数+错误信息）
- * 4. propose_* 执行成功 → build 层重建完整 Proposal 入仓 + 构造 preview（S7.6 推 GUI）→
- * DispatchResult.proposal 透传 run.ts（proposal 事件在 tool_result 后、循环继续前——run.ts 保证）
- */
-export declare function createToolDispatcher(ctx: ToolContext, options?: CreateToolDispatcherOptions): ToolDispatcher;
-export {};
-//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAwBA,OAAO,EAoBL,KAAK,QAAQ,EACb,KAAK,WAAW,EAEjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAoC,cAAc,EAAE,MAAM,UAAU,CAAC;AAIjF,qDAAqD;AACrD,eAAO,MAAM,eAAe,QAAc,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC7B,2CAA2C;IAC1C,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC/B;;;;MAIE;IACD,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC7D;;;;MAIE;IACD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC3C;;;;MAIE;IACD,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iDAAiD;IAChD,KAAK,IAAI,IAAI,CAAC;IACf,qBAAqB;IACpB,IAAI,IAAI,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACpC,oCAAoC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CA+DrF;AAED,uFAAuF;AACvF,eAAO,MAAM,oBAAoB,EAAE,aAAqC,CAAC;AAIzE;;;;GAIG;AACH,KAAK,eAAe,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,KAAK,QAAQ,CAAC;AAErE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAiB7D,CAAC;AAEF,8BAA8B;AAC9B,MAAM,WAAW,2BAA2B;IAC3C,mEAAmE;IAClE,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,GAAE,2BAAgC,GAAG,cAAc,CAwGhH"}