Skip to content

Add session management documentation guide#108

Open
kaleko wants to merge 2 commits into
mainfrom
feature/session-management-docs
Open

Add session management documentation guide#108
kaleko wants to merge 2 commits into
mainfrom
feature/session-management-docs

Conversation

@kaleko
Copy link
Copy Markdown
Contributor

@kaleko kaleko commented May 14, 2026

Adds docs/SESSION_MANAGEMENT.md covering:

  • Architecture approaches comparison (DynamoDB+APIGW, localStorage, AgentCore Memory listing, S3)
  • Full DynamoDB + API Gateway implementation: table schema, CDK code, Lambda handler, frontend service
  • Session flow (create, list, resume, update, delete)
  • Session resumption via AgentCore Memory's runtimeSessionId
  • Advanced patterns for long-running agents (status tracking, polling, cancellation)
  • Session naming strategies
  • Cost considerations
  • Client-side localStorage alternative for prototypes

@kaleko kaleko requested a review from a team May 14, 2026 16:14
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 14, 2026
| **DynamoDB + API Gateway** | Server-side | Survives device switches, shared across clients, queryable | Requires backend infrastructure | Production applications, multi-device users |
| **localStorage / IndexedDB** | Client-side | Zero infrastructure, instant | Lost on clear/device switch, no cross-device | Prototypes, single-device use cases |
| **AgentCore Memory listing** | Server-side (existing) | No new infrastructure | Limited query flexibility, no custom metadata | Simple apps where session list = memory sessions |
| **S3 + presigned URLs** | Server-side | Good for large session payloads | Higher latency for metadata queries | Sessions with large attachments or artifacts |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

strands has s3 session manager, which was super helpful in some projects
https://strandsagents.com/docs/user-guide/concepts/agents/session-management/#s3sessionmanager--s3storage

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants