@ycodium-ai/agent-grok 0.2.3710 → 0.2.3766

package/dist/index.js

@@ -6,6 +6,11 @@ var __export = (target, all) => {
 
 // src/index.ts
 import { definePlugin } from "@ycodium-ai/plugin-api";
+import {
+  EXECUTOR_EFFECTIVE_PAYLOAD_SCHEMA,
+  executorHomeEffectiveValue,
+  readExecutorEffectiveRequest
+} from "@ycodium-ai/plugin-api/executor";
 
 // src/card.ts
 var GROK_DRIVER_KIND = "grok";
@@ -23,6 +28,8 @@ var GROK_CARD = {
   // `grokInstance.startSession` 里按用户选择拼。
   launchArgs: "agent stdio",
   homeEnvVar: "GROK_HOME",
+  // 设置表单里留空的格子此刻会用什么，见 index.ts 的同名命令。
+  effectiveCommand: "effectiveConfig",
   // 只有一个账户目录，它同时装着会话历史：换目录，已开的 thread 就接不上这个实例了。
   accountDirectory: {
     configKeys: ["homePath"],
@@ -161,6 +168,166 @@ var GROK_CARD = {
   }
 };
 
+// src/grokHome.ts
+import * as NodeCrypto from "node:crypto";
+import * as NodeOS from "node:os";
+import * as NodePath2 from "node:path";
+import { mergeLaunchEnv } from "@ycodium-ai/plugin-api/executor";
+
+// src/grokAccount.ts
+import * as NodeFS from "node:fs";
+import * as NodePath from "node:path";
+var AUTH_FILE_NAME = "auth.json";
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var readString = (record4, key) => {
+  const value = record4[key];
+  if (typeof value !== "string") return void 0;
+  const trimmed3 = value.trim();
+  return trimmed3.length > 0 ? trimmed3 : void 0;
+};
+var parseJsonRecord = (raw) => {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return void 0;
+  }
+  return isRecord(parsed) ? parsed : void 0;
+};
+var directoryExists = (homePath) => {
+  try {
+    return NodeFS.statSync(homePath).isDirectory();
+  } catch {
+    return false;
+  }
+};
+var readCredentialFile = (path) => {
+  try {
+    return NodeFS.readFileSync(path, "utf8");
+  } catch {
+    return void 0;
+  }
+};
+var signedOutProbe = (exists) => ({
+  state: "signed-out",
+  directoryExists: exists,
+  email: void 0,
+  name: void 0,
+  expiresAt: void 0
+});
+var unreadableProbe = (exists) => ({
+  state: "unreadable",
+  directoryExists: exists,
+  email: void 0,
+  name: void 0,
+  expiresAt: void 0
+});
+var joinName = (record4) => {
+  const first = readString(record4, "first_name");
+  const last = readString(record4, "last_name");
+  const joined = [first, last].filter((part) => part !== void 0).join(" ");
+  return joined.length > 0 ? joined : void 0;
+};
+var findIdentityEntry = (parsed) => {
+  for (const value of Object.values(parsed)) {
+    if (!isRecord(value)) continue;
+    if (readString(value, "email") !== void 0 || readString(value, "user_id") !== void 0) {
+      return value;
+    }
+  }
+  return void 0;
+};
+var isExpired = (expiresAt, nowMs) => {
+  if (expiresAt === void 0) return false;
+  const parsed = Date.parse(expiresAt);
+  return Number.isNaN(parsed) ? false : parsed <= nowMs;
+};
+var readGrokAccount = (homePath) => {
+  const exists = directoryExists(homePath);
+  const raw = readCredentialFile(NodePath.join(homePath, AUTH_FILE_NAME));
+  if (raw === void 0) return signedOutProbe(exists);
+  const parsed = parseJsonRecord(raw);
+  const identity = parsed === void 0 ? void 0 : findIdentityEntry(parsed);
+  if (identity === void 0) return unreadableProbe(exists);
+  const expiresAt = readString(identity, "expires_at");
+  return {
+    state: isExpired(expiresAt, Date.now()) ? "expired" : "signed-in",
+    directoryExists: exists,
+    email: readString(identity, "email"),
+    name: joinName(identity),
+    expiresAt
+  };
+};
+
+// src/grokHome.ts
+function expandHomePath(value) {
+  if (value === "~") return NodeOS.homedir();
+  if (value.startsWith("~/") || value.startsWith("~\\")) {
+    return NodePath2.join(NodeOS.homedir(), value.slice(2));
+  }
+  return value;
+}
+function resolveGrokHomePath(value) {
+  const trimmed3 = value.trim();
+  if (trimmed3.length === 0) return NodePath2.join(NodeOS.homedir(), ".grok");
+  return NodePath2.resolve(expandHomePath(trimmed3));
+}
+function probeGrokAccount(accountPath) {
+  const resolved = resolveGrokHomePath(accountPath);
+  const account = readGrokAccount(resolved);
+  return {
+    accountPath: resolved,
+    state: account.state,
+    ...account.email === void 0 ? {} : { email: account.email },
+    ...account.name === void 0 ? {} : { name: account.name },
+    ...account.expiresAt === void 0 ? {} : { expiresAt: account.expiresAt }
+  };
+}
+function grokContinuationKey(recipe) {
+  return `grok:home:${resolveGrokHomePath(recipe.homePath)}`;
+}
+function resolveAccountHomePath(recipe, configuredHome) {
+  const fromEnvironment = recipe.environment["GROK_HOME"]?.trim();
+  if (fromEnvironment !== void 0 && fromEnvironment.length > 0) {
+    return NodePath2.resolve(expandHomePath(fromEnvironment));
+  }
+  return resolveGrokHomePath(configuredHome);
+}
+function absentPath() {
+  return NodePath2.join(
+    NodeOS.tmpdir(),
+    `ycodium-grok-no-auth-${NodeCrypto.randomUUID()}`,
+    "auth.json"
+  );
+}
+function ownEndpointAuthGuard(recipe) {
+  const connectivity = GROK_CARD.modelConnectivity;
+  const baseUrlKey = connectivity.baseUrlEnvKey;
+  if (baseUrlKey === void 0 || (recipe.environment[baseUrlKey]?.trim() ?? "") === "") return {};
+  const guard = {};
+  for (const entry of connectivity.extraEnv ?? []) {
+    if (entry.value === "$absentPath") guard[entry.name] = absentPath();
+  }
+  return guard;
+}
+function buildSignInEnv(recipe) {
+  const configuredHome = recipe.homePath;
+  const homeInjection = configuredHome.trim().length > 0 ? { [GROK_CARD.homeEnvVar]: resolveGrokHomePath(configuredHome) } : {};
+  return mergeLaunchEnv({
+    accountHome: homeInjection,
+    instanceTable: recipe.environment,
+    handOverrides: { GROK_OAUTH2_REFERRER: "ycodium" }
+  });
+}
+function buildSpawnEnv(recipe, resolvedHomePath, homeConfigured) {
+  const homeInjection = homeConfigured ? { [GROK_CARD.homeEnvVar]: resolvedHomePath } : {};
+  return mergeLaunchEnv({
+    accountHome: { ...homeInjection, ...ownEndpointAuthGuard(recipe) },
+    instanceTable: recipe.environment,
+    handOverrides: { GROK_OAUTH2_REFERRER: "ycodium" }
+  });
+}
+
 // src/grokInstance.ts
 import * as NodeCrypto3 from "node:crypto";
 import {
@@ -169,7 +336,7 @@ import {
 import { nodeStreamsFromHandle as nodeStreamsFromHandle2 } from "@ycodium-ai/plugin-api/process-stdin";
 
 // ../../packages/ycodium-acp-executor/src/executor.ts
-import * as NodeCrypto from "node:crypto";
+import * as NodeCrypto2 from "node:crypto";
 
 // ../../packages/ycodium-acp-executor/src/approvals.ts
 function createApprovalGate(input2) {
@@ -397,7 +564,7 @@ var UnboundedEventStream = class {
 };
 
 // ../../packages/ycodium-acp-executor/src/config-options.ts
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function asString(value) {
@@ -416,7 +583,7 @@ function flattenChoices(rawOptions, currentValue) {
   const out = [];
   const seen = /* @__PURE__ */ new Set();
   const push = (entry) => {
-    if (!isRecord(entry)) return;
+    if (!isRecord2(entry)) return;
     const value = asString(entry["value"]);
     if (value === void 0 || seen.has(value)) return;
     seen.add(value);
@@ -431,7 +598,7 @@ function flattenChoices(rawOptions, currentValue) {
     });
   };
   for (const entry of rawOptions) {
-    if (isRecord(entry) && Array.isArray(entry["options"])) {
+    if (isRecord2(entry) && Array.isArray(entry["options"])) {
       for (const nested of entry["options"]) push(nested);
       continue;
     }
@@ -440,7 +607,7 @@ function flattenChoices(rawOptions, currentValue) {
   return out;
 }
 function isConfigOption(entry, configId) {
-  return isRecord(entry) && asString(entry["id"])?.trim() === configId.trim();
+  return isRecord2(entry) && asString(entry["id"])?.trim() === configId.trim();
 }
 function findConfigOptionEntry(configOptions, configId) {
   return Array.isArray(configOptions) && configId.trim() !== "" ? configOptions.find(
@@ -455,7 +622,7 @@ function withConfigOptionValue(configOptions, configId, value) {
 }
 function pickEffortOption(configOptions) {
   if (!Array.isArray(configOptions)) return void 0;
-  const candidates = configOptions.filter(isRecord).filter((option) => normalizedField(option, "type") === "select").filter(looksLikeEffortOption);
+  const candidates = configOptions.filter(isRecord2).filter((option) => normalizedField(option, "type") === "select").filter(looksLikeEffortOption);
   return candidates.find((option) => normalizedField(option, "category") === "model_option") ?? candidates.find((option) => normalizedField(option, "id") === "effort") ?? candidates.find((option) => normalizedField(option, "category") === "thought_level") ?? candidates[0];
 }
 function findAcpEffortConfig(configOptions) {
@@ -475,7 +642,7 @@ function findAcpEffortConfig(configOptions) {
 }
 
 // ../../packages/ycodium-acp-executor/src/util.ts
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function asTrimmedString(value) {
@@ -530,11 +697,11 @@ function extractCommandFromTitle(title) {
   return backtickMatch?.[1]?.trim() || void 0;
 }
 function extractToolCommand(data, title) {
-  const item = isRecord2(data?.["item"]) ? data["item"] : void 0;
-  const itemInput = item && isRecord2(item["input"]) ? item["input"] : void 0;
-  const itemResult = item && isRecord2(item["result"]) ? item["result"] : void 0;
-  const rawInput = isRecord2(data?.["rawInput"]) ? data["rawInput"] : void 0;
-  const dataInput = isRecord2(data?.["input"]) ? data["input"] : void 0;
+  const item = isRecord3(data?.["item"]) ? data["item"] : void 0;
+  const itemInput = item && isRecord3(item["input"]) ? item["input"] : void 0;
+  const itemResult = item && isRecord3(item["result"]) ? item["result"] : void 0;
+  const rawInput = isRecord3(data?.["rawInput"]) ? data["rawInput"] : void 0;
+  const dataInput = isRecord3(data?.["input"]) ? data["input"] : void 0;
   const candidates = [
     normalizeCommandValue(item?.["command"]),
     normalizeCommandValue(itemInput?.["command"]),
@@ -579,7 +746,7 @@ function collectPaths(value, paths, seen, depth) {
     }
     return;
   }
-  if (!isRecord2(value)) {
+  if (!isRecord3(value)) {
     return;
   }
   for (const key of ["path", "filePath", "relativePath", "filename", "newPath", "oldPath"]) {
@@ -657,7 +824,7 @@ function deriveToolActivityPresentation(input2) {
   const title = asTrimmedString(input2.title);
   const detail = stripTrailingExitCode(asTrimmedString(input2.detail));
   const fallbackSummary = asTrimmedString(input2.fallbackSummary) ?? "Tool";
-  const data = isRecord2(input2.data) ? input2.data : void 0;
+  const data = isRecord3(input2.data) ? input2.data : void 0;
   const command = extractToolCommand(data, title);
   const primaryPath = extractPrimaryPath(data);
   const action = classifyToolAction({
@@ -689,7 +856,7 @@ function deriveToolActivityPresentation(input2) {
     };
   }
   if (action === "search") {
-    const rawInput = isRecord2(data?.["rawInput"]) ? data["rawInput"] : void 0;
+    const rawInput = isRecord3(data?.["rawInput"]) ? data["rawInput"] : void 0;
     const query = asTrimmedString(rawInput?.["query"]) ?? asTrimmedString(rawInput?.["pattern"]) ?? asTrimmedString(rawInput?.["searchTerm"]);
     return {
       summary: "Searched files",
@@ -749,7 +916,7 @@ function extractCommandFromTitle2(title) {
   return match?.[1]?.trim() || void 0;
 }
 function extractToolCallCommand(rawInput, title) {
-  if (isRecord2(rawInput)) {
+  if (isRecord3(rawInput)) {
     const directCommand = normalizeCommandValue2(rawInput["command"]);
     if (directCommand) {
       return directCommand;
@@ -777,7 +944,7 @@ function boundTailText(text4, limit = TOOL_CALL_CONTENT_MAX_CHARS) {
 var boundToolCallOutputText = (text4) => boundTailText(text4);
 var RAW_OUTPUT_TEXT_FIELDS = ["content", "stdout", "stderr", "output"];
 function boundToolCallRawOutput(rawOutput) {
-  if (!isRecord2(rawOutput)) {
+  if (!isRecord3(rawOutput)) {
     return rawOutput;
   }
   let changed = false;
@@ -969,11 +1136,11 @@ function collectSessionConfigOptionValues(configOption) {
   );
 }
 function collectSessionModelIds(models) {
-  if (!isRecord2(models) || !Array.isArray(models["availableModels"])) {
+  if (!isRecord3(models) || !Array.isArray(models["availableModels"])) {
     return [];
   }
   return models["availableModels"].flatMap(
-    (model) => isRecord2(model) && typeof model["modelId"] === "string" ? [model["modelId"]] : []
+    (model) => isRecord3(model) && typeof model["modelId"] === "string" ? [model["modelId"]] : []
   );
 }
 function catalogModelLastSegment(value) {
@@ -1045,7 +1212,7 @@ function parseAvailableCommandsUpdate(params) {
   }
   const commands = [];
   for (const command of availableCommands) {
-    if (!isRecord2(command)) {
+    if (!isRecord3(command)) {
       continue;
     }
     const name = typeof command["name"] === "string" ? command["name"].trim() : "";
@@ -1053,7 +1220,7 @@ function parseAvailableCommandsUpdate(params) {
       continue;
     }
     const description = typeof command["description"] === "string" ? command["description"].trim() || void 0 : void 0;
-    const input2 = isRecord2(command["input"]) ? command["input"] : void 0;
+    const input2 = isRecord3(command["input"]) ? command["input"] : void 0;
     const inputHint = typeof input2?.["hint"] === "string" ? input2["hint"].trim() || void 0 : void 0;
     commands.push({
       name,
@@ -1107,7 +1274,7 @@ function boundToolCallRawPayload(params, update, toolCall) {
 }
 function textFromContentBlocks(blocks) {
   const parts = blocks.flatMap(
-    (block) => isRecord2(block) && block["type"] === "text" && typeof block["text"] === "string" ? [block["text"]] : []
+    (block) => isRecord3(block) && block["type"] === "text" && typeof block["text"] === "string" ? [block["text"]] : []
   );
   const joined = parts.join("");
   return joined.trim().length > 0 ? joined : void 0;
@@ -1132,7 +1299,7 @@ function parseSessionUpdateEvent(params) {
       const entries = Array.isArray(upd["entries"]) ? upd["entries"] : [];
       const plan = entries.map((entry, index) => ({
         step: readAcpText(entry, "content") ?? `Step ${index + 1}`,
-        status: normalizePlanStepStatus(isRecord2(entry) ? entry["status"] : void 0)
+        status: normalizePlanStepStatus(isRecord3(entry) ? entry["status"] : void 0)
       }));
       if (plan.length > 0) {
         events.push({
@@ -1172,7 +1339,7 @@ function parseSessionUpdateEvent(params) {
     }
     case "agent_message_chunk":
     case "agent_thought_chunk": {
-      const content = isRecord2(upd["content"]) ? upd["content"] : void 0;
+      const content = isRecord3(upd["content"]) ? upd["content"] : void 0;
       const contentType = content?.["type"];
       const streamKind = kind === "agent_thought_chunk" ? "reasoning_text" : "assistant_text";
       if (contentType === "text") {
@@ -1212,7 +1379,7 @@ function parseSessionUpdateEvent(params) {
     }
     case "compaction_summary_chunk": {
       const compactionId = readAcpText(upd, "compactionId");
-      const content = isRecord2(upd["content"]) ? upd["content"] : void 0;
+      const content = isRecord3(upd["content"]) ? upd["content"] : void 0;
       const text4 = content?.["type"] === "text" ? content["text"] : void 0;
       if (compactionId === void 0 || typeof text4 !== "string" || text4.length === 0) break;
       events.push({ _tag: "CompactionSummaryChunk", compactionId, text: text4 });
@@ -22906,17 +23073,17 @@ function isResponseMessage(value) {
 function isNotificationMessage(value) {
   return isJsonRpcEnvelope(value) && !("id" in value) && typeof value["method"] === "string";
 }
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null;
 }
 function isJsonRpcEnvelope(value) {
-  return isRecord3(value) && value["jsonrpc"] === "2.0";
+  return isRecord4(value) && value["jsonrpc"] === "2.0";
 }
 function isJsonRpcId(value) {
   return value === null || typeof value === "string" || typeof value === "number" && Number.isFinite(value);
 }
 function isResponseShapedMessage(value) {
-  return isRecord3(value) && !("method" in value) && ("id" in value || "result" in value || "error" in value);
+  return isRecord4(value) && !("method" in value) && ("id" in value || "result" in value || "error" in value);
 }
 function isResponseBatch(batch) {
   let hasValidCall = false;
@@ -22926,7 +23093,7 @@ function isResponseBatch(batch) {
   for (const entry of batch) {
     hasValidCall ||= isRequestMessage(entry) || isNotificationMessage(entry);
     hasValidResponse ||= isResponseMessage(entry);
-    if (!isRecord3(entry)) {
+    if (!isRecord4(entry)) {
       continue;
     }
     hasCallShape ||= "method" in entry;
@@ -22941,13 +23108,13 @@ function isResponseBatch(batch) {
   return hasResponseShape && !hasCallShape;
 }
 function cancelRequestId(params) {
-  if (!isRecord3(params) || !isJsonRpcId(params["requestId"])) {
+  if (!isRecord4(params) || !isJsonRpcId(params["requestId"])) {
     return void 0;
   }
   return params["requestId"];
 }
 function isErrorResponse(value) {
-  return isRecord3(value) && typeof value["code"] === "number" && Number.isInteger(value["code"]) && typeof value["message"] === "string";
+  return isRecord4(value) && typeof value["code"] === "number" && Number.isInteger(value["code"]) && typeof value["message"] === "string";
 }
 var Handled = {
   /**
@@ -23492,7 +23659,7 @@ var Connection = class {
     if (this.abortController.signal.aborted) {
       return Promise.resolve();
     }
-    if (!isRecord3(message)) {
+    if (!isRecord4(message)) {
       console.error("Invalid message", { message });
       return Promise.resolve();
     }
@@ -23895,7 +24062,7 @@ function ndJsonStream(output2, input2) {
           await writeJson(protocolErrorResponse(RequestError.parseError()));
           return;
         }
-        if (isRecord3(message) || Array.isArray(message)) {
+        if (isRecord4(message) || Array.isArray(message)) {
           controller.enqueue(message);
         } else {
           await writeJson(protocolErrorResponse(RequestError.invalidRequest(message)));
@@ -24882,14 +25049,14 @@ var legacyClientNotificationMethods = /* @__PURE__ */ new Set([
 import * as NodeStream from "node:stream";
 
 // ../../packages/ycodium-acp-executor/src/jsonrpc.ts
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null;
 }
 function isJsonRpcId2(value) {
   return typeof value === "string" || typeof value === "number" && Number.isFinite(value);
 }
 function isJsonRpcEnvelope2(value) {
-  return isRecord4(value) && value["jsonrpc"] === "2.0";
+  return isRecord5(value) && value["jsonrpc"] === "2.0";
 }
 function isRequestMessage2(value) {
   return isJsonRpcEnvelope2(value) && "id" in value && typeof value["method"] === "string" && isJsonRpcId2(value["id"]);
@@ -24909,7 +25076,7 @@ function isNotificationMessage2(value) {
   return isJsonRpcEnvelope2(value) && !("id" in value) && typeof value["method"] === "string";
 }
 function readJsonRpcError(value) {
-  if (!isRecord4(value) || typeof value["code"] !== "number" || typeof value["message"] !== "string") {
+  if (!isRecord5(value) || typeof value["code"] !== "number" || typeof value["message"] !== "string") {
     return void 0;
   }
   return {
@@ -24982,11 +25149,11 @@ var KNOWN_SESSION_UPDATES = /* @__PURE__ */ new Set([
   "compaction_summary_chunk"
 ]);
 function isSessionUpdateEnvelope(payload) {
-  if (!isRecord4(payload) || typeof payload["sessionId"] !== "string") {
+  if (!isRecord5(payload) || typeof payload["sessionId"] !== "string") {
     return false;
   }
   const update = payload["update"];
-  return isRecord4(update) && typeof update["sessionUpdate"] === "string";
+  return isRecord5(update) && typeof update["sessionUpdate"] === "string";
 }
 function hasKnownVariantShape(update) {
   const kind = update["sessionUpdate"];
@@ -24994,7 +25161,7 @@ function hasKnownVariantShape(update) {
     return false;
   }
   if (kind === "user_message_chunk" || kind === "agent_message_chunk" || kind === "agent_thought_chunk") {
-    return isRecord4(update["content"]);
+    return isRecord5(update["content"]);
   }
   return true;
 }
@@ -25400,7 +25567,7 @@ function forgetConfigOptionValue(state, configId) {
   const forgetsModel = configId === void 0 || configId === state.modelConfigId;
   const { currentModelReported: _forgottenReport, ...withoutReport } = state;
   const configOptions = configId !== void 0 && Array.isArray(state.configOptions) ? state.configOptions.map((option) => {
-    if (!isRecord2(option) || option["id"] !== configId) return option;
+    if (!isRecord3(option) || option["id"] !== configId) return option;
     const { currentValue: _forgotten, ...rest } = option;
     return rest;
   }) : state.configOptions;
@@ -25411,7 +25578,7 @@ function forgetConfigOptionValue(state, configId) {
   };
 }
 function modelSelectionStateFromSetup(setup) {
-  const sessionModels = isRecord2(setup.models) ? setup.models : void 0;
+  const sessionModels = isRecord3(setup.models) ? setup.models : void 0;
   const modelConfigId = extractModelConfigId(setup);
   const strategy = modelConfigId !== void 0 ? "config-option" : "session/set_model";
   const modelConfigOption = modelConfigId === void 0 ? void 0 : findSessionConfigOption(setup.configOptions, modelConfigId);
@@ -26779,7 +26946,7 @@ function createExecutorRequests({
     pendingUserInputs.delete(requestId);
     pending.resolve({
       kind: "answered",
-      answers: isRecord2(answers) ? answers : {}
+      answers: isRecord3(answers) ? answers : {}
     });
   };
   return {
@@ -26793,7 +26960,7 @@ function createExecutorRequests({
 }
 
 // ../../packages/ycodium-acp-executor/src/artifacts.ts
-import * as NodePath from "node:path";
+import * as NodePath3 from "node:path";
 import * as NodeURL from "node:url";
 function resourceLinkArtifacts(content) {
   if (content["type"] !== "resource_link" || typeof content["uri"] !== "string") return [];
@@ -26804,7 +26971,7 @@ function resourceLinkArtifacts(content) {
   } catch {
     return [];
   }
-  if (!NodePath.isAbsolute(path)) return [];
+  if (!NodePath3.isAbsolute(path)) return [];
   const name = typeof content["name"] === "string" ? content["name"].trim() : "";
   const mimeType = typeof content["mimeType"] === "string" ? content["mimeType"].trim() : "";
   return [
@@ -27078,18 +27245,18 @@ function modelRefreshFailedError(requestedModelId, error62) {
 }
 
 // ../../packages/ycodium-acp-executor/src/runtime-mode.ts
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function asString2(value) {
   return typeof value === "string" ? value : void 0;
 }
 function acpModeConfigId(setup) {
-  if (!isRecord5(setup)) return void 0;
+  if (!isRecord6(setup)) return void 0;
   const configOptions = setup["configOptions"];
   if (!Array.isArray(configOptions)) return void 0;
   for (const option of configOptions) {
-    if (!isRecord5(option)) continue;
+    if (!isRecord6(option)) continue;
     if (asString2(option["category"])?.trim().toLowerCase() !== "mode") continue;
     const id = asString2(option["id"])?.trim();
     if (id) return id;
@@ -27536,14 +27703,14 @@ function createExecutorSettlement({
 
 // ../../packages/ycodium-acp-executor/src/executor/subagent-sessions.ts
 function parseState(raw) {
-  if (!isRecord2(raw)) return { status: void 0, error: void 0 };
+  if (!isRecord3(raw)) return { status: void 0, error: void 0 };
   const state = raw["state"];
   if (state === "running") return { status: "running", error: void 0 };
   if (state === "requires_action") return { status: "waiting", error: void 0 };
   if (state !== "idle") return { status: void 0, error: void 0 };
   const stopReason = raw["stopReason"];
-  const error62 = isRecord2(raw["error"]) ? asTrimmedString(raw["error"]["message"]) : void 0;
-  if (stopReason === "error" || isRecord2(raw["error"])) return { status: "failed", error: error62 };
+  const error62 = isRecord3(raw["error"]) ? asTrimmedString(raw["error"]["message"]) : void 0;
+  if (stopReason === "error" || isRecord3(raw["error"])) return { status: "failed", error: error62 };
   if (stopReason === "cancelled") return { status: "cancelled", error: void 0 };
   return { status: "idle", error: void 0 };
 }
@@ -27559,7 +27726,7 @@ function childLinkage(childId, record4) {
 function createSubagentSessionTracker(registry2) {
   const observe = (notification, ctx) => {
     const update = notification.update;
-    if (!isRecord2(update) || update["sessionUpdate"] !== "subagent_update") return [];
+    if (!isRecord3(update) || update["sessionUpdate"] !== "subagent_update") return [];
     const childId = asTrimmedString(update["sessionId"]);
     if (childId === void 0 || ctx.ownSessionIds.has(childId)) return [];
     const outerId = notification.sessionId;
@@ -27984,9 +28151,9 @@ function readOpenToolCalls(toolCalls, turnId) {
 }
 
 // ../../packages/ycodium-acp-executor/src/protocol-log.ts
-import * as NodeFS from "node:fs";
-import * as NodeOS from "node:os";
-import * as NodePath2 from "node:path";
+import * as NodeFS2 from "node:fs";
+import * as NodeOS2 from "node:os";
+import * as NodePath4 from "node:path";
 var DEFAULT_MAX_BYTES = 8 * 1024 * 1024;
 var UNSAFE_FILE_CHARS = /[^A-Za-z0-9._-]+/gu;
 function safeFileName(value) {
@@ -27994,12 +28161,12 @@ function safeFileName(value) {
 }
 function createAcpProtocolLogFile(input2) {
   const maxBytes = input2.maxBytes ?? DEFAULT_MAX_BYTES;
-  NodeFS.mkdirSync(input2.directory, { recursive: true });
-  const filePath = NodePath2.join(
+  NodeFS2.mkdirSync(input2.directory, { recursive: true });
+  const filePath = NodePath4.join(
     input2.directory,
     `${safeFileName(input2.provider)}-${safeFileName(input2.threadId)}-${Date.now().toString(36)}.ndjson`
   );
-  const stream = (input2.openStream ?? ((path) => NodeFS.createWriteStream(path, { flags: "a" })))(
+  const stream = (input2.openStream ?? ((path) => NodeFS2.createWriteStream(path, { flags: "a" })))(
     filePath
   );
   let bytes = 0;
@@ -28051,7 +28218,7 @@ function createAcpProtocolLogFromEnv(input2) {
   const flag = process.env.YCODIUM_ACP_PROTOCOL_LOG;
   if (flag !== "1" && flag?.toLowerCase() !== "true") return void 0;
   const configured = process.env.YCODIUM_ACP_PROTOCOL_LOG_DIR?.trim();
-  const directory = configured && configured.length > 0 ? configured : NodePath2.join(NodeOS.tmpdir(), "ycodium-acp-protocol");
+  const directory = configured && configured.length > 0 ? configured : NodePath4.join(NodeOS2.tmpdir(), "ycodium-acp-protocol");
   try {
     const sink = createAcpProtocolLogFile({
       directory,
@@ -28075,7 +28242,7 @@ function defaultNowIso() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
 function defaultRandomId() {
-  return NodeCrypto.randomUUID();
+  return NodeCrypto2.randomUUID();
 }
 function createAcpExecutor(options) {
   const hooks = { ...defaultVendorHooks, ...options.hooks };
@@ -28671,28 +28838,28 @@ var MAX_VERSION_OUTPUT_BYTES = 64 * 1024;
 
 // src/config.ts
 var GROK_DEFAULT_LAUNCH_ARGS = "agent stdio";
-function isRecord6(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function readString(value) {
+function readString2(value) {
   return typeof value === "string" ? value : "";
 }
 function readTrimmed(value) {
-  return readString(value).trim();
+  return readString2(value).trim();
 }
 function readEnvironment(value) {
   if (!Array.isArray(value)) return {};
   const env = {};
   for (const entry of value) {
-    if (!isRecord6(entry)) continue;
+    if (!isRecord7(entry)) continue;
     const name = readTrimmed(entry["name"]);
     if (name.length === 0) continue;
-    env[name] = readString(entry["value"]);
+    env[name] = readString2(entry["value"]);
   }
   return env;
 }
 function parseGrokInstanceConfig(config2) {
-  if (!isRecord6(config2)) {
+  if (!isRecord7(config2)) {
     return {
       binaryPath: "",
       launchArgs: GROK_DEFAULT_LAUNCH_ARGS,
@@ -28702,11 +28869,11 @@ function parseGrokInstanceConfig(config2) {
       envelopeDriver: void 0
     };
   }
-  const nested = isRecord6(config2["config"]) ? config2["config"] : void 0;
+  const nested = isRecord7(config2["config"]) ? config2["config"] : void 0;
   const settings = nested ?? config2;
   return {
     binaryPath: readTrimmed(settings["binaryPath"]),
-    launchArgs: readString(settings["launchArgs"]) || GROK_DEFAULT_LAUNCH_ARGS,
+    launchArgs: readString2(settings["launchArgs"]) || GROK_DEFAULT_LAUNCH_ARGS,
     homePath: readTrimmed(settings["homePath"]) || readTrimmed(config2["homePath"]),
     homeEnvVar: readTrimmed(settings["homeEnvVar"]) || readTrimmed(config2["homeEnvVar"]),
     environment: readEnvironment(config2["environment"]),
@@ -28830,166 +28997,6 @@ function readDeviceCodeOutput(stdout, onText) {
   return { text: text4, code };
 }
 
-// src/grokHome.ts
-import * as NodeCrypto2 from "node:crypto";
-import * as NodeOS2 from "node:os";
-import * as NodePath4 from "node:path";
-import { mergeLaunchEnv } from "@ycodium-ai/plugin-api/executor";
-
-// src/grokAccount.ts
-import * as NodeFS2 from "node:fs";
-import * as NodePath3 from "node:path";
-var AUTH_FILE_NAME = "auth.json";
-var isRecord7 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-var readString2 = (record4, key) => {
-  const value = record4[key];
-  if (typeof value !== "string") return void 0;
-  const trimmed3 = value.trim();
-  return trimmed3.length > 0 ? trimmed3 : void 0;
-};
-var parseJsonRecord = (raw) => {
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    return void 0;
-  }
-  return isRecord7(parsed) ? parsed : void 0;
-};
-var directoryExists = (homePath) => {
-  try {
-    return NodeFS2.statSync(homePath).isDirectory();
-  } catch {
-    return false;
-  }
-};
-var readCredentialFile = (path) => {
-  try {
-    return NodeFS2.readFileSync(path, "utf8");
-  } catch {
-    return void 0;
-  }
-};
-var signedOutProbe = (exists) => ({
-  state: "signed-out",
-  directoryExists: exists,
-  email: void 0,
-  name: void 0,
-  expiresAt: void 0
-});
-var unreadableProbe = (exists) => ({
-  state: "unreadable",
-  directoryExists: exists,
-  email: void 0,
-  name: void 0,
-  expiresAt: void 0
-});
-var joinName = (record4) => {
-  const first = readString2(record4, "first_name");
-  const last = readString2(record4, "last_name");
-  const joined = [first, last].filter((part) => part !== void 0).join(" ");
-  return joined.length > 0 ? joined : void 0;
-};
-var findIdentityEntry = (parsed) => {
-  for (const value of Object.values(parsed)) {
-    if (!isRecord7(value)) continue;
-    if (readString2(value, "email") !== void 0 || readString2(value, "user_id") !== void 0) {
-      return value;
-    }
-  }
-  return void 0;
-};
-var isExpired = (expiresAt, nowMs) => {
-  if (expiresAt === void 0) return false;
-  const parsed = Date.parse(expiresAt);
-  return Number.isNaN(parsed) ? false : parsed <= nowMs;
-};
-var readGrokAccount = (homePath) => {
-  const exists = directoryExists(homePath);
-  const raw = readCredentialFile(NodePath3.join(homePath, AUTH_FILE_NAME));
-  if (raw === void 0) return signedOutProbe(exists);
-  const parsed = parseJsonRecord(raw);
-  const identity = parsed === void 0 ? void 0 : findIdentityEntry(parsed);
-  if (identity === void 0) return unreadableProbe(exists);
-  const expiresAt = readString2(identity, "expires_at");
-  return {
-    state: isExpired(expiresAt, Date.now()) ? "expired" : "signed-in",
-    directoryExists: exists,
-    email: readString2(identity, "email"),
-    name: joinName(identity),
-    expiresAt
-  };
-};
-
-// src/grokHome.ts
-function expandHomePath(value) {
-  if (value === "~") return NodeOS2.homedir();
-  if (value.startsWith("~/") || value.startsWith("~\\")) {
-    return NodePath4.join(NodeOS2.homedir(), value.slice(2));
-  }
-  return value;
-}
-function resolveGrokHomePath(value) {
-  const trimmed3 = value.trim();
-  if (trimmed3.length === 0) return NodePath4.join(NodeOS2.homedir(), ".grok");
-  return NodePath4.resolve(expandHomePath(trimmed3));
-}
-function probeGrokAccount(accountPath) {
-  const resolved = resolveGrokHomePath(accountPath);
-  const account = readGrokAccount(resolved);
-  return {
-    accountPath: resolved,
-    state: account.state,
-    ...account.email === void 0 ? {} : { email: account.email },
-    ...account.name === void 0 ? {} : { name: account.name },
-    ...account.expiresAt === void 0 ? {} : { expiresAt: account.expiresAt }
-  };
-}
-function grokContinuationKey(recipe) {
-  return `grok:home:${resolveGrokHomePath(recipe.homePath)}`;
-}
-function resolveAccountHomePath(recipe, configuredHome) {
-  const fromEnvironment = recipe.environment["GROK_HOME"]?.trim();
-  if (fromEnvironment !== void 0 && fromEnvironment.length > 0) {
-    return NodePath4.resolve(expandHomePath(fromEnvironment));
-  }
-  return resolveGrokHomePath(configuredHome);
-}
-function absentPath() {
-  return NodePath4.join(
-    NodeOS2.tmpdir(),
-    `ycodium-grok-no-auth-${NodeCrypto2.randomUUID()}`,
-    "auth.json"
-  );
-}
-function ownEndpointAuthGuard(recipe) {
-  const connectivity = GROK_CARD.modelConnectivity;
-  const baseUrlKey = connectivity.baseUrlEnvKey;
-  if (baseUrlKey === void 0 || (recipe.environment[baseUrlKey]?.trim() ?? "") === "") return {};
-  const guard = {};
-  for (const entry of connectivity.extraEnv ?? []) {
-    if (entry.value === "$absentPath") guard[entry.name] = absentPath();
-  }
-  return guard;
-}
-function buildSignInEnv(recipe) {
-  const configuredHome = recipe.homePath;
-  const homeInjection = configuredHome.trim().length > 0 ? { [GROK_CARD.homeEnvVar]: resolveGrokHomePath(configuredHome) } : {};
-  return mergeLaunchEnv({
-    accountHome: homeInjection,
-    instanceTable: recipe.environment,
-    handOverrides: { GROK_OAUTH2_REFERRER: "ycodium" }
-  });
-}
-function buildSpawnEnv(recipe, resolvedHomePath, homeConfigured) {
-  const homeInjection = homeConfigured ? { [GROK_CARD.homeEnvVar]: resolvedHomePath } : {};
-  return mergeLaunchEnv({
-    accountHome: { ...homeInjection, ...ownEndpointAuthGuard(recipe) },
-    instanceTable: recipe.environment,
-    handOverrides: { GROK_OAUTH2_REFERRER: "ycodium" }
-  });
-}
-
 // src/grokSignIn.ts
 function makeGrokSignIn(input2) {
   const { host, recipe } = input2;
@@ -30961,6 +30968,7 @@ var createGrokInstance = (config2, host) => {
 var executors = [
   {
     card: GROK_CARD,
+    lifecycle: [{ kind: "detect", reversible: true }],
     createInstance: async (config2, host) => {
       host.log.info("createInstance");
       return createGrokInstance(config2, host);
@@ -30970,9 +30978,26 @@ var executors = [
 ];
 var index_default = definePlugin({
   id: "agent-grok",
-  apiVersion: 53,
+  apiVersion: 56,
   executors,
   activate(ctx) {
+    ctx.command({
+      name: "effectiveConfig",
+      description: "Settings form: the account directory an empty path resolves to on this machine.",
+      scope: "read",
+      payloadSchema: EXECUTOR_EFFECTIVE_PAYLOAD_SCHEMA,
+      handle: async (payload) => {
+        const request = readExecutorEffectiveRequest(payload);
+        return {
+          homePath: executorHomeEffectiveValue(
+            "GROK_HOME",
+            request,
+            process.env,
+            (value) => resolveGrokHomePath(value ?? "")
+          )
+        };
+      }
+    });
     ctx.log.info("grok executor ready");
   }
 });

package/locales/en.json

@@ -1,4 +1,8 @@
 {
+  "presentation": {
+    "name": "Grok",
+    "description": "Use Grok in Ycodium and pick up earlier sessions where they left off."
+  },
   "form": {
     "binaryPath": {
       "title": "Program path",
@@ -9,6 +13,11 @@
       "title": "Account directory",
       "description": "Sessions and the `grok login` credentials live here, so providers sharing this directory can pick up each other's threads and providers with different directories cannot. Leave empty to use the CLI's default (~/.grok).",
       "placeholder": "e.g. ~/.grok-work"
+    },
+    "effective": {
+      "provider": "{{name}} in this provider",
+      "machine": "{{name}} on this machine",
+      "default": "default"
     }
   },
   "usage": {

package/locales/zh-CN.json

@@ -1,4 +1,8 @@
 {
+  "presentation": {
+    "name": "Grok",
+    "description": "在 Ycodium 里使用 Grok，之前的会话可以接着做。"
+  },
   "form": {
     "binaryPath": {
       "title": "程序路径",
@@ -9,6 +13,11 @@
       "title": "账号目录",
       "description": "会话和 `grok login` 的凭据都保存在这里，因此共用同一目录的 provider 可以接手彼此的会话，目录不同的则不能。留空则使用该命令行工具的默认目录（~/.grok）。",
       "placeholder": "例如 ~/.grok-work"
+    },
+    "effective": {
+      "provider": "本 provider 的 {{name}}",
+      "machine": "本机的 {{name}}",
+      "default": "默认"
     }
   },
   "usage": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/agent-grok",
-  "version": "0.2.3710",
+  "version": "0.2.3766",
   "description": "Grok executor: grok CLI over Agent Client Protocol stdio.",
   "keywords": [
     "ycodium",
@@ -21,14 +21,16 @@
     "@types/node": "24.12.4",
     "esbuild": "0.28.1",
     "vite-plus": "0.2.2",
-    "@ycodium-ai/plugin-api": "0.2.3710",
-    "ycodium-acp-executor": "0.2.3710",
+    "@ycodium-ai/plugin-api": "0.2.3766",
+    "ycodium-acp-executor": "0.2.3766",
     "ycodium-executor-testing": "0.0.0"
   },
   "ycodium": {
     "plugin": "./dist/index.js",
     "displayName": "Grok",
-    "description": "Run Grok (grok agent stdio) with its session/resume continuation, reasoning-effort spawn tiers, and device-code sign-in.",
+    "displayNameKey": "presentation.name",
+    "description": "Use Grok in Ycodium and pick up earlier sessions where they left off.",
+    "descriptionKey": "presentation.description",
     "icon": "./assets/icon.svg",
     "permissions": [
       {