From faaddfe18d571ce5f7abb942655c686a9cfdfe99 Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Fri, 29 May 2026 21:35:16 +0300 Subject: docs: finalize release docs --- website/src/content/docs/socket-api.mdx | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'website/src/content/docs/socket-api.mdx') diff --git a/website/src/content/docs/socket-api.mdx b/website/src/content/docs/socket-api.mdx index 3b12d928..8525c33b 100644 --- a/website/src/content/docs/socket-api.mdx +++ b/website/src/content/docs/socket-api.mdx @@ -163,6 +163,23 @@ Integrations report agent state with `pane.report_agent`. `custom_status` is visual. It can show a short label like `indexing` without changing semantic behavior. +Official integrations can also report a native session reference. `pane.get`, `pane.list`, `agent.get`, and `agent.list` expose a read-only `agent_session` object when Herdr has a stored native session reference: + +```json +{ + "agent_session": { + "source": "herdr:codex", + "agent": "codex", + "kind": "id", + "value": "..." + } +} +``` + +If no native session reference is stored, the field is omitted. + +`pane.get`, `pane.list`, `agent.get`, and `agent.list` also expose `foreground_cwd` when Herdr can resolve the cwd of the process currently controlling the pane PTY. The existing `cwd` field remains the pane/workspace cwd used for labels, follow-cwd behavior, and restored session state. + Use `pane.report_metadata` when a user hook wants to customize presentation without taking over lifecycle state from a Herdr integration. ```json -- cgit v1.2.3