ai.matey.cli 0.2.0

package/dist/esm/converters/request-converters.js

@@ -0,0 +1,175 @@
+/**
+ * Request Conversion Utilities
+ *
+ * Convert Universal IR requests to provider-specific formats for debugging.
+ * Complements the response converters - provides full request/response symmetry.
+ *
+ * @example
+ * ```typescript
+ * import { toOpenAIRequest, toAnthropicRequest } from 'ai.matey';
+ *
+ * // Convert IR request to see what will be sent to OpenAI
+ * const openaiReq = toOpenAIRequest(irRequest);
+ * console.log('Will send to OpenAI:', openaiReq);
+ *
+ * // Convert IR request to Anthropic format
+ * const anthropicReq = toAnthropicRequest(irRequest);
+ * ```
+ *
+ * @module
+ */
+import { OpenAIBackendAdapter } from 'ai.matey.backend';
+import { AnthropicBackendAdapter } from 'ai.matey.backend';
+import { GeminiBackendAdapter } from 'ai.matey.backend';
+import { OllamaBackendAdapter } from 'ai.matey.backend';
+import { MistralBackendAdapter } from 'ai.matey.backend';
+// ============================================================================
+// Individual Request Converters
+// ============================================================================
+/**
+ * Convert IR request to OpenAI format.
+ *
+ * Useful for:
+ * - Debugging: See what will be sent to OpenAI
+ * - Testing: Create OpenAI requests without a backend
+ * - Inspection: Understand format transformations
+ *
+ * @param request - Universal IR request
+ * @returns OpenAI-formatted request
+ *
+ * @example
+ * ```typescript
+ * const openaiReq = toOpenAIRequest({
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ *   parameters: { model: 'gpt-4', temperature: 0.7 }
+ * });
+ * console.log(openaiReq.messages); // OpenAI format
+ * ```
+ */
+export function toOpenAIRequest(request) {
+    const adapter = new OpenAIBackendAdapter({ apiKey: 'dummy' });
+    return adapter.fromIR(request);
+}
+/**
+ * Convert IR request to Anthropic format.
+ *
+ * @param request - Universal IR request
+ * @returns Anthropic-formatted request
+ *
+ * @example
+ * ```typescript
+ * const anthropicReq = toAnthropicRequest({
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ *   parameters: { model: 'claude-3', maxTokens: 100 }
+ * });
+ * console.log(anthropicReq.system); // Anthropic uses separate system parameter
+ * ```
+ */
+export function toAnthropicRequest(request) {
+    const adapter = new AnthropicBackendAdapter({ apiKey: 'dummy' });
+    return adapter.fromIR(request);
+}
+/**
+ * Convert IR request to Gemini format.
+ *
+ * @param request - Universal IR request
+ * @returns Gemini-formatted request
+ *
+ * @example
+ * ```typescript
+ * const geminiReq = toGeminiRequest({
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ *   parameters: { model: 'gemini-pro', temperature: 0.7 }
+ * });
+ * console.log(geminiReq.contents); // Gemini uses 'contents' array
+ * ```
+ */
+export function toGeminiRequest(request) {
+    const adapter = new GeminiBackendAdapter({ apiKey: 'dummy' });
+    return adapter.fromIR(request);
+}
+/**
+ * Convert IR request to Ollama format.
+ *
+ * @param request - Universal IR request
+ * @returns Ollama-formatted request
+ *
+ * @example
+ * ```typescript
+ * const ollamaReq = toOllamaRequest({
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ *   parameters: { model: 'llama2', temperature: 0.7 }
+ * });
+ * ```
+ */
+export function toOllamaRequest(request) {
+    const adapter = new OllamaBackendAdapter({ apiKey: 'dummy' });
+    return adapter.fromIR(request);
+}
+/**
+ * Convert IR request to Mistral format.
+ *
+ * @param request - Universal IR request
+ * @returns Mistral-formatted request
+ *
+ * @example
+ * ```typescript
+ * const mistralReq = toMistralRequest({
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ *   parameters: { model: 'mistral-small', temperature: 0.7 }
+ * });
+ * ```
+ */
+export function toMistralRequest(request) {
+    const adapter = new MistralBackendAdapter({ apiKey: 'dummy' });
+    return adapter.fromIR(request);
+}
+// ============================================================================
+// Multi-Format Converter
+// ============================================================================
+/**
+ * Convert IR request to multiple provider formats at once.
+ *
+ * Useful for comparing how the same request looks across different providers.
+ *
+ * @param request - Universal IR request
+ * @param formats - Array of target formats
+ * @returns Object with format names as keys and converted requests as values
+ *
+ * @example
+ * ```typescript
+ * const allFormats = toMultipleRequestFormats(irRequest, [
+ *   'openai',
+ *   'anthropic',
+ *   'gemini'
+ * ]);
+ *
+ * console.log('OpenAI:', allFormats.openai);
+ * console.log('Anthropic:', allFormats.anthropic);
+ * console.log('Gemini:', allFormats.gemini);
+ * ```
+ */
+export function toMultipleRequestFormats(request, formats) {
+    const result = {};
+    for (const format of formats) {
+        switch (format) {
+            case 'openai':
+                result.openai = toOpenAIRequest(request);
+                break;
+            case 'anthropic':
+                result.anthropic = toAnthropicRequest(request);
+                break;
+            case 'gemini':
+                result.gemini = toGeminiRequest(request);
+                break;
+            case 'ollama':
+                result.ollama = toOllamaRequest(request);
+                break;
+            case 'mistral':
+                result.mistral = toMistralRequest(request);
+                break;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=request-converters.js.map

package/dist/esm/converters/request-converters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-converters.js","sourceRoot":"","sources":["../../../src/converters/request-converters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,oBAAoB,EAAsB,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAyB,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAsB,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAsB,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAuB,MAAM,kBAAkB,CAAC;AAE9E,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe,CAAC,OAAsB;IACpD,MAAM,OAAO,GAAG,IAAI,oBAAoB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAsB;IACvD,MAAM,OAAO,GAAG,IAAI,uBAAuB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACjE,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,OAAsB;IACpD,MAAM,OAAO,GAAG,IAAI,oBAAoB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,OAAsB;IACpD,MAAM,OAAO,GAAG,IAAI,oBAAoB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACrD,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAsB,EACtB,OAAwE;IAQxE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,QAAQ;gBACX,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,WAAW;gBACd,MAAM,CAAC,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;gBAC/C,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,SAAS;gBACZ,MAAM,CAAC,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;gBAC3C,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/converters/response-converters.js

@@ -0,0 +1,191 @@
+/**
+ * Response Converters
+ *
+ * Utility functions for converting Universal IR responses to various frontend formats.
+ * Useful for debugging, testing, and compatibility checking.
+ *
+ * @module
+ */
+import { OpenAIFrontendAdapter, } from 'ai.matey.frontend';
+import { AnthropicFrontendAdapter, } from 'ai.matey.frontend';
+import { GeminiFrontendAdapter } from 'ai.matey.frontend';
+import { OllamaFrontendAdapter } from 'ai.matey.frontend';
+import { MistralFrontendAdapter } from 'ai.matey.frontend';
+// ============================================================================
+// Non-Streaming Converters
+// ============================================================================
+/**
+ * Convert Universal IR response to OpenAI format.
+ *
+ * @param response Universal IR response
+ * @returns OpenAI-formatted response
+ *
+ * @example
+ * ```typescript
+ * import { toOpenAI } from 'ai.matey.utils';
+ *
+ * const irResponse = await backend.execute(request);
+ * const openaiFormat = await toOpenAI(irResponse);
+ * console.log(JSON.stringify(openaiFormat, null, 2));
+ * ```
+ */
+export async function toOpenAI(response) {
+    const adapter = new OpenAIFrontendAdapter();
+    return adapter.fromIR(response);
+}
+/**
+ * Convert Universal IR response to Anthropic format.
+ *
+ * @param response Universal IR response
+ * @returns Anthropic-formatted response
+ *
+ * @example
+ * ```typescript
+ * import { toAnthropic } from 'ai.matey.utils';
+ *
+ * const irResponse = await backend.execute(request);
+ * const anthropicFormat = await toAnthropic(irResponse);
+ * ```
+ */
+export async function toAnthropic(response) {
+    const adapter = new AnthropicFrontendAdapter();
+    return adapter.fromIR(response);
+}
+/**
+ * Convert Universal IR response to Gemini format.
+ *
+ * @param response Universal IR response
+ * @returns Gemini-formatted response
+ */
+export async function toGemini(response) {
+    const adapter = new GeminiFrontendAdapter();
+    return adapter.fromIR(response);
+}
+/**
+ * Convert Universal IR response to Ollama format.
+ *
+ * @param response Universal IR response
+ * @returns Ollama-formatted response
+ */
+export async function toOllama(response) {
+    const adapter = new OllamaFrontendAdapter();
+    return adapter.fromIR(response);
+}
+/**
+ * Convert Universal IR response to Mistral format.
+ *
+ * @param response Universal IR response
+ * @returns Mistral-formatted response
+ */
+export async function toMistral(response) {
+    const adapter = new MistralFrontendAdapter();
+    return adapter.fromIR(response);
+}
+// ============================================================================
+// Streaming Converters
+// ============================================================================
+/**
+ * Convert Universal IR stream to OpenAI SSE format.
+ *
+ * @param stream Universal IR stream
+ * @param options Stream conversion options
+ * @returns OpenAI-formatted stream chunks
+ *
+ * @example
+ * ```typescript
+ * import { toOpenAIStream } from 'ai.matey.utils';
+ *
+ * const irStream = backend.executeStream(request);
+ * for await (const chunk of toOpenAIStream(irStream)) {
+ *   console.log('OpenAI chunk:', chunk);
+ * }
+ * ```
+ */
+export async function* toOpenAIStream(stream, options) {
+    const adapter = new OpenAIFrontendAdapter();
+    yield* adapter.fromIRStream(stream, options);
+}
+/**
+ * Convert Universal IR stream to Anthropic SSE format.
+ *
+ * @param stream Universal IR stream
+ * @param options Stream conversion options
+ * @returns Anthropic-formatted stream chunks
+ */
+export async function* toAnthropicStream(stream, options) {
+    const adapter = new AnthropicFrontendAdapter();
+    yield* adapter.fromIRStream(stream, options);
+}
+/**
+ * Convert Universal IR stream to Gemini SSE format.
+ *
+ * @param stream Universal IR stream
+ * @param options Stream conversion options
+ * @returns Gemini-formatted stream chunks
+ */
+export async function* toGeminiStream(stream, options) {
+    const adapter = new GeminiFrontendAdapter();
+    yield* adapter.fromIRStream(stream, options);
+}
+/**
+ * Convert Universal IR stream to Mistral SSE format.
+ *
+ * @param stream Universal IR stream
+ * @param options Stream conversion options
+ * @returns Mistral-formatted stream chunks
+ */
+export async function* toMistralStream(stream, options) {
+    const adapter = new MistralFrontendAdapter();
+    yield* adapter.fromIRStream(stream, options);
+}
+// ============================================================================
+// Multi-Format Converter (for comparison/debugging)
+// ============================================================================
+/**
+ * Convert Universal IR response to multiple formats at once.
+ * Useful for debugging and comparing how different providers handle the same response.
+ *
+ * @param response Universal IR response
+ * @param formats Array of format names to convert to
+ * @returns Object with converted responses for each format
+ *
+ * @example
+ * ```typescript
+ * import { toMultipleFormats } from 'ai.matey.utils';
+ *
+ * const irResponse = await backend.execute(request);
+ * const allFormats = await toMultipleFormats(irResponse, ['openai', 'anthropic', 'gemini']);
+ *
+ * console.log('OpenAI:', JSON.stringify(allFormats.openai, null, 2));
+ * console.log('Anthropic:', JSON.stringify(allFormats.anthropic, null, 2));
+ * console.log('Gemini:', JSON.stringify(allFormats.gemini, null, 2));
+ * ```
+ */
+export async function toMultipleFormats(response, formats = [
+    'openai',
+    'anthropic',
+    'gemini',
+]) {
+    const result = {};
+    for (const format of formats) {
+        switch (format) {
+            case 'openai':
+                result.openai = await toOpenAI(response);
+                break;
+            case 'anthropic':
+                result.anthropic = await toAnthropic(response);
+                break;
+            case 'gemini':
+                result.gemini = await toGemini(response);
+                break;
+            case 'ollama':
+                result.ollama = await toOllama(response);
+                break;
+            case 'mistral':
+                result.mistral = await toMistral(response);
+                break;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=response-converters.js.map

package/dist/esm/converters/response-converters.js.map

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