@camstack/types 1.2.446 → 1.2.447

package/CHANGELOG.md

@@ -7,6 +7,12 @@ 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

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/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/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 {

package/dist/index.d.ts

@@ -163,8 +163,10 @@ export { APP_FLOW_DEFAULT_REDIRECT, APP_FLOW_REFUSAL_MESSAGES, APP_FLOW_STATE_PR
 export { SSO_STATE_COOKIE, SSO_STATE_COOKIE_MAX_AGE_SEC } from './auth/sso-state.js';
 export { buildDeviceEnrollmentLink, buildDeviceSignatureMessage, type CompleteEnrollmentInput, CompleteEnrollmentInputSchema, type CompleteEnrollmentOutput, CompleteEnrollmentOutputSchema, DEVICE_CERT_RENEW_WINDOW_DAYS, DEVICE_CERT_SIGNATURE, DEVICE_CERT_VALIDITY_DAYS, DEVICE_ENROLLMENT_TTL_MS, DEVICE_NONCE_TTL_MS, DEVICE_SAN_CREDENTIAL_PREFIX, DEVICE_SAN_USER_PREFIX, DEVICE_SIGNATURE_MESSAGE_VERSION, type DeviceCertificateLoginMethod, DeviceCertificateLoginMethodSchema, type DeviceChallenge, DeviceChallengeSchema, type DeviceCredential, DeviceCredentialSchema, type DeviceCredentialStatus, DeviceCredentialStatusSchema, type DevicePlatform, DevicePlatformSchema, type DeviceProofInput, DeviceProofInputSchema, type CompleteEnrollmentResult, CompleteEnrollmentResultSchema, DEFINITIVE_DEVICE_REFUSALS, DEVICE_DEFINITIVE_REFUSALS_BEFORE_DELETE, DEVICE_REFRESH_REFUSAL_PREFIX, deviceRefusalFromMessage, type DeviceChallengeResult, DeviceChallengeResultSchema, DeviceEnrollProofSchema, type DeviceRefusal, type DeviceRefusalReason, DeviceRefusalReasonSchema, DeviceRefusalSchema, type DeviceRevoker, type EnrollSelfInput, EnrollSelfInputSchema, formatDeviceRevoker, isDefinitiveDeviceRefusal, type RenewDeviceCertificateResult, RenewDeviceCertificateResultSchema, type RevokeOwnDeviceCertificateResult, RevokeOwnDeviceCertificateResultSchema, type DeviceSignaturePurpose, DeviceSignaturePurposeSchema, type RenewDeviceCertificateOutput, RenewDeviceCertificateOutputSchema, type StartEnrollmentOutput, StartEnrollmentOutputSchema, parseDeviceEnrollmentLink, } from './auth/device-certificate.js';
 export { advertisedHubOrigins, claimedRequestOrigins, normalizeOrigin, pickRequestOrigin, type RequestHeaders, requestMountPrefix, } from './auth/request-origin.js';
-export type { ActionStep, AutomationAction, AutomationCondition, AutomationConditionAll, AutomationConditionAny, AutomationConditionExpression, AutomationConditionLeaf, AutomationConditionStationaryPresent, AutomationConditionNot, AutomationConditionOperator, AutomationConditionTraceNode, AutomationRecipe, AutomationRunMode, AutomationRunOutcome, AutomationRunTrace, AutomationRunVerdict, AutomationStateDoc, AutomationStepTrace, AutomationTrigger, AutomationTriggerTrace, ConditionEvaluation, ConditionReader, DetectionDecision, DetectionTrigger, DetectionVars, GenerateAutomationBlockInput, MirrorRefreshFetchers, MirrorRefreshReport, MirrorSource, StationaryChangedInput, StationaryDecision, StationaryTrigger, StationaryVars, TraceNodeOutcome, TraceValue, TrackLifecycleInput, } from './automation/index.js';
+export type { ActionStep, AutomationAction, AutomationCapStep, AutomationCondition, AutomationConditionAll, AutomationConditionAny, AutomationConditionExpression, AutomationConditionLeaf, AutomationConditionStationaryPresent, AutomationConditionNot, AutomationConditionOperator, AutomationConditionTraceNode, AutomationRecipe, AutomationRunMode, AutomationRunOutcome, AutomationRunTrace, AutomationRunVerdict, AutomationStateDoc, AutomationStepTrace, AutomationTrigger, AutomationTriggerTrace, ConditionEvaluation, ConditionReader, DetectionDecision, DetectionTrigger, DetectionVars, GenerateAutomationBlockInput, MirrorRefreshFetchers, MirrorRefreshReport, MirrorSource, StationaryChangedInput, StationaryDecision, StationaryTrigger, StationaryVars, TraceNodeOutcome, TraceValue, TrackLifecycleInput, } from './automation/index.js';
 export { ActionStepSchema, AutomationActionSchema, AutomationCapStepSchema, AutomationWaitStepSchema, EMPTY_AUTOMATION_STATE, mergeSkipTraces, AutomationConditionOperatorSchema, AutomationConditionSchema, AutomationConditionTraceNodeSchema, AutomationRecipeSchema, AutomationRunModeSchema, AutomationRunOutcomeSchema, AutomationRunTraceSchema, AutomationRunVerdictSchema, AutomationStateDocSchema, AutomationStepTraceSchema, AutomationTriggerSchema, AutomationTriggerTraceSchema, appendTrace, buildTriggerTrace, collectMirrorSources, ConditionMirror, conditionDepth, countConditionLeaves, DEFAULT_TRACE_KEEP, DetectionTriggerFilter, detectionClassMatches, evaluateConditionTree, evaluateStationaryTrigger, generateAutomationBlock, isSkippedTrace, MAX_CONDITION_DEPTH, MAX_CONDITION_LEAVES, MAX_TRACE_KEEP, RunGate, skipSignature, TraceNodeOutcomeSchema, TraceValueSchema, validateRecipeBounds, } from './automation/index.js';
+export { UnitWarningSchema, capUnitResolver, normalizeActionUnits, normalizeConditionUnits, normalizeRecipeUnits, } from './automation/index.js';
+export type { UnitResolver, UnitWarning, UnitsNormalized } from './automation/index.js';
 export * from './automation/action.js';
 export * from './automation/step-runner.js';
 export * from './automation/export-entities.js';