agentvault 1.0.1 → 1.0.5

package/dist/src/deployment/promotion.js

@@ -0,0 +1,114 @@
+/**
+ * Environment promotion for canister deployment
+ *
+ * Handles promoting canisters between environments (dev -> staging -> production)
+ * CLE-102: Wired to actual deploy path
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { parse, stringify } from 'yaml';
+const AGENTVAULT_DIR = path.join(os.homedir(), '.agentvault');
+const HISTORY_DIR = path.join(AGENTVAULT_DIR, 'history');
+function ensureHistoryDir() {
+    if (!fs.existsSync(AGENTVAULT_DIR)) {
+        fs.mkdirSync(AGENTVAULT_DIR, { recursive: true });
+    }
+    if (!fs.existsSync(HISTORY_DIR)) {
+        fs.mkdirSync(HISTORY_DIR, { recursive: true });
+    }
+}
+function getHistoryPath(agentName) {
+    ensureHistoryDir();
+    return path.join(HISTORY_DIR, `${agentName}.yaml`);
+}
+export function loadDeploymentHistory(agentName) {
+    const historyPath = getHistoryPath(agentName);
+    if (!fs.existsSync(historyPath)) {
+        return [];
+    }
+    const content = fs.readFileSync(historyPath, 'utf8');
+    const parsed = parse(content);
+    if (Array.isArray(parsed)) {
+        return parsed;
+    }
+    return [];
+}
+export function saveDeploymentHistory(agentName, history) {
+    const historyPath = getHistoryPath(agentName);
+    fs.writeFileSync(historyPath, stringify(history), 'utf8');
+}
+export function addDeploymentToHistory(deployment) {
+    const history = loadDeploymentHistory(deployment.agentName);
+    history.push(deployment);
+    saveDeploymentHistory(deployment.agentName, history);
+}
+export function getLatestDeployment(agentName, environment) {
+    const history = loadDeploymentHistory(agentName);
+    const envHistory = history.filter((d) => d.environment === environment && d.success);
+    if (envHistory.length === 0) {
+        return null;
+    }
+    return envHistory.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime())[0] ?? null;
+}
+export function getAllDeployments(agentName) {
+    return loadDeploymentHistory(agentName);
+}
+/**
+ * Promote a canister from one environment to another
+ * Now calls actual deploy when skipDeploy is false
+ */
+export async function promoteCanister(agentName, fromEnv, toEnv, options = {}) {
+    const sourceDeployment = getLatestDeployment(agentName, fromEnv);
+    if (!sourceDeployment) {
+        throw new Error(`No successful deployment found for ${agentName} in ${fromEnv} environment`);
+    }
+    const targetCanisterId = options.targetCanisterId || sourceDeployment.canisterId;
+    if (!options.skipDeploy && options.wasmPath) {
+        const { deployAgent } = await import('./deployer.js');
+        const deployResult = await deployAgent({
+            wasmPath: options.wasmPath,
+            network: toEnv,
+            canisterId: targetCanisterId,
+            mode: 'upgrade',
+        });
+        const targetDeployment = {
+            agentName,
+            environment: toEnv,
+            canisterId: deployResult.canister.canisterId,
+            wasmHash: deployResult.canister.wasmHash || sourceDeployment.wasmHash,
+            timestamp: new Date(),
+            version: sourceDeployment.version + 1,
+            success: true,
+        };
+        addDeploymentToHistory(targetDeployment);
+        return targetDeployment;
+    }
+    const targetDeployment = {
+        agentName,
+        environment: toEnv,
+        canisterId: targetCanisterId,
+        wasmHash: sourceDeployment.wasmHash,
+        timestamp: new Date(),
+        version: sourceDeployment.version + 1,
+        success: true,
+    };
+    addDeploymentToHistory(targetDeployment);
+    return targetDeployment;
+}
+/**
+ * Get deployment history for rollback
+ */
+export function getDeploymentForRollback(agentName, environment, version) {
+    const history = loadDeploymentHistory(agentName);
+    const found = history.find((d) => d.environment === environment && d.version === version);
+    return found !== undefined ? found : null;
+}
+/**
+ * Get deployments by time range for rollback
+ */
+export function getDeploymentsByTimeRange(agentName, environment, fromTime, toTime) {
+    const history = loadDeploymentHistory(agentName);
+    return history.filter((d) => d.environment === environment && d.timestamp >= fromTime && d.timestamp <= toTime && d.success).sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+}
+//# sourceMappingURL=promotion.js.map

package/dist/src/deployment/promotion.js.map

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

package/dist/src/deployment/types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Types for ICP canister deployment
+ */
+/**
+ * Network target for deployment
+ *
+ * - 'local': Local dfx/icp replica
+ * - 'ic': IC mainnet
+ * - 'private': Company-owned private ICP replica (PRD-004)
+ * - string: Named environment from icp.yaml (e.g. 'dev', 'staging', 'production')
+ */
+export type NetworkType = 'local' | 'ic' | 'private' | string;
+/**
+ * Which tool is being used for deployment
+ */
+export type DeployToolType = 'icp' | 'dfx' | 'sdk';
+/**
+ * Deployment status codes
+ */
+export type DeploymentStatus = 'pending' | 'deploying' | 'deployed' | 'failed' | 'running' | 'stopping' | 'stopped';
+/**
+ * Information about a deployed canister
+ */
+export interface CanisterInfo {
+    /** Canister ID on the network */
+    canisterId: string;
+    /** Network where the canister is deployed */
+    network: NetworkType;
+    /** Agent name associated with this canister */
+    agentName: string;
+    /** Deployment timestamp */
+    deployedAt: Date;
+    /** WASM module hash (for verification) */
+    wasmHash?: string;
+}
+/**
+ * Options for deployment operation
+ */
+export interface DeployOptions {
+    /** Path to the WASM file to deploy */
+    wasmPath: string;
+    /** Target network for deployment */
+    network: NetworkType;
+    /** Existing canister ID (for upgrades) */
+    canisterId?: string;
+    /** Skip confirmation prompts */
+    skipConfirmation?: boolean;
+    /** Path to dfx identity to use */
+    identityPath?: string;
+    /** Named environment from icp.yaml */
+    environment?: string;
+    /** Identity name for icp-cli */
+    identity?: string;
+    /** Cycles allocation for deployment */
+    cycles?: string;
+    /** Deploy mode (auto, install, reinstall, upgrade) */
+    mode?: 'auto' | 'install' | 'reinstall' | 'upgrade';
+    /** Override project root for icp.yaml lookup */
+    projectRoot?: string;
+}
+/**
+ * Result of a successful deployment
+ */
+export interface DeployResult {
+    /** Deployed canister information */
+    canister: CanisterInfo;
+    /** Whether this was a new deployment or upgrade */
+    isUpgrade: boolean;
+    /** Cycles consumed by deployment */
+    cyclesUsed?: bigint;
+    /** Any warnings during deployment */
+    warnings: string[];
+    /** Which tool was used for deployment */
+    deployTool?: DeployToolType;
+}
+/**
+ * Error that occurred during deployment
+ */
+export interface DeploymentError {
+    /** Error code for programmatic handling */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** Network where the error occurred */
+    network?: NetworkType;
+    /** Canister ID if applicable */
+    canisterId?: string;
+}
+/**
+ * Configuration for ICP client
+ */
+export interface ICPClientConfig {
+    /** Target network */
+    network: NetworkType;
+    /** Host URL (defaults based on network) */
+    host?: string;
+    /** Path to dfx identity file for signing */
+    identity?: string;
+    /** Canister ID for operations (optional, used when deploying/upgrading) */
+    canisterId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/deployment/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/deployment/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEpH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,OAAO,EAAE,WAAW,CAAC;IACrB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,UAAU,EAAE,IAAI,CAAC;IACjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,OAAO,EAAE,WAAW,CAAC;IACrB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IAItB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IACpD,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,QAAQ,EAAE,YAAY,CAAC;IACvB,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yCAAyC;IACzC,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/src/deployment/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for ICP canister deployment
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/deployment/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/deployment/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/fault-tolerance/backup-status.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Backup Status — last-backup timestamp inspection
+ *
+ * Scans ~/.agentvault/backups/ and returns information about the most recent
+ * backup file for a given agent (or globally if no agent name is supplied).
+ */
+export interface BackupTimestampInfo {
+    found: boolean;
+    /** Absolute path to the most recent backup file */
+    filePath?: string;
+    /** ISO-8601 timestamp recorded inside the manifest */
+    timestamp?: string;
+    /** mtime of the file on disk (may differ when copied) */
+    mtimeISO?: string;
+    /** Seconds since the backup was taken (based on manifest timestamp) */
+    ageSeconds?: number;
+    /** Human-readable age string */
+    ageHuman?: string;
+    agentName?: string;
+    /** true when the backup is older than staleThresholdHours */
+    stale?: boolean;
+    staleThresholdHours: number;
+}
+/**
+ * Find the most recent backup file in BACKUPS_DIR.
+ *
+ * @param agentName  Optional filter; if omitted, all agent backups are scanned.
+ * @param staleThresholdHours  Hours after which a backup is considered stale (default 25).
+ */
+export declare function getLastBackupInfo(agentName?: string, staleThresholdHours?: number): BackupTimestampInfo;
+//# sourceMappingURL=backup-status.d.ts.map

package/dist/src/fault-tolerance/backup-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-status.d.ts","sourceRoot":"","sources":["../../../src/fault-tolerance/backup-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAUD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,CAAC,EAAE,MAAM,EAClB,mBAAmB,SAAK,GACvB,mBAAmB,CA4DrB"}

package/dist/src/fault-tolerance/backup-status.js

@@ -0,0 +1,76 @@
+/**
+ * Backup Status — last-backup timestamp inspection
+ *
+ * Scans ~/.agentvault/backups/ and returns information about the most recent
+ * backup file for a given agent (or globally if no agent name is supplied).
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const AGENTVAULT_DIR = path.join(os.homedir(), '.agentvault');
+const BACKUPS_DIR = path.join(AGENTVAULT_DIR, 'backups');
+function humanAge(seconds) {
+    if (seconds < 60)
+        return `${seconds}s`;
+    if (seconds < 3600)
+        return `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    return `${h}h ${m}m`;
+}
+/**
+ * Find the most recent backup file in BACKUPS_DIR.
+ *
+ * @param agentName  Optional filter; if omitted, all agent backups are scanned.
+ * @param staleThresholdHours  Hours after which a backup is considered stale (default 25).
+ */
+export function getLastBackupInfo(agentName, staleThresholdHours = 25) {
+    const base = { found: false, staleThresholdHours };
+    if (!fs.existsSync(BACKUPS_DIR)) {
+        return base;
+    }
+    const files = fs.readdirSync(BACKUPS_DIR).filter(f => f.endsWith('.json'));
+    // Narrow to agent-specific files when a name is given
+    const candidates = agentName
+        ? files.filter(f => f.startsWith(`${agentName}-`) || f.startsWith(agentName))
+        : files;
+    if (candidates.length === 0) {
+        return base;
+    }
+    // Sort by mtime descending — fastest heuristic without parsing every file
+    const withStats = candidates
+        .map(f => ({ f, mtime: fs.statSync(path.join(BACKUPS_DIR, f)).mtime }))
+        .sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
+    // Walk from newest to oldest until we find a valid manifest
+    for (const { f, mtime } of withStats) {
+        const filePath = path.join(BACKUPS_DIR, f);
+        try {
+            const raw = fs.readFileSync(filePath, 'utf8');
+            const manifest = JSON.parse(raw);
+            const rawTs = manifest.timestamp ?? manifest.created;
+            if (!rawTs)
+                continue;
+            const ts = new Date(rawTs);
+            if (isNaN(ts.getTime()))
+                continue;
+            const ageSeconds = Math.floor((Date.now() - ts.getTime()) / 1000);
+            const stale = ageSeconds > staleThresholdHours * 3600;
+            return {
+                found: true,
+                filePath,
+                timestamp: ts.toISOString(),
+                mtimeISO: mtime.toISOString(),
+                ageSeconds,
+                ageHuman: humanAge(ageSeconds),
+                agentName: manifest.agentName ?? agentName,
+                stale,
+                staleThresholdHours,
+            };
+        }
+        catch {
+            // Corrupt/incomplete file — try the next one
+        }
+    }
+    return base;
+}
+//# sourceMappingURL=backup-status.js.map

package/dist/src/fault-tolerance/backup-status.js.map

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

package/dist/src/fault-tolerance/cron-check.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Cron Check — daily canister liveness check + auto-restore
+ *
+ * When the primary canister is unreachable or stopped, this module:
+ *  1. Finds the most recent local backup (JSON or zip-wrapped JSON)
+ *  2. Validates the backup manifest
+ *  3. Triggers `agentvault backup import` to restore the agent
+ *
+ * Designed to be invoked by a system cron entry at 00:01 daily:
+ *   1 0 * * * agentvault cron --check <canister-id> [--agent <name>]
+ */
+export interface CronState {
+    lastCheckISO: string;
+    lastCheckResult: 'alive' | 'restored' | 'restore-failed' | 'no-backup';
+    lastRestoreISO?: string;
+    lastRestoreBackup?: string;
+    consecutiveFailures: number;
+}
+export type CanisterLiveness = 'alive' | 'dead' | 'unknown';
+export interface RestoreResult {
+    success: boolean;
+    backupPath?: string;
+    agentName?: string;
+    error?: string;
+}
+export interface CronCheckOptions {
+    canisterId: string;
+    agentName?: string;
+    network?: string;
+    /** When true, only check — do NOT trigger restore even if canister is dead */
+    dryRun?: boolean;
+}
+export interface CronCheckResult {
+    canisterId: string;
+    liveness: CanisterLiveness;
+    action: 'none' | 'restore-skipped' | 'restore-attempted';
+    restore?: RestoreResult;
+    cronState: CronState;
+}
+/**
+ * Run the daily canister-liveness check.
+ *
+ * - If canister is alive  → log OK, done.
+ * - If canister is dead   → restore from latest local backup.
+ * - If liveness unknown   → log warning, do NOT auto-restore (network blip).
+ */
+export declare function runCronCheck(opts: CronCheckOptions): Promise<CronCheckResult>;
+export interface InstallCronOptions {
+    canisterId: string;
+    agentName?: string;
+    network?: string;
+    /** cron time expression; default "1 0 * * *" (00:01 daily) */
+    cronTime?: string;
+    /** Full path to the agentvault CLI binary; auto-detected if omitted */
+    cliBin?: string;
+}
+/**
+ * Print the crontab line that should be installed.
+ * Returns the crontab line as a string so the caller can display it.
+ */
+export declare function buildCronLine(opts: InstallCronOptions): string;
+/**
+ * Read the last cron run state from disk.
+ */
+export declare function readCronState(): CronState | null;
+//# sourceMappingURL=cron-check.d.ts.map

package/dist/src/fault-tolerance/cron-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-check.d.ts","sourceRoot":"","sources":["../../../src/fault-tolerance/cron-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA+BH,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,OAAO,GAAG,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAoBD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AA6B5D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqCD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;IACzD,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAoDnF;AAID,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAY9D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,SAAS,GAAG,IAAI,CAEhD"}

package/dist/src/fault-tolerance/cron-check.js

@@ -0,0 +1,177 @@
+/**
+ * Cron Check — daily canister liveness check + auto-restore
+ *
+ * When the primary canister is unreachable or stopped, this module:
+ *  1. Finds the most recent local backup (JSON or zip-wrapped JSON)
+ *  2. Validates the backup manifest
+ *  3. Triggers `agentvault backup import` to restore the agent
+ *
+ * Designed to be invoked by a system cron entry at 00:01 daily:
+ *   1 0 * * * agentvault cron --check <canister-id> [--agent <name>]
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { getLastBackupInfo } from './backup-status.js';
+const AGENTVAULT_DIR = path.join(os.homedir(), '.agentvault');
+const CRON_LOG = path.join(AGENTVAULT_DIR, 'cron.log');
+const CRON_STATE_FILE = path.join(AGENTVAULT_DIR, 'cron-state.json');
+// ── Logging ──────────────────────────────────────────────────────────────────
+function ensureDir(p) {
+    const dir = path.dirname(p);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+}
+function log(level, msg) {
+    const line = `[${new Date().toISOString()}] [${level}] ${msg}\n`;
+    try {
+        ensureDir(CRON_LOG);
+        fs.appendFileSync(CRON_LOG, line, 'utf8');
+    }
+    catch {
+        // If logging fails we still continue
+    }
+    process.stdout.write(line);
+}
+function loadCronState() {
+    try {
+        if (fs.existsSync(CRON_STATE_FILE)) {
+            return JSON.parse(fs.readFileSync(CRON_STATE_FILE, 'utf8'));
+        }
+    }
+    catch { /* ignore */ }
+    return null;
+}
+function saveCronState(state) {
+    try {
+        ensureDir(CRON_STATE_FILE);
+        fs.writeFileSync(CRON_STATE_FILE, JSON.stringify(state, null, 2), 'utf8');
+    }
+    catch { /* ignore */ }
+}
+/**
+ * Probe the canister and return its liveness status.
+ *
+ * Uses the ICP client when available; falls back to "unknown" so that
+ * auto-restore is NOT triggered on connectivity issues alone (conservative).
+ */
+async function probeCanister(canisterId, network) {
+    try {
+        const { createICPClient } = await import('../deployment/icpClient.js');
+        const client = createICPClient({ network: network });
+        const status = await client.getCanisterStatus(canisterId);
+        const s = status.status?.toLowerCase() ?? '';
+        if (s === 'running')
+            return 'alive';
+        if (s === 'stopped')
+            return 'dead';
+        return 'unknown';
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log('WARN', `Canister probe failed: ${msg}`);
+        return 'unknown';
+    }
+}
+/**
+ * Attempt to restore from the most recent local backup.
+ */
+async function restoreFromBackup(agentName) {
+    const info = getLastBackupInfo(agentName);
+    if (!info.found || !info.filePath) {
+        return { success: false, error: 'No local backup found' };
+    }
+    log('INFO', `Restoring from backup: ${info.filePath} (age: ${info.ageHuman})`);
+    try {
+        const { importBackup } = await import('../backup/backup.js');
+        const result = await importBackup({
+            inputPath: info.filePath,
+            targetAgentName: agentName,
+            overwrite: true,
+        });
+        if (result.success) {
+            log('INFO', `Restore succeeded — agent: ${result.agentName}, components: ${result.components.join(', ')}`);
+            return { success: true, backupPath: info.filePath, agentName: result.agentName };
+        }
+        else {
+            log('ERROR', `Restore failed: ${result.error ?? 'unknown'}`);
+            return { success: false, backupPath: info.filePath, error: result.error };
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log('ERROR', `Restore threw: ${msg}`);
+        return { success: false, backupPath: info.filePath, error: msg };
+    }
+}
+/**
+ * Run the daily canister-liveness check.
+ *
+ * - If canister is alive  → log OK, done.
+ * - If canister is dead   → restore from latest local backup.
+ * - If liveness unknown   → log warning, do NOT auto-restore (network blip).
+ */
+export async function runCronCheck(opts) {
+    const { canisterId, agentName, network = 'ic', dryRun = false } = opts;
+    log('INFO', `Cron check — canister: ${canisterId}, network: ${network}${dryRun ? ' (dry-run)' : ''}`);
+    const liveness = await probeCanister(canisterId, network);
+    log('INFO', `Canister liveness: ${liveness}`);
+    let action = 'none';
+    let restore;
+    if (liveness === 'dead') {
+        if (dryRun) {
+            log('WARN', 'Canister is DEAD — dry-run mode, skipping restore');
+            action = 'restore-skipped';
+        }
+        else {
+            log('WARN', 'Canister is DEAD — attempting restore from local backup');
+            action = 'restore-attempted';
+            restore = await restoreFromBackup(agentName);
+        }
+    }
+    else if (liveness === 'unknown') {
+        log('WARN', 'Canister liveness unknown (network issue?). Skipping auto-restore to avoid false positive.');
+    }
+    const prev = loadCronState();
+    const cronState = {
+        lastCheckISO: new Date().toISOString(),
+        lastCheckResult: liveness === 'alive'
+            ? 'alive'
+            : liveness === 'dead' && restore?.success
+                ? 'restored'
+                : liveness === 'dead' && restore && !restore.success
+                    ? 'restore-failed'
+                    : 'no-backup',
+        consecutiveFailures: liveness !== 'alive'
+            ? (prev?.consecutiveFailures ?? 0) + 1
+            : 0,
+        ...(restore?.success
+            ? {
+                lastRestoreISO: new Date().toISOString(),
+                lastRestoreBackup: restore.backupPath,
+            }
+            : {
+                lastRestoreISO: prev?.lastRestoreISO,
+                lastRestoreBackup: prev?.lastRestoreBackup,
+            }),
+    };
+    saveCronState(cronState);
+    return { canisterId, liveness, action, restore, cronState };
+}
+/**
+ * Print the crontab line that should be installed.
+ * Returns the crontab line as a string so the caller can display it.
+ */
+export function buildCronLine(opts) {
+    const { canisterId, agentName, network = 'ic', cronTime = '1 0 * * *', cliBin = 'agentvault', } = opts;
+    const agentFlag = agentName ? ` --agent ${agentName}` : '';
+    const netFlag = ` --network ${network}`;
+    return `${cronTime} ${cliBin} cron check ${canisterId}${agentFlag}${netFlag} >> ${CRON_LOG} 2>&1`;
+}
+/**
+ * Read the last cron run state from disk.
+ */
+export function readCronState() {
+    return loadCronState();
+}
+//# sourceMappingURL=cron-check.js.map

package/dist/src/fault-tolerance/cron-check.js.map

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

package/dist/src/fault-tolerance/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Fault Tolerance Module
+ *
+ * Provides:
+ *  - Last-backup timestamp inspection
+ *  - Cron-based canister liveness check + auto-restore from local zip/JSON
+ *  - Mirror canister state sync helpers
+ */
+export * from './backup-status.js';
+export * from './cron-check.js';
+export * from './mirror-sync.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/fault-tolerance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fault-tolerance/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/src/fault-tolerance/index.js

@@ -0,0 +1,12 @@
+/**
+ * Fault Tolerance Module
+ *
+ * Provides:
+ *  - Last-backup timestamp inspection
+ *  - Cron-based canister liveness check + auto-restore from local zip/JSON
+ *  - Mirror canister state sync helpers
+ */
+export * from './backup-status.js';
+export * from './cron-check.js';
+export * from './mirror-sync.js';
+//# sourceMappingURL=index.js.map

package/dist/src/fault-tolerance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fault-tolerance/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}