@pyric/cli 0.1.0-alpha.10

package/dist/serve/bundler.js

@@ -0,0 +1,432 @@
+/**
+ * `pyric dev` SDK bundler — builds the browser-standalone ESM bundles the
+ * import map points `firebase/*` at (`/__pyric/sdk/*.js`).
+ *
+ * esbuild (a real dependency — the `pyric` bin runs under node via npx, so
+ * Bun.build is unavailable) bundles the wrapper entries in `entries/` with
+ * SPLITTING so the shared runtime chunk holds exactly ONE sandbox per page:
+ * both the auth and firestore bundles must close over the same instance.
+ *
+ * Two bundler plugins make pyric browser-standalone:
+ *   - `pyric/*` resolver — resolves `pyric/...` specifiers from THIS package's
+ *     dependency context (entries may live in a temp dir that lacks pyric).
+ *   - node-builtin shims (`url`/`fs`/`path`) — still load-bearing despite the
+ *     Phase U resolver split: `pyric/firestore` re-exports the agent tool
+ *     factories (`firestore/index.js` → `rules/tools.js`), and tools.js
+ *     statically imports the NODE module resolver. The browser path never
+ *     calls into disk reads, so benign shims suffice. Droppable only when
+ *     pyric breaks that static chain (tracked in #553).
+ *
+ * Output is cached under `~/.pyric/serve-cache/<pyric-version>-<hash>/` so a
+ * warm `pyric dev` start skips the (~seconds) bundle step. `--no-cache`
+ * bypasses.
+ */
+import { createHash } from 'node:crypto';
+import { mkdirSync, mkdtempSync, readFileSync, readdirSync, existsSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, relative, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import * as esbuild from 'esbuild';
+/** Modules the import map serves. Keys are the bare specifiers app code uses. */
+export const SDK_MODULES = [
+    'firebase/ai',
+    'firebase/app',
+    'firebase/auth',
+    'firebase/firestore',
+    'firebase/database',
+    'firebase/messaging',
+    'firebase/messaging/sw',
+    'firebase/storage',
+];
+/**
+ * The wrapper entries shipped with @pyric/cli, located relative to this
+ * module: compiled `.js` siblings when running from dist (npx install), `.ts`
+ * sources in the workspace (tests / dev). esbuild bundles either.
+ */
+export function defaultSdkEntries() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pick = (name) => {
+        const js = join(here, 'entries', `${name}.js`);
+        if (existsSync(js))
+            return js;
+        const ts = join(here, 'entries', `${name}.ts`);
+        if (existsSync(ts))
+            return ts;
+        throw new Error(`pyric dev: missing SDK entry '${name}' next to ${here}`);
+    };
+    return {
+        ai: pick('ai'),
+        app: pick('app'),
+        auth: pick('auth'),
+        firestore: pick('firestore'),
+        database: pick('database'),
+        messaging: pick('messaging'),
+        'messaging-sw': pick('messaging-sw'),
+        storage: pick('storage'),
+        init: pick('init'),
+    };
+}
+/**
+ * Resolve the built Studio app dir (the plugin's `ui` option + the CLI's
+ * `--ui`). Reached by file path so @pyric/cli never imports `@pyric/studio`:
+ * the packaged location (`dist/serve/studio-ui`, copied at build) or, in the
+ * monorepo, the sibling studio build. Null when neither exists. The standalone
+ * binary embeds these same bytes instead (see `standalone-assets.ts`).
+ */
+export function resolveStudioUiDir() {
+    const candidates = [
+        new URL('./studio-ui/', import.meta.url),
+        new URL('../../../studio/dist/app/', import.meta.url),
+    ];
+    for (const candidate of candidates) {
+        const dir = fileURLToPath(candidate);
+        if (existsSync(dir))
+            return dir;
+    }
+    return null;
+}
+/**
+ * Resolve the built docs site dir (site-docs). `pyric dev --ui` embeds it so
+ * the Studio Docs tab has local docs without the hosted site. Built with base
+ * `/__pyric/ui/` (see scripts/build.sh) so every page/asset/twin URL resolves
+ * under the CLI mount: pages at `/__pyric/ui/docs/<slug>/`, assets at
+ * `/__pyric/ui/_astro/*`, the search index at `/__pyric/ui/docs/index.json`,
+ * and the shell chrome's tab links back at `/__pyric/ui/<tab>`. The dir holds
+ * the site-docs `dist/` verbatim: `docs/`, `_astro/`, `index.html`, `llms.txt`.
+ */
+export function resolveDocsUiDir() {
+    const candidates = [
+        new URL('./docs-ui/', import.meta.url),
+    ];
+    for (const candidate of candidates) {
+        const dir = fileURLToPath(candidate);
+        if (existsSync(dir))
+            return dir;
+    }
+    return null;
+}
+// ─── pyric dist discovery ─────────────────────────────────────────────
+/** Locate the installed pyric package root (works in the workspace and when
+ *  @pyric/cli is npm-installed — pyric is a direct dependency). */
+export function pyricPackageRoot() {
+    // Resolve a real exported subpath, then walk up to the package root.
+    const entry = fileURLToPath(import.meta.resolve('pyric/firestore'));
+    let dir = dirname(entry);
+    while (dir.includes(sep) && !existsSync(join(dir, 'package.json'))) {
+        dir = dirname(dir);
+    }
+    const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+    if (pkg.name !== 'pyric') {
+        throw new Error(`pyric dev: expected to resolve the pyric package, found '${pkg.name}' at ${dir}`);
+    }
+    return dir;
+}
+export function pyricVersion(root = pyricPackageRoot()) {
+    const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
+    return pkg.version ?? '0.0.0';
+}
+// ─── plugins ──────────────────────────────────────────────────────────
+/** Resolve `pyric/*` specifiers from THIS package's own dependency context
+ *  (`import.meta.resolve`) rather than from the entry file's directory —
+ *  entries may live in a temp dir or the user's project, neither of which
+ *  has pyric in scope; @pyric/cli always does (direct dependency). */
+function pyricResolvePlugin() {
+    return {
+        name: 'pyric-serve-resolve-pyric',
+        setup(build) {
+            build.onResolve({ filter: /^pyric(\/|$)/ }, (args) => ({
+                path: fileURLToPath(import.meta.resolve(args.path)),
+            }));
+        },
+    };
+}
+/** The node builtins pyric's browser graph reaches for (via the rules module
+ *  resolver). Bare and `node:`-prefixed both match. */
+export const NODE_BUILTIN_RE = /^(node:)?(url|fs|path)$/;
+/** Benign browser shim SOURCE per builtin (see header — droppable only when
+ *  pyric breaks the `firestore/index → rules/tools → modules/resolver` static
+ *  chain, #553). Exported so the Vite plugin (`./vite`) reuses the SAME shims
+ *  through its own resolveId/load + optimizeDeps esbuild pass, instead of
+ *  re-deriving them. */
+export const NODE_BUILTIN_SHIMS = {
+    fs: `const no = () => { throw new Error('pyric dev: fs is not available in the browser'); };
+export const readFileSync = no; export const existsSync = () => false;
+export const readdirSync = no; export const writeFileSync = no; export const mkdirSync = no;
+export default { readFileSync, existsSync, readdirSync, writeFileSync, mkdirSync };`,
+    url: `export const fileURLToPath = (u) => String(u).replace('file://', '');
+export const pathToFileURL = (p) => new URL('file://' + p);
+export default { fileURLToPath, pathToFileURL };`,
+    path: `export const join = (...p) => p.join('/');
+export const dirname = (p) => p.split('/').slice(0, -1).join('/') || '/';
+export const resolve = (...p) => p.join('/');
+export const basename = (p) => p.split('/').pop() ?? '';
+export default { join, dirname, resolve, basename };`,
+};
+function nodeShimPlugin() {
+    return {
+        name: 'pyric-serve-node-shims',
+        setup(build) {
+            build.onResolve({ filter: NODE_BUILTIN_RE }, (args) => ({
+                path: args.path.replace(/^node:/, ''),
+                namespace: 'pyric-node-shim',
+            }));
+            build.onLoad({ filter: /.*/, namespace: 'pyric-node-shim' }, (args) => ({
+                contents: NODE_BUILTIN_SHIMS[args.path],
+                loader: 'js',
+            }));
+        },
+    };
+}
+/** Bump when bundler logic changes in a way that must invalidate caches. */
+const BUNDLER_REV = 9; // 9: cache keys also cover dependency-resolution metadata
+const RESOLUTION_FILES = [
+    'bun.lock',
+    'bun.lockb',
+    'package-lock.json',
+    'pnpm-lock.yaml',
+    'yarn.lock',
+];
+function nearestPackageRoot(start) {
+    let dir = start;
+    while (true) {
+        if (existsSync(join(dir, 'package.json')))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+/**
+ * Hash package-manager identity separately from executable source bytes.
+ * Workspace dependency upgrades commonly change package.json/bun.lock before
+ * the prerelease package version moves; installed packages get the same signal
+ * from their consumer lockfile. Package managers own third-party byte
+ * integrity, so their manifests/locks are the supported cache boundary.
+ */
+function packageResolutionHash(graphRoot, pyricRoot) {
+    const h = createHash('sha256');
+    const cliRoot = nearestPackageRoot(graphRoot);
+    for (const [label, root] of [
+        ['cli', cliRoot],
+        ['pyric', pyricRoot],
+    ]) {
+        if (!root)
+            continue;
+        const manifest = join(root, 'package.json');
+        if (!existsSync(manifest))
+            continue;
+        h.update(label);
+        h.update(readFileSync(manifest));
+    }
+    let dir = cliRoot ?? graphRoot;
+    while (true) {
+        for (const name of RESOLUTION_FILES) {
+            const file = join(dir, name);
+            if (!existsSync(file))
+                continue;
+            h.update(name);
+            h.update(readFileSync(file));
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return h.digest('hex');
+}
+export function cacheKey(opts, version, graphRoot = dirname(dirname(fileURLToPath(import.meta.url))), pyricRoot = pyricPackageRoot()) {
+    const h = createHash('sha256');
+    h.update(`rev${BUNDLER_REV}`);
+    h.update(version);
+    // Hash the WHOLE local CLI graph, not just entries or entries/ siblings.
+    // Page adapters import worker/client, worker/protocol, bridge, and verify
+    // leaves outside that directory; missing one can pair a stale page client
+    // with a freshly rebuilt worker. The installed pyric implementation is
+    // hashed separately: workspace and prerelease builds can change dist bytes
+    // without changing package.json's version.
+    h.update(sourceTreeHash(graphRoot));
+    h.update(sourceTreeHash(join(pyricRoot, 'dist')));
+    h.update(packageResolutionHash(graphRoot, pyricRoot));
+    for (const [name, file] of Object.entries(opts.entries).sort()) {
+        h.update(name);
+        h.update(readFileSync(file, 'utf8'));
+    }
+    return `${version}-${h.digest('hex').slice(0, 12)}`;
+}
+// ─── the bundle step ──────────────────────────────────────────────────
+export async function bundleSdk(opts) {
+    const root = pyricPackageRoot();
+    const version = pyricVersion(root);
+    const key = cacheKey(opts, version);
+    const cacheRoot = opts.cacheRoot ?? join(homedir(), '.pyric', 'serve-cache');
+    mkdirSync(cacheRoot, { recursive: true });
+    // A running server keeps serving this directory after bundleSdk returns.
+    // Therefore `--no-cache` must never overwrite the deterministic warm-cache
+    // path: another concurrent `pyric dev --no-cache` could otherwise replace
+    // an entry and its shared chunks between browser requests, splitting
+    // singleton module state (notably the app registry). Each bypass build gets
+    // an immutable generation; the OS-level mkdir primitive makes concurrent
+    // callers distinct without coordination.
+    const generationRoot = opts.noCache
+        ? mkdtempSync(join(cacheRoot, `.no-cache-${key}-`))
+        : join(cacheRoot, key);
+    const outDir = join(generationRoot, 'sdk');
+    const dispose = opts.noCache
+        ? () => rmSync(generationRoot, { recursive: true, force: true })
+        : () => { };
+    if (!opts.noCache && existsSync(join(outDir, '.complete'))) {
+        const files = readdirSync(outDir)
+            .filter((f) => f.endsWith('.js'))
+            .map((f) => join(outDir, f));
+        return { outDir, files, cached: true, dispose };
+    }
+    mkdirSync(outDir, { recursive: true });
+    try {
+        const result = await esbuild.build({
+            entryPoints: Object.fromEntries(Object.entries(opts.entries).map(([name, file]) => [name, file])),
+            outdir: outDir,
+            bundle: true,
+            format: 'esm',
+            platform: 'browser',
+            splitting: true,
+            sourcemap: 'linked',
+            minify: opts.minify ?? true,
+            logLevel: 'silent',
+            // Provenance: any stack frame or "view source" into these bundles must
+            // self-identify as the sandbox shim, not the real Firebase SDK.
+            chunkNames: 'pyric-sandbox-[hash]',
+            banner: {
+                js: '/* pyric dev: pyric sandbox shim serving firebase/* — NOT the real Firebase SDK */',
+            },
+            plugins: [pyricResolvePlugin(), nodeShimPlugin()],
+        });
+        if (result.errors.length > 0) {
+            throw new Error(`pyric dev: SDK bundle failed:\n${result.errors.map((e) => e.text).join('\n')}`);
+        }
+        writeFileSync(join(outDir, '.complete'), new Date().toISOString());
+        const files = readdirSync(outDir)
+            .filter((f) => f.endsWith('.js'))
+            .map((f) => join(outDir, f));
+        return { outDir, files, cached: false, dispose };
+    }
+    catch (error) {
+        dispose();
+        throw error;
+    }
+}
+// ─── the SharedWorker bundle (Phase 3c.A) ─────────────────────────────────
+/**
+ * Locate the SharedWorker entry (`worker/entry.ts`) — compiled `.js` sibling
+ * from dist, `.ts` source in the workspace. Same dual-resolution as
+ * `defaultSdkEntries`.
+ */
+export function workerEntryPath() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const js = join(here, 'worker', 'entry.js');
+    if (existsSync(js))
+        return js;
+    const ts = join(here, 'worker', 'entry.ts');
+    if (existsSync(ts))
+        return ts;
+    throw new Error(`pyric dev: missing SharedWorker entry next to ${here}`);
+}
+/**
+ * Content hash of the worker's executable CLI graph + pyric version. The worker bundle
+ * shares the SDK `outDir` (keyed by the SDK entries), which does NOT cover the
+ * worker graph — so the worker bundle carries its OWN content marker. Hash the
+ * full CLI source/dist tree because the worker imports bridge and verify leaves
+ * outside `serve/worker`; an allowlist would silently miss future dependencies.
+ * Installed pyric dist bytes are also hashed because workspace and prerelease
+ * builds can change implementation without a version bump.
+ */
+export function workerSourceHash(pyricRoot = pyricPackageRoot(), graphRoot = dirname(dirname(fileURLToPath(import.meta.url)))) {
+    const h = createHash('sha256');
+    h.update(`rev${BUNDLER_REV}`);
+    h.update(pyricVersion(pyricRoot));
+    h.update(sourceTreeHash(join(pyricRoot, 'dist')));
+    h.update(sourceTreeHash(graphRoot));
+    h.update(packageResolutionHash(graphRoot, pyricRoot));
+    return h.digest('hex').slice(0, 16);
+}
+/** Hash every JS/TS source below a directory, including split host/client leaves. */
+export function sourceTreeHash(root) {
+    const files = [];
+    const visit = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const path = join(dir, entry.name);
+            if (entry.isDirectory())
+                visit(path);
+            else if (entry.isFile() && (entry.name.endsWith('.ts') || entry.name.endsWith('.js'))) {
+                files.push(path);
+            }
+        }
+    };
+    visit(root);
+    const h = createHash('sha256');
+    for (const file of files.sort()) {
+        h.update(relative(root, file).split(sep).join('/'));
+        h.update(readFileSync(file, 'utf8'));
+    }
+    return h.digest('hex');
+}
+/**
+ * Bundle the SharedWorker entry into a single classic worker script served at
+ * `/__pyric/sdk/worker.js`.
+ *
+ * WHY A SEPARATE BUILD (not part of `bundleSdk`'s splitting graph): a
+ * SharedWorker script is loaded by URL into its OWN realm — it cannot share
+ * the page's runtime chunk. So it is bundled standalone: `splitting: false`,
+ * `format: 'iife'` (the client opens it with `new SharedWorker(url, { type:
+ * 'classic' })`), everything inlined into one file. It reuses the same three
+ * browser-standalone plugins as the SDK bundle (pyric-resolve + node-shims +
+ * firebase-stub) so `pyric/*`, node builtins, and the `firebase/*` peer stubs
+ * resolve identically.
+ *
+ * NOTE: the worker legitimately holds the whole sandbox engine — it IS the
+ * backend — so this bundle is large, but it loads ONCE per origin (not per
+ * page). Trimming node/admin dead paths is tracked as Phase 3b.
+ *
+ * The `.worker-complete` marker is independent of `bundleSdk`'s `.complete`,
+ * while `cacheKey()` includes the complete CLI source graph. A worker/client
+ * or protocol edit therefore invalidates the shared SDK generation too, so
+ * the page and worker halves cannot come from different source generations.
+ */
+export async function bundleWorker(opts) {
+    const outFile = join(opts.outDir, 'worker.js');
+    const marker = join(opts.outDir, '.worker-complete');
+    const hash = workerSourceHash();
+    if (!opts.noCache &&
+        existsSync(outFile) &&
+        existsSync(marker) &&
+        readFileSync(marker, 'utf8') === hash) {
+        return outFile;
+    }
+    mkdirSync(opts.outDir, { recursive: true });
+    const root = pyricPackageRoot();
+    const result = await esbuild.build({
+        entryPoints: [workerEntryPath()],
+        outfile: outFile,
+        bundle: true,
+        format: 'iife',
+        platform: 'browser',
+        splitting: false,
+        sourcemap: 'linked',
+        minify: opts.minify ?? true,
+        logLevel: 'silent',
+        // Bake the build hash so the worker can report its version (staleness
+        // guard): the page warns when a still-running OLD worker is older than the
+        // served bundle. Matches the `<meta name="pyric-worker-v">` value.
+        define: { __PYRIC_WORKER_VERSION__: JSON.stringify(hash) },
+        banner: {
+            js: '/* pyric dev: SharedWorker sandbox host serving firebase/* — NOT the real Firebase SDK */',
+        },
+        plugins: [pyricResolvePlugin(), nodeShimPlugin()],
+    });
+    if (result.errors.length > 0) {
+        throw new Error(`pyric dev: SharedWorker bundle failed:\n${result.errors.map((e) => e.text).join('\n')}`);
+    }
+    writeFileSync(marker, hash);
+    return outFile;
+}
+//# sourceMappingURL=bundler.js.map

package/dist/serve/bundler.js.map

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

package/dist/serve/capture-store.d.ts

@@ -0,0 +1,27 @@
+/** Relative path (from project root) where the serve capture lives.
+ *  Mirrors `SERVE_CAPTURE_PATH` in `verify.ts` — keep in lockstep. */
+export declare const CAPTURE_RELATIVE_PATH: string;
+export interface CaptureStore {
+    /** Absolute path of the capture file (`<projectDir>/.pyric/last-session.json`). */
+    path: string;
+    /**
+     * Write the fixture JSON verbatim. Creates `.pyric/` if absent.
+     * The body is the page's own JSON-serialized fixture; we store it
+     * as-is so `pyric verify` can hand it straight to the replay engine.
+     */
+    write(fixtureJson: string): void;
+    /**
+     * Read back the last-written fixture JSON verbatim, or `null` when the
+     * capture file does not exist yet (nothing captured this run). Powers
+     * GET /__pyric/capture, which the served SharedWorker fetches on boot to
+     * re-hydrate its in-memory event history after a worker death.
+     */
+    read(): string | null;
+}
+/**
+ * Create a capture store rooted at `projectDir`. Returns a tiny sink that
+ * mirrors the minimal shape of `state-store.ts`: a `path` for banner
+ * reporting and a `write` for the route handler.
+ */
+export declare function createCaptureStore(projectDir: string): CaptureStore;
+//# sourceMappingURL=capture-store.d.ts.map

package/dist/serve/capture-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-store.d.ts","sourceRoot":"","sources":["../../src/serve/capture-store.ts"],"names":[],"mappings":"AAoBA;sEACsE;AACtE,eAAO,MAAM,qBAAqB,QAAsC,CAAC;AAEzE,MAAM,WAAW,YAAY;IAC3B,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;;;OAKG;IACH,IAAI,IAAI,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAiBnE"}

package/dist/serve/capture-store.js

@@ -0,0 +1,47 @@
+/**
+ * Capture store for `pyric dev --capture` — the write-side of the
+ * `pyric verify` loop.
+ *
+ * `pyric dev` captures the in-page sandbox session (history + snapshot +
+ * rules) and pushes it here whenever the sandbox changes. `pyric verify`
+ * (no positional arg) reads `SERVE_CAPTURE_PATH` and replays it against
+ * your current rules to surface real divergences. The loop is:
+ *
+ *   pyric dev  →  use your app  →  pyric verify
+ *
+ * The body is stored VERBATIM (the page sends its own JSON.stringify'd
+ * fixture — we never re-serialize it so no wrapper-type drift is
+ * introduced here). The path is intentionally next to the persist store
+ * (.pyric/state/…) so it fits the same .gitignore pattern and feels like
+ * one artifact family.
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/** Relative path (from project root) where the serve capture lives.
+ *  Mirrors `SERVE_CAPTURE_PATH` in `verify.ts` — keep in lockstep. */
+export const CAPTURE_RELATIVE_PATH = join('.pyric', 'last-session.json');
+/**
+ * Create a capture store rooted at `projectDir`. Returns a tiny sink that
+ * mirrors the minimal shape of `state-store.ts`: a `path` for banner
+ * reporting and a `write` for the route handler.
+ */
+export function createCaptureStore(projectDir) {
+    const path = join(projectDir, CAPTURE_RELATIVE_PATH);
+    return {
+        path,
+        write(fixtureJson) {
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, fixtureJson);
+        },
+        read() {
+            try {
+                return readFileSync(path, 'utf8');
+            }
+            catch {
+                // ENOENT (nothing captured yet) or any read error → treat as absent.
+                return null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=capture-store.js.map

package/dist/serve/capture-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-store.js","sourceRoot":"","sources":["../../src/serve/capture-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C;sEACsE;AACtE,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;AAoBzE;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;IACrD,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,WAAmB;YACvB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACnC,CAAC;QACD,IAAI;YACF,IAAI,CAAC;gBACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;gBACrE,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/serve/discovery.d.ts

@@ -0,0 +1,71 @@
+/** Ports probed when the pointer is absent — serve's default scan window PLUS
+ *  the vite-plugin default (5174), which the plain 3473+ window would miss (so a
+ *  vite-only project was never found by scan). The standalone `pyric bridge`
+ *  serves `/health` (not `/__pyric/health`) and writes no pointer, so it is
+ *  registered directly via `claude mcp add`, not discovered here. */
+export declare const SCAN_PORTS: number[];
+export declare const POINTER: string;
+export interface HealthLite {
+    mode?: string;
+    instanceId?: string;
+    /** Whether a browser tab is currently connected as the sandbox peer. */
+    sandboxConnected?: boolean;
+}
+export interface Discovered {
+    mcpUrl: string;
+    /**
+     * The CANONICAL display URL — what a human/browser should OPEN. Comes from
+     * the serve-written pointer when present (`http://localhost:<port>` for the
+     * default host, the explicit `--host` otherwise); falls back to
+     * `http://localhost:<port>`. NEVER a literal loopback address: to a browser
+     * `localhost` and `127.0.0.1` are DIFFERENT ORIGINS (different
+     * SharedWorkers, so different sandboxes), and serve's banner/auto-open use
+     * `localhost` — guidance built from this field must land on the SAME origin.
+     * Node-side connectivity uses `base`/`mcpUrl` instead.
+     */
+    url: string;
+    /** `http://<family>:<port>` the server actually answered on. */
+    base: string;
+    /** Identity pinned at discovery. Null only when talking to an older server
+     *  that predates the instanceId field (matching is then skipped). */
+    instanceId: string | null;
+    source: string;
+}
+/**
+ * Probe BOTH loopback families on a port and return the base that answers.
+ *
+ * Hostname-based URLs are a trap here: serve writes `http://localhost:...`
+ * for humans (browsers dual-stack fine), but `localhost` resolution differs
+ * by runtime — node/undici prefers IPv6 `::1`, and a serve under one runtime
+ * may bind `127.0.0.1`-only while under another binds `::1`-only. So a
+ * discovery client never trusts the hostname: it takes the PORT and tries
+ * explicit `127.0.0.1` and `[::1]`, using whichever the server is actually on.
+ */
+export declare function basesForPort(port: number): string[];
+export declare function probeHealth(base: string): Promise<HealthLite | null>;
+/**
+ * First loopback base on `port` whose health reports a sandbox bridge. With an
+ * `expectedInstanceId`, returns ONLY a family whose health identity matches —
+ * so when two sandboxes collide on one port across families, the client locks
+ * onto the one the pointer names, not merely the first to answer. (An older
+ * server with no `instanceId` field can't be identity-checked; matching is
+ * skipped in that case so the pointer still resolves.)
+ */
+export declare function healthyBase(port: number, expectedInstanceId?: string | null): Promise<{
+    base: string;
+    instanceId: string | null;
+} | null>;
+/**
+ * Canonical display URL for a serve on `port`. Prefers the pointer's own
+ * `url` (serve writes `http://<requested host>:<port>` — `localhost` for the
+ * default, the explicit `--host` otherwise) so guidance shares the origin the
+ * banner/auto-open used; falls back to `http://localhost:<port>` (browsers
+ * resolve `localhost` dual-stack, so it reaches either loopback family).
+ */
+export declare function canonicalServeUrl(port: number, pointerUrl?: string): string;
+/** Find the running serve: pointer first (in `cwd`), then a port scan. The
+ *  pointer gives the PORT and (when present) the identity; the family is
+ *  resolved by probing, so the returned base always uses the address the
+ *  server is actually reachable on. */
+export declare function discoverServe(cwd: string, log?: (m: string) => void, scanPorts?: number[]): Promise<Discovered | null>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/serve/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/serve/discovery.ts"],"names":[],"mappings":"AAqBA;;;;qEAIqE;AACrE,eAAO,MAAM,UAAU,UAAuC,CAAC;AAC/D,eAAO,MAAM,OAAO,QAA+B,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;;OASG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb;yEACqE;IACrE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnD;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAS1E;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,GACjC,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAAC,CAU7D;AAQD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAY3E;AAED;;;uCAGuC;AACvC,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAe,EAGnC,SAAS,GAAE,MAAM,EAAe,GAC/B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAwD5B"}