agentvault 1.0.1 → 1.0.5

package/dist/cli/index.js

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
 /**
- * SoulRecall CLI
+ * AgentVault CLI
  *
- * Command-line interface for the SoulRecall platform.
+ * Command-line interface for the AgentVault platform.
  */
+import { realpathSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
 import { Command } from 'commander';
 import { VERSION } from '../src/index.js';
 import { initCommand } from './commands/init.js';
@@ -39,10 +41,39 @@ import { archiveCmd } from './commands/archive.js';
 import { inferenceCmd } from './commands/inference.js';
 import { approveCmd } from './commands/approve.js';
 import { cloudBackupCmd } from './commands/cloud-backup.js';
+// Phase 5 commands
+import { vaultCmd } from './commands/vault.js';
+// Phase 6 commands (PRD-004: Private ICP Replica)
+import { pilotCmd } from './commands/pilot.js';
+// iOS skills command
+import { skillsCmd } from './commands/skills.js';
+// Phase 6 commands
+import { orchestrateCmd } from './commands/orchestrate.js';
+// Google ADK / A2A agent minting
+import { mintCmd } from './commands/mint.js';
+// Fault Tolerance commands
+import { cronCmd } from './commands/cron.js';
+import { mirrorCmd } from './commands/mirror.js';
+// Security & audit commands
+import { repoCmd } from './commands/repo.js';
+// MemoryRepo commands
+import { memoryCmd } from './commands/memory.js';
+// Rebase command
+import { rebaseCommand } from './commands/rebase.js';
+// MCP commands (Phase 2)
+import { mcpCmd } from './commands/mcp.js';
+// Polytician commands (Phase 5)
+import { polyticianCmd } from './commands/polytician.js';
+// Agent Safehouse secret management layer
+import { safehouseCmd } from './commands/safehouse.js';
+// Wiki — LLM-maintained knowledge base (archivist)
+import { wikiCmd } from './commands/wiki.js';
+// Merge command — local bundle <-> on-chain thoughtform merging
+import { mergeCommand } from './merge.js';
 export function createProgram() {
     const program = new Command();
     program
-        .name('soulrecall')
+        .name('agentvault')
         .description('Persistent On-Chain AI Agent Platform - Sovereign, Reconstructible, Autonomous')
         .version(VERSION, '-v, --version', 'output the current version');
     // Register commands
@@ -80,14 +111,55 @@ export function createProgram() {
     program.addCommand(inferenceCmd);
     program.addCommand(approveCmd);
     program.addCommand(cloudBackupCmd);
+    // Phase 5 commands
+    program.addCommand(vaultCmd);
+    // Phase 6 commands (PRD-004: Private ICP Replica)
+    program.addCommand(pilotCmd);
+    // iOS skills command
+    program.addCommand(skillsCmd);
+    // Phase 6 commands
+    program.addCommand(orchestrateCmd());
+    // Google ADK / A2A agent minting
+    program.addCommand(mintCmd());
+    // Fault Tolerance commands
+    program.addCommand(cronCmd());
+    program.addCommand(mirrorCmd());
+    // Security & audit commands
+    program.addCommand(repoCmd);
+    // MemoryRepo commands
+    program.addCommand(memoryCmd);
+    // Rebase command
+    program.addCommand(rebaseCommand());
+    // MCP commands
+    program.addCommand(mcpCmd);
+    // Polytician commands
+    program.addCommand(polyticianCmd);
+    // Agent Safehouse secret management layer
+    program.addCommand(safehouseCmd);
+    // Wiki — LLM-maintained knowledge base (archivist)
+    program.addCommand(wikiCmd);
+    // Merge command — local bundle <-> on-chain thoughtform merging
+    program.addCommand(mergeCommand());
     return program;
 }
 export async function run(args = process.argv) {
     const program = createProgram();
     await program.parseAsync(args);
 }
-// CLI entry point
-if (import.meta.url === `file://${process.argv[1]}`) {
+// CLI entry point. npm installs the bin as a symlink in node_modules/.bin, so
+// argv[1] must be realpath-resolved before comparing against this module.
+function isMainModule() {
+    if (!process.argv[1]) {
+        return false;
+    }
+    try {
+        return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (isMainModule()) {
     run().catch((error) => {
         console.error('Error:', error.message);
         process.exit(1);

package/dist/cli/index.js.map

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

package/dist/cli/merge.d.ts

@@ -0,0 +1,70 @@
+/**
+ * agentvault merge — Merge local thoughtform bundle with on-chain canister state
+ *
+ * Usage:
+ *   agentvault merge --input=local_bundle.json --branch=main --canister=<canister-id>
+ *
+ * Steps:
+ *   1. Deserialize local bundle JSON (array of thoughtforms with id + updatedAt).
+ *   2. Fetch the current on-chain commit from the MemoryRepo canister.
+ *   3. Resolve conflicts:
+ *      - Matching IDs → keep the entry with the greater updatedAt.
+ *      - New IDs → add them.
+ *   4. Create a new commit on the canister with the merged thoughtforms.
+ *
+ * Acceptance: merged data pushed; canister has combined data, no duplicates.
+ */
+import { Command } from 'commander';
+/**
+ * A single thoughtform entry.
+ * `id` is the unique identifier; `updatedAt` is a numeric timestamp (ms epoch).
+ */
+export interface ThoughtForm {
+    id: string;
+    content: string;
+    updatedAt: number;
+    tags?: string[];
+    [key: string]: unknown;
+}
+/**
+ * The expected shape of a local bundle JSON file.
+ */
+export interface Bundle {
+    thoughtforms: ThoughtForm[];
+}
+/**
+ * Summary returned after a successful merge.
+ */
+export interface MergeSummary {
+    added: number;
+    updated: number;
+    unchanged: number;
+    total: number;
+    commitId: string;
+}
+/**
+ * Merge local thoughtforms with on-chain thoughtforms.
+ *
+ * Conflict resolution:
+ *   - Same ID → keep the one with the greater `updatedAt`.
+ *   - New IDs → add them.
+ *
+ * Returns the merged list along with counts.
+ */
+export declare function mergeThoughtforms(local: ThoughtForm[], remote: ThoughtForm[]): {
+    merged: ThoughtForm[];
+    added: number;
+    updated: number;
+    unchanged: number;
+};
+/**
+ * Execute the merge operation.
+ */
+export declare function executeMerge(options: {
+    input: string;
+    branch: string;
+    canister: string;
+    host?: string;
+}): Promise<MergeSummary>;
+export declare function mergeCommand(): Command;
+//# sourceMappingURL=merge.d.ts.map

package/dist/cli/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../cli/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AA0FD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE,WAAW,EAAE,GACpB;IAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAqC9E;AAgBD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,YAAY,CAAC,CAqDxB;AAID,wBAAgB,YAAY,IAAI,OAAO,CAmCtC"}

package/dist/cli/merge.js

@@ -0,0 +1,232 @@
+/**
+ * agentvault merge — Merge local thoughtform bundle with on-chain canister state
+ *
+ * Usage:
+ *   agentvault merge --input=local_bundle.json --branch=main --canister=<canister-id>
+ *
+ * Steps:
+ *   1. Deserialize local bundle JSON (array of thoughtforms with id + updatedAt).
+ *   2. Fetch the current on-chain commit from the MemoryRepo canister.
+ *   3. Resolve conflicts:
+ *      - Matching IDs → keep the entry with the greater updatedAt.
+ *      - New IDs → add them.
+ *   4. Create a new commit on the canister with the merged thoughtforms.
+ *
+ * Acceptance: merged data pushed; canister has combined data, no duplicates.
+ */
+import * as fs from 'node:fs';
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { createMemoryRepoActor, createAnonymousAgent, validateCanisterId, } from '../src/canister/memory-repo-actor.js';
+// ─── Helpers ────────────────────────────────────────────────────────────────
+/**
+ * Read and validate a local bundle file.
+ */
+function readBundle(filePath) {
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        throw new Error(`Cannot read input file: ${filePath}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Invalid JSON in bundle file: ${filePath}`);
+    }
+    // Accept either { thoughtforms: [...] } or a bare array
+    if (Array.isArray(parsed)) {
+        return { thoughtforms: validateThoughtforms(parsed) };
+    }
+    const obj = parsed;
+    if (!obj.thoughtforms || !Array.isArray(obj.thoughtforms)) {
+        throw new Error('Bundle must contain a "thoughtforms" array or be a JSON array of thoughtforms.');
+    }
+    return { thoughtforms: validateThoughtforms(obj.thoughtforms) };
+}
+/**
+ * Validate that each entry has the required fields.
+ */
+function validateThoughtforms(items) {
+    const validated = [];
+    for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        if (!item || typeof item !== 'object') {
+            throw new Error(`thoughtforms[${i}]: must be an object`);
+        }
+        if (typeof item.id !== 'string' || !item.id) {
+            throw new Error(`thoughtforms[${i}]: missing or invalid "id" (string required)`);
+        }
+        if (typeof item.content !== 'string') {
+            throw new Error(`thoughtforms[${i}]: missing or invalid "content" (string required)`);
+        }
+        if (typeof item.updatedAt !== 'number' || !Number.isFinite(item.updatedAt)) {
+            throw new Error(`thoughtforms[${i}]: missing or invalid "updatedAt" (number required)`);
+        }
+        validated.push(item);
+    }
+    return validated;
+}
+/**
+ * Parse on-chain commit diff back into thoughtforms.
+ *
+ * The diff is stored as a JSON-serialised array of thoughtforms.
+ * If parsing fails (e.g. the commit used a free-text diff), return an empty array.
+ */
+function parseThoughtformsFromDiff(diff) {
+    if (!diff || !diff.trim())
+        return [];
+    try {
+        const parsed = JSON.parse(diff);
+        if (Array.isArray(parsed)) {
+            return validateThoughtforms(parsed);
+        }
+        // If it's a wrapper object with thoughtforms
+        if (parsed && typeof parsed === 'object' && Array.isArray(parsed.thoughtforms)) {
+            return validateThoughtforms(parsed.thoughtforms);
+        }
+    }
+    catch {
+        // Not JSON — might be a plain-text diff; return empty
+    }
+    return [];
+}
+/**
+ * Merge local thoughtforms with on-chain thoughtforms.
+ *
+ * Conflict resolution:
+ *   - Same ID → keep the one with the greater `updatedAt`.
+ *   - New IDs → add them.
+ *
+ * Returns the merged list along with counts.
+ */
+export function mergeThoughtforms(local, remote) {
+    // Index remote by id
+    const remoteMap = new Map();
+    for (const tf of remote) {
+        remoteMap.set(tf.id, tf);
+    }
+    let added = 0;
+    let updated = 0;
+    let unchanged = 0;
+    // Start with a copy of the remote map, then apply local changes
+    const mergedMap = new Map(remoteMap);
+    for (const localTf of local) {
+        const existing = mergedMap.get(localTf.id);
+        if (!existing) {
+            // New entry — add it
+            mergedMap.set(localTf.id, localTf);
+            added++;
+        }
+        else if (localTf.updatedAt > existing.updatedAt) {
+            // Local is newer — update
+            mergedMap.set(localTf.id, localTf);
+            updated++;
+        }
+        else {
+            // Remote is same or newer — keep remote
+            unchanged++;
+        }
+    }
+    return {
+        merged: Array.from(mergedMap.values()),
+        added,
+        updated,
+        unchanged,
+    };
+}
+// ─── Execution ──────────────────────────────────────────────────────────────
+/**
+ * Create an initialized ICP agent, fetching root key for local replicas.
+ */
+async function createInitializedAgent(host) {
+    const agent = createAnonymousAgent(host);
+    const resolvedHost = host ?? process.env.ICP_LOCAL_URL ?? 'http://localhost:4943';
+    if (!resolvedHost.includes('ic0.app') && !resolvedHost.includes('icp0.io')) {
+        await agent.fetchRootKey();
+    }
+    return agent;
+}
+/**
+ * Execute the merge operation.
+ */
+export async function executeMerge(options) {
+    // 1. Deserialise local bundle
+    const bundle = readBundle(options.input);
+    if (bundle.thoughtforms.length === 0) {
+        throw new Error('Local bundle contains no thoughtforms.');
+    }
+    // 2. Validate canister and create actor
+    validateCanisterId(options.canister);
+    const agent = await createInitializedAgent(options.host);
+    const actor = createMemoryRepoActor(options.canister, agent);
+    // 3. Fetch current on-chain state from the target branch
+    //    First switch to the target branch, then get the latest commit.
+    const switchResult = await actor.switchBranch(options.branch);
+    if ('err' in switchResult) {
+        throw new Error(`Cannot switch to branch '${options.branch}': ${switchResult.err}`);
+    }
+    const commits = await actor.log([options.branch]);
+    const remoteThoughtforms = [];
+    const headCommit = commits[0];
+    if (headCommit !== undefined) {
+        // Parse thoughtforms from the latest (head) commit diff
+        const parsed = parseThoughtformsFromDiff(headCommit.diff);
+        remoteThoughtforms.push(...parsed);
+    }
+    // 4. Resolve conflicts
+    const { merged, added, updated, unchanged } = mergeThoughtforms(bundle.thoughtforms, remoteThoughtforms);
+    // 5. Create new commit with merged data
+    const diffPayload = JSON.stringify(merged, null, 2);
+    const message = `merge: ${added} added, ${updated} updated, ${unchanged} unchanged (${merged.length} total)`;
+    const tags = ['merge', 'cli'];
+    const commitResult = await actor.commit(message, diffPayload, tags);
+    if ('err' in commitResult) {
+        throw new Error(`Commit failed: ${commitResult.err}`);
+    }
+    return {
+        added,
+        updated,
+        unchanged,
+        total: merged.length,
+        commitId: commitResult.ok,
+    };
+}
+// ─── CLI Command ────────────────────────────────────────────────────────────
+export function mergeCommand() {
+    const command = new Command('merge');
+    command
+        .description('Merge a local thoughtform bundle with on-chain canister state')
+        .requiredOption('--input <path>', 'Path to local bundle JSON file')
+        .requiredOption('--branch <name>', 'Target branch on the canister (e.g. main)')
+        .requiredOption('--canister <id>', 'MemoryRepo canister ID')
+        .option('--host <url>', 'ICP replica host URL (overrides ICP_LOCAL_URL env)')
+        .action(async (options) => {
+        console.log(chalk.bold('\n  AgentVault Merge\n'));
+        const spinner = ora('Merging local bundle with on-chain state...').start();
+        try {
+            const summary = await executeMerge(options);
+            spinner.succeed(chalk.green('Merge complete'));
+            console.log();
+            console.log(chalk.bold('  Summary'));
+            console.log(chalk.gray('  ' + '─'.repeat(40)));
+            console.log(`  Added:     ${chalk.green(String(summary.added))}`);
+            console.log(`  Updated:   ${chalk.yellow(String(summary.updated))}`);
+            console.log(`  Unchanged: ${chalk.gray(String(summary.unchanged))}`);
+            console.log(`  Total:     ${chalk.bold(String(summary.total))}`);
+            console.log(`  Commit:    ${chalk.cyan(summary.commitId)}`);
+            console.log();
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Merge failed'));
+            console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+            process.exit(1);
+        }
+    });
+    return command;
+}
+//# sourceMappingURL=merge.js.map

package/dist/cli/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../cli/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,sCAAsC,CAAC;AAkC9C,+EAA+E;AAE/E;;GAEG;AACH,SAAS,UAAU,CAAC,QAAgB;IAClC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,wDAAwD;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,YAAY,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,oBAAoB,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,KAAgB;IAC5C,MAAM,SAAS,GAAkB,EAAE,CAAC;IAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAA4B,CAAC;QAEjD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,8CAA8C,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,mDAAmD,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,qDAAqD,CAAC,CAAC;QAC1F,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,IAA8B,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAS,yBAAyB,CAAC,IAAY;IAC7C,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAErC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;QACD,6CAA6C;QAC7C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/E,OAAO,oBAAoB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;IACxD,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAoB,EACpB,MAAqB;IAErB,qBAAqB;IACrB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuB,CAAC;IACjD,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,gEAAgE;IAChE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAsB,SAAS,CAAC,CAAC;IAE1D,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAE3C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,qBAAqB;YACrB,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YACnC,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;YAClD,0BAA0B;YAC1B,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YACnC,OAAO,EAAE,CAAC;QACZ,CAAC;aAAM,CAAC;YACN,wCAAwC;YACxC,SAAS,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QACtC,KAAK;QACL,OAAO;QACP,SAAS;KACV,CAAC;AACJ,CAAC;AAED,+EAA+E;AAE/E;;GAEG;AACH,KAAK,UAAU,sBAAsB,CAAC,IAAa;IACjD,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,uBAAuB,CAAC;IAClF,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3E,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAKlC;IACC,8BAA8B;IAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,wCAAwC;IACxC,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAE7D,yDAAyD;IACzD,oEAAoE;IACpE,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,KAAK,IAAI,YAAY,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,CAAC,MAAM,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,MAAM,kBAAkB,GAAkB,EAAE,CAAC;IAE7C,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,wDAAwD;QACxD,MAAM,MAAM,GAAG,yBAAyB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1D,kBAAkB,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,uBAAuB;IACvB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAC7D,MAAM,CAAC,YAAY,EACnB,kBAAkB,CACnB,CAAC;IAEF,wCAAwC;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,UAAU,KAAK,WAAW,OAAO,aAAa,SAAS,eAAe,MAAM,CAAC,MAAM,SAAS,CAAC;IAC7G,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAE9B,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAEpE,IAAI,KAAK,IAAI,YAAY,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,kBAAkB,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,OAAO;QACL,KAAK;QACL,OAAO;QACP,SAAS;QACT,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,QAAQ,EAAE,YAAY,CAAC,EAAE;KAC1B,CAAC;AACJ,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAErC,OAAO;SACJ,WAAW,CAAC,+DAA+D,CAAC;SAC5E,cAAc,CAAC,gBAAgB,EAAE,gCAAgC,CAAC;SAClE,cAAc,CAAC,iBAAiB,EAAE,2CAA2C,CAAC;SAC9E,cAAc,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;SAC3D,MAAM,CAAC,cAAc,EAAE,oDAAoD,CAAC;SAC5E,MAAM,CAAC,KAAK,EAAE,OAA2E,EAAE,EAAE;QAC5F,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;QAElD,MAAM,OAAO,GAAG,GAAG,CAAC,6CAA6C,CAAC,CAAC,KAAK,EAAE,CAAC;QAE3E,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YAE5C,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YAClE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC5D,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;YACxC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/archival/archive-manager.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Archive Manager
+ *
+ * Manages archiving of agent data to Arweave.
+ * Handles metadata tracking, batch uploads, and retrieval.
+ */
+export interface ArchiveMetadata {
+    id: string;
+    agentName: string;
+    agentVersion: string;
+    transactionId?: string;
+    timestamp: Date;
+    sizeBytes: number;
+    checksum: string;
+    tags: Record<string, string>;
+    status: 'pending' | 'uploading' | 'confirmed' | 'failed';
+    blockHeight?: number;
+}
+export interface ArchiveOptions {
+    includeConfig?: boolean;
+    includeLogs?: boolean;
+    includeMetrics?: boolean;
+    tags?: Record<string, string>;
+}
+export interface ArchiveResult {
+    success: boolean;
+    archiveId?: string;
+    transactionId?: string;
+    error?: string;
+}
+/**
+ * Archive agent data to local storage (for later upload)
+ */
+export declare function prepareArchive(agentName: string, agentVersion: string, data: Record<string, any>, options?: ArchiveOptions): ArchiveResult;
+/**
+ * Mark archive as uploading
+ */
+export declare function markArchiveUploading(archiveId: string): boolean;
+/**
+ * Update archive with transaction ID
+ */
+export declare function updateArchiveTransaction(archiveId: string, transactionId: string): boolean;
+/**
+ * Mark archive as confirmed
+ */
+export declare function confirmArchive(archiveId: string, blockHeight?: number): boolean;
+/**
+ * Mark archive as failed
+ */
+export declare function failArchive(archiveId: string, error?: string): boolean;
+/**
+ * Get archive metadata by ID
+ */
+export declare function getArchive(archiveId: string): ArchiveMetadata | null;
+/**
+ * List all archives for an agent
+ */
+export declare function listArchives(agentName?: string): ArchiveMetadata[];
+/**
+ * List pending archives (ready for upload)
+ */
+export declare function listPendingArchives(): ArchiveMetadata[];
+/**
+ * Get archive data by ID
+ */
+export declare function getArchiveData(archiveId: string): Record<string, any> | null;
+/**
+ * Delete archive (local storage only, does not affect Arweave)
+ */
+export declare function deleteArchive(archiveId: string): boolean;
+/**
+ * Get absolute path for a stored archive payload.
+ */
+export declare function getArchivePath(archiveId: string): string;
+/**
+ * Get archive statistics
+ */
+export declare function getArchiveStats(agentName?: string): {
+    total: number;
+    confirmed: number;
+    pending: number;
+    failed: number;
+    totalBytes: number;
+};
+/**
+ * Verify archive checksum
+ */
+export declare function verifyArchive(archiveId: string): boolean;
+//# sourceMappingURL=archive-manager.d.ts.map

package/dist/src/archival/archive-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-manager.d.ts","sourceRoot":"","sources":["../../../src/archival/archive-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+CD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,GAAE,cAAmB,GAC3B,aAAa,CA0Cf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAiB/D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAkBT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAoBT;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAoBtE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAQpE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAWlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,EAAE,CAQvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAa5E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAsBxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAUA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAkBxD"}