From 2c8a2b65aa148ceb178d2251c54a523af12092c9 Mon Sep 17 00:00:00 2001 From: Teknium <127238744+teknium1@users.noreply.github.com> Date: Mon, 17 Aug 2026 15:31:36 -0700 Subject: [PATCH] docs(sdk): document profiles.list preferred_session_ids lookup Covers the precise pinned-session resolver added in PR #88690: request param shape, the preferred_session response field, hidden-row and compression-lineage resolution, and older-gateway behavior. --- website/docs/developer-guide/desktop-plugin-sdk.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/website/docs/developer-guide/desktop-plugin-sdk.md b/website/docs/developer-guide/desktop-plugin-sdk.md index 3c86a07343..7cd741c61c 100644 --- a/website/docs/developer-guide/desktop-plugin-sdk.md +++ b/website/docs/developer-guide/desktop-plugin-sdk.md @@ -495,7 +495,12 @@ preserves backend identity without exposing connection secrets. Profile-shaped plugins get first-class methods too: `profiles.list` (each profile + its most recent conversation as `last_session`; pass `include_sessions: false` to skip the per-profile DB -probe) and `profiles.create` (`name`, `description`, `clone_from`, +probe; pass `preferred_session_ids: { profileName: sessionId }` for an +exact, existence-checked lookup of one pinned session per profile — each +named row gains a `preferred_session` summary that resolves hidden rows +and compression lineages to their live tip, or `null` when the id is +definitively gone; older gateways ignore the param and omit the field) +and `profiles.create` (`name`, `description`, `clone_from`, `clone_all`, `no_skills`, `soul`, optional `model` + `provider` pin) — the ws twins of the dashboard's `/api/profiles` REST routes. `host.state.busy` is the focused chat's live turn (thinking and streaming).