@x-otto/plugin-anthropic 0.1.0-alpha.0

package/plugin-dist/plugin.js

@@ -0,0 +1,104 @@
+const __otto_plugin_import_meta_url = require("url").pathToFileURL(__filename).href;
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// extensions/plugin-anthropic/plugin.ts
+var plugin_exports = {};
+__export(plugin_exports, {
+  default: () => plugin_default
+});
+module.exports = __toCommonJS(plugin_exports);
+
+// otto-sdk-shim:otto-plugin-sdk
+var definePlugin = (f) => f;
+
+// extensions/plugin-anthropic/src/claude-code-spoof.ts
+var import_node_crypto = require("node:crypto");
+var CLAUDE_CODE_SYSTEM_PREFIX = "You are Claude Code, Anthropic's official CLI for Claude.";
+var CLAUDE_CODE_BETA = "claude-code-20250219";
+var CLAUDE_CODE_VERSION = process.env["OTTO_CLAUDE_CODE_VERSION"] || "2.0.1";
+function mergeClaudeCodeBeta(beta) {
+  const parts = (beta ? beta.split(",") : []).map((s) => s.trim()).filter(Boolean);
+  if (!parts.includes(CLAUDE_CODE_BETA)) {
+    parts.push(CLAUDE_CODE_BETA);
+  }
+  return parts.join(",");
+}
+function claudeCodeOAuthHeaders(beta, sessionId) {
+  return {
+    "anthropic-beta": mergeClaudeCodeBeta(beta),
+    "x-app": "cli",
+    "User-Agent": `claude-cli/${CLAUDE_CODE_VERSION} (external, cli)`,
+    "X-Claude-Code-Session-Id": sessionId
+  };
+}
+var cachedDeviceId;
+function deviceId() {
+  if (!cachedDeviceId) {
+    cachedDeviceId = process.env["OTTO_CLAUDE_CODE_DEVICE_ID"] || (0, import_node_crypto.randomUUID)();
+  }
+  return cachedDeviceId;
+}
+function claudeCodeMetadata(sessionId, accountUuid = "") {
+  return {
+    user_id: JSON.stringify({
+      device_id: deviceId(),
+      account_uuid: accountUuid,
+      session_id: sessionId
+    })
+  };
+}
+function prependClaudeCodeIdentity(blocks) {
+  const prefix = { type: "text", text: CLAUDE_CODE_SYSTEM_PREFIX };
+  if (!blocks || blocks.length === 0) {
+    return [prefix];
+  }
+  if (blocks[0]?.text === CLAUDE_CODE_SYSTEM_PREFIX) {
+    return blocks;
+  }
+  return [prefix, ...blocks];
+}
+
+// extensions/plugin-anthropic/plugin.ts
+function customizeRequest(input) {
+  if (input.auth.mode !== "oauth") return {};
+  return {
+    defaultHeaders: claudeCodeOAuthHeaders(input.auth.beta, input.sessionId),
+    transformSystemBlocks: (blocks) => prependClaudeCodeIdentity(blocks),
+    metadata: claudeCodeMetadata(input.sessionId)
+  };
+}
+var plugin_default = definePlugin((ctx) => ({
+  providerFactories: {
+    anthropic: () => {
+      const protocol = ctx.getWireProtocol("anthropic-messages");
+      if (!protocol) {
+        throw new Error(
+          "wire protocol 'anthropic-messages' is not registered \u2014 is extensions/plugin-otto-wire-protocols installed and trusted? (RFC-148)"
+        );
+      }
+      return protocol.create({
+        resolveAuth: () => ctx.resolveProviderAuth("anthropic").then((a) => a ?? void 0),
+        resolveBaseUrl: async () => "https://api.anthropic.com",
+        headers: { "anthropic-version": "2023-06-01" },
+        customizeRequest
+      });
+    }
+  }
+}));

package/plugin.ts

@@ -0,0 +1,51 @@
+/**
+ * plugin.ts —— plugin-anthropic 代码式插件入口（RFC-148 M3）。
+ *
+ * 单轴化（评审 F-C1 CRITICAL 吸收）：本插件从"声明式 contributes.providers + 框架层
+ * preserveProviderId 特判注入伪装"改为纯代码式——`otto-plugin.json` 的 `contributes.providers`
+ * 条目已删除（同一 api id 'anthropic' 双轴并存会因 source 不同被 first-win 拒绝其一，
+ * 详见 RFC-148 §D5），`contributes.oauth` 声明式部分保留不变，5 个静态模型迁至
+ * `codeProviderModels`（新 manifest 字段，RFC-148 M3 新增，见 packages/plugin/src/manifest.ts）。
+ *
+ * 官方 CLI 客户端伪装（绕 Anthropic 订阅 OAuth token 客户端分类器限流）现在是本插件
+ * 自己的 customizeRequest 定制器（复制 `extensions/plugin-github-copilot/plugin.ts` 的
+ * "代码式插件复用宿主注册的协议实现"模式，经 `ctx.getWireProtocol` 查表拿到
+ * `otto-wire-protocols` 插件提供的 anthropic-messages 协议实现）——框架层
+ * （provider-loader.ts）不再有任何 `preserveProviderId → 构造伪装 customizeRequest` 的
+ * 特判分支，彻底不认识具体官方客户端这个身份概念。
+ */
+import { definePlugin } from '@x-otto/plugin'
+import {
+  anthropicOAuthClientHeaders,
+  anthropicOAuthRequestMetadata,
+  prependAnthropicOAuthIdentity,
+} from './src/anthropic-oauth-client-identity'
+import type { WireRequestCustomizeInput, WireRequestCustomization } from '@x-otto/provider'
+
+function customizeRequest(input: WireRequestCustomizeInput): WireRequestCustomization {
+  if (input.auth.mode !== 'oauth') return {}
+  return {
+    defaultHeaders: anthropicOAuthClientHeaders(input.auth.beta, input.sessionId),
+    transformSystemBlocks: (blocks) => prependAnthropicOAuthIdentity(blocks),
+    metadata: anthropicOAuthRequestMetadata(input.sessionId),
+  }
+}
+
+export default definePlugin((ctx) => ({
+  providerFactories: {
+    anthropic: () => {
+      const protocol = ctx.getWireProtocol('anthropic-messages')
+      if (!protocol) {
+        throw new Error(
+          "wire protocol 'anthropic-messages' is not registered — is extensions/plugin-otto-wire-protocols installed and trusted? (RFC-148)",
+        )
+      }
+      return protocol.create({
+        resolveAuth: () => ctx.resolveProviderAuth('anthropic').then((a) => a ?? undefined),
+        resolveBaseUrl: async () => 'https://api.anthropic.com',
+        headers: { 'anthropic-version': '2023-06-01' },
+        customizeRequest,
+      })
+    },
+  },
+}))

package/src/anthropic-oauth-client-identity.ts

@@ -0,0 +1,101 @@
+import { randomUUID } from 'node:crypto'
+// RFC-148 M2：AnthropicSystemTextBlock（anthropic.ts 内部类型）已随协议实现物理迁出，
+// 改用 @x-otto/provider 的协议中立泛化类型 WireSystemTextBlock（结构完全一致，见 D1 §types.ts）。
+import type { WireSystemTextBlock } from '@x-otto/provider'
+
+/**
+ * anthropic-oauth-client-identity.ts —— 官方客户端形状匹配（订阅 OAuth token 专用）。
+ *
+ * RFC-140 架构下沉：此逻辑此前物理存在于 `@x-otto/provider`（通用契约包，`anthropic.ts`
+ * 内部硬编码调用），但它只对"首方 Anthropic 官方 API + 订阅 OAuth"这一具体场景成立且
+ * 必要——是 anthropic 一家厂商的专属行为，不该驻留在"多厂商共享的通用插入点"里。现通过
+ * `AnthropicProviderOptions.customizeRequest` 通用定制点（`packages/provider/src/provider/
+ * anthropic.ts`）注入，由本文件所在的装载层（`provider-loader.ts` `buildFactory`）在识别到
+ * `preserveProviderId===true`（首方插件信号）时构造并传入，`anthropic.ts` 本身不再认识
+ * "官方 CLI 客户端"这个具体身份概念。
+ *
+ * Anthropic 对订阅 OAuth token（`sk-ant-oat`，Claude Pro/Max）挂了一道客户端分类器：
+ * 请求必须「呈现为官方 CLI 客户端」，否则被激进限流——返回 `429 rate_limit_error`
+ * （注意非 `400`：格式合法、形状不对）。匹配点共三处：
+ *   ① system 数组首块身份串；② 客户端请求头（x-app / User-Agent / 会话 id / beta）；
+ *   ③ body.metadata.user_id 结构。
+ *
+ * ⚠️ 仅在 `auth.mode === 'oauth'` 下启用——API key、其它 provider 一律不动。
+ * ⚠️ 用订阅 token 驱动第三方客户端属 Anthropic ToS 灰区；另：Max-only 账户在 body 携带
+ *    `tools` 时仍可能被路由到 overage 计费道而得 `400`（见 hermes#15080）。调用方自负。
+ */
+
+/** system 数组首块必须逐字等于此串（官方 CLI 客户端固定身份前缀）。 */
+export const ANTHROPIC_OAUTH_SYSTEM_PREFIX = "You are Claude Code, Anthropic's official CLI for Claude."
+
+/** 官方 CLI 客户端专属 beta，与 OAuth 的 `oauth-2025-04-20` 一并发。 */
+const ANTHROPIC_OAUTH_CLIENT_BETA = 'claude-code-20250219'
+
+/** User-Agent 版本——经 env 覆盖以跟随真实 CLI 版本（格式 `claude-cli/<v> (external, cli)`）。 */
+const ANTHROPIC_OAUTH_CLIENT_VERSION = process.env['OTTO_ANTHROPIC_OAUTH_CLIENT_VERSION'] || '2.0.1'
+
+/**
+ * 把 OAuth 的 beta 头（如 `oauth-2025-04-20`）与 `claude-code-20250219` 合并去重，
+ * 保留入参里的既有项与顺序。
+ */
+export function mergeOAuthBetaHeader(beta?: string): string {
+  const parts = (beta ? beta.split(',') : []).map((s) => s.trim()).filter(Boolean)
+  if (!parts.includes(ANTHROPIC_OAUTH_CLIENT_BETA)) {
+    parts.push(ANTHROPIC_OAUTH_CLIENT_BETA)
+  }
+  return parts.join(',')
+}
+
+/**
+ * 订阅 OAuth 请求的客户端伪装头：x-app / User-Agent / 会话 id + 合并后的 anthropic-beta。
+ * 经 SDK `defaultHeaders` 注入——位于平台头之后、authHeaders 之后，故能覆盖 SDK 默认
+ * `User-Agent: Anthropic/JS x.y.z`，且不会顶掉 Bearer 鉴权头。
+ */
+export function anthropicOAuthClientHeaders(
+  beta: string | undefined,
+  sessionId: string,
+): Record<string, string> {
+  return {
+    'anthropic-beta': mergeOAuthBetaHeader(beta),
+    'x-app': 'cli',
+    'User-Agent': `claude-cli/${ANTHROPIC_OAUTH_CLIENT_VERSION} (external, cli)`,
+    'X-Claude-Code-Session-Id': sessionId,
+  }
+}
+
+let cachedDeviceId: string | undefined
+/** 进程内稳定的 device_id（真实官方客户端会持久化；此处够分类器识别即可，可经 env 固定）。 */
+function deviceId(): string {
+  if (!cachedDeviceId) {
+    cachedDeviceId = process.env['OTTO_ANTHROPIC_OAUTH_DEVICE_ID'] || randomUUID()
+  }
+  return cachedDeviceId
+}
+
+/** body.metadata.user_id——与真实官方客户端同构（device_id / account_uuid / session_id 的 JSON 串）。 */
+export function anthropicOAuthRequestMetadata(sessionId: string, accountUuid = ''): { user_id: string } {
+  return {
+    user_id: JSON.stringify({
+      device_id: deviceId(),
+      account_uuid: accountUuid,
+      session_id: sessionId,
+    }),
+  }
+}
+
+/**
+ * 在 system 数组首部插入官方客户端身份块（幂等：已是首块则原样返回）。
+ * 插在最前 == 落在 `buildSystemBlocks` 的稳定前缀断点之前，故进同一缓存前缀。
+ */
+export function prependAnthropicOAuthIdentity(
+  blocks: WireSystemTextBlock[] | undefined,
+): WireSystemTextBlock[] {
+  const prefix: WireSystemTextBlock = { type: 'text', text: ANTHROPIC_OAUTH_SYSTEM_PREFIX }
+  if (!blocks || blocks.length === 0) {
+    return [prefix]
+  }
+  if (blocks[0]?.text === ANTHROPIC_OAUTH_SYSTEM_PREFIX) {
+    return blocks
+  }
+  return [prefix, ...blocks]
+}