@dexto/agent-management 1.5.1 → 1.5.3

package/dist/config/discover-prompts.cjs

@@ -98,13 +98,23 @@ function scanCommandsDirectory(dir) {
   }
   return files;
 }
-const AGENT_INSTRUCTION_FILES = ["agent.md", "claude.md", "gemini.md"];
+const AGENT_INSTRUCTION_FILES = ["agents.md", "claude.md", "gemini.md"];
 function discoverAgentInstructionFile() {
   const cwd = process.cwd();
+  let dirEntries;
+  try {
+    dirEntries = (0, import_fs.readdirSync)(cwd);
+  } catch {
+    return null;
+  }
+  const lowercaseMap = /* @__PURE__ */ new Map();
+  for (const entry of dirEntries) {
+    lowercaseMap.set(entry.toLowerCase(), entry);
+  }
   for (const filename of AGENT_INSTRUCTION_FILES) {
-    const filePath = path.join(cwd, filename);
-    if ((0, import_fs.existsSync)(filePath)) {
-      return filePath;
+    const actualFilename = lowercaseMap.get(filename);
+    if (actualFilename) {
+      return path.join(cwd, actualFilename);
     }
   }
   return null;

package/dist/config/discover-prompts.d.ts

@@ -28,10 +28,10 @@ export declare function discoverCommandPrompts(): FilePromptEntry[];
 /**
  * Discovers agent instruction files from the current working directory.
  *
- * Looks for files in this order of priority:
- * 1. agent.md
- * 2. claude.md
- * 3. gemini.md
+ * Looks for files in this order of priority (case-insensitive):
+ * 1. AGENTS.md (or agents.md, Agents.md, etc.)
+ * 2. CLAUDE.md (or claude.md, Claude.md, etc.)
+ * 3. GEMINI.md (or gemini.md, Gemini.md, etc.)
  *
  * Only the first found file is returned (we don't want multiple instruction files).
  *

package/dist/config/discover-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discover-prompts.d.ts","sourceRoot":"","sources":["../../src/config/discover-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CA8D1D;AA4BD;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,GAAG,IAAI,CAW5D"}
+{"version":3,"file":"discover-prompts.d.ts","sourceRoot":"","sources":["../../src/config/discover-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CA8D1D;AAiCD;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,GAAG,IAAI,CA0B5D"}

package/dist/config/discover-prompts.js

@@ -68,13 +68,23 @@ function scanCommandsDirectory(dir) {
   }
   return files;
 }
-const AGENT_INSTRUCTION_FILES = ["agent.md", "claude.md", "gemini.md"];
+const AGENT_INSTRUCTION_FILES = ["agents.md", "claude.md", "gemini.md"];
 function discoverAgentInstructionFile() {
   const cwd = process.cwd();
+  let dirEntries;
+  try {
+    dirEntries = readdirSync(cwd);
+  } catch {
+    return null;
+  }
+  const lowercaseMap = /* @__PURE__ */ new Map();
+  for (const entry of dirEntries) {
+    lowercaseMap.set(entry.toLowerCase(), entry);
+  }
   for (const filename of AGENT_INSTRUCTION_FILES) {
-    const filePath = path.join(cwd, filename);
-    if (existsSync(filePath)) {
-      return filePath;
+    const actualFilename = lowercaseMap.get(filename);
+    if (actualFilename) {
+      return path.join(cwd, actualFilename);
     }
   }
   return null;

package/dist/index.cjs

@@ -15,6 +15,7 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var index_exports = {};
 __export(index_exports, {
@@ -135,6 +136,8 @@ var import_api_key_store = require("./utils/api-key-store.js");
 var import_api_key_resolver = require("./utils/api-key-resolver.js");
 var import_custom_models = require("./models/custom-models.js");
 var import_models = require("./models/index.js");
+__reExport(index_exports, require("./runtime/index.js"), module.exports);
+__reExport(index_exports, require("./tool-provider/index.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentFactory,
@@ -231,5 +234,7 @@ var import_models = require("./models/index.js");
   walkUpDirectories,
   writeConfigFile,
   writeLLMPreferences,
-  writePreferencesToAgent
+  writePreferencesToAgent,
+  ...require("./runtime/index.js"),
+  ...require("./tool-provider/index.js")
 });

package/dist/index.d.ts

@@ -20,4 +20,6 @@ export { saveProviderApiKey, getProviderKeyStatus, listProviderKeyStatus, determ
 export { resolveApiKeyForProvider, getPrimaryApiKeyEnvVar, PROVIDER_API_KEY_MAP, } from './utils/api-key-resolver.js';
 export { loadCustomModels, saveCustomModel, deleteCustomModel, getCustomModel, getCustomModelsPath, CustomModelSchema, CUSTOM_MODEL_PROVIDERS, type CustomModel, type CustomModelProvider, } from './models/custom-models.js';
 export { getModelsDirectory, getModelFilePath, getModelDirectory, getModelStatePath, getModelTempDirectory, ensureModelsDirectory, ensureModelDirectory, modelFileExists, getModelFileSize, deleteModelDirectory, listModelDirectories, getModelsDiskUsage, formatSize, type ModelSource, type InstalledModel, type ModelState, loadModelState, saveModelState, addInstalledModel, removeInstalledModel, getInstalledModel, getAllInstalledModels, isModelInstalled, updateModelLastUsed, setActiveModel, getActiveModelId, getActiveModel, addToDownloadQueue, removeFromDownloadQueue, getDownloadQueue, syncStateWithFilesystem, getTotalInstalledSize, getInstalledModelCount, registerManualModel, } from './models/index.js';
+export * from './runtime/index.js';
+export * from './tool-provider/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACrF,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EACH,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,GAChC,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG/E,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAG/E,OAAO,EACH,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,YAAY,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EACH,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,KAAK,cAAc,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG1E,OAAO,EACH,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,MAAM,EACN,eAAe,EACf,oBAAoB,EACpB,0BAA0B,GAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,gBAAgB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EACzB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,WAAW,EACX,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,GAC5B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,KAAK,qBAAqB,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,GACvB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACH,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,mBAAmB,GAC3B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAEH,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EAEV,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -110,6 +110,8 @@ import {
   getInstalledModelCount,
   registerManualModel
 } from "./models/index.js";
+export * from "./runtime/index.js";
+export * from "./tool-provider/index.js";
 export {
   AgentFactory,
   AgentManager,

package/dist/runtime/AgentPool.cjs

@@ -0,0 +1,181 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var AgentPool_exports = {};
+__export(AgentPool_exports, {
+  AgentPool: () => AgentPool
+});
+module.exports = __toCommonJS(AgentPool_exports);
+var import_schemas = require("./schemas.js");
+var import_errors = require("./errors.js");
+class AgentPool {
+  agents = /* @__PURE__ */ new Map();
+  config;
+  logger;
+  constructor(config, logger) {
+    this.config = {
+      maxAgents: config.maxAgents ?? import_schemas.DEFAULT_MAX_AGENTS,
+      defaultTaskTimeout: config.defaultTaskTimeout ?? import_schemas.DEFAULT_TASK_TIMEOUT
+    };
+    this.logger = logger;
+  }
+  /**
+   * Add an agent handle to the pool
+   * @throws RuntimeError if agent with same ID already exists or limit exceeded
+   */
+  add(handle) {
+    if (this.agents.has(handle.agentId)) {
+      throw import_errors.RuntimeError.agentAlreadyExists(handle.agentId);
+    }
+    if (this.agents.size >= this.config.maxAgents) {
+      throw import_errors.RuntimeError.maxAgentsExceeded(this.agents.size, this.config.maxAgents);
+    }
+    this.agents.set(handle.agentId, handle);
+    this.logger.debug(
+      `Added agent '${handle.agentId}' to pool${handle.group ? ` (group: ${handle.group})` : ""}`
+    );
+  }
+  /**
+   * Remove an agent from the pool
+   * @returns The removed handle, or undefined if not found
+   */
+  remove(agentId) {
+    const handle = this.agents.get(agentId);
+    if (handle) {
+      this.agents.delete(agentId);
+      this.logger.debug(`Removed agent '${agentId}' from pool`);
+    }
+    return handle;
+  }
+  /**
+   * Get an agent handle by ID
+   */
+  get(agentId) {
+    return this.agents.get(agentId);
+  }
+  /**
+   * Check if another agent can be spawned
+   */
+  canSpawn() {
+    return this.agents.size < this.config.maxAgents;
+  }
+  /**
+   * List agents matching the given filter
+   */
+  list(filter) {
+    if (!filter) {
+      return Array.from(this.agents.values());
+    }
+    const results = [];
+    for (const handle of this.agents.values()) {
+      if (this.matchesFilter(handle, filter)) {
+        results.push(handle);
+      }
+    }
+    return results;
+  }
+  /**
+   * Get all agents in a specific group
+   */
+  getByGroup(group) {
+    return this.list({ group });
+  }
+  /**
+   * Get the count of agents in a specific group
+   */
+  getGroupCount(group) {
+    return this.getByGroup(group).length;
+  }
+  /**
+   * Update the status of an agent
+   * @throws RuntimeError if agent not found
+   */
+  updateStatus(agentId, status, error) {
+    const handle = this.agents.get(agentId);
+    if (!handle) {
+      throw import_errors.RuntimeError.agentNotFound(agentId);
+    }
+    const previousStatus = handle.status;
+    handle.status = status;
+    if (status !== "error") {
+      delete handle.error;
+    } else if (error !== void 0) {
+      handle.error = error;
+    }
+    this.logger.debug(
+      `Agent '${agentId}' status changed: ${previousStatus} -> ${status}${error ? ` (error: ${error})` : ""}`
+    );
+  }
+  /**
+   * Check if an agent exists in the pool
+   */
+  has(agentId) {
+    return this.agents.has(agentId);
+  }
+  /**
+   * Get all agent handles in the pool
+   */
+  getAll() {
+    return Array.from(this.agents.values());
+  }
+  /**
+   * Get the total count of agents in the pool
+   */
+  get size() {
+    return this.agents.size;
+  }
+  /**
+   * Get the configuration
+   */
+  getConfig() {
+    return { ...this.config };
+  }
+  /**
+   * Clear all agents from the pool
+   * Note: This does NOT stop the agents - use AgentRuntime.stopAll instead
+   */
+  clear() {
+    const count = this.agents.size;
+    this.agents.clear();
+    if (count > 0) {
+      this.logger.debug(`Cleared ${count} agents from pool`);
+    }
+  }
+  /**
+   * Check if an agent handle matches a filter
+   */
+  matchesFilter(handle, filter) {
+    if (filter.group !== void 0 && handle.group !== filter.group) {
+      return false;
+    }
+    if (filter.status !== void 0) {
+      const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+      if (!statuses.includes(handle.status)) {
+        return false;
+      }
+    }
+    if (filter.ephemeral !== void 0 && handle.ephemeral !== filter.ephemeral) {
+      return false;
+    }
+    return true;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentPool
+});

package/dist/runtime/AgentPool.d.ts

@@ -0,0 +1,76 @@
+/**
+ * AgentPool - Manages a pool of agent instances
+ *
+ * Tracks active agents, enforces resource limits, and provides
+ * lookup and lifecycle management capabilities.
+ */
+import type { IDextoLogger } from '@dexto/core';
+import type { AgentHandle, AgentStatus, AgentFilter } from './types.js';
+import { type ValidatedAgentRuntimeConfig } from './schemas.js';
+export declare class AgentPool {
+    private agents;
+    private config;
+    private logger;
+    constructor(config: Partial<ValidatedAgentRuntimeConfig>, logger: IDextoLogger);
+    /**
+     * Add an agent handle to the pool
+     * @throws RuntimeError if agent with same ID already exists or limit exceeded
+     */
+    add(handle: AgentHandle): void;
+    /**
+     * Remove an agent from the pool
+     * @returns The removed handle, or undefined if not found
+     */
+    remove(agentId: string): AgentHandle | undefined;
+    /**
+     * Get an agent handle by ID
+     */
+    get(agentId: string): AgentHandle | undefined;
+    /**
+     * Check if another agent can be spawned
+     */
+    canSpawn(): boolean;
+    /**
+     * List agents matching the given filter
+     */
+    list(filter?: AgentFilter): AgentHandle[];
+    /**
+     * Get all agents in a specific group
+     */
+    getByGroup(group: string): AgentHandle[];
+    /**
+     * Get the count of agents in a specific group
+     */
+    getGroupCount(group: string): number;
+    /**
+     * Update the status of an agent
+     * @throws RuntimeError if agent not found
+     */
+    updateStatus(agentId: string, status: AgentStatus, error?: string): void;
+    /**
+     * Check if an agent exists in the pool
+     */
+    has(agentId: string): boolean;
+    /**
+     * Get all agent handles in the pool
+     */
+    getAll(): AgentHandle[];
+    /**
+     * Get the total count of agents in the pool
+     */
+    get size(): number;
+    /**
+     * Get the configuration
+     */
+    getConfig(): ValidatedAgentRuntimeConfig;
+    /**
+     * Clear all agents from the pool
+     * Note: This does NOT stop the agents - use AgentRuntime.stopAll instead
+     */
+    clear(): void;
+    /**
+     * Check if an agent handle matches a filter
+     */
+    private matchesFilter;
+}
+//# sourceMappingURL=AgentPool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPool.d.ts","sourceRoot":"","sources":["../../src/runtime/AgentPool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAGH,KAAK,2BAA2B,EACnC,MAAM,cAAc,CAAC;AAGtB,qBAAa,SAAS;IAClB,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,OAAO,CAAC,2BAA2B,CAAC,EAAE,MAAM,EAAE,YAAY;IAQ9E;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAe9B;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAShD;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI7C;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE;IAczC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE;IAIxC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIpC;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBxE;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI7B;;OAEG;IACH,MAAM,IAAI,WAAW,EAAE;IAIvB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,SAAS,IAAI,2BAA2B;IAIxC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,OAAO,CAAC,aAAa;CAqBxB"}

package/dist/runtime/AgentPool.js

@@ -0,0 +1,160 @@
+import {
+  DEFAULT_MAX_AGENTS,
+  DEFAULT_TASK_TIMEOUT
+} from "./schemas.js";
+import { RuntimeError } from "./errors.js";
+class AgentPool {
+  agents = /* @__PURE__ */ new Map();
+  config;
+  logger;
+  constructor(config, logger) {
+    this.config = {
+      maxAgents: config.maxAgents ?? DEFAULT_MAX_AGENTS,
+      defaultTaskTimeout: config.defaultTaskTimeout ?? DEFAULT_TASK_TIMEOUT
+    };
+    this.logger = logger;
+  }
+  /**
+   * Add an agent handle to the pool
+   * @throws RuntimeError if agent with same ID already exists or limit exceeded
+   */
+  add(handle) {
+    if (this.agents.has(handle.agentId)) {
+      throw RuntimeError.agentAlreadyExists(handle.agentId);
+    }
+    if (this.agents.size >= this.config.maxAgents) {
+      throw RuntimeError.maxAgentsExceeded(this.agents.size, this.config.maxAgents);
+    }
+    this.agents.set(handle.agentId, handle);
+    this.logger.debug(
+      `Added agent '${handle.agentId}' to pool${handle.group ? ` (group: ${handle.group})` : ""}`
+    );
+  }
+  /**
+   * Remove an agent from the pool
+   * @returns The removed handle, or undefined if not found
+   */
+  remove(agentId) {
+    const handle = this.agents.get(agentId);
+    if (handle) {
+      this.agents.delete(agentId);
+      this.logger.debug(`Removed agent '${agentId}' from pool`);
+    }
+    return handle;
+  }
+  /**
+   * Get an agent handle by ID
+   */
+  get(agentId) {
+    return this.agents.get(agentId);
+  }
+  /**
+   * Check if another agent can be spawned
+   */
+  canSpawn() {
+    return this.agents.size < this.config.maxAgents;
+  }
+  /**
+   * List agents matching the given filter
+   */
+  list(filter) {
+    if (!filter) {
+      return Array.from(this.agents.values());
+    }
+    const results = [];
+    for (const handle of this.agents.values()) {
+      if (this.matchesFilter(handle, filter)) {
+        results.push(handle);
+      }
+    }
+    return results;
+  }
+  /**
+   * Get all agents in a specific group
+   */
+  getByGroup(group) {
+    return this.list({ group });
+  }
+  /**
+   * Get the count of agents in a specific group
+   */
+  getGroupCount(group) {
+    return this.getByGroup(group).length;
+  }
+  /**
+   * Update the status of an agent
+   * @throws RuntimeError if agent not found
+   */
+  updateStatus(agentId, status, error) {
+    const handle = this.agents.get(agentId);
+    if (!handle) {
+      throw RuntimeError.agentNotFound(agentId);
+    }
+    const previousStatus = handle.status;
+    handle.status = status;
+    if (status !== "error") {
+      delete handle.error;
+    } else if (error !== void 0) {
+      handle.error = error;
+    }
+    this.logger.debug(
+      `Agent '${agentId}' status changed: ${previousStatus} -> ${status}${error ? ` (error: ${error})` : ""}`
+    );
+  }
+  /**
+   * Check if an agent exists in the pool
+   */
+  has(agentId) {
+    return this.agents.has(agentId);
+  }
+  /**
+   * Get all agent handles in the pool
+   */
+  getAll() {
+    return Array.from(this.agents.values());
+  }
+  /**
+   * Get the total count of agents in the pool
+   */
+  get size() {
+    return this.agents.size;
+  }
+  /**
+   * Get the configuration
+   */
+  getConfig() {
+    return { ...this.config };
+  }
+  /**
+   * Clear all agents from the pool
+   * Note: This does NOT stop the agents - use AgentRuntime.stopAll instead
+   */
+  clear() {
+    const count = this.agents.size;
+    this.agents.clear();
+    if (count > 0) {
+      this.logger.debug(`Cleared ${count} agents from pool`);
+    }
+  }
+  /**
+   * Check if an agent handle matches a filter
+   */
+  matchesFilter(handle, filter) {
+    if (filter.group !== void 0 && handle.group !== filter.group) {
+      return false;
+    }
+    if (filter.status !== void 0) {
+      const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+      if (!statuses.includes(handle.status)) {
+        return false;
+      }
+    }
+    if (filter.ephemeral !== void 0 && handle.ephemeral !== filter.ephemeral) {
+      return false;
+    }
+    return true;
+  }
+}
+export {
+  AgentPool
+};