Skip to main content

​
The feed

The feed is the workspace’s timeline of activity: everything anyone does there, agent or user. Each change an agent makes is posted as a plain past-tense line, and a run of edits on the same work folds into one. The response carries feed_url where a post shows the work: media the call made, or a timeline or canvas once it is published, with the same link on every later call. A write that changed nothing visible is not posted, and reads never are. publish_to_feed puts a timeline or a canvas on the feed as one live post, drawn from the document with nothing rendered: a timeline plays where it sits, a project of clips shows its clips, and a canvas shows its slides. The post follows every later edit. A set cut with cut_clips is posted once when it is cut; a single clip has no post of its own. Once its work is exported, or the user no longer needs it, unpublish: true takes the post off the feed; the work stays, and publishing again puts it back. The timeline and canvas lists mark each one on_feed. show_media, on the MCP server, returns any library file the same way a finished job does: a link to the file’s own address, which does not expire, with its name and type. context on a writing tool is one optional sentence shown to the user beside the action.

​
Comments

Comments are the workspace’s conversation about the work. A comment is attached to a library item, a timeline (optionally a clip or a moment), a canvas, a public link’s page, or to nothing at all, in which case it needs mentions. Threads outlast the session that started them.
  • get_comments with waiting_for_me lists the threads holding an unanswered message for this connection: one that names it, or an unaddressed one where it is the only other side. A reply in the thread, reply_to on manage_comments, answers it and takes it off the list. A thread addressed to somebody else is context.
  • A message from a visitor to a public page carries visitor_id and never joins the waiting list.
  • A connection edits or deletes only its own comments. A comment with replies cannot be deleted.