openzoo 0.13.2 → 0.14.0

package/bin/openzoo.js

@@ -6,8 +6,11 @@ const HELP = `openzoo — local x402-paying proxy + MCP server for openzoo.fun
 usage:
   npx openzoo            start the proxy: http://localhost:8402/v1 (keyless) PLUS a
                          public HTTPS url for cloud IDEs (key required, printed at start)
-  npx openzoo launch <cmd> [args]   launch a Messages API-compatible client
-                                    (needs the proxy running)
+  npx openzoo cursor     wire Cursor to the zoo (writes MCP config, prints the
+                         base_url/key to paste into its AI settings)
+  npx openzoo vscode     same, for VS Code
+  npx openzoo launch <cmd> [args]   launch a TERMINAL Messages API client
+                                    (claude, aider...) already pointed at the zoo
   npx openzoo mcp        stdio MCP server (tools: zoo_ask, zoo_bind, zoo_models, zoo_wallet, zoo_contexts)
   npx openzoo tunnel     public-url-only mode (everything key-gated, no keyless localhost)
   npx openzoo demo       ~1M-token needle demo: direct refuses, the zoo answers
@@ -46,6 +49,11 @@ async function main() {
     case 'start':
       await (await import('../lib/proxy.js')).startProxy({ autoTunnel: true });
       break;
+    case 'cursor':
+    case 'vscode':
+      // GUI editors read config files, not env vars — see lib/setup.js.
+      (await import('../lib/setup.js')).setupEditor(cmd);
+      break;
     case 'mcp':
       await (await import('../lib/mcp.js')).startMcp();
       break;

package/lib/anthropic.js

@@ -144,7 +144,14 @@ export function openAIToAnthropic(data, requestedModel) {
  * dead and RETRIES, and every retry is another payment.
  */
 export function writeAnthropicSse(res, message, upstream) {
-  const headers = { 'content-type': 'text/event-stream; charset=utf-8', 'cache-control': 'no-cache' };
+  // x-accel-buffering: no keeps the cloudflare tunnel / nginx from buffering
+  // the stream and merging the tool_use frames a client parses incrementally.
+  const headers = {
+    'content-type': 'text/event-stream; charset=utf-8',
+    'cache-control': 'no-cache',
+    'x-accel-buffering': 'no',
+    connection: 'keep-alive',
+  };
   const settle = upstream?.headers?.get?.('x-payment-response');
   if (settle) headers['x-payment-response'] = settle;
   res.writeHead(200, headers);

package/lib/proxy.js

@@ -135,6 +135,13 @@ function serveAsSse(res, data, upstream) {
   const headers = {
     'content-type': 'text/event-stream; charset=utf-8',
     'cache-control': 'no-cache',
+    // Tell any proxy in front of us (cloudflare quick tunnel, nginx) NOT to
+    // buffer the stream. Without this the tunnel accumulates the whole SSE
+    // body and releases it at once, which reorders/merges the tool_call frames
+    // an agent parses incrementally — observed as "provider-side tool-call
+    // protocol error" over the tunnel while localhost (no proxy) is fine.
+    'x-accel-buffering': 'no',
+    connection: 'keep-alive',
   };
   const settle = upstream?.headers?.get?.('x-payment-response');
   if (settle) headers['x-payment-response'] = settle;

package/lib/setup.js

@@ -0,0 +1,59 @@
+/**
+ * `npx openzoo cursor` / `npx openzoo vscode` — wire a GUI editor to the zoo.
+ *
+ * WHY THIS IS NOT `launch`: Cursor and VS Code are GUI apps, not processes you
+ * hand env vars to. `openzoo launch <cmd>` works for terminal harnesses (claude,
+ * aider) because they read ANTHROPIC_BASE_URL/OPENAI_BASE_URL at startup. An
+ * editor reads its own config instead, and Cursor keeps the provider base-URL +
+ * key in an ENCRYPTED internal store that no CLI can write — that half stays a
+ * GUI toggle. So this command does the half that IS automatable (MCP server
+ * registration, which is plain JSON) and prints the exact values to paste for
+ * the half that is not, instead of pretending it did everything.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { config } from './config.js';
+
+const CURSOR_MCP = path.join(os.homedir(), '.cursor', 'mcp.json');
+const VSCODE_MCP = path.join(os.homedir(), '.vscode', 'mcp.json');
+
+/** Merge our server into an existing mcp.json without clobbering the user's. */
+function addMcpServer(file) {
+  let doc = {};
+  try { doc = JSON.parse(fs.readFileSync(file, 'utf8')) || {}; } catch { doc = {}; }
+  const key = doc.mcpServers ? 'mcpServers' : (doc.servers ? 'servers' : 'mcpServers');
+  doc[key] = doc[key] || {};
+  const existed = Boolean(doc[key].openzoo);
+  doc[key].openzoo = { command: 'npx', args: ['-y', 'openzoo@latest', 'mcp'] };
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, `${JSON.stringify(doc, null, 2)}\n`);
+  return { file, existed };
+}
+
+export function setupEditor(which = 'cursor') {
+  const base = `http://localhost:${config.port}/v1`;
+  const file = which === 'vscode' ? VSCODE_MCP : CURSOR_MCP;
+  const { existed } = addMcpServer(file);
+
+  console.log(`openzoo → ${which}`);
+  console.log('');
+  console.log(`1. MCP: ${existed ? 'updated' : 'added'} "openzoo" in ${file}`);
+  console.log('   tools: zoo_bind, zoo_ask, zoo_models, zoo_wallet, zoo_contexts');
+  console.log('   (restart the editor to pick it up)');
+  console.log('');
+  console.log('2. Model routing — paste these into the editor\'s AI settings.');
+  console.log('   Cursor keeps provider settings in an encrypted store, so this');
+  console.log('   part cannot be scripted; it is two fields:');
+  console.log('');
+  console.log(`     Override OpenAI Base URL :  ${base}`);
+  console.log('     OpenAI API Key           :  sk-openzoo   (any value; x402 pays, not keys)');
+  console.log('');
+  console.log('   Then add a model the zoo serves (Cursor validates the name):');
+  console.log('     deepseek/deepseek-v4-pro-0813   ← cheap, stateless tools, recommended');
+  console.log('     openai/gpt-5.6-sol-pro          ← flagship, ~34x the output cost');
+  console.log('   Turn OFF the built-in models (Composer/GPT/Cursor-Grok) while the');
+  console.log('   override is on — those only resolve against Cursor\'s own backend.');
+  console.log('');
+  console.log(`3. Make sure the proxy is running:  npx openzoo    (${base})`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openzoo",
-  "version": "0.13.2",
+  "version": "0.14.0",
   "description": "Local x402-paying proxy + MCP server for openzoo.fun — point any OpenAI-compatible harness (Cursor, Claude Code, aider, SDKs) at localhost and it pays per call from a local burner wallet. Solana and Base rails live; Robinhood experimental.",
   "license": "MIT",
   "type": "module",