@camstack/types 1.2.98 → 1.2.99

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.
@@ -24696,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
@@ -24737,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`
@@ -24774,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
@@ -24806,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.
 		*/
@@ -36817,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",
@@ -36853,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",
@@ -43055,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),
@@ -47382,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;
@@ -47428,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;
@@ -47603,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;