npm - @pyric/cli - Versions diffs - 0.1.0-alpha.9 - Mend

@pyric/cli 0.1.0-alpha.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1169) hide show

package/dist/serve/namespace.d.ts ADDED Viewed

@@ -0,0 +1,73 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type StateStore } from './state-store.js';
+import { type StudioRouteOptions } from './studio/index.js';
+import type { InitPayload } from './init-payload.js';
+export type { InitPayload } from './init-payload.js';
+/**
+ * Server-sent-events hub for `/__pyric/events` — the hot-reload channel
+ * (P3). The runtime opens an EventSource; the rules watcher broadcasts
+ * `rules-changed` and connected pages re-deploy without a refresh.
+ */
+export interface ServeEventHub {
+    /** Mounted inside the namespace handler. */
+    handle(req: IncomingMessage, res: ServerResponse): void;
+    broadcast(event: string, data: unknown): void;
+    clientCount(): number;
+}
+export declare function createEventHub(): ServeEventHub;
+export interface NamespaceOptions {
+    /** The bundle output dir (`BundleResult.outDir`). */
+    sdkDir: string;
+    /** Producer for `/__pyric/init.json` — a function so hot-reload serves
+     *  the latest rules without server restart. */
+    initPayload: () => InitPayload;
+    /** Hot-reload channel; serves `/__pyric/events` when present. */
+    events?: ServeEventHub;
+    /** `--persist`: mounts GET/POST /__pyric/state (the state channel). */
+    state?: StateStore;
+    /** `--capture`: mounts GET/POST /__pyric/capture. POST — the page/worker
+     *  pushes its session fixture here; the handler writes it verbatim to
+     *  `.pyric/last-session.json` for `pyric verify` to replay. GET — returns the
+     *  current fixture JSON (200) or 404 when nothing is captured yet, so the
+     *  served worker can re-hydrate its event history on boot after a death. */
+    capture?: {
+        write(json: string): void;
+        read(): string | null;
+    };
+    /** `--ui` (Pyric Studio): mounts `/__pyric/workspace` + `/__pyric/projects`
+     *  (disk-backed `WorkspaceStore`/`ProjectStore`, plus the SSE watch stream)
+     *  that `@pyric/studio`'s `local` mode talks to. */
+    studio?: StudioRouteOptions;
+    /** `--ui` (Pyric Studio): the dir of the built Studio app, served under
+     *  `/__pyric/ui/`. Resolved by file path in the CLI (@pyric/cli never
+     *  imports `@pyric/studio`). Absent when `--ui` is off or the build is
+     *  missing. */
+    studioUiDir?: string;
+    /** `--ui` (Pyric Studio): the built docs site (site-docs), served so the
+     *  Studio Docs tab has local docs without the hosted site. Built with base
+     *  `/__pyric/ui/`, so its output straddles two subtrees under the mount:
+     *  the pages/twins/index.json live under `/__pyric/ui/docs/`, but the shared
+     *  assets live at `/__pyric/ui/_astro/` (Astro's asset dir, at the base
+     *  root — NOT under `docs/`). Both are served from this one dir. */
+    docsUiDir?: string;
+    /** The OpenAI-compatible upstream `/__pyric/ai-proxy` forwards to
+     *  (pyric/ai — cdd-deltas #98.2). Falls back to the
+     *  `PYRIC_AI_PROXY_UPSTREAM` env var, then `http://localhost:11434/v1`
+     *  (local Ollama). Always mounted — the route only touches the network
+     *  when a request arrives. */
+    aiProxyUpstream?: string;
+}
+/** Default upstream: local Ollama's OpenAI-compatible endpoint. */
+export declare const AI_PROXY_DEFAULT_UPSTREAM = "http://localhost:11434/v1";
+export declare function createPyricNamespace(opts: NamespaceOptions): (req: IncomingMessage, res: ServerResponse, url: URL) => boolean | Promise<boolean>;
+/** The import-map targets. Spec → served URL. */
+export declare function sdkImportMap(): Record<string, string>;
+/**
+ * Inject the import map + init script into an HTML document. The import map
+ * MUST precede any module script that imports a mapped specifier, so both
+ * tags go at the very start of `<head>` (fallbacks: after `<html>`, else
+ * prepended). Idempotent — a page already carrying the marker is untouched
+ * (matters when transformHtml runs over an SPA fallback repeatedly).
+ */
+export declare function injectServeTags(html: string, importMap?: Record<string, string>, workerVersion?: string, forceInPage?: boolean): string;
+//# sourceMappingURL=namespace.d.ts.map

package/dist/serve/namespace.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/serve/namespace.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEtF,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;IACxD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9C,WAAW,IAAI,MAAM,CAAC;CACvB;AAED,wBAAgB,cAAc,IAAI,aAAa,CA4B9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf;mDAC+C;IAC/C,WAAW,EAAE,MAAM,WAAW,CAAC;IAC/B,iEAAiE;IACjE,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,uEAAuE;IACvE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;;gFAI4E;IAC5E,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,IAAI,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC/D;;wDAEoD;IACpD,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B;;;mBAGe;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;wEAKoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;kCAI8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,mEAAmE;AACnE,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AA8PrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,IAGjD,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,GAAG,KAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CA8GzF;AAID,iDAAiD;AACjD,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWrD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAkB,EAClD,aAAa,CAAC,EAAE,MAAM,EACtB,WAAW,UAAQ,GAClB,MAAM,CAuDR"}

package/dist/serve/namespace.js ADDED Viewed

@@ -0,0 +1,470 @@
+/**
+ * The `/__pyric/` reserved namespace — pyric's analog of firebase serve's
+ * `/__/firebase/` namespace:
+ *
+ *   /__pyric/sdk/<file>.js   the bundled SDK files (import-map targets +
+ *                            the injected init script + shared chunks)
+ *   /__pyric/init.json       the page init payload (rules, bridge URL) —
+ *                            fetched by the runtime chunk at module init
+ *
+ * Bridge routes (`/__pyric/mcp`, `/__pyric/sandbox`) mount here in P2.
+ */
+import { existsSync, statSync } from 'node:fs';
+import { basename, extname, join } from 'node:path';
+import { collectBody } from '../bridge/server/peer.js';
+import { StateFileError } from './state-store.js';
+import { createWriterLock } from './writer-lock.js';
+import { createStudioRoutes } from './studio/index.js';
+import { contentTypeFor, pipeFileToResponse, resolveStaticFile } from './server.js';
+import { SANDBOX_BUILD_MARKER } from './sandbox-marker.js';
+export function createEventHub() {
+    const clients = new Set();
+    return {
+        handle(req, res) {
+            res.writeHead(200, {
+                'content-type': 'text/event-stream',
+                'cache-control': 'no-store',
+                connection: 'keep-alive',
+            });
+            res.write(': connected\n\n');
+            clients.add(res);
+            req.on('close', () => clients.delete(res));
+            // A dying SSE socket must never surface an unhandled 'error' event
+            // (which would kill the whole serve process) — drop the client instead.
+            res.on('error', () => clients.delete(res));
+        },
+        broadcast(event, data) {
+            const frame = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+            for (const res of clients) {
+                try {
+                    res.write(frame);
+                }
+                catch {
+                    clients.delete(res); // half-closed socket in the close race window
+                }
+            }
+        },
+        clientCount: () => clients.size,
+    };
+}
+// ─── AI proxy (`/__pyric/ai-proxy` — pyric/ai, cdd-deltas #98.2) ───────────
+/** Default upstream: local Ollama's OpenAI-compatible endpoint. */
+export const AI_PROXY_DEFAULT_UPSTREAM = 'http://localhost:11434/v1';
+/**
+ * Request headers that must NOT be forwarded upstream: origin-sensitive
+ * browser context (`origin`/`referer`/`cookie` — the upstream is a different
+ * origin and must never see the page's), hop-by-hop headers, and the two the
+ * proxy re-derives (`host`, `content-length`). `accept-encoding` is dropped
+ * so fetch negotiates its own compression and the streamed body needs no
+ * length fixups.
+ */
+const AI_PROXY_STRIPPED_HEADERS = new Set([
+    'host',
+    'origin',
+    'referer',
+    'cookie',
+    'connection',
+    'content-length',
+    'accept-encoding',
+    'keep-alive',
+    'proxy-authorization',
+    'te',
+    'trailer',
+    'transfer-encoding',
+    'upgrade',
+]);
+/**
+ * Handle `POST /__pyric/ai-proxy/<suffix>` — a same-origin passthrough to the
+ * configured OpenAI-compatible upstream, so the browser openai engine
+ * (running in the served page or the SharedWorker host) reaches a localhost
+ * upstream like Ollama with ZERO CORS setup (no `OLLAMA_ORIGINS`, ever).
+ *
+ * Behavior:
+ *   - POST only (the OpenAI chat-completions surface is POST); 405 otherwise.
+ *   - the path suffix + query ride through verbatim
+ *     (`/__pyric/ai-proxy/chat/completions` → `<upstream>/chat/completions`).
+ *   - the request body is forwarded verbatim; headers minus the
+ *     origin-sensitive/hop-by-hop set above (`authorization` DOES forward —
+ *     upstreams may require a key).
+ *   - the response body is STREAMED through chunk-by-chunk — SSE passthrough
+ *     must never buffer, or `stream: true` completions would arrive all at
+ *     once at the end.
+ *   - an unreachable upstream answers 502 with a plain-text explanation.
+ */
+async function handleAiProxy(configuredUpstream, req, res, url) {
+    if (req.method !== 'POST') {
+        res.writeHead(405, { allow: 'POST' }).end('method not allowed');
+        return;
+    }
+    const upstreamBase = (configuredUpstream ??
+        process.env.PYRIC_AI_PROXY_UPSTREAM ??
+        AI_PROXY_DEFAULT_UPSTREAM).replace(/\/$/, '');
+    const suffix = url.pathname.slice('/__pyric/ai-proxy'.length);
+    const target = `${upstreamBase}${suffix}${url.search}`;
+    // Buffer the REQUEST body (small JSON payloads); the RESPONSE streams.
+    const raw = await new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (c) => chunks.push(c));
+        req.on('end', () => resolve(Buffer.concat(chunks)));
+        req.on('error', reject);
+    });
+    // Copy into a plain-ArrayBuffer view — fetch's BodyInit typing rejects
+    // Buffer's ArrayBufferLike backing.
+    const body = new Uint8Array(raw.byteLength);
+    body.set(raw);
+    const headers = {};
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (value === undefined)
+            continue;
+        if (AI_PROXY_STRIPPED_HEADERS.has(key.toLowerCase()))
+            continue;
+        headers[key] = Array.isArray(value) ? value.join(', ') : value;
+    }
+    let upstream;
+    try {
+        upstream = await fetch(target, { method: 'POST', headers, body });
+    }
+    catch (e) {
+        res.writeHead(502, { 'content-type': 'text/plain' });
+        res.end(`pyric dev ai-proxy: upstream ${target} unreachable: ` +
+            `${e instanceof Error ? e.message : String(e)}\n` +
+            'Set PYRIC_AI_PROXY_UPSTREAM to an OpenAI-compatible base URL ' +
+            `(default ${AI_PROXY_DEFAULT_UPSTREAM}).`);
+        return;
+    }
+    const responseHeaders = { 'cache-control': 'no-store' };
+    const contentType = upstream.headers.get('content-type');
+    if (contentType)
+        responseHeaders['content-type'] = contentType;
+    res.writeHead(upstream.status, responseHeaders);
+    if (!upstream.body) {
+        res.end();
+        return;
+    }
+    res.flushHeaders?.();
+    // Chunk-by-chunk passthrough. A dropped client cancels the upstream read
+    // so an abandoned SSE stream doesn't keep the upstream generating.
+    const reader = upstream.body.getReader();
+    res.on('close', () => {
+        void reader.cancel().catch(() => { });
+    });
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            res.write(value);
+        }
+    }
+    catch {
+        // Upstream or client dropped mid-stream — nothing to salvage.
+    }
+    res.end();
+}
+/** The page's persistence backend speaks this route:
+ *  GET    /__pyric/state                    → whole envelope (404 when absent)
+ *  GET    /__pyric/state?section=firestore  → that section (404 when null)
+ *  POST   /__pyric/state?section=...        → write the section (204; 423 if
+ *                                             another tab holds the writer lock)
+ *  DELETE /__pyric/state                    → release the writer lock (beacon)
+ *  Writes carry `x-pyric-writer: <id>`; the first writer wins, others get 423
+ *  and drop to read-only (pre-mortem #3). The firestore body is the sandbox
+ *  persistence controller's own blob — stored verbatim, never interpreted. */
+async function handleState(state, lock, req, res, url) {
+    const section = url.searchParams.get('section');
+    const writerId = req.headers['x-pyric-writer'] ?? '';
+    try {
+        if (req.method === 'GET') {
+            const value = section ? state.readSection(section) : state.load();
+            if (value === null) {
+                res.writeHead(404, { 'content-type': 'application/json' }).end('null');
+                return;
+            }
+            res.writeHead(200, {
+                'content-type': 'application/json; charset=utf-8',
+                'cache-control': 'no-store',
+                // Lets `pyric snapshot` detect it scanned into a NEIGHBOR project's
+                // serve (pre-mortem #4) and warn instead of promoting the wrong DB.
+                'x-pyric-project-dir': state.projectDir,
+            });
+            res.end(JSON.stringify(value));
+            return;
+        }
+        if (req.method === 'DELETE') {
+            if (writerId)
+                lock.release(writerId);
+            res.writeHead(204).end();
+            return;
+        }
+        if (req.method === 'PUT') {
+            // Lock heartbeat — refresh/claim WITHOUT writing state. 423 if another
+            // live tab holds it.
+            res.writeHead(lock.claim(writerId || 'anon', Date.now()) ? 204 : 423).end();
+            return;
+        }
+        if (req.method === 'POST') {
+            if (section !== 'firestore' && section !== 'auth') {
+                res.writeHead(400).end('section must be firestore|auth');
+                return;
+            }
+            // Single-writer: the first page to flush claims the lock; a different
+            // live page is refused (423) so it can't erase the writer's world.
+            if (!lock.claim(writerId || 'anon', Date.now())) {
+                res.writeHead(423, { 'content-type': 'text/plain' }).end(`another tab holds the persist writer lock (held by ${lock.holder()})`);
+                return;
+            }
+            const body = await collectBody(req);
+            state.writeSection(section, body);
+            res.writeHead(204).end();
+            return;
+        }
+        res.writeHead(405, { allow: 'GET, POST, DELETE' }).end('method not allowed');
+    }
+    catch (e) {
+        // StateFileError (corrupt/version) or bad body — surface, don't clobber.
+        res.writeHead(e instanceof StateFileError ? 409 : 400, { 'content-type': 'text/plain' });
+        res.end(e instanceof Error ? e.message : String(e));
+    }
+}
+/**
+ * Handle POST /__pyric/capture — the page pushes its full session fixture
+ * (JSON-serialized history + snapshot + rules) whenever the sandbox changes.
+ * The server writes it verbatim to `.pyric/last-session.json` so
+ * `pyric verify` can pick it up without any extra arguments.
+ *
+ * GET returns the current fixture JSON verbatim (200), or 404 when nothing
+ * has been captured yet. The served SharedWorker fetches this on boot to
+ * re-hydrate its in-memory event history after a worker death (Traffic /
+ * activity / metrics survive the refresh even though the worker restarted).
+ * Cheap + read-only.
+ *
+ * POST fails fast rather than silently swallowing write errors so the
+ * developer knows the capture is broken.
+ *
+ * We collect the RAW request body as a string rather than using
+ * `collectBody` (which parses JSON). The capture must be stored verbatim
+ * — re-serializing a parsed object would round-trip through JS values and
+ * could alter key order or lose whitespace, making the file differ from
+ * what the page intended to write.
+ */
+async function handleCapture(capture, req, res) {
+    if (req.method === 'GET') {
+        const body = capture.read();
+        if (body === null) {
+            res.writeHead(404, { 'content-type': 'application/json' }).end('null');
+            return;
+        }
+        res.writeHead(200, {
+            'content-type': 'application/json; charset=utf-8',
+            'cache-control': 'no-store',
+        });
+        res.end(body);
+        return;
+    }
+    if (req.method !== 'POST') {
+        res.writeHead(405, { allow: 'GET, POST' }).end('method not allowed');
+        return;
+    }
+    try {
+        const body = await new Promise((resolve, reject) => {
+            let raw = '';
+            req.setEncoding('utf8');
+            req.on('data', (chunk) => { raw += chunk; });
+            req.on('end', () => resolve(raw));
+            req.on('error', reject);
+        });
+        capture.write(body);
+        res.writeHead(204).end();
+    }
+    catch (e) {
+        res.writeHead(400, { 'content-type': 'text/plain' });
+        res.end(e instanceof Error ? e.message : String(e));
+    }
+}
+export function createPyricNamespace(opts) {
+    const writerLock = createWriterLock();
+    const studioRoutes = opts.studio ? createStudioRoutes(opts.studio) : null;
+    return (req, res, url) => {
+        if (studioRoutes &&
+            (url.pathname.startsWith('/__pyric/workspace') ||
+                url.pathname.startsWith('/__pyric/projects'))) {
+            return studioRoutes(req, res, url);
+        }
+        if (opts.state && url.pathname === '/__pyric/state') {
+            return handleState(opts.state, writerLock, req, res, url).then(() => true);
+        }
+        if (opts.capture && url.pathname === '/__pyric/capture') {
+            return handleCapture(opts.capture, req, res).then(() => true);
+        }
+        if (opts.events && url.pathname === '/__pyric/events') {
+            opts.events.handle(req, res);
+            return true;
+        }
+        if (url.pathname === '/__pyric/ai-proxy' || url.pathname.startsWith('/__pyric/ai-proxy/')) {
+            return handleAiProxy(opts.aiProxyUpstream, req, res, url).then(() => true);
+        }
+        if (url.pathname === '/__pyric/init.json') {
+            res.writeHead(200, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' });
+            res.end(JSON.stringify(opts.initPayload()));
+            return true;
+        }
+        if (url.pathname.startsWith('/__pyric/sdk/')) {
+            // basename() flattens any traversal attempt — the sdk dir is flat.
+            const file = join(opts.sdkDir, basename(url.pathname));
+            if (!existsSync(file)) {
+                res.writeHead(404).end('not found');
+                return true;
+            }
+            const type = file.endsWith('.map') ? 'application/json' : 'text/javascript; charset=utf-8';
+            // Immutable-friendly: bundle filenames are content-hashed chunks or
+            // cache-keyed outputs; still no-store in dev for simplicity.
+            res.writeHead(200, { 'content-type': type, 'cache-control': 'no-store' });
+            pipeFileToResponse(file, res);
+            return true;
+        }
+        // Embedded docs site (site-docs). MUST run BEFORE the general
+        // `/__pyric/ui/` studio handler below: that handler's SPA fallback answers
+        // every miss with Studio's index.html, which would swallow docs pages and
+        // (worse) return HTML for a missing docs asset. Built with base
+        // `/__pyric/ui/`, the docs output lives in TWO subtrees under the mount —
+        // pages/twins/index.json under `/__pyric/ui/docs/`, and shared assets at
+        // `/__pyric/ui/_astro/` (Astro's asset dir sits at the base root, not under
+        // `docs/`). We claim both; `_astro` is Astro-specific and never collides
+        // with Studio (Vite emits `/__pyric/ui/assets/`). No SPA fallback here — a
+        // genuinely missing docs page 404s (a broken doc link must fail loudly, not
+        // masquerade as another page). Directory-format pages (`<slug>/index.html`)
+        // and `bunx serve`-style extensionless→trailing-slash redirects are handled
+        // by resolveStaticFile + the directory redirect below.
+        if (opts.docsUiDir &&
+            (url.pathname === '/__pyric/ui/docs' ||
+                url.pathname.startsWith('/__pyric/ui/docs/') ||
+                url.pathname.startsWith('/__pyric/ui/_astro/'))) {
+            const rel = url.pathname.slice('/__pyric/ui'.length) || '/';
+            // `bunx serve` parity: an extensionless path that names a real directory
+            // (e.g. `/__pyric/ui/docs` or `/__pyric/ui/docs/<slug>`) redirects to the
+            // trailing-slash form so the directory's index.html loads with correct
+            // relative-URL resolution.
+            if (!rel.endsWith('/') && !extname(rel)) {
+                const dir = join(opts.docsUiDir, decodeURIComponent(rel));
+                if (existsSync(dir) && statSync(dir).isDirectory()) {
+                    res.writeHead(301, { location: `${url.pathname}/` }).end();
+                    return true;
+                }
+            }
+            const file = resolveStaticFile(opts.docsUiDir, rel);
+            if (!file) {
+                res.writeHead(404).end('not found');
+                return true;
+            }
+            res.writeHead(200, { 'content-type': contentTypeFor(file), 'cache-control': 'no-store' });
+            pipeFileToResponse(file, res);
+            return true;
+        }
+        if (opts.studioUiDir &&
+            (url.pathname === '/__pyric/ui' || url.pathname.startsWith('/__pyric/ui/'))) {
+            // The built Pyric Studio app. Served verbatim (NOT through
+            // injectServeTags: that import-map/init injection is for sandbox pages,
+            // not Studio). Studio uses History-API routing under this mount, so any
+            // path that doesn't resolve to a real file falls back to index.html —
+            // INCLUDING paths with dots (deep links like /storage/uploads/logo.png).
+            // Only misses under Vite's content-hashed asset dir stay hard 404s, so a
+            // broken script/style URL fails loudly instead of returning HTML.
+            if (url.pathname === '/__pyric/ui') {
+                res.writeHead(301, { location: '/__pyric/ui/' }).end();
+                return true;
+            }
+            const rel = url.pathname.slice('/__pyric/ui'.length) || '/';
+            let file = resolveStaticFile(opts.studioUiDir, rel);
+            if (!file && !rel.startsWith('/assets/')) {
+                file = resolveStaticFile(opts.studioUiDir, '/index.html');
+            }
+            if (!file) {
+                res.writeHead(404).end('not found');
+                return true;
+            }
+            res.writeHead(200, { 'content-type': contentTypeFor(file), 'cache-control': 'no-store' });
+            pipeFileToResponse(file, res);
+            return true;
+        }
+        return false; // unknown /__pyric/* → caller 404s
+    };
+}
+// ─── HTML injection ───────────────────────────────────────────────────
+/** The import-map targets. Spec → served URL. */
+export function sdkImportMap() {
+    return {
+        'firebase/ai': '/__pyric/sdk/ai.js',
+        'firebase/app': '/__pyric/sdk/app.js',
+        'firebase/auth': '/__pyric/sdk/auth.js',
+        'firebase/database': '/__pyric/sdk/database.js',
+        'firebase/firestore': '/__pyric/sdk/firestore.js',
+        'firebase/messaging': '/__pyric/sdk/messaging.js',
+        'firebase/messaging/sw': '/__pyric/sdk/messaging-sw.js',
+        'firebase/storage': '/__pyric/sdk/storage.js',
+    };
+}
+/**
+ * Inject the import map + init script into an HTML document. The import map
+ * MUST precede any module script that imports a mapped specifier, so both
+ * tags go at the very start of `<head>` (fallbacks: after `<html>`, else
+ * prepended). Idempotent — a page already carrying the marker is untouched
+ * (matters when transformHtml runs over an SPA fallback repeatedly).
+ */
+export function injectServeTags(html, importMap = sdkImportMap(), workerVersion, forceInPage = false) {
+    const MARKER = 'data-pyric-serve';
+    if (html.includes(MARKER))
+        return html;
+    // A pyric SANDBOX BUILD (`vite build` under the pyricSandbox plugin's sandbox
+    // mode) already BUNDLES its own runtime + init chunk — injecting the import
+    // map + /__pyric/sdk/init.js on top would boot a SECOND runtime instance on
+    // the page (two banners, two bridge peer registrations, races between them).
+    // The bundle owns the sandbox for a marked page: it fetches
+    // /__pyric/init.json itself (worker path: the SharedWorker does; in-page
+    // path: the runtime does) and owns rules hot-reload the same way. The ONLY
+    // serve-time contribution left is the worker-version staleness stamp, which
+    // the bundled runtime reads from this meta to warn about a stale
+    // still-running SharedWorker.
+    if (html.includes(SANDBOX_BUILD_MARKER)) {
+        if (!workerVersion || html.includes('pyric-worker-v'))
+            return html;
+        const meta = `<meta name="pyric-worker-v" content="${workerVersion}" ${MARKER}>`;
+        const headTag = html.match(/<head[^>]*>/i);
+        if (headTag && headTag.index !== undefined) {
+            const at = headTag.index + headTag[0].length;
+            return html.slice(0, at) + meta + html.slice(at);
+        }
+        return meta + html;
+    }
+    // Stamp the worker's content hash so the page can DETECT staleness: a live
+    // SharedWorker survives serve restarts + reloads and can't hot-update, so it
+    // keeps running old code until every tab of the origin closes. The worker
+    // name is intentionally STABLE (one backend shared by all tabs), so rather
+    // than split tabs across versions, `runtime.ts` compares this served hash to
+    // the running worker's baked hash and warns the user to close all tabs.
+    const versionMeta = workerVersion
+        ? `<meta name="pyric-worker-v" content="${workerVersion}" ${MARKER}>`
+        : '';
+    // `--bridge`: the MCP bridge peers with the IN-PAGE sandbox, so force the page
+    // off the default SharedWorker path. Otherwise the agent drives an empty
+    // in-page sandbox while the app's data lives in the worker. Set before any app
+    // code runs; mirrors the Vite plugin's transformIndexHtml.
+    const forceTag = forceInPage
+        ? `<script ${MARKER}>globalThis.__PYRIC_FORCE_INPAGE__=true;</script>`
+        : '';
+    const tags = versionMeta +
+        forceTag +
+        `<script type="importmap" ${MARKER}>${JSON.stringify({ imports: importMap })}</script>` +
+        `<script type="module" src="/__pyric/sdk/init.js" ${MARKER}></script>`;
+    const head = html.match(/<head[^>]*>/i);
+    if (head && head.index !== undefined) {
+        const at = head.index + head[0].length;
+        return html.slice(0, at) + tags + html.slice(at);
+    }
+    const htmlTag = html.match(/<html[^>]*>/i);
+    if (htmlTag && htmlTag.index !== undefined) {
+        const at = htmlTag.index + htmlTag[0].length;
+        return html.slice(0, at) + tags + html.slice(at);
+    }
+    return tags + html;
+}
+//# sourceMappingURL=namespace.js.map

package/dist/serve/namespace.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/serve/namespace.ts"],"names":[],"mappings":"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"}

package/dist/serve/open-browser.d.ts ADDED Viewed

@@ -0,0 +1,23 @@
+export interface AutoOpenContext {
+    /** `--json` is on (stdout is the agent contract — never pop a browser). */
+    json: boolean;
+    /** `--no-open` was passed. */
+    noOpen: boolean;
+    /** stdout is a TTY (interactive). Piped/redirected → false. */
+    isTTY: boolean;
+    /** process.env, read for CI detection. */
+    env: Record<string, string | undefined>;
+}
+/**
+ * Pure decision: should `pyric dev` auto-open the browser? Factored out so
+ * the gating logic is unit-testable without spawning anything. Open only when
+ * interactive AND not explicitly suppressed AND not in CI.
+ */
+export declare function shouldAutoOpen(ctx: AutoOpenContext): boolean;
+/**
+ * Open `url` in the default browser, best-effort. Resolves whether or not the
+ * open succeeded — callers must not let a missing `xdg-open` (headless Linux,
+ * containers) take down the dev server. Never throws.
+ */
+export declare function openBrowser(url: string): Promise<void>;
+//# sourceMappingURL=open-browser.d.ts.map

package/dist/serve/open-browser.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"open-browser.d.ts","sourceRoot":"","sources":["../../src/serve/open-browser.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,IAAI,EAAE,OAAO,CAAC;IACd,8BAA8B;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAI5D;AAgBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAStD"}