@adhdev/mesh-shared 1.0.58-rc.9 → 1.0.58-rc.91

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

@@ -0,0 +1,17 @@
+export declare const CLAUDE_TUI_REVIEW_PAGE_NOT_FOCUSED_PREFIX = "Claude TUI review page is not focused";
+/**
+ * The answer keystrokes reached the terminal, but the daemon could not CONFIRM
+ * the review page before its settle budget expired — the picker was still
+ * showing our own bound question, not a foreign widget.
+ *
+ * This is deliberately a separate class from
+ * CLAUDE_TUI_REVIEW_PAGE_NOT_FOCUSED_PREFIX, which means "the screen is
+ * something we do not own, so we refuse to press Enter into it". Here the
+ * screen IS ours and the input WAS delivered; only the confirmation is
+ * missing. Resending would replay the whole keystroke sequence into a picker
+ * that may have advanced in the meantime, so the UI for this class must NOT
+ * invite a retry. See the daemon-side gate in
+ * `providers/spec/cli-adapter.ts` (assertFocusedClaudeTuiReview) and the web
+ * mapping in `web-core/src/hooks/useInteractivePrompt.ts`.
+ */
+export declare const CLAUDE_TUI_REVIEW_UNCONFIRMED_PREFIX = "Claude TUI answer delivered but not confirmed";

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.9",
+  "version": "1.0.58-rc.91",
   "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,18 @@
+export const CLAUDE_TUI_REVIEW_PAGE_NOT_FOCUSED_PREFIX = 'Claude TUI review page is not focused';
+
+/**
+ * The answer keystrokes reached the terminal, but the daemon could not CONFIRM
+ * the review page before its settle budget expired — the picker was still
+ * showing our own bound question, not a foreign widget.
+ *
+ * This is deliberately a separate class from
+ * CLAUDE_TUI_REVIEW_PAGE_NOT_FOCUSED_PREFIX, which means "the screen is
+ * something we do not own, so we refuse to press Enter into it". Here the
+ * screen IS ours and the input WAS delivered; only the confirmation is
+ * missing. Resending would replay the whole keystroke sequence into a picker
+ * that may have advanced in the meantime, so the UI for this class must NOT
+ * invite a retry. See the daemon-side gate in
+ * `providers/spec/cli-adapter.ts` (assertFocusedClaudeTuiReview) and the web
+ * mapping in `web-core/src/hooks/useInteractivePrompt.ts`.
+ */
+export const CLAUDE_TUI_REVIEW_UNCONFIRMED_PREFIX = 'Claude TUI answer delivered but not confirmed';

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 {