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

package/dist/plugins/webhook/transformer.js

@@ -0,0 +1,157 @@
+/**
+ * Webhook data transformation utilities
+ * Converts base plugin types to webhook-specific types safely
+ */
+/**
+ * Webhook data transformer utility class
+ */
+export class WebhookTransformer {
+    /**
+     * Convert IPluginExecutionContext to WebhookExecutionContext
+     */
+    static contextToWebhook(context) {
+        return {
+            executionId: context.executionId,
+            sessionId: context.sessionId,
+            userId: context.userId
+        };
+    }
+    /**
+     * Convert IPluginExecutionResult to WebhookExecutionResult
+     */
+    static resultToWebhook(result) {
+        return {
+            response: result.response,
+            content: result.content,
+            duration: result.duration,
+            tokensUsed: result.tokensUsed,
+            toolsExecuted: result.toolsExecuted,
+            success: result.success,
+            usage: result.usage,
+            toolCalls: result.toolCalls,
+            error: result.error
+        };
+    }
+    /**
+     * Create execution event data
+     */
+    static createExecutionData(context, result) {
+        const executionData = {
+            response: result.response || undefined,
+            duration: result.duration || undefined,
+            tokensUsed: result.tokensUsed || undefined,
+            toolsExecuted: result.toolsExecuted || undefined,
+            success: result.success !== undefined ? result.success : undefined
+        };
+        return {
+            executionId: context.executionId,
+            sessionId: context.sessionId,
+            userId: context.userId,
+            result: executionData
+        };
+    }
+    /**
+     * Create conversation event data
+     */
+    static createConversationData(context, result) {
+        const toolCalls = result.toolCalls?.map(call => ({
+            id: call.id || '',
+            name: call.name || '',
+            arguments: JSON.stringify(call.arguments || {}),
+            result: String(call.result || '')
+        })) || [];
+        const conversationData = {
+            response: result.content || result.response || undefined,
+            tokensUsed: result.usage?.totalTokens || result.tokensUsed || undefined,
+            toolCalls: toolCalls.length > 0 ? toolCalls : undefined
+        };
+        return {
+            executionId: context.executionId,
+            sessionId: context.sessionId,
+            userId: context.userId,
+            conversation: conversationData
+        };
+    }
+    /**
+     * Create tool execution event data
+     *
+     * REASON: Tool result 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
+     */
+    static createToolData(context, toolResult) {
+        // Safely extract tool data from result
+        const toolName = this.safeGetProperty(toolResult, 'toolName') || 'unknown';
+        const toolId = this.safeGetProperty(toolResult, 'toolId') ||
+            this.safeGetProperty(toolResult, 'executionId') || 'unknown';
+        const hasError = this.safeGetProperty(toolResult, 'error');
+        const duration = this.safeGetProperty(toolResult, 'duration');
+        const result = this.safeGetProperty(toolResult, 'result');
+        const toolData = {
+            name: String(toolName),
+            id: String(toolId),
+            success: !hasError,
+            duration: typeof duration === 'number' ? duration : undefined,
+            result: hasError ? undefined : String(result || ''),
+            error: hasError ? (hasError instanceof Error ? hasError.message : String(hasError)) : undefined
+        };
+        return {
+            executionId: context.executionId,
+            sessionId: context.sessionId,
+            userId: context.userId,
+            tool: toolData
+        };
+    }
+    /**
+     * Create error event data
+     */
+    static createErrorData(context, error) {
+        const errorData = {
+            message: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error ? error.stack : undefined,
+            type: error instanceof Error ? error.constructor.name : 'Unknown',
+            context: context ? {
+                executionId: context.executionId || '',
+                sessionId: context.sessionId || '',
+                userId: context.userId || ''
+            } : undefined
+        };
+        return {
+            executionId: context.executionId,
+            sessionId: context.sessionId,
+            userId: context.userId,
+            error: errorData
+        };
+    }
+    /**
+     * Safely get property from object (handles index signature issues)
+     *
+     * REASON: Safe property access for webhook data transformation needs flexible input/output types
+     * ALTERNATIVES_CONSIDERED:
+     * 1. Strict object types (breaks dynamic property access)
+     * 2. Union types (insufficient for property extraction)
+     * 3. Generic constraints (too complex for simple property access)
+     * 4. Interface definitions (too rigid for dynamic objects)
+     * 5. Type assertions (decreases type safety)
+     * TODO: Consider typed property access if patterns emerge
+     */
+    static safeGetProperty(obj, key) {
+        if (!obj || typeof obj !== 'object' || obj === null || Array.isArray(obj)) {
+            return undefined;
+        }
+        return obj[key];
+    }
+    /**
+     * Default payload transformer for webhook events
+     */
+    static defaultPayloadTransformer(_event, data) {
+        // Simply return the data as-is for the default transformer
+        return data;
+    }
+}
+//# sourceMappingURL=transformer.js.map

package/dist/plugins/webhook/transformer.js.map

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

package/dist/plugins/webhook/types.d.ts

@@ -0,0 +1,183 @@
+import { EXECUTION_EVENTS, EXECUTION_EVENT_PREFIX } from '../../services/execution-service';
+/**
+ * Webhook plugin type definitions
+ * Clean separation of concerns with domain-specific types
+ */
+/**
+ * Webhook event types for different lifecycle events
+ */
+type TExecutionEventName = `${typeof EXECUTION_EVENT_PREFIX}.${typeof EXECUTION_EVENTS[keyof typeof EXECUTION_EVENTS]}`;
+export type TWebhookEventName = TExecutionEventName | 'conversation.complete' | 'tool.executed' | 'error.occurred' | 'custom';
+/**
+ * Base webhook context data
+ */
+export interface IWebhookContextData {
+    executionId?: string | undefined;
+    sessionId?: string | undefined;
+    userId?: string | undefined;
+}
+/**
+ * Execution result data for webhooks
+ */
+export interface IWebhookExecutionData {
+    response?: string | undefined;
+    duration?: number | undefined;
+    tokensUsed?: number | undefined;
+    toolsExecuted?: number | undefined;
+    success?: boolean | undefined;
+}
+/**
+ * Conversation result data for webhooks
+ */
+export interface IWebhookConversationData {
+    response?: string | undefined;
+    tokensUsed?: number | undefined;
+    toolCalls?: IWebhookToolCallData[] | undefined;
+}
+/**
+ * Tool call data for webhooks
+ */
+export interface IWebhookToolCallData {
+    id: string;
+    name: string;
+    arguments: string;
+    result: string;
+}
+/**
+ * Tool execution data for webhooks
+ */
+export interface IWebhookToolData {
+    name: string;
+    id: string;
+    success: boolean;
+    duration?: number | undefined;
+    result?: string | undefined;
+    error?: string | undefined;
+}
+/**
+ * Error data for webhooks
+ */
+export interface IWebhookErrorData {
+    message: string;
+    stack?: string | undefined;
+    context?: Record<string, string | number | boolean> | undefined;
+    type?: string | undefined;
+}
+/**
+ * Complete webhook event data structure
+ */
+export interface IWebhookEventData extends IWebhookContextData {
+    result?: IWebhookExecutionData | undefined;
+    conversation?: IWebhookConversationData | undefined;
+    tool?: IWebhookToolData | undefined;
+    error?: IWebhookErrorData | undefined;
+}
+/**
+ * Webhook metadata for additional context
+ */
+export type TWebhookMetadata = Record<string, string | number | boolean | Date | string[]>;
+/**
+ * Webhook execution context (simplified from base types)
+ */
+export interface IWebhookExecutionContext {
+    executionId?: string | undefined;
+    sessionId?: string | undefined;
+    userId?: string | undefined;
+}
+/**
+ * Webhook execution result (simplified from base types)
+ */
+export interface IWebhookExecutionResult {
+    response?: string | undefined;
+    content?: string | undefined;
+    duration?: number | undefined;
+    tokensUsed?: number | undefined;
+    toolsExecuted?: number | undefined;
+    success?: boolean | undefined;
+    usage?: {
+        totalTokens?: number | undefined;
+    } | undefined;
+    toolCalls?: import('../../abstracts/abstract-plugin').IPluginExecutionResult['toolCalls'];
+    results?: Array<{
+        toolName?: string | undefined;
+        toolId?: string | undefined;
+        executionId?: string | undefined;
+        error?: Error | undefined;
+        duration?: number | undefined;
+        result?: string | number | boolean | undefined;
+    }> | undefined;
+    error?: Error | undefined;
+}
+/**
+ * Webhook payload structure
+ */
+export interface IWebhookPayload {
+    event: TWebhookEventName;
+    timestamp: string;
+    executionId?: string;
+    sessionId?: string;
+    userId?: string;
+    data: IWebhookEventData;
+    metadata?: TWebhookMetadata;
+}
+/**
+ * Webhook endpoint configuration
+ */
+export interface IWebhookEndpoint {
+    url: string;
+    headers?: Record<string, string>;
+    events?: TWebhookEventName[];
+    retries?: number;
+    timeout?: number;
+    secret?: string;
+}
+import type { IPluginOptions, IPluginStats } from '../../abstracts/abstract-plugin';
+/**
+ * Webhook plugin configuration options
+ */
+export interface IWebhookPluginOptions extends IPluginOptions {
+    /** Webhook endpoints */
+    endpoints: IWebhookEndpoint[];
+    /** Events to send webhooks for */
+    events?: TWebhookEventName[];
+    /** Default timeout for webhook requests */
+    defaultTimeout?: number;
+    /** Default retry attempts */
+    defaultRetries?: number;
+    /** Whether to use async sending */
+    async?: boolean;
+    /** Maximum concurrent webhook requests */
+    maxConcurrency?: number;
+    /** Whether to batch webhook requests */
+    batching?: {
+        enabled: boolean;
+        maxSize: number;
+        flushInterval: number;
+    };
+    /** Custom payload transformer */
+    payloadTransformer?: (event: TWebhookEventName, data: IWebhookEventData) => IWebhookEventData;
+}
+/**
+ * Webhook plugin statistics
+ */
+export interface IWebhookPluginStats extends IPluginStats {
+    endpointCount: number;
+    queueLength: number;
+    batchQueueLength: number;
+    activeConcurrency: number;
+    supportedEvents: TWebhookEventName[];
+    totalSent: number;
+    totalErrors: number;
+    averageResponseTime: number;
+}
+/**
+ * Internal webhook request structure
+ */
+export interface IWebhookRequest {
+    endpoint: IWebhookEndpoint;
+    payload: IWebhookPayload;
+    attempt: number;
+    timestamp: Date;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/webhook/types.d.ts.map

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

package/dist/plugins/webhook/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/webhook/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/webhook/types.ts"],"names":[],"mappings":""}

package/dist/plugins/webhook/webhook-plugin.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Webhook Plugin - Facade Pattern Implementation
+ * Coordinates webhook functionality through clean, separated components
+ */
+import { AbstractPlugin, type IPluginExecutionContext, type IPluginExecutionResult, type IPluginErrorContext } from '../../abstracts/abstract-plugin';
+import type { TWebhookEventName, IWebhookEventData, TWebhookMetadata, IWebhookPluginOptions, IWebhookPluginStats } from './types';
+/**
+ * Webhook Plugin using Facade Pattern
+ * Provides a clean interface for webhook functionality
+ */
+export declare class WebhookPlugin extends AbstractPlugin<IWebhookPluginOptions, IWebhookPluginStats> {
+    name: string;
+    version: string;
+    private pluginOptions;
+    private logger;
+    private httpClient;
+    private requestQueue;
+    private batchQueue;
+    private activeConcurrency;
+    private batchTimer?;
+    constructor(options: IWebhookPluginOptions);
+    /**
+     * After execution completes
+     */
+    afterExecution(context: IPluginExecutionContext, result: IPluginExecutionResult): Promise<void>;
+    /**
+     * After conversation completes
+     */
+    afterConversation(context: IPluginExecutionContext, result: IPluginExecutionResult): Promise<void>;
+    /**
+     * 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
+     */
+    afterToolExecution(context: IPluginExecutionContext, toolResults: IPluginExecutionResult): Promise<void>;
+    /**
+     * On error
+     */
+    onError(error: Error, context?: IPluginErrorContext): Promise<void>;
+    /**
+     * Send webhook notification
+     */
+    sendWebhook(event: TWebhookEventName, data: IWebhookEventData, metadata?: TWebhookMetadata): Promise<void>;
+    /**
+     * Send custom webhook
+     */
+    sendCustomWebhook(data: IWebhookEventData, metadata?: TWebhookMetadata): Promise<void>;
+    /**
+     * Send payload to all applicable endpoints
+     */
+    private sendToEndpoints;
+    /**
+     * Process webhook request queue
+     */
+    private processQueue;
+    /**
+     * Get endpoints that should receive the event
+     */
+    private getEndpointsForEvent;
+    /**
+     * Setup event batching
+     */
+    private setupBatching;
+    /**
+     * Flush batched webhooks
+     */
+    private flushBatch;
+    /**
+     * Validate webhook endpoints
+     */
+    private validateEndpoints;
+    /**
+     * Get webhook plugin statistics
+     */
+    getStats(): IWebhookPluginStats;
+    /**
+     * Clear webhook queue
+     */
+    clearQueue(): void;
+    /**
+     * Cleanup on plugin destruction
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=webhook-plugin.d.ts.map

package/dist/plugins/webhook/webhook-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/webhook/webhook-plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,cAAc,EAGd,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EAC3B,MAAM,iCAAiC,CAAC;AAQzC,OAAO,KAAK,EACR,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAGhB,qBAAqB,EACrB,mBAAmB,EAEtB,MAAM,SAAS,CAAC;AAqBjB;;;GAGG;AACH,qBAAa,aAAc,SAAQ,cAAc,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;IACzF,IAAI,SAAmB;IACvB,OAAO,SAAW;IAElB,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAW;gBAElB,OAAO,EAAE,qBAAqB;IAkD1C;;OAEG;IACY,cAAc,CAAC,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9G;;OAEG;IACY,iBAAiB,CAAC,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjH;;;;;;;;;;;OAWG;IACY,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvH;;OAEG;IACY,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlF;;OAEG;IACG,WAAW,CACb,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,iBAAiB,EACvB,QAAQ,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAkChB;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5F;;OAEG;YACW,eAAe;IAwB7B;;OAEG;YACW,YAAY;IAkB1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;YACW,UAAU;IAgBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACM,QAAQ,IAAI,mBAAmB;IAexC;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAUjC"}