@withbuddi/buddi 0.1.0-pre.22 → 0.1.0-pre.24

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

@@ -0,0 +1,110 @@
+/**
+ * Disabling a plugin without removing it, and enabling it again.
+ *
+ * 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. 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 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) {
+    let manifest = adoptedPlugins(env)?.loaded.find((p) => p.record.name === name)?.manifest;
+    if (manifest === undefined) {
+        const loaded = await loadManifest(entry, { name }, env);
+        if (loaded.ok)
+            manifest = loaded.manifest;
+    }
+    return (manifest?.missions ?? []).map((m) => m.id);
+}
+export async function setPluginEnabled(name, enabled, opts = {}) {
+    const env = opts.env ?? process.env;
+    const file = recordFile(env);
+    const before = readPluginsFile(file);
+    const record = before.plugins.find((p) => p.name === name);
+    if (record === undefined) {
+        throw new InstallRefusal('not-installed', `"${name}" is not an installed plugin, so there is nothing to ${enabled ? 'enable' : 'disable'}.`);
+    }
+    const wasEnabled = record.enabled !== false;
+    const changed = wasEnabled !== enabled;
+    if (changed)
+        writePluginsFile(file, setInstalledPluginEnabled(before, name, enabled).contents);
+    let missions = [];
+    let missionsProblem;
+    if (opts.pool === undefined) {
+        missionsProblem = 'the database was not reachable, so its missions were not ' + (enabled ? 'resumed' : 'paused');
+    }
+    else {
+        try {
+            missions = enabled
+                ? await resumePluginMissions(opts.pool, name)
+                : await pausePluginMissions(opts.pool, name, await suggestedMissionIds(name, record.entry, env));
+        }
+        catch (err) {
+            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: restartFor !== undefined,
+        ...(restartFor === undefined ? {} : { restartFor }),
+        ...(loadProblem === undefined ? {} : { loadProblem }),
+    };
+}
+/** 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 && outcome.loadProblem === undefined && !outcome.restartNeeded) {
+        notes.push(`${name} is already ${enabled ? 'enabled' : 'disabled'}.`);
+    }
+    else if (enabled) {
+        notes.push(outcome.loadProblem === undefined ? 'Enabled.' : `Enabled, but it did not load: ${outcome.loadProblem}.`);
+    }
+    else {
+        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(', ')}.`
+            : `Paused ${outcome.missions.length === 1 ? 'the mission' : 'the missions'} ${outcome.missions.join(', ')} (${pluginPausedReason(name)}).`);
+    }
+    if (outcome.missionsProblem !== undefined)
+        notes.push(`Note: ${outcome.missionsProblem}.`);
+    return notes;
+}
+//# sourceMappingURL=toggle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.js","sourceRoot":"","sources":["../../src/plugins/toggle.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>]\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.\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 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' | '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;
@@ -20,9 +21,12 @@ export interface ParsedPluginsArgs {
     dir?: string;
     /** The SPDX license `init` writes. Default: Apache-2.0. */
     license?: string;
+    /** The author `init` writes. Default: asked, then `git config user.name`. */
+    author?: string;
 }
 export declare function parsePluginsArgs(argv: string[]): ParsedPluginsArgs;
-export type Health = 'ok' | 'warn' | 'fail';
+/** `off`: installed and disabled by the owner, not loaded. */
+export type Health = 'ok' | 'warn' | 'fail' | 'off';
 export interface PluginRow {
     name: string;
     version: string;
@@ -32,6 +36,10 @@ export interface PluginRow {
 }
 /** The table `plugins list` prints. Pure over what it is handed. */
 export declare function renderRows(rows: readonly PluginRow[]): string;
+/** "by <name> (<url>)", from package.json's author; nothing when it names none. */
+export declare function authorLine(author: StagedPlugin['author']): string | undefined;
+/** Everything the owner reads before the plugin has ever been imported. */
+export declare function renderStaged(staged: StagedPlugin): string[];
 /** Which name it installs under, and a word about a core it asked npm for. */
 export declare function renderStagedName(staged: Pick<StagedPlugin, 'declaredName' | 'nameFromManifest' | 'coreAsDependency' | 'source'>): string[];
 /**
@@ -60,8 +68,55 @@ 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;
-export declare function main(argv?: string[]): Promise<number>;
-export declare function runPluginsCli(argv: string[]): Promise<number>;
+/**
+ * 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.
+ *
+ * It writes and nothing else: no database, no record, no import. The scaffold
+ * is already installable, so the sentence at the end is the whole rest of the
+ * path and the owner can paste it.
+ */
+/** `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[], 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":";AAsDA,OAAO,EASL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAM5B,eAAO,MAAM,KAAK,g9EA8B2E,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,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;CAClB;AAKD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAsDlE;AAMD,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C,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;AA2KD,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;AAgFD,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CA2DlF;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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"}