@inhuman.tools/plexus-expectations 0.0.0-stage → 0.2.0

package/dist/shared/models/jsonRecord.js

@@ -0,0 +1,46 @@
+/**
+ * Plexus `@syncing.record` bags are `Record<string, string>`. Values round-trip
+ * through JSON.stringify; `undefined` is omitted.
+ */
+export function readJsonRecord(map) {
+    const out = {};
+    for (const [key, raw] of Object.entries(map)) {
+        try {
+            out[key] = JSON.parse(raw);
+        }
+        catch {
+            out[key] = raw;
+        }
+    }
+    return deepFreeze(out);
+}
+export function writeJsonRecord(map, next) {
+    const encoded = {};
+    for (const [key, value] of Object.entries(next ?? {})) {
+        if (value === undefined)
+            continue;
+        encoded[key] = JSON.stringify(value);
+    }
+    for (const key of Object.keys(map)) {
+        if (!(key in encoded))
+            delete map[key];
+    }
+    for (const [key, value] of Object.entries(encoded)) {
+        if (map[key] !== value)
+            map[key] = value;
+    }
+}
+export function deepFreeze(value) {
+    if (value === null || typeof value !== "object" || Object.isFrozen(value))
+        return value;
+    if (Array.isArray(value)) {
+        for (const item of value)
+            deepFreeze(item);
+    }
+    else {
+        for (const item of Object.values(value))
+            deepFreeze(item);
+    }
+    return Object.freeze(value);
+}
+//# sourceMappingURL=jsonRecord.js.map

package/dist/shared/models/jsonRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonRecord.js","sourceRoot":"","sources":["../../../src/shared/models/jsonRecord.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,UAAU,cAAc,CAAC,GAA2B;IACxD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,GAA2B,EAC3B,IAAmD;IAEnD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QACtD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC;YAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAI,KAAQ;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["/**\n * Plexus `@syncing.record` bags are `Record<string, string>`. Values round-trip\n * through JSON.stringify; `undefined` is omitted.\n */\n\n/** Process self-report on ConnectionSpec / DriverSpec. JSON through `liveMap`. */\nexport type LiveFacts = {\n  readonly [key: string]: unknown | undefined;\n  readonly models?: readonly string[];\n  readonly tools?: unknown;\n};\nexport function readJsonRecord(map: Record<string, string>): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [key, raw] of Object.entries(map)) {\n    try {\n      out[key] = JSON.parse(raw);\n    } catch {\n      out[key] = raw;\n    }\n  }\n  return deepFreeze(out);\n}\n\nexport function writeJsonRecord(\n  map: Record<string, string>,\n  next: Readonly<Record<string, unknown>> | undefined,\n): void {\n  const encoded: Record<string, string> = {};\n  for (const [key, value] of Object.entries(next ?? {})) {\n    if (value === undefined) continue;\n    encoded[key] = JSON.stringify(value);\n  }\n  for (const key of Object.keys(map)) {\n    if (!(key in encoded)) delete map[key];\n  }\n  for (const [key, value] of Object.entries(encoded)) {\n    if (map[key] !== value) map[key] = value;\n  }\n}\n\nexport function deepFreeze<T>(value: T): T {\n  if (value === null || typeof value !== \"object\" || Object.isFrozen(value)) return value;\n  if (Array.isArray(value)) {\n    for (const item of value) deepFreeze(item);\n  } else {\n    for (const item of Object.values(value as Record<string, unknown>)) deepFreeze(item);\n  }\n  return Object.freeze(value);\n}\n"]}

package/dist/shared/revalidation-demand.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Revalidation demand. Clients publish on kernel awareness; PEW reduces to
+ * none | secondary | primary. Interned connections outlive a session wrap, so
+ * occupancy is not session-plane. Drivers read the reduced token — never clientIds.
+ */
+import { type PlexusAwareness } from "@here.build/plexus";
+import { ConnectionSpec } from "./models/ConnectionSpec.js";
+import { DriverSpec } from "./models/DriverSpec.js";
+export type RevalidationDemand = "none" | "secondary" | "primary";
+export declare const REVALIDATION_DEMAND_LANE = "revalidationDemand";
+export declare const REVALIDATION_DEMAND_FOCUS_LANE = "revalidationDemandFocus";
+export type RevalidationDemandRef = {
+    readonly kind: "driver";
+    readonly name: string;
+} | {
+    readonly kind: "connection";
+    readonly id: string;
+};
+export type RevalidationDemandSubject = DriverSpec | ConnectionSpec;
+export type RevalidationDemandSource = RevalidationDemandSubject | Iterable<RevalidationDemandSubject | null | undefined> | null | undefined;
+export declare function revalidationDemandRefFromSpec(spec: RevalidationDemandSubject): RevalidationDemandRef;
+export declare function collectRevalidationDemandRefs(source: RevalidationDemandSource): RevalidationDemandRef[];
+export declare function publishRevalidationDemand(hub: PlexusAwareness, refs: readonly RevalidationDemandRef[]): void;
+export declare function publishRevalidationDemandFocus(hub: PlexusAwareness, ref: RevalidationDemandRef | null): void;
+/** Union of every client's occupancy. Primary wins over secondary. */
+export declare function revalidationDemandOf(hub: PlexusAwareness, target: RevalidationDemandRef): RevalidationDemand;
+//# sourceMappingURL=revalidation-demand.d.ts.map

package/dist/shared/revalidation-demand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revalidation-demand.d.ts","sourceRoot":"","sources":["../../src/shared/revalidation-demand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;AAElE,eAAO,MAAM,wBAAwB,uBAAuB,CAAC;AAC7D,eAAO,MAAM,8BAA8B,4BAA4B,CAAC;AAExE,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,yBAAyB,GAAG,UAAU,GAAG,cAAc,CAAC;AAEpE,MAAM,MAAM,wBAAwB,GAAG,yBAAyB,GAAG,QAAQ,CAAC,yBAAyB,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAE7I,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,yBAAyB,GAAG,qBAAqB,CAGpG;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,wBAAwB,GAAG,qBAAqB,EAAE,CAcvG;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,CAO5G;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAO5G;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,qBAAqB,GAAG,kBAAkB,CAY5G"}

package/dist/shared/revalidation-demand.js

@@ -0,0 +1,116 @@
+/**
+ * Revalidation demand. Clients publish on kernel awareness; PEW reduces to
+ * none | secondary | primary. Interned connections outlive a session wrap, so
+ * occupancy is not session-plane. Drivers read the reduced token — never clientIds.
+ */
+import { FieldAwareness } from "@here.build/plexus";
+import { ConnectionSpec } from "./models/ConnectionSpec.js";
+import { DriverSpec } from "./models/DriverSpec.js";
+export const REVALIDATION_DEMAND_LANE = "revalidationDemand";
+export const REVALIDATION_DEMAND_FOCUS_LANE = "revalidationDemandFocus";
+export function revalidationDemandRefFromSpec(spec) {
+    if (isConnectionSubject(spec))
+        return { kind: "connection", id: spec.id };
+    return { kind: "driver", name: spec.name };
+}
+export function collectRevalidationDemandRefs(source) {
+    if (source == null)
+        return [];
+    if (isRevalidationDemandSubject(source))
+        return [revalidationDemandRefFromSpec(source)];
+    const out = [];
+    const seen = new Set();
+    for (const item of source) {
+        if (item == null || !isRevalidationDemandSubject(item))
+            continue;
+        const ref = revalidationDemandRefFromSpec(item);
+        const key = refKey(ref);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(ref);
+    }
+    return out;
+}
+export function publishRevalidationDemand(hub, refs) {
+    const lane = new FieldAwareness(hub, REVALIDATION_DEMAND_LANE);
+    if (refs.length === 0) {
+        lane.clear();
+        return;
+    }
+    lane.set(refs);
+}
+export function publishRevalidationDemandFocus(hub, ref) {
+    const lane = new FieldAwareness(hub, REVALIDATION_DEMAND_FOCUS_LANE);
+    if (ref == null) {
+        lane.clear();
+        return;
+    }
+    lane.set(ref);
+}
+/** Union of every client's occupancy. Primary wins over secondary. */
+export function revalidationDemandOf(hub, target) {
+    const focus = new FieldAwareness(hub, REVALIDATION_DEMAND_FOCUS_LANE);
+    for (const clientId of focus.clientIds) {
+        const value = asRevalidationDemandRef(focus.getOther(clientId));
+        if (value != null && sameRef(value, target))
+            return "primary";
+    }
+    const ambient = new FieldAwareness(hub, REVALIDATION_DEMAND_LANE);
+    for (const clientId of ambient.clientIds) {
+        const list = asRevalidationDemandRefList(ambient.getOther(clientId));
+        if (list.some((item) => sameRef(item, target)))
+            return "secondary";
+    }
+    return "none";
+}
+function isConnectionSubject(spec) {
+    if (spec instanceof ConnectionSpec)
+        return true;
+    if (spec instanceof DriverSpec)
+        return false;
+    return "driver" in spec && "configuration" in spec;
+}
+function isRevalidationDemandSubject(value) {
+    if (value instanceof ConnectionSpec || value instanceof DriverSpec)
+        return true;
+    if (typeof value !== "object" || value === null)
+        return false;
+    if ("driver" in value && "configuration" in value)
+        return true;
+    return "importPath" in value && "abilityClaim" in value;
+}
+function asRevalidationDemandRef(value) {
+    if (typeof value !== "object" || value === null)
+        return null;
+    const rec = value;
+    if (rec.kind === "driver" && typeof rec.name === "string" && rec.name !== "") {
+        return { kind: "driver", name: rec.name };
+    }
+    if (rec.kind === "connection" && typeof rec.id === "string" && rec.id !== "") {
+        return { kind: "connection", id: rec.id };
+    }
+    return null;
+}
+function asRevalidationDemandRefList(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    for (const item of value) {
+        const ref = asRevalidationDemandRef(item);
+        if (ref != null)
+            out.push(ref);
+    }
+    return out;
+}
+function sameRef(a, b) {
+    if (a.kind === "driver" && b.kind === "driver")
+        return a.name === b.name;
+    if (a.kind === "connection" && b.kind === "connection")
+        return a.id === b.id;
+    return false;
+}
+function refKey(ref) {
+    return ref.kind === "driver" ? `driver:${ref.name}` : `connection:${ref.id}`;
+}
+//# sourceMappingURL=revalidation-demand.js.map

package/dist/shared/revalidation-demand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revalidation-demand.js","sourceRoot":"","sources":["../../src/shared/revalidation-demand.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Revalidation demand. Clients publish on kernel awareness; PEW reduces to\n * none | secondary | primary. Interned connections outlive a session wrap, so\n * occupancy is not session-plane. Drivers read the reduced token — never clientIds.\n */\nimport { FieldAwareness, type PlexusAwareness } from \"@here.build/plexus\";\n\nimport { ConnectionSpec } from \"./models/ConnectionSpec.js\";\nimport { DriverSpec } from \"./models/DriverSpec.js\";\n\nexport type RevalidationDemand = \"none\" | \"secondary\" | \"primary\";\n\nexport const REVALIDATION_DEMAND_LANE = \"revalidationDemand\";\nexport const REVALIDATION_DEMAND_FOCUS_LANE = \"revalidationDemandFocus\";\n\nexport type RevalidationDemandRef =\n  | { readonly kind: \"driver\"; readonly name: string }\n  | { readonly kind: \"connection\"; readonly id: string };\n\nexport type RevalidationDemandSubject = DriverSpec | ConnectionSpec;\n\nexport type RevalidationDemandSource = RevalidationDemandSubject | Iterable<RevalidationDemandSubject | null | undefined> | null | undefined;\n\nexport function revalidationDemandRefFromSpec(spec: RevalidationDemandSubject): RevalidationDemandRef {\n  if (isConnectionSubject(spec)) return { kind: \"connection\", id: spec.id };\n  return { kind: \"driver\", name: spec.name };\n}\n\nexport function collectRevalidationDemandRefs(source: RevalidationDemandSource): RevalidationDemandRef[] {\n  if (source == null) return [];\n  if (isRevalidationDemandSubject(source)) return [revalidationDemandRefFromSpec(source)];\n  const out: RevalidationDemandRef[] = [];\n  const seen = new Set<string>();\n  for (const item of source) {\n    if (item == null || !isRevalidationDemandSubject(item)) continue;\n    const ref = revalidationDemandRefFromSpec(item);\n    const key = refKey(ref);\n    if (seen.has(key)) continue;\n    seen.add(key);\n    out.push(ref);\n  }\n  return out;\n}\n\nexport function publishRevalidationDemand(hub: PlexusAwareness, refs: readonly RevalidationDemandRef[]): void {\n  const lane = new FieldAwareness(hub, REVALIDATION_DEMAND_LANE);\n  if (refs.length === 0) {\n    lane.clear();\n    return;\n  }\n  lane.set(refs as never);\n}\n\nexport function publishRevalidationDemandFocus(hub: PlexusAwareness, ref: RevalidationDemandRef | null): void {\n  const lane = new FieldAwareness(hub, REVALIDATION_DEMAND_FOCUS_LANE);\n  if (ref == null) {\n    lane.clear();\n    return;\n  }\n  lane.set(ref as never);\n}\n\n/** Union of every client's occupancy. Primary wins over secondary. */\nexport function revalidationDemandOf(hub: PlexusAwareness, target: RevalidationDemandRef): RevalidationDemand {\n  const focus = new FieldAwareness(hub, REVALIDATION_DEMAND_FOCUS_LANE);\n  for (const clientId of focus.clientIds) {\n    const value = asRevalidationDemandRef(focus.getOther(clientId));\n    if (value != null && sameRef(value, target)) return \"primary\";\n  }\n  const ambient = new FieldAwareness(hub, REVALIDATION_DEMAND_LANE);\n  for (const clientId of ambient.clientIds) {\n    const list = asRevalidationDemandRefList(ambient.getOther(clientId));\n    if (list.some((item) => sameRef(item, target))) return \"secondary\";\n  }\n  return \"none\";\n}\n\nfunction isConnectionSubject(spec: RevalidationDemandSubject): spec is ConnectionSpec {\n  if (spec instanceof ConnectionSpec) return true;\n  if (spec instanceof DriverSpec) return false;\n  return \"driver\" in spec && \"configuration\" in spec;\n}\n\nfunction isRevalidationDemandSubject(value: unknown): value is RevalidationDemandSubject {\n  if (value instanceof ConnectionSpec || value instanceof DriverSpec) return true;\n  if (typeof value !== \"object\" || value === null) return false;\n  if (\"driver\" in value && \"configuration\" in value) return true;\n  return \"importPath\" in value && \"abilityClaim\" in value;\n}\n\nfunction asRevalidationDemandRef(value: unknown): RevalidationDemandRef | null {\n  if (typeof value !== \"object\" || value === null) return null;\n  const rec = value as { kind?: unknown; name?: unknown; id?: unknown };\n  if (rec.kind === \"driver\" && typeof rec.name === \"string\" && rec.name !== \"\") {\n    return { kind: \"driver\", name: rec.name };\n  }\n  if (rec.kind === \"connection\" && typeof rec.id === \"string\" && rec.id !== \"\") {\n    return { kind: \"connection\", id: rec.id };\n  }\n  return null;\n}\n\nfunction asRevalidationDemandRefList(value: unknown): RevalidationDemandRef[] {\n  if (!Array.isArray(value)) return [];\n  const out: RevalidationDemandRef[] = [];\n  for (const item of value) {\n    const ref = asRevalidationDemandRef(item);\n    if (ref != null) out.push(ref);\n  }\n  return out;\n}\n\nfunction sameRef(a: RevalidationDemandRef, b: RevalidationDemandRef): boolean {\n  if (a.kind === \"driver\" && b.kind === \"driver\") return a.name === b.name;\n  if (a.kind === \"connection\" && b.kind === \"connection\") return a.id === b.id;\n  return false;\n}\n\nfunction refKey(ref: RevalidationDemandRef): string {\n  return ref.kind === \"driver\" ? `driver:${ref.name}` : `connection:${ref.id}`;\n}\n"]}

package/dist/shared/role.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Role occupancy. One awareness lane, keyed by expectation uuid.
+ * Schema is append-only (`PlexusAwareness.MAX_LANES` = 64); a lane per
+ * expectation exhausts the budget. Retract the uuid on leave — occupancy
+ * is presence, not a durable outcome. `""` occupies without a report frame.
+ */
+import { type PlexusAwareness } from "@here.build/plexus";
+export declare function reportRole(hub: PlexusAwareness, uuid: string, value: unknown): void;
+export declare function retractRole(hub: PlexusAwareness, uuid: string): void;
+/** First value for `uuid` across bases. Missing key is `undefined`. */
+export declare function roleOf(hub: PlexusAwareness, uuid: string): unknown;
+//# sourceMappingURL=role.d.ts.map

package/dist/shared/role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../src/shared/role.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAK1D,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAOnF;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAElE"}

package/dist/shared/role.js

@@ -0,0 +1,21 @@
+import { MapFieldAwareness } from "./map-field-awareness.js";
+import { ROLE_EXPECTATIONS_LANE } from "./types.js";
+export function reportRole(hub, uuid, value) {
+    const field = lane(hub);
+    if (value === null) {
+        field.mapDelete(uuid);
+        return;
+    }
+    field.mapSet(uuid, value);
+}
+export function retractRole(hub, uuid) {
+    lane(hub).mapDelete(uuid);
+}
+/** First value for `uuid` across bases. Missing key is `undefined`. */
+export function roleOf(hub, uuid) {
+    return lane(hub).mapGet(uuid);
+}
+function lane(hub) {
+    return new MapFieldAwareness(hub, ROLE_EXPECTATIONS_LANE);
+}
+//# sourceMappingURL=role.js.map

package/dist/shared/role.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.js","sourceRoot":"","sources":["../../src/shared/role.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,UAAU,UAAU,CAAC,GAAoB,EAAE,IAAY,EAAE,KAAc;IAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAoB,EAAE,IAAY;IAC5D,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,MAAM,CAAC,GAAoB,EAAE,IAAY;IACvD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,IAAI,CAAC,GAAoB;IAChC,OAAO,IAAI,iBAAiB,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;AAC5D,CAAC","sourcesContent":["/**\n * Role occupancy. One awareness lane, keyed by expectation uuid.\n * Schema is append-only (`PlexusAwareness.MAX_LANES` = 64); a lane per\n * expectation exhausts the budget. Retract the uuid on leave — occupancy\n * is presence, not a durable outcome. `\"\"` occupies without a report frame.\n */\nimport { type PlexusAwareness } from \"@here.build/plexus\";\n\nimport { MapFieldAwareness } from \"./map-field-awareness.js\";\nimport { ROLE_EXPECTATIONS_LANE } from \"./types.js\";\n\nexport function reportRole(hub: PlexusAwareness, uuid: string, value: unknown): void {\n  const field = lane(hub);\n  if (value === null) {\n    field.mapDelete(uuid);\n    return;\n  }\n  field.mapSet(uuid, value);\n}\n\nexport function retractRole(hub: PlexusAwareness, uuid: string): void {\n  lane(hub).mapDelete(uuid);\n}\n\n/** First value for `uuid` across bases. Missing key is `undefined`. */\nexport function roleOf(hub: PlexusAwareness, uuid: string): unknown {\n  return lane(hub).mapGet(uuid);\n}\n\nfunction lane(hub: PlexusAwareness): MapFieldAwareness {\n  return new MapFieldAwareness(hub, ROLE_EXPECTATIONS_LANE);\n}\n"]}

package/dist/shared/types.d.ts

@@ -0,0 +1,43 @@
+import type { AwarenessSerializable, AwarenessShape, Plexus, PlexusModel } from "@here.build/plexus";
+import type { ConnectionSpec } from "./models/ConnectionSpec.js";
+import type { DriverSpec } from "./models/DriverSpec.js";
+import type { WorkContainer } from "./models/WorkContainer.js";
+import type { RevalidationDemandRef } from "./revalidation-demand.js";
+/** `null` = never ensured / never loaded. */
+export type ReadyState = null | "bootstrapping" | "ready" | "failed";
+export declare function asReadyState(value: unknown): ReadyState;
+/**
+ * Revalidation demand is kernel-plane: interned connections outlive a session wrap.
+ * Live catalog faces stay on DriverSpec / ConnectionSpec, not awareness lanes.
+ */
+export type KernelAwareness = AwarenessShape & {
+    revalidationDemand?: readonly RevalidationDemandRef[];
+    revalidationDemandFocus?: RevalidationDemandRef | null;
+};
+/** Live shell tails: one lane, `Record<job.uuid, frame>`. */
+export declare const SHELL_TAILS_LANE = "shell-tails";
+/** Role occupancy: one lane, `Record<expectation.uuid, frame | "">`. */
+export declare const ROLE_EXPECTATIONS_LANE = "role:expectations";
+/** Statusline left slot: the daemon's last successful eval. */
+export declare const STATUSLINE_LANE = "statusline";
+export type SessionAwareness = AwarenessShape & {
+    /** Operator `policy.json` load/eval throw. Presence, not a leaf vote. */
+    policyError?: string;
+    [STATUSLINE_LANE]?: string;
+    [SHELL_TAILS_LANE]?: Record<string, AwarenessSerializable>;
+    [ROLE_EXPECTATIONS_LANE]?: Record<string, AwarenessSerializable>;
+};
+/**
+ * Catalog parent of {@link DriverSpec} / {@link ConnectionSpec}.
+ * Ordinary records, not virtual maps.
+ */
+export type SpecCatalog = PlexusModel<null> & {
+    readonly drivers: Record<string, DriverSpec>;
+    readonly connections: Record<string, ConnectionSpec>;
+};
+/** Product membership is YAML projected onto these records. */
+export type KernelRootModel = SpecCatalog;
+export type SessionRootModel = WorkContainer;
+export type KernelPlexus = Plexus<KernelRootModel, KernelAwareness>;
+export type SessionPlexus = Plexus<SessionRootModel, SessionAwareness>;
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAErG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAGvD;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAC7C,kBAAkB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACtD,uBAAuB,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACxD,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAE9C,wEAAwE;AACxE,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAE1D,+DAA+D;AAC/D,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG;IAC9C,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,eAAe,CAAC,CAAC,EAAE,MAAM,CAAC;IAC3B,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC3D,CAAC,sBAAsB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAClE,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtD,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC;AAE1C,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAE7C,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/shared/types.js

@@ -0,0 +1,12 @@
+export function asReadyState(value) {
+    if (value === "bootstrapping" || value === "ready" || value === "failed")
+        return value;
+    return null;
+}
+/** Live shell tails: one lane, `Record<job.uuid, frame>`. */
+export const SHELL_TAILS_LANE = "shell-tails";
+/** Role occupancy: one lane, `Record<expectation.uuid, frame | "">`. */
+export const ROLE_EXPECTATIONS_LANE = "role:expectations";
+/** Statusline left slot: the daemon's last successful eval. */
+export const STATUSLINE_LANE = "statusline";
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,KAAK,eAAe,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvF,OAAO,IAAI,CAAC;AACd,CAAC;AAWD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAE9C,wEAAwE;AACxE,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAE1D,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC","sourcesContent":["import type { AwarenessSerializable, AwarenessShape, Plexus, PlexusModel } from \"@here.build/plexus\";\n\nimport type { ConnectionSpec } from \"./models/ConnectionSpec.js\";\nimport type { DriverSpec } from \"./models/DriverSpec.js\";\nimport type { WorkContainer } from \"./models/WorkContainer.js\";\nimport type { RevalidationDemandRef } from \"./revalidation-demand.js\";\n\n/** `null` = never ensured / never loaded. */\nexport type ReadyState = null | \"bootstrapping\" | \"ready\" | \"failed\";\n\nexport function asReadyState(value: unknown): ReadyState {\n  if (value === \"bootstrapping\" || value === \"ready\" || value === \"failed\") return value;\n  return null;\n}\n\n/**\n * Revalidation demand is kernel-plane: interned connections outlive a session wrap.\n * Live catalog faces stay on DriverSpec / ConnectionSpec, not awareness lanes.\n */\nexport type KernelAwareness = AwarenessShape & {\n  revalidationDemand?: readonly RevalidationDemandRef[];\n  revalidationDemandFocus?: RevalidationDemandRef | null;\n};\n\n/** Live shell tails: one lane, `Record<job.uuid, frame>`. */\nexport const SHELL_TAILS_LANE = \"shell-tails\";\n\n/** Role occupancy: one lane, `Record<expectation.uuid, frame | \"\">`. */\nexport const ROLE_EXPECTATIONS_LANE = \"role:expectations\";\n\n/** Statusline left slot: the daemon's last successful eval. */\nexport const STATUSLINE_LANE = \"statusline\";\n\nexport type SessionAwareness = AwarenessShape & {\n  /** Operator `policy.json` load/eval throw. Presence, not a leaf vote. */\n  policyError?: string;\n  [STATUSLINE_LANE]?: string;\n  [SHELL_TAILS_LANE]?: Record<string, AwarenessSerializable>;\n  [ROLE_EXPECTATIONS_LANE]?: Record<string, AwarenessSerializable>;\n};\n\n/**\n * Catalog parent of {@link DriverSpec} / {@link ConnectionSpec}.\n * Ordinary records, not virtual maps.\n */\nexport type SpecCatalog = PlexusModel<null> & {\n  readonly drivers: Record<string, DriverSpec>;\n  readonly connections: Record<string, ConnectionSpec>;\n};\n\n/** Product membership is YAML projected onto these records. */\nexport type KernelRootModel = SpecCatalog;\n\nexport type SessionRootModel = WorkContainer;\n\nexport type KernelPlexus = Plexus<KernelRootModel, KernelAwareness>;\nexport type SessionPlexus = Plexus<SessionRootModel, SessionAwareness>;\n"]}

package/package.json

@@ -1,6 +1,82 @@
 {
   "name": "@inhuman.tools/plexus-expectations",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Work graph: WorkExpectation (PEW), Job + honoring executor.",
+  "license": "MIT",
+  "author": "Merkle Bonsai",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./executor": {
+      "types": "./dist/executor/index.d.ts",
+      "import": "./dist/executor/index.js",
+      "default": "./dist/executor/index.js"
+    },
+    "./driver": {
+      "types": "./dist/driver/index.d.ts",
+      "import": "./dist/driver/index.js",
+      "default": "./dist/driver/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "!**/__tests__",
+    "!**/*.test.*"
+  ],
+  "dependencies": {
+    "@here.build/collections": "0.9.0",
+    "tiny-invariant": "^1.3.3",
+    "zod": "^4.4.3",
+    "tslib": "2.8.1",
+    "xstate": "5.32.5",
+    "@inhuman.tools/error-with-invariant": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "eslint": "9.39.2",
+    "prettier": "3.8.1",
+    "typescript": "6.0.2",
+    "vitest": "4.1.0",
+    "yjs": "13.6.33",
+    "mobx": "6.16.1",
+    "@here.build/plexus": "^0.9.6",
+    "@-internal-/eslint-configs": "0.0.0",
+    "@-internal-/tsconfig": "0.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/here-build/inhuman-harness.git",
+    "directory": "packages/plexus-expectations"
+  },
+  "peerDependencies": {
+    "mobx": "6.16.1",
+    "@here.build/plexus": "^0.9.6"
+  },
+  "browserslist": [
+    "last 2 chrome versions",
+    "last 2 firefox versions",
+    "last 2 safari versions",
+    "ios_saf >= 16.4",
+    "node >= 22"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
 }