@kangentic/protocol 0.17.0 → 0.19.0

package/dist/capabilities/verbs.d.ts

@@ -16,9 +16,15 @@
  * `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.
+ * task. A live session is an idempotent no-op; `start-session` never stops
+ * anything.
+ *
+ * `pause-session` is the third lifecycle verb: it suspends a task's live
+ * session exactly as the desktop's Pause button does, without moving the task,
+ * and keeps the conversation for a later `start-session` Resume. Gate it on
+ * `BoardTaskWire.pausable`.
  */
-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 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", "pause-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/payloads.d.ts

@@ -409,9 +409,14 @@ export interface BoardTaskWire {
      * 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`.
+     * false. The desktop draws an archived task as a compact card with no
+     * footer, so a client that matches the desktop card draws "Paused" only
+     * when `archived_at` is null. A move from another column into Done
+     * archives the task in the same step, so only a task that sits in Done
+     * unarchived gets the full card and its footer. 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
@@ -429,6 +434,37 @@ export interface BoardTaskWire {
      * the key from every real wire response.
      */
     paused?: boolean | null;
+    /**
+     * True when the task has a live session (`running` or `queued`) and is not
+     * in To Do. It is the desktop's promise that `pause-session` for this task
+     * pauses that session exactly as its Pause button does: the conversation is
+     * kept for a later Resume, and the pause sticks, so a column with auto-spawn
+     * on does not start the task again by itself. Gate a phone's Pause control on
+     * THIS field.
+     *
+     * Done and archived do not clear it, matching the desktop, whose Pause stays
+     * available there because it is the only in-window stop for a live agent. A
+     * move into Done suspends the task's session in the same step, so a task
+     * there normally has no live session and reads false. It reads true only
+     * when that suspend failed and left the agent running.
+     *
+     * Never true while `paused` is true: a paused task has no live session. While
+     * `spawn_progress` is non-null and no session is live, the desktop card still
+     * shows a Pause control, but its click only cancels an in-flight resume or
+     * start, which `pause-session` does not promise. This field reads false
+     * then, and the verb refuses a task with no live session.
+     *
+     * A pause, a session's start and its end each reach the phone as a
+     * `task-updated` board event, after which the next snapshot carries the new
+     * value. Null or absent means a desktop that predates the field
+     * (pre-0.18.0), and a client offers no Pause then: a 0.15.0 to 0.17.0
+     * desktop refuses `pause-session` with the `unsupported-verb` code, and an
+     * older one does not answer it at all.
+     *
+     * Declared OPTIONAL (`?`) like `paused`; `parseBoardTaskWire` populates the
+     * key from every real wire response.
+     */
+    pausable?: boolean | null;
 }
 /** Phone-needed subset of the desktop's BacklogTask row. */
 export interface BacklogItemWire {

package/dist/index.cjs

@@ -39,6 +39,7 @@ __export(index_exports, {
   PUSH_CATEGORIES: () => PUSH_CATEGORIES,
   PUSH_ENVELOPE_MAX_AGE_MS: () => PUSH_ENVELOPE_MAX_AGE_MS,
   PUSH_ENVELOPE_MAX_FUTURE_SKEW_MS: () => PUSH_ENVELOPE_MAX_FUTURE_SKEW_MS,
+  RESPONSE_TOO_LARGE_ERROR_CODE: () => RESPONSE_TOO_LARGE_ERROR_CODE,
   SecretstreamState: () => SecretstreamState,
   SessionFrameKind: () => SessionFrameKind,
   UNSUPPORTED_VERB_ERROR_CODE: () => UNSUPPORTED_VERB_ERROR_CODE,
@@ -58,6 +59,7 @@ __export(index_exports, {
   deriveSessionSlotId: () => deriveSessionSlotId,
   deriveShortAuthenticationString: () => deriveShortAuthenticationString,
   encodeMessage: () => encodeMessage,
+  encodeMessageFailure: () => encodeMessageFailure,
   encodePairingQrPayload: () => encodePairingQrPayload,
   encodeProtocolVersion: () => encodeProtocolVersion,
   encodeRosterEntryForSigning: () => encodeRosterEntryForSigning,
@@ -90,6 +92,7 @@ __export(index_exports, {
   parseCapabilityRequestPayload: () => parseCapabilityRequestPayload,
   parseDiffFileContentWire: () => parseDiffFileContentWire,
   parseDiffFileListWire: () => parseDiffFileListWire,
+  parsePauseSessionResponsePayload: () => parsePauseSessionResponsePayload,
   parsePushEnvelopePlaintext: () => parsePushEnvelopePlaintext,
   parseReadBoardResponsePayload: () => parseReadBoardResponsePayload,
   parseReadDiffResponsePayload: () => parseReadDiffResponsePayload,
@@ -4971,7 +4974,8 @@ var CAPABILITY_VERBS = [
   "board-tool-read",
   "board-tool-write",
   "register-push",
-  "start-session"
+  "start-session",
+  "pause-session"
 ];
 function isCapabilityVerb(value) {
   return CAPABILITY_VERBS.includes(value);
@@ -5008,6 +5012,7 @@ var FRAME_FORMAT_DEFLATE = 1;
 var JSON_OPEN_BRACE = 123;
 var DEFLATE_HEADER_LENGTH = 5;
 var UNSUPPORTED_VERB_ERROR_CODE = "unsupported-verb";
+var RESPONSE_TOO_LARGE_ERROR_CODE = "response-too-large";
 var UNSUPPORTED_VERB_ERROR_NAME = "UnsupportedVerbError";
 var UnsupportedVerbError = class extends Error {
   requestId;
@@ -5044,6 +5049,15 @@ function encodeMessage(message) {
   }
   return frame;
 }
+function encodeMessageFailure(message) {
+  try {
+    if (new TextEncoder().encode(JSON.stringify(message)).length <= MAX_FRAME_LENGTH) return null;
+    encodeMessage(message);
+    return null;
+  } catch (error) {
+    return error instanceof Error ? error.message : String(error);
+  }
+}
 function decodeMessage(bytes) {
   if (bytes.length > MAX_FRAME_LENGTH) {
     throw new Error(`Bridge message frame exceeds ${MAX_FRAME_LENGTH} bytes`);
@@ -5466,7 +5480,8 @@ function parseBoardTaskWire(value) {
     updated_at: requireString(value, "updated_at", "board task"),
     spawn_progress: nullableString(value, "spawn_progress"),
     resumable: nullableBoolean(value, "resumable"),
-    paused: nullableBoolean(value, "paused")
+    paused: nullableBoolean(value, "paused"),
+    pausable: nullableBoolean(value, "pausable")
   };
 }
 function parseBacklogItemWire(value) {
@@ -5778,6 +5793,20 @@ function parseStartSessionResponsePayload(payload) {
   }
   return { ok: payload.ok, outcome: payload.outcome };
 }
+function parsePauseSessionRequestPayload(payload) {
+  if (!isRecord(payload)) throw new Error("pause-session payload must be an object");
+  if (typeof payload.taskId !== "string") throw new Error('pause-session payload missing "taskId"');
+  if (typeof payload.projectId !== "string") throw new Error('pause-session payload missing "projectId"');
+  return {
+    taskId: payload.taskId,
+    projectId: payload.projectId
+  };
+}
+function parsePauseSessionResponsePayload(payload) {
+  if (!isRecord(payload)) throw new Error("pause-session response must be an object");
+  if (typeof payload.ok !== "boolean") throw new Error('pause-session response missing "ok"');
+  return { ok: payload.ok };
+}
 function parseAnswerPermissionPromptRequestPayload(payload) {
   if (!isRecord(payload)) throw new Error("answer-permission-prompt payload must be an object");
   if (typeof payload.sessionId !== "string") throw new Error('answer-permission-prompt payload missing "sessionId"');
@@ -5875,6 +5904,8 @@ function parseCapabilityRequestPayload(verb, payload) {
       return parseRegisterPushRequestPayload(payload);
     case "start-session":
       return parseStartSessionRequestPayload(payload);
+    case "pause-session":
+      return parsePauseSessionRequestPayload(payload);
     default: {
       const exhaustiveCheck = verb;
       throw new Error(`Unknown capability verb: ${String(exhaustiveCheck)}`);
@@ -6227,6 +6258,7 @@ function isBridgeEvent(value) {
   PUSH_CATEGORIES,
   PUSH_ENVELOPE_MAX_AGE_MS,
   PUSH_ENVELOPE_MAX_FUTURE_SKEW_MS,
+  RESPONSE_TOO_LARGE_ERROR_CODE,
   SecretstreamState,
   SessionFrameKind,
   UNSUPPORTED_VERB_ERROR_CODE,
@@ -6246,6 +6278,7 @@ function isBridgeEvent(value) {
   deriveSessionSlotId,
   deriveShortAuthenticationString,
   encodeMessage,
+  encodeMessageFailure,
   encodePairingQrPayload,
   encodeProtocolVersion,
   encodeRosterEntryForSigning,
@@ -6278,6 +6311,7 @@ function isBridgeEvent(value) {
   parseCapabilityRequestPayload,
   parseDiffFileContentWire,
   parseDiffFileListWire,
+  parsePauseSessionResponsePayload,
   parsePushEnvelopePlaintext,
   parseReadBoardResponsePayload,
   parseReadDiffResponsePayload,

package/dist/index.d.ts

@@ -9,10 +9,10 @@ export { SecretstreamState, deriveSecretstreamPair, FrameTag, type SecretstreamD
 export { deriveShortAuthenticationString, type ShortAuthenticationString } from './crypto/sas';
 export { deriveSessionSlotId, derivePairingSlotId } from './crypto/slot';
 export type { JsonValue, BridgeMessage, HeartbeatMessage, CapabilityRequestMessage, CapabilityResponseMessage, CapabilityErrorCode, EventMessage } from './wire/messages';
-export { encodeMessage, decodeMessage, UnsupportedVerbError, isUnsupportedVerbError, UNSUPPORTED_VERB_ERROR_CODE, MAX_FRAME_LENGTH, MAX_DECODED_LENGTH, COMPRESSION_THRESHOLD, } from './wire/framing';
+export { encodeMessage, encodeMessageFailure, decodeMessage, UnsupportedVerbError, isUnsupportedVerbError, UNSUPPORTED_VERB_ERROR_CODE, RESPONSE_TOO_LARGE_ERROR_CODE, MAX_FRAME_LENGTH, MAX_DECODED_LENGTH, COMPRESSION_THRESHOLD, } from './wire/framing';
 export { isJsonValue, isRecord } from './wire/json-value';
 export { SessionFrameKind, wrapSessionFrame, unwrapSessionFrame } from './wire/session-frame';
-export { parseCapabilityRequestPayload, parseReadStreamResponsePayload, parseReadBoardResponsePayload, parseReadDiffResponsePayload, parseTranscriptWindowResponsePayload, parseRegisterPushRequestPayload, parseStartSessionResponsePayload, isReadStreamSessionStatusWire, type CapabilityRequestPayloadMap, type CapabilityResponsePayloadMap, type ReadStreamRequestPayload, type ReadStreamResponsePayload, type ReadStreamSessionStatusWire, type TranscriptWindowResponsePayload, type ReadBoardRequestPayload, type ReadBoardView, type ReadBoardProjectSummary, type ReadBoardProjectGroup, type ReadBoardProjectListResponsePayload, type ReadBoardSnapshotResponsePayload, type ReadBoardArchivedResponsePayload, type ReadBoardResponsePayload, type ReadDiffScope, type ReadDiffRequestPayload, type ReadDiffResponsePayload, type SendUserMessageRequestPayload, type SendUserMessageResponsePayload, type MoveTaskRequestPayload, type MoveTaskResponsePayload, type AnswerPermissionPromptRequestPayload, type AnswerPermissionPromptResponsePayload, type InteractiveTerminalRequestPayload, type InteractiveTerminalResponsePayload, type BoardToolRequestPayload, type BoardToolResponsePayload, type RegisterPushRequestPayload, type RegisterPushResponsePayload, type StartSessionRequestPayload, type StartSessionResponsePayload, type StartSessionOutcome, } from './wire/payloads';
+export { parseCapabilityRequestPayload, parseReadStreamResponsePayload, parseReadBoardResponsePayload, parseReadDiffResponsePayload, parseTranscriptWindowResponsePayload, parseRegisterPushRequestPayload, parseStartSessionResponsePayload, parsePauseSessionResponsePayload, isReadStreamSessionStatusWire, type CapabilityRequestPayloadMap, type CapabilityResponsePayloadMap, type ReadStreamRequestPayload, type ReadStreamResponsePayload, type ReadStreamSessionStatusWire, type TranscriptWindowResponsePayload, type ReadBoardRequestPayload, type ReadBoardView, type ReadBoardProjectSummary, type ReadBoardProjectGroup, type ReadBoardProjectListResponsePayload, type ReadBoardSnapshotResponsePayload, type ReadBoardArchivedResponsePayload, type ReadBoardResponsePayload, type ReadDiffScope, type ReadDiffRequestPayload, type ReadDiffResponsePayload, type SendUserMessageRequestPayload, type SendUserMessageResponsePayload, type MoveTaskRequestPayload, type MoveTaskResponsePayload, type AnswerPermissionPromptRequestPayload, type AnswerPermissionPromptResponsePayload, type InteractiveTerminalRequestPayload, type InteractiveTerminalResponsePayload, type BoardToolRequestPayload, type BoardToolResponsePayload, type RegisterPushRequestPayload, type RegisterPushResponsePayload, type StartSessionRequestPayload, type StartSessionResponsePayload, type StartSessionOutcome, type PauseSessionRequestPayload, type PauseSessionResponsePayload, } from './wire/payloads';
 export { PUSH_CATEGORIES, isPushCategory, parsePushEnvelopePlaintext, sealPushEnvelope, openPushEnvelope, PUSH_ENVELOPE_MAX_AGE_MS, PUSH_ENVELOPE_MAX_FUTURE_SKEW_MS, type PushCategory, type PushEnvelopePlaintext, } from './crypto/push-envelope';
 export { PAIRING_URI_SCHEME, encodePairingQrPayload, decodePairingQrPayload, type PairingQrPayload, } from './pairing/qr';
 export { sealPairingConfirm, openPairingConfirm } from './pairing/confirm';

package/dist/index.mjs

@@ -4845,7 +4845,8 @@ var CAPABILITY_VERBS = [
   "board-tool-read",
   "board-tool-write",
   "register-push",
-  "start-session"
+  "start-session",
+  "pause-session"
 ];
 function isCapabilityVerb(value) {
   return CAPABILITY_VERBS.includes(value);
@@ -4882,6 +4883,7 @@ var FRAME_FORMAT_DEFLATE = 1;
 var JSON_OPEN_BRACE = 123;
 var DEFLATE_HEADER_LENGTH = 5;
 var UNSUPPORTED_VERB_ERROR_CODE = "unsupported-verb";
+var RESPONSE_TOO_LARGE_ERROR_CODE = "response-too-large";
 var UNSUPPORTED_VERB_ERROR_NAME = "UnsupportedVerbError";
 var UnsupportedVerbError = class extends Error {
   requestId;
@@ -4918,6 +4920,15 @@ function encodeMessage(message) {
   }
   return frame;
 }
+function encodeMessageFailure(message) {
+  try {
+    if (new TextEncoder().encode(JSON.stringify(message)).length <= MAX_FRAME_LENGTH) return null;
+    encodeMessage(message);
+    return null;
+  } catch (error) {
+    return error instanceof Error ? error.message : String(error);
+  }
+}
 function decodeMessage(bytes) {
   if (bytes.length > MAX_FRAME_LENGTH) {
     throw new Error(`Bridge message frame exceeds ${MAX_FRAME_LENGTH} bytes`);
@@ -5340,7 +5351,8 @@ function parseBoardTaskWire(value) {
     updated_at: requireString(value, "updated_at", "board task"),
     spawn_progress: nullableString(value, "spawn_progress"),
     resumable: nullableBoolean(value, "resumable"),
-    paused: nullableBoolean(value, "paused")
+    paused: nullableBoolean(value, "paused"),
+    pausable: nullableBoolean(value, "pausable")
   };
 }
 function parseBacklogItemWire(value) {
@@ -5652,6 +5664,20 @@ function parseStartSessionResponsePayload(payload) {
   }
   return { ok: payload.ok, outcome: payload.outcome };
 }
+function parsePauseSessionRequestPayload(payload) {
+  if (!isRecord(payload)) throw new Error("pause-session payload must be an object");
+  if (typeof payload.taskId !== "string") throw new Error('pause-session payload missing "taskId"');
+  if (typeof payload.projectId !== "string") throw new Error('pause-session payload missing "projectId"');
+  return {
+    taskId: payload.taskId,
+    projectId: payload.projectId
+  };
+}
+function parsePauseSessionResponsePayload(payload) {
+  if (!isRecord(payload)) throw new Error("pause-session response must be an object");
+  if (typeof payload.ok !== "boolean") throw new Error('pause-session response missing "ok"');
+  return { ok: payload.ok };
+}
 function parseAnswerPermissionPromptRequestPayload(payload) {
   if (!isRecord(payload)) throw new Error("answer-permission-prompt payload must be an object");
   if (typeof payload.sessionId !== "string") throw new Error('answer-permission-prompt payload missing "sessionId"');
@@ -5749,6 +5775,8 @@ function parseCapabilityRequestPayload(verb, payload) {
       return parseRegisterPushRequestPayload(payload);
     case "start-session":
       return parseStartSessionRequestPayload(payload);
+    case "pause-session":
+      return parsePauseSessionRequestPayload(payload);
     default: {
       const exhaustiveCheck = verb;
       throw new Error(`Unknown capability verb: ${String(exhaustiveCheck)}`);
@@ -6100,6 +6128,7 @@ export {
   PUSH_CATEGORIES,
   PUSH_ENVELOPE_MAX_AGE_MS,
   PUSH_ENVELOPE_MAX_FUTURE_SKEW_MS,
+  RESPONSE_TOO_LARGE_ERROR_CODE,
   SecretstreamState,
   SessionFrameKind,
   UNSUPPORTED_VERB_ERROR_CODE,
@@ -6119,6 +6148,7 @@ export {
   deriveSessionSlotId,
   deriveShortAuthenticationString,
   encodeMessage,
+  encodeMessageFailure,
   encodePairingQrPayload,
   encodeProtocolVersion,
   encodeRosterEntryForSigning,
@@ -6151,6 +6181,7 @@ export {
   parseCapabilityRequestPayload,
   parseDiffFileContentWire,
   parseDiffFileListWire,
+  parsePauseSessionResponsePayload,
   parsePushEnvelopePlaintext,
   parseReadBoardResponsePayload,
   parseReadDiffResponsePayload,

package/dist/wire/framing.d.ts

@@ -6,6 +6,8 @@ export declare const MAX_DECODED_LENGTH: number;
 export declare const COMPRESSION_THRESHOLD: number;
 /** The `code` a desktop puts on its refusal of a verb its build does not know. */
 export declare const UNSUPPORTED_VERB_ERROR_CODE: CapabilityErrorCode;
+/** The `code` a desktop puts on its refusal of a response that would not fit the frame caps above. */
+export declare const RESPONSE_TOO_LARGE_ERROR_CODE: CapabilityErrorCode;
 /**
  * Thrown by `decodeMessage` for a capability-request whose envelope is
  * well-formed (a string `requestId`, a string `verb`, a JSON `payload`) but
@@ -34,4 +36,17 @@ export declare class UnsupportedVerbError extends Error {
  */
 export declare function isUnsupportedVerbError(error: unknown): error is UnsupportedVerbError;
 export declare function encodeMessage(message: BridgeMessage): Uint8Array;
+/**
+ * Why `encodeMessage` would throw for `message`, or null when it would not,
+ * without keeping the frame. A sender with side effects asks this BEFORE
+ * committing them, so it can send something smaller instead of committing to
+ * a message it cannot send (the desktop re-takes a shorter terminal seed).
+ *
+ * Exact, not an estimate. Raw UTF-8 JSON at or under MAX_FRAME_LENGTH always
+ * fits, because `encodeMessage` only switches to deflate when deflate is
+ * smaller, so that common case costs one stringify. A larger message runs the
+ * real encode, deflate included, and a sender that then sends it pays that
+ * encode a second time. Measured terminal seeds are far under the threshold.
+ */
+export declare function encodeMessageFailure(message: BridgeMessage): string | null;
 export declare function decodeMessage(bytes: Uint8Array): BridgeMessage;

package/dist/wire/messages.d.ts

@@ -32,13 +32,21 @@ export interface CapabilityRequestMessage {
 }
 /**
  * A stable key a client can branch on, beside the human-readable `error`.
- * Today the one member is the refusal a desktop sends for a verb its build
- * does not know (see `UnsupportedVerbError` in framing.ts), so a newer phone
- * can tell "desktop is old" from "desktop is unreachable" and show the right
- * copy. A union rather than a bare string so a second code is a deliberate
- * addition here, not a typo at a call site.
+ * A union rather than a bare string so a new code is a deliberate addition
+ * here, not a typo at a call site.
+ *
+ * - `unsupported-verb`: the desktop's build does not know the verb (see
+ *   `UnsupportedVerbError` in framing.ts), so a newer phone can tell "desktop
+ *   is old" from "desktop is unreachable" and show the right copy.
+ * - `response-too-large`: the answer would not fit the frame caps
+ *   (MAX_DECODED_LENGTH before compression, MAX_FRAME_LENGTH after), so the
+ *   desktop refused instead of sending it. The request was valid and its
+ *   target still exists, so a client must not read it as the target being
+ *   gone (a session ending, a project removed). It is a backstop. A desktop
+ *   shrinks a `read-stream` terminal seed to fit rather than refuse it, so a
+ *   phone's terminal subscribe is never answered with this code.
  */
-export type CapabilityErrorCode = 'unsupported-verb';
+export type CapabilityErrorCode = 'unsupported-verb' | 'response-too-large';
 export interface CapabilityResponseMessage {
     type: 'capability-response';
     requestId: string;

package/dist/wire/payloads.d.ts

@@ -342,6 +342,29 @@ export interface StartSessionResponsePayload {
 }
 /** Phone-side guard: narrows a decoded start-session response before the phone acts on it. */
 export declare function parseStartSessionResponsePayload(payload: JsonValue): StartSessionResponsePayload;
+/**
+ * Keyed by task, like `start-session`: the desktop resolves the task's live
+ * session itself (a pause clears the task's `session_id`, and a stale phone
+ * view may name a session that already ended). It suspends that session the
+ * way the desktop's Pause button does, in the column the task is already in.
+ */
+export interface PauseSessionRequestPayload {
+    taskId: string;
+    projectId: string;
+}
+/**
+ * `ok` means the pause was ACCEPTED: the task had a live session, and the
+ * desktop has recorded it as paused by the user. The agent's own shutdown runs
+ * behind this response, because it can outlast the phone's per-verb budget,
+ * and its end reaches the phone as the board event that carries
+ * `paused: true`. A task with no live session is refused (`ok: false` on the
+ * capability response), so there is no idempotent shape to report here.
+ */
+export interface PauseSessionResponsePayload {
+    ok: boolean;
+}
+/** Phone-side guard: narrows a decoded pause-session response before the phone acts on it. */
+export declare function parsePauseSessionResponsePayload(payload: JsonValue): PauseSessionResponsePayload;
 export interface AnswerPermissionPromptRequestPayload {
     sessionId: string;
     /** The prompt id the phone believes is outstanding - the handler rejects a stale/replayed answer whose id no longer matches the live awaited prompt. */
@@ -428,6 +451,7 @@ export interface CapabilityRequestPayloadMap {
     'board-tool-write': BoardToolRequestPayload;
     'register-push': RegisterPushRequestPayload;
     'start-session': StartSessionRequestPayload;
+    'pause-session': PauseSessionRequestPayload;
 }
 export interface CapabilityResponsePayloadMap {
     'read-stream': ReadStreamResponsePayload | TranscriptWindowResponsePayload;
@@ -441,6 +465,7 @@ export interface CapabilityResponsePayloadMap {
     'board-tool-write': BoardToolResponsePayload;
     'register-push': RegisterPushResponsePayload;
     'start-session': StartSessionResponsePayload;
+    'pause-session': PauseSessionResponsePayload;
 }
 /**
  * Validates and narrows a decoded capability-request's generic JsonValue

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kangentic/protocol",
-  "version": "0.17.0",
+  "version": "0.19.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",