diff options
| author | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-07-15 19:23:30 +0300 |
|---|---|---|
| committer | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-07-15 19:25:20 +0300 |
| commit | 17208b0641a702af60d96e15004f72f226bac0de (patch) | |
| tree | 2912b4a7d59f1ceecd73b4db80d352d1e730bc80 /website/src/content/docs/integrations.mdx | |
| parent | a0678a38b9426b011f66e1b88ff7aaa9bf877104 (diff) | |
docs: finalize next release documentation
Diffstat (limited to 'website/src/content/docs/integrations.mdx')
| -rw-r--r-- | website/src/content/docs/integrations.mdx | 13 |
1 files changed, 5 insertions, 8 deletions
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 <id>`. ## 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 |