stitchkit 0.68.11 → 0.69.0

package/dist/index-tg3m2ec5.js

@@ -0,0 +1,157 @@
+// src/agent-runtime/models.ts
+import { z } from "zod";
+var AgentModelCapabilitySchema = z.enum(["tools", "vision", "reasoning", "files"]);
+var AgentModelDescriptorSchema = z.object({
+  provider: z.string().min(1),
+  modelId: z.string().min(1),
+  contextWindow: z.int().positive(),
+  capabilities: z.array(AgentModelCapabilitySchema),
+  observedAt: z.iso.datetime({ offset: true }).optional(),
+  source: z.string().min(1).optional(),
+  availability: z.enum(["available", "unavailable"]).optional()
+});
+var AgentModelRegistrySnapshotSchema = z.object({
+  schemaVersion: z.literal(1),
+  source: z.string().min(1),
+  observedAt: z.iso.datetime({ offset: true }),
+  models: z.record(z.string().min(1), AgentModelDescriptorSchema)
+});
+var AgentModelPriceSchema = z.object({
+  currency: z.string().length(3),
+  inputPerToken: z.string().regex(/^\d+(?:\.\d+)?$/).optional(),
+  outputPerToken: z.string().regex(/^\d+(?:\.\d+)?$/).optional()
+}).strict();
+var AgentModelMetricSchema = z.object({
+  metric: z.string().min(1),
+  value: z.number(),
+  unit: z.enum(["index", "elo", "percent", "milliseconds"]),
+  source: z.string().min(1),
+  observedAt: z.iso.datetime({ offset: true })
+}).strict();
+var AgentModelPopularitySchema = z.object({
+  rank: z.int().positive(),
+  window: z.literal("week"),
+  source: z.string().min(1),
+  observedAt: z.iso.datetime({ offset: true })
+}).strict();
+var AgentModelCatalogEntrySchema = z.object({
+  id: z.string().min(1),
+  name: z.string().min(1),
+  descriptor: AgentModelDescriptorSchema,
+  description: z.string().optional(),
+  price: AgentModelPriceSchema.optional(),
+  popularity: AgentModelPopularitySchema.optional(),
+  metrics: z.array(AgentModelMetricSchema)
+}).strict();
+var AgentModelCatalogSchema = z.object({
+  schemaVersion: z.literal(1),
+  source: z.string().min(1),
+  observedAt: z.iso.datetime({ offset: true }),
+  completeness: z.enum(["complete", "partial"]),
+  models: z.array(AgentModelCatalogEntrySchema),
+  diagnostics: z.array(z.string())
+}).strict();
+var AgentModelSelectionSchema = z.object({
+  modelId: z.string().min(1),
+  selectedAt: z.iso.datetime({ offset: true })
+}).strict();
+var AgentModelSearchInputSchema = z.object({ query: z.string().max(256).default(""), limit: z.int().positive().max(200) }).strict();
+var AgentModelSearchResultSchema = z.object({
+  models: z.array(AgentModelCatalogEntrySchema),
+  total: z.int().nonnegative(),
+  truncated: z.boolean()
+}).strict();
+function searchAgentModelCatalog(catalog, rawInput) {
+  const input = AgentModelSearchInputSchema.parse(rawInput);
+  const terms = input.query.toLocaleLowerCase().trim().split(/\s+/).filter(Boolean);
+  const matches = catalog.models.filter((model) => {
+    const searchable = `${model.id}
+${model.name}
+${model.description ?? ""}`.toLocaleLowerCase();
+    return terms.every((term) => searchable.includes(term));
+  });
+  return AgentModelSearchResultSchema.parse({
+    models: matches.slice(0, input.limit),
+    total: matches.length,
+    truncated: matches.length > input.limit
+  });
+}
+function createMemoryAgentModelSelectionStore() {
+  const selections = new Map;
+  return {
+    load: (conversationId) => selections.get(conversationId),
+    save(conversationId, rawSelection) {
+      selections.set(conversationId, AgentModelSelectionSchema.parse(rawSelection));
+    }
+  };
+}
+function defineModelRegistry(config) {
+  const descriptors = new Map;
+  for (const key in config.models) {
+    const declaration = config.models[key];
+    if (declaration)
+      descriptors.set(key, AgentModelDescriptorSchema.parse(declaration));
+  }
+  const descriptor = (key) => {
+    const found = descriptors.get(key);
+    if (!found)
+      throw new Error(`Unknown agent model: ${key}`);
+    return found;
+  };
+  const supports = (key, capabilities) => {
+    const available = new Set(descriptor(key).capabilities);
+    return capabilities.every((capability) => available.has(capability));
+  };
+  const preflight = (key, required = []) => {
+    const selected = descriptor(key);
+    if (selected.availability === "unavailable") {
+      throw new Error(`Agent model ${key} is unavailable`);
+    }
+    if (!supports(key, required)) {
+      throw new Error(`Agent model ${key} does not satisfy required capabilities`);
+    }
+    if (!config.providers[selected.provider]) {
+      throw new Error(`Unknown agent model provider: ${selected.provider}`);
+    }
+    return selected;
+  };
+  return {
+    keys: () => [...descriptors.keys()],
+    descriptor,
+    supports,
+    preflight,
+    resolve(key, required = []) {
+      const selected = preflight(key, required);
+      const provider = config.providers[selected.provider];
+      if (!provider)
+        throw new Error(`Unknown agent model provider: ${selected.provider}`);
+      return {
+        descriptor: selected,
+        model: provider.create(selected.modelId),
+        ...provider.normalizeUsage && { normalizeUsage: provider.normalizeUsage }
+      };
+    },
+    snapshot(input) {
+      return AgentModelRegistrySnapshotSchema.parse({
+        schemaVersion: 1,
+        source: input.source,
+        observedAt: input.observedAt,
+        models: Object.fromEntries(descriptors.entries())
+      });
+    }
+  };
+}
+function validateAgentModelSnapshot(input, policy) {
+  if (!Number.isSafeInteger(policy.maxAgeMs) || policy.maxAgeMs < 0) {
+    throw new TypeError("maxAgeMs must be a non-negative safe integer");
+  }
+  const snapshot = AgentModelRegistrySnapshotSchema.parse(input);
+  const now = policy.now?.() ?? new Date;
+  const age = now.getTime() - new Date(snapshot.observedAt).getTime();
+  if (age < 0 || age > policy.maxAgeMs) {
+    throw new Error(`Agent model snapshot from ${snapshot.source} is stale`);
+  }
+  return snapshot;
+}
+
+export { AgentModelCapabilitySchema, AgentModelDescriptorSchema, AgentModelRegistrySnapshotSchema, AgentModelPriceSchema, AgentModelMetricSchema, AgentModelPopularitySchema, AgentModelCatalogEntrySchema, AgentModelCatalogSchema, AgentModelSelectionSchema, AgentModelSearchInputSchema, AgentModelSearchResultSchema, searchAgentModelCatalog, createMemoryAgentModelSelectionStore, defineModelRegistry, validateAgentModelSnapshot };

package/dist/index-v3dpzpjw.js

@@ -0,0 +1,92 @@
+// src/agent-runtime/contained-files.ts
+import { constants } from "node:fs";
+import { lstat, open, readdir, realpath } from "node:fs/promises";
+import path from "node:path";
+async function readContainedUtf8File(absolute, maxBytes) {
+  const handle = await open(absolute, constants.O_RDONLY | constants.O_NOFOLLOW);
+  try {
+    const metadata = await handle.stat();
+    if (!metadata.isFile())
+      throw new Error("Contained path is not a regular file");
+    if (metadata.size > maxBytes)
+      throw new Error("Contained file exceeds byte budget");
+    const buffer = Buffer.alloc(metadata.size);
+    let offset = 0;
+    while (offset < buffer.byteLength) {
+      const { bytesRead } = await handle.read(buffer, offset, buffer.byteLength - offset, offset);
+      if (bytesRead === 0)
+        break;
+      offset += bytesRead;
+    }
+    if (offset !== metadata.size)
+      throw new Error("Contained file changed while being read");
+    return {
+      text: new TextDecoder("utf-8", { fatal: true }).decode(buffer),
+      bytes: offset,
+      mode: metadata.mode
+    };
+  } finally {
+    await handle.close();
+  }
+}
+function inside(root, target) {
+  const relative = path.relative(root, target);
+  return relative === "" || !relative.startsWith("..") && !path.isAbsolute(relative);
+}
+async function walkContainedFiles(input) {
+  const scan = await scanContainedFiles({ ...input, symlinks: "refuse" });
+  if (scan.truncated)
+    throw new Error("Contained file traversal exceeded its bounds");
+  return scan.files;
+}
+async function scanContainedFiles(input) {
+  const root = await realpath(input.root);
+  const files = [];
+  let truncated = false;
+  let skippedDirectories = 0;
+  let skippedSymlinks = 0;
+  const visit = async (directory, depth) => {
+    if (truncated)
+      return;
+    if (depth > input.maxDepth) {
+      truncated = true;
+      return;
+    }
+    const entries = await readdir(directory, { withFileTypes: true });
+    entries.sort((left, right) => left.name.localeCompare(right.name));
+    for (const entry of entries) {
+      const absolute = path.join(directory, entry.name);
+      const metadata = await lstat(absolute);
+      if (metadata.isSymbolicLink()) {
+        if (input.symlinks === "refuse") {
+          throw new Error(`Contained file traversal refuses symlink: ${path.relative(root, absolute)}`);
+        }
+        skippedSymlinks += 1;
+        continue;
+      }
+      if (metadata.isDirectory()) {
+        const relative = path.relative(root, absolute);
+        if (input.excludeDirectory?.(relative)) {
+          skippedDirectories += 1;
+          continue;
+        }
+        await visit(absolute, depth + 1);
+        continue;
+      }
+      if (!metadata.isFile())
+        continue;
+      const resolved = await realpath(absolute);
+      if (!inside(root, resolved))
+        throw new Error("Contained file traversal escaped root");
+      if (files.length >= input.maxFiles) {
+        truncated = true;
+        return;
+      }
+      files.push({ absolute: resolved, relative: path.relative(root, resolved) });
+    }
+  };
+  await visit(root, 0);
+  return { files, truncated, skippedDirectories, skippedSymlinks };
+}
+
+export { readContainedUtf8File, walkContainedFiles, scanContainedFiles };

package/dist/{index-eqqyd9v8.js → index-wwst0td5.js}

@@ -1,9 +1,5 @@
 import {
-  contractToolMountable
-} from "./index-y2ctppmg.js";
-import {
-  projectRuntimeTool,
-  projectToolSurface
+  projectRuntimeTool
 } from "./index-22by16v6.js";
 
 // src/tools/runtime-tool.ts
@@ -87,44 +83,4 @@ function runtimeToolMountable(definition, assertName = true) {
   };
 }
 
-// src/tools/surface.ts
-function collectToolSurface({
-  surface,
-  transport,
-  assertUniqueNames = true,
-  ...collectConfig
-}) {
-  const entries = [];
-  const append = (entry) => {
-    entries.push(entry);
-  };
-  for (const projected of projectToolSurface(surface, transport, {
-    extend: collectConfig.extend,
-    flattenUnionInput: collectConfig.flattenUnionInput,
-    assertNames: collectConfig.assertNames,
-    assertUniqueNames
-  })) {
-    if (projected.kind === "contract") {
-      const mountable = contractToolMountable(projected, collectConfig.extend);
-      append({
-        kind: "contract",
-        service: projected.serviceName,
-        action: mountable.method.key,
-        mountable,
-        projection: projected
-      });
-    } else {
-      append({
-        kind: "runtime",
-        service: projected.serviceName,
-        action: projected.action,
-        mountable: runtimeToolMountable(projected.source, false),
-        definition: projected.source,
-        projection: projected
-      });
-    }
-  }
-  return entries;
-}
-
-export { defineRuntimeTool, createRuntimeToolFactory, collectToolSurface };
+export { defineRuntimeTool, createRuntimeToolFactory, runtimeToolMountable };

package/dist/{index-ysphyxax.js → index-x1th9s8c.js}

@@ -44,6 +44,19 @@ var AgentToolResultPartSchema = z.object({
   outcome: z.enum(["success", "error", "interrupted"]),
   output: z.json().optional()
 });
+var AgentToolApprovalRequestPartSchema = z.object({
+  type: z.literal("tool-approval-request"),
+  approvalId: z.string().min(1),
+  callId: z.string().min(1),
+  isAutomatic: z.boolean().optional(),
+  signature: z.string().min(1).optional()
+});
+var AgentToolApprovalResponsePartSchema = z.object({
+  type: z.literal("tool-approval-response"),
+  approvalId: z.string().min(1),
+  approved: z.boolean(),
+  reason: z.string().min(1).optional()
+});
 var AgentOpaquePartSchema = z.object({
   type: z.literal("provider"),
   envelope: AgentProviderEnvelopeSchema
@@ -59,10 +72,18 @@ var AgentMessagePartSchema = z.discriminatedUnion("type", [
   AgentSourcePartSchema,
   AgentToolCallPartSchema,
   AgentToolResultPartSchema,
+  AgentToolApprovalRequestPartSchema,
+  AgentToolApprovalResponsePartSchema,
   AgentOpaquePartSchema,
   AgentControlPartSchema
 ]);
-var AgentMessageRoleSchema = z.enum(["user", "assistant", "system", "summary"]);
+var AgentMessageRoleSchema = z.enum([
+  "user",
+  "assistant",
+  "tool",
+  "system",
+  "summary"
+]);
 var AgentMessageStatusSchema = z.enum([
   "committed",
   "streaming",
@@ -256,4 +277,4 @@ var AgentRunMetricsSchema = z.object({
   ttftMs: z.number().nonnegative().optional()
 });
 
-export { AgentRecordIdSchema, AgentRecordVersionSchema, AgentTimestampSchema, AgentJsonObjectSchema, AgentProviderEnvelopeSchema, AgentTextPartSchema, AgentReasoningPartSchema, AgentFilePartSchema, AgentSourcePartSchema, AgentToolCallPartSchema, AgentToolResultPartSchema, AgentOpaquePartSchema, AgentControlPartSchema, AgentMessagePartSchema, AgentMessageRoleSchema, AgentMessageStatusSchema, AgentMessageSchema, AgentAssistantPlaceholderSchema, AgentRunStateSchema, AgentRunQueuePrioritySchema, AgentTerminalReasonSchema, runStateForTerminalReason, AgentProvenanceSchema, AgentUsageValueSchema, AgentCostValueSchema, AgentUsageSchema, AgentRunSchema, AgentSnapshotSchema, AgentRunMetricsSchema };
+export { AgentRecordIdSchema, AgentRecordVersionSchema, AgentTimestampSchema, AgentJsonObjectSchema, AgentProviderEnvelopeSchema, AgentTextPartSchema, AgentReasoningPartSchema, AgentFilePartSchema, AgentSourcePartSchema, AgentToolCallPartSchema, AgentToolResultPartSchema, AgentToolApprovalRequestPartSchema, AgentToolApprovalResponsePartSchema, AgentOpaquePartSchema, AgentControlPartSchema, AgentMessagePartSchema, AgentMessageRoleSchema, AgentMessageStatusSchema, AgentMessageSchema, AgentAssistantPlaceholderSchema, AgentRunStateSchema, AgentRunQueuePrioritySchema, AgentTerminalReasonSchema, runStateForTerminalReason, AgentProvenanceSchema, AgentUsageValueSchema, AgentCostValueSchema, AgentUsageSchema, AgentRunSchema, AgentSnapshotSchema, AgentRunMetricsSchema };

package/dist/index-xxsq3ca1.js

@@ -0,0 +1,51 @@
+import {
+  runtimeToolMountable
+} from "./index-wwst0td5.js";
+import {
+  contractToolMountable
+} from "./index-kg9xx84n.js";
+import {
+  projectToolSurface
+} from "./index-22by16v6.js";
+
+// src/tools/surface.ts
+function collectToolSurface({
+  surface,
+  transport,
+  assertUniqueNames = true,
+  ...collectConfig
+}) {
+  const entries = [];
+  const append = (entry) => {
+    entries.push(entry);
+  };
+  for (const projected of projectToolSurface(surface, transport, {
+    extend: collectConfig.extend,
+    flattenUnionInput: collectConfig.flattenUnionInput,
+    assertNames: collectConfig.assertNames,
+    assertUniqueNames
+  })) {
+    if (projected.kind === "contract") {
+      const mountable = contractToolMountable(projected, collectConfig.extend);
+      append({
+        kind: "contract",
+        service: projected.serviceName,
+        action: mountable.method.key,
+        mountable,
+        projection: projected
+      });
+    } else {
+      append({
+        kind: "runtime",
+        service: projected.serviceName,
+        action: projected.action,
+        mountable: runtimeToolMountable(projected.source, false),
+        definition: projected.source,
+        projection: projected
+      });
+    }
+  }
+  return entries;
+}
+
+export { collectToolSurface };

package/dist/{index-22tjt2rk.js → index-zh459sfj.js}

@@ -1,6 +1,6 @@
 import {
   isUnsafeKey
-} from "./index-pgsyp3xh.js";
+} from "./index-x18ndp4p.js";
 import {
   isRecord
 } from "./index-qyrqwr4c.js";

package/dist/index.js

@@ -1492,13 +1492,18 @@ function observeRealtimeRequestPhase(trace, phase) {
     phase,
     elapsedMs: performance.now() - trace.startedAt
   };
-  try {
-    const result = trace.observe(observation);
-    if (result)
-      Promise.resolve(result).catch(() => {
-        return;
-      });
-  } catch {}
+  const observers = trace.observeRequest && trace.observeRequest !== trace.observeClient ? [trace.observeClient, trace.observeRequest] : [trace.observeClient ?? trace.observeRequest];
+  for (const observer of observers) {
+    if (!observer)
+      continue;
+    try {
+      const result = observer(observation);
+      if (result)
+        Promise.resolve(result).catch(() => {
+          return;
+        });
+    } catch {}
+  }
 }
 function socketIoPacketIdentity(data, expected) {
   if (typeof data !== "string")
@@ -1636,7 +1641,7 @@ function bindRealtimeClient(contract, transport, { onRejected, logger } = {}) {
     if (!definition?.ack) {
       throw new Error(`Realtime request "${event}" has no acknowledgement schema`);
     }
-    const pending = transport.emitWithAck(event, parsedArgs, { timeoutMs });
+    const pending = transport.emitWithAck(event, parsedArgs, options);
     const trace = realtimeRequestTraces.get(pending);
     if (trace)
       realtimeRequestTraces.delete(pending);
@@ -1684,6 +1689,7 @@ function createSocketIOClientInternal(config, onRequestPhase) {
   let reconnectTimer = null;
   const pendingRequestDisconnects = new Set;
   const requestTracesByNativeKey = new Map;
+  const observedRequestEngines = new WeakSet;
   let startingRequestTrace = null;
   const serverDisconnectDelay = config.reconnectOnServerDisconnect ?? 1000;
   const connectionListeners = new Set;
@@ -1701,6 +1707,36 @@ function createSocketIOClientInternal(config, onRequestPhase) {
       reconnectTimer = null;
     }
   }
+  function attachRequestPhaseEngineListeners(target) {
+    const engine = target.io.engine;
+    if (!engine || observedRequestEngines.has(engine))
+      return;
+    observedRequestEngines.add(engine);
+    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);
+    });
+  }
   function openSocket(io) {
     if (!desiredConnected || socket)
       return;
@@ -1720,33 +1756,8 @@ function createSocketIOClientInternal(config, onRequestPhase) {
     });
     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);
-        });
+        if (socket)
+          attachRequestPhaseEngineListeners(socket);
       });
     }
     socket.on("connect", () => notifyConnection(true));
@@ -1858,11 +1869,12 @@ function createSocketIOClientInternal(config, onRequestPhase) {
       return true;
     },
     emitWithAck(event, args, options) {
-      const trace = onRequestPhase ? {
+      const trace = onRequestPhase || options.onPhase ? {
         requestId: crypto.randomUUID(),
         event,
         startedAt: performance.now(),
-        observe: onRequestPhase,
+        observeClient: onRequestPhase,
+        observeRequest: options.onPhase,
         closed: false
       } : undefined;
       const closeTrace = (phase) => {
@@ -1881,6 +1893,8 @@ function createSocketIOClientInternal(config, onRequestPhase) {
           realtimeRequestTraces.set(pending2, trace);
         return pending2;
       }
+      if (trace)
+        attachRequestPhaseEngineListeners(active);
       const pending = new Promise((resolve, reject) => {
         let settled = false;
         const finish = (result) => {

package/dist/internal/ai-sdk-typed.d.ts

@@ -0,0 +1,14 @@
+import { type ModelMessage, streamText, type ToolSet } from 'ai';
+/**
+ * AI SDK derives conditional `toolsContext` requirements from each structural tool in a generic
+ * set. AgentRuntime receives that set after canonical mounting, so TypeScript cannot prove the
+ * conditional options object even though the SDK validates it at this adapter boundary.
+ */
+export declare function streamAgentTextBoundary<TOOLS extends ToolSet>(options: unknown): ReturnType<typeof streamText<TOOLS, never>>;
+/**
+ * `modelMessageSchema` in the current AI SDK runtime validates approval requests but strips their
+ * optional signature even though the public type and approval verifier require it. Validate the
+ * full message first, then restore only the already-validated string at this SDK adapter boundary.
+ */
+export declare function modelMessageWithApprovalSignature(input: unknown): ModelMessage;
+//# sourceMappingURL=ai-sdk-typed.d.ts.map

package/dist/internal/ai-sdk-typed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk-typed.d.ts","sourceRoot":"","sources":["../../src/internal/ai-sdk-typed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAsB,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,IAAI,CAAC;AAGrF;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,OAAO,EAC3D,OAAO,EAAE,OAAO,GACf,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAI7C;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAsB9E"}

package/dist/node.js

@@ -5,7 +5,7 @@ import {
   createHandler,
   createSocketIOServer,
   createUnixClientTransport
-} from "./index-hcx9yypn.js";
+} from "./index-444747ww.js";
 import {
   createImplement,
   createImplementRegistry,
@@ -14,8 +14,8 @@ import {
   createScopedImplementRegistry,
   implement,
   implementRegistry
-} from "./index-hxh98zbm.js";
-import"./index-f24xg2cw.js";
+} from "./index-d1jsvkyk.js";
+import"./index-p1be103g.js";
 import"./index-7b188kmz.js";
 import {
   ShutdownOptionsSchema,
@@ -24,8 +24,7 @@ import {
   ShutdownStatusSchema,
   createServerLifecycle
 } from "./index-dk6e56g0.js";
-import"./index-pgsyp3xh.js";
-import"./index-qyrqwr4c.js";
+import"./index-x18ndp4p.js";
 import {
   AppError,
   appError,
@@ -36,6 +35,7 @@ import {
   rateLimited,
   unauthorized
 } from "./index-0w9abg87.js";
+import"./index-qyrqwr4c.js";
 import"./index-6k1937bx.js";
 // src/server/node.ts
 import { serve } from "srvx/node";

package/dist/observability/index.js

@@ -10,7 +10,7 @@ import {
   redact,
   sanitizePayload,
   truncatePreview
-} from "../index-22tjt2rk.js";
+} from "../index-zh459sfj.js";
 import {
   getRequestContext,
   getTraceId,
@@ -21,7 +21,7 @@ import {
   setRequestError,
   setRequestUser,
   wrapInRequestContext
-} from "../index-f24xg2cw.js";
+} from "../index-p1be103g.js";
 import {
   childSpan,
   createTraceContext,
@@ -30,11 +30,11 @@ import {
   recordedErrorMessage,
   resolvePropagationContext,
   resolveTraceContext
-} from "../index-pgsyp3xh.js";
+} from "../index-x18ndp4p.js";
+import"../index-0w9abg87.js";
 import {
   isRecord
 } from "../index-qyrqwr4c.js";
-import"../index-0w9abg87.js";
 import"../index-6k1937bx.js";
 
 // src/observability/audit.ts

package/dist/realtime/request.d.ts

@@ -27,6 +27,11 @@ export type RealtimeRequestPhaseHook = (event: RealtimeRequestPhaseEvent) => voi
 export interface RealtimeRequestOptions {
     /** Maximum acknowledgement wait in milliseconds. Must be finite and > 0. */
     timeoutMs: number;
+    /**
+     * Observe phases for this invocation only. Correlate through the hook's local
+     * closure; no caller metadata is retained or transmitted with the request.
+     */
+    onPhase?: RealtimeRequestPhaseHook;
 }
 export declare class RealtimeRequestTimeoutError extends Error {
     readonly code = "REALTIME_REQUEST_TIMEOUT";

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

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/realtime/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B;;;;;;EAMrC,CAAC;AAEH,gFAAgF;AAChF,eAAO,MAAM,+BAA+B;;;;;;;;;;;kBAOjC,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,wBAAwB,GAAG,CACrC,KAAK,EAAE,yBAAyB,KAC7B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAK3C;CACF;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IACzD,QAAQ,CAAC,IAAI,mCAAmC;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAY,KAAK,EAAE,MAAM,EAIxB;CACF;AAED,qBAAa,0CAA2C,SAAQ,KAAK;IACnE,QAAQ,CAAC,IAAI,8CAA8C;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAY,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAIxC;CACF;AAED;;;;;;;;;GASG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,IAAI,+BAA+B;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,SAAS,CAAC;IAEtD,YACE,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,sBAAsB,EAAE,EAOlC;CACF"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/realtime/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B;;;;;;EAMrC,CAAC;AAEH,gFAAgF;AAChF,eAAO,MAAM,+BAA+B;;;;;;;;;;;kBAOjC,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,wBAAwB,GAAG,CACrC,KAAK,EAAE,yBAAyB,KAC7B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,wBAAwB,CAAC;CACpC;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAK3C;CACF;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IACzD,QAAQ,CAAC,IAAI,mCAAmC;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAY,KAAK,EAAE,MAAM,EAIxB;CACF;AAED,qBAAa,0CAA2C,SAAQ,KAAK;IACnE,QAAQ,CAAC,IAAI,8CAA8C;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAY,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAIxC;CACF;AAED;;;;;;;;;GASG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,IAAI,+BAA+B;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,SAAS,CAAC;IAEtD,YACE,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,sBAAsB,EAAE,EAOlC;CACF"}