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

package/dist/interactive-prompt-constants.d.ts

@@ -0,0 +1 @@
+export declare const CLAUDE_TUI_REVIEW_PAGE_NOT_FOCUSED_PREFIX = "Claude TUI review page is not focused";

package/dist/node-facts.d.ts

@@ -51,6 +51,25 @@ export interface MeshNodeFactsProviderQuota {
     status: string;
     session: MeshNodeFactsQuotaWindow | null;
     weekly: MeshNodeFactsQuotaWindow | null;
+    /** 30-day billing-style window, only for providers that report one
+     *  (cursor-cli). Promoted from the index signature 2026-08-24 so readers
+     *  can render it typed — an 'ok' cursor snapshot often carries ONLY this
+     *  axis, and a reader that looks at session/weekly alone misreads a
+     *  healthy reading as a failure. */
+    monthly?: MeshNodeFactsQuotaWindow | null;
+    /** Per-pool quota buckets, only for providers whose plan has more than one
+     *  pool (antigravity-cli: Gemini vs Claude/GPT groups, each with a 5h and
+     *  a weekly bucket). `session`/`weekly` above collapse these to the WORST
+     *  bucket per window (the routing-safe headline); the buckets carry the
+     *  per-pool detail a reader should surface. Promoted from the index
+     *  signature 2026-08-24, same reasoning as `monthly`. */
+    buckets?: Array<{
+        name?: string;
+        usedPercent?: number;
+        windowMinutes?: number;
+        resetsAt?: number | null;
+        [extra: string]: unknown;
+    }> | null;
     /** Unix ms of the snapshot itself — older than the bundle's reportedAt. */
     updatedAt: number;
     error: string | null;
@@ -136,7 +155,7 @@ export interface MeshNodeFacts {
     machineNickname?: string;
     /**
      * Per-provider quota snapshots, keyed by QuotaProvider id ('claude-cli',
-     * 'codex-cli', 'kimi'). Consumed by ROUTING as well as observation: the
+     * 'codex-cli', 'cursor-cli', 'kimi'). Consumed by ROUTING as well as observation: the
      * coordinator's quota gate / spread bonus (daemon-core mesh-quota-routing.ts,
      * thresholds in RepoMeshPolicy.quotaRouting) reads exactly this shape, so
      * field renames here are a routing-contract change, not a cosmetic one.

package/dist/ws-protocol.d.ts

@@ -18,9 +18,24 @@
  * or matches.
  */
 /** Messages the daemon sends UP to the Workers server over the WS bridge. */
-export type DaemonToServerWsMsg = 'auth' | 'status_report' | 'status_heartbeat' | 'status_event' | 'command_result' | 'error' | 'agent_event' | 'log';
+export type DaemonToServerWsMsg = 'auth' | 'status_report' | 'status_heartbeat' | 'status_event' | 'command_result' | 'error' | 'agent_event' | 'log'
+/**
+ * seqscribe Beacon vectors (design §7.1). ONE daemon-initiated frame carries
+ * both directions — `op: 'put'` stores this node's content-free vector
+ * report, `op: 'get'` asks for the board — because the server has no way to
+ * wake itself: `DaemonConnectionDO` has neither an alarm nor a timer, and
+ * adding one would hit the most request-quota-pressured axis in the system.
+ */
+ | 'beacon_vectors';
 /** Server→daemon control messages the OSS engine reacts to. */
-export type ServerToDaemonWsMsg = 'auth_ok' | 'auth_error' | 'machine_evicted' | 'force_disconnect' | 'token_revoked' | 'version_mismatch' | 'force_update_required' | 'command' | 'agent_command' | 'resolve_action';
+export type ServerToDaemonWsMsg = 'auth_ok' | 'auth_error' | 'machine_evicted' | 'force_disconnect' | 'token_revoked' | 'version_mismatch' | 'force_update_required' | 'command' | 'agent_command' | 'resolve_action'
+/**
+ * Reply to a `beacon_vectors` GET, correlated by `requestId`. A PUT is
+ * fire-and-forget and gets no reply at all — the beacon is advisory, so a
+ * lost report costs one debounce cycle of prediction accuracy and nothing
+ * else, which is not worth an ack round trip.
+ */
+ | 'beacon_vectors_result';
 /** P2P signaling relayed through the server WS. */
 export type P2PSignalingWsMsg = 'p2p_ready' | 'offer' | 'answer' | 'ice' | 'mesh_p2p_ready' | 'mesh_p2p_offer' | 'mesh_p2p_answer' | 'mesh_p2p_ice';
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/mesh-shared",
-  "version": "1.0.58-rc.7",
+  "version": "1.0.58-rc.70",
   "description": "ADHDev mesh-shared — pure mesh/git status normalizers shared by daemon-core and web-core",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/index.ts

@@ -28,3 +28,4 @@ export * from './mesh-status-probe'
 export * from './rpc-chunking'
 export * from './semver-compare'
 export * from './ws-protocol'
+export * from './interactive-prompt-constants'

package/src/interactive-prompt-constants.ts

@@ -0,0 +1 @@
+export const CLAUDE_TUI_REVIEW_PAGE_NOT_FOCUSED_PREFIX = 'Claude TUI review page is not focused';

package/src/node-facts.ts

@@ -54,6 +54,25 @@ export interface MeshNodeFactsProviderQuota {
     status: string
     session: MeshNodeFactsQuotaWindow | null
     weekly: MeshNodeFactsQuotaWindow | null
+    /** 30-day billing-style window, only for providers that report one
+     *  (cursor-cli). Promoted from the index signature 2026-08-24 so readers
+     *  can render it typed — an 'ok' cursor snapshot often carries ONLY this
+     *  axis, and a reader that looks at session/weekly alone misreads a
+     *  healthy reading as a failure. */
+    monthly?: MeshNodeFactsQuotaWindow | null
+    /** Per-pool quota buckets, only for providers whose plan has more than one
+     *  pool (antigravity-cli: Gemini vs Claude/GPT groups, each with a 5h and
+     *  a weekly bucket). `session`/`weekly` above collapse these to the WORST
+     *  bucket per window (the routing-safe headline); the buckets carry the
+     *  per-pool detail a reader should surface. Promoted from the index
+     *  signature 2026-08-24, same reasoning as `monthly`. */
+    buckets?: Array<{
+        name?: string
+        usedPercent?: number
+        windowMinutes?: number
+        resetsAt?: number | null
+        [extra: string]: unknown
+    }> | null
     /** Unix ms of the snapshot itself — older than the bundle's reportedAt. */
     updatedAt: number
     error: string | null
@@ -141,7 +160,7 @@ export interface MeshNodeFacts {
     machineNickname?: string
     /**
      * Per-provider quota snapshots, keyed by QuotaProvider id ('claude-cli',
-     * 'codex-cli', 'kimi'). Consumed by ROUTING as well as observation: the
+     * 'codex-cli', 'cursor-cli', 'kimi'). Consumed by ROUTING as well as observation: the
      * coordinator's quota gate / spread bonus (daemon-core mesh-quota-routing.ts,
      * thresholds in RepoMeshPolicy.quotaRouting) reads exactly this shape, so
      * field renames here are a routing-contract change, not a cosmetic one.
@@ -246,6 +265,7 @@ export const QUOTA_SUPPORTED_PROVIDERS: readonly string[] = [
     'antigravity-cli',
     'claude-cli',
     'codex-cli',
+    'cursor-cli',
     'grok-cli',
     'kimi',
     'opencode',

package/src/ws-protocol.ts

@@ -27,7 +27,15 @@ export type DaemonToServerWsMsg =
     | 'command_result'
     | 'error'
     | 'agent_event'
-    | 'log';
+    | 'log'
+    /**
+     * seqscribe Beacon vectors (design §7.1). ONE daemon-initiated frame carries
+     * both directions — `op: 'put'` stores this node's content-free vector
+     * report, `op: 'get'` asks for the board — because the server has no way to
+     * wake itself: `DaemonConnectionDO` has neither an alarm nor a timer, and
+     * adding one would hit the most request-quota-pressured axis in the system.
+     */
+    | 'beacon_vectors';
 
 /** Server→daemon control messages the OSS engine reacts to. */
 export type ServerToDaemonWsMsg =
@@ -40,7 +48,14 @@ export type ServerToDaemonWsMsg =
     | 'force_update_required'
     | 'command'
     | 'agent_command'
-    | 'resolve_action';
+    | 'resolve_action'
+    /**
+     * Reply to a `beacon_vectors` GET, correlated by `requestId`. A PUT is
+     * fire-and-forget and gets no reply at all — the beacon is advisory, so a
+     * lost report costs one debounce cycle of prediction accuracy and nothing
+     * else, which is not worth an ack round trip.
+     */
+    | 'beacon_vectors_result';
 
 /** P2P signaling relayed through the server WS. */
 export type P2PSignalingWsMsg =
@@ -74,11 +89,13 @@ export type DashboardP2PMessageKind =
 
 export const DAEMON_TO_SERVER_WS_MSGS: readonly DaemonToServerWsMsg[] = [
     'auth', 'status_report', 'status_heartbeat', 'status_event', 'command_result', 'error', 'agent_event', 'log',
+    'beacon_vectors',
 ];
 
 export const SERVER_TO_DAEMON_WS_MSGS: readonly ServerToDaemonWsMsg[] = [
     'auth_ok', 'auth_error', 'machine_evicted', 'force_disconnect', 'token_revoked',
     'version_mismatch', 'force_update_required', 'command', 'agent_command', 'resolve_action',
+    'beacon_vectors_result',
 ];
 
 export function isDaemonToServerWsMsg(value: unknown): value is DaemonToServerWsMsg {