4runr-os 1.0.97 → 1.0.99

package/dist/ui/v3/state/defaultState.js

@@ -1,11 +1,23 @@
 /**
- * Default UiState (Phase 4)
+ * Section 4: Default UiState (Cold Boot State)
  *
  * Initial state before collectors run.
- * All fields start as UNAVAILABLE.
+ * All fields start as UNAVAILABLE with:
+ * - reason stating why
+ * - nextAction telling operator what to do next
+ *
+ * Hard requirements:
+ * - No key may be AVAILABLE in the default state
+ * - No key may be missing
+ * - All panels must have meaningful reason + nextAction (do not leave empty)
  */
 import { unavailable } from './value.js';
 export const defaultUiState = {
-    resources: unavailable('Not initialized', 'Waiting for first collection cycle'),
+    posture: unavailable('Posture not initialized', 'Run "status" to check system state'),
+    resources: unavailable('Resources not collected', 'Waiting for first collection cycle'),
+    assets: unavailable('Asset registry not initialized', 'Start agent registry'),
+    network: unavailable('Network state unknown', 'Run "connect" to initialize Gateway'),
+    capabilities: unavailable('Capabilities not loaded', 'Run "status" after connecting'),
+    statusStrip: unavailable('Status not initialized', 'System starting up'),
 };
 //# sourceMappingURL=defaultState.js.map

package/dist/ui/v3/state/defaultState.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaultState.js","sourceRoot":"","sources":["../../../../src/ui/v3/state/defaultState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,SAAS,EAAE,WAAW,CACpB,iBAAiB,EACjB,oCAAoC,CACrC;CACF,CAAC"}
+{"version":3,"file":"defaultState.js","sourceRoot":"","sources":["../../../../src/ui/v3/state/defaultState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,OAAO,EAAE,WAAW,CAClB,yBAAyB,EACzB,oCAAoC,CACrC;IACD,SAAS,EAAE,WAAW,CACpB,yBAAyB,EACzB,oCAAoC,CACrC;IACD,MAAM,EAAE,WAAW,CACjB,gCAAgC,EAChC,sBAAsB,CACvB;IACD,OAAO,EAAE,WAAW,CAClB,uBAAuB,EACvB,qCAAqC,CACtC;IACD,YAAY,EAAE,WAAW,CACvB,yBAAyB,EACzB,+BAA+B,CAChC;IACD,WAAW,EAAE,WAAW,CACtB,wBAAwB,EACxB,oBAAoB,CACrB;CACF,CAAC"}

package/dist/ui/v3/state/uiState.d.ts

@@ -1,12 +1,22 @@
 /**
- * UiState (Phase 4)
+ * Section 4: UiState Contract
  *
  * Single source of truth for UI state.
  * All panels render from UiState only.
+ *
+ * Rule: UiState keys are locked. If a developer tries to add a key,
+ * it should require deliberate refactor (not accidental).
+ *
+ * All keys must use Value<T> with strict type T for that panel.
  */
 import type { Value } from './value.js';
-import type { ResourcesData } from './resourcesData.js';
+import type { PostureState, ResourcesState, AssetsState, NetworkState, CapabilitiesState, StatusStripState } from './uiStateTypes.js';
 export interface UiState {
-    resources: Value<ResourcesData>;
+    posture: Value<PostureState>;
+    resources: Value<ResourcesState>;
+    assets: Value<AssetsState>;
+    network: Value<NetworkState>;
+    capabilities: Value<CapabilitiesState>;
+    statusStrip: Value<StatusStripState>;
 }
 //# sourceMappingURL=uiState.d.ts.map

package/dist/ui/v3/state/uiState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uiState.d.ts","sourceRoot":"","sources":["../../../../src/ui/v3/state/uiState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;CAKjC"}
+{"version":3,"file":"uiState.d.ts","sourceRoot":"","sources":["../../../../src/ui/v3/state/uiState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC7B,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACjC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3B,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC7B,YAAY,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACvC,WAAW,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;CACtC"}

package/dist/ui/v3/state/uiState.js

@@ -1,8 +1,13 @@
 /**
- * UiState (Phase 4)
+ * Section 4: UiState Contract
  *
  * Single source of truth for UI state.
  * All panels render from UiState only.
+ *
+ * Rule: UiState keys are locked. If a developer tries to add a key,
+ * it should require deliberate refactor (not accidental).
+ *
+ * All keys must use Value<T> with strict type T for that panel.
  */
 export {};
 //# sourceMappingURL=uiState.js.map

package/dist/ui/v3/state/uiState.js.map

@@ -1 +1 @@
-{"version":3,"file":"uiState.js","sourceRoot":"","sources":["../../../../src/ui/v3/state/uiState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
+{"version":3,"file":"uiState.js","sourceRoot":"","sources":["../../../../src/ui/v3/state/uiState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/ui/v3/state/uiStateBuilder.d.ts

@@ -1,12 +1,17 @@
 /**
- * UiState Builder (Phase 4)
+ * Section 4: UiState Builder
  *
  * Builds the complete UiState from collectors.
  * This is the single source of truth for UI data.
+ *
+ * All panels must have data - no missing keys.
  */
 import type { UiState } from './uiState.js';
 /**
  * Build the current UiState
+ *
+ * Section 4: Must include all required keys
+ * All keys must use Value<T> structure
  */
 export declare function buildUiState(): Promise<UiState>;
 /**

package/dist/ui/v3/state/uiStateBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uiStateBuilder.d.ts","sourceRoot":"","sources":["../../../../src/ui/v3/state/uiStateBuilder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAa5C;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAWrD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}
+{"version":3,"file":"uiStateBuilder.d.ts","sourceRoot":"","sources":["../../../../src/ui/v3/state/uiStateBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAe5C;;;;;GAKG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAoBrD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/dist/ui/v3/state/uiStateBuilder.js

@@ -1,11 +1,15 @@
 /**
- * UiState Builder (Phase 4)
+ * Section 4: UiState Builder
  *
  * Builds the complete UiState from collectors.
  * This is the single source of truth for UI data.
+ *
+ * All panels must have data - no missing keys.
  */
 import { defaultUiState } from './defaultState.js';
+import { assertUiState } from './assertUiState.js';
 import { collectResources } from '../collectors/resources.js';
+import { unavailable } from './value.js';
 /**
  * Build UiState from collectors
  *
@@ -15,14 +19,25 @@ const COLLECTOR_INTERVAL = 1500; // ms
 let lastState = defaultUiState;
 /**
  * Build the current UiState
+ *
+ * Section 4: Must include all required keys
+ * All keys must use Value<T> structure
  */
 export async function buildUiState() {
-    // Collect resources
+    // Collect resources (only one collector for now)
     const resources = await collectResources();
-    // Build state
+    // Build state with all required keys
+    // For now, most panels are UNAVAILABLE (will be populated by collectors in future)
     const state = {
+        posture: unavailable('Posture not initialized', 'Run "status" to check system state'),
         resources,
+        assets: unavailable('Asset registry not initialized', 'Start agent registry'),
+        network: unavailable('Network state unknown', 'Run "connect" to initialize Gateway'),
+        capabilities: unavailable('Capabilities not loaded', 'Run "status" after connecting'),
+        statusStrip: unavailable('Status not initialized', 'System starting up'),
     };
+    // Section 4: Validate state contract at runtime
+    assertUiState(state);
     lastState = state;
     return state;
 }

package/dist/ui/v3/state/uiStateBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"uiStateBuilder.js","sourceRoot":"","sources":["../../../../src/ui/v3/state/uiStateBuilder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,IAAI,CAAC,CAAC,KAAK;AAEtC,IAAI,SAAS,GAAY,cAAc,CAAC;AAExC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,oBAAoB;IACpB,MAAM,SAAS,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAE3C,cAAc;IACd,MAAM,KAAK,GAAY;QACrB,SAAS;KACV,CAAC;IAEF,SAAS,GAAG,KAAK,CAAC;IAClB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"uiStateBuilder.js","sourceRoot":"","sources":["../../../../src/ui/v3/state/uiStateBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,IAAI,CAAC,CAAC,KAAK;AAEtC,IAAI,SAAS,GAAY,cAAc,CAAC;AAExC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,iDAAiD;IACjD,MAAM,SAAS,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAE3C,qCAAqC;IACrC,mFAAmF;IACnF,MAAM,KAAK,GAAY;QACrB,OAAO,EAAE,WAAW,CAAC,yBAAyB,EAAE,oCAAoC,CAAC;QACrF,SAAS;QACT,MAAM,EAAE,WAAW,CAAC,gCAAgC,EAAE,sBAAsB,CAAC;QAC7E,OAAO,EAAE,WAAW,CAAC,uBAAuB,EAAE,qCAAqC,CAAC;QACpF,YAAY,EAAE,WAAW,CAAC,yBAAyB,EAAE,+BAA+B,CAAC;QACrF,WAAW,EAAE,WAAW,CAAC,wBAAwB,EAAE,oBAAoB,CAAC;KACzE,CAAC;IAEF,gDAAgD;IAChD,aAAa,CAAC,KAAK,CAAC,CAAC;IAErB,SAAS,GAAG,KAAK,CAAC;IAClB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/ui/v3/state/uiStateTypes.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Section 4: UiState Type Definitions
+ *
+ * Strict type definitions for each panel's data.
+ * These are the T in Value<T> for each panel.
+ */
+/**
+ * Posture state (minimal for now)
+ */
+export type PostureState = {
+    mode: "HUB" | "UNKNOWN";
+};
+/**
+ * Resources state (system metrics)
+ */
+export type ResourcesState = {
+    cpuPct: number;
+    ramUsedMB: number;
+    ramTotalMB: number;
+    diskUsedGB: number;
+    diskTotalGB: number;
+    uptime: string;
+};
+/**
+ * Assets state
+ */
+export type AssetsState = {
+    total: number;
+    active: number;
+    idle: number;
+    error: number;
+};
+/**
+ * Network state
+ */
+export type NetworkState = {
+    gateway: "CONNECTED" | "DISCONNECTED";
+};
+/**
+ * Capabilities state
+ */
+export type CapabilitiesState = {
+    items: string[];
+};
+/**
+ * Status strip state
+ */
+export type StatusStripState = {
+    left: string;
+    right: string;
+};
+//# sourceMappingURL=uiStateTypes.d.ts.map

package/dist/ui/v3/state/uiStateTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uiStateTypes.d.ts","sourceRoot":"","sources":["../../../../src/ui/v3/state/uiStateTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/ui/v3/state/uiStateTypes.js

@@ -0,0 +1,8 @@
+/**
+ * Section 4: UiState Type Definitions
+ *
+ * Strict type definitions for each panel's data.
+ * These are the T in Value<T> for each panel.
+ */
+export {};
+//# sourceMappingURL=uiStateTypes.js.map

package/dist/ui/v3/state/uiStateTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uiStateTypes.js","sourceRoot":"","sources":["../../../../src/ui/v3/state/uiStateTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/ui/v3/state/value.d.ts

@@ -1,39 +1,67 @@
 /**
- * Value Protocol (Phase 4)
+ * Section 4: Value Protocol
  *
  * Explicit availability semantics for data.
  * Prevents fake values and blank panels.
+ *
+ * Hard rules:
+ * - AVAILABLE must include value
+ * - UNAVAILABLE/UNKNOWN must not include value
+ * - No other fields
  */
-export type ValueStatus = 'AVAILABLE' | 'UNAVAILABLE';
+export type Availability = "AVAILABLE" | "UNAVAILABLE" | "UNKNOWN";
 export type Value<T> = {
-    status: 'AVAILABLE';
-    data: T;
+    availability: "AVAILABLE";
+    value: T;
+} | {
+    availability: "UNAVAILABLE";
+    reason?: string;
+    nextAction?: string;
 } | {
-    status: 'UNAVAILABLE';
-    reason: string;
+    availability: "UNKNOWN";
+    reason?: string;
     nextAction?: string;
 };
 /**
  * Create an AVAILABLE value
  */
-export declare function available<T>(data: T): Value<T>;
+export declare function available<T>(value: T): Value<T>;
 /**
  * Create an UNAVAILABLE value
  */
-export declare function unavailable<T>(reason: string, nextAction?: string): Value<T>;
+export declare function unavailable<T>(reason?: string, nextAction?: string): Value<T>;
+/**
+ * Create an UNKNOWN value
+ */
+export declare function unknown<T>(reason?: string, nextAction?: string): Value<T>;
 /**
  * Type guard: check if value is AVAILABLE
  */
 export declare function isAvailable<T>(value: Value<T>): value is {
-    status: 'AVAILABLE';
-    data: T;
+    availability: "AVAILABLE";
+    value: T;
 };
 /**
  * Type guard: check if value is UNAVAILABLE
  */
 export declare function isUnavailable<T>(value: Value<T>): value is {
-    status: 'UNAVAILABLE';
-    reason: string;
+    availability: "UNAVAILABLE";
+    reason?: string;
+    nextAction?: string;
+};
+/**
+ * Type guard: check if value is UNKNOWN
+ */
+export declare function isUnknown<T>(value: Value<T>): value is {
+    availability: "UNKNOWN";
+    reason?: string;
     nextAction?: string;
 };
+/**
+ * Section 4: Shared helper to render Value<T>
+ *
+ * Handles AVAILABLE, UNAVAILABLE, and UNKNOWN states consistently
+ * Never renders empty string - always shows meaningful content
+ */
+export declare function renderValue<T>(v: Value<T>, renderAvailable: (t: T) => string): string;
 //# sourceMappingURL=value.d.ts.map

package/dist/ui/v3/state/value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../../../src/ui/v3/state/value.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;AAEtD,MAAM,MAAM,KAAK,CAAC,CAAC,IACf;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAChC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAE5E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAEzF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAEzH"}
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../../../src/ui/v3/state/value.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;AAEnE,MAAM,MAAM,KAAK,CAAC,CAAC,IACf;IAAE,YAAY,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACvC;IAAE,YAAY,EAAE,aAAa,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,YAAY,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAE7E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI;IAAE,YAAY,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAEhG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI;IAAE,YAAY,EAAE,aAAa,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAEhI;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI;IAAE,YAAY,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAExH;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EACX,eAAe,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,GAChC,MAAM,CAWR"}

package/dist/ui/v3/state/value.js

@@ -1,31 +1,64 @@
 /**
- * Value Protocol (Phase 4)
+ * Section 4: Value Protocol
  *
  * Explicit availability semantics for data.
  * Prevents fake values and blank panels.
+ *
+ * Hard rules:
+ * - AVAILABLE must include value
+ * - UNAVAILABLE/UNKNOWN must not include value
+ * - No other fields
  */
 /**
  * Create an AVAILABLE value
  */
-export function available(data) {
-    return { status: 'AVAILABLE', data };
+export function available(value) {
+    return { availability: "AVAILABLE", value };
 }
 /**
  * Create an UNAVAILABLE value
  */
 export function unavailable(reason, nextAction) {
-    return { status: 'UNAVAILABLE', reason, nextAction };
+    return { availability: "UNAVAILABLE", reason, nextAction };
+}
+/**
+ * Create an UNKNOWN value
+ */
+export function unknown(reason, nextAction) {
+    return { availability: "UNKNOWN", reason, nextAction };
 }
 /**
  * Type guard: check if value is AVAILABLE
  */
 export function isAvailable(value) {
-    return value.status === 'AVAILABLE';
+    return value.availability === "AVAILABLE";
 }
 /**
  * Type guard: check if value is UNAVAILABLE
  */
 export function isUnavailable(value) {
-    return value.status === 'UNAVAILABLE';
+    return value.availability === "UNAVAILABLE";
+}
+/**
+ * Type guard: check if value is UNKNOWN
+ */
+export function isUnknown(value) {
+    return value.availability === "UNKNOWN";
+}
+/**
+ * Section 4: Shared helper to render Value<T>
+ *
+ * Handles AVAILABLE, UNAVAILABLE, and UNKNOWN states consistently
+ * Never renders empty string - always shows meaningful content
+ */
+export function renderValue(v, renderAvailable) {
+    if (isAvailable(v)) {
+        return renderAvailable(v.value);
+    }
+    // UNAVAILABLE or UNKNOWN - render standard unavailable block
+    const reason = v.reason || "Not initialized";
+    const nextAction = v.nextAction || 'Run "help"';
+    const status = v.availability;
+    return `UNAVAILABLE\nReason: ${reason}\nNext: ${nextAction}`;
 }
 //# sourceMappingURL=value.js.map

package/dist/ui/v3/state/value.js.map

@@ -1 +1 @@
-{"version":3,"file":"value.js","sourceRoot":"","sources":["../../../../src/ui/v3/state/value.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;GAEG;AACH,MAAM,UAAU,SAAS,CAAI,IAAO;IAClC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAI,MAAc,EAAE,UAAmB;IAChE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAI,KAAe;IAC5C,OAAO,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,KAAe;IAC9C,OAAO,KAAK,CAAC,MAAM,KAAK,aAAa,CAAC;AACxC,CAAC"}
+{"version":3,"file":"value.js","sourceRoot":"","sources":["../../../../src/ui/v3/state/value.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH;;GAEG;AACH,MAAM,UAAU,SAAS,CAAI,KAAQ;IACnC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAI,MAAe,EAAE,UAAmB;IACjE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAI,MAAe,EAAE,UAAmB;IAC7D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAI,KAAe;IAC5C,OAAO,KAAK,CAAC,YAAY,KAAK,WAAW,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,KAAe;IAC9C,OAAO,KAAK,CAAC,YAAY,KAAK,aAAa,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAI,KAAe;IAC1C,OAAO,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,CAAW,EACX,eAAiC;IAEjC,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACnB,OAAO,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,6DAA6D;IAC7D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,iBAAiB,CAAC;IAC7C,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,IAAI,YAAY,CAAC;IAChD,MAAM,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC;IAE9B,OAAO,wBAAwB,MAAM,WAAW,UAAU,EAAE,CAAC;AAC/D,CAAC"}

package/dist/ui/v3/ui/panels/AssetsPanel.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Section 4: Assets Panel Renderer
+ *
+ * Renders the ASSETS panel content.
+ * Handles Value<AssetsState> correctly - no blank panels.
+ */
+import type { Value } from '../../state/value.js';
+import type { AssetsState } from '../../state/uiStateTypes.js';
+/**
+ * Render Assets panel content
+ *
+ * Returns array of lines
+ * Uses renderValue helper for consistent UNAVAILABLE/UNKNOWN handling
+ */
+export declare function renderAssetsPanel(value: Value<AssetsState>): string[];
+//# sourceMappingURL=AssetsPanel.d.ts.map

package/dist/ui/v3/ui/panels/AssetsPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetsPanel.d.ts","sourceRoot":"","sources":["../../../../../src/ui/v3/ui/panels/AssetsPanel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAe/D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,MAAM,EAAE,CAGrE"}

package/dist/ui/v3/ui/panels/AssetsPanel.js

@@ -0,0 +1,29 @@
+/**
+ * Section 4: Assets Panel Renderer
+ *
+ * Renders the ASSETS panel content.
+ * Handles Value<AssetsState> correctly - no blank panels.
+ */
+import { renderValue } from '../../state/value.js';
+/**
+ * Render Assets panel content when AVAILABLE
+ */
+function renderAvailable(data) {
+    const lines = [];
+    lines.push(`Total: ${data.total}`);
+    lines.push(`Active: ${data.active}`);
+    lines.push(`Idle: ${data.idle}`);
+    lines.push(`Error: ${data.error}`);
+    return lines.join('\n');
+}
+/**
+ * Render Assets panel content
+ *
+ * Returns array of lines
+ * Uses renderValue helper for consistent UNAVAILABLE/UNKNOWN handling
+ */
+export function renderAssetsPanel(value) {
+    const content = renderValue(value, renderAvailable);
+    return content.split('\n');
+}
+//# sourceMappingURL=AssetsPanel.js.map

package/dist/ui/v3/ui/panels/AssetsPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetsPanel.js","sourceRoot":"","sources":["../../../../../src/ui/v3/ui/panels/AssetsPanel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,SAAS,eAAe,CAAC,IAAiB;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/ui/v3/ui/panels/CapabilitiesPanel.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Section 4: Capabilities Panel Renderer
+ *
+ * Renders the CAPABILITIES panel content.
+ * Handles Value<CapabilitiesState> correctly - no blank panels.
+ */
+import type { Value } from '../../state/value.js';
+import type { CapabilitiesState } from '../../state/uiStateTypes.js';
+/**
+ * Render Capabilities panel content
+ *
+ * Returns array of lines
+ * Uses renderValue helper for consistent UNAVAILABLE/UNKNOWN handling
+ */
+export declare function renderCapabilitiesPanel(value: Value<CapabilitiesState>): string[];
+//# sourceMappingURL=CapabilitiesPanel.d.ts.map

package/dist/ui/v3/ui/panels/CapabilitiesPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilitiesPanel.d.ts","sourceRoot":"","sources":["../../../../../src/ui/v3/ui/panels/CapabilitiesPanel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAarE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,CAAC,iBAAiB,CAAC,GAAG,MAAM,EAAE,CAGjF"}

package/dist/ui/v3/ui/panels/CapabilitiesPanel.js

@@ -0,0 +1,27 @@
+/**
+ * Section 4: Capabilities Panel Renderer
+ *
+ * Renders the CAPABILITIES panel content.
+ * Handles Value<CapabilitiesState> correctly - no blank panels.
+ */
+import { renderValue } from '../../state/value.js';
+/**
+ * Render Capabilities panel content when AVAILABLE
+ */
+function renderAvailable(data) {
+    if (data.items.length === 0) {
+        return 'No capabilities';
+    }
+    return data.items.join('\n');
+}
+/**
+ * Render Capabilities panel content
+ *
+ * Returns array of lines
+ * Uses renderValue helper for consistent UNAVAILABLE/UNKNOWN handling
+ */
+export function renderCapabilitiesPanel(value) {
+    const content = renderValue(value, renderAvailable);
+    return content.split('\n');
+}
+//# sourceMappingURL=CapabilitiesPanel.js.map

package/dist/ui/v3/ui/panels/CapabilitiesPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilitiesPanel.js","sourceRoot":"","sources":["../../../../../src/ui/v3/ui/panels/CapabilitiesPanel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,SAAS,eAAe,CAAC,IAAuB;IAC9C,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAA+B;IACrE,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/ui/v3/ui/panels/NetworkPanel.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Section 4: Network Panel Renderer
+ *
+ * Renders the NETWORK panel content.
+ * Handles Value<NetworkState> correctly - no blank panels.
+ */
+import type { Value } from '../../state/value.js';
+import type { NetworkState } from '../../state/uiStateTypes.js';
+/**
+ * Render Network panel content
+ *
+ * Returns array of lines
+ * Uses renderValue helper for consistent UNAVAILABLE/UNKNOWN handling
+ */
+export declare function renderNetworkPanel(value: Value<NetworkState>): string[];
+//# sourceMappingURL=NetworkPanel.d.ts.map

package/dist/ui/v3/ui/panels/NetworkPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkPanel.d.ts","sourceRoot":"","sources":["../../../../../src/ui/v3/ui/panels/NetworkPanel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAUhE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,MAAM,EAAE,CAGvE"}

package/dist/ui/v3/ui/panels/NetworkPanel.js

@@ -0,0 +1,24 @@
+/**
+ * Section 4: Network Panel Renderer
+ *
+ * Renders the NETWORK panel content.
+ * Handles Value<NetworkState> correctly - no blank panels.
+ */
+import { renderValue } from '../../state/value.js';
+/**
+ * Render Network panel content when AVAILABLE
+ */
+function renderAvailable(data) {
+    return `Gateway: ${data.gateway}`;
+}
+/**
+ * Render Network panel content
+ *
+ * Returns array of lines
+ * Uses renderValue helper for consistent UNAVAILABLE/UNKNOWN handling
+ */
+export function renderNetworkPanel(value) {
+    const content = renderValue(value, renderAvailable);
+    return content.split('\n');
+}
+//# sourceMappingURL=NetworkPanel.js.map

package/dist/ui/v3/ui/panels/NetworkPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkPanel.js","sourceRoot":"","sources":["../../../../../src/ui/v3/ui/panels/NetworkPanel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,SAAS,eAAe,CAAC,IAAkB;IACzC,OAAO,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA0B;IAC3D,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/ui/v3/ui/panels/PosturePanel.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Section 4: Posture Panel Renderer
+ *
+ * Renders the POSTURE panel content.
+ * Handles Value<PostureState> correctly - no blank panels.
+ */
+import type { Value } from '../../state/value.js';
+import type { PostureState } from '../../state/uiStateTypes.js';
+/**
+ * Render Posture panel content
+ *
+ * Returns array of lines
+ * Uses renderValue helper for consistent UNAVAILABLE/UNKNOWN handling
+ */
+export declare function renderPosturePanel(value: Value<PostureState>): string[];
+//# sourceMappingURL=PosturePanel.d.ts.map

package/dist/ui/v3/ui/panels/PosturePanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PosturePanel.d.ts","sourceRoot":"","sources":["../../../../../src/ui/v3/ui/panels/PosturePanel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAUhE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,MAAM,EAAE,CAGvE"}

package/dist/ui/v3/ui/panels/PosturePanel.js

@@ -0,0 +1,24 @@
+/**
+ * Section 4: Posture Panel Renderer
+ *
+ * Renders the POSTURE panel content.
+ * Handles Value<PostureState> correctly - no blank panels.
+ */
+import { renderValue } from '../../state/value.js';
+/**
+ * Render Posture panel content when AVAILABLE
+ */
+function renderAvailable(data) {
+    return `MODE: ${data.mode}`;
+}
+/**
+ * Render Posture panel content
+ *
+ * Returns array of lines
+ * Uses renderValue helper for consistent UNAVAILABLE/UNKNOWN handling
+ */
+export function renderPosturePanel(value) {
+    const content = renderValue(value, renderAvailable);
+    return content.split('\n');
+}
+//# sourceMappingURL=PosturePanel.js.map

package/dist/ui/v3/ui/panels/PosturePanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PosturePanel.js","sourceRoot":"","sources":["../../../../../src/ui/v3/ui/panels/PosturePanel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,SAAS,eAAe,CAAC,IAAkB;IACzC,OAAO,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA0B;IAC3D,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/ui/v3/ui/panels/ResourcesPanel.d.ts

@@ -1,16 +1,19 @@
 /**
- * Resources Panel Renderer (Phase 4)
+ * Section 4: Resources Panel Renderer
  *
  * Renders the RESOURCES panel content.
+ * Handles Value<ResourcesState> correctly - no blank panels.
  * Line-budgeted, truncation-safe.
  */
 import type { Value } from '../../state/value.js';
-import type { ResourcesData } from '../../state/resourcesData.js';
+import type { ResourcesState } from '../../state/uiStateTypes.js';
 /**
  * Render Resources panel content
  *
  * Returns array of lines (max ~6 lines)
  * Lines will be truncated to panel width in updateResourcesPanel()
+ *
+ * Section 4: Uses renderValue helper for consistent UNAVAILABLE/UNKNOWN handling
  */
-export declare function renderResourcesPanel(value: Value<ResourcesData>): string[];
+export declare function renderResourcesPanel(value: Value<ResourcesState>): string[];
 //# sourceMappingURL=ResourcesPanel.d.ts.map