@moondeck/station 0.0.0-stage → 1.0.0

package/lib/agents/attach-compatibility.ts

@@ -0,0 +1,51 @@
+/**
+ * Compatibility for the v0.9.147 -> v0.9.148 durable-session key rollout.
+ *
+ * Older hosts could not receive live roster edits and persisted only the
+ * execution-policy key: null for crew, or one of the Secretary policy
+ * constants. v0.9.148 adds kind/model/effort to that key. Treat the old row as
+ * compatible with the richer desired key only when its policy is unchanged;
+ * the transition is deliberately one-way so future/unknown keys remain exact.
+ */
+
+const LEGACY_SECRETARY_POLICY_KEYS = new Set([
+  "secretary-normal-tools-v1",
+  "secretary-communicator-v1",
+]);
+
+function rosterLaunchPolicy(key: string | null): string | null | undefined {
+  if (key === null) return undefined;
+  try {
+    const parsed: unknown = JSON.parse(key);
+    if (
+      !Array.isArray(parsed) ||
+      parsed.length !== 5 ||
+      parsed[0] !== "roster-launch-v1" ||
+      typeof parsed[1] !== "string" ||
+      typeof parsed[2] !== "string" ||
+      typeof parsed[3] !== "string" ||
+      typeof parsed[4] !== "string"
+    ) {
+      return undefined;
+    }
+    return parsed[4] === "" ? null : parsed[4];
+  } catch {
+    return undefined;
+  }
+}
+
+export function attachCompatibilityKeysMatch(
+  stored: string | null | undefined,
+  desired: string | null | undefined,
+): boolean {
+  const storedKey = stored ?? null;
+  const desiredKey = desired ?? null;
+  if (storedKey === desiredKey) return true;
+
+  const desiredPolicy = rosterLaunchPolicy(desiredKey);
+  if (storedKey === null) return desiredPolicy === null;
+  return (
+    LEGACY_SECRETARY_POLICY_KEYS.has(storedKey) &&
+    desiredPolicy === storedKey
+  );
+}