@camstack/types 1.2.137 → 1.2.139

package/dist/capabilities/ai-cap-timeouts.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Transport bounds for AI capability methods.
+ *
+ * Its own module because `llm.cap.ts` and `llm-runtime.cap.ts` already import
+ * each other: declaring the constant in either one hands the other `undefined`
+ * at module-init time, and an undefined `timeoutMs` silently falls back to the
+ * kernel's 60 s default — the exact failure this constant exists to prevent,
+ * reintroduced invisibly. Found by the guard, not by review.
+ */
+/**
+ * Ceiling for a cap method that runs inference or loads a model.
+ *
+ * Deliberately far above anything the AI layer itself may wait for (a summary
+ * asks 180 s by default, a rule may ask 600 s), because the TRANSPORT must
+ * never be the layer that gives up first: when it does, the failure is
+ * reported as a transport error for a model that was still thinking, naming
+ * the wrong layer and hiding the real one.
+ *
+ * Measured 2026-09-03: a 6-image vision request needs 44.8 s warm and ~20 s
+ * more on a cold model load. With no declaration every digest failed at
+ * exactly 60 s and shipped without its text.
+ *
+ * A ceiling, not a budget. The AI layer's own timeouts (the rule's `timeoutMs`,
+ * the profile's `timeoutMs` / `firstTokenTimeoutMs`) remain the things that
+ * decide when to stop, because only they can say WHY.
+ */
+export declare const AI_CAP_TRANSPORT_TIMEOUT_MS = 600000;
+/** A multi-gigabyte download. An hour is not generous, it is honest. */
+export declare const AI_MODEL_INSTALL_TIMEOUT_MS: number;

package/dist/capabilities/llm-runtime.cap.d.ts

@@ -1,14 +1,3 @@
-/**
- * `llm-runtime` — node-side managed llama.cpp executor (spec §4). Registered
- * on EVERY node where `addon-ai` is installed; the hub `llm` provider reaches
- * a specific node's runtime with `nodePin(profile.runtime.nodeId)` — normal
- * cap routing, zero bespoke plumbing. `internal: true`: the operator reaches
- * this only through the `llm` cap's methods.
- *
- * One running llama-server child per node in v1 (models are RAM-heavy).
- * Resource ceiling = llama-server flags + idleStopMinutes ONLY (no RSS
- * watchdog — operator decision #3).
- */
 import { z } from 'zod';
 import { type InferProvider } from './capability-definition.js';
 /**

package/dist/capabilities/metrics-provider.cap.d.ts

@@ -235,15 +235,6 @@ declare const ContainerMemoryPointSchema: z.ZodObject<{
     gpuShmemBytes: z.ZodNullable<z.ZodNumber>;
     atMs: z.ZodNumber;
 }, z.core.$strip>;
-declare const DumpHeapSnapshotInputSchema: z.ZodObject<{
-    addonId: z.ZodString;
-}, z.core.$strip>;
-declare const DumpHeapSnapshotResultSchema: z.ZodObject<{
-    success: z.ZodBoolean;
-    path: z.ZodOptional<z.ZodString>;
-    pid: z.ZodOptional<z.ZodNumber>;
-    reason: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
 /**
  * One point of one function's series.
  *
@@ -714,23 +705,7 @@ export declare const metricsProviderCapability: {
             cadenceMs: z.ZodNumber;
             durable: z.ZodBoolean;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
-        /**
-         * Tell the addon's forked runner to write a V8 heap snapshot to disk (via
-         * SIGUSR2 — the runner's diagnostic handler). Also logs its
-         * `process.memoryUsage()` + heap-space breakdown. Resolves the pid from
-         * `$process.list`, so it can only reach a runner this node spawned. Use
-         * for deep per-addon memory attribution; copy the returned path off the
-         * node to analyze.
-         */
-        readonly dumpHeapSnapshot: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            addonId: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
-            success: z.ZodBoolean;
-            path: z.ZodOptional<z.ZodString>;
-            pid: z.ZodOptional<z.ZodNumber>;
-            reason: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>, "mutation">;
     };
 };
 export type IMetricsProvider = InferProvider<typeof metricsProviderCapability>;
-export { SystemMetricsSchema, SystemResourceSnapshotSchema, DiskSpaceInfoSchema, MetricsGpuInfoSchema, PidResourceStatsSchema, AddonInstanceSchema, NodeProcessSchema, DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, LoadPointSchema, LoadFunctionSeriesSchema, ContainerMemorySnapshotSchema, ContainerMemoryPointSchema, NodeLoadSeriesSchema, GetLoadSeriesInputSchema, CpuBreakdownSchema, MemoryInfoSchema, DiskIoSnapshotSchema, NetworkIoSnapshotSchema, ProcessResourceInfoSchema, PressureInfoSchema, };
+export { SystemMetricsSchema, SystemResourceSnapshotSchema, DiskSpaceInfoSchema, MetricsGpuInfoSchema, PidResourceStatsSchema, AddonInstanceSchema, NodeProcessSchema, LoadPointSchema, LoadFunctionSeriesSchema, ContainerMemorySnapshotSchema, ContainerMemoryPointSchema, NodeLoadSeriesSchema, GetLoadSeriesInputSchema, CpuBreakdownSchema, MemoryInfoSchema, DiskIoSnapshotSchema, NetworkIoSnapshotSchema, ProcessResourceInfoSchema, PressureInfoSchema, };

package/dist/capabilities/pipeline-analytics.cap.d.ts

@@ -617,6 +617,7 @@ declare const MediaFileKindEnum: z.ZodEnum<{
     plateCrop: "plateCrop";
     keyFrameSmall: "keyFrameSmall";
     thumbnailSmall: "thumbnailSmall";
+    sceneFrame: "sceneFrame";
 }>;
 export type MediaFileKind = z.infer<typeof MediaFileKindEnum>;
 /**
@@ -643,6 +644,7 @@ declare const MediaFileRefSchema: z.ZodObject<{
         plateCrop: "plateCrop";
         keyFrameSmall: "keyFrameSmall";
         thumbnailSmall: "thumbnailSmall";
+        sceneFrame: "sceneFrame";
     }>;
     sizeBytes: z.ZodNumber;
     timestamp: z.ZodNumber;
@@ -713,6 +715,7 @@ declare const MediaFileSchema: z.ZodObject<{
         plateCrop: "plateCrop";
         keyFrameSmall: "keyFrameSmall";
         thumbnailSmall: "thumbnailSmall";
+        sceneFrame: "sceneFrame";
     }>;
     sizeBytes: z.ZodNumber;
     timestamp: z.ZodNumber;
@@ -750,6 +753,7 @@ declare const MediaFileInfoSchema: z.ZodObject<{
         plateCrop: "plateCrop";
         keyFrameSmall: "keyFrameSmall";
         thumbnailSmall: "thumbnailSmall";
+        sceneFrame: "sceneFrame";
     }>;
     url: z.ZodString;
     sizeBytes: z.ZodNumber;
@@ -888,6 +892,7 @@ export declare const RetrainFrameCandidateSchema: z.ZodObject<{
         plateCrop: "plateCrop";
         keyFrameSmall: "keyFrameSmall";
         thumbnailSmall: "thumbnailSmall";
+        sceneFrame: "sceneFrame";
     }>;
     timestamp: z.ZodNumber;
     sizeBytes: z.ZodNumber;
@@ -913,6 +918,7 @@ export declare const RetrainFrameSchema: z.ZodObject<{
         plateCrop: "plateCrop";
         keyFrameSmall: "keyFrameSmall";
         thumbnailSmall: "thumbnailSmall";
+        sceneFrame: "sceneFrame";
     }>;
     sizeBytes: z.ZodNumber;
     width: z.ZodNumber;
@@ -945,6 +951,7 @@ export declare const RetrainFrameSelectionSchema: z.ZodObject<{
             plateCrop: "plateCrop";
             keyFrameSmall: "keyFrameSmall";
             thumbnailSmall: "thumbnailSmall";
+            sceneFrame: "sceneFrame";
         }>;
         sizeBytes: z.ZodNumber;
         width: z.ZodNumber;
@@ -977,6 +984,7 @@ export declare const RetrainFrameListSchema: z.ZodObject<{
             plateCrop: "plateCrop";
             keyFrameSmall: "keyFrameSmall";
             thumbnailSmall: "thumbnailSmall";
+            sceneFrame: "sceneFrame";
         }>;
         timestamp: z.ZodNumber;
         sizeBytes: z.ZodNumber;
@@ -1000,6 +1008,7 @@ export declare const RetrainFrameListSchema: z.ZodObject<{
             plateCrop: "plateCrop";
             keyFrameSmall: "keyFrameSmall";
             thumbnailSmall: "thumbnailSmall";
+            sceneFrame: "sceneFrame";
         }>;
         sizeBytes: z.ZodNumber;
         width: z.ZodNumber;
@@ -1460,6 +1469,7 @@ declare const EventMediaKindFootprintSchema: z.ZodObject<{
         plateCrop: "plateCrop";
         keyFrameSmall: "keyFrameSmall";
         thumbnailSmall: "thumbnailSmall";
+        sceneFrame: "sceneFrame";
     }>;
     rows: z.ZodNumber;
     bytes: z.ZodNumber;
@@ -1506,6 +1516,7 @@ declare const EventMediaKindBreakdownSchema: z.ZodObject<{
             plateCrop: "plateCrop";
             keyFrameSmall: "keyFrameSmall";
             thumbnailSmall: "thumbnailSmall";
+            sceneFrame: "sceneFrame";
         }>;
         rows: z.ZodNumber;
         bytes: z.ZodNumber;
@@ -2589,6 +2600,7 @@ export declare const pipelineAnalyticsCapability: {
                     plateCrop: "plateCrop";
                     keyFrameSmall: "keyFrameSmall";
                     thumbnailSmall: "thumbnailSmall";
+                    sceneFrame: "sceneFrame";
                 }>;
                 rows: z.ZodNumber;
                 bytes: z.ZodNumber;
@@ -2980,6 +2992,7 @@ export declare const pipelineAnalyticsCapability: {
                     plateCrop: "plateCrop";
                     keyFrameSmall: "keyFrameSmall";
                     thumbnailSmall: "thumbnailSmall";
+                    sceneFrame: "sceneFrame";
                 }>;
                 timestamp: z.ZodNumber;
                 sizeBytes: z.ZodNumber;
@@ -3003,6 +3016,7 @@ export declare const pipelineAnalyticsCapability: {
                     plateCrop: "plateCrop";
                     keyFrameSmall: "keyFrameSmall";
                     thumbnailSmall: "thumbnailSmall";
+                    sceneFrame: "sceneFrame";
                 }>;
                 sizeBytes: z.ZodNumber;
                 width: z.ZodNumber;
@@ -3048,6 +3062,7 @@ export declare const pipelineAnalyticsCapability: {
                     plateCrop: "plateCrop";
                     keyFrameSmall: "keyFrameSmall";
                     thumbnailSmall: "thumbnailSmall";
+                    sceneFrame: "sceneFrame";
                 }>;
                 sizeBytes: z.ZodNumber;
                 width: z.ZodNumber;
@@ -3434,6 +3449,7 @@ export declare const pipelineAnalyticsCapability: {
                 plateCrop: "plateCrop";
                 keyFrameSmall: "keyFrameSmall";
                 thumbnailSmall: "thumbnailSmall";
+                sceneFrame: "sceneFrame";
             }>>;
             deviceId: z.ZodNumber;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -3451,6 +3467,7 @@ export declare const pipelineAnalyticsCapability: {
                 plateCrop: "plateCrop";
                 keyFrameSmall: "keyFrameSmall";
                 thumbnailSmall: "thumbnailSmall";
+                sceneFrame: "sceneFrame";
             }>;
             sizeBytes: z.ZodNumber;
             timestamp: z.ZodNumber;
@@ -3476,6 +3493,7 @@ export declare const pipelineAnalyticsCapability: {
                 plateCrop: "plateCrop";
                 keyFrameSmall: "keyFrameSmall";
                 thumbnailSmall: "thumbnailSmall";
+                sceneFrame: "sceneFrame";
             }>>>;
             deviceId: z.ZodNumber;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -3493,6 +3511,7 @@ export declare const pipelineAnalyticsCapability: {
                 plateCrop: "plateCrop";
                 keyFrameSmall: "keyFrameSmall";
                 thumbnailSmall: "thumbnailSmall";
+                sceneFrame: "sceneFrame";
             }>;
             sizeBytes: z.ZodNumber;
             timestamp: z.ZodNumber;
@@ -3533,6 +3552,7 @@ export declare const pipelineAnalyticsCapability: {
                 plateCrop: "plateCrop";
                 keyFrameSmall: "keyFrameSmall";
                 thumbnailSmall: "thumbnailSmall";
+                sceneFrame: "sceneFrame";
             }>;
             url: z.ZodString;
             sizeBytes: z.ZodNumber;
@@ -3572,6 +3592,7 @@ export declare const pipelineAnalyticsCapability: {
                 plateCrop: "plateCrop";
                 keyFrameSmall: "keyFrameSmall";
                 thumbnailSmall: "thumbnailSmall";
+                sceneFrame: "sceneFrame";
             }>;
             url: z.ZodString;
             sizeBytes: z.ZodNumber;

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

@@ -4063,13 +4063,6 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof metricsProviderCapability.methods.getLoadSeries.output>;
             meta: object;
         }>;
-        dumpHeapSnapshot: TRPCMutationProcedure<{
-            input: {
-                [x: string]: unknown;
-            } & z.input<typeof metricsProviderCapability.methods.dumpHeapSnapshot.input>;
-            output: z.infer<typeof metricsProviderCapability.methods.dumpHeapSnapshot.output>;
-            meta: object;
-        }>;
     }>>;
     modelConvert: 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: 1003 method paths across 126 capabilities.
+ * Coverage: 1002 method paths across 126 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

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

@@ -76,7 +76,7 @@ export interface SystemProxy {
     readonly llm: Pick<InferProvider<typeof llmCapability>, 'generate' | 'generateVision' | 'cancel' | 'listProfileKinds' | 'listProfiles' | 'upsertProfile' | 'deleteProfile' | 'testProfile' | 'listModels' | 'getDefaults' | 'setDefault' | 'getUsage' | 'listModelCatalog' | 'listRuntimeNodes' | 'listNodeModels' | 'resolveModelRef' | 'installModel' | 'deleteModel' | 'getRuntimeStatus' | 'startRuntime' | 'stopRuntime'>;
     readonly localNetwork: Pick<InferProvider<typeof localNetworkCapability>, 'list' | 'getPreferred' | 'getConnectionEndpoints' | 'getNotificationEndpoint' | 'setNotificationEndpoint' | 'getViewerEndpoints' | 'setViewerEndpoints' | 'getAllowedAddresses' | 'setAllowedAddresses' | 'resetAllowlistToBestMatch' | 'getTlsStatus' | 'regenerateCertificate' | 'uploadCertificate' | 'downloadCa' | 'revertToGeneratedCertificate'>;
     readonly meshNetwork: Pick<InferProvider<typeof meshNetworkCapability>, 'getStatus' | 'join' | 'startLogin' | 'leave' | 'logout' | 'listPeers' | 'testConnection'>;
-    readonly metricsProvider: Pick<InferProvider<typeof metricsProviderCapability>, 'collectSnapshot' | 'getCached' | 'getCurrent' | 'getDiskSpace' | 'getGpuInfo' | 'getCpuTemperature' | 'getProcessStats' | 'listAddonInstances' | 'getAddonStats' | 'listNodeProcesses' | 'getLoadSeries' | 'dumpHeapSnapshot'>;
+    readonly metricsProvider: Pick<InferProvider<typeof metricsProviderCapability>, 'collectSnapshot' | 'getCached' | 'getCurrent' | 'getDiskSpace' | 'getGpuInfo' | 'getCpuTemperature' | 'getProcessStats' | 'listAddonInstances' | 'getAddonStats' | 'listNodeProcesses' | 'getLoadSeries'>;
     readonly mqttBroker: Pick<InferProvider<typeof mqttBrokerCapability>, 'listBrokers' | 'getBrokerConfig' | 'addBroker' | 'removeBroker' | 'testConnection' | 'startEmbeddedBroker' | 'stopEmbeddedBroker' | 'getStatus'>;
     readonly networkAccess: Pick<InferProvider<typeof networkAccessCapability>, 'start' | 'stop' | 'getEndpoint' | 'getStatus' | 'listEndpoints'>;
     readonly networkQuality: Pick<InferProvider<typeof networkQualityCapability>, 'getAllStats'>;

package/dist/index.js

@@ -11414,6 +11414,37 @@ var filesystemBrowseCapability = {
 	}
 };
 //#endregion
+//#region src/capabilities/ai-cap-timeouts.ts
+/**
+* Transport bounds for AI capability methods.
+*
+* Its own module because `llm.cap.ts` and `llm-runtime.cap.ts` already import
+* each other: declaring the constant in either one hands the other `undefined`
+* at module-init time, and an undefined `timeoutMs` silently falls back to the
+* kernel's 60 s default — the exact failure this constant exists to prevent,
+* reintroduced invisibly. Found by the guard, not by review.
+*/
+/**
+* Ceiling for a cap method that runs inference or loads a model.
+*
+* Deliberately far above anything the AI layer itself may wait for (a summary
+* asks 180 s by default, a rule may ask 600 s), because the TRANSPORT must
+* never be the layer that gives up first: when it does, the failure is
+* reported as a transport error for a model that was still thinking, naming
+* the wrong layer and hiding the real one.
+*
+* Measured 2026-09-03: a 6-image vision request needs 44.8 s warm and ~20 s
+* more on a cold model load. With no declaration every digest failed at
+* exactly 60 s and shipped without its text.
+*
+* A ceiling, not a budget. The AI layer's own timeouts (the rule's `timeoutMs`,
+* the profile's `timeoutMs` / `firstTokenTimeoutMs`) remain the things that
+* decide when to stop, because only they can say WHY.
+*/
+var AI_CAP_TRANSPORT_TIMEOUT_MS = 6e5;
+/** A multi-gigabyte download. An hour is not generous, it is honest. */
+var AI_MODEL_INSTALL_TIMEOUT_MS = 60 * 6e4;
+//#endregion
 //#region src/capabilities/llm-shared.ts
 /**
 * Shared LLM generate contracts — imported by BOTH `llm.cap.ts` (consumer
@@ -11729,11 +11760,13 @@ var llmRuntimeCapability = {
 		*/
 		complete: require_sleep.method(LlmRuntimeCompleteInputSchema, LlmGenerateResultSchema, {
 			kind: "mutation",
-			auth: "admin"
+			auth: "admin",
+			timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
 		}),
 		ensureStarted: require_sleep.method(zod.z.object({ runtime: ManagedRuntimeConfigSchema }), LlmRuntimeStatusSchema, {
 			kind: "mutation",
-			auth: "admin"
+			auth: "admin",
+			timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
 		}),
 		stop: require_sleep.method(zod.z.object({}), zod.z.void(), {
 			kind: "mutation",
@@ -11742,7 +11775,8 @@ var llmRuntimeCapability = {
 		status: require_sleep.method(zod.z.object({}), LlmRuntimeStatusSchema, { auth: "admin" }),
 		installModel: require_sleep.method(zod.z.object({ model: ManagedModelRefSchema }), zod.z.void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "admin",
+			timeoutMs: AI_MODEL_INSTALL_TIMEOUT_MS
 		}),
 		deleteModel: require_sleep.method(zod.z.object({ file: zod.z.string() }), zod.z.void(), {
 			kind: "mutation",
@@ -11926,8 +11960,14 @@ var llmCapability = {
 	/** `nodeId` inputs below are DATA (the hub provider pins itself), never routing. */
 	nodeIdMode: "data",
 	methods: {
-		generate: require_sleep.method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }),
-		generateVision: require_sleep.method(GenerateVisionInputSchema, LlmGenerateResultSchema, { kind: "mutation" }),
+		generate: require_sleep.method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, {
+			kind: "mutation",
+			timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
+		}),
+		generateVision: require_sleep.method(GenerateVisionInputSchema, LlmGenerateResultSchema, {
+			kind: "mutation",
+			timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
+		}),
 		/**
 		* Stop a generation started with a `requestId`.
 		*
@@ -11951,7 +11991,8 @@ var llmCapability = {
 		}),
 		testProfile: require_sleep.method(ProfileRefInputSchema, LlmGenerateResultSchema, {
 			kind: "mutation",
-			auth: "admin"
+			auth: "admin",
+			timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
 		}),
 		/** Live vendor enumeration (GET /models etc.). */
 		listModels: require_sleep.method(ProfileRefInputSchema, zod.z.array(zod.z.string())),
@@ -12608,17 +12649,6 @@ var ContainerMemoryPointSchema = zod.z.object({
 	*/
 	gpuShmemBytes: zod.z.number().nullable()
 }).extend({ atMs: zod.z.number() });
-var DumpHeapSnapshotInputSchema = zod.z.object({ 
-/** The addon whose runner should dump a heap snapshot. */
-addonId: zod.z.string() });
-var DumpHeapSnapshotResultSchema = zod.z.object({
-	success: zod.z.boolean(),
-	/** Path of the written .heapsnapshot inside the runner's container/host. */
-	path: zod.z.string().optional(),
-	/** Process pid that was signalled. */
-	pid: zod.z.number().optional(),
-	reason: zod.z.string().optional()
-});
 /**
 * One point of one function's series.
 *
@@ -12807,19 +12837,7 @@ var metricsProviderCapability = {
 		* agent's ring alone (`durable: false`). Empty is a legitimate answer: a
 		* node nobody has heard from has no series, and saying so is the truth.
 		*/
-		getLoadSeries: require_sleep.method(GetLoadSeriesInputSchema, NodeLoadSeriesSchema),
-		/**
-		* Tell the addon's forked runner to write a V8 heap snapshot to disk (via
-		* SIGUSR2 — the runner's diagnostic handler). Also logs its
-		* `process.memoryUsage()` + heap-space breakdown. Resolves the pid from
-		* `$process.list`, so it can only reach a runner this node spawned. Use
-		* for deep per-addon memory attribution; copy the returned path off the
-		* node to analyze.
-		*/
-		dumpHeapSnapshot: require_sleep.method(DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, {
-			kind: "mutation",
-			auth: "admin"
-		})
+		getLoadSeries: require_sleep.method(GetLoadSeriesInputSchema, NodeLoadSeriesSchema)
 	}
 };
 //#endregion
@@ -18492,7 +18510,8 @@ var MediaFileKindEnum = zod.z.enum([
 	"plateCrop",
 	"keyFrame",
 	"keyFrameSmall",
-	"thumbnailSmall"
+	"thumbnailSmall",
+	"sceneFrame"
 ]);
 /**
 * One media row's IDENTITY and shape, with no representation of its bytes.
@@ -41541,12 +41560,6 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"metricsProvider.dumpHeapSnapshot": {
-		capName: "metrics-provider",
-		capScope: "system",
-		addonId: null,
-		access: "create"
-	},
 	"metricsProvider.getAddonStats": {
 		capName: "metrics-provider",
 		capScope: "system",
@@ -47963,8 +47976,7 @@ function createSystemProxy(api) {
 			listAddonInstances: (input) => dispatch("metricsProvider", "listAddonInstances", "query", input),
 			getAddonStats: (input) => dispatch("metricsProvider", "getAddonStats", "query", input),
 			listNodeProcesses: (input) => dispatch("metricsProvider", "listNodeProcesses", "query", input),
-			getLoadSeries: (input) => dispatch("metricsProvider", "getLoadSeries", "query", input),
-			dumpHeapSnapshot: (input) => dispatch("metricsProvider", "dumpHeapSnapshot", "mutation", input)
+			getLoadSeries: (input) => dispatch("metricsProvider", "getLoadSeries", "query", input)
 		},
 		mqttBroker: {
 			listBrokers: (input) => dispatch("mqttBroker", "listBrokers", "query", input),

package/dist/index.mjs

@@ -11413,6 +11413,37 @@ var filesystemBrowseCapability = {
 	}
 };
 //#endregion
+//#region src/capabilities/ai-cap-timeouts.ts
+/**
+* Transport bounds for AI capability methods.
+*
+* Its own module because `llm.cap.ts` and `llm-runtime.cap.ts` already import
+* each other: declaring the constant in either one hands the other `undefined`
+* at module-init time, and an undefined `timeoutMs` silently falls back to the
+* kernel's 60 s default — the exact failure this constant exists to prevent,
+* reintroduced invisibly. Found by the guard, not by review.
+*/
+/**
+* Ceiling for a cap method that runs inference or loads a model.
+*
+* Deliberately far above anything the AI layer itself may wait for (a summary
+* asks 180 s by default, a rule may ask 600 s), because the TRANSPORT must
+* never be the layer that gives up first: when it does, the failure is
+* reported as a transport error for a model that was still thinking, naming
+* the wrong layer and hiding the real one.
+*
+* Measured 2026-09-03: a 6-image vision request needs 44.8 s warm and ~20 s
+* more on a cold model load. With no declaration every digest failed at
+* exactly 60 s and shipped without its text.
+*
+* A ceiling, not a budget. The AI layer's own timeouts (the rule's `timeoutMs`,
+* the profile's `timeoutMs` / `firstTokenTimeoutMs`) remain the things that
+* decide when to stop, because only they can say WHY.
+*/
+var AI_CAP_TRANSPORT_TIMEOUT_MS = 6e5;
+/** A multi-gigabyte download. An hour is not generous, it is honest. */
+var AI_MODEL_INSTALL_TIMEOUT_MS = 60 * 6e4;
+//#endregion
 //#region src/capabilities/llm-shared.ts
 /**
 * Shared LLM generate contracts — imported by BOTH `llm.cap.ts` (consumer
@@ -11728,11 +11759,13 @@ var llmRuntimeCapability = {
 		*/
 		complete: method(LlmRuntimeCompleteInputSchema, LlmGenerateResultSchema, {
 			kind: "mutation",
-			auth: "admin"
+			auth: "admin",
+			timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
 		}),
 		ensureStarted: method(z.object({ runtime: ManagedRuntimeConfigSchema }), LlmRuntimeStatusSchema, {
 			kind: "mutation",
-			auth: "admin"
+			auth: "admin",
+			timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
 		}),
 		stop: method(z.object({}), z.void(), {
 			kind: "mutation",
@@ -11741,7 +11774,8 @@ var llmRuntimeCapability = {
 		status: method(z.object({}), LlmRuntimeStatusSchema, { auth: "admin" }),
 		installModel: method(z.object({ model: ManagedModelRefSchema }), z.void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "admin",
+			timeoutMs: AI_MODEL_INSTALL_TIMEOUT_MS
 		}),
 		deleteModel: method(z.object({ file: z.string() }), z.void(), {
 			kind: "mutation",
@@ -11925,8 +11959,14 @@ var llmCapability = {
 	/** `nodeId` inputs below are DATA (the hub provider pins itself), never routing. */
 	nodeIdMode: "data",
 	methods: {
-		generate: method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }),
-		generateVision: method(GenerateVisionInputSchema, LlmGenerateResultSchema, { kind: "mutation" }),
+		generate: method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, {
+			kind: "mutation",
+			timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
+		}),
+		generateVision: method(GenerateVisionInputSchema, LlmGenerateResultSchema, {
+			kind: "mutation",
+			timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
+		}),
 		/**
 		* Stop a generation started with a `requestId`.
 		*
@@ -11950,7 +11990,8 @@ var llmCapability = {
 		}),
 		testProfile: method(ProfileRefInputSchema, LlmGenerateResultSchema, {
 			kind: "mutation",
-			auth: "admin"
+			auth: "admin",
+			timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
 		}),
 		/** Live vendor enumeration (GET /models etc.). */
 		listModels: method(ProfileRefInputSchema, z.array(z.string())),
@@ -12607,17 +12648,6 @@ var ContainerMemoryPointSchema = z.object({
 	*/
 	gpuShmemBytes: z.number().nullable()
 }).extend({ atMs: z.number() });
-var DumpHeapSnapshotInputSchema = z.object({ 
-/** The addon whose runner should dump a heap snapshot. */
-addonId: z.string() });
-var DumpHeapSnapshotResultSchema = z.object({
-	success: z.boolean(),
-	/** Path of the written .heapsnapshot inside the runner's container/host. */
-	path: z.string().optional(),
-	/** Process pid that was signalled. */
-	pid: z.number().optional(),
-	reason: z.string().optional()
-});
 /**
 * One point of one function's series.
 *
@@ -12806,19 +12836,7 @@ var metricsProviderCapability = {
 		* agent's ring alone (`durable: false`). Empty is a legitimate answer: a
 		* node nobody has heard from has no series, and saying so is the truth.
 		*/
-		getLoadSeries: method(GetLoadSeriesInputSchema, NodeLoadSeriesSchema),
-		/**
-		* Tell the addon's forked runner to write a V8 heap snapshot to disk (via
-		* SIGUSR2 — the runner's diagnostic handler). Also logs its
-		* `process.memoryUsage()` + heap-space breakdown. Resolves the pid from
-		* `$process.list`, so it can only reach a runner this node spawned. Use
-		* for deep per-addon memory attribution; copy the returned path off the
-		* node to analyze.
-		*/
-		dumpHeapSnapshot: method(DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, {
-			kind: "mutation",
-			auth: "admin"
-		})
+		getLoadSeries: method(GetLoadSeriesInputSchema, NodeLoadSeriesSchema)
 	}
 };
 //#endregion
@@ -18491,7 +18509,8 @@ var MediaFileKindEnum = z.enum([
 	"plateCrop",
 	"keyFrame",
 	"keyFrameSmall",
-	"thumbnailSmall"
+	"thumbnailSmall",
+	"sceneFrame"
 ]);
 /**
 * One media row's IDENTITY and shape, with no representation of its bytes.
@@ -41533,12 +41552,6 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"metricsProvider.dumpHeapSnapshot": {
-		capName: "metrics-provider",
-		capScope: "system",
-		addonId: null,
-		access: "create"
-	},
 	"metricsProvider.getAddonStats": {
 		capName: "metrics-provider",
 		capScope: "system",
@@ -47955,8 +47968,7 @@ function createSystemProxy(api) {
 			listAddonInstances: (input) => dispatch("metricsProvider", "listAddonInstances", "query", input),
 			getAddonStats: (input) => dispatch("metricsProvider", "getAddonStats", "query", input),
 			listNodeProcesses: (input) => dispatch("metricsProvider", "listNodeProcesses", "query", input),
-			getLoadSeries: (input) => dispatch("metricsProvider", "getLoadSeries", "query", input),
-			dumpHeapSnapshot: (input) => dispatch("metricsProvider", "dumpHeapSnapshot", "mutation", input)
+			getLoadSeries: (input) => dispatch("metricsProvider", "getLoadSeries", "query", input)
 		},
 		mqttBroker: {
 			listBrokers: (input) => dispatch("mqttBroker", "listBrokers", "query", input),

package/dist/interfaces/metrics-provider.d.ts

@@ -1,5 +1,5 @@
 import type { z } from 'zod';
-import type { CpuBreakdownSchema, MemoryInfoSchema, DiskIoSnapshotSchema, NetworkIoSnapshotSchema, MetricsGpuInfoSchema, ProcessResourceInfoSchema, PressureInfoSchema, SystemResourceSnapshotSchema, DiskSpaceInfoSchema, PidResourceStatsSchema, AddonInstanceSchema, NodeProcessSchema, DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, LoadPointSchema, LoadFunctionSeriesSchema, ContainerMemorySnapshotSchema, ContainerMemoryPointSchema, NodeLoadSeriesSchema, GetLoadSeriesInputSchema } from '../capabilities/metrics-provider.cap.js';
+import type { CpuBreakdownSchema, MemoryInfoSchema, DiskIoSnapshotSchema, NetworkIoSnapshotSchema, MetricsGpuInfoSchema, ProcessResourceInfoSchema, PressureInfoSchema, SystemResourceSnapshotSchema, DiskSpaceInfoSchema, PidResourceStatsSchema, AddonInstanceSchema, NodeProcessSchema, LoadPointSchema, LoadFunctionSeriesSchema, ContainerMemorySnapshotSchema, ContainerMemoryPointSchema, NodeLoadSeriesSchema, GetLoadSeriesInputSchema } from '../capabilities/metrics-provider.cap.js';
 export type CpuBreakdown = z.infer<typeof CpuBreakdownSchema>;
 export type MemoryInfo = z.infer<typeof MemoryInfoSchema>;
 export type DiskIoSnapshot = z.infer<typeof DiskIoSnapshotSchema>;
@@ -12,8 +12,6 @@ export type DiskSpaceInfo = z.infer<typeof DiskSpaceInfoSchema>;
 export type PidResourceStats = z.infer<typeof PidResourceStatsSchema>;
 export type AddonInstance = z.infer<typeof AddonInstanceSchema>;
 export type NodeProcess = z.infer<typeof NodeProcessSchema>;
-export type DumpHeapSnapshotInput = z.infer<typeof DumpHeapSnapshotInputSchema>;
-export type DumpHeapSnapshotResult = z.infer<typeof DumpHeapSnapshotResultSchema>;
 export type LoadSeriesPoint = z.infer<typeof LoadPointSchema>;
 export type LoadFunctionSeries = z.infer<typeof LoadFunctionSeriesSchema>;
 export type ContainerMemorySnapshot = z.infer<typeof ContainerMemorySnapshotSchema>;

package/package.json

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