v0.13.0
Summary
Adds a streamable HTTP transport to aptu-coder, enabling multi-agent environments where an orchestrator and all delegates must share a single server process. Start with --port N or set APTU_CODER_PORT=N; stdio mode is unchanged when neither is set. A brew services start aptu-coder workflow is now the recommended single-step setup for persistent HTTP mode. This release also hardens the CI release workflow against concurrent creation races and removes a no-longer-used MCP server config entry.
What's Changed
Features
- Streamable HTTP transport (
--port): A new--port NCLI flag starts a stateless streamable HTTP MCP server on127.0.0.1:Nusing rmcp 1.6'sStreamableHttpService. HTTP mode is multi-tenant; all sessions connect to one shared process simultaneously, removing the mutual exclusivity betweenaptu-coderanddeveloperextensions in goose session trees. When--portis absent, the existing stdio path is unchanged.NeverSessionManageris used because tools are pure functions with no cross-call state;json_response: trueeliminates SSE framing overhead (#885) APTU_CODER_PORTenv var: When--portis not passed, the server now checksAPTU_CODER_PORTbefore falling back to stdio, enablingbrew services start aptu-coderas a zero-argument persistent HTTP setup.--porttakes precedence over the env var. The default example port is updated from3042(IANA-registered to "journee", defunct since 2003) to49200, which is in the RFC 6335 §6 dynamic/private range (49152--65535) explicitly reserved for unregistered ephemeral and private use. The server binds exclusively to127.0.0.1(#888)
Bug Fixes
- CI release idempotency: The
create-releaseworkflow step now appends a trailinggh release viewaftergh release create, making the step resilient to concurrent creation races (HTTP 422Release.tag_name already exists). Previously, a race between a manual release creation and the workflow caused all downstream jobs (build-and-attest, crates.io, Homebrew, MCPB, MCP Registry) to be skipped (#882)
Chores
- Remove
aptuMCP server entry:.mcp.jsonno longer registersaptuas an MCP server; theaptuCLI is used directly instead (#883)
Documentation
- README.md: Quick Start reordered to lead with streamable HTTP and
brew services;APTU_CODER_PORTadded to the env var table; JSONL metrics path corrected from$XDG_DATA_HOME/aptu-coder/metrics/to$XDG_DATA_HOME/aptu-coder/; Documentation section sorted alphabetically; AGENTS.md entry added (#886) - docs/ARCHITECTURE.md: Updated tool count reference from seven to nine;
main.rsmodule description updated to mention--port(#886) - docs/DESIGN-GUIDE.md: Updated "seven tools" to nine throughout;
remote_tree/remote_fileadded to the tool responsibility table (#886) - docs/ROADMAP.md: Streamable HTTP transport marked complete; moved from tentative backlog to completed entries (#886)
- CONTRIBUTING.md: Removed empty
## Planned enhancementsheading (#886)
Breaking Changes
None - this release is fully backward compatible with v0.12.1.
Full Changelog: v0.12.1...v0.13.0