@dfosco/storyboard 0.5.0-alpha.21 → 0.5.0-alpha.22

package/dist/runtime/api-Bbh7Mcv9.d.ts

@@ -0,0 +1,305 @@
+import { z } from 'zod';
+
+/**
+ * `POST /devserver/acquire` — request a devserver for a `(devDomain, worktree)` slot.
+ *
+ * If a devserver already exists for the slot, the runtime returns its existing
+ * lease (renewed). Otherwise it either rents a hot-pool member or spawns a new
+ * Vite process. The slot is locked for the duration of the call.
+ */
+declare const AcquireRequest: z.ZodObject<{
+    slot: z.ZodObject<{
+        devDomain: z.ZodBranded<z.ZodString, "DevDomain">;
+        worktree: z.ZodBranded<z.ZodString, "WorktreeName">;
+    }, "strip", z.ZodTypeAny, {
+        devDomain?: string & z.BRAND<"DevDomain">;
+        worktree?: string & z.BRAND<"WorktreeName">;
+    }, {
+        devDomain?: string;
+        worktree?: string;
+    }>;
+    /** Absolute path of the worktree directory; the runtime spawns Vite with `cwd: targetCwd`. */
+    targetCwd: z.ZodString;
+    /** Lease TTL in seconds. Defaults to 5 min; CLI clients renew on each command. */
+    ttlSeconds: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Escape hatch for the deprecated default devDomain `"storyboard"`. CI and
+     * one-off scripts may pass true; the CLI never does.
+     */
+    allowDefaultDomain: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    slot?: {
+        devDomain?: string & z.BRAND<"DevDomain">;
+        worktree?: string & z.BRAND<"WorktreeName">;
+    };
+    targetCwd?: string;
+    ttlSeconds?: number;
+    allowDefaultDomain?: boolean;
+}, {
+    slot?: {
+        devDomain?: string;
+        worktree?: string;
+    };
+    targetCwd?: string;
+    ttlSeconds?: number;
+    allowDefaultDomain?: boolean;
+}>;
+type AcquireRequest = z.infer<typeof AcquireRequest>;
+declare const AcquireResponse: z.ZodObject<{
+    lease: z.ZodObject<{
+        id: z.ZodString;
+        devServerId: z.ZodString;
+        slot: z.ZodObject<{
+            devDomain: z.ZodBranded<z.ZodString, "DevDomain">;
+            worktree: z.ZodBranded<z.ZodString, "WorktreeName">;
+        }, "strip", z.ZodTypeAny, {
+            devDomain?: string & z.BRAND<"DevDomain">;
+            worktree?: string & z.BRAND<"WorktreeName">;
+        }, {
+            devDomain?: string;
+            worktree?: string;
+        }>;
+        url: z.ZodString;
+        expiresAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id?: string;
+        slot?: {
+            devDomain?: string & z.BRAND<"DevDomain">;
+            worktree?: string & z.BRAND<"WorktreeName">;
+        };
+        devServerId?: string;
+        url?: string;
+        expiresAt?: string;
+    }, {
+        id?: string;
+        slot?: {
+            devDomain?: string;
+            worktree?: string;
+        };
+        devServerId?: string;
+        url?: string;
+        expiresAt?: string;
+    }>;
+    devServer: z.ZodObject<{
+        id: z.ZodString;
+        pid: z.ZodNumber;
+        port: z.ZodBranded<z.ZodNumber, "Port">;
+        status: z.ZodEnum<["idle", "spawning", "ready", "draining", "stopped"]>;
+        slot: z.ZodNullable<z.ZodObject<{
+            devDomain: z.ZodBranded<z.ZodString, "DevDomain">;
+            worktree: z.ZodBranded<z.ZodString, "WorktreeName">;
+        }, "strip", z.ZodTypeAny, {
+            devDomain?: string & z.BRAND<"DevDomain">;
+            worktree?: string & z.BRAND<"WorktreeName">;
+        }, {
+            devDomain?: string;
+            worktree?: string;
+        }>>;
+        cwd: z.ZodNullable<z.ZodString>;
+        spawnedAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status?: "idle" | "spawning" | "ready" | "draining" | "stopped";
+        id?: string;
+        pid?: number;
+        port?: number & z.BRAND<"Port">;
+        slot?: {
+            devDomain?: string & z.BRAND<"DevDomain">;
+            worktree?: string & z.BRAND<"WorktreeName">;
+        };
+        cwd?: string;
+        spawnedAt?: string;
+        updatedAt?: string;
+    }, {
+        status?: "idle" | "spawning" | "ready" | "draining" | "stopped";
+        id?: string;
+        pid?: number;
+        port?: number;
+        slot?: {
+            devDomain?: string;
+            worktree?: string;
+        };
+        cwd?: string;
+        spawnedAt?: string;
+        updatedAt?: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    lease?: {
+        id?: string;
+        slot?: {
+            devDomain?: string & z.BRAND<"DevDomain">;
+            worktree?: string & z.BRAND<"WorktreeName">;
+        };
+        devServerId?: string;
+        url?: string;
+        expiresAt?: string;
+    };
+    devServer?: {
+        status?: "idle" | "spawning" | "ready" | "draining" | "stopped";
+        id?: string;
+        pid?: number;
+        port?: number & z.BRAND<"Port">;
+        slot?: {
+            devDomain?: string & z.BRAND<"DevDomain">;
+            worktree?: string & z.BRAND<"WorktreeName">;
+        };
+        cwd?: string;
+        spawnedAt?: string;
+        updatedAt?: string;
+    };
+}, {
+    lease?: {
+        id?: string;
+        slot?: {
+            devDomain?: string;
+            worktree?: string;
+        };
+        devServerId?: string;
+        url?: string;
+        expiresAt?: string;
+    };
+    devServer?: {
+        status?: "idle" | "spawning" | "ready" | "draining" | "stopped";
+        id?: string;
+        pid?: number;
+        port?: number;
+        slot?: {
+            devDomain?: string;
+            worktree?: string;
+        };
+        cwd?: string;
+        spawnedAt?: string;
+        updatedAt?: string;
+    };
+}>;
+type AcquireResponse = z.infer<typeof AcquireResponse>;
+/** `POST /devserver/release` — relinquish the lease and trigger draining. */
+declare const ReleaseRequest: z.ZodObject<{
+    leaseId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    leaseId?: string;
+}, {
+    leaseId?: string;
+}>;
+type ReleaseRequest = z.infer<typeof ReleaseRequest>;
+/** `POST /devserver/renew` — extend the lease without changing devserver state. */
+declare const RenewRequest: z.ZodObject<{
+    leaseId: z.ZodString;
+    ttlSeconds: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    ttlSeconds?: number;
+    leaseId?: string;
+}, {
+    ttlSeconds?: number;
+    leaseId?: string;
+}>;
+type RenewRequest = z.infer<typeof RenewRequest>;
+/** `GET /proxy/state` — current routing table the runtime believes Caddy holds. */
+declare const ProxyState: z.ZodObject<{
+    routes: z.ZodArray<z.ZodObject<{
+        devDomain: z.ZodBranded<z.ZodString, "DevDomain">;
+        host: z.ZodString;
+        upstreams: z.ZodRecord<z.ZodString, z.ZodBranded<z.ZodNumber, "Port">>;
+    }, "strip", z.ZodTypeAny, {
+        devDomain?: string & z.BRAND<"DevDomain">;
+        host?: string;
+        upstreams?: Record<string, number & z.BRAND<"Port">>;
+    }, {
+        devDomain?: string;
+        host?: string;
+        upstreams?: Record<string, number>;
+    }>, "many">;
+    caddyReachable: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    routes?: {
+        devDomain?: string & z.BRAND<"DevDomain">;
+        host?: string;
+        upstreams?: Record<string, number & z.BRAND<"Port">>;
+    }[];
+    caddyReachable?: boolean;
+}, {
+    routes?: {
+        devDomain?: string;
+        host?: string;
+        upstreams?: Record<string, number>;
+    }[];
+    caddyReachable?: boolean;
+}>;
+type ProxyState = z.infer<typeof ProxyState>;
+/** `GET /pool/status` — hot-pool inventory. */
+declare const PoolStatus: z.ZodObject<{
+    warm: z.ZodNumber;
+    bound: z.ZodNumber;
+    capacity: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    warm?: number;
+    bound?: number;
+    capacity?: number;
+}, {
+    warm?: number;
+    bound?: number;
+    capacity?: number;
+}>;
+type PoolStatus = z.infer<typeof PoolStatus>;
+/** `POST /proxy/upsert` — bind (devDomain, worktree) → port in the proxy. */
+declare const ProxyUpsertRequest: z.ZodObject<{
+    devDomain: z.ZodString;
+    worktree: z.ZodString;
+    port: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    devDomain?: string;
+    worktree?: string;
+    port?: number;
+}, {
+    devDomain?: string;
+    worktree?: string;
+    port?: number;
+}>;
+type ProxyUpsertRequest = z.infer<typeof ProxyUpsertRequest>;
+/** `POST /proxy/remove` — drop a worktree's route from the proxy. */
+declare const ProxyRemoveRequest: z.ZodObject<{
+    devDomain: z.ZodString;
+    worktree: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    devDomain?: string;
+    worktree?: string;
+}, {
+    devDomain?: string;
+    worktree?: string;
+}>;
+type ProxyRemoveRequest = z.infer<typeof ProxyRemoveRequest>;
+/** `GET /health` — daemon liveness probe. */
+declare const Health: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    version: z.ZodString;
+    uptimeSeconds: z.ZodNumber;
+    port: z.ZodBranded<z.ZodNumber, "Port">;
+}, "strip", z.ZodTypeAny, {
+    port?: number & z.BRAND<"Port">;
+    ok?: true;
+    version?: string;
+    uptimeSeconds?: number;
+}, {
+    port?: number;
+    ok?: true;
+    version?: string;
+    uptimeSeconds?: number;
+}>;
+type Health = z.infer<typeof Health>;
+/** Runtime error envelope. All non-2xx responses share this shape. */
+declare const RuntimeError: z.ZodObject<{
+    error: z.ZodString;
+    code: z.ZodEnum<["NOT_IMPLEMENTED", "BAD_REQUEST", "CONFLICT", "NOT_FOUND", "FORBIDDEN_DEFAULT_DOMAIN", "INTERNAL", "CADDY_UNREACHABLE", "PORT_EXHAUSTED", "TIMEOUT"]>;
+    details: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    code?: "NOT_IMPLEMENTED" | "BAD_REQUEST" | "CONFLICT" | "NOT_FOUND" | "FORBIDDEN_DEFAULT_DOMAIN" | "INTERNAL" | "CADDY_UNREACHABLE" | "PORT_EXHAUSTED" | "TIMEOUT";
+    error?: string;
+    details?: unknown;
+}, {
+    code?: "NOT_IMPLEMENTED" | "BAD_REQUEST" | "CONFLICT" | "NOT_FOUND" | "FORBIDDEN_DEFAULT_DOMAIN" | "INTERNAL" | "CADDY_UNREACHABLE" | "PORT_EXHAUSTED" | "TIMEOUT";
+    error?: string;
+    details?: unknown;
+}>;
+type RuntimeError = z.infer<typeof RuntimeError>;
+
+export { AcquireRequest as A, Health as H, ProxyState as P, ReleaseRequest as R, AcquireResponse as a, RenewRequest as b, PoolStatus as c, ProxyUpsertRequest as d, ProxyRemoveRequest as e, RuntimeError as f };

package/dist/runtime/client/index.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { H as Health, A as AcquireRequest, a as AcquireResponse, R as ReleaseRequest, b as RenewRequest, P as ProxyState, d as ProxyUpsertRequest, e as ProxyRemoveRequest, c as PoolStatus, f as RuntimeError } from '../api-Bbh7Mcv9.js';
+
+interface RuntimeClientOptions {
+    /** Override base URL (mostly for tests). */
+    baseUrl?: string;
+    /** Auto-start the daemon if it isn't running. Default: true. */
+    autoStart?: boolean;
+}
+declare class RuntimeRequestError extends Error {
+    readonly status: number;
+    readonly code: z.infer<typeof RuntimeError>['code'];
+    readonly details?: unknown;
+    constructor(message: string, status: number, code: z.infer<typeof RuntimeError>['code'], details?: unknown);
+}
+declare class RuntimeClient {
+    readonly baseUrl: string;
+    readonly autoStart: boolean;
+    constructor(opts?: RuntimeClientOptions);
+    health(): Promise<Health>;
+    acquire(input: z.input<typeof AcquireRequest>): Promise<AcquireResponse>;
+    release(input: z.input<typeof ReleaseRequest>): Promise<void>;
+    renew(input: z.input<typeof RenewRequest>): Promise<void>;
+    proxyState(): Promise<ProxyState>;
+    proxyUpsert(input: z.input<typeof ProxyUpsertRequest>): Promise<ProxyState>;
+    proxyRemove(input: z.input<typeof ProxyRemoveRequest>): Promise<ProxyState>;
+    poolStatus(): Promise<PoolStatus>;
+}
+/** Default singleton client for casual callers. */
+declare const runtime: RuntimeClient;
+
+export { RuntimeClient, type RuntimeClientOptions, RuntimeRequestError, runtime };

package/dist/runtime/client/index.js

@@ -0,0 +1,239 @@
+// src/runtime/client/index.ts
+import { spawn } from "child_process";
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+
+// src/runtime/schema/identity.ts
+import { z } from "zod";
+var DevDomain = z.string().min(1).max(32).regex(/^[a-z][a-z0-9-]*$/, "devDomain must match /^[a-z][a-z0-9-]*$/").brand();
+var WorktreeName = z.string().min(1).max(64).regex(/^[a-z0-9][a-z0-9._-]*$/i, "worktree name must be URL-safe").brand();
+var Port = z.number().int().min(1024).max(65535).brand();
+var DevServerSlot = z.object({
+  devDomain: DevDomain,
+  worktree: WorktreeName
+});
+
+// src/runtime/schema/devserver.ts
+import { z as z2 } from "zod";
+var DevServerStatus = z2.enum([
+  "idle",
+  // pre-warmed in the hot pool, no project bound yet
+  "spawning",
+  // process started, waiting for `ready in …` from Vite stdout
+  "ready",
+  // bound to a slot, accepting traffic via Caddy
+  "draining",
+  // releasing — finishing in-flight requests before kill
+  "stopped"
+  // process exited, slot freed, port returned to the pool
+]);
+var DevServer = z2.object({
+  id: z2.string().uuid(),
+  pid: z2.number().int().positive(),
+  port: Port,
+  status: DevServerStatus,
+  slot: DevServerSlot.nullable(),
+  /** Absolute path of the worktree directory once bound; null while in the pool. */
+  cwd: z2.string().nullable(),
+  /** ISO timestamp; immutable after spawn. */
+  spawnedAt: z2.string().datetime(),
+  /** ISO timestamp of last status change. */
+  updatedAt: z2.string().datetime()
+});
+var Lease = z2.object({
+  id: z2.string().uuid(),
+  devServerId: z2.string().uuid(),
+  slot: DevServerSlot,
+  /** Public proxy URL the client should print to the user. Authoritative. */
+  url: z2.string().url(),
+  /** Renew before this timestamp or the lease expires and the devserver drains. */
+  expiresAt: z2.string().datetime()
+});
+var ProxyRoute = z2.object({
+  devDomain: DevDomain,
+  host: z2.string(),
+  /** worktree name → upstream port. `main` is the host's catch-all. */
+  upstreams: z2.record(z2.string(), Port)
+});
+
+// src/runtime/schema/api.ts
+import { z as z3 } from "zod";
+var AcquireRequest = z3.object({
+  slot: DevServerSlot,
+  /** Absolute path of the worktree directory; the runtime spawns Vite with `cwd: targetCwd`. */
+  targetCwd: z3.string().min(1),
+  /** Lease TTL in seconds. Defaults to 5 min; CLI clients renew on each command. */
+  ttlSeconds: z3.number().int().min(30).max(60 * 60).default(300),
+  /**
+   * Escape hatch for the deprecated default devDomain `"storyboard"`. CI and
+   * one-off scripts may pass true; the CLI never does.
+   */
+  allowDefaultDomain: z3.boolean().default(false)
+});
+var AcquireResponse = z3.object({
+  lease: Lease,
+  devServer: DevServer
+});
+var ReleaseRequest = z3.object({
+  leaseId: z3.string().uuid()
+});
+var RenewRequest = z3.object({
+  leaseId: z3.string().uuid(),
+  ttlSeconds: z3.number().int().min(30).max(60 * 60).default(300)
+});
+var ProxyState = z3.object({
+  routes: z3.array(ProxyRoute),
+  caddyReachable: z3.boolean()
+});
+var PoolStatus = z3.object({
+  warm: z3.number().int().nonnegative(),
+  bound: z3.number().int().nonnegative(),
+  capacity: z3.number().int().nonnegative()
+});
+var ProxyUpsertRequest = z3.object({
+  devDomain: z3.string(),
+  worktree: z3.string(),
+  port: z3.number()
+});
+var ProxyRemoveRequest = z3.object({
+  devDomain: z3.string(),
+  worktree: z3.string()
+});
+var Health = z3.object({
+  ok: z3.literal(true),
+  version: z3.string(),
+  uptimeSeconds: z3.number().nonnegative(),
+  port: Port
+});
+var RuntimeError = z3.object({
+  error: z3.string(),
+  code: z3.enum([
+    "NOT_IMPLEMENTED",
+    "BAD_REQUEST",
+    "CONFLICT",
+    "NOT_FOUND",
+    "FORBIDDEN_DEFAULT_DOMAIN",
+    "INTERNAL",
+    "CADDY_UNREACHABLE",
+    "PORT_EXHAUSTED",
+    "TIMEOUT"
+  ]),
+  details: z3.unknown().optional()
+});
+
+// src/runtime/client/index.ts
+var RUNTIME_BASE = "http://127.0.0.1:4321";
+var RuntimeRequestError = class extends Error {
+  constructor(message, status, code, details) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.details = details;
+    this.name = "RuntimeRequestError";
+  }
+};
+async function request(baseUrl, method, path, body, responseSchema) {
+  const init = {
+    method,
+    headers: body !== void 0 ? { "Content-Type": "application/json" } : void 0,
+    body: body !== void 0 ? JSON.stringify(body) : void 0
+  };
+  let res;
+  try {
+    res = await fetch(`${baseUrl}${path}`, init);
+  } catch (err) {
+    throw new RuntimeRequestError(
+      `Cannot reach Storyboard Runtime at ${baseUrl} \u2014 is the daemon running? (${err.message})`,
+      0,
+      "INTERNAL"
+    );
+  }
+  const text = await res.text();
+  let parsed;
+  try {
+    parsed = text ? JSON.parse(text) : {};
+  } catch {
+    parsed = { error: text, code: "INTERNAL" };
+  }
+  if (!res.ok) {
+    const err = RuntimeError.safeParse(parsed);
+    if (err.success) {
+      throw new RuntimeRequestError(err.data.error, res.status, err.data.code, err.data.details);
+    }
+    throw new RuntimeRequestError(`HTTP ${res.status}`, res.status, "INTERNAL", parsed);
+  }
+  if (responseSchema === null) return void 0;
+  return responseSchema.parse(parsed);
+}
+async function spawnDaemon(baseUrl) {
+  const here = dirname(fileURLToPath(import.meta.url));
+  const binPath = resolve(here, "..", "..", "bin", "runtime.js");
+  const child = spawn(process.execPath, [binPath], {
+    detached: true,
+    stdio: "ignore",
+    env: process.env
+  });
+  child.unref();
+  const deadline = Date.now() + 5e3;
+  while (Date.now() < deadline) {
+    try {
+      const r = await fetch(`${baseUrl}/health`);
+      if (r.ok) return;
+    } catch {
+    }
+    await new Promise((r) => setTimeout(r, 100));
+  }
+  throw new Error("Storyboard Runtime did not become ready within 5s");
+}
+var RuntimeClient = class {
+  baseUrl;
+  autoStart;
+  constructor(opts = {}) {
+    this.baseUrl = opts.baseUrl ?? RUNTIME_BASE;
+    this.autoStart = opts.autoStart !== false;
+  }
+  async health() {
+    try {
+      return await request(this.baseUrl, "GET", "/health", void 0, Health);
+    } catch (err) {
+      if (this.autoStart && err instanceof RuntimeRequestError && err.status === 0) {
+        await spawnDaemon(this.baseUrl);
+        return request(this.baseUrl, "GET", "/health", void 0, Health);
+      }
+      throw err;
+    }
+  }
+  async acquire(input) {
+    const body = AcquireRequest.parse(input);
+    return request(this.baseUrl, "POST", "/devserver/acquire", body, AcquireResponse);
+  }
+  async release(input) {
+    const body = ReleaseRequest.parse(input);
+    await request(this.baseUrl, "POST", "/devserver/release", body, null);
+  }
+  async renew(input) {
+    const body = RenewRequest.parse(input);
+    await request(this.baseUrl, "POST", "/devserver/renew", body, null);
+  }
+  async proxyState() {
+    return request(this.baseUrl, "GET", "/proxy/state", void 0, ProxyState);
+  }
+  async proxyUpsert(input) {
+    const body = ProxyUpsertRequest.parse(input);
+    return request(this.baseUrl, "POST", "/proxy/upsert", body, ProxyState);
+  }
+  async proxyRemove(input) {
+    const body = ProxyRemoveRequest.parse(input);
+    return request(this.baseUrl, "POST", "/proxy/remove", body, ProxyState);
+  }
+  async poolStatus() {
+    return request(this.baseUrl, "GET", "/pool/status", void 0, PoolStatus);
+  }
+};
+var runtime = new RuntimeClient();
+export {
+  RuntimeClient,
+  RuntimeRequestError,
+  runtime
+};
+//# sourceMappingURL=index.js.map

package/dist/runtime/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/client/index.ts","../../../src/runtime/schema/identity.ts","../../../src/runtime/schema/devserver.ts","../../../src/runtime/schema/api.ts"],"sourcesContent":["import { spawn } from 'node:child_process'\nimport { fileURLToPath } from 'node:url'\nimport { dirname, resolve } from 'node:path'\nimport {\n  AcquireRequest,\n  AcquireResponse,\n  Health,\n  PoolStatus,\n  ProxyRemoveRequest,\n  ProxyState,\n  ProxyUpsertRequest,\n  ReleaseRequest,\n  RenewRequest,\n  RuntimeError,\n} from '../schema/index.js'\nimport type { z } from 'zod'\n\n/**\n * Typed JS/TS client for the Storyboard Runtime daemon.\n *\n * Consumers should always go through this client rather than hand-rolling\n * `fetch` calls — the client is the only place where the daemon's URL is\n * known, and it's the only place where on-demand daemon spawning happens.\n */\n\nconst RUNTIME_BASE = 'http://127.0.0.1:4321'\n\nexport interface RuntimeClientOptions {\n  /** Override base URL (mostly for tests). */\n  baseUrl?: string\n  /** Auto-start the daemon if it isn't running. Default: true. */\n  autoStart?: boolean\n}\n\nexport class RuntimeRequestError extends Error {\n  constructor(\n    message: string,\n    public readonly status: number,\n    public readonly code: z.infer<typeof RuntimeError>['code'],\n    public readonly details?: unknown,\n  ) {\n    super(message)\n    this.name = 'RuntimeRequestError'\n  }\n}\n\nasync function request<S extends z.ZodTypeAny>(\n  baseUrl: string,\n  method: 'GET' | 'POST',\n  path: string,\n  body: unknown,\n  responseSchema: S | null,\n): Promise<S extends z.ZodTypeAny ? z.output<S> : void> {\n  const init: RequestInit = {\n    method,\n    headers: body !== undefined ? { 'Content-Type': 'application/json' } : undefined,\n    body: body !== undefined ? JSON.stringify(body) : undefined,\n  }\n  let res: Response\n  try {\n    res = await fetch(`${baseUrl}${path}`, init)\n  } catch (err) {\n    throw new RuntimeRequestError(\n      `Cannot reach Storyboard Runtime at ${baseUrl} — is the daemon running? (${(err as Error).message})`,\n      0,\n      'INTERNAL',\n    )\n  }\n  const text = await res.text()\n  let parsed: unknown\n  try { parsed = text ? JSON.parse(text) : {} }\n  catch { parsed = { error: text, code: 'INTERNAL' } }\n\n  if (!res.ok) {\n    const err = RuntimeError.safeParse(parsed)\n    if (err.success) {\n      throw new RuntimeRequestError(err.data.error, res.status, err.data.code, err.data.details)\n    }\n    throw new RuntimeRequestError(`HTTP ${res.status}`, res.status, 'INTERNAL', parsed)\n  }\n  if (responseSchema === null) return undefined as never\n  return responseSchema.parse(parsed) as never\n}\n\n/**\n * Spawn the daemon as a detached child. Resolves once the health endpoint\n * answers (or rejects after a short timeout).\n */\nasync function spawnDaemon(baseUrl: string): Promise<void> {\n  const here = dirname(fileURLToPath(import.meta.url))\n  // bin/runtime.js lives next to dist/, two levels up from dist/client/index.js\n  const binPath = resolve(here, '..', '..', 'bin', 'runtime.js')\n  const child = spawn(process.execPath, [binPath], {\n    detached: true,\n    stdio: 'ignore',\n    env: process.env,\n  })\n  child.unref()\n\n  // Poll /health until the daemon is up.\n  const deadline = Date.now() + 5000\n  while (Date.now() < deadline) {\n    try {\n      const r = await fetch(`${baseUrl}/health`)\n      if (r.ok) return\n    } catch { /* not up yet */ }\n    await new Promise(r => setTimeout(r, 100))\n  }\n  throw new Error('Storyboard Runtime did not become ready within 5s')\n}\n\nexport class RuntimeClient {\n  readonly baseUrl: string\n  readonly autoStart: boolean\n\n  constructor(opts: RuntimeClientOptions = {}) {\n    this.baseUrl = opts.baseUrl ?? RUNTIME_BASE\n    this.autoStart = opts.autoStart !== false\n  }\n\n  async health(): Promise<Health> {\n    try {\n      return await request(this.baseUrl, 'GET', '/health', undefined, Health)\n    } catch (err) {\n      if (this.autoStart && err instanceof RuntimeRequestError && err.status === 0) {\n        await spawnDaemon(this.baseUrl)\n        return request(this.baseUrl, 'GET', '/health', undefined, Health)\n      }\n      throw err\n    }\n  }\n\n  async acquire(input: z.input<typeof AcquireRequest>): Promise<AcquireResponse> {\n    const body = AcquireRequest.parse(input)\n    return request(this.baseUrl, 'POST', '/devserver/acquire', body, AcquireResponse)\n  }\n\n  async release(input: z.input<typeof ReleaseRequest>): Promise<void> {\n    const body = ReleaseRequest.parse(input)\n    await request(this.baseUrl, 'POST', '/devserver/release', body, null)\n  }\n\n  async renew(input: z.input<typeof RenewRequest>): Promise<void> {\n    const body = RenewRequest.parse(input)\n    await request(this.baseUrl, 'POST', '/devserver/renew', body, null)\n  }\n\n  async proxyState(): Promise<ProxyState> {\n    return request(this.baseUrl, 'GET', '/proxy/state', undefined, ProxyState)\n  }\n\n  async proxyUpsert(input: z.input<typeof ProxyUpsertRequest>): Promise<ProxyState> {\n    const body = ProxyUpsertRequest.parse(input)\n    return request(this.baseUrl, 'POST', '/proxy/upsert', body, ProxyState)\n  }\n\n  async proxyRemove(input: z.input<typeof ProxyRemoveRequest>): Promise<ProxyState> {\n    const body = ProxyRemoveRequest.parse(input)\n    return request(this.baseUrl, 'POST', '/proxy/remove', body, ProxyState)\n  }\n\n  async poolStatus(): Promise<PoolStatus> {\n    return request(this.baseUrl, 'GET', '/pool/status', undefined, PoolStatus)\n  }\n}\n\n/** Default singleton client for casual callers. */\nexport const runtime = new RuntimeClient()\n","import { z } from 'zod'\n\n/**\n * The legacy/default devDomain. Acquire requests using this value are rejected\n * unless `allowDefaultDomain` is set — see DevServerOrchestrator for details.\n */\nexport const DEFAULT_DEV_DOMAIN = 'storyboard'\n\n/**\n * A devDomain identifies a Storyboard repo on this machine.\n *\n * The literal default value `\"storyboard\"` is intentionally *not* allowed by\n * `acquire` (see schema/acquire.ts) — every checkout MUST set its own\n * `devDomain` in `storyboard.config.json`. This is the structural fix for H3\n * in the server-state RCA: two repos can never share a host space.\n *\n * Allowed: lowercase letters, digits, hyphens. Must start with a letter.\n * 1–32 chars. The runtime constructs the public host as `${devDomain}.localhost`.\n */\nexport const DevDomain = z\n  .string()\n  .min(1)\n  .max(32)\n  .regex(/^[a-z][a-z0-9-]*$/, 'devDomain must match /^[a-z][a-z0-9-]*$/')\n  .brand<'DevDomain'>()\nexport type DevDomain = z.infer<typeof DevDomain>\n\n/**\n * A worktree name. `\"main\"` is reserved for the repo root.\n *\n * Names are URL-safe by construction so we never have to escape them when\n * building branch URLs (`/branch--<name>/...`).\n */\nexport const WorktreeName = z\n  .string()\n  .min(1)\n  .max(64)\n  .regex(/^[a-z0-9][a-z0-9._-]*$/i, 'worktree name must be URL-safe')\n  .brand<'WorktreeName'>()\nexport type WorktreeName = z.infer<typeof WorktreeName>\n\n/**\n * A TCP port the runtime has leased to a devserver. The runtime is the sole\n * authority for port allocation; clients never pick their own port.\n */\nexport const Port = z.number().int().min(1024).max(65535).brand<'Port'>()\nexport type Port = z.infer<typeof Port>\n\n/**\n * The composite key `(devDomain, worktree)` uniquely identifies a devserver.\n *\n * The runtime guarantees at most one devserver per slot — illegal collisions\n * (e.g. two repos trying to claim `(storyboard, main)`) are rejected with\n * `409 CONFLICT` rather than silently overwriting routes.\n */\nexport const DevServerSlot = z.object({\n  devDomain: DevDomain,\n  worktree: WorktreeName,\n})\nexport type DevServerSlot = z.infer<typeof DevServerSlot>\n\n/**\n * Convert a slot to its canonical string key, used for map lookups and\n * logging. Format: `${devDomain}::${worktree}`.\n */\nexport function slotKey(slot: DevServerSlot): string {\n  return `${slot.devDomain}::${slot.worktree}`\n}\n","import { z } from 'zod'\nimport { DevDomain, DevServerSlot, Port, WorktreeName } from './identity.js'\n\n/**\n * DevServer lifecycle FSM.\n *\n * Transitions are enforced in code; illegal transitions throw. This is the\n * structural fix for the per-repo server's \"best-effort\" state — a devserver\n * that thinks it's `ready` but whose port is dead cannot exist here.\n *\n * ```\n *   idle → spawning → ready → draining → stopped\n *            │           │        │\n *            └───────────┴────────┴──────→ stopped (on crash)\n * ```\n */\nexport const DevServerStatus = z.enum([\n  'idle',      // pre-warmed in the hot pool, no project bound yet\n  'spawning',  // process started, waiting for `ready in …` from Vite stdout\n  'ready',     // bound to a slot, accepting traffic via Caddy\n  'draining',  // releasing — finishing in-flight requests before kill\n  'stopped',   // process exited, slot freed, port returned to the pool\n])\nexport type DevServerStatus = z.infer<typeof DevServerStatus>\n\n/** Allowed FSM transitions. Centralised so misuse is a one-line review catch. */\nexport const ALLOWED_TRANSITIONS: Record<DevServerStatus, readonly DevServerStatus[]> = {\n  idle: ['spawning', 'stopped'],\n  spawning: ['ready', 'stopped'],\n  ready: ['draining', 'stopped'],\n  draining: ['stopped'],\n  stopped: [],\n} as const\n\nexport class IllegalTransitionError extends Error {\n  constructor(from: DevServerStatus, to: DevServerStatus) {\n    super(`Illegal devserver transition: ${from} → ${to}`)\n    this.name = 'IllegalTransitionError'\n  }\n}\n\nexport function assertTransition(from: DevServerStatus, to: DevServerStatus): void {\n  if (!ALLOWED_TRANSITIONS[from].includes(to)) {\n    throw new IllegalTransitionError(from, to)\n  }\n}\n\n/**\n * A devserver record as exposed by the runtime API.\n *\n * `slot` is `null` for hot-pool members that haven't been acquired yet.\n * Once bound, `slot.devDomain + slot.worktree` is unique across the whole\n * runtime; the orchestrator rejects duplicate binds.\n */\nexport const DevServer = z.object({\n  id: z.string().uuid(),\n  pid: z.number().int().positive(),\n  port: Port,\n  status: DevServerStatus,\n  slot: DevServerSlot.nullable(),\n  /** Absolute path of the worktree directory once bound; null while in the pool. */\n  cwd: z.string().nullable(),\n  /** ISO timestamp; immutable after spawn. */\n  spawnedAt: z.string().datetime(),\n  /** ISO timestamp of last status change. */\n  updatedAt: z.string().datetime(),\n})\nexport type DevServer = z.infer<typeof DevServer>\n\n/**\n * A short-lived lease handed to a CLI client when it acquires a devserver.\n *\n * Leases are the *only* way a client controls a devserver — the runtime\n * refuses commands without a valid leaseId. This means a stale `sb dev`\n * process can't kill a devserver belonging to a newer session.\n */\nexport const Lease = z.object({\n  id: z.string().uuid(),\n  devServerId: z.string().uuid(),\n  slot: DevServerSlot,\n  /** Public proxy URL the client should print to the user. Authoritative. */\n  url: z.string().url(),\n  /** Renew before this timestamp or the lease expires and the devserver drains. */\n  expiresAt: z.string().datetime(),\n})\nexport type Lease = z.infer<typeof Lease>\n\n/**\n * A Caddy proxy route owned by the runtime. The `@id` is always the devDomain;\n * this lets the runtime PATCH a single route in place without touching others.\n *\n * `upstreams` is keyed by plain string (validated elsewhere as WorktreeName)\n * to avoid `Partial<Record<branded, …>>` shenanigans at the value-spread sites.\n */\nexport const ProxyRoute = z.object({\n  devDomain: DevDomain,\n  host: z.string(),\n  /** worktree name → upstream port. `main` is the host's catch-all. */\n  upstreams: z.record(z.string(), Port),\n})\nexport type ProxyRoute = z.infer<typeof ProxyRoute>\n","import { z } from 'zod'\nimport { DevServerSlot, Port } from './identity.js'\nimport { DevServer, Lease, ProxyRoute } from './devserver.js'\n\n/**\n * `POST /devserver/acquire` — request a devserver for a `(devDomain, worktree)` slot.\n *\n * If a devserver already exists for the slot, the runtime returns its existing\n * lease (renewed). Otherwise it either rents a hot-pool member or spawns a new\n * Vite process. The slot is locked for the duration of the call.\n */\nexport const AcquireRequest = z.object({\n  slot: DevServerSlot,\n  /** Absolute path of the worktree directory; the runtime spawns Vite with `cwd: targetCwd`. */\n  targetCwd: z.string().min(1),\n  /** Lease TTL in seconds. Defaults to 5 min; CLI clients renew on each command. */\n  ttlSeconds: z.number().int().min(30).max(60 * 60).default(300),\n  /**\n   * Escape hatch for the deprecated default devDomain `\"storyboard\"`. CI and\n   * one-off scripts may pass true; the CLI never does.\n   */\n  allowDefaultDomain: z.boolean().default(false),\n})\nexport type AcquireRequest = z.infer<typeof AcquireRequest>\n\nexport const AcquireResponse = z.object({\n  lease: Lease,\n  devServer: DevServer,\n})\nexport type AcquireResponse = z.infer<typeof AcquireResponse>\n\n/** `POST /devserver/release` — relinquish the lease and trigger draining. */\nexport const ReleaseRequest = z.object({\n  leaseId: z.string().uuid(),\n})\nexport type ReleaseRequest = z.infer<typeof ReleaseRequest>\n\n/** `POST /devserver/renew` — extend the lease without changing devserver state. */\nexport const RenewRequest = z.object({\n  leaseId: z.string().uuid(),\n  ttlSeconds: z.number().int().min(30).max(60 * 60).default(300),\n})\nexport type RenewRequest = z.infer<typeof RenewRequest>\n\n/** `GET /proxy/state` — current routing table the runtime believes Caddy holds. */\nexport const ProxyState = z.object({\n  routes: z.array(ProxyRoute),\n  caddyReachable: z.boolean(),\n})\nexport type ProxyState = z.infer<typeof ProxyState>\n\n/** `GET /pool/status` — hot-pool inventory. */\nexport const PoolStatus = z.object({\n  warm: z.number().int().nonnegative(),\n  bound: z.number().int().nonnegative(),\n  capacity: z.number().int().nonnegative(),\n})\nexport type PoolStatus = z.infer<typeof PoolStatus>\n\n/** `POST /proxy/upsert` — bind (devDomain, worktree) → port in the proxy. */\nexport const ProxyUpsertRequest = z.object({\n  devDomain: z.string(),\n  worktree: z.string(),\n  port: z.number(),\n})\nexport type ProxyUpsertRequest = z.infer<typeof ProxyUpsertRequest>\n\n/** `POST /proxy/remove` — drop a worktree's route from the proxy. */\nexport const ProxyRemoveRequest = z.object({\n  devDomain: z.string(),\n  worktree: z.string(),\n})\nexport type ProxyRemoveRequest = z.infer<typeof ProxyRemoveRequest>\n\n/** `GET /health` — daemon liveness probe. */\nexport const Health = z.object({\n  ok: z.literal(true),\n  version: z.string(),\n  uptimeSeconds: z.number().nonnegative(),\n  port: Port,\n})\nexport type Health = z.infer<typeof Health>\n\n/** Runtime error envelope. All non-2xx responses share this shape. */\nexport const RuntimeError = z.object({\n  error: z.string(),\n  code: z.enum([\n    'NOT_IMPLEMENTED',\n    'BAD_REQUEST',\n    'CONFLICT',\n    'NOT_FOUND',\n    'FORBIDDEN_DEFAULT_DOMAIN',\n    'INTERNAL',\n    'CADDY_UNREACHABLE',\n    'PORT_EXHAUSTED',\n    'TIMEOUT',\n  ]),\n  details: z.unknown().optional(),\n})\nexport type RuntimeError = z.infer<typeof RuntimeError>\n"],"mappings":"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","names":["z","z","z","z","z"]}

package/dist/runtime/index.d.ts

@@ -0,0 +1,18 @@
+export { ALLOWED_TRANSITIONS, DEFAULT_DEV_DOMAIN, DevDomain, DevServer, DevServerSlot, DevServerStatus, IllegalTransitionError, Lease, Port, ProxyRoute, WorktreeName, assertTransition, slotKey } from './schema/index.js';
+export { A as AcquireRequest, a as AcquireResponse, H as Health, c as PoolStatus, e as ProxyRemoveRequest, P as ProxyState, d as ProxyUpsertRequest, R as ReleaseRequest, b as RenewRequest, f as RuntimeError } from './api-Bbh7Mcv9.js';
+export { RuntimeClient, RuntimeRequestError, runtime } from './client/index.js';
+export { startDaemon } from './server/main.js';
+import 'zod';
+
+/**
+ * Runtime constants — single source of truth for ports, paths, and version.
+ *
+ * The runtime port (`4321`) is intentionally fixed: a single global daemon
+ * needs a well-known address so the CLI client can find it without
+ * configuration. Port 4321 is RFC-allowed and avoids collisions with
+ * Vite (1234), Caddy admin (2019), and the per-repo legacy server (4100-4199).
+ */
+declare const RUNTIME_PORT: 4321;
+declare const RUNTIME_HOST: "127.0.0.1";
+
+export { RUNTIME_HOST, RUNTIME_PORT };