Feature/ait 131 session management

[mschristensen]

Description

This PR adds a Sessions & Identity section to the AI Transport docs:

• Adds an overview page which describes how session management works with a decoupled, channel-oriented approacg
  • Describes the difference with the traditional connection-oriented approach and the benefits of the channel-oriented solution
  • Describes how identity management and authorization works in channel-oriented sessions
• Adds a page on identifying users and agents, covering:
  • Why identity matters (preventing spoofing, message attribution, personalized behavior, and authorization decisions)
  • How to authenticate users with token-based auth and agents with API keys
  • How to specify capabilities for fine-grained permissions
  • How to establish verified identity using clientId for both users and agents
  • How to add roles and custom attributes using authenticated claims and message metadata
• Adds a page on resuming sessions, covering:
  • How to hydrate presence when rejoining a session
  • How users resume sessions by reattaching and hydrating conversation history
  • How agents resume sessions by recovering execution state and catching up on missed messages using channel history
• Adds a page on online status, covering:
  • Why online status matters for session abandonment detection, multi-device coordination, and agent availability
  • How to go online using presence.enter() from single or multiple devices
  • How to go offline explicitly or after disconnection, with configurable timeouts
  • How to view who is online by retrieving presence members or subscribing to presence changes
  • How to detect when a user is completely offline across all devices

Checklist

• Commits have been rebased.
• Linting has been run against the changed file(s).
• The PR adheres to the writing style guide and contribution guide.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/AIT-131-session-management

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[GregHolmes]

Looks good! I've added some comments here. Some of them are for one section, but should be considered throughout the PR. Let me know what you think.

[paddybyers]

lgtm