mcacp 0.1.0

package/dist/types/tools.js

@@ -0,0 +1,441 @@
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Shared / helper schemas
+// ---------------------------------------------------------------------------
+/**
+ * Configuration for an MCP server that can be forwarded to a sub-agent.
+ *
+ * Two variants:
+ *  - stdio: launch a local process (command + optional args / env)
+ *  - http:  connect to a remote server over HTTP/SSE (url + optional headers)
+ */
+export const McpServerConfigSchema = z.union([
+    z.object({
+        name: z.string().describe('Unique display name for this MCP server.'),
+        command: z.string().describe('Executable to launch (stdio transport).'),
+        args: z.array(z.string()).optional().describe('Command-line arguments.'),
+        env: z
+            .array(z.object({ name: z.string(), value: z.string() }))
+            .optional()
+            .describe('Extra environment variables passed to the process.'),
+    }),
+    z.object({
+        type: z.literal('http'),
+        name: z.string().describe('Unique display name for this MCP server.'),
+        url: z.string().url().describe('Base URL of the HTTP/SSE MCP server.'),
+        headers: z
+            .array(z.object({ name: z.string(), value: z.string() }))
+            .optional()
+            .describe('Extra HTTP headers sent with every request.'),
+    }),
+]);
+/**
+ * A single content block inside a structured prompt.
+ *
+ * - text:          plain or markdown text
+ * - resource_link: reference to an external resource by URI
+ */
+export const ContentBlockInputSchema = z.union([
+    z.object({
+        type: z.literal('text'),
+        text: z.string().describe('The text content of this block.'),
+    }),
+    z.object({
+        type: z.literal('resource_link'),
+        uri: z.string().describe('URI pointing to the linked resource.'),
+        mimeType: z.string().optional().describe('MIME type of the resource (e.g. "text/plain").'),
+    }),
+]);
+/**
+ * Client capability flags passed during initialize.
+ */
+export const ClientCapabilitiesSchema = z
+    .object({
+    fs: z
+        .object({
+        readTextFile: z
+            .boolean()
+            .optional()
+            .describe('Client can read text files on behalf of the agent.'),
+        writeTextFile: z
+            .boolean()
+            .optional()
+            .describe('Client can write text files on behalf of the agent.'),
+    })
+        .optional()
+        .describe('Filesystem capabilities offered by the client.'),
+    terminal: z
+        .boolean()
+        .optional()
+        .describe('Client can execute terminal commands on behalf of the agent.'),
+})
+    .optional();
+/**
+ * Client identification passed during initialize.
+ */
+export const ClientInfoSchema = z.object({
+    name: z.string().describe('Machine-readable name of the client application.'),
+    version: z.string().describe('Semantic version of the client application.'),
+    title: z
+        .string()
+        .optional()
+        .describe('Human-readable display title of the client.'),
+});
+// ---------------------------------------------------------------------------
+// Input schemas - one per tool
+// ---------------------------------------------------------------------------
+// ---- Registry tools -------------------------------------------------------
+export const ListInstalledAgentsInputSchema = z
+    .object({})
+    .describe('No parameters required.');
+export const RegistrySearchInputSchema = z.object({
+    query: z
+        .string()
+        .optional()
+        .describe('Free-text search query. When omitted all available agents are returned.'),
+    showIncompatible: z
+        .boolean()
+        .default(false)
+        .describe('When true, results include agents that are not compatible with the current MCACP version. Defaults to false.'),
+});
+export const AgentInstallInputSchema = z.object({
+    agentId: z
+        .string()
+        .describe('Fully-qualified agent identifier (e.g. "vendor/agent-name").'),
+    version: z
+        .string()
+        .optional()
+        .describe('Specific version to install. When omitted the latest compatible version is used.'),
+});
+export const AgentUninstallInputSchema = z.object({
+    agentId: z
+        .string()
+        .describe('Identifier of the installed agent to remove.'),
+});
+export const AgentCheckUpgradesInputSchema = z
+    .object({})
+    .describe('No parameters required.');
+// ---- Lifecycle tools ------------------------------------------------------
+export const InitializeInputSchema = z.object({
+    agentId: z
+        .string()
+        .describe('Identifier of the installed agent to initialize.'),
+    protocolVersion: z
+        .number()
+        .int()
+        .optional()
+        .describe('ACP protocol version to negotiate. When omitted the latest supported version is used.'),
+    clientInfo: ClientInfoSchema.optional().describe('Information about the calling client. Forwarded to the agent during the ACP handshake.'),
+    clientCapabilities: ClientCapabilitiesSchema.describe('Capability flags describing what the client environment can do on behalf of the agent.'),
+});
+export const ShutdownInputSchema = z.object({
+    agentId: z
+        .string()
+        .describe('Identifier of the running agent to shut down.'),
+});
+// ---- Session tools --------------------------------------------------------
+export const NewSessionInputSchema = z.object({
+    agentId: z
+        .string()
+        .describe('Identifier of the running agent that will own this session.'),
+    cwd: z
+        .string()
+        .describe('Absolute path to the working directory for the session.'),
+    mcpServers: z
+        .array(McpServerConfigSchema)
+        .optional()
+        .describe('MCP servers to make available inside this session.'),
+    permissionPolicy: z
+        .enum(['elicit', 'allow_all', 'deny_all', 'operator'])
+        .optional()
+        .describe('How permission requests from the agent are handled. ' +
+        '"elicit" prompts the user interactively; ' +
+        '"allow_all" auto-approves every request; ' +
+        '"deny_all" auto-denies every request; ' +
+        '"operator" returns permission requests as updates for programmatic handling via grant_permission.'),
+});
+export const LoadSessionInputSchema = z.object({
+    agentId: z
+        .string()
+        .describe('Identifier of the running agent that owns the session.'),
+    sessionId: z
+        .string()
+        .describe('Unique identifier of the previously-created session to reload.'),
+    cwd: z
+        .string()
+        .describe('Absolute path to the working directory for the resumed session.'),
+    mcpServers: z
+        .array(McpServerConfigSchema)
+        .optional()
+        .describe('MCP servers to make available inside the reloaded session.'),
+});
+export const ListSessionsInputSchema = z.object({
+    agentId: z
+        .string()
+        .describe('Agent ID to list sessions for.'),
+});
+export const CloseSessionInputSchema = z.object({
+    sessionId: z
+        .string()
+        .describe('Identifier of the active session to close. The session file is preserved for later reloading.'),
+});
+// ---- Interaction tools ----------------------------------------------------
+export const PromptInputSchema = z.object({
+    sessionId: z
+        .string()
+        .describe('Identifier of the active session to send the prompt to.'),
+    prompt: z
+        .union([z.string(), z.array(ContentBlockInputSchema)])
+        .describe('The user prompt. Supply a plain string for simple text (it will be wrapped in a text content block automatically), ' +
+        'or an array of ContentBlockInput objects for structured multi-block prompts.'),
+});
+export const GrantPermissionInputSchema = z.object({
+    sessionId: z
+        .string()
+        .describe('Identifier of the session that raised the permission request.'),
+    toolCallId: z
+        .string()
+        .describe('The tool_call_id from the permission-request update that this response addresses.'),
+    optionId: z
+        .string()
+        .describe('The chosen option identifier (e.g. "allow", "deny", "allow_always") as listed in the permission request.'),
+});
+export const CancelInputSchema = z.object({
+    sessionId: z
+        .string()
+        .describe('Identifier of the session whose in-progress prompt should be cancelled.'),
+});
+export const SetModeInputSchema = z.object({
+    sessionId: z
+        .string()
+        .describe('Identifier of the active session.'),
+    modeId: z
+        .string()
+        .describe('Identifier of the operating mode to switch to (agent-defined).'),
+});
+export const EventsInputSchema = z.object({
+    timeoutMs: z
+        .number()
+        .optional()
+        .describe('Maximum time in milliseconds to wait for events. When omitted the call blocks indefinitely ' +
+        'until at least one event arrives. If the timeout expires before any events arrive, an empty ' +
+        'array is returned.'),
+    nagleMs: z
+        .number()
+        .optional()
+        .describe('Coalescing window in milliseconds. When set, incoming events are batched: the call waits until ' +
+        'no new events arrive for this duration before returning the batch. Default: 0 (return immediately ' +
+        'on first event).'),
+});
+// ---- Status / monitoring tools --------------------------------------------
+export const ListRunningAgentsInputSchema = z
+    .object({})
+    .describe('No parameters required.');
+export const GetAgentStatusInputSchema = z.object({
+    agentId: z
+        .string()
+        .describe('Identifier of the running agent to query.'),
+});
+export const SetAgentStatusInputSchema = z.object({
+    agentId: z
+        .string()
+        .describe('Identifier of the running agent whose status should be updated.'),
+    status: z
+        .string()
+        .describe('Operator-defined status text to display for this agent (e.g. "idle", "working on X").'),
+});
+// ---------------------------------------------------------------------------
+// Tool definitions
+// ---------------------------------------------------------------------------
+// ---- Registry tools -------------------------------------------------------
+export const listInstalledAgents = {
+    name: 'list_installed_agents',
+    description: 'List all locally installed ACP agents. Returns an array of objects, each containing the agent id, ' +
+        "human-readable name, installed version, and a short description of the agent's capabilities.",
+    inputSchema: ListInstalledAgentsInputSchema,
+};
+export const registrySearch = {
+    name: 'registry_search',
+    description: 'Search all configured registries for available ACP agents. Provide an optional free-text query to ' +
+        'filter results. By default only agents compatible with this MCACP version are shown; set ' +
+        'showIncompatible to true to include all.',
+    inputSchema: RegistrySearchInputSchema,
+};
+export const agentInstall = {
+    name: 'agent_install',
+    description: 'Download and install an ACP agent from a configured registry. Specify the agent identifier and ' +
+        'optionally pin a version. The agent is installed locally and becomes available for initialization.',
+    inputSchema: AgentInstallInputSchema,
+};
+export const agentUninstall = {
+    name: 'agent_uninstall',
+    description: 'Remove a locally installed ACP agent and all of its associated data. The agent must not be ' +
+        'currently running; shut it down first if necessary.',
+    inputSchema: AgentUninstallInputSchema,
+};
+export const agentCheckUpgrades = {
+    name: 'agent_check_upgrades',
+    description: 'Check every installed agent against its source registry and report any available version upgrades. ' +
+        'Returns a list of agents that have newer versions available along with current and latest version numbers.',
+    inputSchema: AgentCheckUpgradesInputSchema,
+};
+// ---- Lifecycle tools ------------------------------------------------------
+export const initialize = {
+    name: 'initialize',
+    description: 'Spawn the agent process and perform the ACP initialize handshake. This must be called before ' +
+        'creating sessions or sending prompts. Optionally pass client information and capability flags so ' +
+        'the agent knows what the host environment supports.',
+    inputSchema: InitializeInputSchema,
+};
+export const shutdown = {
+    name: 'shutdown',
+    description: 'Gracefully shut down a running agent process. All active sessions owned by the agent are closed ' +
+        'first. After shutdown the agent must be re-initialized before it can be used again.',
+    inputSchema: ShutdownInputSchema,
+};
+// ---- Session tools --------------------------------------------------------
+export const newSession = {
+    name: 'new_session',
+    description: 'Create a new ACP session on a running agent. A session provides an isolated conversation context ' +
+        'with its own working directory, MCP server set, and permission policy. Returns the new session identifier.',
+    inputSchema: NewSessionInputSchema,
+};
+export const loadSession = {
+    name: 'load_session',
+    description: 'Reload a previously created session from its persisted session file. The session resumes with its ' +
+        'prior conversation history. You may supply a different working directory or MCP server set for the ' +
+        'reloaded session.',
+    inputSchema: LoadSessionInputSchema,
+};
+export const listSessions = {
+    name: 'list_sessions',
+    description: 'List stored ACP sessions for a given agent. Returns session metadata ' +
+        'including session id, owning agent, creation time, and current status.',
+    inputSchema: ListSessionsInputSchema,
+};
+export const closeSession = {
+    name: 'close_session',
+    description: 'Close an active session. The session file is preserved on disk so the session can be reloaded later ' +
+        'with load_session. Any in-progress prompt is cancelled before closing.',
+    inputSchema: CloseSessionInputSchema,
+};
+// ---- Interaction tools ----------------------------------------------------
+export const prompt = {
+    name: 'prompt',
+    description: 'Send a user prompt to an active session and wait for the agent to finish responding. The prompt can ' +
+        'be a plain string (automatically wrapped in a text content block) or a structured array of content ' +
+        'blocks for multi-modal input. Returns an object with a stopReason string and an updates array ' +
+        'containing all agent output events produced during this turn.',
+    inputSchema: PromptInputSchema,
+};
+export const grantPermission = {
+    name: 'grant_permission',
+    description: 'Respond to a pending permission request from an agent session that uses the "operator" permission ' +
+        'policy. Supply the toolCallId from the permission-request update and the chosen optionId (e.g. ' +
+        '"allow", "deny", "allow_always"). The agent resumes execution with the granted (or denied) permission.',
+    inputSchema: GrantPermissionInputSchema,
+};
+export const cancel = {
+    name: 'cancel',
+    description: 'Cancel an in-progress prompt on an active session. The agent is sent a cancellation signal and any ' +
+        'partial results are discarded. The session remains open and ready for new prompts.',
+    inputSchema: CancelInputSchema,
+};
+export const setMode = {
+    name: 'set_mode',
+    description: "Switch the operating mode of an active session. Modes are agent-defined and control the agent's " +
+        'behavior profile (e.g. "plan" vs "execute", "code" vs "review"). The available mode identifiers ' +
+        'depend on the specific agent.',
+    inputSchema: SetModeInputSchema,
+};
+export const events = {
+    name: 'events',
+    description: 'Block until any prompted session produces events. Returns an array of events, each stamped with ' +
+        'the sessionId and agentId of the session that produced it. Supports optional Nagle-style ' +
+        'coalescing to batch events arriving across multiple sessions within a configurable time window.',
+    inputSchema: EventsInputSchema,
+};
+// ---- Status / monitoring tools --------------------------------------------
+export const listRunningAgents = {
+    name: 'list_running_agents',
+    description: "List all currently spawned (running) agent processes. Returns an array with each agent's " +
+        'identifier, process status, last heartbeat timestamp, and the identifiers of its active sessions.',
+    inputSchema: ListRunningAgentsInputSchema,
+};
+export const getAgentStatus = {
+    name: 'get_agent_status',
+    description: 'Retrieve detailed runtime status for a single running agent. Includes process health, uptime, ' +
+        'memory usage, and per-session activity information such as the current prompt state and turn count.',
+    inputSchema: GetAgentStatusInputSchema,
+};
+export const setAgentStatus = {
+    name: 'set_agent_status',
+    description: 'Set an operator-defined status string on a running agent. This status is surfaced in monitoring ' +
+        'views and can be used by the orchestrating agent to communicate high-level intent (e.g. "working ' +
+        'on task X", "waiting for review").',
+    inputSchema: SetAgentStatusInputSchema,
+};
+// ---------------------------------------------------------------------------
+// Aggregate exports
+// ---------------------------------------------------------------------------
+/**
+ * All MCACP tool definitions in a single array.
+ * Useful for bulk registration with an MCP server.
+ */
+export const ALL_TOOLS = [
+    // Registry
+    listInstalledAgents,
+    registrySearch,
+    agentInstall,
+    agentUninstall,
+    agentCheckUpgrades,
+    // Lifecycle
+    initialize,
+    shutdown,
+    // Session
+    newSession,
+    loadSession,
+    listSessions,
+    closeSession,
+    // Interaction
+    prompt,
+    events,
+    grantPermission,
+    cancel,
+    setMode,
+    // Status / monitoring
+    listRunningAgents,
+    getAgentStatus,
+    setAgentStatus,
+];
+/**
+ * Record mapping every tool name to its Zod input schema.
+ * Useful for runtime validation of incoming tool-call arguments.
+ */
+export const TOOL_SCHEMAS = {
+    // Registry
+    list_installed_agents: ListInstalledAgentsInputSchema,
+    registry_search: RegistrySearchInputSchema,
+    agent_install: AgentInstallInputSchema,
+    agent_uninstall: AgentUninstallInputSchema,
+    agent_check_upgrades: AgentCheckUpgradesInputSchema,
+    // Lifecycle
+    initialize: InitializeInputSchema,
+    shutdown: ShutdownInputSchema,
+    // Session
+    new_session: NewSessionInputSchema,
+    load_session: LoadSessionInputSchema,
+    list_sessions: ListSessionsInputSchema,
+    close_session: CloseSessionInputSchema,
+    // Interaction
+    prompt: PromptInputSchema,
+    events: EventsInputSchema,
+    grant_permission: GrantPermissionInputSchema,
+    cancel: CancelInputSchema,
+    set_mode: SetModeInputSchema,
+    // Status / monitoring
+    list_running_agents: ListRunningAgentsInputSchema,
+    get_agent_status: GetAgentStatusInputSchema,
+    set_agent_status: SetAgentStatusInputSchema,
+};
+//# sourceMappingURL=tools.js.map

package/dist/types/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC;IAC3C,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QACrE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACvE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACxE,GAAG,EAAE,CAAC;aACH,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;aACxD,QAAQ,EAAE;aACV,QAAQ,CAAC,oDAAoD,CAAC;KAClE,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QACrE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QACtE,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;aACxD,QAAQ,EAAE;aACV,QAAQ,CAAC,6CAA6C,CAAC;KAC3D,CAAC;CACH,CAAC,CAAC;AAIH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC;IAC7C,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KAC7D,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;QAChC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QAChE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;KAC3F,CAAC;CACH,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,EAAE,EAAE,CAAC;SACF,MAAM,CAAC;QACN,YAAY,EAAE,CAAC;aACZ,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,oDAAoD,CAAC;QACjE,aAAa,EAAE,CAAC;aACb,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,qDAAqD,CAAC;KACnE,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,QAAQ,EAAE,CAAC;SACR,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;CAC5E,CAAC;KACD,QAAQ,EAAE,CAAC;AAKd;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC7E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC3E,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC;CAC3D,CAAC,CAAC;AAIH,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,8EAA8E;AAE9E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC;KAC5C,MAAM,CAAC,EAAE,CAAC;KACV,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAEvC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yEAAyE,CAC1E;IACH,gBAAgB,EAAE,CAAC;SAChB,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,8GAA8G,CAC/G;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,kFAAkF,CACnF;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,8CAA8C,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC;KAC3C,MAAM,CAAC,EAAE,CAAC;KACV,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAEvC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CACP,uFAAuF,CACxF;IACH,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC9C,wFAAwF,CACzF;IACD,kBAAkB,EAAE,wBAAwB,CAAC,QAAQ,CACnD,wFAAwF,CACzF;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,+CAA+C,CAAC;CAC7D,CAAC,CAAC;AAEH,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CACP,6DAA6D,CAC9D;IACH,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CAAC,yDAAyD,CAAC;IACtE,UAAU,EAAE,CAAC;SACV,KAAK,CAAC,qBAAqB,CAAC;SAC5B,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;IACjE,gBAAgB,EAAE,CAAC;SAChB,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;SACrD,QAAQ,EAAE;SACV,QAAQ,CACP,sDAAsD;QACpD,2CAA2C;QAC3C,2CAA2C;QAC3C,wCAAwC;QACxC,mGAAmG,CACtG;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CACP,wDAAwD,CACzD;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CACP,gEAAgE,CACjE;IACH,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,iEAAiE,CAClE;IACH,UAAU,EAAE,CAAC;SACV,KAAK,CAAC,qBAAqB,CAAC;SAC5B,QAAQ,EAAE;SACV,QAAQ,CACP,4DAA4D,CAC7D;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CACP,gCAAgC,CACjC;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CACP,+FAA+F,CAChG;CACJ,CAAC,CAAC;AAEH,8EAA8E;AAE9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CACP,yDAAyD,CAC1D;IACH,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;SACrD,QAAQ,CACP,qHAAqH;QACnH,8EAA8E,CACjF;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CACP,+DAA+D,CAChE;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,CACP,mFAAmF,CACpF;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CACP,0GAA0G,CAC3G;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CACP,yEAAyE,CAC1E;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,mCAAmC,CAAC;IAChD,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,CACP,gEAAgE,CACjE;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,6FAA6F;QAC3F,8FAA8F;QAC9F,oBAAoB,CACvB;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iGAAiG;QAC/F,oGAAoG;QACpG,kBAAkB,CACrB;CACJ,CAAC,CAAC;AAEH,8EAA8E;AAE9E,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC,EAAE,CAAC;KACV,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAEvC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,2CAA2C,CAAC;CACzD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CACP,iEAAiE,CAClE;IACH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,CACP,uFAAuF,CACxF;CACJ,CAAC,CAAC;AAEH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,8EAA8E;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,oGAAoG;QACpG,8FAA8F;IAChG,WAAW,EAAE,8BAA8B;CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,oGAAoG;QACpG,2FAA2F;QAC3F,0CAA0C;IAC5C,WAAW,EAAE,yBAAyB;CACvC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,iGAAiG;QACjG,oGAAoG;IACtG,WAAW,EAAE,uBAAuB;CACrC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,6FAA6F;QAC7F,qDAAqD;IACvD,WAAW,EAAE,yBAAyB;CACvC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,qGAAqG;QACrG,4GAA4G;IAC9G,WAAW,EAAE,6BAA6B;CAC3C,CAAC;AAEF,8EAA8E;AAE9E,MAAM,CAAC,MAAM,UAAU,GAAmB;IACxC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,+FAA+F;QAC/F,mGAAmG;QACnG,qDAAqD;IACvD,WAAW,EAAE,qBAAqB;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAmB;IACtC,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,kGAAkG;QAClG,qFAAqF;IACvF,WAAW,EAAE,mBAAmB;CACjC,CAAC;AAEF,8EAA8E;AAE9E,MAAM,CAAC,MAAM,UAAU,GAAmB;IACxC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,mGAAmG;QACnG,4GAA4G;IAC9G,WAAW,EAAE,qBAAqB;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAmB;IACzC,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,oGAAoG;QACpG,qGAAqG;QACrG,mBAAmB;IACrB,WAAW,EAAE,sBAAsB;CACpC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,uEAAuE;QACvE,wEAAwE;IAC1E,WAAW,EAAE,uBAAuB;CACrC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,sGAAsG;QACtG,wEAAwE;IAC1E,WAAW,EAAE,uBAAuB;CACrC,CAAC;AAEF,8EAA8E;AAE9E,MAAM,CAAC,MAAM,MAAM,GAAmB;IACpC,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,sGAAsG;QACtG,qGAAqG;QACrG,gGAAgG;QAChG,+DAA+D;IACjE,WAAW,EAAE,iBAAiB;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,oGAAoG;QACpG,iGAAiG;QACjG,wGAAwG;IAC1G,WAAW,EAAE,0BAA0B;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAmB;IACpC,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,qGAAqG;QACrG,oFAAoF;IACtF,WAAW,EAAE,iBAAiB;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAmB;IACrC,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,kGAAkG;QAClG,kGAAkG;QAClG,+BAA+B;IACjC,WAAW,EAAE,kBAAkB;CAChC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAmB;IACpC,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,kGAAkG;QAClG,2FAA2F;QAC3F,iGAAiG;IACnG,WAAW,EAAE,iBAAiB;CAC/B,CAAC;AAEF,8EAA8E;AAE9E,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,2FAA2F;QAC3F,mGAAmG;IACrG,WAAW,EAAE,4BAA4B;CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,gGAAgG;QAChG,qGAAqG;IACvG,WAAW,EAAE,yBAAyB;CACvC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,kGAAkG;QAClG,mGAAmG;QACnG,oCAAoC;IACtC,WAAW,EAAE,yBAAyB;CACvC,CAAC;AAEF,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAqB;IACzC,WAAW;IACX,mBAAmB;IACnB,cAAc;IACd,YAAY;IACZ,cAAc;IACd,kBAAkB;IAClB,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,UAAU;IACV,UAAU;IACV,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,MAAM;IACN,MAAM;IACN,eAAe;IACf,MAAM;IACN,OAAO;IACP,sBAAsB;IACtB,iBAAiB;IACjB,cAAc;IACd,cAAc;CACf,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAmC;IAC1D,WAAW;IACX,qBAAqB,EAAE,8BAA8B;IACrD,eAAe,EAAE,yBAAyB;IAC1C,aAAa,EAAE,uBAAuB;IACtC,eAAe,EAAE,yBAAyB;IAC1C,oBAAoB,EAAE,6BAA6B;IACnD,YAAY;IACZ,UAAU,EAAE,qBAAqB;IACjC,QAAQ,EAAE,mBAAmB;IAC7B,UAAU;IACV,WAAW,EAAE,qBAAqB;IAClC,YAAY,EAAE,sBAAsB;IACpC,aAAa,EAAE,uBAAuB;IACtC,aAAa,EAAE,uBAAuB;IACtC,cAAc;IACd,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,iBAAiB;IACzB,gBAAgB,EAAE,0BAA0B;IAC5C,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,kBAAkB;IAC5B,sBAAsB;IACtB,mBAAmB,EAAE,4BAA4B;IACjD,gBAAgB,EAAE,yBAAyB;IAC3C,gBAAgB,EAAE,yBAAyB;CAC5C,CAAC"}

package/docs/configuration.md

@@ -0,0 +1,164 @@
+# MCACP Configuration Guide
+
+## Config File Locations
+
+MCACP loads config from multiple scopes, merged in priority order (highest wins):
+
+| Scope | Locations | Use for |
+|-------|-----------|---------|
+| **Host** | `/etc/mcacp/config.json` (Linux/Mac), `%PROGRAMDATA%/mcacp/config.json` (Windows) | System-wide defaults |
+| **Project** | `./mcacp.json`, `./.mcacprc.json` | Project-specific agent settings |
+| **User** | `~/.config/mcacp/config.json` (Linux/Mac), `%APPDATA%/mcacp/config.json` (Windows), `~/mcacp.json` | Personal agent configs |
+| **Explicit** | `--config /path/to/file` | Override everything |
+
+All scopes accept `mcacp.json`, `.mcacprc.json`, or `config.json`. Config files merge:
+`agent_servers` entries combine across scopes (user overrides project overrides host).
+All other fields use the highest-priority value.
+
+## Config Schema
+
+```json
+{
+  "agent_servers": {
+    "my-agent": {
+      "command": "/path/to/agent",
+      "args": ["acp"],
+      "env": { "API_KEY": "sk-..." },
+      "autoReapMs": 300000,
+      "permissionPolicy": "operator"
+    }
+  },
+  "registries": [
+    "https://cdn.agentclientprotocol.com/registry/v1/latest/registry.json"
+  ],
+  "defaultAutoReapMs": 300000,
+  "defaultPermissionPolicy": "elicit",
+  "sessionDir": "./.mcacp",
+  "installDir": "./.mcacp/agents",
+  "promptConsolidateMs": 5000,
+  "heartbeatTimeoutMs": 60000,
+  "clientInfo": {
+    "name": "mcacp",
+    "version": "0.1.0",
+    "title": "MCACP Bridge"
+  }
+}
+```
+
+**Note:** `cwd` is not a config-level field — it's set per-session via `new_session` / `load_session`.
+Tool-call events (`tool_call`, `tool_call_update`) are surfaced in the event stream when the agent emits them.
+
+## agent_servers
+
+The `agent_servers` key matches the Zed and JetBrains ACP config format:
+
+```json
+{
+  "agent_servers": {
+    "Display Name": {
+      "command": "executable",
+      "args": ["arg1", "arg2"],
+      "env": { "KEY": "value" }
+    }
+  }
+}
+```
+
+**Core fields** (same as Zed/JetBrains):
+- `command` (string) — executable to launch
+- `args` (string[]) — command-line arguments
+- `env` (object) — environment variables
+
+**MCACP extensions** (optional):
+- `autoReapMs` (number) — auto-shutdown after inactivity (ms). 0 = disabled.
+- `permissionPolicy` (`elicit` | `allow_all` | `deny_all` | `operator`) — per-agent default
+- `installPath` (string) — custom binary install location
+
+## Registering Local Agents
+
+To add a local or custom ACP agent, add it to `agent_servers` in your config:
+
+```json
+{
+  "agent_servers": {
+    "my-private-agent": {
+      "command": "npx",
+      "args": ["-y", "@myorg/agent@latest"],
+      "env": { "AGENT_TOKEN": "..." }
+    },
+    "goose": {
+      "command": "goose",
+      "args": ["acp"]
+    }
+  }
+}
+```
+
+Then call `reload_config` to pick up changes without restarting.
+
+## Importing from Editors
+
+Use the `discover_agents` tool to scan for agents configured in:
+
+- **Zed**: `~/.config/zed/settings.json` → `agent_servers`
+- **JetBrains**: `~/.jetbrains/acp.json` → `agent_servers`
+
+The tool returns discovered agents with `command`, `args`, `env`, and `source`.
+Copy the entries you want into your `mcacp.json` `agent_servers` and call `reload_config`.
+
+### Zed config location
+- Linux/Mac: `~/.config/zed/settings.json`
+- Windows: `%APPDATA%/Zed/settings.json`
+
+### JetBrains config location
+- All platforms: `~/.jetbrains/acp.json`
+
+## Registry
+
+Configured via `registries` array. Default:
+```
+https://cdn.agentclientprotocol.com/registry/v1/latest/registry.json
+```
+
+Use `registry_search` to browse, `agent_install` to install from registry.
+Registry-installed agents are stored in `installDir` (default: `./.mcacp/agents/`).
+
+## Permission Policies
+
+| Policy | Behavior |
+|--------|----------|
+| `elicit` | Translates to MCP elicitation — asks the MCP client interactively |
+| `allow_all` | Auto-approves all permission requests |
+| `deny_all` | Auto-denies all permission requests |
+| `operator` | Surfaces as `permission_request` events — the calling agent decides |
+
+Set per-agent via `agent_servers[id].permissionPolicy` or globally via `defaultPermissionPolicy`.
+
+## Event Consolidation
+
+MCACP uses Nagle-style batching for text chunk events (`agent_message_chunk`, `agent_thought_chunk`).
+Instead of forwarding every individual chunk, text is accumulated and flushed as consolidated batches.
+
+Flush triggers:
+- The accumulated text contains a newline
+- The consolidation timeout expires
+- A non-chunk event arrives (tool_call, complete, error, permission_request)
+
+Configure via `promptConsolidateMs` (default: `5000`ms). Set to `0` to disable consolidation and push every chunk immediately.
+
+## Session Storage
+
+Sessions are persisted as JSON files under `sessionDir` (default: `./.mcacp`).
+Each agent gets its own subdirectory with a `sessions` folder:
+
+```
+.mcacp/<agent-name>/sessions/<sessionId>.json
+```
+
+For example, an agent named `my-agent` with session `abc123` would be stored at:
+```
+.mcacp/my-agent/sessions/abc123.json
+```
+
+Installed agent binaries live in `.mcacp/agents/`.
+Sessions survive restarts and can be resumed with `load_session`.

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "mcacp",
+  "version": "0.1.0",
+  "description": "MCP-to-ACP bridge — let any MCP client drive ACP coding agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcacp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Oortonaut/mcacp.git"
+  },
+  "homepage": "https://github.com/Oortonaut/mcacp",
+  "bugs": {
+    "url": "https://github.com/Oortonaut/mcacp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "acp",
+    "agent-control-protocol",
+    "model-context-protocol",
+    "coding-agent",
+    "multi-agent",
+    "claude",
+    "gemini",
+    "codex"
+  ],
+  "author": "Oortonaut",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.12.0",
+    "eslint": "^9.19.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.4"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}