terminal-pilot 0.0.49 → 0.0.51

package/dist/composition.json

@@ -58,7 +58,7 @@
     },
     {
       "name": "terminal-pilot",
-      "version": "0.0.49",
+      "version": "0.0.51",
       "license": "MIT"
     },
     {

package/dist/testing/cli-repl.js

@@ -1098,9 +1098,9 @@ function detectThemeFromEnv(env) {
   const colorFGBG = env.COLORFGBG;
   if (typeof colorFGBG === "string") {
     const parts = colorFGBG.split(";").map((part) => Number.parseInt(part, 10));
-    const background = parts.at(-1);
-    if (Number.isFinite(background)) {
-      return background >= 8 ? "light" : "dark";
+    const background2 = parts.at(-1);
+    if (Number.isFinite(background2)) {
+      return background2 >= 8 ? "light" : "dark";
     }
   }
   return void 0;
@@ -2956,6 +2956,19 @@ var storage = new AsyncLocalStorage2();
 import readline from "node:readline";
 import { PassThrough } from "node:stream";
 
+// ../toolcraft-design/src/screen/style.ts
+var STYLE_BOLD = 1 << 0;
+var STYLE_DIM = 1 << 1;
+var STYLE_UNDERLINE = 1 << 2;
+var STYLE_INVERSE = 1 << 3;
+
+// ../toolcraft-design/src/explorer/runtime.ts
+import { appendFileSync } from "node:fs";
+
+// ../toolcraft-design/src/terminal/input.ts
+var PASTE_START = Buffer.from("\x1B[200~");
+var PASTE_END = Buffer.from("\x1B[201~");
+
 // ../toolcraft-design/src/explorer/state.ts
 var REGION_HEADER = 1 << 0;
 var REGION_LIST = 1 << 1;
@@ -4004,6 +4017,9 @@ function cloneRequires(requires) {
     check: requires.check
   };
 }
+function cloneToolAnnotations(annotations) {
+  return annotations === void 0 ? void 0 : { ...annotations };
+}
 function cloneStringArray(values) {
   return values === void 0 ? void 0 : [...values];
 }
@@ -4273,16 +4289,24 @@ function resolveGroupScope(ownScope, inheritedScope) {
   return cloneScope(ownScope ?? inheritedScope);
 }
 function createBaseCommand(config2) {
+  if (config2.mcpResult !== void 0 && config2.result === void 0) {
+    throw new ToolcraftBugError(
+      `Command "${config2.name}" defines mcpResult without a result schema.`
+    );
+  }
   const command = {
     kind: "command",
     name: config2.name,
+    title: config2.title,
     description: config2.description,
+    annotations: cloneToolAnnotations(config2.annotations),
     hidden: config2.hidden ?? false,
     examples: cloneCommandExamples(config2.examples),
     aliases: [...config2.aliases ?? []],
     positional: [...config2.positional ?? []],
     params: config2.params,
     result: config2.result,
+    mcpResult: config2.mcpResult,
     stream: void 0,
     secrets: cloneSecrets(config2.secrets),
     scope: resolveCommandScope(config2.scope, void 0),
@@ -4294,10 +4318,13 @@ function createBaseCommand(config2) {
   };
   Object.defineProperty(command, commandConfigSymbol, {
     value: {
+      title: config2.title,
+      annotations: cloneToolAnnotations(config2.annotations),
       scope: cloneScope(config2.scope),
       hidden: config2.hidden ?? false,
       examples: cloneCommandExamples(config2.examples),
       result: config2.result,
+      mcpResult: config2.mcpResult,
       humanInLoop: config2.humanInLoop,
       secrets: cloneSecrets(config2.secrets),
       requires: cloneRequires(config2.requires),
@@ -4345,13 +4372,16 @@ function materializeCommand(command, inherited) {
   const materialized = {
     kind: "command",
     name: command.name,
+    title: internal.title,
     description: command.description,
+    annotations: cloneToolAnnotations(internal.annotations),
     hidden: internal.hidden,
     examples: cloneCommandExamples(internal.examples),
     aliases: [...command.aliases],
     positional: [...command.positional],
     params: command.params,
     result: internal.result,
+    mcpResult: internal.mcpResult,
     stream: command.stream,
     secrets: mergeSecrets(inherited.secrets, internal.secrets),
     scope: resolveCommandScope(internal.scope, inherited.scope),
@@ -4363,10 +4393,13 @@ function materializeCommand(command, inherited) {
   };
   Object.defineProperty(materialized, commandConfigSymbol, {
     value: {
+      title: internal.title,
+      annotations: cloneToolAnnotations(internal.annotations),
       scope: cloneScope(internal.scope),
       hidden: internal.hidden,
       examples: cloneCommandExamples(internal.examples),
       result: internal.result,
+      mcpResult: internal.mcpResult,
       humanInLoop: internal.humanInLoop,
       secrets: cloneSecrets(internal.secrets),
       requires: cloneRequires(internal.requires),
@@ -5314,23 +5347,11 @@ function displayScalar(value) {
   }
   return stringifyValue(value) || "\u2014";
 }
-function isUrl(value) {
-  return typeof value === "string" && (value.startsWith("https://") || value.startsWith("http://"));
-}
-function compactUrl(value) {
-  try {
-    const url = new URL(value);
-    const tail = url.pathname.split("/").filter(Boolean).at(-1);
-    return tail ? `${url.hostname}/\u2026/${tail}` : url.hostname;
-  } catch {
-    return value;
-  }
-}
 function stackedList(value) {
   return value.map((entry) => displayScalar(entry)).join("\n") || "\u2014";
 }
 function displayRowValue(value) {
-  return isUrl(value) ? compactUrl(value) : displayScalar(value);
+  return displayScalar(value);
 }
 function directScalarRows(result) {
   return Object.entries(result).filter(([, value]) => !isObject2(value) && !Array.isArray(value)).map(([key, value]) => ({ label: humanizeKey(key), value: displayRowValue(value) }));
@@ -6302,6 +6323,9 @@ function isNegativeNumericArrayToken(token, schema) {
   return items.length > 0 && items.every((item) => isValidNumberSchemaValue(Number(item), itemSchema));
 }
 function isNextArrayOptionToken(token, schema) {
+  if (token === "-" && unwrapOptional2(schema.item).kind === "string") {
+    return false;
+  }
   return token.startsWith("-") && !isNegativeNumericArrayToken(token, schema);
 }
 function validateArrayBounds(value, schema, label) {
@@ -6370,10 +6394,14 @@ function validateOutputFormats(formats) {
       );
     }
     if (BUILT_IN_OUTPUT_FORMATS.includes(name)) {
-      throw new ToolcraftBugError(`Custom output format "${name}" conflicts with a built-in format.`);
+      throw new ToolcraftBugError(
+        `Custom output format "${name}" conflicts with a built-in format.`
+      );
     }
     if (typeof renderer !== "function") {
-      throw new ToolcraftBugError(`Custom output format "${name}" must define a renderer function.`);
+      throw new ToolcraftBugError(
+        `Custom output format "${name}" must define a renderer function.`
+      );
     }
   }
 }
@@ -7205,10 +7233,8 @@ ${formatHelpOptionList(optionRows)}`);
   }
   const secretRows = formatSecretRows(command.secrets);
   if (secretRows.length > 0) {
-    sections.push(
-      `${text.section("Secrets (environment):")}
-${formatHelpOptionList(secretRows)}`
-    );
+    sections.push(`${text.section("Secrets (environment):")}
+${formatHelpOptionList(secretRows)}`);
   }
   if (command.examples.length > 0) {
     sections.push(
@@ -8288,8 +8314,7 @@ function renderCliErrorPattern(pattern, outputEmitter) {
   if (pattern.kind === "definition") {
     logger2.error(
       `Command definition error: ${pattern.error.message}
-This is a bug in the generated command definition, not in your command arguments.
-Run with --debug for a stack trace.`
+This is a bug in the generated command definition, not in your command arguments.` + (pattern.debugControlEnabled ? "\nRun with --debug for a stack trace." : "")
     );
     if (pattern.debugStackMode !== void 0 && pattern.error.stack) {
       process.stderr.write(`${formatDebugStack(pattern.error.stack, pattern.debugStackMode)}
@@ -8301,7 +8326,7 @@ Run with --debug for a stack trace.`
   if (pattern.kind === "toolcraft-bug") {
     logger2.error(
       `toolcraft hit an internal invariant: ${pattern.error.message}
-This is a bug in toolcraft or in the command definition; it cannot be worked around by changing argv. Re-run with --debug for a stack trace and file an issue.`
+This is a bug in toolcraft or in the command definition; it cannot be worked around by changing argv.` + (pattern.debugControlEnabled ? ` Re-run with --debug for a stack trace and file an issue.` : " File an issue.")
     );
     if (pattern.debugStackMode !== void 0 && pattern.error.stack) {
       process.stderr.write(`${formatDebugStack(pattern.error.stack, pattern.debugStackMode)}
@@ -8311,7 +8336,7 @@ This is a bug in toolcraft or in the command definition; it cannot be worked aro
     return;
   }
   logger2.error(
-    pattern.debugStackMode !== void 0 ? pattern.message : `${pattern.message} Use --debug for a stack trace.`
+    pattern.debugStackMode !== void 0 || !pattern.debugControlEnabled ? pattern.message : `${pattern.message} Use --debug for a stack trace.`
   );
   if (pattern.debugStackMode !== void 0 && pattern.stack !== void 0) {
     process.stderr.write(`${formatDebugStack(pattern.stack, pattern.debugStackMode)}
@@ -9382,7 +9407,9 @@ function renderHttpError(error3, options) {
     } else {
       lines.push(`Response body: ${formatHttpErrorSnippet(error3.response.body)}`);
     }
-    lines.push("Re-run with --verbose to see headers and full body.");
+    if (options.verboseControlEnabled) {
+      lines.push("Re-run with --verbose to see headers and full body.");
+    }
   }
   process.stderr.write(`${lines.join("\n")}
 `);
@@ -9400,6 +9427,7 @@ async function handleRunError(error3, options) {
         options.userErrorPattern === "definition" ? {
           kind: "definition",
           error: error3,
+          debugControlEnabled: options.debugControlEnabled,
           debugStackMode: options.debugStackMode
         } : options.userErrorPattern === "usage" ? {
           kind: "usage",
@@ -9419,6 +9447,7 @@ async function handleRunError(error3, options) {
         {
           kind: "toolcraft-bug",
           error: error3,
+          debugControlEnabled: options.debugControlEnabled,
           debugStackMode: options.debugStackMode
         },
         options.outputEmitter
@@ -9471,6 +9500,7 @@ async function handleRunError(error3, options) {
         kind: "unexpected",
         message: message2,
         stack: error3 instanceof Error ? error3.stack : void 0,
+        debugControlEnabled: options.debugControlEnabled,
         debugStackMode: options.debugStackMode
       },
       options.outputEmitter
@@ -9867,9 +9897,11 @@ async function runCLI(roots, options = {}) {
 `);
     }
     await handleRunError(error3, {
-      debugStackMode: resolvedFlags !== void 0 ? resolveDebugStackMode(resolvedFlags.debug) : getDebugStackModeFromArgv(argv),
+      debugControlEnabled: controls.debug,
+      debugStackMode: controls.debug ? resolvedFlags !== void 0 ? resolveDebugStackMode(resolvedFlags.debug) : getDebugStackModeFromArgv(argv) : void 0,
       output: resolvedFlags !== void 0 ? resolveOutput(resolvedFlags) : resolveOutputFromArgv(argv, controls.outputFormats),
       verbose: resolvedFlags ? Boolean(resolvedFlags.verbose) : argv.includes("--verbose"),
+      verboseControlEnabled: controls.verbose,
       program,
       argv,
       rootUsageName,
@@ -14471,9 +14503,9 @@ function renderBackgrounds(line, startX, y, height) {
   const rectangles = [];
   for (const run of line) {
     const width = displayWidth4(run.text, column);
-    const background = resolveBackgroundColor(run);
-    if (background !== BACKGROUND && width > 0) {
-      rectangles.push(`<rect x="${formatNumber(startX + column * CHARACTER_WIDTH)}" y="${formatNumber(y)}" width="${formatNumber(width * CHARACTER_WIDTH)}" height="${formatNumber(height)}" fill="${escapeXmlAttribute(background)}" />`);
+    const background2 = resolveBackgroundColor(run);
+    if (background2 !== BACKGROUND && width > 0) {
+      rectangles.push(`<rect x="${formatNumber(startX + column * CHARACTER_WIDTH)}" y="${formatNumber(y)}" width="${formatNumber(width * CHARACTER_WIDTH)}" height="${formatNumber(height)}" fill="${escapeXmlAttribute(background2)}" />`);
     }
     column += width;
   }
@@ -15249,7 +15281,7 @@ function sleep2(ms) {
 // src/cli.ts
 configureTheme({ brand: "green", label: "Terminal Pilot" });
 function getBundledPackageVersion() {
-  return true ? "0.0.49" : void 0;
+  return true ? "0.0.51" : void 0;
 }
 var pilotOptionsWithValues = /* @__PURE__ */ new Set([
   "--session",