@x-otto/cli 0.0.1-alpha.0

package/dist/bundled-extensions/plugin-otto-wire-protocols/src/anthropic-usage.ts

@@ -0,0 +1,81 @@
+/**
+ * provider-usage.ts — 供应商 usage 快照解析（状态栏「周/小时额度」展示，非错误路径）。
+ *
+ * 与 stream-errors.ts 的 extractAnthropicRateLimit 不同：那个函数只在**错误对象**（429 响应）
+ * 上解析 anthropic-ratelimit-unified-* 头族，用于判定是否硬额度耗尽。本文件解析**成功响应**的
+ * 同一头族——Anthropic SDK 的 `MessageStream.response` 在流正常结束后仍可访问底层 Response。
+ *
+ * 头名字经业界终端 Agent 实现反编译源码交叉验证（src/services/claudeAiLimits.ts）：
+ *   - 状态/类型/重置时间：`anthropic-ratelimit-unified-status`、`unified-representative-claim`、
+ *     `unified-reset`——三字段有双源证据（SDK source map 反编译 + Anthropic 官方 Rate Limits 文档）
+ *   - 各 bucket 的使用率：`anthropic-ratelimit-unified-{5h|7d}-utilization`（0-1 小数，需归一化
+ *     为百分比）。此前猜测的三个候选名（unified-utilization/remaining-percentage/used-percentage）
+ *     均为伪名——导致已用百分比在线上永远为 undefined，本次修复（2026-07-04 终局 review 发现）。
+ *
+ * ProviderUsageSnapshot 类型定义在 @x-otto/interchange（零依赖协议叶子），本文件只做解析实现。
+ */
+import { headerGet } from '@x-otto/shared'
+import type { ProviderUsageSnapshot } from '@x-otto/interchange'
+
+/** limitType → bucket 缩写（用于拼接 `anthropic-ratelimit-unified-{abbr}-utilization` 头名） */
+const LIMIT_TYPE_ABBREVIATION: Record<string, string> = {
+  five_hour: '5h',
+  seven_day: '7d',
+  seven_day_opus: '7d',
+  seven_day_sonnet: '7d',
+  seven_day_overage_included: '7d',
+}
+
+/**
+ * 从 per-bucket utilization 头读取已用百分比（0-1 小数，归一化为 0-100 整数）。
+ * 头名格式 `anthropic-ratelimit-unified-{abbr}-utilization`，abbr 由 limitType 映射。
+ * 若 limitType 未知或对应头不存在 → undefined（不编造，不猜测）。
+ */
+function readBucketUtilization(
+  headers: Headers | Record<string, string>,
+  limitType: string | undefined,
+): number | undefined {
+  if (!limitType) return undefined
+  const abbr = LIMIT_TYPE_ABBREVIATION[limitType]
+  if (!abbr) return undefined
+  const raw = headerGet(headers, `anthropic-ratelimit-unified-${abbr}-utilization`)
+  if (raw === undefined) return undefined
+  const n = Number(raw)
+  if (!Number.isFinite(n)) return undefined
+  return Math.round(n * 100) // 0-1 → 0-100
+}
+
+/**
+ * 从成功响应的 Headers 中解析供应商 usage 快照。
+ * 仅在 `anthropic-ratelimit-unified-status` 存在时返回非 null（无该头族 = 非 Anthropic OAuth
+ * 订阅计划的请求，如 API key 走标准 RPM/TPM 限流，没有 unified 头族——调用方据此天然实现
+ * "API key 不显示"，见 packages/ai/src/auth-store.ts getAuthSource）。
+ */
+export function extractProviderUsageFromHeaders(
+  headers: Headers | Record<string, string> | null | undefined,
+): ProviderUsageSnapshot | null {
+  if (!headers) return null
+  const status = headerGet(headers, 'anthropic-ratelimit-unified-status')
+  if (status !== 'allowed' && status !== 'allowed_warning' && status !== 'rejected') return null
+
+  const limitType = headerGet(headers, 'anthropic-ratelimit-unified-representative-claim')
+  const resetRaw = headerGet(headers, 'anthropic-ratelimit-unified-reset')
+
+  // Overage（额外用量池）——仅 Anthropic OAuth 订阅计划带有此头族
+  const overageStatus = headerGet(headers, 'anthropic-ratelimit-unified-overage-status')
+  const overageResetRaw = headerGet(headers, 'anthropic-ratelimit-unified-overage-reset')
+  const overageDisabledReason = headerGet(
+    headers,
+    'anthropic-ratelimit-unified-overage-disabled-reason',
+  )
+
+  return {
+    status,
+    limitType: limitType as ProviderUsageSnapshot['limitType'],
+    resetsAt: resetRaw ? Number(resetRaw) : undefined,
+    usedPercent: readBucketUtilization(headers, limitType),
+    overageStatus: overageStatus as ProviderUsageSnapshot['overageStatus'],
+    overageResetsAt: overageResetRaw ? Number(overageResetRaw) : undefined,
+    overageDisabledReason,
+  }
+}

package/dist/bundled-extensions/plugin-otto-wire-protocols/src/openai-completions.ts

@@ -0,0 +1,158 @@
+import { randomUUID } from 'node:crypto'
+
+import { ProviderError } from '@x-otto/shared'
+import {
+  buildChatCompletionsBody,
+  buildRequestHeaders,
+  registeredToolNames,
+  streamChatCompletions,
+} from '@x-otto/provider'
+
+import type {
+  Model,
+  ResolvedAuth,
+  StreamContext,
+  StreamEvent,
+  StreamOptions,
+  ProviderStream,
+  TokenDerivedHeader,
+  WireProtocolLogger,
+  WireRequestCustomization,
+  WireRequestCustomizeInput,
+} from '@x-otto/provider'
+
+/** RFC-185 D3：日志走宿主注入端口，缺省 no-op——插件源码禁 createLogger（防第二单例直写 stderr）。 */
+const noopLogger: WireProtocolLogger = { debug: () => {}, info: () => {}, warn: () => {}, error: () => {} }
+
+/**
+ * 通用 OpenAI Chat Completions provider（对标 opencode/pi 的 openai-compatible 基座）。
+ *
+ * 服务一切 Chat Completions 兼容的厂商（DeepSeek、未来的 OpenAI/groq/openrouter 等）：
+ * - baseURL 取自 `model.baseUrl`（`${baseUrl}/chat/completions`）
+ * - 凭据按 `model.provider` 解析（注入的 resolveKey 接收 provider 名）
+ * - Bearer 鉴权，SSE 流式（含 reasoning_content → thinking）
+ *
+ * SSE 解析循环统一走 streamChatCompletions（RFC-074 R-AICHAT），本文件只负责凭据/url/body。
+ * Copilot 走自己的 provider（带 copilot 专用头）；本 provider 不绑定任何厂商。
+ *
+ * RFC-122 D3：支持声明式 `tokenDerivedHeaders`（插件 provider 轴），JWT claim 值提取后注入请求头。
+ */
+export type OpenAICompletionsCredentialResolver = (provider: string) => Promise<string | undefined>
+
+// RFC-122 D3：TokenDerivedHeader 定义单一真源在 @x-otto/provider（协议中立层，见该包
+// types.ts 头注释）——此前本文件与 openai-responses.ts 各自重复定义一份相同形状，
+// 终局 review 收敛为直接 import，避免两份定义静默漂移。
+
+export interface OpenAICompletionsProviderOptions {
+  resolveKey?: OpenAICompletionsCredentialResolver
+  /** RFC-122 D3：静态额外 headers（如 vendor 自定义头）。 */
+  headers?: Record<string, string>
+  /** RFC-122 D3：JWT claim 派生 headers。 */
+  tokenDerivedHeaders?: TokenDerivedHeader[]
+  /**
+   * RFC-270 D2：程序化请求定制点（拦截器）。此前只有 anthropic-messages 消费该钩子，
+   * 本协议补齐——返回的 `defaultHeaders` 并入头管线第 ④ 档。`transformSystemBlocks`
+   * 不适用于本协议（system 表达形态不同），按 `WireRequestCustomization` 契约忽略。
+   */
+  customizeRequest?: (input: WireRequestCustomizeInput) => WireRequestCustomization
+  /** RFC-270 D3：manifest 显式声明后，允许自定义头覆盖鉴权头（企业网关换鉴权）。 */
+  allowAuthHeaderOverride?: boolean
+  /** RFC-185 D3：宿主注入的日志端口，缺省 no-op。 */
+  logger?: WireProtocolLogger
+}
+
+class OpenAICompletionsStream implements ProviderStream {
+  readonly id = 'openai-completions'
+  readonly displayName = 'OpenAI Chat Completions'
+
+  /**
+   * 进程内稳定的会话 id——供 `customizeRequest` 定制器使用（对齐 anthropic-messages
+   * 的同名字段，RFC-270 D2 终局 review F2：此前本协议无 sessionId，钩子入参无法构造）。
+   */
+  private readonly requestSessionId = randomUUID()
+
+  constructor(
+    private readonly resolveCredential?: OpenAICompletionsCredentialResolver,
+    private readonly extraHeaders?: Record<string, string>,
+    private readonly tokenDerivedHeaders?: TokenDerivedHeader[],
+    private readonly logger: WireProtocolLogger = noopLogger,
+    /** 见 `OpenAICompletionsProviderOptions.customizeRequest`。缺省 = 零定制。 */
+    private readonly customizeRequest?: (input: WireRequestCustomizeInput) => WireRequestCustomization,
+    private readonly allowAuthHeaderOverride?: boolean,
+  ) {}
+
+  /** 统一鉴权解析（RFC-140 D5，`ProviderStream.resolveAuth`）——恒 api_key 模式。 */
+  async resolveAuth(model: Model): Promise<ResolvedAuth> {
+    if (this.resolveCredential) {
+      const key = await this.resolveCredential(model.provider)
+      if (key) {
+        return { token: key, mode: 'api_key' }
+      }
+    }
+    throw new ProviderError(
+      `Missing credential for provider '${model.provider}' (openai-completions).`,
+      { code: 'PROVIDER_AUTH_MISSING' },
+    )
+  }
+
+  async *converse(
+    model: Model,
+    context: StreamContext,
+    options: StreamOptions,
+    signal: AbortSignal,
+  ): AsyncIterable<StreamEvent> {
+    const auth = await this.resolveAuth(model)
+    const key = auth.token
+
+    this.logger.debug({ model: model.id, provider: model.provider }, 'Starting Chat Completions stream')
+
+    // RFC-270 D1：头组装收敛到 @x-otto/provider 的统一管线（此前本文件的合并顺序是
+    // `{ authorization, ...extraHeaders }`——自定义头覆盖鉴权头，与 openai-responses.ts
+    // 恰好相反且其注释谎称一致；管线统一为鉴权头 write-last 不可被覆盖）。
+    const customization = this.customizeRequest?.({
+      auth: { mode: auth.mode, beta: auth.beta },
+      sessionId: this.requestSessionId,
+    })
+
+    const headers = buildRequestHeaders({
+      staticHeaders: this.extraHeaders,
+      tokenDerived: this.tokenDerivedHeaders?.length
+        ? { headers: this.tokenDerivedHeaders, token: key }
+        : undefined,
+      customized: customization?.defaultHeaders,
+      auth: { authorization: `Bearer ${key}` },
+      allowAuthHeaderOverride: this.allowAuthHeaderOverride,
+      logger: this.logger,
+      diagnosticLabel: `openai-completions:${model.provider}`,
+    })
+
+    yield* streamChatCompletions({
+      url: `${model.baseUrl}/chat/completions`,
+      headers,
+      body: buildChatCompletionsBody(model, context),
+      identity: { api: model.api, provider: model.provider, model: model.id },
+      signal,
+      timeout: options.timeout,
+      // RFC-XX reasoning-thinking：reasoning 模型的 thinking 阶段可能长达分钟级零
+      // visible token——中间无任何 SSE chunk，默认 120s idle 会无差别单边坑所有 reasoning
+      // 模型（实测 turn 3 触发：thinking_start → 零输出 → stream.retry×2 → 崩）。
+      // 此处给 reasoning 模型显式加大 idle 苟（300s），非 reasoning 模型保持默认 120s。
+      idleTimeout: model.reasoning ? 300_000 : undefined,
+      // RFC-232（终局修正）：跨 wire 协议救回违约响应，见 @x-otto/provider stream-state.ts。
+      registeredToolNames: registeredToolNames(context.tools),
+    })
+  }
+}
+
+export function createOpenAICompletionsProvider(
+  options: OpenAICompletionsProviderOptions = {},
+): ProviderStream {
+  return new OpenAICompletionsStream(
+    options.resolveKey,
+    options.headers,
+    options.tokenDerivedHeaders,
+    options.logger,
+    options.customizeRequest,
+    options.allowAuthHeaderOverride,
+  )
+}