stitchkit 0.103.12 → 0.104.0

package/llms.txt

@@ -9,19 +9,20 @@ Build with stitchkit: define a contract once, then `implement` it and serve it (
 Load the slice for each entrypoint your code imports — `import … from 'stitchkit/server'` → `llms/server.txt`; the root `stitchkit` import → `llms/stitchkit.txt`. A slice holds that entrypoint's API reference section and the guide pages whose home it is; every guide lives in exactly one slice, and a slice that needs another's guide names it under "Also read". Each file is at most 50.0 KB; a longer one continues in numbered parts, each naming the next at its top. Moving across versions: load `llms/upgrading.txt` and the range slices it lists between your version and the target. `llms-full.txt` inlines everything; it is far larger than a context window, so do not read it whole.
 
 ## Entrypoint slices
-- **stitchkit**: [llms/stitchkit.txt](llms/stitchkit.txt) 17.2 KB → [llms/stitchkit.2.txt](llms/stitchkit.2.txt) 45.2 KB → [llms/stitchkit.3.txt](llms/stitchkit.3.txt) 17.1 KB
+- **stitchkit**: [llms/stitchkit.txt](llms/stitchkit.txt) 17.4 KB → [llms/stitchkit.2.txt](llms/stitchkit.2.txt) 46.2 KB → [llms/stitchkit.3.txt](llms/stitchkit.3.txt) 17.1 KB
 - **stitchkit/live**: [llms/live.txt](llms/live.txt) 21.6 KB
 - **stitchkit/react**: [llms/react.txt](llms/react.txt) 9.0 KB
 - **stitchkit/react/keyboard**: [llms/react-keyboard.txt](llms/react-keyboard.txt) 9.4 KB
-- **stitchkit/tools**: [llms/tools.txt](llms/tools.txt) 47.4 KB → [llms/tools.2.txt](llms/tools.2.txt) 26.9 KB → [llms/tools.3.txt](llms/tools.3.txt) 25.5 KB
+- **stitchkit/tools**: [llms/tools.txt](llms/tools.txt) 46.0 KB → [llms/tools.2.txt](llms/tools.2.txt) 29.5 KB → [llms/tools.3.txt](llms/tools.3.txt) 25.7 KB
+- **stitchkit/tools/mcp**: [llms/tools-mcp.txt](llms/tools-mcp.txt) 1.8 KB
 - **stitchkit/tools/contract**: [llms/tools-contract.txt](llms/tools-contract.txt) 0.2 KB
 - **stitchkit/tools/invoker**: [llms/tools-invoker.txt](llms/tools-invoker.txt) 0.2 KB
-- **stitchkit/tools/connections**: [llms/tools-connections.txt](llms/tools-connections.txt) 3.1 KB
-- **stitchkit/cli**: [llms/cli.txt](llms/cli.txt) 43.6 KB → [llms/cli.2.txt](llms/cli.2.txt) 8.1 KB
+- **stitchkit/tools/connections**: [llms/tools-connections.txt](llms/tools-connections.txt) 3.7 KB
+- **stitchkit/cli**: [llms/cli.txt](llms/cli.txt) 46.1 KB → [llms/cli.2.txt](llms/cli.2.txt) 15.8 KB
 - **stitchkit/remote**: [llms/remote.txt](llms/remote.txt) 1.0 KB
 - **stitchkit/contract**: [llms/contract.txt](llms/contract.txt) 31.9 KB
 - **stitchkit/primitives**: [llms/primitives.txt](llms/primitives.txt) 11.2 KB
-- **stitchkit/server**: [llms/server.txt](llms/server.txt) 45.3 KB → [llms/server.2.txt](llms/server.2.txt) 14.6 KB → [llms/server.3.txt](llms/server.3.txt) 45.6 KB → [llms/server.4.txt](llms/server.4.txt) 38.1 KB → [llms/server.5.txt](llms/server.5.txt) 21.8 KB
+- **stitchkit/server**: [llms/server.txt](llms/server.txt) 45.3 KB → [llms/server.2.txt](llms/server.2.txt) 14.6 KB → [llms/server.3.txt](llms/server.3.txt) 45.6 KB → [llms/server.4.txt](llms/server.4.txt) 38.3 KB → [llms/server.5.txt](llms/server.5.txt) 22.0 KB
 - **stitchkit/observability**: [llms/observability.txt](llms/observability.txt) 44.8 KB
 - **stitchkit/agent-runtime**: [llms/agent-runtime.txt](llms/agent-runtime.txt) 37.2 KB → [llms/agent-runtime.2.txt](llms/agent-runtime.2.txt) 46.7 KB → [llms/agent-runtime.3.txt](llms/agent-runtime.3.txt) 34.3 KB
 - **stitchkit/agent-runtime/testing**: [llms/agent-runtime-testing.txt](llms/agent-runtime-testing.txt) 2.6 KB
@@ -31,7 +32,7 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - **stitchkit/agent-runtime/openrouter**: [llms/agent-runtime-openrouter.txt](llms/agent-runtime-openrouter.txt) 1.1 KB
 - **stitchkit/agent-runtime/sqlite/bun**: [llms/agent-runtime-sqlite-bun.txt](llms/agent-runtime-sqlite-bun.txt) 1.8 KB
 - **stitchkit/agent-runtime/sqlite/node**: [llms/agent-runtime-sqlite-node.txt](llms/agent-runtime-sqlite-node.txt) 1.7 KB
-- **stitchkit/application**: [llms/application.txt](llms/application.txt) 37.9 KB → [llms/application.2.txt](llms/application.2.txt) 24.1 KB → [llms/application.3.txt](llms/application.3.txt) 27.3 KB
+- **stitchkit/application**: [llms/application.txt](llms/application.txt) 37.9 KB → [llms/application.2.txt](llms/application.2.txt) 31.0 KB → [llms/application.3.txt](llms/application.3.txt) 27.8 KB
 - **stitchkit/application/grammy**: [llms/application-grammy.txt](llms/application-grammy.txt) 2.3 KB
 - **stitchkit/application/opentelemetry**: [llms/application-opentelemetry.txt](llms/application-opentelemetry.txt) 1.6 KB
 - **stitchkit/application/directory-inbox**: [llms/application-directory-inbox.txt](llms/application-directory-inbox.txt) 0.3 KB
@@ -40,7 +41,7 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - **stitchkit/testing**: [llms/testing.txt](llms/testing.txt) 30.8 KB
 - **stitchkit/agent-runtime/sandbox**: [llms/agent-runtime-sandbox.txt](llms/agent-runtime-sandbox.txt) 8.3 KB
 - **stitchkit/files**: [llms/files.txt](llms/files.txt) 4.5 KB
-- **stitchkit/telegram**: [llms/telegram.txt](llms/telegram.txt) 26.9 KB
+- **stitchkit/telegram**: [llms/telegram.txt](llms/telegram.txt) 30.1 KB
 - **stitchkit/telegram/html**: [llms/telegram-html.txt](llms/telegram-html.txt) 2.7 KB
 - **stitchkit/telegram/screens**: [llms/telegram-screens.txt](llms/telegram-screens.txt) 21.2 KB
 - **stitchkit/tracking**: [llms/tracking.txt](llms/tracking.txt) 16.8 KB
@@ -55,14 +56,14 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - **stitchkit/agent-runtime/react**: [llms/agent-runtime-react.txt](llms/agent-runtime-react.txt) 1.0 KB
 - **stitchkit/agent-runtime/realtime**: [llms/agent-runtime-realtime.txt](llms/agent-runtime-realtime.txt) 1.8 KB
 - **stitchkit/agent-runtime/harness-tools**: [llms/agent-runtime-harness-tools.txt](llms/agent-runtime-harness-tools.txt) 1.3 KB
-- **stitchkit/process**: [llms/process.txt](llms/process.txt) 20.0 KB
+- **stitchkit/process**: [llms/process.txt](llms/process.txt) 21.7 KB
 
 ## Upgrading slices
 - **Upgrading — how to move across versions**: [llms/upgrading.txt](llms/upgrading.txt) 10.3 KB
-- **Upgrading 0.75.0 → 0.103.0**: [llms/upgrading-0.75.0-0.103.0.txt](llms/upgrading-0.75.0-0.103.0.txt) 46.3 KB
-- **Upgrading 0.61.0 → 0.74.0**: [llms/upgrading-0.61.0-0.74.0.txt](llms/upgrading-0.61.0-0.74.0.txt) 43.5 KB
-- **Upgrading 0.44.0 → 0.60.0**: [llms/upgrading-0.44.0-0.60.0.txt](llms/upgrading-0.44.0-0.60.0.txt) 43.9 KB
-- **Upgrading 0.37.0 → 0.37.0**: [llms/upgrading-0.37.0.txt](llms/upgrading-0.37.0.txt) 6.2 KB
+- **Upgrading 0.80.0 → 0.104.0**: [llms/upgrading-0.80.0-0.104.0.txt](llms/upgrading-0.80.0-0.104.0.txt) 46.7 KB
+- **Upgrading 0.62.0 → 0.79.0**: [llms/upgrading-0.62.0-0.79.0.txt](llms/upgrading-0.62.0-0.79.0.txt) 43.7 KB
+- **Upgrading 0.44.0 → 0.61.0**: [llms/upgrading-0.44.0-0.61.0.txt](llms/upgrading-0.44.0-0.61.0.txt) 41.4 KB
+- **Upgrading 0.37.0 → 0.44.0**: [llms/upgrading-0.37.0-0.44.0.txt](llms/upgrading-0.37.0-0.44.0.txt) 14.7 KB
 
 ## Guide (web)
 - [Getting started](https://github.com/max-listov/stitchkit/blob/master/docs/guide/getting-started.md): install, entrypoints, and a first contract → server → client app

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.103.12",
+  "version": "0.104.0",
   "description": "Contract-first backend framework — one defineContract() into an HTTP API, MCP tools, AI-agent tools and a typed client. Bun and Node.",
   "keywords": [
     "bun",
@@ -42,6 +42,8 @@
   "files": [
     "dist",
     "native/*.node",
+    "darwin-native.cjs",
+    "darwin-native.d.cts",
     "llms.txt",
     "llms-full.txt",
     "llms",
@@ -49,6 +51,9 @@
     "CHANGELOG.md",
     "LICENSE"
   ],
+  "imports": {
+    "#stitchkit-darwin-native": "./darwin-native.cjs"
+  },
   "exports": {
     ".": {
       "types": "./dist/entrypoints/index.d.ts",
@@ -70,6 +75,10 @@
       "types": "./dist/entrypoints/tools.d.ts",
       "import": "./dist/entrypoints/tools.js"
     },
+    "./tools/mcp": {
+      "types": "./dist/entrypoints/tools/mcp.d.ts",
+      "import": "./dist/entrypoints/tools/mcp.js"
+    },
     "./tools/contract": {
       "types": "./dist/entrypoints/tools/contract.d.ts",
       "import": "./dist/entrypoints/tools/contract.js"

package/dist/index-d4pa2bgs.js

@@ -1,42 +0,0 @@
-// src/internal/darwin-binding.ts
-import { existsSync } from "node:fs";
-import { createRequire } from "node:module";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-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",
-    "createDirectoryAt",
-    "statAt",
-    "listAt",
-    "renameAt",
-    "unlinkAt",
-    "processIdentity"
-  ];
-  if (!hasFunctions(loaded, methods)) {
-    throw new Error("The packaged Darwin contained-files backend has an invalid surface");
-  }
-  darwinBinding = loaded;
-  return darwinBinding;
-}
-
-export { loadDarwinBinding };

package/dist/index-wykebpn9.js

@@ -1,221 +0,0 @@
-import {
-  isRecord
-} from "./index-9jfdm5tg.js";
-
-// src/application/file-state-store.ts
-import { mkdir, open, readdir, readFile, rename, stat, unlink } from "node:fs/promises";
-import { basename, dirname, join } from "node:path";
-var ABANDONED_LOCK_MULTIPLIER = 10;
-var ABANDONED_HEARTBEATS = 30;
-var MIN_HEARTBEAT_MS = 10;
-var delay = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
-async function missing(error) {
-  return error instanceof Error && "code" in error && error.code === "ENOENT";
-}
-function existing(error) {
-  return error instanceof Error && "code" in error && error.code === "EEXIST";
-}
-async function ownerState(lockPath) {
-  let owner;
-  try {
-    owner = JSON.parse(await readFile(lockPath, "utf8"));
-  } catch {
-    return "unknown";
-  }
-  if (typeof owner !== "object" || owner === null || !("pid" in owner) || typeof owner.pid !== "number" || !Number.isSafeInteger(owner.pid) || owner.pid <= 0) {
-    return "unknown";
-  }
-  try {
-    process.kill(owner.pid, 0);
-    return "alive";
-  } catch (error) {
-    return error instanceof Error && "code" in error && error.code === "ESRCH" ? "gone" : "unknown";
-  }
-}
-async function sweepTemporaries(path, staleLockMs) {
-  const prefix = `${basename(path)}.tmp.`;
-  const directory = dirname(path);
-  let entries;
-  try {
-    entries = await readdir(directory);
-  } catch {
-    return;
-  }
-  for (const entry of entries) {
-    if (!entry.startsWith(prefix))
-      continue;
-    const candidate = join(directory, entry);
-    const info = await stat(candidate).catch(() => null);
-    if (info && Date.now() - info.mtimeMs > staleLockMs) {
-      await unlink(candidate).catch(() => {
-        return;
-      });
-    }
-  }
-}
-async function reclaim(lockPath, observed, staleLockMs, abandonedAfterMs) {
-  const guardPath = `${lockPath}.reclaim`;
-  let guard;
-  try {
-    guard = await open(guardPath, "wx");
-  } catch (error) {
-    if (!existing(error))
-      throw error;
-    const orphan = await stat(guardPath).catch(() => null);
-    if (orphan && Date.now() - orphan.mtimeMs > staleLockMs) {
-      await unlink(guardPath).catch(() => {
-        return;
-      });
-    }
-    return false;
-  }
-  try {
-    const current = await stat(lockPath).catch(() => null);
-    if (!current || current.dev !== observed.dev || current.ino !== observed.ino || current.mtimeMs !== observed.mtimeMs) {
-      return false;
-    }
-    const owner = await ownerState(lockPath);
-    const age = Date.now() - current.mtimeMs;
-    if (owner !== "gone" && age < abandonedAfterMs)
-      return false;
-    await unlink(lockPath);
-    return true;
-  } finally {
-    await guard.close().catch(() => {
-      return;
-    });
-    await unlink(guardPath).catch(() => {
-      return;
-    });
-  }
-}
-function createFileStateStore2(path, options) {
-  const lockPath = `${path}.lock`;
-  const lockTimeoutMs = options.lockTimeoutMs ?? 1e4;
-  const staleLockMs = options.staleLockMs ?? 3000;
-  const retryMs = options.retryMs ?? 10;
-  const heartbeatMs = Math.max(MIN_HEARTBEAT_MS, Math.floor(staleLockMs / 3));
-  const abandonedAfterMs = Math.max(staleLockMs * ABANDONED_LOCK_MULTIPLIER, heartbeatMs * ABANDONED_HEARTBEATS);
-  if (staleLockMs >= lockTimeoutMs) {
-    throw new Error(`[stitchkit] createFileStateStore: staleLockMs (${staleLockMs}) must be below lockTimeoutMs (${lockTimeoutMs}), or a crashed holder blocks every update until the timeout`);
-  }
-  let sweptTemporaries = false;
-  const parseFile = async () => {
-    let source;
-    try {
-      source = await readFile(path, "utf8");
-    } catch (error) {
-      if (await missing(error))
-        return null;
-      throw error;
-    }
-    try {
-      return options.schema.parse(JSON.parse(source));
-    } catch (error) {
-      await options.onCorrupt?.({ path, error });
-      if ((options.corrupt ?? "throw") === "empty")
-        return null;
-      throw error;
-    }
-  };
-  const acquire = async () => {
-    await mkdir(dirname(path), { recursive: true });
-    if (!sweptTemporaries) {
-      sweptTemporaries = true;
-      await sweepTemporaries(path, staleLockMs);
-    }
-    const deadline = Date.now() + lockTimeoutMs;
-    while (true) {
-      try {
-        const handle = await open(lockPath, "wx");
-        const token = crypto.randomUUID();
-        try {
-          await handle.writeFile(JSON.stringify({ token, pid: process.pid, acquiredAt: Date.now() }));
-          await handle.sync();
-        } catch (error) {
-          await handle.close().catch(() => {
-            return;
-          });
-          await unlink(lockPath).catch(() => {
-            return;
-          });
-          throw error;
-        }
-        return {
-          refresh: async () => {
-            const now = new Date;
-            await handle.utimes(now, now);
-          },
-          release: async () => {
-            await handle.close();
-            try {
-              const owner = JSON.parse(await readFile(lockPath, "utf8"));
-              if (isRecord(owner) && owner.token === token)
-                await unlink(lockPath);
-            } catch (error) {
-              if (!await missing(error))
-                throw error;
-            }
-          }
-        };
-      } catch (error) {
-        if (!existing(error))
-          throw error;
-        try {
-          const lock = await stat(lockPath);
-          if (Date.now() - lock.mtimeMs > staleLockMs) {
-            if (await reclaim(lockPath, lock, staleLockMs, abandonedAfterMs))
-              continue;
-          }
-        } catch (statError) {
-          if (await missing(statError))
-            continue;
-          throw statError;
-        }
-        if (Date.now() >= deadline) {
-          throw new Error(`[stitchkit] timed out acquiring state lock for ${path}`);
-        }
-        await delay(retryMs);
-      }
-    }
-  };
-  const write = async (state) => {
-    const validated = options.schema.parse(state);
-    const temporary = `${path}.tmp.${process.pid}.${crypto.randomUUID()}`;
-    const handle = await open(temporary, "wx");
-    try {
-      try {
-        await handle.writeFile(`${JSON.stringify(validated)}
-`);
-        await handle.sync();
-      } finally {
-        await handle.close();
-      }
-      await rename(temporary, path);
-    } catch (error) {
-      await unlink(temporary).catch(() => {
-        return;
-      });
-      throw error;
-    }
-  };
-  return {
-    read: parseFile,
-    async update(transition) {
-      const lock = await acquire();
-      const heartbeat = setInterval(() => void lock.refresh().catch(() => {
-        return;
-      }), heartbeatMs);
-      try {
-        const next = await transition(await parseFile());
-        await write(next.state);
-        return next.result;
-      } finally {
-        clearInterval(heartbeat);
-        await lock.release();
-      }
-    }
-  };
-}
-
-export { createFileStateStore2 };

package/llms/upgrading-0.37.0.txt

@@ -1,176 +0,0 @@
-# Upgrading 0.37.0 → 0.37.0 — stitchkit docs slice
-
-> Generated from the `docs/` tree by `bun run gen:llms`. The index of all slices is
-> `llms.txt` in this package.
-
-Contains: Guide: Upgrading, 0.37.0 → 0.37.0  (docs/guide/upgrading.md)
-
-==============================================================================
-# Guide: Upgrading, 0.37.0 → 0.37.0  (docs/guide/upgrading.md)
-==============================================================================
-
-## The 0.37 migration
-
-Tool presentation is no longer an executable Zod parser. Replace the removed
-flatten helpers with the JSON Schema compiler, and choose the explicit
-`MountableTool` surface when using the advanced collection API:
-
-```ts
-// before
-const flat = flattenUnionsDeep(zodSchema)
-mountable.schema
-
-// after
-const flat = flattenToolJsonSchema(
-  z.toJSONSchema(zodSchema, { target: 'draft-07', io: 'input' }),
-)
-mountable.presentationSchema // model/MCP/manifest JSON Schema
-mountable.argumentSchema     // executable CLI argument adapter only
-```
-
-Contract and native handlers keep their original Zod schemas; MCP and agent SDK
-adapters now forward raw arguments so defaults, coercions, refinements and
-transforms execute exactly once inside Stitchkit. There are no compatibility
-exports for `flattenDiscriminatedUnion`, `flattenUnionsDeep` or
-`MountableTool.schema`. → ADR 0050
-
-Tool-call hooks now take one options object. Migrate all three callbacks; there
-are no positional overloads:
-
-```ts
-// before
-beforeToolCall: (toolName, args, context, endpoint) => {}
-afterToolCall: (toolName, args, result, durationMs, context, endpoint, error) => {}
-onToolError: (toolName, error, context, endpoint) => {}
-
-// after
-beforeToolCall: ({ toolName, args, context, endpoint }) => {}
-afterToolCall: ({ toolName, args, result, durationMs, context, endpoint, error }) => {}
-onToolError: ({ toolName, error, context, endpoint }) => {}
-```
-
-### MCP schema validation
-
-The standalone validator now takes one object and live MCP configs carry the
-same rules under `schemaValidation`. Migrate every positional call and every
-`onIncompatibleSchema` field; there is no old-shape overload:
-
-```ts
-// before
-validateMcpSchemas(services, 'throw', logger, { requireTypedProperties: true })
-createMcpHandler({ services, onIncompatibleSchema: 'throw' })
-
-// after
-validateMcpSchemas({ services, policy: 'throw', logger, requireTypedProperties: true })
-createMcpHandler({ services, schemaValidation: { policy: 'throw' } })
-```
-
-Put `extend` and `flattenUnionInput` beside `services`, not inside
-`schemaValidation`. The handler applies the profile to the exact prepared schema
-it advertises. Add `requirePortableFormats: true` when every custom JSON Schema
-format must be rejected before a client sees it.
-
-Native MCP registration also changed shape in 0.37. Move protected tools to the
-framework registrar; keep an SDK-raw tool only by naming the opt-out:
-
-```ts
-// before
-nativeTools: (server, auth) => server.registerTool(name, config, handler)
-
-// after — lifecycle, hooks and schema policy apply
-nativeTools: ({ registerTool }, auth) => registerTool({
-  name, description, identity, input, output, handler,
-})
-
-// after — intentionally raw
-nativeTools: ({ rawServer }, auth) => rawServer.registerTool(name, config, handler)
-```
-
-If a tool hook annotated `endpoint` as `MethodDef`, remove that annotation or
-use `OperationIdentity`: native operations have service/action/scope/method but
-no HTTP path.
-
-### Node-facing server types
-
-`stitchkit/server` remains Bun-concrete: an explicitly annotated `RawRoute`
-still receives `BunServer`. `stitchkit/node` no longer drags Bun declarations
-into a Node project. Its raw routes default the host server to `unknown`, and
-its Socket.IO handle exposes only Node capabilities:
-
-```ts
-// before — Node entry still leaked Bun-only fields and ambient types
-const route: RawRoute = { handler: (_req, ctx) => ctx.server?.upgrade(...) }
-const socket = await createSocketIOServer(config)
-socket.websocket
-
-// after — name a custom embedding host only when one exists
-const route: RawRoute<MyHostServer> = {
-  handler: (_req, ctx) => useHost(ctx.server),
-}
-const socket = await createSocketIOServer(config)
-socket.io
-socket.attach(nodeHttpServer)
-```
-
-Node consumers can remove `@types/bun` unless another dependency independently
-requires it.
-
-### Managed server shutdown
-
-`createServer()` and `serveNode()` now return the same structural managed
-lifecycle. Replace every direct runtime stop and parallel Socket.IO close:
-
-```ts
-// before — split ownership
-const socket = await createSocketIOServer(config)
-const server = createServer({
-  services,
-  websocket: socket.websocket,
-  rawRoutes: [socket.route],
-})
-server.stop()
-await socket.io.close()
-
-// after — one owner and one total deadline
-const socket = await createSocketIOServer(config)
-const server = createServer({ services, socket })
-const result = await server.shutdown({ gracePeriodMs: 30_000 })
-```
-
-On Node, keep the same `socket` field and replace `handle.close()` with
-`handle.shutdown()`. Runtime-specific diagnostics move under `handle.runtime`;
-do not use it as a second shutdown path. Standalone CLI/tools that create a
-Socket.IO handle without an HTTP server call `await socket.close()`.
-
-If Bun Socket.IO shares the port with a raw lane, keep the explicit composition
-but let the server mount the Socket.IO route:
-
-```ts
-createServer({
-  services,
-  socket,
-  websocket: composeWebSocketHandlers([
-    webSocketLane({ match: isRaw, handlers: rawHandlers }),
-    socketIoLane(socket.websocket),
-  ]),
-  rawRoutes: [rawUpgradeRoute],
-})
-```
-
-Move native Bun `routes` entries to `rawRoutes`. Native routes run before the
-Fetch handler and therefore cannot participate in admission or drain. Wire
-`SIGTERM`/`SIGINT` in the application; the first signal starts `shutdown()`, and
-a later signal may abort the same controller. Close MCP, databases and queues
-after the server result—those resources remain application-owned.
-
-Move a handshake policy from the Node-only callback shape inside
-`serverOptions` to the runtime-neutral top-level policy. It receives a Web
-`Request`, may be async, and returns whether to admit the handshake:
-
-```ts
-// before
-serverOptions: { allowRequest: (request, done) => done(null, allowed(request)) }
-
-// after
-allowRequest: (request) => allowed(request)
-```

package/dist/{index-69nvze1q.js → index-pptyv13k.js}

@@ -1,9 +1,9 @@
-import {
-  isJsonData
-} from "./index-fm1c1a08.js";
 import {
   raceAbort
 } from "./index-mbnnw3f2.js";
+import {
+  isJsonData
+} from "./index-fm1c1a08.js";
 
 // src/durability/contract.ts
 import { z } from "zod";