session_start

Previous value: -"Override the sticky-pin guard: when this connection is already pinned to a different project by an explicit session_start call, a re-pin is refused unless force is true. Use it only when you are deliberately switching THIS connection to another project — e.g. a new conversation on a connection reused across conversations. On a connection shared by several agents (Cowork, Claude Desktop local-agent-mode), prefer a dedicated plumb serve process per agent over forcing."New value: +"Override the sticky-pin guard: a re-pin away from a pin an explicit session_start already holds is refused unless force is true. Use it when you are deliberately moving this pin — see scope for whether that is your own shard or the whole connection."

Added value: +{
+  "description": "Which pin a workspace re-pin moves. 'agent' (default) moves only your own shard, leaving peers where they are. 'connection' moves the connection's pin, which peers that never chose a root then follow; it needs force: true when an explicit pin holds the connection, and an identity, since it resets peers' workspace, reads and undo.",
+  "enum": [
+    "agent",
+    "connection"
+  ],
+  "type": "string"
+}

Previous value: -"Absolute workspace path. Use this to pin the project for clients that do not report a folder (e.g. Claude Desktop). If this connection is already pinned to a different project, passing a workspace here re-pins it to the new project — this is how you switch projects on a connection reused across conversations. When the current pin was itself set by an explicit session_start, the re-pin is refused unless you also pass force: true — a guard against a peer agent silently stealing the pin on a shared connection (issue #182). Defaults to the daemon's already-resolved workspace."New value: +"Absolute workspace path. Use this to pin the project for clients that do not report a folder (e.g. Claude Desktop). Passing it re-pins — see force and scope for what that moves and when it is refused. Defaults to the daemon's already-resolved workspace."

Previous value: -"Optional opaque identifier linking this plumb session to the caller's own session (e.g. a Claude Code conversation ID). When provided, plumb persists the ID and, if a recent session with the same ID ended within the last 24 h, inherits its name — so a resumed conversation keeps its session name in the TUI."New value: +"A stable id for THIS agent: the client's conversation id, or 'conversation/agent' for a subagent. Pass it every time: it scopes this agent's pin, read tracking and undo when agents share a connection, and carries your session name across a restart (same id, ended under 24 h ago). Claude Code's identity hook fills it."

Previous value: -"Optional override for the workspace's primary language when automatic detection cannot infer it — e.g. an Xcode app that has .swift sources but no SwiftPM Package.swift, so no root marker resolves. Pass the [lsp.<lang>] key (e.g. 'swift', 'typescript', 'rust') to force that language server as the primary, so workspace_symbols and the call/type hierarchies work. The server must be installed and enabled; an unknown, uninstalled, or disabled language is ignored and normal detection applies. Honoured on the connection's current workspace, or alongside an explicit 'workspace' arg."New value: +"Optional override for the workspace's primary language when automatic detection cannot infer it — e.g. an Xcode app that has .swift sources but no SwiftPM Package.swift, so no root marker resolves. Pass the [lsp.<lang>] key (e.g. 'swift', 'typescript', 'rust') to force that language server as the primary, so workspace_symbols and the call/type hierarchies work. The server must be installed and enabled; an unknown, uninstalled, or disabled language is refused, naming the reason and the remedy, not silently ignored. Honoured on the connection's current workspace, or alongside an explicit 'workspace' arg."

Added value: +{
+  "description": "Orientation packet size. 'brief' (≤1.5 KB) returns workspace path, language, branch, a one-line git policy, diagnostics and active-peer COUNTS, memory NAMES only (no descriptions/sizes), and the edit-lane rule where it applies — cheap re-orientation for a subagent that does not need the full packet. 'full' returns the complete packet documented above. Defaults to 'full', except this default flips to 'brief' automatically when the supplied session_id was already seen by this daemon within the last 24h (a resumed conversation); an explicit value always wins over the automatic default.",
+  "enum": [
+    "brief",
+    "full"
+  ],
+  "type": "string"
+}