camstack 1.2.101 → 1.2.103

package/dist/{chunk-7N7KEXGL.js → chunk-IAJ7W6M6.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-Db7MvrdS.mjs
+// ../types/dist/sleep-CgijQHtG.mjs
 var WELL_KNOWN_TABS = [
   {
     id: "overview",
@@ -32150,6 +32150,85 @@ var batteryCapability = {
   *  whether persisting is worth a SQLite commit. */
   volatileStateFields: ["lastUpdated"]
 };
+var NETWORK_LINK_TYPES = [
+  "wifi",
+  "ethernet",
+  "cellular",
+  "unknown"
+];
+var NetworkLinkStatusSchema = external_exports.object({
+  /** The link the device is on. `'unknown'` = not read yet, not "no link". */
+  type: external_exports.enum(NETWORK_LINK_TYPES),
+  /**
+  * Link quality, 0..100 inclusive, normalised by the provider from whatever
+  * the firmware reports (bars, RSSI, a vendor scale). **`null` means NOT
+  * KNOWN or NOT APPLICABLE** — a wired link has no signal, and a wireless
+  * one whose reading has not landed must not be drawn at 0 %. Consumers
+  * SKIP a null rather than coerce it.
+  */
+  signalPercent: external_exports.number().min(0).max(100).nullable(),
+  /** Raw received signal strength in dBm, when the firmware reports one. */
+  rssiDbm: external_exports.number().optional(),
+  /** Network name of a wireless link, when the firmware reports it. */
+  ssid: external_exports.string().optional(),
+  /** Ms epoch of the last observation. Lets consumers reason about freshness. */
+  lastUpdated: external_exports.number()
+});
+var NETWORK_LINK_UNKNOWN = {
+  type: "unknown",
+  signalPercent: null,
+  lastUpdated: 0
+};
+var networkLinkCapability = {
+  name: "network-link",
+  scope: "device",
+  deviceNative: true,
+  mode: "singleton",
+  deviceTypes: [
+    DeviceType.Camera,
+    DeviceType.Sensor,
+    DeviceType.Button,
+    DeviceType.Switch,
+    DeviceType.Light,
+    DeviceType.Lock,
+    DeviceType.Siren
+  ],
+  methods: {},
+  events: {
+    /**
+    * Emitted whenever the cached status changes (a link switch, a signal
+    * reading that moved). Mirrored on the parent chain by the
+    * DeviceEventPropagator like `battery.onStatusChanged`.
+    */
+    onStatusChanged: { data: external_exports.object({
+      deviceId: external_exports.number(),
+      status: NetworkLinkStatusSchema
+    }) }
+  },
+  status: {
+    schema: NetworkLinkStatusSchema,
+    kind: "push",
+    empty: NETWORK_LINK_UNKNOWN
+  },
+  /**
+  * Runtime-state slice — every provider stores the same shape under
+  * `device.runtimeState['network-link']`, read once by the badge and the
+  * Home Assistant projector regardless of the driver.
+  */
+  runtimeState: NetworkLinkStatusSchema,
+  /**
+  * Runtime-state durability: **restored** — a link reading is slow to
+  * change and a sleeping battery camera may not report for hours; the
+  * restored slice is what the badge shows until the next read.
+  *
+  * See `RuntimeStateDurability`. Enforced by
+  * `scripts/check-runtime-state-durability.ts`.
+  */
+  durability: "restored",
+  /** Clock fields: written, but excluded from the compare that decides
+  *  whether persisting is worth a SQLite commit. */
+  volatileStateFields: ["lastUpdated"]
+};
 var BinaryStatusSchema = external_exports.object({
   on: external_exports.boolean(),
   /** Ms epoch of the last transition. 0 if never observed. */
@@ -36855,6 +36934,169 @@ var ptzAutotrackCapability = {
   */
   durability: "session"
 };
+var NavigationMoveCommandSchema = external_exports.object({
+  pan: external_exports.number().min(-1).max(1).optional(),
+  tilt: external_exports.number().min(-1).max(1).optional(),
+  speed: external_exports.number().min(0).max(1).optional()
+});
+var NavigationActionIdSchema = external_exports.enum([
+  "goHome",
+  "locate",
+  "spotClean",
+  "findPet",
+  "personFollow",
+  "stop",
+  "startClean",
+  "pauseClean",
+  "dockWash",
+  "autoEmpty",
+  "flashOn",
+  "flashOff"
+]);
+var NavigationEntryKindSchema = external_exports.enum(["action", "sound"]);
+var NavigationActionEntrySchema = external_exports.object({
+  id: external_exports.string(),
+  kind: NavigationEntryKindSchema,
+  label: external_exports.string(),
+  icon: external_exports.string(),
+  /** Present only on `kind:'sound'` entries — the id to pass to `playSound`. */
+  soundId: external_exports.number().int().optional(),
+  /** Per-device feature flag — render this entry only when true. */
+  enabled: external_exports.boolean()
+});
+var NavigationPointSchema = external_exports.object({
+  x: external_exports.number(),
+  y: external_exports.number()
+});
+var NavigationFeaturesSchema = external_exports.object({
+  move: external_exports.boolean(),
+  stop: external_exports.boolean(),
+  goToPoint: external_exports.boolean(),
+  runAction: external_exports.boolean(),
+  playSound: external_exports.boolean(),
+  light: external_exports.boolean(),
+  lightMode: external_exports.boolean()
+});
+var NavigationLightModeSchema = external_exports.enum(["auto", "manual"]);
+var NavigationModeSchema = external_exports.enum([
+  "idle",
+  "cleaning",
+  "spot",
+  "following",
+  "goto",
+  "returning",
+  "paused",
+  "unknown"
+]);
+var NavigationStatusSchema = external_exports.object({
+  mode: NavigationModeSchema,
+  following: external_exports.boolean(),
+  flash: external_exports.boolean(),
+  lightMode: NavigationLightModeSchema,
+  lightLevel: external_exports.number().min(40).max(100),
+  /** Ms epoch when the slice was last updated. */
+  lastChangedAt: external_exports.number()
+});
+var NavigationRuntimeStateSchema = NavigationStatusSchema.extend({ lastFetchedAt: external_exports.number() });
+var navigationCapability = {
+  name: "navigation",
+  scope: "device",
+  deviceNative: true,
+  mode: "singleton",
+  deviceTypes: [DeviceType.Camera],
+  deviceConfig: { ui: {
+    kind: "widget",
+    widgetId: "host/navigation-panel",
+    tab: "navigation",
+    topTab: true,
+    label: "Navigation",
+    order: 0
+  } },
+  methods: {
+    /**
+    * Momentary drive nudge (the robot moves). `protected` — mirrors
+    * `ptz.continuousMove` so the Viewer navigation panel (and the PTZ-mimic
+    * path) works for any authenticated user, not admin-only. The UI sends
+    * these at ~1 Hz while a control is held; the provider forwards each one to
+    * a single drive write WITHOUT debouncing.
+    */
+    move: method(NavigationMoveCommandSchema.extend({ deviceId: external_exports.number() }), external_exports.void(), { kind: "mutation" }),
+    /** Halt all motion immediately (zero drive vector). */
+    stop: method(external_exports.object({ deviceId: external_exports.number() }), external_exports.void(), { kind: "mutation" }),
+    /** Send the robot to a point on its live map. */
+    goToPoint: method(NavigationPointSchema.extend({ deviceId: external_exports.number() }), external_exports.void(), { kind: "mutation" }),
+    /**
+    * Enumerate the discrete controls THIS device supports (data-driven UI +
+    * PTZ mimic). Camera-probed subset of {@link NAVIGATION_ACTION_CATALOG}.
+    */
+    listActions: method(external_exports.object({ deviceId: external_exports.number() }), external_exports.array(NavigationActionEntrySchema)),
+    /**
+    * Run one discrete action (a `kind:'action'` dictionary entry). Invalid /
+    * unsupported action ids are rejected by the provider.
+    */
+    runAction: method(external_exports.object({
+      deviceId: external_exports.number(),
+      actionId: NavigationActionIdSchema
+    }), external_exports.void(), { kind: "mutation" }),
+    /** Play a sound by its wire id (the `soundId` of a `kind:'sound'` entry). */
+    playSound: method(external_exports.object({
+      deviceId: external_exports.number(),
+      soundId: external_exports.number().int()
+    }), external_exports.void(), { kind: "mutation" }),
+    /**
+    * Turn the on-camera fill light on / off (the `OpenFullLight` control —
+    * works anytime, no active stream required).
+    */
+    setLightOn: method(external_exports.object({
+      deviceId: external_exports.number(),
+      on: external_exports.boolean()
+    }), external_exports.void(), { kind: "mutation" }),
+    /**
+    * Set the fill-light mode (auto vs manual). `manual` optionally carries the
+    * initial `level`. The auto/manual + level control is a CAMERA-service
+    * action that generally needs an active camera stream/monitor session — the
+    * UI shows the manual level slider ONLY when `mode === 'manual'`.
+    */
+    setLightMode: method(external_exports.object({
+      deviceId: external_exports.number(),
+      mode: NavigationLightModeSchema,
+      level: external_exports.number().min(40).max(100).optional()
+    }), external_exports.void(), { kind: "mutation" }),
+    /** Set the MANUAL fill-light level (40..100). Implies `manual` mode. */
+    setLightLevel: method(external_exports.object({
+      deviceId: external_exports.number(),
+      level: external_exports.number().min(40).max(100)
+    }), external_exports.void(), { kind: "mutation" }),
+    /**
+    * Per-device FEATURE-FLAG report for the general primitives — drives which
+    * controls the UI shows (the per-entry flags for the dictionary come back on
+    * `listActions`).
+    */
+    getFeatures: method(external_exports.object({ deviceId: external_exports.number() }), NavigationFeaturesSchema)
+  },
+  events: { onStatusChanged: { data: external_exports.object({
+    deviceId: external_exports.number(),
+    status: NavigationStatusSchema
+  }) } },
+  status: {
+    schema: NavigationStatusSchema,
+    kind: "push"
+  },
+  /**
+  * Runtime-state slice mirrored by the kernel. The navigation panel watches it
+  * for live mode / follow / flash changes.
+  */
+  runtimeState: NavigationRuntimeStateSchema,
+  /**
+  * Runtime-state durability: **session** — like `vacuum-control`, a restored
+  * `mode: cleaning` / `following: true` is a robot that is not actually doing
+  * that. The live handle re-publishes on connect.
+  *
+  * See `RuntimeStateDurability`. Enforced by
+  * `scripts/check-runtime-state-durability.ts`.
+  */
+  durability: "session"
+};
 var rebootCapability = {
   name: "reboot",
   scope: "device",
@@ -42270,6 +42512,66 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "navigation.getFeatures": {
+    capName: "navigation",
+    capScope: "device",
+    addonId: null,
+    access: "view"
+  },
+  "navigation.goToPoint": {
+    capName: "navigation",
+    capScope: "device",
+    addonId: null,
+    access: "create"
+  },
+  "navigation.listActions": {
+    capName: "navigation",
+    capScope: "device",
+    addonId: null,
+    access: "view"
+  },
+  "navigation.move": {
+    capName: "navigation",
+    capScope: "device",
+    addonId: null,
+    access: "create"
+  },
+  "navigation.playSound": {
+    capName: "navigation",
+    capScope: "device",
+    addonId: null,
+    access: "create"
+  },
+  "navigation.runAction": {
+    capName: "navigation",
+    capScope: "device",
+    addonId: null,
+    access: "create"
+  },
+  "navigation.setLightLevel": {
+    capName: "navigation",
+    capScope: "device",
+    addonId: null,
+    access: "create"
+  },
+  "navigation.setLightMode": {
+    capName: "navigation",
+    capScope: "device",
+    addonId: null,
+    access: "create"
+  },
+  "navigation.setLightOn": {
+    capName: "navigation",
+    capScope: "device",
+    addonId: null,
+    access: "create"
+  },
+  "navigation.stop": {
+    capName: "navigation",
+    capScope: "device",
+    addonId: null,
+    access: "create"
+  },
   "networkAccess.getEndpoint": {
     capName: "network-access",
     capScope: "system",
@@ -46365,6 +46667,56 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
     form: "single",
     optional: false
   }],
+  "navigation.getFeatures": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
+  "navigation.goToPoint": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
+  "navigation.listActions": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
+  "navigation.move": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
+  "navigation.playSound": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
+  "navigation.runAction": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
+  "navigation.setLightLevel": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
+  "navigation.setLightMode": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
+  "navigation.setLightOn": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
+  "navigation.stop": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
   "networkQuality.getDeviceStats": [{
     name: "deviceId",
     form: "single",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-7N7KEXGL.js";
+} from "./chunk-IAJ7W6M6.js";
 import "./chunk-LMMQX4CK.js";
 
 // src/cli.ts
@@ -38,7 +38,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-Q6SAJY4R.js");
+  await import("./launcher-WOJX4MSL.js");
 }
 
 // src/commands/agent.ts
@@ -83,7 +83,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-Q6SAJY4R.js");
+  await import("./launcher-WOJX4MSL.js");
 }
 
 // src/commands/setup.ts
@@ -1130,7 +1130,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-3TATRQOW.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-LBZ4OABF.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-3TATRQOW.js → discover-LBZ4OABF.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-7N7KEXGL.js";
+} from "./chunk-IAJ7W6M6.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,