Skip to main content

The feed

The feed is the workspace’s activity: everything anyone does there, agent or user. Each change an agent makes is posted as a plain past-tense line, and a series of edits on the same work is combined into one post. The response includes 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 isn’t posted, and reads aren’t either. publish_to_feed adds a timeline or a canvas to the feed as one live post, shown straight from the document without rendering: a timeline plays in place, a project of clips shows its clips, and a canvas shows its slides. The post updates with every later edit. A set cut with cut_clips is posted once when it is cut, and a single clip has no post of its own. unpublish: true removes the post from the feed, for example once the work is exported; the work stays, and publishing again brings the post 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 doesn’t expire, with its name and type. A picture also comes as a small preview, so the conversation displays it. 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, in which case it has to mention someone. Threads stay after the session that started them ends.
  • get_comments with waiting_for_me lists the threads with an unanswered message for this connection: one that mentions it, or one addressed to no one where it is the only other participant. A reply in the thread (reply_to on manage_comments) answers it and removes it from the list. A thread addressed to someone else is there for context.
  • A message from a visitor to a public page includes visitor_id and isn’t added to the waiting list.
  • A connection can only edit or delete its own comments. A comment with replies can’t be deleted.