ai.matey.cli 0.2.0

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

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toOpenAIRequest = toOpenAIRequest;
+exports.toAnthropicRequest = toAnthropicRequest;
+exports.toGeminiRequest = toGeminiRequest;
+exports.toOllamaRequest = toOllamaRequest;
+exports.toMistralRequest = toMistralRequest;
+exports.toMultipleRequestFormats = toMultipleRequestFormats;
+const ai_matey_backend_1 = require("ai.matey.backend");
+const ai_matey_backend_2 = require("ai.matey.backend");
+const ai_matey_backend_3 = require("ai.matey.backend");
+const ai_matey_backend_4 = require("ai.matey.backend");
+const ai_matey_backend_5 = require("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
+ * ```
+ */
+function toOpenAIRequest(request) {
+    const adapter = new ai_matey_backend_1.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
+ * ```
+ */
+function toAnthropicRequest(request) {
+    const adapter = new ai_matey_backend_2.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
+ * ```
+ */
+function toGeminiRequest(request) {
+    const adapter = new ai_matey_backend_3.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 }
+ * });
+ * ```
+ */
+function toOllamaRequest(request) {
+    const adapter = new ai_matey_backend_4.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 }
+ * });
+ * ```
+ */
+function toMistralRequest(request) {
+    const adapter = new ai_matey_backend_5.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);
+ * ```
+ */
+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/cjs/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;;AAiCH,0CAGC;AAiBD,gDAGC;AAiBD,0CAGC;AAgBD,0CAGC;AAgBD,4CAGC;AA4BD,4DAiCC;AA5KD,uDAA4E;AAC5E,uDAAkF;AAClF,uDAA4E;AAC5E,uDAA4E;AAC5E,uDAA8E;AAE9E,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,eAAe,CAAC,OAAsB;IACpD,MAAM,OAAO,GAAG,IAAI,uCAAoB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,kBAAkB,CAAC,OAAsB;IACvD,MAAM,OAAO,GAAG,IAAI,0CAAuB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACjE,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,eAAe,CAAC,OAAsB;IACpD,MAAM,OAAO,GAAG,IAAI,uCAAoB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,eAAe,CAAC,OAAsB;IACpD,MAAM,OAAO,GAAG,IAAI,uCAAoB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,gBAAgB,CAAC,OAAsB;IACrD,MAAM,OAAO,GAAG,IAAI,wCAAqB,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,SAAgB,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/cjs/converters/response-converters.js

@@ -0,0 +1,203 @@
+"use strict";
+/**
+ * Response Converters
+ *
+ * Utility functions for converting Universal IR responses to various frontend formats.
+ * Useful for debugging, testing, and compatibility checking.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toOpenAI = toOpenAI;
+exports.toAnthropic = toAnthropic;
+exports.toGemini = toGemini;
+exports.toOllama = toOllama;
+exports.toMistral = toMistral;
+exports.toOpenAIStream = toOpenAIStream;
+exports.toAnthropicStream = toAnthropicStream;
+exports.toGeminiStream = toGeminiStream;
+exports.toMistralStream = toMistralStream;
+exports.toMultipleFormats = toMultipleFormats;
+const ai_matey_frontend_1 = require("ai.matey.frontend");
+const ai_matey_frontend_2 = require("ai.matey.frontend");
+const ai_matey_frontend_3 = require("ai.matey.frontend");
+const ai_matey_frontend_4 = require("ai.matey.frontend");
+const ai_matey_frontend_5 = require("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));
+ * ```
+ */
+async function toOpenAI(response) {
+    const adapter = new ai_matey_frontend_1.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);
+ * ```
+ */
+async function toAnthropic(response) {
+    const adapter = new ai_matey_frontend_2.AnthropicFrontendAdapter();
+    return adapter.fromIR(response);
+}
+/**
+ * Convert Universal IR response to Gemini format.
+ *
+ * @param response Universal IR response
+ * @returns Gemini-formatted response
+ */
+async function toGemini(response) {
+    const adapter = new ai_matey_frontend_3.GeminiFrontendAdapter();
+    return adapter.fromIR(response);
+}
+/**
+ * Convert Universal IR response to Ollama format.
+ *
+ * @param response Universal IR response
+ * @returns Ollama-formatted response
+ */
+async function toOllama(response) {
+    const adapter = new ai_matey_frontend_4.OllamaFrontendAdapter();
+    return adapter.fromIR(response);
+}
+/**
+ * Convert Universal IR response to Mistral format.
+ *
+ * @param response Universal IR response
+ * @returns Mistral-formatted response
+ */
+async function toMistral(response) {
+    const adapter = new ai_matey_frontend_5.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);
+ * }
+ * ```
+ */
+async function* toOpenAIStream(stream, options) {
+    const adapter = new ai_matey_frontend_1.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
+ */
+async function* toAnthropicStream(stream, options) {
+    const adapter = new ai_matey_frontend_2.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
+ */
+async function* toGeminiStream(stream, options) {
+    const adapter = new ai_matey_frontend_3.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
+ */
+async function* toMistralStream(stream, options) {
+    const adapter = new ai_matey_frontend_5.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));
+ * ```
+ */
+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/cjs/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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"}