@camstack/types 1.2.444 → 1.2.445

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.445] - 2026-10-29
+
+### Added
+
+- server-management can read and set a node's launch overrides
+
 ## [1.2.444] - 2026-10-29
 
 ### Added
@@ -19,6 +25,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 
 - Node memory is nullable on the metrics and topology contracts: a failed read is unknown, not 0 or 100
+- server-management gains getLaunchOverrides / setLaunchOverrides, the per-node heap-ceiling override
 
 ## [1.2.443] - 2026-10-29
 

package/dist/capabilities/index.d.ts

@@ -119,7 +119,7 @@ export { CameraMetricsSchema, CameraMetricsWithDeviceIdSchema, OrchestratorMetri
 export type { AudioStreamPick, CameraStream, CamProfile, CamStreamKind, DecodedAudioChunkWire, ProfileRtspEntry, ProfileSlot, ProfileSlotStatus, SubscribeAudioChunksInput, SubscribeAudioChunksResult, } from './schemas/streaming-shared.js';
 export { AudioChunkFormatSchema, AudioStreamPickSchema, BrokerStatsSchema, BrokerStatusSchema, CAM_PROFILE_ORDER, CameraStreamSchema, CamProfileSchema, CamStreamKindSchema, CamStreamResolutionSchema, DecodedAudioChunkSchema, FrameHandleSchema, makeProfileBrokerId, makeSourceBrokerId, ProfileRtspEntrySchema, ProfileSlotSchema, ProfileSlotStatusSchema, parseProfileBrokerId, StreamSourceEntrySchema, StreamSourceSchema, SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, selectAssignedProfileSlots, } from './schemas/streaming-shared.js';
 export { buildEventKindDescriptor, EVENT_KIND_BY_CAP, EVENTFUL_CAP_NAMES, type SensorEventKindDescriptor, } from './sensor-event-kinds.js';
-export { type ImageContract, ImageContractSchema, type ImageContractState, ImageContractStateSchema, type IServerManagementProvider, type RunnerBootCheck, RunnerBootCheckSchema, type RunnerRefusal, RunnerRefusalSchema, type ServerBootMode, ServerBootModeSchema, type ServerPackageStatus, ServerPackageStatusSchema, type ServerRollbackInfo, ServerRollbackInfoSchema, type ServerUpdateActionResult, ServerUpdateActionResultSchema, type ServerUpdateCheckResult, ServerUpdateCheckResultSchema, type ServerUpdateOutcome, ServerUpdateOutcomeSchema, type ServerUpdateState, ServerUpdateStateSchema, serverManagementCapability, type UpdateBlocker, UpdateBlockerSchema, type WrapperEvidence, WrapperEvidenceSchema, type WrapperIdentity, WrapperIdentitySchema, type WrapperKind, WrapperKindSchema, } from './server-management.cap.js';
+export { type ImageContract, ImageContractSchema, type ImageContractState, ImageContractStateSchema, type IServerManagementProvider, type RunnerBootCheck, RunnerBootCheckSchema, type RunnerRefusal, RunnerRefusalSchema, type ServerBootMode, ServerBootModeSchema, type ServerPackageStatus, ServerPackageStatusSchema, type ServerRollbackInfo, ServerRollbackInfoSchema, type LaunchOverrides, type SetLaunchOverridesResult, type ServerUpdateActionResult, ServerUpdateActionResultSchema, type ServerUpdateCheckResult, ServerUpdateCheckResultSchema, type ServerUpdateOutcome, ServerUpdateOutcomeSchema, type ServerUpdateState, ServerUpdateStateSchema, serverManagementCapability, type UpdateBlocker, UpdateBlockerSchema, type WrapperEvidence, WrapperEvidenceSchema, type WrapperIdentity, WrapperIdentitySchema, type WrapperKind, WrapperKindSchema, } from './server-management.cap.js';
 export { type BulkRecord, BulkRecordSchema, type CollectionColumn, CollectionColumnSchema, type CollectionIndex, CollectionIndexSchema, DATA_STORE_DATABASES, type DataStoreDatabase, DataStoreDatabaseSchema, type DeclareCollectionInput, DeclareCollectionInputSchema, type ISettingsStoreProvider, type MutationFilter, MutationFilterSchema, QueryFilterSchema, SettingsRecordSchema, type SettingsStoreClient, settingsStoreCapability, } from './settings-store.cap.js';
 export type { ISmtpProvider } from './smtp-provider.cap.js';
 export { SendEmailInputSchema, SendEmailResultSchema, SmtpStatusSchema, smtpProviderCapability, } from './smtp-provider.cap.js';

package/dist/capabilities/server-management.cap.d.ts

@@ -379,6 +379,13 @@ declare const ServerUpdateActionResultSchema: z.ZodObject<{
         remedy: z.ZodString;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
+declare const LaunchOverridesSchema: z.ZodObject<{
+    heapMb: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+declare const SetLaunchOverridesResultSchema: z.ZodObject<{
+    heapMb: z.ZodNullable<z.ZodNumber>;
+    restartRequired: z.ZodBoolean;
+}, z.core.$strip>;
 export declare const serverManagementCapability: {
     readonly name: 'server-management';
     readonly scope: 'system';
@@ -551,6 +558,25 @@ export declare const serverManagementCapability: {
                 remedy: z.ZodString;
             }, z.core.$strip>>>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * The node's persisted launch override (ADR 0970): the heap ceiling the node's
+         * `node` process is started with, or `null` when none is set (the closure's
+         * computed default applies). Read from the node's own data dir.
+         */
+        readonly getLaunchOverrides: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            heapMb: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Set (`heapMb`) or clear (`null`) the node's heap-ceiling override. It is
+         * written on the node itself and applies at the NEXT launch — restart the
+         * node (`restartServer`) for it to take effect.
+         */
+        readonly setLaunchOverrides: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            heapMb: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            heapMb: z.ZodNullable<z.ZodNumber>;
+            restartRequired: z.ZodBoolean;
+        }, z.core.$strip>, "mutation">;
     };
     /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
     readonly mount: {
@@ -570,6 +596,8 @@ export type ServerPackageStatus = z.infer<typeof ServerPackageStatusSchema>;
 export type ServerUpdateCheckResult = z.infer<typeof ServerUpdateCheckResultSchema>;
 export type ServerUpdateOutcome = z.infer<typeof ServerUpdateOutcomeSchema>;
 export type ServerUpdateActionResult = z.infer<typeof ServerUpdateActionResultSchema>;
+export type LaunchOverrides = z.infer<typeof LaunchOverridesSchema>;
+export type SetLaunchOverridesResult = z.infer<typeof SetLaunchOverridesResultSchema>;
 export type RunnerBootCheck = z.infer<typeof RunnerBootCheckSchema>;
 export type RunnerRefusal = z.infer<typeof RunnerRefusalSchema>;
 export type UpdateBlocker = z.infer<typeof UpdateBlockerSchema>;

package/dist/client.js

@@ -28970,7 +28970,9 @@ function createSystemProxy(api) {
 			checkServerUpdate: (input) => dispatch("serverManagement", "checkServerUpdate", "mutation", input),
 			applyServerUpdate: (input) => dispatch("serverManagement", "applyServerUpdate", "mutation", input),
 			rollbackServerUpdate: (input) => dispatch("serverManagement", "rollbackServerUpdate", "mutation", input),
-			restartServer: (input) => dispatch("serverManagement", "restartServer", "mutation", input)
+			restartServer: (input) => dispatch("serverManagement", "restartServer", "mutation", input),
+			getLaunchOverrides: (input) => dispatch("serverManagement", "getLaunchOverrides", "query", input),
+			setLaunchOverrides: (input) => dispatch("serverManagement", "setLaunchOverrides", "mutation", input)
 		},
 		settingsStore: {
 			get: (input) => dispatch("settingsStore", "get", "query", input),

package/dist/client.mjs

@@ -28969,7 +28969,9 @@ function createSystemProxy(api) {
 			checkServerUpdate: (input) => dispatch("serverManagement", "checkServerUpdate", "mutation", input),
 			applyServerUpdate: (input) => dispatch("serverManagement", "applyServerUpdate", "mutation", input),
 			rollbackServerUpdate: (input) => dispatch("serverManagement", "rollbackServerUpdate", "mutation", input),
-			restartServer: (input) => dispatch("serverManagement", "restartServer", "mutation", input)
+			restartServer: (input) => dispatch("serverManagement", "restartServer", "mutation", input),
+			getLaunchOverrides: (input) => dispatch("serverManagement", "getLaunchOverrides", "query", input),
+			setLaunchOverrides: (input) => dispatch("serverManagement", "setLaunchOverrides", "mutation", input)
 		},
 		settingsStore: {
 			get: (input) => dispatch("settingsStore", "get", "query", input),

package/dist/generated/addon-api.d.ts

@@ -9087,6 +9087,20 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof serverManagementCapability.methods.restartServer.output>;
             meta: object;
         }>;
+        getLaunchOverrides: TRPCQueryProcedure<{
+            input: {
+                nodeId?: string | undefined;
+            } | undefined;
+            output: z.infer<typeof serverManagementCapability.methods.getLaunchOverrides.output>;
+            meta: object;
+        }>;
+        setLaunchOverrides: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof serverManagementCapability.methods.setLaunchOverrides.input>;
+            output: z.infer<typeof serverManagementCapability.methods.setLaunchOverrides.output>;
+            meta: object;
+        }>;
     }>>;
     settingsStore: TRPCBuiltRouter<{
         ctx: TrpcContext;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 1427 method paths across 192 capabilities.
+ * Coverage: 1429 method paths across 192 capabilities.
  */
 import type { MethodRole } from '../auth/viewer-access.js';
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';

package/dist/generated/system-proxy.d.ts

@@ -113,7 +113,7 @@ export interface SystemProxy {
     readonly recordingArchive: Pick<InferProvider<typeof recordingArchiveCapability>, 'getAvailabilityBatch' | 'getDaysWithRecordingsBatch' | 'getStorageUsage' | 'listOpsLog' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'refreshStorageLocationsForMigration' | 'startStorageMigrationMove' | 'getStorageMigrationMoveStatus' | 'cancelStorageMigrationMove' | 'relocateFootage' | 'listRelocateJobs' | 'getRelocateResidue' | 'reconcileLedgerAgainstDisk' | 'cancelRelocateJob' | 'planStorageRebalance' | 'startStorageRebalance' | 'getPlacement' | 'setDevicePlacement'>;
     readonly recordingExport: Pick<InferProvider<typeof recordingExportCapability>, 'createExport' | 'getExport' | 'cancelExport' | 'deleteExport' | 'getDownloadUrl' | 'readExportBytes'>;
     readonly remote: Pick<InferProvider<typeof remoteCapability>, 'getConfig' | 'setConfig' | 'listCommands' | 'sendCommand' | 'sendMediaCommand'>;
-    readonly serverManagement: Pick<InferProvider<typeof serverManagementCapability>, 'getServerPackageStatus' | 'checkServerUpdate' | 'applyServerUpdate' | 'rollbackServerUpdate' | 'restartServer'>;
+    readonly serverManagement: Pick<InferProvider<typeof serverManagementCapability>, 'getServerPackageStatus' | 'checkServerUpdate' | 'applyServerUpdate' | 'rollbackServerUpdate' | 'restartServer' | 'getLaunchOverrides' | 'setLaunchOverrides'>;
     readonly settingsStore: Pick<InferProvider<typeof settingsStoreCapability>, 'get' | 'set' | 'query' | 'upsert' | 'upsertMany' | 'insert' | 'insertMany' | 'transact' | 'update' | 'delete' | 'deleteWhere' | 'updateWhere' | 'count' | 'aggregate' | 'histogram' | 'isEmpty' | 'declareCollection'>;
     readonly storage: Pick<InferProvider<typeof storageCapability>, 'resolve' | 'write' | 'read' | 'exists' | 'list' | 'delete' | 'getAvailableSpace' | 'beginUpload' | 'writeChunk' | 'finalizeUpload' | 'abortUpload' | 'beginDownload' | 'readChunk' | 'endDownload' | 'listLocations' | 'listLocationDeclarations' | 'upsertLocation' | 'deleteLocation' | 'listDrainProgress' | 'testLocation' | 'listProviders' | 'testConfig'>;
     readonly storageMigration: Pick<InferProvider<typeof storageMigrationCapability>, 'plan' | 'start' | 'status' | 'cancel' | 'movers' | 'moverClearance' | 'residue' | 'drain' | 'cleanupStart' | 'cleanupStatus' | 'cleanupCancel' | 'history'>;

package/dist/index.js

@@ -60398,6 +60398,12 @@ var ServerUpdateActionResultSchema = zod.z.object({
 	*/
 	blockers: zod.z.array(UpdateBlockerSchema).optional()
 });
+var LaunchOverridesSchema = zod.z.object({ 
+/** The persisted heap ceiling in MB, or `null` when none is set. */
+heapMb: zod.z.number().int().nullable() });
+var SetLaunchOverridesResultSchema = LaunchOverridesSchema.extend({ 
+/** Always true: the override is read at launch, not by the running process. */
+restartRequired: zod.z.boolean() });
 var serverManagementCapability = {
 	name: "server-management",
 	scope: "system",
@@ -60436,6 +60442,21 @@ var serverManagementCapability = {
 		restartServer: require_sleep.method(zod.z.void(), ServerUpdateActionResultSchema, {
 			kind: "mutation",
 			auth: "admin"
+		}),
+		/**
+		* The node's persisted launch override (ADR 0970): the heap ceiling the node's
+		* `node` process is started with, or `null` when none is set (the closure's
+		* computed default applies). Read from the node's own data dir.
+		*/
+		getLaunchOverrides: require_sleep.method(zod.z.void(), LaunchOverridesSchema, { auth: "admin" }),
+		/**
+		* Set (`heapMb`) or clear (`null`) the node's heap-ceiling override. It is
+		* written on the node itself and applies at the NEXT launch — restart the
+		* node (`restartServer`) for it to take effect.
+		*/
+		setLaunchOverrides: require_sleep.method(zod.z.object({ heapMb: zod.z.number().int().min(512).max(65536).nullable() }), SetLaunchOverridesResultSchema, {
+			kind: "mutation",
+			auth: "admin"
 		})
 	},
 	/** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
@@ -96644,6 +96665,13 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		access: "create",
 		role: "admin"
 	},
+	"serverManagement.getLaunchOverrides": {
+		capName: "server-management",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "admin"
+	},
 	"serverManagement.getServerPackageStatus": {
 		capName: "server-management",
 		capScope: "system",
@@ -96665,6 +96693,13 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		access: "create",
 		role: "admin"
 	},
+	"serverManagement.setLaunchOverrides": {
+		capName: "server-management",
+		capScope: "system",
+		addonId: null,
+		access: "create",
+		role: "admin"
+	},
 	"settingsStore.aggregate": {
 		capName: "settings-store",
 		capScope: "system",
@@ -110845,7 +110880,9 @@ function createSystemProxy(api) {
 			checkServerUpdate: (input) => dispatch("serverManagement", "checkServerUpdate", "mutation", input),
 			applyServerUpdate: (input) => dispatch("serverManagement", "applyServerUpdate", "mutation", input),
 			rollbackServerUpdate: (input) => dispatch("serverManagement", "rollbackServerUpdate", "mutation", input),
-			restartServer: (input) => dispatch("serverManagement", "restartServer", "mutation", input)
+			restartServer: (input) => dispatch("serverManagement", "restartServer", "mutation", input),
+			getLaunchOverrides: (input) => dispatch("serverManagement", "getLaunchOverrides", "query", input),
+			setLaunchOverrides: (input) => dispatch("serverManagement", "setLaunchOverrides", "mutation", input)
 		},
 		settingsStore: {
 			get: (input) => dispatch("settingsStore", "get", "query", input),

package/dist/index.mjs

@@ -60397,6 +60397,12 @@ var ServerUpdateActionResultSchema = z.object({
 	*/
 	blockers: z.array(UpdateBlockerSchema).optional()
 });
+var LaunchOverridesSchema = z.object({ 
+/** The persisted heap ceiling in MB, or `null` when none is set. */
+heapMb: z.number().int().nullable() });
+var SetLaunchOverridesResultSchema = LaunchOverridesSchema.extend({ 
+/** Always true: the override is read at launch, not by the running process. */
+restartRequired: z.boolean() });
 var serverManagementCapability = {
 	name: "server-management",
 	scope: "system",
@@ -60435,6 +60441,21 @@ var serverManagementCapability = {
 		restartServer: method(z.void(), ServerUpdateActionResultSchema, {
 			kind: "mutation",
 			auth: "admin"
+		}),
+		/**
+		* The node's persisted launch override (ADR 0970): the heap ceiling the node's
+		* `node` process is started with, or `null` when none is set (the closure's
+		* computed default applies). Read from the node's own data dir.
+		*/
+		getLaunchOverrides: method(z.void(), LaunchOverridesSchema, { auth: "admin" }),
+		/**
+		* Set (`heapMb`) or clear (`null`) the node's heap-ceiling override. It is
+		* written on the node itself and applies at the NEXT launch — restart the
+		* node (`restartServer`) for it to take effect.
+		*/
+		setLaunchOverrides: method(z.object({ heapMb: z.number().int().min(512).max(65536).nullable() }), SetLaunchOverridesResultSchema, {
+			kind: "mutation",
+			auth: "admin"
 		})
 	},
 	/** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
@@ -96643,6 +96664,13 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		access: "create",
 		role: "admin"
 	},
+	"serverManagement.getLaunchOverrides": {
+		capName: "server-management",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "admin"
+	},
 	"serverManagement.getServerPackageStatus": {
 		capName: "server-management",
 		capScope: "system",
@@ -96664,6 +96692,13 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		access: "create",
 		role: "admin"
 	},
+	"serverManagement.setLaunchOverrides": {
+		capName: "server-management",
+		capScope: "system",
+		addonId: null,
+		access: "create",
+		role: "admin"
+	},
 	"settingsStore.aggregate": {
 		capName: "settings-store",
 		capScope: "system",
@@ -110844,7 +110879,9 @@ function createSystemProxy(api) {
 			checkServerUpdate: (input) => dispatch("serverManagement", "checkServerUpdate", "mutation", input),
 			applyServerUpdate: (input) => dispatch("serverManagement", "applyServerUpdate", "mutation", input),
 			rollbackServerUpdate: (input) => dispatch("serverManagement", "rollbackServerUpdate", "mutation", input),
-			restartServer: (input) => dispatch("serverManagement", "restartServer", "mutation", input)
+			restartServer: (input) => dispatch("serverManagement", "restartServer", "mutation", input),
+			getLaunchOverrides: (input) => dispatch("serverManagement", "getLaunchOverrides", "query", input),
+			setLaunchOverrides: (input) => dispatch("serverManagement", "setLaunchOverrides", "mutation", input)
 		},
 		settingsStore: {
 			get: (input) => dispatch("settingsStore", "get", "query", input),

package/package.json

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