clients/go/v1.0.0

parruda/swarmclients/go/v1.0.0Oct 2, 2026by github-actions[bot]

Upgrading?

AI Summary

This release marks the Go client library v1.0.0, mirroring the features and changes of the AHP Swift Package v1.0.0 to provide Go developers with the full implementation of the AHP 1.0.0 specification.

Key Highlights

  • Implements AHP 1.0.0 for the Go client.
  • Adds lightweight chat navigation and changeset exposure.
  • Includes enhancements for automation and session management.
  • Maintains compatibility with the Swift package's breaking changes.

Breaking Changes

  • `FileEdit` and preview `edits` now use named models in generated SDKs, breaking affected SDK APIs.
  • Advertise only the 1.0.0 and 0.9.0 protocol compatibility baselines.

New Features

  • `AuthenticateParams.expiresIn` carries OAuth access token's remaining lifetime.
  • `SessionSummary.chats`, `SessionChatSummary.interactivity`, and `SessionSummary.defaultChat` expose lightweight chat navigation.
  • `chat/isArchivedChanged` action for archiving chats independently.
  • `ChatState.changesets` and `chat/changesetsChanged` expose changeset catalogue.
  • `AutomationDefinition.disableConditions` supports `afterRuns` and `afterDate` with logical OR.
  • `ConfigPropertySchema.minItems` and `maxItems` express array cardinality.
  • `McpServerStartingState.blocking` flag and `session/mcpServerBackgroundRequested` action.
  • `AutomationSessionTemplate.customizations` lets automations carry client plugins.
  • Atomic stable-URI `moveChat` transfer and same-session ordering.
  • `chat/backgroundWorkSet` and `chat/backgroundWorkRemoved` actions.
  • `ChatSummary.changes` and `ChatState.changes` provide aggregate file-change counts.
  • `SessionChatSummary.status` exposes per-chat archived state.
  • `chat/isReadChanged` action for independent read status tracking.

Full Release Notes

## [1.0.0] — 2026-10-02

Implements AHP 1.0.0.

### Added

- `AuthenticateParams.expiresIn` carries an OAuth access token's remaining lifetime in seconds.
- `SessionSummary.chats`, `SessionChatSummary.interactivity`, and `SessionSummary.defaultChat` expose lightweight chat navigation data without requiring a session subscription.
- `chat/isArchivedChanged` action for archiving a chat independently of its session.
- `ChatState.changesets` and `chat/changesetsChanged` expose each chat's changeset catalogue through the subscribed chat channel.
- `AutomationDefinition.disableConditions` supports `afterRuns` (`max`) and `afterDate` (`date`) rules combined with logical OR, with at most one condition per kind. Host-owned `AutomationEntry.runCount` tracks the current scheduled-run allowance. Edit conditions through `automation/updateRequested`: omission leaves them unchanged, an array replaces them, and `[]` removes all conditions without re-enabling the automation.
- `ChangesetStatus.Recomputing` distinguishes refreshes of a completed result from initial changeset computation.
- `ConfigPropertySchema.minItems` and `ConfigPropertySchema.maxItems` express array cardinality for `type: "array"` config properties. (#432)
- `McpServerStartingState.blocking` flag indicating that message processing may be held on the server, and the client-dispatchable `session/mcpServerBackgroundRequested` action asking the host to background such a startup.
- `AutomationSessionTemplate.customizations` lets automations carry client plugins (skills, agents, prompts, rules) that the host captures when the definition is saved, with the host-owned copies reported in `AutomationEntry.customizations` and support advertised by `AutomationCapabilities.customizations`.
- Hosts can advertise chat-owned canvas channel references and synchronize live presentation metadata and source URLs on experimental per-canvas channels.
- Atomic stable-URI `moveChat` transfer and same-session ordering for host-authorized chats, with per-chat `movable` discovery and durable authoritative catalogs.
- Expose chat-owned background work (background shells and subagents) in chat state, with `chat/backgroundWorkSet` and `chat/backgroundWorkRemoved` actions independent of turn lifetime.
- `ChatSummary.changes` and `ChatState.changes` provide aggregate file-change counts without requiring a changeset subscription.
- `SessionChatSummary.status` exposes per-chat archived state via `SessionStatus.IsArchived` in the lightweight chat catalog without requiring a session subscription.
- `chat/isReadChanged` action and optional `SessionChatSummary.status` projection for independently tracking the status of any known chat, including the default chat; the status bitset replaces the unreleased `isRead` and `archived` catalog fields.
- `SessionChatSummary.changes` exposes per-chat change counts in the lightweight chat catalog without requiring a session subscription.

### Changed

- Historical `ToolResultTerminalContent.resource` subscriptions return lazily reconstructed exited terminal state with retained output.
- `FileEdit` and preview `edits` now use named models in generated SDKs. This breaks affected SDK APIs but keeps JSON shapes unchanged.
- Advertise only the 1.0.0 and 0.9.0 protocol compatibility baselines independently of the development version. Host-side negotiation helpers select the highest client-offered version within either caret-compatible range and report malformed offers explicitly.

Related Repositories