@agentage/cli 0.41.1 → 0.42.0

package/README.md

@@ -65,14 +65,13 @@ For extensions (see below):
 | `agentage extension remove <name> [--purge]` | Take it out of the profile and reinstall the rest                |
 | `agentage extension list`                    | One row per extension: state, version, commands, last run        |
 | `agentage extension doctor`                  | Load every extension once and refresh the states                 |
+| `agentage extension check [dir]`             | Check that an extension package conforms (the six kit rules)     |
 | `agentage extension build [--push]`          | Build the part images of an extension package; push with digests |
 | `agentage extension up` / `down`             | Run an extension package on this machine with Docker, then stop  |
 | `agentage extension token --scope <scope>`   | Print a token from the dev issuer `extension up` started         |
 | `agentage <command>`                         | Run a command an installed extension contributes                 |
 | `agentage <id> <command>`                    | The same for an extension built on the kit; always works         |
 
-`agentage extension check` is the old name of `doctor`, kept for 90 days.
-
 Flags, exit codes and token auth are in [`docs/reference.md`](docs/reference.md).
 
 ## Extensions

package/dist/commands/extension/build.d.ts

@@ -2,5 +2,14 @@ import { type Command } from 'commander';
 import type { BuildOptions } from '@agentage/extension/tool';
 import { type LoadKitTool } from './kit-tool.js';
 export type ExtensionBuildOptions = Pick<BuildOptions, 'push' | 'dir' | 'registry'>;
+export type ExtensionCheckOptions = {
+    dir?: string;
+    json?: boolean;
+};
+export declare const runExtensionCheck: ({ dir, json }?: ExtensionCheckOptions, tool?: LoadKitTool) => Promise<void>;
 export declare const runExtensionBuild: (opts?: ExtensionBuildOptions, tool?: LoadKitTool) => Promise<void>;
-export declare const addBuild: (group: Command, build: (opts: ExtensionBuildOptions) => Promise<void>) => void;
+export interface BuildActions {
+    check: (opts: ExtensionCheckOptions) => Promise<void>;
+    build: (opts: ExtensionBuildOptions) => Promise<void>;
+}
+export declare const addBuild: (group: Command, { check, build }: BuildActions) => void;

package/dist/commands/extension/build.js

@@ -1,5 +1,21 @@
 import {} from 'commander';
+import { kitVersion } from '../../core/kit-version.js';
 import { loadKitTool } from './kit-tool.js';
+// The kit's lines, or its report as JSON, on stdout; a package that does not conform exits 1.
+export const runExtensionCheck = async ({ dir = '.', json } = {}, tool = loadKitTool) => {
+    const { check, checkLines } = await tool();
+    if (typeof check !== 'function')
+        throw new Error(`this package uses kit ${kitVersion()}; check needs @agentage/extension ^0.4`);
+    const report = await check(dir);
+    const lines = checkLines(report);
+    const shown = json
+        ? [JSON.stringify(report, null, 2)]
+        : lines.slice(0, report.conforms ? undefined : -1);
+    for (const line of shown)
+        console.log(line);
+    if (!report.conforms)
+        throw new Error(lines.at(-1));
+};
 // One line per image on stdout (part, tag, digest when pushed), then the record path.
 export const runExtensionBuild = async (opts = {}, tool = loadKitTool) => {
     const { build, buildLines } = await tool();
@@ -13,7 +29,13 @@ each image, tagged ghcr.io/agentage/<id>-<part>:<version> with the commit and bu
 labels. --push pushes them (run docker login first) and writes dist/agentage-extension.json, the
 build record with every image by digest. Needs docker. Exits 1 when the manifest is invalid or a
 build or push fails.`;
-export const addBuild = (group, build) => {
+export const addBuild = (group, { check, build }) => {
+    group
+        .command('check')
+        .description('Check that an extension package conforms, as every build does first')
+        .argument('[dir]', 'the extension package folder (default: the current folder)')
+        .option('--json', 'machine-readable report')
+        .action((dir, opts) => check({ dir, ...opts }));
     group
         .command('build')
         .description('Build the part images of an extension package; --push pushes them')

package/dist/commands/extension/doctor.d.ts

@@ -8,6 +8,4 @@ type BeforeLoad = (extensions: DiscoveredExtension[]) => Promise<void>;
 export declare const loadAndGather: (beforeLoad?: BeforeLoad, tree?: string, tool?: LoadKitTool) => Promise<ExtensionsGather>;
 export declare const failedError: (rows: ExtensionRow[]) => Error | null;
 export declare const runExtensionDoctor: (opts?: ExtensionDoctorOptions, tool?: LoadKitTool) => Promise<void>;
-export declare const CHECK_DEPRECATED: string;
-export declare const deprecatedCheck: (doctor: (opts: ExtensionDoctorOptions) => Promise<void>, writeErr: (text: string) => void) => (opts: ExtensionDoctorOptions) => Promise<void>;
 export {};

package/dist/commands/extension/doctor.js

@@ -1,4 +1,3 @@
-import chalk from 'chalk';
 import { driftLines } from '../../core/installer/plan.js';
 import {} from '../../core/loader/discover.js';
 import { loadExtensions } from '../../core/loader/load.js';
@@ -34,10 +33,3 @@ export const runExtensionDoctor = async (opts = {}, tool) => {
     if (failure)
         throw failure;
 };
-export const CHECK_DEPRECATED = 'agentage extension check is now agentage extension doctor; ' +
-    'in 90 days check becomes the conformance check';
-// The old name for 90 days: one line on stderr, then doctor, so --json stdout stays the report.
-export const deprecatedCheck = (doctor, writeErr) => async (opts) => {
-    writeErr(`${chalk.yellow(`warning: ${CHECK_DEPRECATED}`)}\n`);
-    await doctor(opts);
-};

package/dist/commands/extension/kit-tool.d.ts

@@ -1,6 +1,6 @@
 import type * as Kit from '@agentage/extension/tool';
 import { type KitCheck } from '../../core/loader/load.js';
-export type KitTool = Pick<typeof Kit, 'build' | 'buildLines' | 'runCommand' | 'checkCli' | 'up' | 'down' | 'token'>;
+export type KitTool = Pick<typeof Kit, 'check' | 'checkLines' | 'build' | 'buildLines' | 'runCommand' | 'checkCli' | 'up' | 'down' | 'token'>;
 export type LoadKitTool = () => Promise<KitTool>;
 export declare const loadKitTool: LoadKitTool;
 export declare const kitCheck: (tool?: LoadKitTool) => KitCheck;

package/dist/commands/extension/list.d.ts

@@ -1,5 +1,5 @@
 import { type Command } from 'commander';
-import { type ExtensionBuildOptions } from './build.js';
+import { type BuildActions } from './build.js';
 import { type ExtensionDoctorOptions } from './doctor.js';
 import { type ExtensionInstallOptions } from './install.js';
 import { type ExtensionRemoveOptions } from './remove.js';
@@ -11,12 +11,10 @@ export interface ExtensionListOptions {
 export declare const printReport: ({ status, warnings }: ExtensionsGather, json?: boolean) => void;
 export declare const runExtensionList: (opts?: ExtensionListOptions) => Promise<void>;
 export declare const helpOrUnknown: (_opts: unknown, group: Command) => void;
-export interface ExtensionActions extends KitActions {
+export interface ExtensionActions extends KitActions, BuildActions {
     install: (opts: ExtensionInstallOptions) => Promise<void>;
     remove: (opts: ExtensionRemoveOptions) => Promise<void>;
     list: (opts: ExtensionListOptions) => Promise<void>;
     doctor: (opts: ExtensionDoctorOptions) => Promise<void>;
-    check: (opts: ExtensionDoctorOptions) => Promise<void>;
-    build: (opts: ExtensionBuildOptions) => Promise<void>;
 }
 export declare const registerExtension: (program: Command, actions: ExtensionActions) => void;

package/dist/commands/extension/list.js

@@ -58,7 +58,7 @@ while loading goes to stderr, state/<id>.json is rewritten for each, and the row
 failed with the reason (a dependent of a failed extension is blocked). An extension built on the
 extension kit is ok when its command entry exports create and its handlers are the commands it
 declares. Exits 1 when any extension failed, or on integrity drift between the lock and the
-installed tree. extension check is its old name, kept for 90 days.`;
+installed tree.`;
 // Bare `extension` prints its help (exit 0); an unknown subcommand stays a usage error (exit 2).
 export const helpOrUnknown = (_opts, group) => {
     const name = group.args[0];
@@ -83,7 +83,7 @@ const addChanges = (group, { install, remove }) => {
         .addHelpText('after', REMOVE_HELP)
         .action((name, opts) => remove({ name, ...opts }));
 };
-const addReports = (group, { list, doctor, check }) => {
+const addReports = (group, { list, doctor }) => {
     group
         .command('list')
         .description('Show one row per extension: state, versions, commands, last run')
@@ -96,13 +96,8 @@ const addReports = (group, { list, doctor, check }) => {
         .option('--json', 'machine-readable output')
         .addHelpText('after', DOCTOR_HELP)
         .action(doctor);
-    group
-        .command('check', { hidden: true })
-        .description('Deprecated: the old name of doctor')
-        .option('--json', 'machine-readable output')
-        .action(check);
 };
-// Help lists the subcommands in this order: install, remove, list, doctor, build, up, down, token.
+// Help lists the subcommands in this order: install, remove, list, doctor, check, build, up, down, token.
 export const registerExtension = (program, actions) => {
     const group = program
         .command('extension')
@@ -111,6 +106,6 @@ export const registerExtension = (program, actions) => {
         .action(helpOrUnknown);
     addChanges(group, actions);
     addReports(group, actions);
-    addBuild(group, actions.build);
+    addBuild(group, actions);
     addKitTools(group, actions);
 };

package/dist/lib/update/update-cache.js

@@ -24,7 +24,7 @@ export const updateHint = () => {
     if (!c?.latest)
         return null;
     return compareVersions(VERSION, c.latest) < 0
-        ? `update available: ${c.latest} -> ${INSTALL_HINT}`
+        ? `update available: ${VERSION} -> ${c.latest} - ${INSTALL_HINT}`
         : null;
 };
 // Shares fetchJsonUnref (node:https, unref'd timer) so an offline background check never stalls

package/dist/program.d.ts

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 import { type SetupOptions } from './commands/auth/setup.js';
-import { type ExtensionBuildOptions } from './commands/extension/build.js';
+import { type ExtensionBuildOptions, type ExtensionCheckOptions } from './commands/extension/build.js';
 import { type ExtensionDoctorOptions } from './commands/extension/doctor.js';
 import { type ExtensionInstallOptions } from './commands/extension/install.js';
 import { type ExtensionListOptions } from './commands/extension/list.js';
@@ -17,6 +17,7 @@ export interface ProgramDeps {
     extensionRemove: (opts: ExtensionRemoveOptions) => Promise<void>;
     extensionList: (opts: ExtensionListOptions) => Promise<void>;
     extensionDoctor: (opts: ExtensionDoctorOptions) => Promise<void>;
+    extensionCheck: (opts: ExtensionCheckOptions) => Promise<void>;
     extensionBuild: (opts: ExtensionBuildOptions) => Promise<void>;
     extensionUp: (opts: ExtensionUpOptions) => Promise<void>;
     extensionDown: (opts: ExtensionDownOptions) => Promise<void>;

package/dist/program.js

@@ -1,9 +1,9 @@
 import chalk from 'chalk';
 import { Command, CommanderError } from 'commander';
 import { registerSetup } from './commands/auth/setup.js';
-import { runExtensionBuild } from './commands/extension/build.js';
+import { runExtensionBuild, runExtensionCheck, } from './commands/extension/build.js';
 import { registerDelegates } from './commands/extension/delegate.js';
-import { deprecatedCheck, runExtensionDoctor, } from './commands/extension/doctor.js';
+import { runExtensionDoctor } from './commands/extension/doctor.js';
 import { runExtensionInstall } from './commands/extension/install.js';
 import { registerExtension, runExtensionList, } from './commands/extension/list.js';
 import { runExtensionRemove, terminalIo, } from './commands/extension/remove.js';
@@ -33,6 +33,7 @@ const defaultDeps = {
     extensionRemove: (opts) => runExtensionRemove(opts, { ...editDeps, io: terminalIo() }),
     extensionList: (opts) => runExtensionList(opts),
     extensionDoctor: (opts) => runExtensionDoctor(opts),
+    extensionCheck: (opts) => runExtensionCheck(opts),
     extensionBuild: (opts) => runExtensionBuild(opts),
     extensionUp: (opts) => runExtensionUp(opts),
     extensionDown: (opts) => runExtensionDown(opts),
@@ -76,7 +77,7 @@ const addExtensions = (program, deps, argv) => {
         remove: withAction(deps, deps.extensionRemove),
         list: withAction(deps, deps.extensionList),
         doctor: withAction(deps, deps.extensionDoctor),
-        check: withAction(deps, deprecatedCheck(deps.extensionDoctor, deps.writeErr)),
+        check: withAction(deps, deps.extensionCheck),
         build: withAction(deps, deps.extensionBuild),
         up: withAction(deps, deps.extensionUp),
         down: withAction(deps, deps.extensionDown),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentage/cli",
-  "version": "0.41.1",
+  "version": "0.42.0",
   "description": "The agentage CLI - connect this machine to agentage from the terminal",
   "type": "module",
   "main": "./dist/index.js",
@@ -55,7 +55,7 @@
     "prepublishOnly": "npm run verify"
   },
   "dependencies": {
-    "@agentage/extension": "^0.2.1",
+    "@agentage/extension": "^0.2.1 || ^0.3.0 || ^0.4.0",
     "chalk": "^6.0.0",
     "commander": "^15.0.0",
     "open": "^11.0.0"