@apocaliss92/nodedreame 1.11.1 → 1.11.2

package/dist/index.d.cts

@@ -1849,6 +1849,31 @@ declare function extractMowerConsumableValues(result: unknown): number[] | null;
  * maintenance) with remaining %. Returns null on a malformed response.
  */
 declare function parseMowerConsumables(result: unknown): readonly MowerConsumableReading[] | null;
+/** Decoded mowing task sub-state (heartbeat byte 13), or null when no mowing
+ *  session is in progress. Ported from antondaubert/dreame-mower
+ *  `property_misc.py` Property11Handler. */
+type MowerTaskSubState = 'idle' | 'starting' | 'mowing' | 'paused' | 'finished' | 'failed' | 'exit' | 'returning-to-dock';
+/** Ordered sub-state table; the heartbeat encodes `subState = base + index`. */
+declare const MOWER_TASK_SUBSTATES: readonly MowerTaskSubState[];
+/** Typed heartbeat decode: battery byte, main-state, and (when mowing) the task
+ *  sub-state. */
+interface MowerHeartbeat {
+    /** Raw battery byte (byte 11) — percent with a charging flag in the high bits. */
+    readonly rawBattery: number;
+    /** `(byte12 & 0x0F) - 1`; 4 = mowing. */
+    readonly mainState: number;
+    /** Raw sub-state byte (byte 13). */
+    readonly subStateRaw: number;
+    /** Decoded sub-state when a mowing session is active, else null. */
+    readonly taskSubState: MowerTaskSubState | null;
+}
+/**
+ * Decode the 20-byte HEARTBEAT (1:1) blob. Returns null when the payload is not a
+ * well-formed heartbeat (wrong length / missing 0xCE sentinels). The task
+ * sub-state is only meaningful while `mainState === 4` (mowing); in any other
+ * main state there is no active mowing task (returns `taskSubState: null`).
+ */
+declare function parseMowerHeartbeat(value: unknown): MowerHeartbeat | null;
 
 /**
  * Per-model mower capability records + a resolver adapting the rich record into
@@ -2053,6 +2078,14 @@ declare class MowerDevice extends BaseDevice {
      * code — which still surfaces as the raw number via {@link faultRaw}.
      */
     get fault(): MowerFault | null;
+    /**
+     * Live mowing task sub-state decoded from the HEARTBEAT (1:1) blob —
+     * idle/starting/mowing/paused/finished/failed/exit/returning-to-dock — or null
+     * when no mowing session is in progress (or the heartbeat is absent). This is
+     * the donor's "current task" sensor; the heartbeat is push-only (the mower does
+     * not answer live reads), so it tracks the device while it is actively mowing.
+     */
+    get taskSubState(): MowerTaskSubState | null;
     /** Parsed scheduling task descriptor (2:50), or null. */
     get task(): MowerTaskDescriptor | null;
     /**
@@ -2135,6 +2168,9 @@ declare class MowerDevice extends BaseDevice {
     mapSvg(opts?: RenderMowerSvgOptions): Promise<string>;
     /** Props worth seeding on start() / polling — exported for the facade. */
     static readonly DEFAULT_PROPS: readonly [{
+        readonly siid: 1;
+        readonly piid: 1;
+    }, {
         readonly siid: 2;
         readonly piid: 1;
     }, {
@@ -2493,4 +2529,4 @@ declare function createDumper(target: DumperDevice, options?: DumperOptions): Du
  */
 declare function createClientDumper(client: Nodreame, options?: DumperOptions): Dumper[];
 
-export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, AUTO_SWITCH_JSON_KEY, type AiDetectionRaw, type AutoSwitchKey, type AutoSwitchRaw, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceDump, type DeviceEvent, type DreameAiFeature, DreameApiError, DreameAuthError, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, type DumperOptions, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, consumableSpec, createClientDumper, createDumper, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, encodeAiFeatureWrite, encodeAutoSwitchWrite, extractMowerConsumableValues, getMowerCapabilities, getVacuumCapabilities, isDreameConsumableKey, mowerConsumableIndex, parseMowerConsumables, renderMowerSvg, renderVacuumPng, resolveCapabilities, supportedAutoSwitchKeys };
+export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, AUTO_SWITCH_JSON_KEY, type AiDetectionRaw, type AutoSwitchKey, type AutoSwitchRaw, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceDump, type DeviceEvent, type DreameAiFeature, DreameApiError, DreameAuthError, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, type DumperOptions, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, consumableSpec, createClientDumper, createDumper, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, encodeAiFeatureWrite, encodeAutoSwitchWrite, extractMowerConsumableValues, getMowerCapabilities, getVacuumCapabilities, isDreameConsumableKey, mowerConsumableIndex, parseMowerConsumables, parseMowerHeartbeat, renderMowerSvg, renderVacuumPng, resolveCapabilities, supportedAutoSwitchKeys };

package/dist/index.d.ts

@@ -1849,6 +1849,31 @@ declare function extractMowerConsumableValues(result: unknown): number[] | null;
  * maintenance) with remaining %. Returns null on a malformed response.
  */
 declare function parseMowerConsumables(result: unknown): readonly MowerConsumableReading[] | null;
+/** Decoded mowing task sub-state (heartbeat byte 13), or null when no mowing
+ *  session is in progress. Ported from antondaubert/dreame-mower
+ *  `property_misc.py` Property11Handler. */
+type MowerTaskSubState = 'idle' | 'starting' | 'mowing' | 'paused' | 'finished' | 'failed' | 'exit' | 'returning-to-dock';
+/** Ordered sub-state table; the heartbeat encodes `subState = base + index`. */
+declare const MOWER_TASK_SUBSTATES: readonly MowerTaskSubState[];
+/** Typed heartbeat decode: battery byte, main-state, and (when mowing) the task
+ *  sub-state. */
+interface MowerHeartbeat {
+    /** Raw battery byte (byte 11) — percent with a charging flag in the high bits. */
+    readonly rawBattery: number;
+    /** `(byte12 & 0x0F) - 1`; 4 = mowing. */
+    readonly mainState: number;
+    /** Raw sub-state byte (byte 13). */
+    readonly subStateRaw: number;
+    /** Decoded sub-state when a mowing session is active, else null. */
+    readonly taskSubState: MowerTaskSubState | null;
+}
+/**
+ * Decode the 20-byte HEARTBEAT (1:1) blob. Returns null when the payload is not a
+ * well-formed heartbeat (wrong length / missing 0xCE sentinels). The task
+ * sub-state is only meaningful while `mainState === 4` (mowing); in any other
+ * main state there is no active mowing task (returns `taskSubState: null`).
+ */
+declare function parseMowerHeartbeat(value: unknown): MowerHeartbeat | null;
 
 /**
  * Per-model mower capability records + a resolver adapting the rich record into
@@ -2053,6 +2078,14 @@ declare class MowerDevice extends BaseDevice {
      * code — which still surfaces as the raw number via {@link faultRaw}.
      */
     get fault(): MowerFault | null;
+    /**
+     * Live mowing task sub-state decoded from the HEARTBEAT (1:1) blob —
+     * idle/starting/mowing/paused/finished/failed/exit/returning-to-dock — or null
+     * when no mowing session is in progress (or the heartbeat is absent). This is
+     * the donor's "current task" sensor; the heartbeat is push-only (the mower does
+     * not answer live reads), so it tracks the device while it is actively mowing.
+     */
+    get taskSubState(): MowerTaskSubState | null;
     /** Parsed scheduling task descriptor (2:50), or null. */
     get task(): MowerTaskDescriptor | null;
     /**
@@ -2135,6 +2168,9 @@ declare class MowerDevice extends BaseDevice {
     mapSvg(opts?: RenderMowerSvgOptions): Promise<string>;
     /** Props worth seeding on start() / polling — exported for the facade. */
     static readonly DEFAULT_PROPS: readonly [{
+        readonly siid: 1;
+        readonly piid: 1;
+    }, {
         readonly siid: 2;
         readonly piid: 1;
     }, {
@@ -2493,4 +2529,4 @@ declare function createDumper(target: DumperDevice, options?: DumperOptions): Du
  */
 declare function createClientDumper(client: Nodreame, options?: DumperOptions): Dumper[];
 
-export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, AUTO_SWITCH_JSON_KEY, type AiDetectionRaw, type AutoSwitchKey, type AutoSwitchRaw, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceDump, type DeviceEvent, type DreameAiFeature, DreameApiError, DreameAuthError, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, type DumperOptions, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, consumableSpec, createClientDumper, createDumper, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, encodeAiFeatureWrite, encodeAutoSwitchWrite, extractMowerConsumableValues, getMowerCapabilities, getVacuumCapabilities, isDreameConsumableKey, mowerConsumableIndex, parseMowerConsumables, renderMowerSvg, renderVacuumPng, resolveCapabilities, supportedAutoSwitchKeys };
+export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, AUTO_SWITCH_JSON_KEY, type AiDetectionRaw, type AutoSwitchKey, type AutoSwitchRaw, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceDump, type DeviceEvent, type DreameAiFeature, DreameApiError, DreameAuthError, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, type DumperOptions, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, consumableSpec, createClientDumper, createDumper, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, encodeAiFeatureWrite, encodeAutoSwitchWrite, extractMowerConsumableValues, getMowerCapabilities, getVacuumCapabilities, isDreameConsumableKey, mowerConsumableIndex, parseMowerConsumables, parseMowerHeartbeat, renderMowerSvg, renderVacuumPng, resolveCapabilities, supportedAutoSwitchKeys };

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/support/version.ts
 var LIBRARY_NAME = "nodedreame";
-var LIBRARY_VERSION = "1.11.1";
+var LIBRARY_VERSION = "1.11.2";
 
 // src/transport/errors.ts
 var DreameError = class extends Error {
@@ -1575,7 +1575,9 @@ function encodeAiFeatureWrite(raw, feature, value) {
   if (typeof raw === "number") {
     const bit = AI_FEATURE_BIT[feature];
     if (bit === void 0) {
-      throw new Error(`encodeAiFeatureWrite: feature "${feature}" has no int-bitmask representation`);
+      throw new Error(
+        `encodeAiFeatureWrite: feature "${feature}" has no int-bitmask representation`
+      );
     }
     return value ? raw | bit : raw & ~bit;
   }
@@ -1692,18 +1694,53 @@ function encodeAutoSwitchWrite(key2, value) {
 
 // src/models/vacuum/consumables.ts
 var VACUUM_CONSUMABLES = [
-  { key: "main-brush", label: "Main Brush", life: { siid: 9, piid: 2 }, reset: { siid: 9, aiid: 1 } },
-  { key: "side-brush", label: "Side Brush", life: { siid: 10, piid: 2 }, reset: { siid: 10, aiid: 1 } },
+  {
+    key: "main-brush",
+    label: "Main Brush",
+    life: { siid: 9, piid: 2 },
+    reset: { siid: 9, aiid: 1 }
+  },
+  {
+    key: "side-brush",
+    label: "Side Brush",
+    life: { siid: 10, piid: 2 },
+    reset: { siid: 10, aiid: 1 }
+  },
   { key: "filter", label: "Filter", life: { siid: 11, piid: 1 }, reset: { siid: 11, aiid: 1 } },
   { key: "sensor", label: "Sensor", life: { siid: 16, piid: 1 }, reset: { siid: 16, aiid: 1 } },
-  { key: "tank-filter", label: "Tank Filter", life: { siid: 17, piid: 1 }, reset: { siid: 17, aiid: 1 } },
+  {
+    key: "tank-filter",
+    label: "Tank Filter",
+    life: { siid: 17, piid: 1 },
+    reset: { siid: 17, aiid: 1 }
+  },
   { key: "mop-pad", label: "Mop Pad", life: { siid: 18, piid: 1 }, reset: { siid: 18, aiid: 1 } },
-  { key: "silver-ion", label: "Silver-ion", life: { siid: 19, piid: 2 }, reset: { siid: 19, aiid: 1 } },
-  { key: "detergent", label: "Detergent", life: { siid: 20, piid: 1 }, reset: { siid: 20, aiid: 1 } },
+  {
+    key: "silver-ion",
+    label: "Silver-ion",
+    life: { siid: 19, piid: 2 },
+    reset: { siid: 19, aiid: 1 }
+  },
+  {
+    key: "detergent",
+    label: "Detergent",
+    life: { siid: 20, piid: 1 },
+    reset: { siid: 20, aiid: 1 }
+  },
   { key: "squeegee", label: "Squeegee", life: { siid: 24, piid: 1 }, reset: { siid: 24, aiid: 1 } },
-  { key: "deodorizer", label: "Deodorizer", life: { siid: 29, piid: 2 }, reset: { siid: 29, aiid: 1 } },
+  {
+    key: "deodorizer",
+    label: "Deodorizer",
+    life: { siid: 29, piid: 2 },
+    reset: { siid: 29, aiid: 1 }
+  },
   { key: "wheel", label: "Wheel", life: { siid: 30, piid: 2 }, reset: { siid: 30, aiid: 1 } },
-  { key: "scale-inhibitor", label: "Scale Inhibitor", life: { siid: 31, piid: 2 }, reset: { siid: 31, aiid: 1 } },
+  {
+    key: "scale-inhibitor",
+    label: "Scale Inhibitor",
+    life: { siid: 31, piid: 2 },
+    reset: { siid: 31, aiid: 1 }
+  },
   { key: "dust-bag", label: "Dust Bag", life: { siid: 27, piid: 17 }, reset: null }
 ];
 function consumableSpec(key2) {
@@ -3818,6 +3855,9 @@ var VacuumDevice = class _VacuumDevice extends BaseDevice {
 
 // src/models/mower/properties.ts
 var MOWER_PROP = {
+  /** VERIFIED-by-donor — 20-byte heartbeat (sentinel 0xCE at [0]/[19]); byte 11
+   *  battery, byte 12 main-state, byte 13 task sub-state. See parseHeartbeat. */
+  HEARTBEAT: { siid: 1, piid: 1 },
   /** VERIFIED-by-donor — pose + coverage telemetry (binary). P4 uses progress % only. */
   POSE_COVERAGE: { siid: 1, piid: 4 },
   /** VERIFIED-by-donor — MowerStatus (DeviceStatus). */
@@ -4167,6 +4207,39 @@ function parseMowerConsumables(result) {
     };
   });
 }
+var MOWER_TASK_SUBSTATES = [
+  "idle",
+  "starting",
+  "mowing",
+  "paused",
+  "finished",
+  "failed",
+  "exit",
+  "returning-to-dock"
+];
+var HEARTBEAT_SENTINEL = 206;
+var HEARTBEAT_SUBSTATE_BASE = 33;
+var HEARTBEAT_MAIN_STATE_MOWING = 4;
+function parseMowerHeartbeat(value) {
+  if (!Array.isArray(value) || value.length < 14) {
+    return null;
+  }
+  const bytes = [];
+  for (const b of value) {
+    if (typeof b !== "number") {
+      return null;
+    }
+    bytes.push(b);
+  }
+  if (bytes[0] !== HEARTBEAT_SENTINEL || bytes[bytes.length - 1] !== HEARTBEAT_SENTINEL) {
+    return null;
+  }
+  const rawBattery = bytes[11] ?? 0;
+  const mainState = ((bytes[12] ?? 0) & 15) - 1;
+  const subStateRaw = bytes[13] ?? 0;
+  const taskSubState = mainState === HEARTBEAT_MAIN_STATE_MOWING ? MOWER_TASK_SUBSTATES[subStateRaw - HEARTBEAT_SUBSTATE_BASE] ?? null : null;
+  return { rawBattery, mainState, subStateRaw, taskSubState };
+}
 
 // src/models/mower/capabilities.ts
 var FALLBACK2 = {
@@ -4840,6 +4913,19 @@ var MowerDevice = class _MowerDevice extends BaseDevice {
   get fault() {
     return FAULT(this.faultRaw);
   }
+  /**
+   * Live mowing task sub-state decoded from the HEARTBEAT (1:1) blob —
+   * idle/starting/mowing/paused/finished/failed/exit/returning-to-dock — or null
+   * when no mowing session is in progress (or the heartbeat is absent). This is
+   * the donor's "current task" sensor; the heartbeat is push-only (the mower does
+   * not answer live reads), so it tracks the device while it is actively mowing.
+   */
+  get taskSubState() {
+    const hb = parseMowerHeartbeat(
+      this.getProperty(MOWER_PROP.HEARTBEAT.siid, MOWER_PROP.HEARTBEAT.piid)?.value
+    );
+    return hb?.taskSubState ?? null;
+  }
   /** Parsed scheduling task descriptor (2:50), or null. */
   get task() {
     return parseTaskDescriptor(
@@ -5031,6 +5117,7 @@ var MowerDevice = class _MowerDevice extends BaseDevice {
   }
   /** Props worth seeding on start() / polling — exported for the facade. */
   static DEFAULT_PROPS = [
+    MOWER_PROP.HEARTBEAT,
     MOWER_PROP.STATUS,
     MOWER_PROP.DEVICE_CODE,
     MOWER_PROP.BATTERY,
@@ -5658,6 +5745,7 @@ export {
   DreameTransportError,
   LIBRARY_NAME,
   MODEL_CAPABILITIES2 as MOWER_MODEL_CAPABILITIES,
+  MOWER_TASK_SUBSTATES,
   MiotError,
   MiotState,
   MowerCapabilityResolver,
@@ -5689,6 +5777,7 @@ export {
   isDreameConsumableKey,
   mowerConsumableIndex,
   parseMowerConsumables,
+  parseMowerHeartbeat,
   renderMowerSvg,
   renderVacuumPng,
   resolveCapabilities,