macro-agent 0.0.11 → 0.0.12

package/dist/agent-detection/detector.d.ts

@@ -0,0 +1,84 @@
+/**
+ * CLI Agent Detector
+ *
+ * Detects installed CLI coding agents by checking PATH availability
+ * and querying version information. Results are cached with configurable TTL.
+ */
+import type { CLIAgentDefinition, DetectedAgent, DetectionResult, AgentDetectionConfig } from "./types.js";
+import { AgentRegistry } from "./registry.js";
+/**
+ * Detects installed CLI coding agents on the system.
+ *
+ * Runs binary lookups and version checks in parallel, caches results,
+ * and provides query methods for available agents.
+ */
+export declare class AgentDetector {
+    private readonly registry;
+    private readonly cacheTtlMs;
+    private readonly whichTimeoutMs;
+    private readonly versionTimeoutMs;
+    private readonly disabledAgents;
+    private cachedResult;
+    private detectionInProgress;
+    constructor(config?: AgentDetectionConfig);
+    /**
+     * Get the underlying agent registry.
+     */
+    getRegistry(): AgentRegistry;
+    /**
+     * Detect all installed agents.
+     *
+     * Returns cached results if available and not expired.
+     * If a detection is already in progress, returns its promise.
+     */
+    detect(options?: {
+        refresh?: boolean;
+    }): Promise<DetectionResult>;
+    /**
+     * Get available agents (installed only by default).
+     */
+    getAvailableAgents(options?: {
+        refresh?: boolean;
+        includeNotInstalled?: boolean;
+    }): Promise<DetectionResult>;
+    /**
+     * Get a specific detected agent by ID.
+     */
+    getAgent(id: string): Promise<DetectedAgent | undefined>;
+    /**
+     * Check if a specific agent is installed.
+     */
+    isInstalled(id: string): Promise<boolean>;
+    /**
+     * Get the definition for an agent, throwing if not found.
+     */
+    getDefinition(id: string): CLIAgentDefinition;
+    /**
+     * Invalidate the detection cache.
+     */
+    invalidateCache(): void;
+    /**
+     * Get partial results if detection is in progress, or cached results.
+     * Returns null if no results are available yet.
+     */
+    getCachedResult(): DetectionResult | null;
+    /**
+     * Whether a detection scan is currently running.
+     */
+    isDetecting(): boolean;
+    private isCacheExpired;
+    private runDetection;
+    private detectAgent;
+    private findBinary;
+    private getVersion;
+}
+/**
+ * Parse a version string from command output.
+ * Extracts the first semver-like pattern (e.g., "1.2.3").
+ */
+export declare function parseVersion(output: string): string | null;
+/**
+ * Create a new AgentDetector with the given configuration.
+ */
+export declare function createAgentDetector(config?: AgentDetectionConfig): AgentDetector;
+//# sourceMappingURL=detector.d.ts.map

package/dist/agent-detection/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/agent-detection/detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAuB,MAAM,eAAe,CAAC;AAmBnE;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAc;IAE7C,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,mBAAmB,CAAyC;gBAExD,MAAM,CAAC,EAAE,oBAAoB;IAUzC;;OAEG;IACH,WAAW,IAAI,aAAa;IAI5B;;;;;OAKG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAuBvE;;OAEG;IACG,kBAAkB,CAAC,OAAO,CAAC,EAAE;QACjC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,GAAG,OAAO,CAAC,eAAe,CAAC;IAa5B;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAK9D;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/C;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB;IAY7C;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;;OAGG;IACH,eAAe,IAAI,eAAe,GAAG,IAAI;IAIzC;;OAEG;IACH,WAAW,IAAI,OAAO;IAQtB,OAAO,CAAC,cAAc;YAMR,YAAY;YA+BZ,WAAW;YAgCX,UAAU;YAwBV,UAAU;CAiBzB;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,CAAC,EAAE,oBAAoB,GAC5B,aAAa,CAEf"}

package/dist/agent-detection/detector.js

@@ -0,0 +1,240 @@
+/**
+ * CLI Agent Detector
+ *
+ * Detects installed CLI coding agents by checking PATH availability
+ * and querying version information. Results are cached with configurable TTL.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { AgentDetectionError } from "./types.js";
+import { createAgentRegistry } from "./registry.js";
+const execFileAsync = promisify(execFile);
+// =============================================================================
+// Constants
+// =============================================================================
+const DEFAULT_CACHE_TTL_MS = 60_000;
+const DEFAULT_WHICH_TIMEOUT_MS = 5_000;
+const DEFAULT_VERSION_TIMEOUT_MS = 10_000;
+/** Regex to parse version strings like "1.2.3", "0.82.1-beta", etc. */
+const VERSION_REGEX = /\d+\.\d+[\.\d]*/;
+// =============================================================================
+// Agent Detector
+// =============================================================================
+/**
+ * Detects installed CLI coding agents on the system.
+ *
+ * Runs binary lookups and version checks in parallel, caches results,
+ * and provides query methods for available agents.
+ */
+export class AgentDetector {
+    registry;
+    cacheTtlMs;
+    whichTimeoutMs;
+    versionTimeoutMs;
+    disabledAgents;
+    cachedResult = null;
+    detectionInProgress = null;
+    constructor(config) {
+        this.cacheTtlMs = config?.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+        this.whichTimeoutMs = config?.whichTimeoutMs ?? DEFAULT_WHICH_TIMEOUT_MS;
+        this.versionTimeoutMs =
+            config?.versionTimeoutMs ?? DEFAULT_VERSION_TIMEOUT_MS;
+        this.disabledAgents = new Set(config?.disabledAgents ?? []);
+        this.registry = createAgentRegistry(config?.additionalAgents);
+    }
+    /**
+     * Get the underlying agent registry.
+     */
+    getRegistry() {
+        return this.registry;
+    }
+    /**
+     * Detect all installed agents.
+     *
+     * Returns cached results if available and not expired.
+     * If a detection is already in progress, returns its promise.
+     */
+    async detect(options) {
+        // Return cached result if valid
+        if (!options?.refresh && this.cachedResult && !this.isCacheExpired()) {
+            return this.cachedResult;
+        }
+        // If detection is already running, return the in-progress promise
+        if (this.detectionInProgress) {
+            return this.detectionInProgress;
+        }
+        // Start a new detection scan
+        this.detectionInProgress = this.runDetection();
+        try {
+            const result = await this.detectionInProgress;
+            this.cachedResult = result;
+            return result;
+        }
+        finally {
+            this.detectionInProgress = null;
+        }
+    }
+    /**
+     * Get available agents (installed only by default).
+     */
+    async getAvailableAgents(options) {
+        const result = await this.detect({ refresh: options?.refresh });
+        if (options?.includeNotInstalled) {
+            return result;
+        }
+        return {
+            ...result,
+            agents: result.agents.filter((a) => a.installed),
+        };
+    }
+    /**
+     * Get a specific detected agent by ID.
+     */
+    async getAgent(id) {
+        const result = await this.detect();
+        return result.agents.find((a) => a.id === id);
+    }
+    /**
+     * Check if a specific agent is installed.
+     */
+    async isInstalled(id) {
+        const agent = await this.getAgent(id);
+        return agent?.installed ?? false;
+    }
+    /**
+     * Get the definition for an agent, throwing if not found.
+     */
+    getDefinition(id) {
+        const def = this.registry.get(id);
+        if (!def) {
+            throw new AgentDetectionError(`Unknown agent backend: ${id}`, "UNKNOWN_AGENT", id);
+        }
+        return def;
+    }
+    /**
+     * Invalidate the detection cache.
+     */
+    invalidateCache() {
+        this.cachedResult = null;
+    }
+    /**
+     * Get partial results if detection is in progress, or cached results.
+     * Returns null if no results are available yet.
+     */
+    getCachedResult() {
+        return this.cachedResult;
+    }
+    /**
+     * Whether a detection scan is currently running.
+     */
+    isDetecting() {
+        return this.detectionInProgress !== null;
+    }
+    // ===========================================================================
+    // Private
+    // ===========================================================================
+    isCacheExpired() {
+        if (!this.cachedResult)
+            return true;
+        const maxAge = Math.max(...this.cachedResult.agents.map((a) => a.detectedAt));
+        return Date.now() - maxAge > this.cacheTtlMs;
+    }
+    async runDetection() {
+        const definitions = this.registry.listEnabled(Array.from(this.disabledAgents));
+        const startTime = Date.now();
+        const results = await Promise.allSettled(definitions.map((def) => this.detectAgent(def)));
+        const agents = results.map((result, i) => {
+            if (result.status === "fulfilled") {
+                return result.value;
+            }
+            // On failure, return a not-installed entry
+            return {
+                id: definitions[i].id,
+                name: definitions[i].name,
+                installed: false,
+                definition: definitions[i],
+                detectedAt: Date.now(),
+            };
+        });
+        return {
+            agents,
+            scanned: definitions.length,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    async detectAgent(definition) {
+        const detectedAt = Date.now();
+        // Step 1: Check if binary exists on PATH
+        const binaryPath = await this.findBinary(definition.binary);
+        if (!binaryPath) {
+            return {
+                id: definition.id,
+                name: definition.name,
+                installed: false,
+                definition,
+                detectedAt,
+            };
+        }
+        // Step 2: Get version string
+        const version = await this.getVersion(definition);
+        return {
+            id: definition.id,
+            name: definition.name,
+            installed: true,
+            version: version ?? undefined,
+            path: binaryPath,
+            definition,
+            detectedAt,
+        };
+    }
+    async findBinary(binary) {
+        try {
+            const { stdout } = await execFileAsync("which", [binary], {
+                timeout: this.whichTimeoutMs,
+            });
+            const path = stdout.trim();
+            return path || null;
+        }
+        catch {
+            // Binary not found or which failed
+            try {
+                // Fallback to command -v
+                const { stdout } = await execFileAsync("/bin/sh", ["-c", `command -v ${binary}`], { timeout: this.whichTimeoutMs });
+                const path = stdout.trim();
+                return path || null;
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    async getVersion(definition) {
+        try {
+            const { stdout, stderr } = await execFileAsync(definition.binary, definition.versionArgs, { timeout: this.versionTimeoutMs });
+            // Some tools output version to stderr
+            const output = stdout || stderr;
+            return parseVersion(output);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Parse a version string from command output.
+ * Extracts the first semver-like pattern (e.g., "1.2.3").
+ */
+export function parseVersion(output) {
+    const match = output.match(VERSION_REGEX);
+    return match ? match[0] : null;
+}
+/**
+ * Create a new AgentDetector with the given configuration.
+ */
+export function createAgentDetector(config) {
+    return new AgentDetector(config);
+}
+//# sourceMappingURL=detector.js.map

package/dist/agent-detection/detector.js.map

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

package/dist/agent-detection/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CLI Agent Auto-Detection Module
+ *
+ * Detects installed CLI coding agents, exposes them via a registry,
+ * and provides command construction for headless invocation.
+ */
+export type { CLIAgentDefinition, HeadlessConfig, DetectedAgent, DetectionResult, SpawnCommand, SpawnCommandOptions, AgentDetectionConfig, AgentDetectionErrorCode, } from "./types.js";
+export { AgentDetectionError } from "./types.js";
+export { AgentRegistry, createAgentRegistry, BUILTIN_AGENTS, } from "./registry.js";
+export { AgentDetector, createAgentDetector, parseVersion, } from "./detector.js";
+export { buildSpawnCommand, formatSpawnCommand } from "./command-builder.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agent-detection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-detection/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,YAAY,GACb,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/agent-detection/index.js

@@ -0,0 +1,14 @@
+/**
+ * CLI Agent Auto-Detection Module
+ *
+ * Detects installed CLI coding agents, exposes them via a registry,
+ * and provides command construction for headless invocation.
+ */
+export { AgentDetectionError } from "./types.js";
+// Registry
+export { AgentRegistry, createAgentRegistry, BUILTIN_AGENTS, } from "./registry.js";
+// Detector
+export { AgentDetector, createAgentDetector, parseVersion, } from "./detector.js";
+// Command builder
+export { buildSpawnCommand, formatSpawnCommand } from "./command-builder.js";
+//# sourceMappingURL=index.js.map

package/dist/agent-detection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-detection/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,WAAW;AACX,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,WAAW;AACX,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,kBAAkB;AAClB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * CLI Agent Definitions Registry
+ *
+ * Maintains a registry of known CLI coding agents with their
+ * detection and headless invocation configurations.
+ */
+import type { CLIAgentDefinition } from "./types.js";
+/**
+ * All built-in agent definitions.
+ */
+export declare const BUILTIN_AGENTS: readonly CLIAgentDefinition[];
+/**
+ * Registry of known CLI coding agent definitions.
+ *
+ * Provides lookup by ID and supports adding custom agent definitions.
+ */
+export declare class AgentRegistry {
+    private readonly agents;
+    constructor(definitions?: CLIAgentDefinition[]);
+    /**
+     * Get an agent definition by ID.
+     */
+    get(id: string): CLIAgentDefinition | undefined;
+    /**
+     * Check if an agent definition exists.
+     */
+    has(id: string): boolean;
+    /**
+     * Register a new agent definition (or override an existing one).
+     */
+    register(definition: CLIAgentDefinition): void;
+    /**
+     * Remove an agent definition by ID.
+     */
+    remove(id: string): boolean;
+    /**
+     * List all registered agent definitions.
+     */
+    list(): CLIAgentDefinition[];
+    /**
+     * List agent definitions, optionally excluding disabled agents.
+     */
+    listEnabled(disabledIds?: string[]): CLIAgentDefinition[];
+    /**
+     * Get the number of registered agent definitions.
+     */
+    get size(): number;
+}
+/**
+ * Create a new AgentRegistry with built-in agents and optional custom definitions.
+ */
+export declare function createAgentRegistry(additionalAgents?: CLIAgentDefinition[]): AgentRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/agent-detection/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA6FrD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,kBAAkB,EAOvD,CAAC;AAMF;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;gBAEzD,WAAW,CAAC,EAAE,kBAAkB,EAAE;IAc9C;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI/C;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAI9C;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B;;OAEG;IACH,IAAI,IAAI,kBAAkB,EAAE;IAI5B;;OAEG;IACH,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,kBAAkB,EAAE;IAQzD;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,GACtC,aAAa,CAEf"}

package/dist/agent-detection/registry.js

@@ -0,0 +1,177 @@
+/**
+ * CLI Agent Definitions Registry
+ *
+ * Maintains a registry of known CLI coding agents with their
+ * detection and headless invocation configurations.
+ */
+// =============================================================================
+// Built-in Agent Definitions
+// =============================================================================
+const CLAUDE_CODE = {
+    id: "claude-code",
+    name: "Claude Code",
+    description: "Anthropic's CLI coding agent",
+    binary: "claude",
+    versionArgs: ["--version"],
+    headless: {
+        promptFlag: "-p",
+        defaultFlags: ["--output-format", "stream-json"],
+    },
+    modelFlag: "--model",
+    cwdFlag: "--cwd",
+    vendor: "Anthropic",
+};
+const CODEX = {
+    id: "codex",
+    name: "Codex",
+    description: "OpenAI's CLI coding agent",
+    binary: "codex",
+    versionArgs: ["--version"],
+    headless: {
+        subcommand: "exec",
+        promptFlag: "",
+        defaultFlags: ["--full-auto"],
+    },
+    modelFlag: "--model",
+    cwdFlag: "--path",
+    vendor: "OpenAI",
+};
+const GEMINI_CLI = {
+    id: "gemini-cli",
+    name: "Gemini CLI",
+    description: "Google's CLI coding agent",
+    binary: "gemini",
+    versionArgs: ["--version"],
+    headless: {
+        promptFlag: "-p",
+    },
+    modelFlag: "--model",
+    vendor: "Google",
+};
+const OPENCODE = {
+    id: "opencode",
+    name: "OpenCode",
+    description: "Anomaly's CLI coding agent",
+    binary: "opencode",
+    versionArgs: ["--version"],
+    headless: {
+        subcommand: "run",
+        promptFlag: "",
+    },
+    modelFlag: "--model",
+    vendor: "Anomaly",
+};
+const AIDER = {
+    id: "aider",
+    name: "Aider",
+    description: "AI pair programming in your terminal",
+    binary: "aider",
+    versionArgs: ["--version"],
+    headless: {
+        promptFlag: "--message",
+        defaultFlags: ["--yes"],
+    },
+    modelFlag: "--model",
+    vendor: "Aider",
+};
+const GOOSE = {
+    id: "goose",
+    name: "Goose",
+    description: "Block's CLI coding agent",
+    binary: "goose",
+    versionArgs: ["--version"],
+    headless: {
+        subcommand: "run",
+        promptFlag: "-t",
+        defaultFlags: ["--no-session"],
+    },
+    modelFlag: "--model",
+    vendor: "Block",
+};
+/**
+ * All built-in agent definitions.
+ */
+export const BUILTIN_AGENTS = [
+    CLAUDE_CODE,
+    CODEX,
+    GEMINI_CLI,
+    OPENCODE,
+    AIDER,
+    GOOSE,
+];
+// =============================================================================
+// Agent Registry
+// =============================================================================
+/**
+ * Registry of known CLI coding agent definitions.
+ *
+ * Provides lookup by ID and supports adding custom agent definitions.
+ */
+export class AgentRegistry {
+    agents = new Map();
+    constructor(definitions) {
+        // Register built-in agents
+        for (const def of BUILTIN_AGENTS) {
+            this.agents.set(def.id, def);
+        }
+        // Register additional definitions
+        if (definitions) {
+            for (const def of definitions) {
+                this.agents.set(def.id, def);
+            }
+        }
+    }
+    /**
+     * Get an agent definition by ID.
+     */
+    get(id) {
+        return this.agents.get(id);
+    }
+    /**
+     * Check if an agent definition exists.
+     */
+    has(id) {
+        return this.agents.has(id);
+    }
+    /**
+     * Register a new agent definition (or override an existing one).
+     */
+    register(definition) {
+        this.agents.set(definition.id, definition);
+    }
+    /**
+     * Remove an agent definition by ID.
+     */
+    remove(id) {
+        return this.agents.delete(id);
+    }
+    /**
+     * List all registered agent definitions.
+     */
+    list() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * List agent definitions, optionally excluding disabled agents.
+     */
+    listEnabled(disabledIds) {
+        if (!disabledIds || disabledIds.length === 0) {
+            return this.list();
+        }
+        const disabled = new Set(disabledIds);
+        return this.list().filter((def) => !disabled.has(def.id));
+    }
+    /**
+     * Get the number of registered agent definitions.
+     */
+    get size() {
+        return this.agents.size;
+    }
+}
+/**
+ * Create a new AgentRegistry with built-in agents and optional custom definitions.
+ */
+export function createAgentRegistry(additionalAgents) {
+    return new AgentRegistry(additionalAgents);
+}
+//# sourceMappingURL=registry.js.map

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

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