docs(9-ai-sessions): profile memory bank + user-level Bedrock/Vertex + system_prompt_suffix

[maximelb]

Summary

Documentation for the three features bundled in refractionPOINT/ai-sessions#71.

1. Per-profile memory bank

User-scoped, profile-attached store of markdown files that mounts into the runner workspace at /workspace/.memory/ whenever a session is launched from the profile. The user-side complement to the org-scoped ai_memory Hive.

2. User-level AWS Bedrock and Google Vertex Claude providers

The same Bedrock / Vertex provider blocks already supported on the org-scoped ai_agent Hive record are now accepted on the per-user BYOK path via POST /v1/auth/claude/bedrock and POST /v1/auth/claude/vertex. Lets a single user route Claude through their own AWS or GCP account from the dashboard, instead of an Anthropic API key or OAuth.

3. Per-profile system_prompt_suffix

Optional 16 KB free-form string on a profile that the runner appends to the agent's system prompt whenever a session is launched from that profile. Snapshotted onto the session at creation time so live profile edits don't reach already-running sessions.

Pages added/changed

• New: 9-ai-sessions/profile-memory.md — full reference for the memory bank: mounting, sync, naming rules, limits, REST endpoints, lifecycle, security
• 9-ai-sessions/user-sessions.md
  • Step 2 grows two new options (Amazon Bedrock, Google Cloud Vertex AI) alongside the existing API key and OAuth flows
  • New system_prompt_suffix row in the Profile Options table
  • Short pointer under "Session Profiles" to the new memory page
• 9-ai-sessions/api-reference.md
  • GET/PUT/DELETE /v1/profiles/{id}/memories[/content] endpoint reference
  • POST /v1/auth/claude/bedrock and POST /v1/auth/claude/vertex endpoints with request body, response, error responses, and cross-links to provider setup
  • Extended credential_type enum on GET /v1/auth/claude/status (api_key | oauth | bedrock | vertex)
  • system_prompt_suffix example on the Create Profile body and the new system_prompt_suffix_too_long error code
• 9-ai-sessions/memory.md — top-of-page pointer to the per-user equivalent
• 9-ai-sessions/alternative-providers.md — new "Where to configure" subsection cross-linking to the per-user flow on user-sessions.md, so readers landing on the org-scoped page can find the user-scoped one
• mkdocs.yml — nav entry for the new profile-memory.md

Test plan

• mkdocs builds locally (mkdocs build)
• Internal links resolve (memory.md ↔ profile-memory.md ↔ user-sessions.md ↔ api-reference.md ↔ alternative-providers.md)
• Memory API examples copy-paste cleanly (note the --data-urlencode for the path query parameter)
• Bedrock / Vertex curl examples copy-paste cleanly
• Limits in the memory doc match the implementation (100 entries / 64 KiB per entry / 5 MiB aggregate / max 5-segment depth / 256-char path)
• system_prompt_suffix max length matches the implementation (16 KB / 16384 bytes)

This is a draft until refractionPOINT/ai-sessions#71 lands and the features ship.

🤖 Generated with Claude Code