Skip to content

feat(agent-sdk): migrate to 0.3.258 and support message queues - #363

Merged
srothgan merged 4 commits into
mainfrom
migrate/agent-sdk-0.3.258
Sep 2, 2026
Merged

srothgan merged 4 commits into
mainfrom
migrate/agent-sdk-0.3.258

Conversation

@srothgan

@srothgan srothgan commented Sep 2, 2026

Copy link
Copy Markdown
Owner

Summary

  • Upgrade both Agent SDK package surfaces and the bridge version guard to 0.3.258, use summary-only context polling, and preserve the snapshotted system prompt across resume.
  • Add an SDK-correlated active-turn user-message queue with bounded host projection, exactly-once transcript insertion, payload recovery, Esc reconciliation, and compact TUI previews.
  • Add MCP resource links and ambient-task metadata end to end, harden structured Write output, extend REPL/Artifact/ScheduleWakeup rendering, and reconcile final background Bash and authoritative MCP status notifications.

Why

Agent SDK 0.3.258 adds correlation and result metadata that let the host accept messages during an active turn and present richer task and tool results. The migration also changes several output contracts, including nullable Write originals, which require host-side compatibility handling to avoid stale tasks or misleading diffs.

Closes #

Validation

  • Automated: npm.cmd --prefix agent-sdk test (385 tests), npm.cmd --prefix agent-sdk run lint, npm.cmd --prefix agent-sdk run knip, npm.cmd --prefix agent-sdk run audit, npm.cmd pack --dry-run, cargo fmt --all -- --check, cargo check --offline, cargo clippy --all-targets --all-features --offline -- -D warnings, and cargo test --offline.
  • Manual: Active-turn queuing was exercised in depth, including SDK receipt, queue removal, and transcript insertion.
  • Screenshot/video: Not attached.

Notes

  • Breaking changes: None expected.
  • Docs updated: The local migration analysis is intentionally not part of this PR.
  • Governance/release impact: Ships the Agent SDK and bundled Claude Code parity update together with the host features it enables.
  • Remaining smoke coverage: The less common MCP resource-link, managed-model, background Bash, and structured Artifact/REPL/ScheduleWakeup surfaces are covered by automated fixtures but were not all exercised interactively.

- bump both SDK pins, lockfiles, and runtime guard to 0.3.258
- use summary context usage for polling and guarded-resume fencing
- snapshot appended system prompts across resumes until compaction
- add focused version, prompt-policy, context-detail, and resume-fence test
- document the remaining migration phases and live smoke gates
- correlate queued prompts with SDK command lifecycle events
- insert accepted queued prompts as individual user messages
- preserve queued text and images across interruption and failure
- add queue status UX with a ten-message capacity limit
- cover bridge, state, and transcript lifecycle behavior
- Add MCP resource links across the bridge, Rust state, and TUI.
- Preserve ambient task metadata and background Bash completion.
- Harden Write diffs and extend structured tool rendering.
- Add SDK compatibility and regression coverage.
@srothgan srothgan self-assigned this Sep 2, 2026
@srothgan srothgan added type: feature New feature or capability type: dependencies Dependency updates area: tui Terminal UI, rendering, input, and keymap area: core App lifecycle, runtime, agent, and session core area: agent-sdk Bun bridge and Agent SDK integration labels Sep 2, 2026
@srothgan
srothgan merged commit 2fd2006 into main Sep 2, 2026
18 checks passed
@srothgan
srothgan deleted the migrate/agent-sdk-0.3.258 branch September 2, 2026 18:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: agent-sdk Bun bridge and Agent SDK integration area: core App lifecycle, runtime, agent, and session core area: tui Terminal UI, rendering, input, and keymap type: dependencies Dependency updates type: feature New feature or capability

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant