agentvault 1.0.0 → 1.0.2

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

@@ -0,0 +1,60 @@
+/**
+ * Environment Manager
+ *
+ * Manages ICP environment configurations from icp.yaml files.
+ * Supports multiple environments (local, dev, staging, production)
+ * with independent settings for network, cycles, identity, and optimization.
+ */
+import type { IcpProjectConfig, IcpEnvironmentConfig, IcpOptimizationConfig } from './types.js';
+/**
+ * Find the icp.yaml configuration file by walking up from a starting directory.
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Absolute path to icp.yaml, or null if not found
+ */
+export declare function findConfigFile(startDir?: string): string | null;
+/**
+ * Load and parse icp.yaml configuration.
+ *
+ * @param configPath - Path to icp.yaml (if null, will search for it)
+ * @returns Parsed configuration, or null if not found
+ */
+export declare function loadConfig(configPath?: string): IcpProjectConfig | null;
+/**
+ * Get the configuration for a specific environment.
+ *
+ * Falls back to 'local' default if the environment is not defined.
+ *
+ * @param envName - Environment name
+ * @param config - Project configuration (will be loaded if not provided)
+ * @returns Environment configuration
+ */
+export declare function getEnvironment(envName: string, config?: IcpProjectConfig | null): IcpEnvironmentConfig;
+/**
+ * Get the optimization configuration.
+ *
+ * @param config - Project configuration (will be loaded if not provided)
+ * @returns Optimization configuration
+ */
+export declare function getOptimizationConfig(config?: IcpProjectConfig | null): IcpOptimizationConfig;
+/**
+ * List all defined environment names.
+ *
+ * @param config - Project configuration (will be loaded if not provided)
+ * @returns Array of environment names
+ */
+export declare function listEnvironments(config?: IcpProjectConfig | null): string[];
+/**
+ * Write an icp.yaml configuration file.
+ *
+ * @param config - Configuration to write
+ * @param outputPath - Path to write to (defaults to ./icp.yaml)
+ */
+export declare function writeConfig(config: IcpProjectConfig, outputPath?: string): void;
+/**
+ * Generate a default icp.yaml configuration.
+ *
+ * @returns Default project configuration with local, dev, staging, production environments
+ */
+export declare function generateDefaultConfig(): IcpProjectConfig;
+//# sourceMappingURL=environment.d.ts.map

package/dist/src/icp/environment.js

@@ -0,0 +1,183 @@
+/**
+ * Environment Manager
+ *
+ * Manages ICP environment configurations from icp.yaml files.
+ * Supports multiple environments (local, dev, staging, production)
+ * with independent settings for network, cycles, identity, and optimization.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import YAML from 'yaml';
+/**
+ * Default paths to search for icp.yaml configuration.
+ */
+const CONFIG_SEARCH_PATHS = [
+    'icp.yaml',
+    'icp.yml',
+    '.agentvault/icp.yaml',
+];
+/**
+ * Default environment configuration when nothing is specified.
+ */
+const DEFAULT_LOCAL_ENV = {
+    name: 'local',
+    network: { type: 'local' },
+    cycles: { initial: '100T' },
+};
+/**
+ * Default optimization settings.
+ */
+const DEFAULT_OPTIMIZATION = {
+    enabled: true,
+    level: 3,
+    shrink: true,
+    removeDebug: true,
+    wasmOptFlags: ['--O3', '--dce', '--strip-debug'],
+};
+/**
+ * Find the icp.yaml configuration file by walking up from a starting directory.
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Absolute path to icp.yaml, or null if not found
+ */
+export function findConfigFile(startDir) {
+    const searchDir = startDir ? path.resolve(startDir) : process.cwd();
+    // Check each search path in the starting directory
+    for (const relPath of CONFIG_SEARCH_PATHS) {
+        const fullPath = path.join(searchDir, relPath);
+        if (fs.existsSync(fullPath)) {
+            return fullPath;
+        }
+    }
+    // Walk up the directory tree
+    const parent = path.dirname(searchDir);
+    if (parent !== searchDir) {
+        return findConfigFile(parent);
+    }
+    return null;
+}
+/**
+ * Load and parse icp.yaml configuration.
+ *
+ * @param configPath - Path to icp.yaml (if null, will search for it)
+ * @returns Parsed configuration, or null if not found
+ */
+export function loadConfig(configPath) {
+    const resolvedPath = configPath ?? findConfigFile();
+    if (!resolvedPath || !fs.existsSync(resolvedPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(resolvedPath, 'utf-8');
+        const parsed = YAML.parse(content);
+        return parsed;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        throw new Error(`Failed to parse icp.yaml at ${resolvedPath}: ${message}`);
+    }
+}
+/**
+ * Get the configuration for a specific environment.
+ *
+ * Falls back to 'local' default if the environment is not defined.
+ *
+ * @param envName - Environment name
+ * @param config - Project configuration (will be loaded if not provided)
+ * @returns Environment configuration
+ */
+export function getEnvironment(envName, config) {
+    const projectConfig = config ?? loadConfig();
+    if (projectConfig?.environments) {
+        const envConfig = projectConfig.environments[envName];
+        if (envConfig) {
+            return envConfig;
+        }
+    }
+    // Return defaults for known environment names
+    if (envName === 'local') {
+        return DEFAULT_LOCAL_ENV;
+    }
+    // For 'ic' or 'mainnet', return a mainnet default
+    if (envName === 'ic' || envName === 'mainnet') {
+        return {
+            name: envName,
+            network: { type: 'ic' },
+            cycles: { initial: '1T' },
+        };
+    }
+    // Unknown environment - return local defaults with a type based on name
+    return DEFAULT_LOCAL_ENV;
+}
+/**
+ * Get the optimization configuration.
+ *
+ * @param config - Project configuration (will be loaded if not provided)
+ * @returns Optimization configuration
+ */
+export function getOptimizationConfig(config) {
+    const projectConfig = config ?? loadConfig();
+    return projectConfig?.optimization ?? DEFAULT_OPTIMIZATION;
+}
+/**
+ * List all defined environment names.
+ *
+ * @param config - Project configuration (will be loaded if not provided)
+ * @returns Array of environment names
+ */
+export function listEnvironments(config) {
+    const projectConfig = config ?? loadConfig();
+    if (projectConfig?.environments) {
+        return Object.keys(projectConfig.environments);
+    }
+    return ['local'];
+}
+/**
+ * Write an icp.yaml configuration file.
+ *
+ * @param config - Configuration to write
+ * @param outputPath - Path to write to (defaults to ./icp.yaml)
+ */
+export function writeConfig(config, outputPath) {
+    const targetPath = outputPath ?? path.join(process.cwd(), 'icp.yaml');
+    const content = YAML.stringify(config, { indent: 2 });
+    fs.writeFileSync(targetPath, content, 'utf-8');
+}
+/**
+ * Generate a default icp.yaml configuration.
+ *
+ * @returns Default project configuration with local, dev, staging, production environments
+ */
+export function generateDefaultConfig() {
+    return {
+        name: 'agentvault-project',
+        defaultEnvironment: 'local',
+        environments: {
+            local: {
+                name: 'local',
+                network: { type: 'local', replicaCount: 4 },
+                cycles: { initial: '100T' },
+            },
+            dev: {
+                name: 'dev',
+                network: { type: 'ic', replicaCount: 13 },
+                cycles: { initial: '1T' },
+                identity: 'dev-wallet',
+            },
+            staging: {
+                name: 'staging',
+                network: { type: 'ic', replicaCount: 28 },
+                cycles: { initial: '10T' },
+                identity: 'staging-wallet',
+            },
+            production: {
+                name: 'production',
+                network: { type: 'ic', replicaCount: 28 },
+                cycles: { initial: '100T' },
+                identity: 'main-wallet',
+            },
+        },
+        optimization: DEFAULT_OPTIMIZATION,
+    };
+}
+//# sourceMappingURL=environment.js.map

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

@@ -0,0 +1,204 @@
+/**
+ * icp-cli Wrapper
+ *
+ * TypeScript wrapper around the icp CLI tool (v0.1.0).
+ * The binary name is `icp` (not `icp-cli`).
+ *
+ * Provides typed interfaces for build, deploy, canister operations,
+ * cycles management, identity management, network management,
+ * token operations, sync, and environment queries.
+ */
+import type { IcpCliResult, IcpBuildOptions, IcpDeployOptions, IcpCanisterStatusOptions, IcpCanisterCallOptions, IcpCyclesBalanceOptions, IcpCyclesMintOptions, IcpCyclesTransferOptions, IcpIdentityListOptions, IcpIdentityNewOptions, IcpIdentityExportOptions, IcpIdentityImportOptions, IcpNetworkStartOptions, IcpNetworkStopOptions, IcpSyncOptions, IcpTokenBalanceOptions, IcpTokenTransferOptions, IcpEnvironmentListOptions, IcpCommonOptions } from './types.js';
+/**
+ * Build canisters using icp build.
+ *
+ * @param options - Build options
+ * @returns Command result
+ */
+export declare function build(options?: IcpBuildOptions): Promise<IcpCliResult>;
+/**
+ * Deploy project to an environment.
+ *
+ * @param options - Deploy options
+ * @returns Command result
+ */
+export declare function deploy(options?: IcpDeployOptions): Promise<IcpCliResult>;
+/**
+ * Get canister status.
+ *
+ * @param options - Canister status options
+ * @returns Command result with status in stdout
+ */
+export declare function canisterStatus(options: IcpCanisterStatusOptions): Promise<IcpCliResult>;
+/**
+ * Call a canister method.
+ *
+ * @param options - Canister call options
+ * @returns Command result with response in stdout
+ */
+export declare function canisterCall(options: IcpCanisterCallOptions): Promise<IcpCliResult>;
+/**
+ * List canisters in the project.
+ *
+ * @param options - Common options
+ * @returns Command result with canister list in stdout
+ */
+export declare function canisterList(options?: IcpCommonOptions): Promise<IcpCliResult>;
+/**
+ * Start a stopped canister.
+ *
+ * @param canister - Canister ID or name
+ * @param options - Common options
+ * @returns Command result
+ */
+export declare function canisterStart(canister: string, options?: IcpCommonOptions): Promise<IcpCliResult>;
+/**
+ * Stop a running canister.
+ *
+ * @param canister - Canister ID or name
+ * @param options - Common options
+ * @returns Command result
+ */
+export declare function canisterStop(canister: string, options?: IcpCommonOptions): Promise<IcpCliResult>;
+/**
+ * Delete a canister.
+ *
+ * @param canister - Canister ID or name
+ * @param options - Common options
+ * @returns Command result
+ */
+export declare function canisterDelete(canister: string, options?: IcpCommonOptions): Promise<IcpCliResult>;
+/**
+ * Check cycle balance of a canister.
+ *
+ * @param options - Cycles balance options
+ * @returns Command result with balance in stdout
+ */
+export declare function cyclesBalance(options: IcpCyclesBalanceOptions): Promise<IcpCliResult>;
+/**
+ * Mint cycles.
+ *
+ * @param options - Mint options
+ * @returns Command result
+ */
+export declare function cyclesMint(options: IcpCyclesMintOptions): Promise<IcpCliResult>;
+/**
+ * Transfer cycles to a canister.
+ *
+ * @param options - Transfer options
+ * @returns Command result
+ */
+export declare function cyclesTransfer(options: IcpCyclesTransferOptions): Promise<IcpCliResult>;
+/**
+ * List available identities.
+ *
+ * @param options - Common options
+ * @returns Command result with identity list in stdout
+ */
+export declare function identityList(options?: IcpIdentityListOptions): Promise<IcpCliResult>;
+/**
+ * Create a new identity.
+ *
+ * @param options - New identity options
+ * @returns Command result
+ */
+export declare function identityNew(options: IcpIdentityNewOptions): Promise<IcpCliResult>;
+/**
+ * Export an identity.
+ *
+ * @param options - Export options
+ * @returns Command result with PEM data in stdout
+ */
+export declare function identityExport(options: IcpIdentityExportOptions): Promise<IcpCliResult>;
+/**
+ * Import an identity from a PEM file.
+ *
+ * @param options - Import options
+ * @returns Command result
+ */
+export declare function identityImport(options: IcpIdentityImportOptions): Promise<IcpCliResult>;
+/**
+ * Get the principal of the current or named identity.
+ *
+ * @param options - Common options (use identity field to specify which identity)
+ * @returns Command result with principal in stdout
+ */
+export declare function identityPrincipal(options?: IcpCommonOptions): Promise<IcpCliResult>;
+/**
+ * Get the default identity name.
+ *
+ * @param options - Common options
+ * @returns Command result with default identity name in stdout
+ */
+export declare function identityDefault(options?: IcpCommonOptions): Promise<IcpCliResult>;
+/**
+ * Start a local test network.
+ *
+ * @param options - Network start options
+ * @returns Command result
+ */
+export declare function networkStart(options?: IcpNetworkStartOptions): Promise<IcpCliResult>;
+/**
+ * Stop a local test network.
+ *
+ * @param options - Network stop options
+ * @returns Command result
+ */
+export declare function networkStop(options?: IcpNetworkStopOptions): Promise<IcpCliResult>;
+/**
+ * Get network status.
+ *
+ * @param options - Common options
+ * @returns Command result with status in stdout
+ */
+export declare function networkStatus(options?: IcpCommonOptions): Promise<IcpCliResult>;
+/**
+ * List available networks.
+ *
+ * @param options - Common options
+ * @returns Command result with network list in stdout
+ */
+export declare function networkList(options?: IcpCommonOptions): Promise<IcpCliResult>;
+/**
+ * Ping a network to check connectivity.
+ *
+ * @param options - Common options
+ * @returns Command result
+ */
+export declare function networkPing(options?: IcpCommonOptions): Promise<IcpCliResult>;
+/**
+ * Synchronize canisters with the network.
+ *
+ * @param options - Sync options
+ * @returns Command result
+ */
+export declare function sync(options?: IcpSyncOptions): Promise<IcpCliResult>;
+/**
+ * Get token balance.
+ *
+ * @param options - Token balance options
+ * @returns Command result with balance in stdout
+ */
+export declare function tokenBalance(options?: IcpTokenBalanceOptions): Promise<IcpCliResult>;
+/**
+ * Transfer tokens.
+ *
+ * @param options - Token transfer options
+ * @returns Command result
+ */
+export declare function tokenTransfer(options: IcpTokenTransferOptions): Promise<IcpCliResult>;
+/**
+ * List project environments.
+ *
+ * @param options - Common options
+ * @returns Command result with environments in stdout
+ */
+export declare function environmentList(options?: IcpEnvironmentListOptions): Promise<IcpCliResult>;
+/**
+ * Show project information (effective YAML config).
+ *
+ * @param options - Common options
+ * @returns Command result with project info in stdout
+ */
+export declare function projectShow(options?: IcpCommonOptions): Promise<IcpCliResult>;
+//# sourceMappingURL=icpcli.d.ts.map