@camstack/types 1.2.6 → 1.2.8

package/dist/interfaces/pipeline-executor-capability.d.ts

@@ -8,7 +8,7 @@ import type { FrameResult } from '../types/detection.js';
 import type { ConfigUISchema } from './config-ui.js';
 import type { InferenceCapabilities } from './inference-capabilities.js';
 import type { IAddonResolver } from './pipeline-runner.js';
-import type { EngineProvisioning, PipelineValidationResult } from '../capabilities/pipeline-executor.cap.js';
+import type { EngineProvisioning, NativeCropRef, PipelineValidationResult } from '../capabilities/pipeline-executor.cap.js';
 /**
  * Step configuration for pipeline execution — no runtime/backend (comes
  * from engine). Phase 7 (settings redesign) removed the generic
@@ -81,6 +81,15 @@ export interface PipelineRunInput {
      * pipelineRunner.runDetailSubtree (two-plane design).
      */
     readonly plane?: PipelineExecutionPlane;
+    /**
+     * Two-plane NATIVE child-crop reference (detail plane). Set by
+     * `runDetailSubtree` ONLY when the parent crop was resolved from the frame's
+     * retained native surface — lets the executor re-cut a leaf crop child's ROI
+     * (plate-ocr, face-embedding, leaf classifiers) at native resolution instead
+     * of the downscaled parent tile. Auxiliary to the image source, not one of the
+     * mutually-exclusive image inputs. Absent ⇒ tile-crop children.
+     */
+    readonly nativeCropRef?: NativeCropRef;
 }
 /**
  * Singleton capability provided by the pipeline-executor addon.

package/dist/{sleep-BQ60XlE9.mjs → sleep-BTyHhhpv.mjs}

@@ -2394,7 +2394,6 @@ function expandCapMethods(def) {
 	};
 	return out;
 }
-/** Shorthand to define a method schema */
 function method(input, output, options) {
 	return {
 		input,
@@ -2402,6 +2401,7 @@ function method(input, output, options) {
 		kind: options?.kind ?? "query",
 		auth: options?.auth ?? "protected",
 		...options?.access !== void 0 ? { access: options.access } : {},
+		...options?.caller !== void 0 ? { caller: options.caller } : {},
 		timeoutMs: options?.timeoutMs
 	};
 }

package/dist/{sleep-eVjOy4ev.js → sleep-D1IRluEi.js}

@@ -2394,7 +2394,6 @@ function expandCapMethods(def) {
 	};
 	return out;
 }
-/** Shorthand to define a method schema */
 function method(input, output, options) {
 	return {
 		input,
@@ -2402,6 +2401,7 @@ function method(input, output, options) {
 		kind: options?.kind ?? "query",
 		auth: options?.auth ?? "protected",
 		...options?.access !== void 0 ? { access: options.access } : {},
+		...options?.caller !== void 0 ? { caller: options.caller } : {},
 		timeoutMs: options?.timeoutMs
 	};
 }

package/dist/types/detection.d.ts

@@ -218,6 +218,19 @@ export interface ObjectDetection extends DetectionBase {
      * the parent person (the person box is not the ArcFace input).
      */
     readonly faceAlignedCrop?: string;
+    /**
+     * Short side (px) of the face measured on the NATIVE surface the aligned
+     * crop was cut from — the executor's own native-aware size measure
+     * (`aligned.nativeFaceShortSidePx`). The detail's `bbox` travels in the
+     * DOWNSCALED detection-frame space (≈640-wide), where a face that is
+     * 90–200px at native reads as 15–33px — so any consumer gating on
+     * `min(bbox.w, bbox.h)` against a pixel threshold silently discards every
+     * distant-camera face (2026-07-22: zero faces from the 4K outdoor cameras).
+     * Consumers MUST prefer this measure when present and fall back to the
+     * detection-space bbox only when absent (older runners / no native surface).
+     * Present iff the face path cut its aligned crop from a native surface.
+     */
+    readonly nativeFaceShortSidePx?: number;
 }
 /** Audio detection — flat, time-localised within the window. */
 export interface AudioDetection extends DetectionBase {

package/dist/types/pipeline-step.d.ts

@@ -94,6 +94,26 @@ export interface StepDefinition {
     readonly rejectClasses?: readonly string[];
     /** Character set for CTC decode (index 0 = blank token) */
     readonly charset?: readonly string[];
+    /**
+     * Region plate grammar for format-aware plate-OCR rescoring (CTC steps).
+     * ISO-3166 alpha-2 code (`'DE'`, future `'IT'`/`'FR'`) selecting the grammar
+     * the greedy read is validated against; `'off'` disables rescoring. Forwarded
+     * to the Python CTC postprocessor exactly like {@link charset}. Absent ⇒ the
+     * postprocessor's backward-compatible 'off' fallback (no rescoring).
+     */
+    readonly plateRegion?: string;
+    /**
+     * Minimum non-space character count below which a CTC read is suppressed as
+     * degenerate near-all-blank noise (plate-OCR plausibility gate). Forwarded to
+     * the Python postprocessor; absent ⇒ its `DEFAULT_MIN_TEXT_LENGTH` (3).
+     */
+    readonly minTextLength?: number;
+    /**
+     * Confidence floor below which a CTC read is suppressed (plate-OCR
+     * plausibility gate). Forwarded to the Python postprocessor; absent ⇒ its
+     * `DEFAULT_MIN_TEXT_CONFIDENCE` (0, disabled).
+     */
+    readonly minTextConfidence?: number;
     /** COCO-to-macro class mapping (e.g., 'car' → 'vehicle') */
     readonly classMap?: ClassMapDefinition;
     /** UI grouping label — steps with the same group are displayed together (e.g., 'Segmentation') */
@@ -183,6 +203,16 @@ export interface PoolModelConfig {
     readonly labels?: readonly string[];
     /** Character set for CTC-based recognizers */
     readonly charset?: readonly string[];
+    /**
+     * Region plate grammar for format-aware CTC plate-OCR rescoring (ISO-3166
+     * alpha-2, e.g. `'DE'`; `'off'` disables). Read by the Python CTC
+     * postprocessor. See {@link StepDefinition.plateRegion}.
+     */
+    readonly plateRegion?: string;
+    /** Plate-OCR plausibility gate: minimum non-space character count. */
+    readonly minTextLength?: number;
+    /** Plate-OCR plausibility gate: confidence floor. */
+    readonly minTextConfidence?: number;
     /** Number of classes (for YOLO: 80 COCO or 1 for plate) */
     readonly numClasses?: number;
     /** Anchor strides for SCRFD (default [8, 16, 32]) */
@@ -231,6 +261,16 @@ export interface TextOutput {
     readonly kind: 'text';
     readonly text: string;
     readonly confidence: number;
+    /**
+     * Format-aware plate-OCR annotation (CTC steps with an active
+     * `plateRegion`). `true` when the returned `text` matches the region plate
+     * grammar (either the greedy read already conformed, or confusable rescoring
+     * repaired it to a conforming candidate); `false` when no grammar-conforming
+     * read was found and the original greedy read was kept verbatim. Absent when
+     * rescoring is disabled (`plateRegion: 'off'` / unset) or the read was
+     * suppressed by the plausibility gate.
+     */
+    readonly formatValid?: boolean;
 }
 export interface MaskOutput {
     readonly kind: 'mask';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.6",
+  "version": "1.2.8",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",