agentvault 1.0.2 → 1.0.5

package/dist/cli/index.js

@@ -4,6 +4,8 @@
  *
  * 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,6 +41,35 @@ 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
@@ -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":"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"}

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

@@ -68,6 +68,10 @@ export declare function getArchiveData(archiveId: string): Record<string, any> |
  * 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
  */

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"}

package/dist/src/archival/archive-manager.js

@@ -257,6 +257,12 @@ export function deleteArchive(archiveId) {
         return false;
     }
 }
+/**
+ * Get absolute path for a stored archive payload.
+ */
+export function getArchivePath(archiveId) {
+    return path.join(ARCHIVES_DIR, `${archiveId}.json`);
+}
 /**
  * Get archive statistics
  */

package/dist/src/archival/archive-manager.js.map

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

package/dist/src/archival/arweave-archiver.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Arweave Archiver
+ *
+ * Provides permanent, cryptographically-signed archival of agent state to Arweave.
+ *
+ * Features:
+ *  - Bundle creation: agent state + manifest, signed with the deployed ed25519 wallet
+ *  - Heartbeat-triggered archival: automatically uploads on state change
+ *  - Retrieval & verification: fetch bundle by ID, verify signature against wallet
+ *
+ * Bundle format: agentvault-arweave-bundle-v1
+ *   { format, manifest, signature, state }
+ *   where signature = ed25519.sign(canonicalManifestBytes(manifest), privateKey)
+ *   and   manifest.stateHash = SHA-256(state JSON)
+ *   and   manifest.merkleRoot = Merkle root of [{ path:'state.json', content:stateBytes }]
+ */
+import { ArweaveClient, type ArweaveConfig, type JWKInterface } from './arweave-client.js';
+export interface ArweaveBundleManifest {
+    /** Schema version */
+    version: string;
+    /** Name of the agent whose state is archived */
+    agentName: string;
+    /** ISO-8601 creation timestamp */
+    timestamp: string;
+    /** SHA-256 hex of the serialised agent state */
+    stateHash: string;
+    /** SHA-256 Merkle root of the bundle entries (currently just state.json) */
+    merkleRoot: string;
+    /** ed25519 public key (64-char hex = 32 bytes) used to create the signature */
+    publicKey: string;
+}
+export interface ArweaveBundle {
+    format: 'agentvault-arweave-bundle-v1';
+    manifest: ArweaveBundleManifest;
+    /**
+     * ed25519 signature (128-char hex = 64 bytes) over
+     * canonicalManifestBytes(manifest).
+     */
+    signature: string;
+    /** JSON-serialised agent state */
+    state: string;
+}
+export interface ArchiverOptions {
+    /** Agent identifier embedded in every bundle manifest. */
+    agentName: string;
+    /**
+     * Path to the 32-byte ed25519 private key (stored as 64 hex chars).
+     * Defaults to ~/.agentvault/arweave-signing.key.
+     * Created automatically if the file does not exist.
+     */
+    signingKeyPath?: string;
+    /** Arweave gateway configuration passed through to ArweaveClient. */
+    arweaveConfig?: ArweaveConfig;
+    /**
+     * @internal For testing only.
+     * Override the ArweaveClient instance instead of creating a new one.
+     */
+    client?: ArweaveClient;
+}
+export interface ArchiveResult {
+    success: boolean;
+    /** Arweave transaction ID (= bundle retrieval ID) */
+    bundleId?: string;
+    /** Alias for bundleId – kept for symmetry with archive-manager types */
+    transactionId?: string;
+    /** SHA-256 hex of the archived state */
+    stateHash?: string;
+    /** ed25519 public key hex of the signing wallet */
+    publicKey?: string;
+    error?: string;
+}
+export interface HeartbeatOptions {
+    /** How often (ms) the heartbeat fires.  Default: 60 000 (1 minute). */
+    intervalMs?: number;
+    /** Arweave JWK wallet used to pay for and sign the transaction. */
+    jwk: JWKInterface;
+    /** Extra Arweave tags added to every uploaded transaction. */
+    tags?: Record<string, string>;
+    /** Called after each successful archival. */
+    onArchived?: (result: ArchiveResult) => void;
+    /** Called when an archival attempt fails. */
+    onError?: (error: Error) => void;
+}
+export interface VerifyResult {
+    /** True when all three checks pass. */
+    valid: boolean;
+    /** state hash re-computed from bundle.state matches manifest.stateHash */
+    stateHashMatch: boolean;
+    /** ed25519 signature verifies against manifest.publicKey */
+    signatureValid: boolean;
+    /**
+     * Matches expectedPublicKey when provided.
+     * Always true when no expectedPublicKey is passed.
+     */
+    publicKeyMatch: boolean;
+    error?: string;
+}
+export declare class ArweaveArchiver {
+    private readonly agentName;
+    private readonly signingKeyPath;
+    private readonly arweaveClient;
+    private currentState;
+    private lastArchivedStateHash;
+    private heartbeatTimer;
+    constructor(options: ArchiverOptions);
+    /**
+     * Update the current agent state.
+     * The archiver will consider itself dirty until this state is archived.
+     */
+    setState(state: Record<string, unknown>): void;
+    /**
+     * True when the current state has changed since the last successful archive.
+     */
+    get isDirty(): boolean;
+    /**
+     * Create a signed Arweave bundle from the supplied agent state.
+     *
+     * Steps:
+     *  1. Serialise state → stateHash (SHA-256)
+     *  2. Build Merkle root of [state.json]
+     *  3. Build manifest { version, agentName, timestamp, stateHash, merkleRoot, publicKey }
+     *  4. Sign canonical manifest bytes with ed25519
+     *  5. Return ArweaveBundle
+     */
+    createBundle(state: Record<string, unknown>): Promise<ArweaveBundle>;
+    /**
+     * Upload a pre-built bundle to Arweave using the supplied JWK wallet.
+     * Returns the Arweave transaction ID as the bundle retrieval ID.
+     */
+    uploadBundle(bundle: ArweaveBundle, jwk: JWKInterface): Promise<ArchiveResult>;
+    /**
+     * Convenience method: create a bundle for `state` and upload it.
+     * After a successful upload the archiver clears its dirty flag.
+     */
+    archive(state: Record<string, unknown>, jwk: JWKInterface): Promise<ArchiveResult>;
+    /**
+     * Fetch a bundle from Arweave by its transaction ID.
+     * Returns null if the transaction does not exist or is not a valid bundle.
+     */
+    fetchBundle(bundleId: string): Promise<ArweaveBundle | null>;
+    /**
+     * Verify a bundle's cryptographic integrity.
+     *
+     * Checks performed:
+     *  1. Recompute SHA-256 of `bundle.state` → must equal `manifest.stateHash`
+     *  2. Verify ed25519 signature over canonical manifest bytes using
+     *     `manifest.publicKey`
+     *  3. If `expectedPublicKey` is supplied, confirm it matches `manifest.publicKey`
+     *
+     * @param bundle - The bundle to verify (retrieved from Arweave or local store).
+     * @param expectedPublicKey - Known wallet public key (64-char hex) to validate
+     *   the bundle was signed by the correct wallet.
+     */
+    verifyBundle(bundle: ArweaveBundle, expectedPublicKey?: string): Promise<VerifyResult>;
+    /**
+     * Start the periodic heartbeat that auto-archives state changes.
+     *
+     * On every tick the heartbeat checks `isDirty`. If dirty it calls
+     * `archive(currentState, jwk)` and notifies the caller via `onArchived`.
+     * Errors are surfaced via `onError` rather than thrown.
+     *
+     * @throws {Error} if the heartbeat is already running.
+     */
+    startHeartbeat(options: HeartbeatOptions): void;
+    /** Stop the heartbeat timer. Safe to call even if the heartbeat is not running. */
+    stopHeartbeat(): void;
+    /**
+     * Return the ed25519 public key (hex) of the deployed signing wallet.
+     * Returns null if the key file does not exist yet.
+     */
+    getPublicKey(): Promise<string | null>;
+}
+//# sourceMappingURL=arweave-archiver.d.ts.map