unstale

npm / @chat-adapter/linear

@chat-adapter/linear

What changed in @chat-adapter/linear 4, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-19.

1 breaking2 security5 new APIs and options9 behavior and defaults4 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.0 on npm

@chat-adapter/linear 421 changes

Breaking changes 1

  • Adapter and StateAdapter now require channelIdFromThreadId, so implementations must provide it.

    4.19.0release notes

Security 2

  • Validates agent session issue ownership before fetching history to prevent cross-issue reads.

    4.41.1release notes

  • Validates comment ownership before fetching Linear thread replies to prevent cross-issue content exposure.

    4.41.1release notes

New APIs and options 5

  • A new optional webhookVerifier verifies inbound webhooks in place of the Linear webhook secret.

    4.33.0release notes

  • Connect-mode outbound calls outside webhook handling are supported via withInstallation(organizationId, fn).

    4.33.0release notes

  • The Linear adapter exposes its native client as linearClient, returning LinearClient; the previous client getter remains available as a deprecated alias.

    4.29.0release notes

  • EphemeralMessage is now generic over TRawMessage, allowing its raw message type to be specified.

    4.19.0release notes

  • Adds the CardLink element.

    4.15.0release notes

Behavior and default changes 9

  • Generated Linear Connect bots use explicit agent-session mode and setup guidance; initialization recommends agent sessions when a token resolver and webhook verifier are configured without a mode, while preserving the adapter's comments default.

    4.41.0release notes

  • The accessToken config option accepts a string or a resolver returning a string or Promise<string>, allowing tokens to be sourced from Vercel Connect at runtime.

    4.33.0release notes

  • Adapter internals are protected rather than private, allowing consumers to subclass an adapter to override or extend its behavior.

    4.29.0release notes

  • The adapter now declares chat as a full dependency instead of an optional dependency, so it is installed as a required package dependency.

    4.21.0release notes

  • Adapters have improved fallback-render behavior.

    4.16.0release notes

  • Markdown rendering is fully streaming, including for Slack, which has native streaming.

    4.16.0release notes

  • Markdown rendering now supports tables.

    4.16.0release notes

  • The Slack adapter adds typing indicators using the Slack assistants API.

    4.14.0release notes

  • Configuration is now automatically loaded from environment variables.

    4.13.4release notes

Fixes and other changes 4

  • The Linear adapter checks that a comment belongs to the supplied thread before edits, deletions, and reactions.

    4.42.0release notes

  • Linear ordinary comments leave isMention undetermined, allowing SDK text detection to apply; a definitive false from an adapter now suppresses mention detection based on message text.

    4.41.0release notes

  • Linear agent-session events stay on one stable thread, including sessions created by automation or without a root comment.

    4.40.0release notes

  • Expanded npm keywords to improve discoverability of adapter and state packages.

    4.30.0release notes