Co-work Action Snapshot Get¶
Read the exact frozen document version and focus attached to a targeted Co-work Chat turn.
MCP name: cowork_action_snapshot_get
Category: cowork
Mutates state (retry policy: replay)
Parameters¶
| Name | Type | Required | Description |
|---|---|---|---|
action_snapshot_id |
string |
Yes | Exact action_snapshot_id returned in the received user turn |
document_id |
string |
Yes | Bound Co-work document ID |
message_id |
string |
Yes | Exact targeted user message ID returned by conversation_receive |
store_id |
string |
Yes | Bound Co-work Truth store ID |
Details¶
Returns the complete immutable Markdown projection plus the exact target text,
selector, hashes, and allowed-change boundary captured for one targeted Chat
turn. A hosted document agent is generation-fenced to its bound store,
document, conversation, consumer generation, and received message. Use the
exact action_snapshot_id and message_id delivered by
conversation_receive; never substitute the current document or infer a focus
from transcript text. Every terminal fetch outcome durably returns a
consumption_receipt_id. The targeted reply and acknowledgement must echo
that receipt; merely echoing an unfetched action snapshot is rejected.
If the named frozen view is missing or fails integrity validation, the
capability returns ok=false, status=action_snapshot_unavailable, and a
generation-bound consumption_receipt_id whose fetch_outcome is
unavailable. That receipt permits only the normal receipt-bound reply and
acknowledgement path: explain truthfully that the exact context could not be
opened and make no document proposal or comment. This prevents a corrupt
snapshot from trapping the durable user turn while preserving its exact
message, action, consumer, and generation audit trail.
After a consumer restart, call the capability again under the new generation. If the prior generation already committed the stable reply but did not acknowledge the turn, the conversation store permits replay only when the old and new receipts prove the same conversation, user message, action snapshot, and transcript-visible target or Co-think context. It preserves the first reply, binds the new receipt to it, and accepts the acknowledgement; changed semantics are rejected.