terminal-pilot 0.0.22 → 0.0.24

package/dist/cli.js

@@ -2707,6 +2707,11 @@ function getCommandSourcePath(command) {
   return command[commandSourcePathSymbol];
 }
 
+// ../toolcraft/src/error-codes.ts
+function hasOwnErrorCode(error3, code) {
+  return typeof error3 === "object" && error3 !== null && Object.prototype.hasOwnProperty.call(error3, "code") && error3.code === code;
+}
+
 // ../task-list/src/open.ts
 import * as fsPromises from "node:fs/promises";
 
@@ -2875,10 +2880,12 @@ import path5 from "node:path";
 // ../process-runner/src/host/host-runner.ts
 import { spawn as spawnChildProcess } from "node:child_process";
 function createHostRunner(options = {}) {
-  const detachedByDefault = options.detached === true;
+  const runnerOptions = normalizeHostRunnerOptions(options);
+  const detachedByDefault = runnerOptions.detached === true;
   return {
     name: "host",
-    exec(spec) {
+    exec(inputSpec) {
+      const spec = normalizeRunSpec(inputSpec);
       if (spec.signal?.aborted === true) {
         return {
           pid: null,
@@ -2895,12 +2902,16 @@ function createHostRunner(options = {}) {
       const stderrMode = spec.stderr ?? "pipe";
       const killProcessGroup = detachedByDefault || spec.killProcessGroup === true;
       const stdio = stdinMode === "inherit" && stdoutMode === "inherit" && stderrMode === "inherit" ? "inherit" : [stdinMode, stdoutMode, stderrMode];
-      const child = spawnChildProcess(spec.command, spec.args ?? [], {
-        cwd: spec.cwd,
-        env: spec.env,
-        stdio,
-        ...killProcessGroup ? { detached: true } : {}
-      });
+      const child = spawnChildProcess(
+        spec.command,
+        spec.args ?? [],
+        createNullRecord({
+          cwd: spec.cwd,
+          env: spec.env,
+          stdio,
+          ...killProcessGroup ? { detached: true } : {}
+        })
+      );
       if (killProcessGroup) {
         child.unref();
       }
@@ -2946,6 +2957,38 @@ function createHostRunner(options = {}) {
     }
   };
 }
+function normalizeHostRunnerOptions(options) {
+  return createNullRecord({
+    ...optionalOwnProperty(options, "detached")
+  });
+}
+function normalizeRunSpec(spec) {
+  return createNullRecord({
+    command: getOwnProperty(spec, "command"),
+    ...optionalOwnProperty(spec, "args"),
+    ...optionalOwnProperty(spec, "cwd"),
+    ...optionalOwnProperty(spec, "env"),
+    ...optionalOwnProperty(spec, "stdin"),
+    ...optionalOwnProperty(spec, "stdout"),
+    ...optionalOwnProperty(spec, "stderr"),
+    ...optionalOwnProperty(spec, "tty"),
+    ...optionalOwnProperty(spec, "signal"),
+    ...optionalOwnProperty(spec, "killProcessGroup")
+  });
+}
+function optionalOwnProperty(value, name) {
+  const property = getOwnProperty(value, name);
+  return property === void 0 ? {} : { [name]: property };
+}
+function getOwnProperty(value, name) {
+  return hasOwnProperty(value, name) ? value[name] : void 0;
+}
+function hasOwnProperty(value, name) {
+  return Object.prototype.hasOwnProperty.call(value, name);
+}
+function createNullRecord(value) {
+  return Object.assign(/* @__PURE__ */ Object.create(null), value);
+}
 function bindAbortSignal(signal, onAbort) {
   if (signal === void 0) {
     return () => {
@@ -5839,51 +5882,74 @@ function createDefaultFs() {
   return fsPromises;
 }
 async function openTaskList(options) {
-  switch (options.type) {
+  const type2 = getOwnProperty2(options, "type");
+  switch (type2) {
     case "markdown-dir":
     case "yaml-file":
       return openFileBackend(options);
     case "gh-issues":
       return openGhIssuesBackend(options);
     default:
-      throw new Error(`Unknown task list backend type "${options.type}".`);
+      throw new Error(`Unknown task list backend type "${String(type2)}".`);
   }
 }
 async function openFileBackend(options) {
-  const factory = backendFactories[options.type];
-  const stateMachine = resolveStateMachine(options.stateMachine);
+  const type2 = getOwnProperty2(options, "type");
+  const factory = backendFactories[type2];
+  const stateMachine = resolveStateMachine(
+    getOwnProperty2(options, "stateMachine")
+  );
   validateMachine(stateMachine);
-  const markdownOptions = options.type === "markdown-dir" ? options : void 0;
+  const markdownOptions = type2 === "markdown-dir" ? options : void 0;
+  const defaults2 = getOwnProperty2(options, "defaults");
   const deps = {
-    path: options.path,
+    path: getOwnProperty2(options, "path"),
     defaults: {
-      metadata: { ...options.defaults?.metadata ?? {} }
+      metadata: readDefaultMetadata(defaults2)
     },
-    singleList: markdownOptions?.singleList,
-    frontmatterMode: markdownOptions?.frontmatterMode ?? "strict",
-    create: options.create ?? false,
-    fs: options.fs ?? createDefaultFs(),
+    singleList: markdownOptions === void 0 ? void 0 : getOwnProperty2(markdownOptions, "singleList"),
+    frontmatterMode: markdownOptions === void 0 ? "strict" : getOwnProperty2(
+      markdownOptions,
+      "frontmatterMode"
+    ) ?? "strict",
+    create: getOwnProperty2(options, "create") ?? false,
+    fs: getOwnProperty2(options, "fs") ?? createDefaultFs(),
     stateMachine
   };
   return factory(deps);
 }
 async function openGhIssuesBackend(options) {
-  const token = await resolveAuth({ explicitToken: options.auth?.token });
+  const auth = getOwnProperty2(options, "auth");
+  const explicitToken = auth && hasOwnProperty2(auth, "token") ? auth.token : void 0;
   const endpoint = resolveEndpoint();
+  const defaults2 = getOwnProperty2(options, "defaults");
   return ghIssuesBackend({
-    repo: options.repo,
-    project: options.project,
-    filter: options.filter,
-    state: options.state,
-    stateMachine: options.stateMachine,
+    repo: getOwnProperty2(options, "repo"),
+    project: getOwnProperty2(options, "project"),
+    filter: getOwnProperty2(options, "filter"),
+    state: getOwnProperty2(options, "state"),
+    stateMachine: getOwnProperty2(options, "stateMachine"),
     defaults: {
-      metadata: { ...options.defaults?.metadata ?? {} }
+      metadata: readDefaultMetadata(defaults2)
     },
-    token,
+    token: await resolveAuth({ explicitToken }),
     endpoint,
-    fetch: options.fetch
+    fetch: getOwnProperty2(options, "fetch")
   });
 }
+function readDefaultMetadata(defaults2) {
+  const metadata = defaults2 === void 0 ? void 0 : getOwnProperty2(defaults2, "metadata");
+  return isRecord4(metadata) ? { ...metadata } : {};
+}
+function getOwnProperty2(value, name) {
+  return hasOwnProperty2(value, name) ? value[name] : void 0;
+}
+function hasOwnProperty2(value, name) {
+  return Object.prototype.hasOwnProperty.call(value, name);
+}
+function isRecord4(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 
 // ../task-list/src/move.ts
 import * as fsPromises2 from "node:fs/promises";
@@ -6141,7 +6207,7 @@ function osascriptProvider(options = {}) {
         const { stdout } = await execFileAsync(binary, ["-e", script]);
         return parseStdout(stdout);
       } catch (error3) {
-        if (error3.code === "ENOENT") {
+        if (hasOwnErrorCode2(error3, "ENOENT")) {
           throw new Error("osascript not found \u2014 provide a different provider on this platform");
         }
         if (isUserCanceled(error3)) {
@@ -6153,6 +6219,9 @@ function osascriptProvider(options = {}) {
     }
   };
 }
+function hasOwnErrorCode2(error3, code) {
+  return typeof error3 === "object" && error3 !== null && Object.prototype.hasOwnProperty.call(error3, "code") && error3.code === code;
+}
 
 // ../toolcraft/src/human-in-loop/default-provider.ts
 function noProviderConfigured() {
@@ -6710,7 +6779,7 @@ function escapeMarkdownCell(value) {
   return value.replaceAll("|", "\\|");
 }
 function isMissingStateError(error3) {
-  return typeof error3 === "object" && error3 !== null && "code" in error3 && error3.code === "ENOENT";
+  return hasOwnErrorCode(error3, "ENOENT");
 }
 
 // ../toolcraft/src/error-report.ts
@@ -6739,6 +6808,13 @@ import { createCipheriv, createDecipheriv, randomBytes as randomBytes4, randomUU
 import { promises as fs } from "node:fs";
 import { homedir, hostname, userInfo } from "node:os";
 import path10 from "node:path";
+
+// ../auth-store/src/error-codes.ts
+function hasOwnErrorCode3(error3, code) {
+  return error3 instanceof Error && Object.prototype.hasOwnProperty.call(error3, "code") && error3.code === code;
+}
+
+// ../auth-store/src/encrypted-file-store.ts
 var derivedKeyCache = /* @__PURE__ */ new Map();
 var ENCRYPTION_ALGORITHM = "aes-256-gcm";
 var ENCRYPTION_VERSION = 1;
@@ -6954,7 +7030,7 @@ async function deriveEncryptionKey(getMachineIdentity, salt) {
 function parseEncryptedDocument(raw) {
   try {
     const parsed = JSON.parse(raw);
-    if (!isRecord4(parsed)) {
+    if (!isRecord5(parsed)) {
       return null;
     }
     const version = getOwnEntry2(parsed, "version");
@@ -6977,21 +7053,17 @@ function parseEncryptedDocument(raw) {
     return null;
   }
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function getOwnEntry2(record, key2) {
   return Object.prototype.hasOwnProperty.call(record, key2) ? record[key2] : void 0;
 }
 function isNotFoundError(error3) {
-  return Boolean(
-    error3 && typeof error3 === "object" && Object.prototype.hasOwnProperty.call(error3, "code") && error3.code === "ENOENT"
-  );
+  return hasOwnErrorCode3(error3, "ENOENT");
 }
 function isAlreadyExistsError(error3) {
-  return Boolean(
-    error3 && typeof error3 === "object" && Object.prototype.hasOwnProperty.call(error3, "code") && error3.code === "EEXIST"
-  );
+  return hasOwnErrorCode3(error3, "EEXIST");
 }
 
 // ../auth-store/src/keychain-store.ts
@@ -10986,8 +11058,7 @@ async function readCache(cachePath) {
       version: parsed.version === 1 ? 1 : 1
     };
   } catch (error3) {
-    const code = error3.code;
-    if (code === "ENOENT" || error3 instanceof SyntaxError) {
+    if (hasOwnErrorCode(error3, "ENOENT") || error3 instanceof SyntaxError) {
       return void 0;
     }
     return void 0;
@@ -11020,9 +11091,7 @@ async function writeCache(cachePath, cache) {
   }
 }
 function isAlreadyExistsError2(error3) {
-  return Boolean(
-    error3 && typeof error3 === "object" && error3.code === "EEXIST"
-  );
+  return hasOwnErrorCode(error3, "EEXIST");
 }
 async function fetchCache(name, config2) {
   const logger2 = createLogger((message2) => {
@@ -11226,7 +11295,7 @@ async function assertCachePathHasNoSymlinks(filePath) {
         throw new Error(`MCP cache path must not contain symbolic links: ${currentPath}.`);
       }
     } catch (error3) {
-      if (error3.code !== "ENOENT") {
+      if (!hasOwnErrorCode(error3, "ENOENT")) {
         throw error3;
       }
     }
@@ -12674,7 +12743,7 @@ function getJsonParseErrorLocation(error3, source) {
   return null;
 }
 function getJsonParseCauseLocation(error3) {
-  if (typeof error3 !== "object" || error3 === null || !("cause" in error3)) {
+  if (typeof error3 !== "object" || error3 === null || !hasOwnProperty3(error3, "cause")) {
     return null;
   }
   const cause = error3.cause;
@@ -12686,7 +12755,7 @@ function getJsonParseCauseLocation(error3) {
   return { line, column };
 }
 function getNumericProperty(value, key2) {
-  if (typeof value !== "object" || value === null || !(key2 in value)) {
+  if (typeof value !== "object" || value === null || !hasOwnProperty3(value, key2)) {
     return null;
   }
   const propertyValue = value[key2];
@@ -12817,9 +12886,31 @@ function createOption(field, globalLongOptionFlags) {
   const option = createCommanderOption(`${flags} <value>`, field.description, field);
   return [option];
 }
-var ALWAYS_GLOBAL_LONG_OPTION_FLAGS = ["--yes", "--output", "--debug", "--verbose"];
-function getGlobalLongOptionFlags(presetsEnabled, versionEnabled = false) {
-  const flags = presetsEnabled ? ["--preset", ...ALWAYS_GLOBAL_LONG_OPTION_FLAGS] : [...ALWAYS_GLOBAL_LONG_OPTION_FLAGS];
+function resolveCLIControls(controls) {
+  return {
+    debug: controls?.debug === true,
+    output: controls?.output === true,
+    verbose: controls?.verbose === true,
+    yes: controls?.yes === true
+  };
+}
+function getGlobalLongOptionFlags(presetsEnabled, versionEnabled, controls) {
+  const flags = [];
+  if (presetsEnabled) {
+    flags.push("--preset");
+  }
+  if (controls.yes) {
+    flags.push("--yes");
+  }
+  if (controls.output) {
+    flags.push("--output");
+  }
+  if (controls.debug) {
+    flags.push("--debug");
+  }
+  if (controls.verbose) {
+    flags.push("--verbose");
+  }
   if (versionEnabled) {
     flags.push("--version");
   }
@@ -13201,11 +13292,16 @@ function formatGlobalOptionsLine(ctx) {
   if (ctx.presetsEnabled) {
     flags.push("--preset <path>");
   }
-  flags.push("--yes", "--output <format>");
+  if (ctx.controls.yes) {
+    flags.push("--yes");
+  }
+  if (ctx.controls.output) {
+    flags.push("--output <format>");
+  }
   if (ctx.showVersion) {
     flags.push("--version");
   }
-  return `${text.section("Options:")} ${flags.join("  ")}`;
+  return flags.length > 0 ? `${text.section("Options:")} ${flags.join("  ")}` : "";
 }
 function collectSchemaGlobalFieldRows(group, scope, casing, globalLongOptionFlags) {
   const seen = /* @__PURE__ */ new Map();
@@ -13257,7 +13353,8 @@ function renderGroupHelp(group, breadcrumb, scope, casing, globalOptions, rootUs
   const sections = [];
   const globalLongOptionFlags = getGlobalLongOptionFlags(
     globalOptions.presetsEnabled,
-    globalOptions.showVersion
+    globalOptions.showVersion,
+    globalOptions.controls
   );
   const commandRows = formatCommandRows(group, scope, casing, globalLongOptionFlags);
   if (commandRows.length > 0) {
@@ -13295,7 +13392,8 @@ function renderLeafHelp(command, breadcrumb, casing, globalOptions, rootUsageNam
   const sections = [];
   const globalLongOptionFlags = getGlobalLongOptionFlags(
     globalOptions.presetsEnabled,
-    globalOptions.showVersion
+    globalOptions.showVersion,
+    globalOptions.controls
   );
   const collected = collectFields(command.params, casing, globalLongOptionFlags);
   const fields = assignPositionals(collected.fields, command.positional);
@@ -13352,6 +13450,7 @@ async function renderGeneratedHelp(root, argv, options) {
   const output = resolveHelpOutput(argv);
   const casing = options.casing ?? "kebab";
   const rootUsageName = options.rootUsageName ?? inferProgramName(argv);
+  const controls = resolveCLIControls(options.controls);
   await withOutputFormat2(output, async () => {
     const rendered = target.node.kind === "group" ? renderGroupHelp(
       target.node,
@@ -13359,6 +13458,7 @@ async function renderGeneratedHelp(root, argv, options) {
       "cli",
       casing,
       {
+        controls,
         showVersion: options.version !== void 0,
         presetsEnabled: options.presets === true
       },
@@ -13369,6 +13469,7 @@ async function renderGeneratedHelp(root, argv, options) {
       target.breadcrumb,
       casing,
       {
+        controls,
         showVersion: options.version !== void 0,
         presetsEnabled: options.presets === true
       },
@@ -13377,7 +13478,7 @@ async function renderGeneratedHelp(root, argv, options) {
     process.stdout.write(rendered);
   });
 }
-function createNodeCommand(node, casing, globalLongOptionFlags, execute, presetsEnabled, pathSegments = []) {
+function createNodeCommand(node, casing, globalLongOptionFlags, execute, presetsEnabled, controls, pathSegments = []) {
   const nextPathSegments = [...pathSegments, node.name];
   if (node.kind === "command") {
     if (!node.scope.includes("cli")) {
@@ -13392,7 +13493,7 @@ function createNodeCommand(node, casing, globalLongOptionFlags, execute, presets
     }
     node.aliases.forEach((alias) => command.alias(alias));
     command.addHelpCommand(false);
-    addGlobalOptions(command, presetsEnabled);
+    addGlobalOptions(command, presetsEnabled, controls);
     command.allowExcessArguments(true);
     if (collected.dynamicFields.length > 0) {
       command.allowUnknownOption(true);
@@ -13434,6 +13535,7 @@ function createNodeCommand(node, casing, globalLongOptionFlags, execute, presets
       globalLongOptionFlags,
       execute,
       presetsEnabled,
+      controls,
       nextPathSegments
     )
   ).filter((child) => child !== null);
@@ -13443,39 +13545,47 @@ function createNodeCommand(node, casing, globalLongOptionFlags, execute, presets
   }
   node.aliases.forEach((alias) => group.alias(alias));
   group.addHelpCommand(false);
-  addGlobalOptions(group, presetsEnabled);
+  addGlobalOptions(group, presetsEnabled, controls);
   for (const child of visibleChildren) {
     const isDefaultChild = node.default !== void 0 && node.default.scope.includes("cli") && (child.name() === node.default.name || child.aliases().includes(node.default.name));
     group.addCommand(child, isDefaultChild ? { isDefault: true } : void 0);
   }
   return group;
 }
-function addGlobalOptions(command, presetsEnabled) {
+function addGlobalOptions(command, presetsEnabled, controls) {
   const options = [];
   if (presetsEnabled) {
     options.push(new Option("--preset <path>", "Load parameter defaults from a JSON file."));
   }
-  options.push(new Option("--yes", "Accept defaults and skip prompts."));
-  options.push(
-    new Option("--output <format>", "Output format.").argParser((value) => {
-      if (value === "rich" || value === "md" || value === "json") {
-        return value;
-      }
-      if (value === "markdown") {
-        return "md";
-      }
-      throw new InvalidArgumentError(
-        formatInvalidEnumMessage("--output", value, ["rich", "md", "markdown", "json"], {
-          candidates: ["rich", "markdown", "json"],
-          threshold: 3
-        })
-      );
-    })
-  );
-  options.push(
-    new Option("--debug [mode]", "Print stack traces for unexpected errors.").preset("trim").argParser(parseDebugStackMode)
-  );
-  options.push(new Option("--verbose", "Print detailed runtime diagnostics."));
+  if (controls.yes) {
+    options.push(new Option("--yes", "Accept defaults and skip prompts."));
+  }
+  if (controls.output) {
+    options.push(
+      new Option("--output <format>", "Output format.").argParser((value) => {
+        if (value === "rich" || value === "md" || value === "json") {
+          return value;
+        }
+        if (value === "markdown") {
+          return "md";
+        }
+        throw new InvalidArgumentError(
+          formatInvalidEnumMessage("--output", value, ["rich", "md", "markdown", "json"], {
+            candidates: ["rich", "markdown", "json"],
+            threshold: 3
+          })
+        );
+      })
+    );
+  }
+  if (controls.debug) {
+    options.push(
+      new Option("--debug [mode]", "Print stack traces for unexpected errors.").preset("trim").argParser(parseDebugStackMode)
+    );
+  }
+  if (controls.verbose) {
+    options.push(new Option("--verbose", "Print detailed runtime diagnostics."));
+  }
   for (const option of options) {
     option.hideHelp(true);
     command.addOption(option);
@@ -13743,7 +13853,7 @@ async function loadPresetValues(fields, presetPath) {
       encoding: "utf8"
     });
   } catch (error3) {
-    if (typeof error3 === "object" && error3 !== null && "code" in error3 && error3.code === "ENOENT") {
+    if (hasOwnErrorCode(error3, "ENOENT")) {
       throw new UserError(`Preset file "${presetPath}" was not found.`);
     }
     const message2 = error3 instanceof Error && error3.message.length > 0 ? error3.message : "Unknown read error.";
@@ -14842,10 +14952,10 @@ function isHttpErrorLike(error3) {
   }
   const request = error3.request;
   const response = error3.response;
-  return isPlainObject4(request) && typeof request.method === "string" && typeof request.url === "string" && isStringRecord(request.headers) && isPlainObject4(response) && typeof response.status === "number" && typeof response.statusText === "string" && isStringRecord(response.headers) && "body" in response;
+  return isPlainObject4(request) && typeof request.method === "string" && typeof request.url === "string" && isStringRecord(request.headers) && isPlainObject4(response) && typeof response.status === "number" && typeof response.statusText === "string" && isStringRecord(response.headers) && hasOwnProperty3(response, "body");
 }
 function hasTypedOptionalField(value, field, type2) {
-  return !(field in value) || typeof value[field] === type2;
+  return !hasOwnProperty3(value, field) || typeof value[field] === type2;
 }
 function isNonEmptyString(value) {
   return typeof value === "string" && value.trim().length > 0;
@@ -14869,7 +14979,7 @@ function isProblemDetailsLike(body) {
   if (!hasTypedOptionalField(body, "instance", "string")) {
     return false;
   }
-  return isNonEmptyString(body.title) || isNonEmptyString(body.detail);
+  return hasOwnNonEmptyString(body, "title") || hasOwnNonEmptyString(body, "detail");
 }
 function isGraphQLErrorEnvelopeLike(body) {
   if (!isPlainObject4(body) || !Array.isArray(body.errors) || body.errors.length === 0) {
@@ -14879,23 +14989,29 @@ function isGraphQLErrorEnvelopeLike(body) {
     if (!isPlainObject4(error3) || typeof error3.message !== "string") {
       return false;
     }
-    if ("path" in error3) {
+    if (hasOwnProperty3(error3, "path")) {
       const pathValue = error3.path;
       if (!Array.isArray(pathValue) || !pathValue.every((entry) => typeof entry === "string" || typeof entry === "number")) {
         return false;
       }
     }
-    if ("extensions" in error3) {
+    if (hasOwnProperty3(error3, "extensions")) {
       if (!isPlainObject4(error3.extensions)) {
         return false;
       }
-      if ("code" in error3.extensions && typeof error3.extensions.code !== "string") {
+      if (hasOwnProperty3(error3.extensions, "code") && typeof error3.extensions.code !== "string") {
         return false;
       }
     }
     return true;
   });
 }
+function hasOwnProperty3(value, name) {
+  return Object.prototype.hasOwnProperty.call(value, name);
+}
+function hasOwnNonEmptyString(value, name) {
+  return hasOwnProperty3(value, name) && isNonEmptyString(value[name]);
+}
 function styleHttpErrorLine(value, style) {
   return process.stdout.isTTY !== true ? value : style(value);
 }
@@ -14904,19 +15020,19 @@ function formatHttpErrorStatus(value) {
 }
 function formatProblemDetailsBody(body) {
   const lines = [];
-  if (isNonEmptyString(body.title)) {
+  if (hasOwnNonEmptyString(body, "title")) {
     lines.push(`Problem: ${body.title}`);
   }
-  if (isNonEmptyString(body.detail)) {
+  if (hasOwnNonEmptyString(body, "detail")) {
     lines.push(`Detail:  ${body.detail}`);
   }
-  if (body.type !== void 0) {
+  if (hasOwnProperty3(body, "type") && body.type !== void 0) {
     lines.push(`Type:    ${body.type}`);
   }
-  if (body.instance !== void 0) {
+  if (hasOwnProperty3(body, "instance") && body.instance !== void 0) {
     lines.push(`Instance: ${body.instance}`);
   }
-  if (body.status !== void 0) {
+  if (hasOwnProperty3(body, "status") && body.status !== void 0) {
     lines.push(`Status:  ${body.status}`);
   }
   return lines.join("\n");
@@ -14924,10 +15040,10 @@ function formatProblemDetailsBody(body) {
 function formatGraphQLErrorEnvelopeBody(body) {
   return body.errors.map((error3) => {
     const lines = [`GraphQL error: ${error3.message}`];
-    if (error3.path !== void 0) {
+    if (hasOwnProperty3(error3, "path") && error3.path !== void 0) {
       lines.push(`  at path: ${error3.path.join(".")}`);
     }
-    if (error3.extensions?.code !== void 0) {
+    if (hasOwnProperty3(error3, "extensions") && error3.extensions !== void 0 && hasOwnProperty3(error3.extensions, "code") && error3.extensions.code !== void 0) {
       lines.push(`  code:    ${error3.extensions.code}`);
     }
     return lines.join("\n");
@@ -15267,13 +15383,14 @@ function configureCommanderSuggestionOutput(command) {
 async function runCLI(roots, options = {}) {
   enableSourceMaps();
   const normalizedRoot = normalizeRoots(roots, process.argv);
-  const root = options.approvals === false ? normalizedRoot : mergeApprovalsGroup(normalizedRoot);
+  const root = options.approvals === true ? mergeApprovalsGroup(normalizedRoot) : normalizedRoot;
   await resolveMcpProxies(root, { projectRoot: options.projectRoot });
   const casing = options.casing ?? "kebab";
   const services = options.services ?? {};
   const runtimeOptions = options.humanInLoop ?? {};
   const version = options.version ?? findEntrypointPackageMetadata(process.argv[1])?.version;
   const rootUsageName = options.rootUsageName ?? inferProgramName(process.argv);
+  const controls = resolveCLIControls(options.controls);
   const servicesWithBuiltIns = {
     ...services,
     runtimeOptions,
@@ -15293,8 +15410,12 @@ async function runCLI(roots, options = {}) {
   program.showHelpAfterError();
   program.addHelpCommand(false);
   const presetsEnabled = options.presets === true;
-  const globalLongOptionFlags = getGlobalLongOptionFlags(presetsEnabled, version !== void 0);
-  addGlobalOptions(program, presetsEnabled);
+  const globalLongOptionFlags = getGlobalLongOptionFlags(
+    presetsEnabled,
+    version !== void 0,
+    controls
+  );
+  addGlobalOptions(program, presetsEnabled, controls);
   if (version !== void 0) {
     program.version(version, "--version");
   }
@@ -15320,7 +15441,8 @@ async function runCLI(roots, options = {}) {
       casing,
       globalLongOptionFlags,
       execute,
-      presetsEnabled
+      presetsEnabled,
+      controls
     );
     if (command === null) {
       continue;
@@ -15462,7 +15584,7 @@ function consumeTerminatedString(input, index, allowBellTerminator) {
 }
 
 // src/errors.ts
-function hasOwnErrorCode(error3, code) {
+function hasOwnErrorCode4(error3, code) {
   return error3 instanceof Error && Object.prototype.hasOwnProperty.call(error3, "code") && error3.code === code;
 }
 
@@ -16565,7 +16687,7 @@ function ensureSpawnHelperExecutable() {
   }
 }
 function isMissingFileError(error3) {
-  return hasOwnErrorCode(error3, "ENOENT");
+  return hasOwnErrorCode4(error3, "ENOENT");
 }
 function matchPattern(buffer, pattern) {
   const clean = normalizeHistoryBuffer(stripAnsi4(buffer));
@@ -16991,6 +17113,23 @@ var codexAgent = {
   }
 };
 
+// ../agent-defs/src/agents/cursor.ts
+var cursorAgent = {
+  id: "cursor",
+  name: "cursor",
+  aliases: ["cursor-agent"],
+  label: "Cursor",
+  summary: "Cursor's CLI coding agent.",
+  binaryName: "cursor-agent",
+  configPath: "~/.cursor/cli-config.json",
+  branding: {
+    colors: {
+      dark: "#FFFFFF",
+      light: "#000000"
+    }
+  }
+};
+
 // ../agent-defs/src/agents/gemini-cli.ts
 var geminiCliAgent = {
   id: "gemini-cli",
@@ -17105,6 +17244,7 @@ var allAgents = Object.freeze([
   freezeAgent(claudeCodeAgent),
   freezeAgent(claudeDesktopAgent),
   freezeAgent(codexAgent),
+  freezeAgent(cursorAgent),
   freezeAgent(geminiCliAgent),
   freezeAgent(openCodeAgent),
   freezeAgent(kimiAgent),
@@ -17138,6 +17278,10 @@ var agentSkillConfigs = {
     globalSkillDir: "~/.codex/skills",
     localSkillDir: ".codex/skills"
   },
+  cursor: {
+    globalSkillDir: "~/.cursor/skills-cursor",
+    localSkillDir: ".cursor/skills"
+  },
   "gemini-cli": {
     globalSkillDir: "~/.gemini/skills",
     localSkillDir: ".gemini/skills"
@@ -17679,9 +17823,14 @@ function resolvePath(rawPath, homeDir, pathMapper) {
   return filename.length === 0 ? mappedDirectory : path16.join(mappedDirectory, filename);
 }
 
+// ../config-mutations/src/error-codes.ts
+function hasOwnErrorCode5(error3, code) {
+  return typeof error3 === "object" && error3 !== null && Object.prototype.hasOwnProperty.call(error3, "code") && error3.code === code;
+}
+
 // ../config-mutations/src/fs-utils.ts
 function isNotFound(error3) {
-  return typeof error3 === "object" && error3 !== null && Object.prototype.hasOwnProperty.call(error3, "code") && error3.code === "ENOENT";
+  return hasOwnErrorCode5(error3, "ENOENT");
 }
 async function readFileIfExists(fs4, target) {
   try {
@@ -17738,7 +17887,7 @@ async function backupInvalidDocument(context, targetPath, content) {
   }
 }
 function isAlreadyExists(error3) {
-  return typeof error3 === "object" && error3 !== null && Object.prototype.hasOwnProperty.call(error3, "code") && error3.code === "EEXIST";
+  return hasOwnErrorCode5(error3, "EEXIST");
 }
 async function assertRegularWriteTarget(context, targetPath) {
   const boundary = path17.dirname(path17.resolve(context.homeDir));
@@ -18465,6 +18614,11 @@ async function executeMutation(mutation, context, options) {
   }
 }
 
+// ../agent-skill-config/src/error-codes.ts
+function hasOwnErrorCode6(error3, code) {
+  return error3 instanceof Error && Object.prototype.hasOwnProperty.call(error3, "code") && error3.code === code;
+}
+
 // ../agent-skill-config/src/templates.ts
 import { readFile as readFile5, stat } from "node:fs/promises";
 import path18 from "node:path";
@@ -18489,7 +18643,7 @@ async function pathExists2(fs4, targetPath) {
     await fs4.stat(targetPath);
     return true;
   } catch (error3) {
-    if (typeof error3 === "object" && error3 !== null && Object.prototype.hasOwnProperty.call(error3, "code") && error3.code === "ENOENT") {
+    if (hasOwnErrorCode6(error3, "ENOENT")) {
       return false;
     }
     throw error3;
@@ -18567,7 +18721,7 @@ var DEFAULT_INSTALL_SCOPE = "local";
 var TERMINAL_PILOT_SKILL_NAME = "terminal-pilot";
 var installableAgents = supportedAgents;
 function isNotFoundError2(error3) {
-  return hasOwnErrorCode(error3, "ENOENT");
+  return hasOwnErrorCode4(error3, "ENOENT");
 }
 function resolveInstallerServices(installer) {
   return {
@@ -19185,6 +19339,11 @@ function parseAnsi2(input) {
   return buildRuns(lines, lineBreakStyles);
 }
 
+// ../terminal-png/src/error-codes.ts
+function hasOwnErrorCode7(error3, code) {
+  return typeof error3 === "object" && error3 !== null && Object.prototype.hasOwnProperty.call(error3, "code") && error3.code === code;
+}
+
 // ../terminal-png/src/png-renderer.ts
 import { Resvg } from "@resvg/resvg-js";
 
@@ -19758,7 +19917,7 @@ async function renderTerminalPng(ansiText, options = {}) {
   return png;
 }
 function isAlreadyExistsError3(error3) {
-  return error3 instanceof Error && Object.prototype.hasOwnProperty.call(error3, "code") && error3.code === "EEXIST";
+  return error3 instanceof Error && hasOwnErrorCode7(error3, "EEXIST");
 }
 
 // src/commands/screenshot.ts
@@ -19884,7 +20043,7 @@ async function folderExists(fs4, folderPath) {
     await fs4.stat(folderPath);
     return true;
   } catch (error3) {
-    if (hasOwnErrorCode(error3, "ENOENT")) {
+    if (hasOwnErrorCode4(error3, "ENOENT")) {
       return false;
     }
     throw error3;
@@ -19938,8 +20097,6 @@ var waitForExit2 = defineCommand({
 
 // src/commands/index.ts
 var children = [
-  install,
-  uninstall,
   createSession,
   fill,
   type,
@@ -19953,7 +20110,9 @@ var children = [
   resize,
   closeSession,
   getSession,
-  listSessions
+  listSessions,
+  install,
+  uninstall
 ];
 function createTerminalPilotGroup() {
   return defineGroup({
@@ -19976,7 +20135,14 @@ async function main(argv = process.argv) {
   const originalArgv = process.argv;
   process.argv = normalizeArgv(argv);
   try {
-    await runCLI(createTerminalPilotGroup());
+    await runCLI(createTerminalPilotGroup(), {
+      controls: {
+        debug: true,
+        output: true,
+        verbose: true,
+        yes: true
+      }
+    });
   } finally {
     process.argv = originalArgv;
   }