@camstack/types 1.2.259 → 1.2.261

package/dist/addon/base-addon.d.ts

@@ -1,5 +1,5 @@
 import type { ZodType } from 'zod';
-import type { AddonContext, AddonInitResult, CapabilitiesAccess, ProviderRegistration } from '../interfaces/addon.js';
+import type { AddonContext, AddonInitResult, CapabilitiesAccess, ProviderRegistration, StoredKeyRead } from '../interfaces/addon.js';
 import type { ConfigField, ConfigSection, ConfigUISchema, ConfigUISchemaWithValues } from '../interfaces/config-ui.js';
 import { type DurableState } from './durable-state.js';
 export type { CapabilitiesAccess };
@@ -261,6 +261,14 @@ export declare abstract class BaseAddon<TConfig extends object = Record<string,
      * `nodeId` omitted ⇒ the local node (node-blind injection from ctx).
      */
     protected resolveGlobalStore(nodeId?: string, cap?: string): Promise<Record<string, unknown>>;
+    /**
+     * Whether ONE global key of this addon's store was written, read three-way
+     * (D651). For a question a hydrated view cannot answer: `getGlobalSettings`
+     * reports `value ?? default`, so "the operator chose the default" and "nobody
+     * chose" look the same, and a failed read looks like both. A `perNode` key is
+     * not supported here: its stored name is scoped.
+     */
+    protected readStoredGlobalKey(key: string): Promise<StoredKeyRead>;
     updateGlobalSettings(patch: Partial<TConfig>, nodeId?: string): Promise<void>;
     /**
      * The set of field keys the global settings schema declares `perNode: true`

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-DtomDrRW.js");
+const require_sleep = require("./sleep-QxyLiUId.js");
 const require_event_category = require("./event-category-BVfsrBYA.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 //#region src/generated/cap-input-defaults.ts
@@ -16,7 +16,7 @@ const require_err_msg = require("./err-msg-COpsHMw2.js");
 * Plain data, zero Zod: a forked runner must not import the schema barrel
 * (~144MB RSS per runner — D28).
 *
-* Coverage: 24 caps, 58 methods with defaults.
+* Coverage: 24 caps, 59 methods with defaults.
 */
 var CAP_INPUT_DEFAULTS = Object.freeze({
 	"addons": { "getLogs": { "limit": 100 } },
@@ -109,6 +109,16 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 			"priority": 3
 		} } },
 		"getHistory": { "filter": { "limit": 100 } },
+		"previewStateSummary": { "rule": { "__nested__": {
+			"enabled": true,
+			"conditions": {},
+			"media": { "attach": "best" },
+			"throttle": {
+				"cooldownSec": 60,
+				"scope": "rule-device"
+			},
+			"priority": 3
+		} } },
 		"testRule": {
 			"rule": { "__nested__": {
 				"enabled": true,
@@ -140,10 +150,7 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 		"listRecentTracks": { "limit": 200 },
 		"listSummaries": { "limit": 50 },
 		"reclaimDebugMedia": { "mode": "report" },
-		"searchObjectEvents": {
-			"limit": 50,
-			"minScore": .2
-		}
+		"searchObjectEvents": { "limit": 50 }
 	},
 	"pipeline-runner": {
 		"attachCamera": {
@@ -297,7 +304,7 @@ function materialise(defaults) {
 * barrel (`ALL_CAPABILITY_DEFINITIONS`), which would cost ~144MB RSS per
 * forked runner. See docs/decisions/adr-0028.md.
 *
-* Coverage: 23 collection caps, 37 array methods.
+* Coverage: 24 collection caps, 39 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-pages-source": ["listPages"],
@@ -307,6 +314,7 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"custom-model-registry": ["listModels"],
 	"data-store-provider": ["histogram", "query"],
 	"device-export": ["listExposedDevices", "listSupportedDeviceKinds"],
+	"device-extension": ["listSlots", "listSources"],
 	"device-provider": ["discoverDevices", "getDevices"],
 	"failure-contribution": ["list"],
 	"llm": [

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { A as DeviceType, At as DATAPLANE_SECRET_HEADER, Dt as PEER_BYTES_STALL_MS, Et as PEER_BYTES_MAX_OUTSTANDING, G as readNodePin, J as ReadinessTimeoutError, L as expandCapMethods, Lt as emitReadiness, Mt as DisposerChain, Nt as BaseAddon, Ot as PEER_BYTES_TICKET_TTL_MS, Pt as normalizeAddonInitResult, S as DEVICE_CHILDREN_BATCH_MAX, T as describeCustomActions, Tt as PEER_BYTES_CHUNK_BYTES, W as nodePin, Z as scopeKey, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, h as createEventBusSliceSource, j as adminUiCapability, m as createDeviceProxy, p as isDeviceScopedCap, q as ReadinessRegistry, s as asString, t as sleep, u as parseJsonUnknown, x as viewerUiCapability } from "./sleep-DU7mu4wb.mjs";
+import { A as DeviceType, At as DATAPLANE_SECRET_HEADER, Dt as PEER_BYTES_STALL_MS, Et as PEER_BYTES_MAX_OUTSTANDING, G as readNodePin, J as ReadinessTimeoutError, L as expandCapMethods, Mt as DisposerChain, Nt as BaseAddon, Ot as PEER_BYTES_TICKET_TTL_MS, Pt as normalizeAddonInitResult, Rt as emitReadiness, S as DEVICE_CHILDREN_BATCH_MAX, T as describeCustomActions, Tt as PEER_BYTES_CHUNK_BYTES, W as nodePin, Z as scopeKey, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, h as createEventBusSliceSource, j as adminUiCapability, m as createDeviceProxy, p as isDeviceScopedCap, q as ReadinessRegistry, s as asString, t as sleep, u as parseJsonUnknown, x as viewerUiCapability } from "./sleep-BXv0ZcRa.mjs";
 import { t as EventCategory } from "./event-category-BVDXG4tB.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 //#region src/generated/cap-input-defaults.ts
@@ -15,7 +15,7 @@ import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 * Plain data, zero Zod: a forked runner must not import the schema barrel
 * (~144MB RSS per runner — D28).
 *
-* Coverage: 24 caps, 58 methods with defaults.
+* Coverage: 24 caps, 59 methods with defaults.
 */
 var CAP_INPUT_DEFAULTS = Object.freeze({
 	"addons": { "getLogs": { "limit": 100 } },
@@ -108,6 +108,16 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 			"priority": 3
 		} } },
 		"getHistory": { "filter": { "limit": 100 } },
+		"previewStateSummary": { "rule": { "__nested__": {
+			"enabled": true,
+			"conditions": {},
+			"media": { "attach": "best" },
+			"throttle": {
+				"cooldownSec": 60,
+				"scope": "rule-device"
+			},
+			"priority": 3
+		} } },
 		"testRule": {
 			"rule": { "__nested__": {
 				"enabled": true,
@@ -139,10 +149,7 @@ var CAP_INPUT_DEFAULTS = Object.freeze({
 		"listRecentTracks": { "limit": 200 },
 		"listSummaries": { "limit": 50 },
 		"reclaimDebugMedia": { "mode": "report" },
-		"searchObjectEvents": {
-			"limit": 50,
-			"minScore": .2
-		}
+		"searchObjectEvents": { "limit": 50 }
 	},
 	"pipeline-runner": {
 		"attachCamera": {
@@ -296,7 +303,7 @@ function materialise(defaults) {
 * barrel (`ALL_CAPABILITY_DEFINITIONS`), which would cost ~144MB RSS per
 * forked runner. See docs/decisions/adr-0028.md.
 *
-* Coverage: 23 collection caps, 37 array methods.
+* Coverage: 24 collection caps, 39 array methods.
 */
 var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"addon-pages-source": ["listPages"],
@@ -306,6 +313,7 @@ var COLLECTION_ARRAY_METHODS = Object.freeze({
 	"custom-model-registry": ["listModels"],
 	"data-store-provider": ["histogram", "query"],
 	"device-export": ["listExposedDevices", "listSupportedDeviceKinds"],
+	"device-extension": ["listSlots", "listSources"],
 	"device-provider": ["discoverDevices", "getDevices"],
 	"failure-contribution": ["list"],
 	"llm": [

package/dist/capabilities/camera-streams.cap.d.ts

@@ -140,8 +140,8 @@ export declare const cameraStreamsCapability: {
             sourceCamStreamId: z.ZodNullable<z.ZodString>;
             status: z.ZodEnum<{
                 error: "error";
-                unassigned: "unassigned";
                 idle: "idle";
+                unassigned: "unassigned";
                 connecting: "connecting";
                 streaming: "streaming";
             }>;
@@ -326,8 +326,8 @@ export declare const cameraStreamsCapability: {
                 sourceCamStreamId: z.ZodNullable<z.ZodString>;
                 status: z.ZodEnum<{
                     error: "error";
-                    unassigned: "unassigned";
                     idle: "idle";
+                    unassigned: "unassigned";
                     connecting: "connecting";
                     streaming: "streaming";
                 }>;
@@ -369,22 +369,22 @@ export declare const cameraStreamsCapability: {
         slotStatuses: z.ZodObject<{
             high: z.ZodOptional<z.ZodEnum<{
                 error: "error";
-                unassigned: "unassigned";
                 idle: "idle";
+                unassigned: "unassigned";
                 connecting: "connecting";
                 streaming: "streaming";
             }>>;
             mid: z.ZodOptional<z.ZodEnum<{
                 error: "error";
-                unassigned: "unassigned";
                 idle: "idle";
+                unassigned: "unassigned";
                 connecting: "connecting";
                 streaming: "streaming";
             }>>;
             low: z.ZodOptional<z.ZodEnum<{
                 error: "error";
-                unassigned: "unassigned";
                 idle: "idle";
+                unassigned: "unassigned";
                 connecting: "connecting";
                 streaming: "streaming";
             }>>;

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

@@ -14,6 +14,7 @@
 import { z } from 'zod';
 import { DeviceType } from '../device/device-type.js';
 import type { ConfigUISchemaWithValues } from '../interfaces/config-ui.js';
+import type { ExtensionSlotDescriptor } from '../device-extension/slot-descriptor.js';
 /**
  * tRPC procedure kind.
  * - 'query': read-only, no side effects
@@ -503,6 +504,14 @@ export interface CapabilityDefinition<TName extends string = string, TMethods ex
     readonly deviceConfig?: DeviceConfigSpec;
     /** For `scope: 'device'` caps — allowed device types. Omit → applies to every type. */
     readonly deviceTypes?: readonly DeviceType[];
+    /**
+     * Extension slots this capability OWNS (D648): the ways a device of this
+     * kind can be extended by other devices, served by this cap's owner over
+     * the store it already has. Folded by `npm run codegen` into
+     * `generated/extension-slots.ts` and listed by `device-extension`.
+     * Behavioural metadata, so it lives here and only here (D4).
+     */
+    readonly extensionSlots?: readonly ExtensionSlotDescriptor[];
     /**
      * When `true`, every provider of this capability MUST implement the
      * device-settings contribution surface — three extra methods appearing

package/dist/capabilities/custom-model-registry.cap.d.ts

@@ -30,7 +30,6 @@ export declare const CustomModelDescriptorSchema: z.ZodObject<{
                 isDirectory: z.ZodOptional<z.ZodBoolean>;
                 files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                 runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-                    node: "node";
                     python: "python";
                 }>>>>;
             }, z.core.$strip>>;
@@ -40,7 +39,6 @@ export declare const CustomModelDescriptorSchema: z.ZodObject<{
                 isDirectory: z.ZodOptional<z.ZodBoolean>;
                 files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                 runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-                    node: "node";
                     python: "python";
                 }>>>>;
             }, z.core.$strip>>;
@@ -50,7 +48,6 @@ export declare const CustomModelDescriptorSchema: z.ZodObject<{
                 isDirectory: z.ZodOptional<z.ZodBoolean>;
                 files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                 runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-                    node: "node";
                     python: "python";
                 }>>>>;
             }, z.core.$strip>>;
@@ -60,7 +57,6 @@ export declare const CustomModelDescriptorSchema: z.ZodObject<{
                 isDirectory: z.ZodOptional<z.ZodBoolean>;
                 files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                 runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-                    node: "node";
                     python: "python";
                 }>>>>;
             }, z.core.$strip>>;
@@ -70,7 +66,6 @@ export declare const CustomModelDescriptorSchema: z.ZodObject<{
                 isDirectory: z.ZodOptional<z.ZodBoolean>;
                 files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                 runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-                    node: "node";
                     python: "python";
                 }>>>>;
             }, z.core.$strip>>;
@@ -80,7 +75,6 @@ export declare const CustomModelDescriptorSchema: z.ZodObject<{
                 isDirectory: z.ZodOptional<z.ZodBoolean>;
                 files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                 runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-                    node: "node";
                     python: "python";
                 }>>>>;
             }, z.core.$strip>>;
@@ -153,6 +147,15 @@ export declare const CustomModelDescriptorSchema: z.ZodObject<{
             }>>;
             preserveOriginal: z.ZodBoolean;
         }, z.core.$strip>>;
+        clip: z.ZodOptional<z.ZodObject<{
+            textModelId: z.ZodString;
+            embeddingDim: z.ZodNumber;
+            vectorIndex: z.ZodString;
+            tokenizerFile: z.ZodString;
+            contextLength: z.ZodNumber;
+            padId: z.ZodNumber;
+            searchMinScore: z.ZodNumber;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type CustomModelDescriptor = z.infer<typeof CustomModelDescriptorSchema>;
@@ -184,7 +187,6 @@ export declare const customModelRegistryCapability: {
                         isDirectory: z.ZodOptional<z.ZodBoolean>;
                         files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                         runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-                            node: "node";
                             python: "python";
                         }>>>>;
                     }, z.core.$strip>>;
@@ -194,7 +196,6 @@ export declare const customModelRegistryCapability: {
                         isDirectory: z.ZodOptional<z.ZodBoolean>;
                         files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                         runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-                            node: "node";
                             python: "python";
                         }>>>>;
                     }, z.core.$strip>>;
@@ -204,7 +205,6 @@ export declare const customModelRegistryCapability: {
                         isDirectory: z.ZodOptional<z.ZodBoolean>;
                         files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                         runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-                            node: "node";
                             python: "python";
                         }>>>>;
                     }, z.core.$strip>>;
@@ -214,7 +214,6 @@ export declare const customModelRegistryCapability: {
                         isDirectory: z.ZodOptional<z.ZodBoolean>;
                         files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                         runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-                            node: "node";
                             python: "python";
                         }>>>>;
                     }, z.core.$strip>>;
@@ -224,7 +223,6 @@ export declare const customModelRegistryCapability: {
                         isDirectory: z.ZodOptional<z.ZodBoolean>;
                         files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                         runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-                            node: "node";
                             python: "python";
                         }>>>>;
                     }, z.core.$strip>>;
@@ -234,7 +232,6 @@ export declare const customModelRegistryCapability: {
                         isDirectory: z.ZodOptional<z.ZodBoolean>;
                         files: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                         runtimes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
-                            node: "node";
                             python: "python";
                         }>>>>;
                     }, z.core.$strip>>;
@@ -307,6 +304,15 @@ export declare const customModelRegistryCapability: {
                     }>>;
                     preserveOriginal: z.ZodBoolean;
                 }, z.core.$strip>>;
+                clip: z.ZodOptional<z.ZodObject<{
+                    textModelId: z.ZodString;
+                    embeddingDim: z.ZodNumber;
+                    vectorIndex: z.ZodString;
+                    tokenizerFile: z.ZodString;
+                    contextLength: z.ZodNumber;
+                    padId: z.ZodNumber;
+                    searchMinScore: z.ZodNumber;
+                }, z.core.$strip>>;
             }, z.core.$strip>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
     };

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

@@ -68,11 +68,11 @@ export declare const decoderCapability: {
             codec: z.ZodString;
             maxFps: z.ZodDefault<z.ZodNumber>;
             outputFormat: z.ZodDefault<z.ZodEnum<{
-                rgb: "rgb";
-                gray: "gray";
                 jpeg: "jpeg";
+                rgb: "rgb";
                 bgr: "bgr";
                 yuv420: "yuv420";
+                gray: "gray";
             }>>;
             scale: z.ZodDefault<z.ZodNumber>;
             width: z.ZodOptional<z.ZodNumber>;
@@ -118,11 +118,11 @@ export declare const decoderCapability: {
             width: z.ZodNumber;
             height: z.ZodNumber;
             format: z.ZodEnum<{
-                rgb: "rgb";
-                gray: "gray";
                 jpeg: "jpeg";
+                rgb: "rgb";
                 bgr: "bgr";
                 yuv420: "yuv420";
+                gray: "gray";
             }>;
             timestamp: z.ZodNumber;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
@@ -137,11 +137,11 @@ export declare const decoderCapability: {
             width: z.ZodNumber;
             height: z.ZodNumber;
             format: z.ZodEnum<{
-                rgb: "rgb";
-                gray: "gray";
                 jpeg: "jpeg";
+                rgb: "rgb";
                 bgr: "bgr";
                 yuv420: "yuv420";
+                gray: "gray";
             }>;
             pts: z.ZodNumber;
             byteLength: z.ZodNumber;
@@ -156,11 +156,11 @@ export declare const decoderCapability: {
                 width: z.ZodNumber;
                 height: z.ZodNumber;
                 format: z.ZodEnum<{
-                    rgb: "rgb";
-                    gray: "gray";
                     jpeg: "jpeg";
+                    rgb: "rgb";
                     bgr: "bgr";
                     yuv420: "yuv420";
+                    gray: "gray";
                 }>;
                 pts: z.ZodNumber;
                 byteLength: z.ZodNumber;
@@ -172,11 +172,11 @@ export declare const decoderCapability: {
             width: z.ZodNumber;
             height: z.ZodNumber;
             format: z.ZodEnum<{
-                rgb: "rgb";
-                gray: "gray";
                 jpeg: "jpeg";
+                rgb: "rgb";
                 bgr: "bgr";
                 yuv420: "yuv420";
+                gray: "gray";
             }>;
             timestamp: z.ZodNumber;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
@@ -198,11 +198,11 @@ export declare const decoderCapability: {
                 codec: z.ZodOptional<z.ZodString>;
                 maxFps: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
                 outputFormat: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
-                    rgb: "rgb";
-                    gray: "gray";
                     jpeg: "jpeg";
+                    rgb: "rgb";
                     bgr: "bgr";
                     yuv420: "yuv420";
+                    gray: "gray";
                 }>>>;
                 scale: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
                 width: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;