@hazeljs/agent 0.2.0-beta.1

package/dist/agent.module.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Agent Module
+ * HazelJS module for Agent Runtime
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var AgentModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentModule = exports.AgentService = void 0;
+const core_1 = require("@hazeljs/core");
+const agent_runtime_1 = require("./runtime/agent.runtime");
+/**
+ * Agent Service
+ * Injectable service for agent runtime
+ */
+let AgentService = class AgentService {
+    constructor(config = {}) {
+        const moduleOpts = AgentModule.getOptions();
+        const runtimeConfig = moduleOpts.runtime || config;
+        this.runtime = new agent_runtime_1.AgentRuntime(runtimeConfig);
+        // Register agents from module options
+        if (moduleOpts.agents) {
+            for (const agentClass of moduleOpts.agents) {
+                this.runtime.registerAgent(agentClass);
+            }
+        }
+    }
+    getRuntime() {
+        return this.runtime;
+    }
+    async execute(agentName, input, options) {
+        return this.runtime.execute(agentName, input, options);
+    }
+    async resume(executionId, input) {
+        return this.runtime.resume(executionId, input);
+    }
+    getContext(executionId) {
+        return this.runtime.getContext(executionId);
+    }
+    on(type, handler) {
+        return this.runtime.on(type, handler);
+    }
+    getAgents() {
+        return this.runtime.getAgents();
+    }
+    approveToolExecution(requestId, approvedBy) {
+        return this.runtime.approveToolExecution(requestId, approvedBy);
+    }
+    rejectToolExecution(requestId) {
+        return this.runtime.rejectToolExecution(requestId);
+    }
+    getPendingApprovals() {
+        return this.runtime.getPendingApprovals();
+    }
+};
+exports.AgentService = AgentService;
+exports.AgentService = AgentService = __decorate([
+    (0, core_1.Injectable)(),
+    __metadata("design:paramtypes", [Object])
+], AgentService);
+/**
+ * Agent Module
+ * Uses static configuration pattern compatible with HazelJS DI
+ */
+let AgentModule = AgentModule_1 = class AgentModule {
+    static forRoot(options = {}) {
+        AgentModule_1.options = options;
+        return AgentModule_1;
+    }
+    static getOptions() {
+        return AgentModule_1.options;
+    }
+};
+exports.AgentModule = AgentModule;
+AgentModule.options = {};
+exports.AgentModule = AgentModule = AgentModule_1 = __decorate([
+    (0, core_1.HazelModule)({
+        providers: [AgentService],
+        exports: [AgentService],
+    })
+], AgentModule);
+//# sourceMappingURL=agent.module.js.map

package/dist/agent.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.module.js","sourceRoot":"","sources":["../src/agent.module.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;AAEH,wCAAwD;AACxD,2DAA2E;AAa3E;;;GAGG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAY;IAGvB,YAAY,SAA6B,EAAE;QACzC,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,IAAI,MAAM,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,IAAI,4BAAY,CAAC,aAAa,CAAC,CAAC;QAE/C,sCAAsC;QACtC,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtB,KAAK,MAAM,UAAU,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;gBAC3C,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,OAAO,CACX,SAAiB,EACjB,KAAa,EACb,OAAiC;QAEjC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,WAAmB,EAAE,KAAc;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,UAAU,CAAC,WAAmB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,EAAE,CAAC,IAAoB,EAAE,OAAiC;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;IAClC,CAAC;IAED,oBAAoB,CAAC,SAAiB,EAAE,UAAkB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;IAED,mBAAmB,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAC5C,CAAC;CACF,CAAA;AAvDY,oCAAY;uBAAZ,YAAY;IADxB,IAAA,iBAAU,GAAE;;GACA,YAAY,CAuDxB;AAED;;;GAGG;AAKI,IAAM,WAAW,mBAAjB,MAAM,WAAW;IAGtB,MAAM,CAAC,OAAO,CAAC,UAA8B,EAAE;QAC7C,aAAW,CAAC,OAAO,GAAG,OAAO,CAAC;QAC9B,OAAO,aAAW,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,UAAU;QACf,OAAO,aAAW,CAAC,OAAO,CAAC;IAC7B,CAAC;;AAVU,kCAAW;AACP,mBAAO,GAAuB,EAAE,AAAzB,CAA0B;sBADrC,WAAW;IAJvB,IAAA,kBAAW,EAAC;QACX,SAAS,EAAE,CAAC,YAAY,CAAC;QACzB,OAAO,EAAE,CAAC,YAAY,CAAC;KACxB,CAAC;GACW,WAAW,CAWvB"}

package/dist/context/agent.context.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Agent Context Builder
+ * Builds execution context with memory and RAG integration
+ */
+import { AgentContext } from '../types/agent.types';
+import { MemoryManager } from '@hazeljs/rag';
+/**
+ * Agent Context Builder
+ * Prepares context for agent execution
+ */
+export declare class AgentContextBuilder {
+    private memoryManager?;
+    constructor(memoryManager?: MemoryManager | undefined);
+    /**
+     * Build context with memory
+     */
+    buildWithMemory(context: AgentContext, maxHistory?: number): Promise<void>;
+    /**
+     * Build context with RAG
+     */
+    buildWithRAG(context: AgentContext, ragService: any, topK?: number): Promise<void>;
+    /**
+     * Persist context to memory
+     */
+    persistToMemory(context: AgentContext): Promise<void>;
+}
+//# sourceMappingURL=agent.context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.context.d.ts","sourceRoot":"","sources":["../../src/context/agent.context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AAE9D;;;GAGG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,aAAa,CAAC;gBAAd,aAAa,CAAC,EAAE,aAAa,YAAA;IAEjD;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BpF;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,YAAY,EAErB,UAAU,EAAE,GAAG,EACf,IAAI,GAAE,MAAU,GACf,OAAO,CAAC,IAAI,CAAC;IAchB;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAyC5D"}

package/dist/context/agent.context.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Agent Context Builder
+ * Builds execution context with memory and RAG integration
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentContextBuilder = void 0;
+/**
+ * Agent Context Builder
+ * Prepares context for agent execution
+ */
+class AgentContextBuilder {
+    constructor(memoryManager) {
+        this.memoryManager = memoryManager;
+    }
+    /**
+     * Build context with memory
+     */
+    async buildWithMemory(context, maxHistory = 20) {
+        if (!this.memoryManager) {
+            return;
+        }
+        const history = await this.memoryManager.getConversationHistory(context.sessionId, maxHistory);
+        context.memory.conversationHistory = history.map((msg) => ({
+            role: msg.role,
+            content: msg.content,
+            timestamp: msg.timestamp || new Date(),
+        }));
+        const entities = await this.memoryManager.getAllEntities(context.sessionId);
+        context.memory.entities = entities.map((entity) => ({
+            name: entity.name,
+            type: entity.type,
+            attributes: entity.attributes,
+        }));
+        const workingMemoryKeys = ['current_task', 'user_preferences', 'session_state'];
+        for (const key of workingMemoryKeys) {
+            const value = await this.memoryManager.getContext(key, context.sessionId);
+            if (value !== null) {
+                context.memory.workingMemory[key] = value;
+            }
+        }
+    }
+    /**
+     * Build context with RAG
+     */
+    async buildWithRAG(context, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ragService, topK = 5) {
+        if (!ragService) {
+            return;
+        }
+        try {
+            const results = await ragService.search(context.input, { topK });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            context.ragContext = results.map((r) => r.content || r.text);
+        }
+        catch {
+            context.ragContext = [];
+        }
+    }
+    /**
+     * Persist context to memory
+     */
+    async persistToMemory(context) {
+        if (!this.memoryManager) {
+            return;
+        }
+        for (const msg of context.memory.conversationHistory) {
+            await this.memoryManager.addMessage({
+                role: msg.role,
+                content: msg.content,
+                timestamp: msg.timestamp,
+            }, context.sessionId, context.userId);
+        }
+        for (const [key, value] of Object.entries(context.memory.workingMemory)) {
+            await this.memoryManager.setContext(key, value, context.sessionId);
+        }
+        for (const entity of context.memory.entities) {
+            const existingEntity = await this.memoryManager.getEntity(entity.name);
+            if (existingEntity) {
+                await this.memoryManager.updateEntity(entity.name, entity);
+            }
+            else {
+                await this.memoryManager.trackEntity({
+                    name: entity.name,
+                    type: entity.type,
+                    attributes: entity.attributes,
+                    relationships: [],
+                    firstSeen: new Date(),
+                    lastSeen: new Date(),
+                    mentions: 1,
+                }, context.sessionId);
+            }
+        }
+    }
+}
+exports.AgentContextBuilder = AgentContextBuilder;
+//# sourceMappingURL=agent.context.js.map

package/dist/context/agent.context.js.map

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

package/dist/decorators/agent.decorator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @Agent Decorator
+ * Marks a class as an Agent with configuration
+ */
+import 'reflect-metadata';
+import { AgentConfig, AgentMetadata } from '../types/agent.types';
+type NewableFunction = new (...args: unknown[]) => unknown;
+/**
+ * Agent decorator - marks a class as an agent
+ */
+export declare function Agent(config: AgentConfig): ClassDecorator;
+/**
+ * Get agent metadata from a class
+ */
+export declare function getAgentMetadata(target: NewableFunction): AgentMetadata | undefined;
+/**
+ * Check if a class is an agent
+ */
+export declare function isAgent(target: NewableFunction): boolean;
+export {};
+//# sourceMappingURL=agent.decorator.d.ts.map

package/dist/decorators/agent.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/agent.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAElE,KAAK,eAAe,GAAG,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAI3D;;GAEG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAWzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,GAAG,SAAS,CAEnF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAExD"}

package/dist/decorators/agent.decorator.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * @Agent Decorator
+ * Marks a class as an Agent with configuration
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agent = Agent;
+exports.getAgentMetadata = getAgentMetadata;
+exports.isAgent = isAgent;
+require("reflect-metadata");
+const AGENT_METADATA_KEY = Symbol('agent');
+/**
+ * Agent decorator - marks a class as an agent
+ */
+function Agent(config) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+    return ((target) => {
+        const metadata = {
+            ...config,
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+            target: target,
+        };
+        Reflect.defineMetadata(AGENT_METADATA_KEY, metadata, target);
+    });
+}
+/**
+ * Get agent metadata from a class
+ */
+function getAgentMetadata(target) {
+    return Reflect.getMetadata(AGENT_METADATA_KEY, target);
+}
+/**
+ * Check if a class is an agent
+ */
+function isAgent(target) {
+    return Reflect.hasMetadata(AGENT_METADATA_KEY, target);
+}
+//# sourceMappingURL=agent.decorator.js.map

package/dist/decorators/agent.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.decorator.js","sourceRoot":"","sources":["../../src/decorators/agent.decorator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAYH,sBAWC;AAKD,4CAEC;AAKD,0BAEC;AAnCD,4BAA0B;AAK1B,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AAE3C;;GAEG;AACH,SAAgB,KAAK,CAAC,MAAmB;IACvC,sEAAsE;IACtE,OAAO,CAAC,CAAC,MAAgB,EAAE,EAAE;QAC3B,MAAM,QAAQ,GAAkB;YAC9B,GAAG,MAAM;YACT,sEAAsE;YACtE,MAAM,EAAE,MAAyB;SAClC,CAAC;QAEF,OAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC,CAAmB,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,MAAuB;IACtD,OAAO,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAC,MAAuB;IAC7C,OAAO,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC"}

package/dist/decorators/tool.decorator.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @Tool Decorator
+ * Marks a method as a tool that can be used by agents
+ */
+import 'reflect-metadata';
+import { ToolConfig, ToolMetadata } from '../types/tool.types';
+/**
+ * Tool decorator - marks a method as a tool
+ */
+export declare function Tool(config?: Partial<ToolConfig>): MethodDecorator;
+/**
+ * Get tool metadata from a method
+ */
+export declare function getToolMetadata(target: object, propertyKey: string): ToolMetadata | undefined;
+/**
+ * Get all tools from an agent class
+ */
+export declare function getAgentTools(agentClass: new (...args: unknown[]) => unknown): string[];
+/**
+ * Check if a method is a tool
+ */
+export declare function isTool(target: object, propertyKey: string): boolean;
+//# sourceMappingURL=tool.decorator.d.ts.map

package/dist/decorators/tool.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/tool.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAK/D;;GAEG;AACH,wBAAgB,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,eAAe,CA6BlE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE7F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,MAAM,EAAE,CAEvF;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAEnE"}

package/dist/decorators/tool.decorator.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * @Tool Decorator
+ * Marks a method as a tool that can be used by agents
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tool = Tool;
+exports.getToolMetadata = getToolMetadata;
+exports.getAgentTools = getAgentTools;
+exports.isTool = isTool;
+require("reflect-metadata");
+const TOOL_METADATA_KEY = Symbol('tool');
+const TOOLS_LIST_KEY = Symbol('tools');
+/**
+ * Tool decorator - marks a method as a tool
+ */
+function Tool(config) {
+    return (target, propertyKey, descriptor) => {
+        const methodName = String(propertyKey);
+        const metadata = {
+            name: config?.name || methodName,
+            description: config?.description || `Tool: ${methodName}`,
+            parameters: config?.parameters || [],
+            requiresApproval: config?.requiresApproval || false,
+            timeout: config?.timeout || 30000,
+            retries: config?.retries || 0,
+            policy: config?.policy,
+            metadata: config?.metadata,
+            target,
+            propertyKey: methodName,
+            method: descriptor.value,
+            agentClass: target.constructor,
+        };
+        Reflect.defineMetadata(TOOL_METADATA_KEY, metadata, target, propertyKey);
+        const existingTools = Reflect.getMetadata(TOOLS_LIST_KEY, target.constructor) || [];
+        if (!existingTools.includes(methodName)) {
+            existingTools.push(methodName);
+            Reflect.defineMetadata(TOOLS_LIST_KEY, existingTools, target.constructor);
+        }
+        return descriptor;
+    };
+}
+/**
+ * Get tool metadata from a method
+ */
+function getToolMetadata(target, propertyKey) {
+    return Reflect.getMetadata(TOOL_METADATA_KEY, target, propertyKey);
+}
+/**
+ * Get all tools from an agent class
+ */
+function getAgentTools(agentClass) {
+    return Reflect.getMetadata(TOOLS_LIST_KEY, agentClass) || [];
+}
+/**
+ * Check if a method is a tool
+ */
+function isTool(target, propertyKey) {
+    return Reflect.hasMetadata(TOOL_METADATA_KEY, target, propertyKey);
+}
+//# sourceMappingURL=tool.decorator.js.map

package/dist/decorators/tool.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.decorator.js","sourceRoot":"","sources":["../../src/decorators/tool.decorator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAWH,oBA6BC;AAKD,0CAEC;AAKD,sCAEC;AAKD,wBAEC;AA3DD,4BAA0B;AAG1B,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AACzC,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AAEvC;;GAEG;AACH,SAAgB,IAAI,CAAC,MAA4B;IAC/C,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACtF,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QAEvC,MAAM,QAAQ,GAAiB;YAC7B,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,UAAU;YAChC,WAAW,EAAE,MAAM,EAAE,WAAW,IAAI,SAAS,UAAU,EAAE;YACzD,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,EAAE;YACpC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,IAAI,KAAK;YACnD,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,KAAK;YACjC,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,CAAC;YAC7B,MAAM,EAAE,MAAM,EAAE,MAAM;YACtB,QAAQ,EAAE,MAAM,EAAE,QAAQ;YAC1B,MAAM;YACN,WAAW,EAAE,UAAU;YACvB,MAAM,EAAE,UAAU,CAAC,KAAK;YACxB,UAAU,EAAE,MAAM,CAAC,WAAkD;SACtE,CAAC;QAEF,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAEzE,MAAM,aAAa,GAAa,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAC9F,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,OAAO,CAAC,cAAc,CAAC,cAAc,EAAE,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,MAAc,EAAE,WAAmB;IACjE,OAAO,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,UAA+C;IAC3E,OAAO,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAC,MAAc,EAAE,WAAmB;IACxD,OAAO,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACrE,CAAC"}

package/dist/events/event.emitter.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Agent Event Emitter
+ * Handles event emission and subscription for agent runtime
+ */
+import { AgentEvent, AgentEventType } from '../types/event.types';
+type EventHandler<T = unknown> = (event: AgentEvent<T>) => void | Promise<void>;
+/**
+ * Agent Event Emitter
+ * Pub/sub system for agent runtime events
+ */
+export declare class AgentEventEmitter {
+    private handlers;
+    private wildcardHandlers;
+    private logger;
+    /**
+     * Subscribe to an event type
+     */
+    on<T = unknown>(type: AgentEventType, handler: EventHandler<T>): void;
+    /**
+     * Subscribe to all events
+     */
+    onAny(handler: EventHandler): void;
+    /**
+     * Unsubscribe from an event type
+     */
+    off(type: AgentEventType, handler: EventHandler): void;
+    /**
+     * Unsubscribe from all events
+     */
+    offAny(handler: EventHandler): void;
+    /**
+     * Emit an event
+     */
+    emit<T = unknown>(type: AgentEventType, agentId: string, executionId: string, data: T, metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Clear all handlers
+     */
+    clear(): void;
+    /**
+     * Get handler count for an event type
+     */
+    listenerCount(type: AgentEventType): number;
+}
+export {};
+//# sourceMappingURL=event.emitter.d.ts.map

package/dist/events/event.emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.emitter.d.ts","sourceRoot":"","sources":["../../src/events/event.emitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGlE,KAAK,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhF;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAqD;IACrE,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,MAAM,CAAwC;IAEtD;;OAEG;IACH,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAOrE;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIlC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAOtD;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAInC;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,CAAC,EACP,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAsChB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;CAG5C"}

package/dist/events/event.emitter.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Agent Event Emitter
+ * Handles event emission and subscription for agent runtime
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentEventEmitter = void 0;
+const logger_1 = require("../utils/logger");
+/**
+ * Agent Event Emitter
+ * Pub/sub system for agent runtime events
+ */
+class AgentEventEmitter {
+    constructor() {
+        this.handlers = new Map();
+        this.wildcardHandlers = new Set();
+        this.logger = new logger_1.Logger({ level: logger_1.LogLevel.WARN });
+    }
+    /**
+     * Subscribe to an event type
+     */
+    on(type, handler) {
+        if (!this.handlers.has(type)) {
+            this.handlers.set(type, new Set());
+        }
+        this.handlers.get(type).add(handler);
+    }
+    /**
+     * Subscribe to all events
+     */
+    onAny(handler) {
+        this.wildcardHandlers.add(handler);
+    }
+    /**
+     * Unsubscribe from an event type
+     */
+    off(type, handler) {
+        const handlers = this.handlers.get(type);
+        if (handlers) {
+            handlers.delete(handler);
+        }
+    }
+    /**
+     * Unsubscribe from all events
+     */
+    offAny(handler) {
+        this.wildcardHandlers.delete(handler);
+    }
+    /**
+     * Emit an event
+     */
+    async emit(type, agentId, executionId, data, metadata) {
+        const event = {
+            type,
+            agentId,
+            executionId,
+            timestamp: new Date(),
+            data,
+            metadata,
+        };
+        const handlers = this.handlers.get(type);
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    await handler(event);
+                }
+                catch (error) {
+                    this.logger.error(`Error in event handler for ${type}`, error instanceof Error ? error : new Error(String(error)), { executionId });
+                }
+            }
+        }
+        for (const handler of this.wildcardHandlers) {
+            try {
+                await handler(event);
+            }
+            catch (error) {
+                this.logger.error(`Error in wildcard event handler for ${type}`, error instanceof Error ? error : new Error(String(error)), { executionId });
+            }
+        }
+    }
+    /**
+     * Clear all handlers
+     */
+    clear() {
+        this.handlers.clear();
+        this.wildcardHandlers.clear();
+    }
+    /**
+     * Get handler count for an event type
+     */
+    listenerCount(type) {
+        return this.handlers.get(type)?.size || 0;
+    }
+}
+exports.AgentEventEmitter = AgentEventEmitter;
+//# sourceMappingURL=event.emitter.js.map

package/dist/events/event.emitter.js.map

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

package/dist/executor/agent.executor.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Agent Executor
+ * Core execution loop for agents
+ */
+import { AgentContext, AgentExecutionResult } from '../types/agent.types';
+import { IAgentStateManager } from '../state/agent-state.interface';
+import { AgentContextBuilder } from '../context/agent.context';
+import { ToolExecutor } from './tool.executor';
+import { ToolRegistry } from '../registry/tool.registry';
+import { AgentEventType } from '../types/event.types';
+import { LLMProvider } from '../types/llm.types';
+/**
+ * Agent Executor
+ * Implements the core agent execution loop
+ */
+export declare class AgentExecutor {
+    private stateManager;
+    private contextBuilder;
+    private toolExecutor;
+    private toolRegistry;
+    private llmProvider?;
+    private eventEmitter?;
+    constructor(stateManager: IAgentStateManager, contextBuilder: AgentContextBuilder, toolExecutor: ToolExecutor, toolRegistry: ToolRegistry, llmProvider?: LLMProvider | undefined, eventEmitter?: ((type: AgentEventType, executionId: string, data: unknown) => void) | undefined);
+    /**
+     * Helper to handle both sync and async state manager calls
+     */
+    private unwrap;
+    /**
+     * Execute agent with controlled loop
+     */
+    execute(context: AgentContext, maxSteps?: number): Promise<AgentExecutionResult>;
+    /**
+     * Execute a single step
+     */
+    private executeStep;
+    /**
+     * Decide next action using LLM
+     */
+    private decideNextAction;
+    /**
+     * Execute a tool
+     */
+    private executeTool;
+    /**
+     * Build prompt for LLM
+     */
+    private buildPrompt;
+    /**
+     * Resume execution after pause
+     */
+    resume(executionId: string, input?: string): Promise<AgentExecutionResult>;
+    /**
+     * Emit event
+     */
+    private emitEvent;
+}
+//# sourceMappingURL=agent.executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.executor.d.ts","sourceRoot":"","sources":["../../src/executor/agent.executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,YAAY,EAMZ,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;GAGG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,WAAW,CAAC;IACpB,OAAO,CAAC,YAAY,CAAC;gBALb,YAAY,EAAE,kBAAkB,EAChC,cAAc,EAAE,mBAAmB,EACnC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,WAAW,YAAA,EACzB,YAAY,CAAC,GAAE,CAAC,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,aAAA;IAG3F;;OAEG;YACW,MAAM;IAIpB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,GAAE,MAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA+F1F;;OAEG;YACW,WAAW;IAoFzB;;OAEG;YACW,gBAAgB;IA2C9B;;OAEG;YACW,WAAW;IAgDzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAyBnB;;OAEG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmBhF;;OAEG;IACH,OAAO,CAAC,SAAS;CAKlB"}