feat(aigateway): WS X-Cache-Key / cache_key for prompt-cache affinity - #1621
Conversation
…affinity Allow clients (Genesis Hub) to pin AI Gateway WebSocket prompt-cache affinity with a stable session id on upgrade and per-request frames. Co-authored-by: Cursor <cursoragent@cursor.com>
|
The latest Agentuity deployment details.
View deployment logs with the Agentuity CLI: |
|
Warning Review limit reachedYou’ve reached a temporary PR review limit under our Fair Usage Limits Policy. Next review available in: 26 minutes Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available. How can I continue?After more reviews become available, a review can be triggered using the To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews. How do review limits work?CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability. For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window. Please refer docs for additional details. Review details⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (2)
Comment |
📦 Canary Packages Publishedversion: PackagesInstallAdd to your {
"dependencies": {
"@agentuity/genesis": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-genesis-3.1.9-d30f4d3.tgz",
"@agentuity/runtime": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-runtime-3.1.9-d30f4d3.tgz",
"@agentuity/opencode": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-opencode-3.1.9-d30f4d3.tgz",
"@agentuity/adapter": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-adapter-3.1.9-d30f4d3.tgz",
"@agentuity/webhook": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-webhook-3.1.9-d30f4d3.tgz",
"@agentuity/telemetry": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-telemetry-3.1.9-d30f4d3.tgz",
"@agentuity/storage": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-storage-3.1.9-d30f4d3.tgz",
"@agentuity/vite": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-vite-3.1.9-d30f4d3.tgz",
"@agentuity/core": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-core-3.1.9-d30f4d3.tgz",
"@agentuity/sandbox": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-sandbox-3.1.9-d30f4d3.tgz",
"@agentuity/coder": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-coder-3.1.9-d30f4d3.tgz",
"@agentuity/config": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-config-3.1.9-d30f4d3.tgz",
"@agentuity/claude-code": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-claude-code-3.1.9-d30f4d3.tgz",
"@agentuity/coder-tui": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-coder-tui-3.1.9-d30f4d3.tgz",
"@agentuity/aigateway": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-aigateway-3.1.9-d30f4d3.tgz",
"@agentuity/email": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-email-3.1.9-d30f4d3.tgz",
"@agentuity/task": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-task-3.1.9-d30f4d3.tgz",
"@agentuity/hono": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-hono-3.1.9-d30f4d3.tgz",
"@agentuity/migrate": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-migrate-3.1.9-d30f4d3.tgz",
"@agentuity/schedule": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-schedule-3.1.9-d30f4d3.tgz",
"@agentuity/skills": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-skills-3.1.9-d30f4d3.tgz",
"@agentuity/pi": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-pi-3.1.9-d30f4d3.tgz",
"@agentuity/keyvalue": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-keyvalue-3.1.9-d30f4d3.tgz",
"@agentuity/server": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-server-3.1.9-d30f4d3.tgz",
"@agentuity/client": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-client-3.1.9-d30f4d3.tgz",
"@agentuity/api": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-api-3.1.9-d30f4d3.tgz",
"@agentuity/stream": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-stream-3.1.9-d30f4d3.tgz",
"create-agentuity": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/create-agentuity-3.1.9-d30f4d3.tgz",
"@agentuity/drizzle": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-drizzle-3.1.9-d30f4d3.tgz",
"@agentuity/db": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-db-3.1.9-d30f4d3.tgz",
"@agentuity/cli": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-cli-3.1.9-d30f4d3.tgz",
"@agentuity/analytics": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-analytics-3.1.9-d30f4d3.tgz",
"@agentuity/schema": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-schema-3.1.9-d30f4d3.tgz",
"@agentuity/postgres": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-postgres-3.1.9-d30f4d3.tgz",
"@agentuity/vector": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-vector-3.1.9-d30f4d3.tgz",
"@agentuity/queue": "https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-queue-3.1.9-d30f4d3.tgz"
}
}Or install directly: bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-genesis-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-runtime-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-opencode-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-adapter-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-webhook-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-telemetry-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-storage-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-vite-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-core-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-sandbox-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-coder-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-config-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-claude-code-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-coder-tui-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-aigateway-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-email-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-task-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-hono-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-migrate-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-schedule-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-skills-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-pi-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-keyvalue-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-server-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-client-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-api-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-stream-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/create-agentuity-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-drizzle-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-db-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-cli-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-analytics-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-schema-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-postgres-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-vector-3.1.9-d30f4d3.tgz
bun add https://agentuity-sdk-objects.t3.storageapi.dev/npm/3.1.9-d30f4d3/agentuity-queue-3.1.9-d30f4d3.tgz |
Summary
cacheKeyonAIGatewayWebSocketClient/createWebSocket, sent asX-Cache-Keyon the WebSocket upgrade.cache_keyon WS request options/frames; default each request to the connectioncacheKeywhen omitted.Context
Pairs with:
X-Cache-Key/ WScache_keyRelated to TAC-724 Fireworks header-timeout stalls on long synthesis turns.
Release
Please cut
@agentuity/aigateway3.1.11 (or next patch) after merge so Genesis can drop the 3.1.10 type cast and assert upgrade headers.Test plan
bun test packages/aigateway/test/websocket.test.tsbun run build/bun run typecheckinpackages/aigatewayX-Cache-Key: hubsess_…Made with Cursor