agentic-qe 2.3.4 → 2.4.0

package/dist/agents/adapters/LifecycleManagerAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LifecycleManagerAdapter.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/LifecycleManagerAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAG3E;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,sBAAsB;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,MAAM,CAAC,CAAkB;IACjC,OAAO,CAAC,gBAAgB,CAAC,CAAkC;IAC3D,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAc;gBAEnB,OAAO,EAAE,qBAAqB;IAIpC,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxD,SAAS,IAAI,WAAW;IAIlB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BjE,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,iBAAiB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAIjE,aAAa,IAAI,OAAO;IAKxB,UAAU,IAAI,gBAAgB;CAS/B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,qBAAqB,GAC7B,sBAAsB,CAExB"}

package/dist/agents/adapters/LifecycleManagerAdapter.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * LifecycleManagerAdapter - Adapts AgentLifecycleManager to AgentLifecycleStrategy
+ *
+ * Provides backward compatibility during the B1.2 migration.
+ * Wraps the existing AgentLifecycleManager to implement the strategy interface.
+ *
+ * @module agents/adapters/LifecycleManagerAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LifecycleManagerAdapter = void 0;
+exports.createLifecycleAdapter = createLifecycleAdapter;
+const types_1 = require("../../types");
+/**
+ * Adapts AgentLifecycleManager to AgentLifecycleStrategy interface
+ *
+ * This adapter allows BaseAgent to use the strategy interface while
+ * maintaining backward compatibility with existing AgentLifecycleManager.
+ */
+class LifecycleManagerAdapter {
+    constructor(manager) {
+        this.tasksExecuted = 0;
+        this.initTime = 0;
+        this.startTime = Date.now();
+        this.manager = manager;
+    }
+    async initialize(config) {
+        this.config = config;
+        this.initTime = Date.now();
+        // Manager is already initialized by BaseAgent constructor
+        // This is called when using the strategy pattern
+    }
+    getStatus() {
+        return this.manager.getStatus();
+    }
+    async transitionTo(status, reason) {
+        const previousStatus = this.getStatus();
+        // Map to manager methods
+        switch (status) {
+            case types_1.AgentStatus.ACTIVE:
+                this.manager.markActive();
+                break;
+            case types_1.AgentStatus.IDLE:
+                this.manager.markIdle();
+                break;
+            case types_1.AgentStatus.ERROR:
+                this.manager.markError(reason || 'Unknown error');
+                break;
+            default:
+                // Use the manager's transitionTo for other statuses
+                this.manager.transitionTo(status, reason);
+        }
+        // Emit lifecycle event if handler registered
+        if (this.lifecycleHandler) {
+            this.lifecycleHandler({
+                previousStatus,
+                newStatus: status,
+                timestamp: new Date(),
+                reason,
+            });
+        }
+    }
+    async waitForStatus(status, timeout) {
+        // Poll for status change
+        const start = Date.now();
+        while (Date.now() - start < timeout) {
+            if (this.getStatus() === status) {
+                return;
+            }
+            await new Promise(resolve => setTimeout(resolve, 50));
+        }
+        throw new Error(`Timeout waiting for status ${status} after ${timeout}ms`);
+    }
+    async waitForReady(timeout) {
+        // Wait for ACTIVE or IDLE status
+        const start = Date.now();
+        while (Date.now() - start < timeout) {
+            const current = this.getStatus();
+            if (current === types_1.AgentStatus.ACTIVE || current === types_1.AgentStatus.IDLE) {
+                return;
+            }
+            await new Promise(resolve => setTimeout(resolve, 50));
+        }
+        throw new Error(`Timeout waiting for ready state after ${timeout}ms`);
+    }
+    async shutdown() {
+        await this.manager.terminate({});
+    }
+    async reset() {
+        this.manager.reset(false);
+        this.tasksExecuted = 0;
+    }
+    // Lifecycle hooks - these can be overridden by subclasses
+    async onPreTask(_data) {
+        // Default: no-op, can be overridden
+    }
+    async onPostTask(_data) {
+        this.tasksExecuted++;
+    }
+    async onTaskError(_data) {
+        // Default: no-op, can be overridden
+    }
+    onLifecycleChange(handler) {
+        this.lifecycleHandler = handler;
+    }
+    canAcceptTask() {
+        const status = this.getStatus();
+        return status === types_1.AgentStatus.ACTIVE || status === types_1.AgentStatus.IDLE;
+    }
+    getMetrics() {
+        return {
+            initializationTime: this.initTime ? Date.now() - this.initTime : 0,
+            uptime: Date.now() - this.startTime,
+            stateTransitions: 0, // Would need manager to expose this
+            tasksExecuted: this.tasksExecuted,
+            lastActivity: new Date(),
+        };
+    }
+}
+exports.LifecycleManagerAdapter = LifecycleManagerAdapter;
+/**
+ * Create a lifecycle strategy adapter from an existing manager
+ */
+function createLifecycleAdapter(manager) {
+    return new LifecycleManagerAdapter(manager);
+}
+//# sourceMappingURL=LifecycleManagerAdapter.js.map

package/dist/agents/adapters/LifecycleManagerAdapter.js.map

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

package/dist/agents/adapters/MemoryServiceAdapter.d.ts

@@ -0,0 +1,96 @@
+/**
+ * MemoryServiceAdapter - Adapts AgentMemoryService to AgentMemoryStrategy
+ *
+ * Provides backward compatibility during the B1.2 migration.
+ * Wraps the existing AgentMemoryService to implement the strategy interface.
+ *
+ * Phase 2 Update: Added agentId support for automatic namespace prefixing
+ * to maintain backward compatibility with BaseAgent's memory operations.
+ *
+ * @module agents/adapters/MemoryServiceAdapter
+ * @version 1.1.0
+ */
+import type { AgentMemoryStrategy, MemoryOptions, MemoryEntry, MemoryQueryOptions, MemoryStats } from '../../core/strategies';
+import type { QEAgentType, MemoryStore, AgentId } from '../../types';
+import { AgentMemoryService } from '../memory/AgentMemoryService';
+/**
+ * Adapts AgentMemoryService to AgentMemoryStrategy interface
+ *
+ * Supports two namespace formats for backward compatibility:
+ * - Agent-local: aqe/{agentType}/{key}
+ * - Shared: aqe/shared/{agentType}/{key}
+ */
+export declare class MemoryServiceAdapter implements AgentMemoryStrategy {
+    private readonly service;
+    private readonly memoryStore;
+    private readonly agentId?;
+    private initialized;
+    private stats;
+    constructor(service: AgentMemoryService, memoryStore: MemoryStore, agentId?: AgentId);
+    /**
+     * Create agent-local namespace key: aqe/{agentType}/{key}
+     * Used for agent-private storage
+     */
+    private getLocalKey;
+    /**
+     * Create shared namespace key: aqe/shared/{agentType}/{key}
+     * Used for cross-agent shared storage
+     */
+    private getSharedKey;
+    store(key: string, value: unknown, options?: MemoryOptions): Promise<void>;
+    retrieve<T = unknown>(key: string): Promise<T | undefined>;
+    delete(key: string): Promise<boolean>;
+    exists(key: string): Promise<boolean>;
+    /**
+     * Store in shared memory using aqe/shared/{agentType}/{key} namespace
+     * Makes data accessible to other agents of the specified type
+     */
+    storeShared(agentType: QEAgentType, key: string, value: unknown, options?: MemoryOptions): Promise<void>;
+    /**
+     * Retrieve from shared memory using aqe/shared/{agentType}/{key} namespace
+     * Shared memory uses partition: 'shared'
+     */
+    retrieveShared<T = unknown>(agentType: QEAgentType, key: string): Promise<T | undefined>;
+    /**
+     * Store in agent-local memory using aqe/{agentType}/{key} namespace
+     * Maintains backward compatibility with BaseAgent.storeMemory()
+     */
+    storeLocal(key: string, value: unknown, ttl?: number): Promise<void>;
+    /**
+     * Retrieve from agent-local memory using aqe/{agentType}/{key} namespace
+     * Maintains backward compatibility with BaseAgent.retrieveMemory()
+     */
+    retrieveLocal<T = unknown>(key: string): Promise<T | undefined>;
+    /**
+     * Store in shared memory for this agent's type
+     * Convenience method matching BaseAgent.storeSharedMemory()
+     */
+    storeSharedLocal(key: string, value: unknown, ttl?: number): Promise<void>;
+    bulkStore(entries: MemoryEntry[]): Promise<void>;
+    bulkRetrieve<T = unknown>(keys: string[]): Promise<Map<string, T>>;
+    bulkDelete(keys: string[]): Promise<number>;
+    query<T = unknown>(options: MemoryQueryOptions): Promise<MemoryEntry[]>;
+    listKeys(_pattern?: string): Promise<string[]>;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    clear(): Promise<void>;
+    getStats(): Promise<MemoryStats>;
+}
+/**
+ * Create a memory strategy adapter from an existing service
+ *
+ * @param service - AgentMemoryService instance
+ * @param memoryStore - MemoryStore (typically SwarmMemoryManager)
+ * @param agentId - Optional agent ID for namespace prefixing
+ */
+export declare function createMemoryAdapter(service: AgentMemoryService, memoryStore: MemoryStore, agentId?: AgentId): MemoryServiceAdapter;
+/**
+ * Extended interface for agent-local memory operations
+ * Used internally by BaseAgent for backward compatibility
+ */
+export interface AgentLocalMemoryStrategy extends AgentMemoryStrategy {
+    storeLocal(key: string, value: unknown, ttl?: number): Promise<void>;
+    retrieveLocal<T = unknown>(key: string): Promise<T | undefined>;
+    storeSharedLocal(key: string, value: unknown, ttl?: number): Promise<void>;
+}
+//# sourceMappingURL=MemoryServiceAdapter.d.ts.map

package/dist/agents/adapters/MemoryServiceAdapter.d.ts.map

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

package/dist/agents/adapters/MemoryServiceAdapter.js

@@ -0,0 +1,266 @@
+"use strict";
+/**
+ * MemoryServiceAdapter - Adapts AgentMemoryService to AgentMemoryStrategy
+ *
+ * Provides backward compatibility during the B1.2 migration.
+ * Wraps the existing AgentMemoryService to implement the strategy interface.
+ *
+ * Phase 2 Update: Added agentId support for automatic namespace prefixing
+ * to maintain backward compatibility with BaseAgent's memory operations.
+ *
+ * @module agents/adapters/MemoryServiceAdapter
+ * @version 1.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryServiceAdapter = void 0;
+exports.createMemoryAdapter = createMemoryAdapter;
+const SwarmMemoryManager_1 = require("../../core/memory/SwarmMemoryManager");
+/**
+ * Adapts AgentMemoryService to AgentMemoryStrategy interface
+ *
+ * Supports two namespace formats for backward compatibility:
+ * - Agent-local: aqe/{agentType}/{key}
+ * - Shared: aqe/shared/{agentType}/{key}
+ */
+class MemoryServiceAdapter {
+    constructor(service, memoryStore, agentId) {
+        this.initialized = false;
+        this.stats = {
+            totalEntries: 0,
+            totalSize: 0,
+            hitRate: 0,
+            missRate: 0,
+            evictionCount: 0,
+            lastCleanup: new Date(),
+        };
+        this.service = service;
+        this.memoryStore = memoryStore;
+        this.agentId = agentId;
+    }
+    // === Namespace Helpers ===
+    /**
+     * Create agent-local namespace key: aqe/{agentType}/{key}
+     * Used for agent-private storage
+     */
+    getLocalKey(key) {
+        if (!this.agentId)
+            return key;
+        return `aqe/${this.agentId.type}/${key}`;
+    }
+    /**
+     * Create shared namespace key: aqe/shared/{agentType}/{key}
+     * Used for cross-agent shared storage
+     */
+    getSharedKey(agentType, key) {
+        return `aqe/shared/${agentType}/${key}`;
+    }
+    // === Basic Operations ===
+    async store(key, value, options) {
+        if (this.memoryStore instanceof SwarmMemoryManager_1.SwarmMemoryManager) {
+            await this.memoryStore.store(key, value, {
+                partition: options?.namespace || 'default',
+                ttl: options?.ttl,
+                metadata: options?.metadata,
+            });
+        }
+        else {
+            // Basic MemoryStore interface uses ttl as number
+            await this.memoryStore.store(key, value, options?.ttl);
+        }
+        this.stats.totalEntries++;
+    }
+    async retrieve(key) {
+        const result = await this.memoryStore.retrieve(key);
+        if (result !== undefined) {
+            this.stats.hitRate = (this.stats.hitRate * 0.9) + 0.1;
+        }
+        else {
+            this.stats.missRate = (this.stats.missRate * 0.9) + 0.1;
+        }
+        return result;
+    }
+    async delete(key) {
+        try {
+            await this.memoryStore.delete(key);
+            this.stats.totalEntries = Math.max(0, this.stats.totalEntries - 1);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async exists(key) {
+        const value = await this.retrieve(key);
+        return value !== undefined;
+    }
+    // === Shared Memory ===
+    /**
+     * Store in shared memory using aqe/shared/{agentType}/{key} namespace
+     * Makes data accessible to other agents of the specified type
+     */
+    async storeShared(agentType, key, value, options) {
+        const sharedKey = this.getSharedKey(agentType, key);
+        // Use raw store to avoid double-prefixing
+        if (this.memoryStore instanceof SwarmMemoryManager_1.SwarmMemoryManager) {
+            await this.memoryStore.store(sharedKey, value, {
+                partition: options?.namespace || 'shared',
+                ttl: options?.ttl,
+                metadata: options?.metadata,
+            });
+        }
+        else {
+            await this.memoryStore.store(sharedKey, value, options?.ttl);
+        }
+        this.stats.totalEntries++;
+    }
+    /**
+     * Retrieve from shared memory using aqe/shared/{agentType}/{key} namespace
+     * Shared memory uses partition: 'shared'
+     */
+    async retrieveShared(agentType, key) {
+        const sharedKey = this.getSharedKey(agentType, key);
+        // Use partition: 'shared' to match storeShared behavior
+        let result;
+        if (this.memoryStore instanceof SwarmMemoryManager_1.SwarmMemoryManager) {
+            result = await this.memoryStore.retrieve(sharedKey, { partition: 'shared' });
+        }
+        else {
+            result = await this.memoryStore.retrieve(sharedKey);
+        }
+        if (result !== undefined) {
+            this.stats.hitRate = (this.stats.hitRate * 0.9) + 0.1;
+        }
+        else {
+            this.stats.missRate = (this.stats.missRate * 0.9) + 0.1;
+        }
+        return result;
+    }
+    // === Agent-Local Memory (BaseAgent compatibility) ===
+    /**
+     * Store in agent-local memory using aqe/{agentType}/{key} namespace
+     * Maintains backward compatibility with BaseAgent.storeMemory()
+     */
+    async storeLocal(key, value, ttl) {
+        const localKey = this.getLocalKey(key);
+        if (this.memoryStore instanceof SwarmMemoryManager_1.SwarmMemoryManager) {
+            await this.memoryStore.store(localKey, value, {
+                partition: this.agentId?.type || 'default',
+                ttl,
+            });
+        }
+        else {
+            await this.memoryStore.store(localKey, value, ttl);
+        }
+        this.stats.totalEntries++;
+    }
+    /**
+     * Retrieve from agent-local memory using aqe/{agentType}/{key} namespace
+     * Maintains backward compatibility with BaseAgent.retrieveMemory()
+     */
+    async retrieveLocal(key) {
+        const localKey = this.getLocalKey(key);
+        const result = await this.memoryStore.retrieve(localKey);
+        if (result !== undefined) {
+            this.stats.hitRate = (this.stats.hitRate * 0.9) + 0.1;
+        }
+        else {
+            this.stats.missRate = (this.stats.missRate * 0.9) + 0.1;
+        }
+        return result;
+    }
+    /**
+     * Store in shared memory for this agent's type
+     * Convenience method matching BaseAgent.storeSharedMemory()
+     */
+    async storeSharedLocal(key, value, ttl) {
+        if (!this.agentId) {
+            throw new Error('Cannot use storeSharedLocal without agentId');
+        }
+        await this.storeShared(this.agentId.type, key, value, { ttl });
+    }
+    // === Bulk Operations ===
+    async bulkStore(entries) {
+        await Promise.all(entries.map(entry => this.store(entry.key, entry.value, entry.options)));
+    }
+    async bulkRetrieve(keys) {
+        const results = new Map();
+        await Promise.all(keys.map(async (key) => {
+            const value = await this.retrieve(key);
+            if (value !== undefined) {
+                results.set(key, value);
+            }
+        }));
+        return results;
+    }
+    async bulkDelete(keys) {
+        let deleted = 0;
+        await Promise.all(keys.map(async (key) => {
+            const success = await this.delete(key);
+            if (success)
+                deleted++;
+        }));
+        return deleted;
+    }
+    // === Query Operations ===
+    async query(options) {
+        // Basic implementation - full query support requires SwarmMemoryManager
+        if (this.memoryStore instanceof SwarmMemoryManager_1.SwarmMemoryManager) {
+            const keys = await this.listKeys(options.pattern);
+            const limitedKeys = keys.slice(0, options.limit || 100);
+            const entries = [];
+            for (const key of limitedKeys) {
+                const value = await this.retrieve(key);
+                if (value !== undefined) {
+                    entries.push({ key, value });
+                }
+            }
+            return entries;
+        }
+        return [];
+    }
+    async listKeys(_pattern) {
+        // This would require exposing a key listing method from the memory store
+        // For now, return empty array - implementations can override
+        // Full implementation requires adding a listKeys method to SwarmMemoryManager
+        return [];
+    }
+    // === Lifecycle ===
+    async initialize() {
+        this.initialized = true;
+        this.stats.lastCleanup = new Date();
+    }
+    async close() {
+        this.initialized = false;
+    }
+    async clear() {
+        // Would need to clear all keys - delegate to store if supported
+        if (this.memoryStore instanceof SwarmMemoryManager_1.SwarmMemoryManager) {
+            // SwarmMemoryManager doesn't have a clear method exposed
+            // This is a limitation of the current interface
+        }
+        this.stats = {
+            totalEntries: 0,
+            totalSize: 0,
+            hitRate: 0,
+            missRate: 0,
+            evictionCount: 0,
+            lastCleanup: new Date(),
+        };
+    }
+    // === Metrics ===
+    async getStats() {
+        return { ...this.stats };
+    }
+}
+exports.MemoryServiceAdapter = MemoryServiceAdapter;
+/**
+ * Create a memory strategy adapter from an existing service
+ *
+ * @param service - AgentMemoryService instance
+ * @param memoryStore - MemoryStore (typically SwarmMemoryManager)
+ * @param agentId - Optional agent ID for namespace prefixing
+ */
+function createMemoryAdapter(service, memoryStore, agentId) {
+    return new MemoryServiceAdapter(service, memoryStore, agentId);
+}
+//# sourceMappingURL=MemoryServiceAdapter.js.map

package/dist/agents/adapters/MemoryServiceAdapter.js.map

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

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

@@ -0,0 +1,14 @@
+/**
+ * Agent Adapters - Bridge existing services to strategy interfaces
+ *
+ * These adapters provide backward compatibility during the B1.2 migration
+ * from inline implementations to the strategy pattern.
+ *
+ * @module agents/adapters
+ * @version 1.0.0
+ */
+export { LifecycleManagerAdapter, createLifecycleAdapter, } from './LifecycleManagerAdapter';
+export { MemoryServiceAdapter, createMemoryAdapter, type AgentLocalMemoryStrategy, } from './MemoryServiceAdapter';
+export { LearningEngineAdapter, createLearningAdapter, } from './LearningEngineAdapter';
+export { CoordinatorAdapter, createCoordinationAdapter, } from './CoordinatorAdapter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC"}

package/dist/agents/adapters/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Agent Adapters - Bridge existing services to strategy interfaces
+ *
+ * These adapters provide backward compatibility during the B1.2 migration
+ * from inline implementations to the strategy pattern.
+ *
+ * @module agents/adapters
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCoordinationAdapter = exports.CoordinatorAdapter = exports.createLearningAdapter = exports.LearningEngineAdapter = exports.createMemoryAdapter = exports.MemoryServiceAdapter = exports.createLifecycleAdapter = exports.LifecycleManagerAdapter = void 0;
+var LifecycleManagerAdapter_1 = require("./LifecycleManagerAdapter");
+Object.defineProperty(exports, "LifecycleManagerAdapter", { enumerable: true, get: function () { return LifecycleManagerAdapter_1.LifecycleManagerAdapter; } });
+Object.defineProperty(exports, "createLifecycleAdapter", { enumerable: true, get: function () { return LifecycleManagerAdapter_1.createLifecycleAdapter; } });
+var MemoryServiceAdapter_1 = require("./MemoryServiceAdapter");
+Object.defineProperty(exports, "MemoryServiceAdapter", { enumerable: true, get: function () { return MemoryServiceAdapter_1.MemoryServiceAdapter; } });
+Object.defineProperty(exports, "createMemoryAdapter", { enumerable: true, get: function () { return MemoryServiceAdapter_1.createMemoryAdapter; } });
+var LearningEngineAdapter_1 = require("./LearningEngineAdapter");
+Object.defineProperty(exports, "LearningEngineAdapter", { enumerable: true, get: function () { return LearningEngineAdapter_1.LearningEngineAdapter; } });
+Object.defineProperty(exports, "createLearningAdapter", { enumerable: true, get: function () { return LearningEngineAdapter_1.createLearningAdapter; } });
+var CoordinatorAdapter_1 = require("./CoordinatorAdapter");
+Object.defineProperty(exports, "CoordinatorAdapter", { enumerable: true, get: function () { return CoordinatorAdapter_1.CoordinatorAdapter; } });
+Object.defineProperty(exports, "createCoordinationAdapter", { enumerable: true, get: function () { return CoordinatorAdapter_1.createCoordinationAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/agents/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,qEAGmC;AAFjC,kIAAA,uBAAuB,OAAA;AACvB,iIAAA,sBAAsB,OAAA;AAGxB,+DAIgC;AAH9B,4HAAA,oBAAoB,OAAA;AACpB,2HAAA,mBAAmB,OAAA;AAIrB,iEAGiC;AAF/B,8HAAA,qBAAqB,OAAA;AACrB,8HAAA,qBAAqB,OAAA;AAGvB,2DAG8B;AAF5B,wHAAA,kBAAkB,OAAA;AAClB,+HAAA,yBAAyB,OAAA"}

package/dist/agents/lifecycle/AgentLifecycleManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentLifecycleManager.d.ts","sourceRoot":"","sources":["../../../src/agents/lifecycle/AgentLifecycleManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,WAAW,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyB;IAC3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqC;IACtE,OAAO,CAAC,oBAAoB,CAAC,CAAgC;gBAEjD,OAAO,EAAE,OAAO;IAK5B;;OAEG;IACI,uBAAuB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAI7E;;;OAGG;IACU,UAAU,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB9D;;;OAGG;IACU,SAAS,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B7D;;OAEG;IACI,SAAS,IAAI,WAAW;IAI/B;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAI/C;;OAEG;IACI,cAAc,IAAI,OAAO;IAIhC;;OAEG;IACI,UAAU,IAAI,IAAI;IAKzB;;OAEG;IACI,QAAQ,IAAI,IAAI;IAKvB;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACI,oBAAoB,IAAI,eAAe,EAAE;IAIhD;;OAEG;IACI,sBAAsB,IAAI,MAAM;IAMvC;;;OAGG;IACI,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI;IAcnE;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAiBlE;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA4C1B;;OAEG;IACI,mBAAmB,IAAI;QAC5B,aAAa,EAAE,WAAW,CAAC;QAC3B,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;KAC3C;IAkBD;;OAEG;IACI,aAAa,IAAI,OAAO;IAI/B;;;;OAIG;IACI,KAAK,CAAC,YAAY,GAAE,OAAe,GAAG,IAAI;CAWlD"}
+{"version":3,"file":"AgentLifecycleManager.d.ts","sourceRoot":"","sources":["../../../src/agents/lifecycle/AgentLifecycleManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,WAAW,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyB;IAC3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqC;IACtE,OAAO,CAAC,oBAAoB,CAAC,CAAgC;gBAEjD,OAAO,EAAE,OAAO;IAK5B;;OAEG;IACI,uBAAuB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAI7E;;;OAGG;IACU,UAAU,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB9D;;;OAGG;IACU,SAAS,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B7D;;OAEG;IACI,SAAS,IAAI,WAAW;IAI/B;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAI/C;;OAEG;IACI,cAAc,IAAI,OAAO;IAIhC;;OAEG;IACI,UAAU,IAAI,IAAI;IAKzB;;OAEG;IACI,QAAQ,IAAI,IAAI;IAKvB;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACI,oBAAoB,IAAI,eAAe,EAAE;IAIhD;;OAEG;IACI,sBAAsB,IAAI,MAAM;IAMvC;;;OAGG;IACI,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI;IAcnE;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAiBlE;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAoD1B;;OAEG;IACI,mBAAmB,IAAI;QAC5B,aAAa,EAAE,WAAW,CAAC;QAC3B,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;KAC3C;IAkBD;;OAEG;IACI,aAAa,IAAI,OAAO;IAI/B;;;;OAIG;IACI,KAAK,CAAC,YAAY,GAAE,OAAe,GAAG,IAAI;CAWlD"}

package/dist/agents/lifecycle/AgentLifecycleManager.js

@@ -38,8 +38,9 @@ class AgentLifecycleManager {
             if (hooks?.onPreInitialization) {
                 await hooks.onPreInitialization();
             }
-            // Transition to ACTIVE
-            this.transitionTo(types_1.AgentStatus.ACTIVE, 'Initialization complete');
+            // Transition to IDLE (ready for tasks, not actively working)
+            // ACTIVE is used when agent is processing a task
+            this.transitionTo(types_1.AgentStatus.IDLE, 'Initialization complete');
             // Execute post-initialization hook
             if (hooks?.onPostInitialization) {
                 await hooks.onPostInitialization();
@@ -166,9 +167,11 @@ class AgentLifecycleManager {
      */
     buildTransitionMap() {
         const map = new Map();
-        // INITIALIZING can transition to ACTIVE, ERROR, or TERMINATING (for cleanup)
+        // INITIALIZING can transition to IDLE, ACTIVE, ERROR, or TERMINATING (for cleanup)
+        // After initialization, agent should be IDLE (ready for tasks)
         map.set(types_1.AgentStatus.INITIALIZING, new Set([
-            types_1.AgentStatus.ACTIVE,
+            types_1.AgentStatus.IDLE, // Normal completion: ready for tasks
+            types_1.AgentStatus.ACTIVE, // Legacy: some code may transition to ACTIVE
             types_1.AgentStatus.ERROR,
             types_1.AgentStatus.TERMINATING // Allow cleanup during initialization
         ]));
@@ -190,13 +193,19 @@ class AgentLifecycleManager {
             types_1.AgentStatus.TERMINATED,
             types_1.AgentStatus.ERROR
         ]));
-        // TERMINATED is a final state - but allow re-entry of TERMINATING for idempotent cleanup
+        // TERMINATED is typically a final state, but allow:
+        // - TERMINATING for idempotent cleanup
+        // - INITIALIZING for agent re-use after termination (via reset())
         map.set(types_1.AgentStatus.TERMINATED, new Set([
-            types_1.AgentStatus.TERMINATING // Allow idempotent terminate() calls
+            types_1.AgentStatus.TERMINATING, // Allow idempotent terminate() calls
+            types_1.AgentStatus.INITIALIZING // Allow re-initialization (reset)
         ]));
-        // ERROR can transition to TERMINATING (for cleanup)
+        // ERROR can transition to TERMINATING (for cleanup) or IDLE/ACTIVE (for recovery/retry)
+        // Recovery path allows agents to be reused after non-fatal task errors
         map.set(types_1.AgentStatus.ERROR, new Set([
-            types_1.AgentStatus.TERMINATING
+            types_1.AgentStatus.TERMINATING,
+            types_1.AgentStatus.IDLE, // Recovery: allow re-use after error
+            types_1.AgentStatus.ACTIVE // Direct recovery: allow immediate re-execution
         ]));
         return map;
     }