From 17208b0641a702af60d96e15004f72f226bac0de Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Wed, 15 Jul 2026 19:23:30 +0300 Subject: docs: finalize next release documentation --- website/src/content/docs/integrations.mdx | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) (limited to 'website/src/content/docs/integrations.mdx') diff --git a/website/src/content/docs/integrations.mdx b/website/src/content/docs/integrations.mdx index 5f37afbc..48d3e7c9 100644 --- a/website/src/content/docs/integrations.mdx +++ b/website/src/content/docs/integrations.mdx @@ -258,19 +258,16 @@ Herdr resumes stored MastraCode threads with `mastracode --thread `. ## Custom status labels -Integrations can report a short visual label without changing the semantic state. - -For example, an agent can remain semantically `working` while showing `indexing` in the UI. +Integrations report lifecycle state as semantic state only. For example, report an agent as `working` without adding display fields to the lifecycle report. ```bash herdr pane report-agent w1:p1 \ --source custom:docs \ --agent docs-bot \ - --state working \ - --custom-status indexing + --state working ``` -User hooks that run next to a Herdr-managed integration should use metadata instead of `report-agent`. Metadata changes presentation without taking over the integration's `idle`, `working`, `blocked`, or session restore authority. `--agent` guards the report so it only applies while that authoritative agent is active. `--applies-to-source` guards the report so it only applies while that lifecycle authority source is active. `--display-agent` changes the visible name. +User hooks that run next to a Herdr-managed integration should use metadata instead of `report-agent`. Metadata changes presentation without taking over the integration's `idle`, `working`, `blocked`, or session restore authority. `--agent` and `--applies-to-source` guard only presentation fields (`--title`, `--display-agent`, and `--state-label`). Token patches always apply; their reporter owns clearing or TTL refresh. `--display-agent` changes the visible name. ```bash herdr pane report-metadata "$HERDR_PANE_ID" \ @@ -278,12 +275,12 @@ herdr pane report-metadata "$HERDR_PANE_ID" \ --agent claude \ --title "Refactor auth middleware" \ --display-agent "Claude: auth" \ - --custom-status "refactor auth" \ + --token summary="refactor auth" \ --state-label working="refactoring auth" \ --ttl-ms 3600000 ``` -Custom status and state labels are visual-only. Waits, notifications, and workspace rollups still use the semantic state. +Tokens and state labels are visual-only. Waits, notifications, and workspace rollups still use the semantic state. ## Debug integration state -- cgit v1.2.3