ai.matey.wrapper 0.2.0

package/dist/types/anymethod.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Anymethod Wrapper
+ *
+ * Natural language method interface using Proxy pattern.
+ *
+ * @module
+ */
+import type { BackendAdapter, IRMessage } from 'ai.matey.types';
+export interface AnymethodConfig {
+    model?: string;
+    temperature?: number;
+    topK?: number;
+    topP?: number;
+    maxTokens?: number;
+    maxHistorySize?: number;
+    initialPrompts?: Array<{
+        role: 'system' | 'user' | 'assistant';
+        content: string;
+    }>;
+    autoParseJSON?: boolean;
+    methodPromptFormatter?: (methodName: string, args: unknown[]) => string;
+}
+export interface Anymethod {
+    readonly $: AnymethodProxy;
+    readonly $$: AnymethodStreamProxy;
+    prompt(input: string): Promise<string>;
+    promptStreaming(input: string): AsyncIterable<string>;
+    getHistory(): readonly IRMessage[];
+    clearHistory(): void;
+    setHistory(history: IRMessage[]): void;
+    tokensSoFar: number;
+    maxTokens: number;
+    tokensLeft: number;
+}
+export type AnymethodProxy = {
+    [key: string]: (...args: unknown[]) => Promise<unknown>;
+};
+export type AnymethodStreamProxy = {
+    [key: string]: (...args: unknown[]) => AsyncIterable<string>;
+};
+export declare function formatMethodPrompt(methodName: string, args: unknown[]): string;
+export declare function createAnymethod(backend: BackendAdapter, config?: AnymethodConfig): Anymethod;
+export declare function createStatelessAnymethod(backend: BackendAdapter, config?: Omit<AnymethodConfig, 'maxHistorySize'>): Anymethod;
+export declare function createConversationalAnymethod(backend: BackendAdapter, maxHistorySize?: number, config?: Omit<AnymethodConfig, 'maxHistorySize'>): Anymethod;
+//# sourceMappingURL=anymethod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anymethod.d.ts","sourceRoot":"","sources":["../../src/anymethod.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAiB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAO/E,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qBAAqB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;CACzE;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,CAAC,EAAE,cAAc,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,oBAAoB,CAAC;IAClC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACtD,UAAU,IAAI,SAAS,SAAS,EAAE,CAAC;IACnC,YAAY,IAAI,IAAI,CAAC;IACrB,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9D,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAa9E;AAMD,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,GAAE,eAAoB,GAAG,SAAS,CAgKhG;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,cAAc,EACvB,MAAM,GAAE,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAM,GACnD,SAAS,CAEX;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,cAAc,EACvB,cAAc,GAAE,MAAW,EAC3B,MAAM,GAAE,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAM,GACnD,SAAS,CAEX"}

package/dist/types/chat.d.ts

@@ -0,0 +1,144 @@
+/**
+ * IR Chat Client
+ *
+ * An IR-native chat client that wraps the Bridge/BackendAdapter
+ * with conversation state management, streaming helpers, and tool support.
+ *
+ * @module
+ */
+import type { IRMessage, MessageContent } from 'ai.matey.types';
+import type { ChatConfig, SendOptions, StreamOptions, ChatResponse, ConversationState, ChatEventType, ChatEventListener, ChatEvents } from './types.js';
+/**
+ * Headless chat client with conversation state management.
+ *
+ * @example
+ * ```typescript
+ * import { Chat } from 'ai.matey.wrapper/ir';
+ * import { AnthropicBackend } from 'ai.matey.backend/anthropic';
+ *
+ * const chat = new Chat({
+ *   backend: new AnthropicBackend({ apiKey: process.env.ANTHROPIC_API_KEY }),
+ *   systemPrompt: 'You are a helpful assistant.',
+ *   historyLimit: 50,
+ * });
+ *
+ * // Non-streaming
+ * const response = await chat.send('Hello!');
+ * console.log(response.content);
+ *
+ * // Streaming
+ * await chat.stream('Tell me a story', {
+ *   onChunk: ({ delta }) => process.stdout.write(delta),
+ *   onDone: (response) => console.log('\n[Done]'),
+ * });
+ *
+ * // Access state
+ * console.log(chat.messages);
+ * console.log(chat.totalUsage);
+ * ```
+ */
+export declare class Chat {
+    private readonly config;
+    private readonly backend;
+    private _messages;
+    private _isLoading;
+    private _error;
+    private _totalUsage;
+    private _requestCount;
+    private _listeners;
+    private _requestIdCounter;
+    /**
+     * Create a new Chat instance.
+     */
+    constructor(config: ChatConfig);
+    /**
+     * Get all messages in the conversation.
+     */
+    get messages(): readonly IRMessage[];
+    /**
+     * Get whether a request is in progress.
+     */
+    get isLoading(): boolean;
+    /**
+     * Get the current error, if any.
+     */
+    get error(): Error | null;
+    /**
+     * Get cumulative token usage.
+     */
+    get totalUsage(): Readonly<typeof this._totalUsage>;
+    /**
+     * Get the number of requests made.
+     */
+    get requestCount(): number;
+    /**
+     * Get a snapshot of the conversation state.
+     */
+    get state(): ConversationState;
+    /**
+     * Send a message and get a response (non-streaming).
+     *
+     * @param content - The message content (string or structured content)
+     * @param options - Request options
+     * @returns The assistant's response
+     */
+    send(content: string | readonly MessageContent[], options?: SendOptions): Promise<ChatResponse>;
+    /**
+     * Send a message and stream the response.
+     *
+     * @param content - The message content
+     * @param options - Streaming options with callbacks
+     * @returns The final response after streaming completes
+     */
+    stream(content: string | readonly MessageContent[], options?: StreamOptions): Promise<ChatResponse>;
+    /**
+     * Add a message to the conversation without sending a request.
+     * Useful for restoring conversation history or injecting context.
+     */
+    addMessage(message: IRMessage): void;
+    /**
+     * Clear the conversation history.
+     */
+    clear(): void;
+    /**
+     * Remove the last N messages from the conversation.
+     */
+    removeLastMessages(count?: number): IRMessage[];
+    /**
+     * Subscribe to chat events.
+     */
+    on<K extends ChatEventType>(event: K, listener: ChatEventListener<ChatEvents[K]>): () => void;
+    /**
+     * Unsubscribe from chat events.
+     */
+    off<K extends ChatEventType>(event: K, listener: ChatEventListener<ChatEvents[K]>): void;
+    private executeWithToolLoop;
+    private executeStreamWithToolLoop;
+    private executeToolCalls;
+    private buildRequest;
+    private getMessagesWithSystem;
+    private processResponse;
+    private extractTextContent;
+    private extractToolCalls;
+    private createUserMessage;
+    private updateUsage;
+    private trimHistory;
+    private generateRequestId;
+    private setLoading;
+    private setError;
+    private emit;
+    private emitStateChange;
+}
+/**
+ * Create a new Chat instance.
+ *
+ * @example
+ * ```typescript
+ * const chat = createChat({
+ *   backend: myBackend,
+ *   systemPrompt: 'You are helpful.',
+ * });
+ * ```
+ */
+export declare function createChat(config: ChatConfig): Chat;
+//# sourceMappingURL=chat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,SAAS,EAIT,cAAc,EAEf,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EACV,UAAU,EAEV,WAAW,EACX,aAAa,EACb,YAAY,EAGZ,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,UAAU,EACX,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGV;IACb,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IAGtC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,WAAW,CAA4D;IAC/E,OAAO,CAAC,aAAa,CAAK;IAG1B,OAAO,CAAC,UAAU,CAAyD;IAG3E,OAAO,CAAC,iBAAiB,CAAK;IAE9B;;OAEG;gBACS,MAAM,EAAE,UAAU;IAc9B;;OAEG;IACH,IAAI,QAAQ,IAAI,SAAS,SAAS,EAAE,CAEnC;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,CAExB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,QAAQ,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,CAElD;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,iBAAiB,CAQ7B;IAMD;;;;;;OAMG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE,EAC3C,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,YAAY,CAAC;IAsBxB;;;;;;OAMG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE,EAC3C,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IAuBxB;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI;IAMpC;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,kBAAkB,CAAC,KAAK,GAAE,MAAU,GAAG,SAAS,EAAE;IAUlD;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAY7F;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;YAQ1E,mBAAmB;YAiCnB,yBAAyB;YAqHzB,gBAAgB;YA2BhB,YAAY;YAmBZ,qBAAqB;IAsBnC,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,eAAe;CAGxB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAEnD"}

package/dist/types/chrome-ai-legacy.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Legacy Chrome AI Language Model Wrapper
+ *
+ * Mimics the ORIGINAL Chrome AI (window.ai.languageModel) API before recent changes.
+ *
+ * @module
+ */
+import type { BackendAdapter } from 'ai.matey.types';
+export interface LegacyChromeAIPrompt {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface LegacyChromeAICreateOptions {
+    initialPrompts?: LegacyChromeAIPrompt[];
+    temperature?: number;
+    topK?: number;
+    maxTokens?: number;
+    model?: string;
+    maxHistorySize?: number;
+}
+export interface LegacyChromeAISession {
+    prompt(input: string): Promise<string>;
+    promptStreaming(input: string): AsyncIterable<string>;
+    destroy(): void;
+    clone(): LegacyChromeAISession;
+    tokensSoFar?: number;
+    maxTokens?: number;
+    tokensLeft?: number;
+}
+export interface LegacyChromeAILanguageModelAPI {
+    create(options?: LegacyChromeAICreateOptions): LegacyChromeAISession;
+    capabilities(): Promise<{
+        available: 'yes' | 'no' | 'after-download';
+        defaultTemperature?: number;
+        defaultTopK?: number;
+        maxTopK?: number;
+    }>;
+}
+export declare function LegacyChromeAILanguageModel(backend: BackendAdapter): LegacyChromeAILanguageModelAPI;
+export declare function createLegacyWindowAI(backend: BackendAdapter): {
+    languageModel: LegacyChromeAILanguageModelAPI;
+};
+export declare function polyfillLegacyWindowAI(backend: BackendAdapter): void;
+//# sourceMappingURL=chrome-ai-legacy.d.ts.map

package/dist/types/chrome-ai-legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome-ai-legacy.d.ts","sourceRoot":"","sources":["../../src/chrome-ai-legacy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,gBAAgB,CAAC;AAO/E,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACtD,OAAO,IAAI,IAAI,CAAC;IAChB,KAAK,IAAI,qBAAqB,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,qBAAqB,CAAC;IACrE,YAAY,IAAI,OAAO,CAAC;QACtB,SAAS,EAAE,KAAK,GAAG,IAAI,GAAG,gBAAgB,CAAC;QAC3C,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AA+JD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,cAAc,GACtB,8BAA8B,CAqBhC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc;;EAE3D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAIpE"}

package/dist/types/chrome-ai.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Chrome AI Language Model Wrapper
+ *
+ * Mimics the Chrome AI (window.ai.languageModel) API using any backend adapter.
+ *
+ * @module
+ */
+import type { BackendAdapter, StreamMode } from 'ai.matey.types';
+export interface ChromeAIPrompt {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface ChromeAICreateOptions {
+    initialPrompts?: ChromeAIPrompt[];
+    temperature?: number;
+    topK?: number;
+    topP?: number;
+    maxTokens?: number;
+    model?: string;
+    streamMode?: StreamMode;
+}
+export interface ChromeAISession {
+    prompt(input: string): Promise<string>;
+    promptStreaming(input: string): ReadableStream<string>;
+    destroy(): void;
+    clone(): ChromeAISession;
+}
+export interface ChromeAILanguageModelAPI {
+    create(options?: ChromeAICreateOptions): ChromeAISession;
+    capabilities(): Promise<{
+        available: 'readily' | 'after-download' | 'no';
+    }>;
+}
+export declare function ChromeAILanguageModel(backend: BackendAdapter, defaultOptions?: ChromeAICreateOptions): ChromeAILanguageModelAPI;
+export declare function createChromeAILanguageModel(backend: BackendAdapter): {
+    languageModel: ChromeAILanguageModelAPI;
+};
+//# sourceMappingURL=chrome-ai.d.ts.map

package/dist/types/chrome-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome-ai.d.ts","sourceRoot":"","sources":["../../src/chrome-ai.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA4B,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAM3F,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACvD,OAAO,IAAI,IAAI,CAAC;IAChB,KAAK,IAAI,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,eAAe,CAAC;IACzD,YAAY,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC7E;AA0ID,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,cAAc,GAAE,qBAA0B,GACzC,wBAAwB,CAmB1B;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,cAAc;;EAElE"}

package/dist/types/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * AI Matey Wrappers
+ *
+ * Consolidated package containing SDK wrappers and IR utilities.
+ * These wrappers allow using provider SDK patterns with any backend.
+ *
+ * @module ai.matey.wrapper
+ */
+export { OpenAI, OpenAIClient, ChatCompletions, ChatCompletions as OpenAIChatCompletions, Chat as OpenAIChat, Models as OpenAIModels, } from './openai-sdk.js';
+export type { OpenAIChatCompletionParams, OpenAIChatCompletionChoice, OpenAIChatCompletion, OpenAIChatCompletionChunk, OpenAIModelsPage, } from './openai-sdk.js';
+export { Anthropic, AnthropicClient, Messages, Messages as AnthropicMessages, Models as AnthropicModels, } from './anthropic-sdk.js';
+export type { AnthropicMessageParams, AnthropicMessage, AnthropicStreamEvent, AnthropicModelsResponse, } from './anthropic-sdk.js';
+export * from './anymethod.js';
+export * from './chrome-ai.js';
+export * from './chrome-ai-legacy.js';
+export { Chat, createChat } from './chat.js';
+export type { ChatConfig, ChatBackend, ToolCallHandler, SendOptions, StreamOptions, ChatResponse, ToolCall, StreamChunkEvent, ConversationState, ChatEventType, ChatEventListener, ChatEvents, } from './types.js';
+export { collectStream, processStream, streamToText, streamToLines, throttleStream, teeStream, } from './stream-utils.js';
+export type { CollectedStream, TransformStreamOptions } from './stream-utils.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;;;;;;;GAOG;AAGH,OAAO,EACL,MAAM,EACN,YAAY,EACZ,eAAe,EACf,eAAe,IAAI,qBAAqB,EACxC,IAAI,IAAI,UAAU,EAClB,MAAM,IAAI,YAAY,GACvB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,SAAS,EACT,eAAe,EACf,QAAQ,EACR,QAAQ,IAAI,iBAAiB,EAC7B,MAAM,IAAI,eAAe,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAG5B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EACV,UAAU,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACX,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,SAAS,GACV,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/ir-index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * ai.matey.wrapper/ir
+ *
+ * IR-native chat wrapper for the AI Matey universal adapter system.
+ *
+ * This package provides a chat client that works directly with the
+ * IR (Intermediate Representation) format.
+ *
+ * @example
+ * ```typescript
+ * import { createChat } from 'ai.matey.wrapper/ir';
+ * import { AnthropicBackend } from 'ai.matey.backend/anthropic';
+ *
+ * const chat = createChat({
+ *   backend: new AnthropicBackend({ apiKey: process.env.ANTHROPIC_API_KEY }),
+ *   systemPrompt: 'You are a helpful assistant.',
+ * });
+ *
+ * // Non-streaming
+ * const response = await chat.send('Hello!');
+ * console.log(response.content);
+ *
+ * // Streaming with callbacks
+ * await chat.stream('Tell me a story', {
+ *   onChunk: ({ delta }) => process.stdout.write(delta),
+ * });
+ *
+ * // Or use stream utilities directly
+ * const stream = backend.executeStream(request);
+ * for await (const text of streamToText(stream)) {
+ *   process.stdout.write(text);
+ * }
+ * ```
+ *
+ * @module
+ */
+export { Chat, createChat } from './chat.js';
+export { collectStream, processStream, streamToText, streamToLines, throttleStream, teeStream, } from './stream-utils.js';
+export type { ChatConfig, ChatBackend, ToolCallHandler, SendOptions, StreamOptions, ChatResponse, ToolCall, StreamChunkEvent, ConversationState, ChatEventType, ChatEventListener, ChatEvents, } from './types.js';
+export type { CollectedStream, TransformStreamOptions } from './stream-utils.js';
+//# sourceMappingURL=ir-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ir-index.d.ts","sourceRoot":"","sources":["../../src/ir-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,SAAS,GACV,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAEV,UAAU,EACV,WAAW,EACX,eAAe,EAGf,WAAW,EACX,aAAa,EAGb,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAGhB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/openai-sdk.d.ts

@@ -0,0 +1,183 @@
+/**
+ * OpenAI SDK Wrapper
+ *
+ * Mimics the OpenAI SDK interface using any backend adapter.
+ * Allows you to use OpenAI SDK-style code with any provider.
+ *
+ * Uses the OpenAI Frontend Adapter internally for format conversions.
+ *
+ * @module
+ */
+import type { BackendAdapter, StreamMode, ListModelsOptions } from 'ai.matey.types';
+import { type OpenAIMessage } from 'ai.matey.frontend';
+export type { OpenAIRequest, OpenAIResponse, OpenAIStreamChunk, OpenAIMessage, } from 'ai.matey.frontend';
+/**
+ * OpenAI chat completion request parameters (SDK style).
+ */
+export interface OpenAIChatCompletionParams {
+    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 completion choice.
+ */
+export interface OpenAIChatCompletionChoice {
+    index: number;
+    message: OpenAIMessage;
+    finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
+}
+/**
+ * OpenAI usage information.
+ */
+export interface OpenAIUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+/**
+ * OpenAI chat completion response.
+ */
+export interface OpenAIChatCompletion {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: OpenAIChatCompletionChoice[];
+    usage: OpenAIUsage;
+}
+/**
+ * OpenAI streaming chunk delta.
+ */
+export interface OpenAIStreamDelta {
+    role?: 'assistant';
+    content?: string;
+}
+/**
+ * OpenAI streaming chunk choice.
+ */
+export interface OpenAIStreamChoice {
+    index: number;
+    delta: OpenAIStreamDelta;
+    finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
+}
+/**
+ * OpenAI chat completion chunk (streaming).
+ */
+export interface OpenAIChatCompletionChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    choices: OpenAIStreamChoice[];
+}
+/**
+ * OpenAI Model object.
+ */
+export interface OpenAIModel {
+    id: string;
+    object: 'model';
+    created: number;
+    owned_by: string;
+}
+/**
+ * OpenAI Models list page.
+ */
+export interface OpenAIModelsPage {
+    object: 'list';
+    data: OpenAIModel[];
+}
+/**
+ * OpenAI SDK wrapper configuration.
+ */
+export interface OpenAISDKConfig {
+    /**
+     * Streaming mode for stream responses.
+     * @default 'delta'
+     */
+    streamMode?: StreamMode;
+}
+/**
+ * Chat completions interface (mimics OpenAI SDK).
+ */
+export declare class ChatCompletions {
+    private backend;
+    private config;
+    private adapter;
+    constructor(backend: BackendAdapter, config?: OpenAISDKConfig);
+    /**
+     * Create a chat completion (non-streaming).
+     */
+    create(params: OpenAIChatCompletionParams & {
+        stream?: false | undefined;
+    }): Promise<OpenAIChatCompletion>;
+    /**
+     * Create a chat completion (streaming).
+     */
+    create(params: OpenAIChatCompletionParams & {
+        stream: true;
+    }): AsyncIterable<OpenAIChatCompletionChunk>;
+    private createNonStream;
+    private createStream;
+}
+/**
+ * Models interface (mimics OpenAI SDK).
+ */
+export declare class Models {
+    private backend;
+    constructor(backend: BackendAdapter);
+    /**
+     * List available models.
+     */
+    list(options?: ListModelsOptions): Promise<OpenAIModelsPage>;
+    /**
+     * Retrieve information about a specific model.
+     */
+    retrieve(modelId: string): Promise<OpenAIModel | null>;
+}
+/**
+ * Chat interface (mimics OpenAI SDK).
+ */
+export declare class Chat {
+    readonly completions: ChatCompletions;
+    constructor(backend: BackendAdapter, config?: OpenAISDKConfig);
+}
+/**
+ * OpenAI SDK-compatible client.
+ */
+export declare class OpenAIClient {
+    readonly chat: Chat;
+    readonly models: Models;
+    constructor(backend: BackendAdapter, config?: OpenAISDKConfig);
+}
+/**
+ * Create an OpenAI SDK-compatible client using any backend adapter.
+ *
+ * @example
+ * ```typescript
+ * import { OpenAI } from 'ai.matey.wrapper/openai';
+ * import { AnthropicBackendAdapter } from 'ai.matey.backend/anthropic';
+ *
+ * const backend = new AnthropicBackendAdapter({ apiKey: 'sk-ant-...' });
+ * const client = OpenAI(backend);
+ *
+ * const completion = await client.chat.completions.create({
+ *   model: 'claude-3-5-sonnet',
+ *   messages: [
+ *     { role: 'user', content: 'Hello!' }
+ *   ],
+ * });
+ *
+ * console.log(completion.choices[0].message.content);
+ * ```
+ */
+export declare function OpenAI(backend: BackendAdapter, config?: OpenAISDKConfig): OpenAIClient;
+//# sourceMappingURL=openai-sdk.d.ts.map

package/dist/types/openai-sdk.d.ts.map

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

package/dist/types/stream-utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Stream Utilities
+ *
+ * Re-exports stream utilities from ai.matey.utils.
+ *
+ * @module
+ */
+export { collectStreamFull as collectStream, processStream, streamToLines, throttleStream, teeStream, streamToTextIterator as streamToText, type CollectedStream, type ProcessStreamOptions as TransformStreamOptions, } from 'ai.matey.utils';
+//# sourceMappingURL=stream-utils.d.ts.map

package/dist/types/stream-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-utils.d.ts","sourceRoot":"","sources":["../../src/stream-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAEL,iBAAiB,IAAI,aAAa,EAClC,aAAa,EACb,aAAa,EACb,cAAc,EACd,SAAS,EAGT,oBAAoB,IAAI,YAAY,EAGpC,KAAK,eAAe,EACpB,KAAK,oBAAoB,IAAI,sBAAsB,GACpD,MAAM,gBAAgB,CAAC"}