@thoughtflow/core 0.1.2

package/dist/libs/subagent-job-manager.d.ts

@@ -0,0 +1,27 @@
+import { SubAgent, SubAgentJob, SubAgentJobManagerConfig, SubAgentJobResult, SubAgentJobSpawnOptions, SubAgentJobStatus, SubAgentJobStore } from "../contracts/subagent.types";
+export declare class SubAgentJobManager {
+    private readonly store;
+    private readonly defaultTimeoutMs;
+    private readonly maxConcurrentJobs;
+    private readonly concurrencyPool?;
+    private readonly onStatusChange?;
+    private readonly onProgress?;
+    private readonly onLog?;
+    private activeCount;
+    private readonly runningControllers;
+    constructor(config?: SubAgentJobManagerConfig);
+    spawn(subagent: SubAgent, prompt: string, options?: SubAgentJobSpawnOptions): Promise<{
+        jobId: string;
+    }>;
+    status(jobId: string): Promise<SubAgentJob | undefined>;
+    list(filter?: {
+        status?: SubAgentJobStatus | SubAgentJobStatus[];
+        subagentName?: string;
+    }): Promise<SubAgentJob[]>;
+    await(jobId: string, timeoutMs?: number): Promise<SubAgentJobResult>;
+    cancel(jobId: string): Promise<boolean>;
+    getStore(): SubAgentJobStore;
+    private runJob;
+    private pollUntilComplete;
+}
+//# sourceMappingURL=subagent-job-manager.d.ts.map

package/dist/libs/subagent-job-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-job-manager.d.ts","sourceRoot":"","sources":["../../src/libs/subagent-job-manager.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EACR,WAAW,EACX,wBAAwB,EAExB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAQrC,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAwB;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA6C;IAC7E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAyC;IACrE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAoC;IAC3D,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2C;gBAElE,MAAM,GAAE,wBAA6B;IAU3C,KAAK,CACT,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAuCvB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAIvD,IAAI,CAAC,MAAM,CAAC,EAAE;QAClB,MAAM,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,CAAC;QACjD,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIpB,KAAK,CACT,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAgBvB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB7C,QAAQ,IAAI,gBAAgB;YAId,MAAM;YAyJN,iBAAiB;CA8BhC"}

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

@@ -0,0 +1,254 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubAgentJobManager = void 0;
+const crypto_1 = require("crypto");
+const in_memory_job_store_1 = require("./in-memory-job-store");
+const conversation_class_1 = require("../conversation.class");
+const adapter_factory_1 = require("../adapters/llm/adapter-factory");
+class SubAgentJobManager {
+    store;
+    defaultTimeoutMs;
+    maxConcurrentJobs;
+    concurrencyPool;
+    onStatusChange;
+    onProgress;
+    onLog;
+    activeCount = 0;
+    runningControllers = new Map();
+    constructor(config = {}) {
+        this.store = config.store ?? new in_memory_job_store_1.InMemoryJobStore();
+        this.defaultTimeoutMs = config.defaultTimeoutMs ?? 300_000;
+        this.maxConcurrentJobs = config.maxConcurrentJobs ?? 10;
+        this.concurrencyPool = config.concurrencyPool;
+        this.onStatusChange = config.onStatusChange;
+        this.onProgress = config.onProgress;
+        this.onLog = config.onLog;
+    }
+    async spawn(subagent, prompt, options = {}) {
+        if (this.activeCount >= this.maxConcurrentJobs) {
+            throw new Error(`SubAgentJobManager: max concurrent jobs (${this.maxConcurrentJobs}) reached`);
+        }
+        const jobId = `job_${(0, crypto_1.randomUUID)().slice(0, 8)}`;
+        const now = new Date().toISOString();
+        const timeoutMs = options.timeoutMs ?? this.defaultTimeoutMs;
+        const job = {
+            jobId,
+            subagentName: subagent.name,
+            prompt,
+            status: "preparing",
+            createdAt: now,
+            progress: { toolsCalled: 0, tokensUsed: 0 },
+            metadata: options.metadata,
+        };
+        await this.store.save(job);
+        this.activeCount++;
+        const abortController = new AbortController();
+        this.runningControllers.set(jobId, abortController);
+        const signal = options.signal
+            ? anySignal([options.signal, abortController.signal])
+            : abortController.signal;
+        this.runJob(jobId, subagent, prompt, timeoutMs, signal).finally(() => {
+            this.runningControllers.delete(jobId);
+            this.activeCount--;
+        });
+        return { jobId };
+    }
+    async status(jobId) {
+        return this.store.get(jobId);
+    }
+    async list(filter) {
+        return this.store.list(filter);
+    }
+    async await(jobId, timeoutMs) {
+        const effectiveTimeout = timeoutMs ?? 60_000;
+        const result = await Promise.race([
+            this.pollUntilComplete(jobId, effectiveTimeout),
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`Await job ${jobId} timed out after ${effectiveTimeout}ms`)), effectiveTimeout)),
+        ]);
+        return result;
+    }
+    async cancel(jobId) {
+        const controller = this.runningControllers.get(jobId);
+        if (!controller) {
+            const job = await this.store.get(jobId);
+            if (job && (job.status === "running" || job.status === "preparing")) {
+                job.status = "cancelled";
+                job.completedAt = new Date().toISOString();
+                await this.store.save(job);
+                return true;
+            }
+            return false;
+        }
+        controller.abort();
+        return true;
+    }
+    getStore() {
+        return this.store;
+    }
+    async runJob(jobId, subagent, prompt, timeoutMs, signal) {
+        const startTime = Date.now();
+        const toolExecutions = [];
+        let tokensUsed = 0;
+        const updateProgress = async (partial) => {
+            const job = await this.store.get(jobId);
+            if (!job)
+                return;
+            job.progress = { ...job.progress, ...partial, updatedAt: new Date().toISOString() };
+            await this.store.save(job);
+            this.onProgress?.(jobId, subagent.name, job.progress);
+            if (partial.lastTool || partial.partialOutput) {
+                this.onLog?.(jobId, subagent.name, partial.partialOutput ?? `⚙ ${partial.lastTool ?? ""}`);
+            }
+        };
+        try {
+            const job = await this.store.get(jobId);
+            if (!job)
+                return;
+            job.status = "running";
+            job.startedAt = new Date().toISOString();
+            await this.store.save(job);
+            this.onStatusChange?.(jobId, subagent.name, "running");
+            this.onLog?.(jobId, subagent.name, `Subagent "${subagent.name}" started — ${prompt.slice(0, 100)}`);
+            const conn = subagent.connection;
+            const llmAdapter = conn?.baseUrl
+                ? adapter_factory_1.LlmAdapterFactory.create({ type: conn.provider ?? "openai", baseUrl: conn.baseUrl, apiKey: conn.apiKey ?? "none" })
+                : undefined;
+            const config = {
+                llmAdapter,
+                model: subagent.model,
+                baseUrl: conn?.baseUrl,
+                systemPrompt: subagent.systemPrompt,
+                tools: subagent.tools,
+                skills: subagent.skills,
+                middleware: subagent.middleware,
+                metadata: { jobId },
+                onToolEvent: (trace) => {
+                    toolExecutions.push(trace);
+                    updateProgress({
+                        toolsCalled: toolExecutions.length,
+                        lastTool: trace.toolName,
+                        partialOutput: trace.output?.slice(0, 500),
+                    });
+                },
+                debugLevel: "off",
+            };
+            const conversation = new conversation_class_1.Conversation(config);
+            try {
+                const baseUrl = conn?.baseUrl;
+                const executeJob = () => Promise.race([
+                    conversation.sendPrompt(prompt, { signal }),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error(`Job ${jobId} execution timed out after ${timeoutMs}ms`)), timeoutMs)),
+                ]);
+                const result = baseUrl && this.concurrencyPool
+                    ? await this.concurrencyPool.runWithThrottle(baseUrl, executeJob)
+                    : await executeJob();
+                tokensUsed = result.tokensInput + result.tokensOutput;
+                /* Extract key messages from subagent conversation */
+                const allMessages = result.messages ?? [];
+                const keyMessages = allMessages
+                    .filter((m) => m.role !== "system")
+                    .slice(-8)
+                    .map((m) => ({
+                    role: m.role,
+                    content: typeof m.content === "string" ? m.content.slice(0, 500) : "",
+                    toolCall: m.toolCalls?.[0] ? { name: m.toolCalls[0].name ?? m.toolCalls[0].function?.name, args: m.toolCalls[0].arguments ?? m.toolCalls[0].function?.arguments } : undefined,
+                }));
+                const jobResult = {
+                    success: true,
+                    output: result.output,
+                    durationMs: Date.now() - startTime,
+                    toolExecutions: toolExecutions.length,
+                    tokensUsed,
+                    messages: keyMessages.length > 0 ? keyMessages : undefined,
+                };
+                await updateProgress({
+                    toolsCalled: toolExecutions.length,
+                    tokensUsed,
+                    partialOutput: undefined,
+                });
+                const finalJob = await this.store.get(jobId);
+                if (finalJob) {
+                    finalJob.status = "completed";
+                    finalJob.completedAt = new Date().toISOString();
+                    finalJob.result = jobResult;
+                    finalJob.progress.tokensUsed = tokensUsed;
+                    await this.store.save(finalJob);
+                    this.onStatusChange?.(jobId, subagent.name, "completed");
+                    this.onLog?.(jobId, subagent.name, `✅ Subagent "${subagent.name}" completed (${jobResult.durationMs}ms, ${tokensUsed} tokens)`);
+                }
+            }
+            catch (error) {
+                if (signal.aborted) {
+                    const cancelJob = await this.store.get(jobId);
+                    if (cancelJob) {
+                        cancelJob.status = "cancelled";
+                        cancelJob.completedAt = new Date().toISOString();
+                        await this.store.save(cancelJob);
+                        this.onStatusChange?.(jobId, subagent.name, "cancelled");
+                    }
+                    return;
+                }
+                throw error;
+            }
+            finally {
+                conversation.dispose();
+            }
+        }
+        catch (error) {
+            const failJob = await this.store.get(jobId);
+            if (failJob && failJob.status !== "cancelled") {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                failJob.status = "failed";
+                failJob.error = errorMsg;
+                failJob.completedAt = new Date().toISOString();
+                failJob.result = {
+                    success: false,
+                    error: errorMsg,
+                    durationMs: Date.now() - startTime,
+                    toolExecutions: toolExecutions.length,
+                    tokensUsed,
+                };
+                failJob.progress.tokensUsed = tokensUsed;
+                await this.store.save(failJob);
+                this.onStatusChange?.(jobId, subagent.name, "failed", errorMsg);
+                this.onLog?.(jobId, subagent.name, `❌ Subagent "${subagent.name}" failed: ${errorMsg}`);
+            }
+        }
+    }
+    async pollUntilComplete(jobId, timeoutMs) {
+        const start = Date.now();
+        const pollInterval = 200;
+        while (Date.now() - start < timeoutMs) {
+            const job = await this.store.get(jobId);
+            if (!job) {
+                throw new Error(`Job ${jobId} not found`);
+            }
+            if (job.status === "completed" || job.status === "failed" || job.status === "cancelled") {
+                if (job.result)
+                    return job.result;
+                return {
+                    success: false,
+                    error: job.error ?? "No result",
+                    durationMs: job.startedAt ? Date.now() - new Date(job.startedAt).getTime() : 0,
+                    toolExecutions: job.progress.toolsCalled,
+                    tokensUsed: job.progress.tokensUsed,
+                };
+            }
+            await new Promise((r) => setTimeout(r, pollInterval));
+        }
+        throw new Error(`Await job ${jobId} timed out after ${timeoutMs}ms`);
+    }
+}
+exports.SubAgentJobManager = SubAgentJobManager;
+function anySignal(signals) {
+    const controller = new AbortController();
+    for (const signal of signals) {
+        if (signal.aborted) {
+            controller.abort(signal.reason);
+            return controller.signal;
+        }
+        signal.addEventListener("abort", () => controller.abort(signal.reason), { once: true });
+    }
+    return controller.signal;
+}
+//# sourceMappingURL=subagent-job-manager.js.map

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

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

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

@@ -0,0 +1,90 @@
+import { SubAgent } from "../contracts/subagent.types";
+/**
+ * SubAgentRegistry manages a collection of subagents with lookup, validation, and lifecycle support.
+ *
+ * Usage:
+ *   const registry = new SubAgentRegistry();
+ *   registry.register(dataAnalystAgent);
+ *   registry.register(codeWriterAgent);
+ *   const agent = registry.get("dataAnalyst");
+ *   const all = registry.getAll();
+ */
+export declare class SubAgentRegistry {
+    private agents;
+    private logger;
+    constructor(debug?: boolean);
+    /**
+     * Register a subagent in the registry
+     * Validates that the subagent has required fields (name, description, systemPrompt)
+     */
+    register(agent: SubAgent): void;
+    /**
+     * Register multiple subagents
+     */
+    registerBatch(agents: SubAgent[]): void;
+    /**
+     * Get a subagent by name
+     */
+    get(name: string): SubAgent | undefined;
+    /**
+     * Get a subagent by name, with error handling
+     */
+    getOrThrow(name: string): SubAgent;
+    /**
+     * Get all registered subagents
+     */
+    getAll(): SubAgent[];
+    /**
+     * Get subagents by tool requirement
+     * Returns subagents that have access to the specified tool
+     */
+    getByToolName(toolName: string): SubAgent[];
+    /**
+     * Get subagents by metadata filter
+     * Example: registry.getByMetadata({ team: "backend" })
+     */
+    getByMetadata(filter: Record<string, unknown>): SubAgent[];
+    /**
+     * Check if a subagent is registered
+     */
+    has(name: string): boolean;
+    /**
+     * Unregister a subagent
+     */
+    unregister(name: string): boolean;
+    /**
+     * Remove all subagents from the registry
+     */
+    clear(): void;
+    /**
+     * Get the number of registered subagents
+     */
+    size(): number;
+    /**
+     * Validate a subagent structure
+     */
+    private validateSubAgent;
+    /**
+     * Get detailed information about a subagent
+     */
+    getInfo(name: string): SubAgentInfo | null;
+    /**
+     * List all subagents with brief info
+     */
+    list(): SubAgentInfo[];
+}
+/**
+ * Brief information about a registered subagent
+ */
+export interface SubAgentInfo {
+    name: string;
+    description: string;
+    toolsCount: number;
+    toolNames: string[];
+    hasMiddleware: boolean;
+    hasSkills: boolean;
+    hasInterruptConfig: boolean;
+    model?: string;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=subagent-registry.class.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-registry.class.d.ts","sourceRoot":"","sources":["../../src/libs/subagent-registry.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoB,MAAM,6BAA6B,CAAC;AAGzE;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,MAAM,CAAc;gBAEhB,KAAK,UAAQ;IAIzB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAe/B;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI;IAOvC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAUlC;;OAEG;IACH,MAAM,IAAI,QAAQ,EAAE;IAIpB;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE;IAM3C;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,EAAE;IAY1D;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8CxB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAiB1C;;OAEG;IACH,IAAI,IAAI,YAAY,EAAE;CAKvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

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

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubAgentRegistry = void 0;
+const debug_logger_class_1 = require("./debug-logger.class");
+/**
+ * SubAgentRegistry manages a collection of subagents with lookup, validation, and lifecycle support.
+ *
+ * Usage:
+ *   const registry = new SubAgentRegistry();
+ *   registry.register(dataAnalystAgent);
+ *   registry.register(codeWriterAgent);
+ *   const agent = registry.get("dataAnalyst");
+ *   const all = registry.getAll();
+ */
+class SubAgentRegistry {
+    agents = new Map();
+    logger;
+    constructor(debug = false) {
+        this.logger = new debug_logger_class_1.DebugLogger(debug ? "info" : "off");
+    }
+    /**
+     * Register a subagent in the registry
+     * Validates that the subagent has required fields (name, description, systemPrompt)
+     */
+    register(agent) {
+        // Validate required fields
+        this.validateSubAgent(agent);
+        if (this.agents.has(agent.name)) {
+            this.logger.info("SubAgentRegistry", `Overwriting existing subagent: ${agent.name}`);
+        }
+        this.agents.set(agent.name, agent);
+        this.logger.info("SubAgentRegistry", `Registered subagent: ${agent.name} (tools: ${agent.tools.length})`);
+    }
+    /**
+     * Register multiple subagents
+     */
+    registerBatch(agents) {
+        for (const agent of agents) {
+            this.register(agent);
+        }
+        this.logger.info("SubAgentRegistry", `Registered ${agents.length} subagents`);
+    }
+    /**
+     * Get a subagent by name
+     */
+    get(name) {
+        return this.agents.get(name);
+    }
+    /**
+     * Get a subagent by name, with error handling
+     */
+    getOrThrow(name) {
+        const agent = this.agents.get(name);
+        if (!agent) {
+            throw new Error(`SubAgent not found: ${name}. Available: ${Array.from(this.agents.keys()).join(", ")}`);
+        }
+        return agent;
+    }
+    /**
+     * Get all registered subagents
+     */
+    getAll() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Get subagents by tool requirement
+     * Returns subagents that have access to the specified tool
+     */
+    getByToolName(toolName) {
+        return this.getAll().filter((agent) => agent.tools.some((tool) => tool.name === toolName));
+    }
+    /**
+     * Get subagents by metadata filter
+     * Example: registry.getByMetadata({ team: "backend" })
+     */
+    getByMetadata(filter) {
+        return this.getAll().filter((agent) => {
+            if (!agent.metadata)
+                return false;
+            for (const [key, value] of Object.entries(filter)) {
+                if (agent.metadata[key] !== value) {
+                    return false;
+                }
+            }
+            return true;
+        });
+    }
+    /**
+     * Check if a subagent is registered
+     */
+    has(name) {
+        return this.agents.has(name);
+    }
+    /**
+     * Unregister a subagent
+     */
+    unregister(name) {
+        const deleted = this.agents.delete(name);
+        if (deleted) {
+            this.logger.info("SubAgentRegistry", `Unregistered subagent: ${name}`);
+        }
+        return deleted;
+    }
+    /**
+     * Remove all subagents from the registry
+     */
+    clear() {
+        this.agents.clear();
+        this.logger.info("SubAgentRegistry", "Registry cleared");
+    }
+    /**
+     * Get the number of registered subagents
+     */
+    size() {
+        return this.agents.size;
+    }
+    /**
+     * Validate a subagent structure
+     */
+    validateSubAgent(agent) {
+        if (!agent.name || typeof agent.name !== "string") {
+            throw new Error("SubAgent validation failed: name is required and must be a string");
+        }
+        if (!agent.description || typeof agent.description !== "string") {
+            throw new Error("SubAgent validation failed: description is required and must be a string");
+        }
+        if (!agent.systemPrompt || typeof agent.systemPrompt !== "string") {
+            throw new Error("SubAgent validation failed: systemPrompt is required and must be a string");
+        }
+        if (!Array.isArray(agent.tools)) {
+            throw new Error("SubAgent validation failed: tools must be an array");
+        }
+        // Validate interrupt configuration if present
+        if (agent.interruptOn) {
+            if (agent.interruptOn.riskLevel &&
+                !["high", "medium"].includes(agent.interruptOn.riskLevel)) {
+                throw new Error("SubAgent validation failed: interruptOn.riskLevel must be 'high' or 'medium'");
+            }
+        }
+        // Validate model params if present
+        if (agent.modelParams) {
+            const { temperature, topP, topK } = agent.modelParams;
+            if (temperature !== undefined && (temperature < 0 || temperature > 2)) {
+                throw new Error("SubAgent validation failed: temperature must be between 0 and 2");
+            }
+            if (topP !== undefined && (topP < 0 || topP > 1)) {
+                throw new Error("SubAgent validation failed: topP must be between 0 and 1");
+            }
+            if (topK !== undefined && topK < 0) {
+                throw new Error("SubAgent validation failed: topK must be non-negative");
+            }
+        }
+    }
+    /**
+     * Get detailed information about a subagent
+     */
+    getInfo(name) {
+        const agent = this.agents.get(name);
+        if (!agent)
+            return null;
+        return {
+            name: agent.name,
+            description: agent.description,
+            toolsCount: agent.tools.length,
+            toolNames: agent.tools.map((t) => t.name),
+            hasMiddleware: !!agent.middleware && agent.middleware.length > 0,
+            hasSkills: !!agent.skills && agent.skills.length > 0,
+            hasInterruptConfig: !!agent.interruptOn,
+            model: agent.model,
+            metadata: agent.metadata,
+        };
+    }
+    /**
+     * List all subagents with brief info
+     */
+    list() {
+        return Array.from(this.agents.keys())
+            .map((name) => this.getInfo(name))
+            .filter((info) => info !== null);
+    }
+}
+exports.SubAgentRegistry = SubAgentRegistry;
+//# sourceMappingURL=subagent-registry.class.js.map

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

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

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

@@ -0,0 +1,67 @@
+import { SubAgent, SubAgentRouterConfig, IntentClassificationResult } from "../contracts/subagent.types";
+/**
+ * SubAgentRouter provides intelligent intent-based routing to specialized subagents.
+ * It classifies user intents and routes execution to the most appropriate subagent.
+ *
+ * Usage:
+ *   const router = new SubAgentRouter({ routes, defaultSubagent });
+ *   const result = await router.route("user prompt");
+ *   // result.routeTo contains the target subagent
+ */
+export declare class SubAgentRouter {
+    private readonly logger;
+    private readonly routes;
+    private readonly defaultSubagent;
+    private readonly confidenceThreshold;
+    private readonly debug;
+    private intentCache;
+    constructor(config: SubAgentRouterConfig);
+    /**
+     * Route a prompt to the appropriate subagent based on intent classification
+     */
+    route(input: string): Promise<IntentClassificationResult>;
+    /**
+     * Classify intent using heuristic matching or LLM
+     */
+    private classifyIntent;
+    /**
+     * Classify intent by checking keywords associated with each route
+     */
+    private classifyByKeywords;
+    /**
+     * Extract keywords from intent name and description
+     */
+    private extractKeywords;
+    /**
+     * Check if word is a common stopword
+     */
+    private isStopword;
+    /**
+     * Clear the intent cache
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        cacheHits?: number;
+    };
+    /**
+     * Register a new route dynamically
+     */
+    registerRoute(intent: string, subagent: SubAgent): void;
+    /**
+     * Unregister a route
+     */
+    unregisterRoute(intent: string): void;
+    /**
+     * Hash input for cache key generation
+     */
+    private hashIntent;
+    /**
+     * Get all registered routes
+     */
+    getRoutes(): Map<string, SubAgent>;
+}
+//# sourceMappingURL=subagent-router.class.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-router.class.d.ts","sourceRoot":"","sources":["../../src/libs/subagent-router.class.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,6BAA6B,CAAC;AAGrC;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAW;IAC3C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,WAAW,CAAsD;gBAE7D,MAAM,EAAE,oBAAoB;IAYxC;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IA0B/D;;OAEG;YACW,cAAc;IAe5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+C1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,UAAU;IAuBlB;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAIrD;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAMvD;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMrC;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC;CAGnC"}