@chatpanel/events 0.22.0 → 0.23.1

package/index.js

@@ -18,6 +18,7 @@ export {
 export { REF_KINDS, RESOLUTION, makeRef, isRef, resolveRef } from './ref.js';
 export { linearize, compareEvents, causesAreWellFormed } from './order.js';
 export { pendingQueue, isQueued, dequeue, moveQueued, promoteQueued } from './queue.js';
+export { REACH, reachRank, reachSatisfies } from './reach.js';
 export { UPCASTERS, upcast, upcastAll } from './upcast.js';
 export {
   validateCapability, validateInvocation, canSatisfy,
@@ -42,7 +43,7 @@ export { defineAdapter, createAdapterRegistry, AdapterError } from './adapters.j
 export { linkifyCitations, sourcesFromToolText } from './citations.js';
 export { buildTrajectory, phasesOf, lanesOf, filterEntries, displayName, ENTRY_KINDS, threadsOf, threadTitle, promptEntries, turnsOf, threadTree } from './trajectory.js';
 export { createTurnRunner, defineLoop, LOOP_KINDS, LoopError } from './loop.js';
-export { defineModel, defineMiddleware, defineRouteStrategy, createModelRouter, signalsFrom, requirementsFor, requirementsForStep, preferenceFor, failoverOrder, pinnedOrderOf, FAILOVER_CLASS_GAP, FAILOVER_CAPABILITY_GAP, sameModelKey, REACH, RouterError } from './router.js';
+export { defineModel, defineMiddleware, defineRouteStrategy, createModelRouter, signalsFrom, requirementsFor, requirementsForStep, preferenceFor, failoverOrder, pinnedOrderOf, FAILOVER_CLASS_GAP, FAILOVER_CAPABILITY_GAP, sameModelKey, RouterError } from './router.js';
 export { makeSourceStore, manifestText, shortUrl, readSource, sourceId } from './sources-retrieval.js';
 export { classifySource, extractUrls, hostMatches, meetReach, sourcePolicyFor, DEFAULT_INTERNAL_PATTERNS, INTERNAL_PATTERN_CATALOG } from './sources.js';
 export { defineRule, createRuleEngine, SUPPRESSED, RuleError } from './rules.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatpanel/events",
-  "version": "0.22.0",
+  "version": "0.23.1",
   "description": "The canonical ChatPanel event-log and capability contracts — typed durable facts, clock-free deterministic linearization, schema upcasting, and the invariants the replay harness asserts. Pure, dependency-free ESM shared by the ChatPanel extension, gateway and bridge.",
   "type": "module",
   "main": "index.js",
@@ -21,6 +21,7 @@
     "./memory.js": "./memory.js",
     "./order.js": "./order.js",
     "./queue.js": "./queue.js",
+    "./reach.js": "./reach.js",
     "./ref.js": "./ref.js",
     "./registry.js": "./registry.js",
     "./route-graph.js": "./route-graph.js",
@@ -70,6 +71,7 @@
     "observability.js",
     "order.js",
     "queue.js",
+    "reach.js",
     "ref.js",
     "registry.js",
     "route-graph.js",

package/reach.js

@@ -0,0 +1,23 @@
+// reach.js — how far a request may travel, on its own so it can travel alone.
+//
+// One ordered vocabulary answers "how far may this go" for three very different callers: the
+// model router ranks a model's reach against a turn's requirement, pairing gives a phone a
+// ceiling, and the bridge maps that ceiling to a toolset. Three declarations, one vocabulary,
+// or "how far may this reach" gets three answers that drift.
+//
+// A separate module rather than a constant inside router.js for the reason scopes.js exists:
+// the consumers have wildly different weights. The bridge has zero runtime dependencies by
+// design and vendors what it needs — pulling the 50 KB model router in to reach a
+// three-element array is exactly the transitive-graph mistake that split DATA_SCOPES out of
+// capability.js.
+//
+// ORDERED, least to most: a ceiling comparison is an index comparison.
+export const REACH = Object.freeze(['device', 'trusted', 'any']);
+
+/** Position in the ladder; an unknown tier ranks LOWEST, so a typo never widens reach. */
+export const reachRank = (r) => Math.max(0, REACH.indexOf(r));
+
+/** Does `have` satisfy `need`? Fails closed — an unknown `have` is treated as 'device'. */
+export function reachSatisfies(have, need) {
+  return reachRank(have) >= reachRank(need);
+}

package/router.js

@@ -25,9 +25,11 @@ export class RouterError extends Error {
 }
 
 /** Where a request may go. Ordered: each level permits everything below it. */
-export const REACH = Object.freeze(['device', 'trusted', 'any']);
-
-const reachRank = (r) => Math.max(0, REACH.indexOf(r));
+// The reach vocabulary lives in reach.js so a zero-dependency consumer (the bridge) can take
+// the ladder without taking the router. Re-exported here because every existing caller reaches
+// for it through the router — that import must keep working.
+export { REACH, reachRank } from './reach.js';
+import { REACH, reachRank } from './reach.js';
 
 /**
  * Declare a model a request can be routed to.