@mastra/code-sdk 0.0.0-mastracode-cloud-20260706153555

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# @mastra/code-sdk
+
+## 0.0.0-mastracode-cloud-20260706153555
+
+### Minor Changes
+
+- Publish the Mastra Code agent core as `@mastra/code-sdk` (previously the internal `@internal/mastracode` package), so third parties can build their own UIs and surfaces on top of the Mastra Code coding agent. The `mastracode` CLI now consumes it as a regular runtime dependency instead of bundling it into its published output. ([`62ead38`](https://github.com/mastra-ai/mastra/commit/62ead38d2371fc8565f682611af9771bd58e5433))
+
+### Patch Changes
+
+- Updated dependencies [[`81e1ad4`](https://github.com/mastra-ai/mastra/commit/81e1ad440fd7ae0cd3b2977ae0c31eab0168efa7), [`3ffb8b7`](https://github.com/mastra-ai/mastra/commit/3ffb8b720e90f5e6977129ec1f6707d43c2bebe0), [`6ef59fe`](https://github.com/mastra-ai/mastra/commit/6ef59fef1da52ed8da5fbb2a892c71cf4fb6c739), [`a51c63d`](https://github.com/mastra-ai/mastra/commit/a51c63d8ee639e4daeba2a0be093efa6a1b5e52f), [`5ea76a7`](https://github.com/mastra-ai/mastra/commit/5ea76a723d966c72da9aa3ab30ae20276e049765), [`6445560`](https://github.com/mastra-ai/mastra/commit/6445560327045d20b239585fc63fed72e9ce36ec), [`e2b9f33`](https://github.com/mastra-ai/mastra/commit/e2b9f33456fd638eca555f9466c6519d8d049666), [`911281c`](https://github.com/mastra-ai/mastra/commit/911281c57893ba2630428bf88d0cd0c5101ce76f), [`a2ba369`](https://github.com/mastra-ai/mastra/commit/a2ba369e796dfab610f41c6875965b488272fa55), [`02705fd`](https://github.com/mastra-ai/mastra/commit/02705fd2f5a9062210d64ea061adeeb10dc9452e), [`ae51e81`](https://github.com/mastra-ai/mastra/commit/ae51e818825582d42500338dfc1929a082eff0ba), [`6f304ef`](https://github.com/mastra-ai/mastra/commit/6f304ef319e99725e884bdb8d3193c001b6e5964)]:
+  - @mastra/agent-browser@0.0.0-mastracode-cloud-20260706153555
+  - @mastra/core@0.0.0-mastracode-cloud-20260706153555
+  - @mastra/observability@0.0.0-mastracode-cloud-20260706153555
+  - @mastra/mcp@0.0.0-mastracode-cloud-20260706153555
+  - @mastra/stagehand@0.0.0-mastracode-cloud-20260706153555
+  - @mastra/tavily@0.0.0-mastracode-cloud-20260706153555
+  - @mastra/memory@0.0.0-mastracode-cloud-20260706153555
+  - @mastra/github-signals@0.0.0-mastracode-cloud-20260706153555
+  - @mastra/duckdb@0.0.0-mastracode-cloud-20260706153555
+  - @mastra/libsql@0.0.0-mastracode-cloud-20260706153555
+  - @mastra/pg@0.0.0-mastracode-cloud-20260706153555

package/LICENSE.md

@@ -0,0 +1,30 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named "ee/" within this
+  repository, including but not limited to:
+  - `packages/core/src/auth/ee/`
+  - `packages/server/src/server/auth/ee/`
+    is licensed under the license defined in `ee/LICENSE`.
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,50 @@
+# @mastra/code-sdk
+
+The agent core behind [Mastra Code](https://mastra.ai) — everything except the terminal UI. Use it to build your own UIs and surfaces (web apps, editors, bots) on top of the Mastra Code coding agent.
+
+The published [`mastracode`](https://www.npmjs.com/package/mastracode) CLI/TUI and the Mastra Code web surface are both built on this SDK.
+
+## Installation
+
+```bash
+npm install @mastra/code-sdk
+```
+
+## Usage
+
+Mount the Mastra Code agent controller on a Mastra instance:
+
+```ts
+import { mountAgentControllerOnMastra } from '@mastra/code-sdk';
+
+// Creates a Mastra instance that hosts the Mastra Code agent controller
+// (thread management, modes, tools, memory) and starts its workers.
+const { mastra, controller } = await mountAgentControllerOnMastra({
+  cwd: process.cwd(),
+});
+```
+
+To construct the `Mastra` instance yourself (e.g. in a deployable `mastra` entry file), use `prepareAgentControllerMount`:
+
+```ts
+import { Mastra } from '@mastra/core/mastra';
+import { prepareAgentControllerMount } from '@mastra/code-sdk';
+
+const prepared = await prepareAgentControllerMount({ cwd: process.cwd() });
+
+export const mastra = new Mastra(prepared.mastraArgs);
+
+await prepared.finalize();
+```
+
+Deep modules are available as subpath imports, e.g.:
+
+```ts
+import { loadSettings } from '@mastra/code-sdk/onboarding/settings';
+```
+
+> The subpath API surface is still evolving and may change between minor releases while the package is pre-1.0.
+
+## License
+
+Apache-2.0

package/dist/acp/agent.d.ts

@@ -0,0 +1,35 @@
+import type { Agent, AgentSideConnection, InitializeRequest, InitializeResponse, NewSessionRequest, NewSessionResponse, PromptRequest, PromptResponse, CancelNotification, ContentBlock } from '@agentclientprotocol/sdk';
+import type { AgentController, AgentControllerMode, Session } from '@mastra/core/agent-controller';
+/**
+ * ACP Agent implementation that wraps a mastracode Controller.
+ * Each instance represents one ACP connection from a client.
+ */
+export declare class MastraCodeAcpAgent implements Agent {
+    private readonly connection;
+    private readonly controller;
+    private readonly session;
+    private readonly modes;
+    private readonly unsubscribeSessionEvents;
+    private readonly sessionMap;
+    private currentPromptState;
+    private promptMutex;
+    private getThreadIdOrThrow;
+    constructor(connection: AgentSideConnection, controller: AgentController, session: Session, modes: AgentControllerMode[]);
+    dispose(): void;
+    initialize(_request: InitializeRequest): Promise<InitializeResponse>;
+    authenticate(): Promise<void>;
+    newSession(_request: NewSessionRequest): Promise<NewSessionResponse>;
+    prompt(request: PromptRequest): Promise<PromptResponse>;
+    cancel(_notification: CancelNotification): Promise<void>;
+    setSessionMode(params: {
+        sessionId: string;
+        modeId: string;
+    }): Promise<void>;
+    unstable_setSessionModel(params: {
+        sessionId: string;
+        modelId: string;
+    }): Promise<void>;
+}
+export declare function extractTextFromContentBlocks(blocks: ContentBlock[]): string;
+export declare function mapStopReason(reason: 'complete' | 'aborted' | 'error' | 'suspended'): 'end_turn' | 'cancelled' | 'max_tokens' | 'max_turn_requests' | 'refusal';
+//# sourceMappingURL=agent.d.ts.map

package/dist/acp/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/acp/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,YAAY,EACb,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAInG;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,KAAK;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAa;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,WAAW,CAAoC;IAEvD,OAAO,CAAC,kBAAkB;gBASxB,UAAU,EAAE,mBAAmB,EAC/B,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,mBAAmB,EAAE;IAa9B,OAAO,IAAI,IAAI;IAIT,UAAU,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAcpE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,UAAU,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0CpE,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAsEvD,MAAM,CAAC,aAAa,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,cAAc,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5E,wBAAwB,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAK9F;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAY3E;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GACrD,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,mBAAmB,GAAG,SAAS,CAW3E"}

package/dist/acp/agent.js

@@ -0,0 +1,173 @@
+import { PROTOCOL_VERSION } from "@agentclientprotocol/sdk";
+import { handleAgentControllerEvent } from "./event-mapper.js";
+class MastraCodeAcpAgent {
+  connection;
+  controller;
+  session;
+  modes;
+  unsubscribeSessionEvents;
+  sessionMap = /* @__PURE__ */ new Map();
+  // sessionId -> threadId
+  currentPromptState = null;
+  promptMutex = Promise.resolve();
+  getThreadIdOrThrow(sessionId) {
+    const threadId = this.sessionMap.get(sessionId);
+    if (!threadId) {
+      throw new Error(`Unknown ACP sessionId: ${sessionId}`);
+    }
+    return threadId;
+  }
+  constructor(connection, controller, session, modes) {
+    this.connection = connection;
+    this.controller = controller;
+    this.session = session;
+    this.modes = modes;
+    this.unsubscribeSessionEvents = this.session.subscribe((event) => {
+      handleAgentControllerEvent(event, this.currentPromptState, this.connection, this.session);
+    });
+  }
+  dispose() {
+    this.unsubscribeSessionEvents();
+  }
+  async initialize(_request) {
+    return {
+      protocolVersion: PROTOCOL_VERSION,
+      agentInfo: {
+        name: "mastracode",
+        title: "Mastra Code",
+        version: "0.1.0"
+      },
+      agentCapabilities: {
+        loadSession: false
+      }
+    };
+  }
+  async authenticate() {
+  }
+  async newSession(_request) {
+    const thread = await this.session.thread.create();
+    const sessionId = thread.id;
+    this.sessionMap.set(sessionId, thread.id);
+    await this.session.thread.switch({ threadId: thread.id });
+    const availableModes = this.modes.map((m) => ({
+      id: m.id,
+      name: m.name ?? m.id
+    }));
+    const currentModeId = this.session.mode.get();
+    let models;
+    try {
+      const availableModels = await this.controller.listAvailableModels();
+      const currentModelId = this.session.model.get();
+      models = {
+        currentModelId: currentModelId ?? "",
+        availableModels: availableModels.map((m) => ({
+          modelId: m.id,
+          name: m.modelName
+        }))
+      };
+    } catch {
+    }
+    return {
+      sessionId,
+      modes: {
+        currentModeId,
+        availableModes
+      },
+      models
+    };
+  }
+  async prompt(request) {
+    const { sessionId, prompt: contentBlocks } = request;
+    const text = extractTextFromContentBlocks(contentBlocks);
+    const threadId = this.getThreadIdOrThrow(sessionId);
+    const prevMutex = this.promptMutex;
+    let resolveMutex;
+    this.promptMutex = new Promise((resolve) => {
+      resolveMutex = resolve;
+    });
+    await prevMutex;
+    try {
+      await this.session.thread.switch({ threadId });
+      const result = new Promise((resolve) => {
+        const usage2 = {
+          promptTokens: 0,
+          completionTokens: 0,
+          totalTokens: 0
+        };
+        this.currentPromptState = {
+          sessionId,
+          lastTextLength: 0,
+          usage: usage2,
+          resolve: (reason2) => {
+            resolve({ reason: reason2, usage: usage2 });
+            this.currentPromptState = null;
+          }
+        };
+      });
+      try {
+        await this.session.sendMessage({ content: text });
+      } catch (error) {
+        this.currentPromptState = null;
+        throw error;
+      }
+      const { reason, usage } = await result;
+      return {
+        stopReason: mapStopReason(reason),
+        usage: {
+          inputTokens: usage.promptTokens,
+          outputTokens: usage.completionTokens,
+          totalTokens: usage.totalTokens,
+          thoughtTokens: usage.reasoningTokens,
+          cachedReadTokens: usage.cachedInputTokens,
+          cachedWriteTokens: usage.cacheCreationInputTokens
+        }
+      };
+    } finally {
+      resolveMutex();
+    }
+  }
+  async cancel(_notification) {
+    this.session.abort();
+  }
+  async setSessionMode(params) {
+    const threadId = this.getThreadIdOrThrow(params.sessionId);
+    await this.session.thread.switch({ threadId });
+    this.session.mode.set({ modeId: params.modeId });
+  }
+  async unstable_setSessionModel(params) {
+    const threadId = this.getThreadIdOrThrow(params.sessionId);
+    await this.session.thread.switch({ threadId });
+    this.session.model.set({ modelId: params.modelId });
+  }
+}
+function extractTextFromContentBlocks(blocks) {
+  const parts = [];
+  for (const block of blocks) {
+    if (block.type === "text") {
+      parts.push(block.text);
+    } else if (block.type === "resource_link") {
+      parts.push(`[resource: ${block.uri}]`);
+    } else if (block.type === "resource") {
+      parts.push(`[resource: ${block.resource.uri}]`);
+    }
+  }
+  return parts.join("\n");
+}
+function mapStopReason(reason) {
+  switch (reason) {
+    case "complete":
+      return "end_turn";
+    case "aborted":
+      return "cancelled";
+    case "error":
+      return "end_turn";
+    case "suspended":
+      return "end_turn";
+  }
+}
+export {
+  MastraCodeAcpAgent,
+  extractTextFromContentBlocks,
+  mapStopReason
+};
+//# sourceMappingURL=agent.js.map

package/dist/acp/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/acp/agent.ts"],"sourcesContent":["import type {\n  Agent,\n  AgentSideConnection,\n  InitializeRequest,\n  InitializeResponse,\n  NewSessionRequest,\n  NewSessionResponse,\n  PromptRequest,\n  PromptResponse,\n  CancelNotification,\n  ContentBlock,\n} from '@agentclientprotocol/sdk';\nimport { PROTOCOL_VERSION } from '@agentclientprotocol/sdk';\nimport type { AgentController, AgentControllerMode, Session } from '@mastra/core/agent-controller';\nimport { handleAgentControllerEvent } from './event-mapper.js';\nimport type { PromptState } from './event-mapper.js';\n\n/**\n * ACP Agent implementation that wraps a mastracode Controller.\n * Each instance represents one ACP connection from a client.\n */\nexport class MastraCodeAcpAgent implements Agent {\n  private readonly connection: AgentSideConnection;\n  private readonly controller: AgentController;\n  private readonly session: Session;\n  private readonly modes: AgentControllerMode[];\n  private readonly unsubscribeSessionEvents: () => void;\n  private readonly sessionMap = new Map<string, string>(); // sessionId -> threadId\n  private currentPromptState: PromptState | null = null;\n  private promptMutex: Promise<void> = Promise.resolve();\n\n  private getThreadIdOrThrow(sessionId: string): string {\n    const threadId = this.sessionMap.get(sessionId);\n    if (!threadId) {\n      throw new Error(`Unknown ACP sessionId: ${sessionId}`);\n    }\n    return threadId;\n  }\n\n  constructor(\n    connection: AgentSideConnection,\n    controller: AgentController,\n    session: Session,\n    modes: AgentControllerMode[],\n  ) {\n    this.connection = connection;\n    this.controller = controller;\n    this.session = session;\n    this.modes = modes;\n\n    // Register persistent event listener\n    this.unsubscribeSessionEvents = this.session.subscribe(event => {\n      handleAgentControllerEvent(event, this.currentPromptState, this.connection, this.session);\n    });\n  }\n\n  dispose(): void {\n    this.unsubscribeSessionEvents();\n  }\n\n  async initialize(_request: InitializeRequest): Promise<InitializeResponse> {\n    return {\n      protocolVersion: PROTOCOL_VERSION,\n      agentInfo: {\n        name: 'mastracode',\n        title: 'Mastra Code',\n        version: '0.1.0',\n      },\n      agentCapabilities: {\n        loadSession: false,\n      },\n    };\n  }\n\n  async authenticate(): Promise<void> {\n    // No-op: mastracode handles its own auth\n  }\n\n  async newSession(_request: NewSessionRequest): Promise<NewSessionResponse> {\n    const thread = await this.session.thread.create();\n    const sessionId = thread.id;\n    this.sessionMap.set(sessionId, thread.id);\n\n    // Switch to the new thread\n    await this.session.thread.switch({ threadId: thread.id });\n\n    // Build modes list from constructor param\n    const availableModes = this.modes.map((m: AgentControllerMode) => ({\n      id: m.id,\n      name: m.name ?? m.id,\n    }));\n\n    const currentModeId = this.session.mode.get();\n\n    // Build models list (best-effort)\n    let models: NewSessionResponse['models'];\n    try {\n      const availableModels = await this.controller.listAvailableModels();\n      const currentModelId = this.session.model.get();\n      models = {\n        currentModelId: currentModelId ?? '',\n        availableModels: availableModels.map(m => ({\n          modelId: m.id,\n          name: m.modelName,\n        })),\n      };\n    } catch {\n      // Model listing may fail if no providers are configured\n    }\n\n    return {\n      sessionId,\n      modes: {\n        currentModeId,\n        availableModes,\n      },\n      models,\n    };\n  }\n\n  async prompt(request: PromptRequest): Promise<PromptResponse> {\n    const { sessionId, prompt: contentBlocks } = request;\n\n    // Extract text from content blocks\n    const text = extractTextFromContentBlocks(contentBlocks);\n\n    const threadId = this.getThreadIdOrThrow(sessionId);\n\n    // Serialize prompts via mutex\n    const prevMutex = this.promptMutex;\n    let resolveMutex: () => void;\n    this.promptMutex = new Promise<void>(resolve => {\n      resolveMutex = resolve;\n    });\n\n    await prevMutex;\n\n    try {\n      // Ensure we're on the right thread while prompts are serialized\n      await this.session.thread.switch({ threadId });\n\n      // Create prompt state that will be resolved when agent_end fires\n      const result = new Promise<{\n        reason: 'complete' | 'aborted' | 'error' | 'suspended';\n        usage: PromptState['usage'];\n      }>(resolve => {\n        const usage: PromptState['usage'] = {\n          promptTokens: 0,\n          completionTokens: 0,\n          totalTokens: 0,\n        };\n\n        this.currentPromptState = {\n          sessionId,\n          lastTextLength: 0,\n          usage,\n          resolve: reason => {\n            resolve({ reason, usage });\n            this.currentPromptState = null;\n          },\n        };\n      });\n\n      // Send the message to the session\n      try {\n        await this.session.sendMessage({ content: text });\n      } catch (error) {\n        this.currentPromptState = null;\n        throw error;\n      }\n\n      // Wait for agent_end to resolve\n      const { reason, usage } = await result;\n\n      return {\n        stopReason: mapStopReason(reason),\n        usage: {\n          inputTokens: usage.promptTokens,\n          outputTokens: usage.completionTokens,\n          totalTokens: usage.totalTokens,\n          thoughtTokens: usage.reasoningTokens,\n          cachedReadTokens: usage.cachedInputTokens,\n          cachedWriteTokens: usage.cacheCreationInputTokens,\n        },\n      };\n    } finally {\n      resolveMutex!();\n    }\n  }\n\n  async cancel(_notification: CancelNotification): Promise<void> {\n    this.session.abort();\n  }\n\n  async setSessionMode(params: { sessionId: string; modeId: string }): Promise<void> {\n    const threadId = this.getThreadIdOrThrow(params.sessionId);\n    await this.session.thread.switch({ threadId });\n    this.session.mode.set({ modeId: params.modeId });\n  }\n\n  async unstable_setSessionModel(params: { sessionId: string; modelId: string }): Promise<void> {\n    const threadId = this.getThreadIdOrThrow(params.sessionId);\n    await this.session.thread.switch({ threadId });\n    this.session.model.set({ modelId: params.modelId });\n  }\n}\n\nexport function extractTextFromContentBlocks(blocks: ContentBlock[]): string {\n  const parts: string[] = [];\n  for (const block of blocks) {\n    if (block.type === 'text') {\n      parts.push(block.text);\n    } else if (block.type === 'resource_link') {\n      parts.push(`[resource: ${block.uri}]`);\n    } else if (block.type === 'resource') {\n      parts.push(`[resource: ${block.resource.uri}]`);\n    }\n  }\n  return parts.join('\\n');\n}\n\nexport function mapStopReason(\n  reason: 'complete' | 'aborted' | 'error' | 'suspended',\n): 'end_turn' | 'cancelled' | 'max_tokens' | 'max_turn_requests' | 'refusal' {\n  switch (reason) {\n    case 'complete':\n      return 'end_turn';\n    case 'aborted':\n      return 'cancelled';\n    case 'error':\n      return 'end_turn';\n    case 'suspended':\n      return 'end_turn';\n  }\n}\n"],"mappings":"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","names":["usage","reason"]}

package/dist/acp/event-mapper.d.ts

@@ -0,0 +1,22 @@
+import type { AgentSideConnection } from '@agentclientprotocol/sdk';
+import type { AgentControllerEvent, Session, TokenUsage } from '@mastra/core/agent-controller';
+/**
+ * Enable or disable automatic tool approval (set via --dangerous-auto-approve CLI flag).
+ */
+export declare function setAutoApprove(value: boolean): void;
+/**
+ * Accumulated state for an active prompt turn.
+ */
+export interface PromptState {
+    sessionId: string;
+    lastTextLength: number;
+    usage: TokenUsage;
+    resolve: (reason: 'complete' | 'aborted' | 'error' | 'suspended') => void;
+}
+/**
+ * Translate an AgentControllerEvent into an ACP SessionNotification and send it
+ * via the provided connection. Returns null for events that don't produce
+ * a session update.
+ */
+export declare function handleAgentControllerEvent(event: AgentControllerEvent, state: PromptState | null, connection: AgentSideConnection, session: Session): void;
+//# sourceMappingURL=event-mapper.d.ts.map

package/dist/acp/event-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-mapper.d.ts","sourceRoot":"","sources":["../../src/acp/event-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiD,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACnH,OAAO,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAI/F;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEnD;AA4BD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,KAAK,IAAI,CAAC;CAC3E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,WAAW,GAAG,IAAI,EACzB,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE,OAAO,GACf,IAAI,CAyEN"}

package/dist/acp/event-mapper.js

@@ -0,0 +1,166 @@
+let autoApprove = false;
+function setAutoApprove(value) {
+  autoApprove = value;
+}
+function mapToolKind(toolName) {
+  const name = toolName.toLowerCase();
+  if (name.includes("edit") || name.includes("write") || name.includes("replace") || name.includes("patch"))
+    return "edit";
+  if (name.includes("read") || name.includes("view") || name.includes("list") || name.includes("find")) return "read";
+  if (name.includes("delete") || name.includes("remove")) return "delete";
+  if (name.includes("search") || name.includes("grep") || name.includes("query")) return "search";
+  if (name.includes("execute") || name.includes("run") || name.includes("command") || name.includes("shell"))
+    return "execute";
+  if (name.includes("fetch") || name.includes("curl") || name.includes("http") || name.includes("browse") || name.includes("navigate"))
+    return "fetch";
+  if (name.includes("think") || name.includes("reason")) return "think";
+  return "other";
+}
+function handleAgentControllerEvent(event, state, connection, session) {
+  if (!state) return;
+  switch (event.type) {
+    case "agent_start":
+      state.lastTextLength = 0;
+      break;
+    case "message_update": {
+      if (event.message.role !== "assistant") break;
+      const fullText = event.message.content.filter((c) => c.type === "text").map((p) => p.text).join("");
+      if (fullText.length > state.lastTextLength) {
+        const delta = fullText.slice(state.lastTextLength);
+        state.lastTextLength = fullText.length;
+        sendUpdate(connection, state.sessionId, {
+          sessionUpdate: "agent_message_chunk",
+          content: { type: "text", text: delta }
+        });
+      }
+      break;
+    }
+    case "message_end":
+      state.lastTextLength = 0;
+      break;
+    case "tool_start":
+      sendUpdate(connection, state.sessionId, {
+        sessionUpdate: "tool_call",
+        toolCallId: event.toolCallId,
+        title: event.toolName,
+        kind: mapToolKind(event.toolName),
+        status: "in_progress",
+        rawInput: JSON.stringify(event.args)
+      });
+      break;
+    case "tool_end":
+      sendUpdate(connection, state.sessionId, {
+        sessionUpdate: "tool_call_update",
+        toolCallId: event.toolCallId,
+        status: event.isError ? "failed" : "completed",
+        rawOutput: typeof event.result === "string" ? event.result : JSON.stringify(event.result)
+      });
+      break;
+    case "tool_approval_required":
+      void handleToolApproval(state, connection, session, event).catch((err) => {
+        process.stderr.write(`[acp] handleToolApproval error: ${err}
+`);
+      });
+      break;
+    case "tool_suspended":
+      void handleToolSuspended(state, connection, session, event).catch((err) => {
+        process.stderr.write(`[acp] handleToolSuspended error: ${err}
+`);
+      });
+      break;
+    case "usage_update":
+      accumulateUsage(state.usage, event.usage);
+      break;
+    case "agent_end":
+      state.resolve(event.reason ?? "complete");
+      break;
+    // Ignored in v1: om_*, subagent_*, workspace_*, task_updated, etc.
+    default:
+      break;
+  }
+}
+function sendUpdate(connection, sessionId, update) {
+  connection.sessionUpdate({ sessionId, update }).catch((err) => {
+    process.stderr.write(`[acp] sessionUpdate error: ${err}
+`);
+  });
+}
+async function handleToolApproval(state, connection, session, event) {
+  if (autoApprove) {
+    session.respondToToolApproval({ decision: "approve" });
+    return;
+  }
+  const req = {
+    sessionId: state.sessionId,
+    toolCall: {
+      toolCallId: event.toolCallId,
+      title: event.toolName,
+      rawInput: JSON.stringify(event.args)
+    },
+    options: [
+      { optionId: "approve", name: "Allow", kind: "allow_once" },
+      { optionId: "reject", name: "Reject", kind: "reject_once" }
+    ]
+  };
+  try {
+    const resp = await connection.requestPermission(req);
+    if (resp.outcome.outcome === "selected") {
+      const decision = resp.outcome.optionId === "approve" ? "approve" : "decline";
+      session.respondToToolApproval({ decision });
+    } else {
+      session.respondToToolApproval({ decision: "decline" });
+    }
+  } catch (err) {
+    process.stderr.write(`[acp] requestPermission error: ${err}
+`);
+    session.respondToToolApproval({ decision: "decline" });
+  }
+}
+async function handleToolSuspended(state, connection, session, event) {
+  const { toolCallId, toolName, args, suspendPayload } = event;
+  if (toolName === "request_access" || suspendPayload?.kind === "sandbox_access_request") {
+    void session.respondToToolSuspension({ toolCallId, resumeData: "Yes" });
+    return;
+  }
+  if (toolName === "submit_plan") {
+    const req = {
+      sessionId: state.sessionId,
+      toolCall: {
+        toolCallId,
+        title: toolName,
+        rawInput: JSON.stringify(args)
+      },
+      options: [
+        { optionId: "approve", name: "Approve Plan", kind: "allow_once" },
+        { optionId: "reject", name: "Reject Plan", kind: "reject_once" }
+      ]
+    };
+    try {
+      const resp = await connection.requestPermission(req);
+      const action = resp.outcome.outcome === "selected" && resp.outcome.optionId === "approve" ? "approved" : "rejected";
+      void session.respondToToolSuspension({ toolCallId, resumeData: { action } });
+    } catch {
+      void session.respondToToolSuspension({ toolCallId, resumeData: { action: "rejected" } });
+    }
+    return;
+  }
+  void session.respondToToolSuspension({
+    toolCallId,
+    resumeData: "Proceed with your best judgment. Do not ask further questions."
+  });
+}
+function accumulateUsage(target, usage) {
+  target.promptTokens += usage.promptTokens;
+  target.completionTokens += usage.completionTokens;
+  target.totalTokens += usage.totalTokens;
+  if (usage.reasoningTokens) target.reasoningTokens = (target.reasoningTokens ?? 0) + usage.reasoningTokens;
+  if (usage.cachedInputTokens) target.cachedInputTokens = (target.cachedInputTokens ?? 0) + usage.cachedInputTokens;
+  if (usage.cacheCreationInputTokens) {
+    target.cacheCreationInputTokens = (target.cacheCreationInputTokens ?? 0) + usage.cacheCreationInputTokens;
+  }
+}
+export {
+  handleAgentControllerEvent,
+  setAutoApprove
+};
+//# sourceMappingURL=event-mapper.js.map

package/dist/acp/event-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/acp/event-mapper.ts"],"sourcesContent":["import type { SessionNotification, RequestPermissionRequest, AgentSideConnection } from '@agentclientprotocol/sdk';\nimport type { AgentControllerEvent, Session, TokenUsage } from '@mastra/core/agent-controller';\n\nlet autoApprove = false;\n\n/**\n * Enable or disable automatic tool approval (set via --dangerous-auto-approve CLI flag).\n */\nexport function setAutoApprove(value: boolean): void {\n  autoApprove = value;\n}\n\n/**\n * Map a mastracode tool name to an ACP ToolKind.\n */\nfunction mapToolKind(\n  toolName: string,\n): 'read' | 'edit' | 'delete' | 'move' | 'search' | 'execute' | 'think' | 'fetch' | 'other' {\n  const name = toolName.toLowerCase();\n  if (name.includes('edit') || name.includes('write') || name.includes('replace') || name.includes('patch'))\n    return 'edit';\n  if (name.includes('read') || name.includes('view') || name.includes('list') || name.includes('find')) return 'read';\n  if (name.includes('delete') || name.includes('remove')) return 'delete';\n  if (name.includes('search') || name.includes('grep') || name.includes('query')) return 'search';\n  if (name.includes('execute') || name.includes('run') || name.includes('command') || name.includes('shell'))\n    return 'execute';\n  if (\n    name.includes('fetch') ||\n    name.includes('curl') ||\n    name.includes('http') ||\n    name.includes('browse') ||\n    name.includes('navigate')\n  )\n    return 'fetch';\n  if (name.includes('think') || name.includes('reason')) return 'think';\n  return 'other';\n}\n\n/**\n * Accumulated state for an active prompt turn.\n */\nexport interface PromptState {\n  sessionId: string;\n  lastTextLength: number;\n  usage: TokenUsage;\n  resolve: (reason: 'complete' | 'aborted' | 'error' | 'suspended') => void;\n}\n\n/**\n * Translate an AgentControllerEvent into an ACP SessionNotification and send it\n * via the provided connection. Returns null for events that don't produce\n * a session update.\n */\nexport function handleAgentControllerEvent(\n  event: AgentControllerEvent,\n  state: PromptState | null,\n  connection: AgentSideConnection,\n  session: Session,\n): void {\n  if (!state) return;\n\n  switch (event.type) {\n    case 'agent_start':\n      state.lastTextLength = 0;\n      break;\n\n    case 'message_update': {\n      if (event.message.role !== 'assistant') break;\n      const fullText = event.message.content\n        .filter((c): c is { type: 'text'; text: string } => c.type === 'text')\n        .map(p => p.text)\n        .join('');\n      if (fullText.length > state.lastTextLength) {\n        const delta = fullText.slice(state.lastTextLength);\n        state.lastTextLength = fullText.length;\n        sendUpdate(connection, state.sessionId, {\n          sessionUpdate: 'agent_message_chunk',\n          content: { type: 'text', text: delta },\n        });\n      }\n      break;\n    }\n\n    case 'message_end':\n      state.lastTextLength = 0;\n      break;\n\n    case 'tool_start':\n      sendUpdate(connection, state.sessionId, {\n        sessionUpdate: 'tool_call',\n        toolCallId: event.toolCallId,\n        title: event.toolName,\n        kind: mapToolKind(event.toolName),\n        status: 'in_progress',\n        rawInput: JSON.stringify(event.args),\n      });\n      break;\n\n    case 'tool_end':\n      sendUpdate(connection, state.sessionId, {\n        sessionUpdate: 'tool_call_update',\n        toolCallId: event.toolCallId,\n        status: event.isError ? 'failed' : 'completed',\n        rawOutput: typeof event.result === 'string' ? event.result : JSON.stringify(event.result),\n      });\n      break;\n\n    case 'tool_approval_required':\n      void handleToolApproval(state, connection, session, event).catch(err => {\n        process.stderr.write(`[acp] handleToolApproval error: ${err}\\n`);\n      });\n      break;\n\n    case 'tool_suspended':\n      void handleToolSuspended(state, connection, session, event).catch(err => {\n        process.stderr.write(`[acp] handleToolSuspended error: ${err}\\n`);\n      });\n      break;\n\n    case 'usage_update':\n      accumulateUsage(state.usage, event.usage);\n      break;\n\n    case 'agent_end':\n      state.resolve(event.reason ?? 'complete');\n      break;\n\n    // Ignored in v1: om_*, subagent_*, workspace_*, task_updated, etc.\n    default:\n      break;\n  }\n}\n\nfunction sendUpdate(connection: AgentSideConnection, sessionId: string, update: SessionNotification['update']): void {\n  connection.sessionUpdate({ sessionId, update }).catch(err => {\n    process.stderr.write(`[acp] sessionUpdate error: ${err}\\n`);\n  });\n}\n\nasync function handleToolApproval(\n  state: PromptState,\n  connection: AgentSideConnection,\n  session: Session,\n  event: Extract<AgentControllerEvent, { type: 'tool_approval_required' }>,\n): Promise<void> {\n  // Auto-approve if --dangerous-auto-approve flag is set\n  if (autoApprove) {\n    session.respondToToolApproval({ decision: 'approve' });\n    return;\n  }\n\n  const req: RequestPermissionRequest = {\n    sessionId: state.sessionId,\n    toolCall: {\n      toolCallId: event.toolCallId,\n      title: event.toolName,\n      rawInput: JSON.stringify(event.args),\n    },\n    options: [\n      { optionId: 'approve', name: 'Allow', kind: 'allow_once' },\n      { optionId: 'reject', name: 'Reject', kind: 'reject_once' },\n    ],\n  };\n\n  try {\n    const resp = await connection.requestPermission(req);\n    if (resp.outcome.outcome === 'selected') {\n      const decision = resp.outcome.optionId === 'approve' ? 'approve' : 'decline';\n      session.respondToToolApproval({ decision });\n    } else {\n      session.respondToToolApproval({ decision: 'decline' });\n    }\n  } catch (err) {\n    process.stderr.write(`[acp] requestPermission error: ${err}\\n`);\n    session.respondToToolApproval({ decision: 'decline' });\n  }\n}\n\nasync function handleToolSuspended(\n  state: PromptState,\n  connection: AgentSideConnection,\n  session: Session,\n  event: Extract<AgentControllerEvent, { type: 'tool_suspended' }>,\n): Promise<void> {\n  const { toolCallId, toolName, args, suspendPayload } = event;\n\n  // Auto-resolve certain suspensions (mirrors headless.ts autoResolve)\n  if (toolName === 'request_access' || (suspendPayload as any)?.kind === 'sandbox_access_request') {\n    void session.respondToToolSuspension({ toolCallId, resumeData: 'Yes' });\n    return;\n  }\n\n  if (toolName === 'submit_plan') {\n    // Request permission for plan approval\n    const req: RequestPermissionRequest = {\n      sessionId: state.sessionId,\n      toolCall: {\n        toolCallId,\n        title: toolName,\n        rawInput: JSON.stringify(args),\n      },\n      options: [\n        { optionId: 'approve', name: 'Approve Plan', kind: 'allow_once' },\n        { optionId: 'reject', name: 'Reject Plan', kind: 'reject_once' },\n      ],\n    };\n\n    try {\n      const resp = await connection.requestPermission(req);\n      const action =\n        resp.outcome.outcome === 'selected' && resp.outcome.optionId === 'approve' ? 'approved' : 'rejected';\n      void session.respondToToolSuspension({ toolCallId, resumeData: { action } });\n    } catch {\n      void session.respondToToolSuspension({ toolCallId, resumeData: { action: 'rejected' } });\n    }\n    return;\n  }\n\n  // For ask_user and other suspensions, auto-resolve\n  void session.respondToToolSuspension({\n    toolCallId,\n    resumeData: 'Proceed with your best judgment. Do not ask further questions.',\n  });\n}\n\nfunction accumulateUsage(target: TokenUsage, usage: TokenUsage): void {\n  target.promptTokens += usage.promptTokens;\n  target.completionTokens += usage.completionTokens;\n  target.totalTokens += usage.totalTokens;\n  if (usage.reasoningTokens) target.reasoningTokens = (target.reasoningTokens ?? 0) + usage.reasoningTokens;\n  if (usage.cachedInputTokens) target.cachedInputTokens = (target.cachedInputTokens ?? 0) + usage.cachedInputTokens;\n  if (usage.cacheCreationInputTokens) {\n    target.cacheCreationInputTokens = (target.cacheCreationInputTokens ?? 0) + usage.cacheCreationInputTokens;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/acp/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Entry point for ACP server mode.
+ * Initializes mastracode and runs the ACP protocol over stdio.
+ */
+export declare function acpMain(options?: {
+    dangerousAutoApprove?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/acp/index.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAsB,OAAO,CAAC,OAAO,CAAC,EAAE;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8DzF"}

package/dist/acp/index.js

@@ -0,0 +1,54 @@
+import { createMastraCode } from "../index.js";
+import { releaseAllThreadLocks } from "../utils/thread-lock.js";
+import { setAutoApprove } from "./event-mapper.js";
+import { runAcpServer } from "./server.js";
+async function acpMain(options) {
+  if (options?.dangerousAutoApprove) {
+    setAutoApprove(true);
+  }
+  const originalConsoleLog = console.log;
+  console.log = (...args) => {
+    process.stderr.write(args.map(String).join(" ") + "\n");
+  };
+  let result;
+  try {
+    result = await createMastraCode({
+      unixSocketPubSub: false,
+      disableMcp: false,
+      disableHooks: false
+    });
+    const { controller, mcpManager, signalsPubSub } = result;
+    const modes = [
+      { id: "build", name: "Build" },
+      { id: "plan", name: "Plan" },
+      { id: "fast", name: "Fast" }
+    ];
+    const cleanup = async () => {
+      releaseAllThreadLocks();
+      const closeSignalsPubSub = signalsPubSub?.close;
+      await Promise.allSettled([
+        mcpManager?.disconnect(),
+        controller?.getMastra()?.stopWorkers(),
+        controller?.stopIntervals(),
+        closeSignalsPubSub?.()
+      ]);
+      console.log = originalConsoleLog;
+    };
+    const handleSignal = async () => {
+      await cleanup();
+      process.exit(0);
+    };
+    process.on("SIGINT", handleSignal);
+    process.on("SIGTERM", handleSignal);
+    await runAcpServer(controller, modes, cleanup);
+  } catch (error) {
+    process.stderr.write(`[acp] Fatal error: ${error}
+`);
+    console.log = originalConsoleLog;
+    process.exit(1);
+  }
+}
+export {
+  acpMain
+};
+//# sourceMappingURL=index.js.map

package/dist/acp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/acp/index.ts"],"sourcesContent":["import type { AgentControllerMode } from '@mastra/core/agent-controller';\n\nimport { createMastraCode } from '../index.js';\nimport { releaseAllThreadLocks } from '../utils/thread-lock.js';\nimport { setAutoApprove } from './event-mapper.js';\nimport { runAcpServer } from './server.js';\n\n/**\n * Entry point for ACP server mode.\n * Initializes mastracode and runs the ACP protocol over stdio.\n */\nexport async function acpMain(options?: { dangerousAutoApprove?: boolean }): Promise<void> {\n  if (options?.dangerousAutoApprove) {\n    setAutoApprove(true);\n  }\n  // Redirect console.log to stderr to avoid polluting the JSON-RPC stream on stdout.\n  // eslint-disable-next-line no-console\n  const originalConsoleLog = console.log;\n  // eslint-disable-next-line no-console\n  console.log = (...args: unknown[]) => {\n    process.stderr.write(args.map(String).join(' ') + '\\n');\n  };\n\n  let result: Awaited<ReturnType<typeof createMastraCode>> | undefined;\n\n  try {\n    result = await createMastraCode({\n      unixSocketPubSub: false,\n      disableMcp: false,\n      disableHooks: false,\n    });\n\n    const { controller, mcpManager, signalsPubSub } = result;\n\n    // Default modes (same as createMastraCode defaults)\n    const modes: AgentControllerMode[] = [\n      { id: 'build', name: 'Build' },\n      { id: 'plan', name: 'Plan' },\n      { id: 'fast', name: 'Fast' },\n    ];\n\n    // Cleanup function (mirrors main.ts asyncCleanup)\n    const cleanup = async () => {\n      releaseAllThreadLocks();\n      const closeSignalsPubSub = (signalsPubSub as { close?: () => Promise<void> | void } | undefined)?.close;\n      await Promise.allSettled([\n        mcpManager?.disconnect(),\n        controller?.getMastra()?.stopWorkers(),\n        controller?.stopIntervals(),\n        closeSignalsPubSub?.(),\n      ]);\n\n      // Restore console.log\n      // eslint-disable-next-line no-console\n      console.log = originalConsoleLog;\n    };\n\n    // Handle signals\n    const handleSignal = async () => {\n      await cleanup();\n      process.exit(0);\n    };\n\n    process.on('SIGINT', handleSignal);\n    process.on('SIGTERM', handleSignal);\n\n    await runAcpServer(controller, modes, cleanup);\n  } catch (error) {\n    process.stderr.write(`[acp] Fatal error: ${error}\\n`);\n    // eslint-disable-next-line no-console\n    console.log = originalConsoleLog;\n    process.exit(1);\n  }\n}\n"],"mappings":"AAEA,SAAS,wBAAwB;AACjC,SAAS,6BAA6B;AACtC,SAAS,sBAAsB;AAC/B,SAAS,oBAAoB;AAM7B,eAAsB,QAAQ,SAA6D;AACzF,MAAI,SAAS,sBAAsB;AACjC,mBAAe,IAAI;AAAA,EACrB;AAGA,QAAM,qBAAqB,QAAQ;AAEnC,UAAQ,MAAM,IAAI,SAAoB;AACpC,YAAQ,OAAO,MAAM,KAAK,IAAI,MAAM,EAAE,KAAK,GAAG,IAAI,IAAI;AAAA,EACxD;AAEA,MAAI;AAEJ,MAAI;AACF,aAAS,MAAM,iBAAiB;AAAA,MAC9B,kBAAkB;AAAA,MAClB,YAAY;AAAA,MACZ,cAAc;AAAA,IAChB,CAAC;AAED,UAAM,EAAE,YAAY,YAAY,cAAc,IAAI;AAGlD,UAAM,QAA+B;AAAA,MACnC,EAAE,IAAI,SAAS,MAAM,QAAQ;AAAA,MAC7B,EAAE,IAAI,QAAQ,MAAM,OAAO;AAAA,MAC3B,EAAE,IAAI,QAAQ,MAAM,OAAO;AAAA,IAC7B;AAGA,UAAM,UAAU,YAAY;AAC1B,4BAAsB;AACtB,YAAM,qBAAsB,eAAsE;AAClG,YAAM,QAAQ,WAAW;AAAA,QACvB,YAAY,WAAW;AAAA,QACvB,YAAY,UAAU,GAAG,YAAY;AAAA,QACrC,YAAY,cAAc;AAAA,QAC1B,qBAAqB;AAAA,MACvB,CAAC;AAID,cAAQ,MAAM;AAAA,IAChB;AAGA,UAAM,eAAe,YAAY;AAC/B,YAAM,QAAQ;AACd,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,YAAQ,GAAG,UAAU,YAAY;AACjC,YAAQ,GAAG,WAAW,YAAY;AAElC,UAAM,aAAa,YAAY,OAAO,OAAO;AAAA,EAC/C,SAAS,OAAO;AACd,YAAQ,OAAO,MAAM,sBAAsB,KAAK;AAAA,CAAI;AAEpD,YAAQ,MAAM;AACd,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}

package/dist/acp/server.d.ts

@@ -0,0 +1,7 @@
+import type { AgentController, AgentControllerMode } from '@mastra/core/agent-controller';
+/**
+ * Run the ACP server over stdio.
+ * This sets up the JSON-RPC stream and keeps the process alive until the client disconnects.
+ */
+export declare function runAcpServer(controller: AgentController, modes: AgentControllerMode[], cleanup?: () => Promise<void>): Promise<void>;
+//# sourceMappingURL=server.d.ts.map