@camstack/addon-export-hap 1.2.162 → 1.2.164

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.
@@ -5464,7 +5464,7 @@ var ZodIssueCode = {
5464
5464
  var ZodFirstPartyTypeKind;
5465
5465
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5466
5466
  //#endregion
5467
- //#region ../types/dist/sleep-BxjU_fJM.mjs
5467
+ //#region ../types/dist/sleep-BSuCCFjf.mjs
5468
5468
  /**
5469
5469
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5470
5470
  * window to float samples (D455).
@@ -7847,9 +7847,9 @@ function normalizeAddonInitResult(result) {
7847
7847
  return result;
7848
7848
  }
7849
7849
  /**
7850
- * The share-view scope kinds a `csv_*` share token can carry. The hub mints
7851
- * and validates them (`share-token.service.ts` builds its enum from this
7852
- * list); a data plane names the kinds it ACCEPTS in `share`.
7850
+ * The share-view scope kinds a share-link token can carry. The hub mints
7851
+ * and validates them (`ShareViewGrantSchema` builds its
7852
+ * enum from this list); a data plane names the kinds it ACCEPTS in `share`.
7853
7853
  */
7854
7854
  var SHARE_VIEW_KINDS = ["grid-view", "events-view"];
7855
7855
  /** The wire shape of {@link PeerBytesTicket} — see the type for what it is. */
@@ -13346,7 +13346,7 @@ var ConvertResultSchema = object({
13346
13346
  * `super_admin` — collapsed onto the single boolean because every
13347
13347
  * non-admin caller is governed by the same scope-check rules; the
13348
13348
  * distinction was only ever used to route role-specific procedures
13349
- * which we no longer have. CLI / webhook integrations are `cst_*` tokens
13349
+ * which we no longer have. CLI / webhook integrations are tokens (`auth.mintToken`)
13350
13350
  * with `isAdmin: false` + an explicit scope list.
13351
13351
  */
13352
13352
  /** Per-method access flavour. Materialised on every cap method via codegen. */
@@ -13535,10 +13535,12 @@ var AddonRoutesScopeSchema = object({
13535
13535
  type: literal("addon-routes"),
13536
13536
  access: array(MethodAccessSchema).min(1)
13537
13537
  });
13538
+ var PreferencesSelfScopeSchema = object({ type: literal("preferences-self") });
13538
13539
  var CredentialScopeSchema = union([
13539
13540
  literal("*"),
13540
13541
  ShareViewScopeSchema,
13541
13542
  AddonRoutesScopeSchema,
13543
+ PreferencesSelfScopeSchema,
13542
13544
  TokenScopeSchema
13543
13545
  ]);
13544
13546
  object({
@@ -13547,6 +13549,55 @@ object({
13547
13549
  jti: string().min(16),
13548
13550
  scopes: array(CredentialScopeSchema).min(1)
13549
13551
  });
13552
+ var PreferenceNamespaceSchema = string().regex(/^[a-z][a-z0-9.-]{0,63}$/);
13553
+ /** A namespace's value: a JSON object, opaque to the hub. */
13554
+ var PreferenceValueSchema = record(string(), unknown());
13555
+ var PreferenceDeviceIdSchema = string().min(1).max(64);
13556
+ /** A stored row, as the owner reads it. */
13557
+ var PreferenceRowSchema = object({
13558
+ namespace: PreferenceNamespaceSchema,
13559
+ value: PreferenceValueSchema,
13560
+ /** Starts at 1, +1 on every write of this namespace. A delete ends the row and its count. */
13561
+ revision: number().int().positive(),
13562
+ updatedAt: number().int(),
13563
+ /** The client id the last writer sent; `null` when it sent none. */
13564
+ updatedByDevice: PreferenceDeviceIdSchema.nullable()
13565
+ });
13566
+ object({
13567
+ /** Absent: every namespace the caller holds. */
13568
+ namespaces: array(PreferenceNamespaceSchema).max(32).optional() });
13569
+ object({ rows: array(PreferenceRowSchema) });
13570
+ object({
13571
+ namespace: PreferenceNamespaceSchema,
13572
+ value: PreferenceValueSchema,
13573
+ /**
13574
+ * The revision the edit was based on. Absent: last write wins. `0`: the
13575
+ * namespace must not exist yet. Any other value that is not the current
13576
+ * revision answers `conflict` and writes nothing.
13577
+ */
13578
+ baseRevision: number().int().nonnegative().optional(),
13579
+ deviceId: PreferenceDeviceIdSchema.optional()
13580
+ });
13581
+ discriminatedUnion("status", [object({
13582
+ status: literal("saved"),
13583
+ row: PreferenceRowSchema
13584
+ }), object({
13585
+ status: literal("conflict"),
13586
+ current: PreferenceRowSchema.nullable()
13587
+ })]);
13588
+ object({ namespace: PreferenceNamespaceSchema });
13589
+ object({
13590
+ /** `false` when the namespace did not exist. */
13591
+ deleted: boolean() });
13592
+ object({
13593
+ /** The revision the client holds per namespace; a namespace it does not list is new to it. */
13594
+ revisionByNamespace: record(PreferenceNamespaceSchema, number().int().nonnegative()).refine((map) => Object.keys(map).length <= 32, { message: `at most 32 namespaces` }) });
13595
+ object({
13596
+ /** Every row whose revision differs from the client's, and every row it did not list. */
13597
+ rows: array(PreferenceRowSchema),
13598
+ /** Namespaces the client listed that no longer exist. */
13599
+ deleted: array(PreferenceNamespaceSchema)
13600
+ });
13550
13601
  _enum(["new-session", "step-up"]);
13551
13602
  /** The languages the hub's app landing pages are written in (D858). */
13552
13603
  var AppPageLangSchema = _enum(["en", "it"]);
@@ -17694,7 +17745,19 @@ var DeviceHistorySubjectSchema = discriminatedUnion("kind", [object({
17694
17745
  kind: literal("node"),
17695
17746
  nodeId: string().min(1)
17696
17747
  })]);
17748
+ /**
17749
+ * `enum` stores a STATE as the ordinal of its value in the series' value list
17750
+ * (`DeviceHistorySeriesInfo.values`, append-only, so an ordinal never changes
17751
+ * meaning); a rollup keeps the time spent in each state (`states`).
17752
+ */
17697
17753
  var DeviceHistoryKindSchema = _enum([
17754
+ "gauge",
17755
+ "counter",
17756
+ "boolean",
17757
+ "enum"
17758
+ ]);
17759
+ /** What a PRODUCER may declare. `enum` is cap-only: its value list is the cap field's. */
17760
+ var DeviceHistoryProducerKindSchema = _enum([
17698
17761
  "gauge",
17699
17762
  "counter",
17700
17763
  "boolean"
@@ -17731,7 +17794,13 @@ var SeriesInfoSchema = object({
17731
17794
  /** `null` is unknown (a `unitFrom` series whose device does not state a unit right now), never a guess. */
17732
17795
  unit: string().nullable(),
17733
17796
  displayName: string(),
17734
- source: _enum(["cap", "addon"]),
17797
+ source: _enum([
17798
+ "cap",
17799
+ "addon",
17800
+ "derived"
17801
+ ]),
17802
+ /** `enum`: the value of each ordinal (index = ordinal); `null` for every other kind. */
17803
+ values: array(string()).readonly().nullable(),
17735
17804
  firstTs: number(),
17736
17805
  lastTs: number()
17737
17806
  });
@@ -17745,17 +17814,31 @@ var QueryPointSchema = object({
17745
17814
  twMean: number().nullable(),
17746
17815
  min: number(),
17747
17816
  max: number(),
17748
- /** `null` is unknown, never zero (D393). */
17749
- last: number().nullable()
17817
+ /** `null` is unknown, never zero (D393). For an `enum` series: the ordinal of {@link state}. */
17818
+ last: number().nullable(),
17819
+ /**
17820
+ * The increase over the point: a `counter`'s growth since the previous point
17821
+ * or bucket (a drop is a reset, counted from zero), and for
17822
+ * {@link DEVICE_HISTORY_ENERGY_KEY} the kWh used in the bucket. `null` for
17823
+ * every other kind, and when it cannot be known.
17824
+ */
17825
+ delta: number().nullable(),
17826
+ /** `enum`: the state in force at the end of the point (the name of `last`); `null` otherwise. */
17827
+ state: string().nullable(),
17828
+ /** `enum` rollup: milliseconds spent in each state inside the bucket; `null` for raw points and other kinds. */
17829
+ states: record(string(), number()).nullable()
17750
17830
  });
17751
17831
  var QuerySeriesSchema = object({
17752
17832
  scope: string(),
17753
17833
  /** The last point STRICTLY BEFORE `from` in the chosen tier, so a step chart can start at the held value. */
17754
17834
  before: object({
17755
17835
  t: number(),
17756
- value: number().nullable()
17836
+ value: number().nullable(),
17837
+ state: string().nullable()
17757
17838
  }).nullable(),
17758
- points: array(QueryPointSchema).readonly()
17839
+ points: array(QueryPointSchema).readonly(),
17840
+ /** A derived key: the stored key its points were computed from; `null` for a stored series. */
17841
+ derivedFrom: string().nullable()
17759
17842
  });
17760
17843
  /** The window part of a query, shared by the device and node forms. */
17761
17844
  var QueryWindowShape = {
@@ -17771,6 +17854,23 @@ var QueryResultSchema = object({
17771
17854
  series: array(QuerySeriesSchema).readonly(),
17772
17855
  truncated: boolean()
17773
17856
  });
17857
+ /** One read of a batch: a device's key or a node's key (exactly one subject). */
17858
+ var QueryManyItemSchema = union([object({
17859
+ deviceId: number().int(),
17860
+ key: string(),
17861
+ scope: string().optional()
17862
+ }), object({
17863
+ forNodeId: string().min(1),
17864
+ key: string(),
17865
+ scope: string().optional()
17866
+ })]);
17867
+ var QueryManyEntrySchema = discriminatedUnion("ok", [object({
17868
+ ok: literal(true),
17869
+ result: QueryResultSchema
17870
+ }), object({
17871
+ ok: literal(false),
17872
+ error: string()
17873
+ })]);
17774
17874
  var TierStatusSchema = object({
17775
17875
  tier: DeviceHistoryResolutionSchema,
17776
17876
  /** `null` until the first background count answered. */
@@ -17826,16 +17926,22 @@ var DeviceHistoryStatusSchema = object({
17826
17926
  lastRefreshAt: number().nullable()
17827
17927
  })
17828
17928
  });
17829
- method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly()), method(object({ nodeId: string().min(1) }), array(SeriesInfoSchema).readonly(), { auth: "admin" }), method(object({
17929
+ method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly()), method(object({ forNodeId: string().min(1) }), array(SeriesInfoSchema).readonly(), { auth: "admin" }), method(object({
17830
17930
  deviceId: number().int(),
17831
17931
  ...QueryWindowShape
17832
17932
  }), QueryResultSchema), method(object({
17833
- nodeId: string().min(1),
17933
+ forNodeId: string().min(1),
17834
17934
  ...QueryWindowShape
17835
17935
  }), QueryResultSchema, { auth: "admin" }), method(object({
17936
+ items: array(QueryManyItemSchema).min(1).max(24),
17937
+ from: QueryWindowShape.from,
17938
+ to: QueryWindowShape.to,
17939
+ resolution: QueryWindowShape.resolution,
17940
+ maxPoints: QueryWindowShape.maxPoints
17941
+ }), object({ results: array(QueryManyEntrySchema).readonly() }), { auth: "admin" }), method(object({
17836
17942
  name: string().regex(/^[a-z0-9-]+$/),
17837
17943
  subjectKind: _enum(["device", "node"]),
17838
- kind: DeviceHistoryKindSchema,
17944
+ kind: DeviceHistoryProducerKindSchema,
17839
17945
  unit: string().optional(),
17840
17946
  displayName: string().min(1),
17841
17947
  ingest: _enum(["points", "buckets"])
@@ -40506,38 +40612,37 @@ method(LlmRuntimeCompleteInputSchema, LlmGenerateResultSchema, {
40506
40612
  auth: "admin",
40507
40613
  timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
40508
40614
  });
40615
+ var LlmProfileKindSchema = string().regex(/^[a-z0-9][a-z0-9-]{0,63}$/, "a kind id is lower-case letters, digits and dashes");
40616
+ /** What a model (or, by default, every model of a kind) can do. */
40617
+ var LlmModelFeaturesSchema = object({
40618
+ vision: boolean(),
40619
+ tools: boolean(),
40620
+ streaming: boolean()
40621
+ });
40622
+ /** One model a provider offers. `features` overrides the kind's defaults, per field. */
40623
+ var LlmModelInfoSchema = object({
40624
+ id: string(),
40625
+ label: string().optional(),
40626
+ contextLength: number().int().positive().optional(),
40627
+ features: LlmModelFeaturesSchema.partial().optional()
40628
+ });
40509
40629
  /**
40510
- * `llm` — consumer-facing LLM surface (spec §1-§3). Collection-mode: array
40511
- * methods concat-fan across providers; single-row methods route to ONE
40512
- * provider by the `addonId` in the call input (the notification-output
40513
- * posture, notification-output.cap.ts:215-250). Provided by `addon-ai`
40514
- * (hub-placed); the cap stays open for future providers.
40515
- *
40516
- * Profiles are ROWS (data), not addons: one row = one usable model endpoint.
40517
- * `apiKey` is a password field — providers REDACT it on read and merge on
40518
- * write; a stored key NEVER round-trips to a client.
40630
+ * The provider-specific part of a profile, validated by the provider that owns
40631
+ * the kind (`upsertProfile` refuses what it does not accept). A field its
40632
+ * `connectionSchema` declares `type: 'password'` is a secret: it is held in the
40633
+ * keychain, never in the row, and reads back as the redaction marker.
40519
40634
  */
40520
- var LlmProfileKindSchema = _enum([
40521
- "openai-compatible",
40522
- "openai",
40523
- "anthropic",
40524
- "google",
40525
- "managed-local",
40526
- "apple-foundation"
40527
- ]);
40635
+ var LlmProviderConfigSchema = record(string(), unknown());
40528
40636
  var LlmProfileSchema = object({
40529
40637
  id: string(),
40530
40638
  name: string(),
40639
+ /** The provider-declared kind (`LlmProfileKindDescriptor.kind`). */
40531
40640
  kind: LlmProfileKindSchema,
40532
40641
  /** Stamped by the provider — keeps the fanned catalog routable. */
40533
40642
  addonId: string(),
40534
40643
  enabled: boolean(),
40535
40644
  /** Vendor model id, or the managed runtime's loaded model. */
40536
40645
  model: string(),
40537
- /** Required for openai-compatible; override for cloud kinds. */
40538
- baseUrl: string().optional(),
40539
- /** ConfigUISchema type:'password' — never round-trips (spec §5). */
40540
- apiKey: string().optional(),
40541
40646
  /** Vision on/off. A vision call against a `false` profile is REFUSED, never
40542
40647
  * degraded to text — that shipped once and produced a confident answer to a
40543
40648
  * question about a picture nobody sent. */
@@ -40545,15 +40650,11 @@ var LlmProfileSchema = object({
40545
40650
  temperature: number().min(0).max(2).optional(),
40546
40651
  /** Nucleus sampling. Every wire we speak has it. */
40547
40652
  topP: number().min(0).max(1).optional(),
40548
- /** Top-k sampling. Carried only by the wires that have it — NEITHER OpenAI
40549
- * wire does, and the client drops it there (measured: the request body gets
40550
- * `top_p` and no `top_k`). The profile editor hides the field wherever it
40551
- * would change nothing; `KINDS_WITH_TOP_K` is the single owner of that list. */
40653
+ /** Top-k sampling. Carried only by the wires that have it — a kind offers the
40654
+ * field in its editor only when its descriptor lists it in `profileFields`. */
40552
40655
  topK: number().int().positive().optional(),
40553
40656
  maxTokens: number().int().positive().optional(),
40554
- /** Prompt context window. Advisory for cloud kinds (they enforce their own);
40555
- * for `managed-local` it is the llama.cpp `--ctx-size` the runtime starts
40556
- * the model with, so it is the one field that changes a PROCESS. */
40657
+ /** Prompt context window. Advisory for cloud kinds (they enforce their own). */
40557
40658
  contextLength: number().int().positive().optional(),
40558
40659
  /** Default system prompt. A caller's `system` REPLACES it (never appends —
40559
40660
  * two system prompts fighting is worse than either alone). */
@@ -40579,16 +40680,37 @@ var LlmProfileSchema = object({
40579
40680
  * library; the REGISTRY of callable tools is ours and is empty in v1, so a
40580
40681
  * `true` here buys the wiring, not behaviour, until tools are registered. */
40581
40682
  toolsEnabled: boolean().default(false),
40582
- extraHeaders: record(string(), string()).optional(),
40583
- /** kind === 'managed-local' only (spec §4). */
40584
- runtime: ManagedRuntimeConfigSchema.optional(),
40585
- /**
40586
- * kind === 'apple-foundation' only: WHERE it runs — the only thing there is
40587
- * to configure (no key, no URL, no download; `model` is `apple-system`).
40588
- * `supportsVision` on such a row is stamped by the provider from the node's
40589
- * reported `imageInput`, never taken from the operator (D62).
40590
- */
40591
- appleFoundation: object({ nodeId: string() }).optional()
40683
+ /** Everything the kind's provider owns (endpoint, key, node, runtime…). */
40684
+ providerConfig: LlmProviderConfigSchema.default({})
40685
+ });
40686
+ /**
40687
+ * The common profile fields a kind's editor offers. The editor owns how each
40688
+ * one is drawn; the provider says which of them mean something on its wire.
40689
+ */
40690
+ var LlmProfileFieldSchema = _enum([
40691
+ "temperature",
40692
+ "topP",
40693
+ "topK",
40694
+ "maxTokens",
40695
+ "contextLength",
40696
+ "systemPrompt",
40697
+ "timeoutMs",
40698
+ "connectTimeoutMs",
40699
+ "firstTokenTimeoutMs",
40700
+ "idleTimeoutMs",
40701
+ "retry",
40702
+ "toolsEnabled"
40703
+ ]);
40704
+ /**
40705
+ * A provider-drawn part of the editor, by a generic widget id the admin UI
40706
+ * registers (`ai/apple-node`). `placement: 'model'` replaces the generic model
40707
+ * picker: that widget owns the model choice.
40708
+ */
40709
+ var LlmProviderWidgetSchema = object({
40710
+ id: string(),
40711
+ placement: _enum(["connection", "model"]),
40712
+ /** `providerConfig` keys this widget must fill before the profile can be saved. */
40713
+ requires: array(string()).optional()
40592
40714
  });
40593
40715
  /** ConfigUISchema tree passed through untyped on the wire (the
40594
40716
  * notification-output `ConfigSchemaPassthrough` precedent at
@@ -40597,11 +40719,56 @@ var ConfigSchemaPassthrough$3 = unknown();
40597
40719
  var LlmProfileKindDescriptorSchema = object({
40598
40720
  kind: LlmProfileKindSchema,
40599
40721
  label: string(),
40722
+ /** A generic icon name (`cloud`, `plug`, `cpu`) — never a glyph or a logo. */
40600
40723
  icon: string(),
40601
40724
  /** Stamped by each provider so the concat-fanned catalog stays routable. */
40602
40725
  addonId: string(),
40603
- configSchema: ConfigSchemaPassthrough$3
40726
+ /** The provider's own fields (`providerConfig`); `password` fields are keychain-held. */
40727
+ connectionSchema: ConfigSchemaPassthrough$3,
40728
+ /** Provider fields that belong under "Advanced" (extra headers, runtime tuning). */
40729
+ advancedSchema: ConfigSchemaPassthrough$3.optional(),
40730
+ /** The kind's defaults; a model from `listModels` may override any of them. */
40731
+ features: LlmModelFeaturesSchema,
40732
+ /** `false` = the provider stamps `supportsVision` itself (from what a node reports). */
40733
+ visionEditable: boolean(),
40734
+ /** Where the model list comes from: `listModels`, `staticModels`, or nowhere. */
40735
+ modelCatalog: _enum([
40736
+ "fetch",
40737
+ "static",
40738
+ "none"
40739
+ ]),
40740
+ staticModels: array(LlmModelInfoSchema).optional(),
40741
+ /** The common fields that mean something on this kind's wire. */
40742
+ profileFields: array(LlmProfileFieldSchema),
40743
+ providerWidgets: array(LlmProviderWidgetSchema).optional()
40744
+ });
40745
+ /**
40746
+ * `listModels` input. `connection` is an UNSAVED draft of `providerConfig`
40747
+ * (the editor's form); with `profileId` too, a secret the draft leaves
40748
+ * untouched (absent or the redaction marker) is resolved server-side from the
40749
+ * stored profile — the browser never receives it.
40750
+ */
40751
+ var LlmListModelsInputSchema = object({
40752
+ addonId: string(),
40753
+ kind: LlmProfileKindSchema,
40754
+ profileId: string().optional(),
40755
+ connection: LlmProviderConfigSchema.optional()
40604
40756
  });
40757
+ var LlmListModelsErrorCodeSchema = _enum([
40758
+ "auth",
40759
+ "network",
40760
+ "unsupported",
40761
+ "invalid"
40762
+ ]);
40763
+ /** A RESULT, never a throw: "wrong key" is an answer the editor renders inline. */
40764
+ var LlmListModelsResultSchema = discriminatedUnion("ok", [object({
40765
+ ok: literal(true),
40766
+ models: array(LlmModelInfoSchema)
40767
+ }), object({
40768
+ ok: literal(false),
40769
+ code: LlmListModelsErrorCodeSchema,
40770
+ message: string()
40771
+ })]);
40605
40772
  var LlmDefaultSelectorSchema = union([object({ consumer: string() }), object({ purpose: _enum(["text", "vision"]) })]);
40606
40773
  var LlmDefaultSchema = object({
40607
40774
  selector: LlmDefaultSelectorSchema,
@@ -40701,7 +40868,10 @@ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, {
40701
40868
  kind: "mutation",
40702
40869
  auth: "admin",
40703
40870
  timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
40704
- }), method(ProfileRefInputSchema, array(string())), method(object({}), array(LlmDefaultSchema)), method(object({
40871
+ }), method(LlmListModelsInputSchema, LlmListModelsResultSchema, {
40872
+ kind: "mutation",
40873
+ auth: "admin"
40874
+ }), method(object({}), array(LlmDefaultSchema)), method(object({
40705
40875
  selector: LlmDefaultSelectorSchema,
40706
40876
  profileId: string().nullable()
40707
40877
  }), _void(), {
@@ -40869,14 +41039,106 @@ var LogEntrySchema = object({
40869
41039
  meta: record(string(), unknown()).optional(),
40870
41040
  tags: record(string(), string()).optional()
40871
41041
  });
40872
- method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
40873
- scope: array(string()).optional(),
41042
+ /**
41043
+ * A history READ against one destination (D898).
41044
+ *
41045
+ * Every filter is applied by the PROVIDER, before the limit — a filter the
41046
+ * browser applied after the limit is what made a rare device's lines
41047
+ * unreachable behind a busy one's. `before` / `after` are cursors the provider
41048
+ * minted (opaque to everyone else): a file position for the rotated files, a
41049
+ * nanosecond timestamp for Loki.
41050
+ *
41051
+ * A read is BOUNDED by `budgetMs`: a filter that matches nothing on a 30-day
41052
+ * store answers `done: false` with the cursor it reached and the bytes it
41053
+ * scanned, and the caller decides whether to go on. That is what makes a long
41054
+ * scan show progress and stop when asked — `cancelRead` ends the slice in
41055
+ * flight, and not asking for the next slice ends the scan.
41056
+ */
41057
+ var LogReadQuerySchema = object({
41058
+ /** Correlates `cancelRead`. Caller-chosen, unique per in-flight read. */
41059
+ requestId: string().min(1).max(64).optional(),
41060
+ /** The device the line is about (`tags.deviceId`, numeric). */
41061
+ deviceId: number().int().optional(),
41062
+ /**
41063
+ * The emitting addon — bare manifest id; `@<version>` / `::<sub>` suffixes
41064
+ * match. Not `addonId`: a cap router reads that name as "which provider".
41065
+ */
41066
+ fromAddonId: string().min(1).max(200).optional(),
41067
+ /**
41068
+ * The emitting node: matches the agent that emitted the line, the node
41069
+ * itself, or a worker under it (`<agent>/<runner>`) — the `agentId`
41070
+ * semantics of `matchesLogTags`. Not `nodeId`: a cap router reads that
41071
+ * name as "which node's provider".
41072
+ */
41073
+ fromNodeId: string().min(1).max(200).optional(),
41074
+ /** Any other tag, exact match (AND). */
41075
+ tags: record(string(), union([string(), number()])).optional(),
41076
+ /** Severity FLOOR: this level and above. */
40874
41077
  level: LogLevelSchema.optional(),
40875
- since: date().optional(),
40876
- until: date().optional(),
40877
- limit: number().optional(),
40878
- tags: record(string(), string()).optional()
40879
- }), array(LogEntrySchema).readonly());
41078
+ /** Case-insensitive substring over message, scope, tag values and meta values. */
41079
+ text: string().min(1).max(200).optional(),
41080
+ /** Epoch ms, inclusive. */
41081
+ since: number().optional(),
41082
+ /** Epoch ms, inclusive. */
41083
+ until: number().optional(),
41084
+ /** Older than this cursor (exclusive). Absent with `after` absent ⇒ from the newest. */
41085
+ before: string().min(1).max(1024).optional(),
41086
+ /** Newer than this cursor (exclusive). */
41087
+ after: string().min(1).max(1024).optional(),
41088
+ limit: number().int().min(1).max(1e3).optional(),
41089
+ /** Wall-clock bound of this slice. The provider caps it. */
41090
+ budgetMs: number().int().min(50).max(1e4).optional()
41091
+ });
41092
+ var LogReadResultSchema = object({
41093
+ /** Newest first. */
41094
+ entries: array(object({
41095
+ /** `<bootId>.<seq>` minted by the emitting LogManager — the dedupe key. */
41096
+ id: string().optional(),
41097
+ /** Epoch ms. */
41098
+ timestamp: number(),
41099
+ level: LogLevelSchema,
41100
+ scope: string().optional(),
41101
+ message: string(),
41102
+ tags: record(string(), union([string(), number()])).optional(),
41103
+ meta: record(string(), unknown()).optional()
41104
+ })),
41105
+ /** Pass as `before` for the next older page; null when nothing older exists. */
41106
+ nextBefore: string().nullable(),
41107
+ /** Pass as `after` to read what arrived since; null when unknown. */
41108
+ nextAfter: string().nullable(),
41109
+ /** Bytes this slice read (files) or received (remote). Progress, not a promise. */
41110
+ scannedBytes: number().int().nonnegative(),
41111
+ /**
41112
+ * True when the scan in this direction reached the end of the store.
41113
+ * False with fewer than `limit` entries means the budget ran out first —
41114
+ * call again with `nextBefore` to go on.
41115
+ */
41116
+ done: boolean(),
41117
+ /** True when `cancelRead` ended this slice early. */
41118
+ cancelled: boolean().optional()
41119
+ });
41120
+ var LogReadCapabilitiesSchema = object({
41121
+ /** False ⇒ this destination only ships lines (console, forwarder, an unconfigured Loki). */
41122
+ readable: boolean(),
41123
+ /** Why not, when `readable` is false — rendered next to the source. */
41124
+ reason: string().nullable(),
41125
+ /** Filters the provider applies itself. A false one is applied by nobody. */
41126
+ filters: object({
41127
+ deviceId: boolean(),
41128
+ addonId: boolean(),
41129
+ nodeId: boolean(),
41130
+ tags: boolean(),
41131
+ level: boolean(),
41132
+ text: boolean(),
41133
+ timeRange: boolean()
41134
+ }),
41135
+ /** How far back the store reaches, when the provider knows (days). */
41136
+ retentionDays: number().nullable()
41137
+ });
41138
+ method(LogEntrySchema, _void(), { kind: "mutation" }), optionalMethod(_void(), LogReadCapabilitiesSchema, { auth: "admin" }), optionalMethod(LogReadQuerySchema, LogReadResultSchema, { auth: "admin" }), optionalMethod(object({ requestId: string().min(1).max(64) }), object({ cancelled: boolean() }), {
41139
+ kind: "mutation",
41140
+ auth: "admin"
41141
+ });
40880
41142
  /**
40881
41143
  * `login-method` — collection cap through which auth addons contribute
40882
41144
  * their pre-auth login surfaces to the login page. This is the SINGLE,
@@ -43432,6 +43694,33 @@ var NcRuleTargetSchema = object({
43432
43694
  params: record(string(), unknown()).optional()
43433
43695
  });
43434
43696
  /**
43697
+ * WHAT THE NOTIFICATION'S PICTURE IS (D897) — the ONE media choice of a rule.
43698
+ *
43699
+ * Every mode starts from the same CLEAN source frame of the trigger moment
43700
+ * (keyFrame → sceneFrame → lastSceneFrame, narrowed to the trigger instant and
43701
+ * to the zone that fired the rule) and renders it once at send time:
43702
+ * - `scene-boxes` — the whole scene, the subject outlined thick in the accent
43703
+ * colour and every OTHER track visible at that instant outlined thin, each
43704
+ * labelled with class and confidence ("dog 87%").
43705
+ * - `crop` — the subject cut out of that frame around its box at that instant.
43706
+ * - `clean` — the whole scene with nothing drawn on it.
43707
+ * - `none` — no picture.
43708
+ *
43709
+ * A mode that cannot be honoured (no box at that instant, a photograph with no
43710
+ * tracked subject) ships `clean` and names the reason in the log, per camera.
43711
+ * It replaces the `attach` × `frame` × `zoneCrop` triple, which let one rule
43712
+ * ship a crop on one event and a boxed scene on the next depending on which
43713
+ * stored kind had landed.
43714
+ */
43715
+ var NcMediaImageSchema = _enum([
43716
+ "scene-boxes",
43717
+ "crop",
43718
+ "clean",
43719
+ "none"
43720
+ ]);
43721
+ /**
43722
+ * @deprecated Read only by `normalizeNcMediaPolicy` (D897) — see {@link NcMediaImageSchema}.
43723
+ *
43435
43724
  * Media attachment policy (P1 still-image subset).
43436
43725
  * - `best` — the best AVAILABLE subject image at dispatch time (D-3).
43437
43726
  * - `best-matching` — the media that explains WHY the rule fired: a rule
@@ -43445,6 +43734,8 @@ var NcRuleTargetSchema = object({
43445
43734
  * - `none` — no attachment.
43446
43735
  */
43447
43736
  /**
43737
+ * @deprecated Read only by `normalizeNcMediaPolicy` (D897) — see {@link NcMediaImageSchema}.
43738
+ *
43448
43739
  * WHAT THE PICTURE SHOWS — chosen explicitly, because the implicit ladders
43449
43740
  * conflate it with the selection strategy and betray the request: asking for
43450
43741
  * the clean scene frame on an object-event owner used to start at
@@ -43473,16 +43764,29 @@ var NcMediaFrameSchema = _enum([
43473
43764
  */
43474
43765
  var NcLinkedCameraModeSchema = _enum(["mosaic", "each"]);
43475
43766
  var NcMediaPolicySchema = object({
43767
+ /**
43768
+ * The picture — see {@link NcMediaImageSchema}. Absent on a rule nobody has
43769
+ * saved since D897: `normalizeNcMediaPolicy` derives it from the legacy
43770
+ * triple below, at load and at every write, and the store keeps only this.
43771
+ */
43772
+ image: NcMediaImageSchema.optional(),
43773
+ /**
43774
+ * Draw the zone that FIRED the rule on the picture (`scene-boxes` / `clean`;
43775
+ * a `crop` never shows it). Valid only on a rule whose trigger is a zone —
43776
+ * `conditions.zones` or an occupancy zone — and refused on save otherwise.
43777
+ * Replaces `zoneCrop`.
43778
+ */
43779
+ showTriggerZone: boolean().optional(),
43780
+ /** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
43476
43781
  attach: _enum([
43477
43782
  "best",
43478
43783
  "best-matching",
43479
43784
  "keyFrame",
43480
43785
  "none"
43481
- ]).default("best"),
43482
- /** What the still shows. Absent = `cropped` (the historical `best` shape). */
43786
+ ]).optional(),
43787
+ /** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
43483
43788
  frame: NcMediaFrameSchema.optional(),
43484
- /** Crop the attached still to the rule's condition-zone bbox (padded) —
43485
- * "show me the ZONE", not the whole scene or the subject crop. */
43789
+ /** @deprecated D897 — folded into `image: 'clean'` + `showTriggerZone` on save. */
43486
43790
  zoneCrop: boolean().optional(),
43487
43791
  /**
43488
43792
  * Also attach a short GIF cut from the stream broker's clip ring around the
@@ -43654,7 +43958,9 @@ var NcRuleInputSchema = object({
43654
43958
  * targets.
43655
43959
  */
43656
43960
  targetUsers: array(string()).optional(),
43657
- media: NcMediaPolicySchema.default({ attach: "best" }),
43961
+ /** Absent = the kind's default picture (`resolveNcMediaImage`): the subject crop for a
43962
+ * detection, the clean scene for a sensor or a sound. Set explicitly on save (D897). */
43963
+ media: NcMediaPolicySchema.default({}),
43658
43964
  throttle: NcThrottleSchema.default({
43659
43965
  cooldownSec: 60,
43660
43966
  scope: "rule-device"
@@ -44591,13 +44897,37 @@ var NcAlarmModeOpeningsSchema = object({
44591
44897
  /** Covered devices whose state could not be read (D49): neither open nor closed. */
44592
44898
  unknown: array(number().int())
44593
44899
  });
44900
+ /**
44901
+ * One alarm INPUT — a (rule, device) pair — the operator bypassed until the
44902
+ * next disarm ("Bypass this input until disarm" on a trigger notification, or
44903
+ * `nc.bypassAlarmInput`). Reported so an armed alarm with a silenced input
44904
+ * never looks fully armed (D62: off must never look like broken).
44905
+ */
44906
+ var NcAlarmInputBypassViewSchema = object({
44907
+ ruleId: string(),
44908
+ /** The rule's current name (its frozen name when the rule is gone). */
44909
+ ruleName: string(),
44910
+ /** The input: the sensor of the match, else its camera. */
44911
+ deviceId: number().int(),
44912
+ /** The input's current name. */
44913
+ name: string(),
44914
+ /** When it was bypassed (ms epoch). */
44915
+ since: number(),
44916
+ /** Triggers from this input dropped since. */
44917
+ dropped: number().int().min(0)
44918
+ });
44594
44919
  var NcAlarmLiveSchema = object({
44595
44920
  state: AlarmStateSchema,
44596
44921
  /** The mode being armed into (exit delay) or held; null when disarmed. */
44597
44922
  targetMode: AlarmArmModeSchema.nullable(),
44598
44923
  availableModes: array(AlarmArmModeSchema),
44599
44924
  openings: array(NcAlarmModeOpeningsSchema),
44600
- exclusions: array(NcAlarmExclusionViewSchema)
44925
+ exclusions: array(NcAlarmExclusionViewSchema),
44926
+ /**
44927
+ * Inputs bypassed for the rest of this arm session; cleared on disarm.
44928
+ * Defaulted so an older hub answer still parses (as "none known").
44929
+ */
44930
+ bypassedInputs: array(NcAlarmInputBypassViewSchema).default([])
44601
44931
  });
44602
44932
  var NcAlarmConfigSchema = object({
44603
44933
  /**
@@ -61950,26 +62280,6 @@ var ApiKeySummarySchema = object({
61950
62280
  createdAt: number(),
61951
62281
  lastUsedAt: number().optional()
61952
62282
  });
61953
- var ScopedTokenSummarySchema = object({
61954
- id: string(),
61955
- userId: string(),
61956
- name: string(),
61957
- tokenPrefix: string(),
61958
- scopes: array(TokenScopeSchema),
61959
- expiresAt: number().nullish(),
61960
- lastUsedAt: number().nullish(),
61961
- createdAt: number()
61962
- });
61963
- var CreateScopedTokenInputSchema = object({
61964
- userId: string(),
61965
- name: string(),
61966
- scopes: array(TokenScopeSchema),
61967
- expiresAt: number().optional()
61968
- });
61969
- var CreateScopedTokenResultSchema = object({
61970
- token: string(),
61971
- record: ScopedTokenSummarySchema
61972
- });
61973
62283
  var OauthSessionSummarySchema = object({
61974
62284
  id: string(),
61975
62285
  userId: string(),
@@ -61991,11 +62301,11 @@ var TotpStatusSchema = object({
61991
62301
  confirmedAt: number().nullable()
61992
62302
  });
61993
62303
  /**
61994
- * user-management — singleton capability for user accounts, API keys,
61995
- * and scoped tokens.
62304
+ * user-management — singleton capability for user accounts and the
62305
+ * legacy API-key rows.
61996
62306
  *
61997
62307
  * v2 model: every method gated by `auth: 'admin'`. Admin-only delegation
61998
- * — the subset check on `setUserScopes` / `createScopedToken` is moot
62308
+ * — the subset check on `setUserScopes` is moot
61999
62309
  * because non-admins never reach these. If/when we open non-admin
62000
62310
  * delegation, structural caller-scope subset check goes inside the
62001
62311
  * provider.
@@ -62052,15 +62362,7 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(CreateUserI
62052
62362
  kind: "mutation",
62053
62363
  auth: "admin",
62054
62364
  access: "delete"
62055
- }), method(CreateScopedTokenInputSchema, CreateScopedTokenResultSchema, {
62056
- kind: "mutation",
62057
- auth: "admin",
62058
- access: "create"
62059
- }), method(object({ id: string() }), object({ success: literal(true) }), {
62060
- kind: "mutation",
62061
- auth: "admin",
62062
- access: "delete"
62063
- }), method(object({ token: string() }), ScopedTokenSummarySchema.nullable(), { access: "view" }), method(object({ userId: string() }), array(ScopedTokenSummarySchema), { auth: "admin" }), method(object({ userId: string() }), TotpSetupResultSchema, {
62365
+ }), method(object({ userId: string() }), TotpSetupResultSchema, {
62064
62366
  kind: "mutation",
62065
62367
  auth: "admin",
62066
62368
  access: "create"
@@ -66216,7 +66518,7 @@ Object.freeze({
66216
66518
  capName: "llm",
66217
66519
  capScope: "system",
66218
66520
  addonId: null,
66219
- access: "view"
66521
+ access: "create"
66220
66522
  },
66221
66523
  "llm.listNodeModels": {
66222
66524
  capName: "llm",
@@ -66518,7 +66820,19 @@ Object.freeze({
66518
66820
  addonId: null,
66519
66821
  access: "view"
66520
66822
  },
66521
- "logDestination.query": {
66823
+ "logDestination.cancelRead": {
66824
+ capName: "log-destination",
66825
+ capScope: "system",
66826
+ addonId: null,
66827
+ access: "create"
66828
+ },
66829
+ "logDestination.describeRead": {
66830
+ capName: "log-destination",
66831
+ capScope: "system",
66832
+ addonId: null,
66833
+ access: "view"
66834
+ },
66835
+ "logDestination.read": {
66522
66836
  capName: "log-destination",
66523
66837
  capScope: "system",
66524
66838
  addonId: null,
@@ -70880,12 +71194,6 @@ Object.freeze({
70880
71194
  addonId: null,
70881
71195
  access: "create"
70882
71196
  },
70883
- "userManagement.createScopedToken": {
70884
- capName: "user-management",
70885
- capScope: "system",
70886
- addonId: null,
70887
- access: "create"
70888
- },
70889
71197
  "userManagement.createUser": {
70890
71198
  capName: "user-management",
70891
71199
  capScope: "system",
@@ -70934,12 +71242,6 @@ Object.freeze({
70934
71242
  addonId: null,
70935
71243
  access: "view"
70936
71244
  },
70937
- "userManagement.listScopedTokens": {
70938
- capName: "user-management",
70939
- capScope: "system",
70940
- addonId: null,
70941
- access: "view"
70942
- },
70943
71245
  "userManagement.listUsers": {
70944
71246
  capName: "user-management",
70945
71247
  capScope: "system",
@@ -70994,12 +71296,6 @@ Object.freeze({
70994
71296
  addonId: null,
70995
71297
  access: "delete"
70996
71298
  },
70997
- "userManagement.revokeScopedToken": {
70998
- capName: "user-management",
70999
- capScope: "system",
71000
- addonId: null,
71001
- access: "delete"
71002
- },
71003
71299
  "userManagement.setupTotp": {
71004
71300
  capName: "user-management",
71005
71301
  capScope: "system",
@@ -71030,12 +71326,6 @@ Object.freeze({
71030
71326
  addonId: null,
71031
71327
  access: "view"
71032
71328
  },
71033
- "userManagement.validateScopedToken": {
71034
- capName: "user-management",
71035
- capScope: "system",
71036
- addonId: null,
71037
- access: "view"
71038
- },
71039
71329
  "userManagement.verifyTotp": {
71040
71330
  capName: "user-management",
71041
71331
  capScope: "system",
@@ -72549,6 +72839,11 @@ Object.freeze({
72549
72839
  form: "single",
72550
72840
  optional: false
72551
72841
  }],
72842
+ "logDestination.read": [{
72843
+ name: "deviceId",
72844
+ form: "single",
72845
+ optional: true
72846
+ }],
72552
72847
  "mediaPlayer.getStatus": [{
72553
72848
  name: "deviceId",
72554
72849
  form: "single",