@camstack/types 1.0.4 → 1.0.6

package/dist/capabilities/log-destination.cap.d.ts

@@ -1,17 +1,17 @@
 import { z } from 'zod';
 import { type InferProvider } from './capability-definition.js';
 declare const LogLevelSchema: z.ZodEnum<{
-    info: "info";
     error: "error";
     debug: "debug";
+    info: "info";
     warn: "warn";
 }>;
 declare const LogEntrySchema: z.ZodObject<{
     timestamp: z.ZodDate;
     level: z.ZodEnum<{
-        info: "info";
         error: "error";
         debug: "debug";
+        info: "info";
         warn: "warn";
     }>;
     scope: z.ZodArray<z.ZodString>;
@@ -28,9 +28,9 @@ export declare const logDestinationCapability: {
         readonly write: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             timestamp: z.ZodDate;
             level: z.ZodEnum<{
-                info: "info";
                 error: "error";
                 debug: "debug";
+                info: "info";
                 warn: "warn";
             }>;
             scope: z.ZodArray<z.ZodString>;
@@ -41,9 +41,9 @@ export declare const logDestinationCapability: {
         readonly query: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             scope: z.ZodOptional<z.ZodArray<z.ZodString>>;
             level: z.ZodOptional<z.ZodEnum<{
-                info: "info";
                 error: "error";
                 debug: "debug";
+                info: "info";
                 warn: "warn";
             }>>;
             since: z.ZodOptional<z.ZodDate>;
@@ -53,9 +53,9 @@ export declare const logDestinationCapability: {
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             timestamp: z.ZodDate;
             level: z.ZodEnum<{
-                info: "info";
                 error: "error";
                 debug: "debug";
+                info: "info";
                 warn: "warn";
             }>;
             scope: z.ZodArray<z.ZodString>;

package/dist/capabilities/media-player.cap.d.ts

@@ -14,9 +14,9 @@ import { DeviceType } from '../device/device-type.js';
  * fetch — same pattern as `PanTiltZoom` for cameras.
  */
 export declare const MediaPlayerStateSchema: z.ZodEnum<{
-    off: "off";
     idle: "idle";
     playing: "playing";
+    off: "off";
     paused: "paused";
     on: "on";
     buffering: "buffering";
@@ -39,9 +39,9 @@ declare const MediaInfoSchema: z.ZodObject<{
 export type MediaInfo = z.infer<typeof MediaInfoSchema>;
 export declare const MediaPlayerStatusSchema: z.ZodObject<{
     state: z.ZodEnum<{
-        off: "off";
         idle: "idle";
         playing: "playing";
+        off: "off";
         paused: "paused";
         on: "on";
         buffering: "buffering";
@@ -128,9 +128,9 @@ export declare const mediaPlayerCapability: {
     readonly status: {
         readonly schema: z.ZodObject<{
             state: z.ZodEnum<{
-                off: "off";
                 idle: "idle";
                 playing: "playing";
+                off: "off";
                 paused: "paused";
                 on: "on";
                 buffering: "buffering";
@@ -166,9 +166,9 @@ export declare const mediaPlayerCapability: {
      */
     readonly runtimeState: z.ZodObject<{
         state: z.ZodEnum<{
-            off: "off";
             idle: "idle";
             playing: "playing";
+            off: "off";
             paused: "paused";
             on: "on";
             buffering: "buffering";

package/dist/capabilities/mesh-network.cap.d.ts

@@ -34,8 +34,8 @@ declare const MeshEndpointSchema: z.ZodObject<{
     hostname: z.ZodString;
     port: z.ZodNumber;
     protocol: z.ZodEnum<{
-        https: "https";
         http: "http";
+        https: "https";
     }>;
 }, z.core.$strip>;
 export type MeshEndpoint = z.infer<typeof MeshEndpointSchema>;
@@ -80,8 +80,8 @@ export declare const MeshStatusSchema: z.ZodObject<{
         hostname: z.ZodString;
         port: z.ZodNumber;
         protocol: z.ZodEnum<{
-            https: "https";
             http: "http";
+            https: "https";
         }>;
     }, z.core.$strip>>>;
     error: z.ZodOptional<z.ZodString>;
@@ -123,8 +123,8 @@ export declare const meshNetworkCapability: {
                 hostname: z.ZodString;
                 port: z.ZodNumber;
                 protocol: z.ZodEnum<{
-                    https: "https";
                     http: "http";
+                    https: "https";
                 }>;
             }, z.core.$strip>>>;
             error: z.ZodOptional<z.ZodString>;

package/dist/capabilities/metrics-provider.cap.d.ts

@@ -157,6 +157,8 @@ declare const PidResourceStatsSchema: z.ZodObject<{
     pid: z.ZodNumber;
     cpu: z.ZodNumber;
     memory: z.ZodNumber;
+    privateBytes: z.ZodOptional<z.ZodNumber>;
+    sharedBytes: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 declare const AddonInstanceSchema: z.ZodObject<{
     addonId: z.ZodString;
@@ -168,8 +170,8 @@ declare const AddonInstanceSchema: z.ZodObject<{
     pid: z.ZodNumber;
     state: z.ZodEnum<{
         running: "running";
-        stopped: "stopped";
         starting: "starting";
+        stopped: "stopped";
         stopping: "stopping";
         crashed: "crashed";
     }>;
@@ -205,6 +207,15 @@ declare const KillProcessResultSchema: z.ZodObject<{
         SIGKILL: "SIGKILL";
     }>>;
 }, z.core.$strip>;
+declare const DumpHeapSnapshotInputSchema: z.ZodObject<{
+    addonId: z.ZodString;
+}, z.core.$strip>;
+declare const DumpHeapSnapshotResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    path: z.ZodOptional<z.ZodString>;
+    pid: z.ZodOptional<z.ZodNumber>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 declare const SystemMetricsSchema: z.ZodObject<{
     cpuPercent: z.ZodNumber;
     memoryPercent: z.ZodNumber;
@@ -436,6 +447,8 @@ export declare const metricsProviderCapability: {
             pid: z.ZodNumber;
             cpu: z.ZodNumber;
             memory: z.ZodNumber;
+            privateBytes: z.ZodOptional<z.ZodNumber>;
+            sharedBytes: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * List addon instances known to this node — one entry per forked worker
@@ -453,8 +466,8 @@ export declare const metricsProviderCapability: {
             pid: z.ZodNumber;
             state: z.ZodEnum<{
                 running: "running";
-                stopped: "stopped";
                 starting: "starting";
+                stopped: "stopped";
                 stopping: "stopping";
                 crashed: "crashed";
             }>;
@@ -472,6 +485,8 @@ export declare const metricsProviderCapability: {
             pid: z.ZodNumber;
             cpu: z.ZodNumber;
             memory: z.ZodNumber;
+            privateBytes: z.ZodOptional<z.ZodNumber>;
+            sharedBytes: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * Snapshot of every camstack-related process on this node with a
@@ -515,7 +530,22 @@ export declare const metricsProviderCapability: {
                 SIGKILL: "SIGKILL";
             }>>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * Tell the addon's forked runner to write a V8 heap snapshot to disk (via
+         * SIGUSR2 — the runner's diagnostic handler). Also logs its
+         * `process.memoryUsage()` + heap-space breakdown. Refuses pids not in the
+         * live `listNodeProcesses()` snapshot. Use for deep per-addon memory
+         * attribution; copy the returned path off the node to analyze.
+         */
+        readonly dumpHeapSnapshot: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            addonId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            success: z.ZodBoolean;
+            path: z.ZodOptional<z.ZodString>;
+            pid: z.ZodOptional<z.ZodNumber>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, "mutation">;
     };
 };
 export type IMetricsProvider = InferProvider<typeof metricsProviderCapability>;
-export { SystemMetricsSchema, SystemResourceSnapshotSchema, DiskSpaceInfoSchema, MetricsGpuInfoSchema, PidResourceStatsSchema, AddonInstanceSchema, NodeProcessSchema, KillProcessInputSchema, KillProcessResultSchema, CpuBreakdownSchema, MemoryInfoSchema, DiskIoSnapshotSchema, NetworkIoSnapshotSchema, ProcessResourceInfoSchema, PressureInfoSchema, };
+export { SystemMetricsSchema, SystemResourceSnapshotSchema, DiskSpaceInfoSchema, MetricsGpuInfoSchema, PidResourceStatsSchema, AddonInstanceSchema, NodeProcessSchema, KillProcessInputSchema, KillProcessResultSchema, DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, CpuBreakdownSchema, MemoryInfoSchema, DiskIoSnapshotSchema, NetworkIoSnapshotSchema, ProcessResourceInfoSchema, PressureInfoSchema, };

package/dist/capabilities/network-access.cap.d.ts

@@ -5,8 +5,8 @@ declare const NetworkEndpointSchema: z.ZodObject<{
     hostname: z.ZodString;
     port: z.ZodNumber;
     protocol: z.ZodEnum<{
-        https: "https";
         http: "http";
+        https: "https";
     }>;
 }, z.core.$strip>;
 declare const NetworkAccessStatusSchema: z.ZodObject<{
@@ -16,8 +16,8 @@ declare const NetworkAccessStatusSchema: z.ZodObject<{
         hostname: z.ZodString;
         port: z.ZodNumber;
         protocol: z.ZodEnum<{
-            https: "https";
             http: "http";
+            https: "https";
         }>;
     }, z.core.$strip>>;
     error: z.ZodOptional<z.ZodString>;
@@ -37,8 +37,8 @@ declare const NetworkEndpointEntrySchema: z.ZodObject<{
     hostname: z.ZodString;
     port: z.ZodNumber;
     protocol: z.ZodEnum<{
-        https: "https";
         http: "http";
+        https: "https";
     }>;
     id: z.ZodString;
     label: z.ZodString;
@@ -56,8 +56,8 @@ export declare const networkAccessCapability: {
             hostname: z.ZodString;
             port: z.ZodNumber;
             protocol: z.ZodEnum<{
-                https: "https";
                 http: "http";
+                https: "https";
             }>;
         }, z.core.$strip>, "mutation">;
         readonly stop: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodVoid, "mutation">;
@@ -66,8 +66,8 @@ export declare const networkAccessCapability: {
             hostname: z.ZodString;
             port: z.ZodNumber;
             protocol: z.ZodEnum<{
-                https: "https";
                 http: "http";
+                https: "https";
             }>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly getStatus: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
@@ -77,8 +77,8 @@ export declare const networkAccessCapability: {
                 hostname: z.ZodString;
                 port: z.ZodNumber;
                 protocol: z.ZodEnum<{
-                    https: "https";
                     http: "http";
+                    https: "https";
                 }>;
             }, z.core.$strip>>;
             error: z.ZodOptional<z.ZodString>;
@@ -93,8 +93,8 @@ export declare const networkAccessCapability: {
             hostname: z.ZodString;
             port: z.ZodNumber;
             protocol: z.ZodEnum<{
-                https: "https";
                 http: "http";
+                https: "https";
             }>;
             id: z.ZodString;
             label: z.ZodString;

package/dist/capabilities/oauth-integration.cap.d.ts

@@ -13,8 +13,8 @@ declare const OauthIntegrationDescriptorSchema: z.ZodObject<{
     requestedScopes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"category">;
         target: z.ZodEnum<{
-            device: "device";
             system: "system";
+            device: "device";
         }>;
         access: z.ZodArray<z.ZodEnum<{
             view: "view";
@@ -61,8 +61,8 @@ export declare const oauthIntegrationCapability: {
             requestedScopes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"category">;
                 target: z.ZodEnum<{
-                    device: "device";
                     system: "system";
+                    device: "device";
                 }>;
                 access: z.ZodArray<z.ZodEnum<{
                     view: "view";

package/dist/capabilities/pipeline-executor.cap.d.ts

@@ -297,6 +297,25 @@ declare const DetectorOutputSchema: z.ZodObject<{
     inferenceMs: z.ZodNumber;
     modelId: z.ZodString;
 }, z.core.$strip>;
+declare const EngineProvisioningSchema: z.ZodObject<{
+    runtimeId: z.ZodNullable<z.ZodEnum<{
+        onnx: "onnx";
+        coreml: "coreml";
+        openvino: "openvino";
+    }>>;
+    device: z.ZodNullable<z.ZodString>;
+    state: z.ZodEnum<{
+        ready: "ready";
+        idle: "idle";
+        installing: "installing";
+        verifying: "verifying";
+        failed: "failed";
+    }>;
+    progress: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+    nextRetryAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type EngineProvisioning = z.infer<typeof EngineProvisioningSchema>;
 export type PipelineStepInputOutput = {
     readonly addonId: string;
     readonly modelId: string;
@@ -393,6 +412,34 @@ export declare const pipelineExecutorCapability: {
             }>;
             device: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * Per-node detection-engine provisioning snapshot. Returns the live
+         * state of the lazy runtime-provisioning machine on `nodeId`
+         * (idle / installing / verifying / ready / failed). The UI pairs this
+         * one-shot query with the `pipeline.engine-provisioning` live event
+         * (emitted on every transition) to drive a per-node "engine ready?"
+         * indicator without polling. Phase 2.
+         */
+        readonly getEngineProvisioning: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            nodeId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            runtimeId: z.ZodNullable<z.ZodEnum<{
+                onnx: "onnx";
+                coreml: "coreml";
+                openvino: "openvino";
+            }>>;
+            device: z.ZodNullable<z.ZodString>;
+            state: z.ZodEnum<{
+                ready: "ready";
+                idle: "idle";
+                installing: "installing";
+                verifying: "verifying";
+                failed: "failed";
+            }>;
+            progress: z.ZodOptional<z.ZodNumber>;
+            error: z.ZodOptional<z.ZodString>;
+            nextRetryAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly getVideoPipelineSteps: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodRecord<z.ZodString, z.ZodObject<{
             modelId: z.ZodString;
             settings: z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -918,4 +965,4 @@ export declare const pipelineExecutorCapability: {
     };
 };
 export type IPipelineExecutorProvider = InferProvider<typeof pipelineExecutorCapability>;
-export { PipelineEngineChoiceSchema, PipelineDefaultStepSchema, DetectorOutputSchema, PipelineSchemaSchema, PipelineAddonSchemaSchema, PipelineSlotSchemaSchema, PipelineModelOptionSchema, AvailableEngineSchema, PipelineTemplateSchema, PipelineTemplateStepSchema, EngineDeviceInfoSchema, };
+export { PipelineEngineChoiceSchema, PipelineDefaultStepSchema, DetectorOutputSchema, PipelineSchemaSchema, PipelineAddonSchemaSchema, PipelineSlotSchemaSchema, PipelineModelOptionSchema, AvailableEngineSchema, PipelineTemplateSchema, PipelineTemplateStepSchema, EngineDeviceInfoSchema, EngineProvisioningSchema, };