@openagt/start 0.0.0-stage → 0.22.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Suleiman Shahbari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { runCli } from './cli.js';
+runCli(process.argv.slice(2))
+    .then(code => {
+    process.exitCode = code;
+})
+    .catch((err) => {
+    console.error(err);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KAC1B,IAAI,CAAC,IAAI,CAAC,EAAE;IACX,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAA;AACzB,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAClB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC,CAAC,CAAA"}

package/dist/cli.d.ts

@@ -0,0 +1,37 @@
+import { type VersionFetcher } from './update-check.js';
+/** Where the CLI writes. Injectable so tests capture output. */
+export interface CliIO {
+    out: (line: string) => void;
+    err: (line: string) => void;
+}
+/** What the CLI itself accepts: three options, no verbs (D4). */
+export interface CliArgs {
+    help: boolean;
+    version: boolean;
+    /** `--port <n>`: the port the dashboard binds. Default {@link DEFAULT_DAEMON_PORT}; `0` is ephemeral. */
+    port?: number;
+    error?: string;
+}
+/**
+ * Parse argv (without the node/script prefix). Pure and testable.
+ *
+ * Three options and nothing else: `--port` because it is the one thing a browser cannot be asked
+ * and a dashboard cannot serve about itself; `--help` and `--version` because a command with
+ * options owes the user both. The command runs no agent (#1774): a run is started
+ * from the dashboard, by the project's own start hook.
+ */
+export declare function parseArgs(argv: string[]): CliArgs;
+export declare function runCli(argv: string[], io?: CliIO): Promise<number>;
+/**
+ * The startup footer every dashboard path prints (#312): where prompts come from, the version,
+ * and then — once npm answers — whether that version is the latest.
+ *
+ * The update line is deliberately not awaited before the static lines. #312 asks for the static
+ * info first, and the foreground path (bare `openagent`) blocks on the server forever, so a line
+ * printed after the await would never appear there at all. `checkForUpdate` is already forgiving:
+ * offline or slow (2.5s cap) resolves to 'unknown', which prints nothing.
+ */
+export declare function printStartupFooter(io: CliIO, opts?: {
+    fetchLatest?: VersionFetcher;
+}): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0D,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAM/G,gEAAgE;AAChE,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5B;AAyBD,iEAAiE;AACjE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,yGAAyG;IACzG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAyBjD;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBnF;AAkCD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,cAAc,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAaxG"}

package/dist/cli.js

@@ -0,0 +1,137 @@
+import { checkForUpdate, formatUpdateStatus, nodeVersionFetcher } from './update-check.js';
+import { runDaemon, DEFAULT_DAEMON_PORT } from '@openagt/dashboard/serve';
+import { handDownSkills } from './skills.js';
+import { repositoryOf } from './project.js';
+import { openagentVersion } from './version.js';
+const defaultIO = {
+    out: line => process.stdout.write(line + '\n'),
+    err: line => process.stderr.write(line + '\n'),
+};
+const HELP = `OpenAgent — turnkey AI orchestration that wraps a coding agent (Claude Code or Codex).
+
+Usage:
+  openagent              Serve the dashboard in the foreground. Ctrl+C closes it; the server
+                         logs stream to this terminal. Typed inside a Git repository, it adds
+                         that repository to the dashboard's projects.
+
+Options:
+  --port <n>             Dashboard port (default: 4200).
+  -h, --help             Show this help.
+  -v, --version          Print the version.
+
+The dashboard listens on this computer only. A phone, or another computer's OpenAgent, gets in
+from Settings › Devices.
+
+Everything else is the dashboard: it shows a project's runs from their files, and starts one
+through the project's own start hook (.openagent/hooks.yml), which names the tool that runs it.`;
+/**
+ * Parse argv (without the node/script prefix). Pure and testable.
+ *
+ * Three options and nothing else: `--port` because it is the one thing a browser cannot be asked
+ * and a dashboard cannot serve about itself; `--help` and `--version` because a command with
+ * options owes the user both. The command runs no agent (#1774): a run is started
+ * from the dashboard, by the project's own start hook.
+ */
+export function parseArgs(argv) {
+    const opts = { help: false, version: false };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case '--help':
+            case '-h':
+                opts.help = true;
+                break;
+            case '--version':
+            case '-v':
+                opts.version = true;
+                break;
+            case '--port': {
+                const n = Number(argv[++i]);
+                if (Number.isInteger(n) && n >= 0)
+                    opts.port = n;
+                else
+                    opts.error ??= 'invalid --port: must be a non-negative integer';
+                break;
+            }
+            default:
+                // The first thing that could not be read is the one told: what follows an unknown option is its value, not a command.
+                opts.error ??= arg.startsWith('-') ? `unknown option: ${arg}` : `unknown command: ${arg}`;
+        }
+    }
+    return opts;
+}
+export async function runCli(argv, io = defaultIO) {
+    const args = parseArgs(argv);
+    if (args.error) {
+        io.err(args.error);
+        io.err('Run `openagent --help` for usage.');
+        return 2;
+    }
+    if (args.help) {
+        io.out(HELP);
+        return 0;
+    }
+    if (args.version) {
+        io.out(openagentVersion());
+        return 0;
+    }
+    // Everything else is bare `openagent`: serve the dashboard in the foreground until Ctrl-C.
+    return runForegroundDaemonCmd(args, io);
+}
+/**
+ * Bare `openagent`: run the dashboard server in the foreground (#456), so its logs and any
+ * server-thrown errors are visible and Ctrl+C stops it. Blocks until the server is signalled
+ * (SIGINT/SIGTERM).
+ */
+async function runForegroundDaemonCmd(args, io) {
+    const cwd = process.cwd();
+    const port = args.port ?? DEFAULT_DAEMON_PORT;
+    try {
+        // Set in this process's own environment, so everything the dashboard starts inherits it.
+        await handDownSkills(process.env);
+        const project = await repositoryOf(cwd);
+        await runDaemon(cwd, {
+            port,
+            version: openagentVersion(),
+            ...(project !== undefined ? { project, onProjectAdded: (path) => io.out(`◆ project added: ${path}`) } : {}),
+            onListening: state => {
+                io.out(`◆ dashboard running: ${state.url}`);
+                io.out('  Ctrl+C to stop the dashboard. Server logs stream below.');
+                // #312 asks bare `openagent` to print the commands + version too. onListening is sync and
+                // runDaemon then blocks until signalled, so this is fire-and-forget by necessity: the
+                // update line lands a moment later, above the server logs.
+                void printStartupFooter(io);
+            },
+        });
+    }
+    catch (err) {
+        io.err(`could not start the dashboard (${err instanceof Error ? err.message : String(err)}).`);
+        return 1;
+    }
+    return 0;
+}
+/**
+ * The startup footer every dashboard path prints (#312): where prompts come from, the version,
+ * and then — once npm answers — whether that version is the latest.
+ *
+ * The update line is deliberately not awaited before the static lines. #312 asks for the static
+ * info first, and the foreground path (bare `openagent`) blocks on the server forever, so a line
+ * printed after the await would never appear there at all. `checkForUpdate` is already forgiving:
+ * offline or slow (2.5s cap) resolves to 'unknown', which prints nothing.
+ */
+export function printStartupFooter(io, opts = {}) {
+    const version = openagentVersion();
+    io.out('');
+    io.out('Type a prompt on the dashboard to start an agent, or use:');
+    io.out('  openagent --help              All options');
+    io.out('');
+    io.out(`OpenAgent v${version}`);
+    return checkForUpdate(version, opts.fetchLatest ?? nodeVersionFetcher())
+        .then(status => {
+        const line = formatUpdateStatus(status);
+        if (line)
+            io.out(line);
+    })
+        .catch(() => { });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/project.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The Git repository a folder is in, by its top folder: the project `npx @openagt/start` adds when
+ * it is typed in that folder. Undefined outside a repository, where there is nothing to add.
+ */
+export declare function repositoryOf(folder: string): Promise<string | undefined>;
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAI9E"}

package/dist/project.js

@@ -0,0 +1,13 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const run = promisify(execFile);
+/**
+ * The Git repository a folder is in, by its top folder: the project `npx @openagt/start` adds when
+ * it is typed in that folder. Undefined outside a repository, where there is nothing to add.
+ */
+export async function repositoryOf(folder) {
+    const said = await run('git', ['rev-parse', '--show-toplevel'], { cwd: folder }).catch(() => undefined);
+    const top = said?.stdout.trim();
+    return top ? top : undefined;
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAE/B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc;IAC/C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IACvG,MAAM,GAAG,GAAG,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;IAC/B,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9B,CAAC"}

package/dist/skills.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The skills every run gets by default: what an agent needs in any project to work at all, read
+ * what earlier agents did, ask the person a question, and hand its work over on the project's git
+ * host; and the ones the dashboard has pages for, so a page never shows work an agent cannot do:
+ * split a task across subagents, the tickets and the queue. The one place they are named: the
+ * runner links whatever it is handed, and the dashboard gives every project their pages. Each is
+ * linked into a run's checkout, hidden from git, and a project's own skill of the same name takes
+ * its place (see the runner's `basic-skills.ts`).
+ */
+export declare const DEFAULT_SKILLS: readonly string[];
+/**
+ * Put the default skills in `env` under {@link SKILLS_ENV}: their packages' directories, resolved
+ * from this package's own install, joined by the path delimiter. One that is not installed is
+ * left out.
+ */
+export declare function handDownSkills(env: NodeJS.ProcessEnv): Promise<void>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAAkK,CAAA;AAE9M;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAa1E"}

package/dist/skills.js

@@ -0,0 +1,35 @@
+import { realpath } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { delimiter, dirname } from 'node:path';
+import { SKILLS_ENV } from '@openagt/agent-data';
+/**
+ * The skills every run gets by default: what an agent needs in any project to work at all, read
+ * what earlier agents did, ask the person a question, and hand its work over on the project's git
+ * host; and the ones the dashboard has pages for, so a page never shows work an agent cannot do:
+ * split a task across subagents, the tickets and the queue. The one place they are named: the
+ * runner links whatever it is handed, and the dashboard gives every project their pages. Each is
+ * linked into a run's checkout, hidden from git, and a project's own skill of the same name takes
+ * its place (see the runner's `basic-skills.ts`).
+ */
+export const DEFAULT_SKILLS = ['@openagt/skill-logs', '@openagt/skill-question', '@openagt/skill-github', '@openagt/skill-orchestration', '@openagt/skill-tickets', '@openagt/skill-queue'];
+/**
+ * Put the default skills in `env` under {@link SKILLS_ENV}: their packages' directories, resolved
+ * from this package's own install, joined by the path delimiter. One that is not installed is
+ * left out.
+ */
+export async function handDownSkills(env) {
+    const require = createRequire(import.meta.url);
+    const dirs = [];
+    for (const name of DEFAULT_SKILLS) {
+        let manifest;
+        try {
+            manifest = require.resolve(`${name}/package.json`);
+        }
+        catch {
+            continue;
+        }
+        dirs.push(await realpath(dirname(manifest)));
+    }
+    env[SKILLS_ENV] = dirs.join(delimiter);
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAsB,CAAC,qBAAqB,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,sBAAsB,CAAC,CAAA;AAE9M;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAsB;IACzD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,IAAI,QAAgB,CAAA;QACpB,IAAI,CAAC;YACH,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,eAAe,CAAC,CAAA;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IAC9C,CAAC;IACD,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;AACxC,CAAC"}

package/dist/update-check.d.ts

@@ -0,0 +1,44 @@
+/**
+ * CLI "up-to-date?" check (#312): after the bare-`openagent` version footer,
+ * tell the user whether a newer version is published on npm. Display only;
+ * auto-update is a separate, deferred concern. Same seam + node-adapter +
+ * forgiving-on-error convention as `project.ts` (#380).
+ */
+/** The npm package this CLI ships as; the registry key for the version check. */
+export declare const PACKAGE_NAME = "@openagt/start";
+/** Fetches the latest published version of `pkg`, or undefined on any failure. Injectable for tests. */
+export type VersionFetcher = (pkg: string) => Promise<string | undefined>;
+/**
+ * A {@link VersionFetcher} backed by the npm registry. GETs the packument and
+ * reads `dist-tags.latest`. A 2.5s AbortSignal.timeout caps it; any error /
+ * non-ok / offline yields undefined (the check silently degrades to "unknown").
+ */
+export declare function nodeVersionFetcher(): VersionFetcher;
+/** The result of an update check. */
+export type UpdateStatus = {
+    kind: 'up-to-date';
+    current: string;
+} | {
+    kind: 'update-available';
+    current: string;
+    latest: string;
+} | {
+    kind: 'unknown';
+    current: string;
+};
+/**
+ * Compare two `major.minor.patch` versions numerically (a prerelease/build
+ * suffix after `-` or `+` is stripped, missing parts read as 0). Returns
+ * -1 / 0 / 1. No semver dependency.
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Check whether `current` is behind the latest published version. Uses the
+ * injected fetcher; a missing/failed fetch is 'unknown'. `current` >= latest is
+ * 'up-to-date' (so running a local build ahead of the registry never reads as
+ * "update available").
+ */
+export declare function checkForUpdate(current: string, fetchLatest: VersionFetcher, pkg?: string): Promise<UpdateStatus>;
+/** The one-line message to print for a status, or undefined for 'unknown' (print nothing). */
+export declare function formatUpdateStatus(status: UpdateStatus): string | undefined;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iFAAiF;AACjF,eAAO,MAAM,YAAY,mBAAmB,CAAA;AAE5C,wGAAwG;AACxG,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;AAEzE;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,CAYnD;AAED,qCAAqC;AACrC,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAExC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAW5D;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,cAAc,EAC3B,GAAG,GAAE,MAAqB,GACzB,OAAO,CAAC,YAAY,CAAC,CAMvB;AAED,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAS3E"}

package/dist/update-check.js

@@ -0,0 +1,71 @@
+/**
+ * CLI "up-to-date?" check (#312): after the bare-`openagent` version footer,
+ * tell the user whether a newer version is published on npm. Display only;
+ * auto-update is a separate, deferred concern. Same seam + node-adapter +
+ * forgiving-on-error convention as `project.ts` (#380).
+ */
+/** The npm package this CLI ships as; the registry key for the version check. */
+export const PACKAGE_NAME = '@openagt/start';
+/**
+ * A {@link VersionFetcher} backed by the npm registry. GETs the packument and
+ * reads `dist-tags.latest`. A 2.5s AbortSignal.timeout caps it; any error /
+ * non-ok / offline yields undefined (the check silently degrades to "unknown").
+ */
+export function nodeVersionFetcher() {
+    return async (pkg) => {
+        try {
+            const res = await fetch(`https://registry.npmjs.org/${pkg}`, { signal: AbortSignal.timeout(2500) });
+            if (!res.ok)
+                return undefined;
+            const data = (await res.json());
+            const latest = data?.['dist-tags']?.latest;
+            return typeof latest === 'string' ? latest : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    };
+}
+/**
+ * Compare two `major.minor.patch` versions numerically (a prerelease/build
+ * suffix after `-` or `+` is stripped, missing parts read as 0). Returns
+ * -1 / 0 / 1. No semver dependency.
+ */
+export function compareVersions(a, b) {
+    const parse = (v) => (v.split(/[-+]/)[0] ?? '').split('.').map(n => parseInt(n, 10) || 0);
+    const pa = parse(a);
+    const pb = parse(b);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const na = pa[i] ?? 0;
+        const nb = pb[i] ?? 0;
+        if (na !== nb)
+            return na < nb ? -1 : 1;
+    }
+    return 0;
+}
+/**
+ * Check whether `current` is behind the latest published version. Uses the
+ * injected fetcher; a missing/failed fetch is 'unknown'. `current` >= latest is
+ * 'up-to-date' (so running a local build ahead of the registry never reads as
+ * "update available").
+ */
+export async function checkForUpdate(current, fetchLatest, pkg = PACKAGE_NAME) {
+    const latest = await fetchLatest(pkg);
+    if (!latest)
+        return { kind: 'unknown', current };
+    return compareVersions(latest, current) > 0
+        ? { kind: 'update-available', current, latest }
+        : { kind: 'up-to-date', current };
+}
+/** The one-line message to print for a status, or undefined for 'unknown' (print nothing). */
+export function formatUpdateStatus(status) {
+    switch (status.kind) {
+        case 'up-to-date':
+            return `✅ Up to date (v${status.current})`;
+        case 'update-available':
+            return `⬆️  Update available: v${status.latest} (you have v${status.current}). Run: npm i -g ${PACKAGE_NAME}`;
+        case 'unknown':
+            return undefined;
+    }
+}
+//# sourceMappingURL=update-check.js.map

package/dist/update-check.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare function openagentVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAYA,wBAAgB,gBAAgB,IAAI,MAAM,CAYzC"}

package/dist/version.js

@@ -0,0 +1,27 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * OpenAgent's version: this package's own, the one people install, read from its `package.json`
+ * at runtime (#312). Handed to the dashboard, which tells it to machines and a phone.
+ * The compiled entry lives one level under the package root (`dist/` or
+ * `dist-test/`), so its `package.json` is always `../package.json`. Cached after
+ * the first read; falls back to `unknown` if the file is somehow unreadable.
+ */
+let cachedVersion;
+export function openagentVersion() {
+    if (cachedVersion !== undefined)
+        return cachedVersion;
+    try {
+        const pkgPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        // `unknown`, not `0.0.0`: the packages are unreleased and legitimately versioned `0.0.0`, so a
+        // numeric fallback would make a failed read indistinguishable from a correct one (#312).
+        cachedVersion = pkg.version ?? 'unknown';
+    }
+    catch {
+        cachedVersion = 'unknown';
+    }
+    return cachedVersion;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC;;;;;;GAMG;AACH,IAAI,aAAiC,CAAA;AACrC,MAAM,UAAU,gBAAgB;IAC9B,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,aAAa,CAAA;IACrD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,CAAA;QACnF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAyB,CAAA;QAC7E,+FAA+F;QAC/F,yFAAyF;QACzF,aAAa,GAAG,GAAG,CAAC,OAAO,IAAI,SAAS,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,GAAG,SAAS,CAAA;IAC3B,CAAC;IACD,OAAO,aAAa,CAAA;AACtB,CAAC"}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@openagt/start",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.22.0",
+  "description": "OpenAgent in one command: the dashboard, with the skills every agent gets by default. A project's own skill of the same name takes a default's place.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/openagt/openagent.git",
+    "directory": "packages/start"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "openagent": "dist/bin.js"
+  },
+  "exports": {
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@openagt/agent-data": "0.0.5",
+    "@openagt/dashboard": "0.22.0",
+    "@openagt/skill-github": "0.1.1",
+    "@openagt/skill-orchestration": "0.1.7",
+    "@openagt/skill-logs": "0.1.3",
+    "@openagt/skill-queue": "0.1.1",
+    "@openagt/skill-question": "0.1.0",
+    "@openagt/skill-tickets": "0.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^7.0.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "tsc -p tsconfig.test.json && node --test --test-timeout=60000 'dist-test/**/*.test.js'",
+    "clean": "rm -rf dist dist-test"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.