@codehz/ai 0.1.2 → 0.1.4

package/src/adapters/ollama.ts

@@ -28,7 +28,7 @@ import {
 } from "../helpers/mapping.js";
 import { emitMalformedStreamWarning } from "../helpers/adapter-auxiliary.js";
 
-import type { AdapterCapabilities, NormalizedRequest, AIStreamEvent, EventFactory, OutputItem, FetchFn } from "../index.js";
+import type { NormalizedRequest, AIStreamEvent, EventFactory, OutputItem, FetchFn } from "../index.js";
 
 // ── 选项类型 ──────────────────────────────────────────────────
 
@@ -207,37 +207,29 @@ function rollbackTrailingAssistantMessages(messages: OllamaMessage[]): void {
 }
 
 function isOllamaToolCalls(value: unknown): value is OllamaToolCall[] {
-  return Array.isArray(value) && value.every((entry) => {
-    if (!entry || typeof entry !== "object" || !("function" in entry)) return false;
-    const fn = (entry as { function?: unknown }).function;
-    return (
-      !!fn &&
-      typeof fn === "object" &&
-      "name" in fn &&
-      typeof (fn as { name?: unknown }).name === "string" &&
-      "arguments" in fn &&
-      typeof (fn as { arguments?: unknown }).arguments === "object" &&
-      (fn as { arguments?: unknown }).arguments !== null
-    );
-  });
+  return (
+    Array.isArray(value) &&
+    value.every((entry) => {
+      if (!entry || typeof entry !== "object" || !("function" in entry)) return false;
+      const fn = (entry as { function?: unknown }).function;
+      return (
+        !!fn &&
+        typeof fn === "object" &&
+        "name" in fn &&
+        typeof (fn as { name?: unknown }).name === "string" &&
+        "arguments" in fn &&
+        typeof (fn as { arguments?: unknown }).arguments === "object" &&
+        (fn as { arguments?: unknown }).arguments !== null
+      );
+    })
+  );
 }
 
 // ── Adapter ───────────────────────────────────────────────────
 
 export class OllamaAdapter extends AdapterBase {
   readonly kind = "ollama" as const;
-  readonly capabilities: AdapterCapabilities = {
-    nativeStreaming: true,
-    messageStreaming: true,
-    reasoningStreaming: false,
-    toolCallStreaming: false,
-    hiddenReasoningReplay: "none" as const,
-    replayFidelity: "low" as const,
-    tools: true,
-    usage: "partial" as const,
-    billing: "none" as const,
-    providerMetadata: false,
-  };
+  readonly nativeStreaming = true;
 
   private baseUrl: string;
   private apiKey: string | undefined;
@@ -275,7 +267,10 @@ export class OllamaAdapter extends AdapterBase {
                 : item.role === "user"
                   ? "user"
                   : "assistant";
-          messages.push({ role, content: contentBlocksToText(ensureOllamaTextBlocks(item.content, `input message (${item.role}) content`)) });
+          messages.push({
+            role,
+            content: contentBlocksToText(ensureOllamaTextBlocks(item.content, `input message (${item.role}) content`)),
+          });
           break;
         }
         case "tool_call": {
@@ -312,7 +307,12 @@ export class OllamaAdapter extends AdapterBase {
         }
         case "opaque": {
           // Best-effort restore from opaque replay
-          if (item.source === "ollama" && item.purpose === "replay" && typeof item.payload === "object" && item.payload !== null) {
+          if (
+            item.source === "ollama" &&
+            item.purpose === "replay" &&
+            typeof item.payload === "object" &&
+            item.payload !== null
+          ) {
             const payload = item.payload as Record<string, unknown>;
             if (payload.role === "assistant" && typeof payload.content === "string") {
               rollbackTrailingAssistantMessages(messages);
@@ -406,7 +406,6 @@ export class OllamaAdapter extends AdapterBase {
 
     try {
       while (true) {
-        // oxlint-disable-next-line no-await-in-loop
         const { done, value } = await reader.read();
         if (done) break;
 
@@ -489,9 +488,10 @@ export class OllamaAdapter extends AdapterBase {
                 {
                   inputTokens: chunk.prompt_eval_count,
                   outputTokens: chunk.eval_count,
-                  totalTokens: chunk.prompt_eval_count !== undefined && chunk.eval_count !== undefined
-                    ? chunk.prompt_eval_count + chunk.eval_count
-                    : undefined,
+                  totalTokens:
+                    chunk.prompt_eval_count !== undefined && chunk.eval_count !== undefined
+                      ? chunk.prompt_eval_count + chunk.eval_count
+                      : undefined,
                 },
                 "final",
                 {
@@ -520,7 +520,6 @@ export class OllamaAdapter extends AdapterBase {
               );
             }
 
-            // oxlint-disable-next-line no-await-in-loop
             const auxiliaryResult = await auxiliary.finalize(factory);
             for (const event of auxiliaryResult.events) {
               yield event;

package/src/adapters/responses.ts

@@ -25,7 +25,6 @@ import { emitMalformedStreamWarning } from "../helpers/adapter-auxiliary.js";
 
 import { parseSSEEvents } from "../helpers/sse-parser.js";
 
-import { CAPABILITY_MATRIX } from "../index.js";
 import type { NormalizedRequest, AIStreamEvent, EventFactory, OutputItem, FetchFn } from "../index.js";
 
 // ── 类型 ──────────────────────────────────────────────────────
@@ -165,9 +164,7 @@ function parseSSE(chunk: string): { events: ResponsesSSEEvent[]; rest: string; m
 
 function isReplayCanonicalInput(item: ResponsesInputItem): boolean {
   return (
-    (item.type === "message" && item.role === "assistant") ||
-    item.type === "reasoning" ||
-    item.type === "function_call"
+    (item.type === "message" && item.role === "assistant") || item.type === "reasoning" || item.type === "function_call"
   );
 }
 
@@ -194,7 +191,7 @@ function canonicalToResponsesBlock(b: import("../index.js").ContentBlock): Respo
 
 export class ResponsesAdapter extends AdapterBase {
   readonly kind = "responses" as const;
-  readonly capabilities = CAPABILITY_MATRIX.responses;
+  readonly nativeStreaming = true;
 
   private apiKey: string;
   private baseUrl: string;
@@ -453,9 +450,9 @@ export class ResponsesAdapter extends AdapterBase {
       if (completedResponse.usage) {
         auxiliary.recordUsage(
           {
-          inputTokens: completedResponse.usage.input_tokens,
-          outputTokens: completedResponse.usage.output_tokens,
-          totalTokens: completedResponse.usage.total_tokens,
+            inputTokens: completedResponse.usage.input_tokens,
+            outputTokens: completedResponse.usage.output_tokens,
+            totalTokens: completedResponse.usage.total_tokens,
           },
           "final",
           completedResponse.usage,

package/src/core/validation.ts

@@ -122,10 +122,20 @@ function validateInputItem(item: unknown, field: string, issues: ValidationIssue
       return;
     case "tool_result":
       if (typeof item.callId !== "string" || item.callId.length === 0) {
-        pushIssue(issues, `${field}.callId`, "TOOL_RESULT_CALL_ID_INVALID", `${field}.callId must be a non-empty string`);
+        pushIssue(
+          issues,
+          `${field}.callId`,
+          "TOOL_RESULT_CALL_ID_INVALID",
+          `${field}.callId must be a non-empty string`,
+        );
       }
       if (typeof item.toolName !== "string" || item.toolName.length === 0) {
-        pushIssue(issues, `${field}.toolName`, "TOOL_RESULT_NAME_INVALID", `${field}.toolName must be a non-empty string`);
+        pushIssue(
+          issues,
+          `${field}.toolName`,
+          "TOOL_RESULT_NAME_INVALID",
+          `${field}.toolName must be a non-empty string`,
+        );
       }
       if (typeof item.outcome !== "string" || !TOOL_RESULT_OUTCOMES.has(item.outcome)) {
         pushIssue(
@@ -180,12 +190,7 @@ function validateTools(tools: unknown, issues: ValidationIssue[]): void {
     }
 
     if (!isRecord(tool.inputSchema)) {
-      pushIssue(
-        issues,
-        `${field}.inputSchema`,
-        "TOOL_INPUT_SCHEMA_INVALID",
-        `${field}.inputSchema must be an object`,
-      );
+      pushIssue(issues, `${field}.inputSchema`, "TOOL_INPUT_SCHEMA_INVALID", `${field}.inputSchema must be an object`);
     }
   }
 }
@@ -193,8 +198,13 @@ function validateTools(tools: unknown, issues: ValidationIssue[]): void {
 function validateToolChoice(toolChoice: unknown, issues: ValidationIssue[]): void {
   if (toolChoice === undefined) return;
   if (toolChoice === "auto" || toolChoice === "none") return;
-  if (!isRecord(toolChoice) || toolChoice.type !== "tool" || typeof toolChoice.name !== "string" || toolChoice.name.length === 0) {
-    pushIssue(issues, "toolChoice", "TOOL_CHOICE_INVALID", "toolChoice must be auto, none, or { type: \"tool\", name }");
+  if (
+    !isRecord(toolChoice) ||
+    toolChoice.type !== "tool" ||
+    typeof toolChoice.name !== "string" ||
+    toolChoice.name.length === 0
+  ) {
+    pushIssue(issues, "toolChoice", "TOOL_CHOICE_INVALID", 'toolChoice must be auto, none, or { type: "tool", name }');
   }
 }
 
@@ -211,12 +221,7 @@ export function validateRequest(request: AIRequest): ValidationIssue[] {
     } else if (Array.isArray(request.instructions)) {
       validateContentArray(request.instructions, "instructions", issues, "INSTRUCTIONS_INVALID");
     } else {
-      pushIssue(
-        issues,
-        "instructions",
-        "INSTRUCTIONS_INVALID",
-        "instructions must be a string or ContentBlock[]",
-      );
+      pushIssue(issues, "instructions", "INSTRUCTIONS_INVALID", "instructions must be a string or ContentBlock[]");
     }
   }
 

package/src/helpers/adapter-auxiliary.ts

@@ -1,7 +1,6 @@
 import { WarningCode } from "../core/errors.js";
 import type { EventFactory } from "../core/event-factory.js";
 import type {
-  AdapterCapabilities,
   AIStreamEvent,
   BillingInfo,
   NormalizedRequest,
@@ -18,7 +17,6 @@ export type BillingPostprocessHook = (context: {
   usage?: Usage;
   billing?: BillingInfo;
   auxiliary?: AuxiliaryInfo;
-  capabilities: AdapterCapabilities;
 }) => MaybePromise<Partial<BillingInfo> | undefined>;
 
 export type AuxiliaryFinalizeOptions = {
@@ -41,10 +39,7 @@ export class AdapterAuxiliaryState {
   private readonly collector = new AuxiliaryCollector();
   private readonly metadataSources = new Set<string>();
 
-  constructor(
-    private readonly request: NormalizedRequest,
-    private readonly capabilities: AdapterCapabilities,
-  ) {}
+  constructor(private readonly request: NormalizedRequest) {}
 
   recordUsage(usage: Partial<Usage>, source: UsageSource, raw?: unknown): void {
     if (this.request.include?.usage === "off" || isEmptyRecord(usage)) return;
@@ -75,7 +70,6 @@ export class AdapterAuxiliaryState {
           usage: snapshot.usage,
           billing: snapshot.billing,
           auxiliary: snapshot.auxiliary,
-          capabilities: this.capabilities,
         });
         if (derived && !isEmptyRecord(derived)) {
           this.collector.recordBilling(
@@ -105,7 +99,9 @@ export class AdapterAuxiliaryState {
     }
 
     if (this.request.include?.usage !== "off" && !built.usage) {
-      events.push(factory.responseWarning("Usage information was not provided by the provider", WarningCode.USAGE_MISSING));
+      events.push(
+        factory.responseWarning("Usage information was not provided by the provider", WarningCode.USAGE_MISSING),
+      );
     }
 
     if (this.request.include?.billing !== "off") {

package/src/helpers/adapter-base.ts

@@ -14,7 +14,6 @@
 import type {
   NormalizedRequest,
   BackendAdapter,
-  AdapterCapabilities,
   AIStreamEvent,
   AIResponse,
   AuxiliaryInfo,
@@ -56,7 +55,7 @@ export type StreamResult = {
 
 export abstract class AdapterBase implements BackendAdapter {
   abstract readonly kind: "chat-completions" | "messages" | "responses" | "ollama" | "mock";
-  abstract readonly capabilities: AdapterCapabilities;
+  abstract readonly nativeStreaming: boolean;
 
   /**
    * stream 模板方法：
@@ -67,7 +66,7 @@ export abstract class AdapterBase implements BackendAdapter {
   async *stream(request: NormalizedRequest): AsyncIterable<AIStreamEvent> {
     const factory = createEventFactory({
       responseId: request.requestId,
-      backend: { kind: this.kind, isSynthetic: !this.capabilities.nativeStreaming },
+      backend: { kind: this.kind, isSynthetic: !this.nativeStreaming },
     });
 
     yield factory.responseStarted(request.model);
@@ -113,7 +112,10 @@ export abstract class AdapterBase implements BackendAdapter {
   protected buildResponse(request: NormalizedRequest, result: StreamResult, _factory: EventFactory): AIResponse {
     const text = this.extractText(result.output);
     const warnings = mergeWarnings(result.warnings, _factory.warnings);
-    const auxiliary = mergeAuxiliary(result.auxiliary, result.providerMetadata ? { providerMetadata: result.providerMetadata } : undefined);
+    const auxiliary = mergeAuxiliary(
+      result.auxiliary,
+      result.providerMetadata ? { providerMetadata: result.providerMetadata } : undefined,
+    );
 
     return {
       id: request.requestId,
@@ -130,7 +132,7 @@ export abstract class AdapterBase implements BackendAdapter {
         requestId: request.requestId,
         rawResponseId: result.rawResponseId,
         adapter: this.kind,
-        isSyntheticStream: !this.capabilities.nativeStreaming,
+        isSyntheticStream: !this.nativeStreaming,
         metadataSources: result.metadataSources,
         warnings,
       },
@@ -143,14 +145,11 @@ export abstract class AdapterBase implements BackendAdapter {
   }
 
   protected createAuxiliaryState(request: NormalizedRequest): AdapterAuxiliaryState {
-    return new AdapterAuxiliaryState(request, this.capabilities);
+    return new AdapterAuxiliaryState(request);
   }
 }
 
-function mergeAuxiliary(
-  base?: Partial<AuxiliaryInfo>,
-  patch?: Partial<AuxiliaryInfo>,
-): AuxiliaryInfo | undefined {
+function mergeAuxiliary(base?: Partial<AuxiliaryInfo>, patch?: Partial<AuxiliaryInfo>): AuxiliaryInfo | undefined {
   if (!base && !patch) return undefined;
 
   const merged: AuxiliaryInfo = {

package/src/helpers/index.ts

@@ -28,11 +28,7 @@ export type { SSEEvent } from "./sse-parser.js";
 
 export { AdapterBase } from "./adapter-base.js";
 export type { StreamResult } from "./adapter-base.js";
-export {
-  AdapterAuxiliaryState,
-  emitMalformedStreamWarning,
-  metadataSourceList,
-} from "./adapter-auxiliary.js";
+export { AdapterAuxiliaryState, emitMalformedStreamWarning, metadataSourceList } from "./adapter-auxiliary.js";
 export type { AuxiliaryFinalizeOptions, AuxiliaryFinalizeResult, BillingPostprocessHook } from "./adapter-auxiliary.js";
 export { syntheticStream } from "./synthetic-stream.js";
 export type { SyntheticStreamOptions } from "./synthetic-stream.js";

package/src/types/adapter.ts

@@ -2,7 +2,6 @@
  * BackendAdapter — adapter 内部协议和 client 公开类型
  *
  * adapter 对前台只暴露一个统一适配点。
- * 能力矩阵在此落成代码而非仅存在于文档。
  */
 
 import type { AIRequest } from "./request.js";
@@ -20,91 +19,11 @@ export type NormalizedRequest = AIRequest & {
   requestId: string;
 };
 
-// ── 能力矩阵 ──────────────────────────────────────────────────
-
-export type AdapterCapabilities = {
-  nativeStreaming: boolean;
-  messageStreaming: boolean;
-  reasoningStreaming: boolean;
-  toolCallStreaming: boolean;
-  hiddenReasoningReplay: "full" | "partial" | "none";
-  replayFidelity: "high" | "medium" | "low";
-  tools: boolean;
-  usage: "full" | "partial" | "none";
-  billing: "direct" | "lookup" | "derived" | "none";
-  providerMetadata: boolean;
-};
-
-// ── 能力矩阵常量（文档中的能力表在此落代码） ────────────────
-
-export const CAPABILITY_MATRIX = {
-  responses: {
-    nativeStreaming: true,
-    messageStreaming: true,
-    reasoningStreaming: true,
-    toolCallStreaming: true,
-    hiddenReasoningReplay: "full" as const,
-    replayFidelity: "high" as const,
-    tools: true,
-    usage: "full" as const,
-    billing: "lookup" as const,
-    providerMetadata: true,
-  },
-  messages: {
-    nativeStreaming: true,
-    messageStreaming: true,
-    reasoningStreaming: false, // 条件支持，默认 false
-    toolCallStreaming: true,
-    hiddenReasoningReplay: "partial" as const,
-    replayFidelity: "medium" as const,
-    tools: true,
-    usage: "full" as const,
-    billing: "lookup" as const,
-    providerMetadata: true,
-  },
-  "chat.completions": {
-    nativeStreaming: true,
-    messageStreaming: true,
-    reasoningStreaming: false,
-    toolCallStreaming: false, // 中，默认 false
-    hiddenReasoningReplay: "none" as const,
-    replayFidelity: "low" as const,
-    tools: true,
-    usage: "full" as const,
-    billing: "derived" as const,
-    providerMetadata: false,
-  },
-  ollama: {
-    nativeStreaming: true,
-    messageStreaming: true,
-    reasoningStreaming: false,
-    toolCallStreaming: false,
-    hiddenReasoningReplay: "none" as const,
-    replayFidelity: "low" as const,
-    tools: true,
-    usage: "partial" as const,
-    billing: "none" as const,
-    providerMetadata: false,
-  },
-  mock: {
-    nativeStreaming: false,
-    messageStreaming: true,
-    reasoningStreaming: false,
-    toolCallStreaming: true,
-    hiddenReasoningReplay: "none" as const,
-    replayFidelity: "high" as const,
-    tools: true,
-    usage: "none" as const,
-    billing: "none" as const,
-    providerMetadata: true,
-  },
-} as const satisfies Record<string, AdapterCapabilities>;
-
 // ── Adapter 接口 ──────────────────────────────────────────────
 
 export interface BackendAdapter {
   readonly kind: "chat-completions" | "messages" | "responses" | "ollama" | "mock";
-  readonly capabilities: AdapterCapabilities;
+  readonly nativeStreaming: boolean;
   stream(request: NormalizedRequest): AsyncIterable<AIStreamEvent>;
 }
 

package/src/types/index.ts

@@ -46,14 +46,4 @@ export type {
 } from "./events.js";
 
 // Adapter 协议和 client 类型
-export type {
-  BackendAdapter,
-  AdapterCapabilities,
-  FetchFn,
-  NormalizedRequest,
-  CreateAIClientOptions,
-  AIClient,
-} from "./adapter.js";
-
-// 能力矩阵常量
-export { CAPABILITY_MATRIX } from "./adapter.js";
+export type { BackendAdapter, FetchFn, NormalizedRequest, CreateAIClientOptions, AIClient } from "./adapter.js";