stitchkit 0.113.1 → 0.113.3

package/dist/{index-fytsnhzj.js → index-k7z3j3hr.js}

@@ -1,6 +1,6 @@
 import {
   validateDeclaredOutput
-} from "./index-fynr93w4.js";
+} from "./index-k42ckyzx.js";
 import {
   jsonSchemaObjectCoercionMembers
 } from "./index-dsa676h8.js";
@@ -14,15 +14,15 @@ import {
   objectShapeKeys,
   assertUniqueToolName,
   buildToolPresentationSchema
-} from "./index-jgwqc38k.js";
+} from "./index-rhzkndr5.js";
 import {
   toolResultFromError,
   toolErrorFromResult
-} from "./index-tg2q89ps.js";
+} from "./index-v6vb5qx8.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-v6mzw27b.js";
+} from "./index-htxh46ej.js";
 import {
   fetchGuarded,
   readCapped
@@ -35,7 +35,7 @@ import {
 } from "./index-eemvahkc.js";
 import {
   collectToolSurface
-} from "./index-emrmgq3s.js";
+} from "./index-86nbfysb.js";
 import {
   isUnsafeKey,
   safeJsonParse
@@ -43,6 +43,10 @@ import {
 import {
   formatZodError2
 } from "./index-1eeqpadm.js";
+import {
+  AppError2,
+  STITCH_ERROR_STATUS2
+} from "./index-qcn84byh.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";
@@ -65,17 +69,28 @@ function prepareCliCommandEmission(definition, result, options) {
   if (!result.ok || definition.output === undefined) {
     return { result, successExitCode: 0 };
   }
+  let successExitCode;
+  try {
+    successExitCode = cliCommandSuccessExitCode(definition, result.data);
+  } catch (error) {
+    return {
+      result: toolResultFromError(new Error("CLI result policy failed", { cause: error })),
+      successExitCode: 0
+    };
+  }
   try {
-    const successExitCode = cliCommandSuccessExitCode(definition, result.data);
-    const presentation = definition.present?.({ result: result.data, options });
-    if (presentation !== undefined && typeof presentation !== "string") {
+    if (definition.present === undefined)
+      return { result, successExitCode };
+    const presentation = definition.present({ result: result.data, options });
+    if (typeof presentation !== "string") {
       throw new Error("CLI result presenter must return a string");
     }
     return { result, presentation, successExitCode };
   } catch (error) {
     return {
-      result: toolResultFromError(new Error("CLI result policy failed", { cause: error })),
-      successExitCode: 0
+      result,
+      presentationFailure: toolResultFromError(new Error("CLI result presentation failed", { cause: error })),
+      successExitCode
     };
   }
 }
@@ -137,6 +152,8 @@ var DEFAULT_EXIT_CODES2 = {
   CONNECTION_REQUEST_FAILED: 1,
   UPSTREAM_TOOL_ERROR: 1,
   WAIT_FAILED: 1,
+  CLI_COMMAND_UNAVAILABLE: 1,
+  CLI_PRESENTATION_FAILED: 8,
   INTERNAL_SERVER_ERROR: 1
 };
 function cliExitCode2(result, exitCodes) {
@@ -160,6 +177,21 @@ function emitResult2(result, writers, opts) {
 `);
   return cliExitCode2(result, opts.exitCodes);
 }
+function emitPresentationFailure(result, failure, writers, opts) {
+  emitResult2(result, writers, opts);
+  return emitResult2({
+    ok: false,
+    code: "CLI_PRESENTATION_FAILED",
+    retryable: false,
+    details: {
+      message: "The command completed successfully, but its result presentation failed.",
+      command: opts.toolName,
+      operationSucceeded: true,
+      cause: formatToolError(failure)
+    },
+    hint: "The complete, unformatted result is on stdout. Do not repeat the command to recover its result."
+  }, writers, { json: opts.json, toolName: opts.toolName, exitCodes: opts.exitCodes });
+}
 
 // src/tools/cli/argument-error.ts
 class CliArgumentError2 extends Error {
@@ -653,19 +685,25 @@ async function runNativeCommand(definition, args, config, globals) {
     written: { ...out !== "" && { stdout: out }, ...err !== "" && { stderr: err } }
   };
 }
-function buildCliSurface(config, auth, nativeHelp, applicationGlobalNames, assertShape) {
+function buildCliSurface(config, auth, nativeHelp, applicationGlobalNames, shapeIssue) {
   const services = typeof config.services === "function" ? config.services(auth) : config.services ?? [];
   const runtimeTools = typeof config.runtimeTools === "function" ? config.runtimeTools(auth) : config.runtimeTools ?? [];
   const tools = new Map;
   const help = new Map(nativeHelp);
-  for (const { mountable } of collectToolSurface({
+  for (const { kind, mountable } of collectToolSurface({
     surface: { services, runtimeTools },
     transport: "CLI"
   })) {
     const descriptor = applyCliPresentationPolicy(mountable.name, managedCliDescriptor(mountable), config);
-    assertShape?.(mountable.name, descriptor, help.has(mountable.name), config.passthrough?.[mountable.name], applicationGlobalNames);
-    tools.set(mountable.name, mountable);
-    help.set(mountable.name, descriptor);
+    const issue = shapeIssue?.(mountable.name, descriptor, help.has(mountable.name), config.passthrough?.[mountable.name], applicationGlobalNames);
+    if (issue !== undefined) {
+      if (kind !== "runtime")
+        throw new Error(issue);
+      help.set(mountable.name, { ...descriptor, unavailableReason: issue });
+    } else {
+      tools.set(mountable.name, mountable);
+      help.set(mountable.name, descriptor);
+    }
   }
   assertCliPoliciesResolved(help, config);
   return { tools, help };
@@ -1765,7 +1803,10 @@ function renderTopHelp(input) {
   ];
   const width = Math.max(0, ...[...commands.keys()].map((key) => key.length));
   for (const [command, descriptor] of commands) {
-    lines.push(`  ${padRight(command, width)}  ${summarize(descriptor.description)}${command === defaultCommand ? " (default)" : ""}`);
+    lines.push(`  ${padRight(command, width)}  ${summarize(descriptor.description)}${command === defaultCommand ? " (default)" : ""}${descriptor.unavailableReason !== undefined ? " [unavailable]" : ""}`);
+    if (descriptor.unavailableReason !== undefined) {
+      lines.push(`    Unavailable: ${descriptor.unavailableReason}`);
+    }
   }
   if (input.unavailable !== undefined) {
     lines.push("", `Managed commands are unavailable: ${input.unavailable}`);
@@ -1809,6 +1850,9 @@ function renderCommandHelp(name, command, descriptor, applicationOptions = []) {
     "[--flags]"
   ].join(" ");
   const lines = [descriptor.description, "", usage, ""];
+  if (descriptor.unavailableReason !== undefined) {
+    lines.push(`Unavailable: ${descriptor.unavailableReason}`, "");
+  }
   if (fields.length > 0) {
     lines.push("Arguments:");
     const labels = new Map(fields.map((field) => {
@@ -1845,114 +1889,24 @@ function renderCommandHelp(name, command, descriptor, applicationOptions = []) {
 `;
 }
 
-// src/tools/cli/session.ts
-function nativeDescriptor(definition) {
-  return {
-    description: definition.description,
-    argumentSchema: definition.input,
-    presentationSchema: cliCommandPresentationSchema(definition)
-  };
-}
-function assertCommandShape(name, descriptor, exists, passthroughField, applicationGlobals = new Set) {
+// src/tools/cli/command-shape.ts
+function commandShapeIssue(name, descriptor, exists, passthroughField, applicationGlobals = new Set) {
   assertUniqueToolName(name, exists, "CLI command");
   if (name === "help" || name === "version") {
     throw new Error(`[stitchkit] CLI command "${name}" is reserved`);
   }
+  if (passthroughField !== undefined && descriptor.aliases.has(passthroughField)) {
+    throw new Error(`[stitchkit] CLI command "${name}" cannot alias passthrough field "${passthroughField}"`);
+  }
   const fieldNames = jsonSchemaFields(descriptor.presentationSchema).map((field) => field.name);
   const conflicting = fieldNames.filter((field) => RESERVED_CLI_OPTIONS.has(field));
   if (conflicting.length > 0) {
-    throw new Error(`[stitchkit] CLI command "${name}" declares reserved option field(s): ${conflicting.join(", ")}`);
+    return `[stitchkit] CLI command "${name}" declares reserved option field(s): ${conflicting.join(", ")}`;
   }
   const shadowed = fieldNames.filter((field) => applicationGlobals.has(field));
   if (shadowed.length > 0) {
-    throw new Error(`[stitchkit] CLI command "${name}" declares field(s) shadowed by application global options: ${shadowed.join(", ")}`);
+    return `[stitchkit] CLI command "${name}" declares field(s) shadowed by application global options: ${shadowed.join(", ")}`;
   }
-  if (passthroughField !== undefined && descriptor.aliases.has(passthroughField)) {
-    throw new Error(`[stitchkit] CLI command "${name}" cannot alias passthrough field "${passthroughField}"`);
-  }
-}
-function createCliSession(config, io) {
-  if (config.auth !== undefined && config.resolveAuth !== undefined) {
-    throw new Error("[stitchkit] createCli: use either auth or resolveAuth, not both");
-  }
-  const applicationOptions = config.globalOptions ? jsonSchemaFields(buildToolPresentationSchema({
-    inputSchema: config.globalOptions,
-    unrepresentable: "any"
-  })) : [];
-  const applicationGlobalNames = new Set(applicationOptions.map((field) => field.name));
-  for (const name of applicationGlobalNames) {
-    if (RESERVED_CLI_OPTIONS.has(name)) {
-      throw new Error(`[stitchkit] CLI global option "--${name}" is reserved by the framework`);
-    }
-  }
-  const nativeCommands = new Map;
-  const nativeHelp = new Map;
-  for (const definition of config.commands ?? []) {
-    const descriptor = applyCliPresentationPolicy(definition.name, nativeDescriptor(definition), config);
-    assertCommandShape(definition.name, descriptor, nativeCommands.has(definition.name), config.passthrough?.[definition.name], applicationGlobalNames);
-    nativeCommands.set(definition.name, definition);
-    nativeHelp.set(definition.name, descriptor);
-  }
-  return {
-    config,
-    io,
-    applicationOptions,
-    applicationGlobalNames,
-    nativeCommands,
-    nativeHelp
-  };
-}
-function resolveCliRoute(session, argv) {
-  const { config } = session;
-  const { stdout, stderr, exit } = session.io;
-  let globals;
-  let routableArgv;
-  try {
-    const lifted = extractCliGlobalOptions2(argv, config.globalOptions);
-    globals = lifted.globals;
-    routableArgv = lifted.argv;
-  } catch (error) {
-    if (!(error instanceof CliArgumentError2))
-      throw error;
-    stderr(`${error.message}
-`);
-    exit(2);
-    return;
-  }
-  const typedGlobals = globals;
-  const route = routeCliArgv2(routableArgv, config.defaultCommand);
-  if (route.error) {
-    stderr(`${route.error}
-`);
-    exit(2);
-    return;
-  }
-  const { command, commandArgv } = route;
-  if (route.version || command === "--version" || command === "version") {
-    stdout(`${config.name} ${config.version}
-`);
-    exit(0);
-    return;
-  }
-  const beforeSeparator = commandArgv.indexOf("--") === -1 ? commandArgv : commandArgv.slice(0, commandArgv.indexOf("--"));
-  const helpRequested = beforeSeparator.includes("--help") || beforeSeparator.includes("-h");
-  return {
-    globals,
-    typedGlobals,
-    route,
-    command,
-    commandArgv,
-    beforeSeparator,
-    helpRequested
-  };
-}
-function emitOptionsFor(config, json, toolName) {
-  return {
-    json,
-    toolName,
-    errorHint: config.errorHint,
-    exitCodes: { ...DEFAULT_EXIT_CODES2, ...config.exitCodes }
-  };
 }
 
 // src/tools/cli/managed-surface.ts
@@ -1979,7 +1933,7 @@ async function buildManagedSurface(session, typedGlobals, forExecution) {
       };
     }
   }
-  const { tools, help } = buildCliSurface(config, auth, nativeHelp, applicationGlobalNames, assertCommandShape);
+  const { tools, help } = buildCliSurface(config, auth, nativeHelp, applicationGlobalNames, commandShapeIssue);
   return { resolved: true, auth, help, tools };
 }
 
@@ -2056,6 +2010,128 @@ async function prepareInvocation(command, commandArgv, descriptor, config, readS
   return { ok: true, toolArgs, options };
 }
 
+// src/tools/cli/session.ts
+function nativeDescriptor(definition) {
+  return {
+    description: definition.description,
+    argumentSchema: definition.input,
+    presentationSchema: cliCommandPresentationSchema(definition)
+  };
+}
+function createCliSession(config, io) {
+  if (config.auth !== undefined && config.resolveAuth !== undefined) {
+    throw new Error("[stitchkit] createCli: use either auth or resolveAuth, not both");
+  }
+  const applicationOptions = config.globalOptions ? jsonSchemaFields(buildToolPresentationSchema({
+    inputSchema: config.globalOptions,
+    unrepresentable: "any"
+  })) : [];
+  const applicationGlobalNames = new Set(applicationOptions.map((field) => field.name));
+  for (const name of applicationGlobalNames) {
+    if (RESERVED_CLI_OPTIONS.has(name)) {
+      throw new Error(`[stitchkit] CLI global option "--${name}" is reserved by the framework`);
+    }
+  }
+  const nativeCommands = new Map;
+  const nativeHelp = new Map;
+  for (const definition of config.commands ?? []) {
+    const descriptor = applyCliPresentationPolicy(definition.name, nativeDescriptor(definition), config);
+    const issue = commandShapeIssue(definition.name, descriptor, nativeCommands.has(definition.name), config.passthrough?.[definition.name], applicationGlobalNames);
+    if (issue !== undefined)
+      throw new Error(issue);
+    nativeCommands.set(definition.name, definition);
+    nativeHelp.set(definition.name, descriptor);
+  }
+  return {
+    config,
+    io,
+    applicationOptions,
+    applicationGlobalNames,
+    nativeCommands,
+    nativeHelp
+  };
+}
+function resolveCliRoute(session, argv) {
+  const { config } = session;
+  const { stdout, stderr, exit } = session.io;
+  let globals;
+  let routableArgv;
+  try {
+    const lifted = extractCliGlobalOptions2(argv, config.globalOptions);
+    globals = lifted.globals;
+    routableArgv = lifted.argv;
+  } catch (error) {
+    if (!(error instanceof CliArgumentError2))
+      throw error;
+    stderr(`${error.message}
+`);
+    exit(2);
+    return;
+  }
+  const typedGlobals = globals;
+  const route = routeCliArgv2(routableArgv, config.defaultCommand);
+  if (route.error) {
+    stderr(`${route.error}
+`);
+    exit(2);
+    return;
+  }
+  const { command, commandArgv } = route;
+  if (route.version || command === "--version" || command === "version") {
+    stdout(`${config.name} ${config.version}
+`);
+    exit(0);
+    return;
+  }
+  const beforeSeparator = commandArgv.indexOf("--") === -1 ? commandArgv : commandArgv.slice(0, commandArgv.indexOf("--"));
+  const helpRequested = beforeSeparator.some((token) => {
+    if (token === "--help" || token === "-h")
+      return true;
+    const option = classifyLongOptionToken(token);
+    return option?.name === "help" && option.value !== undefined && isReservedBoolWord(option.value) && parseReservedBool("help", option.value);
+  });
+  return {
+    globals,
+    typedGlobals,
+    route,
+    command,
+    commandArgv,
+    beforeSeparator,
+    helpRequested
+  };
+}
+function emitOptionsFor(config, json, toolName) {
+  return {
+    json,
+    toolName,
+    errorHint: config.errorHint,
+    exitCodes: { ...DEFAULT_EXIT_CODES2, ...config.exitCodes }
+  };
+}
+
+// src/tools/cli/unavailable.ts
+function unavailableCommand(reason) {
+  return toolResultFromError(new AppError2("CLI_COMMAND_UNAVAILABLE", {
+    message: reason,
+    status: STITCH_ERROR_STATUS2.CLI_COMMAND_UNAVAILABLE,
+    retryable: false
+  }));
+}
+function unavailableCommandJson(argv) {
+  for (let i = 0;i < argv.length; i++) {
+    const token = argv[i];
+    if (token === "--")
+      break;
+    if (token === undefined)
+      continue;
+    const option = classifyLongOptionToken(token);
+    if (option?.name !== "json")
+      continue;
+    return option.value === undefined ? separateBoolValue(argv[i + 1]) ?? true : isReservedBoolWord(option.value) && parseReservedBool("json", option.value);
+  }
+  return false;
+}
+
 // src/tools/cli/run-managed.ts
 async function runManagedInvocation(session, route) {
   const { config } = session;
@@ -2077,7 +2153,7 @@ function respondTopLevelHelp(session, route, managed) {
   const helpFilter = route.route.helpFilter ?? (command !== undefined ? commandArgv[0] : undefined);
   const filter = helpFilter !== undefined && !helpFilter.startsWith("-") ? helpFilter : undefined;
   if (filter !== undefined && filterCommands(managed.help, filter).size === 0) {
-    stderr(`no command matches "${filter}" (${managed.help.size} available)
+    stderr(`no command matches "${filter}" (${[...managed.help.values()].filter((entry) => entry.unavailableReason === undefined).length} available)
 ` + (managed.resolved ? "" : `Managed commands are unavailable: ${managed.reason}
 `));
     const codes = { ...DEFAULT_EXIT_CODES2, ...config.exitCodes };
@@ -2098,19 +2174,22 @@ function respondTopLevelHelp(session, route, managed) {
 async function runManagedCommand(session, route, command, managed) {
   const { config, applicationOptions } = session;
   const { stdout, stderr, exit, readStdin } = session.io;
-  const tool = managed.tools.get(command);
-  if (!tool) {
+  const descriptor = managed.help.get(command);
+  if (!descriptor) {
     stderr(`Unknown command "${command}". Run "${config.name} --help" for the command list.
 `);
     return exit(1);
   }
-  const descriptor = managed.help.get(command);
-  if (!descriptor)
-    throw new Error("[stitchkit] managed CLI descriptor invariant failed");
   if (route.helpRequested) {
     stdout(renderCommandHelp(config.name, command, descriptor, applicationOptions));
     return exit(0);
   }
+  if (descriptor.unavailableReason !== undefined) {
+    return exit(emitResult2(unavailableCommand(descriptor.unavailableReason), { stdout, stderr }, emitOptionsFor(config, unavailableCommandJson(route.commandArgv), command)));
+  }
+  const tool = managed.tools.get(command);
+  if (!tool)
+    throw new Error("[stitchkit] managed CLI executable invariant failed");
   const prepared = await prepareInvocation(command, route.commandArgv, descriptor, config, readStdin);
   if (!prepared.ok) {
     stderr(`${prepared.message}
@@ -2171,6 +2250,9 @@ async function executeManagedTool(session, route, command, managed, tool, { tool
       initial: result,
       wait: waitConfig,
       call: async (toolName, args) => {
+        const unavailable = managed.help.get(toolName)?.unavailableReason;
+        if (unavailable !== undefined)
+          return unavailableCommand(unavailable);
         const pollTool = managed.tools.get(toolName);
         if (!pollTool) {
           return {
@@ -2202,11 +2284,12 @@ async function emitManagedResult(session, command, initial, options) {
     try {
       viewed = renderCliView2(result.data, options.view);
     } catch (error) {
-      if (!(error instanceof CliArgumentError2))
-        throw error;
-      stderr(`${error.message}
-`);
-      return exit(2);
+      const failure = error instanceof CliArgumentError2 ? {
+        ok: false,
+        code: "BAD_REQUEST",
+        details: { message: error.message }
+      } : toolResultFromError(error);
+      return exit(emitPresentationFailure(result, failure, { stdout, stderr }, emitOptionsFor(config, options.json, command)));
     }
     if (viewed.kind === "text") {
       stdout(viewed.text);
@@ -2263,6 +2346,9 @@ async function runNativeCommand2(session, route, command, native) {
   }
   const result = await executeCliCommand(native, toolArgs, options, { stdout, stderr }, config.coerceJsonArgs ?? true, globals);
   const emission = prepareCliCommandEmission(native, result, options);
+  if (emission.result.ok && emission.presentationFailure !== undefined) {
+    return exit(emitPresentationFailure(emission.result, emission.presentationFailure, { stdout, stderr }, emitOptionsFor(config, options.json, command)));
+  }
   let emittedExitCode;
   if (emission.result.ok && emission.presentation !== undefined) {
     stdout(emission.presentation);

package/dist/{index-j9gxbztg.js → index-qcn84byh.js}

@@ -76,6 +76,8 @@ var STITCH_ERROR_STATUS2 = {
   NOT_IMPLEMENTED: 501,
   WAIT_TIMEOUT: 408,
   WAIT_FAILED: 409,
+  CLI_COMMAND_UNAVAILABLE: 409,
+  CLI_PRESENTATION_FAILED: 500,
   DOWNLOAD_NOT_FOUND: 404,
   VIEW_HTTP_ERROR: 502,
   CONNECTION_TIMEOUT: 504,

package/dist/{index-jgwqc38k.js → index-rhzkndr5.js}

@@ -1,12 +1,12 @@
 import {
   validateDeclaredOutput
-} from "./index-fynr93w4.js";
+} from "./index-k42ckyzx.js";
 import {
   toJsonSchema
 } from "./index-ct75c3at.js";
 import {
   AppError2
-} from "./index-j9gxbztg.js";
+} from "./index-qcn84byh.js";
 import {
   serializeCanonicalJson
 } from "./index-zsvzhjtk.js";

package/dist/{index-k0zfcxf5.js → index-tpwbct8j.js}

@@ -17,7 +17,7 @@ import {
   replaceMessage,
   ArchiveSpillSchema,
   createAgentRuntimeStore2
-} from "./index-yjnmac9b.js";
+} from "./index-523tq7y4.js";
 
 // src/agent-runtime/store-memory.ts
 import { z as z2 } from "zod";

package/dist/{index-8asb62xn.js → index-v1tswj0z.js}

@@ -11,7 +11,7 @@ import {
 } from "./index-50ejfz75.js";
 import {
   AppError2
-} from "./index-j9gxbztg.js";
+} from "./index-qcn84byh.js";
 
 // src/application/kernel-contract.ts
 import { z } from "zod";

package/dist/{index-tg2q89ps.js → index-v6vb5qx8.js}

@@ -1,7 +1,7 @@
 import {
   normalizeError2,
   validateDeclaredOutput
-} from "./index-fynr93w4.js";
+} from "./index-k42ckyzx.js";
 import {
   localVerdict
 } from "./index-dsa676h8.js";
@@ -12,14 +12,14 @@ import {
   applyToolViewDefaults,
   projectToolView,
   objectShapeKeys
-} from "./index-jgwqc38k.js";
+} from "./index-rhzkndr5.js";
 import {
   runWithRequestContext2,
   getRequestContext2
 } from "./index-r6v4mc67.js";
 import {
   projectedToolError
-} from "./index-556g5hsh.js";
+} from "./index-98hv3sba.js";
 import {
   isUnsafeKey
 } from "./index-zsarb5xp.js";
@@ -31,7 +31,7 @@ import {
   STITCH_ERROR_STATUS2,
   isRetryableStatus2,
   isStitchErrorCode2
-} from "./index-j9gxbztg.js";
+} from "./index-qcn84byh.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";

package/dist/{index-2qymcsq2.js → index-vtann8bz.js}

@@ -3,7 +3,7 @@ import {
   recordedErrorMessage,
   normalizeError2,
   validateDeclaredOutput
-} from "./index-fynr93w4.js";
+} from "./index-k42ckyzx.js";
 import {
   DEFAULT_CONTRACT_STREAM_FRAME_BYTES2
 } from "./index-h2fhjqy7.js";
@@ -26,7 +26,7 @@ import {
 import {
   bindContract,
   mediaTypeEssence
-} from "./index-pzw0fpek.js";
+} from "./index-cqmqyjax.js";
 import {
   readBoundedChunks,
   concatChunks,
@@ -71,7 +71,7 @@ import {
   AppError2,
   badRequest2,
   forbidden2
-} from "./index-j9gxbztg.js";
+} from "./index-qcn84byh.js";
 import {
   resolveTraceContext2
 } from "./index-yex7eg1v.js";

package/dist/{index-nn6607y3.js → index-vwhrnp67.js}

@@ -1,16 +1,16 @@
 import {
   assertUniqueToolName
-} from "./index-jgwqc38k.js";
+} from "./index-rhzkndr5.js";
 import {
   toolErrorFromResult
-} from "./index-tg2q89ps.js";
+} from "./index-v6vb5qx8.js";
 import {
   collectTools2,
   createToolRunner
-} from "./index-v6mzw27b.js";
+} from "./index-htxh46ej.js";
 import {
   AppError2
-} from "./index-j9gxbztg.js";
+} from "./index-qcn84byh.js";
 
 // src/tools/invoker.ts
 function createToolInvoker2(services, config) {

package/dist/{index-dsxrcseb.js → index-zktz242w.js}

@@ -27,13 +27,13 @@ import {
 } from "./index-j4zh647a.js";
 import {
   defineRuntimeTool2
-} from "./index-nk1mh535.js";
+} from "./index-ega3yz4c.js";
 import {
   AppError2,
   forbidden2,
   conflict2,
   STITCH_ERROR_STATUS2
-} from "./index-j9gxbztg.js";
+} from "./index-qcn84byh.js";
 
 // src/agent-runtime/coding-tool-contract.ts
 import { z } from "zod";

package/dist/tools/cli/command-shape.d.ts

@@ -0,0 +1,4 @@
+import type { CliCommandPresentation } from './policy.js';
+/** Local configuration faults throw; only argv field conflicts become unavailable. */
+export declare function commandShapeIssue(name: string, descriptor: CliCommandPresentation, exists: boolean, passthroughField?: string, applicationGlobals?: ReadonlySet<string>): string | undefined;
+//# sourceMappingURL=command-shape.d.ts.map

package/dist/tools/cli/command-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-shape.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/command-shape.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEvD,sFAAsF;AACtF,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,sBAAsB,EAClC,MAAM,EAAE,OAAO,EACf,gBAAgB,CAAC,EAAE,MAAM,EACzB,kBAAkB,GAAE,WAAW,CAAC,MAAM,CAAa,GAClD,MAAM,GAAG,SAAS,CAwBpB"}

package/dist/tools/cli/command.d.ts

@@ -1,5 +1,5 @@
 import type { ZodObject, ZodType, z } from 'zod';
-import { type ToolResult } from '../execute-result.js';
+import { type ToolFailure, type ToolResult } from '../execute-result.js';
 import type { CliRunOptions } from './args.js';
 import type { CliWriters } from './format.js';
 export interface CliCommandContext<TInput extends ZodObject> extends CliWriters {
@@ -42,6 +42,7 @@ export declare function defineCliCommand<TInput extends ZodObject>(definition: C
 export interface PreparedCliCommandEmission {
     result: ToolResult;
     presentation?: string;
+    presentationFailure?: ToolFailure;
     successExitCode: number;
 }
 /**