Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
360 changes: 360 additions & 0 deletions docs/designs/compass/agent/compass-message-cost-gate/design.md

Large diffs are not rendered by default.

6 changes: 6 additions & 0 deletions docs/designs/compass/decisions/agent/DL-459.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
id: DL-459
decision: "An agent post's gated cost, fanout_tokens, sums per placed recipient the message tokens plus a tunable turn overhead unless the recipient is mentioned and WORKING (a steer); a recipient's other batched messages are not counted; the context re-load is reported as reload_tokens and never gated"
status: "Active (proposed, pending Matt, 2026-10-11)"
record: ../../agent/compass-message-cost-gate/design.md#q1-cost-model
---
6 changes: 6 additions & 0 deletions docs/designs/compass/decisions/agent/DL-460.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
id: DL-460
decision: "The server computes the estimate in the agent-tool post entry over the same recipient set fan-out wakes, with the one mention parse-and-resolve body moved into package comms"
status: "Active (Matt, 2026-10-10)"
record: ../../agent/compass-message-cost-gate/design.md#q2-where-the-estimate-is-computed
---
6 changes: 6 additions & 0 deletions docs/designs/compass/decisions/agent/DL-461.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
id: DL-461
decision: "The gate threshold is one server-wide setting, COMPASS_MESSAGE_COST_THRESHOLD, compared to fanout_tokens, parsed at startup and defaulting to 100000 with 0 turning the gate off; every gate outcome is counted"
status: "Active (proposed, pending Matt, 2026-10-11)"
record: ../../agent/compass-message-cost-gate/design.md#q3-threshold-and-its-default
---
6 changes: 6 additions & 0 deletions docs/designs/compass/decisions/agent/DL-462.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
id: DL-462
decision: "Every held post needs its own confirm, bound to cost: the re-sent request carries the confirmed fanout_tokens and posts if the recomputed value is within 10% of it; there is no session-level opt-out"
status: "Active (Matt, 2026-10-11)"
record: ../../agent/compass-message-cost-gate/design.md#q4-per-message-confirm-no-session-opt-out
---
6 changes: 6 additions & 0 deletions docs/designs/compass/decisions/agent/DL-463.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
id: DL-463
decision: "The gate rides the existing post arm with new PostMessageRequest and PostMessageResponse fields, applies to every agent post with no capability flag, adds no comms call arm, and keeps the compass_message_cost and compass_message_confirm tools"
status: "Active (Matt, 2026-10-11)"
record: ../../agent/compass-message-cost-gate/design.md#q5-wire-and-tool-shape
---
6 changes: 6 additions & 0 deletions docs/designs/compass/decisions/agent/DL-464.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
id: DL-464
decision: "Before gating, the server returns an already-stored retry and skips the gate for a non-member, a missing topic, or a non-owner owner-only post, so the gate never holds a post the store will deny; human and internal posts are never gated"
status: "Active (Matt, 2026-10-10)"
record: ../../agent/compass-message-cost-gate/design.md#q6-gate-order-against-the-post-acl
---
6 changes: 6 additions & 0 deletions docs/designs/compass/decisions/agent/DL-465.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
id: DL-465
decision: "A recipient's last-active time is the timestamp of the newest entry in its newest session transcript, read with its context tokens in one durable query, and feeds the informational reload_tokens and cold count; no table or in-memory map is added"
status: "Active (Matt, 2026-10-11)"
record: ../../agent/compass-message-cost-gate/design.md#q7-last-active-from-the-transcript
---
6 changes: 6 additions & 0 deletions docs/designs/compass/decisions/agent/DL-470.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
id: DL-470
decision: "An agent post whose text, as ceil(bytes/4) over text blocks and ask question and option text, exceeds COMPASS_MESSAGE_MAX_TOKENS (default 8000) is rejected with ResourceExhausted and cannot be confirmed past; human posts are not capped"
status: "Active (proposed, pending Matt, 2026-10-11)"
record: ../../agent/compass-message-cost-gate/design.md#q8-hard-limits
---
6 changes: 6 additions & 0 deletions docs/designs/compass/decisions/agent/DL-471.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
id: DL-471
decision: "An agent post whose fanout_tokens exceeds COMPASS_MESSAGE_FANOUT_HARD_LIMIT (default 10 times the gate threshold) is rejected with ResourceExhausted and cannot be confirmed past"
status: "Active (proposed, pending Matt, 2026-10-11)"
record: ../../agent/compass-message-cost-gate/design.md#q8-hard-limits
---
Loading