Changelog
New updates and improvements to OpenCode
v2.3.1 Timed-Out Shell Commands Keep Running
A shell command still running when its timeout expires now moves to the background instead of being killed, so long builds and test runs finish and report back. A foreground
timeout: 0now means the default 120 seconds.#63699 See all highlights in v2.3.1Compaction Without the Wait
As a session nears automatic compaction, the summary is now written in the background, so your next prompt doesn't pause for it. Set
compaction.background: falseto turn it off; a background summary that ends up unused still costs tokens.#64290Improvements
- Core, SDKServer requests that crash now return a 500 with a readable JSON
UnknownErrorbody instead of an empty one. Storage problems name the cause (for example "Storage is full" or "Storage is read-only"); other crashes include arefyou can find in the server log.#64022 - Core, SDKExperimental schedules are now automations, behind the
automationsflag (the oldschedulesflag still works). An automation runs on a time, an interval, a cron or a pushed MCP event, and either sends a prompt (to the creating session, another session or a new subagent) or runs a Code Mode program that decides whether to send one. Use/automationor theautomation_*tools. Active or paused plain prompt schedules carry over; schedules with a condition or run limit, and finished ones, are dropped.#64160
Fixes
- SDKApps embedding the SDK with an in-memory database no longer import the user's legacy
auth.jsoncredentials. Only a database file opened by path imports them.#63716
- Core, SDKServer requests that crash now return a 500 with a readable JSON
v2.3.0 Event subscriptions can now receive
See all highlights in v2.3.0experimental.mcp.eventevents from MCP event subscriptionsImprovements
- SDKModel capability schemas now advertise supported freeform tool-input formats.
- SDKSession throughput is now measured from the first streamed token.
- SDKSession creation documentation now clarifies the
parentIDfield.
v2.2.7
See all highlights in v2.2.7session.generatereturnstokensandcostalong withtextBreaking changes
SDK: fewer endpoints wait for plugins to load
On a Location that is still loading plugins,
#62796#63040agent.listreturns the agents loaded so far, andintegration.list,usage.limits,vcs.init,rpc.callandartifact.*no longer wait up to 5 seconds. Entries and actions that a plugin provides appear when it finishes loading, so refresh on the matching*.updatedevent. Model, provider,generate.*,voice.*andwebsearch.queryendpoints still wait.Improvements
v2.2.6 Improvements
See all highlights in v2.2.6Improvements
- SDKAdded
client.experimental.job.list()and its Effect equivalent for listing background shell, subagent, and image jobs, with session, descendant, kind, and status filters.#60698 - SDKServer embedders can provide a custom
fetchimplementation for OpenCode HTTP, model, web, and remote MCP traffic.#61582
- SDKAdded
v2.2.4 Publish Interactive Artifacts
Enable
See all highlights in v2.2.4"experimental": { "artifacts": true }inopencode.jsonto let agents publish, update, and serve HTML or static artifacts through the built-in local provider or plugin-provided storage.#60351Improvements
- SDKExtended
client.experimental.persistentPty.updateto rename terminals or clear a user title, and exposeduserTitlepluspersistent-pty.updatedevents.#60329
- SDKExtended
v2.2.3 Added lazy loading for stored image references when
experimental.media_blobis enabledAdded lazy loading for stored image references when
See all highlights in v2.2.3experimental.media_blobis enabled. Images are downloaded only for previews, while undo, revert, fork, and prompt recall restore referenced attachments safely.#60116Improvements
- SDKPreserved partial
LLMResponseoutput onAIError.partialwhen generation, object generation, or a tool loop fails.#60477 - SDKUnified Effect and Promise tool declarations around
tool(...), with optional output schemas and executable or declaration-only tools.#60407 - SDKAdded typed OpenRouter
debug,models,plugins,provider, anduseroptions to the Responses route.#60044
Fixes
- SDKMatched the Promise AI client more closely to the Effect API and accepted typed tools in loops.#60465#60390
- SDKKept tools whose
executehandler can throw available to the AI client.#60431 - SDKContinued polling queued media generations when providers return unknown intermediate statuses.#59988
- SDKStopped sending an incompatible
filenamealongsidefile_urlon OpenAI Responses requests.#60382
- SDKPreserved partial
v2.2.2 Exposed
See all highlights in v2.2.2SessionInfo.time.busyfor the latest execution’s start timeImprovements
- SDKAdded
ifanduntilinputs forclient.experimental.schedule.create, plus schedule check results and output fields.#60137 - SDKAdded optional source metadata to prompt file attachments.
- SDKAdded
v2.2.1 Group experimental generated-client methods under
client.experimentalGroup experimental generated-client methods under
See all highlights in v2.2.1client.experimental; previous locations remain as deprecated aliases until the next minor release.#59072Improvements
v2.2.0 Create, install and share Desktop plugins (experimental)
See all highlights in v2.2.0Fixes
- SDKFix generated Promise client input types for TypeScript consumers.#58875
- SDKLet SDK clients discard inline tool-result file payloads to reduce memory use.#59101
- SDKAvoid unnecessary catalog refreshes for locations an SDK client has not loaded.#55237#59099
- SDKRestore running sessions created while an SDK client was disconnected.#53012
- SDKRelease omitted tool-image payloads from memory instead of retaining their base64 data.#58560
v1.17.12 Add a live event subscription stream
Improvements
- SDKAdd SDK access to active sessions.
- SDKRestore session runtime operations such as event streaming, interrupts, and message lookup.
- SDKAdd paged durable session history.
- SDKAdd session permission request create and fetch endpoints.
Fixes
- SDKPreserve
V2Eventnames in SSE streams. - SDKWake embedded session execution after new prompts.
- SDKImprove V2 runtime tool results and avoid duplicate model switch events.
- SDKResolve MIME types for prompt attachments sent by URI.