adonis-ai-kit 0.0.0-stage → 1.1.0

package/dist/providers/ai_provider.d.ts

@@ -0,0 +1,23 @@
+import { type ApplicationService } from '@adonisjs/core/types';
+import type { AiManager } from '../src/ai_manager.js';
+declare module '@adonisjs/core/types' {
+    interface ContainerBindings {
+        ai: AiManager;
+    }
+}
+/**
+ * AdonisJS 7 Service Provider for the AI subsystem.
+ * Registers 'ai' singleton in container and installs HTTP response macros.
+ */
+export default class AiProvider {
+    protected app: ApplicationService;
+    private manager?;
+    constructor(app: ApplicationService);
+    register(): void;
+    boot(): Promise<void>;
+    /**
+     * Stops ACP agent processes and settles pending confirmations on application shutdown.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=ai_provider.d.ts.map

package/dist/providers/ai_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai_provider.d.ts","sourceRoot":"","sources":["../../providers/ai_provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAiB,iBAAiB;QAChC,EAAE,EAAE,SAAS,CAAA;KACd;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAGjB,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAF7C,OAAO,CAAC,OAAO,CAAC,CAAW;gBAEL,GAAG,EAAE,kBAAkB;IAE7C,QAAQ;IAaF,IAAI;IAKV;;OAEG;IACG,QAAQ;CAGf"}

package/dist/providers/ai_provider.js

@@ -0,0 +1,34 @@
+/**
+ * AdonisJS 7 Service Provider for the AI subsystem.
+ * Registers 'ai' singleton in container and installs HTTP response macros.
+ */
+export default class AiProvider {
+    app;
+    manager;
+    constructor(app) {
+        this.app = app;
+    }
+    register() {
+        this.app.container.singleton('ai', async () => {
+            const { AiManager } = await import('../src/ai_manager.js');
+            const config = this.app.config.get('ai', {
+                default: 'openai',
+                providers: {},
+            });
+            const logger = await this.app.container.make('logger');
+            this.manager = new AiManager(config, logger);
+            return this.manager;
+        });
+    }
+    async boot() {
+        const { registerResponseMacro } = await import('../src/response_macro.js');
+        registerResponseMacro();
+    }
+    /**
+     * Stops ACP agent processes and settles pending confirmations on application shutdown.
+     */
+    async shutdown() {
+        await this.manager?.shutdown();
+    }
+}
+//# sourceMappingURL=ai_provider.js.map

package/dist/providers/ai_provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai_provider.js","sourceRoot":"","sources":["../../providers/ai_provider.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAGP;IAFd,OAAO,CAAY;IAE3B,YAAsB,GAAuB;QAAvB,QAAG,GAAH,GAAG,CAAoB;IAAG,CAAC;IAEjD,QAAQ;QACN,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YAC5C,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAA;YAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAW,IAAI,EAAE;gBACjD,OAAO,EAAE,QAAQ;gBACjB,SAAS,EAAE,EAAE;aACd,CAAC,CAAA;YACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACtD,IAAI,CAAC,OAAO,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YAC5C,OAAO,IAAI,CAAC,OAAO,CAAA;QACrB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAA;QAC1E,qBAAqB,EAAE,CAAA;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAA;IAChC,CAAC;CACF"}

package/dist/services/main.d.ts

@@ -0,0 +1,4 @@
+import type { AiManager } from '../src/ai_manager.js';
+declare let ai: AiManager;
+export { ai as default };
+//# sourceMappingURL=main.d.ts.map

package/dist/services/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../services/main.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAErD,QAAA,IAAI,EAAE,EAAE,SAAS,CAAA;AAKjB,OAAO,EAAE,EAAE,IAAI,OAAO,EAAE,CAAA"}

package/dist/services/main.js

@@ -0,0 +1,7 @@
+import app from '@adonisjs/core/services/app';
+let ai;
+await app.booted(async () => {
+    ai = await app.container.make('ai');
+});
+export { ai as default };
+//# sourceMappingURL=main.js.map

package/dist/services/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../services/main.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,6BAA6B,CAAA;AAG7C,IAAI,EAAa,CAAA;AACjB,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;IAC1B,EAAE,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACrC,CAAC,CAAC,CAAA;AAEF,OAAO,EAAE,EAAE,IAAI,OAAO,EAAE,CAAA"}

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

@@ -0,0 +1,75 @@
+import type { LoggerContract } from '../ai_manager.js';
+import type { AcpAgentConfig, AcpAgentRuntimeConfig, AcpMcpServerConfig, AcpProjectMcpConfig } from './types.js';
+/**
+ * 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.
+ */
+export declare const ACP_AGENTS: Record<string, AcpAgentConfig>;
+/**
+ * Get ACP agent configuration by ID.
+ */
+export declare function getAcpAgentConfig(agentId: string): AcpAgentConfig | undefined;
+/**
+ * List all available ACP agent IDs.
+ */
+export declare function listAcpAgentIds(): string[];
+/**
+ * Check if an agent ID is a valid ACP agent.
+ */
+export declare function isAcpAgent(agentId: string): boolean;
+/**
+ * Parse agent arguments from env string.
+ * Supports JSON arrays (e.g., '["--flag","--opt","val"]')
+ * and falls back to comma-separated values.
+ */
+export declare function parseAcpArgs(argsOverride: string | undefined, fallback: string[], logger?: LoggerContract): string[];
+/**
+ * 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 declare function normalizeMcpServer(input: unknown): AcpMcpServerConfig | null;
+/** Builds the stdio MCP server entry for a project-local MCP server file. */
+export declare function buildProjectMcpServer(config: AcpProjectMcpConfig, logger?: LoggerContract): AcpMcpServerConfig | null;
+/**
+ * Build runtime configuration for an ACP agent.
+ */
+export declare function buildAcpRuntimeConfig(agentId: string, getEnv?: (key: string) => string | undefined, envSource?: Record<string, string | undefined>, logger?: LoggerContract): AcpAgentRuntimeConfig | null;
+/**
+ * Create provider entry for models.dev registry.
+ */
+export declare function createAcpProviderEntry(agentId: string): {
+    id: string;
+    name: string;
+    env: string[];
+    npm: string;
+    protocol: string;
+    models: Record<string, {
+        id: string;
+        name: string;
+    }>;
+} | null;
+/**
+ * Get all ACP provider entries for models catalog.
+ */
+export declare function getAllAcpProviderEntries(): ReturnType<typeof createAcpProviderEntry>[];
+/**
+ * Environment variable keys used across ACP agents.
+ */
+export declare function getAcpEnvVarKeys(): {
+    apiKeys: string[];
+    agents: Record<string, {
+        path: string;
+        cwd: string;
+        args: string;
+        mcpServers: string;
+        enableProjectMcp: string;
+    }>;
+};
+//# sourceMappingURL=acp_agents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acp_agents.d.ts","sourceRoot":"","sources":["../../../src/acp/acp_agents.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAElB,mBAAmB,EACpB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAiEpD,CAAA;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE7E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,CAAC,EAAE,cAAc,GACtB,MAAM,EAAE,CAiBV;AAoBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAwB5E;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,CAAC,EAAE,cAAc,GACtB,kBAAkB,GAAG,IAAI,CAY3B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAqC,EACvE,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EAC3D,MAAM,CAAC,EAAE,cAAc,GACtB,qBAAqB,GAAG,IAAI,CA0F9B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG;IACvD,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACrD,GAAG,IAAI,CA0BP;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,UAAU,CAAC,OAAO,sBAAsB,CAAC,EAAE,CAItF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,MAAM,CACZ,MAAM,EACN;QACE,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,UAAU,EAAE,MAAM,CAAA;QAClB,gBAAgB,EAAE,MAAM,CAAA;KACzB,CACF,CAAA;CACF,CA4BA"}

package/dist/src/acp/acp_agents.js

@@ -0,0 +1,343 @@
+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.
+ */
+export const 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,
+    },
+    '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',
+    },
+    'codex': {
+        id: 'codex',
+        name: 'Codex CLI',
+        description: "OpenAI's Codex CLI agent",
+        command: 'codex-acp',
+        args: [],
+        envVarPrefix: 'ACP_CODEX',
+        supportsMcpServers: true,
+    },
+    '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,
+    },
+    '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,
+    },
+    'freebuff': {
+        id: 'freebuff',
+        name: 'Freebuff',
+        description: 'Freebuff AI coding agent',
+        command: 'codebuff-agent-acp',
+        args: [],
+        envVarPrefix: 'ACP_FREEBUFF',
+        supportsMcpServers: true,
+    },
+});
+/**
+ * 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: [],
+    };
+}
+/**
+ * Build runtime configuration for an ACP agent.
+ */
+export function buildAcpRuntimeConfig(agentId, getEnv = (key) => process.env[key], envSource = process.env, logger) {
+    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 auth-related env vars based on agent type
+    if (agentId === 'gemini') {
+        const apiKey = getEnv('GEMINI_API_KEY') || getEnv('GOOGLE_API_KEY');
+        if (apiKey)
+            env.GEMINI_API_KEY = apiKey;
+    }
+    else if (agentId === 'claude-code') {
+        const apiKey = getEnv('ANTHROPIC_API_KEY');
+        if (apiKey)
+            env.ANTHROPIC_API_KEY = apiKey;
+    }
+    else if (agentId === 'codex') {
+        const apiKey = getEnv('OPENAI_API_KEY');
+        if (apiKey)
+            env.OPENAI_API_KEY = apiKey;
+    }
+    else if (agentId === 'qwen-code') {
+        const apiKey = getEnv('DASHSCOPE_API_KEY') || getEnv('QWEN_API_KEY');
+        if (apiKey)
+            env.DASHSCOPE_API_KEY = apiKey;
+    }
+    else if (agentId === 'opencode') {
+        const apiKey = getEnv('OPENCODE_API_KEY');
+        if (apiKey)
+            env.OPENCODE_API_KEY = apiKey;
+    }
+    else if (agentId === 'freebuff') {
+        const apiKey = getEnv('CODEBUFF_API_KEY') || getEnv('FREEBUFF_API_KEY');
+        if (apiKey) {
+            env.CODEBUFF_API_KEY = apiKey;
+            env.FREEBUFF_API_KEY = apiKey;
+        }
+    }
+    // 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`);
+        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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,IAAI,MAAM,WAAW,CAAA;AAU5B;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAmC,MAAM,CAAC,MAAM,CAAC;IACtE,aAAa,EAAE;QACb,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,qCAAqC;QAClD,OAAO,EAAE,kBAAkB;QAC3B,IAAI,EAAE,EAAE;QACR,YAAY,EAAE,iBAAiB;QAC/B,kBAAkB,EAAE,IAAI;KACzB;IACD,QAAQ,EAAE;QACR,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,2BAA2B;QACxC,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,CAAC,OAAO,CAAC;QACf,YAAY,EAAE,YAAY;QAC1B,kBAAkB,EAAE,IAAI;QACxB,YAAY,EAAE,gBAAgB;KAC/B;IACD,OAAO,EAAE;QACP,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,0BAA0B;QACvC,OAAO,EAAE,WAAW;QACpB,IAAI,EAAE,EAAE;QACR,YAAY,EAAE,WAAW;QACzB,kBAAkB,EAAE,IAAI;KACzB;IACD,WAAW,EAAE;QACX,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,+BAA+B;QAC5C,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,OAAO,CAAC;QACf,YAAY,EAAE,eAAe;QAC7B,kBAAkB,EAAE,IAAI;KACzB;IACD,aAAa,EAAE;QACb,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC;QAC3B,YAAY,EAAE,iBAAiB;QAC/B,kBAAkB,EAAE,IAAI;KACzB;IACD,UAAU,EAAE;QACV,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,8BAA8B;QAC3C,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,CAAC,KAAK,CAAC;QACb,YAAY,EAAE,cAAc;QAC5B,kBAAkB,EAAE,IAAI;KACzB;IACD,UAAU,EAAE;QACV,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,0BAA0B;QACvC,OAAO,EAAE,oBAAoB;QAC7B,IAAI,EAAE,EAAE;QACR,YAAY,EAAE,cAAc;QAC5B,kBAAkB,EAAE,IAAI;KACzB;CACF,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,UAAU,CAAC,OAAO,CAAC,CAAA;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,OAAO,IAAI,UAAU,CAAA;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,YAAgC,EAChC,QAAkB,EAClB,MAAuB;IAEvB,IAAI,CAAC,YAAY;QAAE,OAAO,QAAQ,CAAA;IAClC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,CAAA;IACnC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YAClC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAC9E,OAAO,MAAM,CAAA;YACf,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,EAAE,IAAI,EAAE,CAAC,8CAA8C,OAAO,EAAE,CAAC,CAAA;QACzE,CAAC;IACH,CAAC;IACD,OAAO,OAAO;SACX,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAA;AACpB,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,CACjB,CAAC,IAAI,EAAwB,EAAE,CAC7B,IAAI,KAAK,IAAI;YACb,OAAO,IAAI,KAAK,QAAQ;YACxB,OAAQ,IAAqB,CAAC,IAAI,KAAK,QAAQ;YAC/C,OAAQ,IAAqB,CAAC,KAAK,KAAK,QAAQ,CACnD,CAAA;IACH,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;aACpD,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;aAChD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAe,EAAE,CAAC,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC5D,MAAM,GAAG,GAAG,KAAgC,CAAA;IAC5C,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEtE,MAAM,GAAG,GACP,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IACnG,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACjG,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAA;QACrB,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM;YACzC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,GAAG;YACH,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC;SACtC,CAAA;IACH,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAC5E,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;QAC/F,GAAG,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;KAC9B,CAAA;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,qBAAqB,CACnC,MAA2B,EAC3B,MAAuB;IAEvB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC5C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,EAAE,IAAI,EAAE,CAAC,uCAAuC,UAAU,yBAAyB,CAAC,CAAA;QAC1F,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,eAAe;QACpC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,MAAM;QACjC,IAAI,EAAE,CAAC,UAAU,CAAC;QAClB,GAAG,EAAE,EAAE;KACR,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,SAA8C,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EACvE,YAAgD,OAAO,CAAC,GAAG,EAC3D,MAAuB;IAEvB,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAExB,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAA;IAElC,yCAAyC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAA;IAE1D,sCAAsC;IACtC,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAExE,2EAA2E;IAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IAElE,8BAA8B;IAC9B,MAAM,GAAG,GAA2B,EAAE,CAAA;IAEtC,gDAAgD;IAChD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,IAAI,MAAM,CAAC,gBAAgB,CAAC,CAAA;QACnE,IAAI,MAAM;YAAE,GAAG,CAAC,cAAc,GAAG,MAAM,CAAA;IACzC,CAAC;SAAM,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAA;QAC1C,IAAI,MAAM;YAAE,GAAG,CAAC,iBAAiB,GAAG,MAAM,CAAA;IAC5C,CAAC;SAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAA;QACvC,IAAI,MAAM;YAAE,GAAG,CAAC,cAAc,GAAG,MAAM,CAAA;IACzC,CAAC;SAAM,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,CAAA;QACpE,IAAI,MAAM;YAAE,GAAG,CAAC,iBAAiB,GAAG,MAAM,CAAA;IAC5C,CAAC;SAAM,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAA;QACzC,IAAI,MAAM;YAAE,GAAG,CAAC,gBAAgB,GAAG,MAAM,CAAA;IAC3C,CAAC;SAAM,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,kBAAkB,CAAC,IAAI,MAAM,CAAC,kBAAkB,CAAC,CAAA;QACvE,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,CAAC,gBAAgB,GAAG,MAAM,CAAA;YAC7B,GAAG,CAAC,gBAAgB,GAAG,MAAM,CAAA;QAC/B,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,MAAM,SAAS,GAAG,GAAG,MAAM,OAAO,CAAA;IAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACrD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;YAC1C,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,CAAA;QACrB,CAAC;IACH,CAAC;IAED,oFAAoF;IACpF,MAAM,UAAU,GAAyB,EAAE,CAAA;IAC3C,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,MAAM,cAAc,CAAC,CAAA;IACrD,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;YACxC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBAC3B,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;oBACxC,IAAI,MAAM;wBAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;;wBAC9B,MAAM,EAAE,IAAI,EAAE,CAAC,+CAA+C,OAAO,EAAE,CAAC,CAAA;gBAC/E,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,EAAE,IAAI,EAAE,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAA;QACjE,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,IAAI,MAAM,CAAC,GAAG,MAAM,qBAAqB,CAAC,KAAK,MAAM,EAAE,CAAC;QACtD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,MAAM,mBAAmB,CAAC,CAAA;QACxD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,qBAAqB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,MAAM,CAAC,CAAA;YACnE,IAAI,MAAM;gBAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACrC,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,IAAI,EAAE,CACZ,SAAS,MAAM,kCAAkC,MAAM,iDAAiD,CACzG,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO;QACP,IAAI;QACJ,GAAG;QACH,GAAG;QACH,UAAU;QACV,YAAY,EAAE,MAAM,CAAC,YAAY;KAClC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IAQpD,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAExB,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAA;IAElC,OAAO;QACL,EAAE,EAAE,OAAO,OAAO,EAAE;QACpB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,EAAE;YACH,GAAG,MAAM,OAAO;YAChB,GAAG,MAAM,MAAM;YACf,GAAG,MAAM,OAAO;YAChB,GAAG,MAAM,cAAc;YACvB,GAAG,MAAM,qBAAqB;YAC9B,GAAG,MAAM,mBAAmB;SAC7B;QACD,GAAG,EAAE,4BAA4B;QACjC,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE;YACN,CAAC,OAAO,CAAC,EAAE;gBACT,EAAE,EAAE,OAAO;gBACX,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,QAAQ;aAC7B;SACF;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,eAAe,EAAE;SACrB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;SACvC,MAAM,CAAC,CAAC,KAAK,EAAsC,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAA;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAa9B,MAAM,MAAM,GAGR,EAAE,CAAA;IAEN,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,CAAA;QAC7B,MAAM,CAAC,EAAE,CAAC,GAAG;YACX,IAAI,EAAE,GAAG,CAAC,OAAO;YACjB,GAAG,EAAE,GAAG,CAAC,MAAM;YACf,IAAI,EAAE,GAAG,CAAC,OAAO;YACjB,UAAU,EAAE,GAAG,CAAC,cAAc;YAC9B,gBAAgB,EAAE,GAAG,CAAC,qBAAqB;SAC5C,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,mBAAmB;YACnB,gBAAgB;YAChB,gBAAgB;YAChB,mBAAmB;YACnB,kBAAkB;YAClB,kBAAkB;SACnB;QACD,MAAM;KACP,CAAA;AACH,CAAC"}

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,64 @@
+import type { LanguageModel } from 'ai';
+import type { ConfirmationService } from '../guard/confirmation.js';
+import type { AiDriver } from '../types.js';
+import type { LoggerContract } from '../ai_manager.js';
+import type { 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?: LoggerContract;
+    /** Answers agent permission requests when `permissionPolicy` is `ask`. */
+    confirmation?: ConfirmationService;
+    /** Environment to derive the agent environment from. Default: `process.env` */
+    env?: Record<string, string | undefined>;
+}
+export declare class AcpDriver implements AiDriver {
+    readonly name: string;
+    readonly defaultModel: string;
+    private config;
+    private logger?;
+    private confirmation?;
+    private env;
+    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,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAIV,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,CAUxB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CACzC;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,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAC,CAAqB;IAC1C,OAAO,CAAC,GAAG,CAAoC;IAC/C,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;IAgB7E;;;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;YAyDd,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"}