@camstack/types 1.1.42 → 1.1.44

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-ByctZsHo.js");
+const require_sleep = require("./sleep-k6I1e98_.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 exports.BaseAddon = require_sleep.BaseAddon;
 exports.DATAPLANE_SECRET_HEADER = require_sleep.DATAPLANE_SECRET_HEADER;

package/dist/addon.mjs

@@ -1,3 +1,3 @@
-import { A as parseJsonUnknown, D as asString, I as scopeKey, M as ReadinessRegistry, N as ReadinessTimeoutError, S as DeviceType, T as asJsonObject, a as viewerUiCapability, bt as EventCategory, ct as BaseAddon, ft as emitReadiness, i as deviceOpsCapability, j as DATAPLANE_SECRET_HEADER, lt as normalizeAddonInitResult, m as expandCapMethods, o as adminUiCapability, s as createDeviceProxy, t as sleep, xt as DisposerChain } from "./sleep-BC9Yqte7.mjs";
+import { A as parseJsonUnknown, D as asString, I as scopeKey, M as ReadinessRegistry, N as ReadinessTimeoutError, S as DeviceType, T as asJsonObject, a as viewerUiCapability, bt as EventCategory, ct as BaseAddon, ft as emitReadiness, i as deviceOpsCapability, j as DATAPLANE_SECRET_HEADER, lt as normalizeAddonInitResult, m as expandCapMethods, o as adminUiCapability, s as createDeviceProxy, t as sleep, xt as DisposerChain } from "./sleep-DkhOVOjW.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 export { BaseAddon, DATAPLANE_SECRET_HEADER, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, ReadinessTimeoutError, adminUiCapability, asJsonObject, asString, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, normalizeAddonInitResult, parseJsonUnknown, scopeKey, sleep, viewerUiCapability };

package/dist/capabilities/advanced-notifier.cap.d.ts

@@ -22,15 +22,16 @@ declare const NotificationRuleConditionsSchema: z.ZodObject<{
         text: z.ZodString;
         minSimilarity: z.ZodNumber;
     }, z.core.$strip>>;
+    labels: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 declare const NotificationRuleTemplateSchema: z.ZodObject<{
     title: z.ZodString;
     body: z.ZodString;
     imageMode: z.ZodEnum<{
         none: "none";
+        full: "full";
         crop: "crop";
         annotated: "annotated";
-        full: "full";
     }>;
 }, z.core.$strip>;
 declare const NotificationRuleSchema: z.ZodObject<{
@@ -60,6 +61,7 @@ declare const NotificationRuleSchema: z.ZodObject<{
             text: z.ZodString;
             minSimilarity: z.ZodNumber;
         }, z.core.$strip>>;
+        labels: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
     outputs: z.ZodReadonly<z.ZodArray<z.ZodString>>;
     template: z.ZodOptional<z.ZodObject<{
@@ -67,9 +69,9 @@ declare const NotificationRuleSchema: z.ZodObject<{
         body: z.ZodString;
         imageMode: z.ZodEnum<{
             none: "none";
+            full: "full";
             crop: "crop";
             annotated: "annotated";
-            full: "full";
         }>;
     }, z.core.$strip>>;
     priority: z.ZodEnum<{
@@ -138,6 +140,7 @@ export declare const advancedNotifierCapability: {
                         text: z.ZodString;
                         minSimilarity: z.ZodNumber;
                     }, z.core.$strip>>;
+                    labels: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                 }, z.core.$strip>;
                 outputs: z.ZodReadonly<z.ZodArray<z.ZodString>>;
                 template: z.ZodOptional<z.ZodObject<{
@@ -145,9 +148,9 @@ export declare const advancedNotifierCapability: {
                     body: z.ZodString;
                     imageMode: z.ZodEnum<{
                         none: "none";
+                        full: "full";
                         crop: "crop";
                         annotated: "annotated";
-                        full: "full";
                     }>;
                 }, z.core.$strip>>;
                 priority: z.ZodEnum<{
@@ -186,6 +189,7 @@ export declare const advancedNotifierCapability: {
                         text: z.ZodString;
                         minSimilarity: z.ZodNumber;
                     }, z.core.$strip>>;
+                    labels: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                 }, z.core.$strip>;
                 outputs: z.ZodReadonly<z.ZodArray<z.ZodString>>;
                 template: z.ZodOptional<z.ZodObject<{
@@ -193,9 +197,9 @@ export declare const advancedNotifierCapability: {
                     body: z.ZodString;
                     imageMode: z.ZodEnum<{
                         none: "none";
+                        full: "full";
                         crop: "crop";
                         annotated: "annotated";
-                        full: "full";
                     }>;
                 }, z.core.$strip>>;
                 priority: z.ZodEnum<{

package/dist/capabilities/cap-router-predicates.d.ts

@@ -10,6 +10,7 @@
  * makes the two paths provably agree. Each predicate accepts both Zod 4
  * (`_def.type`) and legacy Zod 3 (`_def.typeName` / `constructor.name`) shapes.
  */
+import type { CapabilityDefinition } from './capability-definition.js';
 /** `z.void()` — input carries no data. */
 export declare function isVoidInput(schema: unknown): boolean;
 /** `z.object()` — supports `.loose()` for out-of-band `nodeId`/`addonId` keys. */
@@ -20,6 +21,22 @@ export declare function isObjectInput(schema: unknown): boolean;
  * default). Bounded unwrap guards against a malformed/cyclic schema.
  */
 export declare function isArrayOutputSchema(schema: unknown): boolean;
+/**
+ * True when `method` on cap `def` is a COLLECTION cap's array-returning
+ * (non-subscription) method — the methods whose contract is "union the result
+ * across every registered provider" (`listTargets`, `listTargetKinds`,
+ * `discoverTargets`, `listEndpoints`, …).
+ *
+ * Such a method is aggregated at the hub via `concatCollection` / the runtime
+ * `concatArrayMethod`, both of which SKIP a provider that doesn't implement it
+ * (contributes `[]`). That local skip is invisible across the UDS boundary — a
+ * hub-side per-provider proxy fabricates a callable for every property, so the
+ * call reaches the child's real (possibly partial) provider. This predicate lets
+ * the child-side dispatcher reproduce the same graceful skip: a missing method
+ * here yields `[]`, not a "method not found" error. Singleton caps and non-array
+ * methods return `false` so a genuinely missing method still surfaces as a bug.
+ */
+export declare function isCollectionArrayMethod(def: CapabilityDefinition | undefined, method: string): boolean;
 /**
  * Apply `.loose()` to an object input schema when available (Zod 4) so the
  * router accepts the out-of-band `nodeId`/`addonId` selector keys without

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

@@ -39,7 +39,7 @@ export type CapabilityMethodAuth = 'public' | 'protected' | 'admin';
  *   - `mesh`           — mesh-VPN providers (Tailscale, Headscale, …)
  *   - `ingress`        — public-ingress tunnels (Cloudflare Tunnel, …)
  */
-export type ProviderKind = 'broker' | 'device-export' | 'email' | 'mesh' | 'ingress';
+export type ProviderKind = 'broker' | 'device-export' | 'email' | 'mesh' | 'ingress' | 'ai';
 /**
  * Access flavour for a capability method. Drives the scope-access check
  * in `protectedProcedure`. Default inferred at codegen time:

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

@@ -74,6 +74,16 @@ export declare const CustomModelDescriptorSchema: z.ZodObject<{
                     python: "python";
                 }>>>>;
             }, z.core.$strip>>;
+            gguf: z.ZodOptional<z.ZodObject<{
+                url: z.ZodString;
+                sizeMB: z.ZodNumber;
+                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>>;
         }, z.core.$strip>;
         inputSize: z.ZodObject<{
             width: z.ZodNumber;
@@ -190,6 +200,16 @@ export declare const customModelRegistryCapability: {
                             python: "python";
                         }>>>>;
                     }, z.core.$strip>>;
+                    gguf: z.ZodOptional<z.ZodObject<{
+                        url: z.ZodString;
+                        sizeMB: z.ZodNumber;
+                        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>>;
                 }, z.core.$strip>;
                 inputSize: z.ZodObject<{
                     width: z.ZodNumber;

package/dist/capabilities/index.d.ts

@@ -35,15 +35,15 @@ export type { AudioAnalyzerGlobalConfig, AudioBackendChoice, IAudioAnalyzerProvi
 export { AUDIO_BACKEND_CHOICES, AudioAnalysisResultSchema, AudioAnalysisSettingsSchema, AudioClassificationResultSchema, audioAnalyzerCapability, DEFAULT_AUDIO_ANALYZER_CONFIG, } from './audio-analyzer.cap.js';
 export { AudioCodecInfoSchema, AudioDecodeSessionConfigSchema, AudioEncodedChunkSchema, AudioEncodeSessionConfigSchema, AudioPcmChunkSchema, audioCodecCapability, type IAudioCodecCapProvider, PcmSampleFormatSchema, } from './audio-codec.cap.js';
 export { AuthResultSchema, authProviderCapability } from './auth-provider.cap.js';
-export { loginMethodCapability, LoginStageEnum, RedirectLoginMethodSchema, WidgetLoginMethodSchema, LoginMethodContributionSchema, } from './login-method.cap.js';
-export type { ILoginMethodProvider, LoginMethodContribution, RedirectLoginMethod, WidgetLoginMethod, LoginStage, } from './login-method.cap.js';
+export { loginMethodCapability, LoginStageEnum, RedirectLoginMethodSchema, WidgetLoginMethodSchema, PasskeyLoginMethodSchema, LoginMethodContributionSchema, } from './login-method.cap.js';
+export type { ILoginMethodProvider, LoginMethodContribution, RedirectLoginMethod, WidgetLoginMethod, PasskeyLoginMethod, LoginStage, } from './login-method.cap.js';
 export { ArchiveEntrySchema, ArchiveManifestSchema, BackupDestinationInfoSchema, BackupEntrySchema, backupCapability, type IBackupProvider, LocationStatSchema, } from './backup.cap.js';
 export { BrokerAddInputSchema, BrokerGetStateInputSchema, type BrokerInfo as UnifiedBrokerInfo, BrokerInfoSchema as UnifiedBrokerInfoSchema, type BrokerProviderInfo, BrokerProviderInfoSchema, BrokerPublishInputSchema, BrokerRegistryStatusSchema, type BrokerStatus as UnifiedBrokerStatus, BrokerStatusEnum, BrokerSubscribeInputSchema, BrokerSubscribeResultSchema, BrokerTestConnectionResultSchema, BrokerUnsubscribeInputSchema, brokerCapability, type IBrokerProvider, } from './broker.cap.js';
 export { cameraPipelineConfigCapability, type ICameraPipelineConfigProvider, } from './camera-pipeline-config.cap.js';
 export { cameraStreamsCapability, type ICameraStreamsProvider, type PickedCamStream, PickedCamStreamSchema, PickStreamPreferencesSchema, PickStreamRequirementsSchema, type StreamCodec, StreamCodecSchema, } from './camera-streams.cap.js';
 export type { CapabilityDefinition, CapabilityEventSchema, CapabilityMethodAuth, CapabilityMethodKind, CapabilityMethodOptions, CapabilityMethodSchema, CapabilityMountHint, CapabilityMountKind, CapabilityStatusItemArray, CapabilityStatusKind, CapabilityStatusSchema, DeviceConfigDerivedFormUi, DeviceConfigSpec, DeviceConfigUiSpec, DeviceConfigWidgetUi, DeviceSettingsContribution, InferDeviceProxyCap, InferEvents, InferName, InferNativeProvider, InferProvider, InferRuntimeState, ProviderKind, UiContribution, UiContributionKind, UiContributionRemote, } from './capability-definition.js';
 export { DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, event, expandCapMethods, isDeviceConfigCap, method, resolveCapMount, } from './capability-definition.js';
-export { isArrayOutputSchema, isObjectInput, isVoidInput, kebabToCamel, looseSchema, procedureAuthKey, } from './cap-router-predicates.js';
+export { isArrayOutputSchema, isCollectionArrayMethod, isObjectInput, isVoidInput, kebabToCamel, looseSchema, procedureAuthKey, } from './cap-router-predicates.js';
 export * from './custom-actions.js';
 export type { CustomModelDescriptor, ICustomModelRegistryProvider, } from './custom-model-registry.cap.js';
 export { CustomModelDescriptorSchema, customModelRegistryCapability, } from './custom-model-registry.cap.js';
@@ -73,13 +73,16 @@ export { AddBrokerInputSchema, BrokerConnectionDetailsSchema, BrokerInfoSchema,
 export type { NetworkAccessStatus, NetworkEndpoint } from './network-access.cap.js';
 export { NetworkAccessStatusSchema, NetworkEndpointSchema, networkAccessCapability, } from './network-access.cap.js';
 export { type Attachment, AttachmentMediaTypeSchema, type AttachmentMediaType, AttachmentSchema, type DiscoveredTarget, DiscoveredTargetSchema, type INotificationOutputProvider, type NotificationAction, NotificationActionSchema, type NotificationFormat, NotificationFormatSchema, NotificationSchema, type RenderedAs, RenderedAsSchema, type SendResult, SendResultSchema, type Target, type TargetKind, type TargetKindCaps, TargetKindCapsSchema, type TargetKindLevel, TargetKindLevelSchema, TargetKindSchema, TargetSchema, type TestResult, TestResultSchema, notificationOutputCapability, } from './notification-output.cap.js';
+export { type ILlmProvider, type LlmDefault, type LlmDefaultSelector, LlmDefaultSchema, LlmDefaultSelectorSchema, llmCapability, type LlmProfile, type LlmProfileKind, type LlmProfileKindDescriptor, LlmProfileKindDescriptorSchema, LlmProfileKindSchema, LlmProfileSchema, type LlmRuntimeNode, LlmRuntimeNodeSchema, type LlmUsageRollup, LlmUsageRollupSchema, type ManagedModelCatalogEntry, ManagedModelCatalogEntrySchema, } from './llm.cap.js';
+export { type ILlmRuntimeProvider, llmRuntimeCapability, type LlmNodeModel, LlmNodeModelSchema, type LlmRuntimeCompleteInput, LlmRuntimeCompleteInputSchema, type LlmRuntimeDiskUsage, LlmRuntimeDiskUsageSchema, type LlmRuntimeStatus, LlmRuntimeStatusSchema, type ManagedModelRef, ManagedModelRefSchema, type ManagedRuntimeConfig, ManagedRuntimeConfigSchema, } from './llm-runtime.cap.js';
+export { type LlmErrorCode, LlmErrorCodeSchema, type LlmGenerateBaseInput, LlmGenerateBaseInputSchema, type LlmGenerateErr, LlmGenerateErrSchema, type LlmGenerateOk, LlmGenerateOkSchema, type LlmGenerateResult, LlmGenerateResultSchema, type LlmImage, LlmImageSchema, type LlmUsage, LlmUsageSchema, } from './llm-shared.js';
 export { type IOauthIntegrationProvider, type OauthIntegrationDescriptor, OauthIntegrationDescriptorSchema, oauthIntegrationCapability, } from './oauth-integration.cap.js';
-export { type AudioEvent, AudioEventSchema, type DetectionSource, DetectionSourceSchema, type EventKind, EventKindSchema, type IPipelineAnalyticsProvider, type KeyEvent, KeyEventSchema, type MediaFile, type MediaFileKind, MediaFileSchema, type MotionEvent, MotionEventSchema, type ObjectEvent, ObjectEventSchema, pipelineAnalyticsCapability, type ScoredObjectEvent, ScoredObjectEventSchema, type Track, TrackedDetectionSchema, TrackSchema, type TrackState, TrackStateSchema, } from './pipeline-analytics.cap.js';
+export { type AudioEvent, AudioEventSchema, type DetectionSource, DetectionSourceSchema, type EventKind, EventKindSchema, type IPipelineAnalyticsProvider, type KeyEvent, KeyEventSchema, type MediaFile, type MediaFileKind, MediaFileSchema, type MotionEvent, MotionEventSchema, type ObjectEvent, ObjectEventSchema, pipelineAnalyticsCapability, type ScoredObjectEvent, ScoredObjectEventSchema, type Track, type TrackCascadeCounts, TrackCascadeCountsSchema, TrackedDetectionSchema, TrackSchema, type TrackState, TrackStateSchema, } from './pipeline-analytics.cap.js';
 export type { PipelineStepInputOutput, PipelineValidationIssue, PipelineValidationResult, } from './pipeline-executor.cap.js';
 export { ModelSubstitutionSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PipelineValidationIssueSchema, PipelineValidationResultSchema, pipelineExecutorCapability, } from './pipeline-executor.cap.js';
 export type { CameraAssignmentStatus, CameraAudioStatus, CameraBrokerProfile, CameraBrokerStatus, CameraDecoderShm, CameraDecoderStatus, CameraDetectionPhase, CameraDetectionProvisioning, CameraDetectionProvisioningState, CameraDetectionStatus, CameraMotionStatus, CameraRecordingMode, CameraRecordingStatus, CameraSourceStatus, CameraSourceStream, CameraStatus, IngestOwner, } from './pipeline-orchestrator.cap.js';
 export { AgentLoadSummarySchema, CameraAssignmentStatusSchema, CameraAudioStatusSchema, CameraBrokerProfileSchema, CameraBrokerStatusSchema, CameraDecoderShmSchema, CameraDecoderStatusSchema, CameraDetectionPhaseSchema, CameraDetectionProvisioningSchema, CameraDetectionProvisioningStateSchema, CameraDetectionStatusSchema, CameraMotionStatusSchema, CameraRecordingModeSchema, CameraRecordingStatusSchema, CameraSourceStatusSchema, CameraSourceStreamSchema, CameraStatusSchema, CapabilityBindingsSchema, GlobalMetricsSchema, IngestOwnerSchema, PipelineAssignmentSchema, pipelineOrchestratorCapability, } from './pipeline-orchestrator.cap.js';
-export type { MotionSource, MotionSources, ReportMotionInput, RunnerFrameSource, } from './pipeline-runner.cap.js';
+export type { DetailParent, DetailResult, MotionSource, MotionSources, ReportMotionInput, RunDetailSubtreeInput, RunDetailSubtreeResult, RunnerFrameSource, } from './pipeline-runner.cap.js';
 export { MotionSourceEnum, MotionSourcesSchema, pipelineRunnerCapability, ReportMotionInputSchema, RunnerCameraConfigSchema, RunnerCameraDeviceUIFields, RunnerFrameSourceSchema, RunnerLocalLoadSchema, RunnerLocalMetricsSchema, } from './pipeline-runner.cap.js';
 export { AudioChunkInputSchema, AudioClassificationLabelSchema, AudioLevelSchema, BoundingBoxSchema, FrameInputSchema, SpatialDetectionSchema, } from './schemas/detection-shared.js';
 export { CameraMetricsSchema, CameraMetricsWithDeviceIdSchema, OrchestratorMetricsSchema, } from './schemas/orchestrator-metrics.js';
@@ -152,13 +155,14 @@ export { type IMeshNetworkProvider, type MeshEndpoint, type MeshPeer, MeshPeerSc
 export { type IMotionProvider, type MotionOnMotionChangedData, MotionOnMotionChangedDataSchema, type MotionStatus, MotionStatusSchema, motionCapability, } from './motion.cap.js';
 export { type IMotionTriggerProvider, type MotionTriggerRuntimeState, MotionTriggerRuntimeStateSchema, type MotionTriggerStatus, MotionTriggerStatusSchema, motionTriggerCapability, } from './motion-trigger.cap.js';
 export { type IMotionZonesProvider, type MotionZoneOptions, MotionZoneOptionsSchema, type MotionZonePatch, MotionZonePatchSchema, type MotionZoneRegion, MotionZoneRegionSchema, type MotionZoneStatus, MotionZoneStatusSchema, motionZonesCapability, } from './motion-zones.cap.js';
+export { type ISceneMonitorProvider, type SceneCheck, SceneCheckSchema, type SceneCondition, SceneConditionSchema, type SceneMonitor, SceneMonitorSchema, type SceneMonitorState, SceneMonitorStateSchema, type SceneMonitorStatus, SceneMonitorStatusSchema, type SceneReference, SceneReferenceSchema, sceneMonitorCapability, } from './scene-monitor.cap.js';
 export { type INativeObjectDetectionProvider, type NativeDetection, NativeDetectionSchema, type NativeObjectClass, NativeObjectClassEnum, type NativeObjectDetectionRuntimeState, NativeObjectDetectionRuntimeStateSchema, type NativeObjectDetectionStatus, NativeObjectDetectionStatusSchema, nativeObjectDetectionCapability, } from './native-object-detection.cap.js';
 export { ClientNetworkStatsSchema, DeviceNetworkStatsSchema, type INetworkQualityProvider, networkQualityCapability, StreamNetworkStatsSchema, } from './network-quality.cap.js';
 export { ClusterAddonNodeDeploymentSchema, ClusterAddonStatusEntrySchema, type INodesProvider, nodesCapability, TopologyNodeSchema, TopologyProcessSchema, TopologyServiceSchema, } from './nodes.cap.js';
 export { type INotifierProvider, type NotifierAction, type NotifierPriority, type NotifierSendInput, type NotifierSendResult, type NotifierStatus, NotifierStatusSchema, type NotifierSupports, notifierCapability, } from './notifier.cap.js';
 export { type INumericSensorProvider, type NumericSensorStatus, NumericSensorStatusSchema, numericSensorCapability, } from './numeric-sensor.cap.js';
 export { type IOsdProvider, type OsdOverlay, type OsdOverlayKind, OsdOverlayKindEnum, OsdOverlayPatchSchema, OsdOverlaySchema, type OsdPosition, OsdPositionEnum, type OsdStatus, OsdStatusSchema, osdCapability, } from './osd.cap.js';
-export { type IPlateGalleryProvider, type PlateInfo, plateGalleryCapability, } from './plate-gallery.cap.js';
+export { type IPlateGalleryProvider, type PlateInfo, type Vehicle, type VehicleSampleInfo, plateGalleryCapability, } from './plate-gallery.cap.js';
 export { type HardwareDecodeAccels, type HardwareEncoderId, type HardwareEncoderProbe, type HardwareEncoders, type IPlatformProbeProvider, platformProbeCapability, } from './platform-probe.cap.js';
 export { type IPowerMeterProvider, type PowerMeterStatus, PowerMeterStatusSchema, powerMeterCapability, } from './power-meter.cap.js';
 export { type GpsLocation, type IPresenceProvider, type PresenceStatus, PresenceStatusSchema, presenceCapability, } from './presence.cap.js';
@@ -263,10 +267,13 @@ import type { motionCapability } from './motion.cap.js';
 import type { motionDetectionCapability } from './motion-detection.cap.js';
 import type { motionTriggerCapability } from './motion-trigger.cap.js';
 import type { motionZonesCapability } from './motion-zones.cap.js';
+import type { sceneMonitorCapability } from './scene-monitor.cap.js';
 import type { mqttBrokerCapability } from './mqtt-broker.cap.js';
 import type { networkAccessCapability } from './network-access.cap.js';
 import type { networkQualityCapability } from './network-quality.cap.js';
 import type { nodesCapability } from './nodes.cap.js';
+import type { llmCapability } from './llm.cap.js';
+import type { llmRuntimeCapability } from './llm-runtime.cap.js';
 import type { notificationOutputCapability } from './notification-output.cap.js';
 import type { notifierCapability } from './notifier.cap.js';
 import type { numericSensorCapability } from './numeric-sensor.cap.js';
@@ -313,6 +320,6 @@ import type { webrtcSessionCapability } from './webrtc-session.cap.js';
 import type { zoneAnalyticsCapability } from './zone-analytics.cap.js';
 import type { zoneRulesCapability } from './zone-rules.cap.js';
 import type { zonesCapability } from './zones.cap.js';
-type AnyCapability = typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof settingsStoreCapability | typeof logDestinationCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof notificationOutputCapability | typeof advancedNotifierCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof consumablesCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof eventsCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof deviceOpsCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof imageSettingsCapability;
+type AnyCapability = typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof settingsStoreCapability | typeof logDestinationCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof advancedNotifierCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof consumablesCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof eventsCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof deviceOpsCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof imageSettingsCapability;
 export type CapabilityName = AnyCapability['name'];
 export type ITypedReadinessRegistry = IReadinessRegistry<CapabilityName>;

package/dist/capabilities/llm-runtime.cap.d.ts

@@ -0,0 +1,286 @@
+/**
+ * `llm-runtime` — node-side managed llama.cpp executor (spec §4). Registered
+ * on EVERY node where `addon-ai` is installed; the hub `llm` provider reaches
+ * a specific node's runtime with `nodePin(profile.runtime.nodeId)` — normal
+ * cap routing, zero bespoke plumbing. `internal: true`: the operator reaches
+ * this only through the `llm` cap's methods.
+ *
+ * One running llama-server child per node in v1 (models are RAM-heavy).
+ * Resource ceiling = llama-server flags + idleStopMinutes ONLY (no RSS
+ * watchdog — operator decision #3).
+ */
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+export declare const ManagedModelRefSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"catalog">;
+    catalogId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"url">;
+    url: z.ZodString;
+    sha256: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"path">;
+    path: z.ZodString;
+}, z.core.$strip>], "kind">;
+export type ManagedModelRef = z.infer<typeof ManagedModelRefSchema>;
+export declare const ManagedRuntimeConfigSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    engine: z.ZodEnum<{
+        "llama-cpp": "llama-cpp";
+    }>;
+    model: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"catalog">;
+        catalogId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        sha256: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+    }, z.core.$strip>], "kind">;
+    contextSize: z.ZodDefault<z.ZodNumber>;
+    gpuLayers: z.ZodDefault<z.ZodNumber>;
+    threads: z.ZodOptional<z.ZodNumber>;
+    parallel: z.ZodDefault<z.ZodNumber>;
+    autoStart: z.ZodDefault<z.ZodBoolean>;
+    idleStopMinutes: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type ManagedRuntimeConfig = z.infer<typeof ManagedRuntimeConfigSchema>;
+export declare const LlmRuntimeStatusSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    state: z.ZodEnum<{
+        ready: "ready";
+        stopped: "stopped";
+        failed: "failed";
+        starting: "starting";
+        downloading: "downloading";
+        crashed: "crashed";
+    }>;
+    pid: z.ZodOptional<z.ZodNumber>;
+    port: z.ZodOptional<z.ZodNumber>;
+    modelPath: z.ZodOptional<z.ZodString>;
+    modelId: z.ZodOptional<z.ZodString>;
+    downloadProgress: z.ZodOptional<z.ZodNumber>;
+    lastError: z.ZodOptional<z.ZodString>;
+    crashesInWindow: z.ZodNumber;
+    memoryBytes: z.ZodOptional<z.ZodNumber>;
+    vramBytes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type LlmRuntimeStatus = z.infer<typeof LlmRuntimeStatusSchema>;
+export declare const LlmNodeModelSchema: z.ZodObject<{
+    file: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    catalogId: z.ZodOptional<z.ZodString>;
+    installedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type LlmNodeModel = z.infer<typeof LlmNodeModelSchema>;
+export declare const LlmRuntimeDiskUsageSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    modelsBytes: z.ZodNumber;
+    freeBytes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type LlmRuntimeDiskUsage = z.infer<typeof LlmRuntimeDiskUsageSchema>;
+export declare const LlmRuntimeCompleteInputSchema: z.ZodObject<{
+    addonId: z.ZodOptional<z.ZodString>;
+    profileId: z.ZodOptional<z.ZodString>;
+    consumer: z.ZodString;
+    system: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodString;
+    jsonSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+        mimeType: z.ZodString;
+    }, z.core.$strip>>>;
+    runtime: z.ZodObject<{
+        nodeId: z.ZodString;
+        engine: z.ZodEnum<{
+            "llama-cpp": "llama-cpp";
+        }>;
+        model: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"catalog">;
+            catalogId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"url">;
+            url: z.ZodString;
+            sha256: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"path">;
+            path: z.ZodString;
+        }, z.core.$strip>], "kind">;
+        contextSize: z.ZodDefault<z.ZodNumber>;
+        gpuLayers: z.ZodDefault<z.ZodNumber>;
+        threads: z.ZodOptional<z.ZodNumber>;
+        parallel: z.ZodDefault<z.ZodNumber>;
+        autoStart: z.ZodDefault<z.ZodBoolean>;
+        idleStopMinutes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type LlmRuntimeCompleteInput = z.infer<typeof LlmRuntimeCompleteInputSchema>;
+export declare const llmRuntimeCapability: {
+    readonly name: "llm-runtime";
+    readonly scope: "system";
+    readonly mode: "singleton";
+    readonly internal: true;
+    readonly methods: {
+        readonly complete: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            addonId: z.ZodOptional<z.ZodString>;
+            profileId: z.ZodOptional<z.ZodString>;
+            consumer: z.ZodString;
+            system: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodString;
+            jsonSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            maxTokens: z.ZodOptional<z.ZodNumber>;
+            temperature: z.ZodOptional<z.ZodNumber>;
+            images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+                mimeType: z.ZodString;
+            }, z.core.$strip>>>;
+            runtime: z.ZodObject<{
+                nodeId: z.ZodString;
+                engine: z.ZodEnum<{
+                    "llama-cpp": "llama-cpp";
+                }>;
+                model: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"catalog">;
+                    catalogId: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                    sha256: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"path">;
+                    path: z.ZodString;
+                }, z.core.$strip>], "kind">;
+                contextSize: z.ZodDefault<z.ZodNumber>;
+                gpuLayers: z.ZodDefault<z.ZodNumber>;
+                threads: z.ZodOptional<z.ZodNumber>;
+                parallel: z.ZodDefault<z.ZodNumber>;
+                autoStart: z.ZodDefault<z.ZodBoolean>;
+                idleStopMinutes: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            ok: z.ZodLiteral<true>;
+            text: z.ZodString;
+            model: z.ZodString;
+            usage: z.ZodObject<{
+                inputTokens: z.ZodNumber;
+                outputTokens: z.ZodNumber;
+            }, z.core.$strip>;
+            truncated: z.ZodBoolean;
+            latencyMs: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            ok: z.ZodLiteral<false>;
+            code: z.ZodEnum<{
+                auth: "auth";
+                timeout: "timeout";
+                "rate-limited": "rate-limited";
+                refusal: "refusal";
+                "bad-request": "bad-request";
+                unavailable: "unavailable";
+                "no-profile": "no-profile";
+                "budget-exceeded": "budget-exceeded";
+                "adapter-error": "adapter-error";
+            }>;
+            message: z.ZodString;
+            retryAfterMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>], "ok">, "mutation">;
+        readonly ensureStarted: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            runtime: z.ZodObject<{
+                nodeId: z.ZodString;
+                engine: z.ZodEnum<{
+                    "llama-cpp": "llama-cpp";
+                }>;
+                model: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"catalog">;
+                    catalogId: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                    sha256: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"path">;
+                    path: z.ZodString;
+                }, z.core.$strip>], "kind">;
+                contextSize: z.ZodDefault<z.ZodNumber>;
+                gpuLayers: z.ZodDefault<z.ZodNumber>;
+                threads: z.ZodOptional<z.ZodNumber>;
+                parallel: z.ZodDefault<z.ZodNumber>;
+                autoStart: z.ZodDefault<z.ZodBoolean>;
+                idleStopMinutes: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            nodeId: z.ZodString;
+            state: z.ZodEnum<{
+                ready: "ready";
+                stopped: "stopped";
+                failed: "failed";
+                starting: "starting";
+                downloading: "downloading";
+                crashed: "crashed";
+            }>;
+            pid: z.ZodOptional<z.ZodNumber>;
+            port: z.ZodOptional<z.ZodNumber>;
+            modelPath: z.ZodOptional<z.ZodString>;
+            modelId: z.ZodOptional<z.ZodString>;
+            downloadProgress: z.ZodOptional<z.ZodNumber>;
+            lastError: z.ZodOptional<z.ZodString>;
+            crashesInWindow: z.ZodNumber;
+            memoryBytes: z.ZodOptional<z.ZodNumber>;
+            vramBytes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, "mutation">;
+        readonly stop: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly status: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+            nodeId: z.ZodString;
+            state: z.ZodEnum<{
+                ready: "ready";
+                stopped: "stopped";
+                failed: "failed";
+                starting: "starting";
+                downloading: "downloading";
+                crashed: "crashed";
+            }>;
+            pid: z.ZodOptional<z.ZodNumber>;
+            port: z.ZodOptional<z.ZodNumber>;
+            modelPath: z.ZodOptional<z.ZodString>;
+            modelId: z.ZodOptional<z.ZodString>;
+            downloadProgress: z.ZodOptional<z.ZodNumber>;
+            lastError: z.ZodOptional<z.ZodString>;
+            crashesInWindow: z.ZodNumber;
+            memoryBytes: z.ZodOptional<z.ZodNumber>;
+            vramBytes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly installModel: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            model: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"catalog">;
+                catalogId: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                url: z.ZodString;
+                sha256: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"path">;
+                path: z.ZodString;
+            }, z.core.$strip>], "kind">;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly deleteModel: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            file: z.ZodString;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly listLocalModels: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            sizeBytes: z.ZodNumber;
+            catalogId: z.ZodOptional<z.ZodString>;
+            installedAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly getDiskUsage: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+            nodeId: z.ZodString;
+            modelsBytes: z.ZodNumber;
+            freeBytes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+    };
+};
+export type ILlmRuntimeProvider = InferProvider<typeof llmRuntimeCapability>;