stitchkit 0.113.3 → 0.114.1

package/dist/entrypoints/telegram.js

@@ -7,15 +7,20 @@ import {
   attemptExclusiveLock
 } from "../index-5v5a9k2n.js";
 import {
-  TelegramNotDispatchedError2,
-  isTelegramNotDispatchedError,
   TELEGRAM_SEND_FAILURE_REASONS2,
   classifyTelegramSendFailure2
-} from "../index-xvj9h8yh.js";
+} from "../index-61hve0ez.js";
+import {
+  TelegramNotDispatchedError2,
+  isTelegramNotDispatchedError
+} from "../index-6j725ez5.js";
 import {
   TELEGRAM_TEXT_LIMIT2,
   truncateTelegramHtml2
 } from "../index-nmaqxdx7.js";
+import {
+  BOT_TOKEN_SECRET
+} from "../index-sznqf8fx.js";
 import {
   writeFileAtomic2
 } from "../index-07dcf2yn.js";
@@ -26,15 +31,15 @@ import {
   MAX_TIMER_MS,
   sleep
 } from "../index-eemvahkc.js";
+import {
+  untilAborted
+} from "../index-a5qr2rj6.js";
 import {
   assertPositiveSafeInteger
 } from "../index-0s4xebbg.js";
 import {
-  BOT_TOKEN_SECRET
-} from "../index-sznqf8fx.js";
-import {
-  untilAborted
-} from "../index-a5qr2rj6.js";
+  argumentsDigest
+} from "../index-r7a7r7ha.js";
 import {
   isRecord,
   transportResult
@@ -898,6 +903,246 @@ function telegramOperatorSender(config) {
     ...config.fetch && { fetch: config.fetch }
   });
 }
+// src/telegram/outbound-budget.ts
+import { z as z5 } from "zod";
+var DEFAULT_MESSAGES_PER_SECOND = 24;
+var DEFAULT_RETRY_AFTER_FALLBACK_MS = 1000;
+var TOKEN = z5.string().min(1, "token must not be empty");
+var MESSAGES_PER_SECOND = z5.number().positive().max(1000);
+var RETRY_AFTER_FALLBACK_MS = z5.number().int().nonnegative().max(MAX_TIMER_MS);
+var SEND_METHODS = new Set([
+  "sendMessage",
+  "sendPhoto",
+  "sendAudio",
+  "sendDocument",
+  "sendVideo",
+  "sendAnimation",
+  "sendVoice",
+  "sendVideoNote",
+  "sendPaidMedia",
+  "sendMediaGroup",
+  "sendLocation",
+  "sendVenue",
+  "sendContact",
+  "sendPoll",
+  "sendChecklist",
+  "sendDice",
+  "sendMessageDraft",
+  "sendSticker",
+  "sendInvoice",
+  "sendGame",
+  "sendGift",
+  "sendGiveaway",
+  "sendLivePhoto",
+  "sendRichMessage",
+  "copyMessage",
+  "copyMessages",
+  "forwardMessage",
+  "forwardMessages",
+  "answerWebAppQuery"
+]);
+var WEIGHTED_METHODS = new Map([
+  ["sendMediaGroup", "media"],
+  ["sendPaidMedia", "media"],
+  ["copyMessages", "message_ids"],
+  ["forwardMessages", "message_ids"]
+]);
+function sendCost(method, payload) {
+  if (!SEND_METHODS.has(method))
+    return 0;
+  const field = WEIGHTED_METHODS.get(method);
+  if (field === undefined || !isRecord(payload))
+    return 1;
+  const value = payload[field];
+  return Array.isArray(value) ? Math.max(1, value.length) : 1;
+}
+function createBudget(rate, fallback, now, sleepFor) {
+  const interval = 1000 / rate;
+  const queue = [];
+  let nextGrantAt = now();
+  let pausedUntil = Number.NEGATIVE_INFINITY;
+  let granted = 0;
+  let messages = 0;
+  let draining = false;
+  let wake;
+  const wait = async (milliseconds, signal) => {
+    const delay = Math.min(MAX_TIMER_MS, Math.max(0, milliseconds));
+    if (delay <= 0)
+      return;
+    const pending = sleepFor(delay, signal);
+    if (signal)
+      await raceAbort(pending, signal);
+    else
+      await pending;
+  };
+  const wakeWaiting = () => {
+    const current = wake;
+    wake = undefined;
+    current?.abort();
+  };
+  const remove = (waiter) => {
+    const index = queue.indexOf(waiter);
+    if (index === -1)
+      return;
+    queue.splice(index, 1);
+    if (index === 0)
+      wakeWaiting();
+  };
+  const drain = async () => {
+    if (draining)
+      return;
+    draining = true;
+    try {
+      while (queue.length > 0) {
+        const head = queue[0];
+        if (head === undefined)
+          break;
+        if (head.signal?.aborted) {
+          remove(head);
+          continue;
+        }
+        const current = now();
+        const at = Math.max(current, nextGrantAt, pausedUntil);
+        if (at > current) {
+          const controller = new AbortController;
+          wake = controller;
+          try {
+            await wait(at - current, controller.signal);
+          } catch (error) {
+            if (!controller.signal.aborted) {
+              for (const waiter of queue.splice(0)) {
+                if (waiter.onAbort)
+                  waiter.signal?.removeEventListener("abort", waiter.onAbort);
+                waiter.reject(error);
+              }
+              return;
+            }
+          } finally {
+            if (wake === controller)
+              wake = undefined;
+          }
+          continue;
+        }
+        queue.shift();
+        if (head.onAbort)
+          head.signal?.removeEventListener("abort", head.onAbort);
+        nextGrantAt = at + head.cost * interval;
+        granted += 1;
+        messages += head.cost;
+        head.resolve();
+      }
+    } finally {
+      draining = false;
+      if (queue.length > 0)
+        drain();
+    }
+  };
+  const acquire = (cost, signal) => {
+    if (!Number.isSafeInteger(cost) || cost < 1) {
+      return Promise.reject(new RangeError("cost must be an integer of at least one message"));
+    }
+    if (signal?.aborted)
+      return Promise.reject(signal.reason);
+    return new Promise((resolve, reject) => {
+      const waiter = { cost, resolve, reject, ...signal && { signal } };
+      if (signal) {
+        const onAbort = () => {
+          remove(waiter);
+          reject(signal.reason);
+        };
+        waiter.onAbort = onAbort;
+        signal.addEventListener("abort", onAbort, { once: true });
+      }
+      queue.push(waiter);
+      drain();
+    });
+  };
+  const pauseFor = (milliseconds) => {
+    if (Number.isNaN(milliseconds) || milliseconds < 0) {
+      throw new RangeError("pause must be a non-negative number of milliseconds");
+    }
+    const duration = Number.isFinite(milliseconds) ? milliseconds : Number.MAX_SAFE_INTEGER;
+    pausedUntil = Math.max(pausedUntil, now() + duration);
+    wakeWaiting();
+  };
+  const pauseAfter = (error) => {
+    const failure = classifyTelegramSendFailure2(error);
+    if (failure.reason !== "rate-limited")
+      return;
+    pauseFor(failure.retryAfterSeconds === undefined ? fallback : failure.retryAfterSeconds * 1000);
+  };
+  const waitUntilResumed = async (signal) => {
+    while (true) {
+      if (signal?.aborted)
+        throw signal.reason;
+      const remaining = pausedUntil - now();
+      if (remaining <= 0)
+        return;
+      await wait(Math.min(remaining, MAX_TIMER_MS), signal);
+    }
+  };
+  const run = async (method, payload, signal, send) => {
+    if (signal?.aborted)
+      throw signal.reason;
+    const cost = sendCost(method, payload);
+    if (cost > 0)
+      await acquire(cost, signal);
+    if (signal?.aborted)
+      throw signal.reason;
+    let result;
+    try {
+      result = await send();
+    } catch (error) {
+      pauseAfter(error);
+      throw error;
+    }
+    if (isRecord(result) && result.ok === false)
+      pauseAfter(result);
+    return result;
+  };
+  const budget = {
+    run,
+    acquire,
+    pause: pauseFor,
+    pauseAfter,
+    waitUntilResumed,
+    stats: () => ({
+      granted,
+      messages,
+      queued: queue.length,
+      messagesPerSecond: rate,
+      pausedForMs: Math.max(0, pausedUntil - now())
+    })
+  };
+  return budget;
+}
+var budgets = new Map;
+function keyOf(token) {
+  return `telegram-outbound:${argumentsDigest({ token })}`;
+}
+function telegramOutboundBudget(config) {
+  const token = TOKEN.parse(config.token);
+  const rate = MESSAGES_PER_SECOND.parse(config.messagesPerSecond ?? DEFAULT_MESSAGES_PER_SECOND);
+  const fallback = RETRY_AFTER_FALLBACK_MS.parse(config.retryAfterFallbackMs ?? DEFAULT_RETRY_AFTER_FALLBACK_MS);
+  const key = keyOf(token);
+  const existing = budgets.get(key);
+  if (existing) {
+    const same = existing.rate === rate && existing.fallback === fallback && existing.nowOption === config.now && existing.sleepOption === config.sleep;
+    if (!same) {
+      throw new Error("a Telegram outbound budget already exists for this token with different options");
+    }
+    return existing.budget;
+  }
+  const budget = createBudget(rate, fallback, config.now ?? (() => performance.now()), config.sleep ?? sleep);
+  budgets.set(key, {
+    budget,
+    rate,
+    fallback,
+    nowOption: config.now,
+    sleepOption: config.sleep
+  });
+  return budget;
+}
 // src/telegram/transport-connect.ts
 import { lookup } from "node:dns/promises";
 import { connect as connectTcp, isIP } from "node:net";
@@ -2609,6 +2854,7 @@ export {
   sqliteTelegramUpdateStore,
   telegramBroadcastSender,
   telegramOperatorSender,
+  telegramOutboundBudget,
   telegramWebhookUrl,
   verifyTelegramInitData
 };

package/dist/entrypoints/testing.js

@@ -6,7 +6,7 @@ import"../index-p6apg0jg.js";
 import"../index-q0th8q0z.js";
 import {
   createApplication2
-} from "../index-v1tswj0z.js";
+} from "../index-txg1npmg.js";
 import"../index-w5s3xftz.js";
 import {
   RealtimeRequestTimeoutError2,
@@ -15,7 +15,7 @@ import {
 } from "../index-4s0fep5q.js";
 import {
   TOOL_TRANSPORTS2
-} from "../index-fsw1ybf3.js";
+} from "../index-d9hq291n.js";
 import {
   RealtimeRejectDirectionSchema,
   RealtimeRejectPhaseSchema,
@@ -35,7 +35,7 @@ import"../index-k42ckyzx.js";
 import {
   createClient2,
   createClients2
-} from "../index-c5at3ykd.js";
+} from "../index-tsngj2b5.js";
 import {
   assertPositiveSafeInteger
 } from "../index-0s4xebbg.js";

package/dist/entrypoints/tools/connections.js

@@ -11,28 +11,28 @@ import {
 import {
   withSignalDeadline
 } from "../../index-9tqbxv5p.js";
+import {
+  defineRuntimeTool2
+} from "../../index-ega3yz4c.js";
+import {
+  TOOL_ERROR_PROJECTION
+} from "../../index-98hv3sba.js";
 import {
   raceAbort
 } from "../../index-b0kddvzw.js";
 import {
   readBoundedChunks,
   concatChunks
-} from "../../index-5efrpfmj.js";
+} from "../../index-qndsr7f0.js";
 import {
   MAX_TIMER_MS
 } from "../../index-eemvahkc.js";
-import {
-  assertPositiveSafeInteger
-} from "../../index-0s4xebbg.js";
-import {
-  defineRuntimeTool2
-} from "../../index-ega3yz4c.js";
-import {
-  TOOL_ERROR_PROJECTION
-} from "../../index-98hv3sba.js";
 import {
   safeJsonParse
 } from "../../index-zsarb5xp.js";
+import {
+  assertPositiveSafeInteger
+} from "../../index-0s4xebbg.js";
 import {
   AppError2,
   STITCH_ERROR_STATUS2,

package/dist/entrypoints/tools.js

@@ -5,7 +5,7 @@ import {
   createLocalStepDurability2,
   AgentToolError2,
   isAgentToolError2
-} from "../index-56yx8dxp.js";
+} from "../index-tvtacc9a.js";
 import {
   normalizeError2
 } from "../index-k42ckyzx.js";
@@ -33,13 +33,13 @@ import {
   mountAgent2,
   describeToolCatalog2,
   buildToolManifest2
-} from "../index-1csp1hwm.js";
+} from "../index-6p3frkv5.js";
 import"../index-m38ej7e5.js";
 import {
   ALL_TRANSPORTS2,
   TOOL_TRANSPORTS2,
   defineContract2
-} from "../index-fsw1ybf3.js";
+} from "../index-d9hq291n.js";
 import {
   PROTECTED_RESOURCE_PATH2,
   protectedResourceMetadataUrl2,
@@ -74,7 +74,7 @@ import {
   WaitTimeoutError,
   runWaitOperation,
   createCli2
-} from "../index-k7z3j3hr.js";
+} from "../index-km2qw407.js";
 import {
   ManagedFilePathSchema2,
   ManagedFileRefSchema2
@@ -87,9 +87,22 @@ import {
   contractOnlyService,
   mediaTypeEssence
 } from "../index-cqmqyjax.js";
+import {
+  DEFAULT_CORS_ALLOW_HEADERS2
+} from "../index-yk4g8805.js";
 import {
   createToolInvoker2
 } from "../index-vwhrnp67.js";
+import {
+  collectToolSurface
+} from "../index-86nbfysb.js";
+import {
+  getTraceId2
+} from "../index-r6v4mc67.js";
+import {
+  defineRuntimeTool2,
+  createRuntimeToolFactory2
+} from "../index-ega3yz4c.js";
 import {
   ManagedFileError2
 } from "../index-2f9r0jgr.js";
@@ -97,28 +110,15 @@ import {
   fetchGuarded,
   fetchPinnedDocument,
   readCapped
-} from "../index-cxpcdswt.js";
+} from "../index-t65erk4z.js";
 import"../index-1bx1xv1k.js";
 import {
   readBoundedChunks,
   concatChunks
-} from "../index-5efrpfmj.js";
+} from "../index-qndsr7f0.js";
 import {
   assertPositiveSafeInteger
 } from "../index-0s4xebbg.js";
-import {
-  DEFAULT_CORS_ALLOW_HEADERS2
-} from "../index-yk4g8805.js";
-import {
-  collectToolSurface
-} from "../index-86nbfysb.js";
-import {
-  getTraceId2
-} from "../index-r6v4mc67.js";
-import {
-  defineRuntimeTool2,
-  createRuntimeToolFactory2
-} from "../index-ega3yz4c.js";
 import {
   formatZodError2
 } from "../index-1eeqpadm.js";

package/dist/entrypoints/tracking.js

@@ -1,7 +1,7 @@
 import"../index-m38ej7e5.js";
 import {
   defineContract2
-} from "../index-fsw1ybf3.js";
+} from "../index-d9hq291n.js";
 import {
   ApiError2
 } from "../index-kfjkb396.js";

package/dist/{index-xvj9h8yh.js → index-61hve0ez.js}

@@ -1,37 +1,20 @@
+import {
+  isTelegramNotDispatched
+} from "./index-6j725ez5.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";
 
-// src/telegram/not-dispatched.ts
-class TelegramNotDispatchedError2 extends Error {
-  stage;
-  name = "TelegramNotDispatchedError";
-  code = "TELEGRAM_NOT_DISPATCHED";
-  constructor(stage, message, options) {
-    super(message, options);
-    this.stage = stage;
-  }
-}
-function isTelegramNotDispatchedError(error) {
-  return error instanceof TelegramNotDispatchedError2 || error instanceof Error && error.name === "TelegramNotDispatchedError" && Reflect.get(error, "code") === "TELEGRAM_NOT_DISPATCHED";
-}
-function isTelegramNotDispatched(error, depth = 0) {
-  if (error instanceof TelegramNotDispatchedError2)
-    return true;
-  if (typeof error !== "object" || error === null || depth > 4)
-    return false;
-  if (Reflect.get(error, "code") === "TELEGRAM_NOT_DISPATCHED")
-    return true;
-  const nested = Reflect.get(error, "cause") ?? Reflect.get(error, "error");
-  return nested !== error && isTelegramNotDispatched(nested, depth + 1);
-}
-
 // src/telegram/send-failure.ts
 var BY_DESCRIPTION = [
   [/bot was blocked by the user|bot was kicked/i, "blocked-by-user"],
   [/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 +26,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 +66,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 : "";
@@ -168,4 +155,4 @@ function classifyTelegramEditRefusal(error) {
   return "other";
 }
 
-export { TelegramNotDispatchedError2, isTelegramNotDispatchedError, TELEGRAM_SEND_FAILURE_REASONS2, classifyTelegramSendFailure2, classifyTelegramEditRefusal };
+export { TELEGRAM_SEND_FAILURE_REASONS2, classifyTelegramSendFailure2, classifyTelegramEditRefusal };

package/dist/index-6j725ez5.js

@@ -0,0 +1,25 @@
+// src/telegram/not-dispatched.ts
+class TelegramNotDispatchedError2 extends Error {
+  stage;
+  name = "TelegramNotDispatchedError";
+  code = "TELEGRAM_NOT_DISPATCHED";
+  constructor(stage, message, options) {
+    super(message, options);
+    this.stage = stage;
+  }
+}
+function isTelegramNotDispatchedError(error) {
+  return error instanceof TelegramNotDispatchedError2 || error instanceof Error && error.name === "TelegramNotDispatchedError" && Reflect.get(error, "code") === "TELEGRAM_NOT_DISPATCHED";
+}
+function isTelegramNotDispatched(error, depth = 0) {
+  if (error instanceof TelegramNotDispatchedError2)
+    return true;
+  if (typeof error !== "object" || error === null || depth > 4)
+    return false;
+  if (Reflect.get(error, "code") === "TELEGRAM_NOT_DISPATCHED")
+    return true;
+  const nested = Reflect.get(error, "cause") ?? Reflect.get(error, "error");
+  return nested !== error && isTelegramNotDispatched(nested, depth + 1);
+}
+
+export { TelegramNotDispatchedError2, isTelegramNotDispatchedError, isTelegramNotDispatched };

package/dist/{index-1csp1hwm.js → index-6p3frkv5.js}

@@ -10,7 +10,7 @@ import {
 import {
   AgentToolError2,
   resolveToolDurability
-} from "./index-56yx8dxp.js";
+} from "./index-tvtacc9a.js";
 import {
   collectToolSurface
 } from "./index-86nbfysb.js";

package/dist/{index-fy4av0hq.js → index-9bwcthxw.js}

@@ -1,6 +1,6 @@
 import {
   defineContract2
-} from "./index-fsw1ybf3.js";
+} from "./index-d9hq291n.js";
 import {
   bytesToBase64Url,
   base64UrlToBytes

package/dist/{index-523tq7y4.js → index-a3462dqf.js}

@@ -4,7 +4,7 @@ import {
   AgentSandboxRestrictionSchema2,
   AgentSandboxGradeSchema2,
   AGENT_CODING_TOOL_NAMES
-} from "./index-zktz242w.js";
+} from "./index-s47ac8zt.js";
 import {
   AgentRecordIdSchema2,
   AgentRecordVersionSchema2,

package/dist/{index-506kd458.js → index-aw6zahv1.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-b0w7rbpt.js";
 import {
   createAgentRuntimeEventSink2
-} from "./index-616xh7f2.js";
+} from "./index-4qnzda76.js";
 import {
   assertPositiveSafeInteger
 } from "./index-0s4xebbg.js";

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

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

package/dist/{index-erv5shjq.js → index-kdnfe0sr.js}

@@ -5,7 +5,7 @@ import {
   fetchGuarded,
   PrivateAddressRefusal,
   readCapped
-} from "./index-cxpcdswt.js";
+} from "./index-t65erk4z.js";
 import {
   writeFileAtomicSync2
 } from "./index-07dcf2yn.js";

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

@@ -23,19 +23,19 @@ import {
   createToolRunner,
   formatToolError
 } from "./index-htxh46ej.js";
+import {
+  collectToolSurface
+} from "./index-86nbfysb.js";
 import {
   fetchGuarded,
   readCapped
-} from "./index-cxpcdswt.js";
+} from "./index-t65erk4z.js";
 import {
   isWithinDir2
 } from "./index-5cc6r990.js";
 import {
   sleep
 } from "./index-eemvahkc.js";
-import {
-  collectToolSurface
-} from "./index-86nbfysb.js";
 import {
   isUnsafeKey,
   safeJsonParse

package/dist/{index-7fc0c2np.js → index-n3v695sb.js}

@@ -22,7 +22,7 @@ import {
   createLocalStepDurability2,
   isAgentToolError2,
   createToolDurabilityContext
-} from "./index-56yx8dxp.js";
+} from "./index-tvtacc9a.js";
 import {
   canonicalAgentJson2,
   createToolChronology,