@camstack/system 1.2.421 → 1.2.423

package/dist/builtins/winston-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-Df7s77se.js");
+const require_dist = require("../../dist-VIIxVsBW.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);

package/dist/builtins/winston-logging/index.mjs

@@ -1,4 +1,4 @@
-import { Xt as logDestinationCapability, cr as BaseAddon } from "../../dist-0OD9ue39.mjs";
+import { Xt as logDestinationCapability, cr as BaseAddon } from "../../dist-DimotS8e.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";

package/dist/{composition-sources-DoYpCPtl.mjs → composition-sources-BXDchWFn.mjs}

@@ -1,4 +1,4 @@
-import { er as compositionSourceKey, sr as errMsg } from "./dist-0OD9ue39.mjs";
+import { er as compositionSourceKey, sr as errMsg } from "./dist-DimotS8e.mjs";
 //#region src/builtins/core-blocks/composition-sources.ts
 /**
 * Describe what a composition reads and writes for SAVE-time validation

package/dist/{composition-sources-DxlTUSI1.js → composition-sources-CgiAeG-2.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-Df7s77se.js");
+const require_dist = require("./dist-VIIxVsBW.js");
 //#region src/builtins/core-blocks/composition-sources.ts
 /**
 * Describe what a composition reads and writes for SAVE-time validation

package/dist/{constants-GXZQRcjB.js → constants-1_7QtPNo.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-Df7s77se.js");
+const require_dist = require("./dist-VIIxVsBW.js");
 let node_crypto = require("node:crypto");
 //#region src/kernel/moleculer/cluster-secret.ts
 /**

package/dist/{constants-CtxNK2QJ.mjs → constants-C2dhkIuF.mjs}

@@ -1,4 +1,4 @@
-import { xr as buildSecretRef } from "./dist-0OD9ue39.mjs";
+import { xr as buildSecretRef } from "./dist-DimotS8e.mjs";
 import { createHash, timingSafeEqual } from "node:crypto";
 //#region src/kernel/moleculer/cluster-secret.ts
 /**

package/dist/{dist-0OD9ue39.mjs → dist-DimotS8e.mjs}

@@ -718,7 +718,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	return EventCategory;
 }({});
 //#endregion
-//#region ../types/dist/sleep-B_3F_YwS.mjs
+//#region ../types/dist/sleep-BBF1iXUi.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -7338,6 +7338,15 @@ z.discriminatedUnion("type", [
 		message: z.string()
 	})
 ]);
+/** Every status, in the order a summary lists them. */
+var RETRAIN_REVIEW_STATUSES = [
+	"unchanged",
+	"adjusted",
+	"reclassified",
+	"added",
+	"removed",
+	"model-error"
+];
 /**
 * What the gate decided about a birth, from the CALLER's point of view.
 *
@@ -15124,6 +15133,38 @@ var BulkRecordSchema = z.object({
 	data: z.record(z.string(), z.unknown())
 });
 /**
+* One write inside a {@link settingsStoreCapability.methods.transact} call.
+* Only the three that a "replace this set, bump that revision" write needs.
+*/
+var TransactOpSchema = z.discriminatedUnion("op", [
+	z.object({
+		op: z.literal("deleteWhere"),
+		collection: z.string(),
+		filter: MutationFilterSchema
+	}),
+	z.object({
+		op: z.literal("insertMany"),
+		collection: z.string(),
+		records: z.array(BulkRecordSchema).readonly()
+	}),
+	z.object({
+		op: z.literal("update"),
+		collection: z.string(),
+		id: z.string(),
+		data: z.record(z.string(), z.unknown())
+	})
+]);
+/**
+* The precondition of a transaction: the row `key` of `collection` must hold
+* `equals` in `column`, read INSIDE the transaction.
+*/
+var TransactGuardSchema = z.object({
+	collection: z.string(),
+	key: z.string(),
+	column: z.string(),
+	equals: z.unknown()
+});
+/**
 * Column declaration for a structured (SQL-backed) collection.
 *
 * Logical types — the backend translates each to the matching SQLite
@@ -15348,6 +15389,36 @@ id: z.union([z.string(), z.number()]) }), {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/**
+		* Several writes, ONE transaction, behind an optional precondition.
+		*
+		* The multi-collection twin of {@link insertMany}: a write that has to move
+		* a set of rows in one collection AND a revision in another cannot be
+		* expressed as separate calls without a window in which a reader (or a
+		* crash) sees half of it. The retrain annotation save replaces a frame's
+		* rows, its dismissed set and its revision this way.
+		*
+		* `guard`, when given, is read inside the transaction: if the row is
+		* missing or its column differs from `equals`, NOTHING is written and the
+		* answer is `{ applied: false, current }` with what was found — the
+		* compare-and-set a revisioned write needs, with no second reader able to
+		* slip between the check and the writes.
+		*
+		* **All or nothing**, like {@link insertMany}: a throw in any op rolls the
+		* whole call back. Ops run in the order given (delete before insert to
+		* replace a set). `namespace` applies to every collection named.
+		*/
+		transact: method(z.object({
+			namespace: z.string().optional(),
+			guard: TransactGuardSchema.optional(),
+			ops: z.array(TransactOpSchema).readonly()
+		}), z.object({
+			applied: z.boolean(),
+			current: z.unknown().optional()
+		}), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/** Update an existing record by ID. */
 		update: method(z.object({
 			namespace: z.string().optional(),
@@ -15632,6 +15703,18 @@ id: z.union([z.string(), z.number()]) }), {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/** Several writes in ONE transaction behind an optional guard; see the door. */
+		transact: method(z.object({
+			namespace: z.string().optional(),
+			guard: TransactGuardSchema.optional(),
+			ops: z.array(TransactOpSchema).readonly()
+		}), z.object({
+			applied: z.boolean(),
+			current: z.unknown().optional()
+		}), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/** Update an existing record by ID. */
 		update: method(z.object({
 			namespace: z.string().optional(),
@@ -26313,6 +26396,59 @@ var RetrainBboxSchema = z.object({
 	h: z.number()
 });
 /**
+* What a box LOOKED LIKE when it was offered, snapshotted at the moment the
+* operator accepted it. The saved row keeps only the final rectangle; this is
+* the other half of the pair, and the pair is what says whether the operator
+* accepted, nudged, relabelled or replaced a proposal (`retrain-review.ts`).
+*
+* `ref` names the proposal inside its frame: `pipeline:<trackId>` for a box the
+* live pipeline drew, `assist:<n>` for the n-th box of a detector or LLM run,
+* and anything unique for an operator-drawn box (`operator:<n>`). Re-derived
+* pipeline boxes carry the same ref every time, which is what lets a dismissal
+* stay dismissed.
+*/
+var RetrainOriginSchema = z.object({
+	source: RetrainAnnotationSourceSchema,
+	ref: z.string().min(1),
+	bbox: RetrainBboxSchema,
+	macroClass: RetrainMacroClassSchema,
+	label: z.string().optional(),
+	score: z.number().optional(),
+	modelId: z.string().optional()
+});
+/**
+* A proposal the operator deleted. Durable on the frame, so a deleted pipeline
+* box does not come back as a draft every time the frame is reopened, and so
+* the deletion itself is a recorded fact rather than an absence.
+*/
+var RetrainDismissedSchema = z.object({
+	ref: z.string().min(1),
+	snapshot: RetrainOriginSchema
+});
+/** What the operator did with a proposal (see `retrain-review.ts`). */
+var RetrainReviewStatusSchema = z.enum(RETRAIN_REVIEW_STATUSES);
+var RetrainBoxReviewSchema = z.object({
+	ref: z.string(),
+	savedId: z.string().optional(),
+	status: RetrainReviewStatusSchema,
+	/** The baseline was re-derived, not snapshotted (a pre-origin row). */
+	approximate: z.boolean(),
+	origin: RetrainOriginSchema.optional(),
+	/** The class / label the box carries NOW (a removed box: its origin's). Absent on an older hub. */
+	macroClass: RetrainMacroClassSchema.optional(),
+	label: z.string().optional(),
+	iou: z.number().optional()
+});
+var RetrainFrameReviewSchema = z.object({
+	boxes: z.array(RetrainBoxReviewSchema).readonly(),
+	summary: z.object({
+		counts: z.record(RetrainReviewStatusSchema, z.number().int()),
+		total: z.number().int(),
+		changed: z.number().int(),
+		approximate: z.boolean()
+	})
+});
+/**
 * One annotated subject.
 *
 * `bbox` is normalised against the full frame, ALWAYS. The per-model shapes
@@ -26336,6 +26472,9 @@ var RetrainAnnotationSchema = z.object({
 	/** Which model proposed this box — or, on a `model_error`, drew the phantom. */
 	assistModelId: z.string().optional(),
 	assistScore: z.number().optional(),
+	/** The proposal this box started from, snapshotted at accept time. `null` on
+	*  a row saved before origins existed; absent on a draft nobody snapshotted. */
+	origin: RetrainOriginSchema.nullable().optional(),
 	exportedInBatch: z.string().optional(),
 	createdAt: z.number()
 });
@@ -26428,7 +26567,19 @@ var RetrainFrameSchema = z.object({
 	*  empty when nothing the track store holds can be placed on it. */
 	pipelineBoxes: z.array(RetrainPipelineBoxSchema).readonly().optional(),
 	/** The named collections this frame belongs to. Present on list answers. */
-	collectionIds: z.array(z.string()).readonly().optional()
+	collectionIds: z.array(z.string()).readonly().optional(),
+	/** Bumped by every annotation save. A save that names a stale
+	*  `expectedRevision` is refused, so two surfaces cannot overwrite each other. */
+	revision: z.number().int().optional(),
+	/** Proposals the operator deleted — never re-seeded as drafts. */
+	dismissed: z.array(RetrainDismissedSchema).readonly().optional(),
+	/** What the operator did with the proposals, computed by the server. */
+	review: RetrainFrameReviewSchema.optional(),
+	/** The frame's pixels over the admin data plane (full size). Fetch with the
+	*  admin bearer token; relative to the hub root. */
+	imageUrl: z.string().optional(),
+	/** The same, as a ~480 px thumbnail for grids. */
+	thumbnailUrl: z.string().optional()
 });
 /** Why a copy-on-select could not be honoured — named, never a silent skip. */
 var RetrainCopyRefusalSchema = z.enum([
@@ -27971,6 +28122,11 @@ var pipelineAnalyticsCapability = {
 		/**
 		* The pixels of ONE copied frame, base64.
 		*
+		* @deprecated Use `RetrainFrame.imageUrl` / `thumbnailUrl` (the admin
+		* `retrain-frame` data plane, D613). A base64 envelope holds the frame
+		* whole in the producer AND the caller, and a grid of tiles paid that for
+		* every tile. Kept for one release for callers that cannot fetch a URL.
+		*
 		* Through the cap rather than a data plane because it is genuinely one
 		* frame at a time, on demand, at human speed — the shape D9/D18 permit
 		* (what they forbid is frames crossing a boundary at frame RATE). The
@@ -28033,18 +28189,59 @@ var pipelineAnalyticsCapability = {
 		* Refuses a macro class typed into `label` or `subLabel` — the tiers are
 		* separate and the guard is at the WRITE, because a mixed taxonomy cannot
 		* be un-mixed by reading it.
+		*
+		* ATOMIC and REVISIONED: the replaced rows, the frame's `dismissed` set and
+		* its `revision` move in one transaction, guarded by the revision the
+		* caller saw. A stale `expectedRevision` writes nothing and throws
+		* `retrain-revision-conflict` (parse it with `parseRetrainRevisionConflict`);
+		* the UI and an MCP agent no longer overwrite each other silently.
 		*/
 		saveRetrainAnnotations: method(z.object({
 			deviceId: z.number(),
 			/** The frame's track, when it has one — checked against the frame. */
 			trackId: z.string().optional(),
 			frameId: z.string(),
-			annotations: z.array(RetrainAnnotationDraftSchema)
+			annotations: z.array(RetrainAnnotationDraftSchema),
+			/** The frame's `revision` the caller saw. A different current revision
+			*  refuses the save with a `retrain-revision-conflict` error
+			*  (`parseRetrainRevisionConflict`). Absent ⇒ last write wins. */
+			expectedRevision: z.number().int().optional(),
+			/** The proposals the operator deleted. Absent ⇒ keep the frame's
+			*  current set; present ⇒ replace it (an empty array un-dismisses). */
+			dismissed: z.array(RetrainDismissedSchema).optional()
 		}), z.array(RetrainAnnotationSchema).readonly(), {
 			kind: "mutation",
 			auth: "admin"
 		}),
 		/**
+		* Give annotations saved BEFORE origins existed the origin a caller
+		* reconstructed for them (the MCP `track_review_backfill_origin` tool
+		* matches each row to the pipeline box it equals).
+		*
+		* Writes `origin` and nothing else: ids, creation time and the export stamp
+		* are untouched (a re-save through `saveRetrainAnnotations` would reset all
+		* three). A row that already has an origin is SKIPPED — a snapshot taken at
+		* accept time is evidence, a reconstruction is a guess. Atomic and
+		* revision-guarded like the save; bumps the frame's `revision`.
+		*/
+		backfillRetrainOrigins: method(z.object({
+			deviceId: z.number(),
+			trackId: z.string().optional(),
+			frameId: z.string(),
+			expectedRevision: z.number().int().optional(),
+			origins: z.array(z.object({
+				annotationId: z.string(),
+				origin: RetrainOriginSchema
+			})).min(1).max(500)
+		}), z.object({
+			updated: z.number().int(),
+			skipped: z.number().int(),
+			revision: z.number().int()
+		}), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/**
 		* Finish with a track: `staging → trained`. **The only writer of that
 		* state** — D81 shipped the column with it deliberately unreachable.
 		*
@@ -52877,6 +53074,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"dataStoreProvider.transact": {
+		capName: "data-store-provider",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"dataStoreProvider.update": {
 		capName: "data-store-provider",
 		capScope: "system",
@@ -55721,6 +55924,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineAnalytics.backfillRetrainOrigins": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineAnalytics.cancelRelocateMedia": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -57713,6 +57922,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"settingsStore.transact": {
+		capName: "settings-store",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"settingsStore.update": {
 		capName: "settings-store",
 		capScope: "system",
@@ -62299,6 +62514,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"pipelineAnalytics.backfillRetrainOrigins": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"pipelineAnalytics.clearTrackRelation": [{
 		name: "deviceId",
 		form: "single",