@thoughtflow/core 0.1.2

package/dist/libs/structured-call.js

@@ -0,0 +1,306 @@
+"use strict";
+/**
+ * structured-call.ts
+ *
+ * Framework-agnostic callStructured<T> and callStructuredStreaming<T> helpers.
+ * These run a single-turn LlmAdapter request in JSON mode and validate with Zod.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callStructured = callStructured;
+exports.callStructuredStreaming = callStructuredStreaming;
+exports.fillSchemaDefaults = fillSchemaDefaults;
+exports.describeZodSchema = describeZodSchema;
+exports.zodToJsonSchema = zodToJsonSchema;
+const zod_1 = require("zod");
+const nowIso = () => new Date().toISOString();
+async function callStructured(adapter, model, systemPrompt, userPrompt, schema, options) {
+    const schemaHint = describeZodSchema(schema);
+    const enrichedPrompt = schemaHint ? `${userPrompt}\n\n${schemaHint}` : userPrompt;
+    const messages = [
+        { id: "structured-system", role: "system", content: systemPrompt, createdAt: nowIso() },
+        { id: "structured-user", role: "user", content: enrichedPrompt, createdAt: nowIso() },
+    ];
+    const chatOpts = {
+        model,
+        messages,
+        tools: [],
+        responseFormat: "json",
+        responseSchema: zodToJsonSchema(schema),
+        structuredOutput: {
+            strategy: "provider-native",
+            schemaName: "structured_call_response",
+            strict: true,
+        },
+        signal: options?.signal,
+        thinking: options?.thinking,
+        temperature: options?.temperature,
+        numCtx: options?.numCtx,
+        seed: options?.seed,
+    };
+    // First attempt: strict structured output
+    try {
+        const response = await adapter.chat(chatOpts);
+        const normalized = parseAndValidateStructured(response.message.content, schema);
+        return {
+            result: normalized.result,
+            thinking: normalized.thinking,
+            tokensInput: response.tokensInput,
+            tokensOutput: response.tokensOutput,
+        };
+    }
+    catch {
+        // Second attempt: no responseFormat/responseSchema, just prompt instructions
+        const retryMessages = [
+            { id: "structured-system", role: "system", content: systemPrompt, createdAt: nowIso() },
+            { id: "structured-user-2", role: "user", content: `${enrichedPrompt}\n\nIMPORTANT: Every field must match the schema exactly. Arrays must contain objects, not strings.`, createdAt: nowIso() },
+        ];
+        const retryOpts = {
+            model,
+            messages: retryMessages,
+            tools: [],
+            responseFormat: "json",
+            responseSchema: undefined,
+            structuredOutput: {
+                strategy: "provider-native",
+                schemaName: "structured_call_response",
+                strict: false,
+            },
+            signal: options?.signal,
+            thinking: options?.thinking,
+            temperature: options?.temperature,
+            numCtx: options?.numCtx,
+            seed: options?.seed,
+        };
+        const response = await adapter.chat(retryOpts);
+        const normalized = parseAndValidateStructured(response.message.content, schema);
+        return {
+            result: normalized.result,
+            thinking: normalized.thinking,
+            tokensInput: response.tokensInput,
+            tokensOutput: response.tokensOutput,
+        };
+    }
+}
+async function callStructuredStreaming(adapter, model, systemPrompt, userPrompt, schema, options, onToken) {
+    const schemaHint = describeZodSchema(schema);
+    const enrichedPrompt = schemaHint ? `${userPrompt}\n\n${schemaHint}` : userPrompt;
+    const response = await adapter.streamChat({
+        model,
+        messages: [
+            { id: "structured-system", role: "system", content: systemPrompt, createdAt: nowIso() },
+            { id: "structured-user", role: "user", content: enrichedPrompt, createdAt: nowIso() },
+        ],
+        tools: [],
+        responseFormat: "json",
+        responseSchema: zodToJsonSchema(schema),
+        structuredOutput: {
+            strategy: "provider-native",
+            schemaName: "structured_call_response",
+            strict: true,
+        },
+        signal: options?.signal,
+        thinking: options?.thinking,
+        temperature: options?.temperature,
+        numCtx: options?.numCtx,
+        seed: options?.seed,
+    }, (chunk) => {
+        if (!onToken || !chunk.contentDelta) {
+            return;
+        }
+        onToken(chunk.contentDelta, chunk.fullContent);
+    });
+    const normalized = parseAndValidateStructured(response.message.content, schema);
+    return {
+        result: normalized.result,
+        thinking: normalized.thinking,
+        tokensInput: response.tokensInput,
+        tokensOutput: response.tokensOutput,
+    };
+}
+function parseAndValidateStructured(content, schema) {
+    const extracted = extractThinking(content);
+    const parsed = JSON.parse(extracted.content);
+    const filled = fillSchemaDefaults(parsed, schema);
+    const result = schema.parse(filled);
+    return { result, thinking: extracted.thinking };
+}
+function extractThinking(content) {
+    const match = content.match(/<think>([\s\S]*?)<\/think>/);
+    if (!match) {
+        return { content };
+    }
+    return {
+        thinking: match[1].trim(),
+        content: content.replace(/<think>[\s\S]*?<\/think>/, "").trim(),
+    };
+}
+/**
+ * Recursively fill misid: "s", createdAt: NOW(), content: systemPrompt },
+        { role: "user" as const, id: "u", createdAt: NOW()ing required fields in `data` with type-appropriate
+ * defaults so that schema.parse() doesn't throw on partially-filled objects.
+ */
+function fillSchemaDefaults(data, schema) {
+    if (data === null || data === undefined || typeof data !== "object")
+        return data;
+    let inner = schema;
+    while (inner instanceof zod_1.ZodEffects ||
+        inner instanceof zod_1.ZodOptional ||
+        inner instanceof zod_1.ZodNullable ||
+        inner instanceof zod_1.ZodDefault) {
+        if (inner instanceof zod_1.ZodEffects)
+            inner = inner._def.schema;
+        else if (inner instanceof zod_1.ZodDefault)
+            inner = inner._def.innerType;
+        else
+            inner = inner._def.innerType;
+    }
+    if (Array.isArray(data)) {
+        if (inner instanceof zod_1.ZodArray) {
+            const elementSchema = inner._def.type;
+            return data.map((item) => fillSchemaDefaults(item, elementSchema));
+        }
+        return data;
+    }
+    if (!(inner instanceof zod_1.ZodObject))
+        return data;
+    const shape = inner.shape;
+    const result = { ...data };
+    for (const [key, fieldSchema] of Object.entries(shape)) {
+        if (result[key] !== undefined) {
+            if (typeof result[key] === "object" && result[key] !== null) {
+                result[key] = fillSchemaDefaults(result[key], fieldSchema);
+            }
+            continue;
+        }
+        if (fieldSchema instanceof zod_1.ZodOptional || fieldSchema instanceof zod_1.ZodNullable)
+            continue;
+        let unwrapped = fieldSchema;
+        while (unwrapped instanceof zod_1.ZodDefault || unwrapped instanceof zod_1.ZodEffects) {
+            if (unwrapped instanceof zod_1.ZodDefault)
+                unwrapped = unwrapped._def.innerType;
+            else
+                unwrapped = unwrapped._def.schema;
+        }
+        if (unwrapped instanceof zod_1.ZodString)
+            result[key] = "";
+        else if (unwrapped instanceof zod_1.ZodBoolean)
+            result[key] = false;
+        else if (unwrapped instanceof zod_1.ZodNumber)
+            result[key] = 0;
+        else if (unwrapped instanceof zod_1.ZodArray)
+            result[key] = [];
+        else if (unwrapped instanceof zod_1.ZodEnum)
+            result[key] = unwrapped._def.values?.[0] ?? "";
+        else if (unwrapped instanceof zod_1.ZodObject)
+            result[key] = fillSchemaDefaults({}, unwrapped);
+    }
+    return result;
+}
+/** Unwrap Zod wrappers to get inner schema + optionality flag */
+function unwrapZod(fieldSchema) {
+    let unwrapped = fieldSchema;
+    let optional = false;
+    while (true) {
+        if (unwrapped instanceof zod_1.ZodOptional || unwrapped instanceof zod_1.ZodNullable) {
+            optional = true;
+            unwrapped = unwrapped._def.innerType;
+        }
+        else if (unwrapped instanceof zod_1.ZodDefault) {
+            unwrapped = unwrapped._def.innerType;
+        }
+        else if (unwrapped instanceof zod_1.ZodEffects) {
+            unwrapped = unwrapped._def.schema;
+        }
+        else
+            break;
+    }
+    return { unwrapped, optional };
+}
+/** Recursively describe fields of a ZodObject with indentation */
+function describeObjectFields(obj, lines, depth) {
+    const indent = "  ".repeat(depth);
+    for (const [key, fieldSchema] of Object.entries(obj.shape)) {
+        const { unwrapped, optional } = unwrapZod(fieldSchema);
+        const opt = optional ? " (optional)" : " (required)";
+        const desc = fieldSchema.description ? ` — ${fieldSchema.description}` : "";
+        if (unwrapped instanceof zod_1.ZodString) {
+            lines.push(`${indent}"${key}": string${opt}${desc}`);
+        }
+        else if (unwrapped instanceof zod_1.ZodNumber) {
+            lines.push(`${indent}"${key}": number${opt}${desc}`);
+        }
+        else if (unwrapped instanceof zod_1.ZodBoolean) {
+            lines.push(`${indent}"${key}": boolean${opt}${desc}`);
+        }
+        else if (unwrapped instanceof zod_1.ZodEnum) {
+            const vals = unwrapped._def.values.join(" | ");
+            lines.push(`${indent}"${key}": ${vals}${opt}${desc}`);
+        }
+        else if (unwrapped instanceof zod_1.ZodArray) {
+            lines.push(`${indent}"${key}": array${opt}${desc}`);
+        }
+        else if (unwrapped instanceof zod_1.ZodObject) {
+            lines.push(`${indent}"${key}": {${opt}${desc}`);
+            describeObjectFields(unwrapped, lines, depth + 1);
+            lines.push(`${indent}}`);
+        }
+        else {
+            lines.push(`${indent}"${key}": any${opt}${desc}`);
+        }
+    }
+}
+/**
+ * Generate a human-readable JSON schema description from a Zod schema.
+ * Appended to the user prompt so the LLM knows what fields to produce.
+ */
+function describeZodSchema(schema) {
+    let inner = schema;
+    while (inner instanceof zod_1.ZodEffects)
+        inner = inner._def.schema;
+    if (!(inner instanceof zod_1.ZodObject))
+        return "";
+    const lines = ["You MUST respond with a JSON object containing these exact fields:"];
+    describeObjectFields(inner, lines, 0);
+    return lines.join("\n");
+}
+/**
+ * Convert a Zod schema to a minimal JSON Schema representation
+ * for providers that support structured output via responseSchema.
+ */
+function zodToJsonSchema(schema) {
+    let inner = schema;
+    while (inner instanceof zod_1.ZodEffects || inner instanceof zod_1.ZodOptional || inner instanceof zod_1.ZodNullable || inner instanceof zod_1.ZodDefault) {
+        if (inner instanceof zod_1.ZodEffects)
+            inner = inner._def.schema;
+        else
+            inner = inner._def.innerType;
+    }
+    if (!(inner instanceof zod_1.ZodObject))
+        return undefined;
+    const buildProperties = (obj) => {
+        const props = {};
+        for (const [key, fs] of Object.entries(obj.shape)) {
+            const { unwrapped } = unwrapZod(fs);
+            if (unwrapped instanceof zod_1.ZodString)
+                props[key] = { type: "string" };
+            else if (unwrapped instanceof zod_1.ZodNumber)
+                props[key] = { type: "number" };
+            else if (unwrapped instanceof zod_1.ZodBoolean)
+                props[key] = { type: "boolean" };
+            else if (unwrapped instanceof zod_1.ZodEnum)
+                props[key] = { type: "string", enum: unwrapped._def.values };
+            else if (unwrapped instanceof zod_1.ZodArray)
+                props[key] = { type: "array" };
+            else if (unwrapped instanceof zod_1.ZodObject)
+                props[key] = { type: "object", properties: buildProperties(unwrapped) };
+            else
+                props[key] = {};
+        }
+        return props;
+    };
+    return {
+        type: "object",
+        properties: buildProperties(inner),
+    };
+}
+//# sourceMappingURL=structured-call.js.map

package/dist/libs/structured-call.js.map

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

package/dist/libs/subagent-executor.class.d.ts

@@ -0,0 +1,127 @@
+import { SubAgent } from "../contracts/subagent.types";
+import { ServerConcurrencyPool } from "./server-concurrency-pool";
+/**
+ * Task represents a unit of work delegated to a subagent.
+ * Extends the basic subagent conversation with structured task semantics.
+ */
+export interface Task {
+    /** Unique task identifier */
+    id: string;
+    /** Task prompt/description */
+    prompt: string;
+    /** Task status: pending, running, completed, failed, cancelled */
+    status: "pending" | "running" | "completed" | "failed" | "cancelled";
+    /** Task output (if completed) */
+    output?: string;
+    /** Error message (if failed) */
+    error?: string;
+    /** Task execution start time (ISO string) */
+    startedAt?: string;
+    /** Task execution end time (ISO string) */
+    completedAt?: string;
+    /** Optional task metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * SubAgentTask represents the contract for delegating work to a subagent.
+ * Provides structured interface for synchronous subagent execution.
+ */
+export interface SubAgentTask {
+    /** The subagent to execute */
+    subagent: SubAgent;
+    /** The task to execute */
+    task: Task;
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Retry configuration */
+    retryConfig?: {
+        maxRetries: number;
+        backoffMs: number;
+        retryableErrors?: string[];
+    };
+}
+/**
+ * Result of subagent task execution
+ */
+export interface SubAgentTaskResult {
+    /** Task that was executed */
+    task: Task;
+    /** Whether execution was successful */
+    success: boolean;
+    /** Formatted output message */
+    message: string;
+    /** Execution duration in milliseconds */
+    durationMs: number;
+    /** Number of retries needed */
+    retriesUsed: number;
+}
+export interface SubAgentExecutorConfig {
+    debug?: boolean;
+    /** Per-server concurrency throttle. When set, active subagent
+     *  executions to the same baseUrl are limited by the server's
+     *  maxConcurrency. */
+    concurrencyPool?: ServerConcurrencyPool;
+}
+/**
+ * SubAgentExecutor manages synchronous execution of tasks on subagents.
+ * Provides timeout, retry, and error handling.
+ */
+export declare class SubAgentExecutor {
+    private taskCache;
+    private debug;
+    private readonly concurrencyPool?;
+    constructor(config?: SubAgentExecutorConfig);
+    /**
+     * Execute a task on a subagent synchronously
+     */
+    execute(taskDef: SubAgentTask): Promise<SubAgentTaskResult>;
+    /**
+     * Execute task with timeout protection
+     */
+    private executeWithTimeout;
+    /**
+     * Create a conversation instance for a subagent
+     */
+    private createSubagentConversation;
+    /**
+     * Check if error is retryable
+     */
+    private isRetryable;
+    /**
+     * Cancel a running task
+     */
+    cancelTask(taskId: string): boolean;
+    /**
+     * Get task by ID
+     */
+    getTask(taskId: string): Task | undefined;
+    /**
+     * List all tasks
+     */
+    listTasks(filter?: {
+        status?: Task["status"];
+    }): Task[];
+    /**
+     * Clear task history
+     */
+    clearTasks(): void;
+    /**
+     * Generate unique task ID
+     */
+    private generateTaskId;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+    /**
+     * Get task cache statistics
+     */
+    getStats(): {
+        totalTasks: number;
+        pendingTasks: number;
+        completedTasks: number;
+        failedTasks: number;
+        cancelledTasks: number;
+    };
+}
+//# sourceMappingURL=subagent-executor.class.d.ts.map

package/dist/libs/subagent-executor.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-executor.class.d.ts","sourceRoot":"","sources":["../../src/libs/subagent-executor.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAGvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IAEX,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IAEf,kEAAkE;IAClE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAErE,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IAEnB,0BAA0B;IAC1B,IAAI,EAAE,IAAI,CAAC;IAEX,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,0BAA0B;IAC1B,WAAW,CAAC,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,IAAI,EAAE,IAAI,CAAC;IAEX,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;0BAEsB;IACtB,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAwB;gBAE7C,MAAM,GAAE,sBAA2B;IAK/C;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkGjE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;YACW,0BAA0B;IAexC;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAcnC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIzC;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;KAAE,GAAG,IAAI,EAAE;IAQvD;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,QAAQ,IAAI;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB;CAUF"}

package/dist/libs/subagent-executor.class.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubAgentExecutor = void 0;
+const conversation_class_1 = require("../conversation.class");
+/**
+ * SubAgentExecutor manages synchronous execution of tasks on subagents.
+ * Provides timeout, retry, and error handling.
+ */
+class SubAgentExecutor {
+    taskCache = new Map();
+    debug;
+    concurrencyPool;
+    constructor(config = {}) {
+        this.debug = config.debug ?? false;
+        this.concurrencyPool = config.concurrencyPool;
+    }
+    /**
+     * Execute a task on a subagent synchronously
+     */
+    async execute(taskDef) {
+        const startTime = Date.now();
+        let retriesUsed = 0;
+        let lastError = null;
+        const { subagent, task, timeout = 30000, retryConfig } = taskDef;
+        // Validate inputs
+        if (!subagent || !task) {
+            throw new Error("SubAgentExecutor: subagent and task are required");
+        }
+        // Initialize task
+        const executingTask = {
+            ...task,
+            id: task.id || this.generateTaskId(),
+            status: "running",
+            startedAt: new Date().toISOString(),
+        };
+        this.taskCache.set(executingTask.id, executingTask);
+        // Main execution loop with retry
+        const maxRetries = retryConfig?.maxRetries ?? 1;
+        const backoffMs = retryConfig?.backoffMs ?? 1000;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            if (attempt > 0) {
+                // Backoff before retry
+                await this.sleep(backoffMs * Math.pow(2, attempt - 1));
+                retriesUsed++;
+                if (this.debug) {
+                    console.error(`[SubAgentExecutor] Retrying task ${executingTask.id} (attempt ${attempt + 1})`);
+                }
+            }
+            try {
+                // Create subagent conversation
+                const subagentConversation = await this.createSubagentConversation(subagent);
+                // Execute with timeout (throttled per-server when pool is configured)
+                const conn = subagent.connection;
+                const baseUrl = conn?.baseUrl;
+                const executeTask = () => this.executeWithTimeout(subagentConversation, executingTask.prompt, timeout);
+                const output = baseUrl && this.concurrencyPool
+                    ? await this.concurrencyPool.runWithThrottle(baseUrl, executeTask)
+                    : await executeTask();
+                // Mark as completed
+                executingTask.status = "completed";
+                executingTask.output = output;
+                executingTask.completedAt = new Date().toISOString();
+                this.taskCache.set(executingTask.id, executingTask);
+                const durationMs = Date.now() - startTime;
+                return {
+                    task: executingTask,
+                    success: true,
+                    message: output,
+                    durationMs,
+                    retriesUsed,
+                };
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                // Check if error is retryable
+                if (!this.isRetryable(lastError, retryConfig)) {
+                    break; // Don't retry if error is not retryable
+                }
+                if (this.debug) {
+                    console.error(`[SubAgentExecutor] Attempt ${attempt + 1} failed: ${lastError.message}`);
+                }
+            }
+        }
+        // All retries exhausted - mark as failed
+        executingTask.status = "failed";
+        executingTask.error = lastError?.message || "Unknown error";
+        executingTask.completedAt = new Date().toISOString();
+        this.taskCache.set(executingTask.id, executingTask);
+        const durationMs = Date.now() - startTime;
+        return {
+            task: executingTask,
+            success: false,
+            message: `Task failed after ${retriesUsed + 1} attempts: ${executingTask.error}`,
+            durationMs,
+            retriesUsed,
+        };
+    }
+    /**
+     * Execute task with timeout protection
+     */
+    executeWithTimeout(conversation, prompt, timeoutMs) {
+        return Promise.race([
+            conversation.sendPrompt(prompt).then((result) => result.output),
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`Task execution timeout (${timeoutMs}ms)`)), timeoutMs)),
+        ]);
+    }
+    /**
+     * Create a conversation instance for a subagent
+     */
+    async createSubagentConversation(subagent) {
+        // This will be fully implemented in next iterations
+        // For now, create a minimal config
+        const config = {
+            model: subagent.model || "llama2:latest",
+            systemPrompt: subagent.systemPrompt,
+            tools: subagent.tools,
+            skills: subagent.skills,
+            middleware: subagent.middleware,
+            debugLevel: "off",
+        };
+        return new conversation_class_1.Conversation(config);
+    }
+    /**
+     * Check if error is retryable
+     */
+    isRetryable(error, retryConfig) {
+        const retryableErrors = retryConfig?.retryableErrors || [
+            "TIMEOUT",
+            "ECONNREFUSED",
+            "ENOTFOUND",
+            "timeout",
+            "connection",
+            "network",
+        ];
+        const errorMsg = error.message.toUpperCase();
+        return retryableErrors.some((pattern) => errorMsg.includes(pattern.toUpperCase()));
+    }
+    /**
+     * Cancel a running task
+     */
+    cancelTask(taskId) {
+        const task = this.taskCache.get(taskId);
+        if (!task)
+            return false;
+        if (task.status === "running") {
+            task.status = "cancelled";
+            task.completedAt = new Date().toISOString();
+            this.taskCache.set(taskId, task);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get task by ID
+     */
+    getTask(taskId) {
+        return this.taskCache.get(taskId);
+    }
+    /**
+     * List all tasks
+     */
+    listTasks(filter) {
+        const tasks = Array.from(this.taskCache.values());
+        if (filter?.status) {
+            return tasks.filter((t) => t.status === filter.status);
+        }
+        return tasks;
+    }
+    /**
+     * Clear task history
+     */
+    clearTasks() {
+        this.taskCache.clear();
+    }
+    /**
+     * Generate unique task ID
+     */
+    generateTaskId() {
+        return `task_${Date.now()}_${Math.random().toString(36).substring(7)}`;
+    }
+    /**
+     * Sleep utility
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Get task cache statistics
+     */
+    getStats() {
+        const tasks = Array.from(this.taskCache.values());
+        return {
+            totalTasks: tasks.length,
+            pendingTasks: tasks.filter((t) => t.status === "pending").length,
+            completedTasks: tasks.filter((t) => t.status === "completed").length,
+            failedTasks: tasks.filter((t) => t.status === "failed").length,
+            cancelledTasks: tasks.filter((t) => t.status === "cancelled").length,
+        };
+    }
+}
+exports.SubAgentExecutor = SubAgentExecutor;
+//# sourceMappingURL=subagent-executor.class.js.map

package/dist/libs/subagent-executor.class.js.map

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