@tashiscool/agents 0.1.0

package/dist/events.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Agent Event Stream
+ * Process and handle streaming events from LLM agents
+ */
+/**
+ * Base event types for agent execution
+ */
+export type AgentEventType = 'agent_start' | 'agent_end' | 'agent_error' | 'llm_start' | 'llm_stream' | 'llm_end' | 'llm_error' | 'tool_start' | 'tool_end' | 'tool_error' | 'thinking_start' | 'thinking_end' | 'message_start' | 'message_delta' | 'message_end';
+/**
+ * Base agent event
+ */
+export interface AgentEvent<T = unknown> {
+    /** Event type */
+    type: AgentEventType;
+    /** Event timestamp */
+    timestamp: Date;
+    /** Run ID for correlation */
+    runId: string;
+    /** Parent run ID (for nested operations) */
+    parentRunId?: string;
+    /** Event payload */
+    data: T;
+    /** Event metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Agent start event data
+ */
+export interface AgentStartData {
+    agentName: string;
+    input: unknown;
+    tools?: string[];
+}
+/**
+ * Agent end event data
+ */
+export interface AgentEndData {
+    agentName: string;
+    output: unknown;
+    durationMs: number;
+}
+/**
+ * LLM stream event data
+ */
+export interface LlmStreamData {
+    model: string;
+    delta: string;
+    finishReason?: string;
+}
+/**
+ * Tool call event data
+ */
+export interface ToolCallData {
+    toolName: string;
+    toolCallId: string;
+    arguments: Record<string, unknown>;
+    result?: unknown;
+    error?: string;
+}
+/**
+ * Event handler function
+ */
+export type EventHandler<T = unknown> = (event: AgentEvent<T>) => void | Promise<void>;
+/**
+ * Event filter function
+ */
+export type EventFilter = (event: AgentEvent) => boolean;
+/**
+ * Event transformer function
+ */
+export type EventTransformer<TIn = unknown, TOut = unknown> = (event: AgentEvent<TIn>) => AgentEvent<TOut> | null;
+/**
+ * Event stream processor
+ */
+export declare class EventStreamProcessor {
+    private handlers;
+    private filters;
+    private transformers;
+    private eventBuffer;
+    private bufferSize;
+    private isProcessing;
+    constructor(options?: {
+        bufferSize?: number;
+    });
+    /**
+     * Subscribe to specific event type
+     */
+    on<T>(type: AgentEventType | '*', handler: EventHandler<T>): () => void;
+    /**
+     * Subscribe to multiple event types
+     */
+    onMany(types: AgentEventType[], handler: EventHandler): () => void;
+    /**
+     * Add event filter
+     */
+    addFilter(filter: EventFilter): void;
+    /**
+     * Add event transformer
+     */
+    addTransformer(transformer: EventTransformer): void;
+    /**
+     * Process a single event
+     */
+    process(event: AgentEvent): Promise<void>;
+    /**
+     * Process multiple events
+     */
+    processAll(events: AgentEvent[]): Promise<void>;
+    /**
+     * Get buffered events
+     */
+    getBuffer(): AgentEvent[];
+    /**
+     * Get events by type from buffer
+     */
+    getBufferedByType(type: AgentEventType): AgentEvent[];
+    /**
+     * Get events by run ID
+     */
+    getBufferedByRun(runId: string): AgentEvent[];
+    /**
+     * Clear buffer
+     */
+    clearBuffer(): void;
+    /**
+     * Remove all handlers
+     */
+    removeAllHandlers(): void;
+}
+/**
+ * Event emitter for agent execution
+ */
+export declare class AgentEventEmitter {
+    private processor;
+    private currentRunId;
+    private parentRunId?;
+    private startTime;
+    constructor(processor?: EventStreamProcessor, parentRunId?: string);
+    /**
+     * Get current run ID
+     */
+    get runId(): string;
+    /**
+     * Create child emitter for nested operations
+     */
+    child(): AgentEventEmitter;
+    /**
+     * Emit an event
+     */
+    emit<T>(type: AgentEventType, data: T): Promise<void>;
+    /**
+     * Emit agent start
+     */
+    agentStart(agentName: string, input: unknown, tools?: string[]): Promise<void>;
+    /**
+     * Emit agent end
+     */
+    agentEnd(agentName: string, output: unknown): Promise<void>;
+    /**
+     * Emit agent error
+     */
+    agentError(error: Error): Promise<void>;
+    /**
+     * Emit LLM stream delta
+     */
+    llmStream(model: string, delta: string, finishReason?: string): Promise<void>;
+    /**
+     * Emit tool start
+     */
+    toolStart(toolName: string, toolCallId: string, args: Record<string, unknown>): Promise<void>;
+    /**
+     * Emit tool end
+     */
+    toolEnd(toolName: string, toolCallId: string, args: Record<string, unknown>, result: unknown): Promise<void>;
+    /**
+     * Emit tool error
+     */
+    toolError(toolName: string, toolCallId: string, args: Record<string, unknown>, error: string): Promise<void>;
+    /**
+     * Get the processor
+     */
+    getProcessor(): EventStreamProcessor;
+}
+/**
+ * Create an event stream processor
+ */
+export declare function createEventProcessor(options?: {
+    bufferSize?: number;
+}): EventStreamProcessor;
+/**
+ * Create an event emitter
+ */
+export declare function createEventEmitter(processor?: EventStreamProcessor): AgentEventEmitter;
+/**
+ * Common event filters
+ */
+export declare const EventFilters: {
+    /** Filter by run ID */
+    byRunId: (runId: string) => EventFilter;
+    /** Filter by event types */
+    byTypes: (types: AgentEventType[]) => EventFilter;
+    /** Exclude event types */
+    excludeTypes: (types: AgentEventType[]) => EventFilter;
+    /** Filter LLM events only */
+    llmOnly: () => EventFilter;
+    /** Filter tool events only */
+    toolOnly: () => EventFilter;
+};
+/**
+ * Common event transformers
+ */
+export declare const EventTransformers: {
+    /** Add metadata to all events */
+    addMetadata: (meta: Record<string, unknown>) => EventTransformer;
+    /** Redact sensitive data */
+    redact: (keys: string[]) => EventTransformer;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,299 @@
+/**
+ * Agent Event Stream
+ * Process and handle streaming events from LLM agents
+ */
+/**
+ * Event stream processor
+ */
+export class EventStreamProcessor {
+    handlers = new Map();
+    filters = [];
+    transformers = [];
+    eventBuffer = [];
+    bufferSize;
+    isProcessing = false;
+    constructor(options = {}) {
+        this.bufferSize = options.bufferSize || 100;
+    }
+    /**
+     * Subscribe to specific event type
+     */
+    on(type, handler) {
+        if (!this.handlers.has(type)) {
+            this.handlers.set(type, []);
+        }
+        this.handlers.get(type).push(handler);
+        // Return unsubscribe function
+        return () => {
+            const handlers = this.handlers.get(type);
+            if (handlers) {
+                const index = handlers.indexOf(handler);
+                if (index !== -1) {
+                    handlers.splice(index, 1);
+                }
+            }
+        };
+    }
+    /**
+     * Subscribe to multiple event types
+     */
+    onMany(types, handler) {
+        const unsubscribes = types.map((type) => this.on(type, handler));
+        return () => unsubscribes.forEach((unsub) => unsub());
+    }
+    /**
+     * Add event filter
+     */
+    addFilter(filter) {
+        this.filters.push(filter);
+    }
+    /**
+     * Add event transformer
+     */
+    addTransformer(transformer) {
+        this.transformers.push(transformer);
+    }
+    /**
+     * Process a single event
+     */
+    async process(event) {
+        // Apply filters
+        for (const filter of this.filters) {
+            if (!filter(event)) {
+                return;
+            }
+        }
+        // Apply transformers
+        let transformed = event;
+        for (const transformer of this.transformers) {
+            transformed = transformer(transformed);
+            if (!transformed)
+                return;
+        }
+        // Buffer event
+        this.eventBuffer.push(transformed);
+        if (this.eventBuffer.length > this.bufferSize) {
+            this.eventBuffer.shift();
+        }
+        // Call specific handlers
+        const specificHandlers = this.handlers.get(transformed.type) || [];
+        for (const handler of specificHandlers) {
+            await handler(transformed);
+        }
+        // Call wildcard handlers
+        const wildcardHandlers = this.handlers.get('*') || [];
+        for (const handler of wildcardHandlers) {
+            await handler(transformed);
+        }
+    }
+    /**
+     * Process multiple events
+     */
+    async processAll(events) {
+        for (const event of events) {
+            await this.process(event);
+        }
+    }
+    /**
+     * Get buffered events
+     */
+    getBuffer() {
+        return [...this.eventBuffer];
+    }
+    /**
+     * Get events by type from buffer
+     */
+    getBufferedByType(type) {
+        return this.eventBuffer.filter((e) => e.type === type);
+    }
+    /**
+     * Get events by run ID
+     */
+    getBufferedByRun(runId) {
+        return this.eventBuffer.filter((e) => e.runId === runId);
+    }
+    /**
+     * Clear buffer
+     */
+    clearBuffer() {
+        this.eventBuffer = [];
+    }
+    /**
+     * Remove all handlers
+     */
+    removeAllHandlers() {
+        this.handlers.clear();
+    }
+}
+/**
+ * Generate run ID
+ */
+function generateRunId() {
+    return `run_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+}
+/**
+ * Event emitter for agent execution
+ */
+export class AgentEventEmitter {
+    processor;
+    currentRunId;
+    parentRunId;
+    startTime;
+    constructor(processor, parentRunId) {
+        this.processor = processor || new EventStreamProcessor();
+        this.currentRunId = generateRunId();
+        this.parentRunId = parentRunId;
+        this.startTime = Date.now();
+    }
+    /**
+     * Get current run ID
+     */
+    get runId() {
+        return this.currentRunId;
+    }
+    /**
+     * Create child emitter for nested operations
+     */
+    child() {
+        return new AgentEventEmitter(this.processor, this.currentRunId);
+    }
+    /**
+     * Emit an event
+     */
+    async emit(type, data) {
+        const event = {
+            type,
+            timestamp: new Date(),
+            runId: this.currentRunId,
+            parentRunId: this.parentRunId,
+            data,
+        };
+        await this.processor.process(event);
+    }
+    /**
+     * Emit agent start
+     */
+    async agentStart(agentName, input, tools) {
+        await this.emit('agent_start', {
+            agentName,
+            input,
+            tools,
+        });
+    }
+    /**
+     * Emit agent end
+     */
+    async agentEnd(agentName, output) {
+        await this.emit('agent_end', {
+            agentName,
+            output,
+            durationMs: Date.now() - this.startTime,
+        });
+    }
+    /**
+     * Emit agent error
+     */
+    async agentError(error) {
+        await this.emit('agent_error', {
+            message: error.message,
+            stack: error.stack,
+            durationMs: Date.now() - this.startTime,
+        });
+    }
+    /**
+     * Emit LLM stream delta
+     */
+    async llmStream(model, delta, finishReason) {
+        await this.emit('llm_stream', {
+            model,
+            delta,
+            finishReason,
+        });
+    }
+    /**
+     * Emit tool start
+     */
+    async toolStart(toolName, toolCallId, args) {
+        await this.emit('tool_start', {
+            toolName,
+            toolCallId,
+            arguments: args,
+        });
+    }
+    /**
+     * Emit tool end
+     */
+    async toolEnd(toolName, toolCallId, args, result) {
+        await this.emit('tool_end', {
+            toolName,
+            toolCallId,
+            arguments: args,
+            result,
+        });
+    }
+    /**
+     * Emit tool error
+     */
+    async toolError(toolName, toolCallId, args, error) {
+        await this.emit('tool_error', {
+            toolName,
+            toolCallId,
+            arguments: args,
+            error,
+        });
+    }
+    /**
+     * Get the processor
+     */
+    getProcessor() {
+        return this.processor;
+    }
+}
+/**
+ * Create an event stream processor
+ */
+export function createEventProcessor(options) {
+    return new EventStreamProcessor(options);
+}
+/**
+ * Create an event emitter
+ */
+export function createEventEmitter(processor) {
+    return new AgentEventEmitter(processor);
+}
+/**
+ * Common event filters
+ */
+export const EventFilters = {
+    /** Filter by run ID */
+    byRunId: (runId) => (event) => event.runId === runId,
+    /** Filter by event types */
+    byTypes: (types) => (event) => types.includes(event.type),
+    /** Exclude event types */
+    excludeTypes: (types) => (event) => !types.includes(event.type),
+    /** Filter LLM events only */
+    llmOnly: () => (event) => event.type.startsWith('llm_'),
+    /** Filter tool events only */
+    toolOnly: () => (event) => event.type.startsWith('tool_'),
+};
+/**
+ * Common event transformers
+ */
+export const EventTransformers = {
+    /** Add metadata to all events */
+    addMetadata: (meta) => (event) => ({
+        ...event,
+        metadata: { ...event.metadata, ...meta },
+    }),
+    /** Redact sensitive data */
+    redact: (keys) => (event) => {
+        const data = { ...event.data };
+        for (const key of keys) {
+            if (key in data) {
+                data[key] = '[REDACTED]';
+            }
+        }
+        return { ...event, data };
+    },
+};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/executor.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Batch Executor
+ * Execute multiple tool calls with routing, concurrency control, and error handling
+ */
+import type { ToolDefinition, ToolCall, ToolResult } from './tools.js';
+/**
+ * Execution priority
+ */
+export type ExecutionPriority = 'high' | 'normal' | 'low';
+/**
+ * Execution strategy
+ */
+export type ExecutionStrategy = 'parallel' | 'sequential' | 'adaptive';
+/**
+ * Tool call with execution metadata
+ */
+export interface EnhancedToolCall extends ToolCall {
+    /** Execution priority */
+    priority?: ExecutionPriority;
+    /** Timeout in milliseconds */
+    timeoutMs?: number;
+    /** Number of retries on failure */
+    retries?: number;
+    /** Dependencies (tool call IDs that must complete first) */
+    dependsOn?: string[];
+}
+/**
+ * Enhanced tool result
+ */
+export interface EnhancedToolResult extends ToolResult {
+    /** Execution duration in milliseconds */
+    durationMs: number;
+    /** Number of retries attempted */
+    retriesAttempted: number;
+    /** Whether result is from cache */
+    cached: boolean;
+}
+/**
+ * Batch execution options
+ */
+export interface BatchExecutionOptions {
+    /** Maximum concurrent executions */
+    maxConcurrency?: number;
+    /** Default timeout per tool call */
+    defaultTimeoutMs?: number;
+    /** Default number of retries */
+    defaultRetries?: number;
+    /** Execution strategy */
+    strategy?: ExecutionStrategy;
+    /** Stop on first error */
+    stopOnError?: boolean;
+    /** Cache results */
+    enableCache?: boolean;
+    /** Cache TTL in milliseconds */
+    cacheTtlMs?: number;
+}
+/**
+ * Execution progress callback
+ */
+export type ProgressCallback = (progress: {
+    completed: number;
+    total: number;
+    current?: EnhancedToolCall;
+    result?: EnhancedToolResult;
+}) => void;
+/**
+ * Tool router for dynamic tool selection
+ */
+export interface ToolRouter {
+    /** Route a tool call to the appropriate tool */
+    route(call: ToolCall): ToolDefinition | undefined;
+    /** Check if a tool is available */
+    hasRoute(toolName: string): boolean;
+    /** List all available routes */
+    listRoutes(): string[];
+}
+/**
+ * Simple tool router implementation
+ */
+export declare class SimpleToolRouter implements ToolRouter {
+    private tools;
+    private aliases;
+    /**
+     * Register a tool
+     */
+    register(tool: ToolDefinition): void;
+    /**
+     * Register multiple tools
+     */
+    registerAll(tools: ToolDefinition[]): void;
+    /**
+     * Add an alias for a tool
+     */
+    addAlias(alias: string, toolName: string): void;
+    route(call: ToolCall): ToolDefinition | undefined;
+    hasRoute(toolName: string): boolean;
+    listRoutes(): string[];
+}
+/**
+ * Batch executor for tool calls
+ */
+export declare class BatchExecutor {
+    private router;
+    private options;
+    private cache?;
+    constructor(router: ToolRouter, options?: BatchExecutionOptions);
+    /**
+     * Execute a single tool call
+     */
+    executeOne(call: EnhancedToolCall): Promise<EnhancedToolResult>;
+    /**
+     * Execute multiple tool calls
+     */
+    execute(calls: EnhancedToolCall[], onProgress?: ProgressCallback): Promise<EnhancedToolResult[]>;
+    /**
+     * Execute sequentially
+     */
+    private executeSequential;
+    /**
+     * Execute in parallel with concurrency limit
+     */
+    private executeParallel;
+    /**
+     * Adaptive execution based on dependencies
+     */
+    private executeAdaptive;
+    /**
+     * Clear cache
+     */
+    clearCache(): void;
+    /**
+     * Cleanup expired cache entries
+     */
+    cleanupCache(): number;
+}
+/**
+ * Create a batch executor
+ */
+export declare function createBatchExecutor(tools: ToolDefinition[], options?: BatchExecutionOptions): BatchExecutor;
+/**
+ * Create a batch executor with custom router
+ */
+export declare function createBatchExecutorWithRouter(router: ToolRouter, options?: BatchExecutionOptions): BatchExecutor;
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

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