@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/browser.js

@@ -0,0 +1,38 @@
+import { createServer } from 'node:net';
+/**
+ * What launching a Chrome with its DevTools port open needs, whoever launches it: a port nobody
+ * holds, and a way to know the port answers. The bridge browser (#1332) is the one caller.
+ */
+/** A free localhost port, asked of the OS rather than guessed. */
+export async function freePort() {
+    return new Promise((resolve, reject) => {
+        const server = createServer();
+        server.on('error', reject);
+        server.listen(0, '127.0.0.1', () => {
+            const address = server.address();
+            const port = typeof address === 'object' && address ? address.port : 0;
+            server.close(() => (port ? resolve(port) : reject(new Error('no port'))));
+        });
+    });
+}
+/**
+ * Poll `/json/version` until Chrome answers. Chrome opens the port a beat after the process
+ * starts, so connecting to a URL that is not listening yet is the obvious race.
+ */
+export async function waitForDebugEndpoint(browserUrl, opts = {}) {
+    const { timeoutMs = 15_000, intervalMs = 100, fetchImpl = fetch } = opts;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        try {
+            const res = await fetchImpl(`${browserUrl}/json/version`);
+            if (res.ok)
+                return true;
+        }
+        catch {
+            // Not listening yet.
+        }
+        await new Promise(r => setTimeout(r, intervalMs));
+    }
+    return false;
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEvC;;;GAGG;AAEH,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;QAC7B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC1B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;YACjC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAA;YAChC,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACtE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3E,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,IAAI,GAA0E,EAAE;IAEhF,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,UAAU,GAAG,GAAG,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,IAAI,CAAA;IACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;IACvC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,UAAU,eAAe,CAAC,CAAA;YACzD,IAAI,GAAG,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAA;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAA;IACnD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/built-in.d.ts

@@ -0,0 +1,29 @@
+import { type ProjectPackage, type ProvidedCommand, type ProvidedCommandLookup } from '@openagt/agent-data';
+/**
+ * The packages the framework ships for every project, by name: dependencies of the framework
+ * itself, resolved from its own install, so a project installs nothing for them and an empty
+ * folder starts an agent and shows it. Each comes through the same contract as a project's own
+ * package: a module by its `./dashboard` export, a provider of a kind of data and the writer of
+ * its hook lines by its `framework` key. This list is the one place the framework names a
+ * package, and a project's own copy of any of them wins.
+ */
+export declare const BUILT_IN_PACKAGES: readonly string[];
+/** The built-in packages, resolved from the framework's own install, once; one that is not installed is skipped. */
+export declare function builtInPackages(): Promise<ProjectPackage[]>;
+/** The directories the built-in packages' commands sit in: what a hook line's PATH gains after the project's own installed tools. */
+export declare function builtInBinDirs(): Promise<string[]>;
+/** What provides `kind` in the project at `root`: one of the project's own packages, else a built-in one. */
+export declare function lookupProvided(root: string, kind: string): Promise<ProvidedCommandLookup>;
+/** {@link lookupProvided}'s command, for a caller that only needs to run it. */
+export declare function providedCommand(root: string, kind: string): Promise<ProvidedCommand | undefined>;
+/** Whether `command` comes from a built-in package the project has no copy of: one the project did not choose. */
+export declare function isBuiltIn(root: string, command: ProvidedCommand): Promise<boolean>;
+/**
+ * Have every package that writes hook lines write its own into the project at `root`: a package
+ * declares `"framework": { "hooks": "<command>" }`, and `<command> init`, run in the project,
+ * writes its lines into the project's hooks file, keeping every line already there. The project's
+ * own packages are asked, then the built-in ones the project has no copy of. Answers one line per
+ * package that could not write, in words.
+ */
+export declare function writeHookLines(root: string): Promise<string[]>;
+//# sourceMappingURL=built-in.d.ts.map

package/dist/built-in.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in.d.ts","sourceRoot":"","sources":["../src/built-in.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmG,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE5M;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAA2H,CAAA;AAI1K,oHAAoH;AACpH,wBAAgB,eAAe,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAE3D;AAmBD,qIAAqI;AACrI,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAMxD;AAED,6GAA6G;AAC7G,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAE/F;AAED,gFAAgF;AAChF,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAEtG;AAED,kHAAkH;AAClH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxF;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASpE"}

package/dist/built-in.js

@@ -0,0 +1,78 @@
+import { realpath } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { declaring, lookupProvidedCommand, packageBins, projectPackages, readManifest, runPackageCommand } from '@openagt/agent-data';
+/**
+ * The packages the framework ships for every project, by name: dependencies of the framework
+ * itself, resolved from its own install, so a project installs nothing for them and an empty
+ * folder starts an agent and shows it. Each comes through the same contract as a project's own
+ * package: a module by its `./dashboard` export, a provider of a kind of data and the writer of
+ * its hook lines by its `framework` key. This list is the one place the framework names a
+ * package, and a project's own copy of any of them wins.
+ */
+export const BUILT_IN_PACKAGES = ['@openagt/files', '@openagt/skill-branches', '@openagt/skill-github', '@openagt/skill-logs', '@openagt/agent-runner'];
+let resolved;
+/** The built-in packages, resolved from the framework's own install, once; one that is not installed is skipped. */
+export function builtInPackages() {
+    return (resolved ??= resolveBuiltIn());
+}
+async function resolveBuiltIn() {
+    const require = createRequire(import.meta.url);
+    const packages = [];
+    for (const name of BUILT_IN_PACKAGES) {
+        let manifestPath;
+        try {
+            manifestPath = require.resolve(`${name}/package.json`);
+        }
+        catch {
+            continue;
+        }
+        const dir = await realpath(dirname(manifestPath)).catch(() => undefined);
+        const manifest = dir ? await readManifest(join(dir, 'package.json')) : undefined;
+        if (dir && manifest)
+            packages.push({ name, dir, manifest });
+    }
+    return packages;
+}
+/** The directories the built-in packages' commands sit in: what a hook line's PATH gains after the project's own installed tools. */
+export async function builtInBinDirs() {
+    const dirs = new Set();
+    for (const { name, dir, manifest } of await builtInPackages()) {
+        for (const bin of Object.values(packageBins(name, manifest.bin, dir)))
+            dirs.add(dirname(bin));
+    }
+    return [...dirs];
+}
+/** What provides `kind` in the project at `root`: one of the project's own packages, else a built-in one. */
+export async function lookupProvided(root, kind) {
+    return lookupProvidedCommand(root, kind, await builtInPackages());
+}
+/** {@link lookupProvided}'s command, for a caller that only needs to run it. */
+export async function providedCommand(root, kind) {
+    return (await lookupProvided(root, kind)).command;
+}
+/** Whether `command` comes from a built-in package the project has no copy of: one the project did not choose. */
+export async function isBuiltIn(root, command) {
+    if ((await projectPackages(root)).some(pkg => pkg.name === command.package))
+        return false;
+    return (await builtInPackages()).some(pkg => pkg.name === command.package);
+}
+/**
+ * Have every package that writes hook lines write its own into the project at `root`: a package
+ * declares `"framework": { "hooks": "<command>" }`, and `<command> init`, run in the project,
+ * writes its lines into the project's hooks file, keeping every line already there. The project's
+ * own packages are asked, then the built-in ones the project has no copy of. Answers one line per
+ * package that could not write, in words.
+ */
+export async function writeHookLines(root) {
+    const own = await projectPackages(root);
+    const packages = [...own, ...(await builtInPackages()).filter(pkg => !own.some(o => o.name === pkg.name))];
+    const failed = [];
+    for (const command of declaring(packages, 'hooks')) {
+        const result = await runPackageCommand(root, command, ['init']);
+        if (!result.ok)
+            failed.push(`${command.package}: ${result.error}`);
+    }
+    return failed;
+}
+//# sourceMappingURL=built-in.js.map

package/dist/built-in.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in.js","sourceRoot":"","sources":["../src/built-in.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAyE,MAAM,qBAAqB,CAAA;AAE5M;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAsB,CAAC,gBAAgB,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,uBAAuB,CAAC,CAAA;AAE1K,IAAI,QAA+C,CAAA;AAEnD,oHAAoH;AACpH,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,QAAQ,KAAK,cAAc,EAAE,CAAC,CAAA;AACxC,CAAC;AAED,KAAK,UAAU,cAAc;IAC3B,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9C,MAAM,QAAQ,GAAqB,EAAE,CAAA;IACrC,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,IAAI,YAAoB,CAAA;QACxB,IAAI,CAAC;YACH,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,eAAe,CAAC,CAAA;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ;QACV,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QACxE,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAChF,IAAI,GAAG,IAAI,QAAQ;YAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC7D,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,qIAAqI;AACrI,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,MAAM,eAAe,EAAE,EAAE,CAAC;QAC9D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;IAC/F,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;AAClB,CAAC;AAED,6GAA6G;AAC7G,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,IAAY;IAC7D,OAAO,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,EAAE,CAAC,CAAA;AACnE,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAAY;IAC9D,OAAO,CAAC,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;AACnD,CAAC;AAED,kHAAkH;AAClH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,OAAwB;IACpE,IAAI,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAA;IACzF,OAAO,CAAC,MAAM,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAC5E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAA;IACvC,MAAM,QAAQ,GAAG,CAAC,GAAG,GAAG,EAAE,GAAG,CAAC,MAAM,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC1G,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;QAC/D,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}