@kangentic/protocol 0.16.0 → 0.17.0

package/dist/events/payloads.d.ts

@@ -397,11 +397,38 @@ export interface BoardTaskWire {
      * Resume control; a client applies the same precedence. `start-session`
      * re-checks the column and refuses a To Do, Done or archived task with the
      * desktop's Resume copy, so a value overtaken by a move is safe to act on.
+     * A paused task that offers no Resume reads false here. From 0.17.0 `paused`
+     * tells it apart from a task with no paused session.
      *
      * Declared OPTIONAL (`?`) like `spawns_session`; `parseBoardTaskWire`
      * populates the key from every real wire response.
      */
     resumable?: boolean | null;
+    /**
+     * True when the task has a paused session (a `suspended` session that is not
+     * a Command Terminal) and no live one. No column or archive gate applies. It
+     * is the fact the desktop card's "Paused" footer reads, so a paused task in
+     * Done or on the archived page reads true here while `resumable` reads
+     * false. A move into To Do removes the task's session rows, so a task there
+     * normally reads false. Gate Resume on `resumable` only; `resumable: true`
+     * always comes with `paused: true`.
+     *
+     * A desktop pause clears the task's `session_id`, so find a paused session
+     * from this field, not from `session_id`. A respawn queued behind the
+     * desktop's concurrency limit leaves the task holding a paused session and a
+     * queued one; that task reads false, as the desktop card shows the queued
+     * session. While `spawn_progress` is non-null the desktop card shows that
+     * label instead of "Paused"; a client applies the same precedence.
+     *
+     * Under `view: 'sessions'` a paused task that offers no Resume stays out of
+     * the snapshot, because an agent feed has nothing to act on for it. Null or
+     * absent means a desktop that predates the field (pre-0.17.0); a client
+     * then reads a paused task from `resumable` alone, as before.
+     *
+     * Declared OPTIONAL (`?`) like `resumable`; `parseBoardTaskWire` populates
+     * the key from every real wire response.
+     */
+    paused?: boolean | null;
 }
 /** Phone-needed subset of the desktop's BacklogTask row. */
 export interface BacklogItemWire {

package/dist/index.cjs

@@ -5465,7 +5465,8 @@ function parseBoardTaskWire(value) {
     created_at: requireString(value, "created_at", "board task"),
     updated_at: requireString(value, "updated_at", "board task"),
     spawn_progress: nullableString(value, "spawn_progress"),
-    resumable: nullableBoolean(value, "resumable")
+    resumable: nullableBoolean(value, "resumable"),
+    paused: nullableBoolean(value, "paused")
   };
 }
 function parseBacklogItemWire(value) {

package/dist/index.mjs

@@ -5339,7 +5339,8 @@ function parseBoardTaskWire(value) {
     created_at: requireString(value, "created_at", "board task"),
     updated_at: requireString(value, "updated_at", "board task"),
     spawn_progress: nullableString(value, "spawn_progress"),
-    resumable: nullableBoolean(value, "resumable")
+    resumable: nullableBoolean(value, "resumable"),
+    paused: nullableBoolean(value, "paused")
   };
 }
 function parseBacklogItemWire(value) {

package/dist/wire/payloads.d.ts

@@ -136,6 +136,8 @@ export declare function parseTranscriptWindowResponsePayload(payload: JsonValue)
  *   `spawn_progress` label in flight (a first start, or a respawn that has
  *   nulled `session_id`) and a `resumable` paused task (a desktop pause
  *   nulls `session_id` too), so the feed can draw "Paused" with a Resume.
+ *   A paused task that offers no Resume (in Done, say) stays out even though
+ *   its row reads `paused: true` from 0.17.0 (see `BoardTaskWire.paused`).
  * - 'full': every non-archived task, for the one project whose board the user
  *   actually has open.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kangentic/protocol",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Kangentic mobile bridge wire protocol: framing, Noise-based pairing and session handshakes, signed device roster, and capability verbs shared between desktop and mobile.",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",