@liberseek/boft-cli-win32-arm64 0.7.1 → 0.7.3

package/app/plugins/grok/plugin.mjs

@@ -19504,10 +19504,21 @@ var harnessCommandDescriptorSchema = external_exports.object({
   invocation: commandInvocationSchema,
   label: commandLabelSchema,
   description: commandDescriptionSchema.optional(),
-  argumentMode: external_exports.enum(["none", "text"])
+  argumentMode: external_exports.enum(["none", "text"]),
+  /**
+   * Native distinction reported by the Harness. Omitted when the Harness does
+   * not tell skills and commands apart; consumers treat that as "command".
+   */
+  kind: external_exports.enum(["command", "skill"]).optional()
 }).strict();
 var harnessCommandCatalogSchema = external_exports.object({
-  commands: external_exports.array(harnessCommandDescriptorSchema)
+  commands: external_exports.array(harnessCommandDescriptorSchema),
+  /**
+   * `live` when the catalog includes what a native Session reports for its
+   * workspace (custom commands, skills); `static` for Adapter built-ins only.
+   * Omitted by Adapters; set by the Host on inspection results.
+   */
+  source: external_exports.enum(["live", "static"]).optional()
 }).strict().superRefine((catalog, context) => {
   const ids = /* @__PURE__ */ new Set();
   for (const [index, command] of catalog.commands.entries()) {
@@ -19521,7 +19532,11 @@ var harnessCommandCatalogSchema = external_exports.object({
     ids.add(command.id);
   }
 });
-var harnessCommandsInspectParamsSchema = external_exports.object({ harnessId: harnessIdSchema }).strict();
+var harnessCommandsInspectParamsSchema = external_exports.object({
+  harnessId: harnessIdSchema,
+  /** Workspace of a draft without a Thread, for its live catalog when known. */
+  cwd: external_exports.string().min(1).optional()
+}).strict();
 var threadCommandsInspectParamsSchema = external_exports.object({
   threadId: hostThreadIdSchema
 }).strict();
@@ -19866,6 +19881,124 @@ function parseHostUsage(value) {
   return { ...value };
 }
 
+// ../../harness-adapter/dist/live-command-catalog.js
+var COMMON_EXCLUDED_LIVE_COMMANDS = /* @__PURE__ */ new Set([
+  // Session lifecycle
+  "branch",
+  "clear",
+  "exit",
+  "fork",
+  "fresh",
+  "new",
+  "quit",
+  "rename",
+  "rename-chat",
+  "reset",
+  "resume",
+  "rewind",
+  "session",
+  "sessions",
+  // Desktop-owned configuration
+  "autocompact",
+  "color",
+  "config",
+  "effort",
+  "fast",
+  "keybindings",
+  "model",
+  "models",
+  "output-style",
+  "permissions",
+  "settings",
+  "statusline",
+  "terminal-setup",
+  "theme",
+  "vim",
+  // Trust and approval policy
+  "always-approve",
+  "auto-mode-setup",
+  // Native login
+  "login",
+  "logout",
+  // Work outliving the Turn
+  "autopilot",
+  "background",
+  "bg",
+  "goal",
+  "jobs",
+  "loop",
+  "multitask",
+  "queue",
+  "remote-control",
+  "schedule",
+  "steer",
+  // Native terminal UI
+  "copy",
+  "debug",
+  "feedback",
+  "heapdump",
+  "share",
+  "shell",
+  // Plugin and MCP management
+  "marketplace",
+  "mcp",
+  "plugins",
+  "reload-plugins"
+]);
+var COMMON_EXCLUDED_LIVE_COMMAND_PREFIXES = ["__", "hooks-"];
+function isExcludedLiveCommand(name, kind, extra = {}) {
+  const normalized = name.trim().replace(/^\//u, "");
+  if (new Set(extra.names ?? []).has(normalized))
+    return true;
+  if (extra.prefixes?.some((prefix) => normalized.startsWith(prefix)))
+    return true;
+  if (kind === "skill")
+    return false;
+  return COMMON_EXCLUDED_LIVE_COMMANDS.has(normalized) || COMMON_EXCLUDED_LIVE_COMMAND_PREFIXES.some((prefix) => normalized.startsWith(prefix));
+}
+function liveHarnessCommandPrompt(catalog, idPrefix, commandId, argumentText) {
+  if (!commandId.startsWith(idPrefix))
+    return null;
+  const descriptor = catalog.commands.find(({ id }) => id === commandId);
+  if (!descriptor)
+    return null;
+  const text = typeof argumentText === "string" ? argumentText.trim() : "";
+  return text ? `${descriptor.invocation} ${text}` : descriptor.invocation;
+}
+function mergeLiveHarnessCommands(builtIns, idPrefix, live, exclusions = {}) {
+  if (!live)
+    return builtIns;
+  const invocations = new Set(builtIns.commands.map(({ invocation }) => invocation));
+  const ids = new Set(builtIns.commands.map(({ id }) => id));
+  const dynamic = [];
+  for (const command of live) {
+    const name = command.name.trim().replace(/^\//u, "");
+    if (!name || /\s/u.test(name))
+      continue;
+    if (isExcludedLiveCommand(name, command.kind, exclusions))
+      continue;
+    const invocation = `/${name}`;
+    const id = `${idPrefix}${name.replace(/[^A-Za-z0-9._:-]/gu, "-")}`.slice(0, 128);
+    if (invocations.has(invocation) || ids.has(id))
+      continue;
+    const description = command.description?.trim().slice(0, 512);
+    const parsed = harnessCommandDescriptorSchema.safeParse({
+      id,
+      invocation,
+      label: name.slice(0, 128),
+      ...description ? { description } : {},
+      argumentMode: "text",
+      kind: command.kind
+    });
+    if (!parsed.success)
+      continue;
+    invocations.add(invocation);
+    ids.add(id);
+    dynamic.push(parsed.data);
+  }
+  return harnessCommandCatalogSchema.parse({ commands: [...builtIns.commands, ...dynamic] });
+}
+
 // dist/acp-transport.js
 import { spawn, spawnSync } from "node:child_process";
 import { readdir, readFile as readFile2 } from "node:fs/promises";
@@ -19873,6 +20006,41 @@ import os4 from "node:os";
 import path9 from "node:path";
 import { Readable, Writable } from "node:stream";
 
+// dist/grok-slash-commands.js
+var GROK_LIVE_COMMAND_ID_PREFIX = "grok.slash.";
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseGrokAvailableCommands(value) {
+  if (!Array.isArray(value))
+    return [];
+  return value.flatMap((entry) => {
+    if (!isRecord3(entry))
+      return [];
+    const name = typeof entry.name === "string" ? entry.name.trim().replace(/^\//u, "") : "";
+    if (!name)
+      return [];
+    return [
+      {
+        name,
+        description: typeof entry.description === "string" ? entry.description : "",
+        meta: isRecord3(entry._meta) ? entry._meta : null
+      }
+    ];
+  });
+}
+function isGrokSkill(command) {
+  const path12 = command.meta?.path;
+  return typeof path12 === "string" && /(^|[\\/])SKILL\.md$/u.test(path12) || typeof command.meta?.qualifiedName === "string";
+}
+function grokLiveCommands(native) {
+  return native.map((command) => ({
+    name: command.name,
+    description: command.description,
+    kind: isGrokSkill(command) ? "skill" : "command"
+  }));
+}
+
 // dist/command.js
 import path4 from "node:path";
 
@@ -20567,7 +20735,7 @@ function splitLines(text) {
 // dist/grok-file-change.js
 var DEFAULT_GROK_FILE_CHANGE_TEXT_LIMIT = 4 * 1024 * 1024;
 var MAX_GROK_FILE_CHANGES_PER_TOOL = 32;
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function validAbsolutePath(value) {
@@ -20618,7 +20786,7 @@ function projectGrokFileChanges(content, cwd, textLimit = DEFAULT_GROK_FILE_CHAN
     return null;
   const candidates = [];
   for (const entry of content) {
-    if (isRecord3(entry) && entry.type === "diff")
+    if (isRecord4(entry) && entry.type === "diff")
       candidates.push(entry);
   }
   if (candidates.length === 0 || candidates.length > MAX_GROK_FILE_CHANGES_PER_TOOL)
@@ -20935,14 +21103,14 @@ function mediaFileExists(absolutePath) {
 // dist/grok-tool-output.js
 var DEFAULT_GROK_TOOL_OUTPUT_LIMIT = 64e3;
 var EXECUTE_TOOL_NAMES = /* @__PURE__ */ new Set(["bash", "run_terminal_command", "shell", "cursor_shell"]);
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function stringField(value, key) {
-  return isRecord4(value) && typeof value[key] === "string" && value[key].length > 0 ? value[key] : void 0;
+  return isRecord5(value) && typeof value[key] === "string" && value[key].length > 0 ? value[key] : void 0;
 }
 function numberField(value, key) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     return void 0;
   const field = value[key];
   if (field === null)
@@ -20965,7 +21133,7 @@ function firstReadableText(...candidates) {
   for (const candidate of candidates) {
     if (typeof candidate === "string" && candidate.length > 0)
       return candidate;
-    if (isRecord4(candidate)) {
+    if (isRecord5(candidate)) {
       const nested = stringField(candidate, "content") ?? stringField(candidate, "text") ?? stringField(candidate, "tool_result") ?? stringField(candidate, "raw_output");
       if (nested)
         return nested;
@@ -20988,7 +21156,7 @@ function grokToolArguments(rawInput) {
   if (!parsed.success)
     return {};
   const argumentsValue = parsed.data;
-  if (!isRecord4(argumentsValue) || stringField(argumentsValue, "path"))
+  if (!isRecord5(argumentsValue) || stringField(argumentsValue, "path"))
     return argumentsValue;
   const targetFile = stringField(argumentsValue, "target_file");
   return targetFile ? { ...argumentsValue, path: targetFile } : argumentsValue;
@@ -21001,7 +21169,7 @@ function grokCommand(name, kind, rawInput) {
     return command;
   if (name && EXECUTE_TOOL_NAMES.has(name))
     return command;
-  return isRecord4(rawInput) && rawInput.variant === "Bash" ? command : void 0;
+  return isRecord5(rawInput) && rawInput.variant === "Bash" ? command : void 0;
 }
 function grokCommandCwd(rawInput, fallback) {
   return stringField(rawInput, "cwd") ?? fallback;
@@ -21028,11 +21196,11 @@ function acpContentText(content) {
   if (!Array.isArray(content))
     return "";
   return content.flatMap((entry) => {
-    if (!isRecord4(entry))
+    if (!isRecord5(entry))
       return [];
     if (entry.type === "text" && typeof entry.text === "string")
       return [entry.text];
-    if (entry.type !== "content" || !isRecord4(entry.content))
+    if (entry.type !== "content" || !isRecord5(entry.content))
       return [];
     return entry.content.type === "text" && typeof entry.content.text === "string" ? [entry.content.text] : [];
   }).join("\n");
@@ -21043,10 +21211,10 @@ function acpContentImages(content, remainingBytes) {
   const images = [];
   let remaining = remainingBytes;
   for (const entry of content) {
-    if (!isRecord4(entry))
+    if (!isRecord5(entry))
       continue;
     const image = entry.type === "image" ? entry : entry.type === "content" ? entry.content : null;
-    if (!isRecord4(image) || image.type !== "image")
+    if (!isRecord5(image) || image.type !== "image")
       continue;
     const mimeType = stringField(image, "mimeType") ?? stringField(image, "mime_type");
     const data = stringField(image, "data");
@@ -21069,14 +21237,14 @@ function bashOutput(rawOutput) {
 function rawOutputProjection(rawOutput) {
   if (typeof rawOutput === "string")
     return rawOutput.length > 0 ? { text: rawOutput } : {};
-  if (!isRecord4(rawOutput))
+  if (!isRecord5(rawOutput))
     return {};
   if (rawOutput.type === "Bash" || rawOutput.variant === "Bash" || numberField(rawOutput, "exit_code") !== void 0 || numberField(rawOutput, "exitCode") !== void 0) {
     const bash = bashOutput(rawOutput);
     if (bash.text !== void 0 || bash.exitCode !== void 0)
       return bash;
   }
-  const text = firstReadableText(rawOutput.content, rawOutput.text, rawOutput.tool_result, rawOutput.raw_output, isRecord4(rawOutput.FileContent) ? rawOutput.FileContent : void 0, isRecord4(rawOutput.Content) ? rawOutput.Content : void 0);
+  const text = firstReadableText(rawOutput.content, rawOutput.text, rawOutput.tool_result, rawOutput.raw_output, isRecord5(rawOutput.FileContent) ? rawOutput.FileContent : void 0, isRecord5(rawOutput.Content) ? rawOutput.Content : void 0);
   if (text)
     return { text };
   if (typeof rawOutput.match_count === "number" && Number.isFinite(rawOutput.match_count)) {
@@ -21140,11 +21308,11 @@ var WAIT_TOOL_NAMES = /* @__PURE__ */ new Set([
 var KILL_TOOL_NAMES = /* @__PURE__ */ new Set(["kill_command_or_subagent", "kill_task"]);
 var DESCRIPTION_LIMIT = 500;
 var SUMMARY_LIMIT = 2e3;
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function idField(value, key) {
-  if (!isRecord5(value))
+  if (!isRecord6(value))
     return void 0;
   const field = value[key];
   if (typeof field === "string") {
@@ -21156,7 +21324,7 @@ function idField(value, key) {
   return void 0;
 }
 function stringField2(value, key) {
-  if (!isRecord5(value) || typeof value[key] !== "string")
+  if (!isRecord6(value) || typeof value[key] !== "string")
     return void 0;
   const trimmed = value[key].trim();
   return trimmed.length > 0 ? trimmed : void 0;
@@ -21179,7 +21347,7 @@ function collectIds(value) {
   };
   push(idField(value, "task_id"));
   push(idField(value, "subagent_id"));
-  if (isRecord5(value)) {
+  if (isRecord6(value)) {
     const list = value.task_ids ?? value.subagent_ids;
     if (Array.isArray(list)) {
       for (const entry of list)
@@ -21198,7 +21366,7 @@ function grokSubagentOperation(name, title, rawInput) {
     return "send";
   if (SPAWN_TOOL_NAMES.has(id))
     return "spawn";
-  if (isRecord5(rawInput) && rawInput.variant === "Task")
+  if (isRecord6(rawInput) && rawInput.variant === "Task")
     return "spawn";
   return null;
 }
@@ -21221,7 +21389,7 @@ function grokSubagentRole(rawInput) {
   return bounded(stringField2(rawInput, "subagent_type") ?? stringField2(rawInput, "agent_type") ?? stringField2(rawInput, "type"), DESCRIPTION_LIMIT);
 }
 function grokSubagentBackground(rawInput) {
-  if (!isRecord5(rawInput))
+  if (!isRecord6(rawInput))
     return true;
   if (rawInput.background === false || rawInput.run_in_background === false)
     return false;
@@ -21259,7 +21427,7 @@ function grokSubagentResultSummary(...candidates) {
   return void 0;
 }
 function grokSubagentEventFromUpdate(update) {
-  if (!isRecord5(update) || typeof update.sessionUpdate !== "string")
+  if (!isRecord6(update) || typeof update.sessionUpdate !== "string")
     return null;
   const nativeSubagentId = idField(update, "subagent_id") ?? idField(update, "child_session_id");
   if (!nativeSubagentId)
@@ -21320,14 +21488,14 @@ function grokSubagentWaitSettlements(input) {
   return ids.map((id) => ({ id, status: overall }));
 }
 function taskOutputResults(rawOutput) {
-  if (!isRecord5(rawOutput))
+  if (!isRecord6(rawOutput))
     return [];
   if (Array.isArray(rawOutput.results)) {
-    return rawOutput.results.filter(isRecord5);
+    return rawOutput.results.filter(isRecord6);
   }
   const nested = firstRecord(rawOutput.MultiResult, rawOutput.multiResult, rawOutput.multi_result);
   if (nested && Array.isArray(nested.results)) {
-    return nested.results.filter(isRecord5);
+    return nested.results.filter(isRecord6);
   }
   const single = firstRecord(rawOutput.Result, rawOutput.result);
   if (single)
@@ -21338,7 +21506,7 @@ function taskOutputResults(rawOutput) {
 }
 function firstRecord(...values) {
   for (const value of values) {
-    if (isRecord5(value))
+    if (isRecord6(value))
       return value;
   }
   return void 0;
@@ -21361,7 +21529,7 @@ function taskOutputTextSettlements(rawOutput, content, ids) {
   return settled;
 }
 function taskOutputStatus(rawOutput, content) {
-  if (isRecord5(rawOutput) && typeof rawOutput.status === "string")
+  if (isRecord6(rawOutput) && typeof rawOutput.status === "string")
     return rawOutput.status;
   const text = extractText(content) ?? extractText(rawOutput);
   if (!text)
@@ -21420,7 +21588,7 @@ function extractText(value, depth = 0) {
     const joined = parts.join("\n").trim();
     return joined.length > 0 ? joined : void 0;
   }
-  if (!isRecord5(value))
+  if (!isRecord6(value))
     return void 0;
   if (typeof value.text === "string" && value.text.trim().length > 0)
     return value.text.trim();
@@ -21890,11 +22058,11 @@ var GROK_SESSION_DELETE_METHOD = "_x.ai/session/delete";
 function error51(code, message, retryable = false) {
   return { code, message, retryable };
 }
-function isRecord6(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isGrokMethodNotFound(error53) {
-  if (isRecord6(error53) && error53.code === -32601)
+  if (isRecord7(error53) && error53.code === -32601)
     return true;
   const message = error53 instanceof Error ? error53.message : String(error53);
   return /method not found/iu.test(message);
@@ -21912,10 +22080,10 @@ function buildGrokForkParams(input) {
   };
 }
 function parseGrokForkResponse(value) {
-  if (!isRecord6(value) || value.error !== void 0)
+  if (!isRecord7(value) || value.error !== void 0)
     return null;
-  const payload = typeof value.newSessionId !== "string" && isRecord6(value.result) ? value.result : value;
-  if (!isRecord6(payload) || payload.error !== void 0)
+  const payload = typeof value.newSessionId !== "string" && isRecord7(value.result) ? value.result : value;
+  if (!isRecord7(payload) || payload.error !== void 0)
     return null;
   if (typeof payload.newSessionId !== "string" || payload.newSessionId.length === 0)
     return null;
@@ -22078,7 +22246,7 @@ var GROK_SESSION_UPDATE_EXTENSION_METHODS = [
   "_x.ai/session/update",
   "x.ai/session_notification"
 ];
-function isRecord7(value) {
+function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function optionalNonNegativeInt(value) {
@@ -22099,7 +22267,7 @@ function isGrokExtensionSessionUpdateMethod(method) {
   return GROK_SESSION_UPDATE_EXTENSION_METHODS.includes(method);
 }
 function grokCompactionEventFromUpdate(update) {
-  if (!isRecord7(update) || typeof update.sessionUpdate !== "string")
+  if (!isRecord8(update) || typeof update.sessionUpdate !== "string")
     return null;
   const tokensUsed = optionalNonNegativeInt(firstPresent(update, ["tokensUsed", "tokens_used"]));
   const contextWindowTokens = optionalNonNegativeInt(firstPresent(update, ["contextWindowTokens", "contextWindow", "context_window"]));
@@ -22138,7 +22306,7 @@ function grokCompactionEventFromUpdate(update) {
 // dist/grok-manual-compaction.js
 var GROK_COMPACT_CONVERSATION_METHOD = "x.ai/compact_conversation";
 var GROK_COMPACT_CONVERSATION_FALLBACK_METHOD = "_x.ai/compact_conversation";
-function isRecord8(value) {
+function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function optionalNonNegativeInt2(value) {
@@ -22150,7 +22318,7 @@ function optionalErrorMessage2(value) {
 function parseGrokCompactResult(value, cancelled = false) {
   if (cancelled)
     return { outcome: "cancelled" };
-  if (!isRecord8(value))
+  if (!isRecord9(value))
     return { outcome: "succeeded" };
   const tokensBefore = optionalNonNegativeInt2(value.tokensBefore ?? value.tokens_before);
   const tokensAfter = optionalNonNegativeInt2(value.tokensAfter ?? value.tokens_after);
@@ -22188,7 +22356,7 @@ var GROK_REWIND_EXECUTE_METHOD = "_x.ai/rewind/execute";
 function error52(code, message, retryable = false) {
   return { code, message, retryable };
 }
-function isRecord9(value) {
+function isRecord10(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function buildGrokRewindParams(input) {
@@ -22200,10 +22368,10 @@ function buildGrokRewindParams(input) {
   };
 }
 function parseGrokRewindResponse(value) {
-  if (!isRecord9(value))
+  if (!isRecord10(value))
     return null;
-  const payload = typeof value.success !== "boolean" && isRecord9(value.result) ? value.result : value;
-  if (!isRecord9(payload) || typeof payload.success !== "boolean")
+  const payload = typeof value.success !== "boolean" && isRecord10(value.result) ? value.result : value;
+  if (!isRecord10(payload) || typeof payload.success !== "boolean")
     return null;
   return rewindPayload(payload);
 }
@@ -22319,7 +22487,7 @@ var GROK_PLAN_STAY_VALUE = "stay";
 var GROK_PLAN_STAY_LABEL = "Stay in plan mode";
 var GROK_PLAN_OUTCOME_APPROVED = "approved";
 var GROK_PLAN_OUTCOME_CANCELLED = "cancelled";
-function isRecord10(value) {
+function isRecord11(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function stringField3(value, ...keys) {
@@ -22331,9 +22499,9 @@ function stringField3(value, ...keys) {
   return void 0;
 }
 function parseGrokExitPlanModeParams(params) {
-  if (!isRecord10(params))
+  if (!isRecord11(params))
     return null;
-  const nested = isRecord10(params.input) ? params.input : params;
+  const nested = isRecord11(params.input) ? params.input : params;
   const plan = stringField3(nested, "planContent", "plan_content", "plan") ?? stringField3(params, "planContent", "plan_content", "plan") ?? null;
   const planFilePath = stringField3(nested, "planFilePath", "plan_file_path") ?? stringField3(params, "planFilePath", "plan_file_path");
   const sessionId = stringField3(params, "sessionId", "session_id");
@@ -22405,7 +22573,7 @@ var GROK_ACP_CLIENT_CAPABILITIES = {
     "x.ai/exit_plan_mode": true
   }
 };
-function isRecord11(value) {
+function isRecord12(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function stringField4(value, ...keys) {
@@ -22434,15 +22602,15 @@ function isGrokExitPlanModeMethod(method) {
 function questionsPayload(params) {
   if (Array.isArray(params.questions))
     return params.questions;
-  if (isRecord11(params.input) && Array.isArray(params.input.questions))
+  if (isRecord12(params.input) && Array.isArray(params.input.questions))
     return params.input.questions;
-  if (isRecord11(params.askUserQuestion) && Array.isArray(params.askUserQuestion.questions)) {
+  if (isRecord12(params.askUserQuestion) && Array.isArray(params.askUserQuestion.questions)) {
     return params.askUserQuestion.questions;
   }
   return void 0;
 }
 function parseOption(value, labels) {
-  if (!isRecord11(value))
+  if (!isRecord12(value))
     return null;
   const label = stringField4(value, "label");
   if (!label || labels.has(label))
@@ -22457,7 +22625,7 @@ function parseOption(value, labels) {
   };
 }
 function parseQuestion(value, questions) {
-  if (!isRecord11(value))
+  if (!isRecord12(value))
     return null;
   const question = stringField4(value, "question");
   if (!question || questions.has(question))
@@ -22482,7 +22650,7 @@ function parseQuestion(value, questions) {
   };
 }
 function parseGrokAskUserQuestionParams(params) {
-  if (!isRecord11(params))
+  if (!isRecord12(params))
     return null;
   const rawQuestions = questionsPayload(params);
   if (!Array.isArray(rawQuestions) || rawQuestions.length === 0)
@@ -22597,16 +22765,16 @@ var GrokTransportError = class extends Error {
     this.name = "GrokTransportError";
   }
 };
-function isRecord12(value) {
+function isRecord13(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function acpToolName(update, metadata) {
-  if (!isRecord12(update))
+  if (!isRecord13(update))
     return void 0;
   if (typeof update.name === "string" && update.name.length > 0)
     return update.name;
-  const meta3 = isRecord12(update._meta) ? update._meta : metadata;
-  const tool = meta3 && isRecord12(meta3["x.ai/tool"]) ? meta3["x.ai/tool"] : void 0;
+  const meta3 = isRecord13(update._meta) ? update._meta : metadata;
+  const tool = meta3 && isRecord13(meta3["x.ai/tool"]) ? meta3["x.ai/tool"] : void 0;
   return tool && typeof tool.name === "string" && tool.name.length > 0 ? tool.name : void 0;
 }
 function errorText(error53) {
@@ -22662,7 +22830,7 @@ function signalProcessTree(child, signal) {
   try {
     process.kill(-child.pid, signal);
   } catch (error53) {
-    if (!isRecord12(error53) || error53.code !== "ESRCH")
+    if (!isRecord13(error53) || error53.code !== "ESRCH")
       throw error53;
   }
 }
@@ -22757,7 +22925,7 @@ async function readNativeSignals(options, sessionId) {
   }
 }
 function isMissingFile(error53) {
-  return isRecord12(error53) && error53.code === "ENOENT";
+  return isRecord13(error53) && error53.code === "ENOENT";
 }
 async function locateGrokNativeSession(options, sessionId) {
   if (sessionId.length === 0)
@@ -22780,7 +22948,7 @@ async function locateGrokNativeSession(options, sessionId) {
     try {
       summaryRaw = await readFile2(path9.join(grokHomeDir(options), "sessions", entry.name, sessionId, "summary.json"), "utf8");
     } catch (error53) {
-      if (isMissingFile(error53) || isRecord12(error53) && error53.code === "ENOTDIR")
+      if (isMissingFile(error53) || isRecord13(error53) && error53.code === "ENOTDIR")
         continue;
       throw new GrokTransportError("unavailable", "Grok Native Session metadata could not be read", {
         cause: error53
@@ -22792,10 +22960,10 @@ async function locateGrokNativeSession(options, sessionId) {
     } catch {
       continue;
     }
-    if (!isRecord12(parsed))
+    if (!isRecord13(parsed))
       continue;
     const info = parsed.info;
-    const cwd = isRecord12(info) && typeof info.cwd === "string" && info.cwd.length > 0 ? path9.resolve(info.cwd) : path9.resolve(decodeURIComponent(entry.name));
+    const cwd = isRecord13(info) && typeof info.cwd === "string" && info.cwd.length > 0 ? path9.resolve(info.cwd) : path9.resolve(decodeURIComponent(entry.name));
     const sourceWorkspaceDir = typeof parsed.source_workspace_dir === "string" && parsed.source_workspace_dir.length > 0 ? path9.resolve(parsed.source_workspace_dir) : void 0;
     matches.push({
       cwd,
@@ -22828,12 +22996,12 @@ function parseNativeHistory(contents, sessionId) {
     } catch {
       throw new GrokTransportError("protocolError", "Grok Native history contains invalid JSON");
     }
-    if (!isRecord12(record2) || !isRecord12(record2.params))
+    if (!isRecord13(record2) || !isRecord13(record2.params))
       continue;
     const params = record2.params;
-    if (params.sessionId !== sessionId || !isRecord12(params.update))
+    if (params.sessionId !== sessionId || !isRecord13(params.update))
       continue;
-    const metadata = isRecord12(params._meta) ? params._meta : void 0;
+    const metadata = isRecord13(params._meta) ? params._meta : void 0;
     const event = transportEvent(params.update, metadata);
     if (event)
       events.push(metadata ? { ...event, metadata } : event);
@@ -22851,6 +23019,7 @@ var GrokAcpTransport = class {
   #initialize = null;
   #replay = null;
   #sessionId = null;
+  #availableCommands = null;
   #startupModelId;
   #stderrTail = "";
   constructor(options) {
@@ -23139,7 +23308,7 @@ var GrokAcpTransport = class {
       modelId,
       ...reasoningEffort ? { reasoningEffort } : {}
     });
-    if (!isRecord12(response) || !isRecord12(response._meta) || !isRecord12(response._meta.model)) {
+    if (!isRecord13(response) || !isRecord13(response._meta) || !isRecord13(response._meta.model)) {
       throw new GrokTransportError("protocolError", "Grok rejected Model configuration");
     }
     const selected = response._meta.model.Ok;
@@ -23179,10 +23348,19 @@ var GrokAcpTransport = class {
     this.#activePrompt = null;
     this.#activeCompact = null;
   }
+  /** Latest ACP `available_commands_update` of the open Session, if any. */
+  get availableCommands() {
+    return this.#availableCommands;
+  }
   #handleUpdate(notification) {
     if (this.#sessionId && notification.sessionId !== this.#sessionId)
       return;
-    const metadata = isRecord12(notification._meta) ? notification._meta : void 0;
+    const update = notification.update;
+    if (update.sessionUpdate === "available_commands_update") {
+      this.#availableCommands = parseGrokAvailableCommands(update.availableCommands);
+      return;
+    }
+    const metadata = isRecord13(notification._meta) ? notification._meta : void 0;
     const event = transportEvent(notification.update, metadata);
     if (!event)
       return;
@@ -23197,7 +23375,7 @@ var GrokAcpTransport = class {
   #handleExtensionNotification(method, params) {
     if (!isGrokExtensionSessionUpdateMethod(method))
       return;
-    if (typeof params.sessionId !== "string" || !isRecord12(params.update))
+    if (typeof params.sessionId !== "string" || !isRecord13(params.update))
       return;
     this.#handleUpdate(params);
   }
@@ -23417,7 +23595,7 @@ var GrokSubagentLifecycle = class {
 };
 
 // dist/grok-models.js
-function isRecord13(value) {
+function isRecord14(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function nonBlank(value) {
@@ -23429,7 +23607,7 @@ function thinkingOptions(value) {
   const seen = /* @__PURE__ */ new Set();
   const options = [];
   for (const candidate of value) {
-    if (!isRecord13(candidate) || !nonBlank(candidate.label))
+    if (!isRecord14(candidate) || !nonBlank(candidate.label))
       continue;
     const id = harnessThinkingOptionIdSchema.safeParse(candidate.id ?? candidate.value);
     if (!id.success || seen.has(id.data))
@@ -23440,7 +23618,7 @@ function thinkingOptions(value) {
   return options;
 }
 function parseGrokModelState(value) {
-  if (!isRecord13(value) || !nonBlank(value.currentModelId) || !Array.isArray(value.availableModels)) {
+  if (!isRecord14(value) || !nonBlank(value.currentModelId) || !Array.isArray(value.availableModels)) {
     return null;
   }
   const currentModel = harnessModelRefSchema.safeParse({ id: value.currentModelId });
@@ -23451,12 +23629,12 @@ function parseGrokModelState(value) {
   const models = [];
   let currentThinkingOptionId;
   for (const candidate of value.availableModels) {
-    if (!isRecord13(candidate) || !nonBlank(candidate.modelId) || !nonBlank(candidate.name))
+    if (!isRecord14(candidate) || !nonBlank(candidate.modelId) || !nonBlank(candidate.name))
       continue;
     const ref = harnessModelRefSchema.safeParse({ id: candidate.modelId });
     if (!ref.success)
       continue;
-    const metadata = isRecord13(candidate._meta) ? candidate._meta : {};
+    const metadata = isRecord14(candidate._meta) ? candidate._meta : {};
     const options2 = thinkingOptions(metadata.reasoningEfforts);
     if (typeof metadata.totalContextTokens === "number" && Number.isSafeInteger(metadata.totalContextTokens) && metadata.totalContextTokens > 0) {
       contextWindowTokensByModel.set(ref.data.id, metadata.totalContextTokens);
@@ -23491,10 +23669,10 @@ function parseGrokModelState(value) {
   };
 }
 function modelStateFromInitialize(response) {
-  return parseGrokModelState(isRecord13(response._meta) ? response._meta.modelState : void 0);
+  return parseGrokModelState(isRecord14(response._meta) ? response._meta.modelState : void 0);
 }
 function modelStateFromSessionResponse(response) {
-  return parseGrokModelState(isRecord13(response) ? response.models : void 0);
+  return parseGrokModelState(isRecord14(response) ? response.models : void 0);
 }
 function stateForGrokModel(modelState, nativeState, model = modelState.currentModel, thinkingOptionId = modelState.currentThinkingOptionId, permissionModeId) {
   const selectedModel = model;
@@ -23518,7 +23696,7 @@ import os5 from "node:os";
 import path10 from "node:path";
 var GROK_CREDITS_ENDPOINT = "https://cli-chat-proxy.grok.com/v1/billing?format=credits";
 var REQUEST_TIMEOUT_MS = 15e3;
-function isRecord14(value) {
+function isRecord15(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function finitePercent(value) {
@@ -23527,7 +23705,7 @@ function finitePercent(value) {
   return Math.min(100, Math.max(0, value));
 }
 function nonNegativeCentValue(value) {
-  if (!isRecord14(value))
+  if (!isRecord15(value))
     return void 0;
   const amount = value.val === void 0 ? 0 : value.val;
   if (typeof amount !== "number" || !Number.isFinite(amount) || amount < 0)
@@ -23551,7 +23729,7 @@ function productUsageFrom(value) {
   if (!Array.isArray(value))
     return void 0;
   const products = value.flatMap((entry) => {
-    if (!isRecord14(entry) || typeof entry.product !== "string")
+    if (!isRecord15(entry) || typeof entry.product !== "string")
       return [];
     const usagePercent = finitePercent(entry.usagePercent);
     return usagePercent === void 0 ? [] : [{ product: entry.product, usagePercent }];
@@ -23559,10 +23737,10 @@ function productUsageFrom(value) {
   return products.length > 0 ? products : void 0;
 }
 function parseGrokCreditsResponse(value, fetchedAt = (/* @__PURE__ */ new Date()).toISOString()) {
-  if (!isRecord14(value) || !isRecord14(value.config))
+  if (!isRecord15(value) || !isRecord15(value.config))
     return null;
   const config2 = value.config;
-  const period = isRecord14(config2.currentPeriod) ? config2.currentPeriod : void 0;
+  const period = isRecord15(config2.currentPeriod) ? config2.currentPeriod : void 0;
   const periodType = periodTypeFrom(period?.type);
   const resetsAt = (typeof period?.end === "string" && period.end.length > 0 ? period.end : void 0) ?? (typeof config2.billingPeriodEnd === "string" && config2.billingPeriodEnd.length > 0 ? config2.billingPeriodEnd : void 0);
   let usedPercent = finitePercent(config2.creditUsagePercent);
@@ -23589,11 +23767,11 @@ function parseGrokCreditsResponse(value, fetchedAt = (/* @__PURE__ */ new Date()
   };
 }
 function selectAccessToken(auth, now) {
-  if (!isRecord14(auth))
+  if (!isRecord15(auth))
     return null;
-  const entries = Object.entries(auth).filter(([issuer, value]) => (issuer === "https://auth.x.ai" || issuer.startsWith("https://auth.x.ai::")) && isRecord14(value) && typeof value.key === "string" && value.key.length > 0).sort(([left], [right]) => Number(right.startsWith("https://auth.x.ai")) - Number(left.startsWith("https://auth.x.ai")));
+  const entries = Object.entries(auth).filter(([issuer, value]) => (issuer === "https://auth.x.ai" || issuer.startsWith("https://auth.x.ai::")) && isRecord15(value) && typeof value.key === "string" && value.key.length > 0).sort(([left], [right]) => Number(right.startsWith("https://auth.x.ai")) - Number(left.startsWith("https://auth.x.ai")));
   for (const [, value] of entries) {
-    if (!isRecord14(value) || typeof value.key !== "string")
+    if (!isRecord15(value) || typeof value.key !== "string")
       continue;
     if (typeof value.expires_at === "string") {
       const expiresAt = Date.parse(value.expires_at);
@@ -23665,7 +23843,7 @@ async function fetchGrokCredits(input = {}) {
 
 // dist/grok-usage.js
 var USD_TICKS_PER_DOLLAR = 1e10;
-function isRecord15(value) {
+function isRecord16(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function optionalToken(value) {
@@ -23682,7 +23860,7 @@ function combineUsage(base, next) {
   return base === null ? next : parseHostUsage({ ...base, ...next });
 }
 function usageFromNative(value) {
-  if (!isRecord15(value))
+  if (!isRecord16(value))
     return null;
   const nativeInputTokens = optionalToken(value.inputTokens);
   const cachedRead = optionalToken(value.cachedReadTokens);
@@ -23711,7 +23889,7 @@ function usageFromPrompt(response) {
   return response.usage ? usageFromNative(response.usage) : null;
 }
 function usageFromSignals(value) {
-  if (!isRecord15(value))
+  if (!isRecord16(value))
     return null;
   try {
     return parseHostUsage({
@@ -23731,7 +23909,7 @@ var summedUsageFields = [
   "totalTokens"
 ];
 function nativeCostTicks(value) {
-  if (!isRecord15(value))
+  if (!isRecord16(value))
     return void 0;
   const ticks = value.costUsdTicks;
   if (typeof ticks !== "number" || !Number.isSafeInteger(ticks) || ticks < 0)
@@ -23808,7 +23986,7 @@ function usageFromCompact(tokensAfter, contextWindowTokens) {
 function usageFromUpdate(update, metadata, contextWindowTokens) {
   try {
     if (update?.sessionUpdate === "usage_update") {
-      const cost = isRecord15(update.cost) ? update.cost : null;
+      const cost = isRecord16(update.cost) ? update.cost : null;
       return parseHostUsage({
         contextUsedTokens: update.used,
         contextWindowTokens: update.size,
@@ -23955,7 +24133,7 @@ var GrokHarnessSession = class {
     this.#usage = this.initialUsage;
     this.capabilities = capabilitiesForModels(modelState);
     this.commands = {
-      list: async () => ({ ok: true, value: grokCommandCatalog }),
+      list: async () => ({ ok: true, value: this.#liveCommandCatalog() }),
       execute: (command) => this.#executeHarnessCommand(command)
     };
     this.#state = stateForGrokModel(modelState, { nativeRef: nativeRef(opened.sessionId) }, modelState.currentModel, modelState.currentThinkingOptionId, options.initialPermissionModeId);
@@ -24068,7 +24246,21 @@ var GrokHarnessSession = class {
     }));
     return { ok: true, value: { turnId: command.turnId } };
   }
+  /** Built-ins plus the commands, workflows and skills the open Session advertises. */
+  #liveCommandCatalog() {
+    const native = this.#transport.availableCommands ?? null;
+    return mergeLiveHarnessCommands(grokCommandCatalog, GROK_LIVE_COMMAND_ID_PREFIX, native ? grokLiveCommands(native) : null);
+  }
   async #executeHarnessCommand(command) {
+    const livePrompt = liveHarnessCommandPrompt(this.#liveCommandCatalog(), GROK_LIVE_COMMAND_ID_PREFIX, command.commandId, command.arguments?.text);
+    if (livePrompt !== null) {
+      const started = await this.execute({
+        type: "turn.start",
+        turnId: command.turnId,
+        input: [{ type: "text", text: livePrompt }]
+      });
+      return started.ok ? { ok: true, value: { turnId: command.turnId } } : started;
+    }
     if (command.commandId !== "grok.compact") {
       return {
         ok: false,
@@ -24899,6 +25091,7 @@ var GrokAdapter = class {
     read: () => this.#closePromise ? Promise.resolve([]) : readGrokCredentials(this.#environment ?? process.env)
   };
   commandCatalog = grokCommandCatalog;
+  liveCommandCatalog = true;
   harnessId = grokHarnessId;
   subagents = {
     readSnapshot: async (input) => {