@machina.ai/cell-cli-core 1.49.0-rc6 → 1.50.0-rc1

package/dist/src/core/openAiCompatibleContentGenerator.d.ts

@@ -0,0 +1,156 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { CountTokensResponse, EmbedContentResponse, GenerateContentResponse, GenerateContentParameters, CountTokensParameters, EmbedContentParameters } from '@google/genai';
+import type { ContentGenerator } from './contentGenerator.js';
+import type { Config } from '../config/config.js';
+import type { LlmRole } from '../telemetry/llmRole.js';
+/** Wire transport used by OpenAI-compatible providers. */
+export type OpenAiTransportMode = 'responses' | 'chat_completions';
+interface OpenAiToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+interface OpenAiMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content?: string;
+    tool_calls?: OpenAiToolCall[];
+    tool_call_id?: string;
+}
+/** Internally-tagged tools used by /v1/responses. */
+interface OpenAiResponsesTool {
+    type: 'function';
+    name: string;
+    description?: string;
+    parameters: JsonSchema;
+    strict: false;
+}
+type OpenAiInputItem = {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+} | {
+    type: 'function_call';
+    call_id: string;
+    name: string;
+    arguments: string;
+} | {
+    type: 'function_call_output';
+    call_id: string;
+    output: string;
+};
+interface OpenAiUsage {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+    input_tokens?: number;
+    output_tokens?: number;
+    output_tokens_details?: {
+        reasoning_tokens?: number;
+    };
+}
+interface OpenAiResponsesOutputItem {
+    type?: string;
+    id?: string;
+    call_id?: string;
+    name?: string;
+    arguments?: string;
+    content?: Array<{
+        type?: string;
+        text?: string;
+    }>;
+    role?: string;
+}
+interface OpenAiResponsesResponse {
+    output?: OpenAiResponsesOutputItem[];
+    usage?: OpenAiUsage;
+    error?: {
+        message?: string;
+    };
+}
+interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    [key: string]: unknown;
+}
+/**
+ * Stateless compatibility adapter for OpenAI-compatible APIs hosted via the
+ * unified Keycloak proxy. Uses Responses API for openai/xai by default and
+ * chat/completions for other OpenAI-compatible backends.
+ */
+export declare class OpenAiCompatibleContentGenerator implements ContentGenerator {
+    private readonly config;
+    private readonly token?;
+    private readonly sessionId?;
+    readonly provider: string;
+    readonly modelName: string;
+    readonly endpointUrl: string;
+    readonly transportMode: OpenAiTransportMode;
+    private readonly localModelApiKey?;
+    constructor(config: Config, model: string, token?: string | undefined, sessionId?: string | undefined, transportMode?: OpenAiTransportMode);
+    /**
+     * Resolve transport mode from provider defaults and optional config override.
+     * Config may expose getOpenAiTransportMode(): 'responses' | 'chat_completions'.
+     */
+    private resolveTransportMode;
+    private buildEndpointUrl;
+    private mapMessages;
+    /**
+     * Map chat-style messages to Responses API input items.
+     * Assistant tool_calls become function_call items; tool results become
+     * function_call_output items. Roles are preserved as input messages.
+     */
+    mapMessagesToResponsesInput(messages: OpenAiMessage[]): OpenAiInputItem[];
+    private mapSchema;
+    private mapChatTools;
+    /**
+     * Transform Gemini tools into Responses API internally-tagged function tools.
+     * strict is always false to preserve non-strict tool calling behavior.
+     */
+    mapResponsesTools(request: GenerateContentParameters): OpenAiResponsesTool[] | undefined;
+    private buildHeaders;
+    private resolveEndpoint;
+    /**
+     * Build a Responses API request body from an allowlist of fields.
+     * Always sets store:false and never includes previous_response_id.
+     */
+    buildResponsesRequestBody(params: {
+        modelName: string;
+        provider: string;
+        messages: OpenAiMessage[];
+        request: GenerateContentParameters;
+        stream?: boolean;
+    }): Record<string, unknown>;
+    private buildChatCompletionsRequestBody;
+    parseResponsesPayload(data: OpenAiResponsesResponse): GenerateContentResponse;
+    private parseChatCompletionsPayload;
+    /**
+     * Generates content.
+     */
+    generateContent(request: GenerateContentParameters, _userPromptId: string, _role: LlmRole): Promise<GenerateContentResponse>;
+    /**
+     * Generates content stream.
+     */
+    generateContentStream(request: GenerateContentParameters, _userPromptId: string, _role: LlmRole): Promise<AsyncGenerator<GenerateContentResponse>>;
+    private makeStream;
+    /**
+     * Parse Responses API SSE semantic events into Gemini-compatible chunks.
+     */
+    parseResponsesStream(bodyStream: ReadableStream<Uint8Array>): AsyncGenerator<GenerateContentResponse>;
+    private parseChatCompletionsStream;
+    /**
+     * Counts tokens.
+     */
+    countTokens(_request: CountTokensParameters): Promise<CountTokensResponse>;
+    /**
+     * Embeds content.
+     */
+    embedContent(_request: EmbedContentParameters): Promise<EmbedContentResponse>;
+}
+export {};