mojentic 1.0.0

package/dist/examples/react/summarization-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarization-agent.d.ts","sourceRoot":"","sources":["../../../src/examples/react/summarization-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAY,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAK7C;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAM3C,OAAO,CAAC,QAAQ,CAAC,GAAG;IALhC;;;;OAIG;gBAC0B,GAAG,EAAE,SAAS;IAE3C;;;;;OAKG;IACG,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;IAgDtE;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAWnB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAGpB"}

package/dist/examples/react/summarization-agent.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * Summarization agent for the ReAct pattern.
+ *
+ * This agent generates the final answer based on accumulated context.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SummarizationAgent = void 0;
+const error_1 = require("../../error");
+const models_1 = require("../../llm/models");
+const formatters_1 = require("./formatters");
+/**
+ * Agent responsible for generating the final answer.
+ *
+ * This agent reviews the context, plan, and history to synthesize
+ * a complete answer to the user's original query.
+ */
+class SummarizationAgent {
+    llm;
+    /**
+     * Initialize the summarization agent.
+     *
+     * @param llm - The LLM broker to use for generating summaries
+     */
+    constructor(llm) {
+        this.llm = llm;
+    }
+    /**
+     * Generate a final answer based on the context.
+     *
+     * @param event - The finish event containing the complete context
+     * @returns Empty array (terminal event) or array with FailureOccurred on error
+     */
+    async receiveEventAsync(event) {
+        if (event.type !== 'FinishAndSummarize') {
+            return (0, error_1.Ok)([]);
+        }
+        const finishEvent = event;
+        try {
+            const prompt = this.buildPrompt(finishEvent);
+            console.log(this.formatBlock(prompt));
+            const result = await this.llm.generate([models_1.Message.user(prompt)]);
+            if (!(0, error_1.isOk)(result)) {
+                return (0, error_1.Ok)([
+                    {
+                        type: 'FailureOccurred',
+                        source: 'SummarizationAgent',
+                        context: finishEvent.context,
+                        reason: `Error during summarization: ${result.error.message}`,
+                        correlationId: event.correlationId,
+                    },
+                ]);
+            }
+            const response = result.value;
+            console.log('\n' + '='.repeat(80));
+            console.log('FINAL ANSWER:');
+            console.log('='.repeat(80));
+            console.log(response);
+            console.log('='.repeat(80) + '\n');
+            // This is a terminal event - return empty list to stop the loop
+            return (0, error_1.Ok)([]);
+        }
+        catch (error) {
+            return (0, error_1.Ok)([
+                {
+                    type: 'FailureOccurred',
+                    source: 'SummarizationAgent',
+                    context: finishEvent.context,
+                    reason: `Error during summarization: ${error instanceof Error ? error.message : String(error)}`,
+                    correlationId: event.correlationId,
+                },
+            ]);
+        }
+    }
+    /**
+     * Generate the prompt for the summarization LLM.
+     *
+     * @param event - The finish event containing the complete context
+     * @returns The formatted prompt string
+     */
+    buildPrompt(event) {
+        return `Based on the following context, provide a clear and concise answer to the user's query.
+
+${(0, formatters_1.formatCurrentContext)(event.context)}
+
+Your task:
+Review what we've learned and provide a direct answer to: "${event.context.userQuery}"
+
+Be specific and use the information gathered during our process.`;
+    }
+    /**
+     * Format a text block with separators for visual clarity.
+     *
+     * @param text - The text to format
+     * @returns Formatted text with separator lines
+     */
+    formatBlock(text) {
+        return `\n${'='.repeat(80)}\n${text}\n${'='.repeat(80)}\n`;
+    }
+}
+exports.SummarizationAgent = SummarizationAgent;
+//# sourceMappingURL=summarization-agent.js.map

package/dist/examples/react/summarization-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarization-agent.js","sourceRoot":"","sources":["../../../src/examples/react/summarization-agent.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAIH,uCAA+C;AAE/C,6CAA2C;AAE3C,6CAAoD;AAEpD;;;;;GAKG;AACH,MAAa,kBAAkB;IAMA;IAL7B;;;;OAIG;IACH,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CAAC,KAAY;QAClC,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;YACxC,OAAO,IAAA,UAAE,EAAC,EAAE,CAAC,CAAC;QAChB,CAAC;QAED,MAAM,WAAW,GAAG,KAA2B,CAAC;QAEhD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;YAEtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,gBAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAE/D,IAAI,CAAC,IAAA,YAAI,EAAC,MAAM,CAAC,EAAE,CAAC;gBAClB,OAAO,IAAA,UAAE,EAAC;oBACR;wBACE,IAAI,EAAE,iBAAiB;wBACvB,MAAM,EAAE,oBAAoB;wBAC5B,OAAO,EAAE,WAAW,CAAC,OAAO;wBAC5B,MAAM,EAAE,+BAA+B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;wBAC7D,aAAa,EAAE,KAAK,CAAC,aAAa;qBAChB;iBACrB,CAAC,CAAC;YACL,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;YAE9B,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YAEnC,gEAAgE;YAChE,OAAO,IAAA,UAAE,EAAC,EAAE,CAAC,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAA,UAAE,EAAC;gBACR;oBACE,IAAI,EAAE,iBAAiB;oBACvB,MAAM,EAAE,oBAAoB;oBAC5B,OAAO,EAAE,WAAW,CAAC,OAAO;oBAC5B,MAAM,EAAE,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;oBAC/F,aAAa,EAAE,KAAK,CAAC,aAAa;iBAChB;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,WAAW,CAAC,KAAyB;QAC3C,OAAO;;EAET,IAAA,iCAAoB,EAAC,KAAK,CAAC,OAAO,CAAC;;;6DAGwB,KAAK,CAAC,OAAO,CAAC,SAAS;;iEAEnB,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACK,WAAW,CAAC,IAAY;QAC9B,OAAO,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC;IAC7D,CAAC;CACF;AAxFD,gDAwFC"}

package/dist/examples/react/thinking-agent.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Planning agent for the ReAct pattern.
+ *
+ * This agent creates structured plans for solving user queries.
+ */
+import { BaseAsyncAgent } from '../../agents/base-async-agent';
+import { Event } from '../../agents/event';
+import { Result } from '../../error';
+import { LlmBroker } from '../../llm/broker';
+/**
+ * Agent responsible for creating plans in the ReAct loop.
+ *
+ * This agent analyzes the user query and available tools to create
+ * a step-by-step plan for answering the query.
+ */
+export declare class ThinkingAgent implements BaseAsyncAgent {
+    private readonly llm;
+    private readonly tools;
+    /**
+     * Initialize the thinking agent.
+     *
+     * @param llm - The LLM broker to use for generating plans
+     */
+    constructor(llm: LlmBroker);
+    /**
+     * Process a thinking event and generate a plan.
+     *
+     * @param event - The thinking event containing current context
+     * @returns Result containing InvokeDecisioning event with updated plan, or FailureOccurred on error
+     */
+    receiveEventAsync(event: Event): Promise<Result<Event[], Error>>;
+    /**
+     * Generate the prompt for the planning LLM.
+     *
+     * @param event - The thinking event containing current context
+     * @returns The formatted prompt string
+     */
+    private buildPrompt;
+    /**
+     * Format a text block with separators for visual clarity.
+     *
+     * @param text - The text to format
+     * @returns Formatted text with separator lines
+     */
+    private formatBlock;
+}
+//# sourceMappingURL=thinking-agent.d.ts.map

package/dist/examples/react/thinking-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-agent.d.ts","sourceRoot":"","sources":["../../../src/examples/react/thinking-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAM,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAQ7C;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,cAAc;IAQtC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPhC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAElC;;;;OAIG;gBAC0B,GAAG,EAAE,SAAS;IAI3C;;;;;OAKG;IACG,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;IAyEtE;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAWnB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAGpB"}

package/dist/examples/react/thinking-agent.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Planning agent for the ReAct pattern.
+ *
+ * This agent creates structured plans for solving user queries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThinkingAgent = void 0;
+const error_1 = require("../../error");
+const models_1 = require("../../llm/models");
+const date_resolver_1 = require("../../llm/tools/date-resolver");
+const formatters_1 = require("./formatters");
+/**
+ * Agent responsible for creating plans in the ReAct loop.
+ *
+ * This agent analyzes the user query and available tools to create
+ * a step-by-step plan for answering the query.
+ */
+class ThinkingAgent {
+    llm;
+    tools;
+    /**
+     * Initialize the thinking agent.
+     *
+     * @param llm - The LLM broker to use for generating plans
+     */
+    constructor(llm) {
+        this.llm = llm;
+        this.tools = [new date_resolver_1.DateResolverTool()];
+    }
+    /**
+     * Process a thinking event and generate a plan.
+     *
+     * @param event - The thinking event containing current context
+     * @returns Result containing InvokeDecisioning event with updated plan, or FailureOccurred on error
+     */
+    async receiveEventAsync(event) {
+        if (event.type !== 'InvokeThinking') {
+            return (0, error_1.Ok)([]);
+        }
+        const thinkingEvent = event;
+        try {
+            const prompt = this.buildPrompt(thinkingEvent);
+            console.log(this.formatBlock(prompt));
+            // Define schema for Plan object
+            const schema = {
+                type: 'object',
+                properties: {
+                    steps: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'How to answer the query, step by step, each step outlining an action to take',
+                    },
+                },
+                required: ['steps'],
+            };
+            const result = await this.llm.generateObject([models_1.Message.user(prompt)], schema);
+            if (!result.ok) {
+                return (0, error_1.Ok)([
+                    {
+                        type: 'FailureOccurred',
+                        source: 'ThinkingAgent',
+                        context: thinkingEvent.context,
+                        reason: `Error during planning: ${result.error.message}`,
+                        correlationId: event.correlationId,
+                    },
+                ]);
+            }
+            const plan = result.value;
+            console.log(this.formatBlock(JSON.stringify(plan, null, 2)));
+            // Update context with new plan
+            thinkingEvent.context.plan = plan;
+            // Add planning step to history
+            thinkingEvent.context.history.push({
+                thought: 'I need to create a plan to solve this query.',
+                action: 'Created a step-by-step plan.',
+                observation: `Plan has ${plan.steps.length} steps.`,
+            });
+            return (0, error_1.Ok)([
+                {
+                    type: 'InvokeDecisioning',
+                    source: 'ThinkingAgent',
+                    context: thinkingEvent.context,
+                    correlationId: event.correlationId,
+                },
+            ]);
+        }
+        catch (error) {
+            return (0, error_1.Ok)([
+                {
+                    type: 'FailureOccurred',
+                    source: 'ThinkingAgent',
+                    context: thinkingEvent.context,
+                    reason: `Error during planning: ${error instanceof Error ? error.message : String(error)}`,
+                    correlationId: event.correlationId,
+                },
+            ]);
+        }
+    }
+    /**
+     * Generate the prompt for the planning LLM.
+     *
+     * @param event - The thinking event containing current context
+     * @returns The formatted prompt string
+     */
+    buildPrompt(event) {
+        return `You are to solve a problem by reasoning and acting on the information you have. Here is the current context:
+
+${(0, formatters_1.formatCurrentContext)(event.context)}
+${(0, formatters_1.formatAvailableTools)(this.tools)}
+
+Your Instructions:
+Given our context and what we've done so far, and the tools available, create a step-by-step plan to answer the query.
+Each step should be concrete and actionable. Consider which tools you'll need to use.`;
+    }
+    /**
+     * Format a text block with separators for visual clarity.
+     *
+     * @param text - The text to format
+     * @returns Formatted text with separator lines
+     */
+    formatBlock(text) {
+        return `\n${'='.repeat(80)}\n${text}\n${'='.repeat(80)}\n`;
+    }
+}
+exports.ThinkingAgent = ThinkingAgent;
+//# sourceMappingURL=thinking-agent.js.map

package/dist/examples/react/thinking-agent.js.map

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

package/dist/examples/react/tool-call-agent.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Tool execution agent for the ReAct pattern.
+ *
+ * This agent handles the actual execution of tools and captures the results.
+ */
+import { BaseAsyncAgent } from '../../agents/base-async-agent';
+import { Event } from '../../agents/event';
+import { Result } from '../../error';
+/**
+ * Agent responsible for executing tool calls.
+ *
+ * This agent receives tool call events, executes the specified tool,
+ * and updates the context with the results before continuing to the
+ * decisioning phase.
+ */
+export declare class ToolCallAgent implements BaseAsyncAgent {
+    /**
+     * Execute a tool and update the context.
+     *
+     * @param event - The tool call event containing the tool and arguments
+     * @returns Result containing InvokeDecisioning event with updated context, or FailureOccurred on error
+     */
+    receiveEventAsync(event: Event): Promise<Result<Event[], Error>>;
+}
+//# sourceMappingURL=tool-call-agent.d.ts.map

package/dist/examples/react/tool-call-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-agent.d.ts","sourceRoot":"","sources":["../../../src/examples/react/tool-call-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAY,MAAM,aAAa,CAAC;AAI/C;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD;;;;;OAKG;IACG,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;CAiEvE"}

package/dist/examples/react/tool-call-agent.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Tool execution agent for the ReAct pattern.
+ *
+ * This agent handles the actual execution of tools and captures the results.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolCallAgent = void 0;
+const error_1 = require("../../error");
+/**
+ * Agent responsible for executing tool calls.
+ *
+ * This agent receives tool call events, executes the specified tool,
+ * and updates the context with the results before continuing to the
+ * decisioning phase.
+ */
+class ToolCallAgent {
+    /**
+     * Execute a tool and update the context.
+     *
+     * @param event - The tool call event containing the tool and arguments
+     * @returns Result containing InvokeDecisioning event with updated context, or FailureOccurred on error
+     */
+    async receiveEventAsync(event) {
+        if (event.type !== 'InvokeToolCall') {
+            return (0, error_1.Ok)([]);
+        }
+        const toolCallEvent = event;
+        try {
+            const tool = toolCallEvent.tool;
+            const toolName = tool.descriptor().function.name;
+            const args = toolCallEvent.toolArguments;
+            console.log(`\nExecuting tool: ${toolName}`);
+            console.log(`Arguments: ${JSON.stringify(args, null, 2)}`);
+            // Execute the tool
+            const result = await tool.run(args);
+            if (!(0, error_1.isOk)(result)) {
+                return (0, error_1.Ok)([
+                    {
+                        type: 'FailureOccurred',
+                        source: 'ToolCallAgent',
+                        context: toolCallEvent.context,
+                        reason: `Tool execution failed: ${result.error.message}`,
+                        correlationId: event.correlationId,
+                    },
+                ]);
+            }
+            const toolResult = result.value;
+            console.log(`Result: ${JSON.stringify(toolResult, null, 2)}`);
+            // Extract the text content from the result
+            const resultText = JSON.stringify(toolResult);
+            // Add to history
+            toolCallEvent.context.history.push({
+                thought: toolCallEvent.thought,
+                action: `Called ${toolName} with ${JSON.stringify(args)}`,
+                observation: resultText,
+            });
+            // Continue to decisioning
+            return (0, error_1.Ok)([
+                {
+                    type: 'InvokeDecisioning',
+                    source: 'ToolCallAgent',
+                    context: toolCallEvent.context,
+                    correlationId: event.correlationId,
+                },
+            ]);
+        }
+        catch (error) {
+            console.error('Tool execution error:', error);
+            return (0, error_1.Ok)([
+                {
+                    type: 'FailureOccurred',
+                    source: 'ToolCallAgent',
+                    context: toolCallEvent.context,
+                    reason: `Tool execution failed: ${error instanceof Error ? error.message : String(error)}`,
+                    correlationId: event.correlationId,
+                },
+            ]);
+        }
+    }
+}
+exports.ToolCallAgent = ToolCallAgent;
+//# sourceMappingURL=tool-call-agent.js.map

package/dist/examples/react/tool-call-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-agent.js","sourceRoot":"","sources":["../../../src/examples/react/tool-call-agent.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAIH,uCAA+C;AAI/C;;;;;;GAMG;AACH,MAAa,aAAa;IACxB;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CAAC,KAAY;QAClC,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACpC,OAAO,IAAA,UAAE,EAAC,EAAE,CAAC,CAAC;QAChB,CAAC;QAED,MAAM,aAAa,GAAG,KAAuB,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjD,MAAM,IAAI,GAAG,aAAa,CAAC,aAAa,CAAC;YAEzC,OAAO,CAAC,GAAG,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAE3D,mBAAmB;YACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAEpC,IAAI,CAAC,IAAA,YAAI,EAAC,MAAM,CAAC,EAAE,CAAC;gBAClB,OAAO,IAAA,UAAE,EAAC;oBACR;wBACE,IAAI,EAAE,iBAAiB;wBACvB,MAAM,EAAE,eAAe;wBACvB,OAAO,EAAE,aAAa,CAAC,OAAO;wBAC9B,MAAM,EAAE,0BAA0B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;wBACxD,aAAa,EAAE,KAAK,CAAC,aAAa;qBAChB;iBACrB,CAAC,CAAC;YACL,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAE9D,2CAA2C;YAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAE9C,iBAAiB;YACjB,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;gBACjC,OAAO,EAAE,aAAa,CAAC,OAAO;gBAC9B,MAAM,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;gBACzD,WAAW,EAAE,UAAU;aACI,CAAC,CAAC;YAE/B,0BAA0B;YAC1B,OAAO,IAAA,UAAE,EAAC;gBACR;oBACE,IAAI,EAAE,mBAAmB;oBACzB,MAAM,EAAE,eAAe;oBACvB,OAAO,EAAE,aAAa,CAAC,OAAO;oBAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;iBACd;aACvB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;YAC9C,OAAO,IAAA,UAAE,EAAC;gBACR;oBACE,IAAI,EAAE,iBAAiB;oBACvB,MAAM,EAAE,eAAe;oBACvB,OAAO,EAAE,aAAa,CAAC,OAAO;oBAC9B,MAAM,EAAE,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;oBAC1F,aAAa,EAAE,KAAK,CAAC,aAAa;iBAChB;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAxED,sCAwEC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Mojentic - Modern LLM integration framework for TypeScript
+ */
+export * from './error';
+export * from './llm';
+export * from './tracer';
+export * from './agents';
+export * from './context';
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAG1B,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Mojentic - Modern LLM integration framework for TypeScript
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+__exportStar(require("./error"), exports);
+__exportStar(require("./llm"), exports);
+__exportStar(require("./tracer"), exports);
+__exportStar(require("./agents"), exports);
+__exportStar(require("./context"), exports);
+// Version
+exports.VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,wCAAsB;AACtB,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAE1B,UAAU;AACG,QAAA,OAAO,GAAG,OAAO,CAAC"}

package/dist/llm/agent.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Agent - Simple agent with LLM broker, tools, and behavior
+ */
+import { LlmBroker } from './broker';
+import { LlmTool } from './tools';
+import { LlmMessage } from './models';
+import { Result } from '../error';
+/**
+ * A simple agent that combines an LLM broker with tools and behavior.
+ * Agents can be composed and used as tools by other agents through ToolWrapper.
+ *
+ * @example
+ * ```typescript
+ * const agent = new Agent(
+ *   new LlmBroker('qwen3:32b', gateway),
+ *   [new DateResolverTool()],
+ *   'You are a helpful assistant that can resolve dates.'
+ * );
+ *
+ * const result = await agent.generate('What day is next Friday?');
+ * ```
+ */
+export declare class Agent {
+    private readonly broker;
+    private readonly tools;
+    private readonly behavior;
+    /**
+     * Creates a new agent instance.
+     *
+     * @param broker - The LLM broker to use for generation
+     * @param tools - Array of tools available to the agent
+     * @param behavior - System message defining agent's personality and behavior
+     */
+    constructor(broker: LlmBroker, tools?: LlmTool[], behavior?: string);
+    /**
+     * Generate a response to user input.
+     *
+     * @param input - User input string
+     * @returns Result containing the agent's response or an error
+     */
+    generate(input: string): Promise<Result<string, Error>>;
+    /**
+     * Create initial messages with system behavior.
+     * Can be used by ToolWrapper to set up agent context.
+     *
+     * @internal
+     */
+    createInitialMessages(): LlmMessage[];
+    /**
+     * Get the agent's broker.
+     *
+     * @internal
+     */
+    getBroker(): LlmBroker;
+    /**
+     * Get the agent's tools.
+     *
+     * @internal
+     */
+    getTools(): LlmTool[];
+    /**
+     * Get the agent's behavior.
+     *
+     * @internal
+     */
+    getBehavior(): string;
+}
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/llm/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAW,UAAU,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,KAAK;IASd,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAV3B;;;;;;OAMG;gBAEgB,MAAM,EAAE,SAAS,EACjB,KAAK,GAAE,OAAO,EAAO,EACrB,QAAQ,GAAE,MAAuC;IAGpE;;;;;OAKG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAM7D;;;;;OAKG;IACH,qBAAqB,IAAI,UAAU,EAAE;IAIrC;;;;OAIG;IACH,SAAS,IAAI,SAAS;IAItB;;;;OAIG;IACH,QAAQ,IAAI,OAAO,EAAE;IAIrB;;;;OAIG;IACH,WAAW,IAAI,MAAM;CAGtB"}

package/dist/llm/agent.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Agent - Simple agent with LLM broker, tools, and behavior
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agent = void 0;
+const models_1 = require("./models");
+/**
+ * A simple agent that combines an LLM broker with tools and behavior.
+ * Agents can be composed and used as tools by other agents through ToolWrapper.
+ *
+ * @example
+ * ```typescript
+ * const agent = new Agent(
+ *   new LlmBroker('qwen3:32b', gateway),
+ *   [new DateResolverTool()],
+ *   'You are a helpful assistant that can resolve dates.'
+ * );
+ *
+ * const result = await agent.generate('What day is next Friday?');
+ * ```
+ */
+class Agent {
+    broker;
+    tools;
+    behavior;
+    /**
+     * Creates a new agent instance.
+     *
+     * @param broker - The LLM broker to use for generation
+     * @param tools - Array of tools available to the agent
+     * @param behavior - System message defining agent's personality and behavior
+     */
+    constructor(broker, tools = [], behavior = 'You are a helpful assistant.') {
+        this.broker = broker;
+        this.tools = tools;
+        this.behavior = behavior;
+    }
+    /**
+     * Generate a response to user input.
+     *
+     * @param input - User input string
+     * @returns Result containing the agent's response or an error
+     */
+    async generate(input) {
+        const messages = this.createInitialMessages();
+        messages.push(models_1.Message.user(input));
+        return this.broker.generate(messages, this.tools);
+    }
+    /**
+     * Create initial messages with system behavior.
+     * Can be used by ToolWrapper to set up agent context.
+     *
+     * @internal
+     */
+    createInitialMessages() {
+        return [models_1.Message.system(this.behavior)];
+    }
+    /**
+     * Get the agent's broker.
+     *
+     * @internal
+     */
+    getBroker() {
+        return this.broker;
+    }
+    /**
+     * Get the agent's tools.
+     *
+     * @internal
+     */
+    getTools() {
+        return this.tools;
+    }
+    /**
+     * Get the agent's behavior.
+     *
+     * @internal
+     */
+    getBehavior() {
+        return this.behavior;
+    }
+}
+exports.Agent = Agent;
+//# sourceMappingURL=agent.js.map

package/dist/llm/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/llm/agent.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH,qCAA+C;AAG/C;;;;;;;;;;;;;;GAcG;AACH,MAAa,KAAK;IASG;IACA;IACA;IAVnB;;;;;;OAMG;IACH,YACmB,MAAiB,EACjB,QAAmB,EAAE,EACrB,WAAmB,8BAA8B;QAFjD,WAAM,GAAN,MAAM,CAAW;QACjB,UAAK,GAAL,KAAK,CAAgB;QACrB,aAAQ,GAAR,QAAQ,CAAyC;IACjE,CAAC;IAEJ;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,KAAa;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,gBAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACH,qBAAqB;QACnB,OAAO,CAAC,gBAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AA9DD,sBA8DC"}