@camstack/types 1.2.445 → 1.2.447

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.447] - 2026-10-29
+
+### Changed
+
+- Numbers tied to a physical quantity can be entered in a unit you pick: automation conditions and steps accept { value, unit }, converted to the stored unit, and a bare API number is accepted with a warning
+
+## [1.2.446] - 2026-10-29
+
+### Changed
+
+- The server-management capability reports the desktop app's version and update state and can ask it to install a downloaded update.
+
 ## [1.2.445] - 2026-10-29
 
 ### Added

package/dist/automation/action.d.ts

@@ -92,6 +92,7 @@ export declare const ActionEntrySchema: z.ZodObject<{
         cap: z.ZodString;
         method: z.ZodString;
         args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>], "kind">>>;
     variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -127,6 +128,7 @@ export declare const ActionInputSchema: z.ZodObject<{
         cap: z.ZodString;
         method: z.ZodString;
         args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>], "kind">>;
     variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;

package/dist/automation/index.d.ts

@@ -20,7 +20,9 @@ export type { CooldownInput, CooldownVerdict, RunGateAdmission } from './run-gat
 export { RunGate } from './run-gate.js';
 export type { AutomationConditionTraceNode, AutomationRunOutcome, AutomationRunTrace, AutomationRunVerdict, AutomationStateDoc, AutomationStepTrace, AutomationTriggerTrace, TraceNodeOutcome, TraceValue, } from './trace.js';
 export { AutomationConditionTraceNodeSchema, EMPTY_AUTOMATION_STATE, mergeSkipTraces, AutomationRunOutcomeSchema, AutomationRunTraceSchema, AutomationRunVerdictSchema, AutomationStateDocSchema, AutomationStepTraceSchema, AutomationTriggerTraceSchema, appendTrace, buildTriggerTrace, isSkippedTrace, skipSignature, TraceNodeOutcomeSchema, TraceValueSchema, } from './trace.js';
-export type { ActionStep, AutomationAction, AutomationCondition, AutomationConditionAll, AutomationConditionAny, AutomationConditionExpression, AutomationConditionLeaf, AutomationConditionNot, AutomationConditionOperator, AutomationConditionStationaryPresent, AutomationRecipe, AutomationRunMode, AutomationTrigger, } from './recipe.js';
+export type { ActionStep, AutomationAction, AutomationCapStep, AutomationCondition, AutomationConditionAll, AutomationConditionAny, AutomationConditionExpression, AutomationConditionLeaf, AutomationConditionNot, AutomationConditionOperator, AutomationConditionStationaryPresent, AutomationRecipe, AutomationRunMode, AutomationTrigger, } from './recipe.js';
 export { ActionStepSchema, AutomationActionSchema, AutomationCapStepSchema, AutomationWaitStepSchema, AutomationConditionOperatorSchema, AutomationConditionSchema, AutomationRecipeSchema, AutomationRunModeSchema, AutomationTriggerSchema, conditionDepth, countConditionLeaves, DEFAULT_TRACE_KEEP, MAX_TRACE_KEEP, MAX_CONDITION_DEPTH, MAX_CONDITION_LEAVES, validateRecipeBounds, } from './recipe.js';
 export * from './action.js';
 export * from './step-runner.js';
+export { UnitWarningSchema, capUnitResolver, normalizeActionUnits, normalizeConditionUnits, normalizeRecipeUnits, } from './normalize-units.js';
+export type { UnitResolver, UnitWarning, UnitsNormalized } from './normalize-units.js';

package/dist/automation/normalize-units.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The save boundary of the value + unit contract (D972).
+ *
+ * A number tied to a physical quantity is ENTERED in a unit the person picks
+ * and STORED in a fixed one:
+ *
+ *  - a condition leaf on a device field → the field's base unit (D944);
+ *  - a cap step arg → the unit the method's input declares (`paramMeta`).
+ *
+ * The write form of a number is {@link QuantityValue} (`{ value, unit }`,
+ * "this number is in this unit"). Normalising converts it, stores the bare
+ * number and records the picked unit (`leaf.unit` / `step.argUnits[arg]`) so an
+ * editor can show the number the way it was typed. Normalising an already
+ * normalised record changes nothing: a stored bare number is never converted
+ * again, which is why the picked unit is a separate field.
+ *
+ * A bare number on a quantity field is ACCEPTED as the base / declared unit
+ * and reported as a {@link UnitWarning}; a unit that cannot belong to the
+ * quantity is a typed {@link QuantityUnitError}.
+ *
+ * Pure: the cap knowledge arrives as a {@link UnitResolver}.
+ */
+import type { CapabilityDefinition } from '../capabilities/capability-definition.js';
+import { type ParamMeta } from '../units/quantity-input.js';
+import type { ReadingQuantity } from '../units/quantity.js';
+import { z } from 'zod';
+import type { AutomationAction, AutomationCapStep, AutomationCondition, AutomationRecipe } from './recipe.js';
+/** What the boundary needs to know about caps. */
+export interface UnitResolver {
+    /** The quantity of a status field, or `undefined` when it is not a quantity. */
+    fieldQuantity(cap: string, fieldPath: string): ReadingQuantity | undefined;
+    /** What a method input declares for `arg`, or `undefined` when it is not a quantity. */
+    paramMeta(cap: string, method: string, arg: string): ParamMeta | undefined;
+}
+/** A bare number accepted as a base unit — the save succeeded, say so. */
+export declare const UnitWarningSchema: z.ZodObject<{
+    path: z.ZodString;
+    deviceId: z.ZodOptional<z.ZodNumber>;
+    field: z.ZodString;
+    value: z.ZodNumber;
+    assumedUnit: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type UnitWarning = z.infer<typeof UnitWarningSchema>;
+export interface UnitsNormalized<T> {
+    readonly value: T;
+    readonly warnings: readonly UnitWarning[];
+}
+/** A resolver over capability definitions (the generated registry, or a fake). */
+export declare function capUnitResolver(defs: readonly CapabilityDefinition[]): UnitResolver;
+/** Normalise every leaf of a condition tree. Throws {@link QuantityUnitError}. */
+export declare function normalizeConditionUnits(condition: AutomationCondition, resolver: UnitResolver, path?: string): UnitsNormalized<AutomationCondition>;
+/**
+ * Normalise the cap steps of an action list (an internal Action's steps, or a
+ * recipe's actions). Other step kinds pass through. Throws {@link QuantityUnitError}.
+ */
+export declare function normalizeActionUnits<A extends AutomationAction>(actions: readonly A[], resolver: UnitResolver, path?: string): UnitsNormalized<(A | AutomationCapStep)[]>;
+/** Normalise a whole recipe: its condition tree and its actions. */
+export declare function normalizeRecipeUnits(recipe: AutomationRecipe, resolver: UnitResolver): UnitsNormalized<AutomationRecipe>;

package/dist/automation/recipe.d.ts

@@ -27,6 +27,7 @@
  */
 import { z } from 'zod';
 import { type ExpressionBindingSource } from '../expression/binding-source.js';
+import { type QuantityValue } from '../units/quantity-input.js';
 /**
  * Depth of a condition tree, counting the root container as level 1.
  *
@@ -58,7 +59,15 @@ export interface AutomationConditionLeaf {
     readonly cap: string;
     readonly fieldPath: string;
     readonly operator: AutomationConditionOperator;
-    readonly value: string | number | boolean | readonly (string | number)[];
+    /**
+     * The value. A number on a quantity field is stored in the field's base unit
+     * (D944); {@link QuantityValue} is the WRITE form — "this number is in this
+     * unit" — which the save boundary replaces with the converted number and
+     * `unit`. A leaf that still carries one is never evaluated (it fails).
+     */
+    readonly value: string | number | boolean | readonly (string | number)[] | QuantityValue;
+    /** The unit the person picked for `value` (display only; `value` is in the base unit). */
+    readonly unit?: string;
 }
 /** The escape hatch: the bounded expression engine over named device bindings. */
 export interface AutomationConditionExpression {
@@ -170,7 +179,9 @@ export declare const AutomationCapStepSchema: z.ZodObject<{
     cap: z.ZodString;
     method: z.ZodString;
     args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;
+export type AutomationCapStep = z.infer<typeof AutomationCapStepSchema>;
 /**
  * The steps an internal Action may contain: cap and wait, and nothing that can
  * call back into an Action — so an Action can never reach itself (no cycles).
@@ -186,6 +197,7 @@ export declare const ActionStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     cap: z.ZodString;
     method: z.ZodString;
     args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>], "kind">;
 export type ActionStep = z.infer<typeof ActionStepSchema>;
 export declare const AutomationActionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -199,6 +211,7 @@ export declare const AutomationActionSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     cap: z.ZodString;
     method: z.ZodString;
     args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"action">;
     actionId: z.ZodString;
@@ -289,6 +302,7 @@ export declare const AutomationRecipeSchema: z.ZodObject<{
         cap: z.ZodString;
         method: z.ZodString;
         args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"action">;
         actionId: z.ZodString;

package/dist/capabilities/action-source.cap.d.ts

@@ -42,6 +42,7 @@ export declare const actionSourceCapability: {
                 cap: z.ZodString;
                 method: z.ZodString;
                 args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             }, z.core.$strip>], "kind">>>;
             variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;

package/dist/capabilities/actions.cap.d.ts

@@ -31,6 +31,7 @@ export declare const actionsCapability: {
                 cap: z.ZodString;
                 method: z.ZodString;
                 args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             }, z.core.$strip>], "kind">>>;
             variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
@@ -79,6 +80,7 @@ export declare const actionsCapability: {
                     cap: z.ZodString;
                     method: z.ZodString;
                     args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 }, z.core.$strip>], "kind">>>;
                 variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     name: z.ZodString;
@@ -225,7 +227,15 @@ export declare const actionsCapability: {
                 lastAt: z.ZodNumber;
             }, z.core.$strip>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
-        /** Internal actions only. A read-only (addon) entry is refused with `[read-only]`. */
+        /**
+         * Internal actions only; a read-only (addon) entry is refused with `[read-only]`.
+         * Create an internal action. A cap step arg that is a physical quantity may
+         * be sent as `{ value, unit }` ("value expressed in unit"); the server
+         * converts it to the unit the method's input declares, stores the bare
+         * number plus the picked unit in `argUnits`, and refuses a unit of another
+         * dimension (`[invalid-steps]`). A bare number is taken as the declared
+         * unit and answered as a `warnings` entry (D972).
+         */
         readonly create: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             action: z.ZodObject<{
                 name: z.ZodString;
@@ -240,6 +250,7 @@ export declare const actionsCapability: {
                     cap: z.ZodString;
                     method: z.ZodString;
                     args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 }, z.core.$strip>], "kind">>;
                 variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     name: z.ZodString;
@@ -276,6 +287,7 @@ export declare const actionsCapability: {
                     cap: z.ZodString;
                     method: z.ZodString;
                     args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 }, z.core.$strip>], "kind">>>;
                 variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     name: z.ZodString;
@@ -296,6 +308,14 @@ export declare const actionsCapability: {
                     lastError: z.ZodNullable<z.ZodString>;
                 }, z.core.$strip>;
             }, z.core.$strip>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                deviceId: z.ZodOptional<z.ZodNumber>;
+                field: z.ZodString;
+                value: z.ZodNumber;
+                assumedUnit: z.ZodString;
+                message: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>, "mutation">;
         readonly update: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             actionId: z.ZodString;
@@ -312,6 +332,7 @@ export declare const actionsCapability: {
                     cap: z.ZodString;
                     method: z.ZodString;
                     args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 }, z.core.$strip>], "kind">>>;
                 variables: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
                     name: z.ZodString;
@@ -348,6 +369,7 @@ export declare const actionsCapability: {
                     cap: z.ZodString;
                     method: z.ZodString;
                     args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 }, z.core.$strip>], "kind">>>;
                 variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     name: z.ZodString;
@@ -368,6 +390,14 @@ export declare const actionsCapability: {
                     lastError: z.ZodNullable<z.ZodString>;
                 }, z.core.$strip>;
             }, z.core.$strip>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                deviceId: z.ZodOptional<z.ZodNumber>;
+                field: z.ZodString;
+                value: z.ZodNumber;
+                assumedUnit: z.ZodString;
+                message: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>, "mutation">;
         readonly delete: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             actionId: z.ZodString;
@@ -399,6 +429,7 @@ export declare const actionsCapability: {
                 cap: z.ZodString;
                 method: z.ZodString;
                 args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             }, z.core.$strip>], "kind">>>;
             variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;

package/dist/capabilities/core-blocks.cap.d.ts

@@ -188,6 +188,7 @@ export declare const CoreBlockSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             cap: z.ZodString;
             method: z.ZodString;
             args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"action">;
             actionId: z.ZodString;
@@ -731,6 +732,7 @@ export declare const CoreBlockSchema: z.ZodObject<{
                 cap: z.ZodString;
                 method: z.ZodString;
                 args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"action">;
                 actionId: z.ZodString;
@@ -1090,6 +1092,7 @@ export declare const CompositionViewSchema: z.ZodObject<{
                     cap: z.ZodString;
                     method: z.ZodString;
                     args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                 }, z.core.$strip>, z.ZodObject<{
                     kind: z.ZodLiteral<"action">;
                     actionId: z.ZodString;
@@ -1447,6 +1450,7 @@ export declare const CompositionListReadSchema: z.ZodDiscriminatedUnion<[z.ZodOb
                         cap: z.ZodString;
                         method: z.ZodString;
                         args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                        argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                     }, z.core.$strip>, z.ZodObject<{
                         kind: z.ZodLiteral<"action">;
                         actionId: z.ZodString;
@@ -1808,6 +1812,7 @@ export declare const CompositionGetReadSchema: z.ZodDiscriminatedUnion<[z.ZodObj
                         cap: z.ZodString;
                         method: z.ZodString;
                         args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                        argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                     }, z.core.$strip>, z.ZodObject<{
                         kind: z.ZodLiteral<"action">;
                         actionId: z.ZodString;
@@ -2170,6 +2175,7 @@ export declare const CompositionCustomizationReadSchema: z.ZodDiscriminatedUnion
                         cap: z.ZodString;
                         method: z.ZodString;
                         args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                        argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                     }, z.core.$strip>, z.ZodObject<{
                         kind: z.ZodLiteral<"action">;
                         actionId: z.ZodString;
@@ -2552,6 +2558,7 @@ export declare const coreBlocksCapability: {
                             cap: z.ZodString;
                             method: z.ZodString;
                             args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                            argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                         }, z.core.$strip>, z.ZodObject<{
                             kind: z.ZodLiteral<"action">;
                             actionId: z.ZodString;
@@ -2872,6 +2879,7 @@ export declare const coreBlocksCapability: {
                             cap: z.ZodString;
                             method: z.ZodString;
                             args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                            argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                         }, z.core.$strip>, z.ZodObject<{
                             kind: z.ZodLiteral<"action">;
                             actionId: z.ZodString;
@@ -3206,6 +3214,7 @@ export declare const coreBlocksCapability: {
                             cap: z.ZodString;
                             method: z.ZodString;
                             args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                            argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                         }, z.core.$strip>, z.ZodObject<{
                             kind: z.ZodLiteral<"action">;
                             actionId: z.ZodString;
@@ -3538,6 +3547,7 @@ export declare const coreBlocksCapability: {
                             cap: z.ZodString;
                             method: z.ZodString;
                             args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                            argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                         }, z.core.$strip>, z.ZodObject<{
                             kind: z.ZodLiteral<"action">;
                             actionId: z.ZodString;
@@ -3866,6 +3876,7 @@ export declare const coreBlocksCapability: {
                             cap: z.ZodString;
                             method: z.ZodString;
                             args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                            argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                         }, z.core.$strip>, z.ZodObject<{
                             kind: z.ZodLiteral<"action">;
                             actionId: z.ZodString;
@@ -4199,6 +4210,7 @@ export declare const coreBlocksCapability: {
                             cap: z.ZodString;
                             method: z.ZodString;
                             args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                            argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                         }, z.core.$strip>, z.ZodObject<{
                             kind: z.ZodLiteral<"action">;
                             actionId: z.ZodString;
@@ -4838,6 +4850,7 @@ export declare const coreBlocksCapability: {
                             cap: z.ZodString;
                             method: z.ZodString;
                             args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                            argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                         }, z.core.$strip>, z.ZodObject<{
                             kind: z.ZodLiteral<"action">;
                             actionId: z.ZodString;
@@ -5381,6 +5394,7 @@ export declare const coreBlocksCapability: {
                             cap: z.ZodString;
                             method: z.ZodString;
                             args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                            argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                         }, z.core.$strip>, z.ZodObject<{
                             kind: z.ZodLiteral<"action">;
                             actionId: z.ZodString;
@@ -5706,6 +5720,7 @@ export declare const coreBlocksCapability: {
                                 cap: z.ZodString;
                                 method: z.ZodString;
                                 args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                                argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                             }, z.core.$strip>, z.ZodObject<{
                                 kind: z.ZodLiteral<"action">;
                                 actionId: z.ZodString;
@@ -6066,6 +6081,7 @@ export declare const coreBlocksCapability: {
                                 cap: z.ZodString;
                                 method: z.ZodString;
                                 args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                                argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                             }, z.core.$strip>, z.ZodObject<{
                                 kind: z.ZodLiteral<"action">;
                                 actionId: z.ZodString;
@@ -6433,6 +6449,7 @@ export declare const coreBlocksCapability: {
                                 cap: z.ZodString;
                                 method: z.ZodString;
                                 args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                                argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                             }, z.core.$strip>, z.ZodObject<{
                                 kind: z.ZodLiteral<"action">;
                                 actionId: z.ZodString;

package/dist/capabilities/index.d.ts

@@ -119,7 +119,7 @@ export { CameraMetricsSchema, CameraMetricsWithDeviceIdSchema, OrchestratorMetri
 export type { AudioStreamPick, CameraStream, CamProfile, CamStreamKind, DecodedAudioChunkWire, ProfileRtspEntry, ProfileSlot, ProfileSlotStatus, SubscribeAudioChunksInput, SubscribeAudioChunksResult, } from './schemas/streaming-shared.js';
 export { AudioChunkFormatSchema, AudioStreamPickSchema, BrokerStatsSchema, BrokerStatusSchema, CAM_PROFILE_ORDER, CameraStreamSchema, CamProfileSchema, CamStreamKindSchema, CamStreamResolutionSchema, DecodedAudioChunkSchema, FrameHandleSchema, makeProfileBrokerId, makeSourceBrokerId, ProfileRtspEntrySchema, ProfileSlotSchema, ProfileSlotStatusSchema, parseProfileBrokerId, StreamSourceEntrySchema, StreamSourceSchema, SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, selectAssignedProfileSlots, } from './schemas/streaming-shared.js';
 export { buildEventKindDescriptor, EVENT_KIND_BY_CAP, EVENTFUL_CAP_NAMES, type SensorEventKindDescriptor, } from './sensor-event-kinds.js';
-export { type ImageContract, ImageContractSchema, type ImageContractState, ImageContractStateSchema, type IServerManagementProvider, type RunnerBootCheck, RunnerBootCheckSchema, type RunnerRefusal, RunnerRefusalSchema, type ServerBootMode, ServerBootModeSchema, type ServerPackageStatus, ServerPackageStatusSchema, type ServerRollbackInfo, ServerRollbackInfoSchema, type LaunchOverrides, type SetLaunchOverridesResult, type ServerUpdateActionResult, ServerUpdateActionResultSchema, type ServerUpdateCheckResult, ServerUpdateCheckResultSchema, type ServerUpdateOutcome, ServerUpdateOutcomeSchema, type ServerUpdateState, ServerUpdateStateSchema, serverManagementCapability, type UpdateBlocker, UpdateBlockerSchema, type WrapperEvidence, WrapperEvidenceSchema, type WrapperIdentity, WrapperIdentitySchema, type WrapperKind, WrapperKindSchema, } from './server-management.cap.js';
+export { type ImageContract, ImageContractSchema, type ImageContractState, ImageContractStateSchema, type IServerManagementProvider, type RunnerBootCheck, RunnerBootCheckSchema, type RunnerRefusal, RunnerRefusalSchema, type ServerBootMode, ServerBootModeSchema, type ServerPackageStatus, ServerPackageStatusSchema, type ServerRollbackInfo, ServerRollbackInfoSchema, type LaunchOverrides, type SetLaunchOverridesResult, type ServerUpdateActionResult, ServerUpdateActionResultSchema, type ServerUpdateCheckResult, ServerUpdateCheckResultSchema, type ServerUpdateOutcome, ServerUpdateOutcomeSchema, type ServerUpdateState, ServerUpdateStateSchema, serverManagementCapability, type UpdateBlocker, UpdateBlockerSchema, type DesktopAppStatus, DesktopAppStatusSchema, type InstallDesktopUpdateReason, InstallDesktopUpdateReasonSchema, type InstallDesktopUpdateResult, InstallDesktopUpdateResultSchema, type WrapperEvidence, WrapperEvidenceSchema, type WrapperIdentity, WrapperIdentitySchema, type WrapperKind, WrapperKindSchema, } from './server-management.cap.js';
 export { type BulkRecord, BulkRecordSchema, type CollectionColumn, CollectionColumnSchema, type CollectionIndex, CollectionIndexSchema, DATA_STORE_DATABASES, type DataStoreDatabase, DataStoreDatabaseSchema, type DeclareCollectionInput, DeclareCollectionInputSchema, type ISettingsStoreProvider, type MutationFilter, MutationFilterSchema, QueryFilterSchema, SettingsRecordSchema, type SettingsStoreClient, settingsStoreCapability, } from './settings-store.cap.js';
 export type { ISmtpProvider } from './smtp-provider.cap.js';
 export { SendEmailInputSchema, SendEmailResultSchema, SmtpStatusSchema, smtpProviderCapability, } from './smtp-provider.cap.js';

package/dist/capabilities/remote.cap.d.ts

@@ -124,6 +124,7 @@ export declare const remoteCapability: {
                     cap: z.ZodString;
                     method: z.ZodString;
                     args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                     deviceId: z.ZodNumber;
                 }, z.core.$strip>;
             }, z.core.$strip>>;
@@ -149,6 +150,7 @@ export declare const remoteCapability: {
                         cap: z.ZodString;
                         method: z.ZodString;
                         args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                        argUnits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                         deviceId: z.ZodNumber;
                     }, z.core.$strip>;
                 }, z.core.$strip>>;

package/dist/capabilities/server-management.cap.d.ts

@@ -167,11 +167,13 @@ declare const WrapperEvidenceSchema: z.ZodObject<{
  * The shell verdict (see {@link WrapperKindSchema}) with the proofs that
  * produced it.
  *
- * There is deliberately NO `canSelfUpdate` and no apply action: a wrapper
- * update is an ANNOUNCEMENT. The notification body carries the exact command
- * for a `docker` shell and says the app restarts into the new build for
- * `electron`, and that sentence is chosen from `kind` alone — a boolean
- * nothing reads is the defect this repo keeps paying for.
+ * There is deliberately NO `canSelfUpdate` boolean: a wrapper update is an
+ * ANNOUNCEMENT. The notification body carries the exact command for a `docker`
+ * shell and says the app restarts into the new build for `electron`, and that
+ * sentence is chosen from `kind` alone — a boolean nothing reads is the defect
+ * this repo keeps paying for. The one shell that CAN be acted on is the
+ * Electron app, and only through `installDesktopUpdate` (see
+ * {@link DesktopAppStatusSchema} for what the node reads from the app first).
  */
 declare const WrapperIdentitySchema: z.ZodObject<{
     kind: z.ZodEnum<{
@@ -203,6 +205,50 @@ declare const ServerRollbackInfoSchema: z.ZodObject<{
     atMs: z.ZodNumber;
     reason: z.ZodString;
 }, z.core.$strip>;
+/**
+ * What the native desktop app (Electron) that hosts this node says about
+ * itself, read from `<dataDir>/server-root/desktop-app-state.json` (ADR-0971).
+ * Absent on the status = no desktop app, or it never wrote the file.
+ *
+ * `stale` is the honest answer to an app that stopped writing (closed, hung,
+ * crashed): the update facts are then the LAST ones known, not current ones,
+ * and a consumer must not read `update.available: false` from a stale record
+ * as "no update". `stateAtMs` is when the app last wrote.
+ */
+declare const DesktopAppStatusSchema: z.ZodObject<{
+    version: z.ZodString;
+    update: z.ZodObject<{
+        available: z.ZodBoolean;
+        downloaded: z.ZodBoolean;
+        version: z.ZodNullable<z.ZodString>;
+        checking: z.ZodBoolean;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    stateAtMs: z.ZodNumber;
+    stale: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Why `installDesktopUpdate` did nothing. Stable names a UI maps to a sentence:
+ *  - `not-electron`   — this node does not run inside the desktop app.
+ *  - `no-app-state`   — the app never published its state (or the file is unreadable).
+ *  - `app-state-stale` — the app stopped writing; it is probably not running.
+ *  - `not-downloaded` — no update is downloaded yet; nothing to install.
+ */
+declare const InstallDesktopUpdateReasonSchema: z.ZodEnum<{
+    "app-state-stale": "app-state-stale";
+    "no-app-state": "no-app-state";
+    "not-downloaded": "not-downloaded";
+    "not-electron": "not-electron";
+}>;
+declare const InstallDesktopUpdateResultSchema: z.ZodObject<{
+    accepted: z.ZodBoolean;
+    reason: z.ZodNullable<z.ZodEnum<{
+        "app-state-stale": "app-state-stale";
+        "no-app-state": "no-app-state";
+        "not-downloaded": "not-downloaded";
+        "not-electron": "not-electron";
+    }>>;
+}, z.core.$strip>;
 /**
  * The runner boot check (D877): the runners this node PLANNED (hub: one per
  * `resolveRunnerId` over its forked addons; agent: the runners its process
@@ -319,6 +365,18 @@ declare const ServerPackageStatusSchema: z.ZodObject<{
         pending: z.ZodOptional<z.ZodArray<z.ZodString>>;
         planKnown: z.ZodBoolean;
     }, z.core.$strip>>;
+    desktopApp: z.ZodOptional<z.ZodObject<{
+        version: z.ZodString;
+        update: z.ZodObject<{
+            available: z.ZodBoolean;
+            downloaded: z.ZodBoolean;
+            version: z.ZodNullable<z.ZodString>;
+            checking: z.ZodBoolean;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        stateAtMs: z.ZodNumber;
+        stale: z.ZodBoolean;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const ServerUpdateCheckResultSchema: z.ZodObject<{
     packageName: z.ZodString;
@@ -477,6 +535,18 @@ export declare const serverManagementCapability: {
                 pending: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 planKnown: z.ZodBoolean;
             }, z.core.$strip>>;
+            desktopApp: z.ZodOptional<z.ZodObject<{
+                version: z.ZodString;
+                update: z.ZodObject<{
+                    available: z.ZodBoolean;
+                    downloaded: z.ZodBoolean;
+                    version: z.ZodNullable<z.ZodString>;
+                    checking: z.ZodBoolean;
+                    error: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+                stateAtMs: z.ZodNumber;
+                stale: z.ZodBoolean;
+            }, z.core.$strip>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly checkServerUpdate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
             packageName: z.ZodString;
@@ -511,6 +581,24 @@ export declare const serverManagementCapability: {
                 remedy: z.ZodString;
             }, z.core.$strip>>>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * Ask the desktop app hosting this node to install its DOWNLOADED update
+         * and restart. The request is a file in the node's data dir (the node may
+         * be a Windows service, not Electron's child); the app consumes it once.
+         * `accepted: true` means the request was WRITTEN — the app restarting is
+         * observed afterwards on `desktopApp.version`, not promised here. Refused
+         * with a named `reason` when not an electron shell, the app's state is
+         * absent or stale, or nothing is downloaded.
+         */
+        readonly installDesktopUpdate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            accepted: z.ZodBoolean;
+            reason: z.ZodNullable<z.ZodEnum<{
+                "app-state-stale": "app-state-stale";
+                "no-app-state": "no-app-state";
+                "not-downloaded": "not-downloaded";
+                "not-electron": "not-electron";
+            }>>;
+        }, z.core.$strip>, "mutation">;
         readonly rollbackServerUpdate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
             accepted: z.ZodBoolean;
             targetVersion: z.ZodNullable<z.ZodString>;
@@ -591,6 +679,9 @@ export type ImageContract = z.infer<typeof ImageContractSchema>;
 export type WrapperKind = z.infer<typeof WrapperKindSchema>;
 export type WrapperEvidence = z.infer<typeof WrapperEvidenceSchema>;
 export type WrapperIdentity = z.infer<typeof WrapperIdentitySchema>;
+export type DesktopAppStatus = z.infer<typeof DesktopAppStatusSchema>;
+export type InstallDesktopUpdateReason = z.infer<typeof InstallDesktopUpdateReasonSchema>;
+export type InstallDesktopUpdateResult = z.infer<typeof InstallDesktopUpdateResultSchema>;
 export type ServerRollbackInfo = z.infer<typeof ServerRollbackInfoSchema>;
 export type ServerPackageStatus = z.infer<typeof ServerPackageStatusSchema>;
 export type ServerUpdateCheckResult = z.infer<typeof ServerUpdateCheckResultSchema>;
@@ -601,4 +692,4 @@ export type SetLaunchOverridesResult = z.infer<typeof SetLaunchOverridesResultSc
 export type RunnerBootCheck = z.infer<typeof RunnerBootCheckSchema>;
 export type RunnerRefusal = z.infer<typeof RunnerRefusalSchema>;
 export type UpdateBlocker = z.infer<typeof UpdateBlockerSchema>;
-export { RunnerBootCheckSchema, RunnerRefusalSchema, UpdateBlockerSchema, ServerBootModeSchema, ServerUpdateStateSchema, ImageContractStateSchema, ImageContractSchema, WrapperKindSchema, WrapperEvidenceSchema, WrapperIdentitySchema, ServerRollbackInfoSchema, ServerPackageStatusSchema, ServerUpdateCheckResultSchema, ServerUpdateOutcomeSchema, ServerUpdateActionResultSchema, };
+export { RunnerBootCheckSchema, RunnerRefusalSchema, UpdateBlockerSchema, ServerBootModeSchema, ServerUpdateStateSchema, ImageContractStateSchema, ImageContractSchema, WrapperKindSchema, WrapperEvidenceSchema, WrapperIdentitySchema, DesktopAppStatusSchema, InstallDesktopUpdateReasonSchema, InstallDesktopUpdateResultSchema, ServerRollbackInfoSchema, ServerPackageStatusSchema, ServerUpdateCheckResultSchema, ServerUpdateOutcomeSchema, ServerUpdateActionResultSchema, };

package/dist/client.js

@@ -28969,6 +28969,7 @@ function createSystemProxy(api) {
 			getServerPackageStatus: (input) => dispatch("serverManagement", "getServerPackageStatus", "query", input),
 			checkServerUpdate: (input) => dispatch("serverManagement", "checkServerUpdate", "mutation", input),
 			applyServerUpdate: (input) => dispatch("serverManagement", "applyServerUpdate", "mutation", input),
+			installDesktopUpdate: (input) => dispatch("serverManagement", "installDesktopUpdate", "mutation", input),
 			rollbackServerUpdate: (input) => dispatch("serverManagement", "rollbackServerUpdate", "mutation", input),
 			restartServer: (input) => dispatch("serverManagement", "restartServer", "mutation", input),
 			getLaunchOverrides: (input) => dispatch("serverManagement", "getLaunchOverrides", "query", input),

package/dist/client.mjs

@@ -28968,6 +28968,7 @@ function createSystemProxy(api) {
 			getServerPackageStatus: (input) => dispatch("serverManagement", "getServerPackageStatus", "query", input),
 			checkServerUpdate: (input) => dispatch("serverManagement", "checkServerUpdate", "mutation", input),
 			applyServerUpdate: (input) => dispatch("serverManagement", "applyServerUpdate", "mutation", input),
+			installDesktopUpdate: (input) => dispatch("serverManagement", "installDesktopUpdate", "mutation", input),
 			rollbackServerUpdate: (input) => dispatch("serverManagement", "rollbackServerUpdate", "mutation", input),
 			restartServer: (input) => dispatch("serverManagement", "restartServer", "mutation", input),
 			getLaunchOverrides: (input) => dispatch("serverManagement", "getLaunchOverrides", "query", input),

package/dist/device/cap-vocabulary/types.d.ts

@@ -20,6 +20,7 @@ import type * as CapRegistry from '../../generated/capability-router-map.js';
 import type { EventCategory } from '../../enums/event-category.js';
 import type { ICON_KEYS } from '../icon-catalog.generated.js';
 import type { DeviceRole, DeviceType } from '../device-type.js';
+import type { ReadingQuantity } from '../../units/quantity.js';
 /** One catalog icon key (lucide id) — the same vocabulary as `IconKey`. */
 export type VocabIcon = (typeof ICON_KEYS)[number];
 /** A human string in every language the map carries. */
@@ -82,13 +83,20 @@ export interface EnumOffer {
     readonly kind: 'enum';
     readonly values: readonly VocabChoice[];
 }
-/** A number, within the Zod input's bounds. `unit` is a display suffix. */
+/**
+ * A number, within the Zod input's bounds. With `quantity` the number is a
+ * physical quantity: `unit` is the unit the METHOD expects (what its input
+ * declares with `paramMeta`) and a client lets the person pick any unit of
+ * that quantity (`unitsForQuantity`), converting to `unit` before the call.
+ * Without `quantity`, `unit` is only a display suffix.
+ */
 export interface NumberOffer {
     readonly kind: 'number';
     readonly min?: number;
     readonly max?: number;
     readonly step?: number;
     readonly unit?: string;
+    readonly quantity?: ReadingQuantity;
 }
 /** Free text. */
 export interface TextOffer {