@camstack/types 1.2.328 → 1.2.330

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-i3kl-0Na.js");
+const require_sleep = require("./sleep-ClNXPpWR.js");
 const require_event_category = require("./event-category-CHduMGvg.js");
 const require_composition = require("./composition-BLWAivB2.js");
 const require_err_msg = require("./err-msg-Dx2Kor0g.js");
@@ -12716,6 +12716,13 @@ var KeychainAuditEntrySchema = zod.z.object({
 	detail: zod.z.string().nullable()
 });
 var KEYCHAIN_RESET_CONFIRMATION = "RESET KEYCHAIN";
+/**
+* Secrets the HUB itself holds (owner `system`) that no settings form shows:
+* `jwt-signing-key` — the session signing key (D797). It is always "in use",
+* never an orphan; it is generated on a fresh hub and replaced only through
+* {@link keychainAdminCapability.methods.setSystemSecret}.
+*/
+var SystemHeldSecretNameSchema = zod.z.enum(["jwt-signing-key"]);
 var keychainAdminCapability = {
 	name: "keychain-admin",
 	scope: "system",
@@ -12736,6 +12743,24 @@ var keychainAdminCapability = {
 			auth: "admin",
 			caller: "required"
 		}),
+		/**
+		* Replace a system-held secret (no form edits it) with an operator-supplied
+		* value — e.g. importing the session signing key a pre-keychain hub kept in
+		* config.yaml, so the tokens it signed stay valid. Audited as the operator.
+		* Replacing the session signing key invalidates every token signed with the
+		* previous one.
+		*/
+		setSystemSecret: require_sleep.method(zod.z.object({
+			name: SystemHeldSecretNameSchema,
+			value: zod.z.string().min(16)
+		}), zod.z.object({
+			ref: zod.z.string(),
+			version: zod.z.number().int()
+		}), {
+			kind: "mutation",
+			auth: "admin",
+			caller: "required"
+		}),
 		/** Delete refs no owner points at any more. Re-checked here; `unknown` is kept. */
 		deleteOrphans: require_sleep.method(zod.z.object({ refs: zod.z.array(zod.z.string().min(1)).max(1e3) }), zod.z.object({
 			deleted: zod.z.array(zod.z.string()).readonly(),
@@ -25091,6 +25116,9 @@ var RetrainExportFilterSchema = zod.z.object({
 	frameIds: zod.z.array(zod.z.string()).max(2e4).optional(),
 	/** Only frames in at least one of these named collections. */
 	collectionIds: zod.z.array(zod.z.string()).max(200).optional(),
+	/** Exactly the frames of this dataset version (and its completeOnly). An
+	*  unknown id selects nothing. */
+	datasetVersionId: zod.z.string().optional(),
 	batchId: zod.z.string().optional(),
 	/** Only frames the operator marked complete (all subjects boxed). */
 	completeOnly: zod.z.boolean().optional()
@@ -25258,6 +25286,67 @@ var RetrainLlmAssistResultSchema = zod.z.discriminatedUnion("kind", [zod.z.objec
 	]),
 	detail: zod.z.string().optional()
 })]);
+/** What a dataset version is cut from. Every field narrows. */
+var RetrainDatasetSelectionSchema = zod.z.object({
+	deviceIds: zod.z.array(zod.z.number()).readonly().optional(),
+	collectionIds: zod.z.array(zod.z.string()).max(200).readonly().optional(),
+	frameIds: zod.z.array(zod.z.string()).max(2e4).readonly().optional()
+});
+/** The counts a dataset is judged by. */
+var RetrainDatasetStatsSchema = zod.z.object({
+	frames: zod.z.number().int(),
+	completeFrames: zod.z.number().int(),
+	/** `completeFrames / frames`, 0..1. */
+	completeness: zod.z.number(),
+	/** Boxes to learn (model errors excluded). */
+	subjects: zod.z.number().int(),
+	modelErrors: zod.z.number().int(),
+	/** Complete frames with no subject. */
+	hardNegatives: zod.z.number().int(),
+	/** Subjects per class × camera × day/night. */
+	cells: zod.z.array(zod.z.object({
+		macroClass: zod.z.string(),
+		deviceId: zod.z.number(),
+		lighting: zod.z.enum([
+			"day",
+			"night",
+			"unknown"
+		]),
+		subjects: zod.z.number().int(),
+		frames: zod.z.number().int()
+	})).readonly(),
+	cameras: zod.z.array(zod.z.object({
+		deviceId: zod.z.number(),
+		frames: zod.z.number().int(),
+		completeFrames: zod.z.number().int()
+	})).readonly()
+});
+/** An immutable dataset version, without its frame list. */
+var RetrainDatasetVersionSchema = zod.z.object({
+	id: zod.z.string(),
+	name: zod.z.string(),
+	createdAt: zod.z.number(),
+	selection: RetrainDatasetSelectionSchema,
+	layout: RetrainExportLayoutSchema,
+	completeOnly: zod.z.boolean(),
+	frameCount: zod.z.number().int(),
+	/** sha256 of what the frames taught when the version was frozen. */
+	annotationHash: zod.z.string(),
+	/** The export manifest schema the version was cut under. */
+	manifestSchema: zod.z.string(),
+	stats: RetrainDatasetStatsSchema
+});
+var CreateRetrainDatasetVersionResultSchema = zod.z.discriminatedUnion("kind", [zod.z.object({
+	kind: zod.z.literal("created"),
+	version: RetrainDatasetVersionSchema
+}), zod.z.object({
+	kind: zod.z.literal("refused"),
+	reason: zod.z.enum([
+		"empty-name",
+		"duplicate-name",
+		"no-frames"
+	])
+})]);
 /** The outcome of a lifecycle move owned by the retrain page. */
 var RetrainTransitionResultSchema = zod.z.object({
 	trackId: zod.z.string(),
@@ -26657,6 +26746,53 @@ var pipelineAnalyticsCapability = {
 			auth: "admin",
 			timeoutMs: 60 * 6e4
 		}),
+		/** The counts a selection would freeze — class × camera × day/night,
+		*  completeness — without freezing anything. Index reads only. */
+		previewRetrainDataset: require_sleep.method(zod.z.object({
+			selection: RetrainDatasetSelectionSchema,
+			completeOnly: zod.z.boolean().optional()
+		}), RetrainDatasetStatsSchema, {
+			kind: "query",
+			auth: "admin"
+		}),
+		/**
+		* Freeze a dataset version: the frames the selection yields (the same plan
+		* the annotated export builds), the hash of what they teach, the export
+		* parameters and the counts. Immutable — a different selection is a new
+		* version. Export it with `getRetrainExportUrl({ datasetVersionId })`.
+		*/
+		createRetrainDatasetVersion: require_sleep.method(zod.z.object({
+			name: zod.z.string().max(120),
+			selection: RetrainDatasetSelectionSchema,
+			layout: RetrainExportLayoutSchema,
+			completeOnly: zod.z.boolean()
+		}), CreateRetrainDatasetVersionResultSchema, {
+			kind: "mutation",
+			auth: "admin",
+			timeoutMs: 12e4
+		}),
+		/** Every dataset version, newest first. */
+		listRetrainDatasetVersions: require_sleep.method(zod.z.object({}), zod.z.array(RetrainDatasetVersionSchema).readonly(), {
+			kind: "query",
+			auth: "admin"
+		}),
+		/** Delete a version. Its frames stay in the dataset. */
+		deleteRetrainDatasetVersion: require_sleep.method(zod.z.object({ id: zod.z.string() }), zod.z.object({ deleted: zod.z.boolean() }), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Does the corpus still teach what the version froze? `missingFrames`
+		*  counts frames that left the dataset (or lost every box and tick). */
+		verifyRetrainDatasetVersion: require_sleep.method(zod.z.object({ id: zod.z.string() }), zod.z.object({
+			found: zod.z.boolean(),
+			annotationHash: zod.z.string(),
+			matches: zod.z.boolean(),
+			missingFrames: zod.z.number().int()
+		}), {
+			kind: "query",
+			auth: "admin",
+			timeoutMs: 12e4
+		}),
 		/** The enabled, vision-capable LLM profiles, each saying whether a frame
 		*  sent to it leaves the house. */
 		listRetrainAssistProfiles: require_sleep.method(zod.z.object({}), zod.z.array(RetrainAssistProfileSchema).readonly(), {
@@ -55432,6 +55568,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"keychainAdmin.setSystemSecret": {
+		capName: "keychain-admin",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"keychainAdmin.status": {
 		capName: "keychain-admin",
 		capScope: "system",
@@ -56878,6 +57020,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineAnalytics.createRetrainDatasetVersion": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineAnalytics.deleteDeviceEvents": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -56890,6 +57038,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"pipelineAnalytics.deleteRetrainDatasetVersion": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "delete"
+	},
 	"pipelineAnalytics.deleteTracks": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -57112,6 +57266,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listRetrainDatasetVersions": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listRetrainFrames": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -57154,6 +57314,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineAnalytics.previewRetrainDataset": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.proposeRetrainAnnotations": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -57292,6 +57458,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineAnalytics.verifyRetrainDatasetVersion": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.wipeAllAnalytics": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -68491,6 +68663,7 @@ function createSystemProxy(api) {
 			listSecrets: (input) => dispatch("keychainAdmin", "listSecrets", "query", input),
 			listAudit: (input) => dispatch("keychainAdmin", "listAudit", "query", input),
 			reveal: (input) => dispatch("keychainAdmin", "reveal", "mutation", input),
+			setSystemSecret: (input) => dispatch("keychainAdmin", "setSystemSecret", "mutation", input),
 			deleteOrphans: (input) => dispatch("keychainAdmin", "deleteOrphans", "mutation", input),
 			rotateMasterKey: (input) => dispatch("keychainAdmin", "rotateMasterKey", "mutation", input),
 			purgeRetiredKeys: (input) => dispatch("keychainAdmin", "purgeRetiredKeys", "mutation", input),
@@ -77588,6 +77761,7 @@ exports.CoverStatusSchema = CoverStatusSchema;
 exports.CreateApiKeyInputSchema = CreateApiKeyInputSchema;
 exports.CreateApiKeyResultSchema = CreateApiKeyResultSchema;
 exports.CreateIntegrationInputSchema = CreateIntegrationInputSchema;
+exports.CreateRetrainDatasetVersionResultSchema = CreateRetrainDatasetVersionResultSchema;
 exports.CreateScopedTokenInputSchema = CreateScopedTokenInputSchema;
 exports.CreateScopedTokenResultSchema = CreateScopedTokenResultSchema;
 exports.CreateUserInputSchema = CreateUserInputSchema;
@@ -78546,6 +78720,9 @@ exports.RetrainCollectionCreateResultSchema = RetrainCollectionCreateResultSchem
 exports.RetrainCollectionRenameResultSchema = RetrainCollectionRenameResultSchema;
 exports.RetrainCollectionSchema = RetrainCollectionSchema;
 exports.RetrainCopyRefusalSchema = RetrainCopyRefusalSchema;
+exports.RetrainDatasetSelectionSchema = RetrainDatasetSelectionSchema;
+exports.RetrainDatasetStatsSchema = RetrainDatasetStatsSchema;
+exports.RetrainDatasetVersionSchema = RetrainDatasetVersionSchema;
 exports.RetrainExportFilterSchema = RetrainExportFilterSchema;
 exports.RetrainExportLayoutSchema = RetrainExportLayoutSchema;
 exports.RetrainFrameCandidateSchema = RetrainFrameCandidateSchema;
@@ -78728,6 +78905,7 @@ exports.SuggestedDeviceShareSchema = SuggestedDeviceShareSchema;
 exports.SuggestedNodeShareSchema = SuggestedNodeShareSchema;
 exports.SuppliedRootOutputSchema = SuppliedRootOutputSchema;
 exports.SwitchStatusSchema = SwitchStatusSchema;
+exports.SystemHeldSecretNameSchema = SystemHeldSecretNameSchema;
 exports.SystemMetricsSchema = SystemMetricsSchema;
 exports.SystemMirror = SystemMirror;
 exports.TAXONOMY_COLORS = TAXONOMY_COLORS;