stitchkit 0.103.12 → 0.104.0

package/dist/entrypoints/tracking.js

@@ -1,7 +1,7 @@
 import"../index-yex7eg1v.js";
 import {
   ApiError2
-} from "../index-ygkka6zn.js";
+} from "../index-ywppsaby.js";
 import"../index-m38ej7e5.js";
 import {
   defineContract2

package/dist/files/boundary.d.ts

@@ -1,4 +1,6 @@
 import { type ManagedFileRef } from '../contract/file-ref.js';
+import type { FileObservation } from '../internal/bounded-file-read.js';
+export type { FileObservation } from '../internal/bounded-file-read.js';
 export type ManagedFileErrorCode = 'FILE_INVALID_PATH' | 'FILE_NOT_FOUND' | 'FILE_NOT_REGULAR' | 'FILE_OUTSIDE_ROOT' | 'FILE_TOO_LARGE' | 'FILE_EXISTS' | 'FILE_INSPECTION_REJECTED' | 'FILE_UNSAFE_LINK' | 'FILE_CHANGED' | 'FILE_UNSUPPORTED' | 'FILE_IO_ERROR';
 export declare class ManagedFileError extends Error {
     readonly code: ManagedFileErrorCode;
@@ -46,14 +48,6 @@ export interface ManagedFileWriteOptions {
     name?: string;
     signal?: AbortSignal;
 }
-export interface FileObservation {
-    dev: number;
-    ino: number;
-    size: number;
-    nlink: number;
-    mtimeMs: number;
-    ctimeMs: number;
-}
 export interface ManagedFileSource {
     ref: ManagedFileRef;
     bytes: Uint8Array;

package/dist/files/boundary.d.ts.map

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

package/dist/files/file-io.d.ts

@@ -6,11 +6,6 @@ export declare function inspectedRef(path: string, size: number, inspection: Man
     mediaType?: string;
     name?: string;
 }): ManagedFileRef;
-export declare function readHandle(handle: {
-    read(buffer: Uint8Array, offset: number, length: number): Promise<{
-        bytesRead: number;
-    }>;
-}, maxBytes: number, signal?: AbortSignal): Promise<Uint8Array>;
 export declare function writeSource(handle: Awaited<ReturnType<typeof open>>, source: Uint8Array | ReadableStream<Uint8Array>, maxBytes: number, inspectionBytes: number, signal?: AbortSignal): Promise<{
     size: number;
     prefix: Uint8Array;

package/dist/files/file-io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-io.d.ts","sourceRoot":"","sources":["../../src/files/file-io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AA+BpB,wBAAsB,WAAW,CAC/B,SAAS,EAAE,oBAAoB,GAAG,SAAS,EAC3C,KAAK,EAAE,IAAI,CAAC,0BAA0B,EAAE,QAAQ,CAAC,EACjD,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,qBAAqB,CAAC,CAmBhC;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,qBAAqB,EACjC,QAAQ,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,cAAc,CAiBhB;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE;IACN,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1F,EACD,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAkCrB;AAcD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,EACxC,MAAM,EAAE,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,EAC/C,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CA2C/C"}
+{"version":3,"file":"file-io.d.ts","sourceRoot":"","sources":["../../src/files/file-io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AA+BpB,wBAAsB,WAAW,CAC/B,SAAS,EAAE,oBAAoB,GAAG,SAAS,EAC3C,KAAK,EAAE,IAAI,CAAC,0BAA0B,EAAE,QAAQ,CAAC,EACjD,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,qBAAqB,CAAC,CAmBhC;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,qBAAqB,EACjC,QAAQ,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,cAAc,CAiBhB;AAcD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,EACxC,MAAM,EAAE,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,EAC/C,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CA2C/C"}

package/dist/files/read.d.ts

@@ -1,8 +1,8 @@
-import { type Stats } from 'node:fs';
+import type { Stats } from 'node:fs';
 import { type FileHandle } from 'node:fs/promises';
 import type { ManagedFileInspector } from './boundary.js';
 import { type ManagedFileReadOptions, type ManagedFileSource } from './boundary.js';
-/** The descriptor, rather than a preceding path stat, decides kind/link/stability. */
+/** The neutral descriptor owner proves bytes; this adapter adds managed-file metadata. */
 export declare function readManagedDescriptor(target: string, path: string, maxBytes: number, options: ManagedFileReadOptions, inspection: {
     inspect?: ManagedFileInspector;
     bytes: number;

package/dist/files/read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/files/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,kBAAkB,CAAC;AAEzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAGpB,sFAAsF;AACtF,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,sBAAsB,EAC/B,UAAU,EAAE;IAAE,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAChF,cAAc,GAAE,CACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IAAE,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,CAAA;CAAE,CAAQ,GACnF,OAAO,CAAC,iBAAiB,CAAC,CAyE5B"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/files/read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,kBAAkB,CAAC;AAGzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAGpB,0FAA0F;AAC1F,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,sBAAsB,EAC/B,UAAU,EAAE;IAAE,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAChF,cAAc,GAAE,CACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IAAE,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,CAAA;CAAE,CAAQ,GACnF,OAAO,CAAC,iBAAiB,CAAC,CAuB5B"}

package/dist/index-1a6jtnd9.js

@@ -0,0 +1,88 @@
+// src/tools/connections/errors.ts
+class ConnectionAuthorizationRequiredError2 extends Error {
+  connectionName;
+  instanceId;
+  operation;
+  phase;
+  constructor(connectionName, instanceId, context = {}) {
+    super(`Connection "${connectionName}" requires authorization`);
+    this.name = "ConnectionAuthorizationRequiredError";
+    this.connectionName = connectionName;
+    this.instanceId = instanceId;
+    this.operation = context.operation ?? "request";
+    this.phase = context.phase ?? "call";
+  }
+}
+
+class ConnectionRequestError2 extends Error {
+  connectionName;
+  status;
+  body;
+  operation;
+  phase;
+  constructor(connectionName, status, body, context = {}) {
+    super(`Connection "${connectionName}" request failed with status ${status}`);
+    this.name = "ConnectionRequestError";
+    this.connectionName = connectionName;
+    this.status = status;
+    this.body = body;
+    this.operation = context.operation ?? "request";
+    this.phase = context.phase ?? "call";
+  }
+}
+
+class ConnectionUrlError2 extends Error {
+  url;
+  constructor(message, url) {
+    super(message);
+    this.name = "ConnectionUrlError";
+    this.url = url;
+  }
+}
+
+class ConnectionBudgetExceededError2 extends Error {
+  limit;
+  actual;
+  constructor(limit, actual, unit = "tools") {
+    super(`Connection surface exposes ${actual} ${unit}, above the budget of ${limit}`);
+    this.name = "ConnectionBudgetExceededError";
+    this.limit = limit;
+    this.actual = actual;
+  }
+}
+
+class ConnectionTimeoutError2 extends Error {
+  connectionName;
+  timeoutMs;
+  operation;
+  phase;
+  observedReadBytes;
+  constructor(connectionName, timeoutMs, context = {}) {
+    super(`Connection "${connectionName}" timed out after ${timeoutMs} ms`);
+    this.name = "ConnectionTimeoutError";
+    this.connectionName = connectionName;
+    this.timeoutMs = timeoutMs;
+    this.operation = context.operation ?? "request";
+    this.phase = context.phase ?? "call";
+    this.observedReadBytes = context.observedReadBytes ?? 0;
+  }
+}
+
+class ConnectionResponseTooLargeError2 extends Error {
+  connectionName;
+  maxBytes;
+  operation;
+  phase;
+  observedReadBytes;
+  constructor(connectionName, maxBytes, context = {}) {
+    super(`Connection "${connectionName}" response exceeded the ${maxBytes} byte limit`);
+    this.name = "ConnectionResponseTooLargeError";
+    this.connectionName = connectionName;
+    this.maxBytes = maxBytes;
+    this.operation = context.operation ?? "request";
+    this.phase = context.phase ?? "call";
+    this.observedReadBytes = context.observedReadBytes ?? 0;
+  }
+}
+
+export { ConnectionAuthorizationRequiredError2, ConnectionRequestError2, ConnectionUrlError2, ConnectionBudgetExceededError2, ConnectionTimeoutError2, ConnectionResponseTooLargeError2 };

package/dist/{index-fyphpknh.js → index-22rhg58f.js}

@@ -5,7 +5,7 @@ import {
   AppError2,
   STITCH_ERROR_STATUS2,
   isStitchErrorCode2
-} from "./index-n53mswt3.js";
+} from "./index-x928baz2.js";
 import {
   bytesToBase64Url,
   base64UrlToBytes

package/dist/index-269zqj8m.js

@@ -0,0 +1,77 @@
+import {
+  withExclusiveLock2
+} from "./index-g95fk660.js";
+import {
+  writeAtomicFileData
+} from "./index-s4evrmp5.js";
+import {
+  publishAtomicFile
+} from "./index-8a9ksm91.js";
+
+// src/application/file-state-store.ts
+import { mkdir, open, readFile, unlink } from "node:fs/promises";
+import { dirname } from "node:path";
+var missing = (error) => error instanceof Error && ("code" in error) && error.code === "ENOENT";
+function createFileStateStore2(path, options) {
+  if ("staleLockMs" in options || "retryMs" in options)
+    throw new TypeError("File state store lock age/retry options are unsupported");
+  const lockTimeoutMs = options.lockTimeoutMs ?? 1e4;
+  if (!Number.isSafeInteger(lockTimeoutMs) || lockTimeoutMs < 0)
+    throw new TypeError("lockTimeoutMs must be a nonnegative safe integer");
+  const parseFile = async () => {
+    let source;
+    try {
+      source = await readFile(path, "utf8");
+    } catch (error) {
+      if (missing(error))
+        return null;
+      throw error;
+    }
+    try {
+      return options.schema.parse(JSON.parse(source));
+    } catch (error) {
+      await options.onCorrupt?.({ path, error });
+      if (options.corrupt === "empty")
+        return null;
+      throw error;
+    }
+  };
+  return {
+    read: parseFile,
+    async update(transition) {
+      await mkdir(dirname(path), { recursive: true });
+      return withExclusiveLock2(`${path}.lock`, async (lock) => {
+        let active = true;
+        const context = {
+          async assertHeld() {
+            if (!active)
+              throw new Error("State store transaction is no longer active");
+            await lock.assertHeld();
+          }
+        };
+        try {
+          await context.assertHeld();
+          const current = await parseFile();
+          await context.assertHeld();
+          const next = await transition(current, context);
+          await context.assertHeld();
+          const state = options.schema.parse(next.state);
+          await writeAtomicFileData(path, `${JSON.stringify(state)}
+`, { durability: "directory" }, {
+            open,
+            unlink,
+            async publish(staged, target, replace, directorySync) {
+              await context.assertHeld();
+              await publishAtomicFile(staged, target, replace, directorySync);
+            }
+          });
+          return next.result;
+        } finally {
+          active = false;
+        }
+      }, { label: `state store ${path}`, timeoutMs: lockTimeoutMs });
+    }
+  };
+}
+
+export { createFileStateStore2 };

package/dist/{index-r34mvse1.js → index-27a2pj09.js}

@@ -2,7 +2,7 @@ import {
   parseRealtimeRequestArguments,
   parseRealtimeRequestAcknowledgement,
   createValidatedRealtimeSocket
-} from "./index-pw99k9h5.js";
+} from "./index-43p08g7t.js";
 import {
   randomHex
 } from "./index-c9d05kvt.js";

package/dist/{index-r956rndn.js → index-2hyavjjj.js}

@@ -1,16 +1,16 @@
 import {
   isRetryableStatus2
-} from "./index-n53mswt3.js";
+} from "./index-x928baz2.js";
 import {
   rebuildObject,
   mergeSchemas,
   assertToolExtensionCompatible,
   projectToolSurface
-} from "./index-x87j7csh.js";
+} from "./index-77nxk6ay.js";
 import {
   toolErrorFromResult,
   executeToolMethod
-} from "./index-m2xqkv55.js";
+} from "./index-2vnh05w4.js";
 
 // src/tools/mount.ts
 import { z } from "zod";

package/dist/{index-m2xqkv55.js → index-2vnh05w4.js}

@@ -3,11 +3,11 @@ import {
   STITCH_ERROR_STATUS2,
   isRetryableStatus2,
   isStitchErrorCode2
-} from "./index-n53mswt3.js";
+} from "./index-x928baz2.js";
 import {
   normalizeError2,
   validateDeclaredOutput
-} from "./index-b2bz0kdm.js";
+} from "./index-kb8styz3.js";
 import {
   coerceJsonArgs2
 } from "./index-9pw0a51a.js";
@@ -15,7 +15,15 @@ import {
   applyToolViewDefaults,
   projectToolView,
   objectShapeKeys
-} from "./index-x87j7csh.js";
+} from "./index-77nxk6ay.js";
+import {
+  ConnectionAuthorizationRequiredError2,
+  ConnectionRequestError2,
+  ConnectionUrlError2,
+  ConnectionBudgetExceededError2,
+  ConnectionTimeoutError2,
+  ConnectionResponseTooLargeError2
+} from "./index-1a6jtnd9.js";
 import {
   runWithRequestContext2,
   getRequestContext2
@@ -81,10 +89,69 @@ function parseToolCallArguments(method, callArgs, {
   return { ok: true, params, input };
 }
 
+// src/tools/connections/error-projection.ts
+function connectionToolError(error) {
+  if (error instanceof ConnectionTimeoutError2) {
+    const message = "Connection deadline exceeded";
+    return new AppError2("CONNECTION_TIMEOUT", message, STITCH_ERROR_STATUS2.CONNECTION_TIMEOUT, {
+      message,
+      reason: "deadline-exceeded",
+      operation: error.operation,
+      phase: error.phase,
+      timeoutMs: error.timeoutMs,
+      observedReadBytes: error.observedReadBytes
+    }, "Check the connection deadline and verify any write outcome before retrying.", undefined, false);
+  }
+  if (error instanceof ConnectionResponseTooLargeError2) {
+    const message = "Connection response exceeds the byte limit";
+    return new AppError2("CONNECTION_RESPONSE_TOO_LARGE", message, STITCH_ERROR_STATUS2.CONNECTION_RESPONSE_TOO_LARGE, {
+      message,
+      reason: "response-too-large",
+      operation: error.operation,
+      phase: error.phase,
+      maxResponseBytes: error.maxBytes,
+      observedReadBytes: error.observedReadBytes
+    }, "Narrow the response or increase the limit for this operation phase.", undefined, false);
+  }
+  if (error instanceof ConnectionAuthorizationRequiredError2) {
+    const message = "Authorization required";
+    return new AppError2("UNAUTHORIZED", message, STITCH_ERROR_STATUS2.UNAUTHORIZED, {
+      message,
+      reason: "authorization-required",
+      operation: error.operation,
+      phase: error.phase
+    }, "Obtain a new credential before retrying.", undefined, false);
+  }
+  if (error instanceof ConnectionRequestError2) {
+    const forbidden = error.status === 403;
+    const code = forbidden ? "FORBIDDEN" : "CONNECTION_REQUEST_FAILED";
+    const message = forbidden ? "Connection access denied" : "Connection request failed";
+    return new AppError2(code, message, STITCH_ERROR_STATUS2[code], {
+      message,
+      reason: forbidden ? "permission-denied" : "upstream-request-failed",
+      operation: error.operation,
+      phase: error.phase,
+      upstreamStatus: error.status
+    }, forbidden ? "Check the credential permissions." : "Check the upstream service and verify any write outcome before retrying.", undefined, !forbidden && isRetryableStatus2(error.status));
+  }
+  if (error instanceof ConnectionUrlError2) {
+    return new AppError2("BAD_REQUEST", "Connection URL refused", STITCH_ERROR_STATUS2.BAD_REQUEST, { message: "Connection URL refused", reason: "url-rejected" }, "Check the connection URL and its allowed hosts.", undefined, false);
+  }
+  if (error instanceof ConnectionBudgetExceededError2) {
+    return new AppError2("BAD_REQUEST", "Connection mount budget exceeded", STITCH_ERROR_STATUS2.BAD_REQUEST, {
+      message: "Connection mount budget exceeded",
+      reason: "mount-budget-exceeded",
+      limit: error.limit,
+      actual: error.actual
+    }, "Narrow the mounted tool surface or increase its mount budget.", undefined, false);
+  }
+  return;
+}
+
 // src/tools/execute-result.ts
 var normalizedToolErrors = new WeakMap;
 function toolResultFromError(err) {
-  const appErr = normalizeError2(err);
+  const appErr = normalizeError2(connectionToolError(err) ?? err, { logUnexpected: false });
   const result = {
     ok: false,
     code: appErr.code,
@@ -108,6 +175,17 @@ function toolCauseFromResult(result) {
   return normalizedToolErrors.get(result)?.cause;
 }
 
+// src/tools/internal/observe-hook.ts
+async function observed(hook, call) {
+  try {
+    await call();
+  } catch (hookError) {
+    try {
+      console.error(`[stitchkit] ${hook} hook failed:`, hookError);
+    } catch {}
+  }
+}
+
 // src/tools/execute.ts
 class ToolExecutionControlError2 extends Error {
   reason;
@@ -222,15 +300,6 @@ async function resolveToolExtension(extension, keys, rawArgs, context) {
     return { thrown: err };
   }
 }
-async function observed(hook, call) {
-  try {
-    await call();
-  } catch (hookError) {
-    try {
-      console.error(`[stitchkit] ${hook} hook failed:`, hookError);
-    } catch {}
-  }
-}
 async function runToolMethod(method, { toolName, rawArgs, context }, {
   hooks,
   lifecycle,
@@ -340,4 +409,4 @@ async function runToolMethod(method, { toolName, rawArgs, context }, {
   }
 }
 
-export { parseToolCallArguments, toolResultFromError, toolErrorFromResult, toolCauseFromResult, ToolExecutionControlError2, isToolExecutionControlError2, executeToolMethod };
+export { parseToolCallArguments, toolResultFromError, toolErrorFromResult, toolCauseFromResult, observed, ToolExecutionControlError2, isToolExecutionControlError2, executeToolMethod };

package/dist/{index-pw99k9h5.js → index-43p08g7t.js}

@@ -1,6 +1,6 @@
 import {
   AppError2
-} from "./index-n53mswt3.js";
+} from "./index-x928baz2.js";
 import {
   RealtimeRequestInvalidAcknowledgementError2,
   RealtimeRequestRejectedError2

package/dist/{index-xwq9j1sf.js → index-4e0ah203.js}

@@ -2,7 +2,7 @@ import {
   AppError2,
   badRequest2,
   forbidden2
-} from "./index-n53mswt3.js";
+} from "./index-x928baz2.js";
 import {
   isStreamCancellation,
   ownHttpStream,
@@ -14,13 +14,13 @@ import {
   recordedErrorMessage,
   normalizeError2,
   validateDeclaredOutput
-} from "./index-b2bz0kdm.js";
+} from "./index-kb8styz3.js";
 import {
   resolveTraceContext2
 } from "./index-yex7eg1v.js";
 import {
   DEFAULT_CONTRACT_STREAM_FRAME_BYTES2
-} from "./index-r5c4fedv.js";
+} from "./index-h2fhjqy7.js";
 import {
   joinRoutePath,
   parseTrailingWildcard
@@ -31,19 +31,21 @@ import {
 import {
   isModuleNotFound
 } from "./index-srs8hj9c.js";
+import {
+  bindContract,
+  mediaTypeEssence
+} from "./index-g2j7pnak.js";
 import {
   assertCorsConfig,
   isOriginAllowed,
   corsPreflightResponse2,
   requestCorsHeaders,
   applyCors,
-  bindContract,
   DEFAULT_PROCESS_SIGNALS,
   defaultSignalSource,
   reportSignalError,
-  guardSignalCallback,
-  mediaTypeEssence
-} from "./index-afjvjyck.js";
+  guardSignalCallback
+} from "./index-yk4g8805.js";
 import {
   runWithRequestContext2,
   getRequestContext2,

package/dist/{index-nybn2err.js → index-5csmzesf.js}

@@ -1,6 +1,6 @@
 import {
   loadDarwinBinding
-} from "./index-d4pa2bgs.js";
+} from "./index-v5ee8ath.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";

package/dist/{index-qapzv4p5.js → index-5z6jn897.js}

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

package/dist/{index-ahvsksw5.js → index-6d9xaxw1.js}

@@ -1,7 +1,7 @@
 import {
   AppError2,
   STITCH_ERROR_STATUS2
-} from "./index-n53mswt3.js";
+} from "./index-x928baz2.js";
 
 // src/agent-runtime/sandbox.ts
 import { z } from "zod";