@hua-labs/tap 0.5.1 → 0.6.0

package/dist/codex-a2a/index.d.mts

@@ -0,0 +1,2 @@
+export { B as BuildCodexBindingRegistryOptions, C as CodexA2AAdapterKind, a as CodexA2ADeliveryRequest, b as CodexA2ADeliveryResult, c as CodexA2AFailureReason, d as CodexA2AMessageEnvelope, e as CodexA2ATargetTuple, f as CodexBinding, g as CodexBindingAddress, h as CodexBindingBlockReason, i as CodexBindingHeartbeat, j as CodexBindingRegistry, E as CodexBindingRuntimeHealth, F as CodexBindingRuntimeHealthStatus, k as CodexBindingSource, l as CodexBindingStatus, m as ConsentDriveReceipt, n as ConsentDriveResponse, o as ConsentDriveTransport, p as ConsentDriveTransportFactory, R as RemoteCodexRelayConfig, q as RemoteCodexRelayExecutor, r as RemoteCodexRelayInput, s as RemoteCodexRelayResult, t as ResolveCodexBindingOptions, u as ResolveCodexBindingResult, v as ResolveCodexBindingTarget, w as buildCodexBindingRegistry, D as resolveCodexBinding } from '../index-D4Khz2Mh.mjs';
+import '../types-FWvKrFUt.mjs';

package/dist/codex-a2a/index.mjs

@@ -0,0 +1,416 @@
+// src/routing/receive-transports.ts
+import { basename } from "path";
+var VALID_RECEIVE_TRANSPORTS = [
+  "mcp-channel",
+  "consent-drive",
+  "polling"
+];
+function normalizeString(value) {
+  const normalized = value?.trim();
+  return normalized ? normalized : null;
+}
+function normalizeReceiveTransports(values) {
+  const transports = [];
+  for (const value of values ?? []) {
+    if (!VALID_RECEIVE_TRANSPORTS.includes(value)) {
+      continue;
+    }
+    const transport = value;
+    if (transports.includes(transport)) {
+      continue;
+    }
+    transports.push(transport);
+  }
+  return transports;
+}
+function canUseConsentDriveForAddress(options) {
+  const address = options.address;
+  if (!address?.conversationId?.trim() || !address.ownerClientId?.trim()) {
+    return false;
+  }
+  const localHostId = normalizeString(options.localHostId);
+  const targetHostId = normalizeString(address.hostId);
+  if (!localHostId || !targetHostId) {
+    return true;
+  }
+  return localHostId.toLowerCase() === targetHostId.toLowerCase();
+}
+
+// src/codex-a2a/binding-registry.ts
+var DEFAULT_STALE_AFTER_MS = 30 * 60 * 1e3;
+var HEALTH_SEVERITY = {
+  "stuck-turn": 90,
+  "stale-owner": 80,
+  "stale-active-turn": 75,
+  "active-turn": 70,
+  partial: 60,
+  "adapter-unavailable": 50,
+  degraded: 40,
+  "not-observed": 30,
+  unknown: 20,
+  ready: 10
+};
+var HEALTH_STATUSES = new Set(
+  Object.keys(HEALTH_SEVERITY)
+);
+function normalizeString2(value) {
+  const normalized = value?.trim();
+  return normalized ? normalized : null;
+}
+function normalizeToken(value) {
+  return normalizeString2(value)?.replace(/-/g, "_").toLowerCase() ?? null;
+}
+function isCodexLike(value) {
+  const token = normalizeToken(value);
+  return token === "codex" || Boolean(token?.startsWith("codex_"));
+}
+function toTime(value) {
+  if (value instanceof Date) return value.getTime();
+  if (typeof value === "number") return value;
+  if (typeof value === "string") {
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : Date.now();
+  }
+  return Date.now();
+}
+function normalizeAliases(values) {
+  const aliases = [];
+  for (const value of values) {
+    const normalized = normalizeString2(value);
+    if (!normalized || aliases.includes(normalized)) continue;
+    aliases.push(normalized);
+  }
+  return aliases;
+}
+function metadataString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function normalizeRuntimeHealth(value) {
+  if (!value || typeof value !== "object") return null;
+  const status = typeof value.status === "string" && HEALTH_STATUSES.has(value.status) ? value.status : null;
+  if (!status) return null;
+  return {
+    status,
+    reason: normalizeString2(value.reason),
+    checkedAt: normalizeString2(value.checkedAt),
+    adapter: normalizeString2(value.adapter),
+    recovery: normalizeString2(value.recovery)
+  };
+}
+function runtimeHealthTime(value) {
+  const parsed = Date.parse(value.checkedAt ?? "");
+  return Number.isFinite(parsed) ? parsed : 0;
+}
+function mergeRuntimeHealth(existing, next) {
+  if (!existing) return next;
+  if (!next) return existing;
+  const severityDelta = HEALTH_SEVERITY[next.status] - HEALTH_SEVERITY[existing.status];
+  if (severityDelta > 0) return next;
+  if (severityDelta < 0) return existing;
+  const existingTime = runtimeHealthTime(existing);
+  const nextTime = runtimeHealthTime(next);
+  if (nextTime > existingTime) return next;
+  return existing;
+}
+function deriveStaleReason(options) {
+  const status = normalizeString2(options.status);
+  if (status && status !== "active") {
+    return `status:${status}`;
+  }
+  if (!options.lastSeenAt) {
+    return "missing-last-seen";
+  }
+  const lastSeenMs = Date.parse(options.lastSeenAt);
+  if (!Number.isFinite(lastSeenMs)) {
+    return "invalid-last-seen";
+  }
+  const ageMs = options.nowMs - lastSeenMs;
+  if (ageMs > options.staleAfterMs) {
+    return `stale:${ageMs}ms`;
+  }
+  return null;
+}
+function bindingKey(binding) {
+  return [
+    binding.routingAddress,
+    binding.hostId ?? "",
+    binding.clientId ?? "",
+    binding.conversationId ?? "",
+    binding.ownerClientId ?? ""
+  ].join("\0");
+}
+function mergeBinding(existing, next) {
+  const nextIsLiveObserve = next.sources.includes("observe") && next.staleReason === null;
+  return {
+    ...existing,
+    agentName: existing.agentName ?? next.agentName,
+    hostId: existing.hostId ?? next.hostId,
+    clientId: existing.clientId ?? next.clientId,
+    conversationId: existing.conversationId ?? next.conversationId,
+    ownerClientId: existing.ownerClientId ?? next.ownerClientId,
+    instanceId: existing.instanceId ?? next.instanceId,
+    receiveTransports: normalizeReceiveTransports([
+      ...existing.receiveTransports,
+      ...next.receiveTransports
+    ]),
+    bindingStatus: existing.bindingStatus === "ready" || next.bindingStatus === "ready" ? "ready" : existing.bindingStatus === "partial" || next.bindingStatus === "partial" ? "partial" : "stale",
+    lastSeenAt: nextIsLiveObserve ? next.lastSeenAt ?? existing.lastSeenAt : existing.lastSeenAt ?? next.lastSeenAt,
+    staleReason: nextIsLiveObserve ? null : existing.staleReason ?? next.staleReason,
+    health: mergeRuntimeHealth(existing.health, next.health),
+    sources: [.../* @__PURE__ */ new Set([...existing.sources, ...next.sources])],
+    aliases: normalizeAliases([...existing.aliases, ...next.aliases])
+  };
+}
+function shouldIncludeHeartbeatBinding(heartbeat, receiveTransports) {
+  return receiveTransports.includes("consent-drive") || isCodexLike(heartbeat.instanceId) || isCodexLike(heartbeat.address?.clientId) || isCodexLike(heartbeat.address?.routingAddress) || isCodexLike(heartbeat.source);
+}
+function buildHeartbeatBinding(key, heartbeat, nowMs, staleAfterMs) {
+  const receiveTransports = normalizeReceiveTransports([
+    ...heartbeat.receiveTransports ?? [],
+    ...heartbeat.capabilities?.receiveTransports ?? []
+  ]);
+  if (!shouldIncludeHeartbeatBinding(heartbeat, receiveTransports)) {
+    return null;
+  }
+  const id = normalizeString2(heartbeat.id) ?? key;
+  const routingAddress = normalizeString2(heartbeat.address?.routingAddress) ?? normalizeString2(heartbeat.instanceId) ?? id;
+  const lastSeenAt = normalizeString2(heartbeat.lastActivity) ?? normalizeString2(heartbeat.timestamp);
+  const conversationId = normalizeString2(heartbeat.capabilities?.conversationId) ?? normalizeString2(heartbeat.address?.conversationId);
+  const ownerClientId = normalizeString2(heartbeat.capabilities?.ownerClientId) ?? normalizeString2(heartbeat.address?.ownerClientId);
+  const bindingStatus = deriveBindingStatus({
+    conversationId,
+    ownerClientId,
+    staleReason: deriveStaleReason({
+      status: heartbeat.status,
+      lastSeenAt,
+      nowMs,
+      staleAfterMs
+    })
+  });
+  return {
+    agentName: normalizeString2(heartbeat.agent),
+    routingAddress,
+    runtime: "codex",
+    hostId: normalizeString2(heartbeat.address?.hostId),
+    clientId: normalizeString2(heartbeat.address?.clientId) ?? normalizeString2(heartbeat.instanceId),
+    conversationId,
+    ownerClientId,
+    instanceId: normalizeString2(heartbeat.instanceId),
+    receiveTransports,
+    lastSeenAt,
+    staleReason: bindingStatus === "stale" ? deriveStaleReason({
+      status: heartbeat.status,
+      lastSeenAt,
+      nowMs,
+      staleAfterMs
+    }) : null,
+    health: normalizeRuntimeHealth(heartbeat.health),
+    bindingStatus,
+    sources: ["heartbeat"],
+    aliases: normalizeAliases([
+      id,
+      heartbeat.agent,
+      routingAddress,
+      heartbeat.instanceId,
+      ...heartbeat.address?.aliases ?? []
+    ])
+  };
+}
+function findAgentNameForClient(snapshot, clientId) {
+  if (!clientId) return null;
+  const agent = snapshot.agents.find((candidate) => candidate.id === clientId);
+  return agent?.name ?? null;
+}
+function buildObserveBindings(snapshot, nowIso) {
+  if (!snapshot.connected) {
+    return [];
+  }
+  const bindings = [];
+  for (const conversation of snapshot.conversations) {
+    const ownerClientId = normalizeString2(conversation.address.ownerClientId);
+    const conversationId = normalizeString2(conversation.id);
+    if (!ownerClientId || !conversationId) continue;
+    const metadata = conversation.metadata;
+    const lastSeenAt = metadataString(metadata.lastActivity) ?? nowIso;
+    const routingAddress = normalizeString2(conversation.address.clientId) ?? ownerClientId;
+    bindings.push({
+      agentName: findAgentNameForClient(snapshot, ownerClientId),
+      routingAddress,
+      runtime: "codex",
+      hostId: normalizeString2(conversation.address.hostId),
+      clientId: normalizeString2(conversation.address.clientId) ?? ownerClientId,
+      conversationId,
+      ownerClientId,
+      instanceId: null,
+      receiveTransports: ["consent-drive"],
+      bindingStatus: "ready",
+      lastSeenAt,
+      staleReason: null,
+      health: null,
+      sources: ["observe"],
+      aliases: normalizeAliases([routingAddress, ownerClientId])
+    });
+  }
+  return bindings;
+}
+function buildCodexBindingRegistry(options = {}) {
+  const nowMs = toTime(options.now);
+  const nowIso = new Date(nowMs).toISOString();
+  const staleAfterMs = options.staleAfterMs ?? DEFAULT_STALE_AFTER_MS;
+  const byKey = /* @__PURE__ */ new Map();
+  for (const [key, heartbeat] of Object.entries(options.heartbeats ?? {})) {
+    const binding = buildHeartbeatBinding(key, heartbeat, nowMs, staleAfterMs);
+    if (!binding) continue;
+    const existing = byKey.get(bindingKey(binding));
+    byKey.set(
+      bindingKey(binding),
+      existing ? mergeBinding(existing, binding) : binding
+    );
+  }
+  if (options.observeSnapshot) {
+    for (const binding of buildObserveBindings(
+      options.observeSnapshot,
+      nowIso
+    )) {
+      const existing = byKey.get(bindingKey(binding));
+      byKey.set(
+        bindingKey(binding),
+        existing ? mergeBinding(existing, binding) : binding
+      );
+    }
+  }
+  return {
+    bindings: [...byKey.values()].sort(
+      (a, b) => a.routingAddress.localeCompare(b.routingAddress)
+    ),
+    builtAt: nowIso,
+    staleAfterMs
+  };
+}
+function deriveBindingStatus(options) {
+  if (options.staleReason) return "stale";
+  if (options.conversationId && options.ownerClientId) return "ready";
+  if (options.conversationId || options.ownerClientId) return "partial";
+  return "partial";
+}
+function matchesTarget(binding, target) {
+  const requestedAddress = normalizeString2(target.routingAddress);
+  const requestedAgent = normalizeString2(target.agentName);
+  if (requestedAddress && binding.routingAddress !== requestedAddress && !binding.aliases.includes(requestedAddress)) {
+    return false;
+  }
+  if (requestedAgent && binding.agentName !== requestedAgent && !binding.aliases.includes(requestedAgent)) {
+    return false;
+  }
+  const constraints = [
+    [target.hostId, binding.hostId],
+    [target.clientId, binding.clientId],
+    [target.conversationId, binding.conversationId],
+    [target.ownerClientId, binding.ownerClientId]
+  ];
+  return constraints.every(([requested, actual]) => {
+    const normalizedRequested = normalizeString2(requested);
+    return !normalizedRequested || normalizedRequested === actual;
+  });
+}
+function hasExplicitTargetSelector(target) {
+  return Boolean(
+    normalizeString2(target.routingAddress) || normalizeString2(target.agentName) || normalizeString2(target.clientId) || normalizeString2(target.conversationId) || normalizeString2(target.ownerClientId)
+  );
+}
+function liveSnapshotMatches(binding, snapshot) {
+  if (!snapshot || !binding.conversationId || !binding.ownerClientId) {
+    return true;
+  }
+  if (!snapshot.connected) {
+    return false;
+  }
+  return snapshot.conversations.some((conversation) => {
+    const address = conversation.address;
+    return conversation.id === binding.conversationId && address.ownerClientId === binding.ownerClientId && (!binding.hostId || !address.hostId || address.hostId === binding.hostId);
+  });
+}
+function toAddress(binding) {
+  return {
+    hostId: binding.hostId,
+    clientId: binding.clientId,
+    conversationId: binding.conversationId,
+    ownerClientId: binding.ownerClientId
+  };
+}
+function blocked(reason, candidates, message) {
+  return {
+    status: "blocked",
+    reason,
+    candidates,
+    message
+  };
+}
+function resolveCodexBinding(options) {
+  if (!hasExplicitTargetSelector(options.target)) {
+    return blocked(
+      "missing-target",
+      [],
+      "Codex binding resolution requires an explicit target selector."
+    );
+  }
+  const candidates = options.registry.bindings.filter(
+    (binding) => matchesTarget(binding, options.target)
+  );
+  if (candidates.length === 0) {
+    return blocked("not-found", [], "No Codex binding matched the target.");
+  }
+  const freshCandidates = candidates.filter((binding) => !binding.staleReason);
+  if (freshCandidates.length === 0) {
+    return blocked("stale", candidates, "Only stale Codex bindings matched.");
+  }
+  const readyCandidates = freshCandidates.filter(
+    (binding) => binding.bindingStatus === "ready"
+  );
+  if (readyCandidates.length === 0) {
+    return blocked(
+      "partial",
+      freshCandidates,
+      "Only partial Codex bindings matched; conversationId and ownerClientId are both required."
+    );
+  }
+  const liveCandidates = readyCandidates.filter(
+    (binding) => liveSnapshotMatches(binding, options.liveSnapshot)
+  );
+  if (liveCandidates.length === 0) {
+    return blocked(
+      "binding-mismatch",
+      freshCandidates,
+      "Matched Codex bindings were not present in the live observe snapshot."
+    );
+  }
+  const reachableCandidates = liveCandidates.filter(
+    (binding) => canUseConsentDriveForAddress({
+      localHostId: options.localHostId,
+      address: toAddress(binding)
+    })
+  );
+  if (reachableCandidates.length === 0) {
+    return blocked(
+      "not-reachable",
+      liveCandidates,
+      "Matched Codex bindings are not reachable from the local host."
+    );
+  }
+  if (reachableCandidates.length > 1) {
+    return blocked(
+      "ambiguous",
+      reachableCandidates,
+      "Multiple fresh Codex bindings matched the target."
+    );
+  }
+  return {
+    status: "resolved",
+    binding: reachableCandidates[0]
+  };
+}
+export {
+  buildCodexBindingRegistry,
+  resolveCodexBinding
+};
+//# sourceMappingURL=index.mjs.map

package/dist/codex-a2a/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/routing/receive-transports.ts","../../src/codex-a2a/binding-registry.ts"],"mappings":"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","names":["normalizeString"]}

package/dist/codex-health/index.d.mts

@@ -0,0 +1,76 @@
+declare const DEFAULT_STUCK_TURN_SECONDS = 120;
+declare const DEFAULT_STALE_ACTIVE_TURN_SECONDS: number;
+type CodexRuntimeHealthStatus = "ready" | "partial" | "stale-owner" | "active-turn" | "stale-active-turn" | "stuck-turn" | "degraded" | "not-observed" | "adapter-unavailable" | "unknown";
+interface CodexRuntimeHealth {
+    status: CodexRuntimeHealthStatus;
+    reason: string | null;
+    checkedAt: string;
+    adapter: string;
+    recovery: string | null;
+}
+interface CodexRuntimeTurnEvidence {
+    turnId?: string | null;
+    status?: string | null;
+    turnStartedAgeSeconds?: number | null;
+    durationMs?: number | null;
+    finalAssistantStartedAtMs?: number | null;
+    hasError?: boolean | null;
+    itemCount?: number | null;
+}
+interface CodexRuntimeConversationEvidence {
+    conversationId?: string | null;
+    hostId?: string | null;
+    ownerClientId?: string | null;
+    lastChangeType?: string | null;
+    lastTurn?: CodexRuntimeTurnEvidence | null;
+    lastSeenAt?: string | null;
+}
+interface CodexRuntimeBindingEvidence {
+    source?: string | null;
+    filePath?: string | null;
+    id?: string | null;
+    agent?: string | null;
+    routingAddress?: string | null;
+    aliases?: string[];
+    timestamp?: string | null;
+    ageSeconds?: number | null;
+    receiveTransports?: string[];
+    hostId?: string | null;
+    clientId?: string | null;
+    conversationId?: string | null;
+    ownerClientId?: string | null;
+    consentDriveStatus?: string | null;
+    lifecycleStatus?: string | null;
+    runtimeHealthStatus?: string | null;
+    message?: string | null;
+}
+interface CodexRuntimeIpcEvidence {
+    supported?: boolean | null;
+    connected?: boolean | null;
+    initializedClientId?: string | null;
+    conversations?: CodexRuntimeConversationEvidence[];
+    agents?: unknown[];
+    error?: string | null;
+}
+interface CodexRuntimeHealthOptions {
+    checkedAt?: string | null;
+    adapter?: string | null;
+    stuckTurnSeconds?: number;
+    staleActiveTurnSeconds?: number;
+}
+type ClassifiedCodexRuntimeBinding = CodexRuntimeBindingEvidence & {
+    lifecycleStatus: string;
+    runtimeHealthStatus: CodexRuntimeHealthStatus;
+    message: string;
+    liveOwnerClientId: string | null;
+    liveHostId: string | null;
+    liveLastChangeType: string | null;
+    liveLastSeenAt: string | null;
+    health: CodexRuntimeHealth;
+};
+declare function isStuckInProgressConversation(conversation: CodexRuntimeConversationEvidence | null | undefined, options?: Pick<CodexRuntimeHealthOptions, "stuckTurnSeconds">): boolean;
+declare function isStaleActiveInProgressConversation(conversation: CodexRuntimeConversationEvidence | null | undefined, options?: Pick<CodexRuntimeHealthOptions, "staleActiveTurnSeconds">): boolean;
+declare function deriveRuntimeHealthForBinding(binding: Pick<CodexRuntimeBindingEvidence, "runtimeHealthStatus" | "lifecycleStatus" | "message">, options?: Pick<CodexRuntimeHealthOptions, "checkedAt" | "adapter">): CodexRuntimeHealth;
+declare function classifyCodexBindings(bindings: CodexRuntimeBindingEvidence[], ipc: CodexRuntimeIpcEvidence, options?: CodexRuntimeHealthOptions): ClassifiedCodexRuntimeBinding[];
+
+export { type ClassifiedCodexRuntimeBinding, type CodexRuntimeBindingEvidence, type CodexRuntimeConversationEvidence, type CodexRuntimeHealth, type CodexRuntimeHealthOptions, type CodexRuntimeHealthStatus, type CodexRuntimeIpcEvidence, type CodexRuntimeTurnEvidence, DEFAULT_STALE_ACTIVE_TURN_SECONDS, DEFAULT_STUCK_TURN_SECONDS, classifyCodexBindings, deriveRuntimeHealthForBinding, isStaleActiveInProgressConversation, isStuckInProgressConversation };

package/dist/codex-health/index.mjs

@@ -0,0 +1,153 @@
+// src/codex-health/index.ts
+var DEFAULT_STUCK_TURN_SECONDS = 120;
+var DEFAULT_STALE_ACTIVE_TURN_SECONDS = 10 * 60;
+function normalizeString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function asRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function normalizeStatus(value) {
+  return normalizeString(value) ?? "unknown";
+}
+function recoveryForStatus(status) {
+  switch (status) {
+    case "partial":
+      return "Run tap_register_capabilities with the conversationId on the target Codex session.";
+    case "stale-owner":
+      return "Run tap_register_capabilities from the target runtime with the conversationId and omit ownerClientId.";
+    case "active-turn":
+      return "Wait for the active turn to finish before retrying realtime delivery.";
+    case "stale-active-turn":
+      return "Re-observe or restart the target Codex runtime, or rerun lifecycle recovery with --interrupt-stale-active if the UI is idle.";
+    case "stuck-turn":
+      return "Run codex:windows with --conversation-id and --interrupt-stuck if the UI/model is frozen.";
+    case "not-observed":
+      return "Focus or reopen the target Codex session and rerun the lifecycle check.";
+    case "adapter-unavailable":
+      return "Run this check on a host with Codex IPC visibility, or use the matching runtime adapter.";
+    case "degraded":
+      return "Check adapter-specific diagnostics and the matching runtime runbook.";
+    case "unknown":
+      return "Runtime health evidence is incomplete; refresh the target runtime capabilities.";
+    default:
+      return null;
+  }
+}
+function toRuntimeHealthStatus(status) {
+  if (status === "unavailable") return "adapter-unavailable";
+  if (status === "ready" || status === "partial" || status === "stale-owner" || status === "active-turn" || status === "stale-active-turn" || status === "stuck-turn" || status === "degraded" || status === "not-observed" || status === "adapter-unavailable" || status === "unknown") {
+    return status;
+  }
+  return "unknown";
+}
+function isStuckInProgressConversation(conversation, options = {}) {
+  const turn = asRecord(conversation?.lastTurn);
+  const stuckTurnSeconds = typeof options.stuckTurnSeconds === "number" ? options.stuckTurnSeconds : DEFAULT_STUCK_TURN_SECONDS;
+  return turn?.status === "inProgress" && turn.itemCount === 0 && turn.durationMs === null && turn.finalAssistantStartedAtMs === null && typeof turn.turnStartedAgeSeconds === "number" && turn.turnStartedAgeSeconds >= stuckTurnSeconds;
+}
+function isStaleActiveInProgressConversation(conversation, options = {}) {
+  const turn = asRecord(conversation?.lastTurn);
+  const staleActiveTurnSeconds = typeof options.staleActiveTurnSeconds === "number" ? options.staleActiveTurnSeconds : DEFAULT_STALE_ACTIVE_TURN_SECONDS;
+  return turn?.status === "inProgress" && typeof turn.turnStartedAgeSeconds === "number" && turn.turnStartedAgeSeconds >= staleActiveTurnSeconds;
+}
+function deriveRuntimeHealthForBinding(binding, options = {}) {
+  const checkedAt = normalizeString(options.checkedAt) ?? (/* @__PURE__ */ new Date()).toISOString();
+  const adapter = normalizeString(options.adapter) ?? "codex-desktop-ipc";
+  const status = toRuntimeHealthStatus(
+    normalizeStatus(binding.runtimeHealthStatus ?? binding.lifecycleStatus)
+  );
+  return {
+    status,
+    reason: normalizeString(binding.message),
+    checkedAt,
+    adapter,
+    recovery: recoveryForStatus(status)
+  };
+}
+function classifyCodexBindings(bindings, ipc, options = {}) {
+  const checkedAt = normalizeString(options.checkedAt) ?? (/* @__PURE__ */ new Date()).toISOString();
+  const adapter = normalizeString(options.adapter) ?? "codex-desktop-ipc";
+  if (!ipc?.supported || !ipc?.connected) {
+    return bindings.map((binding) => {
+      const extensionUnknown = adapter === "codex-extension-mcp";
+      const classified = {
+        ...binding,
+        lifecycleStatus: "unavailable",
+        runtimeHealthStatus: extensionUnknown ? "unknown" : "adapter-unavailable",
+        message: extensionUnknown ? "Codex extension MCP presence is visible, but no IPC observe surface is available." : ipc?.supported ? normalizeString(ipc.error) ?? "Codex IPC observe is unavailable." : "Codex IPC observe is not supported on this host.",
+        liveOwnerClientId: null,
+        liveHostId: null,
+        liveLastChangeType: null,
+        liveLastSeenAt: null
+      };
+      return {
+        ...classified,
+        health: deriveRuntimeHealthForBinding(classified, {
+          checkedAt,
+          adapter
+        })
+      };
+    });
+  }
+  const conversations = Array.isArray(ipc.conversations) ? ipc.conversations : [];
+  const byConversation = new Map(
+    conversations.map((entry) => [entry.conversationId, entry])
+  );
+  return bindings.map((binding) => {
+    const live = binding.conversationId ? byConversation.get(binding.conversationId) : null;
+    let lifecycleStatus = "unavailable";
+    let runtimeHealthStatus = "adapter-unavailable";
+    let message = "Binding does not include a conversationId.";
+    if (binding.conversationId && !binding.ownerClientId) {
+      lifecycleStatus = "partial";
+      runtimeHealthStatus = "partial";
+      message = "Binding has conversationId but no ownerClientId.";
+    } else if (binding.conversationId && binding.ownerClientId && !live) {
+      lifecycleStatus = "not-observed";
+      runtimeHealthStatus = "not-observed";
+      message = "No live IPC conversation was observed for this conversationId.";
+    } else if (binding.conversationId && binding.ownerClientId && live?.ownerClientId === binding.ownerClientId) {
+      lifecycleStatus = "ready";
+      runtimeHealthStatus = "ready";
+      message = "Stored ownerClientId matches live IPC owner.";
+      if (isStuckInProgressConversation(live, options)) {
+        runtimeHealthStatus = "stuck-turn";
+        message = "Live Codex conversation has an in-progress turn with no emitted items.";
+      } else if (isStaleActiveInProgressConversation(live, options)) {
+        runtimeHealthStatus = "stale-active-turn";
+        message = "Live Codex conversation has an old in-progress turn; the UI may be idle but IPC still reports it active.";
+      } else if (live?.lastTurn?.status === "inProgress") {
+        runtimeHealthStatus = "active-turn";
+        message = "Live Codex conversation has an active in-progress turn.";
+      }
+    } else if (binding.conversationId && binding.ownerClientId && live) {
+      lifecycleStatus = "stale-owner";
+      runtimeHealthStatus = "stale-owner";
+      message = "Stored ownerClientId differs from live IPC owner.";
+    }
+    const classified = {
+      ...binding,
+      lifecycleStatus,
+      runtimeHealthStatus,
+      message,
+      liveOwnerClientId: live?.ownerClientId ?? null,
+      liveHostId: live?.hostId ?? null,
+      liveLastChangeType: live?.lastChangeType ?? null,
+      liveLastSeenAt: live?.lastSeenAt ?? null
+    };
+    return {
+      ...classified,
+      health: deriveRuntimeHealthForBinding(classified, { checkedAt, adapter })
+    };
+  });
+}
+export {
+  DEFAULT_STALE_ACTIVE_TURN_SECONDS,
+  DEFAULT_STUCK_TURN_SECONDS,
+  classifyCodexBindings,
+  deriveRuntimeHealthForBinding,
+  isStaleActiveInProgressConversation,
+  isStuckInProgressConversation
+};
+//# sourceMappingURL=index.mjs.map

package/dist/codex-health/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/codex-health/index.ts"],"mappings":"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","names":[]}