You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
AgentSideConnection, ClientSideConnection, Agent, Client, LegacyAgentFactory, createLegacyAgent, and their extension aliases and connector helper have been removed. Use agent()/client() apps and peer-context request()/notify() calls. Compiled tests, fixtures, and examples are no longer published. See MIGRATION_STABLE_UNSTABLE.md for migration instructions.
Default v1 and experimental v2 imports now expose only stable-feature schemas. Unstable v1 features require @agentclientprotocol/sdk/unstable; unstable v2 features require @agentclientprotocol/sdk/experimental/v2/unstable. Both v2 entrypoints remain experimental. SDK 2.0 does not switch the default protocol from ACP v1. The unversioned JSON schema export is removed; use the versioned schema/v1 or schema/v2 exports. All legacy v1 integrations must migrate to agent()/client() apps regardless of feature profile; opting into /unstable does not restore the removed connection classes or connector helper. See https://github.com/agentclientprotocol/typescript-sdk/blob/main/MIGRATION_STABLE_UNSTABLE.md for migration instructions.
Features
make stable protocol bindings the default (6caf469)
retire legacy connection APIs and publish production-only builds (#294) (52edc15)
minWidth and maxWidth on <Box> now only accept numbers (#1029) 7cd7fd9
Percentage strings were never documented as supported, and Yoga resolved them against the wrong ancestor
stdin, stdout, and stderr are now typed as generic Node.js streams (#981) eb82d8f
This applies to the render() options and to useStdin(), useStdout(), and useStderr(). TTY-only properties like stdout.columns are no longer part of the types
useInput no longer receives unrecognized terminal control sequences (#1014) c76893e
Mouse reports, focus in/out events, cursor position reports, and other terminal replies used to arrive in input with the ESC stripped, as if typed. They are now dropped
Fix screen-reader output: semantic text and labels, empty <Transform> labels, rewrapping when the terminal widens, and restoring output after console writes (#1028) f480301bebfe2d
Fix error source excerpts for file URLs and multiline messages, and treat non-Error throws as rendering failures 81e2451
Fix renderToString() swallowing thrown undefined, and run effect cleanup when output rendering fails 9f7c1d0
Fix useWindowSize() missing resizes before it subscribes fab670b
Track box metrics when a child attaches the ref after mount 53244dc
useStdout().stdout is now typed as NodeJS.WritableStream, so TTY properties like columns and rows are no longer available in the types. Use useWindowSize() instead, which also re-renders on resize.
If your useInput handler parsed mouse reports, focus events, or other terminal replies from input, it will no longer receive them. Keys that Ink recognizes, including Kitty keyboard protocol events, are not affected.
Changed the optional canvas and image decoding backend from canvas to @napi-rs/canvas. Install @napi-rs/canvas v1.0.13 or later in the v1.x series alongside jsdom; installing canvas alone no longer enables this support. The new backend provides prebuilt Skia binaries on supported platforms, and rendering and encoded image bytes can differ. Projects using native canvas objects or custom font registration should follow the canvas migration guidance. Added WebP serialization through canvas.toDataURL() and canvas.toBlob(). Fixed image loading to wait for decoding before firing load, discard obsolete source requests, avoid refetching when dimensions change, and prevent failed images from drawing stale contents. Fixed canvas context and serialization behavior, including unsupported context types, read-only ctx.canvas, image-drawing exceptions, MIME type and quality normalization, and asynchronous null results from canvas.toBlob() for empty canvases or encoding failures. (@Brooooooklyn)
Changed CSS parsing, selector matching, and computed styles to use a new integrated implementation, with substantially expanded support and faster selector queries and repeated style reads. This includes cascade layers, nesting, @scope, custom-property substitution and registration through @property and CSS.registerProperty(), typed attr(), conditional if(), shadow-tree styling with :host, ::slotted(), and ::part(), pseudo-element computed styles, and constructable stylesheets with document.adoptedStyleSheets and shadowRoot.adoptedStyleSheets. Fixed numerous cascade, shorthand, serialization, and default-style issues; computed declarations now stay live across DOM and stylesheet changes. CSS serialization and computed values can differ from previous releases.
Changed HTML and XML parsing to pause at blocking scripts until their required resources are ready. The JSDOM constructor, JSDOM.fromURL(), and JSDOM.fromFile() can now return partially parsed documents. Wait for DOMContentLoaded for the finished tree, or the window's load event for load-delaying resources, checking document.readyState first in case the event has already fired. XML syntax errors encountered after asynchronous parsing resumes are reported through the virtual console as "xml-parsing" errors.
Other changes
Added window.reportError(), which dispatches an error event and reports uncanceled errors to the virtual console. (@sarankumar1325)
Added element.ariaBrailleLabel and element.ariaBrailleRoleDescription. (@Kjubikstronk)
Fixed page-completion load events to fire only on the window. Use window.addEventListener("load", ...) or window.onload instead of listening on the document.
Fixed document.open(), including implicit calls from document.write(), to clear event listeners and handlers from the document, its descendants, and its window when replacing the input stream.
Fixed document.write() to process successive writes through the parser's input stream, preserve insertion points across nested scripts, and make completed text immediately visible. Script-created input streams now remain open until document.close().
Fixed dynamically inserted scripts to respect script.async = false execution order, use their source text and document from preparation time, and avoid executing after adoption into another document. Scripts parsed through inert fragment APIs no longer execute when subsequently inserted.
Fixed unrelated images, stylesheets, and frames being delayed behind scripts, and resource completion events firing before nested stylesheet imports finish. Cyclic imports no longer prevent completion, and <style> elements in shadow trees now fire load events.
Fixed window.stop() to cancel pending subresource and XMLHttpRequest requests in descendant frames and suppress completion events for canceled loads, while allowing subsequent requests to proceed.
Fixed repeated document.close() calls replaying readiness and load events, and incorrect iframe load events when reopening documents from event handlers.
Fixed memory leaks where pending request interceptor promises retained closed windows, introduced in v28.0.0.
Fixed focus remaining on elements that become non-focusable after DOM or style changes. Focus now moves asynchronously to the document's viewport, and element.blur() can release it immediately.
Fixed document.hasFocus() returning false before an element is focused or during focus transitions within the document, including inside frames.
Fixed <template> parsing and template.innerHTML serialization in XML documents, including templates with namespace prefixes. (@b84330808)
Fixed rect.toJSON() and performance.toJSON() to create their result objects in the method's realm instead of the host Node.js realm.
Configuration
📅 Schedule: (in timezone Asia/Shanghai)
Branch creation
Between 12:00 AM and 06:59 AM, only on Monday (* 0-6 * * 1)
Automerge
At any time (no schedule defined)
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.
If you want to rebase/retry this PR, check this box
CI fails with 11 room-web test errors, all rooted in one break: @agentclientprotocol/sdk 2.4.0 (major) removed the AgentSideConnection export that the test fixture uses.
TypeError: acp.AgentSideConnection is not a constructor
The 2.x SDK is a redesign — the connection classes are replaced by the agent/client/AgentApp/SessionBuilder API — so the fake agent needs a rewrite against the new surface, and the protocol/handshake compatibility of the room-lab host (which does not import the connection classes directly) needs verifying before the rest of the suite can pass. ink ^8 and jsdom ^31 in the same grouped PR may add their own follow-ups.
Suggest splitting: land ink/jsdom first, then take the ACP SDK 2.x migration as its own PR with the fixture rewrite and protocol check. Marking needs-human.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
1.9.0→2.6.0^7.1.1→^8.0.0^30.1.3→^31.0.0Bot PRs carry no changeset. If this PR changes a published package's behavior, add a patch changeset per Changesets before merging.
Release Notes
agentclientprotocol/typescript-sdk (@agentclientprotocol/sdk)
v2.6.0Compare Source
Features
v2.5.0Compare Source
Features
v2.4.0Compare Source
Features
v2.3.0Compare Source
Features
Bug Fixes
v2.2.0Compare Source
Features
v2.1.0Compare Source
Features
Bug Fixes
v2.0.2Compare Source
Bug Fixes
v2.0.1Compare Source
Bug Fixes
v2.0.0Compare Source
⚠ BREAKING CHANGES
Features
Bug Fixes
vadimdemedes/ink (ink)
v8.0.0Compare Source
Breaking
7829102minWidthandmaxWidthon<Box>now only accept numbers (#1029)7cd7fd9stdin,stdout, andstderrare now typed as generic Node.js streams (#981)eb82d8frender()options and touseStdin(),useStdout(), anduseStderr(). TTY-only properties likestdout.columnsare no longer part of the typesuseInputno longer receives unrecognized terminal control sequences (#1014)c76893einputwith the ESC stripped, as if typed. They are now droppedNew
contentOffsetXandcontentOffsetYprops to<Box>for building scrollable views (#765)3ba5828overflow="hidden". See the scroll exampleclientWidthandclientHeighttouseBoxMetrics()andmeasureElement()(#988)3ba5828stdin,stdout, andstderroptions ofrender()(#981)eb82d8fPassThroughor otherReadable/Writablestreams. Raw mode is used only whenstdinis a TTY withsetRawMode()incrementalRenderingmode (#1036)91eb50awsdependency in favor of the nativeWebSocketfor React DevTools (#976)33567edkey.returnb73ebf4Fixes
Rendering
fe1d123clear()494ebebclear()fc358c2f603aebc800284cdc18fa06385e9013feb29a501e4507c0c9509ea75<Transform>line indices when clipping4f3c7aa<Static>and nested<Text>753a5f8undefined274b15afc685bconRenderafter the frame is written83d7de5<Static><Static>output on full-clear frames (#1005)d661543<Static>output when resuming re-enters the alternate screen (#1012)9235028793fe59<Static>output after abandoned concurrent renders8678b76<Static>output when its identity changescfdd9e6<Static>rowsf6b2620c0fa4ef5911f44staticNodereference on indirect subtree removal (#979)5448e6bText
4b4493436f5624<Text>vanishing when it starts above the top of the output (#1001)77aba4a405f7512fbc26a32dc266b419e5c80b1c9cb0dfd619dfe1377fe1577f7e57a5064df65<Transform>wrap points changefc685bc9c323f61e57b233be9ed7Input
2ee828creportAssociatedTextnow enablesreportAllKeysAsEscapeCodesautomatically13707d236d7739onKittyQueryResponsestable acrossrerender()calls (#1007)70beca561004d7suspendTerminal()handles idempotent, and do not restore input modes that were released or belong to an unmounted appa7297c4b35e89ac613707a6789fbFocus
02ae1e5disableFocus()blur the focused component as documented, and respect it when new components auto-focusd130588d130588f6f7dc7Other
<Transform>labels, rewrapping when the terminal widens, and restoring output after console writes (#1028)f480301bebfe2d81e2451renderToString()swallowing thrownundefined, and run effect cleanup when output rendering fails9f7c1d0useWindowSize()missing resizes before it subscribesfab670b53244dcuseAnimation()values while pausedf25d312render()options that areundefined659249dad9e3eawrapTextcache returning results for the wrong text or width (#998)3809acc064b4f6waitUntilExit()after unmount1fcd380Migration guide
React 19.3
Upgrade
react(and@types/react) to 19.3 or later.minWidthandmaxWidthUse a number. If you need a relative minimum or maximum width, compute it from
useWindowSize()oruseBoxMetrics()of the parent.Stream types
useStdout().stdoutis now typed asNodeJS.WritableStream, so TTY properties likecolumnsandrowsare no longer available in the types. UseuseWindowSize()instead, which also re-renders on resize.Control sequences in
useInputIf your
useInputhandler parsed mouse reports, focus events, or other terminal replies frominput, it will no longer receive them. Keys that Ink recognizes, including Kitty keyboard protocol events, are not affected.jsdom/jsdom (jsdom)
v31.0.0Compare Source
Breaking changes
canvasto@napi-rs/canvas. Install@napi-rs/canvasv1.0.13 or later in the v1.x series alongside jsdom; installingcanvasalone no longer enables this support. The new backend provides prebuilt Skia binaries on supported platforms, and rendering and encoded image bytes can differ. Projects using native canvas objects or custom font registration should follow the canvas migration guidance. Added WebP serialization throughcanvas.toDataURL()andcanvas.toBlob(). Fixed image loading to wait for decoding before firingload, discard obsolete source requests, avoid refetching when dimensions change, and prevent failed images from drawing stale contents. Fixed canvas context and serialization behavior, including unsupported context types, read-onlyctx.canvas, image-drawing exceptions, MIME type and quality normalization, and asynchronousnullresults fromcanvas.toBlob()for empty canvases or encoding failures. (@Brooooooklyn)@scope, custom-property substitution and registration through@propertyandCSS.registerProperty(), typedattr(), conditionalif(), shadow-tree styling with:host,::slotted(), and::part(), pseudo-element computed styles, and constructable stylesheets withdocument.adoptedStyleSheetsandshadowRoot.adoptedStyleSheets. Fixed numerous cascade, shorthand, serialization, and default-style issues; computed declarations now stay live across DOM and stylesheet changes. CSS serialization and computed values can differ from previous releases.JSDOMconstructor,JSDOM.fromURL(), andJSDOM.fromFile()can now return partially parsed documents. Wait forDOMContentLoadedfor the finished tree, or the window'sloadevent for load-delaying resources, checkingdocument.readyStatefirst in case the event has already fired. XML syntax errors encountered after asynchronous parsing resumes are reported through the virtual console as"xml-parsing"errors.Other changes
window.reportError(), which dispatches anerrorevent and reports uncanceled errors to the virtual console. (@sarankumar1325)element.ariaBrailleLabelandelement.ariaBrailleRoleDescription. (@Kjubikstronk)loadevents to fire only on the window. Usewindow.addEventListener("load", ...)orwindow.onloadinstead of listening on the document.document.open(), including implicit calls fromdocument.write(), to clear event listeners and handlers from the document, its descendants, and its window when replacing the input stream.document.write()to process successive writes through the parser's input stream, preserve insertion points across nested scripts, and make completed text immediately visible. Script-created input streams now remain open untildocument.close().script.async = falseexecution order, use their source text and document from preparation time, and avoid executing after adoption into another document. Scripts parsed through inert fragment APIs no longer execute when subsequently inserted.<style>elements in shadow trees now fireloadevents.window.stop()to cancel pending subresource andXMLHttpRequestrequests in descendant frames and suppress completion events for canceled loads, while allowing subsequent requests to proceed.document.close()calls replaying readiness and load events, and incorrect iframe load events when reopening documents from event handlers.element.blur()can release it immediately.document.hasFocus()returning false before an element is focused or during focus transitions within the document, including inside frames.<template>parsing andtemplate.innerHTMLserialization in XML documents, including templates with namespace prefixes. (@b84330808)rect.toJSON()andperformance.toJSON()to create their result objects in the method's realm instead of the host Node.js realm.Configuration
📅 Schedule: (in timezone Asia/Shanghai)
* 0-6 * * 1)🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.
This PR was generated by Mend Renovate. View the repository job log.