opencode-puter-setup 1.0.0

package/README.md

@@ -0,0 +1,88 @@
+# opencode-puter-setup
+
+Auto-configure Puter as an OpenCode provider, giving you access to Claude Sonnet 4.6 for free — with optional prompt caching.
+
+## What This Does
+
+- Adds two Puter provider entries to your OpenCode config
+- Stores your Puter auth token in the OpenCode auth file
+- Zero external dependencies beyond Node.js 18+
+
+| Provider entry | Model | Endpoint | Prompt caching |
+|---|---|---|---|
+| `puter-openai` | Claude Sonnet 4.6 (Puter) | OpenAI-compatible | No |
+| `puter-anthropic` | Claude Sonnet 4.6 — Cached (Puter) | Anthropic-wire | Message-level only |
+
+> **Caching limitation:** Puter's Anthropic endpoint normalises system prompts to plain strings, which strips `cache_control`. Caching works on user/assistant message content, but not on system prompts.
+
+## Installation
+
+```bash
+# No install required
+npx opencode-puter-setup
+
+# Or install globally
+npm install -g opencode-puter-setup
+opencode-puter-setup
+```
+
+## Quick Start
+
+1. Get your token at `https://puter.com` → Settings → API Tokens
+2. Run the setup and paste it in when prompted
+3. Restart OpenCode, run `/models`, and select either Puter model
+
+## What Gets Written
+
+**`~/.config/opencode/opencode.json`** (or local `.opencode/config.json`):
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "puter-openai": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "Puter",
+      "options": {
+        "baseURL": "https://api.puter.com/puterai/openai/v1/"
+      },
+      "models": {
+        "anthropic/claude-sonnet-4-6": {
+          "name": "Claude Sonnet 4.6 (Puter)"
+        }
+      }
+    },
+    "puter-anthropic": {
+      "npm": "@ai-sdk/anthropic",
+      "name": "Puter (Cached)",
+      "options": {
+        "baseURL": "https://api.puter.com/puterai/anthropic/v1/",
+        "apiKey": "puter"
+      },
+      "models": {
+        "anthropic/claude-sonnet-4-6": {
+          "name": "Claude Sonnet 4.6 — Cached (Puter)"
+        }
+      }
+    }
+  }
+}
+```
+
+**`~/.local/share/opencode/auth.json`** — token stored with `0600` permissions.
+
+## Billing
+
+Puter uses a user-pays model. Your free tier covers typical usage. No charges to you as the developer.
+
+## Troubleshooting
+
+**Model not showing in `/models`** — restart OpenCode after setup.
+
+**401 errors** — your token may have expired. Re-run the setup with a fresh token.
+
+**Caching not reducing costs** — system prompt caching is not supported through Puter. Use message-level `cache_control` on large repeated user/assistant content instead.
+
+## License
+
+MIT

package/bin/setup.js

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as readline from 'readline/promises';
+
+const CONFIG_PATHS = {
+  global: path.join(os.homedir(), '.config', 'opencode', 'opencode.json'),
+  local: '.opencode/config.json',
+  legacyGlobal: path.join(os.homedir(), '.opencode', 'config.json')
+};
+
+// Two provider entries:
+// 1. puter-openai  — OpenAI-compatible endpoint, broad model access
+// 2. puter-anthropic — Anthropic-wire endpoint, enables cache_control on messages
+const PUTER_PROVIDER_CONFIG = {
+  "puter-openai": {
+    npm: "@ai-sdk/openai-compatible",
+    name: "Puter",
+    options: {
+      baseURL: "https://api.puter.com/puterai/openai/v1/"
+    },
+    models: {
+      "anthropic/claude-sonnet-4-6": {
+        name: "Claude Sonnet 4.6 (Puter)"
+      }
+    }
+  },
+  "puter-anthropic": {
+    npm: "@ai-sdk/anthropic",
+    name: "Puter (Cached)",
+    options: {
+      baseURL: "https://api.puter.com/puterai/anthropic/v1/",
+      apiKey: "puter"
+    },
+    models: {
+      "anthropic/claude-sonnet-4-6": {
+        name: "Claude Sonnet 4.6 — Cached (Puter)"
+      }
+    }
+  }
+};
+
+async function getAuthToken(rl) {
+  console.log('\n🔐 Puter Authentication Token Setup\n');
+  console.log('To get your token:');
+  console.log('  1. Visit: https://puter.com/dashboard#account');
+  console.log('  2. Click "Create token" in the API token section');
+  console.log('  3. Copy the token (keep it safe!)\n');
+
+  const token = await rl.question('📌 Paste your Puter auth token: ');
+
+  if (!token || token.trim().length === 0) {
+    throw new Error('❌ Auth token is required');
+  }
+
+  return token.trim();
+}
+
+function ensureConfigDir(configPath) {
+  const dir = path.dirname(configPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+}
+
+function loadConfig(configPath) {
+  if (fs.existsSync(configPath)) {
+    try {
+      const content = fs.readFileSync(configPath, 'utf-8');
+      return JSON.parse(content);
+    } catch (e) {
+      console.warn(`⚠️  Could not parse ${configPath}, starting fresh`);
+      return {};
+    }
+  }
+  return {};
+}
+
+function mergeConfig(existing, newProviders) {
+  return {
+    "$schema": "https://opencode.ai/config.json",
+    ...existing,
+    provider: {
+      ...existing.provider,
+      ...newProviders
+    }
+  };
+}
+
+async function chooseConfigLocation(rl) {
+  const hasLocal = fs.existsSync(CONFIG_PATHS.local);
+  const hasGlobal = fs.existsSync(CONFIG_PATHS.global) || fs.existsSync(CONFIG_PATHS.legacyGlobal);
+
+  // No existing config anywhere — default to global
+  if (!hasLocal && !hasGlobal) {
+    console.log('No existing OpenCode config found. Creating global config.');
+    return 'global';
+  }
+
+  // Only one exists — use it silently
+  if (hasLocal && !hasGlobal) return 'local';
+  if (!hasLocal && hasGlobal) return 'global';
+
+  // Both exist — ask
+  console.log('\nOpenCode config found in multiple locations:\n');
+  console.log(`  [1] Local:  ${CONFIG_PATHS.local}`);
+  console.log(`  [2] Global: ${CONFIG_PATHS.global}`);
+
+  const choice = await rl.question('\nChoose location to update (1/2, default: 2 global): ');
+  return choice === '1' ? 'local' : 'global';
+}
+
+async function main() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  try {
+    console.log('\n╔════════════════════════════════════════╗');
+    console.log('║  OpenCode + Puter Setup                ║');
+    console.log('║  Claude Sonnet 4.6 Auto-Configuration  ║');
+    console.log('╚════════════════════════════════════════╝\n');
+
+    const token = await getAuthToken(rl);
+    const configType = await chooseConfigLocation(rl);
+    const configPath = configType === 'global' ? CONFIG_PATHS.global : CONFIG_PATHS.local;
+
+    ensureConfigDir(configPath);
+    const existingConfig = loadConfig(configPath);
+    const updatedConfig = mergeConfig(existingConfig, PUTER_PROVIDER_CONFIG);
+
+    fs.writeFileSync(configPath, JSON.stringify(updatedConfig, null, 2));
+
+    const authPath = path.join(os.homedir(), '.local', 'share', 'opencode', 'auth.json');
+    ensureConfigDir(authPath);
+
+    let authConfig = {};
+    if (fs.existsSync(authPath)) {
+      try {
+        authConfig = JSON.parse(fs.readFileSync(authPath, 'utf-8'));
+      } catch (e) {
+        console.warn('⚠️  Could not parse auth.json, creating new');
+      }
+    }
+
+    authConfig.puter = token;
+    fs.writeFileSync(authPath, JSON.stringify(authConfig, null, 2));
+    fs.chmodSync(authPath, 0o600);
+
+    console.log('\nSetup Complete!\n');
+    console.log(`Config saved to: ${configPath}`);
+    console.log(`Token saved to:  ${authPath}\n`);
+    console.log('Next steps:\n');
+    console.log('  1. Run: opencode');
+    console.log('  2. Use: /models');
+    console.log('  3. Select one of:');
+    console.log('       Claude Sonnet 4.6 (Puter)          — standard');
+    console.log('       Claude Sonnet 4.6 — Cached (Puter) — with prompt caching\n');
+    console.log('Note: prompt caching applies to message-level cache_control.');
+    console.log('      System prompt caching is not supported by the Puter endpoint.\n');
+    console.log('Your Puter free tier credits will be used.');
+    console.log('No setup fees, no OpenCode billing.\n');
+
+  } catch (error) {
+    console.error(`\n❌ Error: ${error.message}\n`);
+    process.exit(1);
+  } finally {
+    rl.close();
+  }
+}
+
+main().catch(err => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "opencode-puter-setup",
+  "version": "1.0.0",
+  "description": "Auto-configure Puter as an OpenCode provider — Claude Sonnet 4.6 with prompt caching, free",
+  "type": "module",
+  "bin": {
+    "opencode-puter-setup": "bin/setup.js"
+  },
+  "scripts": {
+    "start": "node bin/setup.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "opencode",
+    "puter",
+    "claude",
+    "claude-sonnet",
+    "ai",
+    "free",
+    "prompt-caching",
+    "setup",
+    "provider"
+  ],
+  "license": "MIT",
+  "preferGlobal": true,
+  "files": [
+    "bin/",
+    "README.md"
+  ]
+}