phewsh 0.11.16 → 0.12.0

package/README.md

@@ -65,9 +65,26 @@ phewsh login              # Authenticate + set API key
 phewsh push               # Sync local .intent/ to cloud
 phewsh pull               # Sync cloud to local
 phewsh mcp setup          # Configure MCP server for agent connectivity
+phewsh mcp serve          # Coordination bridge — route work to live agents
+phewsh receipts           # Proof trail — what agents actually did, with evidence
 phewsh style              # Build your style identity
 ```
 
+## Receipts
+
+Every task that runs through PHEWSH leaves evidence on your machine —
+sessions, results, blockers, gate checks, spend — in `~/.phewsh/`. See it:
+
+```bash
+phewsh receipts           # merged timeline, newest first
+phewsh receipts --json    # machine-readable, for agents and scripts
+```
+
+The same trail is visible at [phewsh.com/intent/receipts](https://phewsh.com/intent/receipts)
+while a local bridge is running (`phewsh serve` or `phewsh mcp serve` — the
+first executes tasks directly via Claude Code, the second routes them to
+live connected agents; both record identical receipts).
+
 ## Sync
 
 CLI and web ([phewsh.com/intent](https://phewsh.com/intent)) share the same cloud via Supabase.

package/bin/phewsh.js

@@ -60,8 +60,10 @@ const COMMANDS = {
   context: () => require('../commands/context'),
   gate:    () => require('../commands/gate'),
   sap:     () => require('../commands/sap'),
+  browse:  () => require('../commands/browse'),
   watch:   () => require('../commands/watch')(),
   mcp:     () => require('../commands/mcp')(),
+  receipts: () => require('../commands/receipts')(),
   serve:   () => require('../commands/serve')(),
   sequence: () => require('../commands/sequence')(),
   seq:     () => require('../commands/sequence')(),
@@ -87,7 +89,8 @@ function showHelp() {
   console.log(`    ${cyan('intent')}     ${g('Create, view, evolve .intent/ artifacts')}`);
   console.log(`    ${cyan('gate')}       ${g('Set constraints (budget, time, skill, urgency)')}`);
   console.log(`    ${cyan('context')}    ${g('Export .intent/ for any AI tool')}`);
-  console.log(`    ${cyan('ai')}         ${g('One-shot prompt with .intent/ context')}`);
+  console.log(`    ${cyan('ai')}         ${g('One-shot prompt with .intent/ context')}
+    ${cyan('browse')}     ${g('Read any URL — AI summary in your terminal')}`);
   console.log('');
   console.log(`  ${b(w('sync everywhere'))}`);
   console.log(`    ${cyan('seq')}        ${g('Sequence all memory → optimal context for any agent')}`);
@@ -95,6 +98,7 @@ function showHelp() {
   console.log(`    ${cyan('push/pull')}  ${g('Manual sync to/from phewsh.com/intent')}`);
   console.log(`    ${cyan('serve')}      ${g('Execution bridge — run from phewsh.com/intent')}`);
   console.log(`    ${cyan('mcp')}        ${g('Connect AI agents via MCP protocol')}`);
+  console.log(`    ${cyan('receipts')}   ${g('Proof trail — what agents actually did, with evidence')}`);
   console.log('');
   console.log(`  ${b(w('configure'))}`);
   console.log(`    ${cyan('login')}      ${g('Identity + API key + cloud sync')}`);
@@ -115,7 +119,12 @@ function checkForUpdates() {
       if (data.version && data.version !== pkg.version) {
         const newer = data.version.split('.').map(Number);
         const current = pkg.version.split('.').map(Number);
-        const isNewer = newer[0] > current[0] || newer[1] > current[1] || newer[2] > current[2];
+        // Compare major, then minor, then patch — a later slot only matters
+        // when all earlier slots are equal (0.11.16 is NOT newer than 0.12.0).
+        const isNewer =
+          newer[0] !== current[0] ? newer[0] > current[0] :
+          newer[1] !== current[1] ? newer[1] > current[1] :
+          newer[2] > current[2];
         if (isNewer) {
           console.log(g(`\n  Update available: ${pkg.version} → ${data.version}`));
           console.log(g(`  Run: npm install -g phewsh\n`));

package/commands/ai.js

@@ -2,6 +2,10 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const { trackSap } = require('../lib/supabase');
+const {
+  getProvider, listProviders, detectProvider,
+  buildHeaders, buildBody, getUrl, streamParser,
+} = require('../lib/providers');
 
 const CONFIG_PATH = path.join(os.homedir(), '.phewsh', 'config.json');
 const INTENT_DIR = path.join(process.cwd(), '.intent');
@@ -36,91 +40,183 @@ function buildSystemPrompt(intentFiles) {
   return `You are a focused execution assistant. The user has structured intent artifacts that define what they are building. Use these as your primary context for every response — stay aligned with their vision, plan, and next actions.\n\n${sections}`;
 }
 
-async function streamResponse(apiKey, systemPrompt, userPrompt, userId, accessToken) {
-  const model = 'claude-sonnet-4-6';
-  const messages = [{ role: 'user', content: userPrompt }];
-  const body = { model, max_tokens: 1024, messages, stream: true };
-  if (systemPrompt) body.system = systemPrompt;
+function parseFlags(args) {
+  const flags = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--provider' || args[i] === '-p') {
+      flags.provider = args[i + 1];
+      i++;
+    } else if (args[i] === '--model' || args[i] === '-m') {
+      flags.model = args[i + 1];
+      i++;
+    }
+  }
+  // Strip flags from args to get the prompt
+  const clean = [];
+  for (let i = 0; i < args.length; i++) {
+    if ((args[i] === '--provider' || args[i] === '-p' || args[i] === '--model' || args[i] === '-m') && args[i + 1]) {
+      i++; // skip value
+    } else {
+      clean.push(args[i]);
+    }
+  }
+  return { flags, clean };
+}
+
+function resolveProvider(config, flagProvider) {
+  const providerName = flagProvider || config.defaultProvider || 'anthropic';
+  return getProvider(providerName);
+}
+
+function readProjectId() {
+  try {
+    const p = path.join(INTENT_DIR, 'project.json');
+    if (!fs.existsSync(p)) return null;
+    const j = JSON.parse(fs.readFileSync(p, 'utf-8'));
+    return j.id || null;
+  } catch { return null; }
+}
 
-  const response = await fetch('https://api.anthropic.com/v1/messages', {
+function resolveApiKey(config, provider) {
+  // PHEWSH gateway authenticates with your phewsh JWT (phewsh login --token),
+  // not a BYOK provider key.
+  if (provider.id === 'phewsh') return config.supabaseAccessToken || null;
+  // Check provider-specific key first, then fall back to generic apiKey
+  const providerKey = config.providerKeys?.[provider.id];
+  if (providerKey) return providerKey;
+  // Check env var
+  if (provider.keyEnvVar && process.env[provider.keyEnvVar]) return process.env[provider.keyEnvVar];
+  // Fall back to generic key if provider matches or can be auto-detected
+  if (config.apiKey) {
+    const detected = detectProvider(config.apiKey);
+    if (!detected || detected === provider.id) return config.apiKey;
+  }
+  if (provider.noKey) return null; // ollama doesn't need a key
+  return null;
+}
+
+async function streamResponse(config, provider, model, systemPrompt, userPrompt) {
+  const apiKey = resolveApiKey(config, provider);
+  if (!apiKey && !provider.noKey) {
+    if (provider.id === 'phewsh') {
+      throw new Error('Not logged in. Run `phewsh login --token <jwt>` (get it at phewsh.com/intent → Settings → CLI Access) to use pooled credits.');
+    }
+    throw new Error(`No API key for ${provider.name}. Run \`phewsh login --set-key\` or set ${provider.keyEnvVar}.`);
+  }
+
+  const url = getUrl(provider, config);
+  const headers = buildHeaders(provider, apiKey);
+  // Route through the Decision Gate: tell the gateway which project this spend
+  // belongs to, so a budget set on that project is enforced server-side.
+  if (provider.id === 'phewsh') {
+    const projectId = readProjectId();
+    if (projectId) headers['x-phewsh-project'] = projectId;
+  }
+  const body = buildBody(provider, model, systemPrompt, userPrompt);
+
+  const response = await fetch(url, {
     method: 'POST',
-    headers: {
-      'x-api-key': apiKey,
-      'anthropic-version': '2023-06-01',
-      'content-type': 'application/json',
-    },
+    headers,
     body: JSON.stringify(body),
   });
 
   if (!response.ok) {
     const err = await response.json().catch(() => ({}));
-    throw new Error(err.error?.message || `API error ${response.status}`);
+    const msg = err.error?.message || err.message || `API error ${response.status}`;
+    throw new Error(`${provider.name}: ${msg}`);
   }
 
   process.stdout.write('\n');
 
+  const parse = streamParser(provider);
   let promptTokens = null;
   let completionTokens = null;
 
-  for await (const chunk of response.body) {
-    const text = Buffer.from(chunk).toString('utf-8');
-    const lines = text.split('\n').filter(l => l.startsWith('data: '));
-    for (const line of lines) {
-      const data = line.slice(6);
-      if (data === '[DONE]') continue;
-      try {
-        const parsed = JSON.parse(data);
-        if (parsed.type === 'content_block_delta' && parsed.delta?.text) {
-          process.stdout.write(parsed.delta.text);
-        }
-        // Capture token counts from Anthropic stream
-        if (parsed.type === 'message_start' && parsed.message?.usage) {
-          promptTokens = parsed.message.usage.input_tokens;
-        }
-        if (parsed.type === 'message_delta' && parsed.usage) {
-          completionTokens = parsed.usage.output_tokens;
-        }
-      } catch { /* skip malformed chunks */ }
+  for await (const event of parse(response)) {
+    if (event.type === 'text') {
+      process.stdout.write(event.text);
+    } else if (event.type === 'usage') {
+      promptTokens = event.promptTokens;
+      completionTokens = event.completionTokens;
     }
   }
 
   process.stdout.write('\n\n');
 
-  // SAP: fire-and-forget after stream completes
-  trackSap({ userId, source: 'cli', model, promptTokens, completionTokens, accessToken });
+  // SAP tracking
+  trackSap({
+    userId: config.supabaseUserId,
+    source: 'cli',
+    model,
+    promptTokens,
+    completionTokens,
+    accessToken: config.supabaseAccessToken,
+  });
 }
 
 async function main() {
   if (!subcommand || subcommand === '--help' || subcommand === '-h') {
     console.log(`
-  😮‍💨🤫  phewsh ai
+  phewsh ai
 
   Usage:
     phewsh ai run "<prompt>"    Run a prompt with .intent/ context injected
     phewsh ai status            Show current config and context
+    phewsh ai providers         List available AI providers
+
+  Options:
+    -p, --provider <name>       Override provider (e.g. openrouter, groq, ollama)
+    -m, --model <model>         Override model
 
   Examples:
     phewsh ai run "what should I build next?"
-    phewsh ai run "write a release checklist for the current plan"
-    phewsh ai run "summarize where I am and what's blocked"
+    phewsh ai run -p openrouter "compare these approaches"
+    phewsh ai run -p groq -m llama-3.3-70b-versatile "quick question"
+    phewsh ai run -p ollama "local inference, no API key needed"
     `);
     return;
   }
 
+  if (subcommand === 'providers') {
+    const config = loadConfig() || {};
+    console.log('\n  Available providers:\n');
+    for (const p of listProviders()) {
+      const isDefault = (config.defaultProvider || 'anthropic') === p.id;
+      const hasKey = !!(config.providerKeys?.[p.id] || (p.keyEnvVar && process.env[p.keyEnvVar]));
+      const keyStatus = p.id === 'phewsh'
+        ? (config.supabaseAccessToken ? 'logged in' : 'run: phewsh login --token')
+        : (p.noKey ? 'no key needed' : (hasKey ? 'key set' : 'no key'));
+      const marker = isDefault ? ' (default)' : '';
+      console.log(`  ${p.id.padEnd(12)} ${p.name.padEnd(26)} ${keyStatus}${marker}`);
+      console.log(`  ${''.padEnd(12)} model: ${p.defaultModel || '(configure)'}`);
+      if (p.docs) console.log(`  ${''.padEnd(12)} ${p.docs}`);
+      console.log('');
+    }
+    return;
+  }
+
   if (subcommand === 'status') {
     const config = loadConfig();
     const intentFiles = loadIntentContext();
+    const providerName = config?.defaultProvider || 'anthropic';
+    let provider;
+    try { provider = getProvider(providerName); } catch { provider = { name: providerName }; }
     console.log('\n  phewsh ai — status\n');
-    console.log(`  Config    ${config ? '✓ found' : '✗ not found — run `phewsh login`'}`);
-    console.log(`  API key   ${config?.apiKey ? '✓ set' : '✗ not set'}`);
-    console.log(`  Provider  ${config?.defaultProvider || 'anthropic'}`);
-    console.log(`  .intent/  ${intentFiles.length > 0 ? `✓ ${intentFiles.map(f => f.file).join(', ')}` : '✗ none found'}`);
+    console.log(`  Config    ${config ? 'found' : 'not found — run \`phewsh login\`'}`);
+    console.log(`  Provider  ${provider.name} (${providerName})`);
+    console.log(`  API key   ${config?.apiKey || config?.providerKeys?.[providerName] ? 'set' : 'not set'}`);
+    if (config?.providerKeys) {
+      const configured = Object.keys(config.providerKeys).filter(k => config.providerKeys[k]);
+      if (configured.length > 0) console.log(`  Keys for  ${configured.join(', ')}`);
+    }
+    console.log(`  .intent/  ${intentFiles.length > 0 ? intentFiles.map(f => f.file).join(', ') : 'none found'}`);
     console.log('');
     return;
   }
 
   if (subcommand === 'run') {
-    const prompt = args.slice(1).join(' ');
+    const { flags, clean } = parseFlags(args.slice(1));
+    const prompt = clean.join(' ');
     if (!prompt) {
       console.error('\n  Usage: phewsh ai run "<your prompt>"\n');
       process.exit(1);
@@ -131,8 +227,14 @@ async function main() {
       console.error('\n  Not logged in. Run `phewsh login` first.\n');
       process.exit(1);
     }
-    if (!config.apiKey) {
-      console.error('\n  No API key set. Run `phewsh login --set-key` to add one.\n');
+
+    const provider = resolveProvider(config, flags.provider);
+    const model = flags.model || config.providerModels?.[provider.id] || provider.defaultModel;
+
+    const apiKey = resolveApiKey(config, provider);
+    if (!apiKey && !provider.noKey) {
+      console.error(`\n  No API key for ${provider.name}.`);
+      console.error(`  Run \`phewsh login --set-key\` or set ${provider.keyEnvVar}.\n`);
       process.exit(1);
     }
 
@@ -144,8 +246,9 @@ async function main() {
     } else {
       console.log('\n  No .intent/ found — running without project context');
     }
+    console.log(`  Provider: ${provider.name} | Model: ${model}`);
 
-    await streamResponse(config.apiKey, systemPrompt, prompt, config.supabaseUserId, config.supabaseAccessToken);
+    await streamResponse(config, provider, model, systemPrompt, prompt);
     return;
   }