@ai.ntellect/core 1.0.0 → 1.1.0

package/dist/routing/postgres-checkpoint-adapter.js.map

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

package/dist/routing/redis-checkpoint-adapter.d.ts

@@ -0,0 +1,34 @@
+import { PetriNet } from './index';
+import { Session } from './orchestrator';
+import { IPetriCheckpointAdapter } from './checkpoint-adapter';
+export interface RedisCheckpointAdapterOptions {
+    url?: string;
+    host?: string;
+    port?: number;
+    password?: string;
+    keyPrefix?: string;
+}
+export declare class RedisPetriCheckpointAdapter implements IPetriCheckpointAdapter {
+    private client;
+    private keyPrefix;
+    private connected;
+    constructor(options?: RedisCheckpointAdapterOptions);
+    private ensureConnected;
+    save(net: PetriNet, session?: Session): Promise<string>;
+    load(checkpointId: string): Promise<{
+        net: PetriNet;
+        session?: Session;
+    } | null>;
+    list(): Promise<Array<{
+        id: string;
+        timestamp: number;
+        sessionId?: string;
+    }>>;
+    delete(checkpointId: string): Promise<void>;
+    listBySession(sessionId: string): Promise<Array<{
+        id: string;
+        timestamp: number;
+    }>>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=redis-checkpoint-adapter.d.ts.map

package/dist/routing/redis-checkpoint-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-checkpoint-adapter.d.ts","sourceRoot":"","sources":["../../routing/redis-checkpoint-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAG/D,MAAM,WAAW,6BAA6B;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,2BAA4B,YAAW,uBAAuB;IACzE,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAkB;gBAEvB,OAAO,CAAC,EAAE,6BAA6B;YAoBrC,eAAe;IAOvB,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAwCvD,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,QAAQ,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAiChF,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAuB7E,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB3C,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAmBnF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}

package/dist/routing/redis-checkpoint-adapter.js

@@ -0,0 +1,170 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisPetriCheckpointAdapter = void 0;
+const index_1 = require("./index");
+const redis_1 = require("redis");
+class RedisPetriCheckpointAdapter {
+    constructor(options) {
+        this.connected = false;
+        this.keyPrefix = (options === null || options === void 0 ? void 0 : options.keyPrefix) || 'petri:cp:';
+        if (options === null || options === void 0 ? void 0 : options.url) {
+            this.client = (0, redis_1.createClient)({ url: options.url });
+        }
+        else {
+            this.client = (0, redis_1.createClient)({
+                socket: {
+                    host: (options === null || options === void 0 ? void 0 : options.host) || 'localhost',
+                    port: (options === null || options === void 0 ? void 0 : options.port) || 6379,
+                },
+                password: options === null || options === void 0 ? void 0 : options.password,
+            });
+        }
+        this.client.on('error', (err) => {
+            console.error('Redis Client Error', err);
+        });
+    }
+    ensureConnected() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.connected) {
+                yield this.client.connect();
+                this.connected = true;
+            }
+        });
+    }
+    save(net, session) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.ensureConnected();
+            const checkpointId = `petri-cp-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+            const marking = net.state.marking;
+            const serializedMarking = [];
+            for (const [pid, tokens] of marking) {
+                serializedMarking.push({
+                    placeId: pid,
+                    tokens: tokens.map(t => ({ id: t.id, data: t.data, createdAt: t.createdAt })),
+                });
+            }
+            const checkpoint = {
+                id: checkpointId,
+                timestamp: Date.now(),
+                sessionId: session === null || session === void 0 ? void 0 : session.id,
+                marking: serializedMarking,
+                history: net.state.history || [],
+                sessionContext: session === null || session === void 0 ? void 0 : session.context,
+                sessionTraceId: session === null || session === void 0 ? void 0 : session.traceId,
+                sessionCreatedAt: session === null || session === void 0 ? void 0 : session.createdAt,
+                sessionHistory: (session === null || session === void 0 ? void 0 : session.history) || [],
+            };
+            const key = `${this.keyPrefix}${checkpointId}`;
+            yield this.client.set(key, JSON.stringify(checkpoint));
+            const indexKey = `${this.keyPrefix}index`;
+            yield this.client.zAdd(indexKey, { score: checkpoint.timestamp, value: checkpointId });
+            if (session === null || session === void 0 ? void 0 : session.id) {
+                const sessionKey = `${this.keyPrefix}session:${session.id}`;
+                yield this.client.sAdd(sessionKey, checkpointId);
+            }
+            return checkpointId;
+        });
+    }
+    load(checkpointId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.ensureConnected();
+            const key = `${this.keyPrefix}${checkpointId}`;
+            const data = yield this.client.get(key);
+            if (!data)
+                return null;
+            const cp = JSON.parse(data);
+            const net = new index_1.PetriNet(cp.id);
+            const marking = net.state.marking;
+            for (const item of cp.marking) {
+                marking.set(item.placeId, item.tokens.map((t) => (Object.assign({}, t))));
+            }
+            net.state.history = [...cp.history];
+            let session;
+            if (cp.sessionId) {
+                session = {
+                    id: cp.sessionId,
+                    petriNet: net,
+                    context: cp.sessionContext || {},
+                    history: cp.sessionHistory || [],
+                    createdAt: cp.sessionCreatedAt || cp.timestamp,
+                    traceId: cp.sessionTraceId || `trace-restored-${Date.now()}`,
+                };
+            }
+            return { net, session };
+        });
+    }
+    list() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.ensureConnected();
+            const indexKey = `${this.keyPrefix}index`;
+            const ids = yield this.client.zRange(indexKey, 0, -1, { REV: true });
+            const results = [];
+            for (const id of ids) {
+                const key = `${this.keyPrefix}${id}`;
+                const data = yield this.client.get(key);
+                if (data) {
+                    const cp = JSON.parse(data);
+                    results.push({
+                        id: cp.id,
+                        timestamp: cp.timestamp,
+                        sessionId: cp.sessionId,
+                    });
+                }
+            }
+            return results;
+        });
+    }
+    delete(checkpointId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.ensureConnected();
+            const key = `${this.keyPrefix}${checkpointId}`;
+            const data = yield this.client.get(key);
+            if (data) {
+                const cp = JSON.parse(data);
+                if (cp.sessionId) {
+                    const sessionKey = `${this.keyPrefix}session:${cp.sessionId}`;
+                    yield this.client.sRem(sessionKey, checkpointId);
+                }
+            }
+            yield this.client.del(key);
+            const indexKey = `${this.keyPrefix}index`;
+            yield this.client.zRem(indexKey, checkpointId);
+        });
+    }
+    listBySession(sessionId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.ensureConnected();
+            const sessionKey = `${this.keyPrefix}session:${sessionId}`;
+            const ids = yield this.client.sMembers(sessionKey);
+            const results = [];
+            for (const id of ids) {
+                const key = `${this.keyPrefix}${id}`;
+                const data = yield this.client.get(key);
+                if (data) {
+                    const cp = JSON.parse(data);
+                    results.push({ id: cp.id, timestamp: cp.timestamp });
+                }
+            }
+            return results.sort((a, b) => b.timestamp - a.timestamp);
+        });
+    }
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.connected) {
+                yield this.client.quit();
+                this.connected = false;
+            }
+        });
+    }
+}
+exports.RedisPetriCheckpointAdapter = RedisPetriCheckpointAdapter;
+//# sourceMappingURL=redis-checkpoint-adapter.js.map

package/dist/routing/redis-checkpoint-adapter.js.map

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

package/dist/routing/types.d.ts

@@ -0,0 +1,49 @@
+export interface Token {
+    id: string;
+    data: Record<string, any>;
+    createdAt: number;
+}
+export interface Place {
+    id: string;
+    type: 'normal' | 'initial' | 'final';
+    tokens: Token[];
+}
+export interface Guard {
+    type: 'deterministic' | 'llm_evaluated';
+    condition?: string;
+    name?: string;
+}
+export interface TransitionAction {
+    type: 'graphflow' | 'dynamic';
+    name?: string;
+    prompt?: string;
+    maxSteps?: number;
+    contextMapper?: (ctx: any) => any;
+}
+export interface Transition {
+    id: string;
+    from: string[];
+    to: string | string[];
+    guard?: Guard;
+    action?: TransitionAction;
+    description?: string;
+    when?: {
+        events: string[];
+        timeout?: number;
+    };
+}
+export interface PetriNetState {
+    marking: Map<string, Token[]>;
+    history: string[];
+}
+export interface TransitionResult {
+    success: boolean;
+    transitionId: string;
+    newMarking: Map<string, Token[]>;
+    consumedTokens: Token[];
+    producedTokens: Token[];
+    error?: string;
+}
+export type GuardLLMExecutor = (prompt: string, context: any) => Promise<boolean>;
+export type ActionExecutor = (action: TransitionAction, context: any) => Promise<any>;
+//# sourceMappingURL=types.d.ts.map

package/dist/routing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../routing/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACrC,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,eAAe,GAAG,eAAe,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,GAAG,SAAS,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACjC,cAAc,EAAE,KAAK,EAAE,CAAC;IACxB,cAAc,EAAE,KAAK,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAElF,MAAM,MAAM,cAAc,GAAG,CAC3B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,GAAG,KACT,OAAO,CAAC,GAAG,CAAC,CAAC"}

package/dist/routing/types.js

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

package/dist/routing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../routing/types.ts"],"names":[],"mappings":""}

package/dist/types/agent.d.ts

@@ -0,0 +1,289 @@
+import { GraphFlow } from "@/execution";
+import { z } from "zod";
+/**
+ * Represents an action that has been executed by the agent
+ * @interface ExecutedAction
+ * @property {string} name - The name of the executed action
+ * @property {boolean} isExecuted - Whether the action was successfully executed
+ * @property {string | null} [error] - Optional error message if the action failed
+ * @property {any} result - The result of the action execution
+ * @property {string} timestamp - When the action was executed
+ */
+export type ExecutedAction = {
+    name: string;
+    parameters?: Record<string, any>;
+    isExecuted: boolean;
+    error?: string | null;
+    result: any;
+    timestamp: string;
+};
+export type ChatMessage = {
+    role: "user" | "assistant";
+    content: string;
+};
+export type ScratchpadEntry = {
+    turn: number;
+    thought: string;
+    action: string;
+    observation: string;
+    timestamp: string;
+};
+/**
+ * Represents the context in which an agent operates
+ * @interface AgentContext
+ * @property {Object} input - The input provided to the agent
+ * @property {string} input.raw - The raw input text
+ * @property {number[]} [input.embedding] - Optional vector embedding of the input
+ * @property {ActionSchema[]} actions - List of actions available to the agent
+ * @property {string} response - The agent's response
+ * @property {string} [knowledge] - Optional knowledge base or context
+ * @property {ExecutedAction[]} executedActions - History of executed actions
+ * @property {number} [iteration] - Current iteration count (reset per run)
+ * @property {boolean} [progressed] - Whether progress was made in this iteration
+ * @property {ChatMessage[]} [messages] - Conversation history
+ * @property {ScratchpadEntry[]} scratchpad - Structured journal of thoughts
+ * @property {BaseMemoryType[]} memories - Retrieved episodic memories
+ */
+export type AgentContext = {
+    input: {
+        raw: string;
+        embedding?: number[];
+    };
+    actions: ActionSchema[];
+    response: string;
+    knowledge?: string;
+    executedActions: ExecutedAction[];
+    iteration?: number;
+    progressed?: boolean;
+    messages?: ChatMessage[];
+    toolResults?: Record<string, any>;
+    scratchpad?: ScratchpadEntry[];
+    memories?: any[];
+    entityState?: {
+        currentTarget?: string;
+        lastEntityType?: string | null;
+        pendingResolutions?: any[];
+        resolutionTrace?: any[];
+        explored?: boolean;
+        handles?: Record<string, {
+            id: string;
+            label: string;
+            path: string;
+            category: string;
+        }>;
+    };
+    conversationState?: {
+        currentGoal: string;
+        currentTarget: string | null;
+        lastResolvedEntity: string | null;
+        lastResolvedType: string | null;
+        pendingTask: string | null;
+        turnCount: number;
+        pendingIntent: {
+            action: string | null;
+            unresolvedEntity: string | null;
+            originalInput: string;
+            turn: number;
+            failed: boolean;
+        } | null;
+    };
+    explorationBudget?: {
+        maxSteps: number;
+        maxExplorations: number;
+        maxToolCalls: number;
+        stepsUsed: number;
+        explorationsUsed: number;
+        toolCallsUsed: number;
+    };
+};
+export declare const AgentContextSchema: z.ZodObject<{
+    input: z.ZodObject<{
+        raw: z.ZodString;
+        embedding: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>;
+    cwd: z.ZodOptional<z.ZodString>;
+    actions: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        parameters: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodAny;
+        }, z.core.$strip>>;
+        isExecuted: z.ZodOptional<z.ZodBoolean>;
+        result: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>>;
+    knowledge: z.ZodOptional<z.ZodString>;
+    response: z.ZodString;
+    executedActions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        result: z.ZodAny;
+        timestamp: z.ZodString;
+    }, z.core.$strip>>>;
+    iteration: z.ZodOptional<z.ZodNumber>;
+    progressed: z.ZodOptional<z.ZodBoolean>;
+    messages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            user: "user";
+            assistant: "assistant";
+        }>;
+        content: z.ZodString;
+    }, z.core.$strip>>>;
+    toolResults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    scratchpad: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        turn: z.ZodNumber;
+        thought: z.ZodString;
+        action: z.ZodString;
+        observation: z.ZodString;
+        timestamp: z.ZodString;
+    }, z.core.$strip>>>>;
+    memories: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodAny>>>;
+    entityState: z.ZodOptional<z.ZodObject<{
+        currentTarget: z.ZodOptional<z.ZodString>;
+        lastEntityType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pendingResolutions: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+        resolutionTrace: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+        explored: z.ZodOptional<z.ZodBoolean>;
+        handles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            path: z.ZodString;
+            category: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    conversationState: z.ZodOptional<z.ZodObject<{
+        currentGoal: z.ZodString;
+        currentTarget: z.ZodNullable<z.ZodString>;
+        lastResolvedEntity: z.ZodNullable<z.ZodString>;
+        lastResolvedType: z.ZodNullable<z.ZodString>;
+        pendingTask: z.ZodNullable<z.ZodString>;
+        turnCount: z.ZodNumber;
+        pendingIntent: z.ZodNullable<z.ZodObject<{
+            action: z.ZodNullable<z.ZodString>;
+            unresolvedEntity: z.ZodNullable<z.ZodString>;
+            originalInput: z.ZodString;
+            turn: z.ZodNumber;
+            failed: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    explorationBudget: z.ZodOptional<z.ZodObject<{
+        maxSteps: z.ZodNumber;
+        maxExplorations: z.ZodNumber;
+        maxToolCalls: z.ZodNumber;
+        stepsUsed: z.ZodNumber;
+        explorationsUsed: z.ZodNumber;
+        toolCallsUsed: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Represents a section of the prompt with a title and content
+ * @interface PromptSection
+ * @property {string} title - The title of the prompt section
+ * @property {string | ((context: AgentContext) => string | Promise<string>)} content - The content or a function to generate content
+ */
+export type PromptSection = {
+    title: string;
+    content: string | ((context: AgentContext) => string | Promise<string>);
+};
+/**
+ * Supported LLM providers
+ */
+export type LLMProvider = "openai" | "anthropic" | "ollama" | "groq" | "openrouter" | "google" | "custom";
+/**
+ * Supported LLM models
+ */
+export type LLMModel = "gpt-4" | "gpt-3.5-turbo" | "claude-2" | string;
+export type ExecutorConfig = {
+    llmConfig: LLMConfig;
+    verbose?: boolean;
+};
+/**
+ * Configuration for the Agent
+ * @type AssistantConfig
+ * @extends {Omit<ExecutorConfig, "verbose">}
+ * @property {string} role - The function/job of the assistant (e.g., "Email Assistant")
+ * @property {string} goal - The specific objective the assistant tries to achieve
+ * @property {string} backstory - The personality and behavioral traits of the assistant
+ * @property {any[]} [tools] - Optional tools the assistant can use
+ * @property {any} [memory] - Optional memory system
+ * @property {boolean} [verbose] - Whether to log detailed information
+ */
+export type AgentConfig = {
+    role: string;
+    goal: string;
+    backstory: string;
+    tools: GraphFlow<any>[];
+    memory?: any;
+    verbose?: boolean;
+    maxIterations?: number;
+    llmConfig: ExecutorConfig["llmConfig"];
+    dynamicGoal?: boolean;
+    dynamicGoalPrompt?: string;
+    dynamicNext?: boolean;
+    dynamicNextPrompt?: string;
+    enableSchedule?: boolean;
+    enableClone?: boolean;
+    enableReflection?: boolean;
+    agenda?: any;
+    entityStore?: import("../agent/entity-resolver/entity-index").IEntityStore;
+};
+/**
+ * Represents the schema of an action that can be performed by the agent
+ * @interface ActionSchema
+ * @property {string} name - The name of the action
+ * @property {Array<{name: string, value: any}>} parameters - The parameters required for the action
+ */
+export type ActionSchema = {
+    name: string;
+    parameters: Array<{
+        name: string;
+        value: any;
+    }>;
+};
+/**
+ * Represents the output of the agent's decision-making process
+ * @interface DecisionOutput
+ * @property {ActionSchema[]} actions - The actions to be executed
+ * @property {string} response - The agent's response message
+ * @property {string} [thought] - The agent's internal reasoning for this turn
+ */
+export type DecisionOutput = {
+    actions: ActionSchema[];
+    response: string;
+    thought?: string;
+};
+export type LLMCall = {
+    promptTokens: number;
+    completionTokens: number;
+    duration: number;
+    timestamp: string;
+};
+/**
+ * Configuration for the Language Model
+ * @interface LLMConfig
+ * @property {LLMProvider} provider - The LLM provider to use
+ * @property {string} [apiKey] - API key for the provider (not required for Ollama)
+ * @property {LLMModel} model - The specific model to use
+ * @property {number} [temperature] - Optional temperature parameter for response randomness
+ * @property {number} [maxTokens] - Optional maximum tokens for the response
+ * @property {string} [baseUrl] - Optional base URL for local providers (e.g., Ollama)
+ * @property {Function} [customCall] - Optional custom implementation for API calls
+ */
+export type LLMConfig = {
+    provider: LLMProvider;
+    apiKey?: string;
+    model: LLMModel;
+    temperature?: number;
+    maxTokens?: number;
+    baseUrl?: string;
+    customCall?: (prompt: string | PromptInput, schema: z.ZodType<any>) => Promise<any>;
+};
+/**
+ * Structure for prompt input to the LLM
+ * @interface PromptInput
+ * @property {string} system - The system message/context
+ * @property {string} user - The user's input message
+ */
+export type PromptInput = {
+    system: string;
+    user: string;
+};
+//# sourceMappingURL=agent.d.ts.map

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

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