mojentic 1.0.0

package/dist/agents/async-llm-agent-with-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-llm-agent-with-memory.js","sourceRoot":"","sources":["../../src/agents/async-llm-agent-with-memory.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAAuE;AAEvE,0CAAoD;AACpD,oCAA4C;AAc5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAsB,uBAAwB,SAAQ,+BAAa;IAC9C,MAAM,CAAsB;IAC5B,YAAY,CAAS;IAExC,YAAY,MAAqC;QAC/C,KAAK,CAAC;YACJ,GAAG,MAAM;YACT,2EAA2E;YAC3E,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC1C,CAAC;IAED;;;;;;;;;OASG;IACO,+BAA+B;QACvC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAErD,OAAO;YACL,gBAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;YAC9B,gBAAO,CAAC,IAAI,CACV,+BAA+B,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM;gBACzE,wFAAwF,CAC3F;YACD,gBAAO,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;SAChC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACO,KAAK,CAAC,0BAA0B,CAAI,OAAe;QAC3D,6DAA6D;QAC7D,MAAM,wBAAwB,GAAG;YAC/B,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAI,IAAI,CAAC,aAAa,EAAE,UAAsC;gBAC9D,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8CAA8C;oBAC3D,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;iBACxC;aACF;YACD,QAAQ,EAAE,CAAC,GAAG,CAAE,IAAI,CAAC,aAAa,EAAE,QAAqB,IAAI,EAAE,CAAC,CAAC;SAClE,CAAC;QAEF,qCAAqC;QACrC,MAAM,QAAQ,GAAiB;YAC7B,GAAG,IAAI,CAAC,+BAA+B,EAAE;YACzC,gBAAO,CAAC,IAAI,CAAC,OAAO,CAAC;SACtB,CAAC;QAEF,+BAA+B;QAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAC7C,QAAQ,EACR,wBAAwB,CACzB,CAAC;QAEF,IAAI,IAAA,YAAI,EAAC,MAAM,CAAC,EAAE,CAAC;YACjB,MAAM,kBAAkB,GAAG,MAAM,CAAC,KAAK,CAAC;YAExC,sCAAsC;YACtC,IAAI,kBAAkB,CAAC,MAAM,EAAE,CAAC;gBAC9B,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAC9D,CAAC;YAED,qDAAqD;YACrD,6DAA6D;YAC7D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,qBAAqB,EAAE,GAAG,kBAAkB,CAAC;YAEzE,OAAO,IAAA,UAAE,EAAC,qBAA0B,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,MAA0B,CAAC;IACpC,CAAC;CACF;AA7FD,0DA6FC"}

package/dist/agents/async-llm-agent.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Async LLM Agent - Base class for agents that use LLMs to generate responses
+ */
+import { BaseAsyncAgent } from './base-async-agent';
+import { Event } from './event';
+import { LlmBroker } from '../llm/broker';
+import { LlmTool } from '../llm/tools';
+import { Result } from '../error';
+/**
+ * Configuration for AsyncLlmAgent
+ */
+export interface AsyncLlmAgentConfig {
+    /** The LLM broker to use for generating responses */
+    broker: LlmBroker;
+    /** System prompt defining the agent's behavior and personality */
+    behaviour: string;
+    /** Optional JSON schema for structured output */
+    responseModel?: Record<string, unknown>;
+    /** Optional tools the agent can use */
+    tools?: LlmTool[];
+}
+/**
+ * Base class for async agents that use an LLM to generate responses.
+ *
+ * This agent wraps an LLM broker and provides convenient methods for
+ * generating text or structured responses. Subclasses implement
+ * `receiveEventAsync` to define their event handling logic.
+ *
+ * @example
+ * ```typescript
+ * class FactCheckerAgent extends AsyncLlmAgent {
+ *   constructor(broker: LlmBroker) {
+ *     super({
+ *       broker,
+ *       behaviour: 'You are a fact-checking assistant.',
+ *       responseModel: factCheckSchema
+ *     });
+ *   }
+ *
+ *   async receiveEventAsync(event: Event): Promise<Result<Event[], Error>> {
+ *     if (isQuestionEvent(event)) {
+ *       const result = await this.generateResponse<FactCheckResponse>(
+ *         `Check facts about: ${event.question}`
+ *       );
+ *       if (isOk(result)) {
+ *         return Ok([new FactCheckEvent({ facts: result.value.facts })]);
+ *       }
+ *     }
+ *     return Ok([]);
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class AsyncLlmAgent implements BaseAsyncAgent {
+    protected readonly broker: LlmBroker;
+    protected readonly behaviour: string;
+    protected readonly responseModel?: Record<string, unknown>;
+    protected readonly tools: LlmTool[];
+    constructor(config: AsyncLlmAgentConfig);
+    /**
+     * Add a tool to the agent's available tools.
+     *
+     * @param tool - The tool to add
+     */
+    addTool(tool: LlmTool): void;
+    /**
+     * Generate a response from the LLM.
+     *
+     * If a responseModel is configured, returns structured output conforming to the schema.
+     * Otherwise, returns plain text.
+     *
+     * @param content - The user message content to send to the LLM
+     * @returns Result containing the LLM response or an error
+     */
+    protected generateResponse<T = string>(content: string): Promise<Result<T, Error>>;
+    /**
+     * Process an incoming event and optionally produce new events.
+     * Must be implemented by subclasses.
+     *
+     * @param event - The event to process
+     * @returns Result containing array of new events or an error
+     */
+    abstract receiveEventAsync(event: Event): Promise<Result<Event[], Error>>;
+}
+//# sourceMappingURL=async-llm-agent.d.ts.map

package/dist/agents/async-llm-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-llm-agent.d.ts","sourceRoot":"","sources":["../../src/agents/async-llm-agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAY,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,MAAM,EAAE,SAAS,CAAC;IAClB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,8BAAsB,aAAc,YAAW,cAAc;IAC3D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3D,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;gBAExB,MAAM,EAAE,mBAAmB;IAOvC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAI5B;;;;;;;;OAQG;cACa,gBAAgB,CAAC,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAiBxF;;;;;;OAMG;IACH,QAAQ,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;CAC1E"}

package/dist/agents/async-llm-agent.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Async LLM Agent - Base class for agents that use LLMs to generate responses
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncLlmAgent = void 0;
+const models_1 = require("../llm/models");
+const error_1 = require("../error");
+/**
+ * Base class for async agents that use an LLM to generate responses.
+ *
+ * This agent wraps an LLM broker and provides convenient methods for
+ * generating text or structured responses. Subclasses implement
+ * `receiveEventAsync` to define their event handling logic.
+ *
+ * @example
+ * ```typescript
+ * class FactCheckerAgent extends AsyncLlmAgent {
+ *   constructor(broker: LlmBroker) {
+ *     super({
+ *       broker,
+ *       behaviour: 'You are a fact-checking assistant.',
+ *       responseModel: factCheckSchema
+ *     });
+ *   }
+ *
+ *   async receiveEventAsync(event: Event): Promise<Result<Event[], Error>> {
+ *     if (isQuestionEvent(event)) {
+ *       const result = await this.generateResponse<FactCheckResponse>(
+ *         `Check facts about: ${event.question}`
+ *       );
+ *       if (isOk(result)) {
+ *         return Ok([new FactCheckEvent({ facts: result.value.facts })]);
+ *       }
+ *     }
+ *     return Ok([]);
+ *   }
+ * }
+ * ```
+ */
+class AsyncLlmAgent {
+    broker;
+    behaviour;
+    responseModel;
+    tools;
+    constructor(config) {
+        this.broker = config.broker;
+        this.behaviour = config.behaviour;
+        this.responseModel = config.responseModel;
+        this.tools = config.tools || [];
+    }
+    /**
+     * Add a tool to the agent's available tools.
+     *
+     * @param tool - The tool to add
+     */
+    addTool(tool) {
+        this.tools.push(tool);
+    }
+    /**
+     * Generate a response from the LLM.
+     *
+     * If a responseModel is configured, returns structured output conforming to the schema.
+     * Otherwise, returns plain text.
+     *
+     * @param content - The user message content to send to the LLM
+     * @returns Result containing the LLM response or an error
+     */
+    async generateResponse(content) {
+        const messages = [models_1.Message.system(this.behaviour), models_1.Message.user(content)];
+        if (this.responseModel) {
+            // Generate structured object
+            const result = await this.broker.generateObject(messages, this.responseModel);
+            return result;
+        }
+        else {
+            // Generate text with optional tools
+            const result = await this.broker.generate(messages, this.tools);
+            if ((0, error_1.isOk)(result)) {
+                return (0, error_1.Ok)(result.value);
+            }
+            return result;
+        }
+    }
+}
+exports.AsyncLlmAgent = AsyncLlmAgent;
+//# sourceMappingURL=async-llm-agent.js.map

package/dist/agents/async-llm-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-llm-agent.js","sourceRoot":"","sources":["../../src/agents/async-llm-agent.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAMH,0CAAwC;AACxC,oCAA4C;AAgB5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAsB,aAAa;IACd,MAAM,CAAY;IAClB,SAAS,CAAS;IAClB,aAAa,CAA2B;IACxC,KAAK,CAAY;IAEpC,YAAY,MAA2B;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAa;QACnB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;;;;;;;OAQG;IACO,KAAK,CAAC,gBAAgB,CAAa,OAAe;QAC1D,MAAM,QAAQ,GAAG,CAAC,gBAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,gBAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAEzE,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,6BAA6B;YAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAI,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YACjF,OAAO,MAAM,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,oCAAoC;YACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAChE,IAAI,IAAA,YAAI,EAAC,MAAM,CAAC,EAAE,CAAC;gBACjB,OAAO,IAAA,UAAE,EAAC,MAAM,CAAC,KAAU,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO,MAA0B,CAAC;QACpC,CAAC;IACH,CAAC;CAUF;AAxDD,sCAwDC"}

package/dist/agents/base-agent.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Base interface for synchronous agents
+ *
+ * Synchronous agents implement the `receiveEvent` method to process
+ * incoming events and return a list of new events. This is the simplest
+ * agent interface, suitable for agents that don't need to perform async
+ * operations.
+ *
+ * For agents that need to perform I/O, LLM calls, or other async operations,
+ * use `BaseAsyncAgent` instead.
+ *
+ * @example
+ * ```typescript
+ * class MyAgent implements BaseAgent {
+ *   receiveEvent(event: Event): Event[] {
+ *     // Process event synchronously
+ *     return [new MyResponseEvent({ data: process(event) })];
+ *   }
+ * }
+ * ```
+ */
+import { Event } from './event';
+/**
+ * Base interface that synchronous agents must implement.
+ *
+ * Agents process events and optionally produce new events in response.
+ * Processing is synchronous, making this suitable for simple transformations
+ * and coordination logic that doesn't require async operations.
+ *
+ * @example
+ * ```typescript
+ * class TransformAgent implements BaseAgent {
+ *   receiveEvent(event: Event): Event[] {
+ *     if (isDataEvent(event)) {
+ *       const transformed = this.transform(event.data);
+ *       return [new TransformedEvent({ data: transformed })];
+ *     }
+ *     return [];
+ *   }
+ * }
+ * ```
+ */
+export interface BaseAgent {
+    /**
+     * Process an incoming event and optionally produce new events.
+     *
+     * This method is called when an event is routed to this agent.
+     * The agent should process the event synchronously and return
+     * new events to continue the workflow.
+     *
+     * Returning an empty array means the event was processed but
+     * produced no follow-up events.
+     *
+     * @param event - The event to process
+     * @returns Array of new events to dispatch (can be empty)
+     */
+    receiveEvent(event: Event): Event[];
+}
+//# sourceMappingURL=base-agent.d.ts.map

package/dist/agents/base-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-agent.d.ts","sourceRoot":"","sources":["../../src/agents/base-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,CAAC;CACrC"}

package/dist/agents/base-agent.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Base interface for synchronous agents
+ *
+ * Synchronous agents implement the `receiveEvent` method to process
+ * incoming events and return a list of new events. This is the simplest
+ * agent interface, suitable for agents that don't need to perform async
+ * operations.
+ *
+ * For agents that need to perform I/O, LLM calls, or other async operations,
+ * use `BaseAsyncAgent` instead.
+ *
+ * @example
+ * ```typescript
+ * class MyAgent implements BaseAgent {
+ *   receiveEvent(event: Event): Event[] {
+ *     // Process event synchronously
+ *     return [new MyResponseEvent({ data: process(event) })];
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base-agent.js.map

package/dist/agents/base-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-agent.js","sourceRoot":"","sources":["../../src/agents/base-agent.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/agents/base-async-agent.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Base interface for asynchronous agents
+ */
+import { Event } from './event';
+import { Result } from '../error';
+/**
+ * Base interface that all async agents must implement.
+ *
+ * Agents process events and optionally produce new events in response.
+ * All processing is asynchronous, allowing agents to perform I/O operations
+ * like LLM calls without blocking.
+ *
+ * @example
+ * ```typescript
+ * class MyAgent implements BaseAsyncAgent {
+ *   async receiveEventAsync(event: Event): Promise<Result<Event[], Error>> {
+ *     if (isQuestionEvent(event)) {
+ *       const answer = await this.processQuestion(event.question);
+ *       return Ok([new AnswerEvent({ answer })]);
+ *     }
+ *     return Ok([]);
+ *   }
+ * }
+ * ```
+ */
+export interface BaseAsyncAgent {
+    /**
+     * Process an incoming event and optionally produce new events.
+     *
+     * This method is called by the dispatcher when an event is routed to this agent.
+     * The agent can perform asynchronous operations (LLM calls, database queries, etc.)
+     * and return new events to continue the workflow.
+     *
+     * Returning an empty array means the event was processed but produced no follow-up events.
+     * Returning an error Result indicates processing failure.
+     *
+     * @param event - The event to process
+     * @returns Result containing array of new events to dispatch, or an error
+     */
+    receiveEventAsync(event: Event): Promise<Result<Event[], Error>>;
+}
+//# sourceMappingURL=base-async-agent.d.ts.map

package/dist/agents/base-async-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-async-agent.d.ts","sourceRoot":"","sources":["../../src/agents/base-async-agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;CAClE"}

package/dist/agents/base-async-agent.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Base interface for asynchronous agents
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base-async-agent.js.map

package/dist/agents/base-async-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-async-agent.js","sourceRoot":"","sources":["../../src/agents/base-async-agent.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/agents/event.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Event system for agent communication
+ */
+/**
+ * Base event class for agent communication.
+ * Events are the primary mechanism for agents to communicate with each other.
+ */
+export interface Event {
+    /** Event type discriminator for type guards */
+    type?: string;
+    /** The type/class of the agent that created this event */
+    source: string;
+    /** Unique identifier linking related events in a conversation or workflow */
+    correlationId?: string;
+}
+/**
+ * Special event that signals the dispatcher to stop processing
+ */
+export interface TerminateEvent extends Event {
+    type: 'terminate';
+}
+/**
+ * Type guard to check if an event is a TerminateEvent
+ */
+export declare function isTerminateEvent(event: Event): event is TerminateEvent;
+//# sourceMappingURL=event.d.ts.map

package/dist/agents/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/agents/event.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK;IAC3C,IAAI,EAAE,WAAW,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,IAAI,cAAc,CAEtE"}

package/dist/agents/event.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Event system for agent communication
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTerminateEvent = isTerminateEvent;
+/**
+ * Type guard to check if an event is a TerminateEvent
+ */
+function isTerminateEvent(event) {
+    return event.type === 'terminate';
+}
+//# sourceMappingURL=event.js.map

package/dist/agents/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/agents/event.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAyBH,4CAEC;AALD;;GAEG;AACH,SAAgB,gBAAgB,CAAC,KAAY;IAC3C,OAAQ,KAAwB,CAAC,IAAI,KAAK,WAAW,CAAC;AACxD,CAAC"}

package/dist/agents/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Agent system for event-driven LLM workflows
+ */
+export * from './event';
+export * from './base-agent';
+export * from './base-async-agent';
+export * from './async-llm-agent';
+export * from './async-llm-agent-with-memory';
+export * from './async-aggregator-agent';
+export * from './async-dispatcher';
+export * from './router';
+export * from './iterative-problem-solver';
+export * from './simple-recursive-agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Agent system for event-driven LLM workflows
+ */
+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("./event"), exports);
+__exportStar(require("./base-agent"), exports);
+__exportStar(require("./base-async-agent"), exports);
+__exportStar(require("./async-llm-agent"), exports);
+__exportStar(require("./async-llm-agent-with-memory"), exports);
+__exportStar(require("./async-aggregator-agent"), exports);
+__exportStar(require("./async-dispatcher"), exports);
+__exportStar(require("./router"), exports);
+__exportStar(require("./iterative-problem-solver"), exports);
+__exportStar(require("./simple-recursive-agent"), exports);
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,+CAA6B;AAC7B,qDAAmC;AACnC,oDAAkC;AAClC,gEAA8C;AAC9C,2DAAyC;AACzC,qDAAmC;AACnC,2CAAyB;AACzB,6DAA2C;AAC3C,2DAAyC"}

package/dist/agents/iterative-problem-solver.d.ts

@@ -0,0 +1,83 @@
+/**
+ * IterativeProblemSolver - An agent that iteratively solves problems using available tools
+ */
+import { LlmBroker } from '../llm/broker';
+import { LlmTool } from '../llm/tools';
+/**
+ * Configuration for IterativeProblemSolver
+ */
+export interface IterativeProblemSolverConfig {
+    broker: LlmBroker;
+    tools?: LlmTool[];
+    maxIterations?: number;
+    systemPrompt?: string;
+    temperature?: number;
+}
+/**
+ * An agent that iteratively attempts to solve a problem using available tools.
+ *
+ * This solver uses a chat-based approach to break down and solve complex problems.
+ * It continues attempting to solve the problem until it either succeeds,
+ * fails explicitly, or reaches the maximum number of iterations.
+ *
+ * @example
+ * ```typescript
+ * const broker = new LlmBroker('qwen3:32b', new OllamaGateway());
+ * const solver = new IterativeProblemSolver({
+ *   broker,
+ *   tools: [new DateResolverTool()],
+ *   maxIterations: 5
+ * });
+ *
+ * const result = await solver.solve("What's the date next Friday?");
+ * console.log(result);
+ * ```
+ */
+export declare class IterativeProblemSolver {
+    private readonly chat;
+    private readonly maxIterations;
+    /**
+     * Create a new IterativeProblemSolver instance.
+     *
+     * @param config - Configuration options
+     */
+    constructor(config: IterativeProblemSolverConfig);
+    /**
+     * Execute the problem-solving process.
+     *
+     * This method runs the iterative problem-solving process, continuing until one of
+     * these conditions is met:
+     * - The task is completed successfully ("DONE")
+     * - The task fails explicitly ("FAIL")
+     * - The maximum number of iterations is reached
+     *
+     * @param problem - The problem or request to be solved
+     * @returns A summary of the final result, excluding the process details
+     */
+    solve(problem: string): Promise<string>;
+    /**
+     * Execute a single problem-solving step.
+     *
+     * This method sends a prompt to the chat session asking it to work on the user's request
+     * using available tools. The response should indicate success ("DONE") or failure ("FAIL").
+     *
+     * @param problem - The problem or request to be solved
+     * @returns The response from the chat session, indicating the step's outcome
+     */
+    private step;
+    /**
+     * Get the current chat messages (for inspection/debugging).
+     *
+     * @returns Array of messages in the chat session
+     */
+    getMessages(): import("..").LlmMessage[];
+    /**
+     * Clear the chat history except the system prompt.
+     */
+    clear(): void;
+    /**
+     * Clean up resources when done.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=iterative-problem-solver.d.ts.map

package/dist/agents/iterative-problem-solver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterative-problem-solver.d.ts","sourceRoot":"","sources":["../../src/agents/iterative-problem-solver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC;;;;OAIG;gBACS,MAAM,EAAE,4BAA4B;IAmBhD;;;;;;;;;;;OAWG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuB7C;;;;;;;;OAQG;YACW,IAAI;IAalB;;;;OAIG;IACH,WAAW;IAIX;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/agents/iterative-problem-solver.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * IterativeProblemSolver - An agent that iteratively solves problems using available tools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IterativeProblemSolver = void 0;
+const chat_session_1 = require("../llm/chat-session");
+/**
+ * An agent that iteratively attempts to solve a problem using available tools.
+ *
+ * This solver uses a chat-based approach to break down and solve complex problems.
+ * It continues attempting to solve the problem until it either succeeds,
+ * fails explicitly, or reaches the maximum number of iterations.
+ *
+ * @example
+ * ```typescript
+ * const broker = new LlmBroker('qwen3:32b', new OllamaGateway());
+ * const solver = new IterativeProblemSolver({
+ *   broker,
+ *   tools: [new DateResolverTool()],
+ *   maxIterations: 5
+ * });
+ *
+ * const result = await solver.solve("What's the date next Friday?");
+ * console.log(result);
+ * ```
+ */
+class IterativeProblemSolver {
+    chat;
+    maxIterations;
+    /**
+     * Create a new IterativeProblemSolver instance.
+     *
+     * @param config - Configuration options
+     */
+    constructor(config) {
+        const { broker, tools = [], maxIterations = 3, systemPrompt = 'You are a problem-solving assistant that can solve complex problems step by step. ' +
+            'You analyze problems, break them down into smaller parts, and solve them systematically. ' +
+            'If you cannot solve a problem completely in one step, you make progress and identify what to do next.', temperature = 1.0, } = config;
+        this.maxIterations = maxIterations;
+        this.chat = new chat_session_1.ChatSession(broker, {
+            systemPrompt,
+            tools,
+            temperature,
+        });
+    }
+    /**
+     * Execute the problem-solving process.
+     *
+     * This method runs the iterative problem-solving process, continuing until one of
+     * these conditions is met:
+     * - The task is completed successfully ("DONE")
+     * - The task fails explicitly ("FAIL")
+     * - The maximum number of iterations is reached
+     *
+     * @param problem - The problem or request to be solved
+     * @returns A summary of the final result, excluding the process details
+     */
+    async solve(problem) {
+        let iterationsRemaining = this.maxIterations;
+        let shouldContinue = true;
+        while (shouldContinue && iterationsRemaining > 0) {
+            const result = await this.step(problem);
+            if (result.toLowerCase().includes('fail')) {
+                shouldContinue = false;
+            }
+            else if (result.toLowerCase().includes('done')) {
+                shouldContinue = false;
+            }
+            else {
+                iterationsRemaining--;
+            }
+        }
+        const summary = await this.chat.send('Summarize the final result, and only the final result, without commenting on the process by which you achieved it.');
+        return summary;
+    }
+    /**
+     * Execute a single problem-solving step.
+     *
+     * This method sends a prompt to the chat session asking it to work on the user's request
+     * using available tools. The response should indicate success ("DONE") or failure ("FAIL").
+     *
+     * @param problem - The problem or request to be solved
+     * @returns The response from the chat session, indicating the step's outcome
+     */
+    async step(problem) {
+        const prompt = `
+Given the user request:
+${problem}
+
+Use the tools at your disposal to act on their request. You may wish to create a step-by-step plan for more complicated requests.
+
+If you cannot provide an answer, say only "FAIL".
+If you have the answer, say only "DONE".
+`;
+        return this.chat.send(prompt);
+    }
+    /**
+     * Get the current chat messages (for inspection/debugging).
+     *
+     * @returns Array of messages in the chat session
+     */
+    getMessages() {
+        return this.chat.getMessages();
+    }
+    /**
+     * Clear the chat history except the system prompt.
+     */
+    clear() {
+        this.chat.clear();
+    }
+    /**
+     * Clean up resources when done.
+     */
+    dispose() {
+        this.chat.dispose();
+    }
+}
+exports.IterativeProblemSolver = IterativeProblemSolver;
+//# sourceMappingURL=iterative-problem-solver.js.map

package/dist/agents/iterative-problem-solver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterative-problem-solver.js","sourceRoot":"","sources":["../../src/agents/iterative-problem-solver.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,sDAAkD;AAelD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,sBAAsB;IAChB,IAAI,CAAc;IAClB,aAAa,CAAS;IAEvC;;;;OAIG;IACH,YAAY,MAAoC;QAC9C,MAAM,EACJ,MAAM,EACN,KAAK,GAAG,EAAE,EACV,aAAa,GAAG,CAAC,EACjB,YAAY,GAAG,oFAAoF;YACjG,2FAA2F;YAC3F,uGAAuG,EACzG,WAAW,GAAG,GAAG,GAClB,GAAG,MAAM,CAAC;QAEX,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,0BAAW,CAAC,MAAM,EAAE;YAClC,YAAY;YACZ,KAAK;YACL,WAAW;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe;QACzB,IAAI,mBAAmB,GAAG,IAAI,CAAC,aAAa,CAAC;QAC7C,IAAI,cAAc,GAAG,IAAI,CAAC;QAE1B,OAAO,cAAc,IAAI,mBAAmB,GAAG,CAAC,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAExC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1C,cAAc,GAAG,KAAK,CAAC;YACzB,CAAC;iBAAM,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjD,cAAc,GAAG,KAAK,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,mBAAmB,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAClC,oHAAoH,CACrH,CAAC;QAEF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,IAAI,CAAC,OAAe;QAChC,MAAM,MAAM,GAAG;;EAEjB,OAAO;;;;;;CAMR,CAAC;QACE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;CACF;AA3GD,wDA2GC"}