@camstack/addon-decoder-ffmpeg 1.2.53 → 1.2.56

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -13388,6 +13388,35 @@ method(_void(), array(string()).readonly(), { auth: "admin" }), method(object({
13388
13388
  auth: "admin"
13389
13389
  });
13390
13390
  /**
13391
+ * Transport bounds for AI capability methods.
13392
+ *
13393
+ * Its own module because `llm.cap.ts` and `llm-runtime.cap.ts` already import
13394
+ * each other: declaring the constant in either one hands the other `undefined`
13395
+ * at module-init time, and an undefined `timeoutMs` silently falls back to the
13396
+ * kernel's 60 s default — the exact failure this constant exists to prevent,
13397
+ * reintroduced invisibly. Found by the guard, not by review.
13398
+ */
13399
+ /**
13400
+ * Ceiling for a cap method that runs inference or loads a model.
13401
+ *
13402
+ * Deliberately far above anything the AI layer itself may wait for (a summary
13403
+ * asks 180 s by default, a rule may ask 600 s), because the TRANSPORT must
13404
+ * never be the layer that gives up first: when it does, the failure is
13405
+ * reported as a transport error for a model that was still thinking, naming
13406
+ * the wrong layer and hiding the real one.
13407
+ *
13408
+ * Measured 2026-09-03: a 6-image vision request needs 44.8 s warm and ~20 s
13409
+ * more on a cold model load. With no declaration every digest failed at
13410
+ * exactly 60 s and shipped without its text.
13411
+ *
13412
+ * A ceiling, not a budget. The AI layer's own timeouts (the rule's `timeoutMs`,
13413
+ * the profile's `timeoutMs` / `firstTokenTimeoutMs`) remain the things that
13414
+ * decide when to stop, because only they can say WHY.
13415
+ */
13416
+ var AI_CAP_TRANSPORT_TIMEOUT_MS = 6e5;
13417
+ /** A multi-gigabyte download. An hour is not generous, it is honest. */
13418
+ var AI_MODEL_INSTALL_TIMEOUT_MS = 60 * 6e4;
13419
+ /**
13391
13420
  * Shared LLM generate contracts — imported by BOTH `llm.cap.ts` (consumer
13392
13421
  * surface) and `llm-runtime.cap.ts` (node-side managed executor) so the two
13393
13422
  * caps stay wire-compatible without a circular cap→cap import.
@@ -13659,16 +13688,19 @@ method(LlmGenerateBaseInputSchema.extend({
13659
13688
  timeoutMs: number().int().positive().optional()
13660
13689
  }), LlmGenerateResultSchema, {
13661
13690
  kind: "mutation",
13662
- auth: "admin"
13691
+ auth: "admin",
13692
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13663
13693
  }), method(object({ runtime: ManagedRuntimeConfigSchema }), LlmRuntimeStatusSchema, {
13664
13694
  kind: "mutation",
13665
- auth: "admin"
13695
+ auth: "admin",
13696
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13666
13697
  }), method(object({}), _void(), {
13667
13698
  kind: "mutation",
13668
13699
  auth: "admin"
13669
13700
  }), method(object({}), LlmRuntimeStatusSchema, { auth: "admin" }), method(object({ model: ManagedModelRefSchema }), _void(), {
13670
13701
  kind: "mutation",
13671
- auth: "admin"
13702
+ auth: "admin",
13703
+ timeoutMs: AI_MODEL_INSTALL_TIMEOUT_MS
13672
13704
  }), method(object({ file: string() }), _void(), {
13673
13705
  kind: "mutation",
13674
13706
  auth: "admin"
@@ -13836,7 +13868,13 @@ var ProfileRefInputSchema = object({
13836
13868
  addonId: string(),
13837
13869
  profileId: string()
13838
13870
  });
13839
- method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }), method(GenerateVisionInputSchema, LlmGenerateResultSchema, { kind: "mutation" }), method(object({
13871
+ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, {
13872
+ kind: "mutation",
13873
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13874
+ }), method(GenerateVisionInputSchema, LlmGenerateResultSchema, {
13875
+ kind: "mutation",
13876
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13877
+ }), method(object({
13840
13878
  addonId: string().optional(),
13841
13879
  requestId: string()
13842
13880
  }), _void(), { kind: "mutation" }), method(object({}), array(LlmProfileKindDescriptorSchema)), method(object({}), array(LlmProfileSchema)), method(object({ profile: LlmProfileSchema }), LlmProfileSchema, {
@@ -13847,7 +13885,8 @@ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }
13847
13885
  auth: "admin"
13848
13886
  }), method(ProfileRefInputSchema, LlmGenerateResultSchema, {
13849
13887
  kind: "mutation",
13850
- auth: "admin"
13888
+ auth: "admin",
13889
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13851
13890
  }), method(ProfileRefInputSchema, array(string())), method(object({}), array(LlmDefaultSchema)), method(object({
13852
13891
  selector: LlmDefaultSelectorSchema,
13853
13892
  profileId: string().nullable()
@@ -14313,17 +14352,6 @@ var ContainerMemoryPointSchema = object({
14313
14352
  */
14314
14353
  gpuShmemBytes: number().nullable()
14315
14354
  }).extend({ atMs: number() });
14316
- var DumpHeapSnapshotInputSchema = object({
14317
- /** The addon whose runner should dump a heap snapshot. */
14318
- addonId: string() });
14319
- var DumpHeapSnapshotResultSchema = object({
14320
- success: boolean(),
14321
- /** Path of the written .heapsnapshot inside the runner's container/host. */
14322
- path: string().optional(),
14323
- /** Process pid that was signalled. */
14324
- pid: number().optional(),
14325
- reason: string().optional()
14326
- });
14327
14355
  /**
14328
14356
  * One point of one function's series.
14329
14357
  *
@@ -14447,10 +14475,7 @@ var SystemMetricsSchema = object({
14447
14475
  gpuPercent: number().optional(),
14448
14476
  gpuMemoryPercent: number().optional()
14449
14477
  });
14450
- method(_void(), SystemResourceSnapshotSchema), method(_void(), SystemResourceSnapshotSchema.nullable()), method(_void(), SystemMetricsSchema), method(object({ dirPath: string() }), DiskSpaceInfoSchema), method(_void(), MetricsGpuInfoSchema.nullable()), method(_void(), number().nullable()), method(object({ pids: array(number()) }), array(PidResourceStatsSchema)), method(_void(), array(AddonInstanceSchema).readonly()), method(object({ addonId: string() }), PidResourceStatsSchema.nullable()), method(_void(), array(NodeProcessSchema).readonly()), method(GetLoadSeriesInputSchema, NodeLoadSeriesSchema), method(DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, {
14451
- kind: "mutation",
14452
- auth: "admin"
14453
- });
14478
+ method(_void(), SystemResourceSnapshotSchema), method(_void(), SystemResourceSnapshotSchema.nullable()), method(_void(), SystemMetricsSchema), method(object({ dirPath: string() }), DiskSpaceInfoSchema), method(_void(), MetricsGpuInfoSchema.nullable()), method(_void(), number().nullable()), method(object({ pids: array(number()) }), array(PidResourceStatsSchema)), method(_void(), array(AddonInstanceSchema).readonly()), method(object({ addonId: string() }), PidResourceStatsSchema.nullable()), method(_void(), array(NodeProcessSchema).readonly()), method(GetLoadSeriesInputSchema, NodeLoadSeriesSchema);
14454
14479
  method(object({
14455
14480
  sourceUrl: string(),
14456
14481
  metadata: ModelConvertMetadataSchema,
@@ -18684,7 +18709,8 @@ var MediaFileKindEnum = _enum([
18684
18709
  "plateCrop",
18685
18710
  "keyFrame",
18686
18711
  "keyFrameSmall",
18687
- "thumbnailSmall"
18712
+ "thumbnailSmall",
18713
+ "sceneFrame"
18688
18714
  ]);
18689
18715
  /**
18690
18716
  * One media row ON THE WIRE: what it is, how big it is, and WHERE ITS BYTES
@@ -31502,12 +31528,6 @@ Object.freeze({
31502
31528
  addonId: null,
31503
31529
  access: "view"
31504
31530
  },
31505
- "metricsProvider.dumpHeapSnapshot": {
31506
- capName: "metrics-provider",
31507
- capScope: "system",
31508
- addonId: null,
31509
- access: "create"
31510
- },
31511
31531
  "metricsProvider.getAddonStats": {
31512
31532
  capName: "metrics-provider",
31513
31533
  capScope: "system",
package/dist/index.mjs CHANGED
@@ -13384,6 +13384,35 @@ method(_void(), array(string()).readonly(), { auth: "admin" }), method(object({
13384
13384
  auth: "admin"
13385
13385
  });
13386
13386
  /**
13387
+ * Transport bounds for AI capability methods.
13388
+ *
13389
+ * Its own module because `llm.cap.ts` and `llm-runtime.cap.ts` already import
13390
+ * each other: declaring the constant in either one hands the other `undefined`
13391
+ * at module-init time, and an undefined `timeoutMs` silently falls back to the
13392
+ * kernel's 60 s default — the exact failure this constant exists to prevent,
13393
+ * reintroduced invisibly. Found by the guard, not by review.
13394
+ */
13395
+ /**
13396
+ * Ceiling for a cap method that runs inference or loads a model.
13397
+ *
13398
+ * Deliberately far above anything the AI layer itself may wait for (a summary
13399
+ * asks 180 s by default, a rule may ask 600 s), because the TRANSPORT must
13400
+ * never be the layer that gives up first: when it does, the failure is
13401
+ * reported as a transport error for a model that was still thinking, naming
13402
+ * the wrong layer and hiding the real one.
13403
+ *
13404
+ * Measured 2026-09-03: a 6-image vision request needs 44.8 s warm and ~20 s
13405
+ * more on a cold model load. With no declaration every digest failed at
13406
+ * exactly 60 s and shipped without its text.
13407
+ *
13408
+ * A ceiling, not a budget. The AI layer's own timeouts (the rule's `timeoutMs`,
13409
+ * the profile's `timeoutMs` / `firstTokenTimeoutMs`) remain the things that
13410
+ * decide when to stop, because only they can say WHY.
13411
+ */
13412
+ var AI_CAP_TRANSPORT_TIMEOUT_MS = 6e5;
13413
+ /** A multi-gigabyte download. An hour is not generous, it is honest. */
13414
+ var AI_MODEL_INSTALL_TIMEOUT_MS = 60 * 6e4;
13415
+ /**
13387
13416
  * Shared LLM generate contracts — imported by BOTH `llm.cap.ts` (consumer
13388
13417
  * surface) and `llm-runtime.cap.ts` (node-side managed executor) so the two
13389
13418
  * caps stay wire-compatible without a circular cap→cap import.
@@ -13655,16 +13684,19 @@ method(LlmGenerateBaseInputSchema.extend({
13655
13684
  timeoutMs: number().int().positive().optional()
13656
13685
  }), LlmGenerateResultSchema, {
13657
13686
  kind: "mutation",
13658
- auth: "admin"
13687
+ auth: "admin",
13688
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13659
13689
  }), method(object({ runtime: ManagedRuntimeConfigSchema }), LlmRuntimeStatusSchema, {
13660
13690
  kind: "mutation",
13661
- auth: "admin"
13691
+ auth: "admin",
13692
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13662
13693
  }), method(object({}), _void(), {
13663
13694
  kind: "mutation",
13664
13695
  auth: "admin"
13665
13696
  }), method(object({}), LlmRuntimeStatusSchema, { auth: "admin" }), method(object({ model: ManagedModelRefSchema }), _void(), {
13666
13697
  kind: "mutation",
13667
- auth: "admin"
13698
+ auth: "admin",
13699
+ timeoutMs: AI_MODEL_INSTALL_TIMEOUT_MS
13668
13700
  }), method(object({ file: string() }), _void(), {
13669
13701
  kind: "mutation",
13670
13702
  auth: "admin"
@@ -13832,7 +13864,13 @@ var ProfileRefInputSchema = object({
13832
13864
  addonId: string(),
13833
13865
  profileId: string()
13834
13866
  });
13835
- method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }), method(GenerateVisionInputSchema, LlmGenerateResultSchema, { kind: "mutation" }), method(object({
13867
+ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, {
13868
+ kind: "mutation",
13869
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13870
+ }), method(GenerateVisionInputSchema, LlmGenerateResultSchema, {
13871
+ kind: "mutation",
13872
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13873
+ }), method(object({
13836
13874
  addonId: string().optional(),
13837
13875
  requestId: string()
13838
13876
  }), _void(), { kind: "mutation" }), method(object({}), array(LlmProfileKindDescriptorSchema)), method(object({}), array(LlmProfileSchema)), method(object({ profile: LlmProfileSchema }), LlmProfileSchema, {
@@ -13843,7 +13881,8 @@ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }
13843
13881
  auth: "admin"
13844
13882
  }), method(ProfileRefInputSchema, LlmGenerateResultSchema, {
13845
13883
  kind: "mutation",
13846
- auth: "admin"
13884
+ auth: "admin",
13885
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13847
13886
  }), method(ProfileRefInputSchema, array(string())), method(object({}), array(LlmDefaultSchema)), method(object({
13848
13887
  selector: LlmDefaultSelectorSchema,
13849
13888
  profileId: string().nullable()
@@ -14309,17 +14348,6 @@ var ContainerMemoryPointSchema = object({
14309
14348
  */
14310
14349
  gpuShmemBytes: number().nullable()
14311
14350
  }).extend({ atMs: number() });
14312
- var DumpHeapSnapshotInputSchema = object({
14313
- /** The addon whose runner should dump a heap snapshot. */
14314
- addonId: string() });
14315
- var DumpHeapSnapshotResultSchema = object({
14316
- success: boolean(),
14317
- /** Path of the written .heapsnapshot inside the runner's container/host. */
14318
- path: string().optional(),
14319
- /** Process pid that was signalled. */
14320
- pid: number().optional(),
14321
- reason: string().optional()
14322
- });
14323
14351
  /**
14324
14352
  * One point of one function's series.
14325
14353
  *
@@ -14443,10 +14471,7 @@ var SystemMetricsSchema = object({
14443
14471
  gpuPercent: number().optional(),
14444
14472
  gpuMemoryPercent: number().optional()
14445
14473
  });
14446
- method(_void(), SystemResourceSnapshotSchema), method(_void(), SystemResourceSnapshotSchema.nullable()), method(_void(), SystemMetricsSchema), method(object({ dirPath: string() }), DiskSpaceInfoSchema), method(_void(), MetricsGpuInfoSchema.nullable()), method(_void(), number().nullable()), method(object({ pids: array(number()) }), array(PidResourceStatsSchema)), method(_void(), array(AddonInstanceSchema).readonly()), method(object({ addonId: string() }), PidResourceStatsSchema.nullable()), method(_void(), array(NodeProcessSchema).readonly()), method(GetLoadSeriesInputSchema, NodeLoadSeriesSchema), method(DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, {
14447
- kind: "mutation",
14448
- auth: "admin"
14449
- });
14474
+ method(_void(), SystemResourceSnapshotSchema), method(_void(), SystemResourceSnapshotSchema.nullable()), method(_void(), SystemMetricsSchema), method(object({ dirPath: string() }), DiskSpaceInfoSchema), method(_void(), MetricsGpuInfoSchema.nullable()), method(_void(), number().nullable()), method(object({ pids: array(number()) }), array(PidResourceStatsSchema)), method(_void(), array(AddonInstanceSchema).readonly()), method(object({ addonId: string() }), PidResourceStatsSchema.nullable()), method(_void(), array(NodeProcessSchema).readonly()), method(GetLoadSeriesInputSchema, NodeLoadSeriesSchema);
14450
14475
  method(object({
14451
14476
  sourceUrl: string(),
14452
14477
  metadata: ModelConvertMetadataSchema,
@@ -18680,7 +18705,8 @@ var MediaFileKindEnum = _enum([
18680
18705
  "plateCrop",
18681
18706
  "keyFrame",
18682
18707
  "keyFrameSmall",
18683
- "thumbnailSmall"
18708
+ "thumbnailSmall",
18709
+ "sceneFrame"
18684
18710
  ]);
18685
18711
  /**
18686
18712
  * One media row ON THE WIRE: what it is, how big it is, and WHERE ITS BYTES
@@ -31498,12 +31524,6 @@ Object.freeze({
31498
31524
  addonId: null,
31499
31525
  access: "view"
31500
31526
  },
31501
- "metricsProvider.dumpHeapSnapshot": {
31502
- capName: "metrics-provider",
31503
- capScope: "system",
31504
- addonId: null,
31505
- access: "create"
31506
- },
31507
31527
  "metricsProvider.getAddonStats": {
31508
31528
  capName: "metrics-provider",
31509
31529
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-decoder-ffmpeg",
3
- "version": "1.2.53",
3
+ "version": "1.2.56",
4
4
  "description": "Standalone ffmpeg-subprocess decoder fallback addon for CamStack",
5
5
  "keywords": [
6
6
  "camstack",