@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/preview-runtime.d.ts

@@ -0,0 +1,33 @@
+import type { PreviewHandlers } from './dashboard/telefunc-serve.js';
+/** Inputs to {@link createPreviewRuntime}. */
+export interface PreviewRuntimeOptions {
+    /** The daemon's home id, so a request with no project id targets the home workspace. */
+    homeId: string;
+    /** Resolve a project id to its checkout path (or the home `cwd`); shared with the run runtime. */
+    resolveProject: (id: string | undefined) => Promise<string | undefined>;
+}
+/** The preview surface the dashboard drives, plus the teardown that outlives the daemon. */
+export interface PreviewRuntime {
+    /** The Preview handler set (#475/#797), handed to the dashboard as one value so `runId` survives. */
+    preview: PreviewHandlers;
+    /** Stop every live preview so their dev servers do not outlive the daemon (#475). */
+    dispose: () => Promise<void>;
+}
+/**
+ * On-demand app preview (#475), one long-lived preview process per project (plus one per session that
+ * asks, #797), kept alive across the request that opens it and the Stop that closes it. Split out of
+ * the project runtime because it shares nothing with the run half but the project resolver and the
+ * key scheme: previews know nothing about runs, and the run half reaches in only to stop a finished
+ * run's preview.
+ *
+ * Track a preview under its key and evict it the moment it stops serving (stop, or a self-exit: crash
+ * / build error / the user killing it), so status never reports a dead URL and the idempotent open
+ * below never hands back a corpse instead of restarting.
+ *
+ * Since #797 the key carries the session too, because a session serves its OWN worktree: one preview
+ * per project as before, plus one per session that asks for it, each pointing at the tree it belongs
+ * to. Keyed by project alone, a session's Serve booted the project's checkout and showed you code
+ * that session never wrote.
+ */
+export declare function createPreviewRuntime({ homeId, resolveProject }: PreviewRuntimeOptions): PreviewRuntime;
+//# sourceMappingURL=preview-runtime.d.ts.map

package/dist/preview-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-runtime.d.ts","sourceRoot":"","sources":["../src/preview-runtime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAIpE,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAA;IACd,kGAAkG;IAClG,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CACxE;AAED,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC7B,qGAAqG;IACrG,OAAO,EAAE,eAAe,CAAA;IACxB,qFAAqF;IACrF,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,qBAAqB,GAAG,cAAc,CAqEtG"}

package/dist/preview-runtime.js

@@ -0,0 +1,96 @@
+import { resolveRunCheckout } from './store/index.js';
+import { startPreview, detectServeTargets } from './preview.js';
+import { scopedKey } from './runtime-keys.js';
+import { errorMessage } from './error-message.js';
+/**
+ * On-demand app preview (#475), one long-lived preview process per project (plus one per session that
+ * asks, #797), kept alive across the request that opens it and the Stop that closes it. Split out of
+ * the project runtime because it shares nothing with the run half but the project resolver and the
+ * key scheme: previews know nothing about runs, and the run half reaches in only to stop a finished
+ * run's preview.
+ *
+ * Track a preview under its key and evict it the moment it stops serving (stop, or a self-exit: crash
+ * / build error / the user killing it), so status never reports a dead URL and the idempotent open
+ * below never hands back a corpse instead of restarting.
+ *
+ * Since #797 the key carries the session too, because a session serves its OWN worktree: one preview
+ * per project as before, plus one per session that asks for it, each pointing at the tree it belongs
+ * to. Keyed by project alone, a session's Serve booted the project's checkout and showed you code
+ * that session never wrote.
+ */
+export function createPreviewRuntime({ homeId, resolveProject }) {
+    const activePreviews = new Map();
+    const trackPreview = (key, handle) => {
+        activePreviews.set(key, handle);
+        void handle.exited.then(() => {
+            if (activePreviews.get(key) === handle)
+                activePreviews.delete(key);
+        });
+    };
+    // The app the user last served per project (#651), so re-serving a monorepo picks it again
+    // without re-choosing. In-memory: a live preview already rehydrates via onPreviewStatus, and
+    // the pick resets on daemon restart (the picker still lists everything).
+    const lastServeTarget = new Map();
+    const onServeTargets = async (targetProjectId, runId) => {
+        const projectCwd = await resolveProject(targetProjectId);
+        if (!projectCwd)
+            return [];
+        // Detected in the checkout that will actually be served: a session's branch may have added or
+        // removed a servable package, and offering the project's list would offer apps it cannot serve.
+        const serveCwd = await resolveRunCheckout(projectCwd, runId);
+        return detectServeTargets(serveCwd).catch(() => []);
+    };
+    const onPreview = async (targetProjectId, targetId, runId) => {
+        const projectKey = targetProjectId ?? homeId;
+        const key = scopedKey(projectKey, runId);
+        const existing = activePreviews.get(key);
+        if (existing)
+            return { ok: true, url: existing.url, command: existing.command };
+        const projectCwd = await resolveProject(targetProjectId);
+        if (!projectCwd)
+            return { ok: false, error: `unknown project: ${targetProjectId}` };
+        const serveCwd = await resolveRunCheckout(projectCwd, runId);
+        try {
+            // Resolve the pick: an explicit choice, else the one remembered from last time. Both are
+            // matched against the live target list so a stale/unknown id falls back to the root default.
+            // The memory is per project, not per session: which app you serve is a property of the repo.
+            const wantId = targetId ?? lastServeTarget.get(projectKey);
+            const target = wantId ? (await detectServeTargets(serveCwd).catch(() => [])).find(t => t.id === wantId) : undefined;
+            const handle = await startPreview(target ? { cwd: serveCwd, target } : { cwd: serveCwd });
+            // A racing second open won the slot while we were booting: keep theirs, drop ours.
+            const raced = activePreviews.get(key);
+            if (raced) {
+                await handle.stop().catch(() => { });
+                return { ok: true, url: raced.url, command: raced.command };
+            }
+            if (target)
+                lastServeTarget.set(projectKey, target.id);
+            trackPreview(key, handle);
+            return { ok: true, url: handle.url, command: handle.command };
+        }
+        catch (err) {
+            return { ok: false, error: errorMessage(err) };
+        }
+    };
+    const onStopPreview = async (targetProjectId, runId) => {
+        const key = scopedKey(targetProjectId ?? homeId, runId);
+        const handle = activePreviews.get(key);
+        if (!handle)
+            return;
+        activePreviews.delete(key);
+        await handle.stop().catch(() => { });
+    };
+    const onPreviewStatus = (targetProjectId, runId) => {
+        const handle = activePreviews.get(scopedKey(targetProjectId ?? homeId, runId));
+        return handle ? { running: true, url: handle.url, command: handle.command } : { running: false };
+    };
+    const dispose = async () => {
+        await Promise.all([...activePreviews.values()].map(p => p.stop().catch(() => { })));
+        activePreviews.clear();
+    };
+    return {
+        preview: { start: onPreview, targets: onServeTargets, stop: onStopPreview, status: onPreviewStatus },
+        dispose,
+    };
+}
+//# sourceMappingURL=preview-runtime.js.map

package/dist/preview-runtime.js.map

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

package/dist/preview.d.ts

@@ -0,0 +1,78 @@
+/**
+ * On-demand app preview (#475): serve a project's built result from the dashboard
+ * without an agent run. This is the decoupled twin of the run's serve gate — where
+ * that boots the app to *verify* it, this boots it to *show* it (a one-click Preview
+ * button, useful for non-technical users too). It runs entirely in the daemon
+ * process: the project's dev script when it has one, else a built-in static server
+ * for a plain `index.html`. Kept a quick-win (#475): a URL + a Stop, not a full
+ * in-dashboard preview view.
+ */
+/** A running preview: its URL, how it was served, and a teardown. */
+export interface PreviewHandle {
+    /** The reachable localhost URL. */
+    url: string;
+    /** The npm script serving it (e.g. `dev`), or `static` for the built-in file server. */
+    command: string;
+    /** Stop the preview and free its port. Idempotent. */
+    stop(): Promise<void>;
+    /**
+     * Resolves when the preview is no longer serving — on {@link stop}, or when the dev
+     * server exits on its own (a crash, a build error, the user killing it). The daemon
+     * watches this to evict a dead preview so the next open restarts it (#475).
+     */
+    exited: Promise<void>;
+}
+/** Options for {@link startPreview}. */
+export interface StartPreviewOptions {
+    /** The project directory to serve. */
+    cwd: string;
+    /**
+     * Which app to serve in a multi-package repo (#651), from {@link detectServeTargets}. Absent
+     * serves the root package (the single-package default), preserving the original behavior.
+     */
+    target?: ServeTarget;
+    /** How long to wait for a dev script to print its localhost URL before giving up. Default 20s. */
+    waitMs?: number;
+}
+/** The npm scripts we try, best-first, when serving a project's dev preview. */
+export declare const PREVIEW_SCRIPTS: readonly ["dev", "start", "preview", "serve"];
+/** The first {@link PREVIEW_SCRIPTS} entry the project's `package.json` defines, else undefined. */
+export declare function detectDevScript(cwd: string): Promise<string | undefined>;
+/**
+ * One servable app in a repo (#651): a package that defines a dev/serve script. Plain repos
+ * have exactly one (the root); a monorepo has one per workspace package that can serve, and
+ * the dashboard offers a picker over them.
+ */
+export interface ServeTarget {
+    /** Stable id = the dir relative to the repo root, or `.` for the root package itself. */
+    id: string;
+    /** Human label: the package.json `name`, else the directory basename (`.` → `root`). */
+    label: string;
+    /** The dir to run the script in, relative to the repo root (`''` = the root). */
+    dir: string;
+    /** The npm script that serves it (a {@link PREVIEW_SCRIPTS} entry). */
+    script: string;
+}
+/**
+ * Enumerate the repo's servable apps (#651), best-first: the root package (when it has a serve
+ * script) followed by each workspace package that has one, in path order. A plain single-package
+ * repo yields at most one target (the root); a monorepo yields one per servable workspace so the
+ * Serve button can offer a pick. Workspaces come from `pnpm-workspace.yaml` or the package.json
+ * `workspaces` field; unreadable/absent config just yields the root (or nothing).
+ */
+export declare function detectServeTargets(cwd: string): Promise<ServeTarget[]>;
+/**
+ * Parse the first browsable localhost URL a dev server prints (Vite, Next, CRA, and
+ * friends all announce one), normalizing `0.0.0.0` to `localhost` and trimming any
+ * trailing punctuation. Returns undefined when the output carries no such URL yet.
+ */
+export declare function parsePreviewUrl(output: string): string | undefined;
+/**
+ * Start a live preview of the project. Prefers its dev script (spawned as its own
+ * process group so {@link PreviewHandle.stop} kills the whole tree), and reads the
+ * localhost URL the server announces on stdout/stderr. With no dev script, falls back
+ * to a built-in static server when the project has an `index.html`. Throws when there
+ * is nothing to serve, or the dev script never announces a URL.
+ */
+export declare function startPreview(opts: StartPreviewOptions): Promise<PreviewHandle>;
+//# sourceMappingURL=preview.d.ts.map

package/dist/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAUA;;;;;;;;GAQG;AAEH,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,wFAAwF;IACxF,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAA;IACX;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,kGAAkG;IAClG,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,gFAAgF;AAChF,eAAO,MAAM,eAAe,+CAAgD,CAAA;AAQ5E,oGAAoG;AACpG,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE9E;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,yFAAyF;IACzF,EAAE,EAAE,MAAM,CAAA;IACV,wFAAwF;IACxF,KAAK,EAAE,MAAM,CAAA;IACb,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAA;IACX,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAA;CACf;AAKD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAmB5E;AAwGD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIlE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAWpF"}

package/dist/preview.js

@@ -0,0 +1,301 @@
+import { spawn } from 'node:child_process';
+import { createServer } from 'node:http';
+import { createReadStream } from 'node:fs';
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { basename, join, normalize, sep } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { contentTypeFor } from './dashboard/content-type.js';
+/** The npm scripts we try, best-first, when serving a project's dev preview. */
+export const PREVIEW_SCRIPTS = ['dev', 'start', 'preview', 'serve'];
+/** The first {@link PREVIEW_SCRIPTS} entry a `package.json`'s `scripts` defines, else undefined. */
+function pickScript(scripts) {
+    const s = scripts ?? {};
+    return PREVIEW_SCRIPTS.find(name => typeof s[name] === 'string' && s[name].trim() !== '');
+}
+/** The first {@link PREVIEW_SCRIPTS} entry the project's `package.json` defines, else undefined. */
+export async function detectDevScript(cwd) {
+    return pickScript((await readPkg(cwd))?.scripts);
+}
+/** How many workspace packages we scan / offer, so a pathological monorepo can't hang or flood the picker. */
+const MAX_SERVE_TARGETS = 50;
+/**
+ * Enumerate the repo's servable apps (#651), best-first: the root package (when it has a serve
+ * script) followed by each workspace package that has one, in path order. A plain single-package
+ * repo yields at most one target (the root); a monorepo yields one per servable workspace so the
+ * Serve button can offer a pick. Workspaces come from `pnpm-workspace.yaml` or the package.json
+ * `workspaces` field; unreadable/absent config just yields the root (or nothing).
+ */
+export async function detectServeTargets(cwd) {
+    const targets = [];
+    const seen = new Set();
+    const add = async (dir) => {
+        const abs = dir === '' ? cwd : join(cwd, dir);
+        if (seen.has(abs))
+            return;
+        seen.add(abs);
+        const pkg = await readPkg(abs);
+        const script = pickScript(pkg?.scripts);
+        if (!script)
+            return;
+        targets.push({ id: dir === '' ? '.' : dir, label: serveLabel(pkg?.name, dir), dir, script });
+    };
+    await add('');
+    const rootPkg = await readPkg(cwd);
+    for (const dir of await workspaceDirs(cwd, rootPkg)) {
+        if (targets.length >= MAX_SERVE_TARGETS)
+            break;
+        await add(dir);
+    }
+    return targets;
+}
+/** A target's display label: its package name, else the dir basename (`.`/root → `root`). */
+function serveLabel(name, dir) {
+    if (typeof name === 'string' && name.trim() !== '')
+        return name.trim();
+    const base = basename(dir);
+    return base === '' || base === '.' ? 'root' : base;
+}
+/** Read and parse a directory's `package.json`, or undefined when absent/unreadable/malformed. */
+async function readPkg(dir) {
+    try {
+        return JSON.parse(await readFile(join(dir, 'package.json'), 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The workspace package directories (relative to `cwd`), from `pnpm-workspace.yaml` `packages:`
+ * or the package.json `workspaces` field, expanded from their globs. Order is stable (sorted).
+ */
+async function workspaceDirs(cwd, rootPkg) {
+    const globs = await workspaceGlobs(cwd, rootPkg);
+    const dirs = new Set();
+    for (const glob of globs) {
+        for (const dir of await expandWorkspaceGlob(cwd, glob))
+            dirs.add(dir);
+    }
+    return [...dirs].sort();
+}
+/** The raw workspace globs: pnpm's `pnpm-workspace.yaml` wins, else npm/yarn's `workspaces`. */
+async function workspaceGlobs(cwd, rootPkg) {
+    try {
+        const doc = parseYaml(await readFile(join(cwd, 'pnpm-workspace.yaml'), 'utf8'));
+        const pkgs = doc?.packages;
+        if (Array.isArray(pkgs))
+            return pkgs.filter((g) => typeof g === 'string');
+    }
+    catch {
+        // no pnpm-workspace.yaml — fall through to the package.json workspaces field
+    }
+    const ws = rootPkg?.workspaces;
+    const list = Array.isArray(ws) ? ws : Array.isArray(ws?.packages) ? ws.packages : [];
+    return list.filter((g) => typeof g === 'string');
+}
+/**
+ * Expand one workspace glob to the package dirs it matches (relative to `cwd`). Handles the shapes
+ * real workspaces use — a literal dir, a single `*` segment (`packages/*`), and a trailing `**`
+ * (`packages/**`) — by walking the directory tree rather than pulling in a glob dependency. Negations
+ * (`!`) and dirs without a `package.json` are skipped; the walk is depth-bounded for `**`.
+ */
+async function expandWorkspaceGlob(cwd, glob) {
+    if (glob.startsWith('!'))
+        return []; // exclusion patterns: skip, we only add positives
+    const parts = glob.replace(/\/+$/, '').split('/');
+    const out = [];
+    let visited = 0;
+    const walk = async (relDir, i) => {
+        if (++visited > 2000)
+            return; // bound the tree walk so a pathological repo can't hang the picker
+        if (i === parts.length) {
+            if (await hasPkg(join(cwd, relDir)))
+                out.push(relDir);
+            return;
+        }
+        const seg = parts[i];
+        if (seg === '**') {
+            // Match this dir and any descendant (bounded), then continue past the `**`.
+            await walk(relDir, i + 1);
+            for (const child of await subdirs(join(cwd, relDir)))
+                await walk(join(relDir, child), i);
+            return;
+        }
+        if (seg === '*') {
+            for (const child of await subdirs(join(cwd, relDir)))
+                await walk(join(relDir, child), i + 1);
+            return;
+        }
+        await walk(relDir === '' ? seg : join(relDir, seg), i + 1);
+    };
+    await walk('', 0);
+    return out;
+}
+/** The immediate child directory names of `dir` (excluding dotfiles and `node_modules`), or []. */
+async function subdirs(dir) {
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries.filter(e => e.isDirectory() && e.name !== 'node_modules' && !e.name.startsWith('.')).map(e => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+/** Whether `dir` holds a `package.json` (marking a workspace package). */
+async function hasPkg(dir) {
+    return stat(join(dir, 'package.json')).then(s => s.isFile()).catch(() => false);
+}
+// Strip ANSI color codes (dev servers print their URL in color) before matching.
+const ANSI = /\[[0-9;]*m/g;
+const LOCAL_URL = /https?:\/\/(?:localhost|127\.0\.0\.1|0\.0\.0\.0)(?::\d+)?(?:\/[^\s'"]*)?/i;
+/**
+ * Parse the first browsable localhost URL a dev server prints (Vite, Next, CRA, and
+ * friends all announce one), normalizing `0.0.0.0` to `localhost` and trimming any
+ * trailing punctuation. Returns undefined when the output carries no such URL yet.
+ */
+export function parsePreviewUrl(output) {
+    const match = output.replace(ANSI, '').match(LOCAL_URL);
+    if (!match)
+        return undefined;
+    return match[0].replace(/^(https?:\/\/)0\.0\.0\.0/, '$1localhost').replace(/[.,;:)\]]+$/, '');
+}
+/**
+ * Start a live preview of the project. Prefers its dev script (spawned as its own
+ * process group so {@link PreviewHandle.stop} kills the whole tree), and reads the
+ * localhost URL the server announces on stdout/stderr. With no dev script, falls back
+ * to a built-in static server when the project has an `index.html`. Throws when there
+ * is nothing to serve, or the dev script never announces a URL.
+ */
+export async function startPreview(opts) {
+    // A picked target (#651) serves that workspace package; otherwise fall back to the root package.
+    if (opts.target) {
+        const dir = opts.target.dir === '' ? opts.cwd : join(opts.cwd, opts.target.dir);
+        return startDevServer(dir, opts.target.script, opts.waitMs ?? 20_000);
+    }
+    const script = await detectDevScript(opts.cwd);
+    if (script)
+        return startDevServer(opts.cwd, script, opts.waitMs ?? 20_000);
+    const hasIndex = await stat(join(opts.cwd, 'index.html')).then(s => s.isFile()).catch(() => false);
+    if (hasIndex)
+        return startStaticServer(opts.cwd);
+    throw new Error('nothing to preview: the project has no dev script and no index.html');
+}
+/** Run the project's dev script and resolve once it announces a localhost URL. */
+async function startDevServer(cwd, script, waitMs) {
+    const command = `npm run ${script}`;
+    // Own process group (detached) so stop() can SIGTERM the whole tree, not just npm.
+    const child = spawn('npm', ['run', script], { cwd, env: process.env, detached: true });
+    try {
+        const url = await new Promise((resolvePromise, reject) => {
+            let output = '';
+            const timer = setTimeout(() => reject(new Error(`the "${script}" script did not print a localhost URL within ${Math.round(waitMs / 1000)}s`)), waitMs);
+            const settle = (fn) => {
+                clearTimeout(timer);
+                child.stdout?.off('data', onData);
+                child.stderr?.off('data', onData);
+                child.off('exit', onExit);
+                child.off('error', onError);
+                fn();
+            };
+            const onData = (d) => {
+                output += d.toString();
+                const found = parsePreviewUrl(output);
+                if (found)
+                    settle(() => resolvePromise(found));
+            };
+            const onExit = () => settle(() => reject(new Error(`the "${script}" script exited before printing a URL`)));
+            const onError = (err) => settle(() => reject(err));
+            child.stdout?.on('data', onData);
+            child.stderr?.on('data', onData);
+            child.once('exit', onExit);
+            child.once('error', onError);
+        });
+        // Resolves whether the child is killed by stop() or exits on its own (crash/build error).
+        const exited = new Promise(resolvePromise => child.once('exit', () => resolvePromise()));
+        return { url, command, exited, stop: () => stopChild(child) };
+    }
+    catch (err) {
+        await stopChild(child);
+        throw err;
+    }
+}
+/** SIGTERM the child's process group, escalating to SIGKILL, and resolve once it exits. */
+function stopChild(child) {
+    return new Promise(resolvePromise => {
+        if (child.exitCode !== null || child.signalCode)
+            return resolvePromise();
+        let done = false;
+        const finish = () => {
+            if (done)
+                return;
+            done = true;
+            resolvePromise();
+        };
+        child.once('exit', finish);
+        const kill = (sig) => {
+            try {
+                if (child.pid)
+                    process.kill(-child.pid, sig);
+            }
+            catch {
+                // group already gone
+            }
+        };
+        kill('SIGTERM');
+        setTimeout(() => {
+            kill('SIGKILL');
+            finish();
+        }, 3000).unref();
+    });
+}
+/** A built-in static file server for a project with a plain `index.html` and no dev script. */
+async function startStaticServer(cwd) {
+    const server = createServer((req, res) => void serveStaticFile(cwd, req.url ?? '/', res));
+    await new Promise((resolvePromise, reject) => {
+        server.once('error', reject);
+        server.listen(0, '127.0.0.1', () => resolvePromise());
+    });
+    const port = server.address().port;
+    const exited = new Promise(resolvePromise => server.once('close', () => resolvePromise()));
+    return {
+        url: `http://localhost:${port}`,
+        command: 'static',
+        exited,
+        stop: () => new Promise(resolvePromise => {
+            // Destroy any lingering keep-alive sockets so close() cannot hang on an open tab.
+            server.closeAllConnections?.();
+            server.close(() => resolvePromise());
+        }),
+    };
+}
+/** Serve one file from `root`, defaulting `/` to `index.html`, refusing path traversal. */
+async function serveStaticFile(root, urlPath, res) {
+    // A malformed escape (`/%zz`) must not throw: this runs void-dispatched, so an
+    // exception here would be an unhandled rejection that takes the process down (#938).
+    let decoded;
+    try {
+        decoded = decodeURIComponent(urlPath.split('?')[0]);
+    }
+    catch {
+        res.writeHead(400, { 'content-type': 'text/plain' }).end('bad request');
+        return;
+    }
+    const rel = normalize(decoded).replace(/^(\.\.[/\\])+/, '');
+    // `join(root, '.')` drops a trailing separator, so a `dir/`-shaped cwd cannot fail the prefix check.
+    const base = join(root, '.');
+    const target = join(base, rel === '/' || rel === '.' || rel === '' ? 'index.html' : rel);
+    // Refuse anything that escaped the root after normalization.
+    if (target !== base && !target.startsWith(base + sep)) {
+        res.writeHead(403, { 'content-type': 'text/plain' }).end('forbidden');
+        return;
+    }
+    const info = await stat(target).catch(() => undefined);
+    const file = info?.isDirectory() ? join(target, 'index.html') : target;
+    const fileInfo = info?.isDirectory() ? await stat(file).catch(() => undefined) : info;
+    if (!fileInfo?.isFile()) {
+        res.writeHead(404, { 'content-type': 'text/plain' }).end('not found');
+        return;
+    }
+    res.writeHead(200, { 'content-type': contentTypeFor(file) });
+    createReadStream(file).pipe(res);
+}
+//# sourceMappingURL=preview.js.map

package/dist/preview.js.map

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

package/dist/project-commands.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A project's commands (#1774): the skills written to be run by a person, read off the folders
+ * the coding agents read them from. The framework ships no prompt text; what a project can be
+ * asked to do is what its own command skills say. A skill that teaches the agent how to do
+ * something (the tickets, the queue) is not a command: typed alone it starts an agent with
+ * nothing to do, so the launcher does not list it.
+ */
+/** Where coding agents read a project's skills: Claude Code's folder, and the shared one Codex reads. */
+export declare const SKILLS_DIRS: readonly ['.claude/skills', '.agents/skills'];
+/** One skill as the launcher shows it. */
+export interface ProjectCommand {
+    /** What is typed after the slash: the skill's folder name. */
+    name: string;
+    /** The `description` of the skill's front matter, when it has one. */
+    description?: string;
+}
+/**
+ * The project's commands, by name: the skills whose front matter says
+ * `disable-model-invocation: true`, written to be run by a person or a runner and never picked
+ * up by the agent on its own. A skill in both folders is listed once. A folder without a
+ * readable `SKILL.md` is skipped, and a project with no skills folder has no commands.
+ */
+export declare function readProjectCommands(cwd: string): Promise<ProjectCommand[]>;
+//# sourceMappingURL=project-commands.d.ts.map

package/dist/project-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-commands.d.ts","sourceRoot":"","sources":["../src/project-commands.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,yGAAyG;AACzG,eAAO,MAAM,WAAW,YAAI,gBAAgB,EAAE,gBAAgB,CAAU,CAAA;AAExE,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAqBhF"}

package/dist/project-commands.js

@@ -0,0 +1,57 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+/**
+ * A project's commands (#1774): the skills written to be run by a person, read off the folders
+ * the coding agents read them from. The framework ships no prompt text; what a project can be
+ * asked to do is what its own command skills say. A skill that teaches the agent how to do
+ * something (the tickets, the queue) is not a command: typed alone it starts an agent with
+ * nothing to do, so the launcher does not list it.
+ */
+/** Where coding agents read a project's skills: Claude Code's folder, and the shared one Codex reads. */
+export const SKILLS_DIRS = ['.claude/skills', '.agents/skills'];
+/**
+ * The project's commands, by name: the skills whose front matter says
+ * `disable-model-invocation: true`, written to be run by a person or a runner and never picked
+ * up by the agent on its own. A skill in both folders is listed once. A folder without a
+ * readable `SKILL.md` is skipped, and a project with no skills folder has no commands.
+ */
+export async function readProjectCommands(cwd) {
+    const commands = new Map();
+    // A skill's first readable copy decides, as with the coding agent: a later folder's copy of a
+    // skill already read is not looked at, command or not.
+    const read = new Set();
+    for (const dir of SKILLS_DIRS) {
+        const entries = await readdir(join(cwd, dir), { withFileTypes: true }).catch(() => []);
+        for (const entry of entries) {
+            if (read.has(entry.name) || !/^[a-z0-9][a-z0-9-]*$/.test(entry.name))
+                continue;
+            const raw = await readFile(join(cwd, dir, entry.name, 'SKILL.md'), 'utf8').catch(() => undefined);
+            if (raw === undefined)
+                continue;
+            read.add(entry.name);
+            const front = frontMatter(raw);
+            if (front['disable-model-invocation'] !== true)
+                continue;
+            commands.set(entry.name, {
+                name: entry.name,
+                ...(typeof front['description'] === 'string' && front['description'].trim() ? { description: front['description'].trim() } : {}),
+            });
+        }
+    }
+    return [...commands.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+/** The YAML front matter of a markdown file as a map; none, or one that does not parse, is empty. */
+function frontMatter(raw) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(raw);
+    if (!match)
+        return {};
+    try {
+        const data = parseYaml(match[1]);
+        return data && typeof data === 'object' && !Array.isArray(data) ? data : {};
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=project-commands.js.map

package/dist/project-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-commands.js","sourceRoot":"","sources":["../src/project-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAA;AAEzC;;;;;;GAMG;AAEH,yGAAyG;AACzG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,CAAU,CAAA;AAUxE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW;IACnD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAA;IAClD,8FAA8F;IAC9F,uDAAuD;IACvD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QACtF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAQ;YAC9E,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;YACjG,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAQ;YAC/B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACpB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;YAC9B,IAAI,KAAK,CAAC,0BAA0B,CAAC,KAAK,IAAI;gBAAE,SAAQ;YACxD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;gBACvB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,CAAC,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjI,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;AAC5E,CAAC;AAED,qGAAqG;AACrG,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,IAAI,CAAC;QACH,MAAM,IAAI,GAAY,SAAS,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAA;QAC1C,OAAO,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAgC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC"}