Claude SDK: Monitor for chat history API availability

[pontemonti]

Summary

The Claude Agent SDK (@anthropic-ai/claude-agent-sdk) does not currently expose programmatic access to conversation history, unlike OpenAI's OpenAIConversationsSession.getItems(). This blocks implementing a Claude-specific sendChatHistoryAsync method equivalent to PR #157.

Current State (January 2026)

• Workspace SDK version: ^0.1.30
• unstable_v2 APIs added in: v0.1.54
• History retrieval API: Not available

The SDK's experimental unstable_v2_* session APIs provide:

• session.send(message) - Send a message
• session.stream() - Stream responses
• session.close() - Close session

Missing: session.getHistory() or equivalent to retrieve past messages.

Workaround

Developers can use the generic sendChatHistory from @microsoft/agents-a365-tooling by manually constructing ChatHistoryMessage[].

See: packages/agents-a365-tooling-extensions-claude/docs/design.md

Revisit Criteria

Re-evaluate when:

1. Claude SDK adds session.getHistory() or session.getMessages()
2. unstable_v2 APIs stabilize (lose unstable_ prefix)
3. SDK version is upgraded in this workspace
4. Anthropic documentation shows new history capabilities

References

• TypeScript V2 Preview docs
• GitHub repo
• npm package
• OpenAI sendChatHistory PR #157