@kangentic/protocol 0.14.0 → 0.15.0

package/dist/capabilities/verbs.d.ts

@@ -8,8 +8,17 @@
  * the desktop's capability router (Phase 2) still has to implement and
  * wire a handler, and a device's roster entry still has to include it in
  * its CapabilitySet.
+ *
+ * Append only. The desktop mirrors this tuple by hand in its import-free
+ * types module and pins the two equal INDEX for index, so a verb inserted
+ * mid-list fails that parity test even when both lists hold the same names.
+ *
+ * `start-session` is the second lifecycle verb beside `move-task`: it spawns
+ * or resumes a task's session in the column the task is already in, so a
+ * phone's "Session ended" state can bring the agent back without moving the
+ * task. A live session is an idempotent no-op; nothing is ever stopped.
  */
-export declare const CAPABILITY_VERBS: readonly ["read-stream", "read-board", "read-diff", "send-user-message", "move-task", "answer-permission-prompt", "interactive-terminal", "board-tool-read", "board-tool-write", "register-push"];
+export declare const CAPABILITY_VERBS: readonly ["read-stream", "read-board", "read-diff", "send-user-message", "move-task", "answer-permission-prompt", "interactive-terminal", "board-tool-read", "board-tool-write", "register-push", "start-session"];
 export type CapabilityVerb = (typeof CAPABILITY_VERBS)[number];
 export declare function isCapabilityVerb(value: string): value is CapabilityVerb;
 /** Deny-by-default: a verb absent from the set is not authorized. */

package/dist/events/event.d.ts

@@ -69,7 +69,10 @@ export type ActivityEventPayload = {
  * `spawnProgressLabel`, when present, means the desktop had a respawn in
  * flight for this task when the session ended - a same-column respawn
  * (model switch, agent switch, effort change, isolated-session-track
- * switch) rather than a genuine park. Read it as what the desktop
+ * switch) or an in-place restart (a model or effort pick on the running
+ * task, a board-profile change, or the auto_command escalation that
+ * re-sends a command as the resume prompt, "Re-sending command...") rather
+ * than a genuine park. Read it as what the desktop
  * believed, not as a fact about what happens next; the caveats below
  * bound it. `intentional` cannot carry this distinction on its own:
  * the desktop's SessionManager.suspend() sets `status = 'suspended'`