@adhd/agent-mcp 2.0.0 → 2.1.0

package/src/plugins/loader.js

@@ -1,222 +0,0 @@
-/**
- * External plugin loader for @adhd/agent-mcp.
- *
- * Discovers and loads plugins from two sources (processed in order):
- *   1. agent-mcp config file — supports per-plugin `config` blocks with schema
- *      validation. Discovered via:
- *        a. AGENT_MCP_CONFIG env var (explicit override)
- *        b. {cwd}/agent-mcp.config.json (project-local)
- *        c. {HOME}/.agent-mcp/config.json (global user config)
- *   2. AGENT_MCP_PLUGINS env var — comma-separated module specifiers, no options
- *      (legacy / CI shorthand).
- *
- * Config file format:
- *   {
- *     "plugins": [
- *       { "module": "@adhd/agent-mcp-metrics" },
- *       { "module": "@adhd/agent-mcp-budget", "config": { "maxUSD": 10 } }
- *     ]
- *   }
- *
- * Plugin packages must export a `createPlugin(ctx): Plugin` factory as their
- * `default` export or as a named `createPlugin` export.
- *
- * Optional schema enforcement: if the plugin module exports `configSchema` with a
- * `.safeParse()` method (Zod-compatible), the server validates the `config` block
- * before calling the factory. The validated (coerced + defaulted) result is passed
- * as `ctx.config`. Validation failure skips the plugin; the server continues.
- */
-import { createRequire } from "node:module";
-import { existsSync, readFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { homedir } from "node:os";
-import { pathToFileURL } from "node:url";
-import { z } from "zod";
-import { logger } from "../logger.js";
-import { config } from "../config.js";
-// ── Config file schema ────────────────────────────────────────────────────────
-const pluginEntrySchema = z.object({
-    /** npm package name or absolute file path */
-    module: z.string().min(1, "module must be a non-empty string"),
-    /** plugin-specific options validated against the plugin's own configSchema */
-    config: z.record(z.string(), z.unknown()).optional().default({}),
-});
-/** JSON schema for the agent-mcp.config.json file itself. */
-export const agentMcpConfigFileSchema = z.object({
-    plugins: z.array(pluginEntrySchema).optional().default([]),
-});
-// ── Config file discovery ─────────────────────────────────────────────────────
-/**
- * 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 function findConfigFile(configPathOverride) {
-    const explicit = configPathOverride !== undefined
-        ? configPathOverride
-        : config.plugins.configPath;
-    if (explicit) {
-        if (!existsSync(explicit)) {
-            logger.warn({ path: explicit }, "AGENT_MCP_CONFIG points to a file that does not exist — ignoring");
-            return null;
-        }
-        return explicit;
-    }
-    const local = resolve(process.cwd(), "agent-mcp.config.json");
-    if (existsSync(local))
-        return local;
-    const global_ = resolve(homedir(), ".agent-mcp", "config.json");
-    if (existsSync(global_))
-        return global_;
-    return 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 function loadConfigFile(configPathOverride) {
-    const configPath = findConfigFile(configPathOverride);
-    if (!configPath)
-        return { plugins: [] };
-    let raw;
-    try {
-        raw = JSON.parse(readFileSync(configPath, "utf-8"));
-    }
-    catch (err) {
-        logger.error({ configPath, err }, "Failed to read/parse agent-mcp config file — no config-file plugins will load");
-        return { plugins: [] };
-    }
-    const result = agentMcpConfigFileSchema.safeParse(raw);
-    if (!result.success) {
-        logger.error({ configPath, issues: result.error.flatten().fieldErrors }, "agent-mcp config file failed schema validation — no config-file plugins will load");
-        return { plugins: [] };
-    }
-    logger.info({ configPath, pluginCount: result.data.plugins.length }, "Loaded agent-mcp config file");
-    return result.data;
-}
-// ── Module resolution ─────────────────────────────────────────────────────────
-/**
- * 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 async function resolveSpecifier(specifier) {
-    if (specifier.startsWith("/") ||
-        specifier.startsWith("./") ||
-        specifier.startsWith("../")) {
-        return pathToFileURL(resolve(specifier)).href;
-    }
-    const bases = [
-        process.cwd(),
-        new URL(".", import.meta.url).pathname,
-    ];
-    for (const base of bases) {
-        try {
-            const req = createRequire(base + "/");
-            return pathToFileURL(req.resolve(specifier)).href;
-        }
-        catch {
-            // try next base
-        }
-    }
-    throw new Error(`Cannot resolve plugin "${specifier}" from cwd (${process.cwd()}) or server directory. ` +
-        `Install it in your project: npm install ${specifier}`);
-}
-// ── Single plugin load ────────────────────────────────────────────────────────
-async function loadOnePlugin(hooks, db, entry) {
-    const { module: specifier, config: rawConfig } = entry;
-    // ── Resolve ───────────────────────────────────────────────────────────────
-    let resolved;
-    try {
-        resolved = await resolveSpecifier(specifier);
-    }
-    catch (err) {
-        logger.error({ specifier, err }, "Plugin resolution failed — skipping");
-        return;
-    }
-    // ── Import ────────────────────────────────────────────────────────────────
-    let mod;
-    try {
-        mod = await import(resolved);
-    }
-    catch (err) {
-        logger.error({ specifier, resolved, err }, "Plugin import failed — skipping");
-        return;
-    }
-    // ── Config schema validation ──────────────────────────────────────────────
-    let validatedConfig = rawConfig ?? {};
-    if (mod.configSchema && typeof mod.configSchema.safeParse === "function") {
-        const result = mod.configSchema.safeParse(rawConfig ?? {});
-        if (!result.success) {
-            const issues = result.error?.flatten?.() ?? result.error;
-            logger.error({ specifier, issues }, "Plugin config failed schema validation — skipping. " +
-                "Fix the 'config' block for this plugin in your agent-mcp config file.");
-            return;
-        }
-        validatedConfig = result.data;
-    }
-    // ── Factory ───────────────────────────────────────────────────────────────
-    const factory = (mod.createPlugin ?? mod.default);
-    if (typeof factory !== "function") {
-        logger.error({ specifier }, "Plugin does not export a createPlugin factory (as default or named export) — skipping. " +
-            "Expected: export default function createPlugin(ctx): Plugin { ... }");
-        return;
-    }
-    // ── Instantiate + install ─────────────────────────────────────────────────
-    let plugin;
-    try {
-        const ctx = { db, config: validatedConfig };
-        plugin = await factory(ctx);
-    }
-    catch (err) {
-        logger.error({ specifier, err }, "Plugin factory threw during instantiation — skipping");
-        return;
-    }
-    try {
-        await plugin.install(hooks);
-        logger.info({ plugin: plugin.name, specifier }, "External plugin installed");
-    }
-    catch (err) {
-        logger.error({ specifier, plugin: plugin.name, err }, "Plugin install() threw — skipping");
-    }
-}
-// ── Public entry point ────────────────────────────────────────────────────────
-/**
- * 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 async function loadExternalPlugins(hooks, db, overrides) {
-    const configFile = loadConfigFile(overrides?.configPath);
-    const legacyEntries = (overrides?.pluginEntries ?? config.plugins.entries)
-        .map(module => ({ module, config: {} }));
-    const allEntries = [...configFile.plugins, ...legacyEntries];
-    if (allEntries.length === 0)
-        return;
-    for (const entry of allEntries) {
-        await loadOnePlugin(hooks, db, entry);
-    }
-}
-//# sourceMappingURL=loader.js.map

package/src/plugins/loader.js.map

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

package/src/plugins/usage-plugin.d.ts

@@ -1,27 +0,0 @@
-import type { BetterSQLite3Database } from "drizzle-orm/better-sqlite3";
-import type { IHookRegistry, Plugin } from "@adhd/agent-mcp-types";
-/**
- * Observational plugin that records per-task token usage into `task_usage`.
- *
- * Write strategy (see [inv:incremental-write]):
- *   - task:start            → remember startedAt + identity in memory; no DB write.
- *   - post:model_response   → UPSERT: INSERT the row on first call (is_complete=0),
- *                             then accumulate input/output tokens + tool/model
- *                             counts on every subsequent call. Durable across crash.
- *   - task:completed/failed/cancelled → final UPDATE: latency_ms, root_task_id,
- *                             is_complete=1; drop the in-memory entry.
- *
- * INVARIANT [inv:plugin-no-throw]: every handler is wrapped in try/catch and logs
- * errors silently. An observational plugin must never crash the host process.
- */
-export declare class UsagePlugin implements Plugin {
-    private readonly db;
-    readonly name = "usage";
-    private readonly accumulators;
-    constructor(db: BetterSQLite3Database<any>);
-    install(hooks: IHookRegistry): void;
-    private onTaskStart;
-    private onModelResponse;
-    private onTerminal;
-}
-//# sourceMappingURL=usage-plugin.d.ts.map

package/src/plugins/usage-plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"usage-plugin.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/plugins/usage-plugin.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAKxE,OAAO,KAAK,EACR,aAAa,EACb,MAAM,EAMT,MAAM,uBAAuB,CAAC;AAyB/B;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAY,YAAW,MAAM;IAQlC,OAAO,CAAC,QAAQ,CAAC,EAAE;IAPvB,QAAQ,CAAC,IAAI,WAAW;IAExB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;gBAK1C,EAAE,EAAE,qBAAqB,CAAC,GAAG,CAAC;IAGnD,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAQnC,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,eAAe;IA+DvB,OAAO,CAAC,UAAU;CA6BrB"}

package/src/plugins/usage-plugin.js

@@ -1,148 +0,0 @@
-import { eq, sql } from "drizzle-orm";
-const SEVERITY = { length: 3, tool_calls: 2, stop: 1, unknown: 0 };
-function mostSevere(a, b) {
-    const sa = SEVERITY[a ?? ""] ?? 0;
-    const sb = SEVERITY[b ?? ""] ?? 0;
-    return sa >= sb ? (a ?? "unknown") : (b ?? "unknown");
-}
-import { taskUsageTable } from "../db/schema.js";
-import { logger } from "../logger.js";
-import { nowIso } from "../utils/timestamps.js";
-/**
- * Observational plugin that records per-task token usage into `task_usage`.
- *
- * Write strategy (see [inv:incremental-write]):
- *   - task:start            → remember startedAt + identity in memory; no DB write.
- *   - post:model_response   → UPSERT: INSERT the row on first call (is_complete=0),
- *                             then accumulate input/output tokens + tool/model
- *                             counts on every subsequent call. Durable across crash.
- *   - task:completed/failed/cancelled → final UPDATE: latency_ms, root_task_id,
- *                             is_complete=1; drop the in-memory entry.
- *
- * INVARIANT [inv:plugin-no-throw]: every handler is wrapped in try/catch and logs
- * errors silently. An observational plugin must never crash the host process.
- */
-export class UsagePlugin {
-    db;
-    name = "usage";
-    accumulators = new Map();
-    constructor(
-    // Drizzle better-sqlite3 instance — identical to what the stores receive.
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    db) {
-        this.db = db;
-    }
-    install(hooks) {
-        hooks.register("task:start", payload => this.onTaskStart(payload));
-        hooks.register("post:model_response", payload => this.onModelResponse(payload));
-        hooks.register("task:completed", payload => this.onTerminal(payload));
-        hooks.register("task:failed", payload => this.onTerminal(payload));
-        hooks.register("task:cancelled", payload => this.onTerminal(payload));
-    }
-    onTaskStart(payload) {
-        try {
-            const { executionContext } = payload;
-            const provider = executionContext.agentDefinition.provider;
-            this.accumulators.set(executionContext.taskId, {
-                startedAt: Date.now(),
-                // rootTaskId is resolved at task-creation time and forwarded in the
-                // task:start payload — never walk the tasks DB (ephemeral tasks have
-                // no tasks row). See [inv:root-task-resolution].
-                rootTaskId: payload.rootTaskId ?? null,
-                agentName: executionContext.agentName,
-                providerType: provider.type,
-                model: ("model" in provider && provider.model) || "default",
-                mostSevereStopReason: "unknown",
-                maxTokens: ("maxTokens" in provider && typeof provider.maxTokens === "number")
-                    ? provider.maxTokens
-                    : null,
-            });
-        }
-        catch (err) {
-            logger.error({ err }, "UsagePlugin: task:start handler failed");
-        }
-    }
-    onModelResponse(payload) {
-        try {
-            const { executionContext, tokenUsage, toolCallCount } = payload;
-            const taskId = executionContext.taskId;
-            const acc = this.accumulators.get(taskId);
-            // Tokens are undefined for claudecli — record zeros so the row still
-            // exists. See [inv:claudecli-undefined].
-            const inputTokens = tokenUsage?.inputTokens ?? 0;
-            const outputTokens = tokenUsage?.outputTokens ?? 0;
-            const toolCalls = toolCallCount ?? 0;
-            // Update most-severe stop reason in memory before writing to DB.
-            const incoming = tokenUsage?.stopReason ?? "unknown";
-            if (acc) {
-                acc.mostSevereStopReason = mostSevere(acc.mostSevereStopReason, incoming);
-            }
-            const provider = executionContext.agentDefinition.provider;
-            // UPSERT (see [inv:incremental-write]): insert on the first model
-            // response, accumulate on every subsequent one. Durable across crash.
-            this.db
-                .insert(taskUsageTable)
-                .values({
-                taskId,
-                rootTaskId: acc?.rootTaskId ?? null,
-                agentName: acc?.agentName ?? executionContext.agentName,
-                providerType: acc?.providerType ?? provider.type,
-                model: acc?.model ??
-                    (("model" in provider && provider.model) || "default"),
-                inputTokens,
-                outputTokens,
-                toolCallCount: toolCalls,
-                modelCalls: 1,
-                latencyMs: 0,
-                isComplete: 0,
-                stopReason: acc?.mostSevereStopReason ?? incoming,
-                maxTokens: acc?.maxTokens ?? null,
-                cacheReadTokens: tokenUsage?.cacheReadTokens ?? null,
-                cacheCreationTokens: tokenUsage?.cacheCreationTokens ?? null,
-                createdAt: nowIso(),
-            })
-                .onConflictDoUpdate({
-                target: taskUsageTable.taskId,
-                set: {
-                    inputTokens: sql `${taskUsageTable.inputTokens} + ${inputTokens}`,
-                    outputTokens: sql `${taskUsageTable.outputTokens} + ${outputTokens}`,
-                    toolCallCount: sql `${taskUsageTable.toolCallCount} + ${toolCalls}`,
-                    modelCalls: sql `${taskUsageTable.modelCalls} + 1`,
-                    stopReason: acc?.mostSevereStopReason ?? incoming,
-                    cacheReadTokens: sql `COALESCE(${taskUsageTable.cacheReadTokens}, 0) + ${tokenUsage?.cacheReadTokens ?? 0}`,
-                    cacheCreationTokens: sql `COALESCE(${taskUsageTable.cacheCreationTokens}, 0) + ${tokenUsage?.cacheCreationTokens ?? 0}`,
-                    // maxTokens deliberately OMITTED from SET — constant per task
-                },
-            })
-                .run();
-        }
-        catch (err) {
-            logger.error({ err }, "UsagePlugin: post:model_response handler failed");
-        }
-    }
-    onTerminal(payload) {
-        try {
-            const taskId = payload.executionContext.taskId;
-            const acc = this.accumulators.get(taskId);
-            // If no post:model_response ever fired there is no row to finalise —
-            // the task consumed zero tokens (cancelled before first model call).
-            // The UPDATE simply affects zero rows, which is correct.
-            const latencyMs = acc ? Date.now() - acc.startedAt : 0;
-            const rootTaskId = acc?.rootTaskId ?? payload.executionContext.rootTaskId ?? null;
-            this.db
-                .update(taskUsageTable)
-                .set({
-                latencyMs,
-                rootTaskId,
-                isComplete: 1,
-            })
-                .where(eq(taskUsageTable.taskId, taskId))
-                .run();
-            this.accumulators.delete(taskId);
-        }
-        catch (err) {
-            logger.error({ err }, "UsagePlugin: terminal handler failed");
-        }
-    }
-}
-//# sourceMappingURL=usage-plugin.js.map

package/src/plugins/usage-plugin.js.map

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

package/src/providers/anthropic.d.ts

@@ -1,13 +0,0 @@
-import type { ProviderConfig } from "../validation/index.js";
-import type { LLMProvider, ProviderChatRequest, ProviderChatResponse } from "./types.js";
-export declare class AnthropicProvider implements LLMProvider {
-    private readonly client;
-    private readonly providerConfig;
-    /** True when the resolved secret is a sk-ant-oat… OAuth token. */
-    private readonly useOauthIdentity;
-    constructor(providerConfig: Extract<ProviderConfig, {
-        type: "anthropic";
-    }>);
-    chat(request: ProviderChatRequest): Promise<ProviderChatResponse>;
-}
-//# sourceMappingURL=anthropic.d.ts.map

package/src/providers/anthropic.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/providers/anthropic.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,wBAAwB,CAAC;AAKhF,OAAO,KAAK,EACR,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EAEvB,MAAM,YAAY,CAAC;AAsJpB,qBAAa,iBAAkB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiD;IAChF,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;gBAE/B,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;IA+BpE,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA0H1E"}