agentvault 1.0.1 → 1.0.5

package/dist/src/orchestration/smallchat-tools.js

@@ -0,0 +1,501 @@
+/**
+ * SmallChat ToolClass Definitions for AgentVault Canister Operations
+ *
+ * Maps AgentVault's Candid service interface to SmallChat ToolClass hierarchy.
+ * Each canister operation becomes a SmallChat tool with a selector, enabling
+ * intent-based dispatch, superclass fallback, and compact representation.
+ *
+ * Hierarchy:
+ *   BaseTools
+ *   ├── CanisterLifecycleTools  (bootstrap, freeze, unlock, revive)
+ *   ├── WalletTools             (register, deregister, list, update status)
+ *   │   └── TransactionTools    (queue, sign, complete, fail, retry, schedule)
+ *   ├── SecretTools             (store, get, list, delete encrypted secrets)
+ *   └── VetKeysTools            (init shares, derive key, verify sig)
+ */
+export const BASE_TOOLS = {
+    name: 'BaseTools',
+    tools: [
+        {
+            selector: 'getCanisterStatus',
+            candidMethod: 'getCanisterStatus',
+            description: 'Query canister running status, memory size, and cycle balance',
+            category: 'query',
+            riskLevel: 'low',
+            parameters: {},
+        },
+        {
+            selector: 'getMetrics',
+            candidMethod: 'getMetrics',
+            description: 'Query canister uptime, operation count, and last activity timestamp',
+            category: 'query',
+            riskLevel: 'low',
+            parameters: {},
+        },
+        {
+            selector: 'getSecurityStatus',
+            candidMethod: 'getSecurityStatus',
+            description: 'Query owner, frozen mode, bootstrap state, kill switch, and heap usage',
+            category: 'query',
+            riskLevel: 'low',
+            parameters: {},
+        },
+        {
+            selector: 'getHealthStatus',
+            candidMethod: 'getHealthStatus',
+            description: 'Query heartbeat health check state including consecutive timeouts',
+            category: 'query',
+            riskLevel: 'low',
+            parameters: {},
+        },
+    ],
+};
+export const CANISTER_LIFECYCLE_TOOLS = {
+    name: 'CanisterLifecycleTools',
+    superclass: 'BaseTools',
+    tools: [
+        {
+            selector: 'bootstrap',
+            candidMethod: 'bootstrap',
+            description: 'Initialize canister with agent config, setting owner to caller',
+            category: 'lifecycle',
+            riskLevel: 'critical',
+            requiresMfa: true,
+            parameters: {
+                name: { type: 'string', required: true, description: 'Agent name' },
+                agentType: { type: 'string', required: true, description: 'Agent type identifier' },
+                version: { type: 'string', required: true, description: 'Agent version' },
+            },
+        },
+        {
+            selector: 'completeBootstrap',
+            candidMethod: 'completeBootstrap',
+            description: 'Freeze canister after bootstrap — blocks all writes until manual unlock',
+            category: 'lifecycle',
+            riskLevel: 'critical',
+            requiresMfa: true,
+            parameters: {},
+        },
+        {
+            selector: 'freeze',
+            candidMethod: 'freeze',
+            description: 'Freeze canister — block all state mutations (owner only)',
+            category: 'lifecycle',
+            riskLevel: 'high',
+            requiresMfa: true,
+            parameters: {},
+        },
+        {
+            selector: 'manualUnlock',
+            candidMethod: 'manualUnlock',
+            description: 'Unlock frozen canister to re-enable writes (owner only)',
+            category: 'lifecycle',
+            riskLevel: 'high',
+            requiresMfa: true,
+            parameters: {},
+        },
+        {
+            selector: 'reviveCanister',
+            candidMethod: 'reviveCanister',
+            description: 'Reset health-check kill switch counters (owner only)',
+            category: 'lifecycle',
+            riskLevel: 'high',
+            requiresMfa: true,
+            parameters: {},
+        },
+        {
+            selector: 'addAuthorizedPrincipal',
+            candidMethod: 'addAuthorizedPrincipal',
+            description: 'Add a principal to the authorized callers list (owner only)',
+            category: 'lifecycle',
+            riskLevel: 'critical',
+            requiresMfa: true,
+            parameters: {
+                principal: { type: 'string', required: true, description: 'ICP principal ID to authorize' },
+            },
+        },
+        {
+            selector: 'removeAuthorizedPrincipal',
+            candidMethod: 'removeAuthorizedPrincipal',
+            description: 'Remove a principal from the authorized callers list (owner only)',
+            category: 'lifecycle',
+            riskLevel: 'critical',
+            requiresMfa: true,
+            parameters: {
+                principal: { type: 'string', required: true, description: 'ICP principal ID to revoke' },
+            },
+        },
+    ],
+};
+export const WALLET_TOOLS = {
+    name: 'WalletTools',
+    superclass: 'BaseTools',
+    tools: [
+        {
+            selector: 'registerWallet',
+            candidMethod: 'registerWallet',
+            description: 'Register a new wallet for an agent',
+            category: 'wallet',
+            riskLevel: 'medium',
+            parameters: {
+                id: { type: 'string', required: true, description: 'Wallet identifier' },
+                agentId: { type: 'string', required: true, description: 'Owning agent ID' },
+                chain: { type: 'string', required: true, description: 'Blockchain (icp, eth, dot, sol)' },
+                address: { type: 'string', required: true, description: 'On-chain address' },
+            },
+        },
+        {
+            selector: 'getWallet',
+            candidMethod: 'getWallet',
+            description: 'Get wallet details by ID',
+            category: 'wallet',
+            riskLevel: 'low',
+            parameters: {
+                walletId: { type: 'string', required: true, description: 'Wallet identifier' },
+            },
+        },
+        {
+            selector: 'listWallets',
+            candidMethod: 'listWallets',
+            description: 'List all wallets for an agent',
+            category: 'wallet',
+            riskLevel: 'low',
+            parameters: {
+                agentId: { type: 'string', required: true, description: 'Agent ID' },
+            },
+        },
+        {
+            selector: 'deregisterWallet',
+            candidMethod: 'deregisterWallet',
+            description: 'Remove a wallet registration',
+            category: 'wallet',
+            riskLevel: 'high',
+            requiresMfa: true,
+            parameters: {
+                walletId: { type: 'string', required: true, description: 'Wallet identifier' },
+            },
+        },
+        {
+            selector: 'updateWalletStatus',
+            candidMethod: 'updateWalletStatus',
+            description: 'Change wallet status (active, inactive, revoked)',
+            category: 'wallet',
+            riskLevel: 'medium',
+            parameters: {
+                walletId: { type: 'string', required: true, description: 'Wallet identifier' },
+                status: {
+                    type: 'string',
+                    required: true,
+                    description: 'New status',
+                    enum: ['active', 'inactive', 'revoked'],
+                },
+            },
+        },
+    ],
+};
+export const TRANSACTION_TOOLS = {
+    name: 'TransactionTools',
+    superclass: 'WalletTools',
+    tools: [
+        {
+            selector: 'queueTransaction',
+            candidMethod: 'queueTransaction',
+            description: 'Queue a new transaction for processing',
+            category: 'transaction',
+            riskLevel: 'high',
+            requiresMfa: true,
+            parameters: {
+                walletId: { type: 'string', required: true, description: 'Source wallet ID' },
+                action: {
+                    type: 'string',
+                    required: true,
+                    description: 'Transaction type',
+                    enum: ['send_funds', 'sign_message', 'deploy_contract'],
+                },
+                parameters: {
+                    type: 'object',
+                    required: true,
+                    description: 'Key-value transaction parameters',
+                },
+                priority: {
+                    type: 'string',
+                    description: 'Priority level',
+                    enum: ['low', 'normal', 'high'],
+                },
+                threshold: {
+                    type: 'number',
+                    description: 'Required approval threshold',
+                },
+            },
+        },
+        {
+            selector: 'markTransactionSigned',
+            candidMethod: 'markTransactionSigned',
+            description: 'Mark a queued transaction as signed',
+            category: 'transaction',
+            riskLevel: 'high',
+            parameters: {
+                transactionId: { type: 'string', required: true, description: 'Transaction ID' },
+                signature: { type: 'string', required: true, description: 'Signature data' },
+            },
+        },
+        {
+            selector: 'markTransactionCompleted',
+            candidMethod: 'markTransactionCompleted',
+            description: 'Mark a transaction as completed with result',
+            category: 'transaction',
+            riskLevel: 'medium',
+            parameters: {
+                transactionId: { type: 'string', required: true, description: 'Transaction ID' },
+                result: { type: 'string', required: true, description: 'Completion result' },
+            },
+        },
+        {
+            selector: 'markTransactionFailed',
+            candidMethod: 'markTransactionFailed',
+            description: 'Mark a transaction as failed with error message',
+            category: 'transaction',
+            riskLevel: 'medium',
+            parameters: {
+                transactionId: { type: 'string', required: true, description: 'Transaction ID' },
+                error: { type: 'string', required: true, description: 'Error message' },
+            },
+        },
+        {
+            selector: 'retryTransaction',
+            candidMethod: 'retryTransaction',
+            description: 'Retry a failed transaction',
+            category: 'transaction',
+            riskLevel: 'high',
+            parameters: {
+                transactionId: { type: 'string', required: true, description: 'Transaction ID' },
+            },
+        },
+        {
+            selector: 'scheduleTransaction',
+            candidMethod: 'scheduleTransaction',
+            description: 'Schedule a transaction for future execution',
+            category: 'transaction',
+            riskLevel: 'high',
+            parameters: {
+                transactionId: { type: 'string', required: true, description: 'Transaction ID' },
+                executeAt: { type: 'number', required: true, description: 'Execution timestamp (ns)' },
+            },
+        },
+        {
+            selector: 'getQueuedTransactions',
+            candidMethod: 'getQueuedTransactions',
+            description: 'List all queued transactions',
+            category: 'transaction',
+            riskLevel: 'low',
+            parameters: {},
+        },
+        {
+            selector: 'getPendingTransactions',
+            candidMethod: 'getPendingTransactions',
+            description: 'List pending (unprocessed) transactions',
+            category: 'transaction',
+            riskLevel: 'low',
+            parameters: {},
+        },
+        {
+            selector: 'getTransactionQueueStats',
+            candidMethod: 'getTransactionQueueStats',
+            description: 'Get queue statistics (total, pending, signed, completed, failed)',
+            category: 'transaction',
+            riskLevel: 'low',
+            parameters: {},
+        },
+        {
+            selector: 'clearCompletedTransactions',
+            candidMethod: 'clearCompletedTransactions',
+            description: 'Remove completed transactions from the queue',
+            category: 'transaction',
+            riskLevel: 'medium',
+            parameters: {},
+        },
+    ],
+};
+export const SECRET_TOOLS = {
+    name: 'SecretTools',
+    superclass: 'BaseTools',
+    tools: [
+        {
+            selector: 'storeEncryptedSecret',
+            candidMethod: 'storeEncryptedSecret',
+            description: 'Store an encrypted secret in the canister',
+            category: 'secret',
+            riskLevel: 'high',
+            requiresMfa: true,
+            parameters: {
+                id: { type: 'string', required: true, description: 'Secret identifier' },
+                ciphertext: { type: 'string', required: true, description: 'Encrypted data (hex)' },
+                iv: { type: 'string', required: true, description: 'Initialization vector (hex)' },
+                tag: { type: 'string', required: true, description: 'Auth tag (hex)' },
+                algorithm: {
+                    type: 'string',
+                    description: 'Encryption algorithm',
+                    enum: ['aes_256_gcm', 'chacha20_poly1305'],
+                },
+            },
+        },
+        {
+            selector: 'getEncryptedSecret',
+            candidMethod: 'getEncryptedSecret',
+            description: 'Retrieve an encrypted secret by ID',
+            category: 'secret',
+            riskLevel: 'medium',
+            parameters: {
+                secretId: { type: 'string', required: true, description: 'Secret identifier' },
+            },
+        },
+        {
+            selector: 'listEncryptedSecrets',
+            candidMethod: 'listEncryptedSecrets',
+            description: 'List all encrypted secrets',
+            category: 'secret',
+            riskLevel: 'medium',
+            parameters: {},
+        },
+        {
+            selector: 'deleteEncryptedSecret',
+            candidMethod: 'deleteEncryptedSecret',
+            description: 'Delete an encrypted secret',
+            category: 'secret',
+            riskLevel: 'high',
+            requiresMfa: true,
+            parameters: {
+                secretId: { type: 'string', required: true, description: 'Secret identifier' },
+            },
+        },
+    ],
+};
+export const VETKEYS_TOOLS = {
+    name: 'VetKeysTools',
+    superclass: 'BaseTools',
+    tools: [
+        {
+            selector: 'initializeThresholdShares',
+            candidMethod: 'initializeThresholdShares',
+            description: 'Register BLS threshold share public commitments for VetKeys',
+            category: 'vetkeys',
+            riskLevel: 'critical',
+            requiresMfa: true,
+            parameters: {
+                masterPublicKey: { type: 'string', required: true, description: 'Master public key (hex)' },
+                vssCommitments: {
+                    type: 'array',
+                    required: true,
+                    description: 'VSS commitment array',
+                    items: { type: 'string' },
+                },
+                shareCommitments: {
+                    type: 'array',
+                    required: true,
+                    description: 'Per-share commitment records',
+                    items: { type: 'object' },
+                },
+                groupCommitment: { type: 'string', required: true, description: 'Group commitment (hex)' },
+                threshold: { type: 'number', required: true, description: 'Signing threshold (t-of-n)' },
+                totalParties: { type: 'number', required: true, description: 'Total parties (n)' },
+            },
+        },
+        {
+            selector: 'deriveVetKeysKey',
+            candidMethod: 'deriveVetKeysKey',
+            description: 'Derive a threshold key for a given path and share index',
+            category: 'vetkeys',
+            riskLevel: 'high',
+            requiresMfa: true,
+            parameters: {
+                derivationPath: { type: 'string', required: true, description: 'Key derivation path' },
+                shareIndex: { type: 'number', required: true, description: 'Share participant index' },
+            },
+        },
+        {
+            selector: 'verifyThresholdSignature',
+            candidMethod: 'verifyThresholdSignature',
+            description: 'Verify a threshold signature against the registered shares',
+            category: 'vetkeys',
+            riskLevel: 'low',
+            parameters: {
+                message: { type: 'string', required: true, description: 'Signed message' },
+                signature: { type: 'string', required: true, description: 'Threshold signature (hex)' },
+            },
+        },
+        {
+            selector: 'getVetKeysStatus',
+            candidMethod: 'getVetKeysStatus',
+            description: 'Query VetKeys initialization status and mode',
+            category: 'vetkeys',
+            riskLevel: 'low',
+            parameters: {},
+        },
+        {
+            selector: 'getShareHealthStatus',
+            candidMethod: 'getShareHealthStatus',
+            description: 'Query BLS threshold share health reports',
+            category: 'vetkeys',
+            riskLevel: 'low',
+            parameters: {},
+        },
+    ],
+};
+// ---------------------------------------------------------------------------
+// Registry: all tool classes in hierarchy order
+// ---------------------------------------------------------------------------
+export const ALL_TOOL_CLASSES = [
+    BASE_TOOLS,
+    CANISTER_LIFECYCLE_TOOLS,
+    WALLET_TOOLS,
+    TRANSACTION_TOOLS,
+    SECRET_TOOLS,
+    VETKEYS_TOOLS,
+];
+/**
+ * Flatten all tool definitions from all classes into a single map
+ * keyed by selector string.
+ */
+export function getAllToolDefinitions() {
+    const map = new Map();
+    for (const cls of ALL_TOOL_CLASSES) {
+        for (const tool of cls.tools) {
+            map.set(tool.selector, tool);
+        }
+    }
+    return map;
+}
+/**
+ * Get the superclass chain for a given ToolClass name.
+ * Returns array from most specific to least specific (BaseTools last).
+ */
+export function getSuperclassChain(className) {
+    const chain = [className];
+    let current = ALL_TOOL_CLASSES.find((c) => c.name === className);
+    while (current?.superclass) {
+        chain.push(current.superclass);
+        current = ALL_TOOL_CLASSES.find((c) => c.name === current.superclass);
+    }
+    return chain;
+}
+/**
+ * Find the ToolClass that owns a given selector.
+ */
+export function findToolClassForSelector(selector) {
+    return ALL_TOOL_CLASSES.find((cls) => cls.tools.some((t) => t.selector === selector));
+}
+/**
+ * Get all tools that require MFA confirmation.
+ */
+export function getMfaRequiredTools() {
+    return ALL_TOOL_CLASSES.flatMap((cls) => cls.tools.filter((t) => t.requiresMfa));
+}
+/**
+ * Get all tools at or above a given risk level.
+ */
+export function getToolsByMinRisk(minRisk) {
+    const levels = ['low', 'medium', 'high', 'critical'];
+    const minIndex = levels.indexOf(minRisk);
+    return ALL_TOOL_CLASSES.flatMap((cls) => cls.tools.filter((t) => levels.indexOf(t.riskLevel) >= minIndex));
+}
+//# sourceMappingURL=smallchat-tools.js.map

package/dist/src/orchestration/smallchat-tools.js.map

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

package/dist/src/packaging/compiler.d.ts

@@ -0,0 +1,61 @@
+/**
+ * WASM Compilation
+ *
+ * This module provides real WASM compilation for agent code.
+ * It bundles agent source code and creates WebAssembly modules
+ * with embedded JavaScript for execution.
+ */
+import type { AgentConfig, PackageResult, PackageOptions } from './types.js';
+/**
+ * Bundle agent code to JavaScript
+ *
+ * Uses esbuild to bundle the agent's source code into a single JavaScript file.
+ */
+export declare function bundleAgentCode(config: AgentConfig): Promise<string>;
+/**
+ * Generate a real WASM binary with embedded JavaScript bundle
+ *
+ * Creates a WASM module that contains:
+ * - Magic bytes and version
+ * - Custom section with agent metadata
+ * - Data section with embedded JavaScript bundle
+ * - Exported functions for agent lifecycle
+ */
+export declare function generateWasm(config: AgentConfig, javascriptBundle: string): Buffer;
+/**
+ * Generate WAT (WebAssembly Text Format) representation
+ *
+ * Creates a human-readable text representation of the WASM module.
+ */
+export declare function generateStubWat(config: AgentConfig): string;
+/**
+ * Generate serialized state JSON
+ *
+ * Creates the initial state representation for the agent.
+ */
+export declare function generateStateJson(config: AgentConfig): string;
+/**
+ * Generate WAT (WebAssembly Text Format) representation
+ *
+ * Creates a human-readable text representation of the compiled WASM module.
+ */
+export declare function generateWat(config: AgentConfig, javascriptBundle: string): string;
+/**
+ * Compile an agent to WASM using WasmEdge
+ *
+ * This is the main compilation function that orchestrates the packaging process.
+ * It bundles agent code and creates a WASM module with embedded JavaScript.
+ *
+ * @param config - Agent configuration from detection
+ * @param options - Packaging options including compilation target
+ * @param outputDir - Directory to write output files
+ * @returns Package result with paths to generated files
+ */
+export declare function compileToWasm(config: AgentConfig, options: PackageOptions, outputDir: string): Promise<PackageResult>;
+/**
+ * Validate WASM file integrity
+ *
+ * Checks that a file has valid WASM magic bytes.
+ */
+export declare function validateWasmFile(filePath: string): boolean;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/src/packaging/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/packaging/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAsB7E;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CA2D1E;AAqCD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CA0KlF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA2C3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAqB7D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CA8CjF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CA2JxB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAuB1D"}