@didim365/agent-cli-core 0.1.0

package/dist/src/providers/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Provider-independent types and utilities for multi-LLM support.
+ *
+ * This module exports the unified type system that abstracts away
+ * provider-specific details (Gemini, Claude, OpenAI, vLLM).
+ *
+ * @see docs/ai_adapter/03-technical-design.md
+ */
+export * from './baseAdapter.js';
+export * from './registry.js';
+export * from './factory.js';
+export * from './streamAssembler.js';
+export * from './configAdapter.js';
+export * from './modelSpec.js';
+export * from './contentResolver.js';
+export * from './providerTypes.js';
+export * from './providerConfig.js';
+export * from './providerSelector.js';
+export * from './providerConfigIntegration.js';
+export * from './types.js';
+export * from './events.js';
+export * from './errors.js';
+export * from './telemetryBridge.js';
+export * from './legacyAliases.js';
+import * as Gemini from './gemini/index.js';
+export { Gemini };
+import * as Claude from './claude/index.js';
+export { Claude };
+import * as OpenAi from './openai/index.js';
+export { OpenAi };
+import * as OpenAiCompatible from './openai-compatible/index.js';
+export { OpenAiCompatible };

package/dist/src/providers/index.js

@@ -0,0 +1,68 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Provider-independent types and utilities for multi-LLM support.
+ *
+ * This module exports the unified type system that abstracts away
+ * provider-specific details (Gemini, Claude, OpenAI, vLLM).
+ *
+ * @see docs/ai_adapter/03-technical-design.md
+ */
+// Adapter base classes
+export * from './baseAdapter.js';
+// Provider registry
+export * from './registry.js';
+// Provider factory
+export * from './factory.js';
+// Stream assembler
+export * from './streamAssembler.js';
+// Config adapter
+export * from './configAdapter.js';
+// Model specifications
+export * from './modelSpec.js';
+// Content resolver
+export * from './contentResolver.js';
+// Provider types
+export * from './providerTypes.js';
+// Provider config
+export * from './providerConfig.js';
+// Provider selector
+export * from './providerSelector.js';
+// Provider config integration
+export * from './providerConfigIntegration.js';
+// Core types
+export * from './types.js';
+// Event types
+export * from './events.js';
+// Error types
+export * from './errors.js';
+// Telemetry bridge (provider-agnostic telemetry schema)
+export * from './telemetryBridge.js';
+// Legacy aliases (for backward compatibility during migration)
+// Note: These are deprecated and will be removed after full migration
+export * from './legacyAliases.js';
+// Gemini provider types (Phase 2 - M2.0)
+// Exported as namespace to avoid conflict with legacyAliases
+// Use: import { Gemini } from '@didim365/agent-cli-core/providers'
+// Then: Gemini.GeminiEventType, Gemini.ServerGeminiStreamEvent, etc.
+import * as Gemini from './gemini/index.js';
+export { Gemini };
+// Claude provider types (Phase 3 - M3.1)
+// Use: import { Claude } from '@didim365/agent-cli-core/providers'
+// Then: Claude.ClaudeAdapter, Claude.bootstrapClaudeProvider, etc.
+import * as Claude from './claude/index.js';
+export { Claude };
+// OpenAI provider types (Phase 3 - M3.2)
+// Use: import { OpenAi } from '@didim365/agent-cli-core/providers'
+// Then: OpenAi.OpenAiAdapter, OpenAi.bootstrapOpenAiProvider, etc.
+import * as OpenAi from './openai/index.js';
+export { OpenAi };
+// OpenAI-compatible provider types (Phase 3 - M3.3)
+// Use: import { OpenAiCompatible } from '@didim365/agent-cli-core/providers'
+// Then: OpenAiCompatible.OpenAiCompatibleAdapter, etc.
+import * as OpenAiCompatible from './openai-compatible/index.js';
+export { OpenAiCompatible };
+//# sourceMappingURL=index.js.map

package/dist/src/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AAEH,uBAAuB;AACvB,cAAc,kBAAkB,CAAC;AAEjC,oBAAoB;AACpB,cAAc,eAAe,CAAC;AAE9B,mBAAmB;AACnB,cAAc,cAAc,CAAC;AAE7B,mBAAmB;AACnB,cAAc,sBAAsB,CAAC;AAErC,iBAAiB;AACjB,cAAc,oBAAoB,CAAC;AAEnC,uBAAuB;AACvB,cAAc,gBAAgB,CAAC;AAE/B,mBAAmB;AACnB,cAAc,sBAAsB,CAAC;AAErC,iBAAiB;AACjB,cAAc,oBAAoB,CAAC;AAEnC,kBAAkB;AAClB,cAAc,qBAAqB,CAAC;AAEpC,oBAAoB;AACpB,cAAc,uBAAuB,CAAC;AAEtC,8BAA8B;AAC9B,cAAc,gCAAgC,CAAC;AAE/C,aAAa;AACb,cAAc,YAAY,CAAC;AAE3B,cAAc;AACd,cAAc,aAAa,CAAC;AAE5B,cAAc;AACd,cAAc,aAAa,CAAC;AAE5B,wDAAwD;AACxD,cAAc,sBAAsB,CAAC;AAErC,+DAA+D;AAC/D,sEAAsE;AACtE,cAAc,oBAAoB,CAAC;AAEnC,yCAAyC;AACzC,6DAA6D;AAC7D,mEAAmE;AACnE,qEAAqE;AACrE,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,yCAAyC;AACzC,mEAAmE;AACnE,mEAAmE;AACnE,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,yCAAyC;AACzC,mEAAmE;AACnE,mEAAmE;AACnE,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,oDAAoD;AACpD,6EAA6E;AAC7E,uDAAuD;AACvD,OAAO,KAAK,gBAAgB,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/src/providers/legacyAliases.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Legacy type aliases for backward compatibility during migration.
+ *
+ * This module provides aliases from @google/genai types to the new
+ * provider-independent types. These aliases will be deprecated after
+ * the migration is complete.
+ *
+ * @deprecated Use types from './types.js' directly instead.
+ * @see docs/ai_adapter/migration-plan.md
+ */
+import type { LlmMessage, LlmContent, LlmTextContent, LlmImageContent, LlmToolCallContent, LlmToolResultContent, LlmGenerateRequest, LlmGenerateResponse, LlmTokenUsage, LlmToolDefinition, LlmToolParameters, LlmToolProperty, LlmStopReason } from './types.js';
+import type { LlmEventType, LlmEvent } from './events.js';
+import type { LlmError, LlmErrorType } from './errors.js';
+/**
+ * @deprecated Use LlmMessage instead.
+ * Alias for backward compatibility with @google/genai Content type.
+ *
+ * WARNING: This is a structural alias only. LlmMessage has a different structure
+ * than @google/genai Content. Use contentToLlmMessage() for conversion.
+ */
+export type Content = LlmMessage;
+/**
+ * @deprecated Use LlmContent instead.
+ * Alias for backward compatibility with @google/genai Part type.
+ */
+export type Part = LlmContent;
+/**
+ * @deprecated Use LlmContent[] instead.
+ * Alias for backward compatibility with @google/genai PartListUnion type.
+ *
+ * WARNING: This is a structural alias only. The actual @google/genai PartListUnion
+ * may have different Part structures. Use partToLlmContent() for conversion.
+ */
+export type PartListUnion = LlmContent | LlmContent[];
+/**
+ * @deprecated Use LlmGenerateRequest instead.
+ * Alias for backward compatibility with @google/genai GenerateContentParameters.
+ */
+export type GenerateContentParameters = LlmGenerateRequest;
+/**
+ * @deprecated Use LlmGenerateResponse instead.
+ * Alias for backward compatibility with @google/genai GenerateContentResponse.
+ */
+export type GenerateContentResponse = LlmGenerateResponse;
+/**
+ * @deprecated Use LlmTokenUsage instead.
+ * Alias for backward compatibility with @google/genai UsageMetadata.
+ */
+export type UsageMetadata = LlmTokenUsage;
+/**
+ * @deprecated Use LlmToolDefinition instead.
+ * Alias for backward compatibility with @google/genai FunctionDeclaration.
+ */
+export type FunctionDeclaration = LlmToolDefinition;
+/**
+ * @deprecated Use LlmToolCallContent instead.
+ * Alias for backward compatibility with @google/genai FunctionCall.
+ */
+export type FunctionCall = LlmToolCallContent;
+/**
+ * @deprecated Use LlmToolResultContent instead.
+ * Alias for backward compatibility with @google/genai FunctionResponse.
+ */
+export type FunctionResponse = LlmToolResultContent;
+/**
+ * @deprecated Use LlmStopReason instead.
+ * Alias for backward compatibility with @google/genai FinishReason.
+ */
+export type FinishReason = LlmStopReason;
+/**
+ * @deprecated Use LlmEventType instead.
+ * Alias for backward compatibility with GeminiEventType.
+ */
+export type GeminiEventType = LlmEventType;
+/**
+ * @deprecated Use LlmEvent instead.
+ * Alias for backward compatibility with ServerGeminiStreamEvent.
+ */
+export type ServerGeminiStreamEvent = LlmEvent;
+export type { LlmMessage, LlmContent, LlmTextContent, LlmImageContent, LlmToolCallContent, LlmToolResultContent, LlmGenerateRequest, LlmGenerateResponse, LlmTokenUsage, LlmToolDefinition, LlmToolParameters, LlmToolProperty, LlmStopReason, };
+export type { LlmEventType, LlmEvent };
+export type { LlmError, LlmErrorType };
+/**
+ * Converts a legacy Content array to LlmMessage array.
+ * @deprecated This is a transitional helper.
+ */
+export declare function contentToLlmMessage(content: Content[], role?: LlmMessage['role']): LlmMessage[];
+/**
+ * Converts LlmMessage to legacy Content format.
+ * @deprecated This is a transitional helper.
+ */
+export declare function llmMessageToContent(messages: LlmMessage[]): Content[];

package/dist/src/providers/legacyAliases.js

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// ============================================================================
+// Migration Helpers
+// ============================================================================
+/**
+ * Converts a legacy Content array to LlmMessage array.
+ * @deprecated This is a transitional helper.
+ */
+export function contentToLlmMessage(content, role = 'user') {
+    return content.map((c) => ({
+        role,
+        content: Array.isArray(c.content) ? c.content : [c.content],
+    }));
+}
+/**
+ * Converts LlmMessage to legacy Content format.
+ * @deprecated This is a transitional helper.
+ */
+export function llmMessageToContent(messages) {
+    return messages;
+}
+//# sourceMappingURL=legacyAliases.js.map

package/dist/src/providers/legacyAliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacyAliases.js","sourceRoot":"","sources":["../../../src/providers/legacyAliases.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2JH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAkB,EAClB,OAA2B,MAAM;IAEjC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,IAAI;QACJ,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAqB,CAAC;KAC1E,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAsB;IACxD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/providers/modelSpec.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Model capability flags.
+ *
+ * Indicates what features a model supports.
+ */
+export interface ModelCapabilities {
+    /** Supports streaming responses */
+    streaming?: boolean;
+    /** Supports image/vision input */
+    vision?: boolean;
+    /** Supports function/tool calling */
+    toolUse?: boolean;
+    /** Supports code execution */
+    codeExecution?: boolean;
+    /** Supports thinking/reasoning mode */
+    thinking?: boolean;
+    /** Supports JSON response format */
+    jsonMode?: boolean;
+    /** Supports structured output */
+    structuredOutput?: boolean;
+}
+/**
+ * Model specification and metadata.
+ *
+ * Contains information about a model including its capabilities,
+ * context limits, and provider details.
+ */
+export interface ModelSpec {
+    /** Model identifier (e.g., 'gemini-2.0-flash') */
+    id: string;
+    /** Human-readable model name */
+    name: string;
+    /** Provider identifier (e.g., 'gemini', 'openai', 'anthropic') */
+    provider: string;
+    /** Model capabilities */
+    capabilities: ModelCapabilities;
+    /** Maximum context window size in tokens */
+    contextWindow?: number;
+    /** Maximum output tokens */
+    maxOutputTokens?: number;
+    /** Model description */
+    description?: string;
+    /** Model aliases (alternative names) */
+    aliases?: string[];
+}
+/**
+ * Input for creating a model spec.
+ */
+export interface ModelSpecInput {
+    id: string;
+    name: string;
+    provider: string;
+    capabilities?: Partial<ModelCapabilities>;
+    contextWindow?: number;
+    maxOutputTokens?: number;
+    description?: string;
+    aliases?: string[];
+}
+/**
+ * Create a model specification with default values.
+ *
+ * @param input - Model specification input
+ * @returns Complete model specification
+ *
+ * @example
+ * ```ts
+ * const spec = createModelSpec({
+ *   id: 'gemini-2.0-flash',
+ *   name: 'Gemini 2.0 Flash',
+ *   provider: 'gemini',
+ *   capabilities: { vision: true, toolUse: true }
+ * });
+ * ```
+ */
+export declare function createModelSpec(input: ModelSpecInput): ModelSpec;
+/**
+ * Get default model specifications.
+ *
+ * Returns a list of pre-configured model specs for common models.
+ *
+ * @returns Array of model specifications
+ */
+export declare function getDefaultModelSpecs(): ModelSpec[];
+/**
+ * Check if a model has a specific capability.
+ *
+ * @param spec - Model specification
+ * @param capability - Capability name to check
+ * @returns True if capability is enabled
+ *
+ * @example
+ * ```ts
+ * if (hasCapability(modelSpec, 'vision')) {
+ *   // Model supports image input
+ * }
+ * ```
+ */
+export declare function hasCapability(spec: ModelSpec, capability: keyof ModelCapabilities): boolean;
+export type { ModelSpec as ModelSpecType };

package/dist/src/providers/modelSpec.js

@@ -0,0 +1,107 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Default capabilities for models.
+ */
+const DEFAULT_CAPABILITIES = {
+    streaming: true,
+    vision: false,
+    toolUse: false,
+    codeExecution: false,
+    thinking: false,
+    jsonMode: false,
+    structuredOutput: false,
+};
+/**
+ * Create a model specification with default values.
+ *
+ * @param input - Model specification input
+ * @returns Complete model specification
+ *
+ * @example
+ * ```ts
+ * const spec = createModelSpec({
+ *   id: 'gemini-2.0-flash',
+ *   name: 'Gemini 2.0 Flash',
+ *   provider: 'gemini',
+ *   capabilities: { vision: true, toolUse: true }
+ * });
+ * ```
+ */
+export function createModelSpec(input) {
+    return {
+        id: input.id,
+        name: input.name,
+        provider: input.provider,
+        capabilities: {
+            ...DEFAULT_CAPABILITIES,
+            ...input.capabilities,
+        },
+        contextWindow: input.contextWindow,
+        maxOutputTokens: input.maxOutputTokens,
+        description: input.description,
+        aliases: input.aliases,
+    };
+}
+/**
+ * Get default model specifications.
+ *
+ * Returns a list of pre-configured model specs for common models.
+ *
+ * @returns Array of model specifications
+ */
+export function getDefaultModelSpecs() {
+    return [
+        createModelSpec({
+            id: 'gemini-2.0-flash',
+            name: 'Gemini 2.0 Flash',
+            provider: 'gemini',
+            capabilities: {
+                streaming: true,
+                vision: true,
+                toolUse: true,
+                codeExecution: true,
+                thinking: true,
+            },
+            contextWindow: 1048576,
+            maxOutputTokens: 8192,
+            description: 'Fast, efficient model for most tasks',
+        }),
+        createModelSpec({
+            id: 'gemini-2.5-pro-preview',
+            name: 'Gemini 2.5 Pro Preview',
+            provider: 'gemini',
+            capabilities: {
+                streaming: true,
+                vision: true,
+                toolUse: true,
+                codeExecution: true,
+                thinking: true,
+            },
+            contextWindow: 1048576,
+            maxOutputTokens: 65536,
+            description: 'Most capable Gemini model',
+        }),
+    ];
+}
+/**
+ * Check if a model has a specific capability.
+ *
+ * @param spec - Model specification
+ * @param capability - Capability name to check
+ * @returns True if capability is enabled
+ *
+ * @example
+ * ```ts
+ * if (hasCapability(modelSpec, 'vision')) {
+ *   // Model supports image input
+ * }
+ * ```
+ */
+export function hasCapability(spec, capability) {
+    return spec.capabilities[capability] === true;
+}
+//# sourceMappingURL=modelSpec.js.map

package/dist/src/providers/modelSpec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelSpec.js","sourceRoot":"","sources":["../../../src/providers/modelSpec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA+DH;;GAEG;AACH,MAAM,oBAAoB,GAAsB;IAC9C,SAAS,EAAE,IAAI;IACf,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,KAAK;IACd,aAAa,EAAE,KAAK;IACpB,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;IACf,gBAAgB,EAAE,KAAK;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,KAAqB;IACnD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,YAAY,EAAE;YACZ,GAAG,oBAAoB;YACvB,GAAG,KAAK,CAAC,YAAY;SACtB;QACD,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,eAAe,CAAC;YACd,EAAE,EAAE,kBAAkB;YACtB,IAAI,EAAE,kBAAkB;YACxB,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE;gBACZ,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,IAAI;gBACb,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,IAAI;aACf;YACD,aAAa,EAAE,OAAO;YACtB,eAAe,EAAE,IAAI;YACrB,WAAW,EAAE,sCAAsC;SACpD,CAAC;QACF,eAAe,CAAC;YACd,EAAE,EAAE,wBAAwB;YAC5B,IAAI,EAAE,wBAAwB;YAC9B,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE;gBACZ,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,IAAI;gBACb,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,IAAI;aACf;YACD,aAAa,EAAE,OAAO;YACtB,eAAe,EAAE,KAAK;YACtB,WAAW,EAAE,2BAA2B;SACzC,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAe,EACf,UAAmC;IAEnC,OAAO,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;AAChD,CAAC"}

package/dist/src/providers/modelSpec.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/providers/modelSpec.test.js

@@ -0,0 +1,119 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { createModelSpec, getDefaultModelSpecs, hasCapability, } from './modelSpec.js';
+describe('ModelSpec', () => {
+    describe('createModelSpec()', () => {
+        it('should create a model spec with required fields', () => {
+            const spec = createModelSpec({
+                id: 'gemini-2.0-flash',
+                name: 'Gemini 2.0 Flash',
+                provider: 'gemini',
+            });
+            expect(spec.id).toBe('gemini-2.0-flash');
+            expect(spec.name).toBe('Gemini 2.0 Flash');
+            expect(spec.provider).toBe('gemini');
+        });
+        it('should apply default capabilities when not specified', () => {
+            const spec = createModelSpec({
+                id: 'test-model',
+                name: 'Test Model',
+                provider: 'test',
+            });
+            expect(spec.capabilities).toBeDefined();
+            expect(spec.capabilities.streaming).toBe(true);
+        });
+        it('should merge custom capabilities with defaults', () => {
+            const spec = createModelSpec({
+                id: 'test-model',
+                name: 'Test Model',
+                provider: 'test',
+                capabilities: {
+                    vision: true,
+                    toolUse: true,
+                },
+            });
+            expect(spec.capabilities.vision).toBe(true);
+            expect(spec.capabilities.toolUse).toBe(true);
+            expect(spec.capabilities.streaming).toBe(true);
+        });
+        it('should include context window settings', () => {
+            const spec = createModelSpec({
+                id: 'test-model',
+                name: 'Test Model',
+                provider: 'test',
+                contextWindow: 128000,
+                maxOutputTokens: 8192,
+            });
+            expect(spec.contextWindow).toBe(128000);
+            expect(spec.maxOutputTokens).toBe(8192);
+        });
+    });
+    describe('getDefaultModelSpecs()', () => {
+        it('should return an array of model specs', () => {
+            const specs = getDefaultModelSpecs();
+            expect(Array.isArray(specs)).toBe(true);
+            expect(specs.length).toBeGreaterThan(0);
+        });
+        it('should include Gemini models', () => {
+            const specs = getDefaultModelSpecs();
+            const geminiModels = specs.filter((s) => s.provider === 'gemini');
+            expect(geminiModels.length).toBeGreaterThan(0);
+        });
+        it('should have valid capabilities for each model', () => {
+            const specs = getDefaultModelSpecs();
+            specs.forEach((spec) => {
+                expect(spec.capabilities).toBeDefined();
+                expect(typeof spec.capabilities.streaming).toBe('boolean');
+            });
+        });
+    });
+    describe('hasCapability()', () => {
+        it('should return true if model has capability', () => {
+            const spec = createModelSpec({
+                id: 'test',
+                name: 'Test',
+                provider: 'test',
+                capabilities: { vision: true },
+            });
+            expect(hasCapability(spec, 'vision')).toBe(true);
+        });
+        it('should return false if model lacks capability', () => {
+            const spec = createModelSpec({
+                id: 'test',
+                name: 'Test',
+                provider: 'test',
+                capabilities: { vision: false },
+            });
+            expect(hasCapability(spec, 'vision')).toBe(false);
+        });
+        it('should return false for undefined capability', () => {
+            const spec = createModelSpec({
+                id: 'test',
+                name: 'Test',
+                provider: 'test',
+            });
+            expect(hasCapability(spec, 'codeExecution')).toBe(false);
+        });
+    });
+    describe('ModelCapabilities', () => {
+        it('should support standard capability flags', () => {
+            const capabilities = {
+                streaming: true,
+                vision: true,
+                toolUse: true,
+                codeExecution: false,
+                thinking: true,
+            };
+            expect(capabilities.streaming).toBe(true);
+            expect(capabilities.vision).toBe(true);
+            expect(capabilities.toolUse).toBe(true);
+            expect(capabilities.codeExecution).toBe(false);
+            expect(capabilities.thinking).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=modelSpec.test.js.map

package/dist/src/providers/modelSpec.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelSpec.test.js","sourceRoot":"","sources":["../../../src/providers/modelSpec.test.ts"],"names":[],"mappings":"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"}

package/dist/src/providers/openai/adapter.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * OpenAiAdapter — extends BaseAdapter to wrap OpenAI SDK (openai).
+ *
+ * Accepts provider-independent LlmGenerateRequest, converts to OpenAI SDK
+ * format, and converts responses back to LlmGenerateResponse / LlmEventStream.
+ *
+ * @see docs/ai_adapter/03-technical-design.md §3.3.7
+ * @see packages/core/src/providers/claude/adapter.ts (Claude counterpart)
+ */
+import { BaseAdapter } from '../baseAdapter.js';
+import type { LlmGenerateRequest, LlmGenerateResponse, LlmGenerateConfig, LlmProviderCapabilities, AdapterConfig, GenerateOptions } from '../types.js';
+import type { LlmEventStream } from '../events.js';
+/**
+ * Interface for the OpenAI SDK client.
+ * This allows dependency injection for testing.
+ */
+export interface OpenAiClient {
+    chat: {
+        completions: {
+            create(params: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
+        };
+    };
+}
+/**
+ * OpenAiAdapter wraps the OpenAI SDK behind the BaseAdapter interface.
+ */
+export declare class OpenAiAdapter extends BaseAdapter {
+    protected readonly client: OpenAiClient;
+    readonly providerName: string;
+    readonly capabilities: LlmProviderCapabilities;
+    private readonly converter;
+    constructor(config: AdapterConfig, client: OpenAiClient);
+    /**
+     * Generate content (non-streaming).
+     */
+    generateContent(request: LlmGenerateRequest, _userPromptId: string, options?: GenerateOptions): Promise<LlmGenerateResponse>;
+    /**
+     * Generate content as a stream of LlmEvents.
+     */
+    generateContentStream(request: LlmGenerateRequest, _userPromptId: string, options?: GenerateOptions): LlmEventStream;
+    /**
+     * Classify an OpenAI SDK error into a typed LlmError.
+     * Uses HTTP status code when available, falls back to message heuristics.
+     */
+    private classifyError;
+    /**
+     * Map common config to provider-specific config.
+     */
+    protected mapToProviderConfig(config: LlmGenerateConfig): Record<string, unknown>;
+}