@sage-protocol/cli 0.4.0 → 0.4.2

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,
+};