stitchkit 0.106.1 → 0.108.0

package/dist/entrypoints/process.js

@@ -1,9 +1,9 @@
-import"../index-v5ee8ath.js";
+import"../index-2kbysk9s.js";
 import {
   ProcessInstanceSchema2,
   observeProcessInstance2,
   probeProcessOwner2
-} from "../index-azx12jgv.js";
+} from "../index-bh2ht9y5.js";
 import {
   NativeCommandError2,
   startNativeCommand

package/dist/entrypoints/react.js

@@ -1,10 +1,9 @@
+import {
+  isAbortLikeError
+} from "../index-7jvwrjqa.js";
 import {
   ApiError2
 } from "../index-kfjkb396.js";
-import"../index-yex7eg1v.js";
-import {
-  isAbortLikeError
-} from "../index-n1nszyk0.js";
 import {
   isRecord
 } from "../index-9jfdm5tg.js";

package/dist/entrypoints/remote.js

@@ -1,21 +1,20 @@
-import {
-  ApiError2
-} from "../index-kfjkb396.js";
 import"../index-m38ej7e5.js";
 import"../index-h2fhjqy7.js";
+import"../index-7jvwrjqa.js";
 import {
   endpointHasArguments,
   createClient2
-} from "../index-1pwwan01.js";
-import"../index-yex7eg1v.js";
-import"../index-n1nszyk0.js";
+} from "../index-p5kx5vqd.js";
 import {
-  AppError2,
-  STITCH_ERROR_STATUS2
-} from "../index-j9gxbztg.js";
+  ApiError2
+} from "../index-kfjkb396.js";
 import {
   contractMethodFields
 } from "../index-1bx1xv1k.js";
+import {
+  AppError2,
+  STITCH_ERROR_STATUS2
+} from "../index-j9gxbztg.js";
 import {
   isRecord
 } from "../index-9jfdm5tg.js";

package/dist/entrypoints/server.js

@@ -1,27 +1,33 @@
-import"../index-j4zh647a.js";
-import"../index-dsnjzb62.js";
-import"../index-azx12jgv.js";
-import"../index-v5ee8ath.js";
-import {
-  createFileStateStore2
-} from "../index-1ptj98e0.js";
-import {
-  AppError2,
-  notFound2,
-  badRequest2,
-  unauthorized2,
-  forbidden2,
-  conflict2,
-  rateLimited2,
-  STITCH_ERROR_STATUS2,
-  isStitchErrorCode2,
-  appError2
-} from "../index-j9gxbztg.js";
+import"../index-2kbysk9s.js";
+import"../index-bh2ht9y5.js";
+import"../index-t2bsd0hm.js";
 import {
   errorCode2,
   normalizeError2
-} from "../index-rpzewktb.js";
-import"../index-yex7eg1v.js";
+} from "../index-fynr93w4.js";
+import {
+  DEFAULT_CONTRACT_STREAM_FRAME_BYTES2
+} from "../index-h2fhjqy7.js";
+import {
+  joinRoutePath,
+  parseTrailingWildcard
+} from "../index-m38ej7e5.js";
+import {
+  ShutdownStateSchema2,
+  ShutdownOptionsSchema2,
+  ShutdownStatusSchema2,
+  ShutdownResultSchema2,
+  createServerLifecycle
+} from "../index-q0th8q0z.js";
+import {
+  toJsonSchema,
+  jsonSchemaFields
+} from "../index-ct75c3at.js";
+import"../index-ykdcnq1f.js";
+import"../index-4s0fep5q.js";
+import"../index-fsw1ybf3.js";
+import"../index-q4hjtyye.js";
+import"../index-xqhede6x.js";
 import {
   contextContributionDelta,
   prepareContextContribution,
@@ -42,35 +48,14 @@ import {
   socketIoLane2,
   UnixClientTransportError2,
   createUnixClientTransport2
-} from "../index-wdy68sh6.js";
+} from "../index-njs9gvrh.js";
 import {
-  DEFAULT_CONTRACT_STREAM_FRAME_BYTES2
-} from "../index-h2fhjqy7.js";
-import {
-  ShutdownStateSchema2,
-  ShutdownOptionsSchema2,
-  ShutdownStatusSchema2,
-  ShutdownResultSchema2,
-  createServerLifecycle
-} from "../index-q0th8q0z.js";
-import {
-  joinRoutePath,
-  parseTrailingWildcard
-} from "../index-m38ej7e5.js";
-import"../index-1bx1xv1k.js";
-import {
-  toJsonSchema,
-  jsonSchemaFields
-} from "../index-ct75c3at.js";
-import"../index-pzb63z66.js";
-import"../index-4s0fep5q.js";
-import"../index-fsw1ybf3.js";
-import"../index-x7w1z6pf.js";
-import"../index-xqhede6x.js";
+  createFileStateStore2
+} from "../index-nx49x0tw.js";
 import {
   bindRealtimeServer2
-} from "../index-z23rfxhj.js";
-import"../index-4vsby8n8.js";
+} from "../index-xmgjtkvr.js";
+import"../index-w9mqgnz9.js";
 import {
   withDeadline
 } from "../index-9tqbxv5p.js";
@@ -81,14 +66,14 @@ import {
   verifyJwt2,
   signJwt2,
   verifyPkce2
-} from "../index-37asdw3a.js";
+} from "../index-k7qdkh3n.js";
 import {
   defineMultipartStream2,
   createMultipartStream2,
   implement2,
   createImplement2,
   createScopedImplement2
-} from "../index-cmzvhhtd.js";
+} from "../index-85qve8mq.js";
 import {
   deriveCodeChallenge2
 } from "../index-ap3gqe56.js";
@@ -96,7 +81,7 @@ import {
   isWithinDir2,
   realPathWithinDir
 } from "../index-5cc6r990.js";
-import"../index-cazts87s.js";
+import"../index-1bx1xv1k.js";
 import {
   DEFAULT_CORS_ALLOW_HEADERS2,
   DEFAULT_CORS_EXPOSE_HEADERS2,
@@ -105,7 +90,7 @@ import {
 } from "../index-yk4g8805.js";
 import {
   getTraceId2
-} from "../index-7n68nmc6.js";
+} from "../index-y3nemndz.js";
 import {
   generateTraceId2,
   resolveTraceId2,
@@ -118,6 +103,18 @@ import {
   zodIssues2,
   formatZodError2
 } from "../index-1eeqpadm.js";
+import {
+  AppError2,
+  notFound2,
+  badRequest2,
+  unauthorized2,
+  forbidden2,
+  conflict2,
+  rateLimited2,
+  STITCH_ERROR_STATUS2,
+  isStitchErrorCode2,
+  appError2
+} from "../index-j9gxbztg.js";
 import {
   isUnsafeKey
 } from "../index-zsarb5xp.js";

package/dist/entrypoints/telegram/html.js

@@ -1,3 +1,6 @@
+import {
+  checkTelegramHtml2
+} from "../../index-rz3z13e9.js";
 import {
   TELEGRAM_TEXT_LIMIT2,
   TELEGRAM_CAPTION_LIMIT2,
@@ -9,9 +12,6 @@ import {
   splitTelegramHtml2,
   truncateTelegramHtml2
 } from "../../index-nmaqxdx7.js";
-import {
-  checkTelegramHtml2
-} from "../../index-rz3z13e9.js";
 export {
   TELEGRAM_CAPTION_LIMIT2 as TELEGRAM_CAPTION_LIMIT,
   TELEGRAM_TEXT_LIMIT2 as TELEGRAM_TEXT_LIMIT,

package/dist/entrypoints/telegram/screens.js

@@ -1,18 +1,18 @@
-import {
-  TELEGRAM_TEXT_LIMIT2,
-  TELEGRAM_CAPTION_LIMIT2,
-  escapeTelegramHtml2
-} from "../../index-nmaqxdx7.js";
 import {
   joinRoutePath,
   parseRoutePattern
 } from "../../index-m38ej7e5.js";
 import {
   classifyTelegramEditRefusal
-} from "../../index-e05cjgtf.js";
+} from "../../index-xvj9h8yh.js";
 import {
   checkTelegramHtml2
 } from "../../index-rz3z13e9.js";
+import {
+  TELEGRAM_TEXT_LIMIT2,
+  TELEGRAM_CAPTION_LIMIT2,
+  escapeTelegramHtml2
+} from "../../index-nmaqxdx7.js";
 import {
   createMutationQueue
 } from "../../index-sykb5ag7.js";

package/dist/entrypoints/telegram.d.ts

@@ -3,9 +3,11 @@ export { runTelegramBroadcast, type TelegramBroadcastConfig, type TelegramBroadc
 export { type TelegramBroadcastFailure, TelegramBroadcastFailureSchema, } from '../telegram/broadcast-failure.js';
 export { type TelegramInitData, type TelegramInitDataRefusal, type TelegramInitDataVerification, type VerifyTelegramInitDataOptions, verifyTelegramInitData, } from '../telegram/init-data.js';
 export { createTelegramLocalFiles, TelegramLocalFileError, type TelegramLocalFileRefusal, type TelegramLocalFiles, type TelegramLocalFilesCheck, type TelegramLocalFilesConfig, } from '../telegram/local-files.js';
+export { TelegramNotDispatchedError, type TelegramNotDispatchedStage, } from '../telegram/not-dispatched.js';
 export { createTelegramOperatorChannel, type TelegramChatId, type TelegramOperatorChannel, type TelegramOperatorChannelConfig, type TelegramOperatorDrop, type TelegramOperatorMessage, type TelegramOperatorSenderConfig, telegramOperatorSender, } from '../telegram/operator-channel.js';
 export { createTelegramOperatorDedupe, type TelegramOperatorDedupe, type TelegramOperatorDedupeVerdict, } from '../telegram/operator-dedupe.js';
 export { classifyTelegramSendFailure, TELEGRAM_SEND_FAILURE_REASONS, type TelegramSendFailure, type TelegramSendFailureReason, } from '../telegram/send-failure.js';
+export { createTelegramBotTransport, type TelegramBotTransportOpen, type TelegramBotTransportOptions, type TelegramBotTransportResolve, type TelegramBotTransportSocket, type TelegramFetch, } from '../telegram/transport.js';
 export { createTelegramUpdateIntake, type TelegramUpdateEnvelope, type TelegramUpdateFailure, type TelegramUpdateIntake, type TelegramUpdateIntakeConfig, type TelegramUpdateStoreStep, } from '../telegram/update-intake.js';
 export { memoryTelegramUpdateStore, type StoredTelegramUpdate, type TelegramUpdateClaimOptions, type TelegramUpdateDueQuery, type TelegramUpdateSettlement, type TelegramUpdateState, type TelegramUpdateStore, } from '../telegram/update-store.js';
 export { checkTelegramUpdateStore } from '../telegram/update-store-check.js';

package/dist/entrypoints/telegram.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/entrypoints/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,kBAAkB,EACvB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,wBAAwB,EAC7B,8BAA8B,GAC/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,6BAA6B,EAC7B,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,GACnC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,0BAA0B,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,GAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EACL,KAAK,iCAAiC,EACtC,2BAA2B,EAC3B,iCAAiC,EACjC,KAAK,qBAAqB,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,KAAK,+BAA+B,EACpC,yBAAyB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACL,KAAK,0BAA0B,EAC/B,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,6BAA6B,EAClC,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/entrypoints/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,kBAAkB,EACvB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,wBAAwB,EAC7B,8BAA8B,GAC/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,EAC1B,KAAK,0BAA0B,GAChC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,6BAA6B,EAC7B,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,GACnC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,0BAA0B,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,0BAA0B,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,GAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EACL,KAAK,iCAAiC,EACtC,2BAA2B,EAC3B,iCAAiC,EACjC,KAAK,qBAAqB,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,KAAK,+BAA+B,EACpC,yBAAyB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACL,KAAK,0BAA0B,EAC/B,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,6BAA6B,EAClC,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/entrypoints/telegram.js

@@ -1,33 +1,40 @@
-import {
-  BOT_TOKEN_SECRET
-} from "../index-sznqf8fx.js";
 import {
   backoffDelay
 } from "../index-g6a3na27.js";
+import"../index-2kbysk9s.js";
+import"../index-bh2ht9y5.js";
 import {
+  attemptExclusiveLock
+} from "../index-t2bsd0hm.js";
+import {
+  TelegramNotDispatchedError2,
+  isTelegramNotDispatchedError,
   TELEGRAM_SEND_FAILURE_REASONS2,
   classifyTelegramSendFailure2
-} from "../index-e05cjgtf.js";
-import"../index-j4zh647a.js";
-import {
-  attemptExclusiveLock
-} from "../index-dsnjzb62.js";
-import"../index-azx12jgv.js";
-import"../index-v5ee8ath.js";
+} from "../index-xvj9h8yh.js";
 import {
   TELEGRAM_TEXT_LIMIT2,
   truncateTelegramHtml2
 } from "../index-nmaqxdx7.js";
+import {
+  untilAborted
+} from "../index-a5qr2rj6.js";
 import {
   raceAbort
 } from "../index-b0kddvzw.js";
 import {
   writeFileAtomic2
-} from "../index-cazts87s.js";
+} from "../index-07dcf2yn.js";
 import {
   MAX_TIMER_MS,
   sleep
 } from "../index-eemvahkc.js";
+import {
+  assertPositiveSafeInteger
+} from "../index-0s4xebbg.js";
+import {
+  BOT_TOKEN_SECRET
+} from "../index-sznqf8fx.js";
 import {
   isRecord,
   transportResult
@@ -73,6 +80,8 @@ async function callTelegramBotApi(call) {
   } catch (error) {
     if (call.signal?.aborted)
       throw call.signal.reason;
+    if (isTelegramNotDispatchedError(error))
+      throw error;
     const kind = error instanceof Error ? error.name : "Error";
     throw new Error(`Telegram ${call.method} request failed (${kind})`);
   }
@@ -889,6 +898,328 @@ function telegramOperatorSender(config) {
     ...config.fetch && { fetch: config.fetch }
   });
 }
+// src/telegram/transport-connect.ts
+import { lookup } from "node:dns/promises";
+import { connect as connectTcp, isIP } from "node:net";
+import { connect as connectTls } from "node:tls";
+var NEXT_ADDRESS_DELAY_MS = 250;
+var MAX_ROUNDS = 3;
+var resolveAll = async (host) => (await lookup(host, { all: true, verbatim: true })).map((entry) => entry.address);
+var openSocket = ({ address, port, tls, servername }) => tls ? connectTls({
+  host: address,
+  port,
+  ...servername !== undefined && { servername },
+  ALPNProtocols: ["http/1.1"]
+}) : connectTcp({ host: address, port });
+var connectedEvent = (socket) => ("encrypted" in socket) && socket.encrypted ? "secureConnect" : "connect";
+function race(addresses, target, open, timeoutMs, signal) {
+  return new Promise((resolve) => {
+    const sockets = [];
+    const timers = [];
+    let failed = 0;
+    let started = 0;
+    let lastFailure;
+    let settled = false;
+    const finish = (winner) => {
+      if (settled)
+        return;
+      settled = true;
+      for (const timer of timers)
+        clearTimeout(timer);
+      signal?.removeEventListener("abort", abort);
+      for (const socket of sockets)
+        if (socket !== winner)
+          socket.destroy();
+      resolve(winner ? { socket: winner } : { failure: lastFailure });
+    };
+    const abort = () => finish(undefined);
+    const failOne = (cause) => {
+      lastFailure = cause;
+      if (++failed === addresses.length)
+        finish(undefined);
+      else
+        launchNext();
+    };
+    const launchNext = () => {
+      if (settled)
+        return;
+      const address = addresses[started++];
+      if (address === undefined)
+        return;
+      let socket;
+      try {
+        socket = open({ address, ...target });
+      } catch (cause) {
+        failOne(cause);
+        return;
+      }
+      sockets.push(socket);
+      socket.once(connectedEvent(socket), () => finish(socket));
+      socket.once("error", (cause) => {
+        socket.destroy();
+        failOne(cause);
+      });
+      if (started < addresses.length)
+        timers.push(setTimeout(launchNext, NEXT_ADDRESS_DELAY_MS));
+    };
+    timers.push(setTimeout(() => finish(undefined), timeoutMs));
+    signal?.addEventListener("abort", abort, { once: true });
+    if (signal?.aborted)
+      finish(undefined);
+    else
+      launchNext();
+  });
+}
+function lookupWithin(host, policy, signal) {
+  return new Promise((resolve, reject) => {
+    const settle = (act) => {
+      clearTimeout(timer);
+      signal?.removeEventListener("abort", abort);
+      act();
+    };
+    const abort = () => settle(() => reject(signal?.reason));
+    const timer = setTimeout(() => settle(() => reject(new Error(`Address lookup took longer than ${policy.budgetMs} ms`))), policy.budgetMs);
+    if (signal?.aborted) {
+      abort();
+      return;
+    }
+    signal?.addEventListener("abort", abort, { once: true });
+    Promise.resolve().then(() => policy.resolve(host)).then((found) => settle(() => resolve(found)), (error) => settle(() => reject(error)));
+  });
+}
+async function establish(host, port, tls, policy, signal) {
+  const literal = isIP(host) !== 0;
+  let addresses;
+  if (literal)
+    addresses = [host];
+  else {
+    try {
+      addresses = await lookupWithin(host, policy, signal);
+    } catch (cause) {
+      signal?.throwIfAborted();
+      throw new TelegramNotDispatchedError2("lookup", "Telegram address lookup failed", {
+        cause
+      });
+    }
+  }
+  signal?.throwIfAborted();
+  if (addresses.length === 0)
+    throw new TelegramNotDispatchedError2("lookup", "Telegram address lookup returned nothing");
+  const target = { port, tls, servername: tls && !literal ? host : undefined };
+  const deadline = performance.now() + policy.budgetMs;
+  let lastFailure;
+  for (let round = 0;round < MAX_ROUNDS; round++) {
+    const left = deadline - performance.now();
+    if (left <= 0)
+      break;
+    const outcome = await race(addresses, target, policy.open, Math.min(policy.attemptMs, left), signal);
+    if (signal?.aborted && "socket" in outcome)
+      outcome.socket.destroy();
+    signal?.throwIfAborted();
+    if ("socket" in outcome)
+      return outcome.socket;
+    lastFailure = outcome.failure ?? lastFailure;
+  }
+  throw new TelegramNotDispatchedError2("connect", "Telegram connection was not established", {
+    cause: lastFailure
+  });
+}
+
+// src/telegram/transport.ts
+function chunkedBody(body) {
+  const parts = [];
+  let at = 0;
+  for (;; ) {
+    const lineEnd = body.indexOf(`\r
+`, at);
+    if (lineEnd < 0)
+      throw new Error("Telegram chunked answer was truncated");
+    const size = Number.parseInt(body.subarray(at, lineEnd).toString("latin1"), 16);
+    if (!Number.isSafeInteger(size) || size < 0)
+      throw new Error("Telegram chunked answer had an invalid chunk size");
+    if (size === 0)
+      return Buffer.concat(parts);
+    const start = lineEnd + 2;
+    if (start + size > body.length)
+      throw new Error("Telegram chunked answer was truncated");
+    parts.push(body.subarray(start, start + size));
+    at = start + size + 2;
+  }
+}
+function answerHead(raw) {
+  const headEnd = raw.indexOf(`\r
+\r
+`);
+  if (headEnd < 0)
+    return;
+  const [statusLine = "", ...lines] = raw.subarray(0, headEnd).toString("latin1").split(`\r
+`);
+  const status = /^HTTP\/1\.[01] (\d{3})/.exec(statusLine)?.[1];
+  if (status === undefined)
+    throw new Error("Telegram answer had an invalid status line");
+  if (Number(status) < 200)
+    throw new Error(`Telegram answer was an interim response (HTTP ${status}), not a final one`);
+  const headers = new Headers;
+  for (const line of lines) {
+    const colon = line.indexOf(":");
+    if (colon > 0)
+      headers.append(line.slice(0, colon).trim(), line.slice(colon + 1).trim());
+  }
+  return { bodyStart: headEnd + 4, status: Number(status), headers };
+}
+var bodiless = (status) => status === 204 || status === 304;
+var isChunked = (headers) => /\bchunked\b/i.test(headers.get("transfer-encoding") ?? "");
+function declaredLength(headers) {
+  const raw = headers.get("content-length");
+  if (raw === null)
+    return;
+  const values = new Set(raw.split(",").map((value) => value.trim()));
+  const [only = ""] = values;
+  if (values.size !== 1 || !/^\d{1,15}$/.test(only))
+    throw new Error("Telegram answer had an invalid Content-Length");
+  return Number(only);
+}
+function answerComplete(raw) {
+  const head = answerHead(raw);
+  if (!head)
+    return false;
+  if (bodiless(head.status))
+    return true;
+  const body = raw.subarray(head.bodyStart);
+  if (isChunked(head.headers)) {
+    try {
+      chunkedBody(body);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  const length = declaredLength(head.headers);
+  return length !== undefined && body.length >= length;
+}
+function parseAnswer(raw) {
+  const head = answerHead(raw);
+  if (!head)
+    throw new Error("Telegram answer ended inside its head");
+  const { status, headers } = head;
+  let body = raw.subarray(head.bodyStart);
+  if (isChunked(headers)) {
+    body = chunkedBody(body);
+    headers.delete("content-length");
+  } else {
+    const expected = declaredLength(headers);
+    if (expected !== undefined) {
+      if (body.length < expected)
+        throw new Error("Telegram answer body was truncated");
+      body = body.subarray(0, expected);
+    }
+  }
+  headers.delete("transfer-encoding");
+  return new Response(bodiless(status) ? null : new Uint8Array(body), { status, headers });
+}
+function exchange(socket, request, limits, signal) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    let bytes = 0;
+    let done = false;
+    const finish = (error) => {
+      if (done)
+        return;
+      done = true;
+      clearTimeout(timer);
+      signal?.removeEventListener("abort", abort);
+      socket.destroy();
+      if (error !== undefined) {
+        reject(error);
+        return;
+      }
+      try {
+        resolve(parseAnswer(Buffer.concat(chunks)));
+      } catch (parseError) {
+        reject(parseError);
+      }
+    };
+    const abort = () => finish(signal?.reason);
+    const timer = setTimeout(() => finish(new Error(`Telegram answer took longer than ${limits.responseTimeoutMs} ms`)), limits.responseTimeoutMs);
+    socket.on("data", (chunk) => {
+      bytes += chunk.byteLength;
+      if (bytes > limits.maxResponseBytes) {
+        finish(new Error(`Telegram answer exceeded ${limits.maxResponseBytes} bytes`));
+        return;
+      }
+      chunks.push(chunk);
+      try {
+        if (answerComplete(Buffer.concat(chunks)))
+          finish(undefined);
+      } catch (error) {
+        finish(error);
+      }
+    });
+    socket.once("end", () => finish(undefined));
+    socket.once("close", () => finish(undefined));
+    socket.once("error", (error) => finish(error));
+    signal?.addEventListener("abort", abort, { once: true });
+    if (signal?.aborted)
+      abort();
+    else
+      socket.write(request);
+  });
+}
+async function requestBytes(url, init, signal) {
+  let request;
+  let headers;
+  let body;
+  try {
+    request = new Request(url, { ...init, signal: null });
+    headers = [...request.headers].filter(([name]) => !["host", "content-length", "connection", "transfer-encoding"].includes(name));
+    const read = request.arrayBuffer();
+    body = new Uint8Array(await (signal ? untilAborted(read, signal) : read));
+  } catch (cause) {
+    signal?.throwIfAborted();
+    throw new TelegramNotDispatchedError2("request", "Telegram request body could not be read", {
+      cause
+    });
+  }
+  const head = [
+    `${request.method} ${url.pathname}${url.search} HTTP/1.1`,
+    `Host: ${url.host}`,
+    ...headers.map(([name, value]) => `${name}: ${value}`),
+    `Content-Length: ${body.byteLength}`,
+    "Connection: close",
+    "",
+    ""
+  ].join(`\r
+`);
+  return { head, body };
+}
+function createTelegramBotTransport(options = {}) {
+  const connectAttemptMs = options.connectAttemptMs ?? 2000;
+  const connectBudgetMs = options.connectBudgetMs ?? 5000;
+  const responseTimeoutMs = options.responseTimeoutMs ?? 30000;
+  const maxResponseBytes = options.maxResponseBytes ?? 1024 * 1024;
+  assertPositiveSafeInteger("connectAttemptMs", connectAttemptMs);
+  assertPositiveSafeInteger("connectBudgetMs", connectBudgetMs);
+  assertPositiveSafeInteger("responseTimeoutMs", responseTimeoutMs);
+  assertPositiveSafeInteger("maxResponseBytes", maxResponseBytes);
+  const policy = {
+    resolve: options.resolve ?? resolveAll,
+    open: options.open ?? openSocket,
+    attemptMs: connectAttemptMs,
+    budgetMs: connectBudgetMs
+  };
+  return async (url, init) => {
+    const signal = init.signal ?? undefined;
+    signal?.throwIfAborted();
+    const target = new URL(url);
+    const tls = target.protocol === "https:";
+    if (!tls && target.protocol !== "http:")
+      throw new TelegramNotDispatchedError2("request", `Telegram transport speaks http and https, not ${target.protocol}`);
+    const { head, body } = await requestBytes(target, init, signal);
+    signal?.throwIfAborted();
+    const socket = await establish(target.hostname.replace(/^\[|\]$/g, ""), Number(target.port || (tls ? 443 : 80)), tls, policy, signal);
+    return exchange(socket, Buffer.concat([Buffer.from(head, "latin1"), body]), { maxResponseBytes, responseTimeoutMs }, signal);
+  };
+}
 // src/telegram/update-intake.ts
 var SWEEP_BATCH = 100;
 function defaultRetry(error, attempt) {
@@ -1525,12 +1856,14 @@ export {
   TelegramBotApiError,
   TelegramBroadcastFailureSchema,
   TelegramLocalFileError,
+  TelegramNotDispatchedError2 as TelegramNotDispatchedError,
   TelegramWebhookClaimError,
   callTelegramBotApi,
   checkTelegramUpdateStore,
   checkTelegramWebhook,
   claimTelegramWebhook,
   classifyTelegramSendFailure2 as classifyTelegramSendFailure,
+  createTelegramBotTransport,
   createTelegramLocalFiles,
   createTelegramOperatorChannel,
   createTelegramOperatorDedupe,

package/dist/entrypoints/testing.d.ts

@@ -4,6 +4,7 @@
  */
 export * from '../testing/handler-clients.js';
 export { type ManagedResourceConformanceConfig, type ManagedResourceConformanceControls, ManagedResourceConformanceError, type ManagedResourceConformanceFactoryInput, type ManagedResourceConformanceFixture, type ManagedResourceConformancePhase, ManagedResourceConformancePhaseSchema, type ManagedResourceConformanceScenario, type ManagedResourceConformanceScenarioId, ManagedResourceConformanceScenarioIdSchema, ManagedResourceConformanceScenarioSchema, type ManagedResourceConformanceTraceEntry, ManagedResourceConformanceTraceEntrySchema, type ManagedResourceConformanceTraceOutcome, ManagedResourceConformanceTraceOutcomeSchema, runManagedResourceConformance, } from '../testing/managed-resource-conformance.js';
+export { createManualClock, type ManualClock, ManualClockError, type ManualClockErrorCode, type ManualClockHold, type ManualClockOptions, type ManualClockTimer, type ManualClockUntilOptions, } from '../testing/manual-clock.js';
 export { type CreateRealtimeProbeDriverConfig, createRealtimeProbeDriver, type DefineRealtimeProbeConfig, defineRealtimeProbe, type RealtimeProbeAdapter, type RealtimeProbeFixture, type RealtimeProbeScenario, } from '../testing/realtime-probe.js';
 export { assertSurfaceDiscovery, type ConformanceTransport, type RealtimeDisconnectObservation, RealtimeDisconnectObservationSchema, type RealtimeRejectionObservation, RealtimeRejectionObservationSchema, type RunSurfaceProbesConfig, runSurfaceProbes, type SurfaceDiscoveryObservation, type SurfaceProbe, type SurfaceProbeDriver, type SurfaceRealtimeDiscoveryObservation, type SurfaceToolDiscoveryObservation, type TransportObservation, TransportObservationSchema, } from '../testing/surface-conformance.js';
 export { assertSurfaceManifestSnapshot, buildSurfaceManifest, type IncompatibleSchemaPolicy, type McpSchemaValidationConfig, SURFACE_MANIFEST_VERSION, type SurfaceAgentProjection, type SurfaceManifest, type SurfaceManifestConfig, type SurfaceManifestExtension, SurfaceManifestExtensionSchema, type SurfaceManifestOperation, type SurfaceManifestOperationMcp, SurfaceManifestOperationMcpSchema, SurfaceManifestOperationSchema, type SurfaceManifestOperationToolView, SurfaceManifestOperationToolViewSchema, type SurfaceManifestRealtimeEvent, SurfaceManifestRealtimeEventSchema, SurfaceManifestSchema, type SurfaceManifestTool, SurfaceManifestToolSchema, type SurfaceManifestToolSurface, SurfaceManifestToolSurfaceSchema, type SurfaceMcpPreparation, SurfaceRealtimeSchemaPairSchema, type SurfaceRuntimeToolDefinition, SurfaceSchemaDigestsSchema, type SurfaceToolDefinition, type SurfaceToolExtension, } from '../testing/surface-manifest.js';