stitchkit 0.113.2 → 0.114.0

package/dist/entrypoints/telegram.js

@@ -11,7 +11,7 @@ import {
   isTelegramNotDispatchedError,
   TELEGRAM_SEND_FAILURE_REASONS2,
   classifyTelegramSendFailure2
-} from "../index-xvj9h8yh.js";
+} from "../index-hs35ss3p.js";
 import {
   TELEGRAM_TEXT_LIMIT2,
   truncateTelegramHtml2
@@ -35,6 +35,9 @@ import {
 import {
   untilAborted
 } from "../index-a5qr2rj6.js";
+import {
+  argumentsDigest
+} from "../index-r7a7r7ha.js";
 import {
   isRecord,
   transportResult
@@ -898,6 +901,242 @@ 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;
+    try {
+      return await send();
+    } catch (error) {
+      pauseAfter(error);
+      throw error;
+    }
+  };
+  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 +2848,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-7ysby53h.js";
+} from "../index-v1tswj0z.js";
 import"../index-w5s3xftz.js";
 import {
   RealtimeRequestTimeoutError2,
@@ -30,8 +30,8 @@ import {
   projectToolSurface,
   mcpProjectionCandidate,
   prepareProjectedMcpTools
-} from "../index-vf9c59t3.js";
-import"../index-e40rzw1m.js";
+} from "../index-rhzkndr5.js";
+import"../index-k42ckyzx.js";
 import {
   createClient2,
   createClients2

package/dist/entrypoints/tools/connections.js

@@ -2,8 +2,8 @@ import"../../index-ct75c3at.js";
 import {
   declaresDraft07,
   withDraft2020Keywords
-} from "../../index-vf9c59t3.js";
-import"../../index-e40rzw1m.js";
+} from "../../index-rhzkndr5.js";
+import"../../index-k42ckyzx.js";
 import {
   markJsonSchemaObjectGuards,
   markRemoteSchemaVerdict
@@ -26,10 +26,10 @@ import {
 } from "../../index-0s4xebbg.js";
 import {
   defineRuntimeTool2
-} from "../../index-bv51s0f4.js";
+} from "../../index-ega3yz4c.js";
 import {
   TOOL_ERROR_PROJECTION
-} from "../../index-5gmrx6sc.js";
+} from "../../index-98hv3sba.js";
 import {
   safeJsonParse
 } from "../../index-zsarb5xp.js";
@@ -37,7 +37,7 @@ import {
   AppError2,
   STITCH_ERROR_STATUS2,
   isRetryableStatus2
-} from "../../index-pd578538.js";
+} from "../../index-qcn84byh.js";
 import {
   isRecord
 } from "../../index-9jfdm5tg.js";

package/dist/entrypoints/tools/invoker.js

@@ -1,13 +1,13 @@
-import"../../index-e40rzw1m.js";
+import"../../index-k42ckyzx.js";
 import"../../index-dsa676h8.js";
 import"../../index-rbzq0q16.js";
 import"../../index-ct75c3at.js";
-import"../../index-vf9c59t3.js";
-import"../../index-a31p9ekx.js";
-import"../../index-0gbn42hr.js";
+import"../../index-rhzkndr5.js";
+import"../../index-v6vb5qx8.js";
+import"../../index-htxh46ej.js";
 import {
   createToolInvoker2
-} from "../../index-kvga921h.js";
+} from "../../index-vwhrnp67.js";
 export {
   createToolInvoker2 as createToolInvoker
 };

package/dist/entrypoints/tools/mcp.js

@@ -1,10 +1,10 @@
 import"../../index-ct75c3at.js";
-import"../../index-e40rzw1m.js";
+import"../../index-k42ckyzx.js";
 import"../../index-dsa676h8.js";
 import"../../index-rbzq0q16.js";
-import"../../index-vf9c59t3.js";
-import"../../index-a31p9ekx.js";
-import"../../index-0gbn42hr.js";
+import"../../index-rhzkndr5.js";
+import"../../index-v6vb5qx8.js";
+import"../../index-htxh46ej.js";
 import {
   RESOURCE_MIME_TYPE2,
   EXT_APPS_BUNDLE_PLACEHOLDER2,
@@ -20,9 +20,9 @@ import {
   createMcpHttpRoute2,
   createStdioMcpServer2,
   bindStdioProcessSignals2
-} from "../../index-cn7xenet.js";
-import"../../index-2s7wv547.js";
-import"../../index-bv51s0f4.js";
+} from "../../index-095ya5hm.js";
+import"../../index-86nbfysb.js";
+import"../../index-ega3yz4c.js";
 export {
   EXT_APPS_BUNDLE_PLACEHOLDER2 as EXT_APPS_BUNDLE_PLACEHOLDER,
   MCP_CATALOG_META_KEY2 as MCP_CATALOG_META_KEY,

package/dist/entrypoints/tools.js

@@ -8,7 +8,7 @@ import {
 } from "../index-56yx8dxp.js";
 import {
   normalizeError2
-} from "../index-e40rzw1m.js";
+} from "../index-k42ckyzx.js";
 import"../index-dsa676h8.js";
 import {
   coerceJsonArgs2
@@ -21,19 +21,19 @@ import {
   findNonPortableFormats2,
   flattenToolJsonSchema2,
   findUntypedProperties2
-} from "../index-vf9c59t3.js";
+} from "../index-rhzkndr5.js";
 import {
   ToolExecutionControlError2,
   isToolExecutionControlError2
-} from "../index-a31p9ekx.js";
+} from "../index-v6vb5qx8.js";
 import {
   collectTools2
-} from "../index-0gbn42hr.js";
+} from "../index-htxh46ej.js";
 import {
   mountAgent2,
   describeToolCatalog2,
   buildToolManifest2
-} from "../index-6ez1r4j2.js";
+} from "../index-1csp1hwm.js";
 import"../index-m38ej7e5.js";
 import {
   ALL_TRANSPORTS2,
@@ -60,7 +60,7 @@ import {
   createMcpHttpRoute2,
   createStdioMcpServer2,
   bindStdioProcessSignals2
-} from "../index-cn7xenet.js";
+} from "../index-095ya5hm.js";
 import {
   AsyncOperationCancelResultSchema2,
   createAsyncOperationSnapshotSchema2,
@@ -74,7 +74,7 @@ import {
   WaitTimeoutError,
   runWaitOperation,
   createCli2
-} from "../index-xtc8k5n9.js";
+} from "../index-k7z3j3hr.js";
 import {
   ManagedFilePathSchema2,
   ManagedFileRefSchema2
@@ -82,14 +82,14 @@ import {
 import {
   signJwt2,
   verifyPkce2
-} from "../index-4e36ts8b.js";
+} from "../index-9dyd8xzf.js";
 import {
   contractOnlyService,
   mediaTypeEssence
-} from "../index-vgtzdykw.js";
+} from "../index-cqmqyjax.js";
 import {
   createToolInvoker2
-} from "../index-kvga921h.js";
+} from "../index-vwhrnp67.js";
 import {
   ManagedFileError2
 } from "../index-2f9r0jgr.js";
@@ -111,21 +111,21 @@ import {
 } from "../index-yk4g8805.js";
 import {
   collectToolSurface
-} from "../index-2s7wv547.js";
+} from "../index-86nbfysb.js";
 import {
   getTraceId2
 } from "../index-r6v4mc67.js";
 import {
   defineRuntimeTool2,
   createRuntimeToolFactory2
-} from "../index-bv51s0f4.js";
+} from "../index-ega3yz4c.js";
 import {
   formatZodError2
 } from "../index-1eeqpadm.js";
 import {
   AppError2,
   STITCH_ERROR_STATUS2
-} from "../index-pd578538.js";
+} from "../index-qcn84byh.js";
 import {
   isRecord
 } from "../index-9jfdm5tg.js";

package/dist/{index-cn7xenet.js → index-095ya5hm.js}

@@ -8,17 +8,17 @@ import {
   validateResolvedInputRounds,
   presentationMetadata,
   prepareProjectedMcpTools
-} from "./index-vf9c59t3.js";
+} from "./index-rhzkndr5.js";
 import {
   parseToolCallArguments,
   toolResultFromError,
   observed
-} from "./index-a31p9ekx.js";
+} from "./index-v6vb5qx8.js";
 import {
   collectTools2,
   createToolRunner,
   formatToolError
-} from "./index-0gbn42hr.js";
+} from "./index-htxh46ej.js";
 import {
   DEFAULT_CORS_ALLOW_HEADERS2,
   DEFAULT_PROCESS_SIGNALS,
@@ -31,7 +31,7 @@ import {
 } from "./index-e6c2spsd.js";
 import {
   collectToolSurface
-} from "./index-2s7wv547.js";
+} from "./index-86nbfysb.js";
 import {
   runWithRequestContext2,
   getRequestContext2
@@ -41,7 +41,7 @@ import {
 } from "./index-a5qr2rj6.js";
 import {
   AppError2
-} from "./index-pd578538.js";
+} from "./index-qcn84byh.js";
 import {
   argumentsDigest
 } from "./index-r7a7r7ha.js";

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

@@ -2,21 +2,21 @@ import {
   toolResultFromError,
   toolCauseFromResult,
   isToolExecutionControlError2
-} from "./index-a31p9ekx.js";
+} from "./index-v6vb5qx8.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-0gbn42hr.js";
+} from "./index-htxh46ej.js";
 import {
   AgentToolError2,
   resolveToolDurability
 } from "./index-56yx8dxp.js";
 import {
   collectToolSurface
-} from "./index-2s7wv547.js";
+} from "./index-86nbfysb.js";
 import {
   agentPresenterOf
-} from "./index-bv51s0f4.js";
+} from "./index-ega3yz4c.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";

package/dist/{index-sps9s3aj.js → index-2bqf0a74.js}

@@ -1,6 +1,6 @@
 import {
   createValidatedRealtimeSocket
-} from "./index-grn4brx1.js";
+} from "./index-3za04re9.js";
 
 // src/server/realtime.ts
 function bindRealtimeServer2(contract, handle, options = {}) {

package/dist/{index-grn4brx1.js → index-3za04re9.js}

@@ -7,7 +7,7 @@ import {
 } from "./index-1eeqpadm.js";
 import {
   AppError2
-} from "./index-pd578538.js";
+} from "./index-qcn84byh.js";
 
 // src/realtime/rejected-frame.ts
 var REALTIME_REJECTION_KEY2 = "@stitchkit/realtime-rejected";

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

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

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

@@ -14,7 +14,7 @@ import {
 import {
   ToolExecutionControlError2,
   isToolExecutionControlError2
-} from "./index-a31p9ekx.js";
+} from "./index-v6vb5qx8.js";
 import {
   agentDurableEventId2
 } from "./index-mnkk1ffz.js";

package/dist/{index-2s7wv547.js → index-86nbfysb.js}

@@ -1,12 +1,12 @@
 import {
   projectToolSurface
-} from "./index-vf9c59t3.js";
+} from "./index-rhzkndr5.js";
 import {
   contractToolMountable
-} from "./index-0gbn42hr.js";
+} from "./index-htxh46ej.js";
 import {
   runtimeToolMountable
-} from "./index-bv51s0f4.js";
+} from "./index-ega3yz4c.js";
 
 // src/tools/surface.ts
 function collectToolSurface({

package/dist/{index-5gmrx6sc.js → index-98hv3sba.js}

@@ -1,6 +1,6 @@
 import {
   AppError2
-} from "./index-pd578538.js";
+} from "./index-qcn84byh.js";
 
 // src/tools/internal/tool-error-projection.ts
 var TOOL_ERROR_PROJECTION = Symbol.for("stitchkit.toolErrorProjection");

package/dist/{index-4e36ts8b.js → index-9dyd8xzf.js}

@@ -10,7 +10,7 @@ import {
 } from "./index-zsarb5xp.js";
 import {
   unauthorized2
-} from "./index-pd578538.js";
+} from "./index-qcn84byh.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";

package/dist/{index-zbs0g0v2.js → index-aykhzcnf.js}

@@ -19,7 +19,7 @@ import {
   appendEventIn,
   ArchiveProjectionSchema,
   createAgentRuntimeStore2
-} from "./index-09dyy94r.js";
+} from "./index-523tq7y4.js";
 import {
   AgentConversationPageSchema2,
   AgentConversationMessagePageSchema2

package/dist/{index-0pfk3c1p.js → index-bjcjqj46.js}

@@ -9,7 +9,7 @@ import {
   realtimeRequestTraces,
   createRequestTracer,
   bindRealtimeClient2
-} from "./index-shg5xc9t.js";
+} from "./index-jk29rwkr.js";
 
 // src/browser/retained.ts
 function createRetainedTopics2() {

package/dist/{index-vgtzdykw.js → index-cqmqyjax.js}

@@ -3,7 +3,7 @@ import {
 } from "./index-1bx1xv1k.js";
 import {
   AppError2
-} from "./index-pd578538.js";
+} from "./index-qcn84byh.js";
 import {
   typedEntries,
   callRuntimeHandler

package/dist/{index-bv51s0f4.js → index-ega3yz4c.js}

@@ -1,6 +1,6 @@
 import {
   projectRuntimeTool
-} from "./index-vf9c59t3.js";
+} from "./index-rhzkndr5.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";

package/dist/{index-awbed0mk.js → index-fy4av0hq.js}

@@ -9,7 +9,7 @@ import {
   AppError2,
   STITCH_ERROR_STATUS2,
   isStitchErrorCode2
-} from "./index-pd578538.js";
+} from "./index-qcn84byh.js";
 import {
   typedEntries,
   transportResult,