@camstack/types 1.2.443 → 1.2.445

package/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.445] - 2026-10-29
+
+### Added
+
+- server-management can read and set a node's launch overrides
+
+## [1.2.444] - 2026-10-29
+
+### Added
+
+- Device exporters can declare that they also expose actions and notification targets (device-export entity methods).
+- A composed device of a new type can now be commanded: each method of its capability forwards to one method of a source device
+- A pet fountain device type with a pet-fountain capability (water level, drinking totals, pump controls)
+- A preset to build a pet fountain device from loose entities, with forwarded pump commands and a resettable filter
+
+### Changed
+
+- Node memory is nullable on the metrics and topology contracts: a failed read is unknown, not 0 or 100
+- server-management gains getLaunchOverrides / setLaunchOverrides, the per-node heap-ceiling override
+
 ## [1.2.443] - 2026-10-29
 
 ### Added

package/dist/addon.d.ts

@@ -23,7 +23,11 @@ export { nodePin, readNodePin } from './cap-call-context.js';
 export type { IAdminUiProvider } from './capabilities/admin-ui.cap.js';
 export { adminUiCapability } from './capabilities/admin-ui.cap.js';
 export { expandCapMethods } from './capabilities/capability-definition.js';
-export { describeCustomActions } from './capabilities/custom-actions.js';
+export { customAction, defineCustomActions, describeCustomActions, } from './capabilities/custom-actions.js';
+export { PipelineRunResultBridge, PipelineStepInputSchema, } from './capabilities/pipeline-step-input.js';
+export type { PipelineStepInputOutput } from './capabilities/pipeline-step-input.js';
+export { defineRecordKinds } from './records/record-kind.js';
+export { addonPagesSourceCapability } from './capabilities/addon-pages-source.cap.js';
 export { CALLER_STAMPED_CAPABILITIES, withoutCallerStamp, } from './capabilities/caller-stamp.js';
 export { deviceOpsCapability } from './capabilities/device-ops.cap.js';
 export type { IViewerUiProvider } from './capabilities/viewer-ui.cap.js';

package/dist/addon.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-E7qAQwTE.js");
+const require_sleep = require("./sleep-UXDHn-oJ.js");
 const require_event_category = require("./event-category-E17zaHjN.js");
-const require_err_msg = require("./err-msg-COHgq7Mb.js");
+const require_err_msg = require("./err-msg-EJhsFHqa.js");
 //#region src/generated/cap-input-defaults.ts
 /**
 * AUTO-GENERATED by scripts/generate-cap-input-defaults.ts — DO NOT EDIT.
@@ -367,7 +367,7 @@ function materialise(defaults) {
 * barrel (`ALL_CAPABILITY_DEFINITIONS`), which would cost ~144MB RSS per
 * forked runner. See docs/decisions/adr-0028.md.
 *
-* Coverage: 28 collection caps, 46 array methods.
+* Coverage: 28 collection caps, 48 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"action-source": ["listActions"],
@@ -378,7 +378,12 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"calendar-source": ["listCalendars", "listEvents"],
 	"custom-model-registry": ["listModels"],
 	"data-store-provider": ["histogram", "query"],
-	"device-export": ["listExposedDevices", "listSupportedDeviceKinds"],
+	"device-export": [
+		"listExposedDevices",
+		"listExposedEntities",
+		"listSupportedDeviceKinds",
+		"listSupportedEntityKinds"
+	],
 	"device-extension": ["listSlots", "listSources"],
 	"device-provider": ["discoverDevices", "getDevices"],
 	"device-removal-hook": ["listDeviceData"],
@@ -429,9 +434,15 @@ function isCollectionArrayMethodName(capName, method) {
 * Per capability, the methods declared `optionalMethod` — the ones whose
 * ABSENCE on a provider is a fact about that provider, not a bug.
 *
-* Coverage: 2 caps, 7 methods.
+* Coverage: 3 caps, 11 methods.
 */
 var PROVIDER_OPTIONAL_METHODS = Object.freeze({
+	"device-export": [
+		"exposeEntity",
+		"listExposedEntities",
+		"listSupportedEntityKinds",
+		"unexposeEntity"
+	],
 	"log-destination": [
 		"cancelRead",
 		"describeRead",
@@ -488,6 +499,8 @@ exports.PEER_BYTES_MAX_OUTSTANDING = require_sleep.PEER_BYTES_MAX_OUTSTANDING;
 exports.PEER_BYTES_STALL_MS = require_sleep.PEER_BYTES_STALL_MS;
 exports.PEER_BYTES_TICKET_TTL_MS = require_sleep.PEER_BYTES_TICKET_TTL_MS;
 exports.PROVIDER_OPTIONAL_METHODS = PROVIDER_OPTIONAL_METHODS;
+exports.PipelineRunResultBridge = require_sleep.PipelineRunResultBridge;
+exports.PipelineStepInputSchema = require_sleep.PipelineStepInputSchema;
 exports.PlaintextSecretError = require_sleep.PlaintextSecretError;
 exports.RECORDS_ERROR_CODES = require_sleep.RECORDS_ERROR_CODES;
 exports.RECORD_BATCH_MAX = require_sleep.RECORD_BATCH_MAX;
@@ -525,6 +538,7 @@ exports.StoredRecordKindDeclarationSchema = require_sleep.StoredRecordKindDeclar
 exports.TransactRefusedError = require_sleep.TransactRefusedError;
 exports.UnindexedFilterError = require_sleep.UnindexedFilterError;
 exports.UnknownRecordKindError = require_sleep.UnknownRecordKindError;
+exports.addonPagesSourceCapability = require_sleep.addonPagesSourceCapability;
 exports.addonSliceHandleApi = require_sleep.addonSliceHandleApi;
 exports.adminUiCapability = require_sleep.adminUiCapability;
 exports.arrayItemFieldPath = require_sleep.arrayItemFieldPath;
@@ -543,7 +557,9 @@ exports.createEvent = require_sleep.createEvent;
 exports.createEventBusSliceSource = require_sleep.createEventBusSliceSource;
 exports.createRecordsAccess = require_sleep.createRecordsAccess;
 exports.createSecretsAccess = require_sleep.createSecretsAccess;
+exports.customAction = require_sleep.customAction;
 exports.declarationsOf = require_sleep.declarationsOf;
+exports.defineCustomActions = require_sleep.defineCustomActions;
 exports.defineEntryKind = require_sleep.defineEntryKind;
 exports.defineRecordKinds = require_sleep.defineRecordKinds;
 exports.describeCustomActions = require_sleep.describeCustomActions;

package/dist/addon.mjs

@@ -1,6 +1,6 @@
-import { $ as expandCapMethods, $n as REVALIDATE_AFTER_MS, $r as isSecretMarker, $t as RecordFieldPathSchema, A as HF_REPO, An as RecordUniqueViolationError, Ar as buildSecretRef, B as withoutCallerStamp, Bn as RECORD_CLASSES, C as addonSliceHandleApi, Cn as InvalidRecordError, Dn as RecordNotFoundError, En as RECORDS_ERROR_CODES, Fn as UnknownRecordKindError, Fr as parseSecretRef, G as adminUiCapability, Gn as RECORD_MAX_DATA_BYTES, Hn as RECORD_DEFAULT_MAX_DATA_BYTES, I as deviceOpsCapability, In as asRecordsError, Jn as RECORD_QUERY_MAX, Jt as defineEntryKind, Kn as RECORD_MAX_INDEXES, L as viewerUiCapability, Ln as recordsErrorFromMessage, M as CAP_ADVANCE_FIELDS, Mn as RevConflictError, Mr as globalSecretScope, Nn as TransactRefusedError, Nr as isSecretRef, On as RecordSecretUnavailableError, Or as SECRET_REF_SCHEME, P as CAP_STATE_LEAVES, Pn as UnindexedFilterError, Pr as normalizeSecretOwner, Qn as resolveSecretViewsIn, Qr as isSecretFieldView, Qt as EntryDescriptorSchema, R as DEVICE_CHILDREN_BATCH_MAX, Rn as RECORD_BATCH_MAX, Rr as createEvent, Sn as ForeignSecretMarkerError, Tn as PlaintextSecretError, U as describeCustomActions, Un as RECORD_DELETE_BATCH, Vn as RECORD_DATABASES, Wn as RECORD_ID_MAX_LENGTH, Xn as RECORD_SETTINGS_MAX_ROWS, Xr as classifySecretWrite, Xt as createRecordsAccess, Yn as RECORD_SECRET_COLLECTION_PREFIX, Yr as SECRET_CLEAR, Yt as entryBody, Zn as RECORD_SWEEP_INTERVAL_MS, Zr as isSecretClear, Zt as assertTransactScope, _ as readErrorI18n, _n as collectZodSecretPaths, an as assertValidDeclaration, ar as registerKnownSecret, b as isDeviceScopedCap, bn as DeclarationRefusedError, c as asString, cn as REMOVE_LEAF, cr as PEER_BYTES_CHUNK_BYTES, ct as readNodePin, d as parseJsonUnknown, dn as parseSecretPath, dr as PEER_BYTES_TICKET_TTL_MS, dt as ReadinessRegistry, ei as isSecretMarkerLike, en as RecordIndexSchema, er as createSecretsAccess, f as hfModelUrl, fn as recordArrayItemPath, ft as ReadinessTimeoutError, g as ErrorI18nPayloadSchema, gr as BaseAddon, hn as secretArrayPrefixes, hr as DisposerChain, ht as scopeKey, in as StoredRecordKindDeclarationSchema, ir as knownSecretCount, jn as RecordsError, jr as formatSecretScope, kn as RecordTooLargeError, kr as arrayItemFieldPath, ln as collectSecretLeaves, lr as PEER_BYTES_MAX_OUTSTANDING, mn as recordSecretRef, ni as toSecretFieldView, nn as RecordKindNameSchema, nr as clearKnownSecrets, o as asJsonObject, on as declarationsOf, or as scrubKnownSecrets, p as BOOT_RECOVERY_BACKOFF_MS, pn as recordSecretCollection, pr as DATAPLANE_SECRET_HEADER, qn as RECORD_MAX_INDEX_FIELDS, qt as makeInMemoryRecords, r as maskUrlCredentials, rn as RecordRetentionSchema, rr as forgetKnownSecret, sn as defineRecordKinds, sr as shortSecretRefHash, st as nodePin, t as sleep, ti as makeSecretMarker, tn as RecordKindDeclarationSchema, tr as MIN_SCRUBBED_LENGTH, un as mapSecretLeaves, ur as PEER_BYTES_STALL_MS, ut as MODEL_FORMATS, vn as isZodSecret, vr as normalizeAddonInitResult, w as createEventBusSliceSource, wn as NoCallerError, x as createDeviceProxy, xn as FilterRequiredError, y as DEVICE_SCOPED_CAPS, yn as BatchTooLargeError, z as CALLER_STAMPED_CAPABILITIES, zn as RECORD_BATCH_MAX_BYTES, zr as emitReadiness } from "./sleep-C_u6cEAJ.mjs";
+import { $n as RECORD_SECRET_COLLECTION_PREFIX, $r as SECRET_CLEAR, $t as entryBody, A as HF_REPO, An as RECORDS_ERROR_CODES, B as DEVICE_CHILDREN_BATCH_MAX, Bn as asRecordsError, C as addonSliceHandleApi, Cn as BatchTooLargeError, Dn as InvalidRecordError, En as ForeignSecretMarkerError, Fn as RecordsError, Fr as formatSecretScope, G as describeCustomActions, Gn as RECORD_DATABASES, H as withoutCallerStamp, Hn as RECORD_BATCH_MAX, Hr as createEvent, I as deviceOpsCapability, In as RevConflictError, Ir as globalSecretScope, Jn as RECORD_ID_MAX_LENGTH, Kn as RECORD_DEFAULT_MAX_DATA_BYTES, L as viewerUiCapability, Ln as TransactRefusedError, Lr as isSecretRef, M as CAP_ADVANCE_FIELDS, Mn as RecordSecretUnavailableError, Mr as SECRET_REF_SCHEME, Nn as RecordTooLargeError, Nr as arrayItemFieldPath, On as NoCallerError, P as CAP_STATE_LEAVES, Pn as RecordUniqueViolationError, Pr as buildSecretRef, Q as readNodePin, Qn as RECORD_QUERY_MAX, Qt as defineEntryKind, R as PipelineRunResultBridge, Rn as UnindexedFilterError, Rr as normalizeSecretOwner, Sn as isZodSecret, Sr as normalizeAddonInitResult, Tn as FilterRequiredError, U as customAction, Un as RECORD_BATCH_MAX_BYTES, Ur as emitReadiness, V as CALLER_STAMPED_CAPABILITIES, Vn as recordsErrorFromMessage, W as defineCustomActions, Wn as RECORD_CLASSES, Xn as RECORD_MAX_INDEXES, Y as addonPagesSourceCapability, Yn as RECORD_MAX_DATA_BYTES, Z as nodePin, Zn as RECORD_MAX_INDEX_FIELDS, Zt as makeInMemoryRecords, _ as readErrorI18n, _n as recordSecretCollection, _r as DATAPLANE_SECRET_HEADER, ai as makeSecretMarker, an as RecordKindDeclarationSchema, ar as MIN_SCRUBBED_LENGTH, b as isDeviceScopedCap, br as BaseAddon, c as asString, cn as StoredRecordKindDeclarationSchema, cr as knownSecretCount, d as parseJsonUnknown, dn as defineRecordKinds, dr as shortSecretRefHash, ei as classifySecretWrite, en as createRecordsAccess, er as RECORD_SETTINGS_MAX_ROWS, f as hfModelUrl, fn as REMOVE_LEAF, fr as PEER_BYTES_CHUNK_BYTES, g as ErrorI18nPayloadSchema, gn as recordArrayItemPath, gt as ReadinessTimeoutError, hn as parseSecretPath, hr as PEER_BYTES_TICKET_TTL_MS, ht as ReadinessRegistry, ii as isSecretMarkerLike, in as RecordIndexSchema, ir as createSecretsAccess, jn as RecordNotFoundError, kn as PlaintextSecretError, ln as assertValidDeclaration, lr as registerKnownSecret, mn as mapSecretLeaves, mr as PEER_BYTES_STALL_MS, mt as MODEL_FORMATS, ni as isSecretFieldView, nn as EntryDescriptorSchema, nr as resolveSecretViewsIn, o as asJsonObject, oi as toSecretFieldView, on as RecordKindNameSchema, or as clearKnownSecrets, p as BOOT_RECOVERY_BACKOFF_MS, pn as collectSecretLeaves, pr as PEER_BYTES_MAX_OUTSTANDING, q as adminUiCapability, qn as RECORD_DELETE_BATCH, r as maskUrlCredentials, ri as isSecretMarker, rn as RecordFieldPathSchema, rr as REVALIDATE_AFTER_MS, sn as RecordRetentionSchema, sr as forgetKnownSecret, st as expandCapMethods, t as sleep, ti as isSecretClear, tn as assertTransactScope, tr as RECORD_SWEEP_INTERVAL_MS, un as declarationsOf, ur as scrubKnownSecrets, vn as recordSecretRef, w as createEventBusSliceSource, wn as DeclarationRefusedError, x as createDeviceProxy, xn as collectZodSecretPaths, y as DEVICE_SCOPED_CAPS, yn as secretArrayPrefixes, yr as DisposerChain, yt as scopeKey, z as PipelineStepInputSchema, zn as UnknownRecordKindError, zr as parseSecretRef } from "./sleep-6eG9C8Xl.mjs";
 import { t as EventCategory } from "./event-category-DmZDPDf_.mjs";
-import { a as DeviceType, t as errMsg } from "./err-msg-BCdlR2Li.mjs";
+import { a as DeviceType, t as errMsg } from "./err-msg-DWXWc0Di.mjs";
 //#region src/generated/cap-input-defaults.ts
 /**
 * AUTO-GENERATED by scripts/generate-cap-input-defaults.ts — DO NOT EDIT.
@@ -366,7 +366,7 @@ function materialise(defaults) {
 * barrel (`ALL_CAPABILITY_DEFINITIONS`), which would cost ~144MB RSS per
 * forked runner. See docs/decisions/adr-0028.md.
 *
-* Coverage: 28 collection caps, 46 array methods.
+* Coverage: 28 collection caps, 48 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"action-source": ["listActions"],
@@ -377,7 +377,12 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"calendar-source": ["listCalendars", "listEvents"],
 	"custom-model-registry": ["listModels"],
 	"data-store-provider": ["histogram", "query"],
-	"device-export": ["listExposedDevices", "listSupportedDeviceKinds"],
+	"device-export": [
+		"listExposedDevices",
+		"listExposedEntities",
+		"listSupportedDeviceKinds",
+		"listSupportedEntityKinds"
+	],
 	"device-extension": ["listSlots", "listSources"],
 	"device-provider": ["discoverDevices", "getDevices"],
 	"device-removal-hook": ["listDeviceData"],
@@ -428,9 +433,15 @@ function isCollectionArrayMethodName(capName, method) {
 * Per capability, the methods declared `optionalMethod` — the ones whose
 * ABSENCE on a provider is a fact about that provider, not a bug.
 *
-* Coverage: 2 caps, 7 methods.
+* Coverage: 3 caps, 11 methods.
 */
 var PROVIDER_OPTIONAL_METHODS = Object.freeze({
+	"device-export": [
+		"exposeEntity",
+		"listExposedEntities",
+		"listSupportedEntityKinds",
+		"unexposeEntity"
+	],
 	"log-destination": [
 		"cancelRead",
 		"describeRead",
@@ -458,4 +469,4 @@ function isProviderOptionalMethodName(capName, method) {
 	return methods !== void 0 && methods.includes(method);
 }
 //#endregion
-export { BOOT_RECOVERY_BACKOFF_MS, BaseAddon, BatchTooLargeError, CALLER_STAMPED_CAPABILITIES, CAP_ADVANCE_FIELDS, CAP_INPUT_DEFAULTS, CAP_STATE_LEAVES, COLLECTION_ARRAY_METHODS, DATAPLANE_SECRET_HEADER, DEVICE_CHILDREN_BATCH_MAX, DEVICE_SCOPED_CAPS, DeclarationRefusedError, DeviceType, DisposerChain, EntryDescriptorSchema, ErrorI18nPayloadSchema, EventCategory, FilterRequiredError, ForeignSecretMarkerError, HF_REPO, InvalidRecordError, MIN_SCRUBBED_LENGTH, MODEL_FORMATS, NoCallerError, PEER_BYTES_CHUNK_BYTES, PEER_BYTES_MAX_OUTSTANDING, PEER_BYTES_STALL_MS, PEER_BYTES_TICKET_TTL_MS, PROVIDER_OPTIONAL_METHODS, PlaintextSecretError, RECORDS_ERROR_CODES, RECORD_BATCH_MAX, RECORD_BATCH_MAX_BYTES, RECORD_CLASSES, RECORD_DATABASES, RECORD_DEFAULT_MAX_DATA_BYTES, RECORD_DELETE_BATCH, RECORD_ID_MAX_LENGTH, RECORD_MAX_DATA_BYTES, RECORD_MAX_INDEXES, RECORD_MAX_INDEX_FIELDS, RECORD_QUERY_MAX, RECORD_SECRET_COLLECTION_PREFIX, RECORD_SETTINGS_MAX_ROWS, RECORD_SWEEP_INTERVAL_MS, REMOVE_LEAF, REVALIDATE_AFTER_MS, ReadinessRegistry, ReadinessTimeoutError, RecordFieldPathSchema, RecordIndexSchema, RecordKindDeclarationSchema, RecordKindNameSchema, RecordNotFoundError, RecordRetentionSchema, RecordSecretUnavailableError, RecordTooLargeError, RecordUniqueViolationError, RecordsError, RevConflictError, SECRET_CLEAR, SECRET_REF_SCHEME, StoredRecordKindDeclarationSchema, TransactRefusedError, UnindexedFilterError, UnknownRecordKindError, addonSliceHandleApi, adminUiCapability, arrayItemFieldPath, asJsonObject, asRecordsError, asString, assertTransactScope, assertValidDeclaration, buildSecretRef, classifySecretWrite, clearKnownSecrets, collectSecretLeaves, collectZodSecretPaths, createDeviceProxy, createEvent, createEventBusSliceSource, createRecordsAccess, createSecretsAccess, declarationsOf, defineEntryKind, defineRecordKinds, describeCustomActions, deviceOpsCapability, emitReadiness, entryBody, errMsg, expandCapMethods, forgetKnownSecret, formatSecretScope, globalSecretScope, hfModelUrl, isCollectionArrayMethodName, isDeviceScopedCap, isProviderOptionalMethodName, isSecretClear, isSecretFieldView, isSecretMarker, isSecretMarkerLike, isSecretRef, isZodSecret, knownSecretCount, makeInMemoryRecords, makeSecretMarker, mapSecretLeaves, maskUrlCredentials, nodePin, normalizeAddonInitResult, normalizeSecretOwner, parseJsonUnknown, parseSecretPath, parseSecretRef, readErrorI18n, readNodePin, recordArrayItemPath, recordSecretCollection, recordSecretRef, recordsErrorFromMessage, registerKnownSecret, resolveSecretViewsIn, scopeKey, scrubKnownSecrets, secretArrayPrefixes, shortSecretRefHash, sleep, toSecretFieldView, viewerUiCapability, withCapInputDefaults, withoutCallerStamp };
+export { BOOT_RECOVERY_BACKOFF_MS, BaseAddon, BatchTooLargeError, CALLER_STAMPED_CAPABILITIES, CAP_ADVANCE_FIELDS, CAP_INPUT_DEFAULTS, CAP_STATE_LEAVES, COLLECTION_ARRAY_METHODS, DATAPLANE_SECRET_HEADER, DEVICE_CHILDREN_BATCH_MAX, DEVICE_SCOPED_CAPS, DeclarationRefusedError, DeviceType, DisposerChain, EntryDescriptorSchema, ErrorI18nPayloadSchema, EventCategory, FilterRequiredError, ForeignSecretMarkerError, HF_REPO, InvalidRecordError, MIN_SCRUBBED_LENGTH, MODEL_FORMATS, NoCallerError, PEER_BYTES_CHUNK_BYTES, PEER_BYTES_MAX_OUTSTANDING, PEER_BYTES_STALL_MS, PEER_BYTES_TICKET_TTL_MS, PROVIDER_OPTIONAL_METHODS, PipelineRunResultBridge, PipelineStepInputSchema, PlaintextSecretError, RECORDS_ERROR_CODES, RECORD_BATCH_MAX, RECORD_BATCH_MAX_BYTES, RECORD_CLASSES, RECORD_DATABASES, RECORD_DEFAULT_MAX_DATA_BYTES, RECORD_DELETE_BATCH, RECORD_ID_MAX_LENGTH, RECORD_MAX_DATA_BYTES, RECORD_MAX_INDEXES, RECORD_MAX_INDEX_FIELDS, RECORD_QUERY_MAX, RECORD_SECRET_COLLECTION_PREFIX, RECORD_SETTINGS_MAX_ROWS, RECORD_SWEEP_INTERVAL_MS, REMOVE_LEAF, REVALIDATE_AFTER_MS, ReadinessRegistry, ReadinessTimeoutError, RecordFieldPathSchema, RecordIndexSchema, RecordKindDeclarationSchema, RecordKindNameSchema, RecordNotFoundError, RecordRetentionSchema, RecordSecretUnavailableError, RecordTooLargeError, RecordUniqueViolationError, RecordsError, RevConflictError, SECRET_CLEAR, SECRET_REF_SCHEME, StoredRecordKindDeclarationSchema, TransactRefusedError, UnindexedFilterError, UnknownRecordKindError, addonPagesSourceCapability, addonSliceHandleApi, adminUiCapability, arrayItemFieldPath, asJsonObject, asRecordsError, asString, assertTransactScope, assertValidDeclaration, buildSecretRef, classifySecretWrite, clearKnownSecrets, collectSecretLeaves, collectZodSecretPaths, createDeviceProxy, createEvent, createEventBusSliceSource, createRecordsAccess, createSecretsAccess, customAction, declarationsOf, defineCustomActions, defineEntryKind, defineRecordKinds, describeCustomActions, deviceOpsCapability, emitReadiness, entryBody, errMsg, expandCapMethods, forgetKnownSecret, formatSecretScope, globalSecretScope, hfModelUrl, isCollectionArrayMethodName, isDeviceScopedCap, isProviderOptionalMethodName, isSecretClear, isSecretFieldView, isSecretMarker, isSecretMarkerLike, isSecretRef, isZodSecret, knownSecretCount, makeInMemoryRecords, makeSecretMarker, mapSecretLeaves, maskUrlCredentials, nodePin, normalizeAddonInitResult, normalizeSecretOwner, parseJsonUnknown, parseSecretPath, parseSecretRef, readErrorI18n, readNodePin, recordArrayItemPath, recordSecretCollection, recordSecretRef, recordsErrorFromMessage, registerKnownSecret, resolveSecretViewsIn, scopeKey, scrubKnownSecrets, secretArrayPrefixes, shortSecretRefHash, sleep, toSecretFieldView, viewerUiCapability, withCapInputDefaults, withoutCallerStamp };

package/dist/automation/export-entities.d.ts

@@ -0,0 +1,98 @@
+/**
+ * What a device exporter (HomeKit, Alexa, Home Assistant) does with the
+ * non-device entities it may expose (D968): run an action, send through a
+ * notification target, drop what was deleted.
+ *
+ * One implementation, so the three exporters refuse and log the same way:
+ *  - running goes through `actions.run` and RESPECTS its refusal — an action
+ *    that is already running or in cooldown is logged with a named reason and
+ *    never queued or retried (D391);
+ *  - an exported action or target that no longer exists is dropped from the
+ *    export, and the drop is logged.
+ *
+ * Actions are list entries, not devices (D954): the log tag is `actionId`,
+ * never `deviceId`.
+ */
+import type { IScopedLogger } from '../interfaces/logging.js';
+import type { ActionRunResult } from './action.js';
+import type { ExportEntityRef } from '../capabilities/device-export.cap.js';
+import { NotificationSchema, type SendResult, type Target } from '../capabilities/notification-output.cap.js';
+import type { z } from 'zod';
+/** What an exporter needs to know about an action to offer it. */
+export interface ExportableAction {
+    readonly id: string;
+    readonly name: string;
+}
+/** The slice of `ctx.api` the exporters use for non-device entities. */
+export interface ExportEntityApi {
+    readonly actions: {
+        readonly list: {
+            query(input?: Record<string, never>): Promise<readonly ExportableAction[]>;
+        };
+        readonly run: {
+            mutate(input: {
+                readonly actionId: string;
+            }): Promise<ActionRunResult>;
+        };
+    };
+    readonly notificationOutput: {
+        readonly listTargets: {
+            query(input?: Record<string, never>): Promise<readonly Target[]>;
+        };
+        readonly send: {
+            mutate(input: {
+                readonly targetId: string;
+                readonly addonId: string;
+                readonly notification: z.output<typeof NotificationSchema>;
+            }): Promise<SendResult>;
+        };
+    };
+}
+export type ExportActionRefusalReason = 'already-running' | 'cooldown' | 'not-found';
+export type ExportedActionRun = {
+    readonly status: 'started';
+} | {
+    readonly status: 'refused';
+    readonly reason: ExportActionRefusalReason;
+} | {
+    readonly status: 'failed';
+    readonly message: string;
+};
+export interface RunExportedActionInput {
+    /** The exporter's own name, for the log line (`hap`, `alexa`, `ha`). */
+    readonly exporter: string;
+    readonly actionId: string;
+}
+export declare function runExportedAction(api: ExportEntityApi, log: IScopedLogger, input: RunExportedActionInput): Promise<ExportedActionRun>;
+export type ExportTargetRefusalReason = 'target-gone' | 'target-disabled';
+export type ExportedTargetSend = {
+    readonly status: 'sent';
+} | {
+    readonly status: 'refused';
+    readonly reason: ExportTargetRefusalReason;
+} | {
+    readonly status: 'failed';
+    readonly message: string;
+};
+export interface SendToExportedTargetInput {
+    readonly exporter: string;
+    readonly targetId: string;
+    readonly notification: z.input<typeof NotificationSchema>;
+}
+/** Send through one CamStack notification target on behalf of an exporter. */
+export declare function sendToExportedTarget(api: ExportEntityApi, log: IScopedLogger, input: SendToExportedTargetInput): Promise<ExportedTargetSend>;
+export interface LiveEntityIds {
+    readonly actionIds: ReadonlySet<string>;
+    readonly targetIds: ReadonlySet<string>;
+}
+export interface PrunedEntities {
+    readonly kept: readonly ExportEntityRef[];
+    readonly dropped: readonly ExportEntityRef[];
+}
+/**
+ * Split an exporter's selection into what still exists and what was deleted.
+ * Devices are never judged here (their lifecycle is the tombstone, D865).
+ * Callers pass ids from a query that ANSWERED — an unanswered list must not
+ * reach this function (D49: a failed read changes nothing).
+ */
+export declare function pruneDeletedEntities(selection: readonly ExportEntityRef[], live: LiveEntityIds, log: IScopedLogger, exporter: string): PrunedEntities;

package/dist/capabilities/capability-definition.d.ts

@@ -399,7 +399,7 @@ export declare const DEFAULT_RUNTIME_STATE_DURABILITY: RuntimeStateDurability;
  * it. The symbol is the quantity's stored base (D944), including `µg/m³` and
  * `m/s`. A per-device quantity (`numeric-sensor`) has no fixed unit.
  */
-export type HistoryUnit = '%' | 'dBFS' | 'dBm' | '°C' | 'W' | 'kWh' | 'V' | 'A' | 'VA' | 'lx' | 'ppm' | 'ppb' | 'µg/m³' | 'hPa' | 'count' | 'ratio' | 'ms' | 's' | 'days' | 'bytes' | 'kbps' | 'fps' | 'm/s';
+export type HistoryUnit = '%' | 'dBFS' | 'dBm' | '°C' | 'W' | 'kWh' | 'V' | 'A' | 'VA' | 'lx' | 'ppm' | 'ppb' | 'µg/m³' | 'hPa' | 'count' | 'ratio' | 'ms' | 's' | 'days' | 'bytes' | 'kbps' | 'fps' | 'm/s' | 'L';
 /** Display label per {@link HistoryUnit}. */
 export declare const HISTORY_UNIT_LABELS: Readonly<Record<HistoryUnit, string>>;
 /** One `runtimeState` field recorded as a history series. */

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

@@ -190,6 +190,16 @@ export declare const ComposerBlockSchema: z.ZodObject<{
                         omit: "omit";
                     }>;
                 }, z.core.$strip>], "kind">>;
+                reset: z.ZodOptional<z.ZodObject<{
+                    kind: z.ZodLiteral<"forward">;
+                    source: z.ZodObject<{
+                        addonId: z.ZodString;
+                        stableId: z.ZodString;
+                    }, z.core.$strip>;
+                    cap: z.ZodString;
+                    method: z.ZodString;
+                    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../index.js").CompositionForwardArg, unknown, z.core.$ZodTypeInternals<import("../index.js").CompositionForwardArg, unknown>>>>;
+                }, z.core.$strip>>;
             }, z.core.$strip>>>;
             commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"forward">;
@@ -199,6 +209,7 @@ export declare const ComposerBlockSchema: z.ZodObject<{
                 }, z.core.$strip>;
                 cap: z.ZodString;
                 method: z.ZodString;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../index.js").CompositionForwardArg, unknown, z.core.$ZodTypeInternals<import("../index.js").CompositionForwardArg, unknown>>>>;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"code">;
                 code: z.ZodString;
@@ -420,6 +431,16 @@ export declare const ComposerApplyInputSchema: z.ZodObject<{
                             omit: "omit";
                         }>;
                     }, z.core.$strip>], "kind">>;
+                    reset: z.ZodOptional<z.ZodObject<{
+                        kind: z.ZodLiteral<"forward">;
+                        source: z.ZodObject<{
+                            addonId: z.ZodString;
+                            stableId: z.ZodString;
+                        }, z.core.$strip>;
+                        cap: z.ZodString;
+                        method: z.ZodString;
+                        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../index.js").CompositionForwardArg, unknown, z.core.$ZodTypeInternals<import("../index.js").CompositionForwardArg, unknown>>>>;
+                    }, z.core.$strip>>;
                 }, z.core.$strip>>>;
                 commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"forward">;
@@ -429,6 +450,7 @@ export declare const ComposerApplyInputSchema: z.ZodObject<{
                     }, z.core.$strip>;
                     cap: z.ZodString;
                     method: z.ZodString;
+                    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../index.js").CompositionForwardArg, unknown, z.core.$ZodTypeInternals<import("../index.js").CompositionForwardArg, unknown>>>>;
                 }, z.core.$strip>, z.ZodObject<{
                     kind: z.ZodLiteral<"code">;
                     code: z.ZodString;
@@ -683,6 +705,16 @@ export declare const composerCapability: {
                                     omit: "omit";
                                 }>;
                             }, z.core.$strip>], "kind">>;
+                            reset: z.ZodOptional<z.ZodObject<{
+                                kind: z.ZodLiteral<"forward">;
+                                source: z.ZodObject<{
+                                    addonId: z.ZodString;
+                                    stableId: z.ZodString;
+                                }, z.core.$strip>;
+                                cap: z.ZodString;
+                                method: z.ZodString;
+                                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../index.js").CompositionForwardArg, unknown, z.core.$ZodTypeInternals<import("../index.js").CompositionForwardArg, unknown>>>>;
+                            }, z.core.$strip>>;
                         }, z.core.$strip>>>;
                         commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
                             kind: z.ZodLiteral<"forward">;
@@ -692,6 +724,7 @@ export declare const composerCapability: {
                             }, z.core.$strip>;
                             cap: z.ZodString;
                             method: z.ZodString;
+                            args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("../index.js").CompositionForwardArg, unknown, z.core.$ZodTypeInternals<import("../index.js").CompositionForwardArg, unknown>>>>;
                         }, z.core.$strip>, z.ZodObject<{
                             kind: z.ZodLiteral<"code">;
                             code: z.ZodString;
@@ -758,6 +791,7 @@ export declare const composerCapability: {
                         arrayPath: z.ZodString;
                         key: z.ZodString;
                         label: z.ZodString;
+                        resettable: z.ZodOptional<z.ZodBoolean>;
                     }, z.core.$strip>>;
                     state: z.ZodEnum<{
                         fresh: "fresh";

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

@@ -197,15 +197,14 @@ export declare const consumablesCapability: {
         }, z.core.$strip>, z.ZodVoid, "mutation">;
     };
     /**
-     * A composed consumable (item added to a device with no native consumables
-     * provider) refuses `reset` by name: "Only meaningful when the item's
-     * `resettable` is true" — a composed item is never resettable until
-     * commands (`forward`) arrive in slice 3 (D663).
+     * A consumable ADDED to an existing device (a graft) refuses `reset` by
+     * name: only a composed device of a NEW type forwards an item's reset to a
+     * source button, and marks that item `resettable` (D967).
      */
     readonly composedMethods: {
         readonly reset: {
             readonly kind: 'refuse';
-            readonly reason: 'a composed consumable is not resettable until commands (forward) arrive — slice 3';
+            readonly reason: 'a consumable added to an existing device is not resettable — only a new composed device forwards a reset';
         };
     };
     readonly status: {