@whispering233/ai-editor-agent 0.0.30 → 0.0.32

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/project-runtime.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,YAAY,EAGZ,YAAY,EACZ,cAAc,EACd,eAAe,EACf,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,EAA4C,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE9F,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAElE,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5E,oCAAoC;AACpC,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,WAAW,EAAE,WAAW,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,0CAA0C;IAC1C,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,+CAA+C;IAC/C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,uDAAuD;IACvD,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,qCAAqC;IACrC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,+DAA+D;IAC/D,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gEAAgE;IAChE,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,OAAO,EAAE,YAAY,CAAC;IACtB,sCAAsC;IACtC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,EAAE,YAAY,CAAC;IAC3B,yBAAyB;IACzB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAa/G;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyC9F"}

package/dist/runtime/project-runtime.js

@@ -0,0 +1,78 @@
+// pi 运行时：一个项目的会话运行时装配
+//
+// 装配顺序（每步的「为什么」见 docs/design/architecture.md「AI 运行时」）：
+//   项目根 + agent dir → SessionManager（项目 sessions/）→ SettingsManager（项目配置不参与）
+//   → createAgentSessionServices（ModelRuntime + 资源加载）→ 解析模型 → AgentSession（builtin 工具关闭 + 领域工具）
+//
+// 一个项目一个运行时实例：server 层在打开/切换项目时创建与释放（单项目单在途流）。
+import { resolve } from "node:path";
+import { createAgentSessionFromServices, createAgentSessionServices, SessionManager, SettingsManager, } from "@earendil-works/pi-coding-agent";
+import { projectSessionsDir, resolveAgentDir } from "./paths.js";
+import { createProposalSink, defaultProposalStore } from "./proposals.js";
+import { buildResourceLoaderOptions } from "./resources.js";
+import { createCustomTools } from "./tools.js";
+/** 未配置任何可用模型/凭据（装配期失败；调用方决定如何呈现） */
+export class NoModelConfiguredError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "NoModelConfiguredError";
+    }
+}
+/**
+ * 缺省模型解析：pi settings 的 defaultProvider+defaultModel → 首个可用模型（已配凭据者）→ 抛错。
+ * 不在本函数兜底到任何硬编码模型——「用哪个模型」归用户配置。
+ * 导出供 K5（settings 端点）复用与单测注入（stub runtime）。
+ */
+export async function resolveDefaultModel(runtime, settings) {
+    const provider = settings.getDefaultProvider();
+    const modelId = settings.getDefaultModel();
+    if (provider !== undefined && modelId !== undefined) {
+        const configured = runtime.getModel(provider, modelId);
+        if (configured !== undefined)
+            return configured;
+    }
+    const available = await runtime.getAvailable();
+    const first = available[0];
+    if (first !== undefined)
+        return first;
+    throw new NoModelConfiguredError("未配置可用模型：请先在设置页或 ~/.pi/agent/（auth.json / models.json）配置 provider 凭据");
+}
+/**
+ * 装配一个项目的运行时。
+ * 会话文件落 `<项目根>/sessions`（不是 pi 默认的 agent dir 布局）。
+ */
+export async function createProjectRuntime(input) {
+    const projectRoot = resolve(input.projectRoot);
+    const agentDir = resolveAgentDir(input.agentDir);
+    const sessionManager = input.sessionManager ?? SessionManager.create(projectRoot, projectSessionsDir(projectRoot));
+    // 项目配置不参与：项目目录可能来自他人（备份包/共享目录），不接受其中携带的配置
+    const settingsManager = input.settingsManager ?? SettingsManager.create(projectRoot, agentDir, { projectTrusted: false });
+    const services = await createAgentSessionServices({
+        cwd: projectRoot,
+        agentDir,
+        settingsManager,
+        ...(input.modelRuntime === undefined ? {} : { modelRuntime: input.modelRuntime }),
+        resourceLoaderOptions: buildResourceLoaderOptions(projectRoot),
+    });
+    const model = input.model ?? (await resolveDefaultModel(services.modelRuntime, settingsManager));
+    // 提案接线：PROPOSAL 工具执行成功 → 重建完整 Proposal 入仓 + details 携带前端载荷
+    const proposalSink = input.proposalSink ?? createProposalSink({ store: input.proposalStore ?? defaultProposalStore });
+    const { session } = await createAgentSessionFromServices({
+        services,
+        sessionManager,
+        model,
+        ...(input.thinkingLevel === undefined ? {} : { thinkingLevel: input.thinkingLevel }),
+        // builtin（read/bash/edit/write…）全关：本项目不是编码 agent；领域工具是自定义工具，不受此开关影响
+        noTools: "builtin",
+        customTools: createCustomTools({ toolContext: input.toolContext, proposalSink }),
+    });
+    return {
+        session,
+        services,
+        sessionManager,
+        settingsManager,
+        modelRuntime: services.modelRuntime,
+        dispose: () => session.dispose(),
+    };
+}
+//# sourceMappingURL=project-runtime.js.map

package/dist/runtime/project-runtime.js.map

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

package/dist/runtime/proposals.d.ts

@@ -0,0 +1,85 @@
+import { type Proposal, type ToolContext } from "@whispering233/ai-editor-tools";
+import type { ProposalPayload, ProposalSink } from "./tools.js";
+export type { Proposal };
+/** 提案 TTL（10 分钟；confirm/reject 引用——超期按不存在处理） */
+export declare const PROPOSAL_TTL_MS: number;
+/**
+ * 提案条数上限（超限淘汰 createdAt 最旧）。
+ * 取 200 为数量级防御：正常会话一轮最多 15 个提案、挂卡不确认的残留按 TTL 自动过期，
+ * 200 足以覆盖极端多轮场景且内存占用可忽略（防无限增长）。
+ */
+export declare const PROPOSAL_MAX_COUNT = 200;
+/** 提案仓接口（confirm/reject 路由消费：get/peek；项目切换调 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 取（不校验项目）：区分「404 PROPOSAL_NOT_FOUND」与「409 PROPOSAL_PROJECT_MISMATCH」用
+     * ——get 返回 null 后 peek 仍可见 ⇒ 跨项目误操作。过期条目同样视为不存在（惰性清理）。
+     */
+    peek(proposalId: string): Proposal | null;
+    /**
+     * 按 id 移除单条（一次性消费：confirm/reject 终态后移除——瞬态交互对象，
+     * 残留只会让重复 confirm 产生重复执行或反复 409）。
+     * 与 clear 的区别：clear 清空全部（切换项目用），remove 只移除指定提案。
+     */
+    remove(proposalId: string): void;
+    /** 清空全部项目提案（create/open/close 切换项目时调用） */
+    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;
+/** 默认提案仓单例（confirm/reject 与项目切换 clear 直接引用；测试用 createProposalStore 独立实例） */
+export declare const defaultProposalStore: ProposalStore;
+/**
+ * 提案 build 层入口签名（args 已过 pi 的参数校验——preflight 返回的校验形态）。
+ * run 层裁剪只返回 `{ proposal_id, summary }`，完整 Proposal 对象须经 build 层重建
+ * （与 run 内部产出同源确定：同 ctx + 同 args 结果一致）。
+ */
+export type ProposalBuilder = (ctx: ToolContext, args: unknown) => Proposal;
+/**
+ * 15 个 propose_* 工具名 → build 层函数。
+ * 运行时查表缺失（非提案工具）返回 undefined；完整性由测试断言覆盖
+ * （Object.keys(PROPOSAL_BUILDERS) === PROPOSAL_TOOLS）。
+ */
+export declare const PROPOSAL_BUILDERS: Record<string, ProposalBuilder>;
+/** sink 选项 */
+export interface CreateProposalSinkOptions {
+    /** 提案仓（缺省 defaultProposalStore 单例——与 confirm/reject 同仓消费） */
+    store?: ProposalStore;
+}
+/**
+ * 构造提案 sink：pi 工具适配层在 PROPOSAL 工具执行成功后调用。
+ * 1. 按工具名取 build 函数重建**完整 Proposal**（run 层返回值不含预览细节）
+ * 2. `proposal_id` 以 run 返回值为准覆盖（build 每次生成新 id；三处必须同一 id：
+ *    tool content / SSE details / 仓 key）
+ * 3. 入仓（confirm/reject 取用），返回推给前端的载荷 `{ proposal_id, type, preview }`
+ *
+ * run 返回值形状不符（缺 proposal_id）→ 抛错：工具适配层会把它变成 error tool result
+ * 喂回模型自纠（与「抛错即失败」契约一致），不得静默吞掉。
+ */
+export declare function createProposalSink(options?: CreateProposalSinkOptions): ProposalSink;
+/** 提案载荷生成（导出供测试与调用方复用；与 sink 内部同一逻辑）
+ * preview 恒含 `summary`（结构化预览字段平铺其上）：模型可见的 tool content 与提案卡都需要一句话摘要，
+ * 结构化 preview（如 propose_reorder_timepoints 的 `{changes}`）不得把它覆盖掉。 */
+export declare function toProposalPayload(proposal: Proposal): ProposalPayload;
+//# sourceMappingURL=proposals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proposals.d.ts","sourceRoot":"","sources":["../../src/runtime/proposals.ts"],"names":[],"mappings":"AAaA,OAAO,EAiBL,KAAK,QAAQ,EACb,KAAK,WAAW,EACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhE,YAAY,EAAE,QAAQ,EAAE,CAAC;AAIzB,gDAAgD;AAChD,eAAO,MAAM,eAAe,QAAc,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC5D;;;OAGG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC1C;;;;OAIG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,0CAA0C;IAC1C,KAAK,IAAI,IAAI,CAAC;IACd,qBAAqB;IACrB,IAAI,IAAI,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CA+DrF;AAED,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,EAAE,aAAqC,CAAC;AAIzE;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,KAAK,QAAQ,CAAC;AAE5E;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAkB7D,CAAC;AAIF,cAAc;AACd,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,YAAY,CAUxF;AAiBD;;qEAEqE;AACrE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,eAAe,CASrE"}

package/dist/runtime/proposals.js

@@ -0,0 +1,173 @@
+// pi 运行时：提案内存仓 + 提案 build 层入口 + sink 实现
+//
+// 提案（AI 写操作的确认对象）**仅存服务端内存**：TTL 10 分钟 + 条数上限 + 项目绑定 +
+// 引用快照（确认时由 proposal 端点重校验，见 docs/design/30-agent-loop.md §2）。
+//
+// 本模块是提案仓与 `PROPOSAL_BUILDERS` 的**唯一实现**（提案端点与对话链路同仓消费）：
+// - 仓：set/get/peek/remove/clear/size
+// - build：15 个 propose_* 工具名 → 产出完整 Proposal 的构造函数
+//   （工具的 run 只返回 `{ proposal_id, summary }`，完整对象必须重建——工具的返回值要省 token）
+// - sink：pi 工具执行成功后的接线点——重建 Proposal 入仓 + 返回推给前端的载荷
+//
+// 架构边界：本包不依赖 db——`ToolContext`（db/outlineDir/projectId）由调用方注入并透传。
+import { buildProposeAbandonHook, buildProposeAddDelta, buildProposeAddRelation, buildProposeAdvanceHook, buildProposeCreateEntity, buildProposeCreateHook, buildProposeCreateReference, buildProposeDeleteEntity, buildProposeDeleteNode, buildProposeMoveNode, buildProposeOutlineNode, buildProposeRemoveRelation, buildProposeReorderTimepoints, buildProposeResolveHook, buildProposeUpdateEntity, buildProposeUpdateHook, } from "@whispering233/ai-editor-tools";
+// ============ 提案内存仓（仅内存、不落盘） ============
+/** 提案 TTL（10 分钟；confirm/reject 引用——超期按不存在处理） */
+export const PROPOSAL_TTL_MS = 10 * 60_000;
+/**
+ * 提案条数上限（超限淘汰 createdAt 最旧）。
+ * 取 200 为数量级防御：正常会话一轮最多 15 个提案、挂卡不确认的残留按 TTL 自动过期，
+ * 200 足以覆盖极端多轮场景且内存占用可忽略（防无限增长）。
+ */
+export const PROPOSAL_MAX_COUNT = 200;
+/**
+ * 创建提案仓实例。
+ * 过期策略：**惰性过期 + 按需清理**——get/peek 只清理命中的单条，set 前扫全仓清理；
+ * 无定时器（定时器引入时钟耦合且小仓无必要，测试用假时钟直接断言）。
+ * 淘汰策略：条数超限时淘汰 createdAt **最旧**的提案（sweep 过期后仍满则循环淘汰最旧）。
+ */
+export function createProposalStore(options = {}) {
+    const ttlMs = options.ttlMs ?? PROPOSAL_TTL_MS;
+    const maxCount = options.maxCount ?? PROPOSAL_MAX_COUNT;
+    /** 仓内条目：proposal + 过期时刻（set 时按 createdAt 预计算；createdAt 不可解析按立即过期防御） */
+    const entries = new Map();
+    const isExpired = (entry) => Date.now() >= entry.expiresAt;
+    const sweepExpired = () => {
+        for (const [id, entry] of entries) {
+            if (isExpired(entry))
+                entries.delete(id);
+        }
+    };
+    return {
+        set(proposal) {
+            sweepExpired();
+            const createdAtMs = Date.parse(proposal.createdAt);
+            entries.set(proposal.proposal_id, {
+                proposal,
+                expiresAt: Number.isNaN(createdAtMs) ? 0 : createdAtMs + ttlMs,
+            });
+            // 条数上限：循环淘汰最旧直到回到上限内（createdAt 同值取先插入者——迭代序即插入序）
+            while (entries.size > maxCount) {
+                let oldestId = null;
+                let oldestTime = Number.POSITIVE_INFINITY;
+                for (const [id, entry] of entries) {
+                    const t = Date.parse(entry.proposal.createdAt);
+                    if (t < oldestTime) {
+                        oldestTime = t;
+                        oldestId = id;
+                    }
+                }
+                if (oldestId === null)
+                    break; // 防御：理论不可达（size > 0 必有最旧）
+                entries.delete(oldestId);
+            }
+        },
+        get(proposalId, projectId) {
+            const entry = entries.get(proposalId);
+            if (entry === undefined)
+                return null;
+            if (isExpired(entry)) {
+                entries.delete(proposalId); // 惰性过期清理
+                return null;
+            }
+            if (entry.proposal.project_id !== projectId)
+                return null; // 项目绑定
+            return entry.proposal;
+        },
+        peek(proposalId) {
+            const entry = entries.get(proposalId);
+            if (entry === undefined)
+                return null;
+            if (isExpired(entry)) {
+                entries.delete(proposalId);
+                return null;
+            }
+            return entry.proposal;
+        },
+        remove(proposalId) {
+            entries.delete(proposalId);
+        },
+        clear() {
+            entries.clear();
+        },
+        size() {
+            return entries.size;
+        },
+    };
+}
+/** 默认提案仓单例（confirm/reject 与项目切换 clear 直接引用；测试用 createProposalStore 独立实例） */
+export const defaultProposalStore = createProposalStore();
+/**
+ * 15 个 propose_* 工具名 → build 层函数。
+ * 运行时查表缺失（非提案工具）返回 undefined；完整性由测试断言覆盖
+ * （Object.keys(PROPOSAL_BUILDERS) === PROPOSAL_TOOLS）。
+ */
+export const PROPOSAL_BUILDERS = {
+    propose_create_entity: (ctx, args) => buildProposeCreateEntity(ctx, args),
+    propose_update_entity: (ctx, args) => buildProposeUpdateEntity(ctx, args),
+    propose_delete_entity: (ctx, args) => buildProposeDeleteEntity(ctx, args),
+    propose_add_relation: (ctx, args) => buildProposeAddRelation(ctx, args),
+    propose_remove_relation: (ctx, args) => buildProposeRemoveRelation(ctx, args),
+    propose_add_delta: (ctx, args) => buildProposeAddDelta(ctx, args),
+    propose_outline_node: (ctx, args) => buildProposeOutlineNode(ctx, args),
+    propose_move_node: (ctx, args) => buildProposeMoveNode(ctx, args),
+    propose_delete_node: (ctx, args) => buildProposeDeleteNode(ctx, args),
+    propose_create_hook: (ctx, args) => buildProposeCreateHook(ctx, args),
+    propose_update_hook: (ctx, args) => buildProposeUpdateHook(ctx, args),
+    propose_advance_hook: (ctx, args) => buildProposeAdvanceHook(ctx, args),
+    propose_resolve_hook: (ctx, args) => buildProposeResolveHook(ctx, args),
+    propose_abandon_hook: (ctx, args) => buildProposeAbandonHook(ctx, args),
+    // G2（取代 F9 的 propose_reorder_events）
+    propose_reorder_timepoints: (ctx, args) => buildProposeReorderTimepoints(ctx, args),
+    propose_create_reference: (ctx, args) => buildProposeCreateReference(ctx, args),
+};
+/**
+ * 构造提案 sink：pi 工具适配层在 PROPOSAL 工具执行成功后调用。
+ * 1. 按工具名取 build 函数重建**完整 Proposal**（run 层返回值不含预览细节）
+ * 2. `proposal_id` 以 run 返回值为准覆盖（build 每次生成新 id；三处必须同一 id：
+ *    tool content / SSE details / 仓 key）
+ * 3. 入仓（confirm/reject 取用），返回推给前端的载荷 `{ proposal_id, type, preview }`
+ *
+ * run 返回值形状不符（缺 proposal_id）→ 抛错：工具适配层会把它变成 error tool result
+ * 喂回模型自纠（与「抛错即失败」契约一致），不得静默吞掉。
+ */
+export function createProposalSink(options = {}) {
+    const store = options.store ?? defaultProposalStore;
+    return ({ toolName, params, result, toolContext }) => {
+        const builder = PROPOSAL_BUILDERS[toolName];
+        if (builder === undefined)
+            return undefined; // 非提案工具（防御：调用方只在 PROPOSAL 工具调用）
+        const runResult = parseProposalRunResult(toolName, result);
+        const proposal = { ...builder(toolContext, params), proposal_id: runResult.proposal_id };
+        store.set(proposal);
+        return toProposalPayload(proposal);
+    };
+}
+/** 提案工具 run 返回值解析（缺 proposal_id 视为契约破坏，抛错让模型自纠） */
+function parseProposalRunResult(toolName, result) {
+    if (typeof result !== "object" || result === null) {
+        throw new Error(`提案工具 ${toolName} 返回结果不符合（缺 proposal_id）`);
+    }
+    const record = result;
+    if (typeof record.proposal_id !== "string") {
+        throw new Error(`提案工具 ${toolName} 返回结果不符合（缺 proposal_id）`);
+    }
+    return {
+        proposal_id: record.proposal_id,
+        summary: typeof record.summary === "string" ? record.summary : "",
+    };
+}
+/** 提案载荷生成（导出供测试与调用方复用；与 sink 内部同一逻辑）
+ * preview 恒含 `summary`（结构化预览字段平铺其上）：模型可见的 tool content 与提案卡都需要一句话摘要，
+ * 结构化 preview（如 propose_reorder_timepoints 的 `{changes}`）不得把它覆盖掉。 */
+export function toProposalPayload(proposal) {
+    return {
+        proposal_id: proposal.proposal_id,
+        type: proposal.type,
+        preview: {
+            summary: proposal.summary,
+            ...(proposal.preview ?? { type: proposal.type, args: proposal.args }),
+        },
+    };
+}
+//# sourceMappingURL=proposals.js.map

package/dist/runtime/proposals.js.map

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

package/dist/runtime/resources.d.ts

@@ -0,0 +1,14 @@
+import type { CreateAgentSessionServicesOptions } from "@earendil-works/pi-coding-agent";
+/** pi 资源加载选项（cwd/agentDir/settingsManager 由 SDK 填充，此处只给行为开关） */
+export type ResourceLoaderOptions = NonNullable<CreateAgentSessionServicesOptions["resourceLoaderOptions"]>;
+/** 项目根 AGENTS.md 内容（不存在/不可读 → null；读取失败不阻塞会话装配） */
+export declare function readProjectAgentsFile(projectRoot: string): {
+    path: string;
+    content: string;
+} | null;
+/**
+ * 资源加载选项：内核提示词作 system prompt 主体 + 只注入项目根 AGENTS.md。
+ * `agentsFilesOverride` 忽略 pi 的发现结果（祖先目录 + agent dir），只回项目根文件。
+ */
+export declare function buildResourceLoaderOptions(projectRoot: string): ResourceLoaderOptions;
+//# sourceMappingURL=resources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/runtime/resources.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAC;AAIzF,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,iCAAiC,CAAC,uBAAuB,CAAC,CAAC,CAAC;AAE5G,mDAAmD;AACnD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQnG;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,qBAAqB,CAWrF"}

package/dist/runtime/resources.js

@@ -0,0 +1,39 @@
+// pi 运行时：资源加载选项（本项目对 pi 发现的收窄）
+//
+// 收窄三件事（见 docs/design/architecture.md「AI 运行时」与 docs/design/config.md）：
+// 1. 不加载扩展 —— 项目目录可能来自他人（备份包/共享目录），其中的可执行扩展是安全面而非能力面；
+// 2. 不加载技能与提示词模板 —— 工具集固定，多一个资源来源就多一处不可见状态；
+// 3. AGENTS.md 只认项目根那一个文件 —— pi 默领会向上遍历祖先目录并读 agent dir，
+//    那会把创作根之外（甚至 HOME）的规则悄悄注进对话。
+import { existsSync, readFileSync } from "node:fs";
+import { projectAgentsFilePath } from "./paths.js";
+import { KERNEL_PROMPT } from "./system-prompt.js";
+/** 项目根 AGENTS.md 内容（不存在/不可读 → null；读取失败不阻塞会话装配） */
+export function readProjectAgentsFile(projectRoot) {
+    const path = projectAgentsFilePath(projectRoot);
+    if (!existsSync(path))
+        return null;
+    try {
+        return { path, content: readFileSync(path, "utf8") };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 资源加载选项：内核提示词作 system prompt 主体 + 只注入项目根 AGENTS.md。
+ * `agentsFilesOverride` 忽略 pi 的发现结果（祖先目录 + agent dir），只回项目根文件。
+ */
+export function buildResourceLoaderOptions(projectRoot) {
+    return {
+        noExtensions: true,
+        noSkills: true,
+        noPromptTemplates: true,
+        systemPrompt: KERNEL_PROMPT,
+        agentsFilesOverride: () => {
+            const agentsFile = readProjectAgentsFile(projectRoot);
+            return { agentsFiles: agentsFile === null ? [] : [agentsFile] };
+        },
+    };
+}
+//# sourceMappingURL=resources.js.map

package/dist/runtime/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/runtime/resources.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,uEAAuE;AACvE,sDAAsD;AACtD,4CAA4C;AAC5C,yDAAyD;AACzD,iCAAiC;AAEjC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD,mDAAmD;AACnD,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,MAAM,IAAI,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,WAAmB;IAC5D,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;QACd,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,aAAa;QAC3B,mBAAmB,EAAE,GAAG,EAAE;YACxB,MAAM,UAAU,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;YACtD,OAAO,EAAE,WAAW,EAAE,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;QAClE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/sessions.d.ts

@@ -0,0 +1,35 @@
+import { SessionManager, type SessionEntry, type SessionInfo } from "@earendil-works/pi-coding-agent";
+import { type WireMessage } from "./message-projection.js";
+export type { SessionEntry, SessionInfo } from "@earendil-works/pi-coding-agent";
+/** 会话消息投影（比线协议消息多一个 entry id：历史接口与思维链端点按它定位） */
+export interface WireSessionMessage extends WireMessage {
+    id: string;
+}
+/**
+ * 项目会话列表（pi 发现）：
+ * - 只认 `<项目根>/sessions` 下的 v3 会话文件（旧 v1 文件无 `cwd` 头字段 → 被 pi 的 cwd 过滤丢弃）
+ * - 头部异常（时间不可解析）的候选跳过，避免后续 `toISOString()` 抛错
+ */
+export declare function listProjectSessions(projectRoot: string): Promise<SessionInfo[]>;
+/** 按 id 找会话（磁盘发现映射；未命中 → null） */
+export declare function findProjectSession(projectRoot: string, sessionId: string): Promise<SessionInfo | null>;
+/** 打开会话读条目；会话不存在 / 文件在发现与打开之间损坏 → null（调用方转 404，不 500） */
+export declare function readProjectSession(projectRoot: string, sessionId: string): Promise<{
+    info: SessionInfo;
+    entries: SessionEntry[];
+} | null>;
+/**
+ * 打开指定会话文件的 SessionManager（续聊装配用）。
+ * 缺省（无 sessionFile）→ 在项目目录新建会话。
+ */
+export declare function openProjectSessionManager(projectRoot: string, sessionFile?: string): SessionManager;
+/** 条目 → API 消息投影（只保留 user/assistant/tool 三类；未知角色不投影） */
+export declare function projectSessionMessages(entries: readonly SessionEntry[]): WireSessionMessage[];
+/** 末条可见文本（列表摘要用；全为空 → 空串） */
+export declare function lastVisibleSessionText(entries: readonly SessionEntry[]): string;
+/**
+ * 读取某条 assistant 消息指定下标块的思维链全文；不是 thinking 块 / 下标越界 → null
+ * （调用方转 404 THINKING_NOT_FOUND——列表接口只回预览，全文按需拉取）。
+ */
+export declare function readSessionThinking(entries: readonly SessionEntry[], messageId: string, blockIndex: number): string | null;
+//# sourceMappingURL=sessions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/runtime/sessions.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACtG,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGlF,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEjF,gDAAgD;AAChD,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAGrF;AAED,kCAAkC;AAClC,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG5G;AAED,0DAA0D;AAC1D,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CAQhE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,CAKnG;AAED,wDAAwD;AACxD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,kBAAkB,EAAE,CAS7F;AAED,6BAA6B;AAC7B,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAQ/E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAQf"}

package/dist/runtime/sessions.js

@@ -0,0 +1,89 @@
+// pi 运行时：项目会话文件的读写与投影（server 只经本模块接触会话存储）
+//
+// 为什么收在这里：会话文件是 pi `SessionManager` 的所有物（v3 树状 JSONL，见 docs/db/schema.md），
+// 读条目 / 开管理器 / 投影消息形态的实现细节都属「pi 集成」——server 包只拿投影后的结果，
+// 不 import pi（依赖方向：server → agent，pi 只在 agent 里）。
+//
+// **路径只从磁盘发现来**：`listProjectSessions` 扫 `<项目根>/sessions` 得到 `{id, path}` 映射，
+// 调用方按 id 命中；客户端传入值永不参与路径拼接（旧 `sess_` 白名单校验随格式一并退休）。
+import { SessionManager } from "@earendil-works/pi-coding-agent";
+import { projectMessageForWire } from "./message-projection.js";
+import { projectSessionsDir } from "./paths.js";
+/**
+ * 项目会话列表（pi 发现）：
+ * - 只认 `<项目根>/sessions` 下的 v3 会话文件（旧 v1 文件无 `cwd` 头字段 → 被 pi 的 cwd 过滤丢弃）
+ * - 头部异常（时间不可解析）的候选跳过，避免后续 `toISOString()` 抛错
+ */
+export async function listProjectSessions(projectRoot) {
+    const infos = await SessionManager.list(projectRoot, projectSessionsDir(projectRoot));
+    return infos.filter((info) => !Number.isNaN(info.created.getTime()) && !Number.isNaN(info.modified.getTime()));
+}
+/** 按 id 找会话（磁盘发现映射；未命中 → null） */
+export async function findProjectSession(projectRoot, sessionId) {
+    const sessions = await listProjectSessions(projectRoot);
+    return sessions.find((info) => info.id === sessionId) ?? null;
+}
+/** 打开会话读条目；会话不存在 / 文件在发现与打开之间损坏 → null（调用方转 404，不 500） */
+export async function readProjectSession(projectRoot, sessionId) {
+    const info = await findProjectSession(projectRoot, sessionId);
+    if (info === null)
+        return null;
+    try {
+        return { info, entries: SessionManager.open(info.path, projectSessionsDir(projectRoot)).getEntries() };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 打开指定会话文件的 SessionManager（续聊装配用）。
+ * 缺省（无 sessionFile）→ 在项目目录新建会话。
+ */
+export function openProjectSessionManager(projectRoot, sessionFile) {
+    const sessionsDir = projectSessionsDir(projectRoot);
+    return sessionFile === undefined
+        ? SessionManager.create(projectRoot, sessionsDir)
+        : SessionManager.open(sessionFile, sessionsDir);
+}
+/** 条目 → API 消息投影（只保留 user/assistant/tool 三类；未知角色不投影） */
+export function projectSessionMessages(entries) {
+    const messages = [];
+    for (const entry of entries) {
+        if (entry.type !== "message")
+            continue;
+        const projected = projectMessageForWire(entry.message);
+        if (projected === null)
+            continue;
+        messages.push({ id: entry.id, ...projected });
+    }
+    return messages;
+}
+/** 末条可见文本（列表摘要用；全为空 → 空串） */
+export function lastVisibleSessionText(entries) {
+    for (let index = entries.length - 1; index >= 0; index -= 1) {
+        const entry = entries[index];
+        if (entry.type !== "message")
+            continue;
+        const projected = projectMessageForWire(entry.message);
+        if (projected !== null && projected.content.trim() !== "")
+            return projected.content;
+    }
+    return "";
+}
+/**
+ * 读取某条 assistant 消息指定下标块的思维链全文；不是 thinking 块 / 下标越界 → null
+ * （调用方转 404 THINKING_NOT_FOUND——列表接口只回预览，全文按需拉取）。
+ */
+export function readSessionThinking(entries, messageId, blockIndex) {
+    const entry = entries.find((candidate) => candidate.id === messageId);
+    if (entry === undefined || entry.type !== "message")
+        return null;
+    const content = entry.message?.content;
+    if (!Array.isArray(content))
+        return null;
+    const block = content[blockIndex];
+    if (block === undefined || block.type !== "thinking" || typeof block.thinking !== "string")
+        return null;
+    return block.thinking;
+}
+//# sourceMappingURL=sessions.js.map

package/dist/runtime/sessions.js.map

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

package/dist/{prompts.d.ts → runtime/system-prompt.d.ts}

@@ -1,13 +1,5 @@
-/** 内核提示词（内核层）：创作顾问角色定义 + 行为规范，代码固定不可用户编辑 */
-export declare const KERNEL_PROMPT = "\u4F60\u662F\u300C\u521B\u4F5C\u987E\u95EE\u300D\uFF0C\u4E00\u540D\u8D44\u6DF1\u5C0F\u8BF4\u521B\u4F5C\u642D\u6863\uFF0C\u670D\u52A1\u4E8E\u4F5C\u8005\u7684 AI \u5199\u4F5C\u5DE5\u4F5C\u53F0\u3002\n\u4F60\u7684\u804C\u8D23\u662F\u5E2E\u52A9\u4F5C\u8005\u5206\u6790\u5927\u7EB2\u3001\u4EBA\u7269\u3001\u5173\u7CFB\u3001\u60C5\u8282\u4E0E\u4F0F\u7B14\uFF0C\u63D0\u51FA\u53EF\u6267\u884C\u7684\u4FEE\u6539\u5EFA\u8BAE\u2014\u2014\u4F60\u662F\u5206\u6790\u987E\u95EE\uFF0C\u4E0D\u662F\u64CD\u4F5C\u5458\uFF0C\u4E5F\u4E0D\u4EE3\u5199\u6B63\u6587\u3002\n\n\u884C\u4E3A\u51C6\u5219\uFF1A\n1. \u4E0D\u751F\u6210\u6B63\u6587\uFF1A\u4E0D\u4EE3\u5199\u5C0F\u8BF4\u6B63\u6587\u6216\u7AE0\u8282\u5185\u5BB9\uFF0C\u8F93\u51FA\u59CB\u7EC8\u662F\u5206\u6790\u3001\u5EFA\u8BAE\u4E0E\u65B9\u6848\u3002\n2. \u4E0D\u76F4\u63A5\u5199\u5165\uFF1A\u7EDD\u4E0D\u76F4\u63A5\u5199\u5165\u3001\u4FEE\u6539\u6216\u5220\u9664\u4EFB\u4F55\u6570\u636E\uFF08\u5B9E\u4F53/\u5173\u7CFB/\u5927\u7EB2\u8282\u70B9/\u4F0F\u7B14/Delta\uFF09\uFF1B\u5199\u64CD\u4F5C\u4E00\u5F8B\u901A\u8FC7 propose_* \u5DE5\u5177\u751F\u6210\u63D0\u6848\uFF0C\u7531\u7528\u6237\u786E\u8BA4\u540E\u6267\u884C\u2014\u2014\u7528\u6237\u59CB\u7EC8\u662F\u6700\u7EC8\u51B3\u7B56\u8005\u3002\n3. \u67E5\u8BE2\u4E0E\u5206\u6790\u81EA\u7531\uFF1A\u53EF\u968F\u65F6\u8C03\u7528\u67E5\u8BE2\u7C7B\u4E0E\u5206\u6790\u7C7B\u5DE5\u5177\u83B7\u53D6\u6570\u636E\u3001\u8FD0\u884C\u7ED3\u6784\u5316\u5206\u6790\u3002\n4. \u7ED3\u679C\u622A\u65AD\u987B\u77E5\uFF1A\u5DE5\u5177\u7ED3\u679C\u82E5\u542B\u300C\u5DF2\u622A\u65AD\u300D\u6807\u8BB0\u5373\u6570\u636E\u4E0D\u5B8C\u6574\u2014\u2014\u8BF7\u7F29\u5C0F\u67E5\u8BE2\u8303\u56F4\u6216\u5206\u9875\u83B7\u53D6\uFF0C\u4E0D\u5F97\u57FA\u4E8E\u6B8B\u7F3A\u6570\u636E\u4E0B\u7ED3\u8BBA\u3002\n5. \u957F\u5EA6\u622A\u65AD\u987B\u77E5\uFF1A\u82E5\u4F60\u7684\u56DE\u590D\u56E0\u957F\u5EA6\u9650\u5236\u88AB\u622A\u65AD\uFF0C\u7CFB\u7EDF\u4E0D\u4F1A\u91CD\u53D1\u4F60\u7684\u534A\u6761\u56DE\u590D\uFF1B\u8BF7\u63A7\u5236\u7BC7\u5E45\uFF0C\u4F18\u5148\u7ED9\u51FA\u7ED3\u8BBA\u4E0E\u8981\u70B9\u3002\n6. \u805A\u7126\u4F18\u5148\uFF1Asystem \u6D88\u606F\u4E2D\u300C\u5F53\u524D\u805A\u7126\u300D\u6BB5\u843D\u662F\u4F5C\u8005\u6B63\u5728\u67E5\u770B\u7684\u5185\u5BB9\uFF0C\u4F18\u5148\u56F4\u7ED5\u5B83\u5C55\u5F00\u3002\n7. \u63D0\u6848\u8BED\u4E49\uFF1A\u8C03\u7528\u63D0\u6848\u5DE5\u5177\u540E\u9700\u7528\u6237\u786E\u8BA4\u624D\u751F\u6548\uFF1B\u786E\u8BA4\u524D\u4E0D\u8981\u5047\u8BBE\u4EFB\u4F55\u4FEE\u6539\u5DF2\u53D1\u751F\u3002\n8. \u56DE\u590D\u4F7F\u7528\u9879\u76EE\u914D\u7F6E\u7684\u8BED\u8A00\u3002";
-/** 项目提示词段标题（项目层，来自 project.json 的 prompt 字段） */
-export declare const PROJECT_PROMPT_TITLE = "## \u9879\u76EE\u8BBE\u5B9A";
-/** 临时指令段标题（临时层，即时输入、不持久化） */
-export declare const INSTRUCTION_TITLE = "## \u672C\u6B21\u6307\u4EE4";
-/** 可用工具清单段标题（name + description 一行，来自 registry listTools） */
-export declare const TOOL_LIST_TITLE = "## \u53EF\u7528\u5DE5\u5177";
-/** 聚焦上下文段标题（聚焦层：当前视图中的实体/大纲节点，由调用方查询后传入） */
+/** 内核提示词（system prompt 主体；pi `<project_instructions>` 段追加其后） */
+export declare const KERNEL_PROMPT = "\u4F60\u662F\u300C\u521B\u4F5C\u987E\u95EE\u300D\uFF0C\u4E00\u540D\u8D44\u6DF1\u5C0F\u8BF4\u521B\u4F5C\u642D\u6863\uFF0C\u670D\u52A1\u4E8E\u4F5C\u8005\u7684 AI \u5199\u4F5C\u5DE5\u4F5C\u53F0\u3002\n\u4F60\u7684\u804C\u8D23\u662F\u5E2E\u52A9\u4F5C\u8005\u5206\u6790\u5927\u7EB2\u3001\u4EBA\u7269\u3001\u5173\u7CFB\u3001\u60C5\u8282\u4E0E\u4F0F\u7B14\uFF0C\u63D0\u51FA\u53EF\u6267\u884C\u7684\u4FEE\u6539\u5EFA\u8BAE\u2014\u2014\u4F60\u662F\u5206\u6790\u987E\u95EE\uFF0C\u4E0D\u662F\u64CD\u4F5C\u5458\uFF0C\u4E5F\u4E0D\u4EE3\u5199\u6B63\u6587\u3002\n\n\u884C\u4E3A\u51C6\u5219\uFF1A\n1. \u4E0D\u751F\u6210\u6B63\u6587\uFF1A\u4E0D\u4EE3\u5199\u5C0F\u8BF4\u6B63\u6587\u6216\u7AE0\u8282\u5185\u5BB9\uFF0C\u8F93\u51FA\u59CB\u7EC8\u662F\u5206\u6790\u3001\u5EFA\u8BAE\u4E0E\u65B9\u6848\u3002\n2. \u4E0D\u76F4\u63A5\u5199\u5165\uFF1A\u7EDD\u4E0D\u76F4\u63A5\u5199\u5165\u3001\u4FEE\u6539\u6216\u5220\u9664\u4EFB\u4F55\u6570\u636E\uFF08\u5B9E\u4F53/\u5173\u7CFB/\u5927\u7EB2\u8282\u70B9/\u4F0F\u7B14/Delta\uFF09\uFF1B\u5199\u64CD\u4F5C\u4E00\u5F8B\u901A\u8FC7 propose_* \u5DE5\u5177\u751F\u6210\u63D0\u6848\uFF0C\u7531\u7528\u6237\u786E\u8BA4\u540E\u6267\u884C\u2014\u2014\u7528\u6237\u59CB\u7EC8\u662F\u6700\u7EC8\u51B3\u7B56\u8005\u3002\n3. \u67E5\u8BE2\u4E0E\u5206\u6790\u81EA\u7531\uFF1A\u53EF\u968F\u65F6\u8C03\u7528\u67E5\u8BE2\u7C7B\u4E0E\u5206\u6790\u7C7B\u5DE5\u5177\u83B7\u53D6\u6570\u636E\u3001\u8FD0\u884C\u7ED3\u6784\u5316\u5206\u6790\u3002\n4. \u7ED3\u679C\u622A\u65AD\u987B\u77E5\uFF1A\u5DE5\u5177\u7ED3\u679C\u82E5\u542B\u300C\u5DF2\u622A\u65AD\u300D\u6807\u8BB0\u5373\u6570\u636E\u4E0D\u5B8C\u6574\u2014\u2014\u8BF7\u7F29\u5C0F\u67E5\u8BE2\u8303\u56F4\u6216\u5206\u9875\u83B7\u53D6\uFF0C\u4E0D\u5F97\u57FA\u4E8E\u6B8B\u7F3A\u6570\u636E\u4E0B\u7ED3\u8BBA\u3002\n5. \u957F\u5EA6\u622A\u65AD\u987B\u77E5\uFF1A\u82E5\u4F60\u7684\u56DE\u590D\u56E0\u957F\u5EA6\u9650\u5236\u88AB\u622A\u65AD\uFF0C\u7CFB\u7EDF\u4E0D\u4F1A\u91CD\u53D1\u4F60\u7684\u534A\u6761\u56DE\u590D\uFF1B\u8BF7\u63A7\u5236\u7BC7\u5E45\uFF0C\u4F18\u5148\u7ED9\u51FA\u7ED3\u8BBA\u4E0E\u8981\u70B9\u3002\n6. \u805A\u7126\u4F18\u5148\uFF1A\u672C\u8F6E\u6D88\u606F\u4E2D\u82E5\u5E26\u300C\u5F53\u524D\u805A\u7126\u300D\u6807\u8BB0\uFF0C\u5B83\u662F\u4F5C\u8005\u6B63\u5728\u67E5\u770B\u7684\u5185\u5BB9\uFF0C\u4F18\u5148\u56F4\u7ED5\u5B83\u5C55\u5F00\u3002\n7. \u63D0\u6848\u8BED\u4E49\uFF1A\u8C03\u7528\u63D0\u6848\u5DE5\u5177\u540E\u9700\u7528\u6237\u786E\u8BA4\u624D\u751F\u6548\uFF1B\u786E\u8BA4\u524D\u4E0D\u8981\u5047\u8BBE\u4EFB\u4F55\u4FEE\u6539\u5DF2\u53D1\u751F\u3002\n8. \u56DE\u590D\u4F7F\u7528\u9879\u76EE\u914D\u7F6E\u7684\u8BED\u8A00\u3002";
+/** 「当前聚焦」段标题（调用方注入聚焦上下文时使用，语义与内核提示词第 6 条对应） */
 export declare const FOCUS_TITLE = "## \u5F53\u524D\u805A\u7126";
-/** 聚焦上下文截断提示（截断必须显式告知，不得静默丢数据） */
-export declare const FOCUS_TRUNCATION_NOTICE = "\n\n[\u805A\u7126\u4E0A\u4E0B\u6587\u5DF2\u622A\u65AD\uFF1A\u8D85\u51FA token \u9884\u7B97\uFF0C\u6570\u636E\u4E0D\u5B8C\u6574\uFF1B\u8BF7\u7F29\u5C0F\u67E5\u770B\u8303\u56F4]";
-//# sourceMappingURL=prompts.d.ts.map
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/runtime/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/runtime/system-prompt.ts"],"names":[],"mappings":"AAOA,gEAAgE;AAChE,eAAO,MAAM,aAAa,ikFAWV,CAAC;AAEjB,+CAA+C;AAC/C,eAAO,MAAM,WAAW,gCAAY,CAAC"}

package/dist/runtime/system-prompt.js

@@ -0,0 +1,22 @@
+// pi 运行时：内核提示词（提示词三层的第一层——开发者编辑、代码固定、不持久化）
+//
+// 其余两层：项目设定 = 项目根 AGENTS.md（经 pi 的 `<project_instructions>` 段注入）、
+// 临时指令 = 聊天框消息。见 docs/design/20-context.md §1。
+//
+// 内核提示词是产品定位的代码化（AI 是创作顾问不是代笔），改它等于改产品行为。
+/** 内核提示词（system prompt 主体；pi `<project_instructions>` 段追加其后） */
+export const KERNEL_PROMPT = `你是「创作顾问」，一名资深小说创作搭档，服务于作者的 AI 写作工作台。
+你的职责是帮助作者分析大纲、人物、关系、情节与伏笔，提出可执行的修改建议——你是分析顾问，不是操作员，也不代写正文。
+
+行为准则：
+1. 不生成正文：不代写小说正文或章节内容，输出始终是分析、建议与方案。
+2. 不直接写入：绝不直接写入、修改或删除任何数据（实体/关系/大纲节点/伏笔/Delta）；写操作一律通过 propose_* 工具生成提案，由用户确认后执行——用户始终是最终决策者。
+3. 查询与分析自由：可随时调用查询类与分析类工具获取数据、运行结构化分析。
+4. 结果截断须知：工具结果若含「已截断」标记即数据不完整——请缩小查询范围或分页获取，不得基于残缺数据下结论。
+5. 长度截断须知：若你的回复因长度限制被截断，系统不会重发你的半条回复；请控制篇幅，优先给出结论与要点。
+6. 聚焦优先：本轮消息中若带「当前聚焦」标记，它是作者正在查看的内容，优先围绕它展开。
+7. 提案语义：调用提案工具后需用户确认才生效；确认前不要假设任何修改已发生。
+8. 回复使用项目配置的语言。`;
+/** 「当前聚焦」段标题（调用方注入聚焦上下文时使用，语义与内核提示词第 6 条对应） */
+export const FOCUS_TITLE = "## 当前聚焦";
+//# sourceMappingURL=system-prompt.js.map