@adhdev/mesh-shared 1.0.58-rc.6 → 1.0.58-rc.7

package/dist/index.d.ts

@@ -25,3 +25,5 @@ export * from './interpolation';
 export * from './mesh-tool-names';
 export * from './mesh-status-probe';
 export * from './rpc-chunking';
+export * from './semver-compare';
+export * from './ws-protocol';

package/dist/index.js

@@ -23,6 +23,7 @@ __export(index_exports, {
   CANONICAL_MESH_TOOL_COUNT: () => CANONICAL_MESH_TOOL_COUNT,
   CANONICAL_MESH_TOOL_NAMES: () => CANONICAL_MESH_TOOL_NAMES,
   CLI_SLOT_RECIPES: () => CLI_SLOT_RECIPES,
+  DAEMON_TO_SERVER_WS_MSGS: () => DAEMON_TO_SERVER_WS_MSGS,
   DEFAULT_DIFFICULTY_BRAINS: () => DEFAULT_DIFFICULTY_BRAINS,
   MAGI_RAW_ANSWER_CAP: () => MAGI_RAW_ANSWER_CAP,
   MESH_CHUNK_KIND: () => MESH_CHUNK_KIND,
@@ -34,12 +35,14 @@ __export(index_exports, {
   MESH_TASK_DIFFICULTIES: () => MESH_TASK_DIFFICULTIES,
   MeshChunkAssembler: () => MeshChunkAssembler,
   QUOTA_SUPPORTED_PROVIDERS: () => QUOTA_SUPPORTED_PROVIDERS,
+  SERVER_TO_DAEMON_WS_MSGS: () => SERVER_TO_DAEMON_WS_MSGS,
   STATUS_PROBE_ARG_KEY: () => STATUS_PROBE_ARG_KEY,
   UNKNOWN_CLI_SLOT_RECIPE: () => UNKNOWN_CLI_SLOT_RECIPE,
   argsCarryStatusProbeMarker: () => argsCarryStatusProbeMarker,
   buildMagiPanelProposal: () => buildMagiPanelProposal,
   buildSlotProposal: () => buildSlotProposal,
   canonicalDaemonId: () => canonicalDaemonId,
+  compareSemver: () => compareSemver,
   daemonIdsEquivalent: () => daemonIdsEquivalent,
   deriveProviderPriorityFromSlots: () => deriveProviderPriorityFromSlots,
   deriveSlotsFromLegacy: () => deriveSlotsFromLegacy,
@@ -48,9 +51,12 @@ __export(index_exports, {
   hasGitStatusEvidence: () => hasGitStatusEvidence,
   interpolateArgs: () => interpolateArgs,
   interpolateString: () => interpolateString,
+  isDaemonToServerWsMsg: () => isDaemonToServerWsMsg,
+  isDowngrade: () => isDowngrade,
   isMeshTaskDifficulty: () => isMeshTaskDifficulty,
   isPhantomDaemonEntry: () => isPhantomDaemonEntry,
   isRawDaemonDoId: () => isRawDaemonDoId,
+  isServerToDaemonWsMsg: () => isServerToDaemonWsMsg,
   joinRepoPath: () => joinRepoPath,
   machineCoreFromDaemonId: () => machineCoreFromDaemonId,
   measureWorstCaseChunkEnvelopeBytes: () => measureWorstCaseChunkEnvelopeBytes,
@@ -69,6 +75,7 @@ __export(index_exports, {
   normalizeNodeCapabilitySlots: () => normalizeNodeCapabilitySlots,
   normalizeThinkingLevel: () => normalizeThinkingLevel,
   parseJsonRecord: () => parseJsonRecord,
+  parseSemver: () => parseSemver,
   pickBestTransitGitStatus: () => pickBestTransitGitStatus,
   readBoolean: () => readBoolean,
   readGitSubmodules: () => readGitSubmodules,
@@ -742,6 +749,7 @@ function interpolateString(template, ctx) {
 // src/mesh-tool-names.ts
 var CANONICAL_MESH_TOOL_NAMES = [
   "mesh_status",
+  "mesh_route_preview",
   "mesh_list_nodes",
   // GRAPH-ORCHESTRATION Phase F — batch before task, mirroring ALL_MESH_TOOLS.
   "mesh_enqueue_batch",
@@ -995,11 +1003,88 @@ var MeshChunkAssembler = class {
     }
   }
 };
+
+// src/semver-compare.ts
+var SEMVER_PATTERN = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+var NUMERIC_IDENTIFIER = /^\d+$/;
+function parseSemver(version) {
+  if (typeof version !== "string") return null;
+  const match = version.trim().replace(/^v/, "").match(SEMVER_PATTERN);
+  if (!match) return null;
+  return {
+    major: Number(match[1]),
+    minor: Number(match[2]),
+    patch: Number(match[3]),
+    prerelease: match[4] ? match[4].split(".") : []
+  };
+}
+function comparePrerelease(a, b) {
+  if (a.length === 0 && b.length === 0) return 0;
+  if (a.length === 0) return 1;
+  if (b.length === 0) return -1;
+  for (let i = 0; i < Math.min(a.length, b.length); i += 1) {
+    const idA = a[i];
+    const idB = b[i];
+    if (idA === idB) continue;
+    const numA = NUMERIC_IDENTIFIER.test(idA);
+    const numB = NUMERIC_IDENTIFIER.test(idB);
+    if (numA && numB) return Number(idA) < Number(idB) ? -1 : 1;
+    if (numA) return -1;
+    if (numB) return 1;
+    return idA < idB ? -1 : 1;
+  }
+  return a.length === b.length ? 0 : a.length < b.length ? -1 : 1;
+}
+function compareSemver(a, b) {
+  const pa = parseSemver(a);
+  const pb = parseSemver(b);
+  if (!pa || !pb) return null;
+  if (pa.major !== pb.major) return pa.major < pb.major ? -1 : 1;
+  if (pa.minor !== pb.minor) return pa.minor < pb.minor ? -1 : 1;
+  if (pa.patch !== pb.patch) return pa.patch < pb.patch ? -1 : 1;
+  return comparePrerelease(pa.prerelease, pb.prerelease);
+}
+function isDowngrade(current, target) {
+  const direction = compareSemver(target, current);
+  if (direction === null) return false;
+  return direction < 0;
+}
+
+// src/ws-protocol.ts
+var DAEMON_TO_SERVER_WS_MSGS = [
+  "auth",
+  "status_report",
+  "status_heartbeat",
+  "status_event",
+  "command_result",
+  "error",
+  "agent_event",
+  "log"
+];
+var SERVER_TO_DAEMON_WS_MSGS = [
+  "auth_ok",
+  "auth_error",
+  "machine_evicted",
+  "force_disconnect",
+  "token_revoked",
+  "version_mismatch",
+  "force_update_required",
+  "command",
+  "agent_command",
+  "resolve_action"
+];
+function isDaemonToServerWsMsg(value) {
+  return typeof value === "string" && DAEMON_TO_SERVER_WS_MSGS.includes(value);
+}
+function isServerToDaemonWsMsg(value) {
+  return typeof value === "string" && SERVER_TO_DAEMON_WS_MSGS.includes(value);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CANONICAL_MESH_TOOL_COUNT,
   CANONICAL_MESH_TOOL_NAMES,
   CLI_SLOT_RECIPES,
+  DAEMON_TO_SERVER_WS_MSGS,
   DEFAULT_DIFFICULTY_BRAINS,
   MAGI_RAW_ANSWER_CAP,
   MESH_CHUNK_KIND,
@@ -1011,12 +1096,14 @@ var MeshChunkAssembler = class {
   MESH_TASK_DIFFICULTIES,
   MeshChunkAssembler,
   QUOTA_SUPPORTED_PROVIDERS,
+  SERVER_TO_DAEMON_WS_MSGS,
   STATUS_PROBE_ARG_KEY,
   UNKNOWN_CLI_SLOT_RECIPE,
   argsCarryStatusProbeMarker,
   buildMagiPanelProposal,
   buildSlotProposal,
   canonicalDaemonId,
+  compareSemver,
   daemonIdsEquivalent,
   deriveProviderPriorityFromSlots,
   deriveSlotsFromLegacy,
@@ -1025,9 +1112,12 @@ var MeshChunkAssembler = class {
   hasGitStatusEvidence,
   interpolateArgs,
   interpolateString,
+  isDaemonToServerWsMsg,
+  isDowngrade,
   isMeshTaskDifficulty,
   isPhantomDaemonEntry,
   isRawDaemonDoId,
+  isServerToDaemonWsMsg,
   joinRepoPath,
   machineCoreFromDaemonId,
   measureWorstCaseChunkEnvelopeBytes,
@@ -1046,6 +1136,7 @@ var MeshChunkAssembler = class {
   normalizeNodeCapabilitySlots,
   normalizeThinkingLevel,
   parseJsonRecord,
+  parseSemver,
   pickBestTransitGitStatus,
   readBoolean,
   readGitSubmodules,