agentvault 1.0.1 → 1.0.5

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

@@ -0,0 +1,300 @@
+/**
+ * Archive Manager
+ *
+ * Manages archiving of agent data to Arweave.
+ * Handles metadata tracking, batch uploads, and retrieval.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import crypto from 'node:crypto';
+import { parse, stringify } from 'yaml';
+const AGENTVAULT_DIR = path.join(os.homedir(), '.agentvault');
+const ARCHIVES_DIR = path.join(AGENTVAULT_DIR, 'archives');
+const ARCHIVE_INDEX_PATH = path.join(ARCHIVES_DIR, 'index.yaml');
+function ensureArchivesDir() {
+    if (!fs.existsSync(AGENTVAULT_DIR)) {
+        fs.mkdirSync(AGENTVAULT_DIR, { recursive: true });
+    }
+    if (!fs.existsSync(ARCHIVES_DIR)) {
+        fs.mkdirSync(ARCHIVES_DIR, { recursive: true });
+    }
+}
+function getIndex() {
+    if (!fs.existsSync(ARCHIVE_INDEX_PATH)) {
+        return [];
+    }
+    try {
+        const content = fs.readFileSync(ARCHIVE_INDEX_PATH, 'utf8');
+        const parsed = parse(content);
+        if (Array.isArray(parsed)) {
+            return parsed.map((item) => ({
+                ...item,
+                timestamp: new Date(item.timestamp),
+            }));
+        }
+        return [];
+    }
+    catch (error) {
+        console.error('Failed to load archive index:', error);
+        return [];
+    }
+}
+function saveIndex(index) {
+    ensureArchivesDir();
+    fs.writeFileSync(ARCHIVE_INDEX_PATH, stringify(index), 'utf8');
+}
+function generateChecksum(data) {
+    return crypto.createHash('sha256').update(data).digest('hex');
+}
+function generateArchiveId() {
+    return `archive-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`;
+}
+/**
+ * Archive agent data to local storage (for later upload)
+ */
+export function prepareArchive(agentName, agentVersion, data, options = {}) {
+    try {
+        ensureArchivesDir();
+        const archiveId = generateArchiveId();
+        const timestamp = new Date();
+        const dataStr = JSON.stringify(data);
+        const checksum = generateChecksum(dataStr);
+        const metadata = {
+            id: archiveId,
+            agentName,
+            agentVersion,
+            timestamp,
+            sizeBytes: Buffer.byteLength(dataStr),
+            checksum,
+            tags: {
+                'agent-name': agentName,
+                'agent-version': agentVersion,
+                'content-type': 'application/json',
+                ...options.tags,
+            },
+            status: 'pending',
+        };
+        const archivePath = path.join(ARCHIVES_DIR, `${archiveId}.json`);
+        fs.writeFileSync(archivePath, dataStr, 'utf8');
+        const index = getIndex();
+        index.push(metadata);
+        saveIndex(index);
+        return {
+            success: true,
+            archiveId,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+/**
+ * Mark archive as uploading
+ */
+export function markArchiveUploading(archiveId) {
+    try {
+        const index = getIndex();
+        const archive = index.find((a) => a.id === archiveId);
+        if (!archive) {
+            return false;
+        }
+        archive.status = 'uploading';
+        saveIndex(index);
+        return true;
+    }
+    catch (error) {
+        console.error('Failed to mark archive as uploading:', error);
+        return false;
+    }
+}
+/**
+ * Update archive with transaction ID
+ */
+export function updateArchiveTransaction(archiveId, transactionId) {
+    try {
+        const index = getIndex();
+        const archive = index.find((a) => a.id === archiveId);
+        if (!archive) {
+            return false;
+        }
+        archive.transactionId = transactionId;
+        archive.status = 'pending';
+        saveIndex(index);
+        return true;
+    }
+    catch (error) {
+        console.error('Failed to update archive transaction:', error);
+        return false;
+    }
+}
+/**
+ * Mark archive as confirmed
+ */
+export function confirmArchive(archiveId, blockHeight) {
+    try {
+        const index = getIndex();
+        const archive = index.find((a) => a.id === archiveId);
+        if (!archive) {
+            return false;
+        }
+        archive.status = 'confirmed';
+        if (blockHeight) {
+            archive.blockHeight = blockHeight;
+        }
+        saveIndex(index);
+        return true;
+    }
+    catch (error) {
+        console.error('Failed to confirm archive:', error);
+        return false;
+    }
+}
+/**
+ * Mark archive as failed
+ */
+export function failArchive(archiveId, error) {
+    try {
+        const index = getIndex();
+        const archive = index.find((a) => a.id === archiveId);
+        if (!archive) {
+            return false;
+        }
+        archive.status = 'failed';
+        if (error) {
+            archive.tags['error'] = error;
+        }
+        saveIndex(index);
+        return true;
+    }
+    catch (err) {
+        console.error('Failed to mark archive as failed:', err);
+        return false;
+    }
+}
+/**
+ * Get archive metadata by ID
+ */
+export function getArchive(archiveId) {
+    try {
+        const index = getIndex();
+        return index.find((a) => a.id === archiveId) || null;
+    }
+    catch (error) {
+        console.error('Failed to get archive:', error);
+        return null;
+    }
+}
+/**
+ * List all archives for an agent
+ */
+export function listArchives(agentName) {
+    try {
+        const index = getIndex();
+        if (agentName) {
+            return index.filter((a) => a.agentName === agentName);
+        }
+        return index;
+    }
+    catch (error) {
+        console.error('Failed to list archives:', error);
+        return [];
+    }
+}
+/**
+ * List pending archives (ready for upload)
+ */
+export function listPendingArchives() {
+    try {
+        const index = getIndex();
+        return index.filter((a) => a.status === 'pending');
+    }
+    catch (error) {
+        console.error('Failed to list pending archives:', error);
+        return [];
+    }
+}
+/**
+ * Get archive data by ID
+ */
+export function getArchiveData(archiveId) {
+    try {
+        const archivePath = path.join(ARCHIVES_DIR, `${archiveId}.json`);
+        if (!fs.existsSync(archivePath)) {
+            return null;
+        }
+        const content = fs.readFileSync(archivePath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        console.error('Failed to get archive data:', error);
+        return null;
+    }
+}
+/**
+ * Delete archive (local storage only, does not affect Arweave)
+ */
+export function deleteArchive(archiveId) {
+    try {
+        const index = getIndex();
+        const archiveIndex = index.findIndex((a) => a.id === archiveId);
+        if (archiveIndex === -1) {
+            return false;
+        }
+        const archivePath = path.join(ARCHIVES_DIR, `${archiveId}.json`);
+        if (fs.existsSync(archivePath)) {
+            fs.unlinkSync(archivePath);
+        }
+        index.splice(archiveIndex, 1);
+        saveIndex(index);
+        return true;
+    }
+    catch (error) {
+        console.error('Failed to delete archive:', error);
+        return false;
+    }
+}
+/**
+ * Get absolute path for a stored archive payload.
+ */
+export function getArchivePath(archiveId) {
+    return path.join(ARCHIVES_DIR, `${archiveId}.json`);
+}
+/**
+ * Get archive statistics
+ */
+export function getArchiveStats(agentName) {
+    const archives = listArchives(agentName);
+    return {
+        total: archives.length,
+        confirmed: archives.filter((a) => a.status === 'confirmed').length,
+        pending: archives.filter((a) => a.status === 'pending').length,
+        failed: archives.filter((a) => a.status === 'failed').length,
+        totalBytes: archives.reduce((sum, a) => sum + a.sizeBytes, 0),
+    };
+}
+/**
+ * Verify archive checksum
+ */
+export function verifyArchive(archiveId) {
+    try {
+        const metadata = getArchive(archiveId);
+        if (!metadata) {
+            return false;
+        }
+        const data = getArchiveData(archiveId);
+        if (!data) {
+            return false;
+        }
+        const actualChecksum = generateChecksum(JSON.stringify(data));
+        return actualChecksum === metadata.checksum;
+    }
+    catch (error) {
+        console.error('Failed to verify archive:', error);
+        return false;
+    }
+}
+//# sourceMappingURL=archive-manager.js.map

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

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

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