@hazeljs/agent 0.2.0-beta.1

package/dist/index.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * @hazeljs/agent
+ * AI-native Agent Runtime for HazelJS
+ */
+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("./types/agent.types"), exports);
+__exportStar(require("./types/tool.types"), exports);
+__exportStar(require("./types/event.types"), exports);
+__exportStar(require("./types/llm.types"), exports);
+__exportStar(require("./types/rag.types"), exports);
+__exportStar(require("./decorators/agent.decorator"), exports);
+__exportStar(require("./decorators/tool.decorator"), exports);
+__exportStar(require("./registry/agent.registry"), exports);
+__exportStar(require("./registry/tool.registry"), exports);
+__exportStar(require("./state/agent.state"), exports);
+__exportStar(require("./state/agent-state.interface"), exports);
+__exportStar(require("./state/redis-state.manager"), exports);
+__exportStar(require("./state/database-state.manager"), exports);
+__exportStar(require("./context/agent.context"), exports);
+__exportStar(require("./executor/agent.executor"), exports);
+__exportStar(require("./executor/tool.executor"), exports);
+__exportStar(require("./events/event.emitter"), exports);
+__exportStar(require("./runtime/agent.runtime"), exports);
+__exportStar(require("./utils/rate-limiter"), exports);
+__exportStar(require("./utils/logger"), exports);
+__exportStar(require("./utils/metrics"), exports);
+__exportStar(require("./utils/retry"), exports);
+__exportStar(require("./utils/circuit-breaker"), exports);
+__exportStar(require("./utils/health-check"), exports);
+__exportStar(require("./agent.module"), 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;;;GAGG;;;;;;;;;;;;;;;;AAEH,sDAAoC;AACpC,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC;AAClC,oDAAkC;AAElC,+DAA6C;AAC7C,8DAA4C;AAE5C,4DAA0C;AAC1C,2DAAyC;AAEzC,sDAAoC;AACpC,gEAA8C;AAC9C,8DAA4C;AAC5C,iEAA+C;AAC/C,0DAAwC;AAExC,4DAA0C;AAC1C,2DAAyC;AAEzC,yDAAuC;AAEvC,0DAAwC;AAExC,uDAAqC;AACrC,iDAA+B;AAC/B,kDAAgC;AAChC,gDAA8B;AAC9B,0DAAwC;AACxC,uDAAqC;AAErC,iDAA+B"}

package/dist/registry/agent.registry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Agent Registry
+ * Central registry for all agents in the system
+ */
+import { AgentMetadata } from '../types/agent.types';
+/**
+ * Agent Registry - manages agent registration and lookup
+ */
+export declare class AgentRegistry {
+    private agents;
+    private instances;
+    /**
+     * Register an agent class
+     */
+    register(agentClass: new (...args: unknown[]) => unknown): void;
+    /**
+     * Register an agent instance
+     */
+    registerInstance(agentName: string, instance: unknown): void;
+    /**
+     * Get agent metadata by name
+     */
+    getAgent(name: string): AgentMetadata | undefined;
+    /**
+     * Get agent instance by name
+     */
+    getInstance(name: string): unknown | undefined;
+    /**
+     * Get all registered agents
+     */
+    getAllAgents(): AgentMetadata[];
+    /**
+     * Check if an agent is registered
+     */
+    hasAgent(name: string): boolean;
+    /**
+     * Unregister an agent
+     */
+    unregister(name: string): void;
+    /**
+     * Clear all agents
+     */
+    clear(): void;
+    /**
+     * Get agent count
+     */
+    get count(): number;
+}
+//# sourceMappingURL=agent.registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.registry.d.ts","sourceRoot":"","sources":["../../src/registry/agent.registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,SAAS,CAAmC;IAEpD;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI;IAiB/D;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAW5D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIjD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI9C;;OAEG;IACH,YAAY,IAAI,aAAa,EAAE;IAI/B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;CACF"}

package/dist/registry/agent.registry.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Agent Registry
+ * Central registry for all agents in the system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRegistry = void 0;
+const agent_decorator_1 = require("../decorators/agent.decorator");
+/**
+ * Agent Registry - manages agent registration and lookup
+ */
+class AgentRegistry {
+    constructor() {
+        this.agents = new Map();
+        this.instances = new Map();
+    }
+    /**
+     * Register an agent class
+     */
+    register(agentClass) {
+        if (!(0, agent_decorator_1.isAgent)(agentClass)) {
+            throw new Error(`Class ${agentClass.name} is not decorated with @Agent`);
+        }
+        const metadata = (0, agent_decorator_1.getAgentMetadata)(agentClass);
+        if (!metadata) {
+            throw new Error(`Failed to get metadata for agent ${agentClass.name}`);
+        }
+        if (this.agents.has(metadata.name)) {
+            throw new Error(`Agent ${metadata.name} is already registered`);
+        }
+        this.agents.set(metadata.name, metadata);
+    }
+    /**
+     * Register an agent instance
+     */
+    registerInstance(agentName, instance) {
+        if (!this.agents.has(agentName)) {
+            throw new Error(`Agent ${agentName} is not registered`);
+        }
+        this.instances.set(agentName, instance);
+        const metadata = this.agents.get(agentName);
+        metadata.instance = instance;
+    }
+    /**
+     * Get agent metadata by name
+     */
+    getAgent(name) {
+        return this.agents.get(name);
+    }
+    /**
+     * Get agent instance by name
+     */
+    getInstance(name) {
+        return this.instances.get(name);
+    }
+    /**
+     * Get all registered agents
+     */
+    getAllAgents() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Check if an agent is registered
+     */
+    hasAgent(name) {
+        return this.agents.has(name);
+    }
+    /**
+     * Unregister an agent
+     */
+    unregister(name) {
+        this.agents.delete(name);
+        this.instances.delete(name);
+    }
+    /**
+     * Clear all agents
+     */
+    clear() {
+        this.agents.clear();
+        this.instances.clear();
+    }
+    /**
+     * Get agent count
+     */
+    get count() {
+        return this.agents.size;
+    }
+}
+exports.AgentRegistry = AgentRegistry;
+//# sourceMappingURL=agent.registry.js.map

package/dist/registry/agent.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.registry.js","sourceRoot":"","sources":["../../src/registry/agent.registry.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,mEAA0E;AAE1E;;GAEG;AACH,MAAa,aAAa;IAA1B;QACU,WAAM,GAA+B,IAAI,GAAG,EAAE,CAAC;QAC/C,cAAS,GAAyB,IAAI,GAAG,EAAE,CAAC;IAsFtD,CAAC;IApFC;;OAEG;IACH,QAAQ,CAAC,UAA+C;QACtD,IAAI,CAAC,IAAA,yBAAO,EAAC,UAAU,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,SAAS,UAAU,CAAC,IAAI,+BAA+B,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,QAAQ,GAAG,IAAA,kCAAgB,EAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,oCAAoC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,CAAC,IAAI,wBAAwB,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAiB,EAAE,QAAiB;QACnD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,SAAS,SAAS,oBAAoB,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAExC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;QAC7C,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF;AAxFD,sCAwFC"}

package/dist/registry/tool.registry.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Tool Registry
+ * Central registry for all tools in the system
+ */
+import { ToolMetadata, ToolDefinition } from '../types/tool.types';
+import { LLMToolDefinition } from '../types/llm.types';
+/**
+ * Tool Registry - manages tool registration and lookup
+ */
+export declare class ToolRegistry {
+    private tools;
+    private agentTools;
+    /**
+     * Register tools from an agent instance
+     */
+    registerAgentTools(agentName: string, agentInstance: unknown): void;
+    /**
+     * Get tool metadata by name
+     */
+    getTool(toolName: string): ToolMetadata | undefined;
+    /**
+     * Get all tools for an agent
+     */
+    getAgentTools(agentName: string): ToolMetadata[];
+    /**
+     * Get all registered tools
+     */
+    getAllTools(): ToolMetadata[];
+    /**
+     * Check if a tool is registered
+     */
+    hasTool(toolName: string): boolean;
+    /**
+     * Get tool definitions for LLM (OpenAI function calling format)
+     */
+    getToolDefinitions(agentName: string): ToolDefinition[];
+    /**
+     * Unregister all tools for an agent
+     */
+    unregisterAgentTools(agentName: string): void;
+    /**
+     * Clear all tools
+     */
+    clear(): void;
+    /**
+     * Get tool count
+     */
+    get count(): number;
+    /**
+     * Convert tool definitions to LLM format (OpenAI function calling)
+     */
+    getToolDefinitionsForLLM(agentName: string): LLMToolDefinition[];
+}
+//# sourceMappingURL=tool.registry.d.ts.map

package/dist/registry/tool.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.registry.d.ts","sourceRoot":"","sources":["../../src/registry/tool.registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,UAAU,CAAuC;IAEzD;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI;IAuCnE;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAInD;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE;IAWhD;;OAEG;IACH,WAAW,IAAI,YAAY,EAAE;IAI7B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IA2CvD;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAU7C;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,EAAE;CAYjE"}

package/dist/registry/tool.registry.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Tool Registry
+ * Central registry for all tools in the system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRegistry = void 0;
+const tool_decorator_1 = require("../decorators/tool.decorator");
+/**
+ * Tool Registry - manages tool registration and lookup
+ */
+class ToolRegistry {
+    constructor() {
+        this.tools = new Map();
+        this.agentTools = new Map();
+    }
+    /**
+     * Register tools from an agent instance
+     */
+    registerAgentTools(agentName, agentInstance) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const agentClass = agentInstance.constructor;
+        const toolNames = (0, tool_decorator_1.getAgentTools)(agentClass);
+        if (toolNames.length === 0) {
+            return;
+        }
+        const agentToolSet = new Set();
+        for (const toolName of toolNames) {
+            const metadata = (0, tool_decorator_1.getToolMetadata)(agentInstance, toolName);
+            if (!metadata) {
+                // Tool metadata not found, skip
+                continue;
+            }
+            const fullToolName = `${agentName}.${toolName}`;
+            if (this.tools.has(fullToolName)) {
+                // Tool already registered, skip
+                continue;
+            }
+            // Update metadata to use the actual instance instead of prototype
+            const instanceMetadata = {
+                ...metadata,
+                target: agentInstance,
+            };
+            this.tools.set(fullToolName, instanceMetadata);
+            agentToolSet.add(fullToolName);
+        }
+        this.agentTools.set(agentName, agentToolSet);
+    }
+    /**
+     * Get tool metadata by name
+     */
+    getTool(toolName) {
+        return this.tools.get(toolName);
+    }
+    /**
+     * Get all tools for an agent
+     */
+    getAgentTools(agentName) {
+        const toolNames = this.agentTools.get(agentName);
+        if (!toolNames) {
+            return [];
+        }
+        return Array.from(toolNames)
+            .map((name) => this.tools.get(name))
+            .filter((tool) => tool !== undefined);
+    }
+    /**
+     * Get all registered tools
+     */
+    getAllTools() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Check if a tool is registered
+     */
+    hasTool(toolName) {
+        return this.tools.has(toolName);
+    }
+    /**
+     * Get tool definitions for LLM (OpenAI function calling format)
+     */
+    getToolDefinitions(agentName) {
+        const tools = this.getAgentTools(agentName);
+        return tools.map((tool) => {
+            const properties = {};
+            const required = [];
+            if (tool.parameters) {
+                for (const param of tool.parameters) {
+                    properties[param.name] = {
+                        type: param.type,
+                        description: param.description,
+                    };
+                    if (param.enum) {
+                        properties[param.name].enum = param.enum;
+                    }
+                    if (param.required) {
+                        required.push(param.name);
+                    }
+                }
+            }
+            return {
+                name: tool.name,
+                description: tool.description,
+                parameters: {
+                    type: 'object',
+                    properties,
+                    required,
+                },
+            };
+        });
+    }
+    /**
+     * Unregister all tools for an agent
+     */
+    unregisterAgentTools(agentName) {
+        const toolNames = this.agentTools.get(agentName);
+        if (toolNames) {
+            for (const toolName of toolNames) {
+                this.tools.delete(toolName);
+            }
+            this.agentTools.delete(agentName);
+        }
+    }
+    /**
+     * Clear all tools
+     */
+    clear() {
+        this.tools.clear();
+        this.agentTools.clear();
+    }
+    /**
+     * Get tool count
+     */
+    get count() {
+        return this.tools.size;
+    }
+    /**
+     * Convert tool definitions to LLM format (OpenAI function calling)
+     */
+    getToolDefinitionsForLLM(agentName) {
+        const tools = this.getToolDefinitions(agentName);
+        return tools.map((tool) => ({
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.parameters,
+            },
+        }));
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+//# sourceMappingURL=tool.registry.js.map

package/dist/registry/tool.registry.js.map

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

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

@@ -0,0 +1,155 @@
+/**
+ * Agent Runtime
+ * Main runtime for managing agent lifecycle and execution
+ */
+import { IAgentStateManager } from '../state/agent-state.interface';
+import { AgentExecutionOptions, AgentExecutionResult, AgentContext } from '../types/agent.types';
+import { AgentEventType } from '../types/event.types';
+import { LLMProvider } from '../types/llm.types';
+import { RAGService } from '../types/rag.types';
+import { MemoryManager } from '@hazeljs/rag';
+import { LogLevel } from '../utils/logger';
+import { HealthCheckResult } from '../utils/health-check';
+/**
+ * Agent Runtime Configuration
+ */
+export interface AgentRuntimeConfig {
+    stateManager?: IAgentStateManager;
+    memoryManager?: MemoryManager;
+    ragService?: RAGService;
+    llmProvider?: LLMProvider;
+    defaultMaxSteps?: number;
+    defaultTimeout?: number;
+    enableObservability?: boolean;
+    rateLimitPerMinute?: number;
+    enableMetrics?: boolean;
+    logLevel?: LogLevel;
+    enableRetry?: boolean;
+    enableCircuitBreaker?: boolean;
+}
+/**
+ * Agent Runtime
+ * Central runtime for agent execution and lifecycle management
+ */
+export declare class AgentRuntime {
+    private agentRegistry;
+    private toolRegistry;
+    private stateManager;
+    private contextBuilder;
+    private toolExecutor;
+    private agentExecutor;
+    private eventEmitter;
+    private config;
+    private rateLimiter?;
+    private metrics?;
+    private logger;
+    private retryHandler?;
+    private circuitBreaker?;
+    private healthChecker;
+    constructor(config?: AgentRuntimeConfig);
+    /**
+     * Register an agent class
+     */
+    registerAgent(agentClass: new (...args: unknown[]) => unknown): void;
+    /**
+     * Register an agent instance
+     */
+    registerAgentInstance(agentName: string, instance: unknown): void;
+    /**
+     * Execute an agent
+     */
+    execute(agentName: string, input: string, options?: AgentExecutionOptions): Promise<AgentExecutionResult>;
+    /**
+     * Execute with retry and circuit breaker protection
+     */
+    private executeWithProtection;
+    /**
+     * Resume a paused execution
+     */
+    resume(executionId: string, input?: string): Promise<AgentExecutionResult>;
+    /**
+     * Get execution context
+     */
+    getContext(executionId: string): Promise<AgentContext | undefined>;
+    /**
+     * Subscribe to agent events
+     */
+    on(type: AgentEventType, handler: (event: unknown) => void): void;
+    /**
+     * Subscribe to all agent events
+     */
+    onAny(handler: (event: unknown) => void): void;
+    /**
+     * Unsubscribe from events
+     */
+    off(type: AgentEventType, handler: (event: unknown) => void): void;
+    /**
+     * Get all registered agents
+     */
+    getAgents(): string[];
+    /**
+     * Get agent metadata
+     */
+    getAgentMetadata(agentName: string): import('../types/agent.types').AgentMetadata | undefined;
+    /**
+     * Get health check status
+     */
+    healthCheck(): Promise<HealthCheckResult>;
+    /**
+     * Get metrics
+     */
+    getMetrics(): import('../utils/metrics').AgentMetrics | undefined;
+    /**
+     * Get metrics summary
+     */
+    getMetricsSummary(): string;
+    /**
+     * Reset metrics
+     */
+    resetMetrics(): void;
+    /**
+     * Get rate limiter status
+     */
+    getRateLimiterStatus(): {
+        enabled: boolean;
+        availableTokens?: number;
+    };
+    /**
+     * Get circuit breaker status
+     */
+    getCircuitBreakerStatus(): {
+        enabled: boolean;
+        state?: string;
+        failureCount?: number;
+        successCount?: number;
+    };
+    /**
+     * Reset circuit breaker
+     */
+    resetCircuitBreaker(): void;
+    /**
+     * Get agent tools
+     */
+    getAgentTools(agentName: string): import('../types/tool.types').ToolMetadata[];
+    /**
+     * Approve a tool execution
+     */
+    approveToolExecution(requestId: string, approvedBy: string): void;
+    /**
+     * Reject a tool execution
+     */
+    rejectToolExecution(requestId: string): void;
+    /**
+     * Get pending tool approvals
+     */
+    getPendingApprovals(): import('../types/tool.types').ToolApprovalRequest[];
+    /**
+     * Shutdown the runtime
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Generate a session ID
+     */
+    private generateSessionId;
+}
+//# sourceMappingURL=agent.runtime.d.ts.map

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

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

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

@@ -0,0 +1,49 @@
+/**
+ * Agent Runtime Extensions
+ * Additional methods for health checks, metrics, and monitoring
+ */
+import { AgentRuntime } from './agent.runtime';
+import { HealthCheckResult } from '../utils/health-check';
+import { AgentMetrics } from '../utils/metrics';
+/**
+ * Extended methods for AgentRuntime
+ */
+export declare class AgentRuntimeExtensions {
+    /**
+     * Get health check status
+     */
+    static getHealthCheck(runtime: AgentRuntime): Promise<HealthCheckResult>;
+    /**
+     * Get metrics summary
+     */
+    static getMetrics(runtime: AgentRuntime): AgentMetrics | null;
+    /**
+     * Get metrics summary as string
+     */
+    static getMetricsSummary(runtime: AgentRuntime): string;
+    /**
+     * Reset metrics
+     */
+    static resetMetrics(runtime: AgentRuntime): void;
+    /**
+     * Get rate limiter status
+     */
+    static getRateLimiterStatus(runtime: AgentRuntime): {
+        enabled: boolean;
+        availableTokens?: number;
+    };
+    /**
+     * Get circuit breaker status
+     */
+    static getCircuitBreakerStatus(runtime: AgentRuntime): {
+        enabled: boolean;
+        state?: string;
+        failureCount?: number;
+        successCount?: number;
+    };
+    /**
+     * Reset circuit breaker
+     */
+    static resetCircuitBreaker(runtime: AgentRuntime): void;
+}
+//# sourceMappingURL=agent.runtime.extensions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.runtime.extensions.d.ts","sourceRoot":"","sources":["../../src/runtime/agent.runtime.extensions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;WACU,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmB9E;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,GAAG,IAAI;IAM7D;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM;IAMvD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAQhD;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG;QAClD,OAAO,EAAE,OAAO,CAAC;QACjB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B;IASD;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,OAAO,EAAE,YAAY,GAAG;QACrD,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;IAWD;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;CAOxD"}