@xtruder/opencode-claude-max-plugin 0.1.0

package/README.md

@@ -0,0 +1,99 @@
+# @xtruder/opencode-claude-max-plugin
+
+An [OpenCode](https://opencode.ai/) plugin that enables Claude Pro/Max subscription access via the official [`@anthropic-ai/sdk`](https://github.com/anthropics/anthropic-sdk-typescript), using OAuth credentials from Claude Code (`~/.claude/.credentials.json`).
+
+## Why?
+
+- **Use your Claude subscription** — Automatically reads OAuth credentials from Claude Code, no separate API key needed
+- **Matches Claude Code exactly** — Same headers, billing, tool names, and request format as Claude Code CLI
+- **Prompt caching** — 98% of input tokens served from cache (system prompt + tools cached globally)
+- **All Claude models** — Opus 4.6, Sonnet 4.6, Sonnet 4.5, Haiku 4.5, and more
+- **Extended thinking** — Full reasoning support with signature passthrough
+- **Usage tracking** — Built-in `/usage` command shows subscription utilization
+
+## Installation
+
+```bash
+npm install @xtruder/opencode-claude-max-plugin
+# or
+bun add @xtruder/opencode-claude-max-plugin
+```
+
+## Quick Start
+
+### With OpenCode
+
+Add to `.opencode/opencode.json`. If you have Claude Code credentials (`~/.claude/.credentials.json`), no environment variable is needed:
+
+```json
+{
+  "provider": {
+    "anthropic-sdk": {
+      "npm": "@xtruder/opencode-claude-max-plugin",
+      "name": "Anthropic SDK",
+      "models": {
+        "claude-sonnet-4-6":        { "name": "Claude Sonnet 4.6", "reasoning": true, "tool_call": true },
+        "claude-opus-4-6":          { "name": "Claude Opus 4.6", "reasoning": true, "tool_call": true },
+        "claude-haiku-4-5-20251001": { "name": "Claude Haiku 4.5", "tool_call": true }
+      }
+    }
+  }
+}
+```
+
+### With Vercel AI SDK
+
+```typescript
+import { createAnthropicSDK } from "@xtruder/opencode-claude-max-plugin";
+import { streamText, generateText } from "ai";
+
+// Uses ~/.claude/.credentials.json automatically
+const provider = createAnthropicSDK();
+const model = provider.languageModel("claude-sonnet-4-6");
+
+const result = streamText({ model, prompt: "Hello!" });
+for await (const chunk of result.textStream) {
+  process.stdout.write(chunk);
+}
+```
+
+## Authentication
+
+Credentials are resolved in order:
+
+1. **`apiKey` option** or **`ANTHROPIC_API_KEY` env var**
+2. **Claude Code credentials** — auto-read from `~/.claude/.credentials.json`
+
+For Claude Code credentials, log in via `claude` CLI first.
+
+## Context Window Limits
+
+| Model | Max Context (subscription, no Extra usage) |
+|---|---|
+| Opus 4.6 | ~615K+ tokens (native 1M) |
+| Sonnet 4.6 | ~120K tokens (429 above, needs Extra usage) |
+| Haiku 4.5 | 200K tokens (hard limit) |
+
+## Features
+
+- Streaming and non-streaming completions
+- Tool/function calling with Claude Code tool name mapping
+- Extended thinking with signature passthrough
+- Prompt caching (98% cache hit rate with full tool set)
+- Subscription rate limit detection with clear error messages
+- `/usage` command for subscription utilization tracking
+- MCP tool name remapping (OpenCode → Claude Code format)
+
+## Development
+
+```bash
+bun install
+bun run build
+bun run test    # 17 integration tests
+```
+
+See [RESEARCH.md](RESEARCH.md) for detailed reverse-engineering findings.
+
+## License
+
+MIT

package/build/agent-index.d.ts

@@ -0,0 +1,24 @@
+import type { LanguageModelV2 } from "@ai-sdk/provider";
+export interface AgentSDKProviderOptions {
+    /**
+     * Provider name for logging. Defaults to "anthropic-agent-sdk".
+     */
+    name?: string;
+    /**
+     * Any additional options (passed through by OpenCode).
+     */
+    [key: string]: unknown;
+}
+export interface AgentSDKProvider {
+    languageModel(modelId: string): LanguageModelV2;
+}
+/**
+ * Create an Anthropic Agent SDK provider for use with OpenCode / Vercel AI SDK.
+ *
+ * Uses @anthropic-ai/claude-agent-sdk which handles authentication via
+ * Claude Code's built-in OAuth flow — no API keys or billing headers needed.
+ */
+export declare function createAgentSDK(options?: AgentSDKProviderOptions): AgentSDKProvider;
+export default createAgentSDK;
+export { AgentSDKModel } from "./agent-model.js";
+//# sourceMappingURL=agent-index.d.ts.map

package/build/agent-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-index.d.ts","sourceRoot":"","sources":["../src/agent-index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAAA;CAChD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CAQlB;AAED,eAAe,cAAc,CAAA;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA"}

package/build/agent-index.js

@@ -0,0 +1,294 @@
+// src/agent-model.ts
+import {
+  unstable_v2_createSession
+} from "@anthropic-ai/claude-agent-sdk";
+function mapFinishReason(reason) {
+  switch (reason) {
+    case "end_turn":
+      return "stop";
+    case "stop_sequence":
+      return "stop";
+    case "max_tokens":
+      return "length";
+    case "tool_use":
+      return "tool-calls";
+    default:
+      return "unknown";
+  }
+}
+function extractSystem(prompt) {
+  const parts = [];
+  for (const msg of prompt) {
+    if (msg.role === "system")
+      parts.push(msg.content);
+  }
+  return parts.length > 0 ? parts.join(`
+
+`) : undefined;
+}
+function extractMessages(prompt) {
+  return prompt.filter((m) => m.role !== "system");
+}
+function formatLastMessage(msg) {
+  if (msg.role === "user") {
+    return msg.content.map((p) => {
+      if (p.type === "text")
+        return p.text;
+      return "";
+    }).filter(Boolean).join(`
+`);
+  }
+  if (msg.role === "tool") {
+    return msg.content.map((p) => {
+      const output = p.output;
+      if (output.type === "text" || output.type === "error-text")
+        return output.value;
+      if (output.type === "json" || output.type === "error-json")
+        return JSON.stringify(output.value);
+      return String(output.value);
+    }).join(`
+`);
+  }
+  return "";
+}
+function convertAgentStream(stream, modelId) {
+  let idCounter = 0;
+  return new ReadableStream({
+    async start(controller) {
+      try {
+        let emittedMetadata = false;
+        let firstAssistantTurnDone = false;
+        for await (const msg of stream) {
+          if (firstAssistantTurnDone) {
+            if (msg.type === "result")
+              break;
+            continue;
+          }
+          if (msg.type === "assistant") {
+            const message = msg.message;
+            const content = message.content ?? [];
+            if (!emittedMetadata && message.id) {
+              emittedMetadata = true;
+              controller.enqueue({
+                type: "response-metadata",
+                id: message.id,
+                modelId: message.model ?? modelId,
+                timestamp: new Date
+              });
+            }
+            for (const block of content) {
+              if (block.type === "text") {
+                const id = `block-${idCounter++}`;
+                controller.enqueue({ type: "text-start", id });
+                controller.enqueue({ type: "text-delta", id, delta: block.text });
+                controller.enqueue({ type: "text-end", id });
+              } else if (block.type === "thinking") {
+                const id = `block-${idCounter++}`;
+                controller.enqueue({ type: "reasoning-start", id });
+                controller.enqueue({ type: "reasoning-delta", id, delta: block.thinking });
+                controller.enqueue({ type: "reasoning-end", id });
+              }
+            }
+          }
+          if (msg.type === "result") {
+            const result = msg;
+            controller.enqueue({
+              type: "finish",
+              finishReason: mapFinishReason(result.stop_reason),
+              usage: {
+                inputTokens: result.usage?.input_tokens ?? 0,
+                outputTokens: result.usage?.output_tokens ?? 0,
+                totalTokens: (result.usage?.input_tokens ?? 0) + (result.usage?.output_tokens ?? 0)
+              }
+            });
+            firstAssistantTurnDone = true;
+            break;
+          }
+        }
+      } catch (error) {
+        controller.enqueue({ type: "error", error });
+      } finally {
+        controller.close();
+      }
+    }
+  });
+}
+
+class AgentSDKModel {
+  providerName;
+  specificationVersion = "v2";
+  provider;
+  modelId;
+  supportedUrls = {};
+  session = null;
+  processedMessageCount = 0;
+  lastSystemPrompt = undefined;
+  constructor(modelId, providerName) {
+    this.providerName = providerName;
+    this.modelId = modelId;
+    this.provider = providerName;
+  }
+  needsNewSession(system, messages) {
+    if (!this.session)
+      return true;
+    if (system !== this.lastSystemPrompt)
+      return true;
+    if (messages.length < this.processedMessageCount)
+      return true;
+    return false;
+  }
+  createSession(system, tools) {
+    const opts = {
+      model: this.modelId,
+      maxTurns: 100,
+      includePartialMessages: true,
+      permissionMode: "bypassPermissions",
+      allowDangerouslySkipPermissions: true,
+      persistSession: false,
+      systemPrompt: system ?? "You are a helpful assistant.",
+      tools: []
+    };
+    return unstable_v2_createSession(opts);
+  }
+  async doStream(options) {
+    const system = extractSystem(options.prompt);
+    const messages = extractMessages(options.prompt);
+    const warnings = [];
+    if (this.needsNewSession(system, messages)) {
+      if (this.session) {
+        try {
+          this.session.close();
+        } catch {}
+      }
+      this.session = this.createSession(system, options.tools);
+      this.lastSystemPrompt = system;
+      this.processedMessageCount = 0;
+    }
+    let messageToSend;
+    if (this.processedMessageCount === 0) {
+      const firstUser = messages.find((m) => m.role === "user");
+      if (firstUser) {
+        messageToSend = formatLastMessage(firstUser);
+        this.processedMessageCount = messages.indexOf(firstUser) + 1;
+      }
+    } else {
+      const newMessages = messages.slice(this.processedMessageCount);
+      const toolMsg = newMessages.find((m) => m.role === "tool");
+      if (toolMsg) {
+        messageToSend = formatLastMessage(toolMsg);
+      } else {
+        const userMsg = [...newMessages].reverse().find((m) => m.role === "user");
+        if (userMsg) {
+          messageToSend = formatLastMessage(userMsg);
+        }
+      }
+      this.processedMessageCount = messages.length;
+    }
+    if (!messageToSend) {
+      messageToSend = "Continue.";
+    }
+    await this.session.send(messageToSend);
+    const stream = convertAgentStream(this.session.stream(), this.modelId);
+    const wrappedStream = new ReadableStream({
+      async start(controller) {
+        controller.enqueue({ type: "stream-start", warnings });
+        const reader = stream.getReader();
+        try {
+          while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+              break;
+            controller.enqueue(value);
+          }
+        } finally {
+          reader.releaseLock();
+          controller.close();
+        }
+      }
+    });
+    return {
+      stream: wrappedStream,
+      request: { body: messageToSend }
+    };
+  }
+  async doGenerate(options) {
+    const result = await this.doStream(options);
+    const reader = result.stream.getReader();
+    const content = [];
+    let finishReason = "unknown";
+    let usage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
+    let responseId = "";
+    let responseModel = this.modelId;
+    let currentText = "";
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done)
+        break;
+      switch (value.type) {
+        case "text-delta":
+          currentText += value.delta ?? "";
+          break;
+        case "text-end":
+          if (currentText) {
+            content.push({ type: "text", text: currentText });
+            currentText = "";
+          }
+          break;
+        case "tool-call":
+          content.push({
+            type: "tool-call",
+            toolCallId: value.toolCallId,
+            toolName: value.toolName,
+            input: value.input
+          });
+          break;
+        case "finish":
+          finishReason = value.finishReason;
+          usage = value.usage ?? usage;
+          break;
+        case "response-metadata":
+          responseId = value.id ?? "";
+          responseModel = value.modelId ?? this.modelId;
+          break;
+      }
+    }
+    if (currentText) {
+      content.push({ type: "text", text: currentText });
+    }
+    return {
+      content,
+      finishReason,
+      usage,
+      response: {
+        id: responseId,
+        modelId: responseModel,
+        timestamp: new Date
+      },
+      warnings: []
+    };
+  }
+  close() {
+    if (this.session) {
+      try {
+        this.session.close();
+      } catch {}
+      this.session = null;
+    }
+  }
+}
+
+// src/agent-index.ts
+function createAgentSDK(options = {}) {
+  const { name = "anthropic-agent-sdk", ...rest } = options;
+  return {
+    languageModel(modelId) {
+      return new AgentSDKModel(modelId, name);
+    }
+  };
+}
+var agent_index_default = createAgentSDK;
+export {
+  agent_index_default as default,
+  createAgentSDK,
+  AgentSDKModel
+};

package/build/agent-model.d.ts

@@ -0,0 +1,34 @@
+import type { LanguageModelV2, LanguageModelV2CallOptions } from "@ai-sdk/provider";
+type DoStreamResult = Awaited<ReturnType<LanguageModelV2["doStream"]>>;
+type DoGenerateResult = Awaited<ReturnType<LanguageModelV2["doGenerate"]>>;
+export declare class AgentSDKModel implements LanguageModelV2 {
+    private providerName;
+    readonly specificationVersion: "v2";
+    readonly provider: string;
+    readonly modelId: string;
+    readonly supportedUrls: Record<string, RegExp[]>;
+    private session;
+    private processedMessageCount;
+    private lastSystemPrompt;
+    constructor(modelId: string, providerName: string);
+    /**
+     * Determine if we need a new session based on the prompt.
+     * A new session is needed when:
+     * - No session exists
+     * - System prompt changed
+     * - Message count decreased (new conversation)
+     *
+     * The session is REUSED across doStream() calls for the same conversation
+     * (tool result continuations and multi-turn).
+     */
+    private needsNewSession;
+    private createSession;
+    doStream(options: LanguageModelV2CallOptions): Promise<DoStreamResult>;
+    doGenerate(options: LanguageModelV2CallOptions): Promise<DoGenerateResult>;
+    /**
+     * Close the session and clean up resources.
+     */
+    close(): void;
+}
+export {};
+//# sourceMappingURL=agent-model.d.ts.map

package/build/agent-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-model.d.ts","sourceRoot":"","sources":["../src/agent-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,0BAA0B,EAO3B,MAAM,kBAAkB,CAAA;AAMzB,KAAK,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;AACtE,KAAK,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;AAqJ1E,qBAAa,aAAc,YAAW,eAAe;IAajD,OAAO,CAAC,YAAY;IAZtB,QAAQ,CAAC,oBAAoB,EAAG,IAAI,CAAS;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAK;IAErD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,qBAAqB,CAAI;IACjC,OAAO,CAAC,gBAAgB,CAAgC;gBAItD,OAAO,EAAE,MAAM,EACP,YAAY,EAAE,MAAM;IAM9B;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,aAAa;IAoBf,QAAQ,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,cAAc,CAAC;IA2EtE,UAAU,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+DhF;;OAEG;IACH,KAAK;CAMN"}

package/build/agent-test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-test.d.ts.map

package/build/agent-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-test.d.ts","sourceRoot":"","sources":["../src/agent-test.ts"],"names":[],"mappings":""}

package/build/credentials.d.ts

@@ -0,0 +1,21 @@
+export interface ClaudeOAuthCredentials {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+    scopes: string[];
+    subscriptionType: string | null;
+}
+/**
+ * Default path to Claude Code credentials file.
+ */
+export declare function getCredentialsPath(): string;
+/**
+ * Read OAuth credentials from Claude Code's credentials file.
+ * Returns null if the file doesn't exist or can't be parsed.
+ */
+export declare function readClaudeCredentials(path?: string): ClaudeOAuthCredentials | null;
+/**
+ * Check if credentials are expired (with 5 minute buffer).
+ */
+export declare function isExpired(creds: ClaudeOAuthCredentials): boolean;
+//# sourceMappingURL=credentials.d.ts.map

package/build/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,CAAC,EAAE,MAAM,GACZ,sBAAsB,GAAG,IAAI,CAa/B;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAGhE"}

package/build/index.d.ts

@@ -0,0 +1,66 @@
+import type { LanguageModelV2 } from "@ai-sdk/provider";
+/**
+ * Beta flags that Claude Code sends on every OAuth request.
+ * Order and exact values must match what Claude Code sends.
+ */
+export declare const OAUTH_BETAS: string[];
+/**
+ * Beta flag that enables 1M context window. Only sent when model ID
+ * includes [1m] suffix — e.g. "claude-sonnet-4-6[1m]".
+ * Claude Code checks: /\[1m\]/i.test(modelId) before including this.
+ */
+export declare const CONTEXT_1M_BETA = "context-1m-2025-08-07";
+/**
+ * Beta flags for regular API key auth (no OAuth).
+ */
+export declare const API_KEY_BETAS: string[];
+export interface AnthropicSDKProviderOptions {
+    /**
+     * Anthropic API key. Defaults to ANTHROPIC_API_KEY env var.
+     */
+    apiKey?: string;
+    /**
+     * Custom base URL for the Anthropic API.
+     */
+    baseURL?: string;
+    /**
+     * Additional default headers to send with requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom fetch implementation.
+     */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Provider name for logging. Set automatically by OpenCode.
+     */
+    name?: string;
+    /**
+     * Path to Claude Code credentials file.
+     * Defaults to ~/.claude/.credentials.json.
+     */
+    credentialsPath?: string;
+    /**
+     * Any additional options (passed through by OpenCode).
+     */
+    [key: string]: unknown;
+}
+export interface AnthropicSDKProvider {
+    /**
+     * Get a language model by model ID.
+     */
+    languageModel(modelId: string): LanguageModelV2;
+}
+/**
+ * Create an Anthropic SDK provider for use with OpenCode / Vercel AI SDK.
+ *
+ * When using OAuth credentials from Claude Code, requests are made to
+ * look identical to Claude Code CLI requests — same headers, user-agent,
+ * beta flags, billing system block, and body structure.
+ */
+export declare function createAnthropicSDK(options?: AnthropicSDKProviderOptions): AnthropicSDKProvider;
+export default createAnthropicSDK;
+export { AnthropicSDKModel } from "./model.js";
+export type { ConvertedPrompt } from "./prompt.js";
+export { readClaudeCredentials, isExpired, getCredentialsPath, type ClaudeOAuthCredentials, } from "./credentials.js";
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAQvD;;;GAGG;AACH,eAAO,MAAM,WAAW,UAOvB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,0BAA0B,CAAA;AAEtD;;GAEG;AACH,eAAO,MAAM,aAAa,UAGzB,CAAA;AAED,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEhC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IAE/B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAAA;CAChD;AAgCD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CA8FtB;AAGD,eAAe,kBAAkB,CAAA;AAGjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,kBAAkB,EAClB,KAAK,sBAAsB,GAC5B,MAAM,kBAAkB,CAAA"}