@kangentic/protocol 0.1.1 → 0.2.0

package/dist/index.d.ts

@@ -7,11 +7,16 @@ export { createKKHandshake, type KKHandshakeOptions } from './crypto/noise/kk';
 export { createPairingInitiatorHandshake, createPairingResponderHandshake, type PairingInitiatorOptions, type PairingResponderOptions, } from './crypto/pairing-handshake';
 export { SecretstreamState, deriveSecretstreamPair, FrameTag, type SecretstreamDirectionPair, } from './crypto/secretstream';
 export { deriveShortAuthenticationString, type ShortAuthenticationString } from './crypto/sas';
+export { deriveSessionSlotId } from './crypto/slot';
 export type { JsonValue, BridgeMessage, HeartbeatMessage, CapabilityRequestMessage, CapabilityResponseMessage, EventMessage } from './wire/messages';
 export { encodeMessage, decodeMessage, MAX_FRAME_LENGTH } from './wire/framing';
+export { isJsonValue, isRecord } from './wire/json-value';
 export { SessionFrameKind, wrapSessionFrame, unwrapSessionFrame } from './wire/session-frame';
+export { parseCapabilityRequestPayload, parseReadStreamResponsePayload, parseReadBoardResponsePayload, parseReadDiffResponsePayload, type CapabilityRequestPayloadMap, type CapabilityResponsePayloadMap, type ReadStreamRequestPayload, type ReadStreamResponsePayload, type ReadBoardRequestPayload, type ReadBoardProjectSummary, type ReadBoardProjectListResponsePayload, type ReadBoardSnapshotResponsePayload, 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, } from './wire/payloads';
 export { PAIRING_URI_SCHEME, encodePairingQrPayload, decodePairingQrPayload, type PairingQrPayload, } from './pairing/qr';
 export { signRosterEntry, verifyRosterEntry, encodeRosterEntryForSigning, isRosterEntryExpired, findRosterDevice, rosterDeviceCapabilitySet, capabilitySetToRosterCapabilities, type RosterDeviceEntry, type DeviceRoster, } from './roster/roster';
 export { CAPABILITY_VERBS, isCapabilityVerb, capabilitySetFromArray, capabilitySetToArray, type CapabilityVerb, type CapabilitySet, } from './capabilities/verbs';
-export type { BridgeEvent, TranscriptEvent, BoardEvent, ActivityEvent } from './events/event';
+export { BOARD_TOOL_READ_NAMES, BOARD_TOOL_WRITE_NAMES, isBoardToolReadName, isBoardToolWriteName, type BoardToolReadName, type BoardToolWriteName, type BoardToolName, } from './capabilities/board-tools';
+export { isBridgeEvent, parseActivityEventPayload, type BridgeEvent, type TranscriptEvent, type ActivityEvent, type ActivityEventPayload, type TerminalEvent, type BoardEvent, type BoardEventPayload, type DiffEvent, } from './events/event';
+export { parseTranscriptEntriesWire, isActivityStateWire, isActivityReasonWire, parseSessionUsageWire, parseSessionEventWire, parseBoardColumnWire, parseBoardTaskWire, parseBacklogItemWire, parseDiffFileListWire, parseDiffFileContentWire, type TranscriptBlockWire, type TranscriptEntryWire, type TranscriptTurnUsageWire, type TranscriptSystemSubtypeWire, type ActivityStateWire, type ActivityReasonWire, type SessionUsageWire, type SessionEventWire, type BoardColumnWire, type BoardTaskWire, type BacklogItemWire, type DiffFileStatusWire, type DiffFileWire, type DiffFileListWire, type DiffFileContentWire, } from './events/payloads';
 export type { Transport, TransportState, Unsubscribe } from './transport/transport';

package/dist/index.mjs

@@ -4170,6 +4170,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",
@@ -4177,7 +4185,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);
@@ -4193,6 +4204,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) {
@@ -4209,16 +4233,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") {
@@ -4247,18 +4284,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}`);
@@ -4285,6 +4312,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 = {};
@@ -4446,7 +4827,107 @@ 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;
+  }
+}
 export {
+  BOARD_TOOL_READ_NAMES,
+  BOARD_TOOL_WRITE_NAMES,
   CAPABILITY_VERBS,
   CipherState,
   ED25519_KEY_LENGTH,
@@ -4470,6 +4951,7 @@ export {
   decodeMessage,
   decodePairingQrPayload,
   deriveSecretstreamPair,
+  deriveSessionSlotId,
   deriveShortAuthenticationString,
   encodeMessage,
   encodePairingQrPayload,
@@ -4479,8 +4961,28 @@ export {
   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,
   randomBytes4 as randomBytes,
   rosterDeviceCapabilitySet,
   signRosterEntry,

package/dist/wire/json-value.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The single `isJsonValue` runtime check, shared by framing.ts (validating a
+ * whole decoded BridgeMessage) and payloads.ts (validating one verb's
+ * request payload before a handler trusts it). Split out so neither module
+ * has to re-derive the other's copy.
+ */
+import type { JsonValue } from './messages';
+export declare function isJsonValue(value: unknown): value is JsonValue;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;