@sage-protocol/cli 0.4.0 → 0.4.1

package/dist/cli/browser-wallet-integration.js

@@ -1,5 +1,4 @@
 const { ethers } = require('ethers');
-try { require('dotenv').config({ quiet: true }); } catch (_) {}
 
 class BrowserWalletIntegration {
     constructor(deps = {}) {

package/dist/cli/cast-wallet-manager.js

@@ -4,7 +4,6 @@ const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
 const os = require('os');
-try { require('dotenv').config({ quiet: true }); } catch (_) {}
 
 // Simple color functions to replace chalk
 const colors = {

package/dist/cli/commands/interview.js

@@ -0,0 +1,149 @@
+const { Command } = require('commander');
+const readline = require('readline');
+const InterviewDriver = require('../services/metaprompt/interview-driver');
+const MetapromptPersistence = require('../services/metaprompt/persistence');
+const config = require('../config');
+const templates = require('../services/metaprompt/templates.json');
+
+function register(program) {
+  program
+    .command('interview')
+    .description('Create a new AI persona via an interactive interview')
+    .alias('persona')
+    .option('-t, --template <key>', 'Persona template (coding-assistant, governance-helper, research-analyst, custom)', 'custom')
+    .option('-g, --goal <description>', 'Initial goal or description to seed the interview')
+    .option('-p, --provider <name>', 'AI provider (anthropic, openai)')
+    .option('-m, --model <name>', 'Specific model name')
+    .option('-k, --api-key <key>', 'API key override')
+    .option('--save-key <name>', 'Name for the generated skill file (defaults to template name + timestamp)')
+    .option('--list-templates', 'List available persona templates and exit')
+    .action(async (options) => {
+      if (options.listTemplates) {
+        listTemplates();
+        return;
+      }
+      await runInterview(options);
+    });
+}
+
+function listTemplates() {
+  console.log('\nAvailable Persona Templates:\n');
+  for (const [key, tmpl] of Object.entries(templates)) {
+    console.log(`  ${key}`);
+    console.log(`    ${tmpl.description}`);
+    console.log(`    Default goal: ${tmpl.default_goal}`);
+    console.log('');
+  }
+  console.log('Usage: sage interview --template <key>');
+}
+
+async function runInterview(options) {
+  // 1. Check Config
+  const aiConfig = config.readAIConfig();
+  if (!aiConfig.anthropicApiKey && !aiConfig.openaiApiKey && !options.apiKey) {
+    console.log('⚠️  No AI keys found.');
+    console.log('Please run `sage config ai set --provider anthropic --key sk-...`');
+    console.log('Or provide --api-key and --provider flags.');
+    process.exit(1);
+  }
+
+  // 2. Select Template
+  let templateKey = options.template;
+  if (!templates[templateKey]) {
+    console.warn(`⚠️  Template '${templateKey}' not found. Falling back to 'custom'.`);
+    console.log('Use --list-templates to see available templates.\n');
+    templateKey = 'custom';
+  }
+  const template = templates[templateKey];
+
+  console.log(`\n🎤 Starting Interview: ${template.name}`);
+  console.log(`ℹ️  ${template.description}`);
+  if (options.goal) {
+    console.log(`📝 Initial context: "${options.goal}"`);
+  }
+  console.log('\nType /quit to abort the interview.\n');
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  // 3. Initialize Driver with initial description from --goal
+  const driver = new InterviewDriver(config, {
+    templateKey,
+    initialDescription: options.goal || '',
+    provider: options.provider,
+    model: options.model,
+    apiKey: options.apiKey
+  });
+
+  console.log('🔄 Planning session...');
+  await driver.init();
+
+  // Show which slots were pre-filled from the goal
+  const preFilledCount = Object.keys(driver.answers).length;
+  if (preFilledCount > 0) {
+    console.log(`✅ Pre-filled ${preFilledCount} slot(s) from your initial context.`);
+  }
+
+  // 4. Interview Loop
+  while (true) {
+    const question = await driver.getNextQuestion();
+
+    if (!question) {
+      console.log('\n✅ Interview complete! Generating persona...');
+      break;
+    }
+
+    // Show progress
+    const filled = Object.keys(driver.answers).length;
+    const total = driver.slots.length;
+    const progress = `[${filled}/${total}]`;
+
+    // Ask
+    const answer = await new Promise(resolve => {
+      rl.question(`\n${progress} 🤖 ${question}\n> `, resolve);
+    });
+
+    if (!answer.trim()) {
+      console.log('(Skipping...)');
+      continue;
+    }
+
+    if (answer.trim().toLowerCase() === '/quit') {
+      console.log('⚠️  Interview aborted.');
+      rl.close();
+      process.exit(0);
+    }
+
+    await driver.processAnswer(answer);
+  }
+
+  rl.close();
+
+  // 5. Generate and Save
+  const systemPrompt = driver.generateSystemPrompt();
+  const persistence = new MetapromptPersistence(config);
+
+  const slug = options.saveKey || `${templateKey}-${Date.now().toString().slice(-6)}`;
+
+  // Save Artifacts
+  const paths = persistence.saveMetaprompt(slug, {
+    templateKey,
+    transcript: driver.transcript,
+    answers: driver.answers
+  });
+
+  // Save Skill
+  const skillPath = persistence.saveSkill(slug, systemPrompt);
+  persistence.appendToAgentsList(slug);
+
+  console.log(`\n🎉 Persona Created: ${slug}`);
+  console.log(`   📄 Skill: ${skillPath}`);
+  console.log(`   📝 History: ${paths.metaprompt}`);
+  console.log(`\nNext Steps:`);
+  console.log(`   sage prompts list-workspace-skills`);
+  console.log(`   sage prompts export skills/${slug} --as cursor`);
+}
+
+module.exports = { register };

package/dist/cli/commands/personal.js

@@ -94,13 +94,134 @@ function resolveGateway(pref) {
 }
 
 function resolveSubgraphUrl(override) {
-  return override
-    || process.env.SUBGRAPH_URL
-    || process.env.NEXT_PUBLIC_GRAPH_ENDPOINT
-    || process.env.NEXT_PUBLIC_SUBGRAPH_URL
-    || null;
+  if (override) return override;
+
+  // Prefer profile-configured subgraph URLs (addresses) over raw env
+  try {
+    const profiles = ConfigManager.readProfiles();
+    const active = profiles.activeProfile || 'default';
+    const profile = profiles.profiles?.[active] || {};
+    const addresses = profile.addresses || {};
+    const fromProfile = addresses.SAGE_SUBGRAPH_URL || addresses.SUBGRAPH_URL;
+    if (fromProfile && typeof fromProfile === 'string') {
+      return fromProfile;
+    }
+  } catch (_) {
+    // fall through to env-based resolution
+  }
+
+  return (
+    process.env.SAGE_SUBGRAPH_URL ||
+    process.env.SUBGRAPH_URL ||
+    process.env.NEXT_PUBLIC_GRAPH_ENDPOINT ||
+    process.env.NEXT_PUBLIC_SUBGRAPH_URL ||
+    null
+  );
 }
 
+// Centralised subgraph queries for personal marketplace flows
+const PERSONAL_LISTINGS_QUERY = `
+  query($creator: Bytes!, $first: Int!) {
+    personalListings(
+      where: { creator: $creator, listed: true }
+      first: $first
+      orderBy: updatedAt
+      orderDirection: desc
+    ) {
+      id
+      creator
+      key
+      price
+      listed
+      createdAt
+      updatedAt
+    }
+  }
+`;
+
+const PERSONAL_PURCHASES_QUERY = `
+  query($creator: Bytes!, $first: Int!) {
+    licensePurchases(
+      where: { creator: $creator }
+      first: $first
+      orderBy: blockTimestamp
+      orderDirection: desc
+    ) {
+      key
+      price
+      receiptId
+      buyer
+      blockTimestamp
+      encryptedCid
+      metadata
+    }
+  }
+`;
+
+const PERSONAL_RESOURCES_BY_RECEIPT_QUERY = `
+  query($ids: [BigInt!]) {
+    personalResources(
+      where: { receiptId_in: $ids }
+      first: 200
+      orderBy: recordedAt
+      orderDirection: desc
+    ) {
+      key
+      receiptId
+      encryptedCid
+      metadata
+      recordedAt
+    }
+  }
+`;
+
+const MY_LICENSES_QUERY = `
+  query($holder: Bytes!, $first: Int!) {
+    receiptBalances(
+      where: { holder: $holder, balance_gt: 0 }
+      first: $first
+      orderBy: updatedAt
+      orderDirection: desc
+    ) {
+      receiptId
+      balance
+      updatedAt
+    }
+    licensePurchases(
+      where: { buyer: $holder }
+      first: $first
+      orderBy: blockTimestamp
+      orderDirection: desc
+    ) {
+      creator
+      key
+      price
+      netToCreator
+      fee
+      receiptId
+      blockTimestamp
+      encryptedCid
+      metadata
+    }
+  }
+`;
+
+const PERSONAL_RESOURCES_FOR_BALANCES_QUERY = `
+  query($ids: [BigInt!]) {
+    personalResources(
+      where: { receiptId_in: $ids }
+      first: 100
+      orderBy: recordedAt
+      orderDirection: desc
+    ) {
+      receiptId
+      encryptedCid
+      metadata
+      recordedAt
+    }
+  }
+`;
+
 async function createAction(opts) {
   const provider = await getProvider();
   const wallet = await getWallet(provider);
@@ -436,21 +557,8 @@ async function listAction(opts = {}) {
 
   if (!explicitKeys.length && subgraphUrl) {
     // First try to get all listings (PriceSet events)
-    const listingsQuery = `
-      query($creator: Bytes!, $first: Int!) {
-        personalListings(where: { creator: $creator, listed: true }, first: $first, orderBy: updatedAt, orderDirection: desc) {
-          id
-          creator
-          key
-          price
-          listed
-          createdAt
-          updatedAt
-        }
-      }
-    `;
     try {
-      const listingsData = await subgraphQuery(subgraphUrl, listingsQuery, {
+      const listingsData = await subgraphQuery(subgraphUrl, PERSONAL_LISTINGS_QUERY, {
         creator: creatorAddress.toLowerCase(),
         first: limit,
       });
@@ -476,21 +584,8 @@ async function listAction(opts = {}) {
     }
 
     // Also fetch purchases for additional metadata
-    const purchasesQuery = `
-      query($creator: Bytes!, $first: Int!) {
-        licensePurchases(where: { creator: $creator }, first: $first, orderBy: blockTimestamp, orderDirection: desc) {
-          key
-          price
-          receiptId
-          buyer
-          blockTimestamp
-          encryptedCid
-          metadata
-        }
-      }
-    `;
     try {
-      const data = await subgraphQuery(subgraphUrl, purchasesQuery, {
+      const data = await subgraphQuery(subgraphUrl, PERSONAL_PURCHASES_QUERY, {
         creator: creatorAddress.toLowerCase(),
         first: limit,
       });
@@ -524,18 +619,7 @@ async function listAction(opts = {}) {
         .filter(Boolean);
 
       if (receiptIdsForResources.length) {
-        const resQuery = `
-          query($ids: [BigInt!]) {
-            personalResources(where: { receiptId_in: $ids }, first: 200, orderBy: recordedAt, orderDirection: desc) {
-              key
-              receiptId
-              encryptedCid
-              metadata
-              recordedAt
-            }
-          }
-        `;
-        const resData = await subgraphQuery(subgraphUrl, resQuery, { ids: receiptIdsForResources });
+        const resData = await subgraphQuery(subgraphUrl, PERSONAL_RESOURCES_BY_RECEIPT_QUERY, { ids: receiptIdsForResources });
         personalResourceMap = new Map((resData?.personalResources || []).map((r) => {
           const keyHash = String(r.key);
           const receiptId = r.receiptId ? String(r.receiptId) : '';
@@ -640,33 +724,12 @@ async function myLicensesAction(opts = {}) {
   const holderAddress = opts.holder ? getAddress(opts.holder) : getAddress(await wallet.getAddress());
   const subgraphUrl = resolveSubgraphUrl(opts.subgraph);
   if (!subgraphUrl) {
-    throw new Error('Subgraph URL not configured. Pass --subgraph or set SUBGRAPH_URL.');
+    throw new Error('Subgraph URL not configured. Pass --subgraph or configure SUBGRAPH_URL/SAGE_SUBGRAPH_URL via sage config addresses/import.');
   }
 
   const limit = opts.limit ? Math.max(1, parseInt(opts.limit, 10)) : DEFAULT_LIST_LIMIT;
 
-  const document = `
-    query($holder: Bytes!, $first: Int!) {
-      receiptBalances(where: { holder: $holder, balance_gt: 0 }, first: $first, orderBy: updatedAt, orderDirection: desc) {
-        receiptId
-        balance
-        updatedAt
-      }
-      licensePurchases(where: { buyer: $holder }, first: $first, orderBy: blockTimestamp, orderDirection: desc) {
-        creator
-        key
-        price
-        netToCreator
-        fee
-        receiptId
-        blockTimestamp
-        encryptedCid
-        metadata
-      }
-    }
-  `;
-
-  const data = await subgraphQuery(subgraphUrl, document, {
+  const data = await subgraphQuery(subgraphUrl, MY_LICENSES_QUERY, {
     holder: holderAddress.toLowerCase(),
     first: limit,
   });
@@ -680,16 +743,7 @@ async function myLicensesAction(opts = {}) {
 
   let resourceByReceipt = new Map();
   if (balanceIds.length) {
-    const enriched = await subgraphQuery(subgraphUrl, `
-      query($ids: [BigInt!]) {
-        personalResources(where: { receiptId_in: $ids }, first: 100, orderBy: recordedAt, orderDirection: desc) {
-          receiptId
-          encryptedCid
-          metadata
-          recordedAt
-        }
-      }
-    `, { ids: balanceIds });
+    const enriched = await subgraphQuery(subgraphUrl, PERSONAL_RESOURCES_FOR_BALANCES_QUERY, { ids: balanceIds });
     resourceByReceipt = new Map((enriched?.personalResources || []).map((res) => [String(res.receiptId), res]));
   }
 
@@ -1216,7 +1270,12 @@ function register(program) {
   cmd.addCommand(premium);
 }
 
-module.exports = { register };
 const { query: subgraphQuery } = sdk.subgraph;
 
 const DEFAULT_LIST_LIMIT = 25;
+
+module.exports = {
+  register,
+  // exposed for unit tests
+  resolveSubgraphUrl,
+};

package/dist/cli/commands/stake-status.js

@@ -12,8 +12,6 @@ function register(program) {
       const WalletManager = require('@sage-protocol/wallet-manager');
       const { resolveGovContext } = require('../utils/gov-context');
       
-      // Load environment
-      require('dotenv').config();
       const rpcUrl = process.env.RPC_URL || process.env.BASE_SEPOLIA_RPC || 'https://base-sepolia.publicnode.com';
       const provider = new ethers.JsonRpcProvider(rpcUrl);
       

package/dist/cli/config.js

@@ -32,6 +32,15 @@ function collectAliasKeys(key) {
   return ADDRESS_ALIAS_MAP.get(upper) || [upper];
 }
 
+function isVerbose() {
+  return (
+    process.env.SAGE_VERBOSE === '1' ||
+    process.env.VERBOSE === 'true' ||
+    process.env.DEBUG === '*' ||
+    process.env.DEBUG === 'sage'
+  );
+}
+
 function isQuiet() {
   return (
     process.env.SAGE_SUPPRESS_CONFIG_LOGS === '1' ||
@@ -285,13 +294,14 @@ function createLocalConfig() {
 
     loadEnv() {
       const envPath = path.join(this.projectDir, '.env');
+      const quietJson = String(process.env.SAGE_QUIET_JSON || '').trim() === '1';
       if (fs.existsSync(envPath)) {
         const override = process.env.SAGE_CLI_TEST_MODE === '1' ? false : true;
         try {
           require('dotenv').config({ path: envPath, override, quiet: true });
         } catch (_) {}
-        if (!isQuiet()) console.log('📁 Loaded .env from project directory');
-      } else if (!isQuiet()) {
+        if (isVerbose() && !quietJson) console.log('📁 Loaded .env from project directory');
+      } else if (isVerbose() && !quietJson) {
         console.log('⚠️  .env file not found in project directory');
       }
 
@@ -327,9 +337,9 @@ function createLocalConfig() {
             process.env.GITHUB_TOKEN = git.githubToken;
           }
         }
-        if (!isQuiet()) console.log(`🧭 Loaded config profile: ${active}`);
+        if (isVerbose() && !quietJson) console.log(`🧭 Loaded config profile: ${active}`);
       } catch (e) {
-        console.log('⚠️  Failed to load config profile:', e.message);
+        if (isVerbose() && !quietJson) console.log('⚠️  Failed to load config profile:', e.message);
       }
       return true;
     },
@@ -524,13 +534,19 @@ function createLocalConfig() {
     },
 
     getWalletConfig() {
-      console.log('🔍 getWalletConfig called');
+      const verbose = process.env.SAGE_VERBOSE === '1';
+      const quietJson = String(process.env.SAGE_QUIET_JSON || '').trim() === '1';
+      if (verbose && !quietJson) {
+        console.log('🔍 getWalletConfig called');
+      }
       try {
         const profiles = this.readProfiles();
         const activeProfile = profiles.activeProfile || 'default';
         const profile = profiles.profiles?.[activeProfile];
         const walletType = (profile?.wallet?.type || 'cast').toLowerCase();
-        console.log('🔍 Debug: walletType =', walletType, 'defaultAccount =', profile?.wallet?.defaultAccount);
+        if (verbose && !quietJson) {
+          console.log('🔍 Debug: walletType =', walletType, 'defaultAccount =', profile?.wallet?.defaultAccount);
+        }
         const defaultAccount = profile?.wallet?.defaultAccount;
         if (walletType === 'cast' && defaultAccount) {
           return { type: 'cast', account: defaultAccount, castFlag: `--from ${defaultAccount}` };
@@ -547,10 +563,14 @@ function createLocalConfig() {
         }
         if (walletType === 'privy' && defaultAccount) return { type: 'privy', account: defaultAccount, castFlag: '' };
         if (walletType === 'web3auth' && defaultAccount) return { type: 'web3auth', account: defaultAccount, castFlag: '' };
-        console.log('⚠️  No default account configured. Using deployment-wallet. Set with: sage wallet use <address>');
+        if (!quietJson) {
+          console.log('⚠️  No default account configured. Using deployment-wallet. Set with: sage wallet use <address>');
+        }
         return { type: walletType, account: defaultAccount || 'deployment-wallet', castFlag: walletType === 'cast' ? '--account deployment-wallet' : '' };
       } catch (e) {
-        console.log('⚠️  Failed to load wallet config:', e.message);
+        if (String(process.env.SAGE_QUIET_JSON || '').trim() !== '1') {
+          console.log('⚠️  Failed to load wallet config:', e.message);
+        }
         return { type: 'cast', account: 'deployment-wallet', castFlag: '--account deployment-wallet' };
       }
     },

package/dist/cli/governance-manager.js

@@ -1,6 +1,5 @@
 const { ethers } = require('ethers');
 const { resolveArtifact } = require('./utils/artifacts');
-try { require('dotenv').config({ quiet: true }); } catch (_) {}
 let colors; try { colors = (require('chalk').default || require('chalk')); } catch (e) { colors = { blue: (s)=>s, green: (s)=>s, red: (s)=>s, yellow: (s)=>s, cyan: (s)=>s }; }
 const fs = require('fs');
 const path = require('path');
@@ -1284,6 +1283,8 @@ class GovernanceManager {
     }
  
     async executeProposal(id, opts = {}) {
+        const verbose = process.env.SAGE_VERBOSE === '1';
+        const quietJson = String(process.env.SAGE_QUIET_JSON || '').trim() === '1';
         try {
             const { simulate } = opts;
             if (simulate) {
@@ -1352,19 +1353,23 @@ class GovernanceManager {
                             throw new Error('Cached tuple has mismatched array lengths');
                         }
                         const descriptionHash = ethers.keccak256(ethers.toUtf8Bytes(description));
-                        console.log('🔎 Using cached proposal tuple for execute');
-                        console.log('  targets:', targets);
-                        console.log('  values:', values.map(v => v.toString()));
-                        console.log('  calldatas:', calldatas);
-                        console.log('  descriptionHash:', descriptionHash);
+                        if (!quietJson) {
+                            console.log('🔎 Using cached proposal tuple for execute');
+                            if (verbose) {
+                                console.log('  targets:', targets);
+                                console.log('  values:', values.map(v => v.toString()));
+                                console.log('  calldatas:', calldatas);
+                                console.log('  descriptionHash:', descriptionHash);
+                            }
+                        }
                         // Optional: verify readiness
                         try {
                             const st = await this.governor.state(this.normalizeProposalId(proposalId));
                             const nm = this.getStateName(st);
                             let eta = 0n;
                             try { eta = await this.governor.proposalEta(this.normalizeProposalId(proposalId)); } catch {}
-                            if (eta && eta > 0n) console.log(`🔍 Debug: ETA=${eta.toString()}`);
-                            console.log(`🔍 Debug: Proposal state: ${nm} (${st})`);
+                            if (verbose && !quietJson && eta && eta > 0n) console.log(`🔍 Debug: ETA=${eta.toString()}`);
+                            if (verbose && !quietJson) console.log(`🔍 Debug: Proposal state: ${nm} (${st})`);
                         } catch {}
                         
                         if (simulate) {
@@ -1447,7 +1452,9 @@ class GovernanceManager {
             
             // Fallback: if no indexed events found, try broader query
             if (!logs.length) {
-                console.log('Debug - No indexed events found, trying all ProposalCreated events...');
+                if (verbose && !quietJson) {
+                    console.log('Debug - No indexed events found, trying all ProposalCreated events...');
+                }
                 const allLogs = await this.provider.getLogs({
                     topics: [eventSig],
                     address: governorAddr,
@@ -1508,26 +1515,28 @@ class GovernanceManager {
             // Compute descriptionHash exactly like the working script
             const descriptionHash = ethers.keccak256(ethers.toUtf8Bytes(description));
             
-            console.log('Governor:', governorAddr);
-            console.log('Executing with:');
-            console.log('  targets:', targets);
-            console.log('  values:', values.map(v => v.toString()));
-            console.log('  calldatas[0..]:', calldatas.length);
-            console.log('  descriptionHash:', descriptionHash);
+            if (verbose && !quietJson) {
+                console.log('Governor:', governorAddr);
+                console.log('Executing with:');
+                console.log('  targets:', targets);
+                console.log('  values:', values.map(v => v.toString()));
+                console.log('  calldatas[0..]:', calldatas.length);
+                console.log('  descriptionHash:', descriptionHash);
+            }
             
             // Check proposal state before executing
-            console.log('🔍 Debug: Checking proposal state...');
+            if (verbose && !quietJson) console.log('🔍 Debug: Checking proposal state...');
             const state = await this.governor.state(this.normalizeProposalId(id));
             const stateNum = Number(state);
             const stateName = this.getStateName(stateNum);
-            console.log(`🔍 Debug: Proposal state: ${stateName} (${stateNum})`);
+            if (verbose && !quietJson) console.log(`🔍 Debug: Proposal state: ${stateName} (${stateNum})`);
             
             if (stateNum !== 4) { // 4 = Succeeded
                 console.log(`⚠️  Warning: Proposal is in state ${stateName}, not Succeeded. Execution may fail.`);
             }
             
             // Execute using tuple (like the working script)
-            console.log('🔍 Debug: Executing proposal...');
+            if (verbose && !quietJson) console.log('🔍 Debug: Executing proposal...');
             try {
                 const tx = await this.governor.execute(targets, values, calldatas, descriptionHash);
                 console.log('⏳ Waiting for transaction confirmation...');
@@ -1559,7 +1568,7 @@ class GovernanceManager {
             
             // Check for LibraryUpdated events if this was a library proposal
             if (this.currentSubDAO) {
-                console.log('🔍 Debug: Checking for LibraryUpdated events...');
+                if (verbose && !quietJson) console.log('🔍 Debug: Checking for LibraryUpdated events...');
                 try {
                     const { resolveRegistryAddress } = require('./utils/address-resolution');
                     const registryAddress = resolveRegistryAddress().registry;