stitchkit 0.68.9 → 0.68.11

package/dist/{index-n34x0q5e.js → index-hb0mncmj.js}

@@ -3,17 +3,17 @@ import {
   inputIsQuery,
   parseSSE,
   readBoundedUtf8Lines
-} from "./index-r5s4wqb5.js";
+} from "./index-t23p2b68.js";
 import {
   ContractStreamFrameSchema,
   DEFAULT_CONTRACT_STREAM_FRAME_BYTES,
   parseTrailingWildcard
-} from "./index-bmmtz6r9.js";
+} from "./index-pgsyp3xh.js";
 import {
   isRecord,
   mapObject,
   typedEntries
-} from "./index-smpbdg6k.js";
+} from "./index-qyrqwr4c.js";
 
 // src/browser/cancellation.ts
 class RequestCancellationError extends Error {

package/dist/{index-6tqys26z.js → index-hcx9yypn.js}

@@ -7,7 +7,7 @@ import {
   defaultSignalSource,
   guardSignalCallback,
   reportSignalError
-} from "./index-z575awm9.js";
+} from "./index-hxh98zbm.js";
 import {
   extractIp,
   getClientInfo,
@@ -18,7 +18,7 @@ import {
   runWithRequestContext,
   setRequestEndpoint,
   setRequestError
-} from "./index-51a19y3v.js";
+} from "./index-f24xg2cw.js";
 import {
   ShutdownOptionsSchema
 } from "./index-dk6e56g0.js";
@@ -34,11 +34,11 @@ import {
   safeJsonParse,
   validateDeclaredOutput,
   zodIssues
-} from "./index-bmmtz6r9.js";
+} from "./index-pgsyp3xh.js";
 import {
   isRecord,
   transportResult
-} from "./index-smpbdg6k.js";
+} from "./index-qyrqwr4c.js";
 import {
   AppError,
   badRequest

package/dist/{index-z575awm9.js → index-hxh98zbm.js}

@@ -1,13 +1,13 @@
 import {
   isUnsafeKey,
   mergeMeta
-} from "./index-bmmtz6r9.js";
+} from "./index-pgsyp3xh.js";
 import {
   callRuntimeHandler,
   isRecord,
   transportResult,
   typedEntries
-} from "./index-smpbdg6k.js";
+} from "./index-qyrqwr4c.js";
 
 // src/server/middleware/cors.ts
 var DEFAULT_CORS_ALLOW_HEADERS = "Content-Type, Authorization, X-Trace-Id, traceparent, tracestate";

package/dist/{index-bmmtz6r9.js → index-pgsyp3xh.js}

@@ -1,6 +1,6 @@
 import {
   isRecord
-} from "./index-smpbdg6k.js";
+} from "./index-qyrqwr4c.js";
 import {
   AppError
 } from "./index-0w9abg87.js";

package/dist/index-qyrqwr4c.js

@@ -0,0 +1,41 @@
+// src/internal/typed.ts
+function typedEntries(value) {
+  return Object.entries(value);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function callRuntimeHandler(handler, context) {
+  if (typeof handler !== "function") {
+    throw new TypeError("Runtime handler must be a function");
+  }
+  return Reflect.apply(handler, undefined, [context]);
+}
+function executableAgentRuntimeTools(tools) {
+  for (const tool of tools) {
+    if (typeof tool.handler !== "function") {
+      throw new TypeError(`Runtime tool "${tool.name}" must provide a handler`);
+    }
+    if (tool.present?.agent !== undefined && typeof tool.present.agent !== "function") {
+      throw new TypeError(`Runtime tool "${tool.name}" Agent presenter must be a function`);
+    }
+    if (tool.present?.agent !== undefined && tool.output === undefined) {
+      throw new TypeError(`Runtime tool "${tool.name}" Agent presenter requires an output schema`);
+    }
+  }
+  return tools;
+}
+function transportResult(value) {
+  return value;
+}
+function mapObject(source, mapper) {
+  const result = {};
+  for (const [key, value] of typedEntries(source)) {
+    const mapped = mapper(key, value);
+    if (mapped !== undefined)
+      result[key] = mapped;
+  }
+  return result;
+}
+
+export { typedEntries, isRecord, callRuntimeHandler, executableAgentRuntimeTools, transportResult, mapObject };

package/dist/{index-r5s4wqb5.js → index-t23p2b68.js}

@@ -1,6 +1,6 @@
 import {
   normalizeError
-} from "./index-bmmtz6r9.js";
+} from "./index-pgsyp3xh.js";
 
 // src/internal/bounded-lines.ts
 var DEFAULT_STREAM_LINE_BYTES = 1024 * 1024;

package/dist/{index-3ydx9j01.js → index-xyvxez9r.js}

@@ -2,16 +2,16 @@ import {
   contextContributionDelta,
   mergeContextContribution,
   prepareContextContribution
-} from "./index-z575awm9.js";
+} from "./index-hxh98zbm.js";
 import {
   base64UrlToBytes,
   bytesToBase64Url,
   isUnsafeKey,
   safeJsonParse
-} from "./index-bmmtz6r9.js";
+} from "./index-pgsyp3xh.js";
 import {
   isRecord
-} from "./index-smpbdg6k.js";
+} from "./index-qyrqwr4c.js";
 import {
   forbidden,
   unauthorized

package/dist/{index-04agqrs8.js → index-y2ctppmg.js}

@@ -1,20 +1,24 @@
 import {
   getRequestContext,
   runWithRequestContext
-} from "./index-51a19y3v.js";
+} from "./index-f24xg2cw.js";
 import {
-  objectShapeKeys
-} from "./index-6djpbnda.js";
+  assertToolExtensionCompatible,
+  mergeSchemas,
+  objectShapeKeys,
+  projectToolSurface,
+  rebuildObject
+} from "./index-22by16v6.js";
 import {
   formatZodError,
   isUnsafeKey,
   normalizeError,
   safeJsonParse,
   validateDeclaredOutput
-} from "./index-bmmtz6r9.js";
+} from "./index-pgsyp3xh.js";
 import {
   isRecord
-} from "./index-smpbdg6k.js";
+} from "./index-qyrqwr4c.js";
 import {
   AppError,
   STITCH_ERROR_STATUS,
@@ -335,4 +339,66 @@ async function runToolMethod(method, toolName, rawArgs, context, hooks, lifecycl
   }
 }
 
-export { coerceJsonArgs, ToolExecutionControlError, isToolExecutionControlError, toolResultFromError, toolErrorFromResult, executeToolMethod };
+// src/tools/mount.ts
+import { z as z2 } from "zod";
+function applyExtend(base, extra) {
+  if (base instanceof z2.ZodObject) {
+    assertToolExtensionCompatible(base, extra);
+    return rebuildObject(base, { ...extra, ...base.shape });
+  }
+  return z2.intersection(z2.object(extra), base);
+}
+function contractToolMountable(projected, extend) {
+  const method = projected.source;
+  const baseArgumentSchema = mergeSchemas(method.paramsSchema, method.inputSchema);
+  const argumentSchema = projected.shouldExtend && extend ? applyExtend(baseArgumentSchema, extend.schema) : baseArgumentSchema;
+  return {
+    method,
+    name: projected.name,
+    argumentSchema,
+    presentationSchema: projected.presentationSchema,
+    shouldExtend: projected.shouldExtend
+  };
+}
+function collectTools(service, transport, config = {}) {
+  const { extend, flattenUnionInput = false, assertNames = true } = config;
+  const tools = [];
+  for (const projected of projectToolSurface({ services: [service] }, transport === "HTTP" ? "AGENT" : transport, {
+    extend,
+    flattenUnionInput,
+    assertNames,
+    assertUniqueNames: false
+  })) {
+    if (projected.kind !== "contract")
+      continue;
+    tools.push(contractToolMountable(projected, extend));
+  }
+  return tools;
+}
+function createToolRunner(config) {
+  const extension = config.extend ? {
+    schema: z2.object(config.extend.schema),
+    resolve: config.extend.resolve
+  } : undefined;
+  return async function runOneToolCall(tool, rawArgs, context) {
+    return executeToolMethod(tool.method, tool.name, rawArgs, { ...config.context, ...context, source: config.source }, config.hooks, config.lifecycle, config.coerceJsonArgs ?? true, config.onOutputStrip ? (paths) => config.onOutputStrip?.(tool.name, paths) : undefined, tool.shouldExtend ? extension : undefined);
+  };
+}
+function formatToolError(result, toolName, errorHint) {
+  const err = { error: result.code };
+  if (result.details)
+    err.details = result.details;
+  const hints = [];
+  if (result.hint)
+    hints.push(result.hint);
+  if (errorHint && toolName) {
+    const global = errorHint(toolName, result.code);
+    if (global)
+      hints.push(global);
+  }
+  if (hints.length > 0)
+    err._hint = hints.join(" ");
+  return err;
+}
+
+export { coerceJsonArgs, ToolExecutionControlError, isToolExecutionControlError, toolResultFromError, toolErrorFromResult, executeToolMethod, contractToolMountable, collectTools, createToolRunner, formatToolError };

package/dist/index.js

@@ -21,13 +21,13 @@ import {
   parseTrailingWildcard,
   rateLimited,
   unauthorized
-} from "./index-j2nq04z6.js";
+} from "./index-f6n5n7nz.js";
 import {
   isRecord,
   mapObject,
   transportResult,
   typedEntries
-} from "./index-tss6bk5c.js";
+} from "./index-ksp6e2ye.js";
 
 // src/browser/cancellation.ts
 class RequestCancellationError extends Error {
@@ -1099,6 +1099,21 @@ function isModuleNotFound(error) {
 }
 
 // src/realtime/request.ts
+import { z as z2 } from "zod";
+var RealtimeRequestPhaseSchema = z2.enum([
+  "engine-handoff",
+  "engine-ack-received",
+  "settled",
+  "timeout",
+  "disconnected"
+]);
+var RealtimeRequestPhaseEventSchema = z2.object({
+  requestId: z2.string().min(1),
+  event: z2.string().min(1),
+  phase: RealtimeRequestPhaseSchema,
+  elapsedMs: z2.number().finite().nonnegative()
+}).strict();
+
 class RealtimeRequestTimeoutError extends Error {
   code = "REALTIME_REQUEST_TIMEOUT";
   event;
@@ -1186,9 +1201,9 @@ function parseIssues(value) {
 }
 
 // src/realtime/rejection.ts
-import { z as z2 } from "zod";
+import { z as z3 } from "zod";
 function realtimeContractViolation(options) {
-  const issues = options.cause instanceof z2.ZodError ? zodIssues(options.cause) : undefined;
+  const issues = options.cause instanceof z3.ZodError ? zodIssues(options.cause) : undefined;
   const reason = options.reason.replaceAll("-", " ");
   const error = new AppError("REALTIME_CONTRACT_VIOLATION", `Realtime event "${options.event}" (${options.direction}, ${options.phase}): ${reason}`, 500, {
     event: options.event,
@@ -1469,6 +1484,63 @@ function createRetainedTopics() {
 }
 
 // src/browser/socket-io.ts
+var realtimeRequestTraces = new WeakMap;
+function observeRealtimeRequestPhase(trace, phase) {
+  const observation = {
+    requestId: trace.requestId,
+    event: trace.event,
+    phase,
+    elapsedMs: performance.now() - trace.startedAt
+  };
+  try {
+    const result = trace.observe(observation);
+    if (result)
+      Promise.resolve(result).catch(() => {
+        return;
+      });
+  } catch {}
+}
+function socketIoPacketIdentity(data, expected) {
+  if (typeof data !== "string")
+    return null;
+  const type = data.charAt(0);
+  const binary = type === (expected === "event" ? "5" : "6");
+  if (type !== (expected === "event" ? "2" : "3") && !binary)
+    return null;
+  let offset = 1;
+  if (binary) {
+    const separator = data.indexOf("-", offset);
+    if (separator < 0)
+      return null;
+    for (let index = offset;index < separator; index += 1) {
+      const code = data.charCodeAt(index);
+      if (code < 48 || code > 57)
+        return null;
+    }
+    offset = separator + 1;
+  }
+  let namespace = "/";
+  if (data.charAt(offset) === "/") {
+    const separator = data.indexOf(",", offset);
+    if (separator < 0)
+      return null;
+    namespace = data.slice(offset, separator);
+    offset = separator + 1;
+  }
+  const start = offset;
+  while (offset < data.length) {
+    const code = data.charCodeAt(offset);
+    if (code < 48 || code > 57)
+      break;
+    offset += 1;
+  }
+  if (offset === start)
+    return null;
+  return { namespace, id: data.slice(start, offset) };
+}
+function packetIdentityKey(identity) {
+  return `${identity.namespace}:${identity.id}`;
+}
 var SOCKET_IO_CLIENT = "socket.io-client";
 var ioLoader = null;
 function loadIo() {
@@ -1564,8 +1636,20 @@ function bindRealtimeClient(contract, transport, { onRejected, logger } = {}) {
     if (!definition?.ack) {
       throw new Error(`Realtime request "${event}" has no acknowledgement schema`);
     }
-    const value = await transport.emitWithAck(event, parsedArgs, { timeoutMs });
-    const acknowledgement = parseRealtimeRequestAcknowledgement(definition.ack, event, "client-inbound", value, onRejected, logger);
+    const pending = transport.emitWithAck(event, parsedArgs, { timeoutMs });
+    const trace = realtimeRequestTraces.get(pending);
+    if (trace)
+      realtimeRequestTraces.delete(pending);
+    const value = await pending;
+    let acknowledgement;
+    try {
+      acknowledgement = parseRealtimeRequestAcknowledgement(definition.ack, event, "client-inbound", value, onRejected, logger);
+    } finally {
+      if (trace && !trace.closed) {
+        trace.closed = true;
+        observeRealtimeRequestPhase(trace, "settled");
+      }
+    }
     return acknowledgement;
   }
   return {
@@ -1577,8 +1661,8 @@ function bindRealtimeClient(contract, transport, { onRejected, logger } = {}) {
     onConnectionChange: (listener) => transport.onConnectionChange(listener)
   };
 }
-function createRealtimeClient(contract, { onRejected, logger, ...config }) {
-  const transport = createSocketIOClient(config);
+function createRealtimeClient(contract, { onRejected, logger, onRequestPhase, ...config }) {
+  const transport = createSocketIOClientInternal(config, onRequestPhase);
   const bound = bindRealtimeClient(contract, transport, { onRejected, logger });
   return {
     ...bound,
@@ -1590,12 +1674,17 @@ function createRealtimeClient(contract, { onRejected, logger, ...config }) {
   };
 }
 function createSocketIOClient(config) {
+  return createSocketIOClientInternal(config);
+}
+function createSocketIOClientInternal(config, onRequestPhase) {
   let socket = null;
   const resolveIo = createIoResolver(config.peers?.client);
   let desiredConnected = false;
   let loadingPeer = false;
   let reconnectTimer = null;
   const pendingRequestDisconnects = new Set;
+  const requestTracesByNativeKey = new Map;
+  let startingRequestTrace = null;
   const serverDisconnectDelay = config.reconnectOnServerDisconnect ?? 1000;
   const connectionListeners = new Set;
   const subscriptions = new Set;
@@ -1629,6 +1718,37 @@ function createSocketIOClient(config) {
       reconnectionDelayMax: config.reconnectionDelayMax ?? 5000,
       timeout: config.timeout ?? 20000
     });
+    if (onRequestPhase) {
+      socket.io.on("open", () => {
+        const engine = socket?.io.engine;
+        if (!engine)
+          return;
+        engine.on("packetCreate", (packet) => {
+          if (!startingRequestTrace || packet.type !== "message")
+            return;
+          const identity = socketIoPacketIdentity(packet.data, "event");
+          if (!identity)
+            return;
+          const key = packetIdentityKey(identity);
+          startingRequestTrace.nativeKey = key;
+          requestTracesByNativeKey.set(key, startingRequestTrace);
+          observeRealtimeRequestPhase(startingRequestTrace, "engine-handoff");
+        });
+        engine.on("packet", (packet) => {
+          if (packet.type !== "message")
+            return;
+          const identity = socketIoPacketIdentity(packet.data, "ack");
+          if (!identity)
+            return;
+          const key = packetIdentityKey(identity);
+          const trace = requestTracesByNativeKey.get(key);
+          if (!trace || trace.closed)
+            return;
+          observeRealtimeRequestPhase(trace, "engine-ack-received");
+          requestTracesByNativeKey.delete(key);
+        });
+      });
+    }
     socket.on("connect", () => notifyConnection(true));
     socket.on("disconnect", (reason) => {
       notifyConnection(false, reason);
@@ -1738,11 +1858,30 @@ function createSocketIOClient(config) {
       return true;
     },
     emitWithAck(event, args, options) {
+      const trace = onRequestPhase ? {
+        requestId: crypto.randomUUID(),
+        event,
+        startedAt: performance.now(),
+        observe: onRequestPhase,
+        closed: false
+      } : undefined;
+      const closeTrace = (phase) => {
+        if (!trace || trace.closed)
+          return;
+        trace.closed = true;
+        if (trace.nativeKey)
+          requestTracesByNativeKey.delete(trace.nativeKey);
+        observeRealtimeRequestPhase(trace, phase);
+      };
       const active = socket;
       if (!active?.connected) {
-        return Promise.reject(new RealtimeRequestDisconnectedError(event));
+        const pending2 = Promise.reject(new RealtimeRequestDisconnectedError(event));
+        closeTrace("disconnected");
+        if (trace)
+          realtimeRequestTraces.set(pending2, trace);
+        return pending2;
       }
-      return new Promise((resolve, reject) => {
+      const pending = new Promise((resolve, reject) => {
         let settled = false;
         const finish = (result) => {
           if (settled)
@@ -1753,14 +1892,31 @@ function createSocketIOClient(config) {
           result();
         };
         const onDisconnect = () => {
-          finish(() => reject(new RealtimeRequestDisconnectedError(event)));
+          finish(() => {
+            closeTrace("disconnected");
+            reject(new RealtimeRequestDisconnectedError(event));
+          });
         };
         pendingRequestDisconnects.add(onDisconnect);
         active.on("disconnect", onDisconnect);
-        active.timeout(options.timeoutMs).emitWithAck(event, ...args).then((value) => finish(() => resolve(value)), () => {
-          finish(() => reject(active.connected ? new RealtimeRequestTimeoutError(event, options.timeoutMs) : new RealtimeRequestDisconnectedError(event)));
+        let acknowledgement;
+        startingRequestTrace = trace ?? null;
+        try {
+          acknowledgement = active.timeout(options.timeoutMs).emitWithAck(event, ...args);
+        } finally {
+          startingRequestTrace = null;
+        }
+        acknowledgement.then((value) => finish(() => resolve(value)), () => {
+          finish(() => {
+            const connected = active.connected;
+            closeTrace(connected ? "timeout" : "disconnected");
+            reject(connected ? new RealtimeRequestTimeoutError(event, options.timeoutMs) : new RealtimeRequestDisconnectedError(event));
+          });
         });
       });
+      if (trace)
+        realtimeRequestTraces.set(pending, trace);
+      return pending;
     },
     onConnectionChange(listener) {
       connectionListeners.add(listener);
@@ -1783,6 +1939,8 @@ export {
   REALTIME_REJECTION_KEY,
   RealtimeRequestDisconnectedError,
   RealtimeRequestInvalidAcknowledgementError,
+  RealtimeRequestPhaseEventSchema,
+  RealtimeRequestPhaseSchema,
   RealtimeRequestRejectedError,
   RealtimeRequestTimeoutError,
   STITCH_ERROR_STATUS,

package/dist/internal/typed.d.ts

@@ -1,3 +1,5 @@
+import type { SurfaceAgentRuntimeToolDefinition } from '../tools/internal/surface-projector.js';
+import type { RuntimeToolDefinition } from '../tools/runtime-tool.js';
 export declare function typedEntries<T extends object>(value: T): Array<{
     [K in keyof T]: [K, T[K]];
 }[keyof T]>;
@@ -5,6 +7,12 @@ export declare function typedEntries<T extends object>(value: T): Array<{
 export declare function isRecord(value: unknown): value is Record<string, unknown>;
 /** Invoke a runtime-discovered handler after a fail-first function check. */
 export declare function callRuntimeHandler(handler: unknown, context: unknown): unknown;
+/**
+ * Agent-only public declarations use a peer-free structural tool definition.
+ * Construction validates executable functions before this boundary restores
+ * the richer internal definition consumed by the canonical mount.
+ */
+export declare function executableAgentRuntimeTools(tools: readonly SurfaceAgentRuntimeToolDefinition[]): readonly RuntimeToolDefinition[];
 /**
  * Isolated loose-to-typed adapter boundary for transports whose decoder is
  * selected at runtime while the contract fixes the generic result type.

package/dist/internal/typed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed.d.ts","sourceRoot":"","sources":["../../src/internal/typed.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,KAAK,EAAE,CAAC,GACP,KAAK,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAE/C;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAK9E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAEpD;AAED,wBAAgB,SAAS,CACvB,OAAO,SAAS,MAAM,EACtB,OAAO,SAAS;KAAG,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,EAAE,OAAO;CAAE,EAElD,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,GACrF,OAAO,CAOT;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,SAAS,MAAM,EACtB,OAAO,SAAS;KAAG,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,EAAE,OAAO;CAAE,EAElD,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,OAAO,CAAC,KAAK,OAAO,GACrE,OAAO,CAKT"}
+{"version":3,"file":"typed.d.ts","sourceRoot":"","sources":["../../src/internal/typed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,KAAK,EAAE,CAAC,GACP,KAAK,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAE/C;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAK9E;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,iCAAiC,EAAE,GAClD,SAAS,qBAAqB,EAAE,CAelC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAEpD;AAED,wBAAgB,SAAS,CACvB,OAAO,SAAS,MAAM,EACtB,OAAO,SAAS;KAAG,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,EAAE,OAAO;CAAE,EAElD,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,GACrF,OAAO,CAOT;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,SAAS,MAAM,EACtB,OAAO,SAAS;KAAG,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,EAAE,OAAO;CAAE,EAElD,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,OAAO,CAAC,KAAK,OAAO,GACrE,OAAO,CAKT"}

package/dist/node.js

@@ -5,7 +5,7 @@ import {
   createHandler,
   createSocketIOServer,
   createUnixClientTransport
-} from "./index-6tqys26z.js";
+} from "./index-hcx9yypn.js";
 import {
   createImplement,
   createImplementRegistry,
@@ -14,9 +14,9 @@ import {
   createScopedImplementRegistry,
   implement,
   implementRegistry
-} from "./index-z575awm9.js";
-import"./index-51a19y3v.js";
-import"./index-557by2db.js";
+} from "./index-hxh98zbm.js";
+import"./index-f24xg2cw.js";
+import"./index-7b188kmz.js";
 import {
   ShutdownOptionsSchema,
   ShutdownResultSchema,
@@ -24,8 +24,8 @@ import {
   ShutdownStatusSchema,
   createServerLifecycle
 } from "./index-dk6e56g0.js";
-import"./index-bmmtz6r9.js";
-import"./index-smpbdg6k.js";
+import"./index-pgsyp3xh.js";
+import"./index-qyrqwr4c.js";
 import {
   AppError,
   appError,

package/dist/observability/index.js

@@ -10,7 +10,7 @@ import {
   redact,
   sanitizePayload,
   truncatePreview
-} from "../index-hmfpjnh7.js";
+} from "../index-22tjt2rk.js";
 import {
   getRequestContext,
   getTraceId,
@@ -21,7 +21,7 @@ import {
   setRequestError,
   setRequestUser,
   wrapInRequestContext
-} from "../index-51a19y3v.js";
+} from "../index-f24xg2cw.js";
 import {
   childSpan,
   createTraceContext,
@@ -30,10 +30,10 @@ import {
   recordedErrorMessage,
   resolvePropagationContext,
   resolveTraceContext
-} from "../index-bmmtz6r9.js";
+} from "../index-pgsyp3xh.js";
 import {
   isRecord
-} from "../index-smpbdg6k.js";
+} from "../index-qyrqwr4c.js";
 import"../index-0w9abg87.js";
 import"../index-6k1937bx.js";
 

package/dist/react.js

@@ -1,6 +1,6 @@
 import {
   isRecord
-} from "./index-tss6bk5c.js";
+} from "./index-ksp6e2ye.js";
 
 // src/react/cache-bridge.ts
 function createCacheBridge(config) {

package/dist/realtime/index.d.ts

@@ -1,5 +1,5 @@
 export { defineRealtimeContract, type InferRealtimeEventMap, type RealtimeAcknowledgedEvent, type RealtimeAcknowledgement, type RealtimeContract, type RealtimeEmitArguments, type RealtimeEventArguments, type RealtimeEventDefinition, type RealtimeEventHandler, type RealtimeEventRegistry, type RealtimeRejectDirection, type RealtimeRejectedEvent, type RealtimeRejectedEventHook, type RealtimeRequestArguments, } from './contract.js';
 export { asRealtimeRejection, REALTIME_REJECTION_KEY, type RealtimeRejectionEnvelope, type RealtimeRejectionIssue, type RealtimeRejectionReport, } from './rejected-frame.js';
-export { RealtimeRequestDisconnectedError, RealtimeRequestInvalidAcknowledgementError, type RealtimeRequestOptions, RealtimeRequestRejectedError, RealtimeRequestTimeoutError, } from './request.js';
+export { RealtimeRequestDisconnectedError, RealtimeRequestInvalidAcknowledgementError, type RealtimeRequestOptions, type RealtimeRequestPhase, type RealtimeRequestPhaseEvent, RealtimeRequestPhaseEventSchema, type RealtimeRequestPhaseHook, RealtimeRequestPhaseSchema, RealtimeRequestRejectedError, RealtimeRequestTimeoutError, } from './request.js';
 export type { ValidatedRealtimeSocket } from './socket.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/realtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gCAAgC,EAChC,0CAA0C,EAC1C,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gCAAgC,EAChC,0CAA0C,EAC1C,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,wBAAwB,EAC7B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC"}

package/dist/realtime/request.d.ts

@@ -1,4 +1,29 @@
+import { z } from 'zod';
 import type { RealtimeRejectionIssue } from './rejected-frame.js';
+/** Closed lifecycle reported by an opt-in acknowledged-request observer. */
+export declare const RealtimeRequestPhaseSchema: z.ZodEnum<{
+    disconnected: "disconnected";
+    "engine-ack-received": "engine-ack-received";
+    "engine-handoff": "engine-handoff";
+    settled: "settled";
+    timeout: "timeout";
+}>;
+/** Metadata-only observation: no arguments, acknowledgement or packet bytes. */
+export declare const RealtimeRequestPhaseEventSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    event: z.ZodString;
+    phase: z.ZodEnum<{
+        disconnected: "disconnected";
+        "engine-ack-received": "engine-ack-received";
+        "engine-handoff": "engine-handoff";
+        settled: "settled";
+        timeout: "timeout";
+    }>;
+    elapsedMs: z.ZodNumber;
+}, z.core.$strict>;
+export type RealtimeRequestPhase = z.infer<typeof RealtimeRequestPhaseSchema>;
+export type RealtimeRequestPhaseEvent = z.infer<typeof RealtimeRequestPhaseEventSchema>;
+export type RealtimeRequestPhaseHook = (event: RealtimeRequestPhaseEvent) => void | Promise<void>;
 export interface RealtimeRequestOptions {
     /** Maximum acknowledgement wait in milliseconds. Must be finite and > 0. */
     timeoutMs: number;