@wrongstack/core 0.296.4 → 0.298.0

package/dist/hq/protocol.js

@@ -0,0 +1,675 @@
+// src/hq/protocol/governance.ts
+var SIGNAL_LEVELS = /* @__PURE__ */ new Set([
+  "healthy",
+  "notice",
+  "warning",
+  "unavailable"
+]);
+var SIGNAL_CODES = /* @__PURE__ */ new Set([
+  "attachment_broker_healthy",
+  "attachment_broker_initializing",
+  "attachment_broker_status_unavailable",
+  "attachment_broker_degraded",
+  "attachment_broker_audit_unhealthy",
+  "attachment_broker_revocation_pending",
+  "attachment_broker_stopped",
+  "broker_missing",
+  "broker_invalid",
+  "connection_failed",
+  "request_rejected",
+  "unexpected_response"
+]);
+var OPERATOR_ACTIONS = /* @__PURE__ */ new Set(["none", "observe", "investigate"]);
+var BROKER_STATES = /* @__PURE__ */ new Set(["idle", "active", "retry_wait", "stopped"]);
+var BROKER_HEALTH = /* @__PURE__ */ new Set(["initializing", "healthy", "degraded", "stopped"]);
+function isNonNegativeInteger(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function hasOnlyKeys(value, allowed) {
+  const allowedKeys = new Set(allowed);
+  return Object.keys(value).every((key) => allowedKeys.has(key));
+}
+function isHqGovernanceSnapshotPayload(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+  const payload = value;
+  if (!hasOnlyKeys(payload, [
+    "schemaVersion",
+    "projectId",
+    "observedAt",
+    "available",
+    "signal",
+    "daemon",
+    "attachmentBroker"
+  ]) || payload.schemaVersion !== 1 || typeof payload.projectId !== "string" || payload.projectId.length === 0 || typeof payload.observedAt !== "string" || typeof payload.available !== "boolean" || typeof payload.signal !== "object" || payload.signal === null || Array.isArray(payload.signal)) {
+    return false;
+  }
+  const signal = payload.signal;
+  if (!hasOnlyKeys(signal, ["level", "code", "operatorAction", "executionDisposition"]) || !SIGNAL_LEVELS.has(signal.level) || !SIGNAL_CODES.has(signal.code) || !OPERATOR_ACTIONS.has(signal.operatorAction) || signal.executionDisposition !== "continue") {
+    return false;
+  }
+  if (payload.available === false && (signal.level !== "unavailable" || payload.daemon !== void 0 || payload.attachmentBroker !== void 0) || payload.available === true && signal.level === "unavailable") {
+    return false;
+  }
+  if (payload.daemon !== void 0) {
+    if (typeof payload.daemon !== "object" || payload.daemon === null || Array.isArray(payload.daemon)) {
+      return false;
+    }
+    const daemon = payload.daemon;
+    if (!hasOnlyKeys(daemon, ["pid", "startedAt"]) || !isNonNegativeInteger(daemon.pid) || typeof daemon.startedAt !== "string") {
+      return false;
+    }
+  }
+  if (payload.attachmentBroker !== void 0 && payload.attachmentBroker !== null) {
+    if (typeof payload.attachmentBroker !== "object" || Array.isArray(payload.attachmentBroker)) {
+      return false;
+    }
+    const broker = payload.attachmentBroker;
+    if (!hasOnlyKeys(broker, [
+      "state",
+      "health",
+      "consecutiveFailures",
+      "pendingRevocations",
+      "auditHealthy",
+      "expiresAt",
+      "nextActionAt"
+    ]) || !BROKER_STATES.has(broker.state) || !BROKER_HEALTH.has(broker.health) || !isNonNegativeInteger(broker.consecutiveFailures) || !isNonNegativeInteger(broker.pendingRevocations) || typeof broker.auditHealthy !== "boolean" || broker.expiresAt !== void 0 && typeof broker.expiresAt !== "string" || broker.nextActionAt !== void 0 && typeof broker.nextActionAt !== "string") {
+      return false;
+    }
+  }
+  return true;
+}
+
+// src/hq/protocol/kanban.ts
+var HQ_KANBAN_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
+var MAX_HQ_KANBAN_BOARDS = 250;
+var MAX_HQ_KANBAN_BOARD_BYTES = 75e4;
+function isHqKanbanSnapshotPayload(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const payload = value;
+  if (typeof payload.projectId !== "string" || payload.projectId.length === 0 || typeof payload.generatedAt !== "string" || !Number.isFinite(Date.parse(payload.generatedAt)) || !Array.isArray(payload.boards) || !Array.isArray(payload.tombstones) || payload.boards.length > MAX_HQ_KANBAN_BOARDS || payload.tombstones.length > MAX_HQ_KANBAN_BOARDS) {
+    return false;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const item of payload.boards) {
+    if (!isBoardRecord(item) || seen.has(item.boardId)) return false;
+    seen.add(item.boardId);
+  }
+  for (const item of payload.tombstones) {
+    if (!isTombstone(item) || seen.has(item.boardId)) return false;
+    seen.add(item.boardId);
+  }
+  return true;
+}
+function isBoardRecord(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const record = value;
+  if (typeof record.boardId !== "string" || !HQ_KANBAN_ID_PATTERN.test(record.boardId) || typeof record.revision !== "number" || !Number.isSafeInteger(record.revision) || record.revision < 0 || typeof record.updatedAt !== "string" || !Number.isFinite(Date.parse(record.updatedAt)) || typeof record.board !== "object" || record.board === null || Array.isArray(record.board)) {
+    return false;
+  }
+  const board = record.board;
+  if (board.id !== record.boardId) return false;
+  try {
+    return new TextEncoder().encode(JSON.stringify(board)).byteLength <= MAX_HQ_KANBAN_BOARD_BYTES;
+  } catch {
+    return false;
+  }
+}
+function isTombstone(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const record = value;
+  return typeof record.boardId === "string" && HQ_KANBAN_ID_PATTERN.test(record.boardId) && typeof record.revision === "number" && Number.isSafeInteger(record.revision) && record.revision >= 0 && typeof record.deletedAt === "string" && Number.isFinite(Date.parse(record.deletedAt));
+}
+
+// src/hq/protocol/peer.ts
+var HQ_PEER_REHYDRATE_REASONS = /* @__PURE__ */ new Set([
+  "graceful",
+  "crash",
+  "heartbeat-timeout",
+  "auth-revoked"
+]);
+var HQ_PEER_REHYDRATE_HINT_MAX_CHARS = 280;
+var HQ_BROWSER_PEER_RESUME_CLIENT_ID = "__hq_peer__";
+function isStringOrUndefined(x) {
+  return x === void 0 || typeof x === "string";
+}
+function isHqPeerRehydratePayload(x) {
+  if (typeof x !== "object" || x === null || Array.isArray(x)) return false;
+  const v = x;
+  if (typeof v.projectId !== "string" || v.projectId.length === 0) return false;
+  if (typeof v.machineId !== "string" || v.machineId.length === 0) return false;
+  if (typeof v.leaderClientId !== "string" || v.leaderClientId.length === 0) return false;
+  if (typeof v.previousLeaderHandle !== "string" || v.previousLeaderHandle.length === 0) return false;
+  if (typeof v.reason !== "string" || !HQ_PEER_REHYDRATE_REASONS.has(v.reason)) return false;
+  if (typeof v.detectedAt !== "string" || !Number.isFinite(Date.parse(v.detectedAt))) return false;
+  if (!isStringOrUndefined(v.rehydrateHint)) return false;
+  if (v.rehydrateHint !== void 0 && v.rehydrateHint.length > HQ_PEER_REHYDRATE_HINT_MAX_CHARS) return false;
+  if (!isStringOrUndefined(v.rehydrateCommandId)) return false;
+  return true;
+}
+function isHqPeerLostPayload(x) {
+  if (typeof x !== "object" || x === null || Array.isArray(x)) return false;
+  const v = x;
+  if (typeof v.projectId !== "string" || v.projectId.length === 0) return false;
+  if (typeof v.machineId !== "string" || v.machineId.length === 0) return false;
+  if (typeof v.leaderClientId !== "string" || v.leaderClientId.length === 0) return false;
+  if (typeof v.previousLeaderHandle !== "string" || v.previousLeaderHandle.length === 0) return false;
+  if (typeof v.reason !== "string" || !HQ_PEER_REHYDRATE_REASONS.has(v.reason)) return false;
+  if (typeof v.detectedAt !== "string" || !Number.isFinite(Date.parse(v.detectedAt))) return false;
+  return true;
+}
+
+// src/hq/protocol/envelope.ts
+var HQ_PROTOCOL_VERSION = 1;
+
+// src/hq/protocol/core.ts
+var KNOWN_HQ_CLIENT_FRAME_TYPES = /* @__PURE__ */ new Set([
+  "client.hello",
+  "client.event",
+  "client.command_poll",
+  "client.command_ack",
+  "client.resume"
+]);
+var HQ_CLIENT_KINDS = /* @__PURE__ */ new Set([
+  "tui",
+  "repl",
+  "webui",
+  "cli",
+  "mailbox",
+  "unknown"
+]);
+var HQ_WORKSPACE_KINDS = /* @__PURE__ */ new Set(["git", "directory", "unknown"]);
+var HQ_CLIENT_CAPABILITIES = /* @__PURE__ */ new Set([
+  "telemetry.publish",
+  "session.summary",
+  "fleet.summary",
+  "mailbox.summary",
+  "mailbox.serve",
+  "control.receive"
+]);
+var HQ_COMMAND_ACK_STATUSES = /* @__PURE__ */ new Set([
+  "accepted",
+  "completed",
+  "failed",
+  "rejected"
+]);
+function hasStringType(x) {
+  return typeof x === "object" && x !== null && typeof x.type === "string";
+}
+function isHqClientIdentity(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.clientId === "string" && typeof v.kind === "string" && HQ_CLIENT_KINDS.has(v.kind) && typeof v.machineId === "string" && typeof v.startedAt === "string";
+}
+function isHqProjectIdentity(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.projectId === "string" && typeof v.projectRoot === "string" && typeof v.projectName === "string" && typeof v.machineId === "string" && typeof v.workspaceKind === "string" && HQ_WORKSPACE_KINDS.has(v.workspaceKind);
+}
+function isHqRedactionPolicy(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.rawContent === "boolean" && (v.toolArgs === "none" || v.toolArgs === "summary" || v.toolArgs === "redacted" || v.toolArgs === "full") && (v.paths === "none" || v.paths === "project-relative" || v.paths === "redacted" || v.paths === "full");
+}
+function isHqClientHelloPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.protocolVersion === "number" && isHqClientIdentity(v.client) && isHqProjectIdentity(v.project) && Array.isArray(v.capabilities) && v.capabilities.every(
+    (capability) => typeof capability === "string" && HQ_CLIENT_CAPABILITIES.has(capability)
+  ) && (v.redactionPolicy === void 0 || isHqRedactionPolicy(v.redactionPolicy));
+}
+function isHqEventEnvelope(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.id === "string" && typeof v.type === "string" && v.schemaVersion === HQ_PROTOCOL_VERSION && typeof v.timestamp === "string" && typeof v.clientId === "string" && typeof v.projectId === "string" && Number.isSafeInteger(v.seq) && v.seq >= 0 && Object.hasOwn(v, "payload");
+}
+function isHqClientCommandPollMessage(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.clientId === "string" && typeof v.projectId === "string" && (v.afterCommandId === void 0 || typeof v.afterCommandId === "string") && (v.limit === void 0 || Number.isSafeInteger(v.limit) && v.limit > 0 && v.limit <= 200);
+}
+function isHqClientCommandAckMessage(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.clientId === "string" && typeof v.projectId === "string" && typeof v.commandId === "string" && typeof v.status === "string" && HQ_COMMAND_ACK_STATUSES.has(v.status) && (v.message === void 0 || typeof v.message === "string");
+}
+function isHqClientResumeMessage(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.type === "string" && v.type === "client.resume" && Number.isSafeInteger(v.lastSeqSeen) && v.lastSeqSeen >= 0 && (v.clientId === void 0 || typeof v.clientId === "string") && (v.projectId === void 0 || typeof v.projectId === "string");
+}
+function parseHqFrame(raw) {
+  let parsed;
+  try {
+    parsed = JSON.parse(typeof raw === "string" ? raw : raw.toString("utf8"));
+  } catch {
+    return { ok: false, reason: "invalid-json" };
+  }
+  if (!hasStringType(parsed)) {
+    return { ok: false, reason: "malformed" };
+  }
+  const obj = parsed;
+  if (!KNOWN_HQ_CLIENT_FRAME_TYPES.has(obj.type)) {
+    return { ok: false, reason: "unknown-type" };
+  }
+  switch (obj.type) {
+    case "client.hello":
+      if (!isHqClientHelloPayload(obj.payload)) {
+        return { ok: false, reason: "malformed" };
+      }
+      return { ok: true, frame: { type: "client.hello", payload: obj.payload } };
+    case "client.event":
+      if (!isHqEventEnvelope(obj.event)) {
+        return { ok: false, reason: "malformed" };
+      }
+      return { ok: true, frame: { type: "client.event", event: obj.event } };
+    case "client.command_poll":
+      if (!isHqClientCommandPollMessage(obj)) {
+        return { ok: false, reason: "malformed" };
+      }
+      return {
+        ok: true,
+        frame: {
+          type: "client.command_poll",
+          clientId: obj.clientId,
+          projectId: obj.projectId,
+          ...typeof obj.afterCommandId === "string" ? { afterCommandId: obj.afterCommandId } : {},
+          ...typeof obj.limit === "number" ? { limit: obj.limit } : {}
+        }
+      };
+    case "client.command_ack":
+      if (!isHqClientCommandAckMessage(obj)) {
+        return { ok: false, reason: "malformed" };
+      }
+      return {
+        ok: true,
+        frame: {
+          type: "client.command_ack",
+          clientId: obj.clientId,
+          projectId: obj.projectId,
+          commandId: obj.commandId,
+          status: obj.status,
+          ...typeof obj.message === "string" ? { message: obj.message } : {}
+        }
+      };
+    case "client.resume":
+      if (!isHqClientResumeMessage(obj)) {
+        return { ok: false, reason: "malformed" };
+      }
+      return {
+        ok: true,
+        frame: {
+          type: "client.resume",
+          lastSeqSeen: obj.lastSeqSeen,
+          ...typeof obj.clientId === "string" ? { clientId: obj.clientId } : {},
+          ...typeof obj.projectId === "string" ? { projectId: obj.projectId } : {}
+        }
+      };
+    default: {
+      const _exhaustive = obj.type;
+      return _exhaustive;
+    }
+  }
+}
+var KNOWN_HQ_EVENT_PAYLOAD_TYPES = /* @__PURE__ */ new Set([
+  "mailbox.snapshot",
+  "mailbox.event",
+  "kanban.snapshot",
+  "session.snapshot",
+  "session.transcript",
+  "session.ended",
+  "fleet.snapshot",
+  "fleet.event",
+  "brain.event",
+  "worktree.event",
+  "tool.started",
+  "tool.completed",
+  "session.usage",
+  "client.heartbeat",
+  "mcp.health.snapshot",
+  "mcp.operation",
+  "governance.snapshot",
+  "peer.rehydrate",
+  "peer.lost"
+]);
+function isHqMcpLatencySummary(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.count === "number" && (v.lastMs === void 0 || typeof v.lastMs === "number") && (v.minMs === void 0 || typeof v.minMs === "number") && (v.maxMs === void 0 || typeof v.maxMs === "number") && (v.p50Ms === void 0 || typeof v.p50Ms === "number") && (v.p95Ms === void 0 || typeof v.p95Ms === "number");
+}
+function isHqMcpFailureCounts(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.transport === "number" && typeof v.protocol === "number" && typeof v.tool === "number";
+}
+function isHqMcpHealthCheck(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.name === "string" && typeof v.passed === "boolean" && (v.value === void 0 || typeof v.value === "number") && (v.threshold === void 0 || typeof v.threshold === "number");
+}
+var HQ_MCP_HEALTH_STATES = /* @__PURE__ */ new Set([
+  "disabled",
+  "dormant",
+  "connecting",
+  "healthy",
+  "degraded",
+  "failed"
+]);
+var HQ_MCP_CONNECTION_STATES = /* @__PURE__ */ new Set([
+  "idle",
+  "dormant",
+  "connecting",
+  "connected",
+  "reconnecting",
+  "disconnected",
+  "failed"
+]);
+function isHqMcpServerHealth(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.name === "string" && typeof v.projectId === "string" && typeof v.clientId === "string" && typeof v.connectionState === "string" && HQ_MCP_CONNECTION_STATES.has(v.connectionState) && typeof v.healthState === "string" && HQ_MCP_HEALTH_STATES.has(v.healthState) && (v.lastSuccessAt === void 0 || typeof v.lastSuccessAt === "string") && (v.lastFailureAt === void 0 || typeof v.lastFailureAt === "string") && (v.lastFailureKind === void 0 || v.lastFailureKind === "transport" || v.lastFailureKind === "protocol" || v.lastFailureKind === "tool") && typeof v.consecutiveFailures === "number" && isHqMcpFailureCounts(v.failures) && typeof v.reconnectCount === "number" && typeof v.wakeCount === "number" && typeof v.sleepCount === "number" && typeof v.restartCount === "number" && isHqMcpLatencySummary(v.connectionLatency) && isHqMcpLatencySummary(v.discoveryLatency) && isHqMcpLatencySummary(v.callLatency) && typeof v.inFlightCalls === "number" && typeof v.peakInFlightCalls === "number" && Array.isArray(v.healthChecks) && v.healthChecks.every(isHqMcpHealthCheck);
+}
+function isHqMcpHealthSnapshotPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return Array.isArray(v.servers) && v.servers.every(isHqMcpServerHealth);
+}
+function isHqMcpOperationPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.operation === "object" && v.operation !== null && Array.isArray(v.servers) && v.servers.every(isHqMcpServerHealth);
+}
+function isHqMailboxMessageSummary(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.messageId === "string" && typeof v.from === "string" && typeof v.to === "string" && typeof v.subject === "string" && typeof v.priority === "string" && typeof v.timestamp === "string" && typeof v.completed === "boolean" && typeof v.hasBody === "boolean";
+}
+function isHqMailboxAgentSummary(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.agentId === "string" && typeof v.name === "string" && typeof v.sessionId === "string" && typeof v.status === "string" && typeof v.iterations === "number" && typeof v.toolCalls === "number" && typeof v.lastActivityAt === "string" && typeof v.lastSeenAt === "string" && typeof v.online === "boolean";
+}
+function isHqMailboxSnapshotPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  if (typeof v.mailboxId !== "string" || v.scope !== "project" && v.scope !== "global" || !Array.isArray(v.messages) || !Array.isArray(v.agents) || typeof v.totals !== "object" || v.totals === null) {
+    return false;
+  }
+  const totals = v.totals;
+  if (typeof totals.messages !== "number" || typeof totals.unread !== "number" || typeof totals.incomplete !== "number" || typeof totals.highPriority !== "number" || typeof totals.onlineAgents !== "number") {
+    return false;
+  }
+  for (const message of v.messages) {
+    if (!isHqMailboxMessageSummary(message)) return false;
+  }
+  for (const agent of v.agents) {
+    if (!isHqMailboxAgentSummary(agent)) return false;
+  }
+  return true;
+}
+var HQ_MAILBOX_EVENT_ACTIONS = /* @__PURE__ */ new Set([
+  "message.sent",
+  "message.read",
+  "message.completed",
+  "message.updated",
+  "agent.registered",
+  "agent.heartbeat",
+  "agent.offline",
+  "agent.deregistered"
+]);
+function isHqMailboxEventPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  if (typeof v.mailboxId !== "string") return false;
+  if (typeof v.action !== "string" || !HQ_MAILBOX_EVENT_ACTIONS.has(v.action)) return false;
+  if (v.message !== void 0 && !isHqMailboxMessageSummary(v.message)) return false;
+  if (v.agent !== void 0 && !isHqMailboxAgentSummary(v.agent)) return false;
+  return true;
+}
+var HQ_SESSION_AGENT_STATUSES = /* @__PURE__ */ new Set([
+  "idle",
+  "running",
+  "streaming",
+  "waiting_user",
+  "error"
+]);
+function isHqSessionAgentSummary(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.id === "string" && typeof v.name === "string" && typeof v.status === "string" && HQ_SESSION_AGENT_STATUSES.has(v.status) && typeof v.iterations === "number" && typeof v.toolCalls === "number" && typeof v.lastActivityAt === "string";
+}
+var HQ_SESSION_STATUSES = /* @__PURE__ */ new Set(["active", "idle", "closing", "stale"]);
+function isHqSessionSnapshotPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  if (typeof v.sessionId !== "string" || typeof v.clientKind !== "string" || typeof v.machineId !== "string" || typeof v.projectId !== "string" || typeof v.projectName !== "string" || typeof v.projectRoot !== "string" || typeof v.status !== "string" || !HQ_SESSION_STATUSES.has(v.status) || typeof v.startedAt !== "string" || typeof v.lastActivityAt !== "string" || typeof v.agentCount !== "number" || !Array.isArray(v.agents)) {
+    return false;
+  }
+  for (const agent of v.agents) {
+    if (!isHqSessionAgentSummary(agent)) return false;
+  }
+  return true;
+}
+var HQ_TRANSCRIPT_ROLES = /* @__PURE__ */ new Set([
+  "user",
+  "assistant",
+  "thinking",
+  "tool",
+  "system",
+  "error"
+]);
+function isHqTranscriptEntry(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.ts === "string" && typeof v.role === "string" && HQ_TRANSCRIPT_ROLES.has(v.role) && typeof v.text === "string";
+}
+function isHqTranscriptAppendPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  if (typeof v.sessionId !== "string" || typeof v.fromSeq !== "number" || !Array.isArray(v.entries)) {
+    return false;
+  }
+  for (const entry of v.entries) {
+    if (!isHqTranscriptEntry(entry)) return false;
+  }
+  return true;
+}
+function isHqSessionEndedPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.sessionId === "string" && typeof v.endedAt === "string";
+}
+var HQ_FLEET_SUBAGENT_STATUS = /* @__PURE__ */ new Set([
+  "pending",
+  "running",
+  "idle",
+  "completed",
+  "failed",
+  "stopped"
+]);
+function isHqSubagentSummary(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.subagentId === "string" && typeof v.status === "string" && HQ_FLEET_SUBAGENT_STATUS.has(v.status);
+}
+function isHqFleetSnapshotPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  if (typeof v.runId !== "string" || typeof v.activeSubagents !== "number" || typeof v.queuedTasks !== "number" || typeof v.completedTasks !== "number" || typeof v.failedTasks !== "number" || !Array.isArray(v.subagents)) {
+    return false;
+  }
+  for (const s of v.subagents) {
+    if (!isHqSubagentSummary(s)) return false;
+  }
+  return true;
+}
+function isHqFleetEventPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.runId === "string" && typeof v.event === "string";
+}
+var HQ_BRAIN_EVENT_KINDS = /* @__PURE__ */ new Set([
+  "decision_requested",
+  "decision_answered",
+  "decision_ask_human",
+  "human_answered",
+  "decision_denied",
+  "intervention"
+]);
+function isHqBrainEventPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  if (typeof v.kind !== "string" || !HQ_BRAIN_EVENT_KINDS.has(v.kind)) return false;
+  if (typeof v.at !== "number") return false;
+  return true;
+}
+var HQ_WORKTREE_EVENT_KINDS = /* @__PURE__ */ new Set([
+  "allocated",
+  "committed",
+  "merged",
+  "conflict",
+  "released",
+  "failed"
+]);
+function isHqWorktreeEventPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  if (typeof v.kind !== "string" || !HQ_WORKTREE_EVENT_KINDS.has(v.kind)) return false;
+  if (typeof v.handleId !== "string" || typeof v.ownerId !== "string") return false;
+  return true;
+}
+function isHqToolStartedPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.toolName === "string";
+}
+function isHqToolCompletedPayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const v = x;
+  return typeof v.toolName === "string" && typeof v.status === "string" && typeof v.durationMs === "number";
+}
+function isHqUsagePayload(x) {
+  if (typeof x !== "object" || x === null) return false;
+  return !Array.isArray(x);
+}
+function isHqClientHeartbeatPayload(x) {
+  if (typeof x !== "object" || x === null || Array.isArray(x)) return false;
+  const v = x;
+  return typeof v.uptimeMs === "number" && (v.activeSessionId === void 0 || typeof v.activeSessionId === "string") && (v.activeRunId === void 0 || typeof v.activeRunId === "string") && typeof v.status === "string" && (v.status === "active" || v.status === "idle" || v.status === "stale" || v.status === "error") && (v.activeSubagents === void 0 || typeof v.activeSubagents === "number") && (v.queuedTasks === void 0 || typeof v.queuedTasks === "number");
+}
+function parseHqEventPayload(eventType, payload) {
+  if (!KNOWN_HQ_EVENT_PAYLOAD_TYPES.has(eventType)) {
+    return { ok: true, payload };
+  }
+  switch (eventType) {
+    case "mailbox.snapshot":
+      return isHqMailboxSnapshotPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "mailbox.event":
+      return isHqMailboxEventPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "kanban.snapshot":
+      return isHqKanbanSnapshotPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "session.snapshot":
+      return isHqSessionSnapshotPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "session.transcript":
+      return isHqTranscriptAppendPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "session.ended":
+      return isHqSessionEndedPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "fleet.snapshot":
+      return isHqFleetSnapshotPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "fleet.event":
+      return isHqFleetEventPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "brain.event":
+      return isHqBrainEventPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "worktree.event":
+      return isHqWorktreeEventPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "tool.started":
+      return isHqToolStartedPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "tool.completed":
+      return isHqToolCompletedPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "session.usage":
+      return isHqUsagePayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "client.heartbeat":
+      return isHqClientHeartbeatPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "mcp.health.snapshot":
+      return isHqMcpHealthSnapshotPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "mcp.operation":
+      return isHqMcpOperationPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "governance.snapshot":
+      return isHqGovernanceSnapshotPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "peer.rehydrate":
+      return isHqPeerRehydratePayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    case "peer.lost":
+      return isHqPeerLostPayload(payload) ? { ok: true, payload } : { ok: false, reason: "malformed-payload" };
+    default: {
+      const _exhaustive = eventType;
+      return _exhaustive;
+    }
+  }
+}
+function createHqEventEnvelope(input) {
+  return {
+    id: input.id,
+    type: input.type,
+    schemaVersion: HQ_PROTOCOL_VERSION,
+    timestamp: input.timestamp,
+    clientId: input.clientId,
+    projectId: input.projectId,
+    seq: input.seq,
+    payload: input.payload,
+    ...input.sessionId !== void 0 ? { sessionId: input.sessionId } : {},
+    ...input.runId !== void 0 ? { runId: input.runId } : {}
+  };
+}
+
+// src/hq/protocol/resume.ts
+var HQ_RESUME_GAP_MAX_ENVELOPES = 1e3;
+var HQ_RESUME_GAP_MAX_BYTES = 1048576;
+var HQ_RESUME_GAP_MAX_STALE_MS = 24 * 60 * 60 * 1e3;
+function isHqResumeGapMessage(x) {
+  if (typeof x !== "object" || x === null || Array.isArray(x)) return false;
+  const v = x;
+  if (v.type !== "hq.resume_gap") return false;
+  if (!Number.isSafeInteger(v.lastSeqSeen) || v.lastSeqSeen < 0) return false;
+  if (!Array.isArray(v.envelopes)) return false;
+  if (v.envelopes.length > HQ_RESUME_GAP_MAX_ENVELOPES) return false;
+  if (typeof v.truncated !== "boolean") return false;
+  return true;
+}
+function isHqResumeRejectMessage(x) {
+  if (typeof x !== "object" || x === null || Array.isArray(x)) return false;
+  const v = x;
+  if (v.type !== "hq.resume_reject") return false;
+  if (v.reason !== "gap_too_large" && v.reason !== "last_seen_too_old" && v.reason !== "log_unavailable") {
+    return false;
+  }
+  if (typeof v.detectedAt !== "string" || !Number.isFinite(Date.parse(v.detectedAt))) return false;
+  return true;
+}
+
+// src/hq/protocol/tool.ts
+var DEFAULT_HQ_REDACTION_POLICY = {
+  rawContent: true,
+  toolArgs: "full",
+  paths: "full"
+};
+var HQ_TRANSCRIPT_TEXT_CAP = 16e3;
+export {
+  DEFAULT_HQ_REDACTION_POLICY,
+  HQ_BROWSER_PEER_RESUME_CLIENT_ID,
+  HQ_PEER_REHYDRATE_HINT_MAX_CHARS,
+  HQ_PEER_REHYDRATE_REASONS,
+  HQ_PROTOCOL_VERSION,
+  HQ_RESUME_GAP_MAX_BYTES,
+  HQ_RESUME_GAP_MAX_ENVELOPES,
+  HQ_RESUME_GAP_MAX_STALE_MS,
+  HQ_TRANSCRIPT_TEXT_CAP,
+  createHqEventEnvelope,
+  isHqGovernanceSnapshotPayload,
+  isHqKanbanSnapshotPayload,
+  isHqPeerLostPayload,
+  isHqPeerRehydratePayload,
+  isHqResumeGapMessage,
+  isHqResumeRejectMessage,
+  parseHqEventPayload,
+  parseHqFrame
+};
+//# sourceMappingURL=protocol.js.map