stitchkit 0.113.2 → 0.114.0

package/dist/{index-xvj9h8yh.js → index-hs35ss3p.js}

@@ -32,6 +32,10 @@ var BY_DESCRIPTION = [
   [/user is deactivated|account is deactivated/i, "user-deactivated"],
   [/can'?t initiate conversation|need to start a conversation/i, "not-started"],
   [/chat not found|peer_id_invalid|user not found/i, "chat-not-found"],
+  [
+    /bot_to_bot_disabled|bot-to-bot messaging is disabled|bot to bot.*disabled/i,
+    "bot-to-bot-disabled"
+  ],
   [/too many requests|retry later|flood/i, "rate-limited"],
   [
     /message is too long|can'?t parse entities|message text is empty|wrong file identifier|button_url_invalid/i,
@@ -43,6 +47,7 @@ var TRAITS = {
   "user-deactivated": { retryable: false, recipientUnreachable: true },
   "chat-not-found": { retryable: false, recipientUnreachable: true },
   "not-started": { retryable: false, recipientUnreachable: true },
+  "bot-to-bot-disabled": { retryable: false, recipientUnreachable: false },
   "rate-limited": { retryable: true, recipientUnreachable: false },
   "message-invalid": { retryable: false, recipientUnreachable: false },
   "server-error": { retryable: true, recipientUnreachable: false },
@@ -82,13 +87,16 @@ function retryAfterOf(value, depth = 0) {
   return nested === value ? undefined : retryAfterOf(nested, depth + 1);
 }
 function descriptionOf(value, depth = 0) {
+  if (depth > 4)
+    return "";
   if (typeof value === "string")
     return value;
   if (value instanceof Error) {
-    const nested = isRecord(value) ? descriptionOf(value.cause, depth + 1) : "";
-    return `${value.message} ${nested}`.trim();
+    const own = isRecord(value) && typeof value.description === "string" ? value.description : "";
+    const nested = descriptionOf(value.cause, depth + 1);
+    return [own, value.message, nested].filter(Boolean).join(" ");
   }
-  if (!isRecord(value) || depth > 4)
+  if (!isRecord(value))
     return "";
   const own = typeof value.description === "string" ? value.description : "";
   const message = typeof value.message === "string" ? value.message : "";

package/dist/{index-0gbn42hr.js → index-htxh46ej.js}

@@ -3,14 +3,14 @@ import {
   mergeSchemas,
   assertToolExtensionCompatible,
   projectToolSurface
-} from "./index-vf9c59t3.js";
+} from "./index-rhzkndr5.js";
 import {
   toolErrorFromResult,
   executeToolMethod
-} from "./index-a31p9ekx.js";
+} from "./index-v6vb5qx8.js";
 import {
   isRetryableStatus2
-} from "./index-pd578538.js";
+} from "./index-qcn84byh.js";
 
 // src/tools/mount.ts
 import { z } from "zod";

package/dist/{index-shg5xc9t.js → index-jk29rwkr.js}

@@ -2,7 +2,7 @@ import {
   parseRealtimeRequestArguments,
   parseRealtimeRequestAcknowledgement,
   createValidatedRealtimeSocket
-} from "./index-grn4brx1.js";
+} from "./index-3za04re9.js";
 import {
   randomHex
 } from "./index-c9d05kvt.js";

package/dist/{index-e40rzw1m.js → index-k42ckyzx.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-1eeqpadm.js";
 import {
   AppError2
-} from "./index-pd578538.js";
+} from "./index-qcn84byh.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";

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

@@ -1,6 +1,6 @@
 import {
   validateDeclaredOutput
-} from "./index-e40rzw1m.js";
+} from "./index-k42ckyzx.js";
 import {
   jsonSchemaObjectCoercionMembers
 } from "./index-dsa676h8.js";
@@ -14,15 +14,15 @@ import {
   objectShapeKeys,
   assertUniqueToolName,
   buildToolPresentationSchema
-} from "./index-vf9c59t3.js";
+} from "./index-rhzkndr5.js";
 import {
   toolResultFromError,
   toolErrorFromResult
-} from "./index-a31p9ekx.js";
+} from "./index-v6vb5qx8.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-0gbn42hr.js";
+} from "./index-htxh46ej.js";
 import {
   fetchGuarded,
   readCapped
@@ -35,7 +35,7 @@ import {
 } from "./index-eemvahkc.js";
 import {
   collectToolSurface
-} from "./index-2s7wv547.js";
+} from "./index-86nbfysb.js";
 import {
   isUnsafeKey,
   safeJsonParse
@@ -46,7 +46,7 @@ import {
 import {
   AppError2,
   STITCH_ERROR_STATUS2
-} from "./index-pd578538.js";
+} from "./index-qcn84byh.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";
@@ -69,17 +69,28 @@ function prepareCliCommandEmission(definition, result, options) {
   if (!result.ok || definition.output === undefined) {
     return { result, successExitCode: 0 };
   }
+  let successExitCode;
   try {
-    const successExitCode = cliCommandSuccessExitCode(definition, result.data);
-    const presentation = definition.present?.({ result: result.data, options });
-    if (presentation !== undefined && typeof presentation !== "string") {
+    successExitCode = cliCommandSuccessExitCode(definition, result.data);
+  } catch (error) {
+    return {
+      result: toolResultFromError(new Error("CLI result policy failed", { cause: error })),
+      successExitCode: 0
+    };
+  }
+  try {
+    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
     };
   }
 }
@@ -142,6 +153,7 @@ var DEFAULT_EXIT_CODES2 = {
   UPSTREAM_TOOL_ERROR: 1,
   WAIT_FAILED: 1,
   CLI_COMMAND_UNAVAILABLE: 1,
+  CLI_PRESENTATION_FAILED: 8,
   INTERNAL_SERVER_ERROR: 1
 };
 function cliExitCode2(result, exitCodes) {
@@ -165,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 {
@@ -2257,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);
@@ -2318,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-pd578538.js → index-qcn84byh.js}

@@ -77,6 +77,7 @@ var STITCH_ERROR_STATUS2 = {
   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-vf9c59t3.js → index-rhzkndr5.js}

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

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

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

package/dist/{index-7ysby53h.js → index-v1tswj0z.js}

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

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

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

package/dist/{index-5zxe0f3h.js → index-vtann8bz.js}

@@ -3,7 +3,7 @@ import {
   recordedErrorMessage,
   normalizeError2,
   validateDeclaredOutput
-} from "./index-e40rzw1m.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-vgtzdykw.js";
+} from "./index-cqmqyjax.js";
 import {
   readBoundedChunks,
   concatChunks,
@@ -71,7 +71,7 @@ import {
   AppError2,
   badRequest2,
   forbidden2
-} from "./index-pd578538.js";
+} from "./index-qcn84byh.js";
 import {
   resolveTraceContext2
 } from "./index-yex7eg1v.js";

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

@@ -1,16 +1,16 @@
 import {
   assertUniqueToolName
-} from "./index-vf9c59t3.js";
+} from "./index-rhzkndr5.js";
 import {
   toolErrorFromResult
-} from "./index-a31p9ekx.js";
+} from "./index-v6vb5qx8.js";
 import {
   collectTools2,
   createToolRunner
-} from "./index-0gbn42hr.js";
+} from "./index-htxh46ej.js";
 import {
   AppError2
-} from "./index-pd578538.js";
+} from "./index-qcn84byh.js";
 
 // src/tools/invoker.ts
 function createToolInvoker2(services, config) {

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

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

package/dist/telegram/outbound-budget.d.ts

@@ -0,0 +1,99 @@
+/**
+ * One outbound budget for one Telegram bot token.
+ *
+ * Telegram counts a bot's bulk messages per token, not per subsystem. A bot
+ * that sends a marketing campaign, answers a person and posts an operator note
+ * through three senders has one limit, and three separate pacemakers cannot
+ * keep it: each of them is below the limit on its own and the sum is not.
+ *
+ * This is the one place that counts. The token names the budget; every alias
+ * of the same token in the process gets the same object, and another token is
+ * another budget. The unit is a Telegram message: `sendMediaGroup` and
+ * `sendPaidMedia` cost their media length, `copyMessages` and
+ * `forwardMessages` cost their message ids, and the follow-up call to action
+ * after an album is one more message.
+ *
+ * **It paces; it does not retry.** A 429 pauses every sender of the token for
+ * the wait Telegram stated (or a declared fallback when it stated none). A
+ * network failure or a 5xx is returned to the caller unchanged: repeating a
+ * send whose external outcome is unknown is the caller's decision, and a
+ * primitive that retried it would turn one unknown message into two.
+ *
+ * The schedule is a strict token budget, not a bucket with a full burst: the
+ * first call after an idle period is immediate, and every later call occupies
+ * its own `cost / messagesPerSecond` interval. A full bucket would release a
+ * saved burst at start and again after a 429 pause, which is exactly the
+ * stampede a shared budget exists to prevent.
+ */
+export interface TelegramOutboundBudgetConfig {
+    /** The bot token whose sends share this budget. It is never returned or logged. */
+    readonly token: string;
+    /** Telegram messages per second. Default 24. */
+    readonly messagesPerSecond?: number;
+    /**
+     * How long a 429 without `retry_after` pauses the token. Default 1000 ms.
+     * Telegram's own `retry_after` is always used instead when present.
+     */
+    readonly retryAfterFallbackMs?: number;
+    /**
+     * Test seam: the monotonic clock. Default `performance.now`. A wall clock can
+     * jump backwards and turn a pause into a burst, so the default is monotonic.
+     */
+    readonly now?: () => number;
+    /**
+     * Test seam: how a wait is taken. Default the shared abortable sleep. A
+     * custom sleeper must reject with `signal.reason` when the signal aborts.
+     */
+    readonly sleep?: (milliseconds: number, signal?: AbortSignal) => Promise<void>;
+}
+/** What the budget has done, with no token and no message ids. */
+export interface TelegramOutboundBudgetStats {
+    /** Calls admitted by `acquire` or `run`. */
+    readonly granted: number;
+    /** Weighted messages admitted: an album of three counts as three. */
+    readonly messages: number;
+    /** Calls waiting for their turn. */
+    readonly queued: number;
+    readonly messagesPerSecond: number;
+    /** How much of the current 429 pause is still ahead, in milliseconds. */
+    readonly pausedForMs: number;
+}
+/**
+ * A token's outbound budget. `run` is the narrow adapter a client transformer
+ * calls around its own send; it gates, pauses on 429 and never retries.
+ */
+export interface TelegramOutboundBudget {
+    /**
+     * Run one Bot API call under the budget. A non-send method passes through
+     * without spending a message. A 429 pauses every sender of the token; the
+     * original error is rethrown and the call is not repeated.
+     */
+    run<T>(method: string, payload: unknown, signal: AbortSignal | undefined, send: () => Promise<T>): Promise<T>;
+    /**
+     * Wait until `cost` messages fit. The wait rejects with `signal.reason`
+     * without spending a token; a granted call owns its slots even if its later
+     * send is aborted, which the caller must not repeat as a definite failure.
+     */
+    acquire(cost: number, signal?: AbortSignal): Promise<void>;
+    /** Pause every sender of this token for at least `milliseconds`. Never shortens an existing pause. */
+    pause(milliseconds: number): void;
+    /** Pause the token after a rate-limited refusal; another failure does nothing. */
+    pauseAfter(error: unknown): void;
+    /**
+     * Wait out the current pause without spending a token. For a retry path that
+     * is not a send (edit, delete) and does not go through `acquire`.
+     */
+    waitUntilResumed(signal?: AbortSignal): Promise<void>;
+    /** Measured counters. It never contains the token. */
+    stats(): TelegramOutboundBudgetStats;
+}
+/**
+ * The one budget for `config.token`, created on first use.
+ *
+ * Two aliases of one token share it; two tokens never do. A second call for a
+ * token already in use must agree on the options, otherwise the process has
+ * two incompatible policies for one credential and the call is refused. The
+ * refusal never contains the token.
+ */
+export declare function telegramOutboundBudget(config: TelegramOutboundBudgetConfig): TelegramOutboundBudget;
+//# sourceMappingURL=outbound-budget.d.ts.map

package/dist/telegram/outbound-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-budget.d.ts","sourceRoot":"","sources":["../../src/telegram/outbound-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAwEH,MAAM,WAAW,4BAA4B;IAC3C,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChF;AAED,kEAAkE;AAClE,MAAM,WAAW,2BAA2B;IAC1C,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,GAAG,CAAC,CAAC,EACH,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,sGAAsG;IACtG,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kFAAkF;IAClF,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,gBAAgB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,sDAAsD;IACtD,KAAK,IAAI,2BAA2B,CAAC;CACtC;AAmMD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,4BAA4B,GACnC,sBAAsB,CAsCxB"}

package/dist/telegram/send-failure.d.ts

@@ -30,8 +30,13 @@
  * user who never pressed Start needs an invitation rather than a retry, and a
  * chat Telegram does not know is usually a bad identifier on our side — a
  * defect in our data, not a fact about a person.
+ *
+ * `bot-to-bot-disabled` is permanent for this send but does not accuse the
+ * recipient: Telegram disables bot-to-bot messaging when *either* bot has not
+ * enabled its Bot to Bot setting, so the missing setting may be the sender's.
+ * It is never retried, and it never marks the recipient unreachable.
  */
-export type TelegramSendFailureReason = 'blocked-by-user' | 'user-deactivated' | 'chat-not-found' | 'not-started' | 'rate-limited' | 'message-invalid' | 'server-error' | 'not-dispatched' | 'unknown';
+export type TelegramSendFailureReason = 'blocked-by-user' | 'user-deactivated' | 'chat-not-found' | 'not-started' | 'bot-to-bot-disabled' | 'rate-limited' | 'message-invalid' | 'server-error' | 'not-dispatched' | 'unknown';
 export interface TelegramSendFailure {
     reason: TelegramSendFailureReason;
     /** Telegram's `error_code`, when the failure carried one. */

package/dist/telegram/send-failure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"send-failure.d.ts","sourceRoot":"","sources":["../../src/telegram/send-failure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH;;;;;;;;;GASG;AACH,MAAM,MAAM,yBAAyB,GACjC,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,cAAc,GACd,gBAAgB,GAChB,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,yBAAyB,CAAC;IAClC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,oBAAoB,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,EAAE,YAAY,GAAG,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;CAC1E;AA+CD;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,yBAAyB,EAC7B,CAAC;AAyClD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CA4D/E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,mBAAmB,GAC3B,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,OAAO,CAAC;AAeZ,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAM/E"}
+{"version":3,"file":"send-failure.d.ts","sourceRoot":"","sources":["../../src/telegram/send-failure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,yBAAyB,GACjC,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,aAAa,GACb,qBAAqB,GACrB,cAAc,GACd,iBAAiB,GACjB,cAAc,GACd,gBAAgB,GAChB,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,yBAAyB,CAAC;IAClC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,oBAAoB,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,EAAE,YAAY,GAAG,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;CAC1E;AAoDD;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,yBAAyB,EAC7B,CAAC;AA4ClD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CA4D/E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,mBAAmB,GAC3B,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,OAAO,CAAC;AAeZ,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAM/E"}

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;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/command.ts"],"names":[],"mappings":"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"}

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

@@ -12,7 +12,7 @@
  * still parsing a success.
  */
 import type { ErrorHintFn } from '../execute-hooks.js';
-import type { ToolResult } from '../execute-result.js';
+import type { ToolFailure, ToolResult } from '../execute-result.js';
 /** Map a `ToolResult.code` to a process exit code. */
 export type ExitCodeMap = Record<string, number>;
 /**
@@ -47,4 +47,8 @@ export interface EmitOptions {
  */
 export declare function cliExitCode(result: ToolResult, exitCodes?: ExitCodeMap): number;
 export declare function emitResult(result: ToolResult, writers: CliWriters, opts: EmitOptions): number;
+/** A presentation failure cannot erase a successfully completed operation. */
+export declare function emitPresentationFailure(result: Extract<ToolResult, {
+    ok: true;
+}>, failure: ToolFailure, writers: CliWriters, opts: EmitOptions): number;
 //# sourceMappingURL=format.d.ts.map

package/dist/tools/cli/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAkBhC,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,SAAS,CAAC,EAAE,WAAW,CAAC;CACzB;AAED;;;;GAIG;AACH;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,CAY/E;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,WAAW,GAChB,MAAM,CAeR"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGjE,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAmBhC,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,SAAS,CAAC,EAAE,WAAW,CAAC;CACzB;AAED;;;;GAIG;AACH;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,CAY/E;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,WAAW,GAChB,MAAM,CAeR;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC,EACzC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,WAAW,GAChB,MAAM,CAmBR"}

package/dist/tools/cli/run-native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-native.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/run-native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,WAAW,CAAC;AAInB,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAkB,MAAM,WAAW,CAAC;AAE3E;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EACL,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,QAAQ,SAAS,SAAS,EAE1B,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAC9C,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,EACzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA+Df"}
+{"version":3,"file":"run-native.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/run-native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,WAAW,CAAC;AAInB,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAkB,MAAM,WAAW,CAAC;AAE3E;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EACL,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,QAAQ,SAAS,SAAS,EAE1B,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAC9C,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,EACzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAyEf"}