@ai-setting/roy-agent-cli 1.3.18 → 1.3.22

package/dist/core/src/env/workflow/engine/event-bus.d.ts

@@ -1,55 +0,0 @@
-import type { WorkflowEvent } from '../types/event';
-export type EventHandler = (event: WorkflowEvent) => void | Promise<void>;
-/**
- * EventBus for workflow events.
- * Custom event bus implementation with support for wildcard subscriptions.
- */
-export declare class EventBus {
-    private handlers;
-    private wildcardHandlers;
-    constructor();
-    /**
-     * Subscribe to a specific event type.
-     * @returns Unsubscribe function
-     */
-    on(eventType: string, handler: EventHandler): () => void;
-    /**
-     * Subscribe to an event type only once (auto-unsubscribe after first call).
-     * @returns Unsubscribe function
-     */
-    once(eventType: string, handler: EventHandler): () => void;
-    /**
-     * Unsubscribe from an event type.
-     */
-    off(eventType: string, handler: EventHandler): void;
-    /**
-     * Subscribe to all events (wildcard subscription).
-     * @returns Unsubscribe function
-     */
-    onAny(handler: EventHandler): () => void;
-    /**
-     * Publish an event to all subscribers.
-     * Handler errors are caught and do not crash the bus.
-     *
-     * @param event - The event to publish
-     * @param waitForHandlers - If true, waits for all async handlers to complete (default: false)
-     */
-    publish(event: WorkflowEvent, waitForHandlers?: boolean): Promise<void>;
-    /**
-     * Execute a handler safely, catching any errors.
-     */
-    private executeHandler;
-    /**
-     * Clear all subscriptions.
-     */
-    clear(): void;
-    /**
-     * Get statistics about the event bus.
-     */
-    getStats(): {
-        eventTypes: number;
-        wildcardHandlers: number;
-        totalHandlers: number;
-    };
-}
-//# sourceMappingURL=event-bus.d.ts.map

package/dist/core/src/env/workflow/engine/event-bus.js

@@ -1,137 +0,0 @@
-/**
- * EventBus for workflow events.
- * Custom event bus implementation with support for wildcard subscriptions.
- */
-export class EventBus {
-    handlers = new Map();
-    wildcardHandlers = new Set();
-    constructor() {
-        // No-op - keep for potential future use
-    }
-    /**
-     * Subscribe to a specific event type.
-     * @returns Unsubscribe function
-     */
-    on(eventType, handler) {
-        let handlers = this.handlers.get(eventType);
-        if (!handlers) {
-            handlers = new Set();
-            this.handlers.set(eventType, handlers);
-        }
-        handlers.add(handler);
-        return () => this.off(eventType, handler);
-    }
-    /**
-     * Subscribe to an event type only once (auto-unsubscribe after first call).
-     * @returns Unsubscribe function
-     */
-    once(eventType, handler) {
-        // Use a flag to track if handler has been executed
-        let executed = false;
-        const wrappedHandler = async (event) => {
-            // Skip if already executed (prevent double execution)
-            if (executed) {
-                return;
-            }
-            executed = true;
-            // Execute the original handler
-            try {
-                await handler(event);
-            }
-            catch (error) {
-                // Silently catch handler errors
-                console.error('Event handler error:', error);
-            }
-            // Then unsubscribe
-            this.off(eventType, wrappedHandler);
-        };
-        // Subscribe the wrapped handler
-        return this.on(eventType, wrappedHandler);
-    }
-    /**
-     * Unsubscribe from an event type.
-     */
-    off(eventType, handler) {
-        const handlers = this.handlers.get(eventType);
-        if (handlers) {
-            handlers.delete(handler);
-            if (handlers.size === 0) {
-                this.handlers.delete(eventType);
-            }
-        }
-    }
-    /**
-     * Subscribe to all events (wildcard subscription).
-     * @returns Unsubscribe function
-     */
-    onAny(handler) {
-        this.wildcardHandlers.add(handler);
-        return () => {
-            this.wildcardHandlers.delete(handler);
-        };
-    }
-    /**
-     * Publish an event to all subscribers.
-     * Handler errors are caught and do not crash the bus.
-     *
-     * @param event - The event to publish
-     * @param waitForHandlers - If true, waits for all async handlers to complete (default: false)
-     */
-    async publish(event, waitForHandlers = false) {
-        // Get specific handlers for this event type
-        const handlers = this.handlers.get(event.type);
-        // Collect all handler promises
-        const handlerPromises = [];
-        // Execute specific handlers
-        if (handlers) {
-            for (const handler of handlers) {
-                const promise = this.executeHandler(handler, event);
-                handlerPromises.push(promise);
-            }
-        }
-        // Execute wildcard handlers
-        for (const handler of this.wildcardHandlers) {
-            const promise = this.executeHandler(handler, event);
-            handlerPromises.push(promise);
-        }
-        // Optionally wait for all handlers to complete
-        if (waitForHandlers && handlerPromises.length > 0) {
-            await Promise.allSettled(handlerPromises);
-        }
-    }
-    /**
-     * Execute a handler safely, catching any errors.
-     */
-    async executeHandler(handler, event) {
-        try {
-            await handler(event);
-        }
-        catch (error) {
-            // Silently catch handler errors to prevent crash
-            console.error('Event handler error:', error);
-        }
-    }
-    /**
-     * Clear all subscriptions.
-     */
-    clear() {
-        this.handlers.clear();
-        this.wildcardHandlers.clear();
-    }
-    /**
-     * Get statistics about the event bus.
-     */
-    getStats() {
-        let totalHandlers = 0;
-        for (const handlers of this.handlers.values()) {
-            totalHandlers += handlers.size;
-        }
-        totalHandlers += this.wildcardHandlers.size;
-        return {
-            eventTypes: this.handlers.size,
-            wildcardHandlers: this.wildcardHandlers.size,
-            totalHandlers,
-        };
-    }
-}
-//# sourceMappingURL=event-bus.js.map

package/dist/core/src/env/workflow/engine/event-bus.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=event-bus.test.d.ts.map

package/dist/core/src/env/workflow/engine/event-bus.test.js

@@ -1,274 +0,0 @@
-import { describe, it, expect, beforeEach, vi } from 'vitest';
-import { EventBus } from "./event-bus.js";
-// Helper to create test events
-function createTestEvent(type, runId = 'run_123') {
-    return {
-        type,
-        run_id: runId,
-        timestamp: Date.now(),
-    };
-}
-describe('EventBus', () => {
-    let eventBus;
-    beforeEach(() => {
-        eventBus = new EventBus();
-    });
-    describe('on() - Subscribe to specific event type', () => {
-        it('should subscribe to a specific event type and receive events', async () => {
-            const handler = vi.fn();
-            const unsubscribe = eventBus.on('workflow.started', handler);
-            const event = createTestEvent('workflow.started');
-            await eventBus.publish(event);
-            expect(handler).toHaveBeenCalledTimes(1);
-            expect(handler).toHaveBeenCalledWith(event);
-            unsubscribe();
-        });
-        it('should support multiple handlers for the same event type', async () => {
-            const handler1 = vi.fn();
-            const handler2 = vi.fn();
-            eventBus.on('workflow.started', handler1);
-            eventBus.on('workflow.started', handler2);
-            const event = createTestEvent('workflow.started');
-            await eventBus.publish(event);
-            expect(handler1).toHaveBeenCalledTimes(1);
-            expect(handler2).toHaveBeenCalledTimes(1);
-        });
-        it('should not receive events after unsubscribe', async () => {
-            const handler = vi.fn();
-            const unsubscribe = eventBus.on('workflow.started', handler);
-            const event1 = createTestEvent('workflow.started');
-            await eventBus.publish(event1);
-            expect(handler).toHaveBeenCalledTimes(1);
-            unsubscribe();
-            const event2 = createTestEvent('workflow.started');
-            await eventBus.publish(event2);
-            expect(handler).toHaveBeenCalledTimes(1); // Should not increase
-        });
-        it('should return unsubscribe function from on()', () => {
-            const handler = vi.fn();
-            const unsubscribe = eventBus.on('workflow.started', handler);
-            expect(typeof unsubscribe).toBe('function');
-            unsubscribe();
-        });
-    });
-    describe('once() - Subscribe once (auto-unsubscribe)', () => {
-        it('should only call handler once and then auto-unsubscribe', async () => {
-            const handler = vi.fn();
-            eventBus.once('workflow.started', handler);
-            const event1 = createTestEvent('workflow.started');
-            const event2 = createTestEvent('workflow.started');
-            await eventBus.publish(event1);
-            await eventBus.publish(event2);
-            expect(handler).toHaveBeenCalledTimes(1);
-            expect(handler).toHaveBeenCalledWith(event1);
-        });
-        it('should return unsubscribe function from once()', () => {
-            const handler = vi.fn();
-            const unsubscribe = eventBus.once('workflow.started', handler);
-            expect(typeof unsubscribe).toBe('function');
-        });
-        it('should handle multiple once() subscriptions independently', async () => {
-            const handler1 = vi.fn();
-            const handler2 = vi.fn();
-            eventBus.once('workflow.started', handler1);
-            eventBus.once('workflow.started', handler2);
-            await eventBus.publish(createTestEvent('workflow.started'));
-            await eventBus.publish(createTestEvent('workflow.started'));
-            expect(handler1).toHaveBeenCalledTimes(1);
-            expect(handler2).toHaveBeenCalledTimes(1);
-        });
-    });
-    describe('off() - Unsubscribe', () => {
-        it('should remove handler when off() is called', async () => {
-            const handler = vi.fn();
-            eventBus.on('workflow.started', handler);
-            eventBus.off('workflow.started', handler);
-            await eventBus.publish(createTestEvent('workflow.started'));
-            expect(handler).not.toHaveBeenCalled();
-        });
-        it('should only remove the specified handler', async () => {
-            const handler1 = vi.fn();
-            const handler2 = vi.fn();
-            eventBus.on('workflow.started', handler1);
-            eventBus.on('workflow.started', handler2);
-            eventBus.off('workflow.started', handler1);
-            await eventBus.publish(createTestEvent('workflow.started'));
-            expect(handler1).not.toHaveBeenCalled();
-            expect(handler2).toHaveBeenCalledTimes(1);
-        });
-        it('should handle off() for non-existent handler gracefully', () => {
-            const handler = vi.fn();
-            // Should not throw
-            expect(() => eventBus.off('workflow.started', handler)).not.toThrow();
-        });
-    });
-    describe('onAny() - Wildcard subscriptions', () => {
-        it('should receive all events when using onAny()', async () => {
-            const handler = vi.fn();
-            eventBus.onAny(handler);
-            await eventBus.publish(createTestEvent('workflow.started'));
-            await eventBus.publish(createTestEvent('workflow.completed'));
-            await eventBus.publish(createTestEvent('node.started'));
-            expect(handler).toHaveBeenCalledTimes(3);
-        });
-        it('should return unsubscribe function from onAny()', () => {
-            const handler = vi.fn();
-            const unsubscribe = eventBus.onAny(handler);
-            expect(typeof unsubscribe).toBe('function');
-        });
-        it('should not receive events after unsubscribe', async () => {
-            const handler = vi.fn();
-            const unsubscribe = eventBus.onAny(handler);
-            await eventBus.publish(createTestEvent('workflow.started'));
-            unsubscribe();
-            await eventBus.publish(createTestEvent('workflow.completed'));
-            expect(handler).toHaveBeenCalledTimes(1);
-        });
-        it('should work together with specific event subscriptions', async () => {
-            const anyHandler = vi.fn();
-            const specificHandler = vi.fn();
-            eventBus.onAny(anyHandler);
-            eventBus.on('workflow.started', specificHandler);
-            await eventBus.publish(createTestEvent('workflow.started'));
-            await eventBus.publish(createTestEvent('workflow.completed'));
-            expect(anyHandler).toHaveBeenCalledTimes(2);
-            expect(specificHandler).toHaveBeenCalledTimes(1);
-        });
-    });
-    describe('publish() - Publish events to subscribers', () => {
-        it('should publish event to all matching subscribers', async () => {
-            const handler1 = vi.fn();
-            const handler2 = vi.fn();
-            eventBus.on('workflow.started', handler1);
-            eventBus.on('workflow.started', handler2);
-            const event = createTestEvent('workflow.started');
-            await eventBus.publish(event);
-            expect(handler1).toHaveBeenCalledWith(event);
-            expect(handler2).toHaveBeenCalledWith(event);
-        });
-        it('should handle async handlers', async () => {
-            const handler = vi.fn().mockImplementation(async () => {
-                await new Promise((resolve) => setTimeout(resolve, 10));
-            });
-            eventBus.on('workflow.started', handler);
-            await eventBus.publish(createTestEvent('workflow.started'));
-            expect(handler).toHaveBeenCalled();
-        });
-        it('should not block publish when handlers are async', async () => {
-            const handler = vi.fn().mockImplementation(async () => {
-                await new Promise((resolve) => setTimeout(resolve, 50));
-            });
-            eventBus.on('workflow.started', handler);
-            const start = Date.now();
-            await eventBus.publish(createTestEvent('workflow.started'));
-            const duration = Date.now() - start;
-            // publish should not wait for handler to complete
-            expect(duration).toBeLessThan(40);
-        });
-    });
-    describe('Error handling in handlers', () => {
-        it('should not crash the bus when a handler throws', async () => {
-            const errorHandler = vi.fn().mockImplementation(() => {
-                throw new Error('Handler error');
-            });
-            const normalHandler = vi.fn();
-            eventBus.on('workflow.started', errorHandler);
-            eventBus.on('workflow.started', normalHandler);
-            // Should not throw - the publish method should catch errors internally
-            let threw = false;
-            try {
-                await eventBus.publish(createTestEvent('workflow.started'));
-            }
-            catch {
-                threw = true;
-            }
-            expect(threw).toBe(false);
-            expect(normalHandler).toHaveBeenCalled();
-        });
-        it('should not crash the bus when a handler rejects', async () => {
-            const errorHandler = vi.fn().mockImplementation(async () => {
-                throw new Error('Async handler error');
-            });
-            const normalHandler = vi.fn();
-            eventBus.on('workflow.started', errorHandler);
-            eventBus.on('workflow.started', normalHandler);
-            // Should not throw - the publish method should catch errors internally
-            let threw = false;
-            try {
-                await eventBus.publish(createTestEvent('workflow.started'));
-                // Wait a bit for async handlers to potentially throw
-                await new Promise(resolve => setTimeout(resolve, 20));
-            }
-            catch {
-                threw = true;
-            }
-            expect(threw).toBe(false);
-            expect(normalHandler).toHaveBeenCalled();
-        });
-        it('should continue to other handlers after one fails', async () => {
-            const errorHandler = vi.fn().mockImplementation(() => {
-                throw new Error('Handler error');
-            });
-            const normalHandler = vi.fn();
-            eventBus.on('workflow.started', errorHandler);
-            eventBus.on('workflow.started', normalHandler);
-            await eventBus.publish(createTestEvent('workflow.started'));
-            expect(errorHandler).toHaveBeenCalled();
-            expect(normalHandler).toHaveBeenCalled();
-        });
-    });
-    describe('clear() - Clear all subscriptions', () => {
-        it('should remove all handlers when clear() is called', async () => {
-            const handler1 = vi.fn();
-            const handler2 = vi.fn();
-            const wildcardHandler = vi.fn();
-            eventBus.on('workflow.started', handler1);
-            eventBus.on('workflow.completed', handler2);
-            eventBus.onAny(wildcardHandler);
-            eventBus.clear();
-            await eventBus.publish(createTestEvent('workflow.started'));
-            await eventBus.publish(createTestEvent('workflow.completed'));
-            expect(handler1).not.toHaveBeenCalled();
-            expect(handler2).not.toHaveBeenCalled();
-            expect(wildcardHandler).not.toHaveBeenCalled();
-        });
-        it('should allow new subscriptions after clear()', async () => {
-            const oldHandler = vi.fn();
-            const newHandler = vi.fn();
-            eventBus.on('workflow.started', oldHandler);
-            eventBus.clear();
-            eventBus.on('workflow.started', newHandler);
-            await eventBus.publish(createTestEvent('workflow.started'));
-            expect(oldHandler).not.toHaveBeenCalled();
-            expect(newHandler).toHaveBeenCalledTimes(1);
-        });
-    });
-    describe('getStats() - Get statistics', () => {
-        it('should return correct stats after subscriptions', () => {
-            eventBus.on('workflow.started', vi.fn());
-            eventBus.on('workflow.started', vi.fn());
-            eventBus.on('workflow.completed', vi.fn());
-            eventBus.onAny(vi.fn());
-            const stats = eventBus.getStats();
-            expect(stats.eventTypes).toBe(2); // workflow.started and workflow.completed
-            expect(stats.wildcardHandlers).toBe(1);
-            expect(stats.totalHandlers).toBe(4); // 3 specific + 1 wildcard
-        });
-        it('should return zero stats for new EventBus', () => {
-            const stats = eventBus.getStats();
-            expect(stats.eventTypes).toBe(0);
-            expect(stats.wildcardHandlers).toBe(0);
-            expect(stats.totalHandlers).toBe(0);
-        });
-        it('should update stats after clearing', () => {
-            eventBus.on('workflow.started', vi.fn());
-            eventBus.onAny(vi.fn());
-            eventBus.clear();
-            const stats = eventBus.getStats();
-            expect(stats.eventTypes).toBe(0);
-            expect(stats.wildcardHandlers).toBe(0);
-            expect(stats.totalHandlers).toBe(0);
-        });
-    });
-});
-//# sourceMappingURL=event-bus.test.js.map

package/dist/core/src/env/workflow/engine/executor-agent-session.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=executor-agent-session.test.d.ts.map

package/dist/core/src/env/workflow/engine/executor-agent-session.test.js

@@ -1,46 +0,0 @@
-import { describe, it, expect, beforeEach, vi } from 'vitest';
-import { Executor } from "./executor.js";
-import { EventBus } from "./event-bus.js";
-describe('Executor - agentSessionId in messages', () => {
-    let executor;
-    let mockSessionComponent;
-    let addedMessages = [];
-    beforeEach(() => {
-        addedMessages = [];
-        mockSessionComponent = {
-            addMessage: vi.fn(async (sessionId, message) => {
-                addedMessages.push({ sessionId, message });
-            }),
-        };
-        executor = new Executor({}, new EventBus(), {}, mockSessionComponent);
-    });
-    describe('writeNodeCall', () => {
-        it('should include agentSessionId in metadata when provided', async () => {
-            await executor.writeNodeCall('session-1', 'agent_node', 'agent', { input: 'test' }, 'agent_agent_node_123');
-            expect(addedMessages).toHaveLength(1);
-            const metadata = addedMessages[0].message.metadata;
-            expect(metadata.agentSessionId).toBe('agent_agent_node_123');
-        });
-        it('should not include agentSessionId in metadata when not provided', async () => {
-            await executor.writeNodeCall('session-1', 'tool_node', 'tool', { input: 'test' });
-            expect(addedMessages).toHaveLength(1);
-            const metadata = addedMessages[0].message.metadata;
-            expect(metadata.agentSessionId).toBeUndefined();
-        });
-    });
-    describe('writeNodeInterrupt', () => {
-        it('should include agentSessionId in metadata when provided', async () => {
-            await executor.writeNodeInterrupt('session-1', 'ask_user', 'ask_user', 'Continue?', 'agent_agent_node_456');
-            expect(addedMessages).toHaveLength(1);
-            const metadata = addedMessages[0].message.metadata;
-            expect(metadata.agentSessionId).toBe('agent_agent_node_456');
-        });
-        it('should not include agentSessionId in metadata when not provided', async () => {
-            await executor.writeNodeInterrupt('session-1', 'ask_user', 'ask_user', 'Continue?');
-            expect(addedMessages).toHaveLength(1);
-            const metadata = addedMessages[0].message.metadata;
-            expect(metadata.agentSessionId).toBeUndefined();
-        });
-    });
-});
-//# sourceMappingURL=executor-agent-session.test.js.map

package/dist/core/src/env/workflow/engine/executor.d.ts

@@ -1,106 +0,0 @@
-/**
- * @fileoverview Executor - Executes nodes in a workflow
- *
- * The Executor is responsible for:
- * - Executing individual nodes
- * - Handling retries
- * - Managing timeouts
- * - Tracking execution state
- */
-import type { NodeDefinition, RetryConfig, NodeExecutionContext, NodeExecutionResult } from '../types/index';
-import { EventBus } from './event-bus';
-import { NodeRegistry } from './node-registry';
-import type { SessionComponent } from '../../session/session-component';
-/**
- * Executor Options
- */
-export interface ExecutorOptions {
-    /** Global timeout for node execution (ms). null = no timeout */
-    globalTimeout: number | null;
-    /** Global retry configuration */
-    globalRetry: RetryConfig | null;
-    /** Debug mode */
-    debug: boolean;
-}
-/**
- * Executor
- *
- * Executes nodes in a workflow with support for:
- * - Timeout handling
- * - Retry with configurable backoff
- * - Error propagation
- * - Session message writing
- * - AskUserError handling
- *
- * @example
- * ```typescript
- * const executor = new Executor(nodeRegistry, eventBus, {
- *   globalTimeout: 60000,
- *   globalRetry: { max_attempts: 3, backoff: 'exponential', initial_delay: 1000 },
- *   debug: false
- * });
- *
- * const result = await executor.executeNode(nodeDefinition, context);
- * ```
- */
-export declare class Executor {
-    private nodeRegistry;
-    private eventBus;
-    private options;
-    private sessionComponent?;
-    private abortControllers;
-    constructor(nodeRegistry: NodeRegistry, eventBus: EventBus, options: ExecutorOptions, sessionComponent?: SessionComponent);
-    /**
-     * Execute a node with timeout and retry handling
-     */
-    executeNode(definition: NodeDefinition, context: NodeExecutionContext): Promise<NodeExecutionResult>;
-    /**
-     * Execute node with timeout handling
-     */
-    private executeWithTimeout;
-    /**
-     * Execute node with retry handling
-     */
-    private executeWithRetry;
-    /**
-     * Cancel execution of a specific node
-     */
-    cancelNode(nodeId: string): void;
-    /**
-     * Cancel all running nodes
-     */
-    cancelAll(): void;
-    /**
-     * Combine two abort signals
-     */
-    private combineAbortSignals;
-    /**
-     * Sleep for specified milliseconds
-     */
-    private sleep;
-    /**
-     * Write workflow.node.call message
-     */
-    writeNodeCall(sessionId: string, nodeId: string, nodeType: string, input: unknown, agentSessionId?: string): Promise<void>;
-    /**
-     * Create a meaningful content summary for call message
-     */
-    private summarizeCall;
-    /**
-     * Write workflow.node.interrupt message
-     */
-    writeNodeInterrupt(sessionId: string, nodeId: string, nodeType: string, query: string, agentSessionId?: string): Promise<void>;
-    /**
-     * Write workflow.node.result message
-     */
-    writeNodeResult(sessionId: string, nodeId: string, nodeType: string, output: unknown, error: string | undefined, durationMs: number): Promise<void>;
-    /**
-     * Create a meaningful content summary for result display
-     */
-    private summarizeResult;
-    /**
-     * Write workflow.node.resume message
-     */
-    writeNodeResume(sessionId: string, response: string): Promise<void>;
-}
-//# sourceMappingURL=executor.d.ts.map