agentvault 1.0.1 → 1.0.5

package/dist/src/fault-tolerance/mirror-sync.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Mirror Sync — ICP inter-canister state mirroring
+ *
+ * Helpers for the TypeScript CLI side of canister mirroring.
+ * The actual inter-canister calls live in canister/agent.mo.
+ *
+ * Mirror config is stored in ~/.agentvault/mirror-config.json
+ * so it survives CLI restarts without re-deployment.
+ */
+export interface MirrorConfig {
+    primaryCanisterId: string;
+    mirrorCanisterId: string;
+    network: string;
+    registeredAt: string;
+}
+export declare function saveMirrorConfig(cfg: MirrorConfig): void;
+export declare function loadMirrorConfig(): MirrorConfig | null;
+export declare function deleteMirrorConfig(): void;
+export interface MirrorSetResult {
+    success: boolean;
+    primaryCanisterId: string;
+    mirrorCanisterId: string;
+    error?: string;
+}
+/**
+ * Register a mirror canister on the primary canister via inter-canister call.
+ * Persists the config locally for future CLI invocations.
+ */
+export declare function setMirrorCanister(primaryCanisterId: string, mirrorCanisterId: string, network?: string): Promise<MirrorSetResult>;
+export interface SyncResult {
+    success: boolean;
+    direction: 'push' | 'pull';
+    primaryCanisterId: string;
+    mirrorCanisterId: string;
+    syncedAt?: string;
+    error?: string;
+}
+/**
+ * Push state from primary → mirror (inter-canister call on primary).
+ */
+export declare function syncToMirror(primaryCanisterId: string, mirrorCanisterId: string, network?: string): Promise<SyncResult>;
+/**
+ * Pull state from mirror → primary (inter-canister call on primary).
+ * Used to recover a wiped primary from its mirror.
+ */
+export declare function syncFromMirror(primaryCanisterId: string, mirrorCanisterId: string, network?: string): Promise<SyncResult>;
+export interface MirrorStatusResult {
+    configured: boolean;
+    primaryCanisterId?: string;
+    mirrorCanisterId?: string;
+    network?: string;
+    registeredAt?: string;
+    primaryAlive?: boolean;
+    mirrorAlive?: boolean;
+    error?: string;
+}
+/**
+ * Check liveness of both primary and mirror canisters.
+ */
+export declare function getMirrorStatus(network?: string): Promise<MirrorStatusResult>;
+//# sourceMappingURL=mirror-sync.d.ts.map

package/dist/src/fault-tolerance/mirror-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror-sync.d.ts","sourceRoot":"","sources":["../../../src/fault-tolerance/mirror-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAGxD;AAED,wBAAgB,gBAAgB,IAAI,YAAY,GAAG,IAAI,CAOtD;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAWD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,iBAAiB,EAAE,MAAM,EACzB,gBAAgB,EAAE,MAAM,EACxB,OAAO,SAAO,GACb,OAAO,CAAC,eAAe,CAAC,CAuC1B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,iBAAiB,EAAE,MAAM,EACzB,gBAAgB,EAAE,MAAM,EACxB,OAAO,SAAO,GACb,OAAO,CAAC,UAAU,CAAC,CA4CrB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,iBAAiB,EAAE,MAAM,EACzB,gBAAgB,EAAE,MAAM,EACxB,OAAO,SAAO,GACb,OAAO,CAAC,UAAU,CAAC,CA4CrB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgCnF"}

package/dist/src/fault-tolerance/mirror-sync.js

@@ -0,0 +1,203 @@
+/**
+ * Mirror Sync — ICP inter-canister state mirroring
+ *
+ * Helpers for the TypeScript CLI side of canister mirroring.
+ * The actual inter-canister calls live in canister/agent.mo.
+ *
+ * Mirror config is stored in ~/.agentvault/mirror-config.json
+ * so it survives CLI restarts without re-deployment.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const AGENTVAULT_DIR = path.join(os.homedir(), '.agentvault');
+const MIRROR_CONFIG_FILE = path.join(AGENTVAULT_DIR, 'mirror-config.json');
+function ensureDir(p) {
+    const dir = path.dirname(p);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+}
+export function saveMirrorConfig(cfg) {
+    ensureDir(MIRROR_CONFIG_FILE);
+    fs.writeFileSync(MIRROR_CONFIG_FILE, JSON.stringify(cfg, null, 2), 'utf8');
+}
+export function loadMirrorConfig() {
+    try {
+        if (fs.existsSync(MIRROR_CONFIG_FILE)) {
+            return JSON.parse(fs.readFileSync(MIRROR_CONFIG_FILE, 'utf8'));
+        }
+    }
+    catch { /* ignore */ }
+    return null;
+}
+export function deleteMirrorConfig() {
+    if (fs.existsSync(MIRROR_CONFIG_FILE))
+        fs.unlinkSync(MIRROR_CONFIG_FILE);
+}
+// ── ICP client helpers ─────────────────────────────────────────────────────────
+async function getClient(network) {
+    const { createICPClient } = await import('../deployment/icpClient.js');
+    return createICPClient({ network: network });
+}
+/**
+ * Register a mirror canister on the primary canister via inter-canister call.
+ * Persists the config locally for future CLI invocations.
+ */
+export async function setMirrorCanister(primaryCanisterId, mirrorCanisterId, network = 'ic') {
+    try {
+        const client = await getClient(network);
+        const result = await client.callAgentMethod(primaryCanisterId, 'setMirrorCanister', [
+            mirrorCanisterId,
+        ]);
+        const ok = result !== null &&
+            typeof result === 'object' &&
+            'ok' in result;
+        if (!ok) {
+            const errMsg = result !== null &&
+                typeof result === 'object' &&
+                'err' in result
+                ? String(result.err)
+                : 'Unknown error from canister';
+            return { success: false, primaryCanisterId, mirrorCanisterId, error: errMsg };
+        }
+        const cfg = {
+            primaryCanisterId,
+            mirrorCanisterId,
+            network,
+            registeredAt: new Date().toISOString(),
+        };
+        saveMirrorConfig(cfg);
+        return { success: true, primaryCanisterId, mirrorCanisterId };
+    }
+    catch (err) {
+        return {
+            success: false,
+            primaryCanisterId,
+            mirrorCanisterId,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Push state from primary → mirror (inter-canister call on primary).
+ */
+export async function syncToMirror(primaryCanisterId, mirrorCanisterId, network = 'ic') {
+    try {
+        const client = await getClient(network);
+        const result = await client.callAgentMethod(primaryCanisterId, 'syncToMirror', [
+            mirrorCanisterId,
+        ]);
+        const ok = result !== null &&
+            typeof result === 'object' &&
+            'ok' in result;
+        if (!ok) {
+            const errMsg = result !== null &&
+                typeof result === 'object' &&
+                'err' in result
+                ? String(result.err)
+                : 'Unknown error from canister';
+            return {
+                success: false,
+                direction: 'push',
+                primaryCanisterId,
+                mirrorCanisterId,
+                error: errMsg,
+            };
+        }
+        return {
+            success: true,
+            direction: 'push',
+            primaryCanisterId,
+            mirrorCanisterId,
+            syncedAt: new Date().toISOString(),
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            direction: 'push',
+            primaryCanisterId,
+            mirrorCanisterId,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Pull state from mirror → primary (inter-canister call on primary).
+ * Used to recover a wiped primary from its mirror.
+ */
+export async function syncFromMirror(primaryCanisterId, mirrorCanisterId, network = 'ic') {
+    try {
+        const client = await getClient(network);
+        const result = await client.callAgentMethod(primaryCanisterId, 'syncFromMirror', [
+            mirrorCanisterId,
+        ]);
+        const ok = result !== null &&
+            typeof result === 'object' &&
+            'ok' in result;
+        if (!ok) {
+            const errMsg = result !== null &&
+                typeof result === 'object' &&
+                'err' in result
+                ? String(result.err)
+                : 'Unknown error from canister';
+            return {
+                success: false,
+                direction: 'pull',
+                primaryCanisterId,
+                mirrorCanisterId,
+                error: errMsg,
+            };
+        }
+        return {
+            success: true,
+            direction: 'pull',
+            primaryCanisterId,
+            mirrorCanisterId,
+            syncedAt: new Date().toISOString(),
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            direction: 'pull',
+            primaryCanisterId,
+            mirrorCanisterId,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Check liveness of both primary and mirror canisters.
+ */
+export async function getMirrorStatus(network) {
+    const cfg = loadMirrorConfig();
+    if (!cfg) {
+        return { configured: false };
+    }
+    const net = network ?? cfg.network;
+    const probe = async (id) => {
+        try {
+            const client = await getClient(net);
+            const status = await client.getCanisterStatus(id);
+            return status.status?.toLowerCase() === 'running';
+        }
+        catch {
+            return false;
+        }
+    };
+    const [primaryAlive, mirrorAlive] = await Promise.all([
+        probe(cfg.primaryCanisterId),
+        probe(cfg.mirrorCanisterId),
+    ]);
+    return {
+        configured: true,
+        primaryCanisterId: cfg.primaryCanisterId,
+        mirrorCanisterId: cfg.mirrorCanisterId,
+        network: net,
+        registeredAt: cfg.registeredAt,
+        primaryAlive,
+        mirrorAlive,
+    };
+}
+//# sourceMappingURL=mirror-sync.js.map

package/dist/src/fault-tolerance/mirror-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror-sync.js","sourceRoot":"","sources":["../../../src/fault-tolerance/mirror-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;AAC9D,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC;AAE3E,SAAS,SAAS,CAAC,CAAS;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAWD,MAAM,UAAU,gBAAgB,CAAC,GAAiB;IAChD,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAC9B,EAAE,CAAC,aAAa,CAAC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAiB,CAAC;QACjF,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,YAAY,CAAA,CAAC;IACtB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,IAAI,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC;QAAE,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;AAC3E,CAAC;AAED,kFAAkF;AAElF,KAAK,UAAU,SAAS,CAAC,OAAe;IACtC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;IACvE,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,OAAyB,EAAE,CAAC,CAAC;AACjE,CAAC;AAWD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,iBAAyB,EACzB,gBAAwB,EACxB,OAAO,GAAG,IAAI;IAEd,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,iBAAiB,EAAE,mBAAmB,EAAE;YAClF,gBAAgB;SACjB,CAAC,CAAC;QAEH,MAAM,EAAE,GACN,MAAM,KAAK,IAAI;YACf,OAAO,MAAM,KAAK,QAAQ;YAC1B,IAAI,IAAK,MAAiB,CAAC;QAE7B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,MAAM,GACV,MAAM,KAAK,IAAI;gBACf,OAAO,MAAM,KAAK,QAAQ;gBAC1B,KAAK,IAAK,MAAiB;gBACzB,CAAC,CAAC,MAAM,CAAE,MAA2B,CAAC,GAAG,CAAC;gBAC1C,CAAC,CAAC,6BAA6B,CAAC;YACpC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAChF,CAAC;QAED,MAAM,GAAG,GAAiB;YACxB,iBAAiB;YACjB,gBAAgB;YAChB,OAAO;YACP,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACvC,CAAC;QACF,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAEtB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,iBAAiB;YACjB,gBAAgB;YAChB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAWD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,iBAAyB,EACzB,gBAAwB,EACxB,OAAO,GAAG,IAAI;IAEd,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,iBAAiB,EAAE,cAAc,EAAE;YAC7E,gBAAgB;SACjB,CAAC,CAAC;QAEH,MAAM,EAAE,GACN,MAAM,KAAK,IAAI;YACf,OAAO,MAAM,KAAK,QAAQ;YAC1B,IAAI,IAAK,MAAiB,CAAC;QAE7B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,MAAM,GACV,MAAM,KAAK,IAAI;gBACf,OAAO,MAAM,KAAK,QAAQ;gBAC1B,KAAK,IAAK,MAAiB;gBACzB,CAAC,CAAC,MAAM,CAAE,MAA2B,CAAC,GAAG,CAAC;gBAC1C,CAAC,CAAC,6BAA6B,CAAC;YACpC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,MAAM;gBACjB,iBAAiB;gBACjB,gBAAgB;gBAChB,KAAK,EAAE,MAAM;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,MAAM;YACjB,iBAAiB;YACjB,gBAAgB;YAChB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACnC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,MAAM;YACjB,iBAAiB;YACjB,gBAAgB;YAChB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,iBAAyB,EACzB,gBAAwB,EACxB,OAAO,GAAG,IAAI;IAEd,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,iBAAiB,EAAE,gBAAgB,EAAE;YAC/E,gBAAgB;SACjB,CAAC,CAAC;QAEH,MAAM,EAAE,GACN,MAAM,KAAK,IAAI;YACf,OAAO,MAAM,KAAK,QAAQ;YAC1B,IAAI,IAAK,MAAiB,CAAC;QAE7B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,MAAM,GACV,MAAM,KAAK,IAAI;gBACf,OAAO,MAAM,KAAK,QAAQ;gBAC1B,KAAK,IAAK,MAAiB;gBACzB,CAAC,CAAC,MAAM,CAAE,MAA2B,CAAC,GAAG,CAAC;gBAC1C,CAAC,CAAC,6BAA6B,CAAC;YACpC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,MAAM;gBACjB,iBAAiB;gBACjB,gBAAgB;gBAChB,KAAK,EAAE,MAAM;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,MAAM;YACjB,iBAAiB;YACjB,gBAAgB;YAChB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACnC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,MAAM;YACjB,iBAAiB;YACjB,gBAAgB;YAChB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAaD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAgB;IACpD,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC;IAEnC,MAAM,KAAK,GAAG,KAAK,EAAE,EAAU,EAAoB,EAAE;QACnD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;YAClD,OAAO,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,SAAS,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpD,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC5B,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC;KAC5B,CAAC,CAAC;IAEH,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;QACxC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;QACtC,OAAO,EAAE,GAAG;QACZ,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,YAAY;QACZ,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/src/icp/batch.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Batched canister operations
+ *
+ * Executes multiple canister operations in parallel with dependency ordering,
+ * retries, and configurable concurrency.
+ */
+import type { IcpCommonOptions } from '../icp/types.js';
+export type BatchOperationType = 'call' | 'query' | 'status' | 'deploy';
+export interface BatchOperation {
+    /** Operation ID (auto-generated) */
+    id: string;
+    /** Operation type */
+    type: BatchOperationType;
+    /** Target canister ID */
+    canisterId: string;
+    /** Method name (for call/query) */
+    method?: string;
+    /** Arguments (Candid format) */
+    args?: string;
+    /** Options for the operation */
+    options?: IcpCommonOptions;
+    /** Dependencies (operation IDs that must complete first) */
+    dependsOn?: string[];
+}
+export interface BatchResult {
+    /** Operation ID */
+    operationId: string;
+    /** Whether this operation succeeded */
+    success: boolean;
+    /** Result data (if success) */
+    data?: unknown;
+    /** Error message (if failure) */
+    error?: string;
+    /** Execution duration in milliseconds */
+    durationMs: number;
+}
+export interface BatchExecutionResult {
+    /** Total operations */
+    total: number;
+    /** Successful operations */
+    succeeded: number;
+    /** Failed operations */
+    failed: number;
+    /** Individual results */
+    results: BatchResult[];
+    /** Total execution time */
+    totalDurationMs: number;
+}
+export interface BatchConfig {
+    /** Maximum concurrent operations */
+    maxConcurrency: number;
+    /** Timeout per operation in milliseconds */
+    operationTimeoutMs: number;
+    /** Whether to stop on first failure */
+    stopOnFailure: boolean;
+    /** Retry failed operations */
+    retryCount: number;
+    /** Retry delay in milliseconds */
+    retryDelayMs: number;
+}
+/**
+ * BatchExecutor class for managing and executing batched canister operations
+ */
+export declare class BatchExecutor {
+    private operations;
+    private config;
+    constructor(config?: Partial<BatchConfig>);
+    /**
+     * Add a single operation to the batch
+     */
+    addOperation(operation: BatchOperation): void;
+    /**
+     * Add multiple operations to the batch
+     */
+    addOperations(ops: BatchOperation[]): void;
+    /**
+     * Execute all operations in the batch
+     */
+    execute(): Promise<BatchExecutionResult>;
+    /**
+     * Execute an operation with retry logic
+     */
+    private executeWithRetry;
+    /**
+     * Get a dry-run plan of execution order
+     */
+    executeDryRun(): {
+        order: string[];
+        parallelGroups: string[][];
+    };
+    /**
+     * Clear all operations
+     */
+    clear(): void;
+}
+/**
+ * Create a new batch executor with custom config
+ */
+export declare function createBatchExecutor(config?: Partial<BatchConfig>): BatchExecutor;
+/**
+ * Helper to create a status-check operation
+ */
+export declare function createStatusOperation(canisterId: string, options?: IcpCommonOptions): BatchOperation;
+/**
+ * Helper to create a query operation
+ */
+export declare function createQueryOperation(canisterId: string, method: string, args?: string, options?: IcpCommonOptions): BatchOperation;
+/**
+ * Helper to create a call operation
+ */
+export declare function createCallOperation(canisterId: string, method: string, args?: string, options?: IcpCommonOptions): BatchOperation;
+//# sourceMappingURL=batch.d.ts.map

package/dist/src/icp/batch.d.ts.map

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

package/dist/src/icp/batch.js

@@ -0,0 +1,279 @@
+/**
+ * Batched canister operations
+ *
+ * Executes multiple canister operations in parallel with dependency ordering,
+ * retries, and configurable concurrency.
+ */
+import { canisterStatus, canisterCall, deploy } from '../icp/icpcli.js';
+const DEFAULT_BATCH_CONFIG = {
+    maxConcurrency: 10,
+    operationTimeoutMs: 30000,
+    stopOnFailure: false,
+    retryCount: 2,
+    retryDelayMs: 1000,
+};
+let operationCounter = 0;
+function generateOperationId() {
+    return `op_${++operationCounter}_${Date.now()}`;
+}
+/**
+ * Topologically sort operations by dependency graph
+ */
+function sortOperationsByDeps(operations) {
+    const opMap = new Map(operations.map((op) => [op.id, op]));
+    const visited = new Set();
+    const visiting = new Set();
+    const sorted = [];
+    function visit(opId) {
+        if (visited.has(opId))
+            return;
+        if (visiting.has(opId)) {
+            throw new Error(`Circular dependency detected involving operation: ${opId}`);
+        }
+        visiting.add(opId);
+        const op = opMap.get(opId);
+        if (op !== undefined) {
+            if (op.dependsOn) {
+                for (const depId of op.dependsOn) {
+                    visit(depId);
+                }
+            }
+            visiting.delete(opId);
+            visited.add(opId);
+            sorted.push(op);
+        }
+    }
+    for (const op of operations) {
+        visit(op.id);
+    }
+    return sorted;
+}
+/**
+ * Execute a single batch operation
+ */
+async function executeOperation(operation, config) {
+    const startTime = Date.now();
+    let result;
+    const timeoutPromise = new Promise((_, reject) => {
+        setTimeout(() => reject(new Error(`Operation timeout after ${config.operationTimeoutMs}ms`)), config.operationTimeoutMs);
+    });
+    try {
+        const executionPromise = (async () => {
+            switch (operation.type) {
+                case 'status': {
+                    const statusResult = await canisterStatus({
+                        canister: operation.canisterId,
+                        ...operation.options,
+                    });
+                    return {
+                        operationId: operation.id,
+                        success: statusResult.success,
+                        data: statusResult.stdout,
+                        error: statusResult.success ? undefined : statusResult.stderr,
+                        durationMs: 0,
+                    };
+                }
+                case 'call':
+                case 'query': {
+                    if (!operation.method) {
+                        throw new Error('Method name is required for call/query operations');
+                    }
+                    const callResult = await canisterCall({
+                        canister: operation.canisterId,
+                        method: operation.method,
+                        args: operation.args,
+                        ...operation.options,
+                    });
+                    return {
+                        operationId: operation.id,
+                        success: callResult.success,
+                        data: callResult.stdout,
+                        error: callResult.success ? undefined : callResult.stderr,
+                        durationMs: 0,
+                    };
+                }
+                case 'deploy': {
+                    const deployResult = await deploy({
+                        canisters: [operation.canisterId],
+                        ...operation.options,
+                    });
+                    return {
+                        operationId: operation.id,
+                        success: deployResult.success,
+                        data: deployResult.stdout,
+                        error: deployResult.success ? undefined : deployResult.stderr,
+                        durationMs: 0,
+                    };
+                }
+                default:
+                    return {
+                        operationId: operation.id,
+                        success: false,
+                        error: `Unknown operation type: ${operation.type}`,
+                        durationMs: 0,
+                    };
+            }
+        })();
+        result = await Promise.race([executionPromise, timeoutPromise]);
+    }
+    catch (error) {
+        result = {
+            operationId: operation.id,
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+            durationMs: 0,
+        };
+    }
+    result.durationMs = Date.now() - startTime;
+    return result;
+}
+/**
+ * BatchExecutor class for managing and executing batched canister operations
+ */
+export class BatchExecutor {
+    operations = new Map();
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_BATCH_CONFIG, ...config };
+    }
+    /**
+     * Add a single operation to the batch
+     */
+    addOperation(operation) {
+        this.operations.set(generateOperationId(), operation);
+    }
+    /**
+     * Add multiple operations to the batch
+     */
+    addOperations(ops) {
+        for (const op of ops) {
+            this.operations.set(generateOperationId(), op);
+        }
+    }
+    /**
+     * Execute all operations in the batch
+     */
+    async execute() {
+        const startTime = Date.now();
+        const allOperations = Array.from(this.operations.values());
+        const sortedOps = sortOperationsByDeps(allOperations);
+        let succeeded = 0;
+        let failed = 0;
+        const executionResults = [];
+        for (let i = 0; i < sortedOps.length; i += this.config.maxConcurrency) {
+            const batch = sortedOps.slice(i, i + this.config.maxConcurrency);
+            const batchResults = await Promise.all(batch.map((op) => this.executeWithRetry(op)));
+            for (const result of batchResults) {
+                executionResults.push(result);
+                if (result.success) {
+                    succeeded++;
+                }
+                else {
+                    failed++;
+                    if (this.config.stopOnFailure) {
+                        break;
+                    }
+                }
+            }
+        }
+        return {
+            total: allOperations.length,
+            succeeded,
+            failed,
+            results: executionResults,
+            totalDurationMs: Date.now() - startTime,
+        };
+    }
+    /**
+     * Execute an operation with retry logic
+     */
+    async executeWithRetry(operation) {
+        let lastError;
+        let delay = this.config.retryDelayMs;
+        for (let attempt = 0; attempt <= this.config.retryCount; attempt++) {
+            try {
+                const result = await executeOperation(operation, this.config);
+                if (result.success || attempt === this.config.retryCount) {
+                    return result;
+                }
+                lastError = result.error;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error.message : 'Unknown error';
+            }
+            if (attempt < this.config.retryCount) {
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                delay *= 2;
+            }
+        }
+        return {
+            operationId: operation.id,
+            success: false,
+            error: lastError || 'Max retries exceeded',
+            durationMs: 0,
+        };
+    }
+    /**
+     * Get a dry-run plan of execution order
+     */
+    executeDryRun() {
+        const allOperations = Array.from(this.operations.values());
+        const sortedOps = sortOperationsByDeps(allOperations);
+        const order = sortedOps.map((op) => op.id);
+        const parallelGroups = [];
+        for (let i = 0; i < sortedOps.length; i += this.config.maxConcurrency) {
+            parallelGroups.push(sortedOps.slice(i, i + this.config.maxConcurrency).map((op) => op.id));
+        }
+        return { order, parallelGroups };
+    }
+    /**
+     * Clear all operations
+     */
+    clear() {
+        this.operations.clear();
+    }
+}
+/**
+ * Create a new batch executor with custom config
+ */
+export function createBatchExecutor(config) {
+    return new BatchExecutor(config);
+}
+/**
+ * Helper to create a status-check operation
+ */
+export function createStatusOperation(canisterId, options) {
+    return {
+        id: generateOperationId(),
+        type: 'status',
+        canisterId,
+        options,
+    };
+}
+/**
+ * Helper to create a query operation
+ */
+export function createQueryOperation(canisterId, method, args, options) {
+    return {
+        id: generateOperationId(),
+        type: 'query',
+        canisterId,
+        method,
+        args,
+        options,
+    };
+}
+/**
+ * Helper to create a call operation
+ */
+export function createCallOperation(canisterId, method, args, options) {
+    return {
+        id: generateOperationId(),
+        type: 'call',
+        canisterId,
+        method,
+        args,
+        options,
+    };
+}
+//# sourceMappingURL=batch.js.map