@adhd/agent-mcp 2.0.1 → 2.1.1

package/src/engine/policy.js

@@ -1,112 +0,0 @@
-import { ToolError } from "../validation/errors.js";
-// ── internal helpers ──────────────────────────────────────────────────────────
-/**
- * Extract the first numeric value for `key` from rate-type template rules.
- * Returns undefined when no rate template carries the key.
- */
-function readRateLimit(templates, key) {
-    if (!templates)
-        return undefined;
-    for (const t of templates) {
-        if (t.type !== "rate")
-            continue;
-        const val = t.rules[key];
-        if (typeof val === "number" && Number.isFinite(val))
-            return val;
-    }
-    return undefined;
-}
-/**
- * Extract the allowedAgents allowlist from permission-type template rules.
- *
- * A permission template is applied only when `mode === "allowlist"`. When found,
- * returns the `allowlist` array (possibly empty = block all). Returns undefined
- * when no permission template with mode=allowlist is present.
- */
-function readPermissionAllowlist(templates) {
-    if (!templates)
-        return undefined;
-    for (const t of templates) {
-        if (t.type !== "permission")
-            continue;
-        if (t.rules["mode"] !== "allowlist")
-            continue;
-        const list = t.rules["allowlist"];
-        if (Array.isArray(list))
-            return list;
-    }
-    return undefined;
-}
-/**
- * PolicyEngine enforces the three SPEC §9 safety invariants:
- *
- *  1. Recursion depth limit
- *  2. Tool call loop limit
- *  3. AllowedAgents list (per-agent override takes full precedence over server default)
- *
- * Limits are resolved in priority order:
- *   1. Per-agent agentDefinition fields (highest — always wins)
- *   2. @adhd/agent-policy template rules (when policyTemplateRules is supplied)
- *   3. PolicyConfig server defaults (hardcoded fallback)
- *
- * Throws ToolError on any violation. Does not mutate state.
- */
-export class PolicyEngine {
-    config;
-    constructor(config) {
-        this.config = config;
-    }
-    check(input) {
-        const { executionContext, targetTool, targetAgentName } = input;
-        const callingAgent = executionContext.agentDefinition;
-        const templates = this.config.policyTemplateRules;
-        // ── Check 1: Recursion depth ──────────────────────────────────────
-        //
-        // Priority: agentDefinition.maxToolLoops → rate template max_recursion_depth
-        //           → serverMaxDepth (default)
-        const templateMaxDepth = readRateLimit(templates, "max_recursion_depth");
-        const serverMaxDepth = templateMaxDepth !== undefined
-            ? Math.min(templateMaxDepth, this.config.serverMaxDepth)
-            : this.config.serverMaxDepth;
-        const effectiveMaxDepth = Math.min(callingAgent.maxToolLoops ?? serverMaxDepth, serverMaxDepth);
-        if (executionContext.recursionDepth >= effectiveMaxDepth) {
-            throw new ToolError("MAX_DEPTH_EXCEEDED", `Recursion depth ${executionContext.recursionDepth} has reached or exceeded the maximum of ${effectiveMaxDepth}`);
-        }
-        // ── Check 2: Tool call loop limit ─────────────────────────────────
-        //
-        // Priority: agentDefinition.maxToolLoops → rate template max_tool_loops
-        //           → serverMaxToolLoops (default)
-        const templateMaxToolLoops = readRateLimit(templates, "max_tool_loops");
-        const serverMaxToolLoops = templateMaxToolLoops !== undefined
-            ? Math.min(templateMaxToolLoops, this.config.serverMaxToolLoops)
-            : this.config.serverMaxToolLoops;
-        const effectiveMaxToolLoops = Math.min(callingAgent.maxToolLoops ?? serverMaxToolLoops, serverMaxToolLoops);
-        if (executionContext.toolCallCount >= effectiveMaxToolLoops) {
-            throw new ToolError("MAX_TOOL_LOOPS_EXCEEDED", `Tool call count ${executionContext.toolCallCount} has reached or exceeded the maximum of ${effectiveMaxToolLoops}`);
-        }
-        // ── Check 3: AllowedAgents (only for agent delegation) ────────────
-        if (targetTool === "agent-mcp__agent" && targetAgentName !== undefined) {
-            // Per-agent allowedAgents takes FULL precedence over everything.
-            const agentAllowedAgents = callingAgent.permissions.allowedAgents;
-            let effectiveAllowedAgents;
-            if (agentAllowedAgents !== undefined) {
-                // Agent-level always wins — ignore templates and server default.
-                effectiveAllowedAgents = agentAllowedAgents;
-            }
-            else {
-                // Check permission template allowlist first, then server default.
-                const templateAllowlist = readPermissionAllowlist(templates);
-                effectiveAllowedAgents = templateAllowlist !== undefined
-                    ? templateAllowlist
-                    : this.config.serverAllowedAgents;
-            }
-            // If effectiveAllowedAgents is undefined → unrestricted
-            if (effectiveAllowedAgents !== undefined) {
-                if (!effectiveAllowedAgents.includes(targetAgentName)) {
-                    throw new ToolError("DELEGATION_NOT_ALLOWED", `Agent '${executionContext.agentName}' is not allowed to delegate to '${targetAgentName}'`);
-                }
-            }
-        }
-    }
-}
-//# sourceMappingURL=policy.js.map

package/src/engine/policy.js.map

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

package/src/engine/prompt-resolver.d.ts

@@ -1,89 +0,0 @@
-/**
- * prompt-resolver — resolves a compiled system-prompt for a session start.
- *
- * Flow:
- *  1. Compute context_hash from (agentSlug, platform, context).
- *  2. Look up agent-mcp's own composed_prompts cache via ComposedPromptStore.
- *  3. HIT  → return {content, id} WITHOUT calling compileAgent.
- *  4. MISS → call compileAgent(…), upsert the row, return {content, id}.
- *
- * compileAgent is injected as a parameter (compileAgentFn) so tests can stub it
- * without modifying production code.  Production callers pass the real
- * `compileAgent` from @adhd/agent-compiler.
- *
- * [compiler-integration.1] — imports compileAgent from @adhd/agent-compiler
- * [compiler-integration.2] — caches/looks up the composed prompt and writes composed_prompt_id
- */
-import type { BetterSQLite3Database } from "drizzle-orm/better-sqlite3";
-import type { CompileInput, CompiledAgent } from "@adhd/agent-compiler";
-import type { ComposedPromptStore } from "../store/composed-prompt-store.js";
-export interface ResolveInput {
-    /** Slug (name) of the agent to resolve. */
-    agentSlug: string;
-    /** Target platform id (e.g. "claude_code", "claude_api"). */
-    platform: string;
-    /** Runtime context key/value map (e.g. `{ ticket_type: "security" }`). */
-    context?: Record<string, string>;
-}
-export interface ResolveResult {
-    /** Flat system-prompt string produced by compileAgent() or served from cache. */
-    content: string;
-    /** Row id in agent-mcp's composed_prompts table — written to sessions.composed_prompt_id. */
-    id: string;
-}
-/**
- * Injectable compile function — matches the signature of
- * `compileAgent` from @adhd/agent-compiler so tests can stub it.
- */
-export type CompileAgentFn = (input: CompileInput) => CompiledAgent;
-export interface PromptResolverDeps {
-    /** Agent-mcp's own composed_prompts cache store. */
-    composedPromptStore: ComposedPromptStore;
-    /**
-     * The compileAgent function from @adhd/agent-compiler.
-     * Injectable so tests can stub without touching production code.
-     */
-    compileAgentFn: CompileAgentFn;
-    /**
-     * Registry DB handle passed through to compileAgent on cache MISS.
-     * Must point at the agent-registry SQLite file (all four table prefixes).
-     * Unused on a cache HIT.
-     */
-    registryDb: BetterSQLite3Database<any>;
-}
-/**
- * Compute a deterministic SHA-256 cache key from (agentSlug, platform, context).
- *
- * The key encodes every runtime dimension that could produce a different compiled
- * artifact: the agent identity, the target platform, and any runtime context
- * key/value pairs.  Keys in `context` are sorted before serialisation so that
- * insertion order cannot produce different hashes for identical logical inputs.
- *
- * @returns 64-character lowercase hex SHA-256 string.
- */
-export declare function computeContextHash(agentSlug: string, platform: string, context: Record<string, string>): string;
-/**
- * Resolve the compiled system-prompt for a session start.
- *
- * On a cache HIT (agent-mcp's `composed_prompts` already has a row for this
- * agent + context hash) the cached `{content, id}` is returned WITHOUT calling
- * compileAgent — the registry round-trip is skipped entirely.
- *
- * On a cache MISS, compileAgent is called with the supplied `registryDb` handle.
- * The result is upserted into agent-mcp's `composed_prompts` table and the
- * returned `id` is suitable for writing to `sessions.composed_prompt_id`.
- *
- * **Flat-prompt fallback (backward compatibility):** when `compileAgentFn`
- * throws (e.g. the agent has no registry composition — `AgentError` with code
- * `AGENT_NOT_FOUND`, or a `CompositionError`) this function returns `null`
- * instead of propagating.  The caller (`agentTool`) then falls back to the
- * stored `agentDefinition.systemPrompt`, so a legacy flat-`systemPrompt` agent
- * continues to work even when a live registry DB is wired.
- *
- * @param input - Agent slug, target platform, and optional runtime context.
- * @param deps  - Injected ComposedPromptStore, compileAgentFn, and registry DB.
- * @returns {content, id} on success, or `null` when no registry composition
- *   exists for the agent (caller must fall back to the flat systemPrompt).
- */
-export declare function resolveComposedPrompt(input: ResolveInput, deps: PromptResolverDeps): ResolveResult | null;
-//# sourceMappingURL=prompt-resolver.d.ts.map

package/src/engine/prompt-resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prompt-resolver.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/engine/prompt-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAK7E,MAAM,WAAW,YAAY;IACzB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC1B,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,6FAA6F;IAC7F,EAAE,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,aAAa,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IAC/B,oDAAoD;IACpD,mBAAmB,EAAE,mBAAmB,CAAC;IACzC;;;OAGG;IACH,cAAc,EAAE,cAAc,CAAC;IAC/B;;;;OAIG;IAEH,UAAU,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC;CAC1C;AAID;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAMR;AAID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,kBAAkB,GACzB,aAAa,GAAG,IAAI,CAmDtB"}

package/src/engine/prompt-resolver.js

@@ -1,96 +0,0 @@
-/**
- * prompt-resolver — resolves a compiled system-prompt for a session start.
- *
- * Flow:
- *  1. Compute context_hash from (agentSlug, platform, context).
- *  2. Look up agent-mcp's own composed_prompts cache via ComposedPromptStore.
- *  3. HIT  → return {content, id} WITHOUT calling compileAgent.
- *  4. MISS → call compileAgent(…), upsert the row, return {content, id}.
- *
- * compileAgent is injected as a parameter (compileAgentFn) so tests can stub it
- * without modifying production code.  Production callers pass the real
- * `compileAgent` from @adhd/agent-compiler.
- *
- * [compiler-integration.1] — imports compileAgent from @adhd/agent-compiler
- * [compiler-integration.2] — caches/looks up the composed prompt and writes composed_prompt_id
- */
-import { createHash } from "node:crypto";
-import { logger } from "../logger.js";
-// ── Context hash ─────────────────────────────────────────────────────────────
-/**
- * Compute a deterministic SHA-256 cache key from (agentSlug, platform, context).
- *
- * The key encodes every runtime dimension that could produce a different compiled
- * artifact: the agent identity, the target platform, and any runtime context
- * key/value pairs.  Keys in `context` are sorted before serialisation so that
- * insertion order cannot produce different hashes for identical logical inputs.
- *
- * @returns 64-character lowercase hex SHA-256 string.
- */
-export function computeContextHash(agentSlug, platform, context) {
-    const sortedContext = Object.fromEntries(Object.keys(context).sort().map(k => [k, context[k]]));
-    const payload = `${agentSlug}|${platform}|${JSON.stringify(sortedContext)}`;
-    return createHash("sha256").update(payload, "utf8").digest("hex");
-}
-// ── Public resolver ──────────────────────────────────────────────────────────
-/**
- * Resolve the compiled system-prompt for a session start.
- *
- * On a cache HIT (agent-mcp's `composed_prompts` already has a row for this
- * agent + context hash) the cached `{content, id}` is returned WITHOUT calling
- * compileAgent — the registry round-trip is skipped entirely.
- *
- * On a cache MISS, compileAgent is called with the supplied `registryDb` handle.
- * The result is upserted into agent-mcp's `composed_prompts` table and the
- * returned `id` is suitable for writing to `sessions.composed_prompt_id`.
- *
- * **Flat-prompt fallback (backward compatibility):** when `compileAgentFn`
- * throws (e.g. the agent has no registry composition — `AgentError` with code
- * `AGENT_NOT_FOUND`, or a `CompositionError`) this function returns `null`
- * instead of propagating.  The caller (`agentTool`) then falls back to the
- * stored `agentDefinition.systemPrompt`, so a legacy flat-`systemPrompt` agent
- * continues to work even when a live registry DB is wired.
- *
- * @param input - Agent slug, target platform, and optional runtime context.
- * @param deps  - Injected ComposedPromptStore, compileAgentFn, and registry DB.
- * @returns {content, id} on success, or `null` when no registry composition
- *   exists for the agent (caller must fall back to the flat systemPrompt).
- */
-export function resolveComposedPrompt(input, deps) {
-    const { agentSlug, platform, context = {} } = input;
-    const { composedPromptStore, compileAgentFn, registryDb } = deps;
-    const contextHash = computeContextHash(agentSlug, platform, context);
-    // ── Cache HIT ────────────────────────────────────────────────────────────
-    const cached = composedPromptStore.findByAgentContext(agentSlug, contextHash);
-    if (cached) {
-        logger.debug({ agentSlug, composedPromptId: cached.id }, "Composed prompt cache hit — skipping compileAgent");
-        return { content: cached.content, id: cached.id };
-    }
-    // ── Cache MISS — compile and upsert ──────────────────────────────────────
-    logger.debug({ agentSlug, platform }, "Composed prompt cache miss — calling compileAgent");
-    let compiled;
-    try {
-        compiled = compileAgentFn({
-            agentSlug,
-            platform,
-            context,
-            db: registryDb,
-        });
-    }
-    catch (err) {
-        // No registry composition for this agent — fall back to the stored
-        // flat systemPrompt.  Log at debug level: this is expected for agents
-        // that were created via agent_create without registry backing.
-        logger.debug({ agentSlug, err }, "compileAgent threw — no registry composition; falling back to flat systemPrompt");
-        return null;
-    }
-    const row = composedPromptStore.upsert({
-        agentSlug,
-        contextHash,
-        content: compiled.content,
-        componentVersions: JSON.stringify(compiled.componentVersions ?? {}),
-    });
-    logger.info({ agentSlug, composedPromptId: row.id }, "Composed prompt compiled and cached");
-    return { content: row.content, id: row.id };
-}
-//# sourceMappingURL=prompt-resolver.js.map

package/src/engine/prompt-resolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prompt-resolver.js","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/engine/prompt-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AA2CtC,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAC9B,SAAiB,EACjB,QAAgB,EAChB,OAA+B;IAE/B,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CACpC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAU,CAAC,CACjE,CAAC;IACF,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;IAC5E,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,qBAAqB,CACjC,KAAmB,EACnB,IAAwB;IAExB,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC;IACpD,MAAM,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAEjE,MAAM,WAAW,GAAG,kBAAkB,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAErE,4EAA4E;IAC5E,MAAM,MAAM,GAAG,mBAAmB,CAAC,kBAAkB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC9E,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,CAAC,KAAK,CACR,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,EAAE,EAC1C,mDAAmD,CACtD,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;IACtD,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,mDAAmD,CAAC,CAAC;IAE3F,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACD,QAAQ,GAAG,cAAc,CAAC;YACtB,SAAS;YACT,QAAQ;YACR,OAAO;YACP,EAAE,EAAE,UAAU;SACjB,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,mEAAmE;QACnE,sEAAsE;QACtE,+DAA+D;QAC/D,MAAM,CAAC,KAAK,CACR,EAAE,SAAS,EAAE,GAAG,EAAE,EAClB,iFAAiF,CACpF,CAAC;QACF,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,GAAG,GAAG,mBAAmB,CAAC,MAAM,CAAC;QACnC,SAAS;QACT,WAAW;QACX,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,IAAI,EAAE,CAAC;KACtE,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CACP,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,EAAE,EACvC,qCAAqC,CACxC,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;AAChD,CAAC"}

package/src/engine/queue.d.ts

@@ -1,29 +0,0 @@
-export type BackgroundTaskFn = () => Promise<void>;
-/**
- * BackgroundQueue wraps p-queue to run async tasks with concurrency limiting.
- *
- * TaskStore is NOT a dependency of BackgroundQueue's constructor — it is
- * injected into each enqueue call to avoid circular dependencies. The queue
- * only knows how to run tasks; the caller controls persistence.
- */
-export declare class BackgroundQueue {
-    private readonly queue;
-    constructor(concurrency?: number);
-    /**
-     * Enqueue a background task.
-     *
-     * The task function is responsible for calling
-     * `taskStore.updateStatus(taskId, ...)` on completion or failure.
-     * The orchestrator handles this internally via try/catch/finally.
-     */
-    enqueue(taskId: string, runFn: BackgroundTaskFn): void;
-    get pending(): number;
-    get size(): number;
-    /**
-     * Returns a Promise that resolves when the queue has drained to idle
-     * (all currently enqueued and running tasks have finished).
-     * Delegates to p-queue's own `onIdle()`.
-     */
-    onIdle(): Promise<void>;
-}
-//# sourceMappingURL=queue.d.ts.map

package/src/engine/queue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/engine/queue.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,WAAW,CAAC,EAAE,MAAM;IAMhC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAkBtD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAG1B"}

package/src/engine/queue.js

@@ -1,56 +0,0 @@
-import PQueue from "p-queue";
-import { logger } from "../logger.js";
-import { config } from "../config.js";
-/**
- * BackgroundQueue wraps p-queue to run async tasks with concurrency limiting.
- *
- * TaskStore is NOT a dependency of BackgroundQueue's constructor — it is
- * injected into each enqueue call to avoid circular dependencies. The queue
- * only knows how to run tasks; the caller controls persistence.
- */
-export class BackgroundQueue {
-    queue;
-    constructor(concurrency) {
-        const resolvedConcurrency = concurrency ?? config.queue.concurrency;
-        this.queue = new PQueue({ concurrency: resolvedConcurrency });
-    }
-    /**
-     * Enqueue a background task.
-     *
-     * The task function is responsible for calling
-     * `taskStore.updateStatus(taskId, ...)` on completion or failure.
-     * The orchestrator handles this internally via try/catch/finally.
-     */
-    enqueue(taskId, runFn) {
-        this.queue.add(async () => {
-            logger.debug({ taskId }, "Background task dequeued");
-            try {
-                await runFn();
-            }
-            catch (error) {
-                // DEBT-001 error boundary: the orchestrator's try/catch/finally already
-                // updates the task status and emits TASK_FAILED before re-throwing.
-                // Swallowing here is intentional — rethrowing would surface as an
-                // unhandled rejection in p-queue and reach our process.on("unhandledRejection")
-                // handler, killing the server for a per-task failure. Log for observability.
-                logger.error({ taskId, error }, "Background task failed");
-            }
-        });
-        logger.debug({ taskId, pending: this.queue.pending, size: this.queue.size }, "Background task enqueued");
-    }
-    get pending() {
-        return this.queue.pending;
-    }
-    get size() {
-        return this.queue.size;
-    }
-    /**
-     * Returns a Promise that resolves when the queue has drained to idle
-     * (all currently enqueued and running tasks have finished).
-     * Delegates to p-queue's own `onIdle()`.
-     */
-    onIdle() {
-        return this.queue.onIdle();
-    }
-}
-//# sourceMappingURL=queue.js.map

package/src/engine/queue.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/engine/queue.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,SAAS,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAItC;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IACP,KAAK,CAAS;IAE/B,YAAY,WAAoB;QAC5B,MAAM,mBAAmB,GAAG,WAAW,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC;QAEpE,IAAI,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,MAAc,EAAE,KAAuB;QAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YACtB,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC;YACrD,IAAI,CAAC;gBACD,MAAM,KAAK,EAAE,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,wEAAwE;gBACxE,oEAAoE;gBACpE,kEAAkE;gBAClE,gFAAgF;gBAChF,6EAA6E;gBAC7E,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,wBAAwB,CAAC,CAAC;YAC9D,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,0BAA0B,CAAC,CAAC;IAC7G,CAAC;IAED,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;CACJ"}

package/src/plugins/index.d.ts

@@ -1,2 +0,0 @@
-export { UsagePlugin } from "./usage-plugin.js";
-//# sourceMappingURL=index.d.ts.map

package/src/plugins/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/src/plugins/index.js

@@ -1,2 +0,0 @@
-export { UsagePlugin } from "./usage-plugin.js";
-//# sourceMappingURL=index.js.map

package/src/plugins/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/src/plugins/loader.d.ts

@@ -1,65 +0,0 @@
-import { z } from "zod";
-import type { IHookRegistry } from "@adhd/agent-mcp-types";
-declare const pluginEntrySchema: z.ZodObject<{
-    module: z.ZodString;
-    config: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-}, z.core.$strip>;
-/** JSON schema for the agent-mcp.config.json file itself. */
-export declare const agentMcpConfigFileSchema: z.ZodObject<{
-    plugins: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
-        module: z.ZodString;
-        config: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    }, z.core.$strip>>>>;
-}, z.core.$strip>;
-export type AgentMcpConfigFile = z.infer<typeof agentMcpConfigFileSchema>;
-export type PluginEntry = z.infer<typeof pluginEntrySchema>;
-/**
- * Returns the path to the active agent-mcp config file, or `null` if none is
- * found. Search order:
- *   1. `configPathOverride` (when provided directly — used by tests)
- *      or `ADHD_AGENT_CONFIG` singleton value — absolute path to any JSON file
- *   2. `{cwd}/agent-mcp.config.json` — project-local (next to package.json)
- *   3. `{HOME}/.agent-mcp/config.json` — global user config
- *
- * @param configPathOverride — explicit path that takes priority over the
- *   singleton value; pass `null` to force "no explicit path" (skip the env
- *   lookup) without passing an actual file path.
- */
-export declare function findConfigFile(configPathOverride?: string | null): string | null;
-/**
- * Reads, parses, and validates the agent-mcp config file. Returns
- * `{ plugins: [] }` on any failure so the caller can always destructure safely.
- *
- * @param configPathOverride — forwarded to `findConfigFile`; used in tests.
- */
-export declare function loadConfigFile(configPathOverride?: string | null): AgentMcpConfigFile;
-/**
- * Resolves a module specifier to a `file://` URL string for `import()`.
- *
- * - Absolute/relative paths → converted via `pathToFileURL`.
- * - Package names → resolved via `createRequire` from `process.cwd()` first
- *   (project-local `node_modules`, works for `npx` users), then from the server
- *   binary's directory (monorepo / global installs). Throws if unresolvable.
- */
-export declare function resolveSpecifier(specifier: string): Promise<string>;
-/**
- * Discovers and installs all external plugins. Never throws.
- *
- * Processing order:
- *   1. Plugins from the agent-mcp config file (with optional validated `config` blocks).
- *   2. Specifiers from `ADHD_AGENT_PLUGINS` (comma-separated, no per-plugin options).
- *
- * All failures (bad config file, unresolvable module, failed schema validation,
- * factory errors) are logged at `error` level and skipped — a broken plugin
- * never prevents the server from starting.
- *
- * @param overrides — explicit values for testability; production code omits this.
- *   `configPath`    — forwarded to `findConfigFile`
- *   `pluginEntries` — explicit module list (replaces `config.plugins.entries`)
- */
-export declare function loadExternalPlugins(hooks: IHookRegistry, db: unknown, overrides?: {
-    configPath?: string | null;
-    pluginEntries?: string[];
-}): Promise<void>;
-export {};
-//# sourceMappingURL=loader.d.ts.map

package/src/plugins/loader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/plugins/loader.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,aAAa,EAAwC,MAAM,uBAAuB,CAAC;AAIjG,QAAA,MAAM,iBAAiB;;;iBAKrB,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB;;;;;iBAEnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AA0B5D;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAsBhF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,kBAAkB,CA6BrF;AAID;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BzE;AA6ED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACrC,KAAK,EAAE,aAAa,EACpB,EAAE,EAAE,OAAO,EACX,SAAS,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrE,OAAO,CAAC,IAAI,CAAC,CAYf"}