@sero-ai/app-runtime 0.1.1 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sero-ai/app-runtime",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Hooks for Sero federated app modules — useAppState, useAppInfo, useAgentPrompt, useAppTools",
   "type": "module",
   "main": "./src/index.ts",
@@ -20,10 +20,11 @@
     "access": "public"
   },
   "peerDependencies": {
-    "react": ">=19.0.0"
+    "@sero-ai/common": ">=0.3.1",
+    "react": "^19.2.4"
   },
   "devDependencies": {
-    "@sero/common": "^0.1.0",
+    "@sero-ai/common": "workspace:*",
     "@types/react": "^19.2.13",
     "typescript": "^5.9.3"
   }

package/src/index.ts

@@ -15,7 +15,7 @@ export { useAvailableModels, type UseAvailableModelsResult } from './use-availab
 export { useTheme, type UseThemeResult } from './use-theme';
 export { getSeroApi } from './sero-bridge';
 export type { AppModelInfo, AppModelGroup } from './sero-bridge';
-export type { AppToolContentBlock, AppToolImageContent, AppToolResult, AppToolTextContent } from '@sero/common';
+export type { AppToolContentBlock, AppToolImageContent, AppToolResult, AppToolTextContent } from '@sero-ai/common';
 export { registerWidget, getRuntimeWidgets, onWidgetRegistryChange } from './widget-registry';
 export type { RuntimeWidget } from './widget-registry';
 export { useWidgetRegistration } from './use-widget-registration';

package/src/sero-bridge.ts

@@ -15,7 +15,7 @@ import type {
   SharedModelInfo,
   WebAppActionResult,
   WebAppRequest,
-} from '@sero/common';
+} from '@sero-ai/common';
 
 export interface SeroWindowAppStateBridge {
   read<TData = unknown>(filePath: string): Promise<TData>;

package/src/use-app-state.ts

@@ -16,6 +16,33 @@ import { getSeroApi, type SeroWindowAppStateBridge } from './sero-bridge';
  * @param defaultState — returned while the file is being read (or if missing)
  * @returns [state, updateState] — updateState accepts an updater function
  */
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function normalizeStateValue(defaultValue: unknown, currentValue: unknown): unknown {
+  if (Array.isArray(defaultValue)) {
+    return Array.isArray(currentValue) ? currentValue : defaultValue;
+  }
+
+  if (isPlainObject(defaultValue)) {
+    if (!isPlainObject(currentValue)) return defaultValue;
+    const merged: Record<string, unknown> = { ...currentValue };
+    for (const [key, childDefault] of Object.entries(defaultValue)) {
+      merged[key] = normalizeStateValue(childDefault, currentValue[key]);
+    }
+    return merged;
+  }
+
+  if (currentValue === undefined) return defaultValue;
+  if (defaultValue === null) return currentValue ?? null;
+  return typeof currentValue === typeof defaultValue ? currentValue : defaultValue;
+}
+
+function applyDefaultState<T>(defaultState: T, current: unknown): T {
+  return normalizeStateValue(defaultState, current) as T;
+}
+
 export function useAppState<T>(defaultState: T): [T, (updater: (prev: T) => T) => void] {
   const ctx = useContext(AppContext);
   if (!ctx) {
@@ -43,7 +70,7 @@ export function useAppState<T>(defaultState: T): [T, (updater: (prev: T) => T) =
       try {
         const current = await api.read<T | null>(stateFilePath);
         if (writeId !== latestWriteIdRef.current) return;
-        applyState(current ?? fallbackState);
+        applyState(current == null ? fallbackState : applyDefaultState(fallbackState, current));
       } catch {
         if (writeId !== latestWriteIdRef.current) return;
         applyState(fallbackState);
@@ -65,12 +92,12 @@ export function useAppState<T>(defaultState: T): [T, (updater: (prev: T) => T) =
 
     const unsubscribe = api.appState.onChange<T | null>((filePath, data) => {
       if (filePath !== stateFilePath || data == null) return;
-      applyIfActive(data);
+      applyIfActive(applyDefaultState(defaultStateRef.current, data));
     });
 
     void api.appState.watch<T | null>(stateFilePath).then((current) => {
       if (current == null) return;
-      applyIfActive(current);
+      applyIfActive(applyDefaultState(defaultStateRef.current, current));
     });
 
     return () => {

package/src/use-app-tools.ts

@@ -1,4 +1,4 @@
-import type { AppToolResult } from '@sero/common';
+import type { AppToolResult } from '@sero-ai/common';
 import { useCallback, useContext, useMemo } from 'react';
 
 import { AppContext } from './context';