stitchkit 0.70.0 → 0.70.1

package/dist/index-1z5xxfst.js

@@ -0,0 +1,397 @@
+// src/agent-runtime/contained-files.ts
+import {
+  close as closeDescriptor,
+  constants,
+  existsSync,
+  fchmod,
+  fstat,
+  read as readDescriptor,
+  write as writeDescriptor
+} from "node:fs";
+import { lstat, open, readdir, realpath, rename, unlink, writeFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+var FILE_TYPE_MASK = 61440;
+var FILE_TYPE_DIRECTORY = 16384;
+var FILE_TYPE_REGULAR = 32768;
+var FILE_TYPE_SYMLINK = 40960;
+function modeIs(mode, type) {
+  return (mode & FILE_TYPE_MASK) === type;
+}
+function hasFunctions(value, names) {
+  return typeof value === "object" && value !== null && names.every((name) => typeof Reflect.get(value, name) === "function");
+}
+var darwinBinding;
+function loadDarwinBinding() {
+  if (darwinBinding)
+    return darwinBinding;
+  const directory = path.dirname(fileURLToPath(import.meta.url));
+  const binary = `darwin-${process.arch}.node`;
+  const candidates = [
+    path.resolve(directory, "../native", binary),
+    path.resolve(directory, "../../native", binary)
+  ];
+  const selected = candidates.find((candidate) => existsSync(candidate));
+  if (!selected) {
+    throw new Error(`Contained filesystem operations need the packaged Darwin ${process.arch} backend`);
+  }
+  const loaded = createRequire(import.meta.url)(selected);
+  const methods = [
+    "openDirectoryAt",
+    "openFileAt",
+    "createFileAt",
+    "statAt",
+    "listAt",
+    "renameAt",
+    "unlinkAt"
+  ];
+  if (!hasFunctions(loaded, methods)) {
+    throw new Error("The packaged Darwin contained-files backend has an invalid surface");
+  }
+  darwinBinding = loaded;
+  return darwinBinding;
+}
+
+class NumericFileHandle {
+  fd;
+  constructor(fd) {
+    this.fd = fd;
+  }
+  close() {
+    return new Promise((resolve, reject) => {
+      closeDescriptor(this.fd, (error) => error ? reject(error) : resolve());
+    });
+  }
+  read(buffer, offset, length, position) {
+    return new Promise((resolve, reject) => {
+      readDescriptor(this.fd, buffer, offset, length, position, (error, bytesRead) => error ? reject(error) : resolve({ bytesRead }));
+    });
+  }
+  stat() {
+    return new Promise((resolve, reject) => {
+      fstat(this.fd, (error, metadata) => error ? reject(error) : resolve(metadata));
+    });
+  }
+}
+function descriptorPath(handle) {
+  if (process.platform === "linux")
+    return `/proc/self/fd/${handle.fd}`;
+  throw new Error("Descriptor paths are available only in the Linux contained-files backend");
+}
+function sameIdentity(left, right) {
+  return left.dev === right.dev && left.ino === right.ino;
+}
+async function openPinnedDirectory(absolute) {
+  if (process.platform !== "linux" && process.platform !== "darwin") {
+    throw new Error("Contained filesystem operations support Linux and macOS only");
+  }
+  const expected = await realpath(absolute);
+  const handle = await open(expected, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
+  try {
+    const [pathMetadata, handleMetadata] = await Promise.all([lstat(expected), handle.stat()]);
+    if (!pathMetadata.isDirectory() || !sameIdentity(pathMetadata, handleMetadata)) {
+      throw new Error("Contained directory identity changed while opening");
+    }
+    return handle;
+  } catch (error) {
+    await handle.close();
+    throw error;
+  }
+}
+function safeSegments(relative) {
+  if (path.isAbsolute(relative))
+    throw new Error("Contained paths must be relative");
+  const segments = relative.split(/[\\/]/u);
+  if (segments.length === 0 || segments.some((segment) => segment === "" || segment === "." || segment === "..")) {
+    throw new Error("Contained path has invalid segments");
+  }
+  return segments;
+}
+async function openDirectoryAt(directory, name) {
+  if (process.platform === "darwin") {
+    return new NumericFileHandle(loadDarwinBinding().openDirectoryAt(directory.fd, name));
+  }
+  return open(path.join(descriptorPath(directory), name), constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
+}
+async function openFileAt(directory, name) {
+  if (process.platform === "darwin") {
+    return new NumericFileHandle(loadDarwinBinding().openFileAt(directory.fd, name));
+  }
+  return open(path.join(descriptorPath(directory), name), constants.O_RDONLY | constants.O_NOFOLLOW);
+}
+function entryMetadata(mode) {
+  return {
+    mode,
+    isDirectory: () => modeIs(mode, FILE_TYPE_DIRECTORY),
+    isFile: () => modeIs(mode, FILE_TYPE_REGULAR),
+    isSymbolicLink: () => modeIs(mode, FILE_TYPE_SYMLINK)
+  };
+}
+async function statAt(directory, name) {
+  if (process.platform === "darwin") {
+    const metadata = loadDarwinBinding().statAt(directory.fd, name);
+    return metadata ? entryMetadata(metadata.mode) : null;
+  }
+  return lstat(path.join(descriptorPath(directory), name)).catch((error) => {
+    if (error.code === "ENOENT")
+      return null;
+    throw error;
+  });
+}
+async function listAt(directory) {
+  if (process.platform === "darwin") {
+    return loadDarwinBinding().listAt(directory.fd).map(({ name, mode }) => ({ name, ...entryMetadata(mode) }));
+  }
+  return readdir(descriptorPath(directory), { withFileTypes: true });
+}
+async function openContainedParent(root, relative) {
+  const segments = safeSegments(relative);
+  const basename = segments.pop();
+  if (!basename)
+    throw new Error("Contained path is missing a basename");
+  let current = await openPinnedDirectory(root);
+  try {
+    for (const segment of segments) {
+      const next = await openDirectoryAt(current, segment);
+      const metadata = await next.stat();
+      if (!metadata.isDirectory()) {
+        await next.close();
+        throw new Error("Contained ancestor is not a directory");
+      }
+      await current.close();
+      current = next;
+    }
+    return { handle: current, basename };
+  } catch (error) {
+    await current.close();
+    throw error;
+  }
+}
+async function openContainedFile(root, relative) {
+  const parent = await openContainedParent(root, relative);
+  try {
+    const handle = await openFileAt(parent.handle, parent.basename);
+    const metadata = await handle.stat();
+    if (!metadata.isFile()) {
+      await handle.close();
+      throw new Error("Contained path is not a regular file");
+    }
+    return handle;
+  } finally {
+    await parent.handle.close();
+  }
+}
+async function assertContainedFileCurrent(root, relative, expected) {
+  const current = await openContainedFile(root, relative);
+  try {
+    if (!sameIdentity(await expected.stat(), await current.stat())) {
+      throw new Error("Contained file identity changed during authorization");
+    }
+  } finally {
+    await current.close();
+  }
+}
+async function assertContainedParentCurrent(root, relative, expected) {
+  const current = await openContainedParent(root, relative);
+  try {
+    if (!sameIdentity(await expected.stat(), await current.handle.stat())) {
+      throw new Error("Contained parent identity changed during authorization");
+    }
+  } finally {
+    await current.handle.close();
+  }
+}
+async function writeDescriptorFully(descriptor, content) {
+  const bytes = Buffer.from(content);
+  let offset = 0;
+  while (offset < bytes.byteLength) {
+    const written = await new Promise((resolve, reject) => {
+      writeDescriptor(descriptor, bytes, offset, bytes.byteLength - offset, null, (error, bytesWritten) => error ? reject(error) : resolve(bytesWritten));
+    });
+    if (written === 0)
+      throw new Error("Contained file write made no progress");
+    offset += written;
+  }
+}
+async function chmodDescriptor(descriptor, mode) {
+  await new Promise((resolve, reject) => {
+    fchmod(descriptor, mode & 4095, (error) => error ? reject(error) : resolve());
+  });
+}
+async function createDarwinFile(parent, name, content, mode) {
+  const binding = loadDarwinBinding();
+  const descriptor = binding.createFileAt(parent.fd, name, mode & 4095);
+  let failed;
+  try {
+    await writeDescriptorFully(descriptor, content);
+    await chmodDescriptor(descriptor, mode);
+  } catch (error) {
+    failed = error;
+  } finally {
+    try {
+      await new NumericFileHandle(descriptor).close();
+    } catch (error) {
+      failed ??= error;
+    }
+  }
+  if (failed) {
+    binding.unlinkAt(parent.fd, name);
+    throw failed;
+  }
+}
+async function writeContainedFile(input) {
+  const mode = input.mode ?? 438;
+  if (!input.replace) {
+    if (process.platform === "darwin") {
+      await createDarwinFile(input.parent.handle, input.parent.basename, input.content, mode);
+      return;
+    }
+    await writeFile(path.join(descriptorPath(input.parent.handle), input.parent.basename), input.content, { flag: "wx", mode });
+    return;
+  }
+  const temporary = `.${input.parent.basename}.${process.pid}.${crypto.randomUUID()}.tmp`;
+  if (process.platform === "darwin") {
+    const binding = loadDarwinBinding();
+    let created = false;
+    try {
+      await createDarwinFile(input.parent.handle, temporary, input.content, mode);
+      created = true;
+      binding.renameAt(input.parent.handle.fd, temporary, input.parent.basename);
+    } catch (error) {
+      if (created)
+        binding.unlinkAt(input.parent.handle.fd, temporary);
+      throw error;
+    }
+    return;
+  }
+  const directory = descriptorPath(input.parent.handle);
+  const temporaryPath = path.join(directory, temporary);
+  try {
+    await writeFile(temporaryPath, input.content, { flag: "wx", mode });
+    await rename(temporaryPath, path.join(directory, input.parent.basename));
+  } catch (error) {
+    await unlink(temporaryPath).catch(() => {
+      return;
+    });
+    throw error;
+  }
+}
+async function containedEntryMetadata(parent) {
+  return statAt(parent.handle, parent.basename);
+}
+async function openContainedParentFile(parent) {
+  const handle = await openFileAt(parent.handle, parent.basename);
+  if (!(await handle.stat()).isFile()) {
+    await handle.close();
+    throw new Error("Contained path is not a regular file");
+  }
+  return handle;
+}
+async function readContainedUtf8Handle(handle, maxBytes) {
+  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
+  };
+}
+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 files = [];
+  let truncated = false;
+  let skippedDirectories = 0;
+  let skippedSymlinks = 0;
+  const root = await openPinnedDirectory(input.root);
+  const visit = async (directory, relativeDirectory, depth) => {
+    if (truncated)
+      return;
+    if (depth > input.maxDepth) {
+      truncated = true;
+      return;
+    }
+    const entries = [...await listAt(directory)];
+    entries.sort((left, right) => left.name.localeCompare(right.name));
+    for (const entry of entries) {
+      const relative = relativeDirectory ? path.join(relativeDirectory, entry.name) : entry.name;
+      if (entry.isSymbolicLink()) {
+        if (input.symlinks === "refuse") {
+          throw new Error(`Contained file traversal refuses symlink: ${relative}`);
+        }
+        skippedSymlinks += 1;
+        continue;
+      }
+      if (entry.isDirectory()) {
+        if (input.excludeDirectory?.(relative)) {
+          skippedDirectories += 1;
+          continue;
+        }
+        let child;
+        try {
+          child = await openDirectoryAt(directory, entry.name);
+        } catch (error) {
+          if (input.symlinks === "skip") {
+            skippedSymlinks += 1;
+            continue;
+          }
+          throw error;
+        }
+        try {
+          await visit(child, relative, depth + 1);
+        } finally {
+          await child.close();
+        }
+        continue;
+      }
+      if (!entry.isFile())
+        continue;
+      if (files.length >= input.maxFiles) {
+        truncated = true;
+        return;
+      }
+      let content;
+      if (input.readMaxBytes !== undefined) {
+        try {
+          const handle = await openFileAt(directory, entry.name);
+          try {
+            content = await readContainedUtf8Handle(handle, input.readMaxBytes);
+          } finally {
+            await handle.close();
+          }
+        } catch (error) {
+          if (input.skipUnreadable)
+            continue;
+          throw error;
+        }
+      }
+      files.push({ absolute: relative, relative, ...content && { content } });
+    }
+  };
+  try {
+    await visit(root, "", 0);
+  } finally {
+    await root.close();
+  }
+  return { files, truncated, skippedDirectories, skippedSymlinks };
+}
+
+export { openContainedParent, openContainedFile, assertContainedFileCurrent, assertContainedParentCurrent, writeContainedFile, containedEntryMetadata, openContainedParentFile, readContainedUtf8Handle, walkContainedFiles, scanContainedFiles };

package/dist/{index-38hs3a58.js → index-4g196jmf.js}

@@ -21,7 +21,7 @@ import {
 } from "./index-ktsps64f.js";
 import {
   ShutdownOptionsSchema
-} from "./index-dk6e56g0.js";
+} from "./index-7wpgrqa8.js";
 import {
   errorCode,
   normalizeError,
@@ -1790,6 +1790,9 @@ function bindProcessSignals(handle, options = {}) {
     ...requested.forceTimeoutMs !== undefined && {
       forceTimeoutMs: validated.forceTimeoutMs
     },
+    ...requested.realtimeCloseTimeoutMs !== undefined && {
+      realtimeCloseTimeoutMs: validated.realtimeCloseTimeoutMs
+    },
     ...requested.retryAfterSeconds !== undefined && {
       retryAfterSeconds: validated.retryAfterSeconds
     }

package/dist/{index-dk6e56g0.js → index-7wpgrqa8.js}

@@ -10,6 +10,7 @@ var ShutdownStateSchema = z.enum([
 ]);
 var ShutdownOptionsSchema = z.object({
   gracePeriodMs: z.number().int().nonnegative().default(30000),
+  realtimeCloseTimeoutMs: z.number().int().nonnegative().default(1000),
   forceTimeoutMs: z.number().int().nonnegative().default(5000),
   retryAfterSeconds: z.number().int().nonnegative().default(5),
   signal: z.custom((value) => typeof value === "object" && value !== null && ("aborted" in value) && ("addEventListener" in value), "Expected an AbortSignal").optional()
@@ -63,6 +64,32 @@ function untilAbort(signal) {
     return Promise.resolve();
   return new Promise((resolve) => signal.addEventListener("abort", () => resolve(), { once: true }));
 }
+function closeRealtimeWithin(adapter, timeoutMs, signal) {
+  if (signal.aborted)
+    return Promise.resolve("aborted");
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    const finish = (outcome) => {
+      if (settled)
+        return;
+      settled = true;
+      clearTimeout(timer);
+      signal.removeEventListener("abort", onAbort);
+      resolve(outcome);
+    };
+    const onAbort = () => finish("aborted");
+    const timer = setTimeout(() => finish("timeout"), timeoutMs);
+    signal.addEventListener("abort", onAbort, { once: true });
+    adapter.closeRealtime().then(() => finish("closed"), (error) => {
+      if (settled)
+        return;
+      settled = true;
+      clearTimeout(timer);
+      signal.removeEventListener("abort", onAbort);
+      reject(error);
+    });
+  });
+}
 function withTimeout(promise, timeoutMs, message) {
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => reject(new Error(message)), timeoutMs);
@@ -119,6 +146,7 @@ function createServerLifecycle(getAdapter) {
       const phaseAbort = new AbortController;
       let forcedReason;
       let phaseError;
+      let forcedWebSockets = 0;
       const force = (reason) => {
         if (forcedReason)
           return;
@@ -139,7 +167,13 @@ function createServerLifecycle(getAdapter) {
           await waitForZero(() => pendingApplicationRequests, phaseAbort.signal);
           if (!forcedReason) {
             state = "closing-realtime";
-            await Promise.race([adapter.closeRealtime(), untilAbort(phaseAbort.signal)]);
+            const realtimeOutcome = await closeRealtimeWithin(adapter, parsed.realtimeCloseTimeoutMs, phaseAbort.signal);
+            if (!forcedReason && realtimeOutcome === "timeout" && adapter.pendingWebSockets() > 0) {
+              forcedWebSockets += await Promise.race([
+                adapter.terminateRealtime(),
+                untilAbort(phaseAbort.signal).then(() => 0)
+              ]);
+            }
           }
           if (!forcedReason) {
             state = "stopping-runtime";
@@ -157,6 +191,7 @@ function createServerLifecycle(getAdapter) {
           state = "stopping-runtime";
           pendingRequestsAtForce = adapter.pendingRequests();
           pendingWebSocketsAtForce = adapter.pendingWebSockets();
+          forcedWebSockets += pendingWebSocketsAtForce;
           let forceError;
           let forceFailed = false;
           try {
@@ -189,7 +224,7 @@ function createServerLifecycle(getAdapter) {
           pendingRequestsAtForce,
           pendingWebSocketsAtForce,
           abortedRequests: pendingRequestsAtForce,
-          forcedWebSockets: pendingWebSocketsAtForce,
+          forcedWebSockets,
           durationMs: performance.now() - startedAt
         }));
       })().catch((error) => {

package/dist/{index-6wzr93cg.js → index-w0445741.js}

@@ -8,7 +8,7 @@ import {
 } from "./index-8eywc9zv.js";
 import {
   ShutdownOptionsSchema
-} from "./index-dk6e56g0.js";
+} from "./index-7wpgrqa8.js";
 import {
   AppError
 } from "./index-0w9abg87.js";

package/dist/node.js

@@ -5,7 +5,7 @@ import {
   createHandler,
   createSocketIOServer,
   createUnixClientTransport
-} from "./index-38hs3a58.js";
+} from "./index-4g196jmf.js";
 import {
   createImplement,
   createImplementRegistry,
@@ -23,7 +23,7 @@ import {
   ShutdownStateSchema,
   ShutdownStatusSchema,
   createServerLifecycle
-} from "./index-dk6e56g0.js";
+} from "./index-7wpgrqa8.js";
 import"./index-bd17ytae.js";
 import"./index-vj3vvpaa.js";
 import {
@@ -152,6 +152,18 @@ async function serveNode(config) {
       return Promise.resolve();
     return new Promise((resolve) => socketDrainWaiters.add(resolve));
   };
+  const waitForUpgradedSocketDrain = () => {
+    if (upgradedSockets.size === 0)
+      return Promise.resolve();
+    return Promise.all([...upgradedSockets].map((activeSocket) => new Promise((resolve) => {
+      if (activeSocket.closed)
+        resolve();
+      else
+        activeSocket.once("close", () => resolve());
+    }))).then(() => {
+      return;
+    });
+  };
   const requireRuntime = () => {
     if (!runtime)
       throw new Error("[stitchkit] Node server lifecycle started before srvx");
@@ -167,6 +179,14 @@ async function serveNode(config) {
     pendingRequests: () => responses.size,
     pendingWebSockets: () => upgradedSockets.size,
     closeRealtime: () => socket?.close() ?? Promise.resolve(),
+    async terminateRealtime() {
+      const count = upgradedSockets.size;
+      const physicalClose = waitForUpgradedSocketDrain();
+      for (const activeSocket of [...upgradedSockets])
+        activeSocket.destroy();
+      await physicalClose;
+      return count;
+    },
     async stopGracefully() {
       const runtimeClose = socket ? Promise.resolve() : requireRuntime().close(false);
       requireNodeServer().closeIdleConnections?.();

package/dist/server/bun.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["../../src/server/bun.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,yEAAyE;AACzE,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;AACrD,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC9C,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;AAC5D,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;AACtD,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;AAC9D,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;AAExD,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,KAAK,oBAAoB,GAAG,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC1D,KAAK,qBAAqB,GAAG,eAAe,SAAS;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAE3F,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,eAAe,EACf,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAChF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,8EAA8E;AAC9E,MAAM,WAAW,eAAgB,SAAQ,gBAAgB,EAAE,mBAAmB;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,iGAAiG;IACjG,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,GAAG,CAAC,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,MAAM,eAAe,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAyD7D,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CA6LrE"}
+{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["../../src/server/bun.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,yEAAyE;AACzE,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;AACrD,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC9C,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;AAC5D,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;AACtD,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;AAC9D,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;AAExD,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,KAAK,oBAAoB,GAAG,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC1D,KAAK,qBAAqB,GAAG,eAAe,SAAS;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAE3F,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,eAAe,EACf,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAChF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,8EAA8E;AAC9E,MAAM,WAAW,eAAgB,SAAQ,gBAAgB,EAAE,mBAAmB;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,iGAAiG;IACjG,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,GAAG,CAAC,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,MAAM,eAAe,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAyD7D,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAoMrE"}

package/dist/server/index.js

@@ -13,7 +13,7 @@ import {
   sseRoute,
   streamingRoute,
   webSocketLane
-} from "../index-38hs3a58.js";
+} from "../index-4g196jmf.js";
 import {
   composeAuthHooks,
   createAuthHook,
@@ -60,7 +60,7 @@ import {
   ShutdownStateSchema,
   ShutdownStatusSchema,
   createServerLifecycle
-} from "../index-dk6e56g0.js";
+} from "../index-7wpgrqa8.js";
 import {
   jsonSchemaFields,
   toJsonSchema
@@ -199,6 +199,14 @@ function createServer(config) {
         ws.close(1001, "Server shutting down");
       await Promise.all([logicalClose, waitForSocketDrain()]);
     },
+    async terminateRealtime() {
+      const count = openSockets.size;
+      const physicalClose = waitForSocketDrain();
+      for (const ws of [...openSockets])
+        ws.terminate();
+      await physicalClose;
+      return count;
+    },
     async stopGracefully() {
       await new Promise((resolve) => setTimeout(resolve, 0));
       const server2 = requireRuntime();

package/dist/server/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/server/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAkB,MAAM,WAAW,CAAC;AAEtE,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGlC,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,aAAa,IAAI,IAAI,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,IAAI,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa,EAAE,gBAAgB;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AACzD,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;AAEtE,wBAAsB,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmInF"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/server/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAkB,MAAM,WAAW,CAAC;AAEtE,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGlC,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,aAAa,IAAI,IAAI,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,IAAI,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa,EAAE,gBAAgB;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AACzD,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;AAEtE,wBAAsB,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsJnF"}

package/dist/server/process-signals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-signals.d.ts","sourceRoot":"","sources":["../../src/server/process-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGlE;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,CAAC;AAEf,wDAAwD;AACxD,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,cAAc;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED,gEAAgE;AAChE,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACzD,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC1D;;;;;;;;OAQG;IACH,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;CAClD;AAED,MAAM,WAAW,qBAAqB,CAAC,OAAO,GAAG,cAAc;IAC7D;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAC3C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACpE,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,GAAG,UAAU,KAAK,IAAI,CAAC;IACpF;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,qBAAqB,CAAC,OAAO,GAAG,cAAc;IAC7D;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/C,wCAAwC;IACxC,KAAK,IAAI,IAAI,CAAC;CACf;AAUD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAG,cAAc,EACzD,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,EAC/B,OAAO,GAAE,qBAAqB,CAAC,OAAO,CAAM,GAC3C,qBAAqB,CAAC,OAAO,CAAC,CAqKhC"}
+{"version":3,"file":"process-signals.d.ts","sourceRoot":"","sources":["../../src/server/process-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGlE;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,CAAC;AAEf,wDAAwD;AACxD,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,cAAc;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED,gEAAgE;AAChE,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACzD,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC1D;;;;;;;;OAQG;IACH,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;CAClD;AAED,MAAM,WAAW,qBAAqB,CAAC,OAAO,GAAG,cAAc;IAC7D;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAC3C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACpE,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,GAAG,UAAU,KAAK,IAAI,CAAC;IACpF;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,qBAAqB,CAAC,OAAO,GAAG,cAAc;IAC7D;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/C,wCAAwC;IACxC,KAAK,IAAI,IAAI,CAAC;CACf;AAUD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAG,cAAc,EACzD,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,EAC/B,OAAO,GAAE,qBAAqB,CAAC,OAAO,CAAM,GAC3C,qBAAqB,CAAC,OAAO,CAAC,CAwKhC"}

package/dist/server/shutdown.d.ts

@@ -11,6 +11,7 @@ export declare const ShutdownStateSchema: z.ZodEnum<{
 export type ShutdownState = z.infer<typeof ShutdownStateSchema>;
 export declare const ShutdownOptionsSchema: z.ZodObject<{
     gracePeriodMs: z.ZodDefault<z.ZodNumber>;
+    realtimeCloseTimeoutMs: z.ZodDefault<z.ZodNumber>;
     forceTimeoutMs: z.ZodDefault<z.ZodNumber>;
     retryAfterSeconds: z.ZodDefault<z.ZodNumber>;
     signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
@@ -64,6 +65,7 @@ export interface ShutdownAdapter {
     pendingRequests(): number;
     pendingWebSockets(): number;
     closeRealtime(): Promise<void>;
+    terminateRealtime(): Promise<number>;
     stopGracefully(): Promise<void>;
     forceStop(): Promise<void>;
 }

package/dist/server/shutdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/server/shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,eAAO,MAAM,mBAAmB;;;;;;;EAO9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,qBAAqB;;;;;iBAchC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;iBAY/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB,CAAC,QAAQ;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,eAAe,IAAI,MAAM,CAAC;IAC1B,iBAAiB,IAAI,MAAM,CAAC;IAC5B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,UAAU,eAAe;IACvB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAC1E,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9D;AAqDD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,eAAe,GAAG,eAAe,CAiJxF"}
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/server/shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,eAAO,MAAM,mBAAmB;;;;;;;EAO9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,qBAAqB;;;;;;iBAehC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;iBAY/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB,CAAC,QAAQ;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,eAAe,IAAI,MAAM,CAAC;IAC1B,iBAAiB,IAAI,MAAM,CAAC;IAC5B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,UAAU,eAAe;IACvB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAC1E,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9D;AAoFD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,eAAe,GAAG,eAAe,CAiKxF"}

package/dist/testing.js

@@ -4,7 +4,7 @@ import {
 } from "./index-x1th9s8c.js";
 import {
   createApplication
-} from "./index-6wzr93cg.js";
+} from "./index-w0445741.js";
 import"./index-2k4yrqkc.js";
 import"./index-8eywc9zv.js";
 import {
@@ -12,7 +12,7 @@ import {
   RealtimeRequestInvalidAcknowledgementError,
   RealtimeRequestTimeoutError
 } from "./index-7b188kmz.js";
-import"./index-dk6e56g0.js";
+import"./index-7wpgrqa8.js";
 import {
   mcpProjectionCandidate,
   prepareProjectedMcpTools,