@red-codes/agentguard 1.0.0

package/dist/cli/commands/plugin.js

@@ -0,0 +1,234 @@
+// CLI command: agentguard plugin — manage installed plugins.
+//
+// Subcommands:
+//   list              List all installed plugins
+//   install <source>  Install a plugin from a local path
+//   remove <id>       Remove an installed plugin
+//   enable <id>       Enable a disabled plugin
+//   disable <id>      Disable an installed plugin
+//   search [query]    Search for plugins on npm
+import { readFileSync, existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { createPluginRegistry } from '../../plugins/registry.js';
+import { searchNpmPlugins, searchLocalPlugins } from '../../plugins/discovery.js';
+import { bold, color, dim } from '../colors.js';
+const STORAGE_DIR = '.agentguard';
+/**
+ * Main plugin command handler.
+ *
+ * Routes to the appropriate subcommand based on the first argument.
+ */
+export async function plugin(args) {
+    const subcommand = args[0];
+    switch (subcommand) {
+        case 'list':
+        case 'ls':
+            return pluginList();
+        case 'install':
+        case 'add':
+            return pluginInstall(args.slice(1));
+        case 'remove':
+        case 'rm':
+            return pluginRemove(args.slice(1));
+        case 'enable':
+            return pluginEnable(args.slice(1));
+        case 'disable':
+            return pluginDisable(args.slice(1));
+        case 'search':
+            return pluginSearch(args.slice(1));
+        case undefined:
+        case 'help':
+        case '--help':
+        case '-h':
+            printPluginHelp();
+            return 0;
+        default:
+            console.error(`  Unknown plugin subcommand: ${subcommand}`);
+            console.error('  Run "agentguard plugin help" for usage info.');
+            return 1;
+    }
+}
+function pluginList() {
+    const registry = createPluginRegistry({ storageDir: STORAGE_DIR });
+    const plugins = registry.list();
+    if (plugins.length === 0) {
+        console.log(`\n  ${dim('No plugins installed.')}`);
+        console.log(`  ${dim('Run "agentguard plugin install <path>" to install a plugin.')}\n`);
+        return 0;
+    }
+    console.log(`\n  ${bold('Installed Plugins')} ${dim(`(${plugins.length})`)}\n`);
+    for (const p of plugins) {
+        const status = p.enabled ? color('enabled', 'green') : color('disabled', 'yellow');
+        const typeLabel = color(p.manifest.type, 'cyan');
+        console.log(`  ${bold(p.manifest.name)} ${dim(`v${p.manifest.version}`)}`);
+        console.log(`    ID:     ${p.manifest.id}`);
+        console.log(`    Type:   ${typeLabel}`);
+        console.log(`    Status: ${status}`);
+        console.log(`    Source: ${dim(p.source)}`);
+        if (p.manifest.description) {
+            console.log(`    Desc:   ${dim(p.manifest.description)}`);
+        }
+        if (p.manifest.capabilities && p.manifest.capabilities.length > 0) {
+            console.log(`    Caps:   ${dim(p.manifest.capabilities.join(', '))}`);
+        }
+        console.log();
+    }
+    return 0;
+}
+function pluginInstall(args) {
+    const source = args[0];
+    if (!source) {
+        console.error('  Error: Please specify a plugin source (local path or package name).');
+        return 1;
+    }
+    const resolvedPath = resolve(source);
+    // Try to load manifest from the source
+    const manifest = loadManifestFromPath(resolvedPath);
+    if (!manifest) {
+        console.error(`  Error: Could not find a valid plugin manifest at "${source}".`);
+        console.error('  Expected: package.json with an "agentguard" field containing the manifest.');
+        return 1;
+    }
+    const registry = createPluginRegistry({ storageDir: STORAGE_DIR });
+    const result = registry.install(manifest, source);
+    if (!result.valid) {
+        console.error(`\n  ${color('Installation failed', 'red')} for ${source}:\n`);
+        for (const err of result.errors) {
+            console.error(`    ${color('✗', 'red')} ${err.field}: ${err.message}`);
+        }
+        console.log();
+        return 1;
+    }
+    console.log(`\n  ${color('✓', 'green')} Installed ${bold(manifest.name)} ${dim(`v${manifest.version}`)}`);
+    console.log(`    ID:   ${manifest.id}`);
+    console.log(`    Type: ${manifest.type}\n`);
+    return 0;
+}
+function pluginRemove(args) {
+    const pluginId = args[0];
+    if (!pluginId) {
+        console.error('  Error: Please specify a plugin ID to remove.');
+        return 1;
+    }
+    const registry = createPluginRegistry({ storageDir: STORAGE_DIR });
+    const entry = registry.get(pluginId);
+    if (!entry) {
+        console.error(`  Error: Plugin "${pluginId}" is not installed.`);
+        return 1;
+    }
+    const removed = registry.remove(pluginId);
+    if (!removed) {
+        console.error(`  Error: Cannot remove "${pluginId}" — other plugins depend on it.`);
+        return 1;
+    }
+    console.log(`\n  ${color('✓', 'green')} Removed ${bold(entry.manifest.name)} ${dim(`v${entry.manifest.version}`)}\n`);
+    return 0;
+}
+function pluginEnable(args) {
+    const pluginId = args[0];
+    if (!pluginId) {
+        console.error('  Error: Please specify a plugin ID to enable.');
+        return 1;
+    }
+    const registry = createPluginRegistry({ storageDir: STORAGE_DIR });
+    if (!registry.enable(pluginId)) {
+        console.error(`  Error: Plugin "${pluginId}" is not installed.`);
+        return 1;
+    }
+    console.log(`  ${color('✓', 'green')} Enabled "${pluginId}"`);
+    return 0;
+}
+function pluginDisable(args) {
+    const pluginId = args[0];
+    if (!pluginId) {
+        console.error('  Error: Please specify a plugin ID to disable.');
+        return 1;
+    }
+    const registry = createPluginRegistry({ storageDir: STORAGE_DIR });
+    if (!registry.disable(pluginId)) {
+        console.error(`  Error: Plugin "${pluginId}" is not installed.`);
+        return 1;
+    }
+    console.log(`  ${color('✓', 'green')} Disabled "${pluginId}"`);
+    return 0;
+}
+async function pluginSearch(args) {
+    const query = args[0];
+    const localDir = args.includes('--local') ? args[args.indexOf('--local') + 1] : undefined;
+    console.log(`\n  ${bold('Searching for plugins')}${query ? ` matching "${query}"` : ''}...\n`);
+    // Search npm registry
+    const npmResults = await searchNpmPlugins(query);
+    // Search local directory if specified
+    const localResults = localDir ? searchLocalPlugins({ directory: localDir }) : [];
+    const total = npmResults.length + localResults.length;
+    if (total === 0) {
+        console.log(`  ${dim('No plugins found.')}\n`);
+        return 0;
+    }
+    if (npmResults.length > 0) {
+        console.log(`  ${bold('npm registry')} ${dim(`(${npmResults.length} results)`)}\n`);
+        for (const p of npmResults) {
+            console.log(`    ${bold(p.name)} ${dim(`v${p.version}`)}`);
+            if (p.description) {
+                console.log(`      ${dim(p.description)}`);
+            }
+        }
+        console.log();
+    }
+    if (localResults.length > 0) {
+        console.log(`  ${bold('Local')} ${dim(`(${localResults.length} results)`)}\n`);
+        for (const p of localResults) {
+            console.log(`    ${bold(p.name)} ${dim(`v${p.version}`)} ${p.type ? color(p.type, 'cyan') : ''}`);
+            if (p.description) {
+                console.log(`      ${dim(p.description)}`);
+            }
+            console.log(`      ${dim(p.sourceId)}`);
+        }
+        console.log();
+    }
+    return 0;
+}
+/**
+ * Load a PluginManifest from a local path.
+ *
+ * Expects the path to be a directory containing a package.json
+ * with an "agentguard" field containing the plugin manifest.
+ */
+function loadManifestFromPath(dirPath) {
+    const pkgPath = join(dirPath, 'package.json');
+    if (!existsSync(pkgPath))
+        return null;
+    try {
+        const raw = readFileSync(pkgPath, 'utf8');
+        const pkg = JSON.parse(raw);
+        return pkg.agentguard ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function printPluginHelp() {
+    console.log(`
+  ${bold('agentguard plugin')} — Manage AgentGuard plugins
+
+  ${bold('Usage:')}
+    agentguard plugin <command> [options]
+
+  ${bold('Commands:')}
+    list, ls              List all installed plugins
+    install, add <path>   Install a plugin from a local path
+    remove, rm <id>       Remove an installed plugin by ID
+    enable <id>           Enable a disabled plugin
+    disable <id>          Disable an installed plugin
+    search [query]        Search for plugins on npm
+
+  ${bold('Examples:')}
+    agentguard plugin list
+    agentguard plugin install ./my-renderer-plugin
+    agentguard plugin remove agentguard-renderer-json
+    agentguard plugin disable agentguard-renderer-json
+    agentguard plugin search renderer
+    agentguard plugin search --local ./plugins
+`);
+}
+//# sourceMappingURL=plugin.js.map

package/dist/cli/commands/plugin.js.map

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

package/dist/cli/commands/replay.d.ts

@@ -0,0 +1,12 @@
+/**
+ * replay command — Replay execution events from a session.
+ *
+ * Supports two modes:
+ * 1. Governance replay (--run <runId> or --last): Loads JSONL events from the
+ *    AgentGuard event store and reconstructs action encounters using the replay engine.
+ * 2. Execution log replay (default): Loads NDJSON execution event logs for raw
+ *    event-level display.
+ */
+import type { Command } from 'commander';
+export declare function registerReplayCommand(program: Command): void;
+//# sourceMappingURL=replay.d.ts.map

package/dist/cli/commands/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/replay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgH5D"}

package/dist/cli/commands/replay.js

@@ -0,0 +1,208 @@
+/**
+ * replay command — Replay execution events from a session.
+ *
+ * Supports two modes:
+ * 1. Governance replay (--run <runId> or --last): Loads JSONL events from the
+ *    AgentGuard event store and reconstructs action encounters using the replay engine.
+ * 2. Execution log replay (default): Loads NDJSON execution event logs for raw
+ *    event-level display.
+ */
+import pino from 'pino';
+import { createExecutionEventLog } from '../../core/execution-log/event-log.js';
+import { loadReplaySession, listRunIds, getLatestRunId } from '../../kernel/replay-engine.js';
+export function registerReplayCommand(program) {
+    program
+        .command('replay')
+        .description('Replay execution events from a session log')
+        .argument('[file]', 'NDJSON event log file to replay (legacy mode)')
+        .option('-f, --from <eventId>', 'Start replay from this event ID')
+        .option('--kind <kind>', 'Filter by event kind')
+        .option('--actor <actor>', 'Filter by actor (human, agent, system)')
+        .option('--seed <seed>', 'Seed for deterministic replay (overrides session seed)')
+        .option('--limit <n>', 'Maximum events to display', '50')
+        .option('-r, --run <runId>', 'Replay a governance run by ID')
+        .option('-l, --last', 'Replay the most recent governance run')
+        .option('--list-runs', 'List available governance runs')
+        .option('--summary', 'Show session summary only')
+        .option('--denied-only', 'Show only denied actions')
+        .option('--base-dir <dir>', 'Base directory for event storage', '.agentguard')
+        .action(async (file, options) => {
+        // --- Governance replay mode ---
+        if (options.listRuns) {
+            renderRunList(options.baseDir);
+            return;
+        }
+        if (options.run || options.last) {
+            const runId = options.run || getLatestRunId(options.baseDir);
+            if (!runId) {
+                console.error('\n  No governance runs found.');
+                console.error('  Run "agentguard guard" first to generate events.\n');
+                return;
+            }
+            const session = loadReplaySession(runId, { baseDir: options.baseDir });
+            if (!session) {
+                console.error(`\n  Run "${runId}" not found or has no events.\n`);
+                return;
+            }
+            if (options.summary) {
+                renderSessionSummary(session);
+            }
+            else {
+                renderGovernanceReplay(session, { deniedOnly: options.deniedOnly });
+            }
+            return;
+        }
+        // --- Legacy execution log replay mode ---
+        const targetFile = file || '.events.ndjson';
+        const logger = pino({ name: 'agentguard-replay' });
+        const fs = await import('node:fs');
+        if (!fs.existsSync(targetFile)) {
+            logger.error({ file: targetFile }, 'Event log file not found');
+            console.error(`Event log file not found: ${targetFile}`);
+            console.error('Run "agentguard guard" first to generate events.');
+            return;
+        }
+        const log = createExecutionEventLog();
+        const ndjson = fs.readFileSync(targetFile, 'utf-8');
+        const loaded = log.fromNDJSON(ndjson);
+        logger.info({ loaded }, 'Events loaded');
+        let events = options.from ? log.replay(options.from) : log.replay();
+        if (options.kind) {
+            events = events.filter((e) => e.kind === options.kind);
+        }
+        if (options.actor) {
+            events = events.filter((e) => e.actor === options.actor);
+        }
+        const limit = parseInt(options.limit, 10);
+        const displayed = events.slice(0, limit);
+        if (options.seed) {
+            console.log(`\nSeed: ${options.seed} (override)`);
+        }
+        console.log(`\nReplaying ${displayed.length} of ${events.length} events:\n`);
+        for (const event of displayed) {
+            const time = new Date(event.timestamp).toISOString();
+            const ctx = event.context.file ? ` (${event.context.file})` : '';
+            const caused = event.causedBy ? ` <- ${event.causedBy}` : '';
+            console.log(`  [${time}] ${event.actor}/${event.source} ${event.kind}${ctx}${caused}`);
+            console.log(`    id: ${event.id}`);
+            if (Object.keys(event.payload).length > 0) {
+                console.log(`    payload: ${JSON.stringify(event.payload)}`);
+            }
+            console.log();
+        }
+        if (events.length > limit) {
+            console.log(`  ... and ${events.length - limit} more events`);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Governance replay rendering
+// ---------------------------------------------------------------------------
+function renderRunList(baseDir) {
+    const runIds = listRunIds(baseDir);
+    if (runIds.length === 0) {
+        console.error('\n  No governance runs found.');
+        console.error('  Run "agentguard guard" first to generate events.\n');
+        return;
+    }
+    console.log('\n  Available governance runs:\n');
+    for (const id of runIds.slice(0, 20)) {
+        console.log(`    ${id}`);
+    }
+    if (runIds.length > 20) {
+        console.log(`    ... and ${runIds.length - 20} more`);
+    }
+    console.log('\n  Usage: agentguard replay --run <runId>\n');
+}
+function renderSessionSummary(session) {
+    const s = session.summary;
+    console.log(`\n  Governance Session Summary`);
+    console.log(`  Run: ${session.runId}`);
+    console.log(`  Events: ${session.events.length}`);
+    console.log(`  Duration: ${formatDuration(s.durationMs)}`);
+    console.log('');
+    console.log(`  Actions:     ${s.totalActions}`);
+    console.log(`  Allowed:     ${s.allowed}`);
+    console.log(`  Denied:      ${s.denied}`);
+    console.log(`  Executed:    ${s.executed}`);
+    console.log(`  Failed:      ${s.failed}`);
+    console.log(`  Violations:  ${s.violations}`);
+    console.log(`  Escalations: ${s.escalations}`);
+    console.log(`  Simulations: ${s.simulationsRun}`);
+    if (Object.keys(s.actionTypes).length > 0) {
+        console.log('\n  Action types:');
+        const sorted = Object.entries(s.actionTypes).sort((a, b) => b[1] - a[1]);
+        for (const [type, count] of sorted) {
+            console.log(`    ${type.padEnd(24)} ${count}`);
+        }
+    }
+    if (s.denialReasons.length > 0) {
+        console.log('\n  Denial reasons:');
+        for (const reason of s.denialReasons) {
+            console.log(`    - ${truncate(reason, 70)}`);
+        }
+    }
+    console.log('');
+}
+function renderGovernanceReplay(session, options = {}) {
+    let actions = session.actions;
+    if (options.deniedOnly) {
+        actions = actions.filter((a) => !a.allowed);
+    }
+    console.log(`\n  Governance Replay — ${session.runId}`);
+    console.log(`  ${session.events.length} events, ${session.actions.length} actions`);
+    console.log('');
+    if (actions.length === 0) {
+        console.log('  No actions to display.\n');
+        return;
+    }
+    for (const action of actions) {
+        renderAction(action);
+    }
+    renderSessionSummary(session);
+}
+function renderAction(action) {
+    const icon = action.allowed ? (action.succeeded ? '+' : '!') : 'x';
+    const status = action.allowed
+        ? action.succeeded
+            ? 'ALLOWED+EXECUTED'
+            : action.executed
+                ? 'ALLOWED+FAILED'
+                : 'ALLOWED (dry-run)'
+        : 'DENIED';
+    const time = new Date(action.requestedEvent.timestamp).toISOString().slice(11, 19);
+    console.log(`  [${time}] ${icon} ${action.actionType} -> ${action.target || '(none)'}`);
+    console.log(`           Status: ${status}`);
+    if (action.decisionEvent) {
+        const reason = action.decisionEvent.reason || '';
+        if (reason) {
+            console.log(`           Reason: ${truncate(reason, 60)}`);
+        }
+    }
+    if (action.simulationEvent) {
+        const risk = action.simulationEvent.riskLevel || 'unknown';
+        const blast = action.simulationEvent.blastRadius ?? '?';
+        console.log(`           Simulation: risk=${risk}, blast=${blast}`);
+    }
+    for (const gov of action.governanceEvents) {
+        const detail = gov.reason || gov.invariant || gov.policy || '';
+        console.log(`           Violation: ${gov.kind}${detail ? ` — ${truncate(detail, 50)}` : ''}`);
+    }
+    console.log('');
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    if (minutes === 0)
+        return `${seconds}s`;
+    return `${minutes}m ${seconds % 60}s`;
+}
+function truncate(str, max) {
+    return str.length > max ? str.slice(0, max - 3) + '...' : str;
+}
+//# sourceMappingURL=replay.js.map

package/dist/cli/commands/replay.js.map

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

package/dist/cli/file-event-store.d.ts

@@ -0,0 +1,41 @@
+import type { DomainEvent, EventStore } from '../core/types.js';
+/**
+ * Create a file-based event store.
+ * Events are persisted as newline-delimited JSON (JSONL) files.
+ * Each session gets its own file for efficient append operations.
+ */
+export declare function createFileEventStore(sessionId?: string): EventStore & {
+    sessionId: string;
+};
+/**
+ * List all session IDs that have stored events.
+ */
+export declare function listSessions(): string[];
+/**
+ * Load events from a specific session.
+ */
+export declare function loadSession(sessionId: string): DomainEvent[];
+/** Metadata header written as the first line of an exported session file. */
+export interface ExportHeader {
+    readonly __agentguard_export: true;
+    readonly version: 1;
+    readonly sessionId: string;
+    readonly exportedAt: number;
+    readonly eventCount: number;
+}
+/**
+ * Export a session to a portable JSONL file for sharing.
+ * The first line is a metadata header; subsequent lines are domain events.
+ * Returns the number of events exported.
+ */
+export declare function exportSession(sessionId: string, outputPath: string): number;
+/**
+ * Import a session from a portable JSONL file.
+ * Validates the export header and each event before writing.
+ * Returns the sessionId and number of events imported.
+ */
+export declare function importSession(inputPath: string, targetSessionId?: string): {
+    sessionId: string;
+    eventCount: number;
+};
+//# sourceMappingURL=file-event-store.d.ts.map

package/dist/cli/file-event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-event-store.d.ts","sourceRoot":"","sources":["../../src/cli/file-event-store.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAe,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAgB7E;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAwE3F;AA+BD;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAKvC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAe5D;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,mBAAmB,EAAE,IAAI,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAiB3E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,MAAM,GACvB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAoD3C"}