typed-agents 1.0.0

package/dist/agents/runtime-engine/retry.utils.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = void 0;
+exports.withRetry = withRetry;
+/**
+ * Sleeps for the specified number of milliseconds.
+ *
+ * @param ms - Milliseconds to sleep.
+ * @returns A promise that resolves after the delay.
+ */
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+exports.sleep = sleep;
+/**
+ * Executes a function with retry logic, emitting events on failures.
+ *
+ * Retries up to maxRetries times with exponential backoff if enabled.
+ * Emits "retry:attempt" events for each failure, and throws on final failure.
+ *
+ * @param fn - The async function to execute and retry.
+ * @param maxRetries - Maximum number of retry attempts.
+ * @param baseDelay - Base delay in ms between retries.
+ * @param backoff - Whether to use exponential backoff.
+ * @param emit - Event emitter function for retry events.
+ * @param context - Context object with a "name" for logging.
+ * @returns The result of the successful function call.
+ * @throws The last error if all retries fail.
+ */
+async function withRetry(fn, maxRetries, baseDelay, backoff, emit, context) {
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            const isLast = attempt === maxRetries;
+            emit({
+                type: "retry:attempt",
+                log: {
+                    level: isLast ? "error" : "warn",
+                    message: `🔄 Retry ${attempt + 1}/${maxRetries + 1} su ${context.name}`,
+                },
+                payload: {
+                    name: context.name,
+                    attempt: attempt + 1,
+                    error: String(err),
+                },
+            });
+            if (isLast)
+                throw err;
+            const delay = backoff ? baseDelay * Math.pow(2, attempt) : baseDelay;
+            await (0, exports.sleep)(delay);
+        }
+    }
+    throw new Error("Unreachable");
+}
+//# sourceMappingURL=retry.utils.js.map

package/dist/agents/runtime-engine/retry.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.utils.js","sourceRoot":"","sources":["../../../src/agents/runtime-engine/retry.utils.ts"],"names":[],"mappings":";;;AAuBA,8BAiCC;AAxDD;;;;;GAKG;AACI,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAA9D,QAAA,KAAK,SAAyD;AAE3E;;;;;;;;;;;;;;GAcG;AACI,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,UAAkB,EAClB,SAAiB,EACjB,OAAgB,EAChB,IAA0B,EAC1B,OAAyB;IAEzB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,OAAO,KAAK,UAAU,CAAC;YACtC,IAAI,CAAC;gBACH,IAAI,EAAE,eAAe;gBACrB,GAAG,EAAE;oBACH,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;oBAChC,OAAO,EAAE,YAAY,OAAO,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC,OAAO,OAAO,CAAC,IAAI,EAAE;iBACxE;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,OAAO,EAAE,OAAO,GAAG,CAAC;oBACpB,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;iBACnB;aACF,CAAC,CAAC;YAEH,IAAI,MAAM;gBAAE,MAAM,GAAG,CAAC;YAEtB,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACrE,MAAM,IAAA,aAAK,EAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;AACjC,CAAC"}

package/dist/agents/runtime-engine/state-persistence.d.ts

@@ -0,0 +1,56 @@
+import { SerializedState } from "../agent.types";
+/**
+ * Interface for state persistence implementations.
+ * Allows saving/loading agent run states and listing run IDs.
+ */
+export interface Persister {
+    /**
+     * Saves a serialized state for a given run ID.
+     * @param runId - Unique identifier for the run.
+     * @param state - The serialized state to save.
+     */
+    save(runId: string, state: SerializedState): Promise<void>;
+    /**
+     * Loads a serialized state for a given run ID, or null if not found.
+     * @param runId - Unique identifier for the run.
+     * @returns The loaded state or null.
+     */
+    load(runId: string): Promise<SerializedState | null>;
+    /**
+     * Returns all available run IDs.
+     * @returns Array of run ID strings.
+     */
+    getAllRunIds(): string[];
+}
+/**
+ * In-memory persister using a Map. Each instance has its own store,
+ * preventing shared state between parallel AgentRuntime instances.
+ * Uses structuredClone to avoid accidental mutations.
+ */
+export declare class MemoryPersister implements Persister {
+    private store;
+    save(runId: string, state: SerializedState): Promise<void>;
+    load(runId: string): Promise<SerializedState | null>;
+    getAllRunIds(): string[];
+}
+/**
+ * File-based persister that saves states as JSON files in a directory.
+ * Creates the directory if it doesn't exist.
+ */
+export declare class FilePersister implements Persister {
+    private baseDir;
+    constructor(baseDir: string);
+    save(runId: string, state: SerializedState): Promise<void>;
+    load(runId: string): Promise<SerializedState | null>;
+    getAllRunIds(): string[];
+}
+/**
+ * Null-object pattern persister for "none" mode.
+ * Does nothing, replacing the inline anonymous object.
+ */
+export declare class NullPersister implements Persister {
+    save(): Promise<void>;
+    load(): Promise<null>;
+    getAllRunIds(): string[];
+}
+//# sourceMappingURL=state-persistence.d.ts.map

package/dist/agents/runtime-engine/state-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-persistence.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime-engine/state-persistence.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAErD;;;OAGG;IACH,YAAY,IAAI,MAAM,EAAE,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,KAAK,CAAsC;IAE7C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAK1D,YAAY,IAAI,MAAM,EAAE;CAGzB;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,SAAS;IACjC,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAI7B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1D,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAU1D,YAAY,IAAI,MAAM,EAAE;CAMzB;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,SAAS;IACvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAC3B,YAAY,IAAI,MAAM,EAAE;CACzB"}

package/dist/agents/runtime-engine/state-persistence.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NullPersister = exports.FilePersister = exports.MemoryPersister = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * In-memory persister using a Map. Each instance has its own store,
+ * preventing shared state between parallel AgentRuntime instances.
+ * Uses structuredClone to avoid accidental mutations.
+ */
+class MemoryPersister {
+    store = new Map();
+    async save(runId, state) {
+        this.store.set(runId, structuredClone(state));
+    }
+    async load(runId) {
+        const entry = this.store.get(runId);
+        return entry ? structuredClone(entry) : null;
+    }
+    getAllRunIds() {
+        return Array.from(this.store.keys());
+    }
+}
+exports.MemoryPersister = MemoryPersister;
+/**
+ * File-based persister that saves states as JSON files in a directory.
+ * Creates the directory if it doesn't exist.
+ */
+class FilePersister {
+    baseDir;
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+        fs_1.default.mkdirSync(baseDir, { recursive: true });
+    }
+    async save(runId, state) {
+        const file = path_1.default.join(this.baseDir, `${runId}.json`);
+        await fs_1.default.promises.writeFile(file, JSON.stringify(state, null, 2));
+    }
+    async load(runId) {
+        const file = path_1.default.join(this.baseDir, `${runId}.json`);
+        try {
+            const content = await fs_1.default.promises.readFile(file, "utf-8");
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    getAllRunIds() {
+        return fs_1.default
+            .readdirSync(this.baseDir)
+            .filter((f) => f.endsWith(".json") && !f.includes("-cache"))
+            .map((f) => f.replace(".json", ""));
+    }
+}
+exports.FilePersister = FilePersister;
+/**
+ * Null-object pattern persister for "none" mode.
+ * Does nothing, replacing the inline anonymous object.
+ */
+class NullPersister {
+    async save() { }
+    async load() { return null; }
+    getAllRunIds() { return []; }
+}
+exports.NullPersister = NullPersister;
+//# sourceMappingURL=state-persistence.js.map

package/dist/agents/runtime-engine/state-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-persistence.js","sourceRoot":"","sources":["../../../src/agents/runtime-engine/state-persistence.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AA6BxB;;;;GAIG;AACH,MAAa,eAAe;IAClB,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEnD,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,KAAsB;QAC9C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IAED,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;CACF;AAfD,0CAeC;AAED;;;GAGG;AACH,MAAa,aAAa;IACJ;IAApB,YAAoB,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;QACjC,YAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,KAAsB;QAC9C,MAAM,IAAI,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;QACtD,MAAM,YAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,MAAM,IAAI,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,YAAY;QACV,OAAO,YAAE;aACN,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;aACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;aAC3D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;CACF;AA1BD,sCA0BC;AAED;;;GAGG;AACH,MAAa,aAAa;IACxB,KAAK,CAAC,IAAI,KAAmB,CAAC;IAC9B,KAAK,CAAC,IAAI,KAAoB,OAAO,IAAI,CAAC,CAAC,CAAC;IAC5C,YAAY,KAAe,OAAO,EAAE,CAAC,CAAC,CAAC;CACxC;AAJD,sCAIC"}

package/dist/clients/index.d.ts

@@ -0,0 +1,3 @@
+export * from './llm.client';
+export * from './ollama.client';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/clients/index.js

@@ -0,0 +1,19 @@
+"use strict";
+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("./llm.client"), exports);
+__exportStar(require("./ollama.client"), exports);
+//# sourceMappingURL=index.js.map

package/dist/clients/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,kDAAgC"}

package/dist/clients/llm.client.d.ts

@@ -0,0 +1,48 @@
+import type { ToolDefinition } from "../tools/tool.types";
+export interface LLMMessage {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string;
+    tool_calls?: StandardToolCall[];
+    tool_call_id?: string;
+}
+export interface StandardToolCall {
+    id?: string;
+    function: {
+        name: string;
+        arguments: Record<string, unknown>;
+    };
+}
+export interface LLMResponse {
+    text: string;
+    tool_calls?: StandardToolCall[];
+}
+/**
+ * Discriminated union emitted during streaming.
+ * - text_delta:      incremental text token
+ * - tool_call_delta: a tool call discovered mid-stream
+ * - done:            signals end of stream with the full assembled response
+ */
+export type StreamChunk = {
+    type: "text_delta";
+    delta: string;
+} | {
+    type: "tool_call_delta";
+    tool_call: StandardToolCall;
+} | {
+    type: "done";
+    response: LLMResponse;
+};
+export interface LLMClient {
+    invoke(messages: LLMMessage[], tools?: ToolDefinition[], options?: {
+        temperature?: number;
+    }): Promise<LLMResponse>;
+    /**
+     * Optional streaming variant. Clients that support it should implement this.
+     * The runtime falls back to `invoke` when this is absent.
+     */
+    invokeStream?(messages: LLMMessage[], tools?: ToolDefinition[], options?: {
+        temperature?: number;
+    }): AsyncGenerator<StreamChunk>;
+    getModelIdentifier(): string;
+}
+//# sourceMappingURL=llm.client.d.ts.map

package/dist/clients/llm.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.client.d.ts","sourceRoot":"","sources":["../../src/clients/llm.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAM,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,gBAAgB,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAY,QAAQ,EAAE,WAAW,CAAA;CAAE,CAAC;AAEvD,MAAM,WAAW,SAAS;IACxB,MAAM,CACJ,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,CAAC,EAAE,cAAc,EAAE,EACxB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjC,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;;OAGG;IACH,YAAY,CAAC,CACX,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,CAAC,EAAE,cAAc,EAAE,EACxB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjC,cAAc,CAAC,WAAW,CAAC,CAAC;IAE/B,kBAAkB,IAAI,MAAM,CAAC;CAC9B"}

package/dist/clients/llm.client.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=llm.client.js.map

package/dist/clients/llm.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.client.js","sourceRoot":"","sources":["../../src/clients/llm.client.ts"],"names":[],"mappings":""}

package/dist/clients/ollama.client.d.ts

@@ -0,0 +1,20 @@
+import type { LLMClient, LLMMessage, LLMResponse, StreamChunk } from "./llm.client";
+import type { ToolDefinition } from "../tools/tool.types";
+export declare class OllamaClient implements LLMClient {
+    private model;
+    private ollama;
+    constructor(model: string);
+    invoke(messages: LLMMessage[], tools?: ToolDefinition[], options?: {
+        temperature?: number;
+    }): Promise<LLMResponse>;
+    /**
+     * Streams text deltas token by token.
+     * Tool calls are collected silently and emitted as tool_call_delta chunks,
+     * then included in the final "done" chunk.
+     */
+    invokeStream(messages: LLMMessage[], tools?: ToolDefinition[], options?: {
+        temperature?: number;
+    }): AsyncGenerator<StreamChunk>;
+    getModelIdentifier(): string;
+}
+//# sourceMappingURL=ollama.client.d.ts.map

package/dist/clients/ollama.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.client.d.ts","sourceRoot":"","sources":["../../src/clients/ollama.client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,WAAW,EAEX,WAAW,EACZ,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAkB1D,qBAAa,YAAa,YAAW,SAAS;IAGhC,OAAO,CAAC,KAAK;IAFzB,OAAO,CAAC,MAAM,CAAgB;gBAEV,KAAK,EAAE,MAAM;IAE3B,MAAM,CACV,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,CAAC,EAAE,cAAc,EAAE,EACxB,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GACrC,OAAO,CAAC,WAAW,CAAC;IAkBvB;;;;OAIG;IACI,YAAY,CACjB,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,CAAC,EAAE,cAAc,EAAE,EACxB,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GACrC,cAAc,CAAC,WAAW,CAAC;IAoC9B,kBAAkB,IAAI,MAAM;CAG7B"}

package/dist/clients/ollama.client.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OllamaClient = void 0;
+const ollama_1 = require("ollama");
+function normalizeToolCall(tc) {
+    const argsRaw = tc.function.arguments;
+    const parsedArgs = typeof argsRaw === "string"
+        ? (() => {
+            try {
+                return JSON.parse(argsRaw || "{}");
+            }
+            catch {
+                return {};
+            }
+        })()
+        : (argsRaw ?? {});
+    return {
+        id: tc.id,
+        function: { name: tc.function.name, arguments: parsedArgs },
+    };
+}
+class OllamaClient {
+    model;
+    ollama = new ollama_1.Ollama();
+    constructor(model) {
+        this.model = model;
+    }
+    async invoke(messages, tools, options = {}) {
+        const response = await this.ollama.chat({
+            model: this.model,
+            messages,
+            tools: tools,
+            keep_alive: -1,
+            options: {
+                num_predict: 1000,
+                temperature: options.temperature ?? 0.2,
+            },
+        });
+        return {
+            text: response.message.content || "",
+            tool_calls: (response.message.tool_calls ?? []).map(normalizeToolCall),
+        };
+    }
+    /**
+     * Streams text deltas token by token.
+     * Tool calls are collected silently and emitted as tool_call_delta chunks,
+     * then included in the final "done" chunk.
+     */
+    async *invokeStream(messages, tools, options = {}) {
+        const stream = await this.ollama.chat({
+            model: this.model,
+            messages,
+            tools: tools,
+            stream: true,
+            keep_alive: -1,
+            options: {
+                num_predict: 1000,
+                temperature: options.temperature ?? 0.2,
+            },
+        });
+        let fullText = "";
+        const collectedToolCalls = [];
+        for await (const part of stream) {
+            const delta = part.message.content ?? "";
+            if (delta) {
+                fullText += delta;
+                yield { type: "text_delta", delta };
+            }
+            for (const tc of part.message.tool_calls ?? []) {
+                const normalized = normalizeToolCall(tc);
+                collectedToolCalls.push(normalized);
+                yield { type: "tool_call_delta", tool_call: normalized };
+            }
+        }
+        yield {
+            type: "done",
+            response: { text: fullText, tool_calls: collectedToolCalls },
+        };
+    }
+    getModelIdentifier() {
+        return this.model;
+    }
+}
+exports.OllamaClient = OllamaClient;
+//# sourceMappingURL=ollama.client.js.map

package/dist/clients/ollama.client.js.map

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

package/dist/core/logger/index.d.ts

@@ -0,0 +1,2 @@
+export * from './logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/logger/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/core/logger/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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("./logger"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/logger/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB"}

package/dist/core/logger/logger.d.ts

@@ -0,0 +1,7 @@
+export declare class Logger {
+    private static now;
+    static info(...args: any[]): void;
+    static warn(...args: any[]): void;
+    static error(...args: any[]): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/logger/logger.ts"],"names":[],"mappings":"AAAA,qBAAa,MAAM;IAEjB,OAAO,CAAC,MAAM,CAAC,GAAG;IAIlB,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAI1B,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAI1B,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;CAI5B"}

package/dist/core/logger/logger.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+class Logger {
+    static now() {
+        return new Date().toISOString();
+    }
+    static info(...args) {
+        console.log(`[INFO ${this.now()}]`, ...args);
+    }
+    static warn(...args) {
+        console.warn(`[WARN ${this.now()}]`, ...args);
+    }
+    static error(...args) {
+        console.error(`[ERROR ${this.now()}]`, ...args);
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/core/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/core/logger/logger.ts"],"names":[],"mappings":";;;AAAA,MAAa,MAAM;IAET,MAAM,CAAC,GAAG;QAChB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,IAAW;QACxB,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,IAAW;QACxB,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,IAAW;QACzB,OAAO,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC;CAEF;AAlBD,wBAkBC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './agents';
+export * from './clients';
+export * from './core/logger';
+export * from './runtime';
+export * from './tools';
+//# 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,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+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("./agents"), exports);
+__exportStar(require("./clients"), exports);
+__exportStar(require("./core/logger"), exports);
+__exportStar(require("./runtime"), exports);
+__exportStar(require("./tools"), exports);
+//# 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,2CAAyB;AACzB,4CAA0B;AAC1B,gDAA8B;AAC9B,4CAA0B;AAC1B,0CAAwB"}

package/dist/runtime/agent.runner.d.ts

@@ -0,0 +1,29 @@
+import { AgentRuntime } from "../agents/agent.runtime";
+import { LLMClient } from "../clients/llm.client";
+import type { RunOptions } from "../agents/agent.types";
+/**
+ * P1 FIX: `globalRuntime` singleton eliminated.
+ *
+ * Before: a single shared runtime for all agents caused state collisions
+ * when multiple runAgent calls ran in parallel.
+ *
+ * Now: each call creates its own isolated runtime, unless one is explicitly
+ * passed (useful for sharing event listeners or cache between agents
+ * coordinated by the same orchestrator).
+ */
+/**
+ * Runs an agent class with the given prompt and options.
+ *
+ * Creates a new AgentRuntime instance if not provided, allowing for isolated
+ * execution. Supports custom LLM clients, persistence, and runtime options.
+ *
+ * @param agentClass - The agent class decorated with `@agent()` to run.
+ * @param prompt - The user input prompt to start the agent conversation.
+ * @param showLogs - Whether to enable console logging (overridden by options.silent).
+ * @param client - Optional LLM client to use instead of the agent's default.
+ * @param options - Runtime options like maxSteps, temperature, persistence, etc.
+ * @param runtime - Optional pre-configured AgentRuntime to use (for shared state).
+ * @returns The final output string from the agent.
+ */
+export declare function runAgent(agentClass: new () => object, prompt: string, showLogs?: boolean, client?: LLMClient, options?: RunOptions, runtime?: AgentRuntime): Promise<string>;
+//# sourceMappingURL=agent.runner.d.ts.map

package/dist/runtime/agent.runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.runner.d.ts","sourceRoot":"","sources":["../../src/runtime/agent.runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,uBAAuB,CAAC;AAEvE;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,UAAU,MAAM,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,UAAO,EACf,MAAM,CAAC,EAAE,SAAS,EAClB,OAAO,GAAE,UAAe,EACxB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,CAYjB"}

package/dist/runtime/agent.runner.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAgent = runAgent;
+const agent_runtime_1 = require("../agents/agent.runtime");
+/**
+ * P1 FIX: `globalRuntime` singleton eliminated.
+ *
+ * Before: a single shared runtime for all agents caused state collisions
+ * when multiple runAgent calls ran in parallel.
+ *
+ * Now: each call creates its own isolated runtime, unless one is explicitly
+ * passed (useful for sharing event listeners or cache between agents
+ * coordinated by the same orchestrator).
+ */
+/**
+ * Runs an agent class with the given prompt and options.
+ *
+ * Creates a new AgentRuntime instance if not provided, allowing for isolated
+ * execution. Supports custom LLM clients, persistence, and runtime options.
+ *
+ * @param agentClass - The agent class decorated with `@agent()` to run.
+ * @param prompt - The user input prompt to start the agent conversation.
+ * @param showLogs - Whether to enable console logging (overridden by options.silent).
+ * @param client - Optional LLM client to use instead of the agent's default.
+ * @param options - Runtime options like maxSteps, temperature, persistence, etc.
+ * @param runtime - Optional pre-configured AgentRuntime to use (for shared state).
+ * @returns The final output string from the agent.
+ */
+async function runAgent(agentClass, prompt, showLogs = true, client, options = {}, runtime) {
+    const effectiveShowLogs = showLogs && !(options.silent ?? false);
+    const persistCfg = typeof options.persist === "boolean"
+        ? options.persist
+            ? { mode: "file", dir: "./.agent-runs" }
+            : { mode: "none" }
+        : (options.persist ?? { mode: "none" });
+    const usedRuntime = runtime ?? new agent_runtime_1.AgentRuntime(effectiveShowLogs, persistCfg);
+    return usedRuntime.run(agentClass, prompt, client, options);
+}
+//# sourceMappingURL=agent.runner.js.map

package/dist/runtime/agent.runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.runner.js","sourceRoot":"","sources":["../../src/runtime/agent.runner.ts"],"names":[],"mappings":";;AA6BA,4BAmBC;AAhDD,2DAAuD;AAIvD;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,QAAQ,CAC5B,UAA4B,EAC5B,MAAc,EACd,QAAQ,GAAG,IAAI,EACf,MAAkB,EAClB,UAAsB,EAAE,EACxB,OAAsB;IAEtB,MAAM,iBAAiB,GAAG,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;IAEjE,MAAM,UAAU,GACd,OAAO,OAAO,CAAC,OAAO,KAAK,SAAS;QAClC,CAAC,CAAC,OAAO,CAAC,OAAO;YACf,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE;YACxC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;QACpB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAE5C,MAAM,WAAW,GAAG,OAAO,IAAI,IAAI,4BAAY,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;IAC/E,OAAO,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,2 @@
+export * from './agent.runner';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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("./agent.runner"), exports);
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B"}

package/dist/tools/index.d.ts

@@ -0,0 +1,4 @@
+export * from './registry';
+export * from './tool.decorator';
+export * from './tool.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}