@camstack/types 1.0.5 → 1.0.7

package/dist/inference/runtime-capabilities.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Hardware-driven inference runtime capabilities — SINGLE SOURCE OF TRUTH.
+ *
+ * Pure module: no I/O, no subprocess, no Python import.
+ * Consumed by both `platform-probe` (@camstack/system) and
+ * `detection-pipeline` (@camstack/addon-pipeline).
+ *
+ * Do NOT import from @camstack/system or @camstack/addon-pipeline.
+ */
+import type { ModelFormat } from '../types/models.js';
+import type { HardwareInfo, PlatformScore } from '../interfaces/platform.js';
+export type RuntimeId = 'onnx' | 'openvino' | 'coreml';
+export interface DeviceOption {
+    readonly value: string;
+    readonly label: string;
+}
+/**
+ * Returns the list of supported runtime IDs for given hardware.
+ * onnx is always included (universal floor); accelerators added when hw matches.
+ */
+export declare function supportedRuntimes(hw: HardwareInfo | null): readonly RuntimeId[];
+/**
+ * Returns the device options for a given runtime and hardware probe.
+ */
+export declare function runtimeDevices(id: RuntimeId, hw: HardwareInfo | null): readonly DeviceOption[];
+/**
+ * Returns the default device string for a given runtime.
+ * onnx → 'cpu', openvino → 'auto', coreml → 'all'
+ */
+export declare function defaultDeviceFor(id: RuntimeId): string;
+/**
+ * Returns the model format required for a given runtime.
+ * Delegates to `formatForRuntime` from runtime-mapping.ts.
+ */
+export declare function modelFormatForRuntime(id: RuntimeId): ModelFormat;
+interface ScoreRuntimesResult {
+    readonly scores: readonly PlatformScore[];
+    readonly best: PlatformScore;
+}
+/**
+ * Scores all applicable inference backends for the given hardware.
+ *
+ * Rules (hardware-driven only — no Python import probes):
+ * - coreml:   score 95, darwin+arm64
+ * - cuda:     score 85, nvidia gpu
+ * - openvino: score 90 if intel-npu present, else 80 if intel gpu
+ * - cpu:      score 50 (universal floor, always included)
+ *
+ * All hardware-matched entries are `available: true`.
+ * Scores are sorted descending; `best` is the first available entry
+ * (or last entry as fallback).
+ */
+export declare function scoreRuntimes(hw: HardwareInfo): ScoreRuntimesResult;
+export {};

package/dist/interfaces/addon.d.ts

@@ -706,8 +706,8 @@ export interface ICamstackAddon {
      *  consumed by override-mode UIs (benchmark) so cascade-aware
      *  addons can re-derive dependent options without touching the
      *  persisted store. */
-    getGlobalSettings?(overlay?: Record<string, unknown>, cap?: string): Promise<ConfigUISchemaWithValues>;
-    updateGlobalSettings?(patch: Record<string, unknown>): Promise<void>;
+    getGlobalSettings?(overlay?: Record<string, unknown>, cap?: string, nodeId?: string): Promise<ConfigUISchemaWithValues | null>;
+    updateGlobalSettings?(patch: Record<string, unknown>, nodeId?: string): Promise<void>;
     /** Level 2 — per-device settings (schema + values). Appears in
      *  Device Overrides. */
     getDeviceSettings?(deviceId: number): Promise<ConfigUISchemaWithValues>;

package/dist/interfaces/metrics-provider.d.ts

@@ -1,5 +1,5 @@
 import type { z } from 'zod';
-import type { CpuBreakdownSchema, MemoryInfoSchema, DiskIoSnapshotSchema, NetworkIoSnapshotSchema, MetricsGpuInfoSchema, ProcessResourceInfoSchema, PressureInfoSchema, SystemResourceSnapshotSchema, DiskSpaceInfoSchema, PidResourceStatsSchema, AddonInstanceSchema, NodeProcessSchema, KillProcessInputSchema, KillProcessResultSchema } from '../capabilities/metrics-provider.cap.js';
+import type { CpuBreakdownSchema, MemoryInfoSchema, DiskIoSnapshotSchema, NetworkIoSnapshotSchema, MetricsGpuInfoSchema, ProcessResourceInfoSchema, PressureInfoSchema, SystemResourceSnapshotSchema, DiskSpaceInfoSchema, PidResourceStatsSchema, AddonInstanceSchema, NodeProcessSchema, KillProcessInputSchema, KillProcessResultSchema, DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema } from '../capabilities/metrics-provider.cap.js';
 export type CpuBreakdown = z.infer<typeof CpuBreakdownSchema>;
 export type MemoryInfo = z.infer<typeof MemoryInfoSchema>;
 export type DiskIoSnapshot = z.infer<typeof DiskIoSnapshotSchema>;
@@ -14,3 +14,5 @@ export type AddonInstance = z.infer<typeof AddonInstanceSchema>;
 export type NodeProcess = z.infer<typeof NodeProcessSchema>;
 export type KillProcessInput = z.infer<typeof KillProcessInputSchema>;
 export type KillProcessResult = z.infer<typeof KillProcessResultSchema>;
+export type DumpHeapSnapshotInput = z.infer<typeof DumpHeapSnapshotInputSchema>;
+export type DumpHeapSnapshotResult = z.infer<typeof DumpHeapSnapshotResultSchema>;

package/dist/node.js

@@ -21,7 +21,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_index = require("./index.js");
+const require_err_msg = require("./err-msg-COpsHMw2.js");
 let node_fs = require("node:fs");
 node_fs = __toESM(node_fs);
 let node_path = require("node:path");
@@ -372,7 +372,7 @@ async function installPythonPackages(pythonPath, packages, logger) {
 		});
 		logger.info("Python packages installed successfully");
 	} catch (err) {
-		logger.error("Failed to install Python packages", { meta: { error: require_index.errMsg$1(err) } });
+		logger.error("Failed to install Python packages", { meta: { error: require_err_msg.errMsg(err) } });
 		throw err;
 	}
 }
@@ -422,7 +422,7 @@ async function installPythonRequirements(pythonPath, requirementsFile, logger) {
 	} catch (err) {
 		logger.error("Failed to install Python requirements", { meta: {
 			requirementsFile,
-			error: require_index.errMsg$1(err)
+			error: require_err_msg.errMsg(err)
 		} });
 		throw err;
 	}

package/dist/node.mjs

@@ -1,4 +1,4 @@
-import { errMsg } from "./index.mjs";
+import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 import * as fs from "node:fs";
 import { chmodSync, createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
 import * as path from "node:path";

package/dist/schemas/auth-records.d.ts

@@ -33,15 +33,15 @@ export declare const MethodAccessSchema: z.ZodEnum<{
 }>;
 export type MethodAccess = z.infer<typeof MethodAccessSchema>;
 export declare const CapScopeSchema: z.ZodEnum<{
-    device: "device";
     system: "system";
+    device: "device";
 }>;
 export type CapScope = z.infer<typeof CapScopeSchema>;
 export declare const TokenScopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"category">;
     target: z.ZodEnum<{
-        device: "device";
         system: "system";
+        device: "device";
     }>;
     access: z.ZodArray<z.ZodEnum<{
         view: "view";
@@ -84,8 +84,8 @@ export declare const UserRecordSchema: z.ZodObject<{
     scopes: z.ZodDefault<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";
@@ -142,8 +142,8 @@ export declare const ScopedTokenSchema: z.ZodObject<{
     scopes: 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";