@openagt/dashboard 0.8.0 → 0.9.0

package/dist/preview.d.ts

@@ -1,78 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,301 +0,0 @@
-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

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

package/dist/project-widgets.d.ts

@@ -1,46 +0,0 @@
-import { type PackageCommandResult } from '@gemstack/agent-data';
-/**
- * A dashboard widget one of a project's packages brings (#1774): the package's own browser module,
- * named by its `exports["./dashboard"]`. The framework names no package: any dependency of the
- * project that exports `./dashboard` is a widget, whoever wrote it.
- */
-export interface ProjectWidget {
-    /** The package's name, as the project's package.json lists it. */
-    package: string;
-    /** The package's version, when its package.json says one. */
-    version?: string;
-    /** The directory the widget's module sits in, symlinks resolved: the only directory served for it. */
-    dir: string;
-    /** The widget module's file name inside {@link dir}. */
-    entry: string;
-    /** The package's commands, by name, as absolute paths: what the widget may run in this project. */
-    bins: Record<string, string>;
-}
-/**
- * The widgets a project's packages bring: each of the project's dependencies whose package.json
- * exports `./dashboard` to a file that exists inside the package. Sorted by name.
- */
-export declare function readProjectWidgets(root: string): Promise<ProjectWidget[]>;
-/** The one widget of this project that `name` names, or undefined. */
-export declare function findProjectWidget(root: string, name: string): Promise<ProjectWidget | undefined>;
-/**
- * The file a widget serves at `rel`, a path relative to its module's directory: its module, its
- * stylesheet, a chunk. `undefined` for a path that leaves that directory (symlinks resolved) or
- * names no file, so nothing else of the package, and nothing of the project, is ever served.
- */
-export declare function widgetFile(widget: ProjectWidget, rel: string): Promise<string | undefined>;
-/** What a widget's command answered: its JSON output, or why there is none. */
-export type WidgetCommandResult = PackageCommandResult;
-/**
- * Run one of a widget package's own commands in the project, with the given arguments, and read
- * its standard output as JSON. This is how a widget reads its data: the same command an agent runs
- * (`npx logs`), so the widget and the agent see the same thing and the framework knows neither.
- *
- * `command` picks one of the package's commands; a package with exactly one needs none. The
- * command runs with Node (a package's commands are Node scripts), in the project root, never
- * through a shell, bounded in time and output. Refused: a command the package does not have, too
- * many or too long arguments. A command that exits non-zero answers its last stderr line; one that
- * prints no JSON says so.
- */
-export declare function runWidgetCommand(root: string, widget: ProjectWidget, args: readonly string[], command?: string): Promise<WidgetCommandResult>;
-//# sourceMappingURL=project-widgets.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"project-widgets.d.ts","sourceRoot":"","sources":["../src/project-widgets.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmD,KAAK,oBAAoB,EAAuB,MAAM,sBAAsB,CAAA;AAEtI;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sGAAsG;IACtG,GAAG,EAAE,MAAM,CAAA;IACX,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAA;IACb,mGAAmG;IACnG,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7B;AAoBD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAO/E;AAgBD,sEAAsE;AACtE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAEtG;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAKhG;AAED,+EAA+E;AAC/E,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAA;AAMtD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CAS9B"}

package/dist/project-widgets.js

@@ -1,93 +0,0 @@
-import { realpath, stat } from 'node:fs/promises';
-import { dirname, join, normalize, sep } from 'node:path';
-import { packageBins, projectPackages, runPackageCommand } from '@gemstack/agent-data';
-/** The file an `exports["./dashboard"]` entry names: a plain path, or the `browser`/`import`/`default` condition. */
-function dashboardExport(exports) {
-    if (!exports || typeof exports !== 'object' || Array.isArray(exports))
-        return undefined;
-    const entry = exports['./dashboard'];
-    if (typeof entry === 'string')
-        return entry;
-    if (!entry || typeof entry !== 'object' || Array.isArray(entry))
-        return undefined;
-    for (const condition of ['browser', 'import', 'default']) {
-        const target = entry[condition];
-        if (typeof target === 'string')
-            return target;
-    }
-    return undefined;
-}
-/** Whether `path` is `dir` itself or inside it; both already normalized. */
-function within(dir, path) {
-    return path === dir || path.startsWith(dir + sep);
-}
-/**
- * The widgets a project's packages bring: each of the project's dependencies whose package.json
- * exports `./dashboard` to a file that exists inside the package. Sorted by name.
- */
-export async function readProjectWidgets(root) {
-    const widgets = [];
-    for (const pkg of await projectPackages(root)) {
-        const widget = await readWidget(pkg);
-        if (widget)
-            widgets.push(widget);
-    }
-    return widgets.sort((a, b) => a.package.localeCompare(b.package));
-}
-async function readWidget({ name, dir: pkgDir, manifest: pkg }) {
-    const target = dashboardExport(pkg.exports);
-    if (!target)
-        return undefined;
-    const file = await realpath(join(pkgDir, target)).catch(() => undefined);
-    if (!file || !within(pkgDir, file) || !(await stat(file).then(s => s.isFile()).catch(() => false)))
-        return undefined;
-    return {
-        package: name,
-        ...(typeof pkg.version === 'string' ? { version: pkg.version } : {}),
-        dir: dirname(file),
-        entry: file.slice(dirname(file).length + 1),
-        bins: packageBins(name, pkg.bin, pkgDir),
-    };
-}
-/** The one widget of this project that `name` names, or undefined. */
-export async function findProjectWidget(root, name) {
-    return (await readProjectWidgets(root)).find(widget => widget.package === name);
-}
-/**
- * The file a widget serves at `rel`, a path relative to its module's directory: its module, its
- * stylesheet, a chunk. `undefined` for a path that leaves that directory (symlinks resolved) or
- * names no file, so nothing else of the package, and nothing of the project, is ever served.
- */
-export async function widgetFile(widget, rel) {
-    if (!rel)
-        return undefined;
-    const candidate = await realpath(normalize(join(widget.dir, rel))).catch(() => undefined);
-    if (!candidate || !within(widget.dir, candidate))
-        return undefined;
-    return (await stat(candidate).then(s => s.isFile()).catch(() => false)) ? candidate : undefined;
-}
-/** How many arguments, and how long each, a widget may pass: a command line, not a payload. */
-const MAX_ARGS = 32;
-const MAX_ARG_LENGTH = 4096;
-/**
- * Run one of a widget package's own commands in the project, with the given arguments, and read
- * its standard output as JSON. This is how a widget reads its data: the same command an agent runs
- * (`npx logs`), so the widget and the agent see the same thing and the framework knows neither.
- *
- * `command` picks one of the package's commands; a package with exactly one needs none. The
- * command runs with Node (a package's commands are Node scripts), in the project root, never
- * through a shell, bounded in time and output. Refused: a command the package does not have, too
- * many or too long arguments. A command that exits non-zero answers its last stderr line; one that
- * prints no JSON says so.
- */
-export async function runWidgetCommand(root, widget, args, command) {
-    const names = Object.keys(widget.bins);
-    const name = command ?? (names.length === 1 ? names[0] : undefined);
-    const bin = name !== undefined ? widget.bins[name] : undefined;
-    if (bin === undefined)
-        return { ok: false, error: command !== undefined ? `${widget.package} has no command ${command}` : `${widget.package} has ${names.length === 0 ? 'no command' : 'several commands; name one'}` };
-    if (args.length > MAX_ARGS || args.some(arg => typeof arg !== 'string' || arg.length > MAX_ARG_LENGTH))
-        return { ok: false, error: 'too many or too long arguments' };
-    return runPackageCommand(root, { name: name, bin }, args);
-}
-//# sourceMappingURL=project-widgets.js.map

package/dist/project-widgets.js.map

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