@camstack/types 1.2.97 → 1.2.99

package/dist/generated/addon-api.d.ts

@@ -3592,6 +3592,20 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof localNetworkCapability.methods.setNotificationEndpoint.output>;
             meta: object;
         }>;
+        getViewerEndpoints: TRPCQueryProcedure<{
+            input: {
+                nodeId?: string | undefined;
+            } | undefined;
+            output: z.infer<typeof localNetworkCapability.methods.getViewerEndpoints.output>;
+            meta: object;
+        }>;
+        setViewerEndpoints: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof localNetworkCapability.methods.setViewerEndpoints.input>;
+            output: z.infer<typeof localNetworkCapability.methods.setViewerEndpoints.output>;
+            meta: object;
+        }>;
         getAllowedAddresses: TRPCQueryProcedure<{
             input: {
                 nodeId?: string | undefined;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 949 method paths across 123 capabilities.
+ * Coverage: 951 method paths across 123 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/system-proxy.d.ts

@@ -74,7 +74,7 @@ export interface SystemProxy {
     readonly faceGallery: Pick<InferProvider<typeof faceGalleryCapability>, 'listIdentities' | 'createIdentity' | 'renameIdentity' | 'deleteIdentity' | 'listIdentitySamples' | 'removeSample' | 'getFaceMedia' | 'assignFace' | 'unassignFace' | 'deleteFace' | 'assignFaces' | 'unassignFaces' | 'suggestFaceClusters'>;
     readonly integrations: Pick<InferProvider<typeof integrationsCapability>, 'list' | 'get' | 'getByAddonId' | 'create' | 'update' | 'delete' | 'getSettings' | 'setSettings' | 'getAvailableTypes' | 'testConnection'>;
     readonly llm: Pick<InferProvider<typeof llmCapability>, 'generate' | 'generateVision' | 'cancel' | 'listProfileKinds' | 'listProfiles' | 'upsertProfile' | 'deleteProfile' | 'testProfile' | 'listModels' | 'getDefaults' | 'setDefault' | 'getUsage' | 'listModelCatalog' | 'listRuntimeNodes' | 'listNodeModels' | 'resolveModelRef' | 'installModel' | 'deleteModel' | 'getRuntimeStatus' | 'startRuntime' | 'stopRuntime'>;
-    readonly localNetwork: Pick<InferProvider<typeof localNetworkCapability>, 'list' | 'getPreferred' | 'getConnectionEndpoints' | 'getNotificationEndpoint' | 'setNotificationEndpoint' | 'getAllowedAddresses' | 'setAllowedAddresses' | 'resetAllowlistToBestMatch' | 'getTlsStatus' | 'regenerateCertificate' | 'uploadCertificate' | 'downloadCa' | 'revertToGeneratedCertificate'>;
+    readonly localNetwork: Pick<InferProvider<typeof localNetworkCapability>, 'list' | 'getPreferred' | 'getConnectionEndpoints' | 'getNotificationEndpoint' | 'setNotificationEndpoint' | 'getViewerEndpoints' | 'setViewerEndpoints' | 'getAllowedAddresses' | 'setAllowedAddresses' | 'resetAllowlistToBestMatch' | 'getTlsStatus' | 'regenerateCertificate' | 'uploadCertificate' | 'downloadCa' | 'revertToGeneratedCertificate'>;
     readonly meshNetwork: Pick<InferProvider<typeof meshNetworkCapability>, 'getStatus' | 'join' | 'startLogin' | 'leave' | 'logout' | 'listPeers' | 'testConnection'>;
     readonly metricsProvider: Pick<InferProvider<typeof metricsProviderCapability>, 'collectSnapshot' | 'getCached' | 'getCurrent' | 'getDiskSpace' | 'getGpuInfo' | 'getCpuTemperature' | 'getProcessStats' | 'listAddonInstances' | 'getAddonStats' | 'listNodeProcesses' | 'killProcess' | 'dumpHeapSnapshot'>;
     readonly mqttBroker: Pick<InferProvider<typeof mqttBrokerCapability>, 'listBrokers' | 'getBrokerConfig' | 'addBroker' | 'removeBroker' | 'testConnection' | 'startEmbeddedBroker' | 'stopEmbeddedBroker' | 'getStatus'>;

package/dist/index.d.ts

@@ -104,6 +104,7 @@ export * from './types/detection.js';
 export type { EngineOutput } from './types/engine-output.js';
 export * from './types/entities.js';
 export * from './types/events.js';
+export type * from './types/frame-view.js';
 export * from './types/io.js';
 export * from './types/labels.js';
 export * from './types/live-state.js';

package/dist/index.js

@@ -2359,6 +2359,17 @@ var LabelDefinitionSchema = zod.z.object({
 	description: zod.z.string().optional(),
 	icon: zod.z.string().optional()
 });
+/** Detection-macro targets a catalog `classMap` may resolve to. */
+var CLASS_MAP_MACRO_TARGETS = [
+	"person",
+	"vehicle",
+	"animal",
+	"package"
+];
+var ClassMapDefinitionSchema = zod.z.object({
+	mapping: zod.z.record(zod.z.string(), zod.z.enum(CLASS_MAP_MACRO_TARGETS)),
+	preserveOriginal: zod.z.boolean()
+});
 //#endregion
 //#region src/types/model-variant-groups.ts
 var FORMAT_KEYS = [
@@ -2689,7 +2700,13 @@ var ModelCatalogEntrySchema = zod.z.object({
 	* `id` stays the source of truth for resolution/download/persistence; grouping
 	* is a presentation overlay resolved back to an `id`.
 	*/
-	group: ModelVariantGroupSchema.optional()
+	group: ModelVariantGroupSchema.optional(),
+	/**
+	* Per-MODEL class map override. Absent ⇒ the step's `StepDefinition.classMap`
+	* applies (Frigate / COCO public catalog). Set on a custom model whose raw
+	* labels already ARE the CamStack macros (Scrypted identity map).
+	*/
+	classMap: ClassMapDefinitionSchema.optional()
 });
 var ConvertTargetSchema = zod.z.discriminatedUnion("format", [zod.z.object({
 	format: zod.z.literal("openvino"),
@@ -2718,7 +2735,8 @@ var ModelConvertMetadataSchema = zod.z.object({
 		"ocr",
 		"segmentation"
 	]),
-	faceAlignment: zod.z.boolean().optional()
+	faceAlignment: zod.z.boolean().optional(),
+	classMap: ClassMapDefinitionSchema.optional()
 });
 var ConvertArtifactSchema = zod.z.object({
 	format: zod.z.enum(MODEL_FORMATS),
@@ -16276,6 +16294,33 @@ var NativeCropRefSchema = zod.z.object({
 		h: zod.z.number()
 	})
 });
+zod.z.object({
+	crop: zod.z.object({
+		left: zod.z.number(),
+		top: zod.z.number(),
+		width: zod.z.number().positive(),
+		height: zod.z.number().positive()
+	}).optional(),
+	content: zod.z.object({
+		width: zod.z.number().int().positive(),
+		height: zod.z.number().int().positive()
+	}),
+	fit: zod.z.enum(["stretch", "contain"]),
+	format: zod.z.enum([
+		"rgb",
+		"gray",
+		"jpeg"
+	])
+});
+var FrameRefSchema = zod.z.object({
+	registryId: zod.z.string().min(1),
+	id: zod.z.string().min(1),
+	width: zod.z.number().int().positive(),
+	height: zod.z.number().int().positive(),
+	format: zod.z.enum(["rgb", "gray"]),
+	timestamp: zod.z.number(),
+	capturedAt: zod.z.number().optional()
+});
 var ModelFormatSchema$1 = zod.z.enum([
 	"onnx",
 	"coreml",
@@ -16597,7 +16642,7 @@ var pipelineExecutorCapability = {
 		* legacy call shape used by existing benchmark code; once all
 		* callers pass it explicitly we make it required.
 		*
-		* Exactly one of `frame`, `frameHandle`, `imageBase64`,
+		* Exactly one of `frame`, `frameRef`, `frameHandle`, `imageBase64`,
 		* `referenceImage` must be provided:
 		*  - `frame`: runtime dispatch path (runner → decoded broker frame).
 		*    Carries the raw buffer, dimensions, and format; the executor
@@ -16619,6 +16664,12 @@ var pipelineExecutorCapability = {
 			steps: zod.z.array(PipelineStepInputSchema).min(1),
 			frame: FrameInputSchema.optional(),
 			/**
+			* Process-local lazy frame. Valid only when caller and provider resolve
+			* in the same execution-group process; split/cross-node callers use
+			* `frame`/`image` inline compatibility instead.
+			*/
+			frameRef: FrameRefSchema.optional(),
+			/**
 			* CB5 shm passthrough — a `FrameHandle` naming the same ring slot
 			* the decoded pixels live in. One more member of the one-of
 			* frame/frameHandle/image/imageBase64/referenceImage group.
@@ -16975,7 +17026,10 @@ var NativeCropResultSchema = zod.z.object({
 	* Which source served this crop, so a quality-sensitive consumer (the native
 	* `keyFrame`) can reject a degraded fallback:
 	* - `native` — cut from the decode worker's retained NATIVE surface (the
-	*   quality path).
+	*   quality path). A subject-tile serve is also native-resolution and stays
+	*   `native` here: the public enum cannot name `tile` without a breaking cap
+	*   change. Runner telemetry distinguishes lease vs tile via `source` on the
+	*   internal crop result (`nativeHits` vs `tileHits`).
 	* - `ram-fullframe` — the native surface MISSED but the request was full-frame,
 	*   so the ≤640 RAM `RetainedFrameStore` served it (honest lower-res; legit for
 	*   the blank-frame guard / 640-snapshot resolve, NOT for the clean keyFrame).
@@ -17624,12 +17678,41 @@ var RunnerLocalLoadSchema = zod.z.object({
 * legacy `OrchestratorMetricsSchema` shape so existing dashboards keep
 * working unchanged when they switch to reading from the runner cap.
 */
+var FrameLazyCountersSchema = zod.z.object({
+	framesDecoded: zod.z.number(),
+	framesAdmitted: zod.z.number(),
+	framesDroppedPixelFree: zod.z.number(),
+	viewsMaterialized: zod.z.number(),
+	viewsSkipped: zod.z.number(),
+	workerToRunnerBytes: zod.z.number(),
+	runnerToPoolRawBytes: zod.z.number(),
+	runnerToPoolJpegBytes: zod.z.number(),
+	onDemandFullFrameRequests: zod.z.number(),
+	onDemandCropRequests: zod.z.number(),
+	nativeHits: zod.z.number(),
+	nativeMisses: zod.z.number(),
+	tileHits: zod.z.number(),
+	tileMisses: zod.z.number(),
+	fallbackHits: zod.z.number(),
+	fallbackMisses: zod.z.number(),
+	retainedWritesAvoided: zod.z.number(),
+	residentRefs: zod.z.number(),
+	residentBytes: zod.z.number(),
+	releases: zod.z.number(),
+	evictions: zod.z.number(),
+	staleMisses: zod.z.number()
+});
+var FrameLazyMetricsSchema = zod.z.object({
+	node: FrameLazyCountersSchema,
+	cameras: zod.z.array(FrameLazyCountersSchema.extend({ deviceId: zod.z.number() }))
+});
 var RunnerLocalMetricsSchema = zod.z.object({
 	nodeId: zod.z.string(),
 	activeCameras: zod.z.number(),
 	throttledCameras: zod.z.number(),
 	avgInferenceTimeMs: zod.z.number(),
-	queueDepth: zod.z.number()
+	queueDepth: zod.z.number(),
+	frameLazy: FrameLazyMetricsSchema.optional()
 });
 /**
 * Pipeline Runner capability — runtime detection workhorse.
@@ -19779,6 +19862,9 @@ var storageProviderCapability = {
 };
 //#endregion
 //#region src/capabilities/terminal-session.cap.ts
+/** Profile-exported FormBuilder schema. Shape is ConfigUISchema at the UI. */
+var ProfileSettingsSchemaBridge = zod.z.unknown().nullable();
+var ProfileSettingsBagSchema = zod.z.record(zod.z.string(), zod.z.unknown());
 /**
 * A live terminal session hosted by the provider addon. Output and input do
 * NOT flow through the capability — they use the addon data plane
@@ -19813,7 +19899,9 @@ var TerminalProfileInfoSchema = zod.z.object({
 	executable: zod.z.string().optional(),
 	args: zod.z.array(zod.z.string()).readonly().optional(),
 	cwd: zod.z.string().optional(),
-	environment: zod.z.array(zod.z.string()).readonly().optional()
+	environment: zod.z.array(zod.z.string()).readonly().optional(),
+	/** ConfigUISchema for instance knobs, or null when the profile has none. */
+	settingsSchema: ProfileSettingsSchemaBridge.optional()
 });
 /**
 * A durable operator-created Terminal instance. Profiles are templates; only
@@ -19830,7 +19918,8 @@ var TerminalInstanceInfoSchema = zod.z.object({
 	executable: zod.z.string(),
 	args: zod.z.array(zod.z.string()).readonly(),
 	cwd: zod.z.string(),
-	environment: zod.z.array(zod.z.string()).readonly()
+	environment: zod.z.array(zod.z.string()).readonly(),
+	profileSettings: ProfileSettingsBagSchema
 });
 var TerminalLegacyCameraSchema = zod.z.object({
 	stableId: zod.z.string(),
@@ -19880,7 +19969,8 @@ var terminalSessionCapability = {
 			executable: zod.z.string().max(1024).optional(),
 			args: zod.z.array(zod.z.string().max(2048)).max(64).optional(),
 			cwd: zod.z.string().max(1024).optional(),
-			environment: zod.z.array(zod.z.string().max(4096)).max(64).optional()
+			environment: zod.z.array(zod.z.string().max(4096)).max(64).optional(),
+			profileSettings: ProfileSettingsBagSchema.optional()
 		}), TerminalInstanceInfoSchema, {
 			kind: "mutation",
 			auth: "admin"
@@ -19891,7 +19981,8 @@ var terminalSessionCapability = {
 			executable: zod.z.string().max(1024).optional(),
 			args: zod.z.array(zod.z.string().max(2048)).max(64).optional(),
 			cwd: zod.z.string().max(1024).optional(),
-			environment: zod.z.array(zod.z.string().max(4096)).max(64).optional()
+			environment: zod.z.array(zod.z.string().max(4096)).max(64).optional(),
+			profileSettings: ProfileSettingsBagSchema.optional()
 		}), TerminalInstanceInfoSchema, {
 			kind: "mutation",
 			auth: "admin"
@@ -24530,10 +24621,10 @@ var lawnMowerControlCapability = {
 *
 *  • The SDK (mobile / web client) consumes `getConnectionEndpoints()`
 *    to receive an ordered list of candidate base URLs it should race
-*    on connect — LAN IPv4 first (lowest latency when on same network),
-*    then public hostname (if a tunnel is up), then IPv6. The SDK can
-*    race them with short timeouts and stick with the winner for the
-*    session.
+*    on connect — LAN IPv4 and stable LAN IPv6 first (lowest latency
+*    when on the same network), then public hostname (if a tunnel is
+*    up). The SDK can race them with short timeouts and stick with the
+*    winner for the session.
 *
 * Why hub-only: agents are not directly addressable by the operator's
 * clients — they reverse-connect to the hub. Exposing their interfaces
@@ -24688,6 +24779,17 @@ var NotificationEndpointSchema = zod.z.object({
 	/** What the ranking currently resolves to (null when nothing is reachable). */
 	resolved: zod.z.string().nullable()
 });
+/**
+* The URLs the SDK / viewer should race for API access. `baseUrls` empty =
+* AUTO (every LAN IPv4 + the public tunnel). `resolved` is what that choice
+* currently expands to, so the UI can show the effective set either way.
+*/
+var ViewerEndpointsSchema = zod.z.object({
+	/** The operator's explicit race set, or empty for AUTO. */
+	baseUrls: zod.z.array(zod.z.string()).readonly(),
+	/** What the ranking currently resolves to (may be empty if nothing is up). */
+	resolved: zod.z.array(zod.z.string()).readonly()
+});
 var AllowedAddressesSchema = zod.z.object({ 
 /**
 * Allowlist of interface addresses operators have explicitly opted
@@ -24729,13 +24831,13 @@ var localNetworkCapability = {
 		*/
 		getPreferred: require_sleep.method(zod.z.void(), PreferredSchema),
 		/**
-		* Ordered candidate base URLs the SDK should try on connect.
-		* Includes LAN IPs (one per non-internal interface), the public
-		* tunnel hostname (when active), and loopback as a last-resort
-		* fallback. Filterable by `includeLoopback` / `ipv4Only`.
-		* Honours `getAllowedAddresses()` when set — addresses outside
-		* the allowlist are dropped (the public tunnel + loopback are
-		* always included as escape hatches).
+		* Ordered candidate base URLs (the palette the Network tab shows).
+		* Includes LAN IPv4, stable LAN IPv6, the public tunnel, and mesh when
+		* joined. Loopback is off by default. The SDK races the subset from
+		* `getViewerEndpoints`, not this full list — IPv6 stays here because
+		* WebRTC ICE gathers dual-stack regardless of the HTTP race. Honours
+		* `getAllowedAddresses()` when set — addresses outside the allowlist
+		* are dropped (the public tunnel is still included as an escape hatch).
 		*
 		* **The port is the hub's, not the caller's** (D62 — a function's fact
 		* belongs to whoever already owns it). This method used to take a `port`
@@ -24766,10 +24868,11 @@ var localNetworkCapability = {
 			*/
 			port: zod.z.number().int().min(1).max(65535).optional(),
 			/** Include `http(s)://127.0.0.1:<port>` as the lowest-priority
-			*  candidate. Default `true`. */
+			*  candidate. Default `false` — loopback is not a client route. */
 			includeLoopback: zod.z.boolean().optional(),
-			/** Skip IPv6 entries. Some legacy clients can't parse them.
-			*  Default `false`. */
+			/** Skip IPv6 entries. Default `false` — the palette includes stable
+			*  LAN IPv6 (ICE/WebRTC uses dual-stack regardless). Pass `true` to
+			*  hide them. The viewer HTTP/WS race is `getViewerEndpoints`. */
 			ipv4Only: zod.z.boolean().optional(),
 			/** Scheme to emit for LAN/loopback URLs. Default `'http'`.
 			*  Pass `'https'` when the caller is itself loaded over HTTPS
@@ -24798,6 +24901,19 @@ var localNetworkCapability = {
 		*/
 		setNotificationEndpoint: require_sleep.method(zod.z.object({ baseUrl: zod.z.string().nullable() }), NotificationEndpointSchema, { kind: "mutation" }),
 		/**
+		* The endpoints the SDK / viewer races for API access. Empty `baseUrls`
+		* means AUTO: every LAN IPv4 address plus the public tunnel, never IPv6,
+		* never mesh, never loopback. `resolved` is that set (or the operator's
+		* explicit subset) as it stands right now.
+		*/
+		getViewerEndpoints: require_sleep.method(zod.z.void(), ViewerEndpointsSchema),
+		/**
+		* Replace the viewer race set. Empty `baseUrls` restores AUTO. Stored
+		* verbatim (not indices) so a temporarily-down tunnel is not silently
+		* dropped from the operator's choice.
+		*/
+		setViewerEndpoints: require_sleep.method(zod.z.object({ baseUrls: zod.z.array(zod.z.string()).readonly() }), ViewerEndpointsSchema, { kind: "mutation" }),
+		/**
 		* Read the operator's allowlist. Empty = "auto" (no filter). Used
 		* by the admin UI's address selector to seed its checkbox state.
 		*/
@@ -36809,6 +36925,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"localNetwork.getViewerEndpoints": {
+		capName: "local-network",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"localNetwork.list": {
 		capName: "local-network",
 		capScope: "system",
@@ -36845,6 +36967,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"localNetwork.setViewerEndpoints": {
+		capName: "local-network",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"localNetwork.uploadCertificate": {
 		capName: "local-network",
 		capScope: "system",
@@ -43047,6 +43175,8 @@ function createSystemProxy(api) {
 			getConnectionEndpoints: (input) => dispatch("localNetwork", "getConnectionEndpoints", "query", input),
 			getNotificationEndpoint: (input) => dispatch("localNetwork", "getNotificationEndpoint", "query", input),
 			setNotificationEndpoint: (input) => dispatch("localNetwork", "setNotificationEndpoint", "mutation", input),
+			getViewerEndpoints: (input) => dispatch("localNetwork", "getViewerEndpoints", "query", input),
+			setViewerEndpoints: (input) => dispatch("localNetwork", "setViewerEndpoints", "mutation", input),
 			getAllowedAddresses: (input) => dispatch("localNetwork", "getAllowedAddresses", "query", input),
 			setAllowedAddresses: (input) => dispatch("localNetwork", "setAllowedAddresses", "mutation", input),
 			resetAllowlistToBestMatch: (input) => dispatch("localNetwork", "resetAllowlistToBestMatch", "mutation", input),
@@ -47374,6 +47504,7 @@ exports.CAPABILITY_ROUTER_KEYS = CAPABILITY_ROUTER_KEYS;
 exports.CAP_NAMES_WITH_STATUS = CAP_NAMES_WITH_STATUS;
 exports.CAP_NODE_PIN_CONTEXT_KEY = require_sleep.CAP_NODE_PIN_CONTEXT_KEY;
 exports.CAP_PROVIDER_KIND_MAP = CAP_PROVIDER_KIND_MAP;
+exports.CLASS_MAP_MACRO_TARGETS = CLASS_MAP_MACRO_TARGETS;
 exports.CLUSTER_MODEL_SCOPED_STEPS = CLUSTER_MODEL_SCOPED_STEPS;
 exports.CLUSTER_MODEL_SECTION_ID = CLUSTER_MODEL_SECTION_ID;
 exports.CLUSTER_STEP_SETTING_FIELDS = CLUSTER_STEP_SETTING_FIELDS;
@@ -47420,6 +47551,7 @@ exports.CapScopeSchema = CapScopeSchema;
 exports.CapabilityBindingsSchema = CapabilityBindingsSchema;
 exports.CarbonMonoxideStatusSchema = CarbonMonoxideStatusSchema;
 exports.ChargingStatus = require_sleep.ChargingStatus;
+exports.ClassMapDefinitionSchema = ClassMapDefinitionSchema;
 exports.ClientNetworkStatsSchema = ClientNetworkStatsSchema;
 exports.ClimateControlStatusSchema = ClimateControlStatusSchema;
 exports.ClipPlaybackSchema = ClipPlaybackSchema;
@@ -47595,6 +47727,8 @@ exports.Fmp4BoxSplitter = require_canonical_hash.Fmp4BoxSplitter;
 exports.FrameHandleFormatSchema = require_sleep.FrameHandleFormatSchema;
 exports.FrameHandleSchema = require_sleep.FrameHandleSchema;
 exports.FrameInputSchema = FrameInputSchema;
+exports.FrameLazyCountersSchema = FrameLazyCountersSchema;
+exports.FrameLazyMetricsSchema = FrameLazyMetricsSchema;
 exports.GasStatusSchema = GasStatusSchema;
 exports.GetStreamWithCodecInputSchema = GetStreamWithCodecInputSchema;
 exports.GlobalMetricsSchema = GlobalMetricsSchema;