@omnicross/core 0.1.0 → 0.1.2

package/dist/completion.d.cts

@@ -1,17 +1,159 @@
-export { a as ApiFormat, B as BuiltinToolExecutor, C as CompletionOptions, b as CompletionResult, c as CompletionService, N as NATIVE_SEARCH_TOOL_NAMES, d as NativeSearchAugmentation, e as NativeSearchDetectionResult, f as NativeSearchProvider, g as NativeSearchUserConfig, S as SimpleChatGeminiMessage, h as SimpleChatGeminiPart, i as StreamCallbacks, j as StreamEvent, k as StreamEventType, l as StreamSender, V as VisionFallbackProvider, m as addOpenRouterProviderToRequest, n as applyAugmentation, o as attachStreamEventBuffer, p as buildAnthropicApiUrl, q as buildAzureOpenAIApiUrl, r as buildGeminiApiUrl, s as buildNativeSearchAugmentation, t as buildOpenAIApiUrl, u as buildOpenAIResponseApiUrl, v as buildProviderApiUrl, w as convertMessageToAnthropic, x as convertMessageToGemini, y as convertMessageToOpenAI, z as detectNativeSearch, D as emitStreamEvent, E as getBuiltinSearchTools, F as getOpenRouterProviderConfig, H as getProviderHeaders, I as normalizeAzureEndpoint, J as registerStreamEventBuffer, K as releaseStreamEventBuffer, L as resolveApiFormat, P as resolveProviderEndpoint } from './index-DXazdTzZ.cjs';
+export { A as ApiFormat, C as CompletionOptions, a as CompletionResult, N as NATIVE_SEARCH_TOOL_NAMES, b as NativeSearchAugmentation, c as NativeSearchDetectionResult, d as NativeSearchProvider, e as NativeSearchUserConfig, S as StreamCallbacks } from './types-BScIHmPr.cjs';
+export { C as CompletionService, V as VisionFallbackProvider } from './CompletionService-D3a47vdU.cjs';
+export { buildAnthropicApiUrl, buildAzureOpenAIApiUrl, buildGeminiApiUrl, buildOpenAIApiUrl, buildOpenAIResponseApiUrl, buildProviderApiUrl, normalizeAzureEndpoint, resolveApiFormat, resolveProviderEndpoint } from './completion/url-builder.cjs';
+import { LLMProvider, OpenRouterProviderRouting } from '@omnicross/contracts/llm-config';
+import { SimpleChatMessage, AnthropicMessage, OpenAIMessage } from '@omnicross/contracts/completion-types';
+export { B as BuiltinToolExecutor, g as getBuiltinSearchTools } from './BuiltinToolExecutor-CS2WpXhM.cjs';
+export { applyAugmentation, buildNativeSearchAugmentation, detectNativeSearch } from './completion/NativeSearchInjector.cjs';
 import '@omnicross/contracts/message-blocks';
-import '@omnicross/contracts/completion-types';
-import '@omnicross/contracts/llm-config';
 import './usage-event-sink-BX7FE1NL.cjs';
-import './ApiKeyPoolService-BmMkau07.cjs';
-import './types-DZIQbgp0.cjs';
+import './logger-4GvQNzhE.cjs';
+import './ports/provider-config-source.cjs';
+import './transformer/types.cjs';
+import './transformer/TransformerService.cjs';
+import './provider-proxy/types.cjs';
 import 'node:http';
 import '@omnicross/contracts/subscription-types';
 import '@omnicross/contracts/usage-types';
-import './SubscriptionAuthSource-Cr4fVEYY.cjs';
+import './completion/ApiKeyPoolService.cjs';
+import './pipeline/AuthSource.cjs';
+import './pipeline/SubscriptionAuthSource.cjs';
 import './pipeline/SubscriptionAuthStrategy.cjs';
-import './transformer/types.cjs';
-import './transformer/TransformerService.cjs';
+import './ports/web-search-backend.cjs';
 import '@omnicross/contracts/websearch-types';
 import '@omnicross/contracts/mcp-types';
 import '@omnicross/contracts/endpoint-resolver';
+
+/**
+ * StreamEventBuffer — per-streamId event queue for streamed completion delivery.
+ *
+ * Closes the subscribe-vs-emit race between a producer that starts the LLM call
+ * asynchronously and a consumer that only attaches its listener after awaiting a
+ * reply. Events emitted before `attach(streamId)` is called are queued and
+ * replayed in order on attach.
+ */
+/**
+ * Minimal structural sender — the subset of an Electron `WebContents` (or any
+ * IPC channel) this buffer actually uses. Kept LOCAL so core has zero electron
+ * dependency; the host passes any object satisfying this shape.
+ */
+interface StreamSender {
+    isDestroyed(): boolean;
+    send(channel: string, payload: StreamEvent): void;
+}
+type StreamEventType = 'start' | 'delta' | 'reasoning' | 'tool_call' | 'tool_result' | 'tool_use' | 'block' | 'search_start' | 'search_result' | 'done' | 'error' | 'abort';
+interface StreamEvent {
+    type: StreamEventType;
+    [key: string]: unknown;
+}
+/**
+ * Register a new stream. Called by the engine / handler immediately after the
+ * `streamId` is created, before any `emit`. Idempotent re-registration replaces
+ * the sender (covers the rare case of the engine retrying with the same id).
+ */
+declare function register(streamId: string, sender: StreamSender): void;
+/**
+ * Emit an event for `streamId`. Forwards directly if the client has attached;
+ * otherwise queues until `attach` is called. Bounded at QUEUE_CAP — overflow
+ * evicts the oldest non-terminal event.
+ */
+declare function emit(streamId: string, event: StreamEvent): void;
+/**
+ * The client announced readiness via the `completion:stream:subscribe` IPC. Drains
+ * the queue synchronously to the bound sender, then flips to direct-forward mode.
+ * Returns the number of events drained for diagnostic purposes.
+ */
+declare function attach(streamId: string): {
+    ok: boolean;
+    drained: number;
+};
+/**
+ * Mark a stream finished. If the client has already attached, release
+ * synchronously. Otherwise defer one tick so a late `subscribe` arriving on the
+ * heels of the `done`/`error` event still drains the queue before cleanup.
+ */
+declare function release(streamId: string): void;
+
+/**
+ * Request Header Building Utilities
+ *
+ * Functions for building correct request headers based on provider format.
+ */
+
+/**
+ * Get request headers based on provider format
+ */
+declare function getProviderHeaders(provider: LLMProvider, apiKey: string): Record<string, string>;
+
+/**
+ * Message Format Conversion Utilities
+ *
+ * Functions for converting SimpleChatMessage to different API formats.
+ */
+
+/**
+ * Convert SimpleChatMessage to OpenAI-compatible format (covers OpenAI, OpenRouter,
+ * and other OpenAI-compatible providers — DO NOT call from Anthropic / Gemini paths,
+ * which have their own converters above).
+ *
+ * - Text only: { role, content: string }
+ * - With media: { role, content: [{ type: "text" | "image_url" | "input_audio" | "video_url", ... }] }
+ *
+ * Audio is emitted as `input_audio` with base64 + format (the standard OpenAI / OpenRouter
+ * shape). Video is emitted as `video_url`: HTTPS URLs pass through; local data is sent as a
+ * `data:<mime>;base64,...` URL with a 25 MB cap before the request is even built.
+ */
+declare function convertMessageToOpenAI(msg: SimpleChatMessage): OpenAIMessage;
+/**
+ * Convert SimpleChatMessage to Anthropic format (with vision support)
+ * Anthropic format:
+ * - Text only: { role, content: string }
+ * - With images: { role, content: [{ type: "text", text: "..." }, { type: "image", source: { type: "base64", media_type: "...", data: "..." } }] }
+ */
+declare function convertMessageToAnthropic(msg: SimpleChatMessage): AnthropicMessage;
+/**
+ * Minimal Gemini part shape for the simple-chat DIRECT path (text + inline
+ * media only), serialized with the official REST JSON casing
+ * (`inlineData` / `mimeType`).
+ *
+ * NOT the same wire model as the transformer pipeline's full `GeminiPart`
+ * union in `transformer/transformers/utils/gemini.util.ts` (function calls /
+ * file data, snake_case alias keys). The two paths intentionally serialize
+ * differently — do not merge them blindly.
+ */
+interface SimpleChatGeminiPart {
+    text?: string;
+    inlineData?: {
+        mimeType: string;
+        data: string;
+    };
+}
+/** Gemini message for the simple-chat direct path. */
+interface SimpleChatGeminiMessage {
+    role: string;
+    parts: SimpleChatGeminiPart[];
+}
+/**
+ * Convert SimpleChatMessage to Gemini format (with vision support)
+ * Gemini format:
+ * - { role: "user"|"model", parts: [{ text: "..." }, { inlineData: { mimeType: "...", data: "..." } }] }
+ */
+declare function convertMessageToGemini(msg: SimpleChatMessage): SimpleChatGeminiMessage;
+
+/**
+ * OpenRouter Provider Utilities
+ *
+ * Functions for handling OpenRouter-specific configuration and routing.
+ */
+
+/**
+ * Get OpenRouter provider routing config from model configuration
+ * Returns the provider routing config if the provider is OpenRouter and model has config
+ */
+declare function getOpenRouterProviderConfig(provider: LLMProvider, modelId: string): OpenRouterProviderRouting | undefined;
+/**
+ * Add OpenRouter provider routing to request body if applicable
+ */
+declare function addOpenRouterProviderToRequest(requestBody: Record<string, unknown>, provider: LLMProvider, modelId: string): Record<string, unknown>;
+
+export { type SimpleChatGeminiMessage, type SimpleChatGeminiPart, type StreamEvent, type StreamEventType, type StreamSender, addOpenRouterProviderToRequest, attach as attachStreamEventBuffer, convertMessageToAnthropic, convertMessageToGemini, convertMessageToOpenAI, emit as emitStreamEvent, getOpenRouterProviderConfig, getProviderHeaders, register as registerStreamEventBuffer, release as releaseStreamEventBuffer };

package/dist/completion.d.ts

@@ -1,17 +1,159 @@
-export { a as ApiFormat, B as BuiltinToolExecutor, C as CompletionOptions, b as CompletionResult, c as CompletionService, N as NATIVE_SEARCH_TOOL_NAMES, d as NativeSearchAugmentation, e as NativeSearchDetectionResult, f as NativeSearchProvider, g as NativeSearchUserConfig, S as SimpleChatGeminiMessage, h as SimpleChatGeminiPart, i as StreamCallbacks, j as StreamEvent, k as StreamEventType, l as StreamSender, V as VisionFallbackProvider, m as addOpenRouterProviderToRequest, n as applyAugmentation, o as attachStreamEventBuffer, p as buildAnthropicApiUrl, q as buildAzureOpenAIApiUrl, r as buildGeminiApiUrl, s as buildNativeSearchAugmentation, t as buildOpenAIApiUrl, u as buildOpenAIResponseApiUrl, v as buildProviderApiUrl, w as convertMessageToAnthropic, x as convertMessageToGemini, y as convertMessageToOpenAI, z as detectNativeSearch, D as emitStreamEvent, E as getBuiltinSearchTools, F as getOpenRouterProviderConfig, H as getProviderHeaders, I as normalizeAzureEndpoint, J as registerStreamEventBuffer, K as releaseStreamEventBuffer, L as resolveApiFormat, P as resolveProviderEndpoint } from './index-BTSmc9Sm.js';
+export { A as ApiFormat, C as CompletionOptions, a as CompletionResult, N as NATIVE_SEARCH_TOOL_NAMES, b as NativeSearchAugmentation, c as NativeSearchDetectionResult, d as NativeSearchProvider, e as NativeSearchUserConfig, S as StreamCallbacks } from './types-BScIHmPr.js';
+export { C as CompletionService, V as VisionFallbackProvider } from './CompletionService-DdWaAxq0.js';
+export { buildAnthropicApiUrl, buildAzureOpenAIApiUrl, buildGeminiApiUrl, buildOpenAIApiUrl, buildOpenAIResponseApiUrl, buildProviderApiUrl, normalizeAzureEndpoint, resolveApiFormat, resolveProviderEndpoint } from './completion/url-builder.js';
+import { LLMProvider, OpenRouterProviderRouting } from '@omnicross/contracts/llm-config';
+import { SimpleChatMessage, AnthropicMessage, OpenAIMessage } from '@omnicross/contracts/completion-types';
+export { B as BuiltinToolExecutor, g as getBuiltinSearchTools } from './BuiltinToolExecutor-BluWyeob.js';
+export { applyAugmentation, buildNativeSearchAugmentation, detectNativeSearch } from './completion/NativeSearchInjector.js';
 import '@omnicross/contracts/message-blocks';
-import '@omnicross/contracts/completion-types';
-import '@omnicross/contracts/llm-config';
 import './usage-event-sink-BX7FE1NL.js';
-import './ApiKeyPoolService-BmMkau07.js';
-import './types-DCzHkhJt.js';
+import './logger-4GvQNzhE.js';
+import './ports/provider-config-source.js';
+import './transformer/types.js';
+import './transformer/TransformerService.js';
+import './provider-proxy/types.js';
 import 'node:http';
 import '@omnicross/contracts/subscription-types';
 import '@omnicross/contracts/usage-types';
-import './SubscriptionAuthSource-D89zmiSS.js';
+import './completion/ApiKeyPoolService.js';
+import './pipeline/AuthSource.js';
+import './pipeline/SubscriptionAuthSource.js';
 import './pipeline/SubscriptionAuthStrategy.js';
-import './transformer/types.js';
-import './transformer/TransformerService.js';
+import './ports/web-search-backend.js';
 import '@omnicross/contracts/websearch-types';
 import '@omnicross/contracts/mcp-types';
 import '@omnicross/contracts/endpoint-resolver';
+
+/**
+ * StreamEventBuffer — per-streamId event queue for streamed completion delivery.
+ *
+ * Closes the subscribe-vs-emit race between a producer that starts the LLM call
+ * asynchronously and a consumer that only attaches its listener after awaiting a
+ * reply. Events emitted before `attach(streamId)` is called are queued and
+ * replayed in order on attach.
+ */
+/**
+ * Minimal structural sender — the subset of an Electron `WebContents` (or any
+ * IPC channel) this buffer actually uses. Kept LOCAL so core has zero electron
+ * dependency; the host passes any object satisfying this shape.
+ */
+interface StreamSender {
+    isDestroyed(): boolean;
+    send(channel: string, payload: StreamEvent): void;
+}
+type StreamEventType = 'start' | 'delta' | 'reasoning' | 'tool_call' | 'tool_result' | 'tool_use' | 'block' | 'search_start' | 'search_result' | 'done' | 'error' | 'abort';
+interface StreamEvent {
+    type: StreamEventType;
+    [key: string]: unknown;
+}
+/**
+ * Register a new stream. Called by the engine / handler immediately after the
+ * `streamId` is created, before any `emit`. Idempotent re-registration replaces
+ * the sender (covers the rare case of the engine retrying with the same id).
+ */
+declare function register(streamId: string, sender: StreamSender): void;
+/**
+ * Emit an event for `streamId`. Forwards directly if the client has attached;
+ * otherwise queues until `attach` is called. Bounded at QUEUE_CAP — overflow
+ * evicts the oldest non-terminal event.
+ */
+declare function emit(streamId: string, event: StreamEvent): void;
+/**
+ * The client announced readiness via the `completion:stream:subscribe` IPC. Drains
+ * the queue synchronously to the bound sender, then flips to direct-forward mode.
+ * Returns the number of events drained for diagnostic purposes.
+ */
+declare function attach(streamId: string): {
+    ok: boolean;
+    drained: number;
+};
+/**
+ * Mark a stream finished. If the client has already attached, release
+ * synchronously. Otherwise defer one tick so a late `subscribe` arriving on the
+ * heels of the `done`/`error` event still drains the queue before cleanup.
+ */
+declare function release(streamId: string): void;
+
+/**
+ * Request Header Building Utilities
+ *
+ * Functions for building correct request headers based on provider format.
+ */
+
+/**
+ * Get request headers based on provider format
+ */
+declare function getProviderHeaders(provider: LLMProvider, apiKey: string): Record<string, string>;
+
+/**
+ * Message Format Conversion Utilities
+ *
+ * Functions for converting SimpleChatMessage to different API formats.
+ */
+
+/**
+ * Convert SimpleChatMessage to OpenAI-compatible format (covers OpenAI, OpenRouter,
+ * and other OpenAI-compatible providers — DO NOT call from Anthropic / Gemini paths,
+ * which have their own converters above).
+ *
+ * - Text only: { role, content: string }
+ * - With media: { role, content: [{ type: "text" | "image_url" | "input_audio" | "video_url", ... }] }
+ *
+ * Audio is emitted as `input_audio` with base64 + format (the standard OpenAI / OpenRouter
+ * shape). Video is emitted as `video_url`: HTTPS URLs pass through; local data is sent as a
+ * `data:<mime>;base64,...` URL with a 25 MB cap before the request is even built.
+ */
+declare function convertMessageToOpenAI(msg: SimpleChatMessage): OpenAIMessage;
+/**
+ * Convert SimpleChatMessage to Anthropic format (with vision support)
+ * Anthropic format:
+ * - Text only: { role, content: string }
+ * - With images: { role, content: [{ type: "text", text: "..." }, { type: "image", source: { type: "base64", media_type: "...", data: "..." } }] }
+ */
+declare function convertMessageToAnthropic(msg: SimpleChatMessage): AnthropicMessage;
+/**
+ * Minimal Gemini part shape for the simple-chat DIRECT path (text + inline
+ * media only), serialized with the official REST JSON casing
+ * (`inlineData` / `mimeType`).
+ *
+ * NOT the same wire model as the transformer pipeline's full `GeminiPart`
+ * union in `transformer/transformers/utils/gemini.util.ts` (function calls /
+ * file data, snake_case alias keys). The two paths intentionally serialize
+ * differently — do not merge them blindly.
+ */
+interface SimpleChatGeminiPart {
+    text?: string;
+    inlineData?: {
+        mimeType: string;
+        data: string;
+    };
+}
+/** Gemini message for the simple-chat direct path. */
+interface SimpleChatGeminiMessage {
+    role: string;
+    parts: SimpleChatGeminiPart[];
+}
+/**
+ * Convert SimpleChatMessage to Gemini format (with vision support)
+ * Gemini format:
+ * - { role: "user"|"model", parts: [{ text: "..." }, { inlineData: { mimeType: "...", data: "..." } }] }
+ */
+declare function convertMessageToGemini(msg: SimpleChatMessage): SimpleChatGeminiMessage;
+
+/**
+ * OpenRouter Provider Utilities
+ *
+ * Functions for handling OpenRouter-specific configuration and routing.
+ */
+
+/**
+ * Get OpenRouter provider routing config from model configuration
+ * Returns the provider routing config if the provider is OpenRouter and model has config
+ */
+declare function getOpenRouterProviderConfig(provider: LLMProvider, modelId: string): OpenRouterProviderRouting | undefined;
+/**
+ * Add OpenRouter provider routing to request body if applicable
+ */
+declare function addOpenRouterProviderToRequest(requestBody: Record<string, unknown>, provider: LLMProvider, modelId: string): Record<string, unknown>;
+
+export { type SimpleChatGeminiMessage, type SimpleChatGeminiPart, type StreamEvent, type StreamEventType, type StreamSender, addOpenRouterProviderToRequest, attach as attachStreamEventBuffer, convertMessageToAnthropic, convertMessageToGemini, convertMessageToOpenAI, emit as emitStreamEvent, getOpenRouterProviderConfig, getProviderHeaders, register as registerStreamEventBuffer, release as releaseStreamEventBuffer };