shipmyagent 1.0.167 → 1.0.187

package/bin/core/context/Compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Compact.d.ts","sourceRoot":"","sources":["../../../src/core/context/Compact.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,IAAI,CAAC;AAGZ,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAEpF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,EAAE,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC3C,oBAAoB,EAAE,CAAC,MAAM,EAAE;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAC;KAChD,KAAK,gBAAgB,CAAC;IACvB,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAClC,cAAc,EAAE,MAAM,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACzD,eAAe,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA0IlD"}

package/bin/core/context/Compact.js

@@ -0,0 +1,170 @@
+/**
+ * Context 压缩模块。
+ *
+ * 关键职责（中文）
+ * - 评估当前消息是否超出输入预算。
+ * - 在锁外生成“更早历史摘要”，降低锁持有时间。
+ * - 在锁内完成归档与 messages.jsonl 重写，保证并发安全。
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { generateText, isTextUIPart, } from "ai";
+import { generateId } from "../../utils/Id.js";
+import { getLogger } from "../../utils/logger/Logger.js";
+/**
+ * 对当前 context messages 做一次 best-effort compact（必要时）。
+ *
+ * 注意（中文）
+ * - compact 会 rewrite `messages.jsonl`（不是纯 append-only），因此必须防并发覆盖
+ * - 这里做两阶段锁：先 snapshot 再生成摘要，最后再锁定写入，降低锁持有时间
+ */
+export async function compactContextMessageIfNeeded(deps, params) {
+    const logger = getLogger(deps.rootPath, "info");
+    // 算法阶段（中文）
+    // phase 1：snapshot（短锁）
+    // - 仅负责拿一致性快照，不做耗时的模型调用。
+    // - 目的是把锁持有时间降到最低。
+    let snapshot = [];
+    let snapshotTailId = "";
+    await deps.withWriteLock(async () => {
+        snapshot = await deps.loadAll();
+        snapshotTailId =
+            snapshot.length > 0
+                ? String(snapshot[snapshot.length - 1].id || "")
+                : "";
+    });
+    if (snapshot.length <= params.keepLastMessages + 2) {
+        return { compacted: false, reason: "small_messages" };
+    }
+    const systemText = (params.system || [])
+        .map((m) => String(m.content ?? ""))
+        .join("\n\n");
+    // 关键点（中文）：context messages 现在可能包含 tool parts/output，必须把它们计入预算估算，否则会低估 token。
+    let messagesJson = "";
+    try {
+        messagesJson = JSON.stringify(snapshot);
+    }
+    catch {
+        messagesJson = "";
+    }
+    const est = estimateTokensApproxFromText(systemText + "\n\n" + messagesJson);
+    if (est <= params.maxInputTokensApprox) {
+        return { compacted: false, reason: "under_budget" };
+    }
+    const keepLast = Math.max(6, Math.min(2000, Math.floor(params.keepLastMessages)));
+    const older = snapshot.slice(0, Math.max(0, snapshot.length - keepLast));
+    if (older.length === 0)
+        return { compacted: false, reason: "nothing_to_compact" };
+    const olderTextAll = extractPlainTextFromMessages(older);
+    const maxOlderChars = 24_000;
+    const olderText = olderTextAll.length > maxOlderChars
+        ? "（注意：更早历史过长，已截断保留末尾）\n" + olderTextAll.slice(-maxOlderChars)
+        : olderTextAll;
+    // phase 1.5：生成摘要（不持锁）
+    // - 这一步最耗时，必须在锁外执行，避免阻塞 append。
+    let summary = "";
+    try {
+        const r = await generateText({
+            model: params.model,
+            system: [
+                {
+                    role: "system",
+                    content: "你是对话压缩助手。请把更早的对话历史压缩成“可持续复用”的工作摘要。\n" +
+                        "要求：\n" +
+                        "- 输出中文\n" +
+                        "- 不要复述无关细节，不要输出工具原始日志\n" +
+                        "- 必须包含：已确认事实/用户偏好约束/已做决策/未完成事项\n" +
+                        "- 使用 Markdown 列表，控制在 300~800 字",
+                },
+            ],
+            prompt: `请压缩以下更早历史（按 user/assistant 交替记录）：\n\n${olderText}`,
+        });
+        summary = String(r.text || "").trim();
+    }
+    catch (e) {
+        await logger.log("warn", "Context messages compact summary failed, fallback to lossy truncation", {
+            contextId: deps.contextId,
+            error: String(e),
+        });
+        summary = "（系统自动压缩：摘要生成失败，已丢弃更早历史，仅保留最近对话。）";
+    }
+    const fromId = String(older[0]?.id || "");
+    const toId = String(older[older.length - 1]?.id || "");
+    const summaryMsg = deps.createSummaryMessage({
+        text: summary,
+        sourceRange: fromId && toId ? { fromId, toId, count: older.length } : undefined,
+    });
+    const archiveId = `compact-${Date.now()}-${generateId()}`;
+    // phase 2：写入（短锁，且避免覆盖新追加）
+    // - 以“当前最新 context messages”为准重算 currentOlder/currentKept，避免覆盖并发新消息。
+    await deps.withWriteLock(async () => {
+        const current = await deps.loadAll();
+        if (!current.length)
+            return;
+        // 如果 tail 不同，说明期间有新消息追加；我们仍可安全 compact：按“当前”来保留最近 keepLast。
+        // snapshotTailId 用于 debug，不作为强一致性依赖。
+        void snapshotTailId;
+        const currentOlder = current.slice(0, Math.max(0, current.length - keepLast));
+        const currentKept = current.slice(Math.max(0, current.length - keepLast));
+        if (currentOlder.length === 0)
+            return;
+        if (params.archiveOnCompact) {
+            const archivePath = path.join(deps.getArchiveDirPath(), `${encodeURIComponent(String(archiveId || "").trim())}.json`);
+            await fs.writeJson(archivePath, {
+                v: 1,
+                contextId: deps.contextId,
+                archivedAt: Date.now(),
+                messages: currentOlder,
+            }, { spaces: 2 });
+        }
+        const next = [summaryMsg, ...currentKept];
+        const messagesPath = deps.getMessagesFilePath();
+        const tmp = messagesPath + ".tmp";
+        await fs.writeFile(tmp, next.map((m) => JSON.stringify(m)).join("\n") + "\n", "utf8");
+        await fs.move(tmp, messagesPath, { overwrite: true });
+        const prevMeta = await deps.readMetaUnsafe();
+        await deps.writeMetaUnsafe({
+            ...prevMeta,
+            updatedAt: Date.now(),
+            lastArchiveId: params.archiveOnCompact ? archiveId : undefined,
+            keepLastMessages: keepLast,
+            maxInputTokensApprox: params.maxInputTokensApprox,
+        });
+    });
+    return { compacted: true };
+}
+/**
+ * 近似 token 估算。
+ *
+ * 算法说明（中文）
+ * - 这里使用经验近似，不追求精确 tokenizer 一致性。
+ * - 目标是为 compact 提供保守预算，宁可略高估也不要低估。
+ */
+function estimateTokensApproxFromText(text) {
+    const t = String(text || "");
+    // 经验值：英文 ~4 chars/token；中文更接近 1-2 chars/token。这里用保守的 3 chars/token。
+    return Math.ceil(t.length / 3);
+}
+/**
+ * 从 UIMessage 提取可摘要的纯文本。
+ *
+ * 关键点（中文）
+ * - 统一把 user/assistant 内容线性化，作为 compact 摘要输入。
+ * - tool 原始结构不会原样输出，避免把噪声日志喂给摘要模型。
+ */
+function extractPlainTextFromMessages(messages) {
+    const lines = [];
+    for (const m of messages) {
+        if (!m || typeof m !== "object")
+            continue;
+        const role = m.role === "user" ? "user" : "assistant";
+        const parts = Array.isArray(m.parts) ? m.parts : [];
+        const textParts = parts.filter(isTextUIPart).map((p) => String(p.text ?? ""));
+        const text = textParts.join("\n").trim();
+        if (!text)
+            continue;
+        lines.push(`${role}: ${text}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=Compact.js.map

package/bin/core/context/Compact.js.map

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

package/bin/core/context/ContextAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContextAgent.d.ts","sourceRoot":"","sources":["../../../src/core/context/ContextAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAetD,qBAAa,YAAY;IAEvB,OAAO,CAAC,WAAW,CAAkB;IAErC,OAAO,CAAC,KAAK,CAAoC;IAEjD,OAAO,CAAC,KAAK,CAA4B;IACzC;;;;;;OAMG;IACH,OAAO,CAAC,cAAc,CAAuB;;IAI7C;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBjC;;;;;;;OAOG;IACG,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;IAuCrD;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;;;;;;;OAQG;YACW,oBAAoB;IAoSlC;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAiBlC;;;;;;OAMG;IACH,OAAO,CAAC,6BAA6B;IAqCrC;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAgD5B;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB"}
+{"version":3,"file":"ContextAgent.d.ts","sourceRoot":"","sources":["../../../src/core/context/ContextAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAKL,KAAK,aAAa,EAGnB,MAAM,IAAI,CAAC;AAOZ,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAKtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,CAAC,CAAC,EACrB,GAAG,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAC/C,EAAE,EAAE,MAAM,CAAC,KACR,CAAC,CAAC;IACP,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,YAAY,CAAC;IACrD,sBAAsB,EAAE,MAAM,MAAM,EAAE,CAAC;IACvC,uBAAuB,EAAE,CAAC,MAAM,CAAC,EAAE;QACjC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;KACjC,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxB,OAAO,CAAC,EAAE;QACR,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,CAAC;CACH,CAAC;AAEF,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IAEtC,OAAO,CAAC,KAAK,CAA4B;IACzC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAC6B;IAC3C;;;;;;OAMG;IACH,OAAO,CAAC,cAAc,CAAuB;gBAEjC,IAAI,EAAE,wBAAwB;IAM1C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAOxC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;;;;;OAMG;IACG,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;IAkBrD;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;;;;;;;OAQG;YACW,oBAAoB;IAkSlC;;OAEG;IACH,OAAO,CAAC,mCAAmC;IAa3C;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAkBlC;;;;;;OAMG;IACH,OAAO,CAAC,0BAA0B;IAWlC;;;;;;OAMG;IACH,OAAO,CAAC,6BAA6B;IAqCrC;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IA+C5B;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAI1C;;OAEG;IACH,WAAW,IAAI,IAAI;CAGpB"}

package/bin/core/context/ContextAgent.js

@@ -2,26 +2,27 @@
  * ContextAgentRunner：单会话 Agent 执行器。
  *
  * 关键职责（中文）
- * - 组装 system prompt（运行时上下文 + providers）。
+ * - 组装 system prompt（运行时上下文 + 静态模板 + service system）。
  * - 执行 tool-loop，并把 assistant/tool 调用结果回写 context 消息。
  * - 在上下文超窗时按策略逐步收紧 compact 参数并重试。
  */
 import { isTextUIPart, streamText, stepCountIs, } from "ai";
-import { withLlmRequestContext } from "../../utils/logger/Context.js";
-import { generateId } from "../../main/utils/Id.js";
-import { buildContextSystemPrompt, transformPromptsIntoSystemMessages, } from "../prompts/System.js";
-import { createModel } from "../llm/CreateModel.js";
-import { openai } from "@ai-sdk/openai";
-import { getRuntimeState, getRuntimeStateBase, } from "../../main/runtime/RuntimeState.js";
-import { collectSystemPromptProviderResult } from "../prompts/SystemProvider.js";
-import { loadProjectDotenv } from "../../main/runtime/Config.js";
+import { generateId } from "../../utils/Id.js";
+import { buildContextSystemPrompt, DEFAULT_SHIP_PROMPTS, transformPromptsIntoSystemMessages, } from "../prompts/System.js";
 import { shellTools } from "../shell/Tool.js";
+import { compactContextMessageIfNeeded } from "./Compact.js";
 export class ContextAgent {
-    // 是否初始化
-    initialized = false;
-    // 模型
-    model = openai("gpt-5.2");
+    deps;
+    model;
     tools = {};
+    /**
+     * Agent system 配置（可由调用方覆盖）。
+     *
+     * 关键点（中文）
+     * - 默认按 chat 会话模式运行。
+     * - task 等非聊天场景可通过 `setSystem` 覆盖默认行为。
+     */
+    system = ContextAgent.createDefaultSystemConfig();
     /**
      * contextId 绑定检查。
      *
@@ -30,83 +31,65 @@ export class ContextAgent {
      * - 本实例一旦首次 run 绑定到某个 contextId，后续必须一致，避免上下文串线
      */
     boundContextId = null;
-    constructor() { }
+    constructor(deps) {
+        this.deps = deps;
+        this.model = deps.model;
+        this.tools = { ...shellTools };
+    }
     /**
-     * 获取运行时 logger。
+     * 创建默认 system 配置。
      */
-    getLogger() {
-        return getRuntimeStateBase().logger;
+    static createDefaultSystemConfig() {
+        return {
+            mode: "chat",
+            disableServiceSystems: [],
+        };
     }
     /**
-     * 初始化 Agent 运行依赖。
-     *
-     * 流程（中文）
-     * 1) 构建工具集合
-     * 2) 根据 ship.json 创建模型实例
-     * 3) 标记 initialized=true
+     * 归一化外部传入的 system 配置。
      */
-    async initialize() {
-        try {
-            // 注意：不要在模块顶层读取 runtime state，否则像 `sma -v` 这种只打印版本号的场景也会因为未初始化而崩溃
-            const runtime = getRuntimeState();
-            loadProjectDotenv(runtime.rootPath);
-            this.tools = { ...shellTools };
-            this.model = await createModel({
-                config: getRuntimeState().config,
-            });
-            this.initialized = true;
-        }
-        catch (error) {
-            const logger = this.getLogger();
-            await logger.log("error", "Agent Runtime initialization failed", {
-                error: String(error),
-            });
-        }
+    normalizeSystemConfig(input) {
+        const mode = input.mode === "task" ? "task" : "chat";
+        const replaceDefaultCorePrompt = String(input.replaceDefaultCorePrompt || "").trim();
+        const disableServiceSystems = Array.isArray(input.disableServiceSystems)
+            ? [...new Set(input.disableServiceSystems
+                    .map((item) => String(item || "").trim())
+                    .filter(Boolean))]
+            : [];
+        return {
+            mode,
+            ...(replaceDefaultCorePrompt ? { replaceDefaultCorePrompt } : {}),
+            disableServiceSystems,
+        };
+    }
+    /**
+     * 获取运行时 logger。
+     */
+    getLogger() {
+        return this.deps.logger;
     }
     /**
      * run：对外统一入口。
      *
      * 流程（中文）
      * 1) 记录 requestId 与日志
-     * 2) 检查初始化状态
-     * 3) 进入 tool-loop 主流程
+     * 2) 进入 tool-loop 主流程
      */
     async run(input) {
         const { query, contextId, onStepCallback } = input;
         const startTime = Date.now();
         const requestId = generateId();
         const logger = this.getLogger();
-        await logger.log("debug", `ContextId: ${contextId}`);
         await logger.log("info", "Agent request started", {
             requestId,
             contextId,
             instructionsPreview: query?.slice(0, 200),
-            rootPath: getRuntimeState().rootPath,
+            rootPath: this.deps.projectRoot,
+        });
+        return this.runWithToolLoopAgent(query, startTime, contextId, {
+            requestId,
+            onStepCallback,
         });
-        if (this.initialized) {
-            return this.runWithToolLoopAgent(query, startTime, contextId, {
-                requestId,
-                onStepCallback,
-            });
-        }
-        let contextStore = null;
-        try {
-            contextStore =
-                getRuntimeState().contextManager.getContextStore(contextId);
-        }
-        catch {
-            contextStore = null;
-        }
-        return {
-            success: false,
-            assistantMessage: this.buildFallbackAssistantMessage({
-                contextId,
-                requestId,
-                contextStore,
-                text: "LLM is not configured (or runtime not initialized). Please configure `ship.json.llm` (model + apiKey) and restart.",
-                note: "agent_not_initialized",
-            }),
-        };
     }
     /**
      * 绑定 contextId（单实例单会话约束）。
@@ -128,7 +111,7 @@ export class ContextAgent {
      * 算法步骤（中文）
      * - 绑定 contextId，防止一个实例跨会话串线。
      * - 读取/补齐用户消息到 context store（防止入口未写入）。
-     * - 收集 system prompt providers，得到 activeTools 与附加系统消息。
+     * - 收集 service system 文本，和运行时/静态 system 一起拼装。
      * - 执行模型调用；若超窗则按 compact policy 递进重试。
      */
     async runWithToolLoopAgent(userText, startTime, contextId, opts) {
@@ -137,37 +120,49 @@ export class ContextAgent {
         const requestId = opts?.requestId || "";
         const onStepCallback = opts?.onStepCallback;
         const logger = this.getLogger();
-        if (!this.initialized) {
-            throw new Error("Agent not initialized");
-        }
         try {
             this.bindContextId(contextId);
-            const runtime = getRuntimeState();
             // phase 0（中文）：装配 context store 与 runtime/system prompt 基础上下文。
-            contextStore = runtime.contextManager.getContextStore(contextId);
+            contextStore = this.deps.getContextStore(contextId);
+            const activeContextStore = contextStore;
             const runtimeSystemMessages = this.buildRuntimeSystemMessages({
-                projectRoot: runtime.rootPath,
-                contextId,
-                requestId,
-            });
-            const staticSystemMessages = transformPromptsIntoSystemMessages([
-                ...runtime.systems,
-            ]);
-            let currentProviderResult = await collectSystemPromptProviderResult({
-                projectRoot: runtime.rootPath,
+                projectRoot: this.deps.projectRoot,
                 contextId,
                 requestId,
-                allToolNames: Object.keys(this.tools),
             });
+            const staticSystemMessages = transformPromptsIntoSystemMessages(this.resolveStaticSystemPrompts({
+                systems: this.deps.getStaticSystemPrompts(),
+            }));
+            let serviceSystemMessages = transformPromptsIntoSystemMessages(await this.deps.getServiceSystemPrompts({
+                disabledServiceNames: this.system.disableServiceSystems,
+            }));
             let currentBaseSystemMessages = [
                 ...runtimeSystemMessages,
                 ...staticSystemMessages,
-                ...currentProviderResult.messages,
+                ...serviceSystemMessages,
             ];
             const compactPolicy = this.resolveCompactPolicy(retryAttempts);
             let compacted = false;
             try {
-                const compactResult = await contextStore.compactIfNeeded({
+                const compactResult = await compactContextMessageIfNeeded({
+                    rootPath: activeContextStore.rootPath,
+                    contextId: activeContextStore.contextId,
+                    withWriteLock: (fn) => activeContextStore.withWriteLock(fn),
+                    loadAll: () => activeContextStore.loadAll(),
+                    createSummaryMessage: ({ text, sourceRange }) => activeContextStore.createAssistantTextMessage({
+                        text,
+                        metadata: {
+                            contextId: activeContextStore.contextId,
+                        },
+                        kind: "summary",
+                        source: "compact",
+                        ...(sourceRange ? { sourceRange } : {}),
+                    }),
+                    getArchiveDirPath: () => activeContextStore.getArchiveDirPath(),
+                    getMessagesFilePath: () => activeContextStore.getMessagesFilePath(),
+                    readMetaUnsafe: () => activeContextStore.readMetaUnsafe(),
+                    writeMetaUnsafe: (next) => activeContextStore.writeMetaUnsafe(next),
+                }, {
                     model: this.model,
                     system: currentBaseSystemMessages,
                     keepLastMessages: compactPolicy.keepLastMessages,
@@ -180,32 +175,22 @@ export class ContextAgent {
                 // ignore compact failure; fallback to un-compacted context messages
             }
             if (compacted) {
-                // 关键点（中文）：compact 后重新聚合 provider，保证 prompt 与 activeTools 同步最新状态。
-                currentProviderResult = await collectSystemPromptProviderResult({
-                    projectRoot: runtime.rootPath,
-                    contextId,
-                    requestId,
-                    allToolNames: Object.keys(this.tools),
-                });
+                // 关键点（中文）：compact 后重新收集 service system，保证提示词与最新状态一致。
+                serviceSystemMessages = transformPromptsIntoSystemMessages(await this.deps.getServiceSystemPrompts({
+                    disabledServiceNames: this.system.disableServiceSystems,
+                }));
                 currentBaseSystemMessages = [
                     ...runtimeSystemMessages,
                     ...staticSystemMessages,
-                    ...currentProviderResult.messages,
+                    ...serviceSystemMessages,
                 ];
             }
-            let baseModelMessages = await contextStore.toModelMessages({
+            let baseModelMessages = await activeContextStore.toModelMessages({
                 tools: this.tools,
             });
             if (!Array.isArray(baseModelMessages) || baseModelMessages.length === 0) {
                 baseModelMessages = [{ role: "user", content: userText }];
             }
-            await logger.log("debug", "Context selected", {
-                contextId,
-                historySource: "messages_jsonl",
-                modelMessages: baseModelMessages.length,
-                keepLastMessages: compactPolicy.keepLastMessages,
-                maxInputTokensApprox: compactPolicy.maxInputTokensApprox,
-            });
             // 关键点（中文）
             // - 在 step 边界尝试合并同 lane 的新增用户消息，保证当前 run 可见最新输入。
             // - 保留 tool-loop 的 in-flight 后缀消息（工具调用链）。
@@ -235,51 +220,46 @@ export class ContextAgent {
                 return toAppend.length;
             };
             // phase 2（中文）：进入 tool-loop。
-            const result = await withLlmRequestContext({ contextId, requestId }, () => {
-                return streamText({
-                    model: this.model,
-                    system: currentBaseSystemMessages,
-                    prepareStep: async ({ messages }) => {
-                        const incomingMessages = Array.isArray(messages)
-                            ? messages
-                            : [];
-                        const suffix = incomingMessages.length >= lastAppliedBasePrefixLen
-                            ? incomingMessages.slice(lastAppliedBasePrefixLen)
-                            : [];
-                        let outMessages;
-                        if (typeof onStepCallback === "function") {
-                            try {
-                                const mergedMessages = await onStepCallback();
-                                const added = appendMergedUserMessages(Array.isArray(mergedMessages) ? mergedMessages : []);
-                                if (added > 0) {
-                                    outMessages = [...baseModelMessages, ...suffix];
-                                    lastAppliedBasePrefixLen = baseModelMessages.length;
-                                    void logger.log("debug", "Lane merged messages detected; appended queued user messages for next step", { contextId, requestId, added });
-                                }
-                            }
-                            catch {
-                                // ignore merge hook failures
+            const runStreamText = () => streamText({
+                model: this.model,
+                system: currentBaseSystemMessages,
+                prepareStep: async ({ messages }) => {
+                    const incomingMessages = Array.isArray(messages)
+                        ? messages
+                        : [];
+                    const suffix = incomingMessages.length >= lastAppliedBasePrefixLen
+                        ? incomingMessages.slice(lastAppliedBasePrefixLen)
+                        : [];
+                    let outMessages;
+                    if (typeof onStepCallback === "function") {
+                        try {
+                            const mergedMessages = await onStepCallback();
+                            const added = appendMergedUserMessages(Array.isArray(mergedMessages) ? mergedMessages : []);
+                            if (added > 0) {
+                                outMessages = [...baseModelMessages, ...suffix];
+                                lastAppliedBasePrefixLen = baseModelMessages.length;
                             }
                         }
-                        const stepOverrides = {
-                            system: currentBaseSystemMessages,
-                        };
-                        if (Array.isArray(currentProviderResult.activeTools) &&
-                            currentProviderResult.activeTools.length > 0) {
-                            stepOverrides.activeTools = currentProviderResult.activeTools;
+                        catch {
+                            // ignore merge hook failures
                         }
-                        return {
-                            ...stepOverrides,
-                            ...(Array.isArray(outMessages)
-                                ? { messages: outMessages }
-                                : {}),
-                        };
-                    },
-                    messages: baseModelMessages,
-                    tools: this.tools,
-                    stopWhen: [stepCountIs(30)],
-                });
+                    }
+                    const stepOverrides = {
+                        system: currentBaseSystemMessages,
+                    };
+                    return {
+                        ...stepOverrides,
+                        ...(Array.isArray(outMessages) ? { messages: outMessages } : {}),
+                    };
+                },
+                messages: baseModelMessages,
+                tools: this.tools,
+                providerOptions: this.buildOpenAIResponsesProviderOptions(),
+                stopWhen: [stepCountIs(30)],
             });
+            const result = this.deps.withRequestContext
+                ? await this.deps.withRequestContext({ contextId, requestId }, runStreamText)
+                : runStreamText();
             // phase 3（中文）：把 stream 结果固化为最终 assistant UIMessage。
             // 关键点（中文）：用 ai-sdk v6 的 UIMessage 流来生成最终 assistant UIMessage（包含 tool parts），避免手工拼装。
             let finalAssistantUiMessage = null;
@@ -383,6 +363,17 @@ export class ContextAgent {
             };
         }
     }
+    /**
+     * 构建 OpenAI Responses providerOptions。
+     */
+    buildOpenAIResponsesProviderOptions() {
+        return {
+            openai: {
+                // 关键点（中文）：Responses 走无状态模式，历史仅由本地 UIMessage 管理。
+                store: false,
+            },
+        };
+    }
     /**
      * 构建运行时 system message。
      *
@@ -397,10 +388,26 @@ export class ContextAgent {
                     projectRoot: input.projectRoot,
                     contextId: input.contextId,
                     requestId: input.requestId,
+                    mode: this.system.mode,
                 }),
             },
         ];
     }
+    /**
+     * 解析静态 system prompts。
+     *
+     * 关键点（中文）
+     * - task 执行上下文替换默认 core prompt（`DEFAULT_SHIP_PROMPTS`）为 task 专用提示词。
+     * - Agent.md 等其他静态系统提示保持不变。
+     */
+    resolveStaticSystemPrompts(input) {
+        const base = Array.isArray(input.systems) ? [...input.systems] : [];
+        const replacement = String(this.system.replaceDefaultCorePrompt || "").trim();
+        if (!replacement)
+            return base;
+        const filtered = base.filter((item) => item !== DEFAULT_SHIP_PROMPTS);
+        return [...filtered, replacement];
+    }
     /**
      * 构造 fallback assistant 消息。
      *
@@ -446,14 +453,13 @@ export class ContextAgent {
      * - 目标是在不直接失败的前提下，尽量保留可用上下文。
      */
     resolveCompactPolicy(retryAttempts) {
-        const runtime = getRuntimeState();
-        const contextMessagesConfig = runtime.config.context?.messages;
+        const contextMessagesConfig = this.deps.compact;
         const baseKeepLastMessages = typeof contextMessagesConfig?.keepLastMessages === "number"
             ? Math.max(6, Math.min(5000, Math.floor(contextMessagesConfig.keepLastMessages)))
             : 30;
         const baseMaxInputTokensApprox = typeof contextMessagesConfig?.maxInputTokensApprox === "number"
             ? Math.max(2000, Math.min(200_000, Math.floor(contextMessagesConfig.maxInputTokensApprox)))
-            : 16000;
+            : 128000;
         // 关键点（中文）：当 provider 报错超窗时，会进入 retry；此时需要更激进的 compact。
         const retryFactor = Math.max(1, Math.pow(2, retryAttempts));
         const keepLastMessages = Math.max(6, Math.floor(baseKeepLastMessages / retryFactor));
@@ -468,10 +474,19 @@ export class ContextAgent {
         };
     }
     /**
-     * 是否已完成初始化。
+     * 设置当前 Agent 的 system 配置。
+     *
+     * 关键点（中文）
+     * - 由上游调用方（如 task runner）按场景覆盖默认 chat system。
+     */
+    setSystem(config) {
+        this.system = this.normalizeSystemConfig(config);
+    }
+    /**
+     * 重置为默认 chat system 配置。
      */
-    isInitialized() {
-        return this.initialized;
+    resetSystem() {
+        this.system = ContextAgent.createDefaultSystemConfig();
     }
 }
 //# sourceMappingURL=ContextAgent.js.map