camstack 1.2.52 → 1.2.54

package/dist/{chunk-YVH2KSTL.js → chunk-NEA5DJLZ.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-Dolp38qx.mjs
+// ../types/dist/sleep-C9C8EoK8.mjs
 var WELL_KNOWN_TABS = [
   {
     id: "overview",
@@ -17070,6 +17070,10 @@ var addonSettingsCapability = {
       kind: "mutation",
       auth: "admin"
     }),
+    getIntegrationSettings: method(external_exports.object({
+      addonId: external_exports.string(),
+      nodeId: external_exports.string().optional()
+    }), SettingsSchemaWithValuesSchema.nullable()),
     getDeviceSettings: method(external_exports.object({
       addonId: external_exports.string(),
       deviceId: external_exports.number(),
@@ -21683,6 +21687,80 @@ var logDestinationCapability = {
   /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
   mount: { kind: "skip" }
 };
+var FailureReasonCountSchema = external_exports.object({
+  /**
+  * Why the attempt did not land, in the contributor's own vocabulary —
+  * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
+  * strings that already appear in this repo's logs and, where one exists, the
+  * same string the per-track `previewMissReason` records (D276): a second
+  * vocabulary for the same loss would make the row and the counter
+  * un-joinable.
+  */
+  reason: external_exports.string(),
+  count: external_exports.number().int().nonnegative()
+});
+var FailureContributionSchema = external_exports.object({
+  /**
+  * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
+  * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
+  * `unit` free: the families are owned by different addons and a shared enum
+  * is a central list that rots invisibly.
+  */
+  family: external_exports.string(),
+  /**
+  * The NUMERIC device id — the same value every log line carries as
+  * `tags.deviceId`. Never nullable and never absent: a contributor that
+  * cannot name the camera must not emit the entry, because a fleet total
+  * cannot answer the only question anybody asks of this surface.
+  */
+  deviceId: external_exports.number().int().positive(),
+  /**
+  * A second dimension inside the family: the model / step id for an inference
+  * timeout, so "which camera AND which model" is one read. Absent when the
+  * family has a single variant.
+  */
+  variant: external_exports.string().optional(),
+  /**
+  * Epoch ms this counter started — the INCARNATION MARKER. A consumer
+  * differencing two reads must drop the interval when it changes, because the
+  * counter restarted from zero in a respawned runner. Same discipline as
+  * `LoadContribution.startedAtMs`.
+  */
+  sinceMs: external_exports.number(),
+  /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
+  atMs: external_exports.number(),
+  /**
+  * THE DENOMINATOR — every attempt on this path for this camera in the
+  * window. A failure count published without it is the mistake this schema
+  * exists to make impossible.
+  */
+  attempts: external_exports.number().int().nonnegative(),
+  /** Attempts that landed. `attempts - succeeded` is the loss. */
+  succeeded: external_exports.number().int().nonnegative(),
+  /** The loss, partitioned. Sums to `attempts - succeeded`. */
+  reasons: external_exports.array(FailureReasonCountSchema).readonly()
+});
+var failureContributionCapability = {
+  name: "failure-contribution",
+  scope: "system",
+  mode: "collection",
+  internal: true,
+  methods: {
+    /**
+    * This addon's per-camera failure counters, read live from bounded in-RAM
+    * state it already keeps. Inert: no persistence, no sampling, no timer.
+    *
+    * READING NEVER RESETS. The counters are CUMULATIVE since `sinceMs`, and a
+    * consumer that wants a rate differences two reads. A draining read would
+    * make two operators with the page open each destroy half of the other's
+    * numbers, and `load-contribution` already settled the same question the
+    * same way for `cpuSeconds`.
+    */
+    list: method(external_exports.void(), external_exports.array(FailureContributionSchema).readonly())
+  },
+  /** In-process only — enumerated through `addons.listCapabilityProviders`. */
+  mount: { kind: "skip" }
+};
 var LOAD_CONTRIBUTION_ROLES = [
   "decode",
   "transcode",
@@ -25675,6 +25753,20 @@ var TrackSchema = external_exports.object({
   * `=== true` and render nothing otherwise — never infer "no rider".
   */
   hasRider: external_exports.boolean().optional(),
+  /**
+  * WHY this track ended without a NATIVE best-shot tile
+  * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
+  * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
+  * `derive-returned-null tile=standin`, …) written at close and CLEARED by
+  * the late-keyFrame upgrade when a native tile lands after all. The
+  * operator-facing answer to "perché manca l'immagine?" on a track whose
+  * tile is a face/plate stand-in, a raster crop, or an icon.
+  *
+  * **Absent ≠ "missed silently"**: a row written before the column, a hub
+  * that predates the field, and every track whose tile landed native all
+  * omit it. Render nothing when absent.
+  */
+  previewMissReason: external_exports.string().optional(),
   ...TrackFlagFields,
   ...TrackRetrainFields
 });
@@ -37174,6 +37266,7 @@ var LoggingSettingsPatchSchema = external_exports.object({
   channels: external_exports.array(LogChannelWindowPatchSchema).readonly().optional()
 });
 var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: external_exports.string() });
+var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: external_exports.string() });
 var GetLoggingSettingsInputSchema = external_exports.object({
   scopeNodeId: external_exports.string().optional(),
   /**
@@ -37283,6 +37376,28 @@ var systemCapability = {
     */
     getLoadContributions: method(external_exports.void(), external_exports.array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }),
     /**
+    * Every `failure-contribution` an addon on this cluster reports — per
+    * camera, per reason, **with the denominator attached**.
+    *
+    * This is the surface the operator asked for on 2026-08-28 (*"possiamo
+    * armare questi errori intanto? Così al prossimo giro ricontrolliamo tutti
+    * questi punti"*). Before it, four live failure modes could only be counted
+    * by grepping Loki and hand-correlating timestamps, which is exactly how a
+    * 22% thumbnail gap and a 3-hour media blackout were diagnosed — twice.
+    *
+    * Read it as a RATIO, never as a count. `attempts` is on every entry
+    * because the count on its own lies: `enrichment crop native miss` read as
+    * "35x worse than yesterday" and was flat across twelve hours once divided
+    * by the successes on the same path.
+    *
+    * The counters are CUMULATIVE since each entry's `sinceMs`. Reading does
+    * not reset them, and `sinceMs` changing means the reporting runner
+    * respawned — a consumer differencing two reads drops that interval.
+    *
+    * Admin-only: the rows name cameras and the paths that fail on them.
+    */
+    getFailureContributions: method(external_exports.void(), external_exports.array(ReportedFailureContributionSchema).readonly(), { auth: "admin" }),
+    /**
     * The logging settings document — levels and armed diagnostics — resolved
     * for `nodeId`, or for the cluster when `nodeId` is absent.
     *
@@ -38487,6 +38602,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "addonSettings.getIntegrationSettings": {
+    capName: "addon-settings",
+    capScope: "system",
+    addonId: null,
+    access: "view"
+  },
   "addonSettings.updateDeviceSettings": {
     capName: "addon-settings",
     capScope: "system",
@@ -40149,6 +40270,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "failureContribution.list": {
+    capName: "failure-contribution",
+    capScope: "system",
+    addonId: null,
+    access: "view"
+  },
   "fanControl.setDirection": {
     capName: "fan-control",
     capScope: "device",
@@ -43455,6 +43582,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "system.getFailureContributions": {
+    capName: "system",
+    capScope: "system",
+    addonId: null,
+    access: "view"
+  },
   "system.getLoadContributions": {
     capName: "system",
     capScope: "system",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-YVH2KSTL.js";
+} from "./chunk-NEA5DJLZ.js";
 import "./chunk-LMMQX4CK.js";
 
 // src/cli.ts
@@ -38,7 +38,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-7T4UUMOZ.js");
+  await import("./launcher-QLUF66FQ.js");
 }
 
 // src/commands/agent.ts
@@ -83,7 +83,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-7T4UUMOZ.js");
+  await import("./launcher-QLUF66FQ.js");
 }
 
 // src/commands/setup.ts
@@ -1130,7 +1130,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-7QG523MP.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-2O7WGGRD.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-7QG523MP.js → discover-2O7WGGRD.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-YVH2KSTL.js";
+} from "./chunk-NEA5DJLZ.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,