@camstack/addon-export-google 0.1.17 → 0.1.20

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.
@@ -13523,6 +13523,35 @@ method(_void(), array(string()).readonly(), { auth: "admin" }), method(object({
13523
13523
  auth: "admin"
13524
13524
  });
13525
13525
  /**
13526
+ * Transport bounds for AI capability methods.
13527
+ *
13528
+ * Its own module because `llm.cap.ts` and `llm-runtime.cap.ts` already import
13529
+ * each other: declaring the constant in either one hands the other `undefined`
13530
+ * at module-init time, and an undefined `timeoutMs` silently falls back to the
13531
+ * kernel's 60 s default — the exact failure this constant exists to prevent,
13532
+ * reintroduced invisibly. Found by the guard, not by review.
13533
+ */
13534
+ /**
13535
+ * Ceiling for a cap method that runs inference or loads a model.
13536
+ *
13537
+ * Deliberately far above anything the AI layer itself may wait for (a summary
13538
+ * asks 180 s by default, a rule may ask 600 s), because the TRANSPORT must
13539
+ * never be the layer that gives up first: when it does, the failure is
13540
+ * reported as a transport error for a model that was still thinking, naming
13541
+ * the wrong layer and hiding the real one.
13542
+ *
13543
+ * Measured 2026-09-03: a 6-image vision request needs 44.8 s warm and ~20 s
13544
+ * more on a cold model load. With no declaration every digest failed at
13545
+ * exactly 60 s and shipped without its text.
13546
+ *
13547
+ * A ceiling, not a budget. The AI layer's own timeouts (the rule's `timeoutMs`,
13548
+ * the profile's `timeoutMs` / `firstTokenTimeoutMs`) remain the things that
13549
+ * decide when to stop, because only they can say WHY.
13550
+ */
13551
+ var AI_CAP_TRANSPORT_TIMEOUT_MS = 6e5;
13552
+ /** A multi-gigabyte download. An hour is not generous, it is honest. */
13553
+ var AI_MODEL_INSTALL_TIMEOUT_MS = 60 * 6e4;
13554
+ /**
13526
13555
  * Shared LLM generate contracts — imported by BOTH `llm.cap.ts` (consumer
13527
13556
  * surface) and `llm-runtime.cap.ts` (node-side managed executor) so the two
13528
13557
  * caps stay wire-compatible without a circular cap→cap import.
@@ -13794,16 +13823,19 @@ method(LlmGenerateBaseInputSchema.extend({
13794
13823
  timeoutMs: number().int().positive().optional()
13795
13824
  }), LlmGenerateResultSchema, {
13796
13825
  kind: "mutation",
13797
- auth: "admin"
13826
+ auth: "admin",
13827
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13798
13828
  }), method(object({ runtime: ManagedRuntimeConfigSchema }), LlmRuntimeStatusSchema, {
13799
13829
  kind: "mutation",
13800
- auth: "admin"
13830
+ auth: "admin",
13831
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13801
13832
  }), method(object({}), _void(), {
13802
13833
  kind: "mutation",
13803
13834
  auth: "admin"
13804
13835
  }), method(object({}), LlmRuntimeStatusSchema, { auth: "admin" }), method(object({ model: ManagedModelRefSchema }), _void(), {
13805
13836
  kind: "mutation",
13806
- auth: "admin"
13837
+ auth: "admin",
13838
+ timeoutMs: AI_MODEL_INSTALL_TIMEOUT_MS
13807
13839
  }), method(object({ file: string() }), _void(), {
13808
13840
  kind: "mutation",
13809
13841
  auth: "admin"
@@ -13971,7 +14003,13 @@ var ProfileRefInputSchema = object({
13971
14003
  addonId: string(),
13972
14004
  profileId: string()
13973
14005
  });
13974
- method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }), method(GenerateVisionInputSchema, LlmGenerateResultSchema, { kind: "mutation" }), method(object({
14006
+ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, {
14007
+ kind: "mutation",
14008
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
14009
+ }), method(GenerateVisionInputSchema, LlmGenerateResultSchema, {
14010
+ kind: "mutation",
14011
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
14012
+ }), method(object({
13975
14013
  addonId: string().optional(),
13976
14014
  requestId: string()
13977
14015
  }), _void(), { kind: "mutation" }), method(object({}), array(LlmProfileKindDescriptorSchema)), method(object({}), array(LlmProfileSchema)), method(object({ profile: LlmProfileSchema }), LlmProfileSchema, {
@@ -13982,7 +14020,8 @@ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }
13982
14020
  auth: "admin"
13983
14021
  }), method(ProfileRefInputSchema, LlmGenerateResultSchema, {
13984
14022
  kind: "mutation",
13985
- auth: "admin"
14023
+ auth: "admin",
14024
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13986
14025
  }), method(ProfileRefInputSchema, array(string())), method(object({}), array(LlmDefaultSchema)), method(object({
13987
14026
  selector: LlmDefaultSelectorSchema,
13988
14027
  profileId: string().nullable()
@@ -14448,17 +14487,6 @@ var ContainerMemoryPointSchema = object({
14448
14487
  */
14449
14488
  gpuShmemBytes: number().nullable()
14450
14489
  }).extend({ atMs: number() });
14451
- var DumpHeapSnapshotInputSchema = object({
14452
- /** The addon whose runner should dump a heap snapshot. */
14453
- addonId: string() });
14454
- var DumpHeapSnapshotResultSchema = object({
14455
- success: boolean(),
14456
- /** Path of the written .heapsnapshot inside the runner's container/host. */
14457
- path: string().optional(),
14458
- /** Process pid that was signalled. */
14459
- pid: number().optional(),
14460
- reason: string().optional()
14461
- });
14462
14490
  /**
14463
14491
  * One point of one function's series.
14464
14492
  *
@@ -14582,10 +14610,7 @@ var SystemMetricsSchema = object({
14582
14610
  gpuPercent: number().optional(),
14583
14611
  gpuMemoryPercent: number().optional()
14584
14612
  });
14585
- 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, {
14586
- kind: "mutation",
14587
- auth: "admin"
14588
- });
14613
+ 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);
14589
14614
  method(object({
14590
14615
  sourceUrl: string(),
14591
14616
  metadata: ModelConvertMetadataSchema,
@@ -18835,7 +18860,8 @@ var MediaFileKindEnum = _enum([
18835
18860
  "plateCrop",
18836
18861
  "keyFrame",
18837
18862
  "keyFrameSmall",
18838
- "thumbnailSmall"
18863
+ "thumbnailSmall",
18864
+ "sceneFrame"
18839
18865
  ]);
18840
18866
  /**
18841
18867
  * One media row ON THE WIRE: what it is, how big it is, and WHERE ITS BYTES
@@ -31672,12 +31698,6 @@ Object.freeze({
31672
31698
  addonId: null,
31673
31699
  access: "view"
31674
31700
  },
31675
- "metricsProvider.dumpHeapSnapshot": {
31676
- capName: "metrics-provider",
31677
- capScope: "system",
31678
- addonId: null,
31679
- access: "create"
31680
- },
31681
31701
  "metricsProvider.getAddonStats": {
31682
31702
  capName: "metrics-provider",
31683
31703
  capScope: "system",
@@ -13519,6 +13519,35 @@ method(_void(), array(string()).readonly(), { auth: "admin" }), method(object({
13519
13519
  auth: "admin"
13520
13520
  });
13521
13521
  /**
13522
+ * Transport bounds for AI capability methods.
13523
+ *
13524
+ * Its own module because `llm.cap.ts` and `llm-runtime.cap.ts` already import
13525
+ * each other: declaring the constant in either one hands the other `undefined`
13526
+ * at module-init time, and an undefined `timeoutMs` silently falls back to the
13527
+ * kernel's 60 s default — the exact failure this constant exists to prevent,
13528
+ * reintroduced invisibly. Found by the guard, not by review.
13529
+ */
13530
+ /**
13531
+ * Ceiling for a cap method that runs inference or loads a model.
13532
+ *
13533
+ * Deliberately far above anything the AI layer itself may wait for (a summary
13534
+ * asks 180 s by default, a rule may ask 600 s), because the TRANSPORT must
13535
+ * never be the layer that gives up first: when it does, the failure is
13536
+ * reported as a transport error for a model that was still thinking, naming
13537
+ * the wrong layer and hiding the real one.
13538
+ *
13539
+ * Measured 2026-09-03: a 6-image vision request needs 44.8 s warm and ~20 s
13540
+ * more on a cold model load. With no declaration every digest failed at
13541
+ * exactly 60 s and shipped without its text.
13542
+ *
13543
+ * A ceiling, not a budget. The AI layer's own timeouts (the rule's `timeoutMs`,
13544
+ * the profile's `timeoutMs` / `firstTokenTimeoutMs`) remain the things that
13545
+ * decide when to stop, because only they can say WHY.
13546
+ */
13547
+ var AI_CAP_TRANSPORT_TIMEOUT_MS = 6e5;
13548
+ /** A multi-gigabyte download. An hour is not generous, it is honest. */
13549
+ var AI_MODEL_INSTALL_TIMEOUT_MS = 60 * 6e4;
13550
+ /**
13522
13551
  * Shared LLM generate contracts — imported by BOTH `llm.cap.ts` (consumer
13523
13552
  * surface) and `llm-runtime.cap.ts` (node-side managed executor) so the two
13524
13553
  * caps stay wire-compatible without a circular cap→cap import.
@@ -13790,16 +13819,19 @@ method(LlmGenerateBaseInputSchema.extend({
13790
13819
  timeoutMs: number().int().positive().optional()
13791
13820
  }), LlmGenerateResultSchema, {
13792
13821
  kind: "mutation",
13793
- auth: "admin"
13822
+ auth: "admin",
13823
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13794
13824
  }), method(object({ runtime: ManagedRuntimeConfigSchema }), LlmRuntimeStatusSchema, {
13795
13825
  kind: "mutation",
13796
- auth: "admin"
13826
+ auth: "admin",
13827
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13797
13828
  }), method(object({}), _void(), {
13798
13829
  kind: "mutation",
13799
13830
  auth: "admin"
13800
13831
  }), method(object({}), LlmRuntimeStatusSchema, { auth: "admin" }), method(object({ model: ManagedModelRefSchema }), _void(), {
13801
13832
  kind: "mutation",
13802
- auth: "admin"
13833
+ auth: "admin",
13834
+ timeoutMs: AI_MODEL_INSTALL_TIMEOUT_MS
13803
13835
  }), method(object({ file: string() }), _void(), {
13804
13836
  kind: "mutation",
13805
13837
  auth: "admin"
@@ -13967,7 +13999,13 @@ var ProfileRefInputSchema = object({
13967
13999
  addonId: string(),
13968
14000
  profileId: string()
13969
14001
  });
13970
- method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }), method(GenerateVisionInputSchema, LlmGenerateResultSchema, { kind: "mutation" }), method(object({
14002
+ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, {
14003
+ kind: "mutation",
14004
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
14005
+ }), method(GenerateVisionInputSchema, LlmGenerateResultSchema, {
14006
+ kind: "mutation",
14007
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
14008
+ }), method(object({
13971
14009
  addonId: string().optional(),
13972
14010
  requestId: string()
13973
14011
  }), _void(), { kind: "mutation" }), method(object({}), array(LlmProfileKindDescriptorSchema)), method(object({}), array(LlmProfileSchema)), method(object({ profile: LlmProfileSchema }), LlmProfileSchema, {
@@ -13978,7 +14016,8 @@ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, { kind: "mutation" }
13978
14016
  auth: "admin"
13979
14017
  }), method(ProfileRefInputSchema, LlmGenerateResultSchema, {
13980
14018
  kind: "mutation",
13981
- auth: "admin"
14019
+ auth: "admin",
14020
+ timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
13982
14021
  }), method(ProfileRefInputSchema, array(string())), method(object({}), array(LlmDefaultSchema)), method(object({
13983
14022
  selector: LlmDefaultSelectorSchema,
13984
14023
  profileId: string().nullable()
@@ -14444,17 +14483,6 @@ var ContainerMemoryPointSchema = object({
14444
14483
  */
14445
14484
  gpuShmemBytes: number().nullable()
14446
14485
  }).extend({ atMs: number() });
14447
- var DumpHeapSnapshotInputSchema = object({
14448
- /** The addon whose runner should dump a heap snapshot. */
14449
- addonId: string() });
14450
- var DumpHeapSnapshotResultSchema = object({
14451
- success: boolean(),
14452
- /** Path of the written .heapsnapshot inside the runner's container/host. */
14453
- path: string().optional(),
14454
- /** Process pid that was signalled. */
14455
- pid: number().optional(),
14456
- reason: string().optional()
14457
- });
14458
14486
  /**
14459
14487
  * One point of one function's series.
14460
14488
  *
@@ -14578,10 +14606,7 @@ var SystemMetricsSchema = object({
14578
14606
  gpuPercent: number().optional(),
14579
14607
  gpuMemoryPercent: number().optional()
14580
14608
  });
14581
- 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, {
14582
- kind: "mutation",
14583
- auth: "admin"
14584
- });
14609
+ 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);
14585
14610
  method(object({
14586
14611
  sourceUrl: string(),
14587
14612
  metadata: ModelConvertMetadataSchema,
@@ -18831,7 +18856,8 @@ var MediaFileKindEnum = _enum([
18831
18856
  "plateCrop",
18832
18857
  "keyFrame",
18833
18858
  "keyFrameSmall",
18834
- "thumbnailSmall"
18859
+ "thumbnailSmall",
18860
+ "sceneFrame"
18835
18861
  ]);
18836
18862
  /**
18837
18863
  * One media row ON THE WIRE: what it is, how big it is, and WHERE ITS BYTES
@@ -31668,12 +31694,6 @@ Object.freeze({
31668
31694
  addonId: null,
31669
31695
  access: "view"
31670
31696
  },
31671
- "metricsProvider.dumpHeapSnapshot": {
31672
- capName: "metrics-provider",
31673
- capScope: "system",
31674
- addonId: null,
31675
- access: "create"
31676
- },
31677
31697
  "metricsProvider.getAddonStats": {
31678
31698
  capName: "metrics-provider",
31679
31699
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-export-google",
3
- "version": "0.1.17",
3
+ "version": "0.1.20",
4
4
  "description": "Google Home export — hub-side smart-home fulfillment (SYNC / QUERY / EXECUTE / DISCONNECT) for the non-camera fleet, served over the hub's own OAuth account link. No Google credential is stored, sent or required.",
5
5
  "keywords": [
6
6
  "camstack",