@didim365/agent-cli-core 0.3.1 → 0.3.4

package/dist/src/providers/didim/converter.js

@@ -0,0 +1,309 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * DidimAIStudio converter — pure functions for request/response transformation.
+ *
+ * Converts between the LLM-agnostic types used by the adapter layer and the
+ * DidimAIStudio REST/SSE API format.
+ *
+ * API contract (master plan §1.2 + 06-didiaistudio-plan.md):
+ * - Invoke:   POST {baseUrl}/scenario-gateway/v1/invoke
+ * - SSE:      POST {baseUrl}/scenario-gateway/v1/invoke/sse
+ * - Improved: POST {baseUrl}/scenario-gateway/v1/invoke/sse/improved
+ * - Auth:     Authorization: Bearer {jwt_token}
+ * - Body:     { chat: string, thread_id?: string }
+ * - Response: { response: string, thread_id: string }
+ *
+ * Improved mode event types (OpenAPI spec + 06-plan):
+ * - message_partial:  토큰 스트리밍 (chunk/content/message 필드)
+ * - message_complete: ToolMessage 완료 (message 필드 or process_name)
+ * - message_metadata: 실행 컨텍스트 (langgraph_node, step, model) → 비콘텐츠
+ * - process:          노드 진행 상황 → 비콘텐츠
+ * - message:          최종 완성 응답 → adapter가 delta 이후 중복 억제
+ * - complete/done:    실행 완료 (thread_id, qa_id)
+ * - error:            에러
+ */
+import { LlmEventType, } from '../events.js';
+/** Default response ID prefix for DidimAIStudio (no server-side ID). */
+const DIDIM_RESPONSE_ID_PREFIX = 'didim-';
+// ============================================================================
+// Domain & Endpoint
+// ============================================================================
+const INVOKE_PATH = '/scenario-gateway/v1/invoke';
+/**
+ * Normalizes a DidimAIStudio domain by stripping protocol prefixes,
+ * trailing slashes, and path segments. Preserves port numbers.
+ */
+export function normalizeDidimDomain(raw) {
+    if (!raw || !raw.trim()) {
+        return '';
+    }
+    let domain = raw.trim();
+    // Strip protocol(s) — handles double-protocol edge case
+    domain = domain.replace(/^(https?:\/\/)+/i, '');
+    // Strip query string, hash, and path
+    domain = domain.split('?')[0].split('#')[0];
+    const slashIdx = domain.indexOf('/');
+    if (slashIdx !== -1) {
+        domain = domain.substring(0, slashIdx);
+    }
+    return domain;
+}
+/**
+ * Detects the protocol scheme from a raw domain/URL string.
+ * Returns 'http' if explicitly specified, otherwise defaults to 'https'.
+ *
+ * Supports http:// for local development (e.g., http://localhost:8008).
+ */
+export function detectScheme(raw) {
+    return /^http:\/\//i.test(raw.trim()) ? 'http' : 'https';
+}
+/**
+ * Builds the full endpoint URL for a given domain and options.
+ * Preserves http:// protocol when explicitly provided (local dev support).
+ */
+export function getDidimEndpoint(domain, options) {
+    const scheme = detectScheme(domain);
+    const normalizedDomain = normalizeDidimDomain(domain);
+    if (!normalizedDomain) {
+        throw new Error('Invalid domain provided');
+    }
+    let url = `${scheme}://${normalizedDomain}${INVOKE_PATH}`;
+    if (options?.streaming) {
+        url += '/sse';
+        if (options.streamMode === 'improved') {
+            url += '/improved';
+        }
+    }
+    return url;
+}
+// ============================================================================
+// Headers & Body
+// ============================================================================
+/**
+ * Builds HTTP headers for a DidimAIStudio request.
+ * Trims threadId before use — whitespace-only values are excluded.
+ */
+export function buildDidimHeaders(jwtToken, threadId) {
+    const headers = {
+        Authorization: `Bearer ${jwtToken}`,
+        'Content-Type': 'application/json',
+    };
+    const trimmed = threadId?.trim();
+    if (trimmed) {
+        headers['x-thread-id'] = trimmed;
+    }
+    return headers;
+}
+/**
+ * Builds the JSON request body for a DidimAIStudio request.
+ * Trims threadId before use — whitespace-only values are excluded.
+ */
+export function buildDidimRequestBody(chat, threadId) {
+    const body = { chat };
+    const trimmed = threadId?.trim();
+    if (trimmed) {
+        body['thread_id'] = trimmed;
+    }
+    return body;
+}
+// ============================================================================
+// Response Parsing
+// ============================================================================
+/**
+ * Parses a raw DidimAIStudio invoke response into typed application data.
+ */
+export function parseDidimResponse(raw) {
+    const content = typeof raw.response === 'string' ? raw.response : '';
+    const threadId = typeof raw.thread_id === 'string' ? raw.thread_id : null;
+    return { content, threadId };
+}
+// ============================================================================
+// SSE Event Parsing
+// ============================================================================
+/**
+ * Extracts a text field from parsed SSE data using a fallback chain.
+ *
+ * Design docs use inconsistent field names across documents:
+ * - 06-didiaistudio-plan.md: "chunk"
+ * - master plan: "content"
+ * - OpenAPI description: "message"
+ *
+ * This function tries all known field names to handle any server version.
+ */
+function extractTextField(parsed) {
+    for (const key of ['chunk', 'content', 'message']) {
+        if (typeof parsed[key] === 'string') {
+            return parsed[key];
+        }
+    }
+    return '';
+}
+/**
+ * Parses a single SSE event (event name + data string) into a DidimSseEvent.
+ *
+ * Handles both `sse` and `improved` stream modes with graceful fallback
+ * for malformed input (invalid JSON, unknown events, empty/whitespace keep-alive).
+ *
+ * @returns Parsed event, or `null` for ignored/keep-alive/metadata events.
+ */
+export function parseDidimSseEvent(eventName, data, mode) {
+    // Empty or whitespace-only data → keep-alive, ignore
+    if (!data || !data.trim()) {
+        return null;
+    }
+    // Parse JSON safely
+    let parsed;
+    try {
+        parsed = JSON.parse(data);
+    }
+    catch {
+        // Invalid JSON → return error event with raw data for debugging
+        return { type: 'error', message: `Invalid JSON: ${data}` };
+    }
+    if (mode === 'sse') {
+        return parseSseMode(eventName, parsed);
+    }
+    return parseImprovedMode(eventName, parsed);
+}
+function parseSseMode(eventName, parsed) {
+    switch (eventName) {
+        case 'message':
+            return {
+                type: 'delta',
+                text: extractTextField(parsed),
+            };
+        case 'done':
+            return {
+                type: 'done',
+                threadId: typeof parsed['thread_id'] === 'string' ? parsed['thread_id'] : null,
+            };
+        case 'error':
+            return {
+                type: 'error',
+                message: typeof parsed['message'] === 'string'
+                    ? parsed['message']
+                    : 'Unknown error',
+            };
+        default:
+            return null;
+    }
+}
+function parseImprovedMode(eventName, parsed) {
+    switch (eventName) {
+        // Token streaming
+        case 'message_partial':
+            return {
+                type: 'delta',
+                text: extractTextField(parsed),
+            };
+        // ToolMessage completion — may carry text content
+        case 'message_complete':
+            return {
+                type: 'delta',
+                text: extractTextField(parsed),
+            };
+        // Final completed response — adapter suppresses when deltas already emitted
+        case 'message':
+            return {
+                type: 'final_message',
+                text: extractTextField(parsed),
+            };
+        // Completion event — supports both 'complete' (OpenAPI) and 'done' (06-plan)
+        case 'complete':
+        case 'done':
+            return {
+                type: 'done',
+                threadId: typeof parsed['thread_id'] === 'string' ? parsed['thread_id'] : null,
+            };
+        case 'error':
+            return {
+                type: 'error',
+                message: typeof parsed['message'] === 'string'
+                    ? parsed['message']
+                    : typeof parsed['error'] === 'string'
+                        ? parsed['error']
+                        : 'Unknown error',
+            };
+        // Non-content metadata events — recognized but not converted to text
+        case 'message_metadata':
+        case 'process':
+            return {
+                type: 'metadata',
+                eventName,
+                data: parsed,
+            };
+        default:
+            // Unknown event — return null. Phase 2 adapter can log if needed.
+            return null;
+    }
+}
+// ============================================================================
+// LlmEvent Conversion
+// ============================================================================
+/**
+ * Generates a unique response ID for DidimAIStudio responses.
+ * DidimAIStudio does not provide server-side response IDs.
+ */
+export function generateDidimResponseId() {
+    return `${DIDIM_RESPONSE_ID_PREFIX}${crypto.randomUUID()}`;
+}
+/**
+ * Converts a parsed DidimAIStudio invoke response to an LlmGenerateResponse.
+ */
+export function convertDidimResponseToLlm(parsed, model) {
+    return {
+        id: generateDidimResponseId(),
+        content: [{ type: 'text', text: parsed.content }],
+        model,
+        stopReason: 'end_turn',
+    };
+}
+/**
+ * Converts a DidimSseEvent to one or more LlmEvents.
+ *
+ * Event mapping:
+ * - delta         → TextDelta
+ * - final_message → TextDelta (adapter suppresses when deltas already emitted)
+ * - done          → Finished + MessageEnd (in order)
+ * - error         → Error
+ * - metadata      → [] (non-content, silently skipped)
+ */
+export function convertDidimSseToLlmEvents(event) {
+    switch (event.type) {
+        case 'delta':
+        case 'final_message': {
+            const textEvent = {
+                type: LlmEventType.TextDelta,
+                text: event.text,
+            };
+            return [textEvent];
+        }
+        case 'done': {
+            const finishedEvent = {
+                type: LlmEventType.Finished,
+                finishReason: 'end_turn',
+            };
+            const messageEndEvent = {
+                type: LlmEventType.MessageEnd,
+            };
+            return [finishedEvent, messageEndEvent];
+        }
+        case 'error': {
+            const errorEvent = {
+                type: LlmEventType.Error,
+                error: event.message || 'Unknown DidimAIStudio error',
+            };
+            return [errorEvent];
+        }
+        case 'metadata':
+            // Non-content events — no LlmEvents produced
+            return [];
+        default:
+            return [];
+    }
+}
+//# sourceMappingURL=converter.js.map

package/dist/src/providers/didim/converter.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Didim provider module — DidimAIStudio adapter, bootstrap, and converter.
+ *
+ * @see docs/00_project/Integration_DidimAIStudio/00_master_plan.md
+ */
+export { DidimAdapter } from './adapter.js';
+export { bootstrapDidimProvider } from './bootstrap.js';
+export { type DidimStreamMode, type DidimResponse, type DidimParsedResponse, type DidimSseEvent, type DidimEndpointOptions, normalizeDidimDomain, detectScheme, getDidimEndpoint, buildDidimHeaders, buildDidimRequestBody, parseDidimResponse, parseDidimSseEvent, generateDidimResponseId, convertDidimResponseToLlm, convertDidimSseToLlmEvents, } from './converter.js';

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

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Didim provider module — DidimAIStudio adapter, bootstrap, and converter.
+ *
+ * @see docs/00_project/Integration_DidimAIStudio/00_master_plan.md
+ */
+export { DidimAdapter } from './adapter.js';
+export { bootstrapDidimProvider } from './bootstrap.js';
+export { 
+// Functions
+normalizeDidimDomain, detectScheme, getDidimEndpoint, buildDidimHeaders, buildDidimRequestBody, parseDidimResponse, parseDidimSseEvent, generateDidimResponseId, convertDidimResponseToLlm, convertDidimSseToLlmEvents, } from './converter.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/providers/didim/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO;AAOL,YAAY;AACZ,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC"}

package/dist/src/providers/gemini/converter.js

@@ -222,7 +222,7 @@ export class GeminiConverter {
                     type: 'tool_call',
                     id: crypto.randomUUID(),
                     name: part.functionCall.name,
-                    arguments: (part.functionCall.args ?? {}),
+                    arguments: part.functionCall.args ?? {},
                 });
             }
             else if ('inlineData' in part && part.inlineData) {

package/dist/src/providers/gemini/converter.js.map

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

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

@@ -35,3 +35,5 @@ import * as OpenAi from './openai/index.js';
 export { OpenAi };
 import * as OpenAiCompatible from './openai-compatible/index.js';
 export { OpenAiCompatible };
+import * as Didim from './didim/index.js';
+export { Didim };

package/dist/src/providers/index.js

@@ -65,4 +65,9 @@ export { OpenAi };
 // Then: OpenAiCompatible.OpenAiCompatibleAdapter, etc.
 import * as OpenAiCompatible from './openai-compatible/index.js';
 export { OpenAiCompatible };
+// Didim provider types (DidimAIStudio integration)
+// Use: import { Didim } from '@didim365/agent-cli-core/providers'
+// Then: Didim.DidimAdapter, Didim.bootstrapDidimProvider, etc.
+import * as Didim from './didim/index.js';
+export { Didim };
 //# sourceMappingURL=index.js.map

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

@@ -1 +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"}
+{"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;AAE5B,mDAAmD;AACnD,kEAAkE;AAClE,+DAA+D;AAC/D,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,CAAC"}

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

@@ -9,6 +9,10 @@
  * Accepts provider-independent LlmGenerateRequest, converts to OpenAI SDK
  * format, and converts responses back to LlmGenerateResponse / LlmEventStream.
  *
+ * Supports two API paths:
+ *   - Chat Completions API (`/v1/chat/completions`) — default for most models
+ *   - Responses API (`/v1/responses`) — for codex models (gpt-5.3-codex, etc.)
+ *
  * @see docs/ai_adapter/03-technical-design.md §3.3.7
  * @see packages/core/src/providers/claude/adapter.ts (Claude counterpart)
  */
@@ -17,6 +21,7 @@ import type { LlmGenerateRequest, LlmGenerateResponse, LlmGenerateConfig, LlmPro
 import type { LlmEventStream } from '../events.js';
 import { LlmError } from '../errors.js';
 import { OpenAiConverter } from './converter.js';
+import { OpenAiResponsesConverter } from './responsesConverter.js';
 /**
  * Interface for the OpenAI SDK client.
  * This allows dependency injection for testing.
@@ -27,24 +32,46 @@ export interface OpenAiClient {
             create(params: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
         };
     };
+    responses: {
+        create(params: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
+    };
 }
 /**
  * OpenAiAdapter wraps the OpenAI SDK behind the BaseAdapter interface.
+ *
+ * Routes requests to either Chat Completions or Responses API based on model.
  */
 export declare class OpenAiAdapter extends BaseAdapter {
     protected readonly client: OpenAiClient;
     readonly providerName: string;
     readonly capabilities: LlmProviderCapabilities;
     protected readonly converter: OpenAiConverter;
+    protected readonly responsesConverter: OpenAiResponsesConverter;
     constructor(config: AdapterConfig, client: OpenAiClient);
     /**
      * Generate content (non-streaming).
+     *
+     * Routes to Responses API for codex/pro models, Chat Completions otherwise.
      */
     generateContent(request: LlmGenerateRequest, _userPromptId: string, options?: GenerateOptions): Promise<LlmGenerateResponse>;
     /**
      * Generate content as a stream of LlmEvents.
+     *
+     * Routes to Responses API streaming for codex/pro models.
      */
     generateContentStream(request: LlmGenerateRequest, _userPromptId: string, options?: GenerateOptions): LlmEventStream;
+    /**
+     * Non-streaming via Responses API.
+     */
+    private generateContentViaResponses;
+    /**
+     * Streaming via Responses API.
+     */
+    private generateContentStreamViaResponses;
+    /**
+     * Check if a model requires the Responses API.
+     */
+    private isResponsesApiModel;
     /**
      * Classify an OpenAI SDK error into a typed LlmError.
      * Uses HTTP status code when available, falls back to message heuristics.

package/dist/src/providers/openai/adapter.js

@@ -9,6 +9,10 @@
  * Accepts provider-independent LlmGenerateRequest, converts to OpenAI SDK
  * format, and converts responses back to LlmGenerateResponse / LlmEventStream.
  *
+ * Supports two API paths:
+ *   - Chat Completions API (`/v1/chat/completions`) — default for most models
+ *   - Responses API (`/v1/responses`) — for codex models (gpt-5.3-codex, etc.)
+ *
  * @see docs/ai_adapter/03-technical-design.md §3.3.7
  * @see packages/core/src/providers/claude/adapter.ts (Claude counterpart)
  */
@@ -17,6 +21,7 @@ import { LlmError, LlmErrorType, AuthenticationError, RateLimitError, ModelNotFo
 import { createErrorEvent, LlmEventType } from '../events.js';
 import { extractWithRateLimits, OPENAI_RATE_LIMIT_HEADERS, } from '../rateLimitUtils.js';
 import { OpenAiConverter } from './converter.js';
+import { OpenAiResponsesConverter } from './responsesConverter.js';
 import { debugLogger } from '../../utils/debugLogger.js';
 /**
  * OpenAI adapter capabilities.
@@ -45,24 +50,38 @@ const OPENAI_CAPABILITIES = {
     maxContextLength: 400_000,
     maxOutputTokens: 128_000,
 };
+/**
+ * Models that require the Responses API (`/v1/responses`).
+ * These models do NOT support Chat Completions (`/v1/chat/completions`).
+ */
+const RESPONSES_API_MODELS = new Set(['gpt-5.3-codex', 'gpt-5.4-pro']);
 /**
  * OpenAiAdapter wraps the OpenAI SDK behind the BaseAdapter interface.
+ *
+ * Routes requests to either Chat Completions or Responses API based on model.
  */
 export class OpenAiAdapter extends BaseAdapter {
     client;
     providerName = 'openai';
     capabilities = OPENAI_CAPABILITIES;
     converter;
+    responsesConverter;
     constructor(config, client) {
         super(config);
         this.client = client;
         this.converter = new OpenAiConverter();
+        this.responsesConverter = new OpenAiResponsesConverter();
     }
     /**
      * Generate content (non-streaming).
+     *
+     * Routes to Responses API for codex/pro models, Chat Completions otherwise.
      */
     async generateContent(request, _userPromptId, options) {
         this.validateRequest(request);
+        if (this.isResponsesApiModel(request.model)) {
+            return this.generateContentViaResponses(request, options);
+        }
         try {
             const params = this.converter.toOpenAiRequest(request);
             const createResult = this.client.chat.completions.create(params, {
@@ -81,9 +100,14 @@ export class OpenAiAdapter extends BaseAdapter {
     }
     /**
      * Generate content as a stream of LlmEvents.
+     *
+     * Routes to Responses API streaming for codex/pro models.
      */
     generateContentStream(request, _userPromptId, options) {
         this.validateRequest(request);
+        if (this.isResponsesApiModel(request.model)) {
+            return this.generateContentStreamViaResponses(request, options);
+        }
         const client = this.client;
         const converter = this.converter;
         const classify = this.classifyError.bind(this);
@@ -133,6 +157,88 @@ export class OpenAiAdapter extends BaseAdapter {
         }
         return streamGenerator();
     }
+    // ============================================================================
+    // Responses API methods
+    // ============================================================================
+    /**
+     * Non-streaming via Responses API.
+     */
+    async generateContentViaResponses(request, options) {
+        try {
+            const params = this.responsesConverter.toResponsesRequest(request);
+            const createResult = this.client.responses.create(params, {
+                signal: options?.signal,
+            });
+            const { data, rateLimits } = await extractWithRateLimits(createResult, OPENAI_RATE_LIMIT_HEADERS);
+            const result = this.responsesConverter.fromResponsesResponse(data, request.model);
+            if (rateLimits) {
+                result.rateLimits = rateLimits;
+            }
+            return result;
+        }
+        catch (error) {
+            throw this.classifyError(error);
+        }
+    }
+    /**
+     * Streaming via Responses API.
+     */
+    generateContentStreamViaResponses(request, options) {
+        const client = this.client;
+        const responsesConverter = this.responsesConverter;
+        const classify = this.classifyError.bind(this);
+        const params = responsesConverter.toResponsesRequest(request);
+        const signal = options?.signal;
+        async function* streamGenerator() {
+            try {
+                const createResult = client.responses.create({
+                    ...params,
+                    stream: true,
+                }, { signal });
+                const { data, rateLimits } = await extractWithRateLimits(createResult, OPENAI_RATE_LIMIT_HEADERS);
+                const stream = data;
+                const state = responsesConverter.createStreamState();
+                let chunkIndex = 0;
+                let messageEndEmitted = false;
+                for await (const event of stream) {
+                    const events = responsesConverter.convertStreamEvent(event, state);
+                    for (const llmEvent of events) {
+                        if (llmEvent.type === LlmEventType.TextDelta) {
+                            debugLogger.log(`[OpenAI Responses stream] chunk#${chunkIndex} TextDelta: "${llmEvent.text.substring(0, 80)}"`);
+                        }
+                        if (llmEvent.type === LlmEventType.MessageEnd) {
+                            messageEndEmitted = true;
+                            yield rateLimits ? { ...llmEvent, rateLimits } : llmEvent;
+                        }
+                        else {
+                            yield llmEvent;
+                        }
+                    }
+                    chunkIndex++;
+                }
+                if (!messageEndEmitted) {
+                    yield {
+                        type: LlmEventType.MessageEnd,
+                        ...(rateLimits && { rateLimits }),
+                    };
+                }
+            }
+            catch (error) {
+                const classified = classify(error);
+                yield createErrorEvent(classified, classified.code, classified.isRetryable);
+            }
+        }
+        return streamGenerator();
+    }
+    // ============================================================================
+    // Helpers
+    // ============================================================================
+    /**
+     * Check if a model requires the Responses API.
+     */
+    isResponsesApiModel(model) {
+        return RESPONSES_API_MODELS.has(model);
+    }
     /**
      * Classify an OpenAI SDK error into a typed LlmError.
      * Uses HTTP status code when available, falls back to message heuristics.