@agentage/cli 0.41.0 → 0.41.2

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

@@ -1,10 +1,6 @@
 import { type Command } from 'commander';
-import { type BuildOptions, type BuildResult } from '@agentage/extension/tool';
+import type { BuildOptions } from '@agentage/extension/tool';
+import { type LoadKitTool } from './kit-tool.js';
 export type ExtensionBuildOptions = Pick<BuildOptions, 'push' | 'dir' | 'registry'>;
-export interface BuildTool {
-    build: (options: BuildOptions) => Promise<BuildResult>;
-    buildLines: (result: BuildResult) => string[];
-}
-export declare const loadBuildTool: () => Promise<BuildTool>;
-export declare const runExtensionBuild: (opts?: ExtensionBuildOptions, tool?: () => Promise<BuildTool>) => Promise<void>;
+export declare const runExtensionBuild: (opts?: ExtensionBuildOptions, tool?: LoadKitTool) => Promise<void>;
 export declare const addBuild: (group: Command, build: (opts: ExtensionBuildOptions) => Promise<void>) => void;

package/dist/commands/extension/build.js

@@ -1,9 +1,7 @@
 import {} from 'commander';
-import {} from '@agentage/extension/tool';
-// Imported on use, so every other command starts without loading the kit.
-export const loadBuildTool = () => import('@agentage/extension/tool');
+import { loadKitTool } from './kit-tool.js';
 // One line per image on stdout (part, tag, digest when pushed), then the record path.
-export const runExtensionBuild = async (opts = {}, tool = loadBuildTool) => {
+export const runExtensionBuild = async (opts = {}, tool = loadKitTool) => {
     const { build, buildLines } = await tool();
     for (const line of buildLines(await build(opts)))
         console.log(line);

package/dist/commands/extension/delegate.js

@@ -5,12 +5,11 @@ import { loadOrder } from '../../core/loader/order.js';
 import { loadSet, scan } from '../../core/loader/scan.js';
 import { claimVerbs, commandNames, readHeld } from '../../core/loader/verbs.js';
 import { NO_MACHINE, readMachine } from '../../core/profile/machine.js';
-import { registerKit } from './kit-commands.js';
+import { registerKit, stub } from './kit-commands.js';
 import { kitCheck, loadKitTool } from './kit-tool.js';
 // Loads the command's extension and its peers only, then hands it the whole command line.
 const runDelegated = async (ext, name, extensions, program, argv) => {
-    const order = loadOrder([ext], extensions);
-    const session = await loadExtensions(order, program, kitCheck());
+    const session = await loadExtensions(loadOrder([ext], extensions), program, kitCheck());
     try {
         const loaded = session.loaded.get(ext.id ?? '');
         const run = session.outcomes.get(ext.pkg);
@@ -33,14 +32,7 @@ const unknownCommand = (program, core, extensions, verbs) => (operands) => {
 };
 const registerApi = (program, ext, run) => {
     for (const name of ext.commands)
-        program
-            .command(name)
-            .description(`from the ${ext.id} extension`)
-            .helpGroup(`${ext.id}:`)
-            .helpOption(false)
-            .allowUnknownOption()
-            .allowExcessArguments()
-            .action(run(name));
+        stub(program, name, `from the ${ext.id} extension`, run(name)).helpGroup(`${ext.id}:`);
 };
 // Manifests only, never code: each stub hands the command line, --help included, to the extension.
 export const registerDelegates = (program, argv, wrap, tool = loadKitTool) => {

package/dist/commands/extension/doctor.js

@@ -7,8 +7,7 @@ import { loadMachine } from '../../core/profile/machine.js';
 import { kitCheck } from './kit-tool.js';
 import { printReport } from './list.js';
 import { gatherFrom, invalidProfileError, } from './rows.js';
-// Loads what can load, once: state files rewritten, rows carrying this run's ok and failed.
-// `tree` loads that tree instead of the current one; kit-shaped ones are checked by the kit.
+// Loads what can load once (`tree`: that tree, not the current one); the kit checks kit-shaped ones.
 export const loadAndGather = async (beforeLoad = async () => undefined, tree, tool) => {
     const found = scan(await loadMachine(), tree);
     const extensions = loadSet(found);

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

@@ -9,5 +9,6 @@ export interface KitRegistration {
     wrap: (fn: () => Promise<void>) => Run;
     tool: LoadKitTool;
 }
+export declare const stub: (parent: Command, name: string, summary: string, run: Run) => Command;
 export declare const registerKit: (program: Command, ext: DiscoveredExtension, verbs: Verbs, { argv, wrap, tool }: KitRegistration) => void;
 export {};

package/dist/commands/extension/kit-commands.js

@@ -13,8 +13,8 @@ const runKit = async (tool, dir, command, argv) => {
     if (code !== 0)
         throw new CommanderError(code, KIT_EXIT, `${command} exited ${code}`);
 };
-// A stub per command: help from the manifest, everything after its own words to the kit.
-const stub = (parent, name, summary, run) => parent
+// A stub per command: help from the manifest, the rest of the line to the extension's own code.
+export const stub = (parent, name, summary, run) => parent
     .command(name)
     .description(summary)
     .helpOption(false)

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

@@ -1,31 +1,6 @@
+import type * as Kit from '@agentage/extension/tool';
 import { type KitCheck } from '../../core/loader/load.js';
-export interface KitRun {
-    dir: string;
-    command: string;
-    argv: string[];
-    stdout?: (text: string) => void;
-    stderr?: (text: string) => void;
-}
-export interface KitUp {
-    dir?: string;
-    onLine?: (line: string) => void;
-}
-export interface KitDown extends KitUp {
-    keepData?: boolean;
-}
-export interface KitTool {
-    runCommand: (options: KitRun) => Promise<number>;
-    checkCli: (dir: string) => Promise<string | null>;
-    up: (options: KitUp) => Promise<{
-        parts: number;
-        seconds: number;
-    }>;
-    down: (options: KitDown) => Promise<unknown>;
-    token: (options: {
-        scope: string;
-        issuer?: string;
-    }) => Promise<string>;
-}
+export type KitTool = Pick<typeof Kit, '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/up.js

@@ -31,15 +31,19 @@ export const issuerUrl = (value) => {
 const UP_HELP = `
 Runs the extension package in --dir (default: the current folder) on this machine with Docker
 only, the way a deployment runs it: the part images built with the release recipe, the store
-with its migrations and seeds, a dev token issuer and a local gateway. Prints one line per step
-as the kit reports it, the last one once every part is healthy. Needs docker. Exits 1 when a
-step fails, with the kit's message.`;
+with its migrations and seeds, a dev token issuer and a local gateway. Each working copy is its
+own compose project; up refuses while another one holds localhost:4280 or 4281 and names it, and
+on a kept store says what was already applied. Prints one line per step as the kit reports it,
+the last one once every part is healthy. Needs docker; every docker call has a timeout. Exits 1
+when a step fails, with the kit's message.`;
 const DOWN_HELP = `
-Removes what agentage extension up started for the package in --dir: its containers, network
-and the store's volume; --keep-data keeps the volume. Exits 1 when that fails.`;
+Removes what agentage extension up started for the package in --dir, and nothing else: its
+containers, network and the store's volume; --keep-data keeps the volume. The line it prints
+names the compose project it removed. Exits 1 when that fails.`;
 const TOKEN_HELP = `
 Prints a token from the dev issuer agentage extension up started, alone on stdout, for calling
-/api/v1/ and /mcp by hand or from tests. Only up trusts it. Exits 1 when the issuer refuses.`;
+/api/v1/ and /mcp by hand or from tests. Only up trusts it. Exits 1 when the issuer refuses or
+does not answer within 5 s.`;
 const DIR = '--dir <path>';
 const DIR_TEXT = 'the extension package folder (default: the current folder)';
 const addUp = (group, up) => {

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentage/cli",
-  "version": "0.41.0",
+  "version": "0.41.2",
   "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.0",
+    "@agentage/extension": "^0.2.1 || ^0.3.0",
     "chalk": "^6.0.0",
     "commander": "^15.0.0",
     "open": "^11.0.0"