agentvault 1.0.1 → 1.0.5

package/dist/src/mint/google-adk.js

@@ -0,0 +1,180 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execa } from 'execa';
+import { exportBackup } from '../backup/index.js';
+import { prepareArchive, markArchiveUploading, updateArchiveTransaction, confirmArchive, failArchive, getArchiveData, } from '../archival/archive-manager.js';
+import { ArweaveClient } from '../archival/arweave-client.js';
+import { generateStubCanisterId } from '../deployment/index.js';
+function normalizeAgentName(name) {
+    return name.trim().toLowerCase().replace(/[^a-z0-9-]/g, '-');
+}
+async function ensureGoogleAdkAvailable(installIfMissing) {
+    const warnings = [];
+    const pythonBins = ['python3', 'python'];
+    for (const pythonBin of pythonBins) {
+        const show = await execa(pythonBin, ['-m', 'pip', 'show', 'google-adk'], { reject: false });
+        if (show.exitCode === 0) {
+            return { installed: true, warnings };
+        }
+        if (!installIfMissing) {
+            continue;
+        }
+        const install = await execa(pythonBin, ['-m', 'pip', 'install', 'google-adk', 'google-a2a'], { reject: false });
+        if (install.exitCode === 0) {
+            return { installed: true, warnings };
+        }
+        warnings.push(`Failed to install Google ADK with ${pythonBin}: ${install.stderr || install.stdout}`);
+    }
+    warnings.push('Google ADK is not available. Install manually with: python3 -m pip install google-adk google-a2a');
+    return { installed: false, warnings };
+}
+function buildTemplateSource(agentName, template) {
+    const strategyMap = {
+        'loop-agent': 'loop',
+        'workflow-agent': 'workflow',
+        'sequential-agent': 'sequential',
+        'parallel-agent': 'parallel',
+    };
+    return `"""${agentName}: Google ADK + A2A compatible scaffold."""
+
+from dataclasses import dataclass
+
+@dataclass
+class AgentContext:
+    task: str
+
+class ${agentName.replace(/-/g, '_')}Agent:
+    strategy = "${strategyMap[template]}"
+
+    def run(self, context: AgentContext) -> str:
+        return f"[${template}] handled task: {context.task}"
+
+if __name__ == "__main__":
+    agent = ${agentName.replace(/-/g, '_')}Agent()
+    print(agent.run(AgentContext(task="hello from agentvault")))
+`;
+}
+function writeScaffoldFiles(agentDir, agentName, template, canisterId) {
+    const agentVaultDir = path.join(agentDir, '.agentvault');
+    const configDir = path.join(agentVaultDir, 'config');
+    const backupDir = path.join(agentVaultDir, 'backups');
+    fs.mkdirSync(configDir, { recursive: true });
+    fs.mkdirSync(backupDir, { recursive: true });
+    const manifest = {
+        name: agentName,
+        protocol: 'a2a',
+        framework: 'google-adk',
+        template,
+        canisterId,
+        createdAt: new Date().toISOString(),
+    };
+    fs.writeFileSync(path.join(agentDir, 'agent.py'), buildTemplateSource(agentName, template), 'utf8');
+    fs.writeFileSync(path.join(agentDir, 'requirements.txt'), 'google-adk\ngoogle-a2a\n', 'utf8');
+    fs.writeFileSync(path.join(agentDir, 'a2a-manifest.json'), JSON.stringify(manifest, null, 2), 'utf8');
+    fs.writeFileSync(path.join(configDir, 'agent.config.json'), JSON.stringify({
+        name: agentName,
+        type: `google-adk-${template}`,
+        canisterId,
+        description: `Scaffolded Google ADK ${template}`,
+        createdAt: Date.now(),
+    }, null, 2), 'utf8');
+}
+async function createBirthdayBackup(agentDir, agentName, canisterId) {
+    const backupPath = path.join(agentDir, '.agentvault', 'backups', 'birthday-backup.json');
+    const backupResult = await exportBackup({
+        agentName,
+        outputPath: backupPath,
+        canisterId,
+        includeCanisterState: false,
+    });
+    if (!backupResult.success || !backupResult.path) {
+        throw new Error(backupResult.error || 'Failed to create birthday backup');
+    }
+    return backupResult.path;
+}
+async function createArweaveBirthdayArchive(agentName, template, canisterId, backupPath, arweaveJwkPath) {
+    const warnings = [];
+    const archivePayload = {
+        kind: 'birthday-backup',
+        agentName,
+        template,
+        canisterId,
+        backupPath,
+        createdAt: new Date().toISOString(),
+    };
+    const prepared = prepareArchive(agentName, '1.0.0', archivePayload, {
+        tags: {
+            birthday: 'true',
+            framework: 'google-adk',
+            template,
+        },
+    });
+    if (!prepared.success || !prepared.archiveId) {
+        warnings.push(prepared.error || 'Failed to prepare Arweave archive');
+        return { warnings };
+    }
+    if (!arweaveJwkPath) {
+        warnings.push('Arweave wallet not provided. Archive prepared locally but not uploaded.');
+        return { archiveId: prepared.archiveId, warnings };
+    }
+    try {
+        const data = getArchiveData(prepared.archiveId);
+        if (!data) {
+            throw new Error('Prepared archive data was not found on disk.');
+        }
+        const jwk = JSON.parse(fs.readFileSync(arweaveJwkPath, 'utf8'));
+        const client = new ArweaveClient();
+        markArchiveUploading(prepared.archiveId);
+        const upload = await client.uploadJSON(data, jwk, {
+            tags: {
+                'App-Name': 'AgentVault',
+                'Agent-Name': agentName,
+                'Canister-ID': canisterId,
+                Birthday: 'true',
+            },
+        });
+        if (!upload.success || !upload.transactionId) {
+            failArchive(prepared.archiveId, upload.error || 'Upload failed');
+            warnings.push(upload.error || 'Failed to upload birthday archive to Arweave');
+            return { archiveId: prepared.archiveId, warnings };
+        }
+        updateArchiveTransaction(prepared.archiveId, upload.transactionId);
+        confirmArchive(prepared.archiveId);
+        return { archiveId: prepared.archiveId, transactionId: upload.transactionId, warnings };
+    }
+    catch (error) {
+        failArchive(prepared.archiveId, error instanceof Error ? error.message : 'Unknown error');
+        warnings.push(`Arweave upload failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        return { archiveId: prepared.archiveId, warnings };
+    }
+}
+export async function mintGoogleAdkAgent(options) {
+    const warnings = [];
+    const agentName = normalizeAgentName(options.agentName);
+    if (!agentName) {
+        throw new Error('Agent name is required');
+    }
+    const targetRoot = options.targetRoot ?? process.cwd();
+    const agentDir = path.resolve(targetRoot, agentName);
+    if (fs.existsSync(agentDir) && fs.readdirSync(agentDir).length > 0) {
+        throw new Error(`Target directory is not empty: ${agentDir}`);
+    }
+    fs.mkdirSync(agentDir, { recursive: true });
+    const adkStatus = await ensureGoogleAdkAvailable(options.installAdk !== false);
+    warnings.push(...adkStatus.warnings);
+    const canisterId = generateStubCanisterId();
+    writeScaffoldFiles(agentDir, agentName, options.template, canisterId);
+    const backupPath = await createBirthdayBackup(agentDir, agentName, canisterId);
+    const archive = await createArweaveBirthdayArchive(agentName, options.template, canisterId, backupPath, options.arweaveJwkPath);
+    warnings.push(...archive.warnings);
+    return {
+        agentDir,
+        canisterId,
+        backupPath,
+        archiveId: archive.archiveId,
+        arweaveTransactionId: archive.transactionId,
+        adkInstalled: adkStatus.installed,
+        warnings,
+    };
+}
+//# sourceMappingURL=google-adk.js.map

package/dist/src/mint/google-adk.js.map

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

package/dist/src/monitoring/alerting.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Alerting
+ *
+ * Generates, stores, and retrieves monitoring alerts for canisters.
+ * Tracks cycle depletion, memory issues, and performance degradation.
+ */
+import type { MonitoringAlert, CanisterStatusInfo, HealthThresholds } from './types.js';
+/**
+ * Load alerts from storage.
+ *
+ * @param canisterId - Canister ID
+ * @returns Stored alerts array
+ */
+export declare function loadAlerts(canisterId: string): MonitoringAlert[];
+/**
+ * Save alerts to storage.
+ *
+ * @param canisterId - Canister ID
+ * @param alerts - Alerts to store
+ */
+export declare function saveAlerts(canisterId: string, alerts: MonitoringAlert[]): void;
+/**
+ * Append a new alert to storage.
+ *
+ * @param canisterId - Canister ID
+ * @param alert - Alert to add
+ */
+export declare function appendAlert(canisterId: string, alert: MonitoringAlert): void;
+/**
+ * Clear alerts for a canister.
+ *
+ * @param canisterId - Canister ID
+ */
+export declare function clearAlerts(canisterId: string): void;
+/**
+ * Generate health alerts for a canister based on its current status.
+ *
+ * @param statusInfo - Canister status information
+ * @param thresholds - Health check thresholds
+ * @returns Array of alerts
+ */
+export declare function generateHealthAlerts(statusInfo: CanisterStatusInfo, thresholds?: HealthThresholds): MonitoringAlert[];
+/**
+ * Get recent alerts for a canister.
+ *
+ * @param canisterId - Canister ID
+ * @param limit - Maximum number of alerts to return (default: 10)
+ * @returns Recent alerts (newest first)
+ */
+export declare function getRecentAlerts(canisterId: string, limit?: number): MonitoringAlert[];
+//# sourceMappingURL=alerting.d.ts.map

package/dist/src/monitoring/alerting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerting.d.ts","sourceRoot":"","sources":["../../../src/monitoring/alerting.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAapB;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,EAAE,CAWhE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAK9E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAI5E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAKpD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,kBAAkB,EAC9B,UAAU,GAAE,gBAAqB,GAChC,eAAe,EAAE,CAkFnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAW,GACjB,eAAe,EAAE,CAGnB"}

package/dist/src/monitoring/alerting.js

@@ -0,0 +1,169 @@
+/**
+ * Alerting
+ *
+ * Generates, stores, and retrieves monitoring alerts for canisters.
+ * Tracks cycle depletion, memory issues, and performance degradation.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Default alert storage path
+ */
+const ALERTS_DIR = path.join(process.env.HOME || process.cwd(), '.agentvault', 'alerts');
+/**
+ * Alert storage file path
+ */
+const getAlertFilePath = (canisterId) => path.join(ALERTS_DIR, `${canisterId}.json`);
+/**
+ * Load alerts from storage.
+ *
+ * @param canisterId - Canister ID
+ * @returns Stored alerts array
+ */
+export function loadAlerts(canisterId) {
+    const alertFile = getAlertFilePath(canisterId);
+    if (!fs.existsSync(alertFile)) {
+        return [];
+    }
+    try {
+        const content = fs.readFileSync(alertFile, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Save alerts to storage.
+ *
+ * @param canisterId - Canister ID
+ * @param alerts - Alerts to store
+ */
+export function saveAlerts(canisterId, alerts) {
+    const alertFile = getAlertFilePath(canisterId);
+    const content = JSON.stringify(alerts, null, 2);
+    fs.mkdirSync(path.dirname(alertFile), { recursive: true });
+    fs.writeFileSync(alertFile, content, 'utf-8');
+}
+/**
+ * Append a new alert to storage.
+ *
+ * @param canisterId - Canister ID
+ * @param alert - Alert to add
+ */
+export function appendAlert(canisterId, alert) {
+    const alerts = loadAlerts(canisterId);
+    alerts.push(alert);
+    saveAlerts(canisterId, alerts);
+}
+/**
+ * Clear alerts for a canister.
+ *
+ * @param canisterId - Canister ID
+ */
+export function clearAlerts(canisterId) {
+    const alertFile = getAlertFilePath(canisterId);
+    if (fs.existsSync(alertFile)) {
+        fs.unlinkSync(alertFile);
+    }
+}
+/**
+ * Generate health alerts for a canister based on its current status.
+ *
+ * @param statusInfo - Canister status information
+ * @param thresholds - Health check thresholds
+ * @returns Array of alerts
+ */
+export function generateHealthAlerts(statusInfo, thresholds = {}) {
+    const alerts = [];
+    const cycles = statusInfo.cycles;
+    if (cycles !== undefined) {
+        if (thresholds.cyclesCritical !== undefined && cycles < thresholds.cyclesCritical) {
+            alerts.push({
+                severity: 'critical',
+                message: `Cycle balance critically low: ${cycles.toString()}`,
+                canisterId: statusInfo.canisterId,
+                metric: 'cycles',
+                value: cycles.toString(),
+                threshold: thresholds.cyclesCritical.toString(),
+                timestamp: new Date(),
+            });
+        }
+        else if (thresholds.cyclesWarning !== undefined && cycles < thresholds.cyclesWarning) {
+            alerts.push({
+                severity: 'warning',
+                message: `Cycle balance low: ${cycles.toString()}`,
+                canisterId: statusInfo.canisterId,
+                metric: 'cycles',
+                value: cycles.toString(),
+                threshold: thresholds.cyclesWarning.toString(),
+                timestamp: new Date(),
+            });
+        }
+    }
+    const memoryBytes = statusInfo.memorySize;
+    if (memoryBytes !== undefined) {
+        const memoryMB = Number(memoryBytes) / (1024 * 1024);
+        // IC canisters have ~4GB max memory (4096 MB)
+        const maxMemoryMB = 4096;
+        const criticalThresholdMB = maxMemoryMB * ((thresholds.memoryCriticalPercent ?? 0) / 100);
+        const warningThresholdMB = maxMemoryMB * ((thresholds.memoryWarningPercent ?? 0) / 100);
+        if (thresholds.memoryCriticalPercent !== undefined && memoryMB > criticalThresholdMB) {
+            alerts.push({
+                severity: 'critical',
+                message: `Memory usage critically high: ${memoryMB.toFixed(2)} MB`,
+                canisterId: statusInfo.canisterId,
+                metric: 'memory',
+                value: `${memoryMB.toFixed(2)} MB`,
+                threshold: `${thresholds.memoryCriticalPercent}%`,
+                timestamp: new Date(),
+            });
+        }
+        else if (thresholds.memoryWarningPercent !== undefined && memoryMB > warningThresholdMB) {
+            alerts.push({
+                severity: 'warning',
+                message: `Memory usage high: ${memoryMB.toFixed(2)} MB`,
+                canisterId: statusInfo.canisterId,
+                metric: 'memory',
+                value: `${memoryMB.toFixed(2)} MB`,
+                threshold: `${thresholds.memoryWarningPercent}%`,
+                timestamp: new Date(),
+            });
+        }
+    }
+    if (statusInfo.status === 'stopped') {
+        alerts.push({
+            severity: 'critical',
+            message: 'Canister is stopped',
+            canisterId: statusInfo.canisterId,
+            metric: 'status',
+            value: statusInfo.status,
+            threshold: 'healthy',
+            timestamp: new Date(),
+        });
+    }
+    else if (statusInfo.status === 'stopping') {
+        alerts.push({
+            severity: 'warning',
+            message: 'Canister is stopping',
+            canisterId: statusInfo.canisterId,
+            metric: 'status',
+            value: statusInfo.status,
+            threshold: 'healthy',
+            timestamp: new Date(),
+        });
+    }
+    return alerts;
+}
+/**
+ * Get recent alerts for a canister.
+ *
+ * @param canisterId - Canister ID
+ * @param limit - Maximum number of alerts to return (default: 10)
+ * @returns Recent alerts (newest first)
+ */
+export function getRecentAlerts(canisterId, limit = 10) {
+    const alerts = loadAlerts(canisterId);
+    return alerts.slice(-limit);
+}
+//# sourceMappingURL=alerting.js.map

package/dist/src/monitoring/alerting.js.map

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

package/dist/src/monitoring/health.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Health Monitoring
+ *
+ * Performs health checks on canisters and determines overall health status
+ * based on resource usage thresholds.
+ */
+import type { CanisterHealthStatus, CanisterStatusInfo, HealthThresholds, MonitoringOptions, MonitoringAlert, ThoughtFormHealthStatus, ThoughtFormHealthOptions } from './types.js';
+/**
+ * Determine health status based on resource metrics.
+ *
+ * @param statusInfo - Canister status information
+ * @param thresholds - Health check thresholds
+ * @returns Health status
+ */
+export declare function determineHealthStatus(statusInfo: CanisterStatusInfo, thresholds?: HealthThresholds): CanisterHealthStatus;
+/**
+ * Generate alerts based on health status.
+ *
+ * @param statusInfo - Canister status information
+ * @param thresholds - Health check thresholds
+ * @param currentHealth - Current health status
+ * @returns Generated alerts
+ */
+export declare function generateHealthAlerts(statusInfo: CanisterStatusInfo, thresholds?: HealthThresholds, currentHealth?: CanisterHealthStatus): MonitoringAlert[];
+/**
+ * Perform a one-time health check.
+ *
+ * @param options - Monitoring options
+ * @returns Canister status with health status
+ */
+export declare function checkHealth(canisterId: string, options?: Partial<MonitoringOptions>): Promise<CanisterStatusInfo>;
+/**
+ * Check multiple canisters' health status.
+ *
+ * @param canisterIds - Array of canister IDs to check
+ * @param options - Monitoring options applied to all
+ * @returns Array of canister status info
+ */
+export declare function checkMultipleHealth(canisterIds: string[], options?: Partial<MonitoringOptions>): Promise<CanisterStatusInfo[]>;
+/**
+ * Check ThoughtForm store health by querying the canister for latest
+ * memory timestamp and total count.
+ *
+ * @param options - ThoughtForm health check options
+ * @returns ThoughtForm health status with latest timestamp and count
+ */
+export declare function checkThoughtFormHealth(options: ThoughtFormHealthOptions): Promise<ThoughtFormHealthStatus>;
+//# sourceMappingURL=health.d.ts.map

package/dist/src/monitoring/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/monitoring/health.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,kBAAkB,EAC9B,UAAU,GAAE,gBAAqB,GAChC,oBAAoB,CAoCtB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,kBAAkB,EAC9B,UAAU,GAAE,gBAAqB,EACjC,aAAa,GAAE,oBAAgC,GAC9C,eAAe,EAAE,CAmEnB;AAaD;;;;;GAKG;AACF,wBAAsB,WAAW,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,OAAO,CAAC,kBAAkB,CAAC,CAU7B;AAED;;;;;;GAMG;AACF,wBAAsB,mBAAmB,CACxC,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAS/B;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA4DlC"}