ai.matey.frontend 0.2.0

package/dist/types/adapters/gemini.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Gemini Frontend Adapter
+ *
+ * Adapts Google Gemini API format to Universal IR.
+ * Handles Gemini's systemInstruction field and content array format.
+ *
+ * @module
+ */
+import type { FrontendAdapter, AdapterMetadata } from 'ai.matey.types';
+import type { IRChatRequest, IRChatResponse, IRStreamChunk } from 'ai.matey.types';
+import type { StreamConversionOptions } from 'ai.matey.types';
+export interface GeminiContent {
+    role: 'user' | 'model';
+    parts: Array<{
+        text: string;
+    } | {
+        inlineData: {
+            mimeType: string;
+            data: string;
+        };
+    }>;
+}
+export interface GeminiRequest {
+    contents: GeminiContent[];
+    systemInstruction?: {
+        parts: Array<{
+            text: string;
+        }>;
+    };
+    generationConfig?: {
+        temperature?: number;
+        topP?: number;
+        topK?: number;
+        maxOutputTokens?: number;
+        stopSequences?: string[];
+    };
+}
+export interface GeminiResponse {
+    candidates: Array<{
+        content: GeminiContent;
+        finishReason: 'STOP' | 'MAX_TOKENS' | 'SAFETY' | 'RECITATION' | 'OTHER';
+    }>;
+    usageMetadata?: {
+        promptTokenCount: number;
+        candidatesTokenCount: number;
+        totalTokenCount: number;
+    };
+}
+export declare class GeminiFrontendAdapter implements FrontendAdapter<GeminiRequest, GeminiResponse> {
+    readonly metadata: AdapterMetadata;
+    toIR(request: GeminiRequest): Promise<IRChatRequest>;
+    fromIR(response: IRChatResponse): Promise<GeminiResponse>;
+    fromIRStream(stream: AsyncGenerator<IRStreamChunk>, _options?: StreamConversionOptions): AsyncGenerator<string>;
+}
+//# sourceMappingURL=gemini.d.ts.map

package/dist/types/adapters/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../src/adapters/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAa,MAAM,gBAAgB,CAAC;AAC9F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAM9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,UAAU,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACvD,gBAAgB,CAAC,EAAE;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,KAAK,CAAC;QAChB,OAAO,EAAE,aAAa,CAAC;QACvB,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;KACzE,CAAC,CAAC;IACH,aAAa,CAAC,EAAE;QACd,gBAAgB,EAAE,MAAM,CAAC;QACzB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,qBAAa,qBAAsB,YAAW,eAAe,CAAC,aAAa,EAAE,cAAc,CAAC;IAC1F,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAWhC;IAEF,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAkCpD,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IA8BlD,YAAY,CACjB,MAAM,EAAE,cAAc,CAAC,aAAa,CAAC,EACrC,QAAQ,CAAC,EAAE,uBAAuB,GACjC,cAAc,CAAC,MAAM,CAAC;CAS1B"}

package/dist/types/adapters/generic.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Generic Frontend Adapter
+ *
+ * A passthrough frontend adapter that accepts and returns IR format directly.
+ * Use this when you want to work with the universal IR format without
+ * any provider-specific conversions.
+ *
+ * @example
+ * ```typescript
+ * import { GenericFrontendAdapter } from 'ai.matey.frontend/generic';
+ * import { Bridge } from 'ai.matey.core';
+ *
+ * const frontend = new GenericFrontendAdapter();
+ * const bridge = new Bridge(frontend, backend);
+ *
+ * // Request and response are both in IR format
+ * const response = await bridge.chat({
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ *   parameters: { model: 'gpt-4' },
+ *   metadata: { requestId: 'req_123', timestamp: Date.now(), provenance: {} },
+ * });
+ * ```
+ *
+ * @module
+ */
+import type { FrontendAdapter, AdapterMetadata } from 'ai.matey.types';
+import type { IRChatRequest, IRChatResponse, IRChatStream, IRStreamChunk, StreamConversionOptions } from 'ai.matey.types';
+/**
+ * Configuration options for the Generic Frontend Adapter.
+ */
+export interface GenericFrontendConfig {
+    /**
+     * Custom adapter name for provenance tracking.
+     * @default 'generic-frontend'
+     */
+    readonly name?: string;
+    /**
+     * Whether to validate requests before passing through.
+     * @default false
+     */
+    readonly validateRequests?: boolean;
+    /**
+     * Whether to add/update provenance information.
+     * @default true
+     */
+    readonly trackProvenance?: boolean;
+    /**
+     * Maximum context tokens (for capability reporting).
+     * @default undefined (unlimited)
+     */
+    readonly maxContextTokens?: number;
+    /**
+     * Supported models (for capability reporting).
+     */
+    readonly supportedModels?: readonly string[];
+}
+/**
+ * Passthrough frontend adapter for IR format.
+ *
+ * This adapter accepts IR requests directly and returns IR responses without
+ * any conversion. It's useful for:
+ *
+ * - **Direct IR access**: Work with the universal format without provider wrappers
+ * - **Testing**: Test bridges and backends without conversion overhead
+ * - **Custom integrations**: Build tools that operate at the IR level
+ * - **Format normalization**: Use when your application already produces IR
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const frontend = new GenericFrontendAdapter();
+ *
+ * // With custom configuration
+ * const frontend = new GenericFrontendAdapter({
+ *   name: 'my-app-frontend',
+ *   trackProvenance: true,
+ *   maxContextTokens: 128000,
+ * });
+ * ```
+ */
+export declare class GenericFrontendAdapter implements FrontendAdapter<IRChatRequest, IRChatResponse, IRStreamChunk> {
+    readonly metadata: AdapterMetadata;
+    private readonly config;
+    constructor(config?: GenericFrontendConfig);
+    /**
+     * Pass through IR request (no conversion needed).
+     *
+     * Optionally adds provenance tracking if enabled.
+     */
+    toIR(request: IRChatRequest): Promise<IRChatRequest>;
+    /**
+     * Pass through IR response (no conversion needed).
+     */
+    fromIR(response: IRChatResponse): Promise<IRChatResponse>;
+    /**
+     * Pass through IR stream chunks (no conversion needed).
+     */
+    fromIRStream(stream: IRChatStream, _options?: StreamConversionOptions): AsyncGenerator<IRStreamChunk, void, undefined>;
+    /**
+     * Validate IR request structure.
+     *
+     * Only performs validation if `validateRequests` is enabled in config.
+     */
+    validate(request: IRChatRequest): Promise<void>;
+}
+/**
+ * Create a new Generic Frontend Adapter instance.
+ *
+ * @example
+ * ```typescript
+ * const frontend = createGenericFrontend();
+ *
+ * // Or with configuration
+ * const frontend = createGenericFrontend({
+ *   name: 'my-frontend',
+ *   trackProvenance: true,
+ * });
+ * ```
+ */
+export declare function createGenericFrontend(config?: GenericFrontendConfig): GenericFrontendAdapter;
+export default GenericFrontendAdapter;
+//# sourceMappingURL=generic.d.ts.map

package/dist/types/adapters/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../../src/adapters/generic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAMxB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IAEnC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,sBAAuB,YAAW,eAAe,CAC5D,aAAa,EACb,cAAc,EACd,aAAa,CACd;IACC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,MAAM,GAAE,qBAA0B;IAyB9C;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBpD;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAIzD;;OAEG;IACI,YAAY,CACjB,MAAM,EAAE,YAAY,EACpB,QAAQ,CAAC,EAAE,uBAAuB,GACjC,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC;IAMjD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAoBhD;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,sBAAsB,CAE5F;AAMD,eAAe,sBAAsB,CAAC"}

package/dist/types/adapters/mistral.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Mistral Frontend Adapter
+ *
+ * Pass-through adapter for Mistral format.
+ *
+ * @module
+ */
+import type { FrontendAdapter, AdapterMetadata } from 'ai.matey.types';
+import type { IRChatRequest, IRChatResponse, IRStreamChunk } from 'ai.matey.types';
+import type { StreamConversionOptions } from 'ai.matey.types';
+export interface MistralMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface MistralRequest {
+    model: string;
+    messages: MistralMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    stream?: boolean;
+    safe_mode?: boolean;
+    random_seed?: number;
+}
+export interface MistralResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: MistralMessage;
+        finish_reason: 'stop' | 'length' | 'model_length' | null;
+    }>;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export declare class MistralFrontendAdapter implements FrontendAdapter<MistralRequest, MistralResponse> {
+    readonly metadata: AdapterMetadata;
+    toIR(request: MistralRequest): Promise<IRChatRequest>;
+    fromIR(response: IRChatResponse): Promise<MistralResponse>;
+    fromIRStream(stream: AsyncGenerator<IRStreamChunk>, _options?: StreamConversionOptions): AsyncGenerator<string>;
+}
+//# sourceMappingURL=mistral.d.ts.map

package/dist/types/adapters/mistral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mistral.d.ts","sourceRoot":"","sources":["../../../src/adapters/mistral.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAa,MAAM,gBAAgB,CAAC;AAC9F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAG9D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,cAAc,CAAC;QACxB,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,GAAG,IAAI,CAAC;KAC1D,CAAC,CAAC;IACH,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,qBAAa,sBAAuB,YAAW,eAAe,CAAC,cAAc,EAAE,eAAe,CAAC;IAC7F,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAWhC;IAEF,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwBrD,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA+BnD,YAAY,CACjB,MAAM,EAAE,cAAc,CAAC,aAAa,CAAC,EACrC,QAAQ,CAAC,EAAE,uBAAuB,GACjC,cAAc,CAAC,MAAM,CAAC;CAS1B"}

package/dist/types/adapters/ollama.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Ollama Frontend Adapter
+ *
+ * Adapts Ollama API format to Universal IR.
+ * Ollama uses a local server with OpenAI-compatible chat format.
+ *
+ * @module
+ */
+import type { FrontendAdapter, AdapterMetadata } from 'ai.matey.types';
+import type { IRChatRequest, IRChatResponse, IRStreamChunk } from 'ai.matey.types';
+import type { StreamConversionOptions } from 'ai.matey.types';
+export interface OllamaMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface OllamaRequest {
+    model: string;
+    messages: OllamaMessage[];
+    options?: {
+        temperature?: number;
+        top_p?: number;
+        top_k?: number;
+        num_predict?: number;
+        stop?: string[];
+    };
+    stream?: boolean;
+}
+export interface OllamaResponse {
+    model: string;
+    created_at: string;
+    message: OllamaMessage;
+    done: boolean;
+    total_duration?: number;
+    load_duration?: number;
+    prompt_eval_count?: number;
+    eval_count?: number;
+}
+export declare class OllamaFrontendAdapter implements FrontendAdapter<OllamaRequest, OllamaResponse> {
+    readonly metadata: AdapterMetadata;
+    toIR(request: OllamaRequest): Promise<IRChatRequest>;
+    fromIR(response: IRChatResponse): Promise<OllamaResponse>;
+    fromIRStream(stream: AsyncGenerator<IRStreamChunk>, _options?: StreamConversionOptions): AsyncGenerator<string>;
+}
+//# sourceMappingURL=ollama.d.ts.map

package/dist/types/adapters/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../src/adapters/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAa,MAAM,gBAAgB,CAAC;AAC9F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAM9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,qBAAsB,YAAW,eAAe,CAAC,aAAa,EAAE,cAAc,CAAC;IAC1F,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAWhC;IAEF,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAyBpD,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAclD,YAAY,CACjB,MAAM,EAAE,cAAc,CAAC,aAAa,CAAC,EACrC,QAAQ,CAAC,EAAE,uBAAuB,GACjC,cAAc,CAAC,MAAM,CAAC;CAS1B"}

package/dist/types/adapters/openai.d.ts

@@ -0,0 +1,116 @@
+/**
+ * OpenAI Frontend Adapter
+ *
+ * Adapts OpenAI Chat Completions API format to Universal IR.
+ * Since OpenAI format is similar to IR, this is mostly a pass-through adapter.
+ *
+ * @module
+ */
+import type { FrontendAdapter, AdapterMetadata } from 'ai.matey.types';
+import type { IRChatRequest, IRChatResponse, IRChatStream } from 'ai.matey.types';
+import type { StreamConversionOptions } from 'ai.matey.types';
+/**
+ * OpenAI message content.
+ */
+export type OpenAIMessageContent = string | Array<{
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+}>;
+/**
+ * OpenAI message.
+ */
+export interface OpenAIMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: OpenAIMessageContent;
+    name?: string;
+    tool_call_id?: string;
+}
+/**
+ * OpenAI Chat Completions API request.
+ */
+export interface OpenAIRequest {
+    model: string;
+    messages: OpenAIMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    stop?: string | string[];
+    stream?: boolean;
+    user?: string;
+    seed?: number;
+}
+/**
+ * OpenAI Chat Completions API response.
+ */
+export interface OpenAIResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: OpenAIMessage;
+        finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+/**
+ * OpenAI streaming chunk.
+ */
+export interface OpenAIStreamChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        delta: {
+            role?: 'assistant';
+            content?: string;
+        };
+        finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
+    }>;
+}
+/**
+ * Frontend adapter for OpenAI Chat Completions API.
+ */
+export declare class OpenAIFrontendAdapter implements FrontendAdapter<OpenAIRequest, OpenAIResponse, OpenAIStreamChunk> {
+    readonly metadata: AdapterMetadata;
+    /**
+     * Convert OpenAI request to Universal IR.
+     */
+    toIR(request: OpenAIRequest): Promise<IRChatRequest>;
+    /**
+     * Convert Universal IR response to OpenAI format.
+     */
+    fromIR(response: IRChatResponse): Promise<OpenAIResponse>;
+    /**
+     * Convert Universal IR stream to OpenAI SSE format.
+     */
+    fromIRStream(stream: IRChatStream, options?: StreamConversionOptions): AsyncGenerator<OpenAIStreamChunk, void, undefined>;
+    /**
+     * Convert OpenAI message to IR message.
+     */
+    private convertMessageToIR;
+    /**
+     * Convert IR message to OpenAI message.
+     */
+    private convertMessageFromIR;
+    /**
+     * Map IR finish reason to OpenAI finish reason.
+     */
+    private mapFinishReason;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/types/adapters/openai.d.ts.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * AI Matey Frontend Adapters
+ *
+ * Consolidated package containing all frontend adapters.
+ * Each frontend adapter handles converting provider-specific
+ * request/response formats to Universal IR and vice versa.
+ *
+ * @module ai.matey.frontend
+ */
+export * from './adapters/openai.js';
+export * from './adapters/anthropic.js';
+export * from './adapters/gemini.js';
+export * from './adapters/mistral.js';
+export * from './adapters/ollama.js';
+export * from './adapters/chrome-ai.js';
+export * from './adapters/generic.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

package/package.json

@@ -0,0 +1,144 @@
+{
+  "name": "ai.matey.frontend",
+  "version": "0.2.0",
+  "description": "Frontend adapters for AI Matey - Universal AI Adapter System",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./openai": {
+      "import": {
+        "types": "./dist/types/adapters/openai.d.ts",
+        "default": "./dist/esm/adapters/openai.js"
+      },
+      "require": {
+        "types": "./dist/types/adapters/openai.d.ts",
+        "default": "./dist/cjs/adapters/openai.js"
+      }
+    },
+    "./anthropic": {
+      "import": {
+        "types": "./dist/types/adapters/anthropic.d.ts",
+        "default": "./dist/esm/adapters/anthropic.js"
+      },
+      "require": {
+        "types": "./dist/types/adapters/anthropic.d.ts",
+        "default": "./dist/cjs/adapters/anthropic.js"
+      }
+    },
+    "./gemini": {
+      "import": {
+        "types": "./dist/types/adapters/gemini.d.ts",
+        "default": "./dist/esm/adapters/gemini.js"
+      },
+      "require": {
+        "types": "./dist/types/adapters/gemini.d.ts",
+        "default": "./dist/cjs/adapters/gemini.js"
+      }
+    },
+    "./generic": {
+      "import": {
+        "types": "./dist/types/adapters/generic.d.ts",
+        "default": "./dist/esm/adapters/generic.js"
+      },
+      "require": {
+        "types": "./dist/types/adapters/generic.d.ts",
+        "default": "./dist/cjs/adapters/generic.js"
+      }
+    },
+    "./mistral": {
+      "import": {
+        "types": "./dist/types/adapters/mistral.d.ts",
+        "default": "./dist/esm/adapters/mistral.js"
+      },
+      "require": {
+        "types": "./dist/types/adapters/mistral.d.ts",
+        "default": "./dist/cjs/adapters/mistral.js"
+      }
+    },
+    "./ollama": {
+      "import": {
+        "types": "./dist/types/adapters/ollama.d.ts",
+        "default": "./dist/esm/adapters/ollama.js"
+      },
+      "require": {
+        "types": "./dist/types/adapters/ollama.d.ts",
+        "default": "./dist/cjs/adapters/ollama.js"
+      }
+    },
+    "./chrome-ai": {
+      "import": {
+        "types": "./dist/types/adapters/chrome-ai.d.ts",
+        "default": "./dist/esm/adapters/chrome-ai.js"
+      },
+      "require": {
+        "types": "./dist/types/adapters/chrome-ai.d.ts",
+        "default": "./dist/cjs/adapters/chrome-ai.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "readme.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "ai.matey.types": "*",
+    "ai.matey.errors": "*",
+    "ai.matey.utils": "*",
+    "ai.matey.backend": "*"
+  },
+  "devDependencies": {
+    "ai.matey.testing": "*",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "frontend",
+    "adapter",
+    "openai",
+    "anthropic",
+    "gemini",
+    "ai-matey"
+  ],
+  "author": "AI Matey",
+  "license": "MIT",
+  "homepage": "https://github.com/johnhenry/ai.matey#readme",
+  "bugs": {
+    "url": "https://github.com/johnhenry/ai.matey/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/johnhenry/ai.matey.git",
+    "directory": "packages/frontend"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/readme.md

@@ -0,0 +1,62 @@
+# ai.matey.frontend
+
+Frontend adapters for AI Matey - Universal AI Adapter System.
+
+Part of the [ai.matey](https://github.com/johnhenry/ai.matey) monorepo.
+
+## Installation
+
+```bash
+npm install ai.matey.frontend
+```
+
+## Overview
+
+Frontend adapters convert provider-specific request formats to the Universal IR (Intermediate Representation) format used internally by AI Matey. This allows your application to accept requests in any provider's format and route them to any backend.
+
+## Included Adapters
+
+- **OpenAI** - OpenAI Chat Completions API format
+- **Anthropic** - Anthropic Messages API format
+- **Gemini** - Google Gemini API format
+- **Mistral** - Mistral API format
+- **Ollama** - Ollama API format
+- **Chrome AI** - Chrome AI format
+- **Generic** - Passthrough adapter for IR format
+
+## Usage
+
+```typescript
+import { OpenAIFrontendAdapter, AnthropicFrontendAdapter } from 'ai.matey.frontend';
+import { Bridge } from 'ai.matey.core';
+
+// Accept OpenAI-formatted requests
+const openAIFrontend = new OpenAIFrontendAdapter();
+
+// Accept Anthropic-formatted requests
+const anthropicFrontend = new AnthropicFrontendAdapter();
+
+// Create a bridge that accepts OpenAI format
+const bridge = new Bridge({
+  frontend: openAIFrontend,
+  backend: yourBackend,
+});
+```
+
+## Generic Adapter
+
+The Generic adapter passes IR format directly without conversion:
+
+```typescript
+import { GenericFrontendAdapter, createGenericFrontend } from 'ai.matey.frontend';
+
+const frontend = createGenericFrontend();
+```
+
+## API Reference
+
+See the TypeScript definitions for detailed API documentation.
+
+## License
+
+MIT - see [LICENSE](./LICENSE) for details.