acpx 0.6.0

Changes

• CLI/claude: add --system-prompt <text> and --append-system-prompt <text> global flags that forward through ACP _meta.systemPrompt on session/new, letting callers replace or append to the Claude Code system prompt without dropping out of persistent acpx sessions. The value is persisted in session_options.system_prompt so ensure/reuse flows keep the override. Codex and other agents ignore the field. (#229) Thanks @Vercantez.
• CLI/sessions: add sessions prune with --dry-run, age filters, and --include-history so closed session records and optional event streams can be cleaned up explicitly. (#227) Thanks @coder999999999.
• Runtime/embedding: add startTurn(...) turn handles so embedders can observe live runtime events separately from terminal completion, cancel a turn, or close only the event stream while preserving runTurn(...) compatibility. (#262) Thanks @enki.
• CLI/ACP: add --no-terminal to disable advertised ACP terminal capability for new agent clients. (#155) Thanks @DMQ.
• Agents/built-ins: bump the default @agentclientprotocol/claude-agent-acp, @zed-industries/codex-acp, and pi-acp package ranges so fresh built-in launches pick up the latest adapter releases. (#253, #275) Thanks @flowforgelab.
• Conformance/ACP: add a post-success drain case that catches late tool updates emitted after session/prompt resolves. (#252) Thanks @logofet85-ai.
• Docs/session identity: clarify when CLI output shows ACPX runtime session IDs versus backend agent session IDs.
• Dependencies/CI: update ACP SDK, runtime dependencies, TypeScript-native tooling, formatter/lint tooling, and workflow actions.

Breaking

Fixes

• CLI/runtime: persist non-mode session/set_config_option values and replay them on fresh adapter sessions, so options such as Codex reasoning_effort survive session fallback/reuse. (#138)
• CLI/prompt: honor --model when sending prompts to existing persistent sessions, including queued owner paths. (#211) Thanks @skywills.
• Runtime/persistent sessions: keep reusable persistent ACP clients warm across turns and close pooled clients during runtime close. (#265) Thanks @Sway-Chan.
• Runtime/ACP: drain late post-success session updates before closing prompt turns so adapters that resolve session/prompt before final updates do not drop assistant output. (#251) Thanks @logofet85-ai.
• Runtime/embedding: reuse the saved persistent session when sending runtime controls instead of creating a new backend session for control operations.
• CLI/sessions: persist the submitted prompt at turn start so sessions history and sessions read no longer report No history while an active prompt is already running. (#157)
• Runtime/WSL: translate session cwd with wslpath when running under WSL and spawning Windows .exe ACP agents, so session/new and session/load receive paths the agent can access. (#232)
• Client/auth: require explicit ACPX_AUTH_* env vars or config auth entries for ACP auth-method selection, so ambient provider env like OPENAI_API_KEY no longer triggers unintended login flows in adapters such as codex-acp.
• Config/agents: honor custom agent args arrays from config instead of silently dropping required adapter subcommands. (#199) Thanks @log-li.
• CLI/queue: tighten persistent queue and IPC socket directories to owner-only permissions, including previously-created permissive directories. (#216) Thanks @garagon.
• CLI/queue: use cryptographically random owner generation IDs so rapid queue owner restarts cannot reuse a stale generation token. (#207) Thanks @Yuan-ManX.
• Output/errors: add text-mode remediation hints for auth-required, missing-session, ACP session failures, timeouts, provider rate limits, and invalid model names while keeping JSON error payloads stable. (#256) Thanks @SJeffZhang.
• CLI/quiet output: emit final token usage and cost metadata to stderr when adapters include it in the ACP prompt result, while keeping quiet stdout as assistant text only. (#257)
• CLI/status: report resumable persistent sessions as idle when no queue owner is running, instead of marking pre-prompt or TTL-expired sessions as dead. (#185)
• Client/ACP: use the locked ACP SDK close API path so session closing stays compatible with the current SDK.
• Runtime/doctor: guarantee doctor().details contains strings even when probe failures include Error or object values. (#267)
• Replay viewer: protect run-bundle file reads from run-id boundary escapes.

acpx 0.5.3

What's Changed

• [codex] upgrade vite to 8.0.7 by @hxy91819 in #231

New Contributors

• @hxy91819 made their first contribution in #231

Full Changelog: v0.5.2...v0.5.3

acpx 0.5.2

What's Changed

• fix: close backend sessions on reset by @dutifulbob in #228

Full Changelog: v0.5.1...v0.5.2

acpx 0.5.1

What's Changed

• fix: own built-in adapter launches by @dutifulbob in #226

Full Changelog: v0.5.0...v0.5.1

acpx 0.5.0

What's Changed

• feat: validate flow definitions and require defineFlow by @osolmaz in #219
• refactor: add acpx runtime embedding API by @osolmaz in #220
• Stabilize runtime prompt turns by @osolmaz in #222

Full Changelog: v0.4.1...v0.5.0

acpx 0.4.1

What's Changed

• chore(deps-dev): bump @typescript/native-preview from 7.0.0-dev.20260326.1 to 7.0.0-dev.20260328.1 by @dependabot[bot] in #203
• chore(deps): bump @agentclientprotocol/sdk from 0.17.0 to 0.17.1 in the production group by @dependabot[bot] in #200
• chore(deps-dev): bump typescript from 5.9.3 to 6.0.2 by @dependabot[bot] in #202
• feat: stream replay viewer runs live by @osolmaz in #205
• [codex] bump codex and claude ACP adapter pins by @osolmaz in #215

Full Changelog: v0.4.0...v0.4.1

acpx 0.4.0

What's Changed

• feat: add experimental acpx flows runtime and examples by @osolmaz in #179
• docs: add conflict gates to PR triage flow by @osolmaz in #180
• fix: handle -32601/-32602 in session/load fallback by @Bortlesboat in #174
• feat: add flow trace replay bundles for flow runs by @osolmaz in #181
• test: add unit tests for perf-metrics module by @Bortlesboat in #175
• docs: specify the flow replay viewer by @osolmaz in #183
• docs: specify explicit flow permission grants by @osolmaz in #186
• fix: validate maintenance PRs via standard repo checks by @osolmaz in #187
• feat: add built-in trae agent backed by trae-cli by @hqwuzhaoyi in #171
• fix: enable shell for terminal spawn on Windows by @Bortlesboat in #173
• chore(deps-dev): bump the development group across 1 directory with 7 updates by @dependabot[bot] in #177
• Add built-in Qoder ACP support by @xinyuan0801 in #178
• fix: finalize interrupted flow runs by @osolmaz in #188
• chore: bump codex and claude ACP adapter ranges by @moritzketzer in #163
• chore(deps): bump pnpm/action-setup from 4 to 5 by @dependabot[bot] in #154
• chore(deps): bump actions/upload-artifact from 4 to 7 by @dependabot[bot] in #146
• fix: add connection timeout and max buffer size limit by @Yuan-ManX in #168
• chore(deps): bump @agentclientprotocol/sdk from 0.15.0 to 0.16.1 in the production group across 1 directory by @dependabot[bot] in #131
• Let ACP validation choose PR test plans by @osolmaz in #189
• fix: support --model for codex sessions by @osolmaz in #192
• flow: broaden pr-triage refactor judgment by @osolmaz in #190
• chore(deps-dev): bump @typescript/native-preview from 7.0.0-dev.20260310.1 to 7.0.0-dev.20260311.1 by @dependabot[bot] in #133
• fix(client): cache authEnvKeys results to reduce allocations by @Yuan-ManX in #167
• feat(output): add --suppress-reads flag by @osolmaz in #193
• fix: preserve line breaks in thinking output by @osolmaz in #194
• fix: recognize Cursor session-not-found error format by @osolmaz in #195
• feat: add --prompt-retries for automatic retry on transient errors by @osolmaz in #196
• feat: add flow run title API by @osolmaz in #197
• fix: use kiro-cli-chat directly to prevent orphan child processes by @vokako in #129
• feat: generic model selection via ACP session/set_model by @ironerumi in #150

New Contributors

• @Bortlesboat made their first contribution in #174
• @hqwuzhaoyi made their first contribution in #171
• @xinyuan0801 made their first contribution in #178
• @moritzketzer made their first contribution in #163
• @Yuan-ManX made their first contribution in #168

Full Changelog: v0.3.1...v0.4.0

acpx 0.3.1

What's Changed

• feat(conformance): add data-driven ACP core v1 suite with CI/nightly coverage by @lynnzc in #130
• feat: add Factory Droid aliases by @vincentkoc in #156

Full Changelog: v0.3.0...v0.3.1

acpx 0.3.0

What's Changed

• fix: validate structured image prompt blocks by @vincentkoc in #110
• chore(deps-dev): bump tsdown from 0.21.0-beta.2 to 0.21.0 by @dependabot[bot] in #106
• chore(deps-dev): bump @typescript/native-preview from 7.0.0-dev.20260307.1 to 7.0.0-dev.20260308.1 by @dependabot[bot] in #107
• fix(windows): support .cmd/.bat agent commands by @lynnzc in #102
• fix: use --acp flag for Gemini CLI instead of deprecated --experimental-acp by @imWildCat in #113
• feat: Add Factory Droid as built-in agent by @ironerumi in #112
• feat: add iflow agent support by @gandli in #109
• chore(deps-dev): bump tsdown from 0.21.0 to 0.21.1 in the development group by @dependabot[bot] in #118
• chore(deps-dev): bump the development group with 4 updates by @dependabot[bot] in #125
• fix: count client-method permission denials in permission stats by @lynnzc in #120
• fix: suppress recoverable session/load fallback errors by @lynnzc in #122
• fix: clarify unsupported session control errors by @manthan787 in #123
• fix: close codex-acp session config gaps by @vincentkoc in #127
• chore(deps-dev): bump @typescript/native-preview from 7.0.0-dev.20260308.1 to 7.0.0-dev.20260310.1 by @dependabot[bot] in #126

New Contributors

• @dependabot[bot] made their first contribution in #106
• @lynnzc made their first contribution in #102
• @imWildCat made their first contribution in #113
• @ironerumi made their first contribution in #112
• @manthan787 made their first contribution in #123

Full Changelog: v0.2.0...v0.3.0

acpx 0.2.0

What's Changed

• docs: add missing changelog entries for #86 and #87 by @vincentkoc in #104
• fix: preserve structured ACP prompt blocks by @vincentkoc in #103
• docs: align changelog with openclaw style by @vincentkoc in #105
• Clean up duplicate ACP and queue helpers by @vincentkoc in #108

Full Changelog: v0.1.16...v0.2.0