@thoughtflow/core 0.1.2

package/dist/libs/compiled-subagent.manager.js

@@ -0,0 +1,224 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompiledSubAgentManager = void 0;
+const conversation_class_1 = require("../conversation.class");
+const debug_logger_class_1 = require("./debug-logger.class");
+/**
+ * CompiledSubAgentManager compiles SubAgents into executable runnables
+ * with invoke, stream, and batch capabilities.
+ *
+ * Usage:
+ *   const compiler = new CompiledSubAgentManager(subagent);
+ *   const compiled = await compiler.compile();
+ *   const result = await compiled.invoke({ prompt: "hello" });
+ */
+class CompiledSubAgentManager {
+    subagent;
+    conversation = null;
+    logger;
+    compiled = null;
+    callCount = 0;
+    totalDurationMs = 0;
+    failureCount = 0;
+    constructor(subagent, debug = false) {
+        if (!subagent) {
+            throw new Error("CompiledSubAgentManager: subagent is required");
+        }
+        this.subagent = subagent;
+        this.logger = new debug_logger_class_1.DebugLogger(debug ? "info" : "off");
+    }
+    /**
+     * Compile the subagent into an executable runnable
+     */
+    async compile() {
+        if (this.compiled) {
+            return this.compiled;
+        }
+        this.logger.info("CompiledSubAgentManager", `Compiling subagent: ${this.subagent.name}`);
+        // Create conversation instance for this subagent
+        const config = {
+            model: this.subagent.model || "llama2:latest",
+            systemPrompt: this.subagent.systemPrompt,
+            tools: this.subagent.tools,
+            skills: this.subagent.skills,
+            middleware: this.subagent.middleware,
+            debugLevel: "off",
+        };
+        this.conversation = new conversation_class_1.Conversation(config);
+        // Create compiled subagent with runnable interface
+        this.compiled = {
+            ...this.subagent,
+            compiledId: `compiled_${this.subagent.name}_${Date.now()}`,
+            runnable: {
+                invoke: this.invoke.bind(this),
+                stream: this.stream.bind(this),
+                batch: this.batch.bind(this),
+            },
+            executionStats: {
+                totalExecutions: 0,
+                averageTimeMs: 0,
+                successRate: 0,
+            },
+        };
+        this.logger.info("CompiledSubAgentManager", `Compiled ${this.subagent.name} with ID ${this.compiled.compiledId}`);
+        return this.compiled;
+    }
+    /**
+     * Single invocation: execute subagent once with input
+     */
+    async invoke(input) {
+        if (!this.conversation) {
+            throw new Error("CompiledSubAgentManager: must call compile() first");
+        }
+        const startTime = Date.now();
+        const subagentInput = input;
+        const prompt = subagentInput?.prompt || String(input);
+        const timeoutMs = subagentInput?.timeoutMs || 30000;
+        try {
+            this.logger.info("CompiledSubAgentManager", `Invoking ${this.subagent.name}`);
+            // Execute with timeout
+            const result = await Promise.race([
+                this.conversation.sendPrompt(prompt),
+                new Promise((_, reject) => setTimeout(() => reject(new Error(`Invocation timeout (${timeoutMs}ms)`)), timeoutMs)),
+            ]);
+            const durationMs = Date.now() - startTime;
+            this.callCount++;
+            this.totalDurationMs += durationMs;
+            this.updateStats();
+            return {
+                output: result.output || String(result),
+                metadata: {
+                    subagentName: this.subagent.name,
+                    durationMs,
+                    success: true,
+                    timestamp: new Date().toISOString(),
+                },
+            };
+        }
+        catch (error) {
+            const durationMs = Date.now() - startTime;
+            this.callCount++;
+            this.failureCount++;
+            this.totalDurationMs += durationMs;
+            this.updateStats();
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                output: "",
+                metadata: {
+                    subagentName: this.subagent.name,
+                    durationMs,
+                    success: false,
+                    error: errorMessage,
+                    timestamp: new Date().toISOString(),
+                },
+            };
+        }
+    }
+    /**
+     * Stream invocation: execute subagent and stream results
+     * For now, chunks the text result into pieces
+     */
+    async *stream(input) {
+        if (!this.conversation) {
+            throw new Error("CompiledSubAgentManager: must call compile() first");
+        }
+        const subagentInput = input;
+        const prompt = subagentInput?.prompt || String(input);
+        try {
+            yield {
+                type: "metadata",
+                content: `Starting stream for ${this.subagent.name}`,
+                metadata: { subagentName: this.subagent.name, timestamp: new Date().toISOString() },
+            };
+            // Execute the prompt
+            const result = await this.conversation.sendPrompt(prompt);
+            const output = result.output || String(result);
+            // Chunk the output into pieces
+            const chunkSize = 50; // characters per chunk
+            for (let i = 0; i < output.length; i += chunkSize) {
+                yield {
+                    type: "text",
+                    content: output.substring(i, i + chunkSize),
+                    metadata: { chunkIndex: Math.floor(i / chunkSize) },
+                };
+            }
+            yield {
+                type: "complete",
+                content: "Stream completed",
+                metadata: { subagentName: this.subagent.name },
+            };
+            this.callCount++;
+            this.updateStats();
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            yield {
+                type: "error",
+                content: errorMessage,
+                metadata: { subagentName: this.subagent.name, error: true },
+            };
+            this.failureCount++;
+        }
+    }
+    /**
+     * Batch invocation: execute subagent multiple times
+     */
+    async batch(inputs) {
+        if (!this.conversation) {
+            throw new Error("CompiledSubAgentManager: must call compile() first");
+        }
+        const results = [];
+        for (const input of inputs) {
+            const result = await this.invoke(input);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Update execution statistics
+     */
+    updateStats() {
+        if (!this.compiled?.executionStats)
+            return;
+        this.compiled.executionStats.totalExecutions = this.callCount;
+        this.compiled.executionStats.successRate =
+            this.callCount > 0 ? (this.callCount - this.failureCount) / this.callCount : 0;
+        this.compiled.executionStats.averageTimeMs =
+            this.callCount > 0 ? this.totalDurationMs / this.callCount : 0;
+        this.compiled.executionStats.lastExecutedAt = new Date().toISOString();
+    }
+    /**
+     * Get compiled subagent (after calling compile())
+     */
+    getCompiled() {
+        if (!this.compiled) {
+            throw new Error("CompiledSubAgentManager: must call compile() first");
+        }
+        return this.compiled;
+    }
+    /**
+     * Get execution statistics
+     */
+    getStats() {
+        return {
+            callCount: this.callCount,
+            failureCount: this.failureCount,
+            successCount: this.callCount - this.failureCount,
+            totalDurationMs: this.totalDurationMs,
+            averageDurationMs: this.callCount > 0 ? this.totalDurationMs / this.callCount : 0,
+            successRate: this.callCount > 0 ? (this.callCount - this.failureCount) / this.callCount : 0,
+        };
+    }
+    /**
+     * Dispose and cleanup conversation
+     */
+    dispose() {
+        if (this.conversation) {
+            this.conversation.dispose();
+            this.conversation = null;
+        }
+        this.logger.info("CompiledSubAgentManager", `Disposed ${this.subagent.name}`);
+    }
+}
+exports.CompiledSubAgentManager = CompiledSubAgentManager;
+//# sourceMappingURL=compiled-subagent.manager.js.map

package/dist/libs/compiled-subagent.manager.js.map

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

package/dist/libs/conditional-flow.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Conditional flow and branching for complex decision trees
+ * Inspired by LangGraph's addConditionalEdges
+ */
+/**
+ * Result of evaluating a condition
+ */
+export type ConditionResult = string | null | undefined;
+/**
+ * Evaluates state and returns route name
+ */
+export type ConditionEvaluator<TState> = (state: TState) => ConditionResult | Promise<ConditionResult>;
+/**
+ * Handler executed when branch is selected
+ */
+export type BranchHandler<TState, TResult> = (state: TState) => TResult | Promise<TResult>;
+/**
+ * Result from executing a branch
+ */
+export interface BranchExecutionResult<TResult> {
+    /** Name of the route taken */
+    route: string;
+    /** Result from the branch handler */
+    result: TResult;
+    /** Condition that matched (if applicable) */
+    matchedCondition?: string;
+    /** Time taken in milliseconds */
+    executionTimeMs: number;
+    /** Whether this was the default branch */
+    isDefault: boolean;
+}
+/**
+ * Branch node in the flow
+ */
+export interface BranchNode<TState, TResult> {
+    name: string;
+    condition: ConditionEvaluator<TState>;
+    handler: BranchHandler<TState, TResult>;
+}
+/**
+ * History entry for branch execution
+ */
+export interface BranchHistoryEntry {
+    timestamp: Date;
+    route: string;
+    executionTimeMs: number;
+    state?: Record<string, unknown>;
+    error?: Error;
+}
+/**
+ * Statistics for branch usage
+ */
+export interface BranchStatistics {
+    totalExecutions: number;
+    executionsByRoute: Record<string, number>;
+    averageExecutionTimeMs: number;
+    averageTimeByRoute: Record<string, number>;
+    errorsByRoute: Record<string, number>;
+    mostUsedRoute: string | null;
+}
+/**
+ * ConditionalFlow manages decision trees with multiple branches
+ *
+ * Usage:
+ *   const flow = new ConditionalFlow<State, Result>();
+ *   flow.addBranch('path_a', (state) => state.type === 'a' ? 'path_a' : null, handleA);
+ *   flow.addBranch('path_b', (state) => state.type === 'b' ? 'path_b' : null, handleB);
+ *   flow.addDefault((state) => handleDefault(state));
+ *   const result = await flow.execute(myState);
+ */
+export declare class ConditionalFlow<TState, TResult = unknown> {
+    private branches;
+    private defaultBranch;
+    private history;
+    private executionStats;
+    private maxHistorySize;
+    constructor(maxHistorySize?: number);
+    /**
+     * Add a conditional branch
+     */
+    addBranch(name: string, condition: ConditionEvaluator<TState>, handler: BranchHandler<TState, TResult>): this;
+    /**
+     * Set default branch (fallback if no condition matches)
+     */
+    addDefault(handler: BranchHandler<TState, TResult>): this;
+    /**
+     * Evaluate which branch should be taken without executing
+     */
+    evaluate(state: TState): Promise<{
+        route: string;
+        isDefault: boolean;
+    }>;
+    /**
+     * Execute the appropriate branch based on state
+     */
+    execute(state: TState): Promise<BranchExecutionResult<TResult>>;
+    /**
+     * Get all available routes
+     */
+    getRoutes(): string[];
+    /**
+     * Check if a route exists
+     */
+    hasRoute(route: string): boolean;
+    /**
+     * Get branch execution history
+     */
+    getHistory(): BranchHistoryEntry[];
+    /**
+     * Clear history
+     */
+    clearHistory(): void;
+    /**
+     * Get statistics about branch usage
+     */
+    getStatistics(): BranchStatistics;
+    /**
+     * Reset statistics
+     */
+    resetStatistics(): void;
+    /**
+     * Remove a branch
+     */
+    removeBranch(name: string): boolean;
+    /**
+     * Get information about a specific branch
+     */
+    getBranchInfo(name: string): {
+        name: string;
+        isDefault: boolean;
+        exists: boolean;
+        executionCount?: undefined;
+        errorCount?: undefined;
+        averageTimeMs?: undefined;
+    } | {
+        name: string;
+        isDefault: boolean;
+        exists: boolean;
+        executionCount: number;
+        errorCount: number;
+        averageTimeMs: number;
+    };
+    /**
+     * Dispose and cleanup
+     */
+    dispose(): void;
+    /**
+     * Record execution in history
+     */
+    private recordHistory;
+    /**
+     * Safely serialize state for history
+     */
+    private safeSerializeState;
+}
+//# sourceMappingURL=conditional-flow.d.ts.map

package/dist/libs/conditional-flow.d.ts.map

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

package/dist/libs/conditional-flow.js

@@ -0,0 +1,295 @@
+"use strict";
+/**
+ * Conditional flow and branching for complex decision trees
+ * Inspired by LangGraph's addConditionalEdges
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConditionalFlow = void 0;
+/**
+ * ConditionalFlow manages decision trees with multiple branches
+ *
+ * Usage:
+ *   const flow = new ConditionalFlow<State, Result>();
+ *   flow.addBranch('path_a', (state) => state.type === 'a' ? 'path_a' : null, handleA);
+ *   flow.addBranch('path_b', (state) => state.type === 'b' ? 'path_b' : null, handleB);
+ *   flow.addDefault((state) => handleDefault(state));
+ *   const result = await flow.execute(myState);
+ */
+class ConditionalFlow {
+    branches = new Map();
+    defaultBranch = null;
+    history = [];
+    executionStats = new Map();
+    maxHistorySize = 1000;
+    constructor(maxHistorySize) {
+        if (maxHistorySize) {
+            this.maxHistorySize = maxHistorySize;
+        }
+    }
+    /**
+     * Add a conditional branch
+     */
+    addBranch(name, condition, handler) {
+        if (name === "default") {
+            throw new Error("Cannot name a branch 'default' - use addDefault() instead");
+        }
+        this.branches.set(name, {
+            name,
+            condition,
+            handler,
+        });
+        // Initialize stats for this route
+        if (!this.executionStats.has(name)) {
+            this.executionStats.set(name, { count: 0, totalTime: 0, errors: 0 });
+        }
+        return this;
+    }
+    /**
+     * Set default branch (fallback if no condition matches)
+     */
+    addDefault(handler) {
+        this.defaultBranch = handler;
+        // Initialize stats for default route
+        if (!this.executionStats.has("default")) {
+            this.executionStats.set("default", { count: 0, totalTime: 0, errors: 0 });
+        }
+        return this;
+    }
+    /**
+     * Evaluate which branch should be taken without executing
+     */
+    async evaluate(state) {
+        // Try each branch condition in order
+        for (const [name, branch] of this.branches) {
+            try {
+                const result = await branch.condition(state);
+                if (result === name || (result && result === name)) {
+                    return { route: name, isDefault: false };
+                }
+            }
+            catch (error) {
+                // Condition evaluation error - try next branch
+                console.error(`Condition evaluation failed for branch '${name}':`, error);
+            }
+        }
+        // No branch matched, use default
+        if (this.defaultBranch) {
+            return { route: "default", isDefault: true };
+        }
+        // No match and no default
+        throw new Error(`No branch matched and no default handler set. Available routes: ${Array.from(this.branches.keys()).join(", ")}`);
+    }
+    /**
+     * Execute the appropriate branch based on state
+     */
+    async execute(state) {
+        const startTime = Date.now();
+        try {
+            const { route, isDefault } = await this.evaluate(state);
+            let handler;
+            let matchedCondition;
+            if (isDefault) {
+                if (!this.defaultBranch) {
+                    throw new Error("Default branch selected but not set");
+                }
+                handler = this.defaultBranch;
+            }
+            else {
+                const branch = this.branches.get(route);
+                if (!branch) {
+                    throw new Error(`Branch '${route}' not found`);
+                }
+                handler = branch.handler;
+                matchedCondition = route;
+            }
+            // Execute the handler
+            const result = await handler(state);
+            const executionTimeMs = Date.now() - startTime;
+            // Update stats
+            const stats = this.executionStats.get(route) || { count: 0, totalTime: 0, errors: 0 };
+            stats.count++;
+            stats.totalTime += executionTimeMs;
+            this.executionStats.set(route, stats);
+            // Record in history
+            this.recordHistory({
+                timestamp: new Date(),
+                route,
+                executionTimeMs,
+                state: this.safeSerializeState(state),
+            });
+            return {
+                route,
+                result,
+                matchedCondition,
+                executionTimeMs,
+                isDefault,
+            };
+        }
+        catch (error) {
+            const executionTimeMs = Date.now() - startTime;
+            // Try to determine which route caused the error
+            let failedRoute = "unknown";
+            try {
+                const { route } = await this.evaluate(state);
+                failedRoute = route;
+            }
+            catch {
+                // Could not evaluate
+            }
+            // Update error stats
+            const stats = this.executionStats.get(failedRoute) || { count: 0, totalTime: 0, errors: 0 };
+            stats.errors++;
+            this.executionStats.set(failedRoute, stats);
+            // Record error in history
+            this.recordHistory({
+                timestamp: new Date(),
+                route: failedRoute,
+                executionTimeMs,
+                error: error,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Get all available routes
+     */
+    getRoutes() {
+        const routes = Array.from(this.branches.keys());
+        if (this.defaultBranch) {
+            routes.push("default");
+        }
+        return routes;
+    }
+    /**
+     * Check if a route exists
+     */
+    hasRoute(route) {
+        if (route === "default") {
+            return !!this.defaultBranch;
+        }
+        return this.branches.has(route);
+    }
+    /**
+     * Get branch execution history
+     */
+    getHistory() {
+        return [...this.history];
+    }
+    /**
+     * Clear history
+     */
+    clearHistory() {
+        this.history = [];
+    }
+    /**
+     * Get statistics about branch usage
+     */
+    getStatistics() {
+        const stats = {
+            totalExecutions: 0,
+            executionsByRoute: {},
+            averageExecutionTimeMs: 0,
+            averageTimeByRoute: {},
+            errorsByRoute: {},
+            mostUsedRoute: null,
+        };
+        let totalTime = 0;
+        let maxCount = 0;
+        for (const [route, data] of this.executionStats) {
+            stats.totalExecutions += data.count;
+            stats.executionsByRoute[route] = data.count;
+            stats.averageTimeByRoute[route] = data.count > 0 ? data.totalTime / data.count : 0;
+            stats.errorsByRoute[route] = data.errors;
+            totalTime += data.totalTime;
+            // Track most used route
+            if (data.count > maxCount) {
+                maxCount = data.count;
+                stats.mostUsedRoute = route;
+            }
+        }
+        stats.averageExecutionTimeMs = stats.totalExecutions > 0 ? totalTime / stats.totalExecutions : 0;
+        return stats;
+    }
+    /**
+     * Reset statistics
+     */
+    resetStatistics() {
+        this.executionStats.clear();
+        for (const route of Array.from(this.branches.keys())) {
+            this.executionStats.set(route, { count: 0, totalTime: 0, errors: 0 });
+        }
+        if (this.defaultBranch) {
+            this.executionStats.set("default", { count: 0, totalTime: 0, errors: 0 });
+        }
+    }
+    /**
+     * Remove a branch
+     */
+    removeBranch(name) {
+        if (name === "default") {
+            if (this.defaultBranch) {
+                this.defaultBranch = null;
+                return true;
+            }
+            return false;
+        }
+        return this.branches.delete(name);
+    }
+    /**
+     * Get information about a specific branch
+     */
+    getBranchInfo(name) {
+        if (name === "default") {
+            return {
+                name: "default",
+                isDefault: true,
+                exists: !!this.defaultBranch,
+            };
+        }
+        const branch = this.branches.get(name);
+        const stats = this.executionStats.get(name);
+        return {
+            name,
+            isDefault: false,
+            exists: !!branch,
+            executionCount: stats?.count ?? 0,
+            errorCount: stats?.errors ?? 0,
+            averageTimeMs: stats && stats.count > 0 ? stats.totalTime / stats.count : 0,
+        };
+    }
+    /**
+     * Dispose and cleanup
+     */
+    dispose() {
+        this.branches.clear();
+        this.defaultBranch = null;
+        this.history = [];
+        this.executionStats.clear();
+    }
+    /**
+     * Record execution in history
+     */
+    recordHistory(entry) {
+        this.history.push(entry);
+        // Trim history if it exceeds max size
+        if (this.history.length > this.maxHistorySize) {
+            this.history = this.history.slice(this.history.length - this.maxHistorySize);
+        }
+    }
+    /**
+     * Safely serialize state for history
+     */
+    safeSerializeState(state) {
+        try {
+            if (typeof state === "object" && state !== null && !(state instanceof Date)) {
+                return JSON.parse(JSON.stringify(state));
+            }
+        }
+        catch {
+            // If serialization fails, don't include state
+        }
+        return undefined;
+    }
+}
+exports.ConditionalFlow = ConditionalFlow;
+//# sourceMappingURL=conditional-flow.js.map