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

package/dist/plugins/webhook/webhook-plugin.js

@@ -0,0 +1,328 @@
+/**
+ * Webhook Plugin - Facade Pattern Implementation
+ * Coordinates webhook functionality through clean, separated components
+ */
+import { AbstractPlugin, PluginCategory, PluginPriority } from '../../abstracts/abstract-plugin';
+import { EXECUTION_EVENTS, EXECUTION_EVENT_PREFIX } from '../../services/execution-service';
+import { createLogger } from '../../utils/logger';
+import { PluginError } from '../../utils/errors';
+import { WebhookTransformer } from './transformer';
+import { WebhookHttpClient } from './http-client';
+// Local event constants for webhook usage (kept internal to plugin)
+const EXEC_EVENTS = {
+    START: `${EXECUTION_EVENT_PREFIX}.${EXECUTION_EVENTS.START}`,
+    COMPLETE: `${EXECUTION_EVENT_PREFIX}.${EXECUTION_EVENTS.COMPLETE}`,
+    ERROR: `${EXECUTION_EVENT_PREFIX}.${EXECUTION_EVENTS.ERROR}`
+};
+const CONV_EVENTS = {
+    COMPLETE: 'conversation.complete'
+};
+const TOOL_EVENTS_LOCAL = {
+    EXECUTED: 'tool.executed'
+};
+const ERROR_EVENTS = {
+    OCCURRED: 'error.occurred'
+};
+/**
+ * Webhook Plugin using Facade Pattern
+ * Provides a clean interface for webhook functionality
+ */
+export class WebhookPlugin extends AbstractPlugin {
+    name = 'WebhookPlugin';
+    version = '1.0.0';
+    pluginOptions;
+    logger;
+    httpClient;
+    requestQueue = [];
+    batchQueue = [];
+    activeConcurrency = 0;
+    batchTimer;
+    constructor(options) {
+        super();
+        // Set plugin classification
+        this.category = PluginCategory.NOTIFICATION;
+        this.priority = PluginPriority.LOW;
+        // Validate required options
+        if (!options.endpoints || options.endpoints.length === 0) {
+            throw new PluginError('At least one webhook endpoint is required', this.name);
+        }
+        // Set default options
+        this.pluginOptions = {
+            enabled: options.enabled ?? true,
+            events: [EXEC_EVENTS.COMPLETE, CONV_EVENTS.COMPLETE, TOOL_EVENTS_LOCAL.EXECUTED, ERROR_EVENTS.OCCURRED],
+            defaultTimeout: 5000,
+            defaultRetries: 3,
+            async: true,
+            maxConcurrency: 3,
+            batching: {
+                enabled: false,
+                maxSize: 10,
+                flushInterval: 5000
+            },
+            payloadTransformer: WebhookTransformer.defaultPayloadTransformer,
+            // Add plugin options defaults
+            category: options.category ?? PluginCategory.NOTIFICATION,
+            priority: options.priority ?? PluginPriority.LOW,
+            moduleEvents: options.moduleEvents ?? [],
+            subscribeToAllModuleEvents: options.subscribeToAllModuleEvents ?? false,
+            ...options
+        };
+        this.logger = createLogger(`${this.name}`);
+        this.httpClient = new WebhookHttpClient(this.logger);
+        this.validateEndpoints();
+        if (this.pluginOptions.batching.enabled) {
+            this.setupBatching();
+        }
+        this.logger.info('WebhookPlugin initialized', {
+            endpointCount: this.pluginOptions.endpoints.length,
+            events: this.pluginOptions.events,
+            batching: this.pluginOptions.batching.enabled
+        });
+    }
+    /**
+     * After execution completes
+     */
+    async afterExecution(context, result) {
+        const webhookContext = WebhookTransformer.contextToWebhook(context);
+        const webhookResult = WebhookTransformer.resultToWebhook(result);
+        const eventData = WebhookTransformer.createExecutionData(webhookContext, webhookResult);
+        await this.sendWebhook(EXEC_EVENTS.COMPLETE, eventData);
+    }
+    /**
+     * After conversation completes
+     */
+    async afterConversation(context, result) {
+        const webhookContext = WebhookTransformer.contextToWebhook(context);
+        const webhookResult = WebhookTransformer.resultToWebhook(result);
+        const eventData = WebhookTransformer.createConversationData(webhookContext, webhookResult);
+        await this.sendWebhook(CONV_EVENTS.COMPLETE, eventData);
+    }
+    /**
+     * After tool execution
+     *
+     * REASON: Tool results structure varies by tool type and provider, needs flexible handling for webhook processing
+     * ALTERNATIVES_CONSIDERED:
+     * 1. Strict tool result interfaces (breaks tool compatibility)
+     * 2. Union types (insufficient for dynamic tool results)
+     * 3. Generic constraints (too complex for webhook processing)
+     * 4. Interface definitions (too rigid for varied tool results)
+     * 5. Type assertions (decreases type safety)
+     * TODO: Consider standardized tool result interface across tools
+     */
+    async afterToolExecution(context, toolResults) {
+        const webhookContext = WebhookTransformer.contextToWebhook(context);
+        // Handle tool results from IPluginExecutionResult
+        if (toolResults.toolCalls && toolResults.toolCalls.length > 0) {
+            for (const toolCall of toolResults.toolCalls) {
+                const toolData = {
+                    toolName: toolCall.name || '',
+                    toolId: toolCall.id || '',
+                    result: toolCall.result,
+                    success: toolCall.result !== null,
+                    duration: toolResults.duration
+                };
+                const eventData = WebhookTransformer.createToolData(webhookContext, toolData);
+                await this.sendWebhook(TOOL_EVENTS_LOCAL.EXECUTED, eventData);
+            }
+        }
+    }
+    /**
+     * On error
+     */
+    async onError(error, context) {
+        const webhookContext = context ? {
+            executionId: context.executionId,
+            sessionId: context.sessionId,
+            userId: context.userId
+        } : {
+            executionId: undefined,
+            sessionId: undefined,
+            userId: undefined
+        };
+        const errorEventData = WebhookTransformer.createErrorData(webhookContext, error);
+        await this.sendWebhook(ERROR_EVENTS.OCCURRED, errorEventData);
+        await this.sendWebhook(EXEC_EVENTS.ERROR, errorEventData);
+    }
+    /**
+     * Send webhook notification
+     */
+    async sendWebhook(event, data, metadata) {
+        if (!this.pluginOptions.events.includes(event)) {
+            return;
+        }
+        const payload = {
+            event,
+            timestamp: new Date().toISOString(),
+            data: this.pluginOptions.payloadTransformer(event, data),
+            ...(metadata && { metadata })
+        };
+        // Add context data if available
+        if (data.executionId)
+            payload.executionId = data.executionId;
+        if (data.sessionId)
+            payload.sessionId = data.sessionId;
+        if (data.userId)
+            payload.userId = data.userId;
+        this.logger.debug('Sending webhook', {
+            event,
+            endpointCount: this.getEndpointsForEvent(event).length
+        });
+        // Batch or send immediately
+        if (this.pluginOptions.batching.enabled) {
+            this.batchQueue.push(payload);
+            if (this.batchQueue.length >= this.pluginOptions.batching.maxSize) {
+                await this.flushBatch();
+            }
+        }
+        else {
+            await this.sendToEndpoints(payload);
+        }
+    }
+    /**
+     * Send custom webhook
+     */
+    async sendCustomWebhook(data, metadata) {
+        await this.sendWebhook('custom', data, metadata);
+    }
+    /**
+     * Send payload to all applicable endpoints
+     */
+    async sendToEndpoints(payload) {
+        const endpoints = this.getEndpointsForEvent(payload.event);
+        if (endpoints.length === 0) {
+            return;
+        }
+        const requests = endpoints.map(endpoint => ({
+            endpoint,
+            payload,
+            attempt: 1,
+            timestamp: new Date()
+        }));
+        if (this.pluginOptions.async) {
+            // Add to queue for async processing
+            this.requestQueue.push(...requests);
+            this.processQueue();
+        }
+        else {
+            // Send synchronously
+            await Promise.allSettled(requests.map(req => this.httpClient.sendRequest(req)));
+        }
+    }
+    /**
+     * Process webhook request queue
+     */
+    async processQueue() {
+        while (this.requestQueue.length > 0 && this.activeConcurrency < this.pluginOptions.maxConcurrency) {
+            const request = this.requestQueue.shift();
+            if (!request)
+                break;
+            this.activeConcurrency++;
+            // Process request asynchronously
+            this.httpClient.sendRequest(request).finally(() => {
+                this.activeConcurrency--;
+                // Continue processing queue
+                if (this.requestQueue.length > 0) {
+                    this.processQueue();
+                }
+            });
+        }
+    }
+    /**
+     * Get endpoints that should receive the event
+     */
+    getEndpointsForEvent(event) {
+        return this.pluginOptions.endpoints.filter(endpoint => {
+            if (!endpoint.events || endpoint.events.length === 0) {
+                return true; // No event filter means all events
+            }
+            return endpoint.events.includes(event);
+        });
+    }
+    /**
+     * Setup event batching
+     */
+    setupBatching() {
+        this.batchTimer = setInterval(() => {
+            this.flushBatch();
+        }, this.pluginOptions.batching.flushInterval);
+    }
+    /**
+     * Flush batched webhooks
+     */
+    async flushBatch() {
+        if (this.batchQueue.length === 0) {
+            return;
+        }
+        const payloads = [...this.batchQueue];
+        this.batchQueue = [];
+        this.logger.debug('Flushing webhook batch', { payloadCount: payloads.length });
+        // Send all batched payloads
+        for (const payload of payloads) {
+            await this.sendToEndpoints(payload);
+        }
+    }
+    /**
+     * Validate webhook endpoints
+     */
+    validateEndpoints() {
+        for (const endpoint of this.pluginOptions.endpoints) {
+            if (!endpoint.url) {
+                throw new PluginError(`Webhook endpoint URL is required`, this.name);
+            }
+            try {
+                new URL(endpoint.url);
+            }
+            catch {
+                throw new PluginError(`Invalid webhook URL: ${endpoint.url}`, this.name);
+            }
+            if (endpoint.events) {
+                const validEvents = [
+                    EXEC_EVENTS.START, EXEC_EVENTS.COMPLETE, EXEC_EVENTS.ERROR,
+                    CONV_EVENTS.COMPLETE, TOOL_EVENTS_LOCAL.EXECUTED, ERROR_EVENTS.OCCURRED, 'custom'
+                ];
+                for (const event of endpoint.events) {
+                    if (!validEvents.includes(event)) {
+                        throw new PluginError(`Invalid webhook event: ${event}`, this.name);
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Get webhook plugin statistics
+     */
+    getStats() {
+        const base = super.getStats();
+        return {
+            ...base,
+            endpointCount: this.pluginOptions.endpoints.length,
+            queueLength: this.requestQueue.length,
+            batchQueueLength: this.batchQueue.length,
+            activeConcurrency: this.activeConcurrency,
+            supportedEvents: this.pluginOptions.events,
+            totalSent: 0, // TODO: Track total sent webhooks
+            totalErrors: 0, // TODO: Track total webhook errors
+            averageResponseTime: 0 // TODO: Track average response time
+        };
+    }
+    /**
+     * Clear webhook queue
+     */
+    clearQueue() {
+        this.requestQueue = [];
+        this.batchQueue = [];
+        this.logger.info('Webhook queues cleared');
+    }
+    /**
+     * Cleanup on plugin destruction
+     */
+    async destroy() {
+        if (this.batchTimer) {
+            clearInterval(this.batchTimer);
+        }
+        await this.flushBatch();
+        this.clearQueue();
+        this.logger.info('WebhookPlugin destroyed');
+    }
+}
+//# sourceMappingURL=webhook-plugin.js.map

package/dist/plugins/webhook/webhook-plugin.js.map

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

package/dist/schemas/agent-template-schema.d.ts

@@ -0,0 +1,137 @@
+import { z } from 'zod';
+/**
+ * Reusable type definitions for schema validation
+ */
+/**
+ * Schema validation input type
+ * Used for validating external data inputs before parsing
+ */
+export type TSchemaValidationInput = Record<string, string | number | boolean | Date | string[] | number[] | boolean[] | null | undefined> | string | number | boolean | null | undefined;
+/**
+ * Zod schema for validating agent template metadata
+ */
+export declare const AgentTemplateMetadataSchema: z.ZodObject<{
+    type: z.ZodEnum<["builtin", "custom"]>;
+    author: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodEffects<z.ZodString, Date, string>]>>;
+    updatedAt: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodEffects<z.ZodString, Date, string>]>>;
+    description: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "custom" | "builtin";
+    description?: string | undefined;
+    category?: string | undefined;
+    updatedAt?: Date | undefined;
+    author?: string | undefined;
+    createdAt?: Date | undefined;
+}, {
+    type: "custom" | "builtin";
+    description?: string | undefined;
+    category?: string | undefined;
+    updatedAt?: string | Date | undefined;
+    author?: string | undefined;
+    createdAt?: string | Date | undefined;
+}>;
+/**
+ * Zod schema for validating agent templates
+ */
+export declare const AgentTemplateSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    llm_provider: z.ZodString;
+    model: z.ZodString;
+    temperature: z.ZodNumber;
+    system_prompt: z.ZodString;
+    tags: z.ZodArray<z.ZodString, "many">;
+    version: z.ZodOptional<z.ZodString>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["builtin", "custom"]>;
+        author: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodEffects<z.ZodString, Date, string>]>>;
+        updatedAt: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodEffects<z.ZodString, Date, string>]>>;
+        description: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        type: "custom" | "builtin";
+        description?: string | undefined;
+        category?: string | undefined;
+        updatedAt?: Date | undefined;
+        author?: string | undefined;
+        createdAt?: Date | undefined;
+    }, {
+        type: "custom" | "builtin";
+        description?: string | undefined;
+        category?: string | undefined;
+        updatedAt?: string | Date | undefined;
+        author?: string | undefined;
+        createdAt?: string | Date | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    temperature: number;
+    model: string;
+    name: string;
+    description: string;
+    tags: string[];
+    llm_provider: string;
+    system_prompt: string;
+    maxTokens?: number | undefined;
+    metadata?: {
+        type: "custom" | "builtin";
+        description?: string | undefined;
+        category?: string | undefined;
+        updatedAt?: Date | undefined;
+        author?: string | undefined;
+        createdAt?: Date | undefined;
+    } | undefined;
+    version?: string | undefined;
+}, {
+    temperature: number;
+    model: string;
+    name: string;
+    description: string;
+    tags: string[];
+    llm_provider: string;
+    system_prompt: string;
+    maxTokens?: number | undefined;
+    metadata?: {
+        type: "custom" | "builtin";
+        description?: string | undefined;
+        category?: string | undefined;
+        updatedAt?: string | Date | undefined;
+        author?: string | undefined;
+        createdAt?: string | Date | undefined;
+    } | undefined;
+    version?: string | undefined;
+}>;
+/**
+ * Type for validated agent template
+ */
+export type TValidatedAgentTemplate = z.infer<typeof AgentTemplateSchema>;
+/**
+ * Validate an agent template
+ *
+ * @param template - Template to validate
+ * @returns Validated template
+ * @throws {z.ZodError} When validation fails
+ */
+export declare function validateAgentTemplate(template: TSchemaValidationInput): TValidatedAgentTemplate;
+/**
+ * Safely validate an agent template with error handling
+ *
+ * @param template - Template to validate
+ * @returns Validation result with success flag and data or error
+ */
+export declare function safeValidateAgentTemplate(template: TSchemaValidationInput): {
+    success: boolean;
+    data?: TValidatedAgentTemplate;
+    error?: z.ZodError;
+};
+/**
+ * Get formatted validation errors
+ *
+ * @param error - Zod validation error
+ * @returns Formatted error messages
+ */
+export declare function getValidationErrors(error: z.ZodError): string[];
+//# sourceMappingURL=agent-template-schema.d.ts.map

package/dist/schemas/agent-template-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-template-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/agent-template-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AAEH;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAE1L;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;EAa7B,CAAC;AAEZ;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCrB,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE1E;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,uBAAuB,CAE/F;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,sBAAsB,GAAG;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,uBAAuB,CAAC;IAC/B,KAAK,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC;CACtB,CAQA;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,EAAE,CAK/D"}

package/dist/schemas/agent-template-schema.js

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+/**
+ * Zod schema for validating agent template metadata
+ */
+export const AgentTemplateMetadataSchema = z.object({
+    type: z.enum(['builtin', 'custom']),
+    author: z.string().optional(),
+    createdAt: z.union([
+        z.date(),
+        z.string().transform((str) => new Date(str))
+    ]).optional(),
+    updatedAt: z.union([
+        z.date(),
+        z.string().transform((str) => new Date(str))
+    ]).optional(),
+    description: z.string().optional(),
+    category: z.string().optional()
+}).strict();
+/**
+ * Zod schema for validating agent templates
+ */
+export const AgentTemplateSchema = z.object({
+    name: z.string()
+        .min(1, 'Template name cannot be empty')
+        .regex(/^[a-z0-9_-]+$/, 'Template name must contain only lowercase letters, numbers, underscores, and hyphens'),
+    description: z.string()
+        .min(10, 'Description must be at least 10 characters long'),
+    llm_provider: z.string()
+        .min(1, 'LLM provider is required')
+        .regex(/^[a-z0-9_-]+$/, 'Provider name must contain only lowercase letters, numbers, underscores, and hyphens'),
+    model: z.string()
+        .min(1, 'Model name is required'),
+    temperature: z.number()
+        .min(0, 'Temperature must be >= 0')
+        .max(1, 'Temperature must be <= 1'),
+    system_prompt: z.string()
+        .min(50, 'System prompt must be at least 50 characters long'),
+    tags: z.array(z.string())
+        .min(1, 'At least one tag is required')
+        .max(10, 'Maximum 10 tags allowed'),
+    version: z.string()
+        .regex(/^\d+\.\d+\.\d+$/, 'Version must follow semantic versioning (x.y.z)')
+        .optional(),
+    maxTokens: z.number()
+        .min(1)
+        .max(100000)
+        .optional(),
+    metadata: AgentTemplateMetadataSchema.optional()
+}).strict();
+/**
+ * Validate an agent template
+ *
+ * @param template - Template to validate
+ * @returns Validated template
+ * @throws {z.ZodError} When validation fails
+ */
+export function validateAgentTemplate(template) {
+    return AgentTemplateSchema.parse(template);
+}
+/**
+ * Safely validate an agent template with error handling
+ *
+ * @param template - Template to validate
+ * @returns Validation result with success flag and data or error
+ */
+export function safeValidateAgentTemplate(template) {
+    const result = AgentTemplateSchema.safeParse(template);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    else {
+        return { success: false, error: result.error };
+    }
+}
+/**
+ * Get formatted validation errors
+ *
+ * @param error - Zod validation error
+ * @returns Formatted error messages
+ */
+export function getValidationErrors(error) {
+    return error.errors.map(err => {
+        const path = err.path.length > 0 ? err.path.join('.') : 'root';
+        return `${path}: ${err.message}`;
+    });
+}
+//# sourceMappingURL=agent-template-schema.js.map

package/dist/schemas/agent-template-schema.js.map

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

package/dist/services/conversation-service/index.d.ts

@@ -0,0 +1,88 @@
+import type { IAssistantMessage, ISystemMessage, IToolMessage, IUserMessage, TUniversalMessage } from '../../interfaces/messages';
+import type { IAIProvider } from '../../interfaces/provider';
+import type { TUniversalValue } from '../../interfaces/types';
+import { IConversationContext, IConversationResponse, IStreamingChunk, IConversationServiceOptions, IContextOptions, IConversationService } from '../../interfaces/service';
+/**
+ * Conversation Service - handles AI provider interactions and response processing
+ * Stateless service that manages conversation context, AI provider calls, and response processing
+ * All methods are pure functions without instance state
+ * @internal
+ */
+export declare class ConversationService implements IConversationService {
+    /**
+     * Prepare conversation context from messages and configuration
+     * Pure function that transforms inputs to context object
+     */
+    prepareContext(messages: TUniversalMessage[], model: string, provider: string, contextOptions?: IContextOptions, serviceOptions?: IConversationServiceOptions): IConversationContext;
+    /**
+     * Generate a response using the AI provider
+     * Stateless operation that handles the full request-response cycle
+     */
+    generateResponse(provider: IAIProvider, context: IConversationContext, serviceOptions?: IConversationServiceOptions): Promise<IConversationResponse>;
+    /**
+     * Generate streaming response using the AI provider
+     * Stateless streaming operation
+     */
+    generateStreamingResponse(provider: IAIProvider, context: IConversationContext, serviceOptions?: IConversationServiceOptions): AsyncGenerator<IStreamingChunk, void, undefined>;
+    /**
+     * Validate conversation context
+     * Pure validation function
+     */
+    validateContext(context: IConversationContext): {
+        isValid: boolean;
+        errors: string[];
+    };
+    /**
+     * Static helper method for context creation
+     */
+    private static createContext;
+    /**
+     * Static method for response generation
+     */
+    private static performResponseGeneration;
+    /**
+     * Static method for streaming response generation
+     */
+    private static performStreamingResponse;
+    /**
+     * Static method for context validation
+     */
+    private static performContextValidation;
+    /**
+     * Create a user message
+     */
+    createUserMessage(content: string, metadata?: Record<string, string | number | boolean>): IUserMessage;
+    /**
+     * Create an assistant message from response
+     */
+    createAssistantMessage(response: IConversationResponse, metadata?: Record<string, string | number | boolean>): IAssistantMessage;
+    /**
+     * Create a system message
+     */
+    createSystemMessage(content: string, metadata?: Record<string, string | number | boolean>): ISystemMessage;
+    /**
+     * Create a tool message
+     */
+    createToolMessage(toolCallId: string, result: TUniversalValue, metadata?: Record<string, string | number | boolean>): IToolMessage;
+    private static createUserMessageStatic;
+    private static createAssistantMessageStatic;
+    private static createSystemMessageStatic;
+    private static createToolMessageStatic;
+    /**
+     * Convert complex metadata to simple provider request format
+     */
+    private static convertToProviderMetadata;
+    /**
+     * Convert optional usage to required format
+     */
+    private static convertUsage;
+    private static createProviderRequest;
+    private static processProviderResponse;
+    private static processStreamingChunk;
+    private static executeWithRetry;
+    private static shouldRetryError;
+    private static withTimeout;
+    private static createTimeoutPromise;
+    private static delay;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/services/conversation-service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/conversation-service/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,iBAAiB,EACjB,cAAc,EAEd,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAA0C,MAAM,2BAA2B,CAAC;AACrG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EACH,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,2BAA2B,EAC3B,eAAe,EACf,oBAAoB,EAEvB,MAAM,0BAA0B,CAAC;AAoClC;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAE5D;;;OAGG;IACH,cAAc,CACV,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,eAAoB,EACpC,cAAc,GAAE,2BAAgC,GACjD,oBAAoB;IAYvB;;;OAGG;IACG,gBAAgB,CAClB,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,oBAAoB,EAC7B,cAAc,GAAE,2BAAgC,GACjD,OAAO,CAAC,qBAAqB,CAAC;IAKjC;;;OAGG;IACI,yBAAyB,CAC5B,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,oBAAoB,EAC7B,cAAc,GAAE,2BAAgC,GACjD,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;IAKnD;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAQtF;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAiD5B;;OAEG;mBACkB,yBAAyB;IA6D9C;;OAEG;mBACmB,wBAAwB;IA0E9C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAmCvC;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,YAAY;IAItG;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,iBAAiB;IAIhI;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,cAAc;IAI1G;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,YAAY;IAKlI,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAYtC,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAoB3C,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAYxC,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAiBtC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAkBxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAe3B,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAiBpC,OAAO,CAAC,MAAM,CAAC,uBAAuB;IActC,OAAO,CAAC,MAAM,CAAC,qBAAqB;mBAaf,gBAAgB;IA+CrC,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAoB/B,OAAO,CAAC,MAAM,CAAC,WAAW;IAO1B,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAQnC,OAAO,CAAC,MAAM,CAAC,KAAK;CAGvB"}