@agentproto/adapter-mastracode 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agentproto contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MASTRACODE.md

@@ -0,0 +1,32 @@
+---
+name: mastracode
+id: mastracode
+description: Mastra Code terminal coding agent via its documented headless CLI.
+version: 0.1.0
+bin: npx
+bin_args: ["-y", "mastracode"]
+install:
+  - method: npm
+    package: mastracode
+    global: true
+version_check:
+  cmd: npm view mastracode version
+  parse: '(\d+\.\d+\.\d+)'
+  range: ">=0.26.0"
+  timeout_ms: 15000
+sandbox: ./SANDBOX.md
+protocol: print
+tags: ["mastracode", "mastra", "print", "agent-runtime", "coding"]
+---
+
+# Mastra Code adapter
+
+This adapter wraps Mastra Code as an AIP-45 agent CLI using the currently
+documented headless command surface:
+
+```sh
+npx -y mastracode --prompt "Fix the bug" --output jsonl
+```
+
+As of 2026-06-30, `mastracode acp --help` prints the top-level CLI help rather
+than ACP-specific usage, so this adapter is intentionally not marked as ACP.

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { AgentCliHandle, AgentCliRuntime } from '@agentproto/driver-agent-cli';
+export { AgentCliHandle, AgentCliRuntime } from '@agentproto/driver-agent-cli';
+
+/**
+ * @agentproto/adapter-mastracode — AIP-45 adapter for Mastra Code.
+ *
+ * Mastra Code does not currently expose a discoverable ACP subcommand
+ * (`mastracode acp --help` prints the top-level CLI help). We spawn
+ * its documented headless CLI via `npx -y mastracode` and mark this
+ * adapter as a print/headless protocol arm rather than claiming ACP.
+ *
+ *   import { mastracode, mastracodeRuntime } from "@agentproto/adapter-mastracode"
+ *   const session = await mastracodeRuntime().start()
+ *   for await (const evt of session.send({ role: "user", content: "..." })) {
+ *     console.log(evt)
+ *   }
+ *   await session.close()
+ */
+
+declare const mastracode: AgentCliHandle;
+declare function mastracodeRuntime(): AgentCliRuntime;
+
+export { mastracode, mastracodeRuntime };

package/dist/index.mjs

@@ -0,0 +1,138 @@
+import { defineAgentCli, createAgentCliRuntime } from '@agentproto/driver-agent-cli';
+
+/**
+ * @agentproto/adapter-mastracode v0.1.0-alpha
+ * AIP-45 adapter for Mastra Code via its headless CLI mode.
+ */
+
+var mastracode = defineAgentCli({
+  name: "mastracode",
+  id: "mastracode",
+  description: "Mastra Code \u2014 terminal-based AI coding agent with persistent threads, tools, modes, and multi-provider model support. Current CLI exposes TUI/headless operation, not ACP; spawned via `npx -y mastracode`.",
+  version: "0.1.0",
+  bin: "npx",
+  bin_args: ["-y", "mastracode"],
+  install: [{ method: "npm", package: "mastracode", global: true }],
+  version_check: {
+    cmd: "npm view mastracode version",
+    parse: "(\\d+\\.\\d+\\.\\d+)",
+    range: ">=0.26.0",
+    timeout_ms: 15e3
+  },
+  auth: {
+    ref: "./SECRETS.md",
+    state: {
+      env: [
+        "ANTHROPIC_API_KEY",
+        "OPENAI_API_KEY",
+        "OPENROUTER_API_KEY",
+        "GOOGLE_GENERATIVE_AI_API_KEY"
+      ]
+    }
+  },
+  sandbox: "./SANDBOX.md",
+  protocol: "print",
+  print: {
+    prompt_flag: "--prompt",
+    output_format: ["--output", "jsonl"],
+    pre_prompt: [],
+    resume: { flag: "--thread", kind: "value" },
+    event_schema: "mastra-jsonl"
+  },
+  session: {
+    mode: "ephemeral",
+    idle_timeout_ms: 18e5,
+    context_carryover: false
+  },
+  models: {
+    default: "anthropic/claude-sonnet-4-5",
+    allowed: [
+      "anthropic/claude-sonnet-4-5",
+      "anthropic/claude-sonnet-4-6",
+      "openai/gpt-5.1",
+      "openai/gpt-5.1-mini",
+      "google/gemini-2.5-flash",
+      "openrouter/anthropic/claude-sonnet-4-6"
+    ],
+    env: {
+      anthropic: "ANTHROPIC_API_KEY",
+      openai: "OPENAI_API_KEY",
+      openrouter: "OPENROUTER_API_KEY",
+      google: "GOOGLE_GENERATIVE_AI_API_KEY"
+    }
+  },
+  capabilities: {
+    streaming: true,
+    tool_calls: true,
+    sub_agents: true,
+    file_io: true,
+    multimodal: false,
+    // `mastracode --thread <id>` reattaches to a prior thread with real
+    // persisted memory (confirmed cross-process: separate spawn, same
+    // thread id, correct continuity). `print.resume` below drives this.
+    resumable: true,
+    bidirectional: false
+  },
+  modes: [
+    {
+      id: "default",
+      description: "Default headless mode. Mastra Code defaults to build mode when omitted."
+    },
+    {
+      id: "plan",
+      description: "Plan-only mode \u2014 analyze architecture and propose implementation plans before writing code.",
+      bin_args_append: ["--mode", "plan"]
+    },
+    {
+      id: "build",
+      description: "Build mode \u2014 file edits and shell commands use Mastra Code's configured permissions.",
+      bin_args_append: ["--mode", "build"]
+    },
+    {
+      id: "fast",
+      description: "Fast mode \u2014 lower-latency answers and small edits.",
+      bin_args_append: ["--mode", "fast"]
+    }
+  ],
+  options: [
+    {
+      id: "model",
+      type: "string",
+      description: "Provider/model override for this operator binding (e.g. `anthropic/claude-sonnet-4-5`).",
+      bin_args_template: ["--model", "{value}"]
+    },
+    {
+      id: "thinking_level",
+      type: "enum",
+      enum: ["off", "low", "medium", "high", "xhigh"],
+      description: "Thinking level passed to Mastra Code.",
+      bin_args_template: ["--thinking-level", "{value}"]
+    },
+    {
+      id: "timeout",
+      type: "integer",
+      min: 1,
+      max: 86400,
+      description: "Maximum headless run duration in seconds.",
+      bin_args_template: ["--timeout", "{value}"]
+    }
+  ],
+  continuation: {
+    default: "none",
+    supported: ["none", "transcript", "native-resume"]
+  },
+  metadata: {
+    acp: {
+      checked: "2026-06-30",
+      result: "`mastracode acp --help` prints top-level Mastra Code help; no ACP subcommand is currently discoverable."
+    }
+  },
+  tags: ["mastracode", "mastra", "print", "agent-runtime", "coding"]
+});
+function mastracodeRuntime() {
+  return createAgentCliRuntime(mastracode);
+}
+
+export { mastracode, mastracodeRuntime };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * @agentproto/adapter-mastracode — AIP-45 adapter for Mastra Code.\n *\n * Mastra Code does not currently expose a discoverable ACP subcommand\n * (`mastracode acp --help` prints the top-level CLI help). We spawn\n * its documented headless CLI via `npx -y mastracode` and mark this\n * adapter as a print/headless protocol arm rather than claiming ACP.\n *\n *   import { mastracode, mastracodeRuntime } from \"@agentproto/adapter-mastracode\"\n *   const session = await mastracodeRuntime().start()\n *   for await (const evt of session.send({ role: \"user\", content: \"...\" })) {\n *     console.log(evt)\n *   }\n *   await session.close()\n */\n\nimport {\n  createAgentCliRuntime,\n  defineAgentCli,\n  type AgentCliHandle,\n  type AgentCliRuntime,\n} from \"@agentproto/driver-agent-cli\"\n\nexport const mastracode: AgentCliHandle = defineAgentCli({\n  name: \"mastracode\",\n  id: \"mastracode\",\n  description:\n    \"Mastra Code — terminal-based AI coding agent with persistent threads, tools, modes, and multi-provider model support. Current CLI exposes TUI/headless operation, not ACP; spawned via `npx -y mastracode`.\",\n  version: \"0.1.0\",\n  bin: \"npx\",\n  bin_args: [\"-y\", \"mastracode\"],\n  install: [{ method: \"npm\", package: \"mastracode\", global: true }],\n  version_check: {\n    cmd: \"npm view mastracode version\",\n    parse: \"(\\\\d+\\\\.\\\\d+\\\\.\\\\d+)\",\n    range: \">=0.26.0\",\n    timeout_ms: 15_000,\n  },\n  auth: {\n    ref: \"./SECRETS.md\",\n    state: {\n      env: [\n        \"ANTHROPIC_API_KEY\",\n        \"OPENAI_API_KEY\",\n        \"OPENROUTER_API_KEY\",\n        \"GOOGLE_GENERATIVE_AI_API_KEY\",\n      ],\n    },\n  },\n  sandbox: \"./SANDBOX.md\",\n  protocol: \"print\",\n  print: {\n    prompt_flag: \"--prompt\",\n    output_format: [\"--output\", \"jsonl\"],\n    pre_prompt: [],\n    resume: { flag: \"--thread\", kind: \"value\" },\n    event_schema: \"mastra-jsonl\",\n  },\n  session: {\n    mode: \"ephemeral\",\n    idle_timeout_ms: 1_800_000,\n    context_carryover: false,\n  },\n  models: {\n    default: \"anthropic/claude-sonnet-4-5\",\n    allowed: [\n      \"anthropic/claude-sonnet-4-5\",\n      \"anthropic/claude-sonnet-4-6\",\n      \"openai/gpt-5.1\",\n      \"openai/gpt-5.1-mini\",\n      \"google/gemini-2.5-flash\",\n      \"openrouter/anthropic/claude-sonnet-4-6\",\n    ],\n    env: {\n      anthropic: \"ANTHROPIC_API_KEY\",\n      openai: \"OPENAI_API_KEY\",\n      openrouter: \"OPENROUTER_API_KEY\",\n      google: \"GOOGLE_GENERATIVE_AI_API_KEY\",\n    },\n  },\n  capabilities: {\n    streaming: true,\n    tool_calls: true,\n    sub_agents: true,\n    file_io: true,\n    multimodal: false,\n    // `mastracode --thread <id>` reattaches to a prior thread with real\n    // persisted memory (confirmed cross-process: separate spawn, same\n    // thread id, correct continuity). `print.resume` below drives this.\n    resumable: true,\n    bidirectional: false,\n  },\n  modes: [\n    {\n      id: \"default\",\n      description:\n        \"Default headless mode. Mastra Code defaults to build mode when omitted.\",\n    },\n    {\n      id: \"plan\",\n      description:\n        \"Plan-only mode — analyze architecture and propose implementation plans before writing code.\",\n      bin_args_append: [\"--mode\", \"plan\"],\n    },\n    {\n      id: \"build\",\n      description:\n        \"Build mode — file edits and shell commands use Mastra Code's configured permissions.\",\n      bin_args_append: [\"--mode\", \"build\"],\n    },\n    {\n      id: \"fast\",\n      description: \"Fast mode — lower-latency answers and small edits.\",\n      bin_args_append: [\"--mode\", \"fast\"],\n    },\n  ],\n  options: [\n    {\n      id: \"model\",\n      type: \"string\",\n      description:\n        \"Provider/model override for this operator binding (e.g. `anthropic/claude-sonnet-4-5`).\",\n      bin_args_template: [\"--model\", \"{value}\"],\n    },\n    {\n      id: \"thinking_level\",\n      type: \"enum\",\n      enum: [\"off\", \"low\", \"medium\", \"high\", \"xhigh\"],\n      description: \"Thinking level passed to Mastra Code.\",\n      bin_args_template: [\"--thinking-level\", \"{value}\"],\n    },\n    {\n      id: \"timeout\",\n      type: \"integer\",\n      min: 1,\n      max: 86_400,\n      description: \"Maximum headless run duration in seconds.\",\n      bin_args_template: [\"--timeout\", \"{value}\"],\n    },\n  ],\n  continuation: {\n    default: \"none\",\n    supported: [\"none\", \"transcript\", \"native-resume\"],\n  },\n  metadata: {\n    acp: {\n      checked: \"2026-06-30\",\n      result:\n        \"`mastracode acp --help` prints top-level Mastra Code help; no ACP subcommand is currently discoverable.\",\n    },\n  },\n  tags: [\"mastracode\", \"mastra\", \"print\", \"agent-runtime\", \"coding\"],\n})\n\nexport function mastracodeRuntime(): AgentCliRuntime {\n  return createAgentCliRuntime(mastracode)\n}\n\nexport type { AgentCliHandle, AgentCliRuntime }\n"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@agentproto/adapter-mastracode",
+  "version": "0.2.0",
+  "description": "@agentproto/adapter-mastracode — AIP-45 AGENT-CLI adapter for Mastra Code. Spawns the documented headless CLI via `npx -y mastracode`; current Mastra Code does not expose a discoverable ACP subcommand.",
+  "keywords": [
+    "agentproto",
+    "aip-45",
+    "mastracode",
+    "mastra",
+    "print",
+    "agent-cli",
+    "adapter"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-45",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "adapters/mastracode"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./MASTRACODE.md": "./MASTRACODE.md",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "MASTRACODE.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agentproto/driver-agent-cli": "0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@agentproto/tooling": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}