@sage-protocol/cli 0.4.0 → 0.4.2

package/dist/cli/services/metaprompt/templates.json

@@ -0,0 +1,130 @@
+{
+  "coding-assistant": {
+    "key": "coding-assistant",
+    "name": "Coding Assistant",
+    "description": "An expert developer persona aware of your specific stack, testing frameworks, and project structure.",
+    "default_goal": "Write high-quality, tested, and idiomatic code following the project's established patterns.",
+    "planner_instructions": "Focus on extracting the user's technology stack (languages, frameworks), testing tools, preferred project structure (monorepo, folders), and specific coding conventions (linting, naming).",
+    "recommended_slots": [
+      {
+        "key": "tech_stack",
+        "label": "Technology Stack",
+        "description": "Languages, frameworks, and key libraries used in the project.",
+        "required": true,
+        "priority": 1,
+        "group": "context"
+      },
+      {
+        "key": "project_structure",
+        "label": "Project Structure",
+        "description": "How the codebase is organized (e.g., monorepo, src/ folders, conventions).",
+        "required": true,
+        "priority": 2,
+        "group": "constraints"
+      },
+      {
+        "key": "testing_framework",
+        "label": "Testing Framework",
+        "description": "Tools and patterns used for testing (e.g., Jest, Hardhat, Foundry).",
+        "required": false,
+        "priority": 3,
+        "group": "tools"
+      }
+    ],
+    "inject_tools": ["sage prompts", "sage project"]
+  },
+  "governance-helper": {
+    "key": "governance-helper",
+    "name": "Governance Helper",
+    "description": "A steward persona for drafting proposals, analyzing risk, and navigating DAO governance.",
+    "default_goal": "Assist in creating, reviewing, and executing governance proposals that align with DAO constraints.",
+    "planner_instructions": "Focus on the DAO's identity, risk parameters (conservative vs aggressive), voting thresholds, and required proposal formats.",
+    "recommended_slots": [
+      {
+        "key": "dao_name",
+        "label": "DAO Name",
+        "description": "The name and identity of the organization.",
+        "required": true,
+        "priority": 1,
+        "group": "identity"
+      },
+      {
+        "key": "risk_profile",
+        "label": "Risk Profile",
+        "description": "The DAO's tolerance for risk (e.g., conservative treasury management).",
+        "required": true,
+        "priority": 2,
+        "group": "constraints"
+      },
+      {
+        "key": "proposal_format",
+        "label": "Proposal Format",
+        "description": "Specific sections or templates required for proposals.",
+        "required": false,
+        "priority": 3,
+        "group": "output"
+      }
+    ],
+    "inject_tools": ["sage governance", "sage treasury"]
+  },
+  "research-analyst": {
+    "key": "research-analyst",
+    "name": "Research Analyst",
+    "description": "A data-focused persona for synthesizing information from subgraphs, specs, and documents.",
+    "default_goal": "Analyze provided data sources and synthesize clear, actionable reports.",
+    "planner_instructions": "Focus on the data sources available (Subgraphs, IPFS, APIs), the analytical lens (financial, technical, community), and the desired output format.",
+    "recommended_slots": [
+      {
+        "key": "data_sources",
+        "label": "Data Sources",
+        "description": "Where the agent should look for information (e.g., specific Subgraphs, docs).",
+        "required": true,
+        "priority": 1,
+        "group": "tools"
+      },
+      {
+        "key": "analytical_lens",
+        "label": "Analytical Lens",
+        "description": "The perspective to adopt when analyzing data (e.g., audit, growth, sentiment).",
+        "required": true,
+        "priority": 2,
+        "group": "role"
+      },
+      {
+        "key": "output_format",
+        "label": "Output Format",
+        "description": "The structure of the final report (e.g., executive summary, deep dive).",
+        "required": false,
+        "priority": 3,
+        "group": "output"
+      }
+    ],
+    "inject_tools": ["sage prompts"]
+  },
+  "custom": {
+    "key": "custom",
+    "name": "Custom Persona",
+    "description": "Build a persona from scratch for any domain.",
+    "default_goal": "Assist the user with their specific task.",
+    "planner_instructions": "Analyze the user's initial description to determine the most critical information gaps. Propose slots for Role, Goals, Constraints, and Output Format.",
+    "recommended_slots": [
+      {
+        "key": "role",
+        "label": "Role",
+        "description": "Who is the agent?",
+        "required": true,
+        "priority": 1,
+        "group": "identity"
+      },
+      {
+        "key": "goal",
+        "label": "Goal",
+        "description": "What is the agent trying to achieve?",
+        "required": true,
+        "priority": 1,
+        "group": "goals"
+      }
+    ],
+    "inject_tools": []
+  }
+}

package/dist/cli/services/project-context.js

@@ -0,0 +1,98 @@
+const path = require('path');
+const fs = require('fs');
+const config = require('../config');
+const ArtifactManager = require('./artifact-manager');
+
+class ProjectContextService {
+    constructor(cwd = process.cwd()) {
+        this.cwd = cwd;
+        this.config = config;
+        this.artifactManager = new ArtifactManager(cwd);
+    }
+
+    async getProjectContext() {
+        await this.artifactManager.initialize();
+
+        // Basic Project Info
+        const projectRoot = this.cwd;
+        const promptsDir = path.join(this.cwd, 'prompts');
+
+        // Load Sage Config
+        const profiles = this.config.readProfiles();
+        const activeProfile = profiles.profiles?.[profiles.activeProfile] || {};
+
+        // Load Workspace Config (.sage/workspace.json)
+        let workspaceConfig = {};
+        try {
+            const workspacePath = path.join(this.cwd, '.sage', 'workspace.json');
+            if (fs.existsSync(workspacePath)) {
+                workspaceConfig = JSON.parse(fs.readFileSync(workspacePath, 'utf8'));
+            }
+        } catch (e) {
+            // ignore
+        }
+
+        // Artifact Counts
+        const artifacts = await this.artifactManager.listArtifacts({});
+        const counts = {
+            promptCount: artifacts.filter(a => a.kind === 'prompt').length,
+            skillCount: artifacts.filter(a => a.kind === 'skill').length,
+            snippetCount: artifacts.filter(a => a.kind === 'snippet').length,
+            total: artifacts.length
+        };
+
+        // Libraries (from workspace config or local discovery)
+        // For now, just return what's in workspace config or empty
+        const libraries = workspaceConfig.libraries || [];
+
+        // Get addresses from profile
+        const addresses = activeProfile.addresses || {};
+
+        // Agent surfaces: where other tools expect configuration / rules
+        const agentSurfaces = {
+            cursorRulesDir: null,
+            claudeManifest: null,
+            copilotPromptsDir: null,
+            agentsFiles: [],
+        };
+
+        const cursorRulesDir = path.join(this.cwd, '.cursor', 'rules');
+        if (fs.existsSync(cursorRulesDir)) {
+            agentSurfaces.cursorRulesDir = '.cursor/rules';
+        }
+
+        const claudePath = path.join(this.cwd, 'CLAUDE.md');
+        if (fs.existsSync(claudePath)) {
+            agentSurfaces.claudeManifest = 'CLAUDE.md';
+        }
+
+        const copilotDir = path.join(this.cwd, '.github', 'prompts');
+        if (fs.existsSync(copilotDir)) {
+            agentSurfaces.copilotPromptsDir = '.github/prompts';
+        }
+
+        const agentsPath = path.join(this.cwd, 'AGENTS.md');
+        if (fs.existsSync(agentsPath)) {
+            agentSurfaces.agentsFiles.push('AGENTS.md');
+        }
+
+        return {
+            projectRoot,
+            promptsDir: 'prompts', // relative
+            subdao: addresses.SUBDAO || workspaceConfig.subdao || null,
+            registry: addresses.LIBRARY_REGISTRY || addresses.REGISTRY || workspaceConfig.registry || null,
+            network: process.env.SAGE_NETWORK || 'base-sepolia',
+            rpcUrl: activeProfile.rpcUrl || null,
+            workspace: counts,
+            libraries,
+            agentSurfaces,
+        };
+    }
+
+    // Backwards compatibility for any callers still using getContext()
+    async getContext() {
+        return this.getProjectContext();
+    }
+}
+
+module.exports = ProjectContextService;

package/dist/cli/subdao.js

@@ -7,9 +7,6 @@ const fs = require('fs');
 const path = require('path');
 const { resolveArtifact } = require('./utils/artifacts');
 
-// Load environment variables
-require('dotenv').config();
-
 class SubDAOManager {
     constructor() {
         this.provider = null;

package/dist/cli/sxxx-manager.js

@@ -5,7 +5,6 @@ const { resolveArtifact } = require('./utils/artifacts');
 const { withSpinner } = require('./utils/progress');
 const { waitForReceipt } = require('./utils/tx-wait');
 const cliConfig = require('./config');
-try { require('dotenv').config({ quiet: true }); } catch (_) {}
 
 // Simple color functions
 const colors = {

package/dist/cli/utils/aliases.js

@@ -106,12 +106,6 @@ const COMMAND_CATALOG = {
       ex: 'examples'
     }
   },
-  prompt: {
-    aliases: ['p'],
-    needsSubcommand: true,
-    subcommands: ['list', 'show', 'pull', 'push', 'publish', 'propose', 'doctor', 'run', 'test', 'preview', 'validate', 'compare', 'fork'],
-    subcommandAliases: { ls: 'list' }
-  },
   dev: {
     aliases: [],
     needsSubcommand: true,

package/dist/cli/utils/tx-wait.js

@@ -1,5 +1,3 @@
-try { require('dotenv').config({ quiet: true }); } catch (_) {}
-
 async function sleep(ms) { return new Promise(r => setTimeout(r, ms)); }
 
 /**
@@ -32,4 +30,3 @@ async function waitForReceipt(provider, txOrHash, timeoutMs, pollMs = 1500) {
 }
 
 module.exports = { waitForReceipt };
-

package/dist/cli/wallet-manager.js

@@ -10,7 +10,6 @@ let CDPWalletManager;
 try { CDPWalletManager = require('./cdp-wallet-manager'); } catch (_) { CDPWalletManager = null; }
 let WalletShared;
 try { WalletShared = require('@sage-protocol/wallet-manager'); } catch (_) { WalletShared = null; }
-try { require('dotenv').config({ quiet: true }); } catch (_) {}
 
 class WalletManager {
     constructor() {
@@ -37,7 +36,7 @@ class WalletManager {
             // NEVER auto-switch to private key based on env alone; require explicit insecure opt-in
             const insecurePk = shouldAllowInsecurePrivateKey();
             if (!insecurePk && (process.env.SAGE_PRIVATE_KEY || process.env.PRIVATE_KEY)) {
-                if (!process.env.SAGE_QUIET_JSON) {
+                if (!process.env.SAGE_QUIET_JSON && (process.env.SAGE_VERBOSE === '1')) {
                     console.warn('⚠️  SAGE_PRIVATE_KEY/PRIVATE_KEY detected but ignored.');
                     console.warn('    For safety, raw private keys are disabled by default.');
                     console.warn('    To enable, pass --insecure on wallet commands or set SAGE_INSECURE_PK=1.');
@@ -82,7 +81,7 @@ class WalletManager {
     }
 
     async connectMetaMask() {
-        if (!process.env.SAGE_QUIET_JSON) console.log('🔗 Connecting to MetaMask...');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('🔗 Connecting to MetaMask...');
         
         this.wallet = new MetaMaskIntegration();
         this.account = await this.wallet.connect();
@@ -90,11 +89,11 @@ class WalletManager {
         this.provider = this.wallet.getProvider();
         this.connected = true;
         
-        if (!process.env.SAGE_QUIET_JSON) console.log('✅ MetaMask connected successfully');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('✅ MetaMask connected successfully');
     }
 
     async connectWalletConnect() {
-        if (!process.env.SAGE_QUIET_JSON) console.log('🔗 Connecting via WalletConnect...');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('🔗 Connecting via WalletConnect...');
         if (WalletShared?.walletconnect?.fromWalletConnect && process.env.WALLETCONNECT_PROJECT_ID) {
             const wc = await WalletShared.walletconnect.fromWalletConnect({ projectId: process.env.WALLETCONNECT_PROJECT_ID, rpcUrl: process.env.RPC_URL, chainId: process.env.CHAIN_ID ? Number(process.env.CHAIN_ID) : undefined });
             const uri = wc.uri;
@@ -123,11 +122,11 @@ class WalletManager {
         this.signer = this.wallet.getSigner();
         this.provider = this.wallet.getProvider();
         this.connected = true;
-        if (!process.env.SAGE_QUIET_JSON) console.log('✅ WalletConnect connected successfully');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('✅ WalletConnect connected successfully');
     }
 
     async connectWeb3Auth() {
-        if (!process.env.SAGE_QUIET_JSON) console.log('🔗 Connecting with Web3Auth wallet...');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('🔗 Connecting with Web3Auth wallet...');
         if (WalletShared?.web3auth?.fromWeb3Auth && (process.env.WEB3AUTH_PRIVATE_KEY || process.env.WEB3AUTH_PK)) {
             const { signer, provider } = await WalletShared.web3auth.fromWeb3Auth({ rpcUrl: process.env.RPC_URL, privateKey: process.env.WEB3AUTH_PRIVATE_KEY || process.env.WEB3AUTH_PK, chainId: process.env.CHAIN_ID ? Number(process.env.CHAIN_ID) : undefined });
             this.signer = signer;
@@ -150,11 +149,11 @@ class WalletManager {
         this.signer = this.wallet.signer;
         this.provider = this.wallet.provider || (this.wallet.signer && this.wallet.signer.provider) || null;
         this.connected = true;
-        if (!process.env.SAGE_QUIET_JSON) console.log('✅ Web3Auth wallet connected successfully');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('✅ Web3Auth wallet connected successfully');
     }
 
     async connectPrivy() {
-        if (!process.env.SAGE_QUIET_JSON) console.log('🔗 Connecting with Privy wallet...');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('🔗 Connecting with Privy wallet...');
         const rpc = process.env.RPC_URL || process.env.BASE_SEPOLIA_RPC || process.env.BASE_RPC_URL || 'https://base-sepolia.publicnode.com';
         if (WalletShared?.privy?.fromPrivyDeterministic && process.env.PRIVY_EMAIL && process.env.PRIVY_PASSWORD) {
             const { signer, provider } = await WalletShared.privy.fromPrivyDeterministic({ rpcUrl: rpc, email: process.env.PRIVY_EMAIL, password: process.env.PRIVY_PASSWORD, chainId: process.env.CHAIN_ID ? Number(process.env.CHAIN_ID) : undefined });
@@ -182,11 +181,11 @@ class WalletManager {
         }
         this.connected = true;
         persistWalletContext({ config: this.config, account: this.account, type: 'privy' });
-        if (!process.env.SAGE_QUIET_JSON) console.log('✅ Privy wallet connected successfully');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('✅ Privy wallet connected successfully');
     }
 
     async connectCast() {
-        if (!process.env.SAGE_QUIET_JSON) console.log('🔗 Connecting with Cast wallet...');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('🔗 Connecting with Cast wallet...');
         
         this.wallet = new CastWalletManager();
         this.account = await this.wallet.connect();
@@ -194,11 +193,11 @@ class WalletManager {
         this.provider = this.wallet.getProvider();
         this.connected = true;
         
-        if (!process.env.SAGE_QUIET_JSON) console.log('✅ Cast wallet connected successfully');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('✅ Cast wallet connected successfully');
     }
 
     async connectCDP() {
-        if (!process.env.SAGE_QUIET_JSON) console.log('🔗 Connecting with CDP Embedded Wallet...');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('🔗 Connecting with CDP Embedded Wallet...');
         const rpc = process.env.RPC_URL || process.env.BASE_SEPOLIA_RPC || process.env.BASE_RPC_URL || 'https://base-sepolia.publicnode.com';
         if (WalletShared?.cdp?.fromCdp) {
             const { signer, provider } = await WalletShared.cdp.fromCdp({ rpcUrl: rpc, chainId: process.env.CHAIN_ID ? Number(process.env.CHAIN_ID) : undefined });
@@ -207,7 +206,7 @@ class WalletManager {
             try { this.account = await signer.getAddress(); } catch (_) { this.account = process.env.CDP_WALLET_ADDRESS || null; }
             this.connected = true;
             if (!this.account) throw new Error('Unable to determine CDP account address');
-            if (!process.env.SAGE_QUIET_JSON) console.log('✅ CDP wallet connected successfully');
+            if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('✅ CDP wallet connected successfully');
             return;
         }
         if (!CDPWalletManager) throw new Error('CDP wallet not available. Ensure cli/cdp-wallet-manager.js exists and dependencies are installed.');
@@ -216,11 +215,11 @@ class WalletManager {
         this.signer = this.wallet.getSigner();
         this.provider = this.wallet.getProvider();
         this.connected = true;
-        if (!process.env.SAGE_QUIET_JSON) console.log('✅ CDP wallet connected successfully');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('✅ CDP wallet connected successfully');
     }
 
     async connectPrivateKey() {
-        if (!process.env.SAGE_QUIET_JSON) console.log('🔗 Connecting with private key...');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('🔗 Connecting with private key...');
         
         const envPk = process.env.SAGE_PRIVATE_KEY || process.env.PRIVATE_KEY;
         if (!envPk) {
@@ -241,7 +240,7 @@ class WalletManager {
                 }
                 this.account = await this.signer.getAddress();
                 this.connected = true;
-                if (!process.env.SAGE_QUIET_JSON) {
+                if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') {
                     console.log('✅ Private key connected successfully:', this.account);
                     console.warn('⚠️  Insecure mode in use. Consider using Cast keystore: sage wallet import --mnemonic "..."');
                 }
@@ -289,7 +288,7 @@ class WalletManager {
                 const h = await checkRpcHealth(url, Number(process.env.SAGE_RPC_TIMEOUT_MS || 8000));
                 if (h.healthy) { rpc = url; break; }
             }
-            if (!process.env.SAGE_QUIET_JSON) console.log(`🌐 RPC: ${rpc}`);
+            if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log(`🌐 RPC: ${rpc}`);
         } catch (_) {}
         return rpc;
     }
@@ -464,7 +463,7 @@ class WalletManager {
         this.provider = null;
         this.wallet = null;
         
-        if (!process.env.SAGE_QUIET_JSON) console.log('✅ Wallet disconnected');
+        if (!process.env.SAGE_QUIET_JSON && process.env.SAGE_VERBOSE === '1') console.log('✅ Wallet disconnected');
     }
 
     isConnected() {

package/dist/cli/walletconnect-integration.js

@@ -1,7 +1,6 @@
 const { SignClient } = require('@walletconnect/sign-client');
 const { ethers } = require('ethers');
 const qrcode = require('qrcode-terminal');
-try { require('dotenv').config({ quiet: true }); } catch (_) {}
 
 // Custom Signer class for ethers.js v6 integration
 class WalletConnectSigner extends ethers.AbstractSigner {

package/dist/cli/wizard-manager.js

@@ -2,7 +2,6 @@
 const { spawn } = require('child_process');
 const { ethers } = require('ethers');
 const FactoryABI = require('./utils/factory-abi');
-try { require('dotenv').config({ quiet: true }); } catch (_) { }
 
 // Color functions for consistent styling
 const colors = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sage-protocol/cli",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Sage Protocol CLI for managing AI prompt libraries",
   "bin": {
     "sage": "./bin/sage.js"
@@ -33,11 +33,13 @@
     "build": "node scripts/build-cli.js"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.71.0",
     "@sage-protocol/contracts": "^0.1.0",
     "@sage-protocol/shared": "^0.1.0",
     "@sage-protocol/wallet-manager": "^0.1.0",
     "@whetstone-research/doppler-sdk": "^0.0.1-alpha.36",
     "keytar": "^7.9.0",
+    "openai": "^4.58.0",
     "qrcode-terminal": "^0.12.0",
     "update-notifier": "^6.0.2",
     "viem": "^2.33.2"

package/dist/cli/commands/prompt-test.js

@@ -1,176 +0,0 @@
-const { Command } = require('commander');
-const fs = require('fs');
-const path = require('path');
-const cliConfig = require('../config');
-const { getProvider } = require('../utils/cli-session');
-const { SageEchoExecutor } = require('@sage-protocol/sdk');
-
-function readJsonFile(filePath) {
-  const resolved = path.isAbsolute(filePath) ? filePath : path.join(process.cwd(), filePath);
-  const raw = fs.readFileSync(resolved, 'utf8');
-  return JSON.parse(raw);
-}
-
-function buildContext(options) {
-  if (options.contextFile) {
-    return readJsonFile(options.contextFile);
-  }
-  if (options.context) {
-    try {
-      return JSON.parse(options.context);
-    } catch (error) {
-      throw new Error(`Failed to parse --context JSON: ${error.message}`);
-    }
-  }
-  return {};
-}
-
-function resolveRegistry(passed) {
-  if (passed) return passed;
-
-  if (typeof cliConfig.readProfiles === 'function') {
-    const profiles = cliConfig.readProfiles();
-    const active = profiles.activeProfile || 'default';
-    const addresses = profiles.profiles?.[active]?.addresses || {};
-    if (addresses.PROMPT_REGISTRY_ADDRESS) return addresses.PROMPT_REGISTRY_ADDRESS;
-    if (addresses.LIBRARY_REGISTRY_ADDRESS) return addresses.LIBRARY_REGISTRY_ADDRESS;
-  }
-
-  return process.env.PROMPT_REGISTRY_ADDRESS || process.env.LIBRARY_REGISTRY_ADDRESS || null;
-}
-
-function formatResult(result) {
-  if (!result || typeof result !== 'object') return result;
-  const { prompt, response, request } = result;
-  return {
-    prompt,
-    request,
-    response,
-  };
-}
-
-const promptTest = new Command('test')
-  .description('Execute a prompt from the registry via Echo')
-  .argument('<promptKey>', 'Key of the prompt stored in the registry')
-  .option('-r, --registry <address>', 'Prompt registry address (defaults to configured LIBRARY_REGISTRY_ADDRESS)')
-  .option('-g, --gateway <url>', 'IPFS gateway to fetch prompt content', process.env.SAGE_IPFS_GATEWAY)
-  .option('-m, --model <model>', 'Echo model to use (defaults to gpt-4o-mini or $ECHO_MODEL)', process.env.ECHO_MODEL)
-  .option('--user <text>', 'User message to send alongside the prompt template')
-  .option('--temperature <float>', 'Sampling temperature (e.g. 0.2)')
-  .option('--max-tokens <int>', 'Maximum number of tokens to generate')
-  .option('--top-p <float>', 'Top-p nucleus sampling value (0-1)')
-  .option('--context <json>', 'Inline JSON payload passed to the prompt execution context')
-  .option('--context-file <path>', 'Path to JSON file used as execution context')
-  .option('--json', 'Emit raw JSON response only')
-  .action(async (promptKey, options) => {
-    try {
-      if (typeof cliConfig.loadEnv === 'function') {
-        try { cliConfig.loadEnv(); } catch (_) {}
-      }
-
-      // Read-only execution: only a provider is required
-      const provider = await getProvider({ preferWallet: true });
-      const registry = resolveRegistry(options.registry);
-      if (!registry) {
-        throw new Error('Prompt registry address not configured. Provide --registry or import addresses via `sage config addresses import`.');
-      }
-
-      const echoApiKey = process.env.ECHO_API_KEY;
-      const echoAppId = process.env.ECHO_APP_ID || process.env.NEXT_PUBLIC_ECHO_APP_ID;
-
-      if (!echoApiKey) {
-        throw new Error('ECHO_API_KEY is not set. Create an Echo API key in the Echo dashboard and export it before running this command.');
-      }
-
-      const context = buildContext(options);
-
-      if (process.env.SAGE_DEBUG_PROMPT_TEST === '1') {
-        console.log('[debug] context loaded, initializing executor');
-      }
-
-      const executor = new SageEchoExecutor(provider, null, {
-        registry,
-        ipfsGateway: options.gateway,
-        apiKey: echoApiKey,
-        appId: echoAppId,
-        model: options.model,
-        routerUrl: process.env.ECHO_ROUTER_URL,
-      });
-
-      const execOptions = {
-        registry,
-        ipfsGateway: options.gateway,
-        model: options.model,
-        userMessage: options.user,
-      };
-
-      if (typeof options.temperature !== 'undefined') {
-        const temp = Number(options.temperature);
-        if (Number.isNaN(temp)) {
-          throw new Error('Temperature must be a number.');
-        }
-        execOptions.temperature = temp;
-      }
-      if (typeof options.maxTokens !== 'undefined') {
-        const maxTokens = parseInt(options.maxTokens, 10);
-        if (Number.isNaN(maxTokens)) {
-          throw new Error('max-tokens must be an integer.');
-        }
-        execOptions.maxTokens = maxTokens;
-      }
-      if (typeof options.topP !== 'undefined') {
-        const topP = Number(options.topP);
-        if (Number.isNaN(topP)) {
-          throw new Error('top-p must be a number.');
-        }
-        execOptions.topP = topP;
-      }
-
-      const result = await executor.executePrompt(promptKey, context, execOptions);
-
-      if (process.env.SAGE_DEBUG_PROMPT_TEST === '1') {
-        console.log('[debug] execution complete');
-      }
-      const payload = formatResult(result);
-      const { response } = payload;
-      const raw = response?.raw || null;
-      const firstChoice = Array.isArray(raw?.choices) ? raw.choices[0] : null;
-      const completionText =
-        response?.text ||
-        firstChoice?.message?.content ||
-        firstChoice?.text ||
-        null;
-      const usage = response?.usage || raw?.usage || null;
-      const modelUsed = raw?.model || response?.model || execOptions.model || process.env.ECHO_MODEL || 'gpt-4o-mini';
-      const responseId = raw?.id || response?.id || null;
-
-      if (options.json || process.env.SAGE_QUIET_JSON === '1') {
-        console.log(JSON.stringify(payload, null, 2));
-      } else {
-        console.log('✅ Echo prompt execution succeeded');
-        console.log(`Model: ${modelUsed}`);
-        if (usage) {
-          console.log(`Tokens — prompt: ${usage.prompt_tokens ?? 'n/a'}, completion: ${usage.completion_tokens ?? 'n/a'}, total: ${usage.total_tokens ?? 'n/a'}`);
-        }
-        if (responseId) {
-          console.log(`Response ID: ${responseId}`);
-        }
-        if (completionText) {
-          console.log('\n--- Assistant Response ---\n');
-          console.log(completionText);
-          console.log('\n--------------------------');
-        } else {
-          console.log('\n(No assistant message returned — inspect JSON output for details)');
-        }
-      }
-    } catch (error) {
-      if (options.json || process.env.SAGE_QUIET_JSON === '1') {
-        console.error(JSON.stringify({ error: error.message, code: error.code || null }));
-      } else {
-        console.error(`❌ Failed to execute prompt: ${error.message}`);
-      }
-      process.exitCode = 1;
-    }
-  });
-
-module.exports = promptTest;