@ai.ntellect/core 1.0.0 → 1.1.1

package/dist/agent/llm-factory.js

@@ -0,0 +1,297 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMFactory = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const openai_1 = require("@ai-sdk/openai");
+const ai_1 = require("ai");
+const DEFAULT_GROQ_MODEL = "llama-3.1-8b-instant";
+const GROQ_FALLBACK_MODELS = [
+    "allam-2-7b",
+    "groq/compound-mini",
+    "groq/compound",
+    "qwen/qwen3-32b",
+    "llama-3.3-70b-versatile",
+    "meta-llama/llama-4-scout-17b-16e-instruct",
+];
+const DEFAULT_FALLBACK_MODEL = "llama-3.1-8b-instant";
+function createOpenAICompatibleLLM(baseUrl, apiKey, model, providerName) {
+    return {
+        generate: (prompt, schema) => __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e;
+            const t0 = performance.now();
+            const userPrompt = typeof prompt === "string" ? prompt : prompt.user;
+            const systemPrompt = typeof prompt === "string" ? undefined : prompt.system;
+            const response = yield fetch(`${baseUrl}/chat/completions`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: model,
+                    messages: [
+                        ...(systemPrompt ? [{ role: "system", content: systemPrompt }] : []),
+                        { role: "user", content: userPrompt },
+                    ],
+                    temperature: 0.7,
+                    max_tokens: 4096,
+                    response_format: { type: "json_object" },
+                }),
+            });
+            if (!response.ok) {
+                const errorText = yield response.text();
+                throw new Error(`${providerName} API error (${response.status}): ${errorText}`);
+            }
+            const data = yield response.json();
+            const duration = performance.now() - t0;
+            const usage = data.usage
+                ? { promptTokens: (_a = data.usage.prompt_tokens) !== null && _a !== void 0 ? _a : 0, completionTokens: (_b = data.usage.completion_tokens) !== null && _b !== void 0 ? _b : 0 }
+                : undefined;
+            let content = ((_e = (_d = (_c = data.choices) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.message) === null || _e === void 0 ? void 0 : _e.content) || "";
+            try {
+                const parsed = JSON.parse(content);
+                const validated = schema.parse(parsed);
+                return { object: validated, usage, duration };
+            }
+            catch (e) {
+                console.log(chalk_1.default.yellow(`[WARN] ${providerName} JSON parse error: ${e.message}`));
+                return { object: { actions: [], response: content.substring(0, 200) }, usage, duration };
+            }
+        }),
+    };
+}
+function createLLMWithFallback(baseUrl, apiKey, primaryModel, fallbackModels, providerName) {
+    const allModels = [primaryModel, ...fallbackModels];
+    let currentModelIndex = 0;
+    return {
+        generate: (prompt, schema) => __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e;
+            let lastError = null;
+            for (const model of allModels.slice(currentModelIndex)) {
+                try {
+                    // model trying info suppressed for cleaner CLI
+                    const llm = createOpenAICompatibleLLM(baseUrl, apiKey, model, providerName);
+                    const result = yield llm.generate(prompt, schema);
+                    if (result === null || result === void 0 ? void 0 : result.object) {
+                        currentModelIndex = allModels.indexOf(model);
+                        return result;
+                    }
+                }
+                catch (error) {
+                    lastError = error;
+                    const isRateLimit = ((_a = error.message) === null || _a === void 0 ? void 0 : _a.includes("429")) ||
+                        ((_b = error.message) === null || _b === void 0 ? void 0 : _b.includes("rate limit"));
+                    if (isRateLimit) {
+                        console.log(chalk_1.default.yellow(`[WARN] Rate limit for ${model}, trying fallback...`));
+                        continue;
+                    }
+                    console.log(chalk_1.default.yellow(`[WARN] ${providerName} error: ${error.message}`));
+                    if (((_c = error.message) === null || _c === void 0 ? void 0 : _c.includes("500")) || ((_d = error.message) === null || _d === void 0 ? void 0 : _d.includes("502")) || ((_e = error.message) === null || _e === void 0 ? void 0 : _e.includes("503"))) {
+                        continue;
+                    }
+                    throw error;
+                }
+            }
+            throw lastError || new Error(`All ${providerName} models failed`);
+        }),
+    };
+}
+/**
+ * Factory class for creating Language Model instances based on configuration
+ * @class LLMFactory
+ */
+class LLMFactory {
+    /**
+     * Creates an LLM instance based on the provided configuration
+     * @static
+     * @param {LLMConfig} config - Configuration for the LLM
+     * @returns {Object} An object with a generate method for interacting with the LLM
+     * @throws {Error} When an unsupported provider is specified or custom provider lacks required function
+     */
+    static createLLM(config) {
+        switch (config.provider) {
+            case "openai":
+                return {
+                    generate: (prompt, schema) => __awaiter(this, void 0, void 0, function* () {
+                        var _a, _b, _c;
+                        const t0 = performance.now();
+                        const result = yield (0, ai_1.generateObject)({
+                            model: (0, openai_1.openai)(config.model),
+                            temperature: (_a = config.temperature) !== null && _a !== void 0 ? _a : 0.7,
+                            maxTokens: config.maxTokens,
+                            prompt: typeof prompt === "string" ? prompt : prompt.user,
+                            system: typeof prompt === "string" ? undefined : prompt.system,
+                            schema,
+                        });
+                        const duration = performance.now() - t0;
+                        return {
+                            object: result.object,
+                            usage: result.usage
+                                ? { promptTokens: (_b = result.usage.promptTokens) !== null && _b !== void 0 ? _b : 0, completionTokens: (_c = result.usage.completionTokens) !== null && _c !== void 0 ? _c : 0 }
+                                : undefined,
+                            duration,
+                        };
+                    }),
+                };
+            case "ollama":
+                return {
+                    generate: (prompt, schema) => __awaiter(this, void 0, void 0, function* () {
+                        var _a, _b, _c, _d;
+                        const t0 = performance.now();
+                        const baseUrl = config.baseUrl || "http://localhost:11434";
+                        const userPrompt = typeof prompt === "string" ? prompt : prompt.user;
+                        const systemPrompt = typeof prompt === "string" ? undefined : prompt.system;
+                        const response = yield fetch(`${baseUrl}/api/chat`, {
+                            method: "POST",
+                            headers: { "Content-Type": "application/json" },
+                            body: JSON.stringify({
+                                model: config.model,
+                                messages: [
+                                    ...(systemPrompt ? [{ role: "system", content: systemPrompt }] : []),
+                                    { role: "user", content: userPrompt + "\n\nImportant: Respond ONLY with valid JSON matching the required schema." },
+                                ],
+                                stream: false,
+                            }),
+                        });
+                        if (!response.ok) {
+                            const errorText = yield response.text();
+                            throw new Error(`Ollama API error (${response.status}): ${errorText}`);
+                        }
+                        const data = yield response.json();
+                        const duration = performance.now() - t0;
+                        const usage = data.usage
+                            ? { promptTokens: (_a = data.usage.prompt_eval_count) !== null && _a !== void 0 ? _a : 0, completionTokens: (_b = data.usage.eval_count) !== null && _b !== void 0 ? _b : 0 }
+                            : undefined;
+                        let content = ((_c = data.message) === null || _c === void 0 ? void 0 : _c.content) || "";
+                        if ((_d = data.message) === null || _d === void 0 ? void 0 : _d.thinking) {
+                            console.log(chalk_1.default.cyan('\n[REASONING] ') + data.message.thinking.substring(0, 500) + '...\n');
+                        }
+                        let parsed;
+                        const firstBrace = content.indexOf('{');
+                        const errResult = (obj) => ({ object: obj, usage, duration });
+                        if (firstBrace !== -1) {
+                            let endBrace = -1;
+                            let braceCount = 0;
+                            for (let i = firstBrace; i < content.length; i++) {
+                                if (content[i] === '{')
+                                    braceCount++;
+                                else if (content[i] === '}') {
+                                    braceCount--;
+                                    if (braceCount === 0) {
+                                        endBrace = i;
+                                        break;
+                                    }
+                                }
+                            }
+                            if (endBrace !== -1) {
+                                const jsonStr = content.substring(firstBrace, endBrace + 1);
+                                try {
+                                    parsed = JSON.parse(jsonStr);
+                                }
+                                catch (e) {
+                                    console.log(chalk_1.default.yellow('[WARN] Truncated JSON, attempting repair...'));
+                                    const repaired = jsonStr.replace(/,(\s*[}\]])/g, '$1').replace(/([}\]])(\s*[,\n])/g, '$1$2');
+                                    try {
+                                        parsed = JSON.parse(repaired);
+                                    }
+                                    catch (_e) {
+                                        console.log(chalk_1.default.yellow('[WARN] Repair failed, extracting partial actions...'));
+                                        const actionMatches = jsonStr.matchAll(/"name"\s*:\s*"([^"]+)"/g);
+                                        const actions = [];
+                                        for (const match of actionMatches) {
+                                            actions.push({ name: match[1], parameters: {} });
+                                        }
+                                        if (actions.length > 0) {
+                                            parsed = { actions, response: "Partial response" };
+                                        }
+                                        else {
+                                            return errResult({ actions: [], response: content.substring(0, 200) });
+                                        }
+                                    }
+                                }
+                            }
+                            else {
+                                console.log(chalk_1.default.yellow('[WARN] Incomplete JSON, returning empty response'));
+                                return errResult({ actions: [], response: content.substring(0, 100) });
+                            }
+                        }
+                        else {
+                            return errResult({ actions: [], response: content.substring(0, 200) });
+                        }
+                        const validated = schema.parse(parsed);
+                        return { object: validated, usage, duration };
+                    }),
+                };
+            case "groq":
+                return createLLMWithFallback("https://api.groq.com/openai/v1", config.apiKey || "", config.model || DEFAULT_GROQ_MODEL, GROQ_FALLBACK_MODELS, "Groq");
+            case "openrouter":
+                return createLLMWithFallback("https://openrouter.ai/api/v1", config.apiKey || "", config.model || "google/gemini-flash-1.5", [], "OpenRouter");
+            case "google":
+                return {
+                    generate: (prompt, schema) => __awaiter(this, void 0, void 0, function* () {
+                        var _a, _b, _c, _d, _e, _f, _g;
+                        const t0 = performance.now();
+                        const userPrompt = typeof prompt === "string" ? prompt : prompt.user;
+                        const systemPrompt = typeof prompt === "string" ? undefined : prompt.system;
+                        const apiKey = config.apiKey || "";
+                        const model = config.model || "gemini-flash-1.5";
+                        const url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${apiKey}`;
+                        const body = {
+                            contents: [{
+                                    parts: [{ text: `${systemPrompt ? `System: ${systemPrompt}\n\n` : ""}${userPrompt}` }]
+                                }],
+                            generationConfig: { temperature: 0.7, maxOutputTokens: 4096 }
+                        };
+                        const response = yield fetch(url, {
+                            method: "POST",
+                            headers: { "Content-Type": "application/json" },
+                            body: JSON.stringify(body)
+                        });
+                        if (!response.ok) {
+                            const errorText = yield response.text();
+                            throw new Error(`Google API error (${response.status}): ${errorText}`);
+                        }
+                        const data = yield response.json();
+                        const duration = performance.now() - t0;
+                        const usage = data.usageMetadata
+                            ? {
+                                promptTokens: (_a = data.usageMetadata.promptTokenCount) !== null && _a !== void 0 ? _a : 0,
+                                completionTokens: (_b = data.usageMetadata.candidatesTokenCount) !== null && _b !== void 0 ? _b : 0,
+                            }
+                            : undefined;
+                        const text = ((_g = (_f = (_e = (_d = (_c = data.candidates) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.content) === null || _e === void 0 ? void 0 : _e.parts) === null || _f === void 0 ? void 0 : _f[0]) === null || _g === void 0 ? void 0 : _g.text) || "";
+                        try {
+                            const parsed = JSON.parse(text);
+                            return { object: schema.parse(parsed), usage, duration };
+                        }
+                        catch (_h) {
+                            return { object: { actions: [], response: text.substring(0, 200) }, usage, duration };
+                        }
+                    })
+                };
+            case "custom":
+                if (!config.customCall) {
+                    throw new Error("Custom LLM provider requires a customCall function");
+                }
+                return {
+                    generate: config.customCall,
+                };
+            default:
+                throw new Error(`Unsupported LLM provider: ${config.provider}`);
+        }
+    }
+}
+exports.LLMFactory = LLMFactory;
+//# sourceMappingURL=llm-factory.js.map

package/dist/agent/llm-factory.js.map

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

package/dist/agent/orchestrator.d.ts

@@ -0,0 +1,18 @@
+import { AgentContext } from "../types/agent";
+import { Agent } from "./agent";
+import { AgentRegistry } from "./registry";
+export type OrchestratorConfig = {
+    mainAgent: Agent;
+    registry: AgentRegistry;
+    autoHandoff?: boolean;
+};
+export declare class OrchestratorAgent {
+    private mainAgent;
+    private registry;
+    private autoHandoff;
+    constructor(config: OrchestratorConfig);
+    process(input: string): Promise<AgentContext>;
+    getMainAgent(): Agent;
+    getRegistry(): AgentRegistry;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/agent/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../agent/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,KAAK,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,WAAW,CAAU;gBAEjB,MAAM,EAAE,kBAAkB;IAMhC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBnD,YAAY,IAAI,KAAK;IAIrB,WAAW,IAAI,aAAa;CAG7B"}

package/dist/agent/orchestrator.js

@@ -0,0 +1,44 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrchestratorAgent = void 0;
+class OrchestratorAgent {
+    constructor(config) {
+        var _a;
+        this.mainAgent = config.mainAgent;
+        this.registry = config.registry;
+        this.autoHandoff = (_a = config.autoHandoff) !== null && _a !== void 0 ? _a : true;
+    }
+    process(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const ctx = yield this.mainAgent.process(input);
+            const handoff = ctx._handoff;
+            if (handoff && handoff.graph === "PARENT" && this.autoHandoff) {
+                const targetName = handoff.goto;
+                const target = this.registry.getAgent(targetName);
+                if (target) {
+                    const handoffTask = ((_a = handoff.update) === null || _a === void 0 ? void 0 : _a.handoffTask) || input;
+                    return target.process(handoffTask);
+                }
+            }
+            return ctx;
+        });
+    }
+    getMainAgent() {
+        return this.mainAgent;
+    }
+    getRegistry() {
+        return this.registry;
+    }
+}
+exports.OrchestratorAgent = OrchestratorAgent;
+//# sourceMappingURL=orchestrator.js.map

package/dist/agent/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../agent/orchestrator.ts"],"names":[],"mappings":";;;;;;;;;;;;AAUA,MAAa,iBAAiB;IAK5B,YAAY,MAA0B;;QACpC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,MAAA,MAAM,CAAC,WAAW,mCAAI,IAAI,CAAC;IAChD,CAAC;IAEK,OAAO,CAAC,KAAa;;;YACzB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAEhD,MAAM,OAAO,GAAI,GAAW,CAAC,QAAQ,CAAC;YACtC,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC9D,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;gBAChC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBAClD,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,WAAW,GAAG,CAAA,MAAA,OAAO,CAAC,MAAM,0CAAE,WAAW,KAAI,KAAK,CAAC;oBACzD,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;YAED,OAAO,GAAG,CAAC;QACb,CAAC;KAAA;IAED,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAlCD,8CAkCC"}

package/dist/agent/prompt-builder.d.ts

@@ -0,0 +1,35 @@
+import { AgentContext, PromptSection } from "../types/agent";
+/**
+ * Builder class for creating structured prompts with multiple sections
+ * @class PromptBuilder
+ */
+export declare class PromptBuilder {
+    private sections;
+    private formatFn?;
+    /**
+     * Adds a new section to the prompt
+     * @param {string} title - The title of the section
+     * @param {string | ((context: AgentContext) => string | Promise<string>)} content - The content or a function to generate content
+     * @returns {this} The builder instance for method chaining
+     */
+    addSection(title: string, content: string | ((context: AgentContext) => string | Promise<string>)): this;
+    /**
+     * Sets a custom formatter function for the final prompt
+     * @param {(sections: PromptSection[], context: AgentContext) => string | Promise<string>} formatter - The formatter function
+     * @returns {this} The builder instance for method chaining
+     */
+    setFormatter(formatter: (sections: PromptSection[], context: AgentContext) => string | Promise<string>): this;
+    /**
+     * Builds the final prompt by resolving all sections and applying formatting
+     * @param {AgentContext} context - The context to use when resolving dynamic content
+     * @returns {Promise<string>} The formatted prompt string
+     */
+    build(context: AgentContext): Promise<string>;
+}
+/**
+ * Default formatter function that formats sections with markdown-style headers
+ * @param {PromptSection[]} sections - The sections to format
+ * @returns {string} The formatted prompt string
+ */
+export declare const defaultFormatter: (sections: PromptSection[]) => string;
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/agent/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../agent/prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAC,CAGa;IAE9B;;;;;OAKG;IACH,UAAU,CACR,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GACtE,IAAI;IAKP;;;;OAIG;IACH,YAAY,CACV,SAAS,EAAE,CACT,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,EAAE,YAAY,KAClB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAC5B,IAAI;IAKP;;;;OAIG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAmBpD;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,aAAc,aAAa,EAAE,KAAG,MAI5D,CAAC"}

package/dist/agent/prompt-builder.js

@@ -0,0 +1,76 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultFormatter = exports.PromptBuilder = void 0;
+/**
+ * Builder class for creating structured prompts with multiple sections
+ * @class PromptBuilder
+ */
+class PromptBuilder {
+    constructor() {
+        this.sections = [];
+    }
+    /**
+     * Adds a new section to the prompt
+     * @param {string} title - The title of the section
+     * @param {string | ((context: AgentContext) => string | Promise<string>)} content - The content or a function to generate content
+     * @returns {this} The builder instance for method chaining
+     */
+    addSection(title, content) {
+        this.sections.push({ title, content });
+        return this;
+    }
+    /**
+     * Sets a custom formatter function for the final prompt
+     * @param {(sections: PromptSection[], context: AgentContext) => string | Promise<string>} formatter - The formatter function
+     * @returns {this} The builder instance for method chaining
+     */
+    setFormatter(formatter) {
+        this.formatFn = formatter;
+        return this;
+    }
+    /**
+     * Builds the final prompt by resolving all sections and applying formatting
+     * @param {AgentContext} context - The context to use when resolving dynamic content
+     * @returns {Promise<string>} The formatted prompt string
+     */
+    build(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resolvedSections = yield Promise.all(this.sections.map((section) => __awaiter(this, void 0, void 0, function* () {
+                return ({
+                    title: section.title,
+                    content: typeof section.content === "function"
+                        ? yield section.content(context)
+                        : section.content,
+                });
+            })));
+            if (this.formatFn) {
+                return this.formatFn(resolvedSections, context);
+            }
+            return resolvedSections
+                .map((section) => `## ${section.title}\n${section.content}`)
+                .join("\n\n");
+        });
+    }
+}
+exports.PromptBuilder = PromptBuilder;
+/**
+ * Default formatter function that formats sections with markdown-style headers
+ * @param {PromptSection[]} sections - The sections to format
+ * @returns {string} The formatted prompt string
+ */
+const defaultFormatter = (sections) => {
+    return sections
+        .map((section) => `## ${section.title}\n${section.content}`)
+        .join("\n\n");
+};
+exports.defaultFormatter = defaultFormatter;
+//# sourceMappingURL=prompt-builder.js.map

package/dist/agent/prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../../agent/prompt-builder.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA;;;GAGG;AACH,MAAa,aAAa;IAA1B;QACU,aAAQ,GAAoB,EAAE,CAAC;IA2DzC,CAAC;IArDC;;;;;OAKG;IACH,UAAU,CACR,KAAa,EACb,OAAuE;QAEvE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,YAAY,CACV,SAG6B;QAE7B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACG,KAAK,CAAC,OAAqB;;YAC/B,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,GAAG,CACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAO,OAAO,EAAE,EAAE;gBAAC,OAAA,CAAC;oBACpC,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,OAAO,EACL,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU;wBACnC,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;wBAChC,CAAC,CAAC,OAAO,CAAC,OAAO;iBACtB,CAAC,CAAA;cAAA,CAAC,CACJ,CAAC;YAEF,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;YAED,OAAO,gBAAgB;iBACpB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;iBAC3D,IAAI,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC;KAAA;CACF;AA5DD,sCA4DC;AAED;;;;GAIG;AACI,MAAM,gBAAgB,GAAG,CAAC,QAAyB,EAAU,EAAE;IACpE,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;SAC3D,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC,CAAC;AAJW,QAAA,gBAAgB,oBAI3B"}

package/dist/agent/registry.d.ts

@@ -0,0 +1,19 @@
+import { Agent } from "./agent";
+export type AgentRegistration = {
+    agent: Agent;
+    role: string;
+    description: string;
+    capabilities?: string[];
+};
+export declare class AgentRegistry {
+    private agents;
+    register(name: string, agent: Agent, role: string, description: string, capabilities?: string[]): void;
+    get(name: string): AgentRegistration | undefined;
+    getAgent(name: string): Agent | undefined;
+    find(query: string): AgentRegistration[];
+    list(): AgentRegistration[];
+    remove(name: string): boolean;
+    has(name: string): boolean;
+    get size(): number;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/agent/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../agent/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA6C;IAE3D,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,IAAI;IAOP,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIzC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAexC,IAAI,IAAI,iBAAiB,EAAE;IAI3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/agent/registry.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRegistry = void 0;
+class AgentRegistry {
+    constructor() {
+        this.agents = new Map();
+    }
+    register(name, agent, role, description, capabilities) {
+        if (this.agents.has(name)) {
+            throw new Error(`Agent "${name}" is already registered`);
+        }
+        this.agents.set(name, { agent, role, description, capabilities });
+    }
+    get(name) {
+        return this.agents.get(name);
+    }
+    getAgent(name) {
+        var _a;
+        return (_a = this.agents.get(name)) === null || _a === void 0 ? void 0 : _a.agent;
+    }
+    find(query) {
+        var _a;
+        const q = query.toLowerCase();
+        const results = [];
+        for (const [, reg] of this.agents) {
+            if (reg.role.toLowerCase().includes(q) ||
+                reg.description.toLowerCase().includes(q) ||
+                ((_a = reg.capabilities) === null || _a === void 0 ? void 0 : _a.some((c) => c.toLowerCase().includes(q)))) {
+                results.push(reg);
+            }
+        }
+        return results;
+    }
+    list() {
+        return Array.from(this.agents.values());
+    }
+    remove(name) {
+        return this.agents.delete(name);
+    }
+    has(name) {
+        return this.agents.has(name);
+    }
+    get size() {
+        return this.agents.size;
+    }
+}
+exports.AgentRegistry = AgentRegistry;
+//# sourceMappingURL=registry.js.map

package/dist/agent/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../agent/registry.ts"],"names":[],"mappings":";;;AASA,MAAa,aAAa;IAA1B;QACU,WAAM,GAAmC,IAAI,GAAG,EAAE,CAAC;IAqD7D,CAAC;IAnDC,QAAQ,CACN,IAAY,EACZ,KAAY,EACZ,IAAY,EACZ,WAAmB,EACnB,YAAuB;QAEvB,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,yBAAyB,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAC,IAAY;;QACnB,OAAO,MAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,0CAAE,KAAK,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,KAAa;;QAChB,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,IACE,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAClC,GAAG,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;iBACzC,MAAA,GAAG,CAAC,YAAY,0CAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA,EAC1D,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF;AAtDD,sCAsDC"}

package/dist/agent/tools/file-system.d.ts

@@ -0,0 +1,11 @@
+import { GraphFlow } from "../../execution/index";
+export declare function createFileReaderTool(): GraphFlow<any>;
+export declare function createFileWriterTool(): GraphFlow<any>;
+export declare function createFileDeleterTool(): GraphFlow<any>;
+export declare function createDirectoryCreatorTool(): GraphFlow<any>;
+export declare function createDirectoryListerTool(): GraphFlow<any>;
+export declare function createShellTool(): GraphFlow<any>;
+export declare function createNodeCodeTool(): GraphFlow<any>;
+export declare function createPythonCodeTool(): GraphFlow<any>;
+export declare function createAllAgentTools(): GraphFlow<any>[];
+//# sourceMappingURL=file-system.d.ts.map

package/dist/agent/tools/file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../../../agent/tools/file-system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAQlD,wBAAgB,oBAAoB,IAAI,SAAS,CAAC,GAAG,CAAC,CAqCrD;AAED,wBAAgB,oBAAoB,IAAI,SAAS,CAAC,GAAG,CAAC,CAwCrD;AAED,wBAAgB,qBAAqB,IAAI,SAAS,CAAC,GAAG,CAAC,CA2CtD;AAED,wBAAgB,0BAA0B,IAAI,SAAS,CAAC,GAAG,CAAC,CAsC3D;AAED,wBAAgB,yBAAyB,IAAI,SAAS,CAAC,GAAG,CAAC,CAwC1D;AA8ED,wBAAgB,eAAe,IAAI,SAAS,CAAC,GAAG,CAAC,CAsChD;AAED,wBAAgB,kBAAkB,IAAI,SAAS,CAAC,GAAG,CAAC,CAuEnD;AAED,wBAAgB,oBAAoB,IAAI,SAAS,CAAC,GAAG,CAAC,CAoDrD;AAED,wBAAgB,mBAAmB,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAWtD"}