@ycodium-ai/agent-grok 0.2.2634 → 0.2.2664

package/dist/index.js

@@ -70,7 +70,10 @@ var GROK_CARD = {
     // 档位走 spawn 旗标，切档要重开会话（与 runtimeModeSwitch 同为 next-turn 的原因）。
     // 声明这一位让界面画这双手自报的三档；不声明就退回宿主四档，而四档在这只手上
     // 有两档撞车（都落到 `auto`）。
-    nativeModeSwitch: true
+    nativeModeSwitch: true,
+    // 压缩走 CLI 宣告过的 `/compact` 命令（见 `compactContext`），进度与结果由执行器按
+    // 压缩生命周期事件报；CLI 没宣告这条命令时 `compactContext` 拒绝，不退回发文本。
+    contextCompaction: "native"
   },
   // 凭据由 CLI 自己保管在 `<GROK_HOME>/auth.json`，宿主读它只认 `/token`。
   credentialSources: [
@@ -152,7 +155,7 @@ var GROK_CARD = {
 
 // src/grokInstance.ts
 import * as NodeCrypto2 from "node:crypto";
-import * as NodeOS from "node:os";
+import * as NodeOS2 from "node:os";
 import * as NodePath2 from "node:path";
 import { mergeLaunchEnv } from "@ycodium-ai/plugin-api/executor";
 import { nodeStreamsFromHandle as nodeStreamsFromHandle2 } from "@ycodium-ai/plugin-api/process-stdin";
@@ -3000,23 +3003,23 @@ function canParseURL(input2) {
     return false;
   }
 }
-function validateURL(trimmed2, def) {
+function validateURL(trimmed3, def) {
   if (!("normalize" in def) && !("hostname" in def) && !("protocol" in def)) {
-    return canParseURL(trimmed2) || URL_UNPARSEABLE;
+    return canParseURL(trimmed3) || URL_UNPARSEABLE;
   }
-  return parseURLObject(trimmed2, def);
+  return parseURLObject(trimmed3, def);
 }
-function parseURLObject(trimmed2, def) {
-  if (!def.normalize && def.protocol?.source === httpProtocol.source && !/^https?:\/\//i.test(trimmed2)) {
+function parseURLObject(trimmed3, def) {
+  if (!def.normalize && def.protocol?.source === httpProtocol.source && !/^https?:\/\//i.test(trimmed3)) {
     return URL_BAD_FORMAT;
   }
   try {
     if (typeof URL !== "undefined") {
       const URLStatic = URL;
       if (typeof URLStatic.parse === "function")
-        return URLStatic.parse(trimmed2) ?? URL_UNPARSEABLE;
+        return URLStatic.parse(trimmed3) ?? URL_UNPARSEABLE;
     }
-    return new URL(trimmed2);
+    return new URL(trimmed3);
   } catch {
     return URL_UNPARSEABLE;
   }
@@ -3037,8 +3040,8 @@ var $ZodURL = /* @__PURE__ */ $constructor("$ZodURL", (inst, def) => {
   $ZodStringFormat.init(inst, def);
   inst._zod.check = (payload) => {
     try {
-      const trimmed2 = payload.value.trim();
-      const url2 = validateURL(trimmed2, def);
+      const trimmed3 = payload.value.trim();
+      const url2 = validateURL(trimmed3, def);
       if (url2 === URL_BAD_FORMAT) {
         payload.issues.push({
           code: "invalid_format",
@@ -3061,7 +3064,7 @@ var $ZodURL = /* @__PURE__ */ $constructor("$ZodURL", (inst, def) => {
         return;
       }
       if (url2 === true) {
-        payload.value = stripTabAndNewline(trimmed2);
+        payload.value = stripTabAndNewline(trimmed3);
         return;
       }
       if (def.hostname && !urlHostnameOk(url2, def.hostname)) {
@@ -3086,7 +3089,7 @@ var $ZodURL = /* @__PURE__ */ $constructor("$ZodURL", (inst, def) => {
           continue: !def.abort
         });
       }
-      payload.value = def.normalize ? url2.href : stripTabAndNewline(trimmed2);
+      payload.value = def.normalize ? url2.href : stripTabAndNewline(trimmed3);
       return;
     } catch (_) {
       payload.issues.push({
@@ -9521,8 +9524,8 @@ function ko_default() {
 }
 
 // ../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/locales/lt.js
-var capitalizeFirstCharacter = (text) => {
-  return text.charAt(0).toUpperCase() + text.slice(1);
+var capitalizeFirstCharacter = (text2) => {
+  return text2.charAt(0).toUpperCase() + text2.slice(1);
 };
 function getUnitTypeFromNumber(number4) {
   const abs = Math.abs(number4);
@@ -16816,8 +16819,8 @@ function rewriteKeyNames(ctx) {
       bySchema.set(entry.schema, entry);
   }
   const rewrites = /* @__PURE__ */ new Map();
-  for (const record2 of pendingRecords.get(ctx) ?? []) {
-    const seen = ctx.seen.get(record2);
+  for (const record3 of pendingRecords.get(ctx) ?? []) {
+    const seen = ctx.seen.get(record3);
     const names = (seen?.def ?? seen?.schema)?.propertyNames;
     if (!names || names === true || rewrites.has(names))
       continue;
@@ -23584,11 +23587,21 @@ var AcpExecutorRequestError = class extends AcpExecutorError {
   }
 };
 var AcpConnectionClosedError = class extends Error {
-  constructor(message = "ACP connection closed") {
-    super(message);
+  constructor(message = "ACP connection closed", options) {
+    super(message, options);
     this.name = "AcpConnectionClosedError";
   }
 };
+async function withStartupStderr(error62, stderrTail) {
+  if (!(error62 instanceof AcpConnectionClosedError) || stderrTail === void 0) return error62;
+  const tail = await stderrTail();
+  if (tail.length === 0) return error62;
+  return new AcpConnectionClosedError(`${error62.message}
+Agent stderr (last lines):
+${tail}`, {
+    cause: error62
+  });
+}
 
 // ../../packages/ycodium-acp-executor/src/jsonrpc.ts
 function isRecord2(value) {
@@ -23730,12 +23743,12 @@ function asBytes(chunk) {
   throw new TypeError("ACP readable produced a non-byte chunk");
 }
 function isEnqueueableLine(lineBytes) {
-  const trimmed2 = textDecoder.decode(lineBytes).trim();
-  if (!trimmed2) {
+  const trimmed3 = textDecoder.decode(lineBytes).trim();
+  if (!trimmed3) {
     return false;
   }
   try {
-    const parsed = JSON.parse(trimmed2);
+    const parsed = JSON.parse(trimmed3);
     return typeof parsed === "object" && parsed !== null;
   } catch {
     return false;
@@ -23933,9 +23946,9 @@ function createAcpConnection(options) {
   const handleChunk = async (bytes) => {
     const lines = lineBuffer.push(bytes);
     for (const line of lines) {
-      const trimmed2 = textDecoder.decode(line).trim();
-      if (trimmed2) {
-        log({ direction: "incoming", stage: "raw", payload: trimmed2 });
+      const trimmed3 = textDecoder.decode(line).trim();
+      if (trimmed3) {
+        log({ direction: "incoming", stage: "raw", payload: trimmed3 });
       }
     }
     const expected = lines.filter(isEnqueueableLine).length;
@@ -23972,9 +23985,9 @@ function createAcpConnection(options) {
     enqueueInbound(async () => {
       const last = lineBuffer.flush();
       if (last) {
-        const trimmed2 = textDecoder.decode(last).trim();
-        if (trimmed2) {
-          log({ direction: "incoming", stage: "raw", payload: trimmed2 });
+        const trimmed3 = textDecoder.decode(last).trim();
+        if (trimmed3) {
+          log({ direction: "incoming", stage: "raw", payload: trimmed3 });
         }
       }
       const expected = last && isEnqueueableLine(last) ? 1 : 0;
@@ -24087,10 +24100,10 @@ function selectAutoApprovedAcpPermissionOption(request) {
 }
 function parseAcpResumeCursor(raw, schemaVersion) {
   if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return void 0;
-  const record2 = raw;
-  if (record2["schemaVersion"] !== schemaVersion) return void 0;
-  if (typeof record2["sessionId"] !== "string" || !record2["sessionId"].trim()) return void 0;
-  return { sessionId: record2["sessionId"].trim() };
+  const record3 = raw;
+  if (record3["schemaVersion"] !== schemaVersion) return void 0;
+  if (typeof record3["sessionId"] !== "string" || !record3["sessionId"].trim()) return void 0;
+  return { sessionId: record3["sessionId"].trim() };
 }
 function acpPromptSettlementBelongsToContext(input2) {
   return input2.liveAcpSessionId === input2.expectedAcpSessionId && (input2.liveActiveTurnId === input2.turnId || input2.liveSessionActiveTurnId === input2.turnId);
@@ -24099,18 +24112,18 @@ function isAcpRequestPermissionParams(value) {
   if (typeof value !== "object" || value === null) {
     return false;
   }
-  const record2 = value;
-  if (typeof record2["sessionId"] !== "string") {
+  const record3 = value;
+  if (typeof record3["sessionId"] !== "string") {
     return false;
   }
-  const toolCall = record2["toolCall"];
+  const toolCall = record3["toolCall"];
   if (typeof toolCall !== "object" || toolCall === null) {
     return false;
   }
   if (typeof toolCall["toolCallId"] !== "string") {
     return false;
   }
-  return Array.isArray(record2["options"]);
+  return Array.isArray(record3["options"]);
 }
 
 // ../../packages/ycodium-acp-executor/src/approvals.ts
@@ -24635,8 +24648,8 @@ function asTrimmedString(value) {
   if (typeof value !== "string") {
     return void 0;
   }
-  const trimmed2 = value.trim();
-  return trimmed2.length > 0 ? trimmed2 : void 0;
+  const trimmed3 = value.trim();
+  return trimmed3.length > 0 ? trimmed3 : void 0;
 }
 
 // ../../packages/ycodium-acp-executor/src/tool-presentation.ts
@@ -24658,12 +24671,12 @@ function normalizeCommandValue(value) {
   return parts.length > 0 ? parts.join(" ") : void 0;
 }
 function stripTrailingExitCode(value) {
-  const trimmed2 = value?.trim();
-  if (!trimmed2) {
+  const trimmed3 = value?.trim();
+  if (!trimmed3) {
     return void 0;
   }
-  const match = /^(?<output>[\s\S]*?)(?:\s*<exited with exit code \d+>)\s*$/iu.exec(trimmed2);
-  const output2 = match?.groups?.output?.trim() ?? trimmed2;
+  const match = /^(?<output>[\s\S]*?)(?:\s*<exited with exit code \d+>)\s*$/iu.exec(trimmed3);
+  const output2 = match?.groups?.output?.trim() ?? trimmed3;
   return output2.length > 0 ? output2 : void 0;
 }
 function extractCommandFromTitle(title) {
@@ -24753,11 +24766,11 @@ function extractPrimaryPath(data) {
   return paths[0];
 }
 function normalizeEquivalentValue(value) {
-  const trimmed2 = asTrimmedString(value);
-  if (!trimmed2) {
+  const trimmed3 = asTrimmedString(value);
+  if (!trimmed3) {
     return void 0;
   }
-  return trimmed2.replace(/\s+/gu, " ").replace(/\s+(?:complete|completed|started)\s*$/iu, "").trim();
+  return trimmed3.replace(/\s+/gu, " ").replace(/\s+(?:complete|completed|started)\s*$/iu, "").trim();
 }
 function isEquivalent(left, right) {
   const normalizedLeft = normalizeEquivalentValue(left)?.toLowerCase();
@@ -24845,7 +24858,7 @@ function extractModelConfigId(sessionResponse) {
       return opt.id.trim();
     }
   }
-  return void 0;
+  return configOptions.find((opt) => opt.id.trim() === "model" && opt.type === "select") ? "model" : void 0;
 }
 function findSessionConfigOption(configOptions, configId) {
   if (!configOptions) {
@@ -25023,11 +25036,11 @@ function extractToolCallCommand(rawInput, title) {
 }
 var TOOL_CALL_CONTENT_MAX_CHARS = 8e3;
 var TOOL_CALL_CONTENT_TRUNCATION_MARKER = "[Earlier output truncated]\n\n";
-function boundToolCallOutputText(text) {
-  if (text.length <= TOOL_CALL_CONTENT_MAX_CHARS) {
-    return text;
+function boundToolCallOutputText(text2) {
+  if (text2.length <= TOOL_CALL_CONTENT_MAX_CHARS) {
+    return text2;
   }
-  const tail = text.slice(text.length - TOOL_CALL_CONTENT_MAX_CHARS);
+  const tail = text2.slice(text2.length - TOOL_CALL_CONTENT_MAX_CHARS);
   return `${TOOL_CALL_CONTENT_TRUNCATION_MARKER}${tail}`;
 }
 var RAW_OUTPUT_TEXT_FIELDS = ["content", "stdout", "stderr", "output"];
@@ -25059,9 +25072,9 @@ function extractTextContentFromToolCallContent(content) {
   const typed = content;
   const chunks = [];
   for (const entry of typed) {
-    const text = toolCallContentText(entry)?.trim();
-    if (text) {
-      chunks.push(text);
+    const text2 = toolCallContentText(entry)?.trim();
+    if (text2) {
+      chunks.push(text2);
     }
   }
   if (chunks.length === 0) {
@@ -25239,8 +25252,15 @@ function boundToolCallRawPayload(params, update, toolCall) {
 function readAcpText(source, key) {
   const value = source?.[key];
   if (typeof value !== "string") return void 0;
-  const trimmed2 = value.trim();
-  return trimmed2.length > 0 ? trimmed2 : void 0;
+  const trimmed3 = value.trim();
+  return trimmed3.length > 0 ? trimmed3 : void 0;
+}
+function textFromContentBlocks(blocks) {
+  const parts = blocks.flatMap(
+    (block) => isRecord5(block) && block["type"] === "text" && typeof block["text"] === "string" ? [block["text"]] : []
+  );
+  const joined = parts.join("");
+  return joined.trim().length > 0 ? joined : void 0;
 }
 function parseSessionUpdateEvent(params) {
   const upd = params.update;
@@ -25305,11 +25325,11 @@ function parseSessionUpdateEvent(params) {
       const contentType = content?.["type"];
       const streamKind = kind === "agent_thought_chunk" ? "reasoning_text" : "assistant_text";
       if (contentType === "text") {
-        const text = typeof content?.["text"] === "string" ? content["text"] : "";
-        if (text.length > 0) {
+        const text2 = typeof content?.["text"] === "string" ? content["text"] : "";
+        if (text2.length > 0) {
           events.push({
             _tag: "ContentDelta",
-            text,
+            text: text2,
             streamKind,
             rawPayload: params
           });
@@ -25325,6 +25345,28 @@ function parseSessionUpdateEvent(params) {
       }
       break;
     }
+    case "compaction_update": {
+      const compactionId = readAcpText(upd, "compactionId");
+      const status = readAcpText(upd, "status");
+      if (compactionId === void 0 || status === void 0) break;
+      const rawSummary = upd["summary"];
+      events.push({
+        _tag: "CompactionUpdated",
+        compactionId,
+        status,
+        summary: rawSummary === void 0 ? void 0 : Array.isArray(rawSummary) ? textFromContentBlocks(rawSummary) ?? null : null,
+        error: readAcpText(upd, "error")
+      });
+      break;
+    }
+    case "compaction_summary_chunk": {
+      const compactionId = readAcpText(upd, "compactionId");
+      const content = isRecord5(upd["content"]) ? upd["content"] : void 0;
+      const text2 = content?.["type"] === "text" ? content["text"] : void 0;
+      if (compactionId === void 0 || typeof text2 !== "string" || text2.length === 0) break;
+      events.push({ _tag: "CompactionSummaryChunk", compactionId, text: text2 });
+      break;
+    }
     default:
       break;
   }
@@ -25421,6 +25463,97 @@ function createAcpExecutor(options) {
     if (settledPromptKeys.length > SETTLED_PROMPT_KEY_LIMIT) settledPromptKeys.shift();
   };
   const toolCalls = /* @__PURE__ */ new Map();
+  const compactions = /* @__PURE__ */ new Map();
+  let manualCompaction;
+  const COMPACTION_SUMMARY_MAX_CHARS = 8e3;
+  const nowMs = () => options.nowMs?.() ?? Date.now();
+  const emitCompactionState = (record3, state) => {
+    const summary = record3.summary?.trim() ?? "";
+    const truncated = summary.length > COMPACTION_SUMMARY_MAX_CHARS;
+    emit({
+      type: "thread.state.changed",
+      ...stamp(),
+      provider: options.provider,
+      threadId: options.threadId,
+      ...activeTurnId !== void 0 ? { turnId: activeTurnId } : {},
+      payload: {
+        state,
+        compaction: {
+          compactionId: record3.snapshotId,
+          trigger: record3.trigger,
+          ...state === "compacted" ? { durationMs: Math.max(0, nowMs() - record3.startedAtMs) } : {},
+          ...summary.length > 0 ? {
+            summary: truncated ? summary.slice(0, COMPACTION_SUMMARY_MAX_CHARS) : summary,
+            ...truncated ? { summaryTruncated: true } : {}
+          } : {}
+        }
+      }
+    });
+  };
+  const applyCompactionUpdate = (event) => {
+    let record3 = compactions.get(event.compactionId);
+    if (record3 === void 0) {
+      if (manualCompaction !== void 0 && !manualCompaction.adopted) {
+        manualCompaction.adopted = true;
+        record3 = manualCompaction;
+      } else {
+        record3 = {
+          snapshotId: randomId(),
+          trigger: "automatic",
+          startedAtMs: nowMs(),
+          summary: void 0,
+          announced: false,
+          finished: false,
+          adopted: false
+        };
+      }
+      compactions.set(event.compactionId, record3);
+    }
+    if (event.summary !== void 0) record3.summary = event.summary ?? void 0;
+    switch (event.status) {
+      case "in_progress":
+        if (!record3.announced) {
+          record3.announced = true;
+          emitCompactionState(record3, "compacting");
+        }
+        return;
+      case "completed":
+        record3.announced = true;
+        record3.finished = true;
+        compactions.delete(event.compactionId);
+        emitCompactionState(record3, "compacted");
+        return;
+      case "failed":
+      case "cancelled":
+        record3.finished = true;
+        compactions.delete(event.compactionId);
+        emit({
+          type: "runtime.warning",
+          ...stamp(),
+          provider: options.provider,
+          threadId: options.threadId,
+          ...activeTurnId !== void 0 ? { turnId: activeTurnId } : {},
+          payload: {
+            message: event.error ?? `Context compaction ${event.status}`,
+            detail: { code: `context-compaction-${event.status}` }
+          }
+        });
+        return;
+      default:
+        return;
+    }
+  };
+  const shownToolCallIds = /* @__PURE__ */ new Set();
+  const SHOWN_TOOL_CALL_LIMIT = 256;
+  const rememberShownToolCall = (toolCallId) => {
+    shownToolCallIds.add(toolCallId);
+    if (shownToolCallIds.size <= SHOWN_TOOL_CALL_LIMIT) return;
+    for (const id of shownToolCallIds) {
+      if (toolCalls.has(id)) continue;
+      shownToolCallIds.delete(id);
+      return;
+    }
+  };
   let assistantSegment = { nextSegmentIndex: 0 };
   let modeState;
   let availableCommands = [];
@@ -25507,7 +25640,6 @@ function createAcpExecutor(options) {
     }
     for (const event of parsed.events) {
       if (event._tag === "ToolCallUpdated") {
-        closeActiveAssistantSegment(activeTurnId);
         const tracked = toolCalls.get(event.toolCall.toolCallId);
         const previous = tracked?.state;
         const nextToolCall = mergeToolCallState(previous, event.toolCall);
@@ -25526,9 +25658,35 @@ function createAcpExecutor(options) {
             skippedSinceEmit: decision.skippedSinceEmit
           });
         }
-        if (!decision.emit) {
+        const hookResult = hooks.onToolCallUpdated?.({
+          toolCallId: nextToolCall.toolCallId,
+          status: nextToolCall.status,
+          title: nextToolCall.title,
+          kind: nextToolCall.kind,
+          rawInput: nextToolCall.data["rawInput"],
+          rawOutput: nextToolCall.data["rawOutput"],
+          meta: params.update._meta,
+          turnId: activeTurnId
+        });
+        const taskEvents = hookResult === void 0 ? [] : "events" in hookResult ? hookResult.events : hookResult;
+        const handledByHook = hookResult !== void 0 && "events" in hookResult && hookResult.handled === true;
+        for (const taskEvent of taskEvents) {
+          emit({
+            type: taskEvent.type,
+            ...stamp(),
+            provider: options.provider,
+            threadId: options.threadId,
+            ...taskEvent.turnId !== void 0 ? { turnId: taskEvent.turnId } : {},
+            payload: taskEvent.payload
+          });
+        }
+        if (handledByHook || !decision.emit) {
           continue;
         }
+        if (!shownToolCallIds.has(nextToolCall.toolCallId)) {
+          rememberShownToolCall(nextToolCall.toolCallId);
+          closeActiveAssistantSegment(activeTurnId);
+        }
         emit(
           makeAcpToolCallEvent({
             stamp: stamp(),
@@ -25541,7 +25699,21 @@ function createAcpExecutor(options) {
         );
         continue;
       }
+      if (event._tag === "CompactionUpdated") {
+        applyCompactionUpdate(event);
+        continue;
+      }
+      if (event._tag === "CompactionSummaryChunk") {
+        const record3 = compactions.get(event.compactionId);
+        if (record3 !== void 0 && !record3.finished) {
+          record3.summary = (record3.summary ?? "") + event.text;
+        }
+        continue;
+      }
       if (event._tag === "ContentDelta") {
+        if (manualCompaction !== void 0) {
+          continue;
+        }
         if (event.streamKind === "reasoning_text") {
           if (event.text.trim().length === 0) {
             continue;
@@ -25784,7 +25956,9 @@ function createAcpExecutor(options) {
     },
     onNotification: (notification) => {
       if (notification.method === "session/update") {
-        handleSessionUpdate(notification.params);
+        const params = notification.params;
+        const transformed = hooks.transformSessionUpdate ? hooks.transformSessionUpdate(params) : params;
+        if (transformed !== void 0) handleSessionUpdate(transformed);
         return;
       }
       if (settleFromNotification(notification.method, notification.params)) return;
@@ -25918,13 +26092,15 @@ function createAcpExecutor(options) {
       options.mcpServers ?? [],
       initialized.agentCapabilities
     );
+    const additionalDirectories = options.additionalDirectories !== void 0 && options.additionalDirectories.length > 0 ? { additionalDirectories: options.additionalDirectories } : {};
     let setup;
     let nextSessionId;
     if (options.resumeSessionId && options.resumeMethod === "session/resume") {
       setup = await connection.request("session/resume", {
         sessionId: options.resumeSessionId,
         cwd: options.cwd,
-        mcpServers
+        mcpServers,
+        ...additionalDirectories
       });
       nextSessionId = options.resumeSessionId;
     } else if (options.resumeSessionId) {
@@ -25933,7 +26109,8 @@ function createAcpExecutor(options) {
         setup = await connection.request("session/load", {
           sessionId: options.resumeSessionId,
           cwd: options.cwd,
-          mcpServers
+          mcpServers,
+          ...additionalDirectories
         });
       } finally {
         sessionLoadInFlight = false;
@@ -25946,7 +26123,8 @@ function createAcpExecutor(options) {
     } else {
       const created = await connection.request("session/new", {
         cwd: options.cwd,
-        mcpServers
+        mcpServers,
+        ...additionalDirectories
       });
       nextSessionId = created.sessionId;
       setup = created;
@@ -26020,13 +26198,13 @@ function createAcpExecutor(options) {
         startInFlight = void 0;
         return result;
       },
-      (error62) => {
+      async (error62) => {
         startInFlight = void 0;
         if (isLive(expectedGeneration) && !startResult) {
           status = "idle";
           generation = expectedGeneration;
         }
-        throw error62;
+        throw await withStartupStderr(error62, options.stderrTail);
       }
     );
     return startInFlight;
@@ -26094,6 +26272,36 @@ function createAcpExecutor(options) {
       interruptedTurnIds.delete(input2.turnId);
     }
   };
+  const sendPromptRpc = async (sessionId2, promptParts) => {
+    const settlementHooks = hooks.promptSettlement;
+    const promptKey = settlementHooks === void 0 ? void 0 : randomId();
+    const promptRpc = connection.request("session/prompt", {
+      sessionId: sessionId2,
+      prompt: promptParts,
+      ...settlementHooks !== void 0 && promptKey !== void 0 ? settlementHooks.requestFields(promptKey) : {}
+    });
+    if (settlementHooks === void 0 || promptKey === void 0) {
+      return await promptRpc;
+    } else {
+      const { promise: early, resolve: settleEarly } = Promise.withResolvers();
+      pendingSettlement = { promptKey, sessionId: sessionId2, settle: settleEarly };
+      try {
+        const outcome = await Promise.race([
+          promptRpc.then((value) => {
+            const key = settlementHooks.responseKey?.(value);
+            if (key !== void 0) rememberSettledPromptKey(key);
+            return { response: value };
+          }),
+          early
+        ]);
+        if (outcome.error !== void 0) throw outcome.error;
+        return outcome.response;
+      } finally {
+        pendingSettlement = void 0;
+        void promptRpc.catch(() => void 0);
+      }
+    }
+  };
   const prompt = async (input2) => {
     failIfDisposed();
     const started = requireStarted();
@@ -26144,35 +26352,8 @@ function createAcpExecutor(options) {
         expectedGeneration: started.generation
       });
       closeActiveAssistantSegment(turnId);
-      const settlementHooks = hooks.promptSettlement;
-      const promptKey = settlementHooks === void 0 ? void 0 : randomId();
-      const promptRpc = connection.request("session/prompt", {
-        sessionId: started.sessionId,
-        prompt: promptParts,
-        ...settlementHooks !== void 0 && promptKey !== void 0 ? settlementHooks.requestFields(promptKey) : {}
-      });
       try {
-        if (settlementHooks === void 0 || promptKey === void 0) {
-          response = await promptRpc;
-        } else {
-          const { promise: early, resolve: settleEarly } = Promise.withResolvers();
-          pendingSettlement = { promptKey, sessionId: started.sessionId, settle: settleEarly };
-          try {
-            const outcome = await Promise.race([
-              promptRpc.then((value) => {
-                const key = settlementHooks.responseKey?.(value);
-                if (key !== void 0) rememberSettledPromptKey(key);
-                return { response: value };
-              }),
-              early
-            ]);
-            if (outcome.error !== void 0) throw outcome.error;
-            response = outcome.response;
-          } finally {
-            pendingSettlement = void 0;
-            void promptRpc.catch(() => void 0);
-          }
-        }
+        response = await sendPromptRpc(started.sessionId, promptParts);
       } catch (error62) {
         if (disposed) {
           throw new AcpExecutorDisposedError();
@@ -26336,6 +26517,74 @@ function createAcpExecutor(options) {
     };
     apply();
   };
+  const compact = async (input2) => {
+    failIfDisposed();
+    const started = requireStarted();
+    const trimmedName = input2.commandName.trim();
+    const commandName = trimmedName.startsWith("/") ? trimmedName.slice(1) : trimmedName;
+    if (!availableCommands.some((command) => command.name === commandName)) {
+      throw new AcpExecutorError(
+        "command-unavailable",
+        `The agent has not advertised the /${commandName} command`
+      );
+    }
+    if (promptsInFlight > 0 || promptMutex.isLocked || manualCompaction !== void 0) {
+      throw new AcpExecutorError(
+        "busy",
+        "Cannot compact while a turn or another compaction is running"
+      );
+    }
+    const record3 = {
+      snapshotId: randomId(),
+      trigger: "manual",
+      startedAtMs: nowMs(),
+      summary: void 0,
+      announced: true,
+      finished: false,
+      adopted: false
+    };
+    await promptMutex.acquire();
+    manualCompaction = record3;
+    const emitSessionState = (state) => {
+      emit({
+        type: "session.state.changed",
+        ...stamp(),
+        provider: options.provider,
+        threadId: options.threadId,
+        payload: { state, reason: "compaction" }
+      });
+    };
+    try {
+      failIfDisposed();
+      emitSessionState("compacting");
+      emitCompactionState(record3, "compacting");
+      let response;
+      try {
+        response = await sendPromptRpc(started.sessionId, [
+          { type: "text", text: `/${commandName}` }
+        ]);
+      } catch (error62) {
+        if (disposed) throw new AcpExecutorDisposedError();
+        throw error62;
+      }
+      await connection.awaitInboundIdle();
+      if (response.stopReason === "cancelled") {
+        return;
+      }
+      if (!record3.finished) {
+        record3.finished = true;
+        emitCompactionState(record3, "compacted");
+      }
+    } finally {
+      for (const [agentId, tracked] of compactions) {
+        if (tracked === record3) compactions.delete(agentId);
+      }
+      manualCompaction = void 0;
+      promptMutex.release();
+      notifyPromptSettled();
+      if (!disposed) emitSessionState("ready");
+    }
+  };
   const setNativeMode = async (modeId) => {
     failIfDisposed();
     const started = startResult;
@@ -26423,6 +26672,7 @@ function createAcpExecutor(options) {
     respondToRequest,
     respondToUserInput,
     setNativeMode,
+    compact,
     dispose
   };
 }
@@ -26498,13 +26748,13 @@ function parseCliVersion(output2) {
 }
 async function collectCappedText(stream, maxBytes) {
   const decoder = new TextDecoder();
-  let text = "";
+  let text2 = "";
   let total = 0;
   for await (const chunk of stream) {
     total += chunk.byteLength;
-    if (total <= maxBytes) text += decoder.decode(chunk, { stream: true });
+    if (total <= maxBytes) text2 += decoder.decode(chunk, { stream: true });
   }
-  return { text: text + decoder.decode(), overflowed: total > maxBytes };
+  return { text: text2 + decoder.decode(), overflowed: total > maxBytes };
 }
 async function collectProbeProcess(child, input2) {
   try {
@@ -26645,11 +26895,11 @@ import * as NodeFS from "node:fs";
 import * as NodePath from "node:path";
 var AUTH_FILE_NAME = "auth.json";
 var isRecord7 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-var readString2 = (record2, key) => {
-  const value = record2[key];
+var readString2 = (record3, key) => {
+  const value = record3[key];
   if (typeof value !== "string") return void 0;
-  const trimmed2 = value.trim();
-  return trimmed2.length > 0 ? trimmed2 : void 0;
+  const trimmed3 = value.trim();
+  return trimmed3.length > 0 ? trimmed3 : void 0;
 };
 var parseJsonRecord = (raw) => {
   let parsed;
@@ -26688,9 +26938,9 @@ var unreadableProbe = (exists) => ({
   name: void 0,
   expiresAt: void 0
 });
-var joinName = (record2) => {
-  const first = readString2(record2, "first_name");
-  const last = readString2(record2, "last_name");
+var joinName = (record3) => {
+  const first = readString2(record3, "first_name");
+  const last = readString2(record3, "last_name");
   const joined = [first, last].filter((part) => part !== void 0).join(" ");
   return joined.length > 0 ? joined : void 0;
 };
@@ -26725,13 +26975,176 @@ var readGrokAccount = (homePath) => {
   };
 };
 
-// src/grokSupport.ts
-import { modelSelectionStringOption } from "@ycodium-ai/plugin-api/executor";
+// src/grokPlanGate.ts
+var XAI_EXIT_PLAN_MODE_METHODS = [
+  "_x.ai/exit_plan_mode",
+  "x.ai/exit_plan_mode"
+];
+var GROK_PLAN_APPROVE_OPTION_ID = "approved";
+var GROK_PLAN_ABANDON_OPTION_ID = "abandoned";
+var GROK_EMPTY_PLAN_TEXT = "The agent exited plan mode without writing a plan.";
 var isRecord8 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var trimmed = (value) => {
   if (typeof value !== "string") return void 0;
-  const text = value.trim();
-  return text.length > 0 ? text : void 0;
+  const text2 = value.trim();
+  return text2.length > 0 ? text2 : void 0;
+};
+function parseXAiExitPlanModeParams(params) {
+  const candidates = [params, ...isRecord8(params) ? [params["params"]] : []];
+  for (const candidate of candidates) {
+    if (!isRecord8(candidate)) continue;
+    const toolCallId = trimmed(candidate["toolCallId"]);
+    if (toolCallId === void 0) continue;
+    return { toolCallId, planContent: trimmed(candidate["planContent"]) };
+  }
+  return void 0;
+}
+function grokPlanQuestion(params) {
+  return {
+    id: params.toolCallId,
+    header: "Plan",
+    question: params.planContent ?? GROK_EMPTY_PLAN_TEXT,
+    kind: "plan",
+    allowFreeform: true,
+    multiSelect: false,
+    // 选项只给语义：用户读到的文案由宿主按界面语言渲染，label 仅是协议要求非空的稳定值。
+    options: [
+      {
+        id: GROK_PLAN_APPROVE_OPTION_ID,
+        label: GROK_PLAN_APPROVE_OPTION_ID,
+        description: "",
+        planAction: "approve"
+      },
+      {
+        id: GROK_PLAN_ABANDON_OPTION_ID,
+        label: GROK_PLAN_ABANDON_OPTION_ID,
+        description: "",
+        planAction: "stop"
+      }
+    ]
+  };
+}
+var ABANDONED_FEEDBACK = "The user chose not to continue with this plan. Stop here and wait for their next message.";
+var abandoned = () => ({
+  outcome: "abandoned",
+  feedback: ABANDONED_FEEDBACK
+});
+function makeXAiExitPlanModeResponse(params, resolution) {
+  if (resolution.kind === "cancelled") return abandoned();
+  const answer = resolution.answers[params.toolCallId];
+  const selected = typeof answer === "string" ? answer : Array.isArray(answer) && answer.length === 1 && typeof answer[0] === "string" ? answer[0] : void 0;
+  const text2 = trimmed(selected);
+  if (text2 === void 0) return abandoned();
+  if (text2 === GROK_PLAN_APPROVE_OPTION_ID) return { outcome: "approved" };
+  if (text2 === GROK_PLAN_ABANDON_OPTION_ID) return abandoned();
+  return { outcome: "request_changes", feedback: text2 };
+}
+
+// src/grokBackgroundTasks.ts
+var record2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+var text = (value) => typeof value === "string" ? value.trim() || void 0 : void 0;
+var lifecycle = (status, exitCode) => {
+  switch (text(status)?.toLowerCase()) {
+    case "pending":
+    case "running":
+      return "running";
+    case "completed":
+    case "success":
+    case "succeeded":
+      return "completed";
+    case "failed":
+    case "error":
+      return "failed";
+    case "stopped":
+    case "killed":
+    case "cancelled":
+      return "stopped";
+    default:
+      return typeof exitCode === "number" && Number.isFinite(exitCode) ? exitCode === 0 ? "completed" : "failed" : void 0;
+  }
+};
+function buildGrokBackgroundTaskEvents(input2) {
+  const { tasks, toolCallId, toolCallStatus, turnId } = input2;
+  const output2 = record2(input2.rawOutput);
+  const events = [];
+  if (toolCallStatus !== "completed" && toolCallStatus !== "failed" && output2["type"] !== "BackgroundTaskStarted") {
+    return events;
+  }
+  const attribution = (task) => task.turnId !== void 0 && task.turnId === turnId ? { turnId } : {};
+  const start = (id, taskType, description, toolUseId) => {
+    const known = tasks.get(id);
+    if (known) return known;
+    const task = {
+      payload: {
+        taskId: id,
+        taskType,
+        description,
+        title: description,
+        ...toolUseId ? { toolUseId } : {}
+      },
+      // 轮询可能重新发现老任务，那时并不知道它是哪一轮起的。
+      turnId: toolUseId ? turnId : void 0
+    };
+    tasks.set(id, task);
+    events.push({ type: "task.started", payload: task.payload, ...attribution(task) });
+    return task;
+  };
+  const complete = (task, status, summary) => {
+    tasks.delete(task.payload.taskId);
+    events.push({
+      type: "task.completed",
+      payload: { ...task.payload, status, ...summary ? { summary } : {} },
+      ...attribution(task)
+    });
+  };
+  if (output2["type"] === "Monitor" && toolCallStatus === "completed") {
+    const id = text(output2["taskId"]);
+    if (id) {
+      start(id, "monitor", text(record2(input2.rawInput)["description"]) ?? "Monitor", toolCallId);
+    }
+  } else if (output2["type"] === "BackgroundTaskStarted") {
+    const id = text(output2["task_id"]) ?? text(output2["taskId"]);
+    const command = text(output2["command"]);
+    if (id && command) start(id, "shell", command.split("\n")[0].slice(0, 200), toolCallId);
+  } else if (output2["type"] === "TaskOutput" || output2["type"] === "KillTask") {
+    const results = record2(output2["MultiResult"])["results"];
+    for (const value of Array.isArray(results) ? results : [output2["Result"]]) {
+      const result = record2(value);
+      const id = text(result["task_id"]);
+      if (!id) continue;
+      if (output2["type"] === "KillTask") {
+        const task2 = tasks.get(id);
+        if (task2 && toolCallStatus === "completed" && result["outcome"] === "killed") {
+          complete(task2, "stopped");
+        }
+        continue;
+      }
+      const command = text(result["command"]);
+      const status = lifecycle(result["status"], result["exit_code"]);
+      if (!command || !status || command.startsWith("[subagent:")) continue;
+      const task = start(id, /^\[monitor[:\]]/.test(command) ? "monitor" : "shell", command);
+      const summary = text(result["output"])?.split("\n").find((line) => line.trim())?.trim();
+      if (status === "running") {
+        events.push({
+          type: "task.progress",
+          payload: { ...task.payload, ...summary ? { summary } : {} },
+          ...attribution(task)
+        });
+      } else {
+        complete(task, status, summary);
+      }
+    }
+  }
+  return events;
+}
+
+// src/grokSupport.ts
+import { modelSelectionStringOption } from "@ycodium-ai/plugin-api/executor";
+var isRecord9 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var trimmed2 = (value) => {
+  if (typeof value !== "string") return void 0;
+  const text2 = value.trim();
+  return text2.length > 0 ? text2 : void 0;
 };
 function grokReasoningEffortArgs(effort) {
   const value = effort?.trim();
@@ -26842,45 +27255,45 @@ function grokRuntimeModeCaveat(nativeModeId) {
 }
 var GROK_REASONING_OPTION_ID = "reasoningEffort";
 function resolveGrokAuthMethodId(initializeResult) {
-  const authMethods = isRecord8(initializeResult) ? initializeResult["authMethods"] : void 0;
+  const authMethods = isRecord9(initializeResult) ? initializeResult["authMethods"] : void 0;
   if (!Array.isArray(authMethods)) return void 0;
   for (const method of authMethods) {
-    if (isRecord8(method) && method["id"] === "cached_token") return "cached_token";
+    if (isRecord9(method) && method["id"] === "cached_token") return "cached_token";
   }
   return void 0;
 }
 var positive = (value) => typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.trunc(value) : void 0;
 function grokPromptUsage(promptResponse) {
-  if (!isRecord8(promptResponse)) return void 0;
+  if (!isRecord9(promptResponse)) return void 0;
   const meta3 = promptResponse["_meta"];
-  if (!isRecord8(meta3)) return void 0;
+  if (!isRecord9(meta3)) return void 0;
   const usedTokens = positive(meta3["totalTokens"]);
   if (usedTokens === void 0) return void 0;
-  return { usedTokens, modelId: trimmed(meta3["modelId"]) };
+  return { usedTokens, modelId: trimmed2(meta3["modelId"]) };
 }
 function grokModelState(initializeResult) {
-  if (!isRecord8(initializeResult)) return void 0;
+  if (!isRecord9(initializeResult)) return void 0;
   const meta3 = initializeResult["_meta"];
-  if (!isRecord8(meta3)) return void 0;
+  if (!isRecord9(meta3)) return void 0;
   const modelState = meta3["modelState"];
-  if (!isRecord8(modelState)) return void 0;
+  if (!isRecord9(modelState)) return void 0;
   const availableModels = modelState["availableModels"];
   if (!Array.isArray(availableModels)) return void 0;
-  return { currentModelId: trimmed(modelState["currentModelId"]), availableModels };
+  return { currentModelId: trimmed2(modelState["currentModelId"]), availableModels };
 }
 function grokAdvertisedModels(initializeResult) {
   const state = grokModelState(initializeResult);
   if (state === void 0) return [];
   const models = [];
   for (const entry of state.availableModels) {
-    if (!isRecord8(entry)) continue;
-    const modelId = trimmed(entry["modelId"]);
+    if (!isRecord9(entry)) continue;
+    const modelId = trimmed2(entry["modelId"]);
     if (modelId === void 0) continue;
     const modelMeta = entry["_meta"];
-    const contextWindow = isRecord8(modelMeta) ? positive(modelMeta["totalContextTokens"]) : void 0;
+    const contextWindow = isRecord9(modelMeta) ? positive(modelMeta["totalContextTokens"]) : void 0;
     models.push({
       modelId,
-      name: trimmed(entry["name"]),
+      name: trimmed2(entry["name"]),
       isDefault: state.currentModelId !== void 0 && modelId === state.currentModelId,
       contextWindow
     });
@@ -26892,7 +27305,7 @@ var XAI_ASK_USER_QUESTION_METHODS = [
   "x.ai/ask_user_question"
 ];
 var readOption = (value) => {
-  if (!isRecord8(value)) return void 0;
+  if (!isRecord9(value)) return void 0;
   const label = typeof value["label"] === "string" ? value["label"] : void 0;
   if (label === void 0) return void 0;
   return {
@@ -26903,7 +27316,7 @@ var readOption = (value) => {
   };
 };
 var readQuestion = (value) => {
-  if (!isRecord8(value)) return void 0;
+  if (!isRecord9(value)) return void 0;
   const question = typeof value["question"] === "string" ? value["question"] : void 0;
   if (question === void 0) return void 0;
   const optionsRaw = value["options"];
@@ -26919,9 +27332,9 @@ var readQuestion = (value) => {
   };
 };
 function parseXAiAskUserQuestionParams(params) {
-  const candidates = [params, ...isRecord8(params) ? [params["params"]] : []];
+  const candidates = [params, ...isRecord9(params) ? [params["params"]] : []];
   for (const candidate of candidates) {
-    if (!isRecord8(candidate)) continue;
+    if (!isRecord9(candidate)) continue;
     const questionsRaw = candidate["questions"];
     if (!Array.isArray(questionsRaw)) continue;
     const questions = questionsRaw.flatMap((entry) => {
@@ -26947,12 +27360,12 @@ function extractXAiAskUserQuestions(params) {
 var answerValues = (answer) => {
   if (Array.isArray(answer)) {
     return answer.flatMap((entry) => {
-      const text2 = trimmed(entry);
-      return text2 === void 0 ? [] : [text2];
+      const text3 = trimmed2(entry);
+      return text3 === void 0 ? [] : [text3];
     });
   }
-  const text = trimmed(answer);
-  return text === void 0 ? [] : [text];
+  const text2 = trimmed2(answer);
+  return text2 === void 0 ? [] : [text2];
 };
 function makeXAiAskUserQuestionResponse(params, answers) {
   const normalized = params.questions.flatMap((question) => {
@@ -26963,7 +27376,7 @@ function makeXAiAskUserQuestionResponse(params, answers) {
     const resolved = values.map((value) => ({ value, option: optionByLabel.get(value) }));
     const selectedLabels = resolved.flatMap(({ option }) => option ? [option.label] : []);
     const notes = resolved.flatMap(({ option, value }) => option ? [] : [value]);
-    const preview = question.multiSelect ? void 0 : resolved.map(({ option }) => trimmed(option?.preview)).find((value) => value);
+    const preview = question.multiSelect ? void 0 : resolved.map(({ option }) => trimmed2(option?.preview)).find((value) => value);
     const annotation = preview !== void 0 || notes.length > 0 ? {
       ...preview !== void 0 ? { preview } : {},
       ...notes.length > 0 ? { notes: notes.join("\n") } : {}
@@ -26993,34 +27406,99 @@ function makeXAiAskUserQuestionCancelledResponse() {
   return { outcome: "cancelled" };
 }
 var XAI_PROMPT_COMPLETE_METHOD = "_x.ai/session/prompt_complete";
+var GROK_RATE_LIMIT_MESSAGE = "Grok usage limit reached or rate limited. Try again later.";
+var grokAgentResultMessage = (value) => {
+  if (typeof value === "string") return trimmed2(value);
+  return isRecord9(value) ? trimmed2(value["message"]) : void 0;
+};
 var grokPromptSettlement = {
   // 关联 id 双写 promptId 与 requestId（宿主 XAiAcpExtension 同款）：
   // agent 认回哪个键是它的事，两个都给才不猜版本。
   requestFields: (promptKey) => ({ _meta: { promptId: promptKey, requestId: promptKey } }),
   responseKey: (response) => {
-    if (!isRecord8(response)) return void 0;
+    if (!isRecord9(response)) return void 0;
     const meta3 = response["_meta"];
-    if (!isRecord8(meta3)) return void 0;
-    return trimmed(meta3["promptId"]) ?? trimmed(meta3["requestId"]);
+    if (!isRecord9(meta3)) return void 0;
+    return trimmed2(meta3["promptId"]) ?? trimmed2(meta3["requestId"]);
   },
   fromNotification: (method, params) => {
     if (method !== XAI_PROMPT_COMPLETE_METHOD) return void 0;
-    if (!isRecord8(params)) return void 0;
+    if (!isRecord9(params)) return void 0;
     const sessionId = params["sessionId"];
     if (typeof sessionId !== "string") return void 0;
-    const stopReason = trimmed(params["stopReason"]);
+    const stopReason = trimmed2(params["stopReason"]);
+    const failed = stopReason === "error" || stopReason === "rate_limit";
+    const detail = stopReason === "rate_limit" ? GROK_RATE_LIMIT_MESSAGE : grokAgentResultMessage(params["agentResult"]);
     return {
       sessionId,
       ...typeof params["promptId"] === "string" ? { promptKey: params["promptId"] } : {},
-      outcome: stopReason === "error" ? "error" : "completed",
+      outcome: failed ? "error" : "completed",
       ...stopReason === void 0 ? {} : { stopReason },
-      ...typeof params["agentResult"] === "string" ? { detail: params["agentResult"] } : {}
+      ...detail === void 0 ? {} : { detail }
     };
   }
 };
 
+// src/grokSkills.ts
+import * as NodeOS from "node:os";
+var INSPECT_TIMEOUT_MS = 15e3;
+var MAX_INSPECT_OUTPUT_BYTES = 4 * 1024 * 1024;
+var GROK_INSPECT_ARGS = ["inspect", "--json"];
+var isRecord10 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var trimmedString = (value) => typeof value === "string" ? value.trim() : "";
+function parseGrokInspectSkills(stdout) {
+  let parsed;
+  try {
+    parsed = JSON.parse(stdout);
+  } catch {
+    return [];
+  }
+  const entries = isRecord10(parsed) ? parsed["skills"] : void 0;
+  if (!Array.isArray(entries)) return [];
+  const byName = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    if (!isRecord10(entry)) continue;
+    const name = trimmedString(entry["name"]);
+    const source = isRecord10(entry["source"]) ? entry["source"] : void 0;
+    const path = trimmedString(source?.["path"]);
+    if (name.length === 0 || path.length === 0) continue;
+    const scope = trimmedString(source?.["type"]);
+    const description = trimmedString(entry["description"]);
+    byName.set(name, {
+      name,
+      path,
+      enabled: entry["userInvocable"] !== false,
+      ...scope.length > 0 ? { scope } : {},
+      ...description.length > 0 ? { description } : {}
+    });
+  }
+  return [...byName.values()].toSorted((left, right) => left.name.localeCompare(right.name));
+}
+async function probeGrokSkills(input2) {
+  const { recipe, host, env } = input2;
+  try {
+    const handle = await host.process.spawn({
+      program: recipe.binaryPath,
+      args: GROK_INSPECT_ARGS,
+      cwd: NodeOS.homedir(),
+      owner: { bindingId: host.bindingId },
+      ...Object.keys(env).length > 0 ? { env } : {}
+    });
+    const run = await collectProbeProcess(handle, {
+      timeoutMs: INSPECT_TIMEOUT_MS,
+      maxOutputBytes: MAX_INSPECT_OUTPUT_BYTES,
+      what: "grok inspect"
+    });
+    if (run.exitCode !== 0 || run.stdout === void 0) return [];
+    return parseGrokInspectSkills(run.stdout);
+  } catch {
+    return [];
+  }
+}
+
 // src/probeModels.ts
 import {
+  describeExecutorSpawnFailure,
   ExecutorSpawnRefusedError
 } from "@ycodium-ai/plugin-api/executor";
 import { nodeStreamsFromHandle } from "@ycodium-ai/plugin-api/process-stdin";
@@ -27048,7 +27526,7 @@ async function probeGrokModels(input2) {
     });
   } catch (error62) {
     if (error62 instanceof ExecutorSpawnRefusedError) throw error62;
-    return { kind: "not-started", detail: failureDetail(error62) };
+    return { kind: "not-started", ...describeExecutorSpawnFailure(error62) };
   }
   let handshake;
   try {
@@ -27123,16 +27601,16 @@ var deviceCodeUrl = (output2) => DEVICE_CODE_URL.exec(output2)?.[0];
 var deviceCodeValue = (output2) => DEVICE_CODE_VALUE.exec(output2)?.[1];
 var hasDeviceCode = (output2) => deviceCodeUrl(output2) !== void 0 && deviceCodeValue(output2) !== void 0;
 function expandHomePath(value) {
-  if (value === "~") return NodeOS.homedir();
+  if (value === "~") return NodeOS2.homedir();
   if (value.startsWith("~/") || value.startsWith("~\\")) {
-    return NodePath2.join(NodeOS.homedir(), value.slice(2));
+    return NodePath2.join(NodeOS2.homedir(), value.slice(2));
   }
   return value;
 }
 function resolveGrokHomePath(value) {
-  const trimmed2 = value.trim();
-  if (trimmed2.length === 0) return NodePath2.join(NodeOS.homedir(), ".grok");
-  return NodePath2.resolve(expandHomePath(trimmed2));
+  const trimmed3 = value.trim();
+  if (trimmed3.length === 0) return NodePath2.join(NodeOS2.homedir(), ".grok");
+  return NodePath2.resolve(expandHomePath(trimmed3));
 }
 function probeGrokAccount(accountPath) {
   const resolved = resolveGrokHomePath(accountPath);
@@ -27157,7 +27635,7 @@ function resolveAccountHomePath(recipe, configuredHome) {
 }
 function absentPath() {
   return NodePath2.join(
-    NodeOS.tmpdir(),
+    NodeOS2.tmpdir(),
     `ycodium-grok-no-auth-${NodeCrypto2.randomUUID()}`,
     "auth.json"
   );
@@ -27239,7 +27717,7 @@ var createGrokInstance = (config2, host) => {
       return {
         installed: false,
         version: null,
-        readiness: "error",
+        readiness: "not-installed",
         auth: { status: "unknown" },
         detail: "Grok program path is not configured"
       };
@@ -27250,15 +27728,17 @@ var createGrokInstance = (config2, host) => {
       resolveGrokHomePath(configuredHome),
       configuredHome.trim().length > 0
     );
-    const [outcome, version2] = await Promise.all([
+    const [outcome, version2, skills] = await Promise.all([
       probeGrokModels({ recipe, host, env }),
-      probeGrokVersion({ recipe, host, env })
+      probeGrokVersion({ recipe, host, env }),
+      probeGrokSkills({ recipe, host, env })
     ]);
     if (outcome.kind !== "answered") {
       return {
         installed: outcome.kind === "failed",
         version: version2,
-        readiness: "error",
+        // 找不到、路径不存在、不可执行是 not-installed，别的启动失败与握不上手都是 error。
+        readiness: outcome.kind === "not-started" ? outcome.readiness : "error",
         auth: probeAuth(),
         ...outcome.detail === void 0 ? {} : { detail: outcome.detail },
         // 装着但握不上手时，界面照样画权限格。不报档就退回宿主四档，而那四档对这双手
@@ -27272,6 +27752,7 @@ var createGrokInstance = (config2, host) => {
       readiness: "ready",
       auth: probeAuth(),
       ...outcome.models === void 0 ? {} : { models: outcome.models },
+      skills,
       ...GROK_NATIVE_MODE_REPORT
     };
   };
@@ -27315,13 +27796,15 @@ var createGrokInstance = (config2, host) => {
         owner: { bindingId: host.bindingId },
         ...Object.keys(env).length > 0 ? { env } : {}
       });
-      const { readable, writable } = nodeStreamsFromHandle2(handle);
+      const { readable, writable, stderrTail } = nodeStreamsFromHandle2(handle);
       const resume = input2.discardResumeCursor === true ? void 0 : parseAcpResumeCursor(input2.resumeCursor, RESUME_SCHEMA_VERSION);
       const requestedModelId = modelIdFromSelection(input2.modelSelection);
       let initializeResult;
+      const backgroundTasks = /* @__PURE__ */ new Map();
       const executor = createAcpExecutor({
         readable,
         writable,
+        stderrTail,
         cwd,
         threadId: input2.threadId,
         provider: GROK_DRIVER_KIND,
@@ -27333,7 +27816,23 @@ var createGrokInstance = (config2, host) => {
         authMethodId: resolveGrokAuthMethodId,
         hooks: {
           promptSettlement: grokPromptSettlement,
+          onToolCallUpdated: (update) => buildGrokBackgroundTaskEvents({
+            tasks: backgroundTasks,
+            toolCallId: update.toolCallId,
+            rawInput: update.rawInput,
+            rawOutput: update.rawOutput,
+            toolCallStatus: update.status,
+            turnId: update.turnId
+          }),
           onExtensionRequest: async (method, params, ctx) => {
+            if (XAI_EXIT_PLAN_MODE_METHODS.includes(method)) {
+              const plan = parseXAiExitPlanModeParams(params);
+              if (plan === void 0) {
+                throw new Error(`malformed ${method} params`);
+              }
+              const resolution2 = await ctx.askUserInput([grokPlanQuestion(plan)]);
+              return makeXAiExitPlanModeResponse(plan, resolution2);
+            }
             if (!XAI_ASK_USER_QUESTION_METHODS.includes(method)) {
               throw new Error(`unsupported extension method ${method}`);
             }
@@ -27495,6 +27994,15 @@ var createGrokInstance = (config2, host) => {
       const booked = requireThread(threadId);
       await booked.executor.respondToUserInput(requestId, answers);
     },
+    // 原生压缩：让 CLI 执行它自己宣告的 `/compact`。这不是用户消息——执行器不开轮次、
+    // 不把命令吐的文本放进时间线，进度与结果只走压缩生命周期事件。
+    compactContext: async (threadId) => {
+      const booked = requireThread(threadId);
+      if (booked.session.status === "running") {
+        throw new Error("Cannot compact context while a turn is running");
+      }
+      await booked.executor.compact({ commandName: "compact" });
+    },
     stopSession: async (threadId) => {
       const booked = threads.get(threadId);
       if (booked === void 0) return;
@@ -27546,9 +28054,9 @@ var createGrokInstance = (config2, host) => {
         const stdoutText = (async () => {
           const decoder = new TextDecoder();
           for await (const chunk of handle.stdout) {
-            const text = decoder.decode(chunk, { stream: true });
-            collected.push(text);
-            host.log.info("sign-in output", { text });
+            const text2 = decoder.decode(chunk, { stream: true });
+            collected.push(text2);
+            host.log.info("sign-in output", { text: text2 });
             if (onCodeFound !== void 0 && hasDeviceCode(collected.join(""))) {
               onCodeFound();
               onCodeFound = void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/agent-grok",
-  "version": "0.2.2634",
+  "version": "0.2.2664",
   "description": "Grok executor: grok CLI over Agent Client Protocol stdio.",
   "keywords": [
     "ycodium",
@@ -21,9 +21,9 @@
     "@types/node": "24.12.4",
     "esbuild": "0.28.1",
     "vite-plus": "0.2.2",
+    "@ycodium-ai/plugin-api": "0.2.2664",
     "ycodium-executor-testing": "0.0.0",
-    "@ycodium-ai/plugin-api": "0.2.2634",
-    "ycodium-acp-executor": "0.2.2634"
+    "ycodium-acp-executor": "0.2.2664"
   },
   "ycodium": {
     "plugin": "./dist/index.js",