@camstack/types 0.1.14 → 0.1.16

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

@@ -0,0 +1,200 @@
+import type { PipelineEngineChoice, PipelineConfig } from '../types/pipeline.js';
+import type { PipelineSchema, PipelineDefaultStep, PipelineTemplateStep, PipelineTemplate } from '../types/pipeline-schema.js';
+import type { ModelFormat } from '../types/models.js';
+import type { FrameInput } from '../types/io.js';
+import type { FrameResult, DetectorOutput } 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';
+/**
+ * Step configuration for pipeline execution — no runtime/backend (comes
+ * from engine). Phase 7 (settings redesign) removed the generic
+ * `confidence: number` field; per-step thresholds live in `settings`
+ * and the runtime executor falls back to
+ * `StepDefinition.defaultConfidence` when unset.
+ */
+export interface PipelineStepInput {
+    readonly addonId: string;
+    readonly modelId: string;
+    readonly enabled: boolean;
+    readonly children?: readonly PipelineStepInput[];
+    readonly settings?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Input for pipeline execution. Exactly one image source must be provided:
+ *  - `frame`: runtime dispatch (pipeline-runner — decoded broker frame)
+ *  - `imageBase64`: one-shot benchmark (ImageTab "Run")
+ *  - `referenceImage`: named file from the reference-image store
+ *
+ * `engine` + `deviceId` are optional contextual hints — the executor uses
+ * `deviceId` for per-device overrides and traces, and `engine` to select
+ * the factory (when absent, falls back to the executor's persisted
+ * selection during the migration window).
+ */
+export interface PipelineRunInput {
+    readonly steps: readonly PipelineStepInput[];
+    readonly engine?: PipelineEngineChoice;
+    readonly frame?: FrameInput;
+    readonly referenceImage?: string;
+    readonly imageBase64?: string;
+    /**
+     * Binary JPEG bytes — preferred over `imageBase64` on internal worker
+     * hops (hub → forked worker via Moleculer MsgPack). Skips 33% base64
+     * overhead + per-call decode. Exactly one of `frame`/`image`/
+     * `imageBase64`/`referenceImage` is required.
+     */
+    readonly image?: Uint8Array;
+    readonly deviceId?: number;
+    /**
+     * Correlation id tagged on every `pipeline.progress` event emitted
+     * by this run. When a UI-initiated one-shot (`runPipelineTest`)
+     * generates its own id and passes it here, the UI can filter the
+     * progress stream by `sessionId + nodeId` to ignore concurrent
+     * runtime dispatches from live camera frames. Server-side runs
+     * that omit this field get a generated id.
+     */
+    readonly sessionId?: string;
+}
+/**
+ * Singleton capability provided by the pipeline-executor addon.
+ * The server backend consumes this via the capability registry.
+ */
+export interface IPipelineExecutorProvider {
+    /** Build pipeline schema filtered by the selected (or provided) engine */
+    getSchema(engine?: PipelineEngineChoice): Promise<PipelineSchema>;
+    /** Get all available engines probed on this agent */
+    getAvailableEngines(): Promise<PipelineEngineChoice[]>;
+    /** Build default step tree for an engine */
+    getDefaultSteps(engine: PipelineEngineChoice): Promise<PipelineDefaultStep[]>;
+    /** Get persisted global steps (null if not yet configured). Kept read-only for benchmark fallback. */
+    getGlobalSteps(): Promise<PipelineDefaultStep[] | null>;
+    /** Get the runner-ready pipeline config */
+    getGlobalPipelineConfig(): Promise<PipelineConfig | null>;
+    /** Get the currently selected engine (bootstrap default on the node). */
+    getSelectedEngine(): Promise<PipelineEngineChoice>;
+    getOrchestratorConfigSchema(): Promise<ConfigUISchema>;
+    /** Get full inference capabilities (addon models, runtimes, etc.) */
+    getCapabilities(forceRefresh?: boolean): Promise<InferenceCapabilities>;
+    /** Get available models for a specific addon */
+    getAddonModels(input: {
+        addonId: string;
+    }): Promise<readonly import('./inference-capabilities.js').ModelAvailability[]>;
+    /** Download a specific model */
+    downloadModel(input: {
+        modelId: string;
+        format: ModelFormat;
+        addonId: string;
+    }): Promise<{
+        filePath: string;
+        sizeMB: number;
+        durationMs: number;
+    }>;
+    /** Delete a downloaded model from disk */
+    deleteModel(input: {
+        modelId: string;
+        format: ModelFormat;
+        addonId: string;
+    }): Promise<{
+        success: true;
+    }>;
+    /** Execute the full pipeline on a reference/base64 image (for UI/benchmark) */
+    runPipeline(input: PipelineRunInput, onProgress?: (message: string) => void): Promise<FrameResult>;
+    /**
+     * Batched execution — N raw frames packed into one cap call. Routes
+     * through `SharedInferencePool.inferBatch` (`MSG_INFER_BATCH = 0x03`)
+     * so IPC + JSON envelope cost is amortised N:1 vs N concurrent
+     * `runPipeline` calls. Constraints:
+     *   - Single root step (no crop children) — multi-step trees fall
+     *     back to sequential execution per-frame inside the provider.
+     *   - Uniform model across the batch (Python pool resolves one model
+     *     index per request).
+     * Used by the Scrypted-comparison benchmark to mirror
+     * `detectObjects(media, {batch})`.
+     */
+    runPipelineBatch(input: {
+        readonly steps: readonly PipelineStepInput[];
+        readonly engine?: PipelineEngineChoice;
+        readonly frames: readonly FrameInput[];
+        readonly deviceId?: number;
+        readonly sessionId?: string;
+    }): Promise<{
+        readonly results: readonly FrameResult[];
+    }>;
+    /** Run single-addon detection on a frame */
+    detect(input: {
+        addonId: string;
+        frame: FrameInput;
+        config?: Record<string, unknown>;
+    }): Promise<DetectorOutput>;
+    listReferenceImages(): Promise<Array<{
+        id: string;
+        filename: string;
+        sizeKB: number;
+    }>>;
+    getReferenceImage(input: {
+        filename: string;
+    }): Promise<{
+        base64: string;
+        filename: string;
+    } | null>;
+    getReferenceAudioFiles(): Promise<readonly {
+        filename: string;
+        sizeKb: number;
+    }[]>;
+    getReferenceAudio(input: {
+        filename: string;
+    }): Promise<{
+        base64: string;
+    }>;
+    getAudioCapabilities(): Promise<{
+        activeBackend: string;
+        availableBackends: readonly {
+            id: string;
+            name: string;
+            description: string;
+            available: boolean;
+        }[];
+        sampleRate: number;
+        chunkDurationMs: number;
+    }>;
+    /**
+     * Run the audio classifier on a reference WAV file (benchmark path).
+     *
+     * Returns an `AudioResult` wrapped in a `{success, error?, frame?}`
+     * envelope so the UI can render a clean failure when the classifier
+     * cap isn't available. Each class above the step's `minScore`
+     * threshold becomes one `AudioDetection` entry; the full top-N ranked
+     * list lives in `frame.debug.alternateLabels['audio-classifier']`.
+     */
+    runAudioTest(input: {
+        addonId: string;
+        modelId: string;
+        filename?: string;
+        settings?: Record<string, unknown>;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+        frame?: import('../types/detection.js').AudioResult;
+    }>;
+    listTemplates(): Promise<PipelineTemplate[]>;
+    saveTemplate(input: {
+        name: string;
+        steps: readonly PipelineTemplateStep[];
+        engine: PipelineEngineChoice;
+    }): Promise<PipelineTemplate>;
+    updateTemplate(input: {
+        id: string;
+        name?: string;
+        steps?: readonly PipelineTemplateStep[];
+    }): Promise<PipelineTemplate>;
+    deleteTemplate(input: {
+        id: string;
+    }): Promise<void>;
+    /** Get the detection pipeline addon's config schema (for detection-config UI). */
+    getDetectionConfigSchema(): Promise<ConfigUISchema | null>;
+    /** Get the addon resolver for runtime pipeline execution */
+    getAddonResolver(): Promise<IAddonResolver>;
+    /** Set the in-process tRPC client for inter-capability calls. */
+    setApi(api: unknown): Promise<void>;
+}
+//# sourceMappingURL=pipeline-executor-capability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-executor-capability.d.ts","sourceRoot":"","sources":["../../src/interfaces/pipeline-executor-capability.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,165 @@
+import type { RunnerLocalLoad } from './pipeline-runner-capability.js';
+/** Stream profile quality values. */
+export type OrchestrationStreamProfile = 'high' | 'mid' | 'low';
+/**
+ * How motion is detected for a camera — list of active sources,
+ * OR-ed. Re-export of the cap-side type so orchestrator-facing code
+ * doesn't have to import from the pipeline-runner cap directly.
+ */
+export type OrchestrationMotionSources = import('../capabilities/pipeline-runner.cap.js').MotionSources;
+/**
+ * Pipeline placement record persisted by `addon-pipeline-orchestrator` via
+ * the multi-level settings store. The orchestrator looks this up on every
+ * `DeviceStreamsRegistered` event to decide whether the camera has a
+ * manual pipeline node pin (L1 affinity) or whether the load balancer
+ * (L2 capacity / L3 hardware-aware) needs to pick one.
+ *
+ * Naming convention: `{Pipeline,Decoder}Assignment` — one record type per
+ * placement domain managed by the orchestrator. Future domains (recording,
+ * etc.) follow the same pattern.
+ */
+export interface PipelineAssignment {
+    readonly deviceId: number;
+    /** Moleculer node id of the runner currently responsible for this camera. */
+    readonly agentNodeId: string;
+    /** True when the assignment was set manually, false when chosen by the balancer. */
+    readonly pinned: boolean;
+    /** Why this assignment was made — useful for debugging the load balancer. */
+    readonly reason: 'manual' | 'capacity' | 'hardware-affinity' | 'failover' | 'rebalance';
+    /** Unix timestamp (ms) when the assignment was last updated. */
+    readonly assignedAt: number;
+}
+/**
+ * Decoder placement record. Symmetric to `PipelineAssignment` but for the
+ * decoder-node placement domain (`balanceDecoder` decision: manual pin →
+ * co-located with pipeline → capacity).
+ */
+export interface DecoderAssignment {
+    readonly deviceId: number;
+    /** Moleculer node id of the decoder provider currently responsible for this camera. */
+    readonly decoderNodeId: string;
+    /** True when the assignment was set manually via `assignDecoder`, false when chosen by the balancer. */
+    readonly pinned: boolean;
+    /** Why this assignment was made — useful for debugging the decoder balancer. */
+    readonly reason: 'manual' | 'co-located' | 'capacity' | 'hardware-affinity';
+}
+/**
+ * Per-agent load summary surfaced to the load balancer + dashboards.
+ * Aggregated from each runner's `getLocalLoad` cap call.
+ */
+export interface AgentLoadSummary {
+    readonly nodeId: string;
+    readonly online: boolean;
+    readonly load: RunnerLocalLoad;
+    /** Computed score used by the L2 capacity balancer (lower = less loaded). */
+    readonly score: number;
+}
+/**
+ * Aggregate metrics across the whole detection cluster.
+ *
+ * Replaces the legacy `IPipelineExecutorProvider.orchestratorStatus()` cap
+ * method as the canonical source of truth for global pipeline health.
+ * The orchestrator computes this by aggregating each runner's local
+ * metrics over the cluster.
+ */
+export interface PipelineOrchestratorGlobalMetrics {
+    readonly totalAgents: number;
+    readonly onlineAgents: number;
+    readonly totalCameras: number;
+    readonly attachedCameras: number;
+    readonly activeCameras: number;
+    /** Average inference time across all agents weighted by their camera count. */
+    readonly avgInferenceTimeMs: number;
+    /** Total queue depth across all agents. */
+    readonly queueDepth: number;
+}
+/**
+ * Pipeline Orchestrator provider interface — implemented by
+ * `addon-pipeline-orchestrator`. Lives on the hub.
+ *
+ * Tracks the camera-to-agent assignment map, listens to device lifecycle
+ * events, queries each runner's capacity + hardware profile, and dispatches
+ * `attachCamera` / `detachCamera` cap calls to the appropriate runner
+ * instances. Persists assignments via the multi-level settings store so
+ * they survive hub restarts.
+ *
+ * Strictly the control plane: never sees a frame, never calls inference,
+ * never drains queues. The runner does that work locally on each agent.
+ *
+ * All methods are serializable so the orchestrator is routable across the
+ * cluster (in practice it's hub-only, but the interface enforces the
+ * discipline that nothing leaks across boundaries as live references).
+ */
+export interface IPipelineOrchestratorProvider {
+    /**
+     * Pin a camera's pipeline to a specific agent. Sets the manual L1
+     * affinity in the camera's per-device settings and re-evaluates the
+     * assignment immediately.
+     */
+    assignPipeline(input: {
+        deviceId: number;
+        agentNodeId: string;
+    }): Promise<{
+        success: true;
+    }>;
+    /**
+     * Clear a camera's pipeline pin and stop detection on it.
+     * Removes the entry from the assignment map until the next
+     * `DeviceStreamsRegistered` event triggers a fresh assignment.
+     */
+    unassignPipeline(input: {
+        deviceId: number;
+    }): Promise<{
+        success: true;
+    }>;
+    /**
+     * Trigger a full rebalance pass. Iterates over all assigned cameras,
+     * recomputes the optimal agent for each one based on current load +
+     * hardware affinity, and migrates cameras whose current agent is no
+     * longer optimal. Pinned cameras are never migrated.
+     *
+     * Returns the number of cameras that were migrated to a different agent.
+     */
+    rebalance(): Promise<{
+        migrated: number;
+    }>;
+    /** Get every camera's pipeline placement. */
+    getPipelineAssignments(): readonly PipelineAssignment[];
+    /** Get one camera's pipeline placement, or null if unassigned. */
+    getPipelineAssignment(input: {
+        deviceId: number;
+    }): PipelineAssignment | null;
+    /**
+     * Get per-agent load summaries used by the load balancer + dashboards.
+     * Async so each call can refresh the in-memory cache from live runner
+     * state — the cache is only populated during dispatch / rebalance, so
+     * a sync accessor would return stale (empty) data after a server
+     * restart that rehydrated assignments from disk without
+     * re-dispatching.
+     */
+    getAgentLoad(): Promise<readonly AgentLoadSummary[]>;
+    /** Aggregate global metrics across the whole detection cluster. */
+    getGlobalMetrics(): Promise<PipelineOrchestratorGlobalMetrics>;
+    /**
+     * Read the per-node capability binding map: which addon implements each
+     * well-known cap on the named node. Empty record = no overrides (the
+     * kernel's "first registered wins" lookup applies).
+     */
+    getCapabilityBindings(input: {
+        nodeId: string;
+    }): Promise<Readonly<Record<string, string>>>;
+    /**
+     * Set the addon that implements `capName` on `nodeId`. Persisted in
+     * the orchestrator's settings store; emits a `capability.binding-changed`
+     * event so each kernel process updates its local preferred-provider
+     * registry on the fly.
+     */
+    setCapabilityBinding(input: {
+        nodeId: string;
+        capName: string;
+        addonId: string;
+    }): Promise<{
+        success: true;
+    }>;
+}
+//# sourceMappingURL=pipeline-orchestrator-capability.d.ts.map

package/dist/interfaces/pipeline-orchestrator-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-orchestrator-capability.d.ts","sourceRoot":"","sources":["../../src/interfaces/pipeline-orchestrator-capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAkBtE,qCAAqC;AACrC,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;AAE/D;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,wCAAwC,EAAE,aAAa,CAAA;AAMvG;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,mBAAmB,GAAG,UAAU,GAAG,WAAW,CAAA;IACvF,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,uFAAuF;IACvF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,wGAAwG;IACxG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,mBAAmB,CAAA;CAC5E;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,6BAA6B;IAE5C;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;IAE5F;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;IAEzE;;;;;;;OAOG;IACH,SAAS,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAG1C,6CAA6C;IAC7C,sBAAsB,IAAI,SAAS,kBAAkB,EAAE,CAAA;IACvD,kEAAkE;IAClE,qBAAqB,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,kBAAkB,GAAG,IAAI,CAAA;IAC7E;;;;;;;OAOG;IACH,YAAY,IAAI,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAAA;IACpD,mEAAmE;IACnE,gBAAgB,IAAI,OAAO,CAAC,iCAAiC,CAAC,CAAA;IAG9D;;;;OAIG;IACH,qBAAqB,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAE3F;;;;;OAKG;IACH,oBAAoB,CAAC,KAAK,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;KAChB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;CAO/B"}

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

@@ -0,0 +1,147 @@
+import type { OrchestratorMetrics, CameraMetrics } from './api-shared.js';
+import type { PipelineEngineChoice } from '../types/pipeline.js';
+import type { PipelineStepInputOutput } from '../capabilities/pipeline-executor.cap.js';
+import type { Zone } from '../capabilities/zones.cap.js';
+import type { PipelinePhaseMode } from '../device/device-profile.js';
+/**
+ * Camera assignment payload sent by the pipeline-orchestrator to a runner
+ * via `attachCamera`. Carries everything the runner needs to subscribe to
+ * the local stream-broker and dispatch frames to motion / detection caps.
+ *
+ * Stateless-pipeline model: `engine`, `steps`, and `audio` travel with the
+ * payload so the runner holds the full content in RAM for the lifetime of
+ * the attach. Re-sent on rebalance, edit, or restart. The fields are
+ * optional during the additive migration (Phase 1) — the runner treats
+ * absent content as "no inference" until Phase 3 makes them required.
+ */
+export interface RunnerCameraConfig {
+    readonly deviceId: number;
+    readonly motionCooldownMs: number;
+    readonly motionFps: number;
+    readonly detectionFps: number;
+    readonly motionStreamId: string;
+    readonly detectionStreamId: string;
+    /** Motion sources that can activate the pipeline. At least one entry. */
+    readonly motionSources: import('../capabilities/pipeline-runner.cap.js').MotionSources;
+    readonly pipelineEnabled: boolean;
+    /** Engine choice for video steps — Phase 1 optional, runner ignores until Phase 3. */
+    readonly engine?: PipelineEngineChoice;
+    /** Ordered tree of video steps — Phase 1 optional, runner ignores until Phase 3. */
+    readonly steps?: readonly PipelineStepInputOutput[];
+    /** Audio classification branch — Phase 1 optional, runner ignores until Phase 3. */
+    readonly audio?: {
+        readonly engine: PipelineEngineChoice;
+        readonly modelId: string;
+        readonly enabled: boolean;
+    } | null;
+    /**
+     * Per-camera detection zones (user + onboard) snapshot taken at
+     * dispatch time. Empty array → no zone filtering. Forwarded so
+     * motion-wasm + pipeline-executor running on the runner can apply
+     * include/exclude/monitor logic without an extra hub round-trip;
+     * the orchestrator re-attaches the camera whenever the `zones`
+     * device-state slice changes so the runner's copy stays in sync.
+     */
+    readonly zones?: readonly Zone[];
+    /**
+     * Operator-facing scheduling modes. The runner uses these to gate
+     * its substream subscribers + phase machine:
+     *
+     *   - `'disabled'`   — runner skips the substream subscriber for
+     *                      this phase entirely. Bindings stay bound;
+     *                      this is the runtime-level off switch.
+     *   - `'always-on'`  — phase starts in `'active'` and stays active.
+     *   - `'on-motion'`  — phase starts in `'watching'`; transitions to
+     *                      `'active'` when a motion source fires; falls
+     *                      back after `motionCooldownMs`.
+     *
+     * `detectionMode` defaults to `'on-motion'` (battery profile keeps
+     * this); `audioMode` defaults to `'always-on'` (battery profile
+     * lowers to `'disabled'`).
+     */
+    readonly detectionMode: PipelinePhaseMode;
+    readonly audioMode: PipelinePhaseMode;
+}
+/**
+ * Hardware capability flags reported by a runner instance. Consumed by the
+ * orchestrator's L3 hardware-aware load balancer to assign cameras to the
+ * agent best suited for their detection workload (e.g. high-FPS cameras
+ * onto GPU agents, motion-only onto CPU-only agents).
+ */
+export interface RunnerHardwareCapabilities {
+    readonly hasGpu: boolean;
+    /** Inference backend identifier (e.g. 'coreml', 'openvino', 'cpu', 'cuda'). */
+    readonly inferenceBackend?: string;
+    readonly cpuCores?: number;
+}
+/**
+ * Runtime load summary returned by `getLocalLoad`. The orchestrator's L2
+ * capacity-based balancer uses this to compute a "least-loaded agent"
+ * score when picking a target for new camera assignments.
+ */
+export interface RunnerLocalLoad {
+    readonly nodeId: string;
+    readonly attachedCameras: number;
+    readonly activeCameras: number;
+    readonly avgInferenceFps: number;
+    readonly avgInferenceTimeMs: number;
+    readonly queueDepthTotal: number;
+    readonly hardware: RunnerHardwareCapabilities;
+}
+/**
+ * Aggregate runtime metrics for a runner's whole local pool. Mirrors the
+ * legacy `OrchestratorMetrics` shape so dashboards keep working unchanged
+ * when they migrate from `pipeline-executor.orchestratorStatus` to the
+ * new runner cap.
+ */
+export interface RunnerLocalMetrics extends OrchestratorMetrics {
+    readonly nodeId: string;
+}
+/**
+ * Pipeline Runner provider interface — implemented by `addon-pipeline-runner`.
+ *
+ * One instance per node (singleton scope). Receives camera assignments from
+ * the hub orchestrator, owns the per-camera frame queues + semaphore +
+ * motion → detection phase machine, and emits typed events on the bus
+ * (`detection.motion-analysis`, `pipeline.inference-result`, `pipeline.trace`).
+ *
+ * All methods exposed here mirror the cap definition exactly — there are no
+ * "local-only" methods, no callbacks, no live object passing. Everything is
+ * serializable so the runner is transparently routable across the cluster.
+ */
+export interface IPipelineRunnerProvider {
+    /** Attach a camera to this runner. Subscribes to the local broker. */
+    attachCamera(config: RunnerCameraConfig): Promise<{
+        success: true;
+    }>;
+    /** Detach a camera. Unsubscribes from the broker, clears queues. */
+    detachCamera(input: {
+        deviceId: number;
+    }): Promise<{
+        success: true;
+    }>;
+    /**
+     * Report an external motion event for a camera. Drives the runner's
+     * unified phase machine — every `detected:true` (analyzer or onboard)
+     * rearms the cooldown timer; `detected:false` is a no-op. `regions`
+     * is populated only by `source: 'analyzer'`.
+     */
+    reportMotion(input: import('../capabilities/pipeline-runner.cap.js').ReportMotionInput): Promise<{
+        success: true;
+    }>;
+    /** Return load summary used by the orchestrator's load balancer. */
+    getLocalLoad(): Promise<RunnerLocalLoad>;
+    /** Return aggregate runtime metrics for this runner instance. */
+    getLocalMetrics(): Promise<RunnerLocalMetrics>;
+    /** Per-camera metrics for cameras attached to this runner. */
+    getCameraMetrics(input: {
+        deviceId: number;
+    }): Promise<CameraMetrics | null>;
+    /** All per-camera metrics in one round-trip. */
+    getAllCameraMetrics(): ReadonlyArray<{
+        deviceId: number;
+    } & CameraMetrics>;
+    /** List the deviceIds currently attached to this runner. */
+    getLocalCameras(): readonly number[];
+}
+//# sourceMappingURL=pipeline-runner-capability.d.ts.map

package/dist/interfaces/pipeline-runner-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-runner-capability.d.ts","sourceRoot":"","sources":["../../src/interfaces/pipeline-runner-capability.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/pipeline-runner.d.ts

@@ -1,5 +1,5 @@
-import type { FrameInput } from '../types/io.js';
-import type { CropInput } from '../types/detection.js';
+import type { FrameInput, AudioChunkInput } from '../types/io.js';
+import type { CropInput, DetectorOutput, CropperOutput, ClassifierOutput, RefinerOutput } from '../types/detection.js';
 import type { PipelineConfig, PipelineResult, StepResult, PipelineStatus } from '../types/pipeline.js';
 export interface IPipelineRunner {
     run(frame: FrameInput, config?: PipelineConfig): Promise<PipelineResult>;
@@ -20,4 +20,20 @@ export interface ValidationResult {
 export interface IPipelineValidator {
     validate(config: PipelineConfig): ValidationResult;
 }
+/** Output type from any inference addon */
+export type InferenceOutput = DetectorOutput | CropperOutput | ClassifierOutput | RefinerOutput;
+/** Callable addon instance — the result of resolving an addon */
+export interface IAddonCaller {
+    /** Run inference on a frame or crop */
+    process(input: FrameInput | CropInput): Promise<InferenceOutput>;
+    /** Classify an audio chunk (optional — only audio addons implement this) */
+    classifyAudio?(input: AudioChunkInput): Promise<ClassifierOutput>;
+}
+/** Resolves addon IDs to callable instances — abstracts transport (in-process, forked, remote) */
+export interface IAddonResolver {
+    /** Get a callable addon for the given ID and config */
+    resolve(addonId: string, config: Record<string, unknown>): Promise<IAddonCaller>;
+    /** Shutdown all resolved addons */
+    shutdownAll(): Promise<void>;
+}
 //# sourceMappingURL=pipeline-runner.d.ts.map

package/dist/interfaces/pipeline-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-runner.d.ts","sourceRoot":"","sources":["../../src/interfaces/pipeline-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAEtG,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACxE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAChH,SAAS,IAAI,cAAc,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAAA;CACnD"}
+{"version":3,"file":"pipeline-runner.d.ts","sourceRoot":"","sources":["../../src/interfaces/pipeline-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACtH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAEtG,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACxE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAChH,SAAS,IAAI,cAAc,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAAA;CACnD;AAED,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,aAAa,GAAG,gBAAgB,GAAG,aAAa,CAAA;AAE/F,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAChE,4EAA4E;IAC5E,aAAa,CAAC,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAClE;AAED,kGAAkG;AAClG,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAChF,mCAAmC;IACnC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B"}

package/dist/interfaces/platform.d.ts

@@ -49,7 +49,7 @@ export interface ResolvedInferenceConfig {
     readonly modelId: string;
     readonly runtime: 'node' | 'python';
     readonly backend: string;
-    readonly format: string;
+    readonly format: import('../types/models.js').ModelFormat;
     readonly reason: string;
 }
 //# sourceMappingURL=platform.d.ts.map

package/dist/interfaces/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/interfaces/platform.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;IAC/C,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAA;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAA;CACzC;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAA;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;IACzC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAED,wEAAwE;AACxE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/interfaces/platform.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;IAC/C,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAA;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAA;CACzC;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAA;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;IACzC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAED,wEAAwE;AACxE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,oBAAoB,EAAE,WAAW,CAAA;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB"}

package/dist/interfaces/queryable.d.ts

@@ -0,0 +1,26 @@
+/**
+ * IQueryable — standard capability for addons to expose custom query methods
+ * discoverable by the hub and admin UI.
+ *
+ * Any addon implementing this capability can be queried from the hub via:
+ *   broker.call("{addonId}.queryable.query", { name, params })
+ *
+ * The admin UI auto-generates forms from paramsSchema and renders results
+ * from resultSchema.
+ */
+interface QueryCatalogEntry {
+    readonly name: string;
+    readonly description: string;
+    /** Zod schema for query parameters — used for validation + auto-generated UI forms */
+    readonly paramsSchema?: unknown;
+    /** Zod schema for query results — used for auto-rendered result display */
+    readonly resultSchema?: unknown;
+}
+interface IQueryable {
+    /** List all queries this addon supports */
+    getQueryCatalog(): QueryCatalogEntry[];
+    /** Execute a named query with parameters */
+    query(name: string, params: Record<string, unknown>): Promise<unknown>;
+}
+export type { IQueryable, QueryCatalogEntry };
+//# sourceMappingURL=queryable.d.ts.map

package/dist/interfaces/queryable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryable.d.ts","sourceRoot":"","sources":["../../src/interfaces/queryable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,UAAU,iBAAiB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAChC;AAED,UAAU,UAAU;IAClB,2CAA2C;IAC3C,eAAe,IAAI,iBAAiB,EAAE,CAAA;IACtC,4CAA4C;IAC5C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACvE;AAED,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/interfaces/raw-tensor-engine.d.ts

@@ -0,0 +1,16 @@
+import type { DetectionRuntime, DetectionDevice } from '../types/config.js';
+/**
+ * Raw tensor inference engine — runs inference on pre-processed tensor data.
+ * Used by addons that need custom preprocessing (e.g. CLIP embedding encoder).
+ *
+ * Unlike IInferenceEngine (JPEG in → EngineOutput out), this accepts
+ * raw Float32Array tensors with explicit shapes.
+ */
+export interface IRawTensorEngine {
+    readonly runtime: DetectionRuntime;
+    readonly device: DetectionDevice;
+    /** Run inference on a pre-processed tensor */
+    run(input: Float32Array, inputShape: readonly number[]): Promise<Float32Array>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=raw-tensor-engine.d.ts.map

package/dist/interfaces/raw-tensor-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-tensor-engine.d.ts","sourceRoot":"","sources":["../../src/interfaces/raw-tensor-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAE3E;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAEhC,8CAA8C;IAC9C,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAE9E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB"}