@kangentic/protocol 0.5.0 → 0.6.0

package/dist/events/event.d.ts

@@ -45,10 +45,19 @@ export type ActivityEventPayload = {
 } | {
     type: 'event';
     event: SessionEventWire;
-} | {
+}
+/**
+ * `options`, when present on a pending push, carries the prompt dialog's
+ * numbered option labels in keystroke order (options[0] is answered with
+ * "1\r"). Absent from pre-0.6.0 desktops and whenever no numbered dialog
+ * could be parsed from the PTY frame; the phone then falls back to its
+ * blind approve/deny keystrokes.
+ */
+ | {
     type: 'permission';
     promptId: string;
     pending: boolean;
+    options?: string[];
 }
 /**
  * The streamed session's PTY exited. Pushed once by the desktop's

package/dist/index.cjs

@@ -5437,6 +5437,15 @@ function parseReadStreamResponsePayload(payload) {
     usage: payload.usage === null || payload.usage === void 0 ? null : parseSessionUsageWire(payload.usage),
     awaitedPromptId: payload.awaitedPromptId ?? null
   };
+  if (payload.awaitedPromptOptions !== void 0) {
+    if (payload.awaitedPromptOptions === null) {
+      response.awaitedPromptOptions = null;
+    } else if (Array.isArray(payload.awaitedPromptOptions) && payload.awaitedPromptOptions.every((option) => typeof option === "string")) {
+      response.awaitedPromptOptions = payload.awaitedPromptOptions;
+    } else {
+      throw new Error('read-stream response has an invalid "awaitedPromptOptions"');
+    }
+  }
   if (payload.ptyDimensions !== void 0) {
     response.ptyDimensions = parseTerminalDimensionsWire(payload.ptyDimensions);
   }
@@ -5514,12 +5523,16 @@ function parseReadBoardResponsePayload(payload) {
   if (!Array.isArray(payload.columns)) throw new Error('read-board response is missing "columns"');
   if (!Array.isArray(payload.tasks)) throw new Error('read-board response is missing "tasks"');
   if (!Array.isArray(payload.backlog)) throw new Error('read-board response is missing "backlog"');
+  if (payload.showTicketNumbers !== void 0 && typeof payload.showTicketNumbers !== "boolean") {
+    throw new Error('read-board response has a non-boolean "showTicketNumbers"');
+  }
   return {
     projectId: payload.projectId,
     columns: payload.columns.map((column) => parseBoardColumnWire(column)),
     tasks: payload.tasks.map((task) => parseBoardTaskWire(task)),
     backlog: payload.backlog.map((item) => parseBacklogItemWire(item)),
-    ...payload.projectColor !== void 0 ? { projectColor: parseAccentColor(payload.projectColor, "read-board snapshot") } : {}
+    ...payload.projectColor !== void 0 ? { projectColor: parseAccentColor(payload.projectColor, "read-board snapshot") } : {},
+    ...payload.showTicketNumbers !== void 0 ? { showTicketNumbers: payload.showTicketNumbers } : {}
   };
 }
 function parseReadBoardRequestPayload(payload) {
@@ -5895,7 +5908,13 @@ function parseActivityEventPayload(payload) {
     case "permission": {
       if (typeof payload.promptId !== "string") throw new Error('permission payload is missing "promptId"');
       if (typeof payload.pending !== "boolean") throw new Error('permission payload is missing "pending"');
-      return { type: "permission", promptId: payload.promptId, pending: payload.pending };
+      if (payload.options === void 0) {
+        return { type: "permission", promptId: payload.promptId, pending: payload.pending };
+      }
+      if (!Array.isArray(payload.options) || !payload.options.every((option) => typeof option === "string")) {
+        throw new Error('permission payload has an invalid "options"');
+      }
+      return { type: "permission", promptId: payload.promptId, pending: payload.pending, options: payload.options };
     }
     case "session-ended": {
       if (typeof payload.intentional !== "boolean") throw new Error('session-ended payload is missing "intentional"');

package/dist/index.mjs

@@ -5326,6 +5326,15 @@ function parseReadStreamResponsePayload(payload) {
     usage: payload.usage === null || payload.usage === void 0 ? null : parseSessionUsageWire(payload.usage),
     awaitedPromptId: payload.awaitedPromptId ?? null
   };
+  if (payload.awaitedPromptOptions !== void 0) {
+    if (payload.awaitedPromptOptions === null) {
+      response.awaitedPromptOptions = null;
+    } else if (Array.isArray(payload.awaitedPromptOptions) && payload.awaitedPromptOptions.every((option) => typeof option === "string")) {
+      response.awaitedPromptOptions = payload.awaitedPromptOptions;
+    } else {
+      throw new Error('read-stream response has an invalid "awaitedPromptOptions"');
+    }
+  }
   if (payload.ptyDimensions !== void 0) {
     response.ptyDimensions = parseTerminalDimensionsWire(payload.ptyDimensions);
   }
@@ -5403,12 +5412,16 @@ function parseReadBoardResponsePayload(payload) {
   if (!Array.isArray(payload.columns)) throw new Error('read-board response is missing "columns"');
   if (!Array.isArray(payload.tasks)) throw new Error('read-board response is missing "tasks"');
   if (!Array.isArray(payload.backlog)) throw new Error('read-board response is missing "backlog"');
+  if (payload.showTicketNumbers !== void 0 && typeof payload.showTicketNumbers !== "boolean") {
+    throw new Error('read-board response has a non-boolean "showTicketNumbers"');
+  }
   return {
     projectId: payload.projectId,
     columns: payload.columns.map((column) => parseBoardColumnWire(column)),
     tasks: payload.tasks.map((task) => parseBoardTaskWire(task)),
     backlog: payload.backlog.map((item) => parseBacklogItemWire(item)),
-    ...payload.projectColor !== void 0 ? { projectColor: parseAccentColor(payload.projectColor, "read-board snapshot") } : {}
+    ...payload.projectColor !== void 0 ? { projectColor: parseAccentColor(payload.projectColor, "read-board snapshot") } : {},
+    ...payload.showTicketNumbers !== void 0 ? { showTicketNumbers: payload.showTicketNumbers } : {}
   };
 }
 function parseReadBoardRequestPayload(payload) {
@@ -5784,7 +5797,13 @@ function parseActivityEventPayload(payload) {
     case "permission": {
       if (typeof payload.promptId !== "string") throw new Error('permission payload is missing "promptId"');
       if (typeof payload.pending !== "boolean") throw new Error('permission payload is missing "pending"');
-      return { type: "permission", promptId: payload.promptId, pending: payload.pending };
+      if (payload.options === void 0) {
+        return { type: "permission", promptId: payload.promptId, pending: payload.pending };
+      }
+      if (!Array.isArray(payload.options) || !payload.options.every((option) => typeof option === "string")) {
+        throw new Error('permission payload has an invalid "options"');
+      }
+      return { type: "permission", promptId: payload.promptId, pending: payload.pending, options: payload.options };
     }
     case "session-ended": {
       if (typeof payload.intentional !== "boolean") throw new Error('session-ended payload is missing "intentional"');

package/dist/wire/payloads.d.ts

@@ -48,6 +48,15 @@ export interface ReadStreamResponsePayload {
     usage: SessionUsageWire | null;
     /** The live outstanding permission-prompt id (see answer-permission-prompt), or null when none is pending. */
     awaitedPromptId: string | null;
+    /**
+     * The awaited prompt's numbered option labels, parsed by the desktop from
+     * the pending dialog's PTY frame, in keystroke order: options[0] is the
+     * row answered with "1\r", options[1] with "2\r", and so on. Absent from
+     * pre-0.6.0 desktops; absent or null means unknown (no numbered dialog
+     * could be parsed), and the phone falls back to its blind
+     * approve/deny keystrokes. Only meaningful while awaitedPromptId is set.
+     */
+    awaitedPromptOptions?: string[] | null;
     /**
      * The PTY grid the scrollback bytes are laid out for. Absent from
      * pre-0.4.0 desktops; the phone then falls back to inferring a width
@@ -103,6 +112,12 @@ export interface ReadBoardSnapshotResponsePayload {
     backlog: BacklogItemWire[];
     /** The project's accent color ("#rrggbb"); same semantics as ReadBoardProjectSummary.color. Absent from pre-0.5.0 desktops. */
     projectColor?: string;
+    /**
+     * The desktop's Layout "Ticket Numbers" setting: whether task cards
+     * display their #N number. Absent from pre-0.6.0 desktops (treat as
+     * true, the desktop default).
+     */
+    showTicketNumbers?: boolean;
 }
 export type ReadBoardResponsePayload = ReadBoardProjectListResponsePayload | ReadBoardSnapshotResponsePayload;
 /** Phone-side narrowing of a read-board response (project list or board snapshot). Throws on a malformed required field. */

package/package.json

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