@glassly/engine 0.3.5-beta.760 → 0.3.5-beta.775

package/build/services/widgetPlacements.js

@@ -2,8 +2,8 @@
  * Who placed which widget where: the pure bookkeeping behind the runtime's
  * widget routing. A placement is one host's box for one provider widget;
  * a provider is placed while any host holds one of its widgets. Frames are
- * kept per widget so a host that places one again gets the last frame
- * at once.
+ * kept per widget and view so a host that places one again gets the last
+ * card and expanded frames at once.
  */
 export const widgetKey = (providerPackageName, widgetId) => `${providerPackageName}/${widgetId}`;
 const placementKey = (hostPackageName, providerPackageName, widgetId) => `${hostPackageName}|${widgetKey(providerPackageName, widgetId)}`;
@@ -41,13 +41,14 @@ export function dropProvider(state, providerPackageName) {
     }
     return placements.size === state.placements.size ? state : { ...state, placements };
 }
-export function setFrame(state, providerPackageName, widgetId, elements) {
+export function setFrame(state, providerPackageName, widgetId, elements, view = "card") {
+    const key = widgetKey(providerPackageName, widgetId);
     const frames = new Map(state.frames);
-    frames.set(widgetKey(providerPackageName, widgetId), elements);
+    frames.set(key, { ...state.frames.get(key), [view]: elements });
     return { ...state, frames };
 }
-export function frameOf(state, providerPackageName, widgetId) {
-    return state.frames.get(widgetKey(providerPackageName, widgetId)) ?? null;
+export function frameOf(state, providerPackageName, widgetId, view = "card") {
+    return state.frames.get(widgetKey(providerPackageName, widgetId))?.[view] ?? null;
 }
 export function placementOf(state, hostPackageName, providerPackageName, widgetId) {
     return state.placements.get(placementKey(hostPackageName, providerPackageName, widgetId)) ?? null;

package/build/services/widgetPlacements.js.map

@@ -1 +1 @@
-{"version":3,"file":"widgetPlacements.js","sourceRoot":"","sources":["../../src/services/widgetPlacements.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Who placed which widget where: the pure bookkeeping behind the runtime's\n * widget routing. A placement is one host's box for one provider widget;\n * a provider is placed while any host holds one of its widgets. Frames are\n * kept per widget so a host that places one again gets the last frame\n * at once.\n */\n\nexport interface WidgetBox {\n  size: \"XS\" | \"SM\" | \"MD\" | \"LG\"\n  width: number\n  height: number\n}\n\nexport interface Placement {\n  hostPackageName: string\n  providerPackageName: string\n  widgetId: string\n  box: WidgetBox\n}\n\nexport interface WidgetPlacements {\n  /** Keyed by `${host}|${provider}/${widgetId}`. */\n  placements: ReadonlyMap<string, Placement>\n  /** The latest frame per `${provider}/${widgetId}`. */\n  frames: ReadonlyMap<string, unknown[]>\n}\n\nexport const widgetKey = (providerPackageName: string, widgetId: string): string => `${providerPackageName}/${widgetId}`\nconst placementKey = (hostPackageName: string, providerPackageName: string, widgetId: string): string =>\n  `${hostPackageName}|${widgetKey(providerPackageName, widgetId)}`\n\nexport function emptyWidgetPlacements(): WidgetPlacements {\n  return {placements: new Map(), frames: new Map()}\n}\n\nexport function placeWidget(state: WidgetPlacements, placement: Placement): WidgetPlacements {\n  const placements = new Map(state.placements)\n  placements.set(placementKey(placement.hostPackageName, placement.providerPackageName, placement.widgetId), placement)\n  return {...state, placements}\n}\n\nexport function unplaceWidget(\n  state: WidgetPlacements,\n  hostPackageName: string,\n  providerPackageName: string,\n  widgetId: string,\n): WidgetPlacements {\n  const key = placementKey(hostPackageName, providerPackageName, widgetId)\n  if (!state.placements.has(key)) return state\n  const placements = new Map(state.placements)\n  placements.delete(key)\n  return {...state, placements}\n}\n\n/** A host went away: drop everything it placed. */\nexport function dropHost(state: WidgetPlacements, hostPackageName: string): WidgetPlacements {\n  const placements = new Map(state.placements)\n  for (const [key, placement] of state.placements) {\n    if (placement.hostPackageName === hostPackageName) placements.delete(key)\n  }\n  return placements.size === state.placements.size ? state : {...state, placements}\n}\n\n/** A provider went away: drop its placements, keep its frames for the placeholder. */\nexport function dropProvider(state: WidgetPlacements, providerPackageName: string): WidgetPlacements {\n  const placements = new Map(state.placements)\n  for (const [key, placement] of state.placements) {\n    if (placement.providerPackageName === providerPackageName) placements.delete(key)\n  }\n  return placements.size === state.placements.size ? state : {...state, placements}\n}\n\nexport function setFrame(state: WidgetPlacements, providerPackageName: string, widgetId: string, elements: unknown[]): WidgetPlacements {\n  const frames = new Map(state.frames)\n  frames.set(widgetKey(providerPackageName, widgetId), elements)\n  return {...state, frames}\n}\n\nexport function frameOf(state: WidgetPlacements, providerPackageName: string, widgetId: string): unknown[] | null {\n  return state.frames.get(widgetKey(providerPackageName, widgetId)) ?? null\n}\n\nexport function placementOf(\n  state: WidgetPlacements,\n  hostPackageName: string,\n  providerPackageName: string,\n  widgetId: string,\n): Placement | null {\n  return state.placements.get(placementKey(hostPackageName, providerPackageName, widgetId)) ?? null\n}\n\n/** Hosts holding this widget, each once. */\nexport function hostsOf(state: WidgetPlacements, providerPackageName: string, widgetId: string): string[] {\n  const hosts = new Set<string>()\n  for (const placement of state.placements.values()) {\n    if (placement.providerPackageName === providerPackageName && placement.widgetId === widgetId) {\n      hosts.add(placement.hostPackageName)\n    }\n  }\n  return Array.from(hosts)\n}\n\n/** Providers with at least one widget placed. */\nexport function placedProviders(state: WidgetPlacements): Set<string> {\n  const providers = new Set<string>()\n  for (const placement of state.placements.values()) providers.add(placement.providerPackageName)\n  return providers\n}\n\nexport function isProviderPlaced(state: WidgetPlacements, providerPackageName: string): boolean {\n  for (const placement of state.placements.values()) {\n    if (placement.providerPackageName === providerPackageName) return true\n  }\n  return false\n}\n\n/** The placements a host holds on a provider, for re-delivering boxes. */\nexport function placementsBy(state: WidgetPlacements, hostPackageName: string): Placement[] {\n  return Array.from(state.placements.values()).filter((placement) => placement.hostPackageName === hostPackageName)\n}\n"]}
+{"version":3,"file":"widgetPlacements.js","sourceRoot":"","sources":["../../src/services/widgetPlacements.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Who placed which widget where: the pure bookkeeping behind the runtime's\n * widget routing. A placement is one host's box for one provider widget;\n * a provider is placed while any host holds one of its widgets. Frames are\n * kept per widget and view so a host that places one again gets the last\n * card and expanded frames at once.\n */\n\nexport type WidgetView = \"card\" | \"expanded\"\n\nexport interface WidgetBox {\n  size: \"XS\" | \"XSM\" | \"SM\" | \"MD\" | \"LG\"\n  width: number\n  height: number\n}\n\nexport interface Placement {\n  hostPackageName: string\n  providerPackageName: string\n  widgetId: string\n  box: WidgetBox\n}\n\nexport interface WidgetPlacements {\n  /** Keyed by `${host}|${provider}/${widgetId}`. */\n  placements: ReadonlyMap<string, Placement>\n  /** The latest frame per `${provider}/${widgetId}` and view. */\n  frames: ReadonlyMap<string, Readonly<Partial<Record<WidgetView, unknown[]>>>>\n}\n\nexport const widgetKey = (providerPackageName: string, widgetId: string): string => `${providerPackageName}/${widgetId}`\nconst placementKey = (hostPackageName: string, providerPackageName: string, widgetId: string): string =>\n  `${hostPackageName}|${widgetKey(providerPackageName, widgetId)}`\n\nexport function emptyWidgetPlacements(): WidgetPlacements {\n  return {placements: new Map(), frames: new Map()}\n}\n\nexport function placeWidget(state: WidgetPlacements, placement: Placement): WidgetPlacements {\n  const placements = new Map(state.placements)\n  placements.set(placementKey(placement.hostPackageName, placement.providerPackageName, placement.widgetId), placement)\n  return {...state, placements}\n}\n\nexport function unplaceWidget(\n  state: WidgetPlacements,\n  hostPackageName: string,\n  providerPackageName: string,\n  widgetId: string,\n): WidgetPlacements {\n  const key = placementKey(hostPackageName, providerPackageName, widgetId)\n  if (!state.placements.has(key)) return state\n  const placements = new Map(state.placements)\n  placements.delete(key)\n  return {...state, placements}\n}\n\n/** A host went away: drop everything it placed. */\nexport function dropHost(state: WidgetPlacements, hostPackageName: string): WidgetPlacements {\n  const placements = new Map(state.placements)\n  for (const [key, placement] of state.placements) {\n    if (placement.hostPackageName === hostPackageName) placements.delete(key)\n  }\n  return placements.size === state.placements.size ? state : {...state, placements}\n}\n\n/** A provider went away: drop its placements, keep its frames for the placeholder. */\nexport function dropProvider(state: WidgetPlacements, providerPackageName: string): WidgetPlacements {\n  const placements = new Map(state.placements)\n  for (const [key, placement] of state.placements) {\n    if (placement.providerPackageName === providerPackageName) placements.delete(key)\n  }\n  return placements.size === state.placements.size ? state : {...state, placements}\n}\n\nexport function setFrame(\n  state: WidgetPlacements,\n  providerPackageName: string,\n  widgetId: string,\n  elements: unknown[],\n  view: WidgetView = \"card\",\n): WidgetPlacements {\n  const key = widgetKey(providerPackageName, widgetId)\n  const frames = new Map(state.frames)\n  frames.set(key, {...state.frames.get(key), [view]: elements})\n  return {...state, frames}\n}\n\nexport function frameOf(\n  state: WidgetPlacements,\n  providerPackageName: string,\n  widgetId: string,\n  view: WidgetView = \"card\",\n): unknown[] | null {\n  return state.frames.get(widgetKey(providerPackageName, widgetId))?.[view] ?? null\n}\n\nexport function placementOf(\n  state: WidgetPlacements,\n  hostPackageName: string,\n  providerPackageName: string,\n  widgetId: string,\n): Placement | null {\n  return state.placements.get(placementKey(hostPackageName, providerPackageName, widgetId)) ?? null\n}\n\n/** Hosts holding this widget, each once. */\nexport function hostsOf(state: WidgetPlacements, providerPackageName: string, widgetId: string): string[] {\n  const hosts = new Set<string>()\n  for (const placement of state.placements.values()) {\n    if (placement.providerPackageName === providerPackageName && placement.widgetId === widgetId) {\n      hosts.add(placement.hostPackageName)\n    }\n  }\n  return Array.from(hosts)\n}\n\n/** Providers with at least one widget placed. */\nexport function placedProviders(state: WidgetPlacements): Set<string> {\n  const providers = new Set<string>()\n  for (const placement of state.placements.values()) providers.add(placement.providerPackageName)\n  return providers\n}\n\nexport function isProviderPlaced(state: WidgetPlacements, providerPackageName: string): boolean {\n  for (const placement of state.placements.values()) {\n    if (placement.providerPackageName === providerPackageName) return true\n  }\n  return false\n}\n\n/** The placements a host holds on a provider, for re-delivering boxes. */\nexport function placementsBy(state: WidgetPlacements, hostPackageName: string): Placement[] {\n  return Array.from(state.placements.values()).filter((placement) => placement.hostPackageName === hostPackageName)\n}\n"]}

package/build/types/applet.d.ts

@@ -81,13 +81,15 @@ export interface DeclaredAction {
      */
     visibility?: "public" | "system";
 }
-export type DeclaredWidgetSize = "XS" | "SM" | "MD" | "LG";
+export type DeclaredWidgetSize = "XS" | "XSM" | "SM" | "MD" | "LG";
 /** A dashboard widget a miniapp declares in `miniapp.json` and serves through `session.widgets`. */
 export interface DeclaredWidget {
     id: string;
     name: string;
     sizes: DeclaredWidgetSize[];
     defaultSize: DeclaredWidgetSize;
+    /** A tap on the selected widget expands it to the full screen instead of activating the card. */
+    expandable: boolean;
 }
 export interface ClientApp extends AppletInterface {
     offline: boolean;

package/build/types/applet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"applet.d.ts","sourceRoot":"","sources":["../../src/types/applet.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"applet.d.ts","sourceRoot":"","sources":["../../src/types/applet.ts"],"names":[],"mappings":"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"}

package/build/types/applet.js.map

@@ -1 +1 @@
-{"version":3,"file":"applet.js","sourceRoot":"","sources":["../../src/types/applet.ts"],"names":[],"mappings":"","sourcesContent":["import type {ManifestPermissionType} from \"@glassly/miniapp/manifest\"\nimport type {ReactNode} from \"react\"\n/**\n * App and miniapp types owned by @glassly/engine.\n */\n\nimport {HardwareRequirement} from \"./hardware\"\n\nimport type {CompatibilityResult} from \"../utils/hardware/hardware\"\n\n/**\n * App execution model types\n */\nexport type AppletType = \"standard\" | \"background\" | \"dashboard\"\n\n/**\n * Permission types that apps can request: the manifest vocabulary from the\n * SDK (the single source the CLI validator reads too) plus the host-only ALL.\n */\nexport type AppPermissionType = \"ALL\" | ManifestPermissionType\n\n/**\n * Permission object with type and description\n */\nexport interface AppletPermission {\n  type: AppPermissionType\n  description?: string\n  required?: boolean\n}\n\n/**\n * Minimal app interface for client home screen display\n * Optimized for fast rendering - only essential fields\n *\n * This is the client-facing interface used by mobile apps.\n * Internal cloud services use AppI from models (more fields).\n */\nexport interface AppletInterface {\n  packageName: string\n  name: string\n  webviewUrl: string\n  logoUrl: string\n  iconComponent?: ReactNode\n  type: AppletType\n  permissions: AppletPermission[]\n  running: boolean\n  /**\n   * True while this app's UI WebView is mounted in the Compositor overlay.\n   * At most one app is foregrounded at a time. Distinct from `running`:\n   * a foregrounded app is always running, but a running app may be\n   * backgrounded (JSContext alive, WebView torn down). Normalized to a\n   * concrete boolean by the apps store's projectApps; literal call sites\n   * may omit it.\n   */\n  foregrounded?: boolean\n  healthy: boolean\n  hardwareRequirements: HardwareRequirement[]\n  /** ISO date string when the app was installed */\n  installedDate?: string\n  /** ISO date string when the app was last run. Undefined if never run (app is \"new\") */\n  lastActiveAt?: string\n}\n\n/**\n * Runtime applet shape used by the engine apps store and OEM hosts.\n *\n * Extends AppletInterface with the host-side fields the manager / OEM tracks\n * outside the manifest: offline routing, hardware compatibility result,\n * loading/hidden/local flags, lifecycle hooks, screenshot, and the\n * dev-miniapp escape hatches (`devUrl` / `isMiniappDev`) that surface a\n * `glassly dev` snapshot.\n */\n/**\n * A manifest-declared action a miniapp exposes for other miniapps to invoke\n * via `session.actions`. Populated from `miniapp.json`'s `actions` field.\n * Shape maps 1:1 onto an MCP tool (id→name, description, parameters→inputSchema).\n */\nexport interface DeclaredAction {\n  id: string\n  description: string\n  /** JSON-Schema input descriptor (MCP-compatible subset). */\n  parameters?: Record<string, unknown>\n  /** JSON-Schema descriptor for the action's structured result. */\n  outputSchema?: Record<string, unknown>\n  /**\n   * Who may invoke the action: \"public\" (default — any installed miniapp) or\n   * \"system\" (system miniapps such as the AI assistant only).\n   */\n  visibility?: \"public\" | \"system\"\n}\n\nexport type DeclaredWidgetSize = \"XS\" | \"SM\" | \"MD\" | \"LG\"\n\n/** A dashboard widget a miniapp declares in `miniapp.json` and serves through `session.widgets`. */\nexport interface DeclaredWidget {\n  id: string\n  name: string\n  sizes: DeclaredWidgetSize[]\n  defaultSize: DeclaredWidgetSize\n}\n\nexport interface ClientApp extends AppletInterface {\n  offline: boolean\n  offlineRoute: string\n  compatibility?: CompatibilityResult\n  loading: boolean\n  local: boolean\n  hidden: boolean\n  /**\n   * Always On miniapp: the host starts it at launch and it only stops from\n   * the app switcher's Always On pill; its card cannot be swiped away and\n   * the capsule close minimizes it. Manifest `alwaysOn` gives the default;\n   * the wearer's choice persists beside the hidden flag.\n   */\n  alwaysOn?: boolean\n  /** Running, but paused while the paired glasses are disconnected (MiniappPauseCoordinator). */\n  paused?: boolean\n  onStart?: () => void\n  onStop?: () => void\n  screenshot?: string\n  runtimePermissions?: string[]\n  declaredPermissions?: string[]\n  version?: string\n  /** Manifest `description`: the paragraph the store and the info page show. */\n  description?: string\n  /** Manifest `tagline`: one line under the name. */\n  tagline?: string\n  /** Manifest `tags`: lowercase store tag slugs. */\n  tags?: string[]\n  needsPcm?: boolean\n  needsTranscript?: boolean\n  devUrl?: string\n  devPort?: number\n  isMiniappDev?: boolean\n  /** Manifest-declared actions (for session.miniapps.list + invoke gating). */\n  actions?: DeclaredAction[]\n  /** Manifest-declared dashboard widgets. */\n  widgets?: DeclaredWidget[]\n  /**\n   * Running only because a host placed one of its widgets: no card in the\n   * app switcher, no frame of its own on the glasses. Opening the app from\n   * the home screen promotes it to a normal run.\n   */\n  widgetOnly?: boolean\n}\n"]}
+{"version":3,"file":"applet.js","sourceRoot":"","sources":["../../src/types/applet.ts"],"names":[],"mappings":"","sourcesContent":["import type {ManifestPermissionType} from \"@glassly/miniapp/manifest\"\nimport type {ReactNode} from \"react\"\n/**\n * App and miniapp types owned by @glassly/engine.\n */\n\nimport {HardwareRequirement} from \"./hardware\"\n\nimport type {CompatibilityResult} from \"../utils/hardware/hardware\"\n\n/**\n * App execution model types\n */\nexport type AppletType = \"standard\" | \"background\" | \"dashboard\"\n\n/**\n * Permission types that apps can request: the manifest vocabulary from the\n * SDK (the single source the CLI validator reads too) plus the host-only ALL.\n */\nexport type AppPermissionType = \"ALL\" | ManifestPermissionType\n\n/**\n * Permission object with type and description\n */\nexport interface AppletPermission {\n  type: AppPermissionType\n  description?: string\n  required?: boolean\n}\n\n/**\n * Minimal app interface for client home screen display\n * Optimized for fast rendering - only essential fields\n *\n * This is the client-facing interface used by mobile apps.\n * Internal cloud services use AppI from models (more fields).\n */\nexport interface AppletInterface {\n  packageName: string\n  name: string\n  webviewUrl: string\n  logoUrl: string\n  iconComponent?: ReactNode\n  type: AppletType\n  permissions: AppletPermission[]\n  running: boolean\n  /**\n   * True while this app's UI WebView is mounted in the Compositor overlay.\n   * At most one app is foregrounded at a time. Distinct from `running`:\n   * a foregrounded app is always running, but a running app may be\n   * backgrounded (JSContext alive, WebView torn down). Normalized to a\n   * concrete boolean by the apps store's projectApps; literal call sites\n   * may omit it.\n   */\n  foregrounded?: boolean\n  healthy: boolean\n  hardwareRequirements: HardwareRequirement[]\n  /** ISO date string when the app was installed */\n  installedDate?: string\n  /** ISO date string when the app was last run. Undefined if never run (app is \"new\") */\n  lastActiveAt?: string\n}\n\n/**\n * Runtime applet shape used by the engine apps store and OEM hosts.\n *\n * Extends AppletInterface with the host-side fields the manager / OEM tracks\n * outside the manifest: offline routing, hardware compatibility result,\n * loading/hidden/local flags, lifecycle hooks, screenshot, and the\n * dev-miniapp escape hatches (`devUrl` / `isMiniappDev`) that surface a\n * `glassly dev` snapshot.\n */\n/**\n * A manifest-declared action a miniapp exposes for other miniapps to invoke\n * via `session.actions`. Populated from `miniapp.json`'s `actions` field.\n * Shape maps 1:1 onto an MCP tool (id→name, description, parameters→inputSchema).\n */\nexport interface DeclaredAction {\n  id: string\n  description: string\n  /** JSON-Schema input descriptor (MCP-compatible subset). */\n  parameters?: Record<string, unknown>\n  /** JSON-Schema descriptor for the action's structured result. */\n  outputSchema?: Record<string, unknown>\n  /**\n   * Who may invoke the action: \"public\" (default — any installed miniapp) or\n   * \"system\" (system miniapps such as the AI assistant only).\n   */\n  visibility?: \"public\" | \"system\"\n}\n\nexport type DeclaredWidgetSize = \"XS\" | \"XSM\" | \"SM\" | \"MD\" | \"LG\"\n\n/** A dashboard widget a miniapp declares in `miniapp.json` and serves through `session.widgets`. */\nexport interface DeclaredWidget {\n  id: string\n  name: string\n  sizes: DeclaredWidgetSize[]\n  defaultSize: DeclaredWidgetSize\n  /** A tap on the selected widget expands it to the full screen instead of activating the card. */\n  expandable: boolean\n}\n\nexport interface ClientApp extends AppletInterface {\n  offline: boolean\n  offlineRoute: string\n  compatibility?: CompatibilityResult\n  loading: boolean\n  local: boolean\n  hidden: boolean\n  /**\n   * Always On miniapp: the host starts it at launch and it only stops from\n   * the app switcher's Always On pill; its card cannot be swiped away and\n   * the capsule close minimizes it. Manifest `alwaysOn` gives the default;\n   * the wearer's choice persists beside the hidden flag.\n   */\n  alwaysOn?: boolean\n  /** Running, but paused while the paired glasses are disconnected (MiniappPauseCoordinator). */\n  paused?: boolean\n  onStart?: () => void\n  onStop?: () => void\n  screenshot?: string\n  runtimePermissions?: string[]\n  declaredPermissions?: string[]\n  version?: string\n  /** Manifest `description`: the paragraph the store and the info page show. */\n  description?: string\n  /** Manifest `tagline`: one line under the name. */\n  tagline?: string\n  /** Manifest `tags`: lowercase store tag slugs. */\n  tags?: string[]\n  needsPcm?: boolean\n  needsTranscript?: boolean\n  devUrl?: string\n  devPort?: number\n  isMiniappDev?: boolean\n  /** Manifest-declared actions (for session.miniapps.list + invoke gating). */\n  actions?: DeclaredAction[]\n  /** Manifest-declared dashboard widgets. */\n  widgets?: DeclaredWidget[]\n  /**\n   * Running only because a host placed one of its widgets: no card in the\n   * app switcher, no frame of its own on the glasses. Opening the app from\n   * the home screen promotes it to a normal run.\n   */\n  widgetOnly?: boolean\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glassly/engine",
-  "version": "0.3.5-beta.760",
+  "version": "0.3.5-beta.775",
   "description": "Glassly Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -97,17 +97,17 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@glassly/bluetooth-sdk": "0.3.5-beta.760",
-    "@glassly/cloud-client": "0.3.5-beta.760",
-    "@glassly/cloud-protocol": "0.3.5-beta.760",
-    "@glassly/crust": "0.3.5-beta.760",
-    "@glassly/miniapp": "0.3.5-beta.760",
+    "@glassly/bluetooth-sdk": "0.3.5-beta.775",
+    "@glassly/cloud-client": "0.3.5-beta.775",
+    "@glassly/cloud-protocol": "0.3.5-beta.775",
+    "@glassly/crust": "0.3.5-beta.775",
+    "@glassly/miniapp": "0.3.5-beta.775",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
     "react-native-marked": "8.1.1",
     "semver": "^7.7.4",
     "typesafe-ts": "^1.7.1",
-    "@glassly/llm-providers": "0.3.5-beta.760",
+    "@glassly/llm-providers": "0.3.5-beta.775",
     "@huggingface/jinja": "^0.5.9",
     "jsonrepair": "^3.12.0"
   },
@@ -115,8 +115,8 @@
     "@glassly/llm-providers": "workspace:*",
     "@types/semver": "^7.7.1",
     "expo-module-scripts": "^56.0.3",
-    "expo-modules-core": "^57.0.7",
-    "react-native-nitro-modules": "^0.35.10",
+    "expo-modules-core": "^58.0.23",
+    "react-native-nitro-modules": "^0.37.1",
     "typescript": "~5.9.2"
   },
   "peerDependencies": {

package/src/facades/memory.ts

@@ -4,9 +4,10 @@
  * purge everything; the full timeline surface (lines, sessions, summaries)
  * is what miniapps reach through session.memory with the MEMORY permission.
  */
-import type {MemoryEntry, MemorySession} from "@glassly/miniapp"
+import type {MemoryEntry, MemoryExportResult, MemoryImportResult, MemorySession} from "@glassly/miniapp"
 
-import type {MemoryStats} from "../services/MemoryStore"
+import {exportMemoryFile, importMemoryFile} from "../services/memoryBackupFile"
+import {MemoryBackupError, type MemoryStats} from "../services/MemoryStore"
 import {memoryStore} from "../services/memoryStoreInstance"
 
 export const memory = {
@@ -30,6 +31,14 @@ export const memory = {
   stats: (): Promise<MemoryStats> => memoryStore.stats(),
   /** Drop the entire timeline: every entry and every summary. */
   clearAll: (): Promise<void> => memoryStore.clear(),
+  /** Share the whole timeline as a JSON backup file. */
+  exportFile: (): Promise<MemoryExportResult> => exportMemoryFile(),
+  /**
+   * Pick a backup file and merge it in, skipping what's already stored.
+   * Resolves null on cancel; rejects with a MemoryBackupError for a non-backup file.
+   */
+  importFile: (): Promise<MemoryImportResult | null> => importMemoryFile(),
+  isBackupError: (err: unknown): boolean => err instanceof MemoryBackupError,
   /** Subscribe to store mutations (from miniapps or Settings). */
   onChanged: (listener: () => void): (() => void) => memoryStore.onChanged(listener),
 }

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface EngineReleaseMetadata {
 export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "0.3.5",
-  "releaseIdentity": "0.3.5-beta.760",
-  "releaseSetId": "glassly-0.3.5-beta.760",
-  "sourceCommit": "d5e2a8877bc5441b410677c79d96b38b985d5f91",
+  "releaseIdentity": "0.3.5-beta.775",
+  "releaseSetId": "glassly-0.3.5-beta.775",
+  "sourceCommit": "c48886d82edd42a7d012af3b8936251ac92ba949",
   "otaManifestUrl": null,
   "otaManifestSha256": null
 })

package/src/services/BlobStore.ts

@@ -383,7 +383,7 @@ export class BlobStore {
           return
         }
         up.handle.offset = payload.offset
-        up.handle.writeBytes(bytes)
+        up.handle.writeBytesSync(bytes)
         up.handle.offset = up.bytes // restore append position
         this.hooks.sendResult(packageName, requestId, true, {bytesWritten: up.bytes})
         return
@@ -397,7 +397,7 @@ export class BlobStore {
         return
       }
       up.handle.offset = up.bytes
-      up.handle.writeBytes(bytes)
+      up.handle.writeBytesSync(bytes)
       up.bytes += bytes.length
       this.hooks.sendResult(packageName, requestId, true, {bytesWritten: up.bytes})
     } catch (err) {
@@ -633,7 +633,7 @@ export class BlobStore {
     }
     try {
       const want = Math.max(0, Math.min(Number(payload.maxBytes) || 1024 * 1024, reader.remaining))
-      const bytes = want > 0 ? reader.handle.readBytes(want) : new Uint8Array(0)
+      const bytes = want > 0 ? reader.handle.readBytesSync(want) : new Uint8Array(0)
       reader.remaining -= bytes.length
       const done = reader.remaining <= 0
       const base64 = bytes.length

package/src/services/ForegroundLocationPermission.ts

@@ -13,7 +13,7 @@ export interface ForegroundLocationPermissionClient {
  */
 export async function resolveForegroundLocationPermission(
   client: ForegroundLocationPermissionClient,
-  getAppState: () => string,
+  getAppState: () => string | null | undefined,
 ): Promise<ForegroundLocationPermissionResponse> {
   const current = await client.getForegroundPermissionsAsync()
   if (current.status === "granted" || getAppState() !== "active") {

package/src/services/LocalMiniappRuntime.ts

@@ -109,6 +109,7 @@ import {
   unplaceWidget,
   type WidgetBox,
   type WidgetPlacements,
+  type WidgetView,
 } from "./widgetPlacements"
 import {
   activeDashboard,
@@ -183,6 +184,8 @@ import {listPhoneCalendarEvents, PhoneCalendarError} from "./PhoneCalendarServic
 import {LocalMiniappStorage} from "./LocalMiniappStorage"
 import {captureDecisionFor, type CaptureCandidate} from "./MemoryCapture"
 import {memoryStore} from "./memoryStoreInstance"
+import {exportMemoryFile, importMemoryFile} from "./memoryBackupFile"
+import {MemoryBackupError} from "./MemoryStore"
 import {speakerProfileStore} from "./speakerProfileStoreInstance"
 
 // =============================================================================
@@ -1591,6 +1594,8 @@ class LocalMiniappRuntime {
       case MiniappRequestType.MEMORY_QUERY:
       case MiniappRequestType.MEMORY_WINDOW:
       case MiniappRequestType.MEMORY_EXPORT_TEXT:
+      case MiniappRequestType.MEMORY_EXPORT_FILE:
+      case MiniappRequestType.MEMORY_IMPORT_FILE:
       case MiniappRequestType.MEMORY_SUMMARY_ADD:
       case MiniappRequestType.MEMORY_SUMMARY_LIST:
       case MiniappRequestType.MEMORY_PENDING_SUMMARY_HOUR:
@@ -4006,6 +4011,14 @@ class LocalMiniappRuntime {
           this.sendResult(packageName, requestId, true, {text: await memoryStore.exportText(scope, num(payload.at))})
           return
         }
+        case MiniappRequestType.MEMORY_EXPORT_FILE: {
+          this.sendResult(packageName, requestId, true, await exportMemoryFile())
+          return
+        }
+        case MiniappRequestType.MEMORY_IMPORT_FILE: {
+          this.sendResult(packageName, requestId, true, {imported: await importMemoryFile()})
+          return
+        }
         case MiniappRequestType.MEMORY_SUMMARY_ADD: {
           const hourStart = num(payload.hourStart)
           if (hourStart == null || typeof payload.text !== "string") {
@@ -4041,6 +4054,13 @@ class LocalMiniappRuntime {
           })
       }
     } catch (err) {
+      if (err instanceof MemoryBackupError) {
+        this.sendResult(packageName, requestId, false, undefined, {
+          code: MiniappErrorCode.INVALID_ARGUMENT,
+          message: err.message,
+        })
+        return
+      }
       console.error(`${LOG_TAG}: ${requestType} error:`, err)
       this.sendResult(packageName, requestId, false, undefined, {
         code: MiniappErrorCode.INTERNAL,
@@ -4662,7 +4682,7 @@ class LocalMiniappRuntime {
       if (base64) {
         // File share via base64 — write to temp file then share
         const tempFile = new File(Paths.cache, filename || "shared_file")
-        tempFile.write(base64, {encoding: "base64"})
+        tempFile.writeSync(base64, {encoding: "base64"})
         await Share.open({
           url: tempFile.uri,
           type: mimeType || "application/octet-stream",
@@ -4742,7 +4762,7 @@ class LocalMiniappRuntime {
       let file: File
       if (base64) {
         file = new File(Paths.cache, name)
-        file.write(base64, {encoding: "base64"})
+        file.writeSync(base64, {encoding: "base64"})
       } else if (url) {
         file = await File.downloadFileAsync(url, new File(Paths.cache, name), {idempotent: true})
       } else {
@@ -6298,6 +6318,8 @@ class LocalMiniappRuntime {
   private widgetCallSeq = 0
   /** Elements per widget frame; a card is small, and the link is slow. */
   private static readonly WIDGET_FRAME_ELEMENT_CAP = 64
+  /** Elements per expanded widget frame: the full screen, on the same link. */
+  private static readonly WIDGET_EXPANDED_FRAME_ELEMENT_CAP = 128
 
   private requireWidgetHost(packageName: string, requestId: string | undefined, op: string): boolean {
     return this.requirePermission(packageName, requestId, "HOST_WIDGETS", `to ${op} widgets`)
@@ -6346,6 +6368,7 @@ class LocalMiniappRuntime {
           name: widget.name,
           sizes: widget.sizes,
           defaultSize: widget.defaultSize,
+          expandable: widget.expandable,
           running: app.running,
           compatible: app.compatibility?.isCompatible !== false,
         })
@@ -6357,7 +6380,8 @@ class LocalMiniappRuntime {
   private parseWidgetBox(raw: unknown): WidgetBox | null {
     const box = raw as {size?: unknown; width?: unknown; height?: unknown} | null
     if (!box || typeof box !== "object") return null
-    if (box.size !== "XS" && box.size !== "SM" && box.size !== "MD" && box.size !== "LG") return null
+    if (box.size !== "XS" && box.size !== "XSM" && box.size !== "SM" && box.size !== "MD" && box.size !== "LG")
+      return null
     const width = Number(box.width)
     const height = Number(box.height)
     if (!(width > 0) || !(height > 0)) return null
@@ -6383,7 +6407,7 @@ class LocalMiniappRuntime {
   /**
    * session.widgets.place: record the host's box, wake the provider in widget
    * mode when it is not running, hand it the box, and answer with the last
-   * frame the provider pushed for the widget.
+   * card and expanded frames the provider pushed for the widget.
    */
   private async handleWidgetPlace(
     hostPackageName: string,
@@ -6432,7 +6456,10 @@ class LocalMiniappRuntime {
     if (placementOf(this.widgetPlacements, hostPackageName, provider, widgetId) && this.connectedApps.has(provider)) {
       this.sendWidgetCall(provider, widgetId, {kind: "box", box})
     }
-    this.sendResult(hostPackageName, requestId, true, {frame: widgetFrameOf(this.widgetPlacements, provider, widgetId)})
+    this.sendResult(hostPackageName, requestId, true, {
+      frame: widgetFrameOf(this.widgetPlacements, provider, widgetId),
+      expandedFrame: widgetFrameOf(this.widgetPlacements, provider, widgetId, "expanded"),
+    })
   }
 
   private async handleWidgetUnplace(
@@ -6550,20 +6577,38 @@ class LocalMiniappRuntime {
     }
   }
 
-  /** Provider → host, one-shot: cache the frame and push it to every host holding the widget. */
+  /** Provider → host, one-shot: cache the frame for its view and push it to every host holding the widget. */
   private handleWidgetUpdate(providerPackageName: string, payload: Record<string, unknown>): void {
     const widgetId = payload.widgetId as string | undefined
     const elements = payload.elements
     if (!widgetId || !Array.isArray(elements)) return
     const app = this.interopApps().find((a) => a.packageName === providerPackageName)
-    if (!app || !this.declaredWidget(app, widgetId)) return
-    if (elements.length > LocalMiniappRuntime.WIDGET_FRAME_ELEMENT_CAP || this.actionPayloadTooLarge(elements)) {
-      console.warn(`${LOG_TAG}: dropping oversized widget frame from ${providerPackageName}/${widgetId}`)
+    const widget = app ? this.declaredWidget(app, widgetId) : undefined
+    if (!widget) return
+    const view: WidgetView = payload.view === "expanded" ? "expanded" : "card"
+    if (view === "expanded" && !widget.expandable) {
+      console.warn(
+        `${LOG_TAG}: dropping expanded frame from ${providerPackageName}/${widgetId}: not declared expandable`,
+      )
       return
     }
-    this.widgetPlacements = setWidgetFrame(this.widgetPlacements, providerPackageName, widgetId, elements)
+    const cap =
+      view === "expanded"
+        ? LocalMiniappRuntime.WIDGET_EXPANDED_FRAME_ELEMENT_CAP
+        : LocalMiniappRuntime.WIDGET_FRAME_ELEMENT_CAP
+    if (elements.length > cap || this.actionPayloadTooLarge(elements)) {
+      console.warn(`${LOG_TAG}: dropping oversized ${view} widget frame from ${providerPackageName}/${widgetId}`)
+      return
+    }
+    this.widgetPlacements = setWidgetFrame(this.widgetPlacements, providerPackageName, widgetId, elements, view)
     for (const host of widgetHostsOf(this.widgetPlacements, providerPackageName, widgetId)) {
-      this.sendToMiniapp(host, {type: MiniappResponseType.WIDGET_FRAME, packageName: providerPackageName, widgetId, elements})
+      this.sendToMiniapp(host, {
+        type: MiniappResponseType.WIDGET_FRAME,
+        packageName: providerPackageName,
+        widgetId,
+        elements,
+        ...(view === "expanded" ? {view} : {}),
+      })
     }
   }
 

package/src/services/MemoryStore.ts

@@ -17,7 +17,14 @@
  * user-scoped keys so existing history survives the move.
  */
 
-import type {MemoryEntry, MemoryNoteSource, MemorySession, MemorySummary} from "@glassly/miniapp"
+import type {
+  MemoryBackup,
+  MemoryEntry,
+  MemoryImportResult,
+  MemoryNoteSource,
+  MemorySession,
+  MemorySummary,
+} from "@glassly/miniapp"
 
 import {searchMemoryEntries} from "../utils/memory/search"
 
@@ -91,6 +98,14 @@ export interface MemoryStats {
   oldestAt: number | null
 }
 
+/** Thrown by importBackup for anything that isn't a backup this build can read. */
+export class MemoryBackupError extends Error {
+  constructor(message: string) {
+    super(message)
+    this.name = "MemoryBackupError"
+  }
+}
+
 export function hourStartOf(ms: number): number {
   return Math.floor(ms / HOUR_MS) * HOUR_MS
 }
@@ -359,6 +374,65 @@ export class MemoryStore {
     return Math.max(...hours)
   }
 
+  /** The whole timeline as a backup file body (Settings > Memory, session.memory.exportFile). */
+  async exportBackup(): Promise<MemoryBackup> {
+    await this.ensureLoaded()
+    return {
+      format: "glassly-memory",
+      version: 1,
+      exportedAt: Date.now(),
+      entries: [...this.entries],
+      summaries: [...this.summaries].sort((a, b) => a.hourStart - b.hourStart),
+    }
+  }
+
+  /**
+   * Merge a backup into the timeline. Skips entries whose id is stored, notes
+   * whose text is already in the same hour, and hours that already have a
+   * summary. Throws MemoryBackupError when `data` isn't a memory backup.
+   */
+  async importBackup(data: unknown): Promise<MemoryImportResult> {
+    const backup = parseBackup(data)
+    await this.ensureLoaded()
+    const result: MemoryImportResult = {entries: 0, summaries: 0, skipped: 0}
+
+    const ids = new Set(this.entries.map((e) => e.id))
+    const noteKeys = new Set(this.entries.filter((e) => e.kind === "note").map(noteKey))
+    for (const entry of backup.entries) {
+      const key = entry.kind === "note" ? noteKey(entry) : null
+      if (ids.has(entry.id) || (key != null && noteKeys.has(key))) {
+        result.skipped++
+        continue
+      }
+      ids.add(entry.id)
+      if (key != null) noteKeys.add(key)
+      this.entries.push(entry)
+      result.entries++
+    }
+
+    const byHour = new Map(this.summaries.map((s) => [s.hourStart, s]))
+    for (const summary of backup.summaries) {
+      if (byHour.get(summary.hourStart)?.text.trim()) {
+        result.skipped++
+        continue
+      }
+      byHour.set(summary.hourStart, summary)
+      result.summaries++
+    }
+
+    if (result.entries > 0) {
+      this.entries.sort((a, b) => a.at - b.at)
+      this.prune()
+      await this.persistLog()
+    }
+    if (result.summaries > 0) {
+      this.summaries = [...byHour.values()].sort((a, b) => a.hourStart - b.hourStart).slice(-MEMORY_BOUNDS.maxSummaries)
+      await this.persistSummaries()
+    }
+    if (result.entries > 0 || result.summaries > 0) this.emitChanged()
+    return result
+  }
+
   /** Plain-text export of a scope, for the OS share sheet. */
   async exportText(scope: "session" | "day" | "all", at?: number): Promise<string> {
     const sessions = (await this.sessionList()).filter((s) => {
@@ -563,10 +637,45 @@ function parseArray(raw: unknown): unknown[] {
 function normalize(text: string): string {
   return text
     .toLowerCase()
-    .replace(/[^a-z0-9]+/g, " ")
+    .replace(/[^\p{L}\p{N}]+/gu, " ")
     .trim()
 }
 
+function noteKey(entry: MemoryEntry): string {
+  return `${hourStartOf(entry.at)}:${normalize(entry.text)}`
+}
+
+function parseBackup(data: unknown): {entries: MemoryEntry[]; summaries: MemorySummary[]} {
+  const raw = data as Record<string, unknown> | null
+  if (!raw || typeof raw !== "object" || raw.format !== "glassly-memory" || !Array.isArray(raw.entries)) {
+    throw new MemoryBackupError("Not a Glassly memory backup")
+  }
+  if (typeof raw.version !== "number" || raw.version > 1) {
+    throw new MemoryBackupError(`Unsupported memory backup version ${String(raw.version)}`)
+  }
+  const entries: MemoryEntry[] = []
+  for (const v of raw.entries) {
+    if (!isEntry(v) || !v.id || !v.text.trim() || !Number.isFinite(v.at)) continue
+    entries.push({
+      id: v.id,
+      kind: v.kind,
+      text: v.text.trim(),
+      at: v.at,
+      speakerId: typeof v.speakerId === "string" ? v.speakerId : null,
+      ...(typeof v.resolvedSpeakerName === "string" && v.resolvedSpeakerName
+        ? {resolvedSpeakerName: v.resolvedSpeakerName}
+        : {}),
+      language: typeof v.language === "string" ? v.language : null,
+      ...(v.kind === "note" ? {source: v.source === "voice" || v.source === "auto" ? v.source : "ui"} : {}),
+    })
+  }
+  const summaries = (Array.isArray(raw.summaries) ? raw.summaries : [])
+    .filter(isSummary)
+    .filter((s) => s.text.trim() && Number.isFinite(s.hourStart))
+    .map((s) => ({hourStart: s.hourStart, text: s.text, createdAt: s.createdAt}))
+  return {entries, summaries}
+}
+
 function isEntry(v: unknown): v is MemoryEntry {
   if (!v || typeof v !== "object") return false
   const e = v as Record<string, unknown>

package/src/services/manifestActions.ts

@@ -79,20 +79,26 @@ export function normalizeManifestActions(raw: unknown): DeclaredAction[] {
   return out
 }
 
-const WIDGET_SIZES: readonly DeclaredWidgetSize[] = ["XS", "SM", "MD", "LG"]
+const WIDGET_SIZES: readonly DeclaredWidgetSize[] = ["XS", "XSM", "SM", "MD", "LG"]
 const isWidgetSize = (value: unknown): value is DeclaredWidgetSize => (WIDGET_SIZES as readonly unknown[]).includes(value)
 
 /**
  * Normalize manifest widgets for installed and dev-sideloaded bundles: an
  * entry without an id, a name or a usable size is dropped, repeats of a
  * size are folded, and a default size the widget does not offer becomes
- * its first size.
+ * its first size. Only `expandable: true` makes a widget expandable.
  */
 export function normalizeManifestWidgets(raw: unknown): DeclaredWidget[] {
   if (!Array.isArray(raw)) return []
   const out: DeclaredWidget[] = []
   const seen = new Set<string>()
-  for (const w of raw as Array<{id?: unknown; name?: unknown; sizes?: unknown; defaultSize?: unknown}>) {
+  for (const w of raw as Array<{
+    id?: unknown
+    name?: unknown
+    sizes?: unknown
+    defaultSize?: unknown
+    expandable?: unknown
+  }>) {
     if (!w || typeof w.id !== "string" || !w.id || typeof w.name !== "string" || !w.name || seen.has(w.id)) continue
     const sizes = Array.isArray(w.sizes) ? Array.from(new Set(w.sizes.filter(isWidgetSize))) : []
     if (sizes.length === 0) continue
@@ -102,6 +108,7 @@ export function normalizeManifestWidgets(raw: unknown): DeclaredWidget[] {
       name: w.name,
       sizes,
       defaultSize: isWidgetSize(w.defaultSize) && sizes.includes(w.defaultSize) ? w.defaultSize : sizes[0],
+      expandable: w.expandable === true,
     })
   }
   return out