@robota-sdk/agent-core 3.0.0-beta.1

package/dist/utils/execution-proxy.js

@@ -0,0 +1,230 @@
+import { EXECUTION_EVENTS } from '../services/execution-service';
+import { TOOL_EVENTS } from '../services/tool-execution-service';
+import { AGENT_EVENTS } from '../agents/constants';
+import { TASK_EVENTS } from '../services/task-events';
+/**
+ * ExecutionProxy - Automatic event emission using Proxy pattern
+ *
+ * This class wraps target objects and automatically emits events
+ * around method execution without modifying business logic.
+ *
+ * Benefits:
+ * - Zero business logic pollution
+ * - Automatic event emission
+ * - Configurable per method
+ * - AOP (Aspect-Oriented Programming) pattern
+ */
+export class ExecutionProxy {
+    config;
+    methodConfigs = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Configure specific methods for event emission
+     */
+    configureMethod(methodName, config) {
+        this.methodConfigs.set(methodName, config);
+        return this;
+    }
+    /**
+     * Configure multiple methods with standard patterns
+     */
+    configureStandardMethods() {
+        // Agent execution methods
+        if (this.config.sourceType === 'agent') {
+            this.configureMethod('run', {
+                startEvent: AGENT_EVENTS.EXECUTION_START,
+                completeEvent: AGENT_EVENTS.EXECUTION_COMPLETE,
+                errorEvent: AGENT_EVENTS.EXECUTION_ERROR,
+                extractMetadata: (target, methodName, args) => ({
+                    inputLength: args[0]?.length || 0,
+                    conversationId: target.conversationId,
+                    options: args[1] || {}
+                }),
+                extractResult: (result) => ({ response: result })
+            });
+            this.configureMethod('runStream', {
+                startEvent: AGENT_EVENTS.EXECUTION_START,
+                completeEvent: AGENT_EVENTS.EXECUTION_COMPLETE,
+                errorEvent: AGENT_EVENTS.EXECUTION_ERROR,
+                extractMetadata: (target, methodName, args) => ({
+                    inputLength: args[0]?.length || 0,
+                    conversationId: target.conversationId,
+                    streaming: true,
+                    options: args[1] || {}
+                })
+            });
+        }
+        // Team task assignment methods
+        if (this.config.sourceType === 'team') {
+            this.configureMethod('assignTask', {
+                startEvent: TASK_EVENTS.ASSIGNED,
+                completeEvent: TASK_EVENTS.COMPLETED,
+                errorEvent: EXECUTION_EVENTS.ERROR,
+                extractMetadata: (target, methodName, args) => {
+                    const params = args[0];
+                    return {
+                        taskDescription: params?.jobDescription,
+                        agentTemplate: params?.agentTemplate,
+                        priority: params?.priority,
+                        allowFurtherDelegation: params?.allowFurtherDelegation
+                    };
+                },
+                extractResult: (result) => ({
+                    result: result?.result,
+                    agentId: result?.agentId,
+                    metadata: result?.metadata
+                })
+            });
+            this.configureMethod('execute', {
+                startEvent: EXECUTION_EVENTS.START,
+                completeEvent: EXECUTION_EVENTS.COMPLETE,
+                errorEvent: EXECUTION_EVENTS.ERROR,
+                extractMetadata: (target, methodName, args) => ({
+                    taskDescription: args[0],
+                    teamMode: true
+                }),
+                extractResult: (result) => ({ response: result })
+            });
+        }
+        // Tool execution methods
+        if (this.config.sourceType === 'tool') {
+            this.configureMethod('execute', {
+                startEvent: TOOL_EVENTS.CALL_START,
+                completeEvent: TOOL_EVENTS.CALL_COMPLETE,
+                errorEvent: TOOL_EVENTS.CALL_ERROR,
+                extractMetadata: (target, methodName, args) => ({
+                    toolName: target.schema?.name || target.constructor.name,
+                    parameters: args[0],
+                    parametersCount: args[0] ? Object.keys(args[0]).length : 0,
+                    context: args[1]
+                }),
+                extractResult: (result) => ({
+                    result: typeof result?.data === 'string' ? result.data : JSON.stringify(result?.data),
+                    success: result?.success
+                })
+            });
+        }
+        return this;
+    }
+    /**
+     * Create a proxy wrapper around the target object
+     */
+    wrap(target) {
+        return new Proxy(target, {
+            get: (target, prop, receiver) => {
+                const originalMethod = Reflect.get(target, prop, receiver);
+                // Only wrap methods that are configured
+                if (typeof originalMethod === 'function' && this.methodConfigs.has(prop)) {
+                    const methodConfig = this.methodConfigs.get(prop);
+                    return async (...args) => {
+                        const startTime = Date.now();
+                        const executionId = this.generateExecutionId();
+                        try {
+                            // Emit start event
+                            if (methodConfig.startEvent) {
+                                const metadata = methodConfig.extractMetadata?.(target, prop, args) || {};
+                                this.emitEvent(methodConfig.startEvent, {
+                                    timestamp: new Date(),
+                                    metadata: {
+                                        ...metadata,
+                                        executionId,
+                                        methodName: prop,
+                                        phase: 'start'
+                                    }
+                                });
+                            }
+                            // Execute original method
+                            const result = await originalMethod.apply(target, args);
+                            const duration = Date.now() - startTime;
+                            // Emit complete event
+                            if (methodConfig.completeEvent) {
+                                const extractedResult = methodConfig.extractResult?.(result) || {};
+                                const metadata = methodConfig.extractMetadata?.(target, prop, args) || {};
+                                this.emitEvent(methodConfig.completeEvent, {
+                                    timestamp: new Date(),
+                                    ...extractedResult,
+                                    metadata: {
+                                        ...metadata,
+                                        executionId,
+                                        methodName: prop,
+                                        duration,
+                                        phase: 'complete',
+                                        success: true
+                                    }
+                                });
+                            }
+                            return result;
+                        }
+                        catch (error) {
+                            const duration = Date.now() - startTime;
+                            // Emit error event
+                            if (methodConfig.errorEvent) {
+                                const metadata = methodConfig.extractMetadata?.(target, prop, args) || {};
+                                this.emitEvent(methodConfig.errorEvent, {
+                                    timestamp: new Date(),
+                                    error: error instanceof Error ? error.message : String(error),
+                                    metadata: {
+                                        ...metadata,
+                                        executionId,
+                                        methodName: prop,
+                                        duration,
+                                        phase: 'error',
+                                        errorName: error instanceof Error ? error.name : 'UnknownError',
+                                        success: false
+                                    }
+                                });
+                            }
+                            throw error;
+                        }
+                    };
+                }
+                return originalMethod;
+            }
+        });
+    }
+    /**
+     * Emit event with standard ServiceEventData format
+     */
+    emitEvent(eventType, additionalData) {
+        const baseMetadata = {
+            emitterSourceType: this.config.sourceType,
+            emitterSourceId: this.config.sourceId
+        };
+        const eventData = {
+            timestamp: new Date(),
+            ...(additionalData.metadata ? { metadata: { ...baseMetadata, ...additionalData.metadata } } : { metadata: baseMetadata }),
+            ...additionalData
+        };
+        this.config.eventService.emit(eventType, eventData);
+    }
+    /**
+     * Generate unique execution ID
+     */
+    generateExecutionId() {
+        return `${this.config.sourceType}-${this.config.sourceId}-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+}
+/**
+ * Factory function to create execution proxy with standard configuration
+ */
+export function createExecutionProxy(target, config) {
+    const proxy = new ExecutionProxy(config);
+    proxy.configureStandardMethods();
+    return proxy.wrap(target);
+}
+/**
+ * Decorator function for automatic event emission
+ * Usage: @withEventEmission(eventService, 'agent', 'agent-id')
+ */
+export function withEventEmission(eventService, sourceType, sourceId) {
+    return function (target) {
+        return createExecutionProxy(target, {
+            eventService,
+            sourceType,
+            sourceId
+        });
+    };
+}
+//# sourceMappingURL=execution-proxy.js.map

package/dist/utils/execution-proxy.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,11 @@
+export * from './message-converter';
+export * from './logger';
+export * from './validation';
+export * from './errors';
+export * from './periodic-task';
+/**
+ * Cross-platform timer identifier type
+ * Works in both Node.js and browser environments
+ */
+export type TTimerId = ReturnType<typeof setTimeout>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAEhC;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,7 @@
+// Utility exports
+export * from './message-converter';
+export * from './logger';
+export * from './validation';
+export * from './errors';
+export * from './periodic-task';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,74 @@
+import type { TLoggerData, TUniversalValue } from '../interfaces/types';
+/**
+ * Reusable type definitions for logger utility
+ */
+/**
+ * Log levels for the logger
+ */
+export type TUtilLogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Log entry structure
+ */
+export interface IUtilLogEntry {
+    timestamp: string;
+    level: TUtilLogLevel;
+    message: string;
+    context?: TLoggerData;
+    packageName?: string;
+}
+/**
+ * Logger interface
+ */
+export interface ILogger {
+    debug(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+    info(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+    warn(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+    error(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+    log(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+    group?(label?: string): void;
+    groupEnd?(): void;
+}
+/**
+ * Silent logger that does nothing (Null Object Pattern)
+ *
+ * IMPORTANT:
+ * - This library must not write to stdio by default.
+ * - Inject a real logger explicitly if you want output.
+ */
+export declare const SilentLogger: ILogger;
+/**
+ * Console logger implementation
+ * @internal
+ */
+export declare class ConsoleLogger implements ILogger {
+    private level;
+    private packageName;
+    private sinkLogger;
+    constructor(packageName: string, logger?: ILogger);
+    debug(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+    info(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+    warn(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+    error(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+    log(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+    private getLevel;
+    private shouldLog;
+    private forward;
+}
+/**
+ * Create a logger instance for a package
+ * @internal
+ */
+export declare function createLogger(packageName: string, logger?: ILogger): ILogger;
+/**
+ * Set global log level for all loggers
+ */
+export declare function setGlobalLogLevel(level: TUtilLogLevel): void;
+/**
+ * Get global log level
+ */
+export declare function getGlobalLogLevel(): TUtilLogLevel;
+/**
+ * Default logger for the agents package
+ */
+export declare const logger: ILogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAExE;;GAEG;AAGH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,KAAK,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,eAAe,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;IACnE,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,eAAe,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;IAClE,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,eAAe,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;IAClE,KAAK,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,eAAe,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;IACnE,GAAG,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,eAAe,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,OAQ1B,CAAC;AA8BF;;;GAGG;AACH,qBAAa,aAAc,YAAW,OAAO;IACzC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAU;gBAEhB,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;IAKjD,KAAK,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,eAAe,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,IAAI;IAOlE,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,eAAe,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,IAAI;IAOjE,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,eAAe,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,IAAI;IAOjE,KAAK,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,eAAe,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,IAAI;IAOlE,GAAG,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,eAAe,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,IAAI;IAKhE,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,OAAO;CA2BlB;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAE3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAE5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAEjD;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,SAAyB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,143 @@
+/**
+ * Silent logger that does nothing (Null Object Pattern)
+ *
+ * IMPORTANT:
+ * - This library must not write to stdio by default.
+ * - Inject a real logger explicitly if you want output.
+ */
+export const SilentLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+    log: () => { },
+    group: () => { },
+    groupEnd: () => { },
+};
+/**
+ * Global logger configuration
+ */
+class LoggerConfig {
+    static instance;
+    globalLevel;
+    constructor() {
+        // Set default level (environment variables no longer used for browser compatibility)
+        this.globalLevel = 'warn';
+    }
+    static getInstance() {
+        if (!LoggerConfig.instance) {
+            LoggerConfig.instance = new LoggerConfig();
+        }
+        return LoggerConfig.instance;
+    }
+    getGlobalLevel() {
+        return this.globalLevel;
+    }
+    setGlobalLevel(level) {
+        this.globalLevel = level;
+    }
+}
+/**
+ * Console logger implementation
+ * @internal
+ */
+export class ConsoleLogger {
+    level = null; // null means use global level
+    packageName;
+    sinkLogger;
+    constructor(packageName, logger) {
+        this.packageName = packageName;
+        this.sinkLogger = logger || SilentLogger;
+    }
+    debug(...args) {
+        if (this.shouldLog('debug')) {
+            const [message, context] = args;
+            this.forward('debug', String(message ?? ''), isLoggerContext(context) ? context : undefined);
+        }
+    }
+    info(...args) {
+        if (this.shouldLog('info')) {
+            const [message, context] = args;
+            this.forward('info', String(message ?? ''), isLoggerContext(context) ? context : undefined);
+        }
+    }
+    warn(...args) {
+        if (this.shouldLog('warn')) {
+            const [message, context] = args;
+            this.forward('warn', String(message ?? ''), isLoggerContext(context) ? context : undefined);
+        }
+    }
+    error(...args) {
+        if (this.shouldLog('error')) {
+            const [message, context] = args;
+            this.forward('error', String(message ?? ''), isLoggerContext(context) ? context : undefined);
+        }
+    }
+    log(...args) {
+        // Alias for info-level output (when enabled).
+        this.info(...args);
+    }
+    getLevel() {
+        return this.level || LoggerConfig.getInstance().getGlobalLevel();
+    }
+    shouldLog(level) {
+        const currentLevel = this.getLevel();
+        if (currentLevel === 'silent')
+            return false;
+        const levels = ['debug', 'info', 'warn', 'error', 'silent'];
+        return levels.indexOf(level) >= levels.indexOf(currentLevel);
+    }
+    forward(level, message, context) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            ...(context && { context }),
+            packageName: this.packageName
+        };
+        const formattedMessage = `[${entry.timestamp}] [${entry.level.toUpperCase()}] [${entry.packageName}] ${entry.message}`;
+        switch (level) {
+            case 'debug':
+                this.sinkLogger.debug(formattedMessage, context ?? {});
+                return;
+            case 'info':
+                this.sinkLogger.info(formattedMessage, context ?? {});
+                return;
+            case 'warn':
+                this.sinkLogger.warn(formattedMessage, context ?? {});
+                return;
+            case 'error':
+                this.sinkLogger.error(formattedMessage, context ?? {});
+                return;
+            case 'silent':
+                return;
+        }
+    }
+}
+function isLoggerContext(value) {
+    return typeof value === 'object' && value !== null && !(value instanceof Error) && !(value instanceof Date) && !Array.isArray(value);
+}
+/**
+ * Create a logger instance for a package
+ * @internal
+ */
+export function createLogger(packageName, logger) {
+    return new ConsoleLogger(packageName, logger);
+}
+/**
+ * Set global log level for all loggers
+ */
+export function setGlobalLogLevel(level) {
+    LoggerConfig.getInstance().setGlobalLevel(level);
+}
+/**
+ * Get global log level
+ */
+export function getGlobalLogLevel() {
+    return LoggerConfig.getInstance().getGlobalLevel();
+}
+/**
+ * Default logger for the agents package
+ */
+export const logger = createLogger('agents');
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/message-converter.d.ts

@@ -0,0 +1,68 @@
+import type { TUniversalMessage } from '../interfaces/agent';
+/**
+ * Provider-specific message format types
+ */
+interface IOpenAIMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | null;
+    tool_calls?: {
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }[];
+    tool_call_id?: string;
+    name?: string;
+}
+interface IAnthropicProviderMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+interface IGoogleProviderMessage {
+    role: 'user' | 'model';
+    parts: {
+        text: string;
+    }[];
+}
+/**
+ * Provider message format union type
+ */
+type TProviderMessage = IOpenAIMessage | IAnthropicProviderMessage | IGoogleProviderMessage | TUniversalMessage;
+/**
+ * Universal message converter utility
+ * Handles message format conversion between different providers
+ */
+export declare class MessageConverter {
+    /**
+     * Convert messages to provider-specific format
+     */
+    static toProviderFormat(messages: TUniversalMessage[], providerName: string): TProviderMessage[];
+    /**
+     * Convert to OpenAI format
+     */
+    private static toOpenAIFormat;
+    /**
+     * Convert to Anthropic format
+     */
+    private static toAnthropicFormat;
+    /**
+     * Convert to Google format
+     */
+    private static toGoogleFormat;
+    /**
+     * Convert to universal format (no conversion)
+     */
+    private static toUniversalFormat;
+    /**
+     * Extract system message from messages
+     */
+    static extractSystemMessage(messages: TUniversalMessage[]): string | undefined;
+    /**
+     * Filter non-system messages
+     */
+    static filterNonSystemMessages(messages: TUniversalMessage[]): TUniversalMessage[];
+}
+export {};
+//# sourceMappingURL=message-converter.d.ts.map

package/dist/utils/message-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-converter.d.ts","sourceRoot":"","sources":["../../src/utils/message-converter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,UAAU,cAAc;IACpB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YACN,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;SACrB,CAAC;KACL,EAAE,CAAC;IACJ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,yBAAyB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC5B,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;CACP;AAED;;GAEG;AACH,KAAK,gBAAgB,GAAG,cAAc,GAAG,yBAAyB,GAAG,sBAAsB,GAAG,iBAAiB,CAAC;AAEhH;;;GAGG;AACH,qBAAa,gBAAgB;IACzB;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAahG;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IA0B7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAUhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAO7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAIhC;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,GAAG,SAAS;IAK9E;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE;CAGrF"}

package/dist/utils/message-converter.js

@@ -0,0 +1,87 @@
+/**
+ * Universal message converter utility
+ * Handles message format conversion between different providers
+ */
+export class MessageConverter {
+    /**
+     * Convert messages to provider-specific format
+     */
+    static toProviderFormat(messages, providerName) {
+        switch (providerName.toLowerCase()) {
+            case 'openai':
+                return this.toOpenAIFormat(messages);
+            case 'anthropic':
+                return this.toAnthropicFormat(messages);
+            case 'google':
+                return this.toGoogleFormat(messages);
+            default:
+                return this.toUniversalFormat(messages);
+        }
+    }
+    /**
+     * Convert to OpenAI format
+     */
+    static toOpenAIFormat(messages) {
+        return messages.map(msg => {
+            const baseMessage = {
+                role: msg.role,
+                content: msg.content
+            };
+            // Add tool calls for assistant messages
+            if (msg.role === 'assistant' && 'toolCalls' in msg && msg.toolCalls) {
+                baseMessage.tool_calls = msg.toolCalls.map(tc => ({
+                    id: tc.id,
+                    type: tc.type,
+                    function: tc.function
+                }));
+            }
+            // Add tool call ID and name for tool messages
+            if (msg.role === 'tool' && 'toolCallId' in msg) {
+                baseMessage.tool_call_id = msg.toolCallId;
+                baseMessage.name = msg.content; // Tool name from content for OpenAI
+            }
+            return baseMessage;
+        });
+    }
+    /**
+     * Convert to Anthropic format
+     */
+    static toAnthropicFormat(messages) {
+        // Anthropic has different message structure
+        return messages
+            .filter(msg => msg.role !== 'system') // System messages handled separately
+            .map(msg => ({
+            role: msg.role === 'assistant' ? 'assistant' : 'user',
+            content: msg.content || ''
+        }));
+    }
+    /**
+     * Convert to Google format
+     */
+    static toGoogleFormat(messages) {
+        return messages.map(msg => ({
+            role: msg.role === 'assistant' ? 'model' : 'user',
+            parts: [{ text: msg.content || '' }]
+        }));
+    }
+    /**
+     * Convert to universal format (no conversion)
+     */
+    static toUniversalFormat(messages) {
+        return messages;
+    }
+    /**
+     * Extract system message from messages
+     */
+    static extractSystemMessage(messages) {
+        const systemMsg = messages.find(msg => msg.role === 'system');
+        return systemMsg?.content;
+    }
+    /**
+     * Filter non-system messages
+     */
+    static filterNonSystemMessages(messages) {
+        return messages.filter(msg => msg.role !== 'system');
+    }
+}
+//# sourceMappingURL=message-converter.js.map

package/dist/utils/message-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-converter.js","sourceRoot":"","sources":["../../src/utils/message-converter.ts"],"names":[],"mappings":"AAqCA;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACzB;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAA6B,EAAE,YAAoB;QACvE,QAAQ,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC;YACjC,KAAK,QAAQ;gBACT,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YACzC,KAAK,WAAW;gBACZ,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAC5C,KAAK,QAAQ;gBACT,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YACzC;gBACI,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,cAAc,CAAC,QAA6B;QACvD,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YACtB,MAAM,WAAW,GAAmB;gBAChC,IAAI,EAAE,GAAG,CAAC,IAA8B;gBACxC,OAAO,EAAE,GAAG,CAAC,OAAO;aACvB,CAAC;YAEF,wCAAwC;YACxC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,WAAW,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;gBAClE,WAAW,CAAC,UAAU,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;oBAC9C,EAAE,EAAE,EAAE,CAAC,EAAE;oBACT,IAAI,EAAE,EAAE,CAAC,IAAkB;oBAC3B,QAAQ,EAAE,EAAE,CAAC,QAAQ;iBACxB,CAAC,CAAC,CAAC;YACR,CAAC;YAED,8CAA8C;YAC9C,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,YAAY,IAAI,GAAG,EAAE,CAAC;gBAC7C,WAAW,CAAC,YAAY,GAAG,GAAG,CAAC,UAAU,CAAC;gBAC1C,WAAW,CAAC,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,oCAAoC;YACxE,CAAC;YAED,OAAO,WAAW,CAAC;QACvB,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,iBAAiB,CAAC,QAA6B;QAC1D,4CAA4C;QAC5C,OAAO,QAAQ;aACV,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,qCAAqC;aAC1E,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACT,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;YACrD,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;SAC7B,CAAC,CAAC,CAAC;IACZ,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,cAAc,CAAC,QAA6B;QACvD,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACxB,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;YACjD,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;SACvC,CAAC,CAAC,CAAC;IACR,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,iBAAiB,CAAC,QAA6B;QAC1D,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,QAA6B;QACrD,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC9D,OAAO,SAAS,EAAE,OAAO,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,QAA6B;QACxD,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IACzD,CAAC;CACJ"}