@whispering233/ai-editor-agent 0.0.30 → 0.0.33

package/dist/index.d.ts

@@ -1,9 +1,6 @@
 export declare const AGENT_PKG_NAME = "@whispering233/ai-editor-agent";
 export declare const AGENT_PKG_VERSION = "0.1.0";
 export declare const TOOLS_DEP = "@whispering233/ai-editor-tools";
-export * from "./session.js";
-export * from "./prompts.js";
-export * from "./context.js";
-export * from "./run.js";
-export * from "./executor.js";
+export { AGENTS_FILE_NAME, createCustomTools, createPingFrame, createProposalSink, createProposalStore, createProjectRuntime, createSessionFrame, defaultProposalStore, buildResourceLoaderOptions, estimateTokens, extractText, FOCUS_TITLE, findProjectSession, getThinkingPreview, KERNEL_PROMPT, lastVisibleSessionText, listProjectSessions, NoModelConfiguredError, openProjectSessionManager, projectAgentsFilePath, projectMessageForWire, projectSessionMessages, projectSessionsDir, PROPOSAL_BUILDERS, PROPOSAL_MAX_COUNT, PROPOSAL_TTL_MS, readProjectAgentsFile, readProjectSession, readSessionThinking, resolveAgentDir, resolveDefaultModel, SESSIONS_DIR_NAME, stringifyToolResult, THINKING_PREVIEW_MAX_CHARS, toProposalPayload, toSseFrame, TOOL_RESULT_MAX_TOKENS, truncateToolResultText, } from "./runtime/index.js";
+export type { CreateCustomToolsOptions, CreateProposalSinkOptions, ProjectRuntime, ProjectRuntimeInput, Proposal, ProposalStore, ProposalStoreOptions, ProposalPayload, ProposalSink, ProposalSinkInput, ResourceLoaderOptions, SessionEntry, SessionInfo, SseFrame, SseProjectionOptions, ThinkingLevel, ThinkingPreviewProjection, WireMessage, WireSessionMessage, WireToolCall, } from "./runtime/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,cAAc,mCAAmC,CAAC;AAC/D,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,SAAS,mCAAiB,CAAC;AAExC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,cAAc,mCAAmC,CAAC;AAC/D,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,SAAS,mCAAiB,CAAC;AAExC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,cAAc,EACd,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,iBAAiB,EACjB,UAAU,EACV,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,wBAAwB,EACxB,yBAAyB,EACzB,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,oBAAoB,EACpB,aAAa,EACb,yBAAyB,EACzB,WAAW,EACX,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,15 +1,11 @@
 // @whispering233/ai-editor-agent 入口
-// S7.1 会话管理（session.ts）：历史重建 / 成对裁剪 / 喂回格式 / 末条约束——纯内存、无 I/O
-// S7.2 上下文组装（context.ts + prompts.ts）：三层提示词注入 / 聚焦注入 / 工具清单 / 分层 token 预算
-// S7.3 主循环（run.ts）：runAgent 三重保险 / 工具调度接口 ToolDispatcher / AgentEvent 事件流
-// S7.4 工具调度（executor.ts）：ToolDispatcher 真实现 / 提案内存仓（TTL + 上限 + 项目绑定）
+//
+// 本包 = pi 运行时装配层：模型/凭据/会话/循环都由 pi 承担（见 docs/design/architecture.md「AI 运行时」），
+// 本包只负责装配（ModelRuntime + SessionManager + AgentSession）、内核提示词、领域工具适配、
+// 事件投影（→ SSE 帧）与提案仓。
 import { TOOLS_PKG_NAME } from "@whispering233/ai-editor-tools";
 export const AGENT_PKG_NAME = "@whispering233/ai-editor-agent";
 export const AGENT_PKG_VERSION = "0.1.0";
 export const TOOLS_DEP = TOOLS_PKG_NAME;
-export * from "./session.js";
-export * from "./prompts.js";
-export * from "./context.js";
-export * from "./run.js";
-export * from "./executor.js";
+export { AGENTS_FILE_NAME, createCustomTools, createPingFrame, createProposalSink, createProposalStore, createProjectRuntime, createSessionFrame, defaultProposalStore, buildResourceLoaderOptions, estimateTokens, extractText, FOCUS_TITLE, findProjectSession, getThinkingPreview, KERNEL_PROMPT, lastVisibleSessionText, listProjectSessions, NoModelConfiguredError, openProjectSessionManager, projectAgentsFilePath, projectMessageForWire, projectSessionMessages, projectSessionsDir, PROPOSAL_BUILDERS, PROPOSAL_MAX_COUNT, PROPOSAL_TTL_MS, readProjectAgentsFile, readProjectSession, readSessionThinking, resolveAgentDir, resolveDefaultModel, SESSIONS_DIR_NAME, stringifyToolResult, THINKING_PREVIEW_MAX_CHARS, toProposalPayload, toSseFrame, TOOL_RESULT_MAX_TOKENS, truncateToolResultText, } from "./runtime/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,6DAA6D;AAC7D,0EAA0E;AAC1E,0EAA0E;AAC1E,qEAAqE;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,MAAM,CAAC,MAAM,cAAc,GAAG,gCAAgC,CAAC;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,cAAc,CAAC;AAExC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,6EAA6E;AAC7E,sEAAsE;AACtE,qBAAqB;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,MAAM,CAAC,MAAM,cAAc,GAAG,gCAAgC,CAAC;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,cAAc,CAAC;AAExC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,cAAc,EACd,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,iBAAiB,EACjB,UAAU,EACV,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/runtime/events.d.ts

@@ -0,0 +1,21 @@
+import type { AgentSessionEvent, ContextUsage } from "@earendil-works/pi-coding-agent";
+/** 一帧 SSE（`event: <event>` + `data: <json>`） */
+export interface SseFrame {
+    event: string;
+    data: Record<string, unknown>;
+}
+/** 投影选项（每轮取值都是「当前时刻」的函数，不做快照缓存） */
+export interface SseProjectionOptions {
+    /** 占用条口径：由 `AgentSession.getContextUsage()` 提供（turn_end / agent_end 帧附带） */
+    getContextUsage?: () => ContextUsage | undefined;
+}
+/** 服务端合成的会话帧（流的首帧：客户端据此持久化「当前会话」） */
+export declare function createSessionFrame(sessionId: string): SseFrame;
+/** 心跳帧（探活 + 断开检测；载荷恒为空） */
+export declare function createPingFrame(): SseFrame;
+/**
+ * 单个 pi 会话事件 → SSE 帧；不投影的事件返回 null（调用方跳过）。
+ * 纯函数：同样的输入 + 同样的 options 取值 ⇒ 同样的帧（便于单测逐事件断言）。
+ */
+export declare function toSseFrame(event: AgentSessionEvent, options?: SseProjectionOptions): SseFrame | null;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/runtime/events.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIvF,gDAAgD;AAChD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,mCAAmC;AACnC,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,YAAY,GAAG,SAAS,CAAC;CAClD;AAqBD,qCAAqC;AACrC,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAE9D;AAED,2BAA2B;AAC3B,wBAAgB,eAAe,IAAI,QAAQ,CAE1C;AAsED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,GAAE,oBAAyB,GAAG,QAAQ,GAAG,IAAI,CAmIxG"}

package/dist/runtime/events.js

@@ -0,0 +1,235 @@
+// pi 运行时：会话事件 → SSE 帧投影
+//
+// 契约 = docs/api/80-api-chat.md「SSE 事件集 + 过滤约定」：本模块是该契约的**唯一实现点**。
+// 三件必须做的事（每件都有「不做就会出事」的理由）：
+// 1. **剥离 `partial`/完整消息大对象**：pi 的增量事件都挂一份完整消息快照，原样转发单帧可达数百 KB。
+// 2. **thinking 降预览**：全文走按需端点，帧里只给预览 + 定位参数（流式期间已由 thinking_delta 下发增量）。
+// 3. **AUTO 工具的 `details` 不下发**：与 `content` 重复且可能极大；只有 PROPOSAL 工具的
+//    details（提案载荷）是 UI 的真实消费面。
+//
+// 丢弃 pi 的内部状态事件（entry_appended / queue_update / session_info_changed /
+// thinking_level_changed / agent_settled / summarization_retry_* / bash_execution_update）：
+// 事件表没有登记 = UI 没有消费方，转发只会变成无人接的噪声。
+import { PROPOSAL_TOOLS } from "@whispering233/ai-editor-shared";
+import { getThinkingPreview, projectMessageForWire } from "./message-projection.js";
+/** 提案工具名集合（details 门控依据；shared 常量是工具名的唯一事实来源） */
+const PROPOSAL_TOOL_NAME_SET = new Set(PROPOSAL_TOOLS);
+/** 丢弃的事件类型（未登记进事件表的内部状态） */
+const DROPPED_EVENT_TYPES = new Set([
+    "entry_appended",
+    "queue_update",
+    "session_info_changed",
+    "thinking_level_changed",
+    "agent_settled",
+    "summarization_retry_scheduled",
+    "summarization_retry_attempt_start",
+    "summarization_retry_finished",
+    "bash_execution_update",
+]);
+/** 服务端合成的会话帧（流的首帧：客户端据此持久化「当前会话」） */
+export function createSessionFrame(sessionId) {
+    return { event: "session", data: { session_id: sessionId } };
+}
+/** 心跳帧（探活 + 断开检测；载荷恒为空） */
+export function createPingFrame() {
+    return { event: "ping", data: {} };
+}
+/** 占用条字段（无 getContextUsage 或返回 undefined 时不带该键） */
+function contextUsageField(options) {
+    const usage = options.getContextUsage?.();
+    if (usage === undefined)
+        return {};
+    return {
+        contextUsage: { percent: usage.percent, tokens: usage.tokens, contextWindow: usage.contextWindow },
+    };
+}
+/** 从 partial 快照里取工具调用的 id/name（toolcall_start/delta 事件不带这两个字段） */
+function toolCallMetadata(event) {
+    const assistantEvent = event.assistantMessageEvent;
+    if (assistantEvent.type !== "toolcall_start" && assistantEvent.type !== "toolcall_delta")
+        return null;
+    const content = assistantEvent.partial?.content;
+    const contentIndex = assistantEvent.contentIndex;
+    if (!Array.isArray(content) || typeof contentIndex !== "number")
+        return null;
+    const block = content[contentIndex];
+    if (block === undefined || block.type !== "toolCall")
+        return null;
+    const id = typeof block.id === "string" ? block.id : null;
+    const toolName = typeof block.name === "string" ? block.name : null;
+    return id !== null && toolName !== null ? { id, toolName } : null;
+}
+/**
+ * assistant 增量事件投影：剥离 `partial`（完整消息快照）。
+ * `done` / `error` 两种收尾事件还挂着完整消息（`message` / `error`），同样只留 `reason`——
+ * 消息终态由随后的 `message_end` 帧负责。
+ */
+function projectAssistantMessageEvent(event) {
+    if (event.type === "done")
+        return { type: "done", reason: event.reason };
+    if (event.type === "error")
+        return { type: "error", reason: event.reason };
+    const { partial: _partial, ...rest } = event;
+    void _partial;
+    // thinking_end 的 content 是整段思维链（可达数十 KB）：客户端已通过 thinking_delta 拿到增量、
+    // 终态由 message_end 的预览负责（全文走按需端点）——这里降为预览，避免单帧数百 KB。
+    if (event.type === "thinking_end" && typeof rest.content === "string") {
+        return { ...rest, content: getThinkingPreview(rest.content), contentLength: rest.content.length };
+    }
+    const metadata = toolCallMetadata({ assistantMessageEvent: event });
+    return metadata === null ? rest : { ...rest, ...metadata };
+}
+/** 末条 assistant 消息的失败信息（agent_end 帧用：错误/中止时带 stopReason） */
+function lastAssistantFailure(messages) {
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (message === undefined || message.role !== "assistant")
+            continue;
+        const stopReason = typeof message.stopReason === "string" ? message.stopReason : undefined;
+        if (stopReason !== "error" && stopReason !== "aborted")
+            return {};
+        return {
+            stopReason,
+            ...(typeof message.errorMessage === "string" ? { errorMessage: message.errorMessage } : {}),
+        };
+    }
+    return {};
+}
+/** 消息帧的 `{ message }` 载荷（未知角色 → null，调用方丢弃该帧） */
+function messageField(message) {
+    const projected = projectMessageForWire(message);
+    return projected === null ? null : { message: projected };
+}
+/**
+ * 单个 pi 会话事件 → SSE 帧；不投影的事件返回 null（调用方跳过）。
+ * 纯函数：同样的输入 + 同样的 options 取值 ⇒ 同样的帧（便于单测逐事件断言）。
+ */
+export function toSseFrame(event, options = {}) {
+    const type = event.type;
+    if (DROPPED_EVENT_TYPES.has(type))
+        return null;
+    switch (type) {
+        case "agent_start":
+        case "turn_start":
+            return { event: type, data: {} };
+        case "message_start":
+        case "message_end": {
+            const data = messageField(event.message);
+            return data === null ? null : { event: type, data };
+        }
+        case "message_update": {
+            const update = event;
+            // 只投影 assistant 的增量：pi 的 message_update 仅对 assistant 消息触发（文档事件表同款），
+            // 其他角色出现即视为未知事件，丢弃而不是转发一个前端无法归属的 delta。
+            const role = update.message?.role;
+            if (role !== "assistant")
+                return null;
+            // **不带 `message`**：pi 的增量事件里挂着完整消息快照，一旦转发就等于把「partial 剥离」
+            // 白做（正文会随每个 chunk 重复下发）；消息终态由 message_end 帧负责。
+            return {
+                event: "message_update",
+                data: { assistantMessageEvent: projectAssistantMessageEvent(update.assistantMessageEvent) },
+            };
+        }
+        case "tool_execution_start":
+        case "tool_execution_update": {
+            const execution = event;
+            return {
+                event: type,
+                data: {
+                    toolCallId: execution.toolCallId,
+                    toolName: execution.toolName,
+                    ...(type === "tool_execution_start"
+                        ? { args: execution.args }
+                        : { partialResult: execution.partialResult }),
+                },
+            };
+        }
+        case "tool_execution_end": {
+            const execution = event;
+            return {
+                event: "tool_execution_end",
+                data: {
+                    toolCallId: execution.toolCallId,
+                    toolName: execution.toolName,
+                    result: projectToolResult(execution.toolName, execution.result),
+                    isError: execution.isError,
+                },
+            };
+        }
+        case "turn_end": {
+            const turn = event;
+            return {
+                event: "turn_end",
+                data: {
+                    toolResults: turn.toolResults
+                        .map((result) => projectMessageForWire(result))
+                        .filter((result) => result !== null),
+                    ...contextUsageField(options),
+                },
+            };
+        }
+        case "compaction_start": {
+            const compaction = event;
+            return { event: "compaction_start", data: { reason: compaction.reason } };
+        }
+        case "compaction_end": {
+            const compaction = event;
+            return {
+                event: "compaction_end",
+                data: {
+                    reason: compaction.reason,
+                    ...(compaction.result === undefined ? {} : { result: compaction.result }),
+                    aborted: compaction.aborted,
+                    willRetry: compaction.willRetry,
+                    ...(compaction.errorMessage === undefined ? {} : { errorMessage: compaction.errorMessage }),
+                },
+            };
+        }
+        case "auto_retry_start": {
+            const retry = event;
+            return {
+                event: "auto_retry_start",
+                data: {
+                    attempt: retry.attempt,
+                    maxAttempts: retry.maxAttempts,
+                    delayMs: retry.delayMs,
+                    errorMessage: retry.errorMessage,
+                },
+            };
+        }
+        case "auto_retry_end": {
+            const retry = event;
+            return {
+                event: "auto_retry_end",
+                data: {
+                    success: retry.success,
+                    attempt: retry.attempt,
+                    ...(retry.finalError === undefined ? {} : { finalError: retry.finalError }),
+                },
+            };
+        }
+        case "agent_end": {
+            const end = event;
+            return {
+                event: "agent_end",
+                data: { ...lastAssistantFailure(end.messages), ...contextUsageField(options) },
+            };
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * 工具结果 projection：
+ * - AUTO 工具：只给 `content`（details 与 content 重复，且可能是整棵大纲/全图）
+ * - PROPOSAL 工具：附带 `details`（提案载荷 `{ proposal_id, type, preview }`，前端提案卡的唯一数据面）
+ */
+function projectToolResult(toolName, result) {
+    const record = (typeof result === "object" && result !== null ? result : {});
+    const content = record.content ?? [];
+    if (!PROPOSAL_TOOL_NAME_SET.has(toolName))
+        return { content };
+    return record.details === undefined ? { content } : { content, details: record.details };
+}
+//# sourceMappingURL=events.js.map

package/dist/runtime/events.js.map

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

package/dist/runtime/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./paths.js";
+export * from "./resources.js";
+export * from "./sessions.js";
+export * from "./system-prompt.js";
+export * from "./tool-result.js";
+export * from "./tools.js";
+export * from "./message-projection.js";
+export * from "./events.js";
+export * from "./proposals.js";
+export * from "./project-runtime.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,12 @@
+// pi 运行时入口：装配 + 资源收窄 + 工具适配 + 事件投影 + 提案仓
+export * from "./paths.js";
+export * from "./resources.js";
+export * from "./sessions.js";
+export * from "./system-prompt.js";
+export * from "./tool-result.js";
+export * from "./tools.js";
+export * from "./message-projection.js";
+export * from "./events.js";
+export * from "./proposals.js";
+export * from "./project-runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAEzC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

package/dist/runtime/message-projection.d.ts

@@ -0,0 +1,57 @@
+import type { AssistantMessage, TextContent, ThinkingContent, ToolResultMessage, UserMessage } from "@earendil-works/pi-ai";
+/** 思维链预览长度（与 pi-web 同口径：240 字符） */
+export declare const THINKING_PREVIEW_MAX_CHARS = 240;
+/** 思维链投影（列表/帧里只给预览；`deferred: true` 表示全文需按需拉取） */
+export interface ThinkingPreviewProjection {
+    /** 前 240 字符预览（首行截取后 trimEnd） */
+    preview: string;
+    deferred: true;
+    /** 原消息 content 数组中的块下标（取全文时的定位参数） */
+    blockIndex: number;
+    /** 原文字符数（前端展示「已折叠 N 字」） */
+    length: number;
+}
+/** 工具调用投影（assistant 消息内） */
+export interface WireToolCall {
+    id: string;
+    name: string;
+    arguments: unknown;
+}
+/** 线协议消息投影（SSE 帧与历史接口共用；`id` 由历史层按 entry 补，不在此层） */
+export interface WireMessage {
+    role: "user" | "assistant" | "tool";
+    /** 可见文本（assistant = text 块拼接；thinking 不在此字段） */
+    content: string;
+    /** assistant 消息的思维链投影（仅非空块） */
+    thinking?: ThinkingPreviewProjection[];
+    /** assistant 消息的工具调用 */
+    toolCalls?: WireToolCall[];
+    /** tool 消息关联的调用 id */
+    toolCallId?: string;
+    /** tool 消息是否失败 */
+    isError?: boolean;
+    /** ISO 8601（pi 消息的毫秒时间戳） */
+    createdAt: string;
+}
+/** 思维链预览：截首行 + 截断到 240 字符（同行首 240 字符，超长行同样截断） */
+export declare function getThinkingPreview(thinking: string): string;
+/** 单块 thinking → 预览投影 */
+export declare function projectThinkingBlock(block: ThinkingContent, blockIndex: number): ThinkingPreviewProjection;
+/** 文本提取：string 原样；块数组只取 text 块（图片等非文本内容不进 content） */
+export declare function extractText(content: string | readonly (TextContent | {
+    type: string;
+    text?: string;
+})[]): string;
+/** user 消息投影 */
+export declare function projectUserMessage(message: UserMessage): WireMessage;
+/** assistant 消息投影（thinking 降预览、toolCall 拆到 toolCalls） */
+export declare function projectAssistantMessage(message: AssistantMessage): WireMessage;
+/** tool 消息投影 */
+export declare function projectToolResultMessage(message: ToolResultMessage): WireMessage;
+/**
+ * 任意 pi 消息 → 线协议投影；未知角色返回 null（调用方据此丢弃该帧）。
+ * 判定按 role 分支（不用 instanceof——消息可能来自反序列化的会话文件，原型链不可靠）。
+ */
+export declare function projectMessageForWire(message: unknown): WireMessage | null;
+/** tool 块的类型引用（toolCalls 投影用；导出供调用方类型标注） */
+//# sourceMappingURL=message-projection.d.ts.map

package/dist/runtime/message-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-projection.d.ts","sourceRoot":"","sources":["../../src/runtime/message-projection.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAE/B,mCAAmC;AACnC,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,IAAI,CAAC;IACf,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACpC,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACvC,wBAAwB;IACxB,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,sBAAsB;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,yBAAyB;AACzB,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,yBAAyB,CAO1G;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,GAAG,MAAM,CAMhH;AAOD,gBAAgB;AAChB,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAEpE;AAED,yDAAyD;AACzD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAqB9E;AAED,gBAAgB;AAChB,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,CAQhF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAO1E;AAED,4CAA4C"}

package/dist/runtime/message-projection.js

@@ -0,0 +1,94 @@
+// pi 运行时：消息 → 线协议投影（SSE 帧与历史回看共用同一份投影）
+//
+// 为什么单独一层：
+// 1. thinking 全文可能极长，而流式期间已由 `thinking_delta` 下发过——帧/历史里只给
+//    「预览 + 可拉取标记」，全文走按需端点（契约见 docs/api/80-api-chat.md）。
+// 2. 抹平 pi 的原始消息形态（content blocks / toolResult / usage / api 元数据），
+//    让 client 只面对文档登记过的字段（role/content/thinking/toolCalls/toolCallId/isError/createdAt）。
+//
+// 未知角色（pi 的 custom / bashExecution / branchSummary / compactionSummary 等）返回 null：
+// 文档的事件表只登记 user / assistant / tool 三类，多出来的角色没有消费方。
+/** 思维链预览长度（与 pi-web 同口径：240 字符） */
+export const THINKING_PREVIEW_MAX_CHARS = 240;
+/** 思维链预览：截首行 + 截断到 240 字符（同行首 240 字符，超长行同样截断） */
+export function getThinkingPreview(thinking) {
+    return thinking.trimStart().match(/^[^\r\n]{0,240}/u)?.[0].trimEnd() ?? "";
+}
+/** 单块 thinking → 预览投影 */
+export function projectThinkingBlock(block, blockIndex) {
+    return {
+        preview: getThinkingPreview(block.thinking),
+        deferred: true,
+        blockIndex,
+        length: block.thinking.length,
+    };
+}
+/** 文本提取：string 原样；块数组只取 text 块（图片等非文本内容不进 content） */
+export function extractText(content) {
+    if (typeof content === "string")
+        return content;
+    return content
+        .filter((block) => block.type === "text" && typeof block.text === "string")
+        .map((block) => block.text)
+        .join("");
+}
+/** 毫秒时间戳 → ISO 8601（缺省防御：无 timestamp 用当前时刻） */
+function toIso(timestamp) {
+    return new Date(typeof timestamp === "number" ? timestamp : Date.now()).toISOString();
+}
+/** user 消息投影 */
+export function projectUserMessage(message) {
+    return { role: "user", content: extractText(message.content), createdAt: toIso(message.timestamp) };
+}
+/** assistant 消息投影（thinking 降预览、toolCall 拆到 toolCalls） */
+export function projectAssistantMessage(message) {
+    const thinking = [];
+    const toolCalls = [];
+    message.content.forEach((block, index) => {
+        if (block.type === "thinking") {
+            // 空思维链（含被安全过滤的 redacted 块）不投影：预览为空串没有信息量，且 length 会误导
+            if (block.thinking.trim() === "")
+                return;
+            thinking.push(projectThinkingBlock(block, index));
+            return;
+        }
+        if (block.type === "toolCall") {
+            toolCalls.push({ id: block.id, name: block.name, arguments: block.arguments });
+        }
+    });
+    return {
+        role: "assistant",
+        content: extractText(message.content),
+        ...(thinking.length === 0 ? {} : { thinking }),
+        ...(toolCalls.length === 0 ? {} : { toolCalls }),
+        createdAt: toIso(message.timestamp),
+    };
+}
+/** tool 消息投影 */
+export function projectToolResultMessage(message) {
+    return {
+        role: "tool",
+        content: extractText(message.content),
+        toolCallId: message.toolCallId,
+        isError: message.isError,
+        createdAt: toIso(message.timestamp),
+    };
+}
+/**
+ * 任意 pi 消息 → 线协议投影；未知角色返回 null（调用方据此丢弃该帧）。
+ * 判定按 role 分支（不用 instanceof——消息可能来自反序列化的会话文件，原型链不可靠）。
+ */
+export function projectMessageForWire(message) {
+    if (typeof message !== "object" || message === null)
+        return null;
+    const role = message.role;
+    if (role === "user")
+        return projectUserMessage(message);
+    if (role === "assistant")
+        return projectAssistantMessage(message);
+    if (role === "toolResult")
+        return projectToolResultMessage(message);
+    return null;
+}
+/** tool 块的类型引用（toolCalls 投影用；导出供调用方类型标注） */
+//# sourceMappingURL=message-projection.js.map

package/dist/runtime/message-projection.js.map

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

package/dist/runtime/paths.d.ts

@@ -0,0 +1,11 @@
+/** 项目内会话目录名（与备份管道登记的随包目录同名） */
+export declare const SESSIONS_DIR_NAME = "sessions";
+/** 项目规则文件名（唯一持久化上下文通道；读取只认项目根这一个文件） */
+export declare const AGENTS_FILE_NAME = "AGENTS.md";
+/** pi agent dir（`~/.pi/agent`；调用方可覆盖——测试隔离依赖） */
+export declare function resolveAgentDir(override?: string): string;
+/** 项目内会话目录绝对路径（`<项目根>/sessions`） */
+export declare function projectSessionsDir(projectRoot: string): string;
+/** 项目根 AGENTS.md 绝对路径 */
+export declare function projectAgentsFilePath(projectRoot: string): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/runtime/paths.ts"],"names":[],"mappings":"AAQA,+BAA+B;AAC/B,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAE5C,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,oCAAoC;AACpC,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,yBAAyB;AACzB,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/runtime/paths.js

@@ -0,0 +1,23 @@
+// pi 运行时：路径解析（项目目录 vs pi agent dir）
+//
+// 会话文件落**项目目录**（随书移动/备份天然携带），模型/凭据/参数落 pi agent dir。
+// 两个位置都由本模块给出，避免调用方自行拼接路径（路径只出一处）。
+import { join, resolve } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+/** 项目内会话目录名（与备份管道登记的随包目录同名） */
+export const SESSIONS_DIR_NAME = "sessions";
+/** 项目规则文件名（唯一持久化上下文通道；读取只认项目根这一个文件） */
+export const AGENTS_FILE_NAME = "AGENTS.md";
+/** pi agent dir（`~/.pi/agent`；调用方可覆盖——测试隔离依赖） */
+export function resolveAgentDir(override) {
+    return override === undefined ? getAgentDir() : resolve(override);
+}
+/** 项目内会话目录绝对路径（`<项目根>/sessions`） */
+export function projectSessionsDir(projectRoot) {
+    return join(resolve(projectRoot), SESSIONS_DIR_NAME);
+}
+/** 项目根 AGENTS.md 绝对路径 */
+export function projectAgentsFilePath(projectRoot) {
+    return join(resolve(projectRoot), AGENTS_FILE_NAME);
+}
+//# sourceMappingURL=paths.js.map

package/dist/runtime/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/runtime/paths.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,qDAAqD;AACrD,mCAAmC;AAEnC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,+BAA+B;AAC/B,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE5C,uCAAuC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAE5C,iDAAiD;AACjD,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC,CAAC;AACvD,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,CAAC;AACtD,CAAC"}

package/dist/runtime/project-runtime.d.ts

@@ -0,0 +1,57 @@
+import type { Api, Model } from "@earendil-works/pi-ai";
+import { AgentSession, ModelRuntime, SessionManager, SettingsManager, type AgentSessionServices } from "@earendil-works/pi-coding-agent";
+import type { ToolContext } from "@whispering233/ai-editor-tools";
+import { type ProposalStore } from "./proposals.js";
+import { type ProposalSink } from "./tools.js";
+/** 思考强度（取自 AgentSession 的公开签名，避免直接依赖 pi-agent-core 类型） */
+export type ThinkingLevel = Parameters<AgentSession["setThinkingLevel"]>[0];
+/** 未配置任何可用模型/凭据（装配期失败；调用方决定如何呈现） */
+export declare class NoModelConfiguredError extends Error {
+    constructor(message: string);
+}
+export interface ProjectRuntimeInput {
+    /** 项目根目录（AGENTS.md 与 sessions/ 都在这里） */
+    projectRoot: string;
+    /** 工具执行上下文（db / outlineDir / projectId） */
+    toolContext: ToolContext;
+    /** pi agent dir 覆盖（缺省 `~/.pi/agent`；测试隔离用） */
+    agentDir?: string;
+    /** 注入既有 ModelRuntime（测试/复用）；缺省由 SDK 按 agentDir 自建 */
+    modelRuntime?: ModelRuntime;
+    /** 注入既有 SettingsManager；缺省按「项目配置不参与」自建 */
+    settingsManager?: SettingsManager;
+    /** 注入既有 SessionManager；缺省按项目 sessions/ 目录自建 */
+    sessionManager?: SessionManager;
+    /** 显式激活模型；缺省按 pi settings 的 defaultModel / 首个可用模型解析 */
+    model?: Model<Api>;
+    /** 初始思考强度；缺省按 pi settings 与模型能力解析 */
+    thinkingLevel?: ThinkingLevel;
+    /** 提案仓（缺省 defaultProposalStore 单例——与 confirm/reject 路由同仓消费） */
+    proposalStore?: ProposalStore;
+    /** 覆写提案登记回调（缺省 = createProposalSink(proposalStore)；测试/特殊装配用） */
+    proposalSink?: ProposalSink;
+}
+/** 一个项目的 pi 运行时（会话 + 支撑服务） */
+export interface ProjectRuntime {
+    /** 会话（prompt/abort/subscribe/dispose 见 pi AgentSession） */
+    session: AgentSession;
+    /** cwd 绑定的支撑服务（模型运行时 / 设置 / 资源加载器） */
+    services: AgentSessionServices;
+    sessionManager: SessionManager;
+    settingsManager: SettingsManager;
+    modelRuntime: ModelRuntime;
+    /** 释放会话订阅（项目关闭/切换时调用） */
+    dispose(): void;
+}
+/**
+ * 缺省模型解析：pi settings 的 defaultProvider+defaultModel → 首个可用模型（已配凭据者）→ 抛错。
+ * 不在本函数兜底到任何硬编码模型——「用哪个模型」归用户配置。
+ * 导出供 K5（settings 端点）复用与单测注入（stub runtime）。
+ */
+export declare function resolveDefaultModel(runtime: ModelRuntime, settings: SettingsManager): Promise<Model<Api>>;
+/**
+ * 装配一个项目的运行时。
+ * 会话文件落 `<项目根>/sessions`（不是 pi 默认的 agent dir 布局）。
+ */
+export declare function createProjectRuntime(input: ProjectRuntimeInput): Promise<ProjectRuntime>;
+//# sourceMappingURL=project-runtime.d.ts.map