workerdeck 2.8.0 → 2.9.0

package/build/cli.mjs

@@ -1,15 +1,41 @@
 #!/usr/bin/env node
-import { a as ConfigError, d as parseArgs, f as resolveInstanceConfig, r as startInstance, u as loadConfigFile } from "./instance-BhSGGmoY.mjs";
+import { a as ConfigError, d as parseArgs, f as resolveInstanceConfig, r as startInstance, u as loadConfigFile } from "./instance-vQe2VlGq.mjs";
 import { dirname, join } from "node:path";
 import { readFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 import { spawn } from "node:child_process";
+//#region src/lib/shutdown.ts
+function installShutdown({ current, alsoClose, log = (text) => void process.stdout.write(`${text}\n`) }) {
+	let shuttingDown = false;
+	const shutdown = (signal) => {
+		if (shuttingDown) {
+			process.stdout.write(`\n[workerdeck] ${signal} again - terminating now\n`);
+			process.exit(130);
+		}
+		shuttingDown = true;
+		log(`\n[workerdeck] ${signal} - shutting down (press again to stop now)`);
+		const instance = current();
+		instance.drain({ onProgress: (report) => {
+			if (report.working.length > 0) log(`[workerdeck] waiting for ${report.working.length} session(s) to finish the current turn`);
+			for (const id of report.awaitingHuman) log(`[workerdeck] session ${id} is waiting on an approval - not waiting for it`);
+			if (report.timedOut) log(`[workerdeck] ${report.working.length} session(s) still running - stopping anyway`);
+			else if (report.working.length === 0) log("[workerdeck] all turns finished");
+		} }).catch(() => void 0).then(() => instance.close()).then(() => {
+			for (const runner of alsoClose?.() ?? []) runner.close("server");
+		}).then(() => process.exit(0)).catch(() => process.exit(1));
+	};
+	process.on("SIGINT", () => shutdown("SIGINT"));
+	process.on("SIGTERM", () => shutdown("SIGTERM"));
+	return shutdown;
+}
+//#endregion
 //#region src/cli.ts
 const HELP = `workerdeck - run a workerdeck instance: session gateway + dashboard, one port.
 
 Usage
   workerdeck [options]
   workerdeck guard [options]     check whether it is safe to restart an instance
+  workerdeck reload [options]    hot-reload a gateway started with --hot-reload
 
 Options
   -p, --port <n>            port to listen on (default 8787, WORKERDECK_PORT)
@@ -85,6 +111,11 @@ Options
                             404s. For a gateway reached only from the VS Code
                             extension, the phone, or another host's dashboard.
       --open                open the dashboard in a browser once it is up
+      --hot-reload          dev only: re-evaluate the gateway's own source in place on
+                            ctrl-r, SIGUSR2 or \`workerdeck reload\`, carrying live
+                            sessions and their engine child processes across the swap.
+                            Needs a source checkout; the published CLI is one bundled
+                            file with nothing to swap.
   -h, --help                show this
   -v, --version             print the version
 
@@ -125,6 +156,10 @@ function line(text) {
 	process.stdout.write(`${text}\n`);
 }
 async function main(argv) {
+	if (argv[0] === "reload") {
+		const { runReload } = await import("./reload-command-DAeUzBa1.mjs");
+		return await runReload(argv.slice(1));
+	}
 	if (argv[0] === "guard") {
 		const { runGuard } = await import("./guard-C4ybpzbt.mjs").then((n) => n.t);
 		return await runGuard(argv.slice(1));
@@ -138,27 +173,19 @@ async function main(argv) {
 		process.stdout.write(`${await readVersion()}\n`);
 		return 0;
 	}
+	if (flags.hotReload) {
+		const { runHotReload } = await import("./hot-reload-CfP94v9Y.mjs");
+		const result = await runHotReload(flags);
+		if (result !== "unsupported") return result;
+	}
 	const loaded = await loadConfigFile(flags.config);
 	const config = resolveInstanceConfig(flags, loaded);
 	const instance = await startInstance(config);
 	if (config.open) openInBrowser(instance.url);
-	let shuttingDown = false;
-	const shutdown = (signal) => {
-		if (shuttingDown) {
-			process.stdout.write(`\n[workerdeck] ${signal} again - terminating now\n`);
-			process.exit(130);
-		}
-		shuttingDown = true;
-		line(`\n[workerdeck] ${signal} - shutting down (press again to stop now)`);
-		instance.drain({ onProgress: (report) => {
-			if (report.working.length > 0) line(`[workerdeck] waiting for ${report.working.length} session(s) to finish the current turn`);
-			for (const id of report.awaitingHuman) line(`[workerdeck] session ${id} is waiting on an approval - not waiting for it`);
-			if (report.timedOut) line(`[workerdeck] ${report.working.length} session(s) still running - stopping anyway`);
-			else if (report.working.length === 0) line("[workerdeck] all turns finished");
-		} }).catch(() => void 0).then(() => instance.close()).then(() => process.exit(0)).catch(() => process.exit(1));
-	};
-	process.on("SIGINT", () => shutdown("SIGINT"));
-	process.on("SIGTERM", () => shutdown("SIGTERM"));
+	installShutdown({
+		current: () => instance,
+		log: line
+	});
 	await instance.closed;
 	return 0;
 }
@@ -173,6 +200,6 @@ main(process.argv.slice(2)).then((code) => {
 	process.exit(1);
 });
 //#endregion
-export {};
+export { installShutdown as t };
 
 //# sourceMappingURL=cli.mjs.map

package/build/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { spawn } from 'node:child_process'\nimport { readFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { ConfigError, loadConfigFile, parseArgs, resolveInstanceConfig } from './config.ts'\nimport { startInstance } from './lib/instance.ts'\n\nconst HELP = `workerdeck - run a workerdeck instance: session gateway + dashboard, one port.\n\nUsage\n  workerdeck [options]\n  workerdeck guard [options]     check whether it is safe to restart an instance\n\nOptions\n  -p, --port <n>            port to listen on (default 8787, WORKERDECK_PORT)\n      --host <addr>         interface to bind (default 127.0.0.1, WORKERDECK_HOST)\n      --auth-key <secret>   shared secret, min 12 chars; browsers log in with it,\n                            services send it as x-workerdeck-key\n                            (WORKERDECK_AUTH_KEY). Unset = no auth on loopback;\n                            on any other interface a key is generated instead,\n                            printed once, and stored in <state-dir>/auth-key for\n                            later starts to reuse.\n      --trust-proxy         trust x-forwarded-proto/-host/-for from one reverse\n                            proxy. Required behind TLS termination, or the session\n                            cookie loses its Secure flag and the origin check\n                            computes http:// where the browser says https://.\n      --allowed-origin <o>  extra origin accepted on browser requests, for when a\n                            proxy rewrites Host (repeatable)\n      --allowed-host <name> extra Host header accepted when running without auth\n                            (repeatable; loopback names are always accepted)\n      --insecure-host <name>\n                            bind host that may serve without auth - no key demanded,\n                            none generated - and, while unauthenticated, also\n                            accepted as a Host header (repeatable; config:\n                            insecureHosts). Names the host alone, no port.\n      --profile <name=dir>  Claude config dir a session may run under (repeatable). Declared\n                            this way a profile is fixed: it cannot be changed over the API.\n      --profile-root <path> directory a profile created at runtime may point its config dir at\n                            (repeatable; default: your home directory). Narrow this to pin\n                            exactly which credential stores the dashboard may reach for.\n      --no-profile-store    refuse runtime profile management entirely - /v1/profiles stays\n                            read-only and profiles come from --profile and the config file\n                            alone. Profiles created at runtime are stored in\n                            <state-dir>/profiles.json, so --no-parking-store implies this.\n      --cwd-root <path>     restrict session cwds to this root (repeatable,\n                            WORKERDECK_CWD_ROOTS as a ':'-separated list)\n      --fs-root <path>      narrow which host directories /v1/fs serves\n                            (repeatable, WORKERDECK_FS_ROOTS as a ':'-separated\n                            list). Reading otherwise follows --cwd-root: a caller\n                            who may start a session in a tree can already read it\n                            through the agent. With neither, the routes 404.\n      --fs-write            also accept writes over /v1/fs. Its own switch because\n                            an agent's writes go through the permission flow and a\n                            PUT does not. Every write is still conditional on the\n                            hash the client last read.\n      --shell               let an operator run '!' shell commands on the host from\n                            the composer, in the session's cwd. Off by default and\n                            its own switch: unlike an agent's Bash tool, a '!'\n                            command goes through no permission prompt at all.\n                            Never offered to a scoped principal.\n      --approval-timeout <d>\n                            how long a permission prompt or a question may wait for\n                            an answer before the engine denies it (300000, 30s, 5m;\n                            config: approvalTimeoutMs). Default 'none' - a prompt\n                            waits as long as the session lives. A session may\n                            override it per request.\n      --state-dir <path>    where parked sessions are persisted\n                            (default: beside the config file, else ~/.workerdeck)\n      --no-parking-store    keep parked sessions in memory only; a restart drops them\n  -c, --config <path>       config file (default: ./workerdeck.config.mjs)\n      --insecure            allow no-auth on a non-loopback address. Only when\n                            something in front is doing the authenticating.\n      --cors-origin <o>     browser origin allowed to call /v1 cross-origin, for a\n                            dashboard served elsewhere (repeatable, exact origin, no\n                            wildcard; config: corsOrigins). Refused without auth. The\n                            key is still required - this only permits the call.\n      --no-keep-awake       don't hold the machine awake while a session is waiting\n                            on it (config: keepAwake: false). By default a turn in\n                            flight, or a session blocked on an approval, blocks idle\n                            sleep - a laptop sleeping mid-turn drops the socket and\n                            burns the turn. The screen is never kept on, and the\n                            lock releases the moment nothing is waiting.\n      --no-web              don't serve the web dashboard (config: web: false).\n                            /v1 and the auth routes are unchanged; everything else\n                            404s. For a gateway reached only from the VS Code\n                            extension, the phone, or another host's dashboard.\n      --open                open the dashboard in a browser once it is up\n  -h, --help                show this\n  -v, --version             print the version\n\nConfig file\n  Options that cannot fit on a command line - \\`authenticate\\`, \\`buildRunnerConfig\\`,\n  \\`createEngineRunner\\` are functions - live in workerdeck.config.mjs, which\n  default-exports the createWorkerServer options (or a function returning them).\n  Flags and env override it. Supplying your own \\`authenticate\\` turns the built-in\n  shared-secret auth off entirely.\n\nCredentials\n  workerdeck implements no Anthropic auth of its own: the official SDK/CLI\n  resolves credentials from the environment, per profile. --auth-key protects this\n  gateway, nothing else.\n`\n\nasync function readVersion(): Promise<string> {\n  // src/cli.ts and build/cli.mjs are both one level under the package root.\n  const pkgPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json')\n  try {\n    const raw = await readFile(pkgPath, 'utf8')\n    return (JSON.parse(raw) as { version?: string }).version ?? 'unknown'\n  } catch {\n    return 'unknown'\n  }\n}\n\nfunction openInBrowser(url: string): void {\n  const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open'\n  try {\n    const child = spawn(command, [url], {\n      stdio: 'ignore',\n      detached: true,\n      shell: process.platform === 'win32',\n    })\n    child.on('error', () => {})\n    child.unref()\n  } catch {}\n}\n\nfunction line(text: string): void {\n  process.stdout.write(`${text}\\n`)\n}\n\nasync function main(argv: string[]): Promise<number> {\n  if (argv[0] === 'guard') {\n    const { runGuard } = await import('./lib/guard.ts')\n    return await runGuard(argv.slice(1))\n  }\n\n  const flags = parseArgs(argv)\n  if (flags.help) {\n    process.stdout.write(HELP)\n    return 0\n  }\n  if (flags.version) {\n    process.stdout.write(`${await readVersion()}\\n`)\n    return 0\n  }\n\n  const loaded = await loadConfigFile(flags.config)\n  const config = resolveInstanceConfig(flags, loaded)\n  const instance = await startInstance(config)\n\n  if (config.open) {\n    openInBrowser(instance.url)\n  }\n\n  // A second signal must always be able to kill a shutdown that is taking too long. That used to work only by\n  // accident - the second call re-entered `instance.close()` and got an immediate callback out of an already-closed\n  // http server - so it evaporated the moment close stopped being idempotent-by-luck. Make it a real path.\n  let shuttingDown = false\n  const shutdown = (signal: string): void => {\n    if (shuttingDown) {\n      process.stdout.write(`\\n[workerdeck] ${signal} again - terminating now\\n`)\n      process.exit(130)\n    }\n    shuttingDown = true\n    line(`\\n[workerdeck] ${signal} - shutting down (press again to stop now)`)\n    instance\n      .drain({\n        onProgress: (report) => {\n          if (report.working.length > 0) {\n            line(`[workerdeck] waiting for ${report.working.length} session(s) to finish the current turn`)\n          }\n          // Named, not waited for: nothing about shutting down answers a permission prompt.\n          for (const id of report.awaitingHuman) {\n            line(`[workerdeck] session ${id} is waiting on an approval - not waiting for it`)\n          }\n          if (report.timedOut) {\n            line(`[workerdeck] ${report.working.length} session(s) still running - stopping anyway`)\n          } else if (report.working.length === 0) {\n            line('[workerdeck] all turns finished')\n          }\n        },\n      })\n      .catch(() => undefined)\n      .then(() => instance.close())\n      .then(() => process.exit(0))\n      .catch(() => process.exit(1))\n  }\n  process.on('SIGINT', () => shutdown('SIGINT'))\n  process.on('SIGTERM', () => shutdown('SIGTERM'))\n\n  // Resolves only on close: until then the process stays up, serving.\n  await instance.closed\n  return 0\n}\n\nmain(process.argv.slice(2))\n  .then((code) => {\n    if (code !== 0) {\n      process.exit(code)\n    }\n  })\n  .catch((error: unknown) => {\n    if (error instanceof ConfigError) {\n      process.stderr.write(`[workerdeck] ${error.message}\\n`)\n      process.exit(2)\n    }\n    process.stderr.write(`[workerdeck] ${error instanceof Error ? (error.stack ?? error.message) : String(error)}\\n`)\n    process.exit(1)\n  })\n"],"mappings":"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"}
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/lib/shutdown.ts","../src/cli.ts"],"sourcesContent":["import type { Instance } from './instance.ts'\n\nexport type ShutdownOptions = {\n  // A getter, not an instance: under --hot-reload the instance is replaced on every reload, and a captured one\n  // would drain a server that stopped listening several generations ago.\n  current: () => Instance\n  // Runners this process holds outside any instance, which under --hot-reload is what a failed generation leaves\n  // behind: no registry holds them, so `close()` cannot reach them and nothing else ends their engine children.\n  alsoClose?: () => { close: (reason?: 'client' | 'server' | 'error') => void }[]\n  log?: (text: string) => void\n}\n\nexport function installShutdown({\n  current,\n  alsoClose,\n  log = (text) => void process.stdout.write(`${text}\\n`),\n}: ShutdownOptions): (signal: string) => void {\n  // A second signal must always be able to kill a shutdown that is taking too long. That used to work only by\n  // accident - the second call re-entered `instance.close()` and got an immediate callback out of an already-closed\n  // http server - so it evaporated the moment close stopped being idempotent-by-luck. Make it a real path.\n  let shuttingDown = false\n  const shutdown = (signal: string): void => {\n    if (shuttingDown) {\n      process.stdout.write(`\\n[workerdeck] ${signal} again - terminating now\\n`)\n      process.exit(130)\n    }\n    shuttingDown = true\n    log(`\\n[workerdeck] ${signal} - shutting down (press again to stop now)`)\n    const instance = current()\n    instance\n      .drain({\n        onProgress: (report) => {\n          if (report.working.length > 0) {\n            log(`[workerdeck] waiting for ${report.working.length} session(s) to finish the current turn`)\n          }\n          // Named, not waited for: nothing about shutting down answers a permission prompt.\n          for (const id of report.awaitingHuman) {\n            log(`[workerdeck] session ${id} is waiting on an approval - not waiting for it`)\n          }\n          if (report.timedOut) {\n            log(`[workerdeck] ${report.working.length} session(s) still running - stopping anyway`)\n          } else if (report.working.length === 0) {\n            log('[workerdeck] all turns finished')\n          }\n        },\n      })\n      .catch(() => undefined)\n      .then(() => instance.close())\n      .then(() => {\n        for (const runner of alsoClose?.() ?? []) {\n          runner.close('server')\n        }\n      })\n      .then(() => process.exit(0))\n      .catch(() => process.exit(1))\n  }\n  process.on('SIGINT', () => shutdown('SIGINT'))\n  process.on('SIGTERM', () => shutdown('SIGTERM'))\n  // Returned for the one caller that cannot rely on the signal: a raw-mode TTY delivers ctrl-c as a byte, not SIGINT.\n  return shutdown\n}\n","#!/usr/bin/env node\nimport { spawn } from 'node:child_process'\nimport { readFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { ConfigError, loadConfigFile, parseArgs, resolveInstanceConfig } from './config.ts'\nimport { startInstance } from './lib/instance.ts'\nimport { installShutdown } from './lib/shutdown.ts'\n\nconst HELP = `workerdeck - run a workerdeck instance: session gateway + dashboard, one port.\n\nUsage\n  workerdeck [options]\n  workerdeck guard [options]     check whether it is safe to restart an instance\n  workerdeck reload [options]    hot-reload a gateway started with --hot-reload\n\nOptions\n  -p, --port <n>            port to listen on (default 8787, WORKERDECK_PORT)\n      --host <addr>         interface to bind (default 127.0.0.1, WORKERDECK_HOST)\n      --auth-key <secret>   shared secret, min 12 chars; browsers log in with it,\n                            services send it as x-workerdeck-key\n                            (WORKERDECK_AUTH_KEY). Unset = no auth on loopback;\n                            on any other interface a key is generated instead,\n                            printed once, and stored in <state-dir>/auth-key for\n                            later starts to reuse.\n      --trust-proxy         trust x-forwarded-proto/-host/-for from one reverse\n                            proxy. Required behind TLS termination, or the session\n                            cookie loses its Secure flag and the origin check\n                            computes http:// where the browser says https://.\n      --allowed-origin <o>  extra origin accepted on browser requests, for when a\n                            proxy rewrites Host (repeatable)\n      --allowed-host <name> extra Host header accepted when running without auth\n                            (repeatable; loopback names are always accepted)\n      --insecure-host <name>\n                            bind host that may serve without auth - no key demanded,\n                            none generated - and, while unauthenticated, also\n                            accepted as a Host header (repeatable; config:\n                            insecureHosts). Names the host alone, no port.\n      --profile <name=dir>  Claude config dir a session may run under (repeatable). Declared\n                            this way a profile is fixed: it cannot be changed over the API.\n      --profile-root <path> directory a profile created at runtime may point its config dir at\n                            (repeatable; default: your home directory). Narrow this to pin\n                            exactly which credential stores the dashboard may reach for.\n      --no-profile-store    refuse runtime profile management entirely - /v1/profiles stays\n                            read-only and profiles come from --profile and the config file\n                            alone. Profiles created at runtime are stored in\n                            <state-dir>/profiles.json, so --no-parking-store implies this.\n      --cwd-root <path>     restrict session cwds to this root (repeatable,\n                            WORKERDECK_CWD_ROOTS as a ':'-separated list)\n      --fs-root <path>      narrow which host directories /v1/fs serves\n                            (repeatable, WORKERDECK_FS_ROOTS as a ':'-separated\n                            list). Reading otherwise follows --cwd-root: a caller\n                            who may start a session in a tree can already read it\n                            through the agent. With neither, the routes 404.\n      --fs-write            also accept writes over /v1/fs. Its own switch because\n                            an agent's writes go through the permission flow and a\n                            PUT does not. Every write is still conditional on the\n                            hash the client last read.\n      --shell               let an operator run '!' shell commands on the host from\n                            the composer, in the session's cwd. Off by default and\n                            its own switch: unlike an agent's Bash tool, a '!'\n                            command goes through no permission prompt at all.\n                            Never offered to a scoped principal.\n      --approval-timeout <d>\n                            how long a permission prompt or a question may wait for\n                            an answer before the engine denies it (300000, 30s, 5m;\n                            config: approvalTimeoutMs). Default 'none' - a prompt\n                            waits as long as the session lives. A session may\n                            override it per request.\n      --state-dir <path>    where parked sessions are persisted\n                            (default: beside the config file, else ~/.workerdeck)\n      --no-parking-store    keep parked sessions in memory only; a restart drops them\n  -c, --config <path>       config file (default: ./workerdeck.config.mjs)\n      --insecure            allow no-auth on a non-loopback address. Only when\n                            something in front is doing the authenticating.\n      --cors-origin <o>     browser origin allowed to call /v1 cross-origin, for a\n                            dashboard served elsewhere (repeatable, exact origin, no\n                            wildcard; config: corsOrigins). Refused without auth. The\n                            key is still required - this only permits the call.\n      --no-keep-awake       don't hold the machine awake while a session is waiting\n                            on it (config: keepAwake: false). By default a turn in\n                            flight, or a session blocked on an approval, blocks idle\n                            sleep - a laptop sleeping mid-turn drops the socket and\n                            burns the turn. The screen is never kept on, and the\n                            lock releases the moment nothing is waiting.\n      --no-web              don't serve the web dashboard (config: web: false).\n                            /v1 and the auth routes are unchanged; everything else\n                            404s. For a gateway reached only from the VS Code\n                            extension, the phone, or another host's dashboard.\n      --open                open the dashboard in a browser once it is up\n      --hot-reload          dev only: re-evaluate the gateway's own source in place on\n                            ctrl-r, SIGUSR2 or \\`workerdeck reload\\`, carrying live\n                            sessions and their engine child processes across the swap.\n                            Needs a source checkout; the published CLI is one bundled\n                            file with nothing to swap.\n  -h, --help                show this\n  -v, --version             print the version\n\nConfig file\n  Options that cannot fit on a command line - \\`authenticate\\`, \\`buildRunnerConfig\\`,\n  \\`createEngineRunner\\` are functions - live in workerdeck.config.mjs, which\n  default-exports the createWorkerServer options (or a function returning them).\n  Flags and env override it. Supplying your own \\`authenticate\\` turns the built-in\n  shared-secret auth off entirely.\n\nCredentials\n  workerdeck implements no Anthropic auth of its own: the official SDK/CLI\n  resolves credentials from the environment, per profile. --auth-key protects this\n  gateway, nothing else.\n`\n\nasync function readVersion(): Promise<string> {\n  // src/cli.ts and build/cli.mjs are both one level under the package root.\n  const pkgPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json')\n  try {\n    const raw = await readFile(pkgPath, 'utf8')\n    return (JSON.parse(raw) as { version?: string }).version ?? 'unknown'\n  } catch {\n    return 'unknown'\n  }\n}\n\nfunction openInBrowser(url: string): void {\n  const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open'\n  try {\n    const child = spawn(command, [url], {\n      stdio: 'ignore',\n      detached: true,\n      shell: process.platform === 'win32',\n    })\n    child.on('error', () => {})\n    child.unref()\n  } catch {}\n}\n\nfunction line(text: string): void {\n  process.stdout.write(`${text}\\n`)\n}\n\nasync function main(argv: string[]): Promise<number> {\n  if (argv[0] === 'reload') {\n    const { runReload } = await import('./dev/reload-command.ts')\n    return await runReload(argv.slice(1))\n  }\n\n  if (argv[0] === 'guard') {\n    const { runGuard } = await import('./lib/guard.ts')\n    return await runGuard(argv.slice(1))\n  }\n\n  const flags = parseArgs(argv)\n  if (flags.help) {\n    process.stdout.write(HELP)\n    return 0\n  }\n  if (flags.version) {\n    process.stdout.write(`${await readVersion()}\\n`)\n    return 0\n  }\n\n  if (flags.hotReload) {\n    const { runHotReload } = await import('./dev/hot-reload.ts')\n    const result = await runHotReload(flags)\n    if (result !== 'unsupported') {\n      return result\n    }\n  }\n\n  const loaded = await loadConfigFile(flags.config)\n  const config = resolveInstanceConfig(flags, loaded)\n  const instance = await startInstance(config)\n\n  if (config.open) {\n    openInBrowser(instance.url)\n  }\n\n  installShutdown({ current: () => instance, log: line })\n\n  // Resolves only on close: until then the process stays up, serving.\n  await instance.closed\n  return 0\n}\n\nmain(process.argv.slice(2))\n  .then((code) => {\n    if (code !== 0) {\n      process.exit(code)\n    }\n  })\n  .catch((error: unknown) => {\n    if (error instanceof ConfigError) {\n      process.stderr.write(`[workerdeck] ${error.message}\\n`)\n      process.exit(2)\n    }\n    process.stderr.write(`[workerdeck] ${error instanceof Error ? (error.stack ?? error.message) : String(error)}\\n`)\n    process.exit(1)\n  })\n"],"mappings":"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"}

package/build/hot-reload-CfP94v9Y.mjs

@@ -0,0 +1,152 @@
+import { t as installShutdown } from "./cli.mjs";
+import * as nodeModule from "node:module";
+import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { createFileSessionStore, isDormant, reloadPlan } from "@workerdeck/server";
+import { fileURLToPath, pathToFileURL } from "node:url";
+//#region src/dev/hot-reload.ts
+const here = fileURLToPath(import.meta.url);
+const packagesDir = resolve(dirname(here), "..", "..", "..");
+const CTRL_C = "";
+const CTRL_R = "";
+function line(text) {
+	process.stdout.write(`${text}\n`);
+}
+async function persistProvider(parking, runner) {
+	let how = "kept";
+	if (!runner.snapshot?.()) {
+		await runner.interrupt();
+		how = "interrupted";
+	}
+	const before = Date.now();
+	parking.touch(runner);
+	await parking.flush(runner.id);
+	const record = await parking.get(runner.id);
+	return record && !isDormant(record) && record.parkedAt >= before ? how : "lost";
+}
+async function runHotReload(flags) {
+	if (!here.endsWith(".ts") || !existsSync(join(packagesDir, "server", "src"))) {
+		process.stderr.write("[workerdeck] --hot-reload needs a source checkout; this build is one bundled file with nothing to swap.\n            Serving without it. Run it as `pnpm cli --hot-reload` from the repo instead.\n");
+		return "unsupported";
+	}
+	const registerHooks = nodeModule.registerHooks;
+	if (!registerHooks) {
+		process.stderr.write("[workerdeck] --hot-reload needs `module.registerHooks`, which this runtime does not provide (Node 22.15+).\n            Serving without it.\n");
+		return "unsupported";
+	}
+	const packagesUrl = `${pathToFileURL(packagesDir).href}/`;
+	let generation = 0;
+	registerHooks({ resolve(specifier, context, nextResolve) {
+		const result = nextResolve(specifier, context);
+		if (generation === 0 || typeof result.url !== "string") return result;
+		if (!result.url.startsWith(packagesUrl) || result.url.includes("/node_modules/")) return result;
+		return {
+			...result,
+			url: `${result.url}${result.url.includes("?") ? "&" : "?"}wdgen=${generation}`
+		};
+	} });
+	let baseStore;
+	let stateDir = null;
+	let pidPath;
+	const start = async (carried) => {
+		const config = await import(`${packagesUrl}cli/src/config.ts`);
+		const lib = await import(`${packagesUrl}cli/src/lib/instance.ts`);
+		const loaded = await config.loadConfigFile(flags.config);
+		const resolved = config.resolveInstanceConfig(flags, loaded);
+		stateDir = resolved.stateDir;
+		if (resolved.stateDir && !resolved.options.parking?.store) baseStore ??= createFileSessionStore({ dir: join(resolved.stateDir, "parked") });
+		resolved.options.parking = {
+			...resolved.options.parking,
+			...baseStore ? { store: baseStore } : {},
+			persistLive: true
+		};
+		return await lib.startInstance(resolved, {
+			quiet: generation > 0,
+			carried
+		});
+	};
+	let instance = await start([]);
+	let orphans = [];
+	if (stateDir) {
+		pidPath = join(stateDir, "gateway.pid");
+		mkdirSync(stateDir, { recursive: true });
+		writeFileSync(pidPath, `${process.pid}\n`);
+		process.on("exit", () => {
+			try {
+				rmSync(pidPath);
+			} catch {}
+		});
+	}
+	let reloading = false;
+	const reload = async (trigger) => {
+		if (reloading) return;
+		reloading = true;
+		const started = Date.now();
+		const persisted = [];
+		const dropped = [];
+		try {
+			const carry = [];
+			const persist = [];
+			for (const info of instance.server.registry.list()) {
+				const runner = instance.server.registry.get(info.id);
+				if (!runner) continue;
+				const plan = reloadPlan(runner);
+				if (plan === "carry") carry.push(runner.id);
+				else if (plan === "persist") persist.push(runner);
+				else dropped.push(runner.id);
+			}
+			for (const runner of persist) persisted.push(`${runner.id} (${await persistProvider(instance.server.parking, runner)})`);
+			await instance.server.parking.flush();
+			for (const id of carry) {
+				const released = instance.server.releaseSession(id);
+				if (released) orphans.push(released);
+			}
+			await instance.close();
+			generation += 1;
+			instance = await start(orphans);
+			const adopted = new Set(instance.adopted);
+			const ended = orphans.filter((carried) => !adopted.has(carried.runner.id)).map((carried) => carried.runner.id);
+			orphans = [];
+			line(`[workerdeck] reloaded on ${trigger}: gen ${generation} in ${Date.now() - started}ms, ${adopted.size} carried${persisted.length ? `, persisted ${persisted.join(", ")}` : ""}${dropped.length ? `, dropped ${dropped.join(", ")}` : ""}${ended.length ? `, ended while held ${ended.join(", ")}` : ""}`);
+		} catch (error) {
+			line(`[workerdeck] reload failed at gen ${generation}: ${error instanceof Error ? error.message : String(error)}`);
+			if (orphans.length > 0) {
+				line(`[workerdeck] holding ${orphans.length} session(s): ${orphans.map((carried) => carried.runner.id).join(", ")}`);
+				line("[workerdeck] their turns keep running and their transcripts are buffered, but nothing can attach and");
+				line("[workerdeck] no push or webhook goes out until a generation starts. Fix the error and reload again,");
+				line("[workerdeck] or ctrl-c to stop (the sessions close; their records are kept).");
+			}
+		} finally {
+			reloading = false;
+		}
+	};
+	const shutdown = installShutdown({
+		current: () => instance,
+		alsoClose: () => orphans.map((carried) => carried.runner),
+		log: line
+	});
+	process.on("SIGUSR2", () => void reload("SIGUSR2"));
+	if (process.stdin.isTTY) {
+		process.stdin.setRawMode(true);
+		process.stdin.resume();
+		process.stdin.setEncoding("utf8");
+		process.stdin.on("data", (key) => {
+			if (key === CTRL_R) {
+				reload("ctrl-r");
+				return;
+			}
+			if (key === CTRL_C) shutdown("SIGINT");
+		});
+		process.on("exit", () => {
+			if (process.stdin.isTTY) process.stdin.setRawMode(false);
+		});
+	}
+	line(`  hot reload: ctrl-r${pidPath ? ", `workerdeck reload`" : ""}, or SIGUSR2 to pid ${process.pid}`);
+	line("");
+	await new Promise(() => {});
+	return 0;
+}
+//#endregion
+export { runHotReload };
+
+//# sourceMappingURL=hot-reload-CfP94v9Y.mjs.map

package/build/hot-reload-CfP94v9Y.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hot-reload-CfP94v9Y.mjs","names":[],"sources":["../src/dev/hot-reload.ts"],"sourcesContent":["import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs'\nimport * as nodeModule from 'node:module'\nimport { dirname, join, resolve } from 'node:path'\nimport { fileURLToPath, pathToFileURL } from 'node:url'\nimport { createFileSessionStore, isDormant, reloadPlan, type CarriedSession, type SessionStore } from '@workerdeck/server'\nimport type { CliFlags } from '../config.ts'\nimport type { Instance } from '../lib/instance.ts'\nimport { installShutdown } from '../lib/shutdown.ts'\n\ntype Registry = Instance['server']['registry']\ntype CarriedRunner = NonNullable<ReturnType<Registry['get']>>\ntype Parking = Instance['server']['parking']\n\nconst here = fileURLToPath(import.meta.url)\nconst packagesDir = resolve(dirname(here), '..', '..', '..')\n\nconst CTRL_C = '\\u0003'\nconst CTRL_R = '\\u0012'\n\nfunction line(text: string): void {\n  process.stdout.write(`${text}\\n`)\n}\n\n// A provider session is never carried by identity: its executors close over the generation's bridge hub, so a\n// carried one fails every LATER bridged call with no_client while a client is attached, not merely the one in\n// flight. It takes the ordinary restart path instead, which needs its snapshot on disk before the close.\n// `snapshot()` is side-effect free, so probing it is how we learn whether an interrupt is owed.\nasync function persistProvider(parking: Parking, runner: CarriedRunner): Promise<'kept' | 'interrupted' | 'lost'> {\n  let how: 'kept' | 'interrupted' = 'kept'\n  if (!runner.snapshot?.()) {\n    // The documented way out of every state snapshot refuses: it aborts the model call, settles pending executions\n    // as interrupted and emits the failed turn_result whose write-through then runs.\n    await runner.interrupt()\n    how = 'interrupted'\n  }\n  const before = Date.now()\n  parking.touch(runner)\n  await parking.flush(runner.id)\n  const record = await parking.get(runner.id)\n  return record && !isDormant(record) && record.parkedAt >= before ? how : 'lost'\n}\n\n// Runs the gateway inside a shell that can re-evaluate every module under `packages/` in place, carrying the live\n// runners - and therefore their engine child processes, subagents and shell grandchildren - across the swap.\n// Dev only: the published CLI is a single bundled file with no subgraph to re-evaluate.\n//\n// `unsupported` rather than a throw: the flag reaches this CLI from a VS Code setting and a config file as well as\n// from a keyboard, and a gateway that refuses to start because one dev convenience is unavailable is the worse\n// failure. The caller serves without it and says so.\nexport async function runHotReload(flags: CliFlags): Promise<number | 'unsupported'> {\n  if (!here.endsWith('.ts') || !existsSync(join(packagesDir, 'server', 'src'))) {\n    process.stderr.write(\n      '[workerdeck] --hot-reload needs a source checkout; this build is one bundled file with nothing to swap.\\n' +\n        '            Serving without it. Run it as `pnpm cli --hot-reload` from the repo instead.\\n',\n    )\n    return 'unsupported'\n  }\n\n  // A namespace lookup, not a named import: `registerHooks` landed in Node 22.15, and a runtime without it (an\n  // older Node, or Bun) must reach the unsupported path below rather than fail to load this module at all.\n  const registerHooks = (nodeModule as Partial<typeof nodeModule>).registerHooks\n  if (!registerHooks) {\n    process.stderr.write(\n      '[workerdeck] --hot-reload needs `module.registerHooks`, which this runtime does not provide (Node 22.15+).\\n' +\n        '            Serving without it.\\n',\n    )\n    return 'unsupported'\n  }\n\n  const packagesUrl = `${pathToFileURL(packagesDir).href}/`\n  let generation = 0\n\n  // Only our own sources are versioned. node_modules stays at one copy per package on purpose: a second Agent SDK,\n  // a second `ws`, or a second quickjs would each be a different kind of disaster.\n  registerHooks({\n    resolve(specifier, context, nextResolve) {\n      const result = nextResolve(specifier, context)\n      if (generation === 0 || typeof result.url !== 'string') {\n        return result\n      }\n      if (!result.url.startsWith(packagesUrl) || result.url.includes('/node_modules/')) {\n        return result\n      }\n      return { ...result, url: `${result.url}${result.url.includes('?') ? '&' : '?'}wdgen=${generation}` }\n    },\n  })\n\n  let baseStore: SessionStore | undefined\n  let stateDir: string | null = null\n  let pidPath: string | undefined\n\n  const start = async (carried: CarriedSession[]): Promise<Instance> => {\n    const config = (await import(`${packagesUrl}cli/src/config.ts`)) as typeof import('../config.ts')\n    const lib = (await import(`${packagesUrl}cli/src/lib/instance.ts`)) as typeof import('../lib/instance.ts')\n    const loaded = await config.loadConfigFile(flags.config)\n    const resolved = config.resolveInstanceConfig(flags, loaded)\n    stateDir = resolved.stateDir\n    // One store object for the whole process. A file store is single-process by contract, and two generations\n    // holding two of them over one directory is exactly the two-servers-one-directory case it refuses to be; an\n    // in-memory one is worse, because a reload would drop every record it holds.\n    if (resolved.stateDir && !resolved.options.parking?.store) {\n      baseStore ??= createFileSessionStore({ dir: join(resolved.stateDir, 'parked') })\n    }\n    resolved.options.parking = {\n      ...resolved.options.parking,\n      ...(baseStore ? { store: baseStore } : {}),\n      // Forced: the seam persists provider sessions rather than carrying them, and without this their snapshots\n      // are never written, so a reload would end them.\n      persistLive: true,\n    }\n    return await lib.startInstance(resolved, { quiet: generation > 0, carried })\n  }\n\n  let instance = await start([])\n  let orphans: CarriedSession[] = []\n\n  if (stateDir) {\n    pidPath = join(stateDir, 'gateway.pid')\n    // The state dir is created lazily by whoever writes into it first, and on a cold one that is nobody yet.\n    mkdirSync(stateDir, { recursive: true })\n    writeFileSync(pidPath, `${process.pid}\\n`)\n    process.on('exit', () => {\n      try {\n        rmSync(pidPath!)\n      } catch {}\n    })\n  }\n\n  let reloading = false\n  const reload = async (trigger: string): Promise<void> => {\n    if (reloading) {\n      return\n    }\n    reloading = true\n    const started = Date.now()\n    const persisted: string[] = []\n    const dropped: string[] = []\n    try {\n      // One synchronous pass, because every later step keys off this classification and `info()` is synchronous.\n      const carry: string[] = []\n      const persist: CarriedRunner[] = []\n      for (const info of instance.server.registry.list()) {\n        const runner = instance.server.registry.get(info.id)\n        if (!runner) {\n          continue\n        }\n        const plan = reloadPlan(runner)\n        if (plan === 'carry') {\n          carry.push(runner.id)\n        } else if (plan === 'persist') {\n          persist.push(runner)\n        } else {\n          dropped.push(runner.id)\n        }\n      }\n\n      // While this generation still owns them: `touch()` writes nothing for a runner its registry does not hold.\n      for (const runner of persist) {\n        persisted.push(`${runner.id} (${await persistProvider(instance.server.parking, runner)})`)\n      }\n      // Both halves matter: this generation's queued writes must land before `close()` skips them, and two managers\n      // in one process share the file store's `${path}.${pid}.tmp`, so their writes must never overlap.\n      await instance.server.parking.flush()\n\n      for (const id of carry) {\n        const released = instance.server.releaseSession(id)\n        if (released) {\n          orphans.push(released)\n        }\n      }\n      await instance.close()\n      generation += 1\n      instance = await start(orphans)\n      const adopted = new Set(instance.adopted)\n      const ended = orphans.filter((carried) => !adopted.has(carried.runner.id)).map((carried) => carried.runner.id)\n      orphans = []\n      line(\n        `[workerdeck] reloaded on ${trigger}: gen ${generation} in ${Date.now() - started}ms, ` +\n          `${adopted.size} carried${persisted.length ? `, persisted ${persisted.join(', ')}` : ''}` +\n          `${dropped.length ? `, dropped ${dropped.join(', ')}` : ''}${ended.length ? `, ended while held ${ended.join(', ')}` : ''}`,\n      )\n    } catch (error) {\n      line(`[workerdeck] reload failed at gen ${generation}: ${error instanceof Error ? error.message : String(error)}`)\n      if (orphans.length > 0) {\n        line(`[workerdeck] holding ${orphans.length} session(s): ${orphans.map((carried) => carried.runner.id).join(', ')}`)\n        line('[workerdeck] their turns keep running and their transcripts are buffered, but nothing can attach and')\n        line('[workerdeck] no push or webhook goes out until a generation starts. Fix the error and reload again,')\n        line('[workerdeck] or ctrl-c to stop (the sessions close; their records are kept).')\n      }\n    } finally {\n      reloading = false\n    }\n  }\n\n  const shutdown = installShutdown({\n    current: () => instance,\n    // Held across a failed generation, so no registry holds them and `close()` cannot reach them. Nothing else\n    // would end their engine children promptly.\n    alsoClose: () => orphans.map((carried) => carried.runner),\n    log: line,\n  })\n\n  process.on('SIGUSR2', () => void reload('SIGUSR2'))\n  if (process.stdin.isTTY) {\n    process.stdin.setRawMode(true)\n    process.stdin.resume()\n    process.stdin.setEncoding('utf8')\n    process.stdin.on('data', (key: string) => {\n      if (key === CTRL_R) {\n        void reload('ctrl-r')\n        return\n      }\n      // Raw mode swallows SIGINT, so ctrl-c arrives as a byte and has to be re-spelled as the shutdown it was.\n      if (key === CTRL_C) {\n        shutdown('SIGINT')\n      }\n    })\n    process.on('exit', () => {\n      if (process.stdin.isTTY) {\n        process.stdin.setRawMode(false)\n      }\n    })\n  }\n\n  line(`  hot reload: ctrl-r${pidPath ? ', `workerdeck reload`' : ''}, or SIGUSR2 to pid ${process.pid}`)\n  line('')\n\n  // Never resolves: every exit from here runs through `installShutdown`, which closes the current instance and\n  // exits. Awaiting `instance.closed` instead would return the moment a reload closed the generation it captured.\n  await new Promise<void>(() => {})\n  return 0\n}\n"],"mappings":"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"}

package/build/index.d.mts

@@ -1,4 +1,4 @@
-import { Authenticator, WorkerServer, WorkerServerOptions } from "@workerdeck/server";
+import { Authenticator, CarriedSession, WorkerServer, WorkerServerOptions } from "@workerdeck/server";
 import { KeyObject } from "node:crypto";
 import { ProfileInfo, SessionNotification, SessionNotificationType } from "@workerdeck/protocol";
 import { IncomingMessage, ServerResponse } from "node:http";
@@ -117,6 +117,7 @@ type CliFlags = {
   keepAwake?: boolean;
   corsOrigins: string[];
   open?: boolean;
+  hotReload?: boolean;
   help?: boolean;
   version?: boolean;
 };
@@ -153,8 +154,13 @@ declare function isLoopbackHostname(hostname: string): boolean;
 declare function resolveInstanceConfig(flags: CliFlags, loaded: LoadedConfig, env?: NodeJS.ProcessEnv, cwd?: string): ResolvedConfig;
 //#endregion
 //#region src/lib/instance.d.ts
+type StartOptions = {
+  quiet?: boolean;
+  carried?: CarriedSession[];
+};
 type Instance = {
   server: WorkerServer;
+  adopted: string[];
   url: string;
   port: number;
   closed: Promise<void>;
@@ -163,9 +169,7 @@ type Instance = {
 };
 declare function resolveWebRoot(): string;
 declare function createHostGuard(allowedHosts: Set<string> | null): (req: IncomingMessage) => boolean;
-declare function startInstance(config: ResolvedConfig, options?: {
-  quiet?: boolean;
-}): Promise<Instance>;
+declare function startInstance(config: ResolvedConfig, options?: StartOptions): Promise<Instance>;
 //#endregion
 //#region src/lib/guard.d.ts
 declare function runGuard(argv: string[]): Promise<number>;

package/build/index.mjs

@@ -1,3 +1,3 @@
 import { n as runGuard } from "./guard-C4ybpzbt.mjs";
-import { C as createActivityRegistry, S as createDeviceRoute, _ as createApnsForwarder, a as ConfigError, b as createApnsRoute, c as isLoopback, d as parseArgs, f as resolveInstanceConfig, g as buildPush, h as materializeAuthKey, i as renderLoginPage, l as isLoopbackHostname, m as createAuthSessionStore, n as resolveWebRoot, o as defaultStateDir, p as createCliAuth, r as startInstance, s as hostnameOf, t as createHostGuard, u as loadConfigFile, v as createApnsClient, w as createActivityRoute, x as createDeviceRegistry, y as loadApnsKey } from "./instance-BhSGGmoY.mjs";
+import { C as createActivityRegistry, S as createDeviceRoute, _ as createApnsForwarder, a as ConfigError, b as createApnsRoute, c as isLoopback, d as parseArgs, f as resolveInstanceConfig, g as buildPush, h as materializeAuthKey, i as renderLoginPage, l as isLoopbackHostname, m as createAuthSessionStore, n as resolveWebRoot, o as defaultStateDir, p as createCliAuth, r as startInstance, s as hostnameOf, t as createHostGuard, u as loadConfigFile, v as createApnsClient, w as createActivityRoute, x as createDeviceRegistry, y as loadApnsKey } from "./instance-vQe2VlGq.mjs";
 export { ConfigError, buildPush, createActivityRegistry, createActivityRoute, createApnsClient, createApnsForwarder, createApnsRoute, createAuthSessionStore, createCliAuth, createDeviceRegistry, createDeviceRoute, createHostGuard, defaultStateDir, hostnameOf, isLoopback, isLoopbackHostname, loadApnsKey, loadConfigFile, materializeAuthKey, parseArgs, renderLoginPage, resolveInstanceConfig, resolveWebRoot, runGuard, startInstance };

package/build/{instance-BhSGGmoY.mjs → instance-vQe2VlGq.mjs}

@@ -1803,6 +1803,9 @@ function parseArgs(argv) {
 			case "--open":
 				flags.open = true;
 				break;
+			case "--hot-reload":
+				flags.hotReload = true;
+				break;
 			default: throw new ConfigError(`unknown option: ${arg}`);
 		}
 	}
@@ -2071,11 +2074,9 @@ function lockCommand(pid) {
 }
 function driveWakeLock(source, lock) {
 	const sync = () => lock.set(sessionsNeedTheMachine(source.list()));
-	source.observe((runner) => {
-		runner.subscribe((event) => {
-			if (event.type === "status_changed" || event.type === "session_closed" || event.type === "session_error") sync();
-		}, runner.info().lastSeq);
-	});
+	source.observe((runner) => runner.subscribe((event) => {
+		if (event.type === "status_changed" || event.type === "session_closed" || event.type === "session_error") sync();
+	}, runner.info().lastSeq));
 	sync();
 }
 function createWakeLock(options = {}) {
@@ -2335,7 +2336,16 @@ async function startInstance(config, options = {}) {
 			target: apns.activity
 		});
 	}
-	const { port } = await server.listen(config.port, config.host);
+	const adopted = [];
+	for (const carried of options.carried ?? []) if (server.adoptSession(carried)) adopted.push(carried);
+	let port;
+	try {
+		({port} = await server.listen(config.port, config.host));
+	} catch (error) {
+		for (const carried of adopted) server.releaseSession(carried.runner.id);
+		await server.close();
+		throw error;
+	}
 	const displayHost = config.host === "0.0.0.0" || config.host === "::" ? "localhost" : config.host;
 	const url = `http://${displayHost.includes(":") ? `[${displayHost}]` : displayHost}:${port}`;
 	let resolveClosed = () => {};
@@ -2370,6 +2380,7 @@ async function startInstance(config, options = {}) {
 	}
 	return {
 		server,
+		adopted: adopted.map((carried) => carried.runner.id),
 		url,
 		port,
 		closed,
@@ -2389,4 +2400,4 @@ async function startInstance(config, options = {}) {
 //#endregion
 export { createActivityRegistry as C, createDeviceRoute as S, createApnsForwarder as _, ConfigError as a, createApnsRoute as b, isLoopback as c, parseArgs as d, resolveInstanceConfig as f, buildPush as g, materializeAuthKey as h, renderLoginPage as i, isLoopbackHostname as l, createAuthSessionStore as m, resolveWebRoot as n, defaultStateDir as o, createCliAuth as p, startInstance as r, hostnameOf as s, createHostGuard as t, loadConfigFile as u, createApnsClient as v, createActivityRoute as w, createDeviceRegistry as x, loadApnsKey as y };
 
-//# sourceMappingURL=instance-BhSGGmoY.mjs.map
+//# sourceMappingURL=instance-vQe2VlGq.mjs.map