mojentic 1.0.0

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

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * Decision-making agent for the ReAct pattern.
+ *
+ * This agent evaluates the current context and decides on the next action to take.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecisioningAgent = void 0;
+const error_1 = require("../../error");
+const models_1 = require("../../llm/models");
+const date_resolver_1 = require("../../llm/tools/date-resolver");
+const models_2 = require("./models");
+const formatters_1 = require("./formatters");
+/**
+ * Agent responsible for deciding the next action in the ReAct loop.
+ *
+ * This agent evaluates the current context, plan, and history to determine
+ * whether to continue planning, take an action, or finish and summarize.
+ */
+class DecisioningAgent {
+    llm;
+    static MAX_ITERATIONS = 10;
+    tools;
+    /**
+     * Initialize the decisioning agent.
+     *
+     * @param llm - The LLM broker to use for generating decisions
+     */
+    constructor(llm) {
+        this.llm = llm;
+        this.tools = [new date_resolver_1.DateResolverTool()];
+    }
+    /**
+     * Process a decisioning event and determine the next action.
+     *
+     * @param event - The decisioning event containing current context
+     * @returns Result containing one of: InvokeToolCall, FinishAndSummarize, InvokeThinking, or FailureOccurred event
+     */
+    async receiveEventAsync(event) {
+        if (event.type !== 'InvokeDecisioning') {
+            return (0, error_1.Ok)([]);
+        }
+        const decisioningEvent = event;
+        // Check iteration limit
+        if (decisioningEvent.context.iteration >= DecisioningAgent.MAX_ITERATIONS) {
+            return (0, error_1.Ok)([
+                {
+                    type: 'FailureOccurred',
+                    source: 'DecisioningAgent',
+                    context: decisioningEvent.context,
+                    reason: `Maximum iterations (${DecisioningAgent.MAX_ITERATIONS}) exceeded`,
+                    correlationId: event.correlationId,
+                },
+            ]);
+        }
+        // Increment iteration counter
+        decisioningEvent.context.iteration += 1;
+        const prompt = this.buildPrompt(decisioningEvent);
+        console.log(this.formatBlock(prompt));
+        try {
+            // Define schema for DecisionResponse
+            const schema = {
+                type: 'object',
+                properties: {
+                    thought: {
+                        type: 'string',
+                        description: 'The reasoning behind the decision',
+                    },
+                    nextAction: {
+                        type: 'string',
+                        description: 'What should happen next: PLAN, ACT, or FINISH',
+                        enum: ['PLAN', 'ACT', 'FINISH'],
+                    },
+                    toolName: {
+                        type: 'string',
+                        description: 'Name of tool to use if nextAction is ACT',
+                    },
+                    toolArguments: {
+                        type: 'object',
+                        description: 'Arguments for the tool if nextAction is ACT. IMPORTANT: Use the exact parameter names from the tool descriptor. For resolve_date, use "date_string" not "relative_date_found".',
+                    },
+                },
+                required: ['thought', 'nextAction'],
+            };
+            const result = await this.llm.generateObject([models_1.Message.user(prompt)], schema);
+            if (!result.ok) {
+                return (0, error_1.Ok)([
+                    {
+                        type: 'FailureOccurred',
+                        source: 'DecisioningAgent',
+                        context: decisioningEvent.context,
+                        reason: `Error during decision making: ${result.error.message}`,
+                        correlationId: event.correlationId,
+                    },
+                ]);
+            }
+            const decision = result.value;
+            console.log(this.formatBlock(`Decision: ${JSON.stringify(decision, null, 2)}`));
+            // Route based on decision
+            if (decision.nextAction === models_2.NextAction.FINISH) {
+                return (0, error_1.Ok)([
+                    {
+                        type: 'FinishAndSummarize',
+                        source: 'DecisioningAgent',
+                        context: decisioningEvent.context,
+                        thought: decision.thought,
+                        correlationId: event.correlationId,
+                    },
+                ]);
+            }
+            if (decision.nextAction === models_2.NextAction.ACT) {
+                if (!decision.toolName) {
+                    return (0, error_1.Ok)([
+                        {
+                            type: 'FailureOccurred',
+                            source: 'DecisioningAgent',
+                            context: decisioningEvent.context,
+                            reason: 'ACT decision made but no tool specified',
+                            correlationId: event.correlationId,
+                        },
+                    ]);
+                }
+                // Find the requested tool
+                const tool = this.tools.find((t) => t.descriptor().function.name === decision.toolName);
+                if (!tool) {
+                    return (0, error_1.Ok)([
+                        {
+                            type: 'FailureOccurred',
+                            source: 'DecisioningAgent',
+                            context: decisioningEvent.context,
+                            reason: `Tool '${decision.toolName}' not found`,
+                            correlationId: event.correlationId,
+                        },
+                    ]);
+                }
+                return (0, error_1.Ok)([
+                    {
+                        type: 'InvokeToolCall',
+                        source: 'DecisioningAgent',
+                        context: decisioningEvent.context,
+                        thought: decision.thought,
+                        action: models_2.NextAction.ACT,
+                        tool,
+                        toolArguments: decision.toolArguments || {},
+                        correlationId: event.correlationId,
+                    },
+                ]);
+            }
+            // PLAN action - go back to thinking
+            return (0, error_1.Ok)([
+                {
+                    type: 'InvokeThinking',
+                    source: 'DecisioningAgent',
+                    context: decisioningEvent.context,
+                    correlationId: event.correlationId,
+                },
+            ]);
+        }
+        catch (error) {
+            return (0, error_1.Ok)([
+                {
+                    type: 'FailureOccurred',
+                    source: 'DecisioningAgent',
+                    context: decisioningEvent.context,
+                    reason: `Error during decision making: ${error instanceof Error ? error.message : String(error)}`,
+                    correlationId: event.correlationId,
+                },
+            ]);
+        }
+    }
+    /**
+     * Generate the prompt for the decision-making LLM.
+     *
+     * @param event - The decisioning 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:
+Review the current plan and history. Decide what to do next:
+
+1. PLAN - If the plan is incomplete or needs refinement
+2. ACT - If you should take an action using one of the available tools
+3. FINISH - If you have enough information to answer the user's query
+
+If you choose ACT, specify which tool to use and what arguments to pass.
+Think carefully about whether each step in the plan has been completed.`;
+    }
+    /**
+     * 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.DecisioningAgent = DecisioningAgent;
+//# sourceMappingURL=decisioning-agent.js.map

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

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

package/dist/examples/react/events.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Event definitions for the ReAct pattern.
+ *
+ * This module defines all event types used to coordinate the ReAct loop,
+ * including thinking, decisioning, tool calls, completion, and failure events.
+ */
+import { Event } from '../../agents/event';
+import { CurrentContext, NextAction } from './models';
+import { LlmTool } from '../../llm/tools';
+/**
+ * Event to trigger the thinking/planning phase.
+ *
+ * This event initiates the planning process where the agent creates
+ * or refines a plan for answering the user's query.
+ */
+export interface InvokeThinking extends Event {
+    type: 'InvokeThinking';
+    /** The current context as we work through our response */
+    context: CurrentContext;
+}
+/**
+ * Event to trigger the decision-making phase.
+ *
+ * This event initiates the decision process where the agent evaluates
+ * the current plan and history to decide on the next action.
+ */
+export interface InvokeDecisioning extends Event {
+    type: 'InvokeDecisioning';
+    /** The current context as we work through our response */
+    context: CurrentContext;
+}
+/**
+ * Event to trigger a tool invocation.
+ *
+ * This event carries the information needed to execute a specific tool
+ * with given arguments, along with the reasoning behind the decision.
+ */
+export interface InvokeToolCall extends Event {
+    type: 'InvokeToolCall';
+    /** The current context as we work through our response */
+    context: CurrentContext;
+    /** The reasoning behind the decision */
+    thought: string;
+    /** The next action type */
+    action: NextAction;
+    /** The tool instance to invoke */
+    tool: LlmTool;
+    /** Arguments to pass to the tool */
+    toolArguments: Record<string, unknown>;
+}
+/**
+ * Event to trigger the completion and summarization phase.
+ *
+ * This event indicates that the agent has gathered sufficient information
+ * to answer the user's query and should generate a final response.
+ */
+export interface FinishAndSummarize extends Event {
+    type: 'FinishAndSummarize';
+    /** The current context as we work through our response */
+    context: CurrentContext;
+    /** The reasoning behind the decision */
+    thought: string;
+}
+/**
+ * Event to signal a failure in the ReAct loop.
+ *
+ * This event captures errors or unrecoverable situations that prevent
+ * the agent from continuing to process the user's query.
+ */
+export interface FailureOccurred extends Event {
+    type: 'FailureOccurred';
+    /** The current context as we work through our response */
+    context: CurrentContext;
+    /** The reason for the failure */
+    reason: string;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/examples/react/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/examples/react/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK;IAC3C,IAAI,EAAE,gBAAgB,CAAC;IACvB,0DAA0D;IAC1D,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAkB,SAAQ,KAAK;IAC9C,IAAI,EAAE,mBAAmB,CAAC;IAC1B,0DAA0D;IAC1D,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK;IAC3C,IAAI,EAAE,gBAAgB,CAAC;IACvB,0DAA0D;IAC1D,OAAO,EAAE,cAAc,CAAC;IACxB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,kCAAkC;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAmB,SAAQ,KAAK;IAC/C,IAAI,EAAE,oBAAoB,CAAC;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,cAAc,CAAC;IACxB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,KAAK;IAC5C,IAAI,EAAE,iBAAiB,CAAC;IACxB,0DAA0D;IAC1D,OAAO,EAAE,cAAc,CAAC;IACxB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/examples/react/events.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Event definitions for the ReAct pattern.
+ *
+ * This module defines all event types used to coordinate the ReAct loop,
+ * including thinking, decisioning, tool calls, completion, and failure events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=events.js.map

package/dist/examples/react/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/examples/react/events.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/examples/react/formatters.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Formatting utilities for the ReAct pattern implementation.
+ *
+ * This module provides helper functions for formatting context and tool information
+ * into human-readable strings for LLM prompts.
+ */
+import { CurrentContext } from './models';
+import { LlmTool } from '../../llm/tools';
+/**
+ * Format the current context into a readable string.
+ *
+ * @param context - The current context containing query, plan, and history
+ * @returns A formatted multi-line string describing the current context
+ */
+export declare function formatCurrentContext(context: CurrentContext): string;
+/**
+ * Format the available tools into a readable list.
+ *
+ * @param tools - A list of tool objects with descriptor methods
+ * @returns A formatted string listing available tools and their descriptions
+ */
+export declare function formatAvailableTools(tools: LlmTool[]): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/examples/react/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../src/examples/react/formatters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAuBpE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAgC7D"}

package/dist/examples/react/formatters.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Formatting utilities for the ReAct pattern implementation.
+ *
+ * This module provides helper functions for formatting context and tool information
+ * into human-readable strings for LLM prompts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatCurrentContext = formatCurrentContext;
+exports.formatAvailableTools = formatAvailableTools;
+/**
+ * Format the current context into a readable string.
+ *
+ * @param context - The current context containing query, plan, and history
+ * @returns A formatted multi-line string describing the current context
+ */
+function formatCurrentContext(context) {
+    const userQuery = `The user has asked us to answer the following query:\n> ${context.userQuery}\n`;
+    let plan = 'You have not yet made a plan.\n';
+    if (context.plan.steps.length > 0) {
+        plan = 'Current plan:\n';
+        plan += context.plan.steps.map((step) => `- ${step}`).join('\n');
+        plan += '\n';
+    }
+    let history = 'No steps have yet been taken.\n';
+    if (context.history.length > 0) {
+        history = "What's been done so far:\n";
+        history += context.history
+            .map((step, i) => `${i + 1}.\n    Thought: ${step.thought}\n    Action: ${step.action}\n    Observation: ${step.observation}`)
+            .join('\n');
+        history += '\n';
+    }
+    return `Current Context:\n${userQuery}${plan}${history}\n`;
+}
+/**
+ * Format the available tools into a readable list.
+ *
+ * @param tools - A list of tool objects with descriptor methods
+ * @returns A formatted string listing available tools and their descriptions
+ */
+function formatAvailableTools(tools) {
+    let output = '';
+    if (tools.length > 0) {
+        output += 'Tools available:\n';
+        for (const tool of tools) {
+            const descriptor = tool.descriptor();
+            const funcDescriptor = descriptor.function;
+            output += `- ${funcDescriptor.name}: ${funcDescriptor.description}\n`;
+            // Add parameter information
+            if (funcDescriptor.parameters) {
+                const params = funcDescriptor.parameters;
+                if (params.properties) {
+                    output += '  Parameters:\n';
+                    const properties = params.properties;
+                    const required = params.required || [];
+                    for (const [paramName, paramInfo] of Object.entries(properties)) {
+                        const paramDesc = paramInfo.description || '';
+                        const isRequired = required.includes(paramName);
+                        const reqStr = isRequired ? ' (required)' : ' (optional)';
+                        output += `    - ${paramName}${reqStr}: ${paramDesc}\n`;
+                    }
+                }
+            }
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/examples/react/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../../src/examples/react/formatters.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAWH,oDAuBC;AAQD,oDAgCC;AArED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,OAAuB;IAC1D,MAAM,SAAS,GAAG,2DAA2D,OAAO,CAAC,SAAS,IAAI,CAAC;IAEnG,IAAI,IAAI,GAAG,iCAAiC,CAAC;IAC7C,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,IAAI,GAAG,iBAAiB,CAAC;QACzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,IAAI,IAAI,CAAC;IACf,CAAC;IAED,IAAI,OAAO,GAAG,iCAAiC,CAAC;IAChD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,GAAG,4BAA4B,CAAC;QACvC,OAAO,IAAI,OAAO,CAAC,OAAO;aACvB,GAAG,CACF,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACV,GAAG,CAAC,GAAG,CAAC,mBAAmB,IAAI,CAAC,OAAO,iBAAiB,IAAI,CAAC,MAAM,sBAAsB,IAAI,CAAC,WAAW,EAAE,CAC9G;aACA,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,OAAO,qBAAqB,SAAS,GAAG,IAAI,GAAG,OAAO,IAAI,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,KAAgB;IACnD,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,oBAAoB,CAAC;QAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACrC,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;YAE3C,MAAM,IAAI,KAAK,cAAc,CAAC,IAAI,KAAK,cAAc,CAAC,WAAW,IAAI,CAAC;YAEtE,4BAA4B;YAC5B,IAAI,cAAc,CAAC,UAAU,EAAE,CAAC;gBAC9B,MAAM,MAAM,GAAG,cAAc,CAAC,UAAqC,CAAC;gBACpE,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;oBACtB,MAAM,IAAI,iBAAiB,CAAC;oBAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAqD,CAAC;oBAChF,MAAM,QAAQ,GAAI,MAAM,CAAC,QAAqB,IAAI,EAAE,CAAC;oBAErD,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;wBAChE,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,IAAI,EAAE,CAAC;wBAC9C,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;wBAChD,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC;wBAC1D,MAAM,IAAI,SAAS,SAAS,GAAG,MAAM,KAAK,SAAS,IAAI,CAAC;oBAC1D,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/examples/react/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ReAct Pattern Example - Module exports
+ */
+export * from './models';
+export * from './events';
+export * from './formatters';
+export * from './thinking-agent';
+export * from './decisioning-agent';
+export * from './tool-call-agent';
+export * from './summarization-agent';
+export * from './output-agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/examples/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/examples/react/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC"}

package/dist/examples/react/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * ReAct Pattern Example - Module exports
+ */
+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 });
+__exportStar(require("./models"), exports);
+__exportStar(require("./events"), exports);
+__exportStar(require("./formatters"), exports);
+__exportStar(require("./thinking-agent"), exports);
+__exportStar(require("./decisioning-agent"), exports);
+__exportStar(require("./tool-call-agent"), exports);
+__exportStar(require("./summarization-agent"), exports);
+__exportStar(require("./output-agent"), exports);
+//# sourceMappingURL=index.js.map

package/dist/examples/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/examples/react/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,2CAAyB;AACzB,+CAA6B;AAC7B,mDAAiC;AACjC,sDAAoC;AACpC,oDAAkC;AAClC,wDAAsC;AACtC,iDAA+B"}

package/dist/examples/react/models.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Base data models for the ReAct pattern.
+ *
+ * This module defines the core data structures used throughout the ReAct
+ * implementation, including actions, plans, observations, and context.
+ */
+/**
+ * Enumeration of possible next actions in the ReAct loop.
+ */
+export declare enum NextAction {
+    PLAN = "PLAN",
+    ACT = "ACT",
+    FINISH = "FINISH"
+}
+/**
+ * A single step in the ReAct loop capturing thought, action, and observation.
+ *
+ * This model represents one iteration of the ReAct pattern where the agent:
+ * 1. Thinks about what to do
+ * 2. Takes an action
+ * 3. Observes the result
+ */
+export interface ThoughtActionObservation {
+    /** The thought process behind the action taken in the current context */
+    thought: string;
+    /** The action taken in the current context */
+    action: string;
+    /** The observation made after the action taken in the current context */
+    observation: string;
+}
+/**
+ * A structured plan for solving a user query.
+ *
+ * Contains a list of steps that outline how to approach answering the query.
+ */
+export interface Plan {
+    /** How to answer the query, step by step, each step outlining an action to take */
+    steps: string[];
+}
+/**
+ * The complete context for a ReAct session.
+ *
+ * This model tracks everything needed to maintain state throughout the
+ * reasoning and acting loop, including the user's query, the plan,
+ * the history of actions, and the iteration count.
+ */
+export interface CurrentContext {
+    /** The user query to which we are responding */
+    userQuery: string;
+    /** The current plan of action for the current context */
+    plan: Plan;
+    /** The history of actions taken and observations made in the current context */
+    history: ThoughtActionObservation[];
+    /** The number of iterations taken in the current context */
+    iteration: number;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/examples/react/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../src/examples/react/models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,oBAAY,UAAU;IACpB,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,MAAM,WAAW;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,IAAI;IACnB,mFAAmF;IACnF,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,IAAI,EAAE,IAAI,CAAC;IACX,gFAAgF;IAChF,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/examples/react/models.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Base data models for the ReAct pattern.
+ *
+ * This module defines the core data structures used throughout the ReAct
+ * implementation, including actions, plans, observations, and context.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NextAction = void 0;
+/**
+ * Enumeration of possible next actions in the ReAct loop.
+ */
+var NextAction;
+(function (NextAction) {
+    NextAction["PLAN"] = "PLAN";
+    NextAction["ACT"] = "ACT";
+    NextAction["FINISH"] = "FINISH";
+})(NextAction || (exports.NextAction = NextAction = {}));
+//# sourceMappingURL=models.js.map

package/dist/examples/react/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/examples/react/models.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;GAEG;AACH,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,yBAAW,CAAA;IACX,+BAAiB,CAAA;AACnB,CAAC,EAJW,UAAU,0BAAV,UAAU,QAIrB"}

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

@@ -0,0 +1,23 @@
+/**
+ * Simple output agent for displaying events in the ReAct pattern.
+ *
+ * This agent logs event information for debugging and monitoring purposes.
+ */
+import { BaseAsyncAgent } from '../../agents/base-async-agent';
+import { Event } from '../../agents/event';
+import { Result } from '../../error';
+/**
+ * Agent responsible for outputting event information.
+ *
+ * This agent receives all events and logs them for monitoring the ReAct workflow.
+ */
+export declare class OutputAgent implements BaseAsyncAgent {
+    /**
+     * Process an event and log its information.
+     *
+     * @param event - The event to process
+     * @returns Empty array (this agent doesn't produce new events)
+     */
+    receiveEventAsync(event: Event): Promise<Result<Event[], Error>>;
+}
+//# sourceMappingURL=output-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output-agent.d.ts","sourceRoot":"","sources":["../../../src/examples/react/output-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;AAEzC;;;;GAIG;AACH,qBAAa,WAAY,YAAW,cAAc;IAChD;;;;;OAKG;IACG,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;CAIvE"}

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

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Simple output agent for displaying events in the ReAct pattern.
+ *
+ * This agent logs event information for debugging and monitoring purposes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutputAgent = void 0;
+const error_1 = require("../../error");
+/**
+ * Agent responsible for outputting event information.
+ *
+ * This agent receives all events and logs them for monitoring the ReAct workflow.
+ */
+class OutputAgent {
+    /**
+     * Process an event and log its information.
+     *
+     * @param event - The event to process
+     * @returns Empty array (this agent doesn't produce new events)
+     */
+    async receiveEventAsync(event) {
+        console.log(`\n[Event: ${event.type}] Source: ${event.source}`);
+        return (0, error_1.Ok)([]);
+    }
+}
+exports.OutputAgent = OutputAgent;
+//# sourceMappingURL=output-agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output-agent.js","sourceRoot":"","sources":["../../../src/examples/react/output-agent.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAIH,uCAAyC;AAEzC;;;;GAIG;AACH,MAAa,WAAW;IACtB;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CAAC,KAAY;QAClC,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAChE,OAAO,IAAA,UAAE,EAAC,EAAE,CAAC,CAAC;IAChB,CAAC;CACF;AAXD,kCAWC"}

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

@@ -0,0 +1,46 @@
+/**
+ * Summarization agent for the ReAct pattern.
+ *
+ * This agent generates the final answer based on accumulated context.
+ */
+import { BaseAsyncAgent } from '../../agents/base-async-agent';
+import { Event } from '../../agents/event';
+import { Result } from '../../error';
+import { LlmBroker } from '../../llm/broker';
+/**
+ * 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.
+ */
+export declare class SummarizationAgent implements BaseAsyncAgent {
+    private readonly llm;
+    /**
+     * Initialize the summarization agent.
+     *
+     * @param llm - The LLM broker to use for generating summaries
+     */
+    constructor(llm: LlmBroker);
+    /**
+     * 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
+     */
+    receiveEventAsync(event: Event): Promise<Result<Event[], Error>>;
+    /**
+     * Generate the prompt for the summarization LLM.
+     *
+     * @param event - The finish event containing the complete 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=summarization-agent.d.ts.map