adonis-ai-kit 0.0.0-stage → 1.2.0

package/dist/src/acp/acp_agents.js

@@ -0,0 +1,367 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * Built-in ACP agent configurations. These are the ONLY commands that may be started from a
+ * model name; anything else must be configured explicitly via `AcpProviderConfig.command`.
+ *
+ * Commands follow the agents' own ACP docs: Claude via the `claude-agent-acp` adapter, Gemini CLI
+ * with `--acp`, Qwen Code's `qwen --acp`, Codex via `codex-acp`, `opencode acp`.
+ * `sourcecraft` and `freebuff` could not be verified against upstream docs; override them with
+ * `ACP_<AGENT>_PATH` / `ACP_<AGENT>_ARGS` if your install differs.
+ */
+const DEFAULT_ACP_AGENTS = Object.freeze({
+    'claude-code': {
+        id: 'claude-code',
+        name: 'Claude Code',
+        description: "Anthropic's agentic coding CLI tool",
+        command: 'claude-agent-acp',
+        args: [],
+        envVarPrefix: 'ACP_CLAUDE_CODE',
+        supportsMcpServers: true,
+        credentialEnv: [{ target: 'ANTHROPIC_API_KEY', sources: ['ANTHROPIC_API_KEY'] }],
+    },
+    'gemini': {
+        id: 'gemini',
+        name: 'Gemini CLI',
+        description: "Google's Gemini CLI agent",
+        command: 'gemini',
+        args: ['--acp'],
+        envVarPrefix: 'ACP_GEMINI',
+        supportsMcpServers: true,
+        authMethodId: 'gemini-api-key',
+        credentialEnv: [{ target: 'GEMINI_API_KEY', sources: ['GEMINI_API_KEY', 'GOOGLE_API_KEY'] }],
+    },
+    'codex': {
+        id: 'codex',
+        name: 'Codex CLI',
+        description: "OpenAI's Codex CLI agent",
+        command: 'codex-acp',
+        args: [],
+        envVarPrefix: 'ACP_CODEX',
+        supportsMcpServers: true,
+        credentialEnv: [{ target: 'OPENAI_API_KEY', sources: ['OPENAI_API_KEY'] }],
+    },
+    'qwen-code': {
+        id: 'qwen-code',
+        name: 'Qwen Code',
+        description: "Alibaba's Qwen Code CLI agent",
+        command: 'qwen',
+        args: ['--acp'],
+        envVarPrefix: 'ACP_QWEN_CODE',
+        supportsMcpServers: true,
+        credentialEnv: [{ target: 'DASHSCOPE_API_KEY', sources: ['DASHSCOPE_API_KEY', 'QWEN_API_KEY'] }],
+    },
+    /** @deprecated Removed from defaults in 2.0; register it with registerAcpAgent() */
+    'sourcecraft': {
+        id: 'sourcecraft',
+        name: 'SourceCraft Code Assistant',
+        description: "SourceCraft's Code Assistant agent via CLI",
+        command: 'src',
+        args: ['code', '--', 'acp'],
+        envVarPrefix: 'ACP_SOURCECRAFT',
+        supportsMcpServers: true,
+    },
+    'opencode': {
+        id: 'opencode',
+        name: 'OpenCode',
+        description: 'OpenCode AI coding assistant',
+        command: 'opencode',
+        args: ['acp'],
+        envVarPrefix: 'ACP_OPENCODE',
+        supportsMcpServers: true,
+        credentialEnv: [{ target: 'OPENCODE_API_KEY', sources: ['OPENCODE_API_KEY'] }],
+    },
+    /** @deprecated Removed from defaults in 2.0; register it with registerAcpAgent() */
+    'freebuff': {
+        id: 'freebuff',
+        name: 'Freebuff',
+        description: 'Freebuff AI coding agent',
+        command: 'codebuff-agent-acp',
+        args: [],
+        envVarPrefix: 'ACP_FREEBUFF',
+        supportsMcpServers: true,
+        credentialEnv: [
+            { target: 'CODEBUFF_API_KEY', sources: ['CODEBUFF_API_KEY', 'FREEBUFF_API_KEY'] },
+            { target: 'FREEBUFF_API_KEY', sources: ['CODEBUFF_API_KEY', 'FREEBUFF_API_KEY'] },
+        ],
+    },
+});
+/**
+ * Registry of the ACP agents this application may start.
+ *
+ * It starts with the built-in agents, and an application can replace it with the
+ * binaries that are actually installed on the operator's machine
+ * (`setAcpAgents`) or extend it (`registerAcpAgent`).
+ */
+export const ACP_AGENTS = { ...DEFAULT_ACP_AGENTS };
+/**
+ * Registers (or replaces) one ACP agent.
+ */
+export function registerAcpAgent(agentId, config) {
+    ACP_AGENTS[agentId] = config;
+}
+/**
+ * Replaces the whole agent registry, e.g. with the binaries of a given deployment.
+ */
+export function setAcpAgents(agents) {
+    for (const key of Object.keys(ACP_AGENTS))
+        delete ACP_AGENTS[key];
+    Object.assign(ACP_AGENTS, agents);
+}
+/**
+ * Restores the built-in agent registry.
+ */
+export function resetAcpAgents() {
+    setAcpAgents(DEFAULT_ACP_AGENTS);
+}
+/**
+ * Get ACP agent configuration by ID.
+ */
+export function getAcpAgentConfig(agentId) {
+    return ACP_AGENTS[agentId];
+}
+/**
+ * List all available ACP agent IDs.
+ */
+export function listAcpAgentIds() {
+    return Object.keys(ACP_AGENTS);
+}
+/**
+ * Check if an agent ID is a valid ACP agent.
+ */
+export function isAcpAgent(agentId) {
+    return agentId in ACP_AGENTS;
+}
+/**
+ * Parse agent arguments from env string.
+ * Supports JSON arrays (e.g., '["--flag","--opt","val"]')
+ * and falls back to comma-separated values.
+ */
+export function parseAcpArgs(argsOverride, fallback, logger) {
+    if (!argsOverride)
+        return fallback;
+    const trimmed = argsOverride.trim();
+    if (trimmed.startsWith('[')) {
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (Array.isArray(parsed) && parsed.every((item) => typeof item === 'string')) {
+                return parsed;
+            }
+        }
+        catch {
+            logger?.warn?.(`[ACP] Invalid JSON array in args override: ${trimmed}`);
+        }
+    }
+    return trimmed
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+function toNameValueList(input) {
+    if (Array.isArray(input)) {
+        return input.filter((item) => item !== null &&
+            typeof item === 'object' &&
+            typeof item.name === 'string' &&
+            typeof item.value === 'string');
+    }
+    if (input !== null && typeof input === 'object') {
+        return Object.entries(input)
+            .filter(([, value]) => typeof value === 'string')
+            .map(([name, value]) => ({ name, value: value }));
+    }
+    return [];
+}
+/**
+ * Validates an MCP server definition and converts it to the exact shape required by the ACP
+ * schema: stdio servers have no `type` and an `env` array; remote servers have `type`
+ * 'http' | 'sse' and a `headers` array. Legacy `Record` env/headers and `httpUrl` are accepted.
+ * Returns `null` for unusable entries.
+ */
+export function normalizeMcpServer(input) {
+    if (input === null || typeof input !== 'object')
+        return null;
+    const raw = input;
+    if (typeof raw.name !== 'string' || raw.name.length === 0)
+        return null;
+    const url = typeof raw.url === 'string' ? raw.url : typeof raw.httpUrl === 'string' ? raw.httpUrl : undefined;
+    if (raw.type === 'http' || raw.type === 'sse' || (raw.type === undefined && url && !raw.command)) {
+        if (!url)
+            return null;
+        return {
+            type: raw.type === 'sse' ? 'sse' : 'http',
+            name: raw.name,
+            url,
+            headers: toNameValueList(raw.headers),
+        };
+    }
+    if (typeof raw.command !== 'string' || raw.command.length === 0)
+        return null;
+    return {
+        name: raw.name,
+        command: raw.command,
+        args: Array.isArray(raw.args) ? raw.args.filter((a) => typeof a === 'string') : [],
+        env: toNameValueList(raw.env),
+    };
+}
+/** Builds the stdio MCP server entry for a project-local MCP server file. */
+export function buildProjectMcpServer(config, logger) {
+    const serverPath = path.resolve(config.path);
+    if (!existsSync(serverPath)) {
+        logger?.warn?.(`[ACP] Project MCP server not found: ${serverPath}. Skipping project MCP.`);
+        return null;
+    }
+    return {
+        name: config.name ?? 'project-tools',
+        command: config.command ?? 'node',
+        args: [serverPath],
+        env: [],
+    };
+}
+export function buildAcpRuntimeConfig(agentId, optionsOrGetEnv, positionalEnvSource, positionalLogger) {
+    // Positional form: getEnv is a function, or explicitly undefined with trailing arguments.
+    const isPositional = typeof optionsOrGetEnv === 'function' ||
+        (optionsOrGetEnv === undefined && arguments.length > 2);
+    const options = isPositional
+        ? {
+            getEnv: optionsOrGetEnv,
+            envSource: positionalEnvSource,
+            logger: positionalLogger,
+        }
+        : (optionsOrGetEnv ?? {});
+    const getEnv = options.getEnv ?? ((key) => process.env[key]);
+    const envSource = options.envSource ?? process.env;
+    const { logger } = options;
+    const config = getAcpAgentConfig(agentId);
+    if (!config)
+        return null;
+    const prefix = config.envVarPrefix;
+    // Build command (allow override via env)
+    const command = getEnv(`${prefix}_PATH`) || config.command;
+    // Build args (allow override via env)
+    const args = parseAcpArgs(getEnv(`${prefix}_ARGS`), config.args, logger);
+    // Build cwd (allow override via env, default to current working directory)
+    const cwd = path.resolve(getEnv(`${prefix}_CWD`) || process.cwd());
+    // Build environment variables
+    const env = {};
+    // Add the agent's declared credentials: first source that has a value wins
+    // (an agent registered without credentialEnv inherits the built-in agent's with the same id)
+    const credentialEnv = config.credentialEnv ?? DEFAULT_ACP_AGENTS[agentId]?.credentialEnv ?? [];
+    for (const { target, sources } of credentialEnv) {
+        const value = sources.map((source) => getEnv(source)).find(Boolean);
+        if (value)
+            env[target] = value;
+    }
+    // Add custom env vars from ACP_<AGENT>_ENV_* pattern
+    const envPrefix = `${prefix}_ENV_`;
+    for (const [key, value] of Object.entries(envSource)) {
+        if (key.startsWith(envPrefix) && value !== undefined) {
+            const envKey = key.slice(envPrefix.length);
+            env[envKey] = value;
+        }
+    }
+    // Parse MCP servers configuration (validated and converted to the ACP schema shape)
+    const mcpServers = [];
+    const mcpConfigJson = getEnv(`${prefix}_MCP_SERVERS`);
+    if (mcpConfigJson) {
+        try {
+            const parsed = JSON.parse(mcpConfigJson);
+            if (Array.isArray(parsed)) {
+                for (const entry of parsed) {
+                    const server = normalizeMcpServer(entry);
+                    if (server)
+                        mcpServers.push(server);
+                    else
+                        logger?.warn?.(`[ACP] Ignoring invalid MCP server entry for ${agentId}`);
+                }
+            }
+        }
+        catch {
+            logger?.warn?.(`[ACP] Invalid MCP servers JSON for ${agentId}`);
+        }
+    }
+    // Add the project's MCP server if enabled and an explicit path was given
+    if (getEnv(`${prefix}_ENABLE_PROJECT_MCP`) === 'true') {
+        const projectPath = getEnv(`${prefix}_PROJECT_MCP_PATH`) || options.projectMcpPath;
+        if (projectPath) {
+            const server = buildProjectMcpServer({ path: projectPath }, logger);
+            if (server)
+                mcpServers.push(server);
+        }
+        else {
+            logger?.warn?.(`[ACP] ${prefix}_ENABLE_PROJECT_MCP is set but ${prefix}_PROJECT_MCP_PATH is not; skipping project MCP.`);
+        }
+    }
+    return {
+        command,
+        args,
+        cwd,
+        env,
+        mcpServers,
+        authMethodId: config.authMethodId,
+    };
+}
+/**
+ * Create provider entry for models.dev registry.
+ */
+export function createAcpProviderEntry(agentId) {
+    const config = getAcpAgentConfig(agentId);
+    if (!config)
+        return null;
+    const prefix = config.envVarPrefix;
+    return {
+        id: `acp-${agentId}`,
+        name: config.name,
+        env: [
+            `${prefix}_PATH`,
+            `${prefix}_CWD`,
+            `${prefix}_ARGS`,
+            `${prefix}_MCP_SERVERS`,
+            `${prefix}_ENABLE_PROJECT_MCP`,
+            `${prefix}_PROJECT_MCP_PATH`,
+        ],
+        npm: '@mcpc-tech/acp-ai-provider',
+        protocol: 'acp',
+        models: {
+            [agentId]: {
+                id: agentId,
+                name: `${config.name} Agent`,
+            },
+        },
+    };
+}
+/**
+ * Get all ACP provider entries for models catalog.
+ */
+export function getAllAcpProviderEntries() {
+    return listAcpAgentIds()
+        .map((id) => createAcpProviderEntry(id))
+        .filter((entry) => entry !== null);
+}
+/**
+ * Environment variable keys used across ACP agents.
+ */
+export function getAcpEnvVarKeys() {
+    const agents = {};
+    for (const [id, config] of Object.entries(ACP_AGENTS)) {
+        const p = config.envVarPrefix;
+        agents[id] = {
+            path: `${p}_PATH`,
+            cwd: `${p}_CWD`,
+            args: `${p}_ARGS`,
+            mcpServers: `${p}_MCP_SERVERS`,
+            enableProjectMcp: `${p}_ENABLE_PROJECT_MCP`,
+        };
+    }
+    return {
+        apiKeys: [
+            'ANTHROPIC_API_KEY',
+            'GEMINI_API_KEY',
+            'OPENAI_API_KEY',
+            'DASHSCOPE_API_KEY',
+            'OPENCODE_API_KEY',
+            'FREEBUFF_API_KEY',
+        ],
+        agents,
+    };
+}
+//# sourceMappingURL=acp_agents.js.map

package/dist/src/acp/acp_agents.js.map

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

package/dist/src/acp/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './acp_agents.js';
+export * from './provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/acp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/acp/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA"}

package/dist/src/acp/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './acp_agents.js';
+export * from './provider.js';
+//# sourceMappingURL=index.js.map

package/dist/src/acp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/acp/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA"}

package/dist/src/acp/provider.d.ts

@@ -0,0 +1,74 @@
+import type { LanguageModel } from 'ai';
+import type { ConfirmationService } from '../guard/confirmation.js';
+import type { AiDriver } from '../types.js';
+import type { Logger } from '../logger.js';
+import type { AcpAgentRuntimeConfig, AcpProviderConfig } from './types.js';
+/**
+ * Builds the environment for the agent process.
+ *
+ * `@mcpc-tech/acp-ai-provider` spawns the agent with `{ ...process.env, ...env }`, so the server's
+ * secrets cannot be left out by omission. Instead every variable that is not allowlisted is
+ * explicitly blanked, and only the allowlist plus `extra` (agent credentials, configured env)
+ * keep real values.
+ */
+export declare function buildAgentEnv(source: Record<string, string | undefined>, extra: Record<string, string>, inheritEnv?: boolean): Record<string, string>;
+export interface AcpDriverDeps {
+    logger?: Logger;
+    /** Answers agent permission requests when `permissionPolicy` is `ask`. */
+    confirmation?: ConfirmationService;
+    /**
+     * Environment whose allowlisted variables the agent keeps. Default: `process.env`. Variables that
+     * exist only in `process.env` are blanked as well, because the agent is spawned with
+     * `{ ...process.env, ...env }`.
+     */
+    env?: Record<string, string | undefined>;
+    /**
+     * Prebuilt runtime config (e.g. from `buildAcpRuntimeConfig`). Used verbatim, except that `cwd`
+     * must be absolute and the agent environment is rebuilt from `env` plus the runtime's own env.
+     */
+    runtime?: AcpAgentRuntimeConfig;
+}
+export declare class AcpDriver implements AiDriver {
+    readonly name: string;
+    readonly defaultModel: string;
+    private config;
+    private logger?;
+    private confirmation?;
+    private env;
+    private runtime?;
+    private cachedModels;
+    private providers;
+    private permissionPolicy;
+    constructor(name: string, config: AcpProviderConfig, deps?: AcpDriverDeps);
+    /**
+     * Lazily loads and instantiates an AI SDK language model backed by the ACP agent.
+     * `modelName` selects among the built-in agents; it is never executed as a command.
+     */
+    getModel(modelName?: string): Promise<LanguageModel>;
+    /**
+     * Tests whether the ACP agent can be resolved and its model instantiated.
+     */
+    ping(): Promise<{
+        ok: boolean;
+        latencyMs: number;
+        error?: string;
+    }>;
+    /**
+     * Terminates every agent process started by this driver.
+     */
+    shutdown(): Promise<void>;
+    private resolveRuntimeConfig;
+    private createModel;
+    /**
+     * The ACP provider auto-selects the first permission option when no handler is set, and offers
+     * no public API to set one. The handler is installed on the model's client right after every
+     * connection is established. If it cannot be installed the model refuses to connect (fail-closed).
+     */
+    private installPermissionHandler;
+    private answerPermission;
+}
+/**
+ * Factory for creating an AcpDriver instance.
+ */
+export declare function createAcpDriver(name: string, config: AcpProviderConfig, deps?: AcpDriverDeps): AcpDriver;
+//# sourceMappingURL=provider.d.ts.map

package/dist/src/acp/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/acp/provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAA;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EACV,qBAAqB,EAGrB,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAiEnB;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,UAAU,UAAQ,GACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0EAA0E;IAC1E,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,qBAAqB,CAAA;CAChC;AAED,qBAAa,SAAU,YAAW,QAAQ;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,YAAY,CAAC,CAAqB;IAC1C,OAAO,CAAC,GAAG,CAAoC;IAC/C,OAAO,CAAC,OAAO,CAAC,CAAuB;IACvC,OAAO,CAAC,YAAY,CAAiD;IACrE,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,gBAAgB,CAAqB;gBAEjC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,GAAE,aAAkB;IAiB7E;;;OAGG;IACG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAe1D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAgBzE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAa/B,OAAO,CAAC,oBAAoB;YAsEd,WAAW;IAiCzB;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;YAiBlB,gBAAgB;CA8C/B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,iBAAiB,EACzB,IAAI,GAAE,aAAkB,GACvB,SAAS,CAEX"}