@kangentic/protocol 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -20,6 +20,8 @@ var __toCommonJS = (mod2) => __copyProps(__defProp({}, "__esModule", { value: tr
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  BOARD_TOOL_READ_NAMES: () => BOARD_TOOL_READ_NAMES,
+  BOARD_TOOL_WRITE_NAMES: () => BOARD_TOOL_WRITE_NAMES,
   CAPABILITY_VERBS: () => CAPABILITY_VERBS,
   CipherState: () => CipherState,
   ED25519_KEY_LENGTH: () => ED25519_KEY_LENGTH,
@@ -43,6 +45,7 @@ __export(index_exports, {
   decodeMessage: () => decodeMessage,
   decodePairingQrPayload: () => decodePairingQrPayload,
   deriveSecretstreamPair: () => deriveSecretstreamPair,
+  deriveSessionSlotId: () => deriveSessionSlotId,
   deriveShortAuthenticationString: () => deriveShortAuthenticationString,
   encodeMessage: () => encodeMessage,
   encodePairingQrPayload: () => encodePairingQrPayload,
@@ -52,8 +55,28 @@ __export(index_exports, {
   generateEd25519KeyPair: () => generateEd25519KeyPair,
   generateX25519KeyPair: () => generateX25519KeyPair,
   hexToBytes: () => hexToBytes,
+  isActivityReasonWire: () => isActivityReasonWire,
+  isActivityStateWire: () => isActivityStateWire,
+  isBoardToolReadName: () => isBoardToolReadName,
+  isBoardToolWriteName: () => isBoardToolWriteName,
+  isBridgeEvent: () => isBridgeEvent,
   isCapabilityVerb: () => isCapabilityVerb,
+  isJsonValue: () => isJsonValue,
+  isRecord: () => isRecord,
   isRosterEntryExpired: () => isRosterEntryExpired,
+  parseActivityEventPayload: () => parseActivityEventPayload,
+  parseBacklogItemWire: () => parseBacklogItemWire,
+  parseBoardColumnWire: () => parseBoardColumnWire,
+  parseBoardTaskWire: () => parseBoardTaskWire,
+  parseCapabilityRequestPayload: () => parseCapabilityRequestPayload,
+  parseDiffFileContentWire: () => parseDiffFileContentWire,
+  parseDiffFileListWire: () => parseDiffFileListWire,
+  parseReadBoardResponsePayload: () => parseReadBoardResponsePayload,
+  parseReadDiffResponsePayload: () => parseReadDiffResponsePayload,
+  parseReadStreamResponsePayload: () => parseReadStreamResponsePayload,
+  parseSessionEventWire: () => parseSessionEventWire,
+  parseSessionUsageWire: () => parseSessionUsageWire,
+  parseTranscriptEntriesWire: () => parseTranscriptEntriesWire,
   randomBytes: () => randomBytes4,
   rosterDeviceCapabilitySet: () => rosterDeviceCapabilitySet,
   signRosterEntry: () => signRosterEntry,
@@ -4236,6 +4259,14 @@ function deriveShortAuthenticationString(handshakeHash) {
   return { digits, emoji };
 }
 
+// src/crypto/slot.ts
+var SESSION_SLOT_LABEL = "kangentic-session-slot-v1";
+var SESSION_SLOT_LENGTH = 16;
+function deriveSessionSlotId(desktopStaticPublicKey, phoneStaticPublicKey) {
+  const material = concatBytes4(desktopStaticPublicKey, phoneStaticPublicKey);
+  return bytesToHex(deriveLabeledKey(material, SESSION_SLOT_LABEL, SESSION_SLOT_LENGTH));
+}
+
 // src/capabilities/verbs.ts
 var CAPABILITY_VERBS = [
   "read-stream",
@@ -4243,7 +4274,10 @@ var CAPABILITY_VERBS = [
   "read-diff",
   "send-user-message",
   "move-task",
-  "answer-permission-prompt"
+  "answer-permission-prompt",
+  "interactive-terminal",
+  "board-tool-read",
+  "board-tool-write"
 ];
 function isCapabilityVerb(value) {
   return CAPABILITY_VERBS.includes(value);
@@ -4259,6 +4293,19 @@ function capabilitySetToArray(capabilities) {
   return Array.from(capabilities);
 }
 
+// src/wire/json-value.ts
+function isJsonValue(value) {
+  if (value === null) return true;
+  const valueType = typeof value;
+  if (valueType === "boolean" || valueType === "number" || valueType === "string") return true;
+  if (Array.isArray(value)) return value.every(isJsonValue);
+  if (valueType === "object") return Object.values(value).every(isJsonValue);
+  return false;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // src/wire/framing.ts
 var MAX_FRAME_LENGTH = 1024 * 1024;
 function encodeMessage(message) {
@@ -4275,16 +4322,29 @@ function decodeMessage(bytes) {
   const parsed = JSON.parse(new TextDecoder().decode(bytes));
   return validateBridgeMessage(parsed);
 }
-function isJsonValue(value) {
-  if (value === null) return true;
-  const t = typeof value;
-  if (t === "boolean" || t === "number" || t === "string") return true;
-  if (Array.isArray(value)) return value.every(isJsonValue);
-  if (t === "object") return Object.values(value).every(isJsonValue);
-  return false;
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null;
+function validateEvent(event) {
+  if (typeof event.kind !== "string") throw new Error('event message missing a valid "kind"');
+  if (!isJsonValue(event.payload)) throw new Error("event payload is not JSON-serializable");
+  switch (event.kind) {
+    case "transcript":
+    case "activity":
+    case "terminal": {
+      if (typeof event.sessionId !== "string") throw new Error(`"${event.kind}" event is missing "sessionId"`);
+      if (typeof event.taskId !== "string") throw new Error(`"${event.kind}" event is missing "taskId"`);
+      return event;
+    }
+    case "board": {
+      if (typeof event.projectId !== "string") throw new Error('"board" event is missing "projectId"');
+      if (event.taskId !== void 0 && typeof event.taskId !== "string") throw new Error('"board" event has a non-string "taskId"');
+      return event;
+    }
+    case "diff": {
+      if (typeof event.taskId !== "string") throw new Error('"diff" event is missing "taskId"');
+      return event;
+    }
+    default:
+      throw new Error(`event message has an unknown event kind: ${event.kind}`);
+  }
 }
 function validateBridgeMessage(value) {
   if (!isRecord(value) || typeof value.type !== "string") {
@@ -4313,18 +4373,8 @@ function validateBridgeMessage(value) {
       };
     }
     case "event": {
-      const event = value.event;
-      if (!isRecord(event) || typeof event.kind !== "string") {
-        throw new Error('event message missing a valid "event"');
-      }
-      if (typeof event.taskId !== "string") throw new Error('event is missing "taskId"');
-      if (!isJsonValue(event.payload)) throw new Error("event payload is not JSON-serializable");
-      if (event.kind === "transcript" || event.kind === "activity") {
-        if (typeof event.sessionId !== "string") throw new Error(`"${event.kind}" event is missing "sessionId"`);
-      } else if (event.kind !== "board") {
-        throw new Error(`event message has an unknown event kind: ${event.kind}`);
-      }
-      return { type: "event", event };
+      if (!isRecord(value.event)) throw new Error('event message missing a valid "event"');
+      return { type: "event", event: validateEvent(value.event) };
     }
     default:
       throw new Error(`Unknown bridge message type: ${value.type}`);
@@ -4351,6 +4401,360 @@ function unwrapSessionFrame(frame) {
   return { kind, payload: frame.subarray(1) };
 }
 
+// src/events/payloads.ts
+var DIFF_FILE_STATUSES = ["A", "M", "D", "R", "C", "U"];
+var TRANSCRIPT_SYSTEM_SUBTYPES = ["compaction", "command", "command_output", "session_boundary"];
+function requireString(record, field, context) {
+  const value = record[field];
+  if (typeof value !== "string") throw new Error(`${context} is missing a string "${field}"`);
+  return value;
+}
+function requireNumber(record, field, context) {
+  const value = record[field];
+  if (typeof value !== "number") throw new Error(`${context} is missing a number "${field}"`);
+  return value;
+}
+function requireBoolean(record, field, context) {
+  const value = record[field];
+  if (typeof value !== "boolean") throw new Error(`${context} is missing a boolean "${field}"`);
+  return value;
+}
+function isTranscriptBlockWire(value) {
+  if (!isRecord(value)) return false;
+  if (value.type === "text" || value.type === "thinking") return typeof value.text === "string";
+  if (value.type === "tool_use") return typeof value.id === "string" && typeof value.name === "string" && "input" in value;
+  return false;
+}
+function isTranscriptEntryWire(value) {
+  if (!isRecord(value)) return false;
+  if (typeof value.uuid !== "string" || typeof value.ts !== "number") return false;
+  switch (value.kind) {
+    case "user":
+      return typeof value.text === "string";
+    case "assistant":
+      return Array.isArray(value.blocks) && value.blocks.every(isTranscriptBlockWire);
+    case "tool_result":
+      return typeof value.toolUseId === "string" && typeof value.content === "string";
+    case "system":
+      return typeof value.subtype === "string" && TRANSCRIPT_SYSTEM_SUBTYPES.includes(value.subtype) && typeof value.text === "string";
+    default:
+      return false;
+  }
+}
+function parseTranscriptEntriesWire(payload) {
+  if (!Array.isArray(payload)) throw new Error("transcript payload must be an array of entries");
+  return payload.map((entry, index) => {
+    if (!isTranscriptEntryWire(entry)) throw new Error(`transcript payload entry ${index} is malformed`);
+    return entry;
+  });
+}
+function isActivityStateWire(value) {
+  return value === "thinking" || value === "idle" || value === "permission";
+}
+function isActivityReasonWire(value) {
+  if (!isRecord(value)) return false;
+  switch (value.kind) {
+    case "idle":
+    case "permission":
+    case "turn-active":
+      return true;
+    case "tool":
+      return typeof value.pendingCount === "number" && (value.currentTool === null || typeof value.currentTool === "string");
+    case "subagent":
+      return typeof value.depth === "number";
+    case "background-shell":
+      return typeof value.count === "number" && Array.isArray(value.ids) && value.ids.every((id) => typeof id === "string");
+    default:
+      return false;
+  }
+}
+function parseSessionUsageWire(payload) {
+  if (!isRecord(payload)) throw new Error("usage payload must be an object");
+  const contextWindow = payload.contextWindow;
+  if (!isRecord(contextWindow)) throw new Error('usage payload is missing "contextWindow"');
+  const cost = payload.cost;
+  if (!isRecord(cost)) throw new Error('usage payload is missing "cost"');
+  const model = payload.model;
+  if (!isRecord(model)) throw new Error('usage payload is missing "model"');
+  return {
+    contextWindow: {
+      usedPercentage: requireNumber(contextWindow, "usedPercentage", "usage contextWindow"),
+      usedTokens: requireNumber(contextWindow, "usedTokens", "usage contextWindow"),
+      cacheTokens: requireNumber(contextWindow, "cacheTokens", "usage contextWindow"),
+      totalInputTokens: requireNumber(contextWindow, "totalInputTokens", "usage contextWindow"),
+      totalOutputTokens: requireNumber(contextWindow, "totalOutputTokens", "usage contextWindow"),
+      contextWindowSize: requireNumber(contextWindow, "contextWindowSize", "usage contextWindow")
+    },
+    cost: {
+      totalCostUsd: requireNumber(cost, "totalCostUsd", "usage cost"),
+      totalDurationMs: requireNumber(cost, "totalDurationMs", "usage cost")
+    },
+    ...typeof payload.toolCallCount === "number" ? { toolCallCount: payload.toolCallCount } : {},
+    model: {
+      id: requireString(model, "id", "usage model"),
+      displayName: requireString(model, "displayName", "usage model"),
+      ...typeof model.effort === "string" ? { effort: model.effort } : {}
+    }
+  };
+}
+function parseSessionEventWire(payload) {
+  if (!isRecord(payload)) throw new Error("session event payload must be an object");
+  return {
+    ts: requireNumber(payload, "ts", "session event"),
+    type: requireString(payload, "type", "session event"),
+    ...typeof payload.tool === "string" ? { tool: payload.tool } : {},
+    ...typeof payload.toolId === "string" ? { toolId: payload.toolId } : {},
+    ...typeof payload.detail === "string" ? { detail: payload.detail } : {}
+  };
+}
+function parseStringArray(value, context) {
+  if (!Array.isArray(value) || !value.every((item) => typeof item === "string")) {
+    throw new Error(`${context} is not a string array`);
+  }
+  return value;
+}
+function nullableString(record, field) {
+  const value = record[field];
+  return typeof value === "string" ? value : null;
+}
+function nullableNumber(record, field) {
+  const value = record[field];
+  return typeof value === "number" ? value : null;
+}
+function parseBoardColumnWire(value) {
+  if (!isRecord(value)) throw new Error("board column must be an object");
+  return {
+    id: requireString(value, "id", "board column"),
+    name: requireString(value, "name", "board column"),
+    description: nullableString(value, "description"),
+    role: nullableString(value, "role"),
+    position: requireNumber(value, "position", "board column"),
+    color: requireString(value, "color", "board column"),
+    icon: nullableString(value, "icon"),
+    is_archived: requireBoolean(value, "is_archived", "board column"),
+    is_ghost: requireBoolean(value, "is_ghost", "board column")
+  };
+}
+function parseBoardTaskWire(value) {
+  if (!isRecord(value)) throw new Error("board task must be an object");
+  return {
+    id: requireString(value, "id", "board task"),
+    display_id: requireNumber(value, "display_id", "board task"),
+    title: requireString(value, "title", "board task"),
+    description: typeof value.description === "string" ? value.description : "",
+    swimlane_id: requireString(value, "swimlane_id", "board task"),
+    position: requireNumber(value, "position", "board task"),
+    agent: nullableString(value, "agent"),
+    session_id: nullableString(value, "session_id"),
+    worktree_path: nullableString(value, "worktree_path"),
+    branch_name: nullableString(value, "branch_name"),
+    pr_number: nullableNumber(value, "pr_number"),
+    pr_url: nullableString(value, "pr_url"),
+    pr_state: nullableString(value, "pr_state"),
+    base_branch: nullableString(value, "base_branch"),
+    labels: Array.isArray(value.labels) ? parseStringArray(value.labels, "board task labels") : [],
+    priority: typeof value.priority === "number" ? value.priority : 0,
+    attachment_count: typeof value.attachment_count === "number" ? value.attachment_count : 0,
+    archived_at: nullableString(value, "archived_at"),
+    created_at: requireString(value, "created_at", "board task"),
+    updated_at: requireString(value, "updated_at", "board task")
+  };
+}
+function parseBacklogItemWire(value) {
+  if (!isRecord(value)) throw new Error("backlog item must be an object");
+  return {
+    id: requireString(value, "id", "backlog item"),
+    title: requireString(value, "title", "backlog item"),
+    description: typeof value.description === "string" ? value.description : "",
+    priority: typeof value.priority === "number" ? value.priority : 0,
+    labels: Array.isArray(value.labels) ? parseStringArray(value.labels, "backlog item labels") : [],
+    position: requireNumber(value, "position", "backlog item"),
+    item_type: nullableString(value, "item_type"),
+    external_url: nullableString(value, "external_url"),
+    attachment_count: typeof value.attachment_count === "number" ? value.attachment_count : 0,
+    created_at: requireString(value, "created_at", "backlog item"),
+    updated_at: requireString(value, "updated_at", "backlog item")
+  };
+}
+function parseDiffFileListWire(payload) {
+  if (!isRecord(payload)) throw new Error("diff file list must be an object");
+  if (!Array.isArray(payload.files)) throw new Error('diff file list is missing "files"');
+  const files = payload.files.map((file, index) => {
+    if (!isRecord(file)) throw new Error(`diff file entry ${index} must be an object`);
+    const status = requireString(file, "status", `diff file entry ${index}`);
+    if (!DIFF_FILE_STATUSES.includes(status)) throw new Error(`diff file entry ${index} has an invalid "status"`);
+    return {
+      path: requireString(file, "path", `diff file entry ${index}`),
+      status,
+      insertions: requireNumber(file, "insertions", `diff file entry ${index}`),
+      deletions: requireNumber(file, "deletions", `diff file entry ${index}`),
+      ...typeof file.oldPath === "string" ? { oldPath: file.oldPath } : {},
+      binary: requireBoolean(file, "binary", `diff file entry ${index}`)
+    };
+  });
+  return {
+    files,
+    totalInsertions: requireNumber(payload, "totalInsertions", "diff file list"),
+    totalDeletions: requireNumber(payload, "totalDeletions", "diff file list")
+  };
+}
+function parseDiffFileContentWire(payload) {
+  if (!isRecord(payload)) throw new Error("diff file content must be an object");
+  return {
+    original: requireString(payload, "original", "diff file content"),
+    modified: requireString(payload, "modified", "diff file content"),
+    language: requireString(payload, "language", "diff file content")
+  };
+}
+
+// src/wire/payloads.ts
+function parseReadStreamResponsePayload(payload) {
+  if (!isRecord(payload)) throw new Error("read-stream response must be an object");
+  if (typeof payload.scrollback !== "string") throw new Error('read-stream response is missing "scrollback"');
+  if (!isRecord(payload.activity)) throw new Error('read-stream response is missing "activity"');
+  const state = payload.activity.state;
+  const reason = payload.activity.reason;
+  if (state !== null && !isActivityStateWire(state)) throw new Error('read-stream response has an invalid activity "state"');
+  if (reason !== null && !isActivityReasonWire(reason)) throw new Error('read-stream response has an invalid activity "reason"');
+  if (payload.awaitedPromptId !== null && typeof payload.awaitedPromptId !== "string") {
+    throw new Error('read-stream response has an invalid "awaitedPromptId"');
+  }
+  return {
+    scrollback: payload.scrollback,
+    activity: { state: state ?? null, reason: reason ?? null },
+    usage: payload.usage === null || payload.usage === void 0 ? null : parseSessionUsageWire(payload.usage),
+    awaitedPromptId: payload.awaitedPromptId ?? null
+  };
+}
+function parseReadStreamRequestPayload(payload) {
+  if (!isRecord(payload)) throw new Error("read-stream payload must be an object");
+  if (typeof payload.sessionId !== "string") throw new Error('read-stream payload missing "sessionId"');
+  if (payload.action !== "subscribe" && payload.action !== "unsubscribe") {
+    throw new Error('read-stream payload has an invalid "action"');
+  }
+  return { sessionId: payload.sessionId, action: payload.action };
+}
+function parseReadBoardResponsePayload(payload) {
+  if (!isRecord(payload)) throw new Error("read-board response must be an object");
+  if (Array.isArray(payload.projects)) {
+    const projects = payload.projects.map((project, index) => {
+      if (!isRecord(project) || typeof project.id !== "string" || typeof project.name !== "string") {
+        throw new Error(`read-board project ${index} is malformed`);
+      }
+      return { id: project.id, name: project.name };
+    });
+    return { projects };
+  }
+  if (typeof payload.projectId !== "string") throw new Error('read-board response is missing "projectId"');
+  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"');
+  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))
+  };
+}
+function parseReadBoardRequestPayload(payload) {
+  if (!isRecord(payload)) throw new Error("read-board payload must be an object");
+  if (payload.projectId !== void 0 && typeof payload.projectId !== "string") {
+    throw new Error('read-board payload has a non-string "projectId"');
+  }
+  if (payload.action !== void 0 && payload.action !== "subscribe" && payload.action !== "unsubscribe") {
+    throw new Error('read-board payload has an invalid "action"');
+  }
+  return { projectId: payload.projectId, action: payload.action };
+}
+function parseReadDiffResponsePayload(payload) {
+  if (!isRecord(payload)) throw new Error("read-diff response must be an object");
+  return "files" in payload ? parseDiffFileListWire(payload) : parseDiffFileContentWire(payload);
+}
+function parseReadDiffRequestPayload(payload) {
+  if (!isRecord(payload)) throw new Error("read-diff payload must be an object");
+  if (typeof payload.taskId !== "string") throw new Error('read-diff payload missing "taskId"');
+  if (typeof payload.projectId !== "string") throw new Error('read-diff payload missing "projectId"');
+  if (payload.filePath !== void 0 && typeof payload.filePath !== "string") {
+    throw new Error('read-diff payload has a non-string "filePath"');
+  }
+  if (payload.scope !== void 0 && payload.scope !== "working" && payload.scope !== "staged" && payload.scope !== "branch") {
+    throw new Error('read-diff payload has an invalid "scope"');
+  }
+  if (payload.action !== void 0 && payload.action !== "subscribe" && payload.action !== "unsubscribe") {
+    throw new Error('read-diff payload has an invalid "action"');
+  }
+  return {
+    taskId: payload.taskId,
+    projectId: payload.projectId,
+    filePath: payload.filePath,
+    scope: payload.scope,
+    action: payload.action
+  };
+}
+function parseSendUserMessageRequestPayload(payload) {
+  if (!isRecord(payload)) throw new Error("send-user-message payload must be an object");
+  if (typeof payload.sessionId !== "string") throw new Error('send-user-message payload missing "sessionId"');
+  if (typeof payload.text !== "string") throw new Error('send-user-message payload missing "text"');
+  return { sessionId: payload.sessionId, text: payload.text };
+}
+function parseMoveTaskRequestPayload(payload) {
+  if (!isRecord(payload)) throw new Error("move-task payload must be an object");
+  if (typeof payload.taskId !== "string") throw new Error('move-task payload missing "taskId"');
+  if (typeof payload.targetSwimlaneId !== "string") throw new Error('move-task payload missing "targetSwimlaneId"');
+  if (typeof payload.targetPosition !== "number") throw new Error('move-task payload missing "targetPosition"');
+  if (typeof payload.projectId !== "string") throw new Error('move-task payload missing "projectId"');
+  return {
+    taskId: payload.taskId,
+    targetSwimlaneId: payload.targetSwimlaneId,
+    targetPosition: payload.targetPosition,
+    projectId: payload.projectId
+  };
+}
+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"');
+  if (typeof payload.promptId !== "string") throw new Error('answer-permission-prompt payload missing "promptId"');
+  if (typeof payload.keystrokes !== "string") throw new Error('answer-permission-prompt payload missing "keystrokes"');
+  return { sessionId: payload.sessionId, promptId: payload.promptId, keystrokes: payload.keystrokes };
+}
+function parseInteractiveTerminalRequestPayload(payload) {
+  if (!isRecord(payload)) throw new Error("interactive-terminal payload must be an object");
+  if (typeof payload.sessionId !== "string") throw new Error('interactive-terminal payload missing "sessionId"');
+  if (typeof payload.data !== "string") throw new Error('interactive-terminal payload missing "data"');
+  return { sessionId: payload.sessionId, data: payload.data };
+}
+function parseBoardToolRequestPayload(payload) {
+  if (!isRecord(payload)) throw new Error("board-tool payload must be an object");
+  if (typeof payload.tool !== "string") throw new Error('board-tool payload missing "tool"');
+  if (payload.params === void 0 || !isJsonValue(payload.params)) throw new Error('board-tool payload missing a JSON "params"');
+  return { tool: payload.tool, params: payload.params };
+}
+function parseCapabilityRequestPayload(verb, payload) {
+  switch (verb) {
+    case "read-stream":
+      return parseReadStreamRequestPayload(payload);
+    case "read-board":
+      return parseReadBoardRequestPayload(payload);
+    case "read-diff":
+      return parseReadDiffRequestPayload(payload);
+    case "send-user-message":
+      return parseSendUserMessageRequestPayload(payload);
+    case "move-task":
+      return parseMoveTaskRequestPayload(payload);
+    case "answer-permission-prompt":
+      return parseAnswerPermissionPromptRequestPayload(payload);
+    case "interactive-terminal":
+      return parseInteractiveTerminalRequestPayload(payload);
+    case "board-tool-read":
+    case "board-tool-write":
+      return parseBoardToolRequestPayload(payload);
+    default: {
+      const exhaustiveCheck = verb;
+      throw new Error(`Unknown capability verb: ${String(exhaustiveCheck)}`);
+    }
+  }
+}
+
 // src/wire/base64url.ts
 var ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
 var DECODE_MAP = {};
@@ -4512,8 +4916,108 @@ function rosterDeviceCapabilitySet(entry) {
 function capabilitySetToRosterCapabilities(capabilities) {
   return capabilitySetToArray(capabilities);
 }
+
+// src/capabilities/board-tools.ts
+var BOARD_TOOL_READ_NAMES = [
+  "search_tasks",
+  "find_task",
+  "get_current_task",
+  "get_task_stats",
+  "get_usage_stats",
+  "board_summary",
+  "list_sessions",
+  "get_session_history",
+  "get_column_detail",
+  "get_handoff_context",
+  "get_transcript",
+  "get_session_files",
+  "get_session_events"
+];
+var BOARD_TOOL_WRITE_NAMES = [
+  "create_task",
+  "update_task",
+  "delete_task",
+  "link_pr",
+  "remove_attachment",
+  "update_column",
+  "create_backlog_task",
+  "promote_backlog",
+  "update_backlog_item",
+  "delete_backlog_item"
+];
+function isBoardToolReadName(value) {
+  return BOARD_TOOL_READ_NAMES.includes(value);
+}
+function isBoardToolWriteName(value) {
+  return BOARD_TOOL_WRITE_NAMES.includes(value);
+}
+
+// src/events/event.ts
+var BOARD_CHANGES = ["task-created", "task-updated", "task-deleted", "swimlane-updated", "backlog-changed"];
+function parseActivityEventPayload(payload) {
+  if (!isRecord(payload)) throw new Error("activity payload must be an object");
+  switch (payload.type) {
+    case "activity": {
+      if (!isActivityStateWire(payload.state)) throw new Error('activity payload has an invalid "state"');
+      if (!isActivityReasonWire(payload.reason)) throw new Error('activity payload has an invalid "reason"');
+      return { type: "activity", state: payload.state, reason: payload.reason };
+    }
+    case "usage":
+      return { type: "usage", usage: parseSessionUsageWire(payload.usage) };
+    case "event":
+      return { type: "event", event: parseSessionEventWire(payload.event) };
+    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 };
+    }
+    default:
+      throw new Error('activity payload has an unknown "type"');
+  }
+}
+function isBridgeEvent(value) {
+  if (!isRecord(value)) return false;
+  switch (value.kind) {
+    case "transcript": {
+      if (typeof value.sessionId !== "string" || typeof value.taskId !== "string") return false;
+      try {
+        parseTranscriptEntriesWire(value.payload);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    case "activity": {
+      if (typeof value.sessionId !== "string" || typeof value.taskId !== "string") return false;
+      try {
+        parseActivityEventPayload(value.payload);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    case "terminal": {
+      if (typeof value.sessionId !== "string" || typeof value.taskId !== "string") return false;
+      return isRecord(value.payload) && typeof value.payload.data === "string";
+    }
+    case "board": {
+      if (typeof value.projectId !== "string") return false;
+      if (value.taskId !== void 0 && typeof value.taskId !== "string") return false;
+      if (!isRecord(value.payload)) return false;
+      const change = value.payload.change;
+      if (typeof change !== "string" || !BOARD_CHANGES.includes(change)) return false;
+      return Array.isArray(value.payload.ids) && value.payload.ids.every((id) => typeof id === "string");
+    }
+    case "diff":
+      return typeof value.taskId === "string" && value.payload === null;
+    default:
+      return false;
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BOARD_TOOL_READ_NAMES,
+  BOARD_TOOL_WRITE_NAMES,
   CAPABILITY_VERBS,
   CipherState,
   ED25519_KEY_LENGTH,
@@ -4537,6 +5041,7 @@ function capabilitySetToRosterCapabilities(capabilities) {
   decodeMessage,
   decodePairingQrPayload,
   deriveSecretstreamPair,
+  deriveSessionSlotId,
   deriveShortAuthenticationString,
   encodeMessage,
   encodePairingQrPayload,
@@ -4546,8 +5051,28 @@ function capabilitySetToRosterCapabilities(capabilities) {
   generateEd25519KeyPair,
   generateX25519KeyPair,
   hexToBytes,
+  isActivityReasonWire,
+  isActivityStateWire,
+  isBoardToolReadName,
+  isBoardToolWriteName,
+  isBridgeEvent,
   isCapabilityVerb,
+  isJsonValue,
+  isRecord,
   isRosterEntryExpired,
+  parseActivityEventPayload,
+  parseBacklogItemWire,
+  parseBoardColumnWire,
+  parseBoardTaskWire,
+  parseCapabilityRequestPayload,
+  parseDiffFileContentWire,
+  parseDiffFileListWire,
+  parseReadBoardResponsePayload,
+  parseReadDiffResponsePayload,
+  parseReadStreamResponsePayload,
+  parseSessionEventWire,
+  parseSessionUsageWire,
+  parseTranscriptEntriesWire,
   randomBytes,
   rosterDeviceCapabilitySet,
   signRosterEntry,