-
Notifications
You must be signed in to change notification settings - Fork 107
Agent cannot read comment text on tokenless shared docs #31
Copy link
Copy link
Open
Description
Summary
When a Proof document is shared without a token (URL like /d/<slug> with no ?token=), agents can read the document content but cannot access comment thread text. The comment anchors (highlighted spans) are visible in the DOM/markdown, but the actual comment body text is stored server-side and all API endpoints that would return it require authentication.
Steps to Reproduce
- Create a Proof doc and add comments via the editor UI
- Share the URL without a token (e.g.
https://www.proofeditor.ai/d/439nuvhs) - As an agent, try to read the comments:
GET /d/<slug>withAccept: application/json— returns markdown withproof:base64 markers showing comment anchors (position + ID), but no comment body textGET /api/agent/<slug>/state— returns401 UnauthorizedGET /api/agent/<slug>/snapshot— returns401 UnauthorizedGET /api/agent/<slug>/events/pending— returns401 UnauthorizedPOST /api/agent/<slug>/presence— returns401 Unauthorized
What Works
- Document markdown content is fully readable via
GET /d/<slug>(bothtext/markdownandapplication/json) - Comment anchor positions are embedded as base64-encoded marks in the markdown (e.g.
proof:W3si...) - The decoded marks contain
type,from,to,id, andbyfields - DOM shows
<span data-proof="comment" data-id="..." data-by="...">elements with the highlighted text
What Doesn't Work
- Comment body text is inaccessible — no API endpoint returns it without a token
- The JSON response includes
"hint": "This link has no token. Ask for a tokenized link if you need a stable shareable URL."— but the document owner could not find a way to generate a tokenized URL in the Proof UI - The
tokenSourcefield returns"none"
Impact
This breaks the agent-in-the-loop review workflow. The human leaves comments, but the agent can only see where comments are, not what they say. This is the primary use case for Proof + AI collaboration.
Suggested Fix
Either:
- Include comment body text in the base64 marks embedded in the markdown (so tokenless reads get the full picture)
- Allow tokenless read access to comment threads on docs with
shareState: "ACTIVE"androle: "editor" - Make token generation discoverable in the UI — the owner should be able to generate a tokenized share link easily
Environment
- Document slug:
439nuvhs projectionFresh: false,repairPending: trueshareState: "ACTIVE",role: "editor"capabilities: { canRead: true, canComment: true, canEdit: true }- Bug also filed via
report_bugAPI → internal issue #733
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels