@withbuddi/buddi 0.1.0-pre.23 → 0.1.0-pre.25

package/packages/gateway/dist/plugins/toggle.js

@@ -3,16 +3,20 @@
  *
  * The record says `enabled: false`; nothing else about the installation moves.
  * The package stays where it is, its schema and data stay, and agents granted
- * its family keep their files. What changes happens at the next start: the
- * plugin is not imported, so nothing of it registers, and an agent's grant to
- * it is skipped with a line in its prompt instead of holding the agent back.
+ * its family keep their files. In the running gateway it takes effect at once
+ * (`live.ts`): the plugin leaves the registry, so its tools leave the agents,
+ * its pages leave the rail and Settings, and its sources and sentinels stop;
+ * enabling loads it back the way boot does. A process with no registry (the
+ * CLI when buddi is not running) only writes the record, which the next start
+ * reads, so there is nothing to restart there either.
  *
- * The one thing done here and now is the missions it suggested: they are
- * paused with a reason ("paused: finance is disabled"), and enabling resumes
- * exactly those — a mission the owner switched off stays off.
+ * The missions it suggested are paused with a reason ("paused: finance is
+ * disabled"), and enabling resumes exactly those — a mission the owner
+ * switched off stays off.
  */
 import { pausePluginMissions, pluginPausedReason, readPluginsFile, resumePluginMissions, setInstalledPluginEnabled, writePluginsFile, } from '@buddi/core';
 import { adoptedPlugins, loadManifest, recordFile } from './load.js';
+import { loadPluginLive, unloadPluginLive } from './live.js';
 import { InstallRefusal } from './refusals.js';
 /** The mission ids a plugin suggests: from this process's load, or its entry point. */
 async function suggestedMissionIds(name, entry, env) {
@@ -51,29 +55,49 @@ export async function setPluginEnabled(name, enabled, opts = {}) {
             missionsProblem = `its missions were not ${enabled ? 'resumed' : 'paused'}: ${err instanceof Error ? err.message : String(err)}`;
         }
     }
+    // The running gateway, now: whenever a registry is here, even when the
+    // record already said so, so a second click finishes what a first one left.
+    let restartFor;
+    let loadProblem;
+    if (opts.registry !== undefined) {
+        const liveDeps = { registry: opts.registry, env, pool: opts.pool, ...(opts.log ? { log: opts.log } : {}) };
+        const live = enabled ? await loadPluginLive(record, liveDeps) : unloadPluginLive(record, liveDeps);
+        restartFor = live.restartFor;
+        loadProblem = live.problem;
+    }
+    else if (changed && opts.gatewayRunning !== false) {
+        restartFor = enabled
+            ? 'the running buddi loads its tools, pages and watchers when it restarts'
+            : 'its tools, pages and watchers stay on in the running buddi until it restarts';
+    }
     return {
         name,
         enabled,
         changed,
         missions,
         ...(missionsProblem === undefined ? {} : { missionsProblem }),
-        restartNeeded: changed,
+        restartNeeded: restartFor !== undefined,
+        ...(restartFor === undefined ? {} : { restartFor }),
+        ...(loadProblem === undefined ? {} : { loadProblem }),
     };
 }
-/** What happened, one finished sentence each, for the CLI. */
+/** What happened, one finished sentence each, for the CLI and the card. */
 export function toggleNotes(outcome) {
     const { name, enabled } = outcome;
     const notes = [];
-    if (!outcome.changed) {
+    if (!outcome.changed && outcome.loadProblem === undefined && !outcome.restartNeeded) {
         notes.push(`${name} is already ${enabled ? 'enabled' : 'disabled'}.`);
     }
     else if (enabled) {
-        notes.push(`${name} is enabled. Its tools, pages and watchers come back when buddi restarts.`);
+        notes.push(outcome.loadProblem === undefined ? 'Enabled.' : `Enabled, but it did not load: ${outcome.loadProblem}.`);
     }
     else {
-        notes.push(`${name} is disabled. Its tools, pages and watchers stop when buddi restarts; its data stays, ` +
-            'and agents that use it carry on without those tools.');
+        notes.push(outcome.restartNeeded
+            ? 'Disabled. Its data is kept.'
+            : 'Disabled. Its tools, pages and watchers are off now; its data is kept.');
     }
+    if (outcome.restartFor !== undefined)
+        notes.push(`Restart buddi to finish: ${outcome.restartFor}.`);
     if (outcome.missions.length > 0) {
         notes.push(enabled
             ? `Resumed ${outcome.missions.length === 1 ? 'the mission' : 'the missions'} ${outcome.missions.join(', ')}.`

package/packages/gateway/dist/plugins/toggle.js.map

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

package/packages/gateway/dist/plugins/update.d.ts

@@ -14,6 +14,14 @@ export interface UpdateOptions extends StageOptions {
     version?: string;
     /** Stage an older version anyway. The CLI never passes it; nothing else does. */
     allowDowngrade?: boolean;
+    /**
+     * Take the new version from this npm package instead of from where the
+     * installed one came. Browse passes it: a plugin installed from a directory
+     * or a file, once it is listed on withbuddi.com, updates to the published
+     * package, and the record follows (its source becomes the registry). A
+     * path is refused here; only a package name may replace a source.
+     */
+    from?: string;
 }
 /**
  * Stage the next version of an installed plugin. Approving it is the caller's

package/packages/gateway/dist/plugins/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/plugins/update.ts"],"names":[],"mappings":"AAkBA,OAAO,EAA6B,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAK7F,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAY1E;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAgDhG"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/plugins/update.ts"],"names":[],"mappings":"AAmBA,OAAO,EAA6B,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAK7F,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAY1E;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAqDhG"}

package/packages/gateway/dist/plugins/update.js

@@ -14,6 +14,7 @@
  * version of that limitation.
  */
 import { compareSemver, parseSemver, readPluginsFile } from '@buddi/core';
+import { parsePluginSpec } from './spec.js';
 import { InstallRefusal } from './refusals.js';
 import { packageUses, recordFile } from './load.js';
 import { rejectStaged, stagePlugin } from './stage.js';
@@ -56,11 +57,16 @@ export async function updatePlugin(name, opts = {}) {
     // What the installed version declared it reaches, so the card can say what
     // the new one adds. Unreadable is nothing: the card then lists every area.
     const installedUses = packageUses(record.entry);
-    const staged = await stagePlugin(specFor(record, opts.version), {
-        ...opts,
+    const { from, ...stageOpts } = opts;
+    if (from !== undefined && parsePluginSpec(from).kind !== 'registry') {
+        throw new InstallRefusal('bad-from', `"${from}" is not an npm package; an update from elsewhere names a package.`);
+    }
+    const staged = await stagePlugin(from ?? specFor(record, opts.version), {
+        ...stageOpts,
         env,
         previous,
         previousUses: installedUses.ok ? installedUses.uses : [],
+        previousSource: record.source,
     });
     let newer = true;
     if (opts.allowDowngrade !== true) {

package/packages/gateway/dist/plugins/update.js.map

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

package/packages/gateway/dist/plugins-cli.d.ts

@@ -1,14 +1,15 @@
 #!/usr/bin/env node
+import { type PluginManifest } from '@buddi/core';
 import { type StagedPlugin } from './plugins/stage.js';
-export declare const USAGE = "buddi plugins \u2014 what this installation has installed\n\n  buddi plugins init <name> [--dir <path>] [--license <spdx>] [--author <name>]\n                                          write a new plugin: manifest, one auto tool, one gated\n                                          tool, a migration, a buddi.md and a test. Refuses a\n                                          directory that already exists. License: Apache-2.0\n                                          unless --license names another. Author: asked, with\n                                          git config user.name as the default.\n  buddi plugins dev <dir>                 watch <dir>/dist and, when it changes, restart the\n                                          service (or say to restart buddi): plugins load at start\n  buddi plugins list [--json]             what is installed, its version, and whether it is healthy\n  buddi plugins info <name>               what it is, what it brought, and what it proposes\n  buddi plugins install <spec>            STAGE it and read what it claims (imports nothing)\n  buddi plugins install <spec> --yes --integrity <hash>\n                                          approve it: import it, plan it, install it.\n                                          The hash is the one the staged card printed; a\n                                          package that came from a registry or a .tgz is\n                                          never approved without it, not even with --yes.\n                                          Without it the command stages, prints the card and\n                                          exits 3: staged, not installed.\n  buddi plugins update <name> [--version] stage the next version; --yes --integrity approves it\n  buddi plugins staged                    what is staged and waiting for you\n  buddi plugins approve <id> [--integrity <hash>] [--acknowledge-drift]\n  buddi plugins reject <id>               delete a stage and everything it fetched\n  buddi plugins disable <name>            stop loading it: its tools, pages and watchers stop at the\n                                          next start, its data stays, its missions pause\n  buddi plugins enable <name>             load it again at the next start and resume its missions\n  buddi plugins uninstall <name>          what removing it would do (removes nothing)\n  buddi plugins uninstall <name> --yes    remove it; its database schema is KEPT\n      --detach-agents                     also take its tools out of agents that were granted them\n      --purge --confirm <name>            ALSO DROP its schema and everything in it. Irreversible,\n                                          and the plugin's own name has to be typed back.\n\nA <spec> is a directory that exists, a .tgz on disk, or an npm package:\n`finance`, `@you/buddi-plugin-finance@1.2.3`. Installing one runs its code inside buddi.";
+export declare const USAGE = "buddi plugins \u2014 what this installation has installed\n\n  buddi plugins init <name> [--dir <path>] [--license <spdx>] [--author <name>]\n                                          write a new plugin: manifest, one auto tool, one gated\n                                          tool, a migration, a buddi.md and a test. Refuses a\n                                          directory that already exists. License: Apache-2.0\n                                          unless --license names another. Author: asked, with\n                                          git config user.name as the default.\n  buddi plugins dev <dir>                 watch <dir>/dist and, when it changes, restart the\n                                          service (or say to restart buddi): plugins load at start\n  buddi plugins list [--json]             what is installed, its version, and whether it is healthy\n  buddi plugins info <name>               what it is, what it brought, and what it proposes\n  buddi plugins describe <spec> [--json]  stage it, read its manifest, print what it brings, delete\n                                          the stage. Installs nothing: no record, no schema, no\n                                          tools. --json is what a market listing's claims are.\n  buddi plugins install <spec>            STAGE it and read what it claims (imports nothing)\n  buddi plugins install <spec> --yes --integrity <hash>\n                                          approve it: import it, plan it, install it.\n                                          The hash is the one the staged card printed; a\n                                          package that came from a registry or a .tgz is\n                                          never approved without it, not even with --yes.\n                                          Without it the command stages, prints the card and\n                                          exits 3: staged, not installed.\n  buddi plugins update <name> [--version] stage the next version; --yes --integrity approves it\n  buddi plugins staged                    what is staged and waiting for you\n  buddi plugins approve <id> [--integrity <hash>] [--acknowledge-drift]\n  buddi plugins reject <id>               delete a stage and everything it fetched\n  buddi plugins disable <name>            turn it off now: its tools, pages and watchers stop, its\n                                          data stays, its missions pause\n  buddi plugins enable <name>             turn it back on now and resume its missions\n  buddi plugins uninstall <name>          what removing it would do (removes nothing)\n  buddi plugins uninstall <name> --yes    remove it; its database schema is KEPT\n      --detach-agents                     also take its tools out of agents that were granted them\n      --purge --confirm <name>            ALSO DROP its schema and everything in it. Irreversible,\n                                          and the plugin's own name has to be typed back.\n\nA <spec> is a directory that exists, a .tgz on disk, or an npm package:\n`finance`, `@you/buddi-plugin-finance@1.2.3`. Installing one runs its code inside buddi.";
 export interface ParsedPluginsArgs {
-    command: 'help' | 'list' | 'info' | 'init' | 'dev' | 'install' | 'update' | 'staged' | 'approve' | 'reject' | 'disable' | 'enable' | 'uninstall';
+    command: 'help' | 'list' | 'info' | 'describe' | 'init' | 'dev' | 'install' | 'update' | 'staged' | 'approve' | 'reject' | 'disable' | 'enable' | 'uninstall';
     target?: string;
     yes: boolean;
     detachAgents: boolean;
     purge: boolean;
     acknowledgeDrift: boolean;
-    /** `list --json`. */
+    /** `list --json`, `describe --json`. */
     json?: boolean;
     /** Passed back at approval. Absent means "the hash this run just showed me". */
     integrity?: string;
@@ -67,8 +68,46 @@ export declare function needsIntegrityFirst(staged: StagedPlugin, args: ParsedPl
  * wrong) so a script can tell the two apart and go on to `plugins approve`.
  */
 export declare const STAGED_NOT_INSTALLED = 3;
+/**
+ * The shape `describe --json` prints: what the market's check job writes into
+ * an entry's `claims`, so the listing can never claim less than the code does.
+ * Pure over the stage and the imported manifest.
+ */
+export declare function describeJson(staged: StagedPlugin, manifest: PluginManifest): Record<string, unknown>;
+/**
+ * Stage, import the manifest, print, delete the stage.
+ *
+ * The manifest is imported, so the plugin's top-level code runs in this
+ * process, and the command says so. What never happens: the record is not
+ * written, no migration runs, no tool is registered and nothing is moved out
+ * of staging.
+ */
+export declare function describeSpec(spec: string, opts?: {
+    env?: NodeJS.ProcessEnv;
+    registry?: string;
+    json?: boolean;
+    log?: (line: string) => void;
+}): Promise<number>;
 /** The version of `@buddi/core` this process is running, for the peer range. */
 export declare function runningCoreVersion(): string;
+/**
+ * How `disable` / `enable` reach the running gateway: its own route, so the
+ * change applies there at once. `notRunning` when nothing answered (the next
+ * start reads the record), `unreachable` when one may be running but could
+ * not be asked, `refused` with the gateway's own sentence.
+ */
+export type ToggleInGateway = (name: string, enabled: boolean) => Promise<{
+    notes: string[];
+} | {
+    notRunning: true;
+} | {
+    unreachable: string;
+} | {
+    refused: string;
+}>;
+export interface PluginsCliHooks {
+    toggleInGateway?: ToggleInGateway;
+}
 /**
  * `init` — the first ten minutes.
  *
@@ -78,6 +117,6 @@ export declare function runningCoreVersion(): string;
  */
 /** `git config user.name`, or nothing when git has none (or is not there). */
 export declare function gitUserName(): string | undefined;
-export declare function main(argv?: string[]): Promise<number>;
-export declare function runPluginsCli(argv: string[]): Promise<number>;
+export declare function main(argv?: string[], hooks?: PluginsCliHooks): Promise<number>;
+export declare function runPluginsCli(argv: string[], hooks?: PluginsCliHooks): Promise<number>;
 //# sourceMappingURL=plugins-cli.d.ts.map

package/packages/gateway/dist/plugins-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins-cli.d.ts","sourceRoot":"","sources":["../src/plugins-cli.ts"],"names":[],"mappings":";AAwDA,OAAO,EASL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAO5B,eAAO,MAAM,KAAK,y2FAkC2E,CAAC;AAE9F,MAAM,WAAW,iBAAiB;IAChC,OAAO,EACH,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,KAAK,GACL,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,WAAW,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAuDlE;AAMD,8DAA8D;AAC9D,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AA0CD,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAQ7D;AA8ID,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,SAAS,CAG7E;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAsC3D;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,QAAQ,CAAC,GAC9F,MAAM,EAAE,CAaV;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,cAAc,CAAC,GAAG,MAAM,EAAE,CAO3G;AA4ED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAE1F;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AA0LtC,gFAAgF;AAChF,wBAAgB,kBAAkB,IAAI,MAAM,CAc3C;AAUD;;;;;;GAMG;AACH,8EAA8E;AAC9E,wBAAgB,WAAW,IAAI,MAAM,GAAG,SAAS,CAOhD;AA8FD,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CA8DlF;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnE"}
+{"version":3,"file":"plugins-cli.d.ts","sourceRoot":"","sources":["../src/plugins-cli.ts"],"names":[],"mappings":"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"}

package/packages/gateway/dist/plugins-cli.js

@@ -31,8 +31,9 @@ import { fileURLToPath } from 'node:url';
 import { contributionHeadline, contributionOf, createPool, describeSource, renderContribution, renderUses, pluginUsesChange, } from '@buddi/core';
 import { loadEnvironment } from './bootstrap.js';
 import { installedManifests } from './agents/catalog.js';
-import { isBuiltInPlugin, loadInstalledPlugins, recordFile, } from './plugins/load.js';
-import { acceptAgentSteps, InstallRefusal, renderAgentDrift } from './plugins/install.js';
+import { isBuiltInPlugin, loadInstalledPlugins, loadManifest, manifestProblem, recordFile, } from './plugins/load.js';
+import { acceptAgentSteps, entryPointOf, InstallRefusal, renderAgentDrift } from './plugins/install.js';
+import { driftBetween } from './plugins/claims.js';
 import { applyUninstall, planUninstall, UninstallRefusal } from './plugins/uninstall.js';
 import { approveStaged } from './plugins/approve.js';
 import { listStaged, readStaged, rejectStaged, resolveCoreDir, stagePlugin, StageRefusal, TRUST_SENTENCE, } from './plugins/stage.js';
@@ -53,6 +54,9 @@ export const USAGE = `buddi plugins — what this installation has installed
                                           service (or say to restart buddi): plugins load at start
   buddi plugins list [--json]             what is installed, its version, and whether it is healthy
   buddi plugins info <name>               what it is, what it brought, and what it proposes
+  buddi plugins describe <spec> [--json]  stage it, read its manifest, print what it brings, delete
+                                          the stage. Installs nothing: no record, no schema, no
+                                          tools. --json is what a market listing's claims are.
   buddi plugins install <spec>            STAGE it and read what it claims (imports nothing)
   buddi plugins install <spec> --yes --integrity <hash>
                                           approve it: import it, plan it, install it.
@@ -65,9 +69,9 @@ export const USAGE = `buddi plugins — what this installation has installed
   buddi plugins staged                    what is staged and waiting for you
   buddi plugins approve <id> [--integrity <hash>] [--acknowledge-drift]
   buddi plugins reject <id>               delete a stage and everything it fetched
-  buddi plugins disable <name>            stop loading it: its tools, pages and watchers stop at the
-                                          next start, its data stays, its missions pause
-  buddi plugins enable <name>             load it again at the next start and resume its missions
+  buddi plugins disable <name>            turn it off now: its tools, pages and watchers stop, its
+                                          data stays, its missions pause
+  buddi plugins enable <name>             turn it back on now and resume its missions
   buddi plugins uninstall <name>          what removing it would do (removes nothing)
   buddi plugins uninstall <name> --yes    remove it; its database schema is KEPT
       --detach-agents                     also take its tools out of agents that were granted them
@@ -118,20 +122,22 @@ export function parsePluginsArgs(argv) {
     };
     if (head === undefined || head === 'help' || head === '--help')
         return { command: 'help', ...base };
-    if (flags.has('--json') && head !== 'list')
-        throw new Error('buddi plugins: --json only applies to list');
+    if (flags.has('--json') && head !== 'list' && head !== 'describe') {
+        throw new Error('buddi plugins: --json only applies to list and describe');
+    }
     if (head === 'list')
         return { command: 'list', ...base };
     if (head === 'staged')
         return { command: 'staged', ...base };
-    if (['info', 'init', 'dev', 'install', 'update', 'approve', 'reject', 'disable', 'enable', 'uninstall'].includes(head)) {
+    if (['info', 'describe', 'init', 'dev', 'install', 'update', 'approve', 'reject', 'disable', 'enable', 'uninstall'].includes(head)) {
         const target = positional[0];
         if (target === undefined) {
             const what = head === 'install' ? 'plugin to install (a directory, a .tgz, or an npm package)'
-                : head === 'approve' || head === 'reject' ? 'staging id'
-                    : head === 'init' ? 'name for the new plugin'
-                        : head === 'dev' ? "plugin directory to watch (the one whose dist/ you are building)"
-                            : 'plugin name';
+                : head === 'describe' ? 'plugin to describe (a directory, a .tgz, or an npm package)'
+                    : head === 'approve' || head === 'reject' ? 'staging id'
+                        : head === 'init' ? 'name for the new plugin'
+                            : head === 'dev' ? "plugin directory to watch (the one whose dist/ you are building)"
+                                : 'plugin name';
             throw new Error(`buddi plugins ${head} needs a ${what}`);
         }
         return { command: head, target, ...base };
@@ -629,6 +635,138 @@ async function commandUninstall(name, args, pool, env) {
     console.log('Restart any running buddi process so it stops registering the tools: `buddi service restart`.');
     return 0;
 }
+/* ------------------------------------------------------------------ *
+ * Describing one: what a market listing says it brings
+ * ------------------------------------------------------------------ */
+/**
+ * The shape `describe --json` prints: what the market's check job writes into
+ * an entry's `claims`, so the listing can never claim less than the code does.
+ * Pure over the stage and the imported manifest.
+ */
+export function describeJson(staged, manifest) {
+    const contribution = contributionOf(manifest);
+    return {
+        package: {
+            name: staged.source.kind === 'registry' ? staged.source.name : packageNameOf(staged),
+            version: staged.version,
+            integrity: staged.integrity,
+            ...(staged.publisher === undefined ? {} : { publisher: staged.publisher }),
+            ...(packageLicenseOf(staged) === undefined ? {} : { license: packageLicenseOf(staged) }),
+            ...(staged.author === undefined ? {} : { author: staged.author }),
+            buddiName: staged.declaredName,
+            ...(staged.buddi?.hostApi === undefined ? {} : { hostApi: staged.buddi.hostApi }),
+            uses: staged.uses ?? [],
+            dependencies: staged.dependencies,
+            scripts: staged.scripts,
+        },
+        claims: {
+            ...(staged.claims.schema === undefined ? {} : { schema: staged.claims.schema }),
+            hosts: staged.claims.hosts,
+            missing: staged.claims.missing,
+        },
+        manifest: {
+            name: manifest.name,
+            version: manifest.version,
+            schema: manifest.schema,
+            ...(manifest.description === undefined ? {} : { description: manifest.description }),
+            ...(manifest.author === undefined ? {} : { author: manifest.author }),
+            uses: contribution.uses,
+            network: contribution.network,
+            tools: contribution.tools.map((tool) => ({
+                name: tool.name,
+                tier: tool.tier,
+                ownerOnly: tool.ownerOnly === true,
+                description: tool.description,
+            })),
+            sentinels: contribution.sentinels.map((s) => ({ name: s.id, every: s.every })),
+            sources: contribution.sources.map((s) => ({ name: s.id, every: s.every })),
+            missions: contribution.missions.map((m) => ({ id: m.id, name: m.name, cron: m.cron, agent: m.agent })),
+            agents: contribution.agents.map((a) => ({ id: a.id, handle: a.handle, name: a.name, tools: a.tools })),
+            skills: contribution.skills,
+            pages: (manifest.pages ?? []).map((p) => ({ id: p.id, title: p.title, place: p.place })),
+            views: contribution.views,
+            home: (manifest.home ?? []).length,
+        },
+        drift: driftBetween(staged.claims, manifest),
+    };
+}
+function packageJsonOf(staged) {
+    try {
+        return JSON.parse(readFileSync(path.join(staged.packageDir, 'package.json'), 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function packageNameOf(staged) {
+    const name = packageJsonOf(staged).name;
+    return typeof name === 'string' ? name : staged.name;
+}
+function packageLicenseOf(staged) {
+    const license = packageJsonOf(staged).license;
+    return typeof license === 'string' ? license : undefined;
+}
+/**
+ * Stage, import the manifest, print, delete the stage.
+ *
+ * The manifest is imported, so the plugin's top-level code runs in this
+ * process, and the command says so. What never happens: the record is not
+ * written, no migration runs, no tool is registered and nothing is moved out
+ * of staging.
+ */
+export async function describeSpec(spec, opts = {}) {
+    const env = opts.env ?? process.env;
+    const log = opts.log ?? ((line) => console.log(line));
+    const staged = await stagePlugin(spec, {
+        env,
+        ...(opts.registry === undefined ? {} : { registry: opts.registry }),
+        ...(opts.json === true
+            ? {}
+            : {
+                onPhase: (phase) => {
+                    if (phase === 'fetching')
+                        log('fetching…');
+                    if (phase === 'installing-dependencies')
+                        log('installing its dependencies (--ignore-scripts)…');
+                },
+            }),
+    });
+    try {
+        const entry = entryPointOf(staged.packageDir);
+        const loaded = await loadManifest(entry, undefined, env);
+        if (!loaded.ok)
+            throw new InstallRefusal('not-a-plugin', `${spec} is not a usable plugin: ${loaded.message}`);
+        const problem = manifestProblem(loaded.manifest, undefined, env);
+        if (problem !== undefined)
+            throw new InstallRefusal('not-a-plugin', problem);
+        const manifest = loaded.manifest;
+        if (opts.json === true) {
+            log(JSON.stringify(describeJson(staged, manifest), null, 2));
+            return 0;
+        }
+        // The card is drawn from package.json; a package naming no author there
+        // still names one in its manifest, and here the manifest has been read.
+        const author = staged.author ?? manifest.author;
+        log(renderStaged({ ...staged, ...(author === undefined ? {} : { author }) }).join('\n'));
+        log('');
+        log(renderContribution(contributionOf(manifest)).join('\n'));
+        const drift = driftBetween(staged.claims, manifest);
+        if (drift.length > 0) {
+            log('');
+            log('ITS PROSE AND ITS CODE DO NOT AGREE');
+            for (const difference of drift)
+                log(`  ${difference}`);
+        }
+        log('');
+        log('Its manifest was imported to read it, so its top-level code ran in this process. Nothing');
+        log('was installed: no record was written, no schema touched, no tool registered. The stage');
+        log('was deleted.');
+        return 0;
+    }
+    finally {
+        rejectStaged(staged.id, env);
+    }
+}
 /* ------------------------------------------------------------------ *
  * Starting one, and working on one
  * ------------------------------------------------------------------ */
@@ -648,13 +786,24 @@ export function runningCoreVersion() {
     }
     return '0.1.0';
 }
-/** `disable` / `enable`: the record, the missions, and the restart it needs. */
-async function commandToggle(name, enabled, pool, env) {
-    const outcome = await setPluginEnabled(name, enabled, { env, ...(pool === undefined ? {} : { pool }) });
+/** `disable` / `enable`: through the running gateway when there is one, else the record. */
+async function commandToggle(name, enabled, pool, env, hooks) {
+    const via = hooks.toggleInGateway === undefined ? undefined : await hooks.toggleInGateway(name, enabled);
+    if (via !== undefined && 'notes' in via) {
+        for (const note of via.notes)
+            console.log(note);
+        return 0;
+    }
+    if (via !== undefined && 'refused' in via) {
+        console.error(via.refused);
+        return 1;
+    }
+    const gatewayRunning = via === undefined || !('notRunning' in via);
+    const outcome = await setPluginEnabled(name, enabled, { env, gatewayRunning, ...(pool === undefined ? {} : { pool }) });
     for (const note of toggleNotes(outcome))
         console.log(note);
     if (outcome.restartNeeded)
-        console.log('Restart buddi to apply it: `buddi service restart`.');
+        console.log('`buddi service restart` restarts it.');
     return 0;
 }
 /**
@@ -759,7 +908,7 @@ async function commandDev(dir) {
     });
     return 0;
 }
-export async function main(argv = process.argv.slice(2)) {
+export async function main(argv = process.argv.slice(2), hooks = {}) {
     let args;
     try {
         args = parsePluginsArgs(argv);
@@ -783,6 +932,14 @@ export async function main(argv = process.argv.slice(2)) {
             return await commandInit(args.target, args, process.env);
         if (args.command === 'dev')
             return await commandDev(args.target);
+        // Describing reads a package and deletes the stage; it needs no database.
+        if (args.command === 'describe') {
+            return await describeSpec(args.target, {
+                env: process.env,
+                json: args.json === true,
+                ...(args.registry === undefined ? {} : { registry: args.registry }),
+            });
+        }
     }
     catch (err) {
         console.error(err instanceof Error ? err.message : String(err));
@@ -819,7 +976,7 @@ export async function main(argv = process.argv.slice(2)) {
         if (args.command === 'reject')
             return commandReject(args.target, process.env);
         if (args.command === 'disable' || args.command === 'enable') {
-            return await commandToggle(args.target, args.command === 'enable', pool, process.env);
+            return await commandToggle(args.target, args.command === 'enable', pool, process.env, hooks);
         }
         return await commandUninstall(args.target, args, pool, process.env);
     }
@@ -835,8 +992,8 @@ export async function main(argv = process.argv.slice(2)) {
         await pool?.end().catch(() => { });
     }
 }
-export async function runPluginsCli(argv) {
-    return main(argv);
+export async function runPluginsCli(argv, hooks = {}) {
+    return main(argv, hooks);
 }
 function invokedDirectly() {
     const entry = process.argv[1];