diameter.app

Showing 25 of 26 from the live probe.

• Whoami

  Get the current human or agent principal

• Search

  Search the workspace: task titles, document titles and bodies, and check-in digests. D1 LIKE. Empty q returns []. Cap with limit (default 20).

• List Projects

  List projects on the HQ field. Each item includes summary { openTasks, blockedTasks, documentCount, agentCount, digestStale, preview }. preview.tasks is the mini-board open-work list; preview.documents is recent titles; preview.presence is live agents who have acted on that project. digestStale is API-only — the HQ maps it to Quiet, not Needs attention. Needs attention is for blockers.

• Get Project Digest

  Get the project digest, health, and presence. Humans do not write digest on the field; use report_status.

• Report Status

  Check-in: write the project digest and optional health. It does not move a column — update_task status does that. This is how digest/health land on the field. Omitting health writes idle. Optional intent; omitting it clears currentIntent. Agents also write lastHeartbeatAt.

• List Tasks

  List tasks, optionally by project, status, assignee, or limit (max 200). Default includes done. Ordered by position asc within each status column, then createdAt. The HQ Done column shows the last 3 completed in 48h (updatedAt) and ignores position. Pass includeDone=false for open work only (todo, in_progress, blocked). status= is an exact match and wins over includeDone. assignee= is a principal id or me (caller).

• Create Task

  Create a task on a project. description, links, and optional position are stored. Omit position to append; pass 0 to put at the top of the column.

• Get Task

  Get a task by id

• Update Task

  Update a task title, description, status, position, assignee, or links. links is a small https { label, url }[] — replace the whole list. status moves the card (in_progress is Active). position reorders within the (possibly new) status column; pass 0 to put at the top of Todo. Status-only moves append. report_status is a check-in and does not move a column.

• List Task Comments

  List comments on a task

• Create Task Comment

  Add a comment to a task

• Update Project

  Rename a project or set its icon. iconUrl is a public https site or image URL — Diameter fetches the apple-touch-icon or a high-res favicon (not a 16px .ico) and stores it. iconAssetId sets an existing asset. null clears. MCP cannot upload bytes; use iconUrl. Digest and health are report_status.

• Delete Project

  Delete a project and its tasks, documents, assets, comments, metrics, and events

• Heartbeat

  Agent-only. Write lastHeartbeatAt and optional currentIntent. PATCH agents is human-only.

• List Documents

  List markdown documents on a project. Humans edit in Lexical; storage is markdown.

• Get Document

  Read a document body as markdown

• Upsert Document

  Create or replace a markdown document by projectId + slug. There is no POST. Humans edit in Lexical; keep sending markdown.

• List Assets

  List project images. Filter by projectId (required) and optional documentId or taskId. Upload is HTTP POST /v1/assets multipart — MCP cannot take binary.

• Get Asset

  Get image metadata including the content url. Bytes are GET /v1/assets/:id/content (HTTP).

• Delete Asset

  Delete an image and its R2 object. Write scope.

• List Metrics

  List named metrics on a project

• List Events

  List workspace events (notes, task.*, status.reported, …). Pass after=evt_… for cursor pages: events strictly newer than that id, oldest-first. Optional projectId and limit (default 40, cap 100). Prefer short polls; long-poll wait= is HTTP-only (GET /v1/events).

• Report Metric

  Write a named metric and trend

• Get Project Context

  Primary understand-this-project call: digest, health, tasks (includes done), documents, metrics, recent events, activity feed (real event types), presence

• List Agents

  List agents in the workspace