@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.
@@ -5454,7 +5454,7 @@ var ZodIssueCode = {
5454
5454
  var ZodFirstPartyTypeKind;
5455
5455
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5456
5456
  //#endregion
5457
- //#region ../types/dist/sleep-BxjU_fJM.mjs
5457
+ //#region ../types/dist/sleep-BSuCCFjf.mjs
5458
5458
  /**
5459
5459
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5460
5460
  * window to float samples (D455).
@@ -7837,9 +7837,9 @@ function normalizeAddonInitResult(result) {
7837
7837
  return result;
7838
7838
  }
7839
7839
  /**
7840
- * The share-view scope kinds a `csv_*` share token can carry. The hub mints
7841
- * and validates them (`share-token.service.ts` builds its enum from this
7842
- * list); a data plane names the kinds it ACCEPTS in `share`.
7840
+ * The share-view scope kinds a share-link token can carry. The hub mints
7841
+ * and validates them (`ShareViewGrantSchema` builds its
7842
+ * enum from this list); a data plane names the kinds it ACCEPTS in `share`.
7843
7843
  */
7844
7844
  var SHARE_VIEW_KINDS = ["grid-view", "events-view"];
7845
7845
  /** The wire shape of {@link PeerBytesTicket} — see the type for what it is. */
@@ -13336,7 +13336,7 @@ var ConvertResultSchema = object({
13336
13336
  * `super_admin` — collapsed onto the single boolean because every
13337
13337
  * non-admin caller is governed by the same scope-check rules; the
13338
13338
  * distinction was only ever used to route role-specific procedures
13339
- * which we no longer have. CLI / webhook integrations are `cst_*` tokens
13339
+ * which we no longer have. CLI / webhook integrations are tokens (`auth.mintToken`)
13340
13340
  * with `isAdmin: false` + an explicit scope list.
13341
13341
  */
13342
13342
  /** Per-method access flavour. Materialised on every cap method via codegen. */
@@ -13525,10 +13525,12 @@ var AddonRoutesScopeSchema = object({
13525
13525
  type: literal("addon-routes"),
13526
13526
  access: array(MethodAccessSchema).min(1)
13527
13527
  });
13528
+ var PreferencesSelfScopeSchema = object({ type: literal("preferences-self") });
13528
13529
  var CredentialScopeSchema = union([
13529
13530
  literal("*"),
13530
13531
  ShareViewScopeSchema,
13531
13532
  AddonRoutesScopeSchema,
13533
+ PreferencesSelfScopeSchema,
13532
13534
  TokenScopeSchema
13533
13535
  ]);
13534
13536
  object({
@@ -13537,6 +13539,55 @@ object({
13537
13539
  jti: string().min(16),
13538
13540
  scopes: array(CredentialScopeSchema).min(1)
13539
13541
  });
13542
+ var PreferenceNamespaceSchema = string().regex(/^[a-z][a-z0-9.-]{0,63}$/);
13543
+ /** A namespace's value: a JSON object, opaque to the hub. */
13544
+ var PreferenceValueSchema = record(string(), unknown());
13545
+ var PreferenceDeviceIdSchema = string().min(1).max(64);
13546
+ /** A stored row, as the owner reads it. */
13547
+ var PreferenceRowSchema = object({
13548
+ namespace: PreferenceNamespaceSchema,
13549
+ value: PreferenceValueSchema,
13550
+ /** Starts at 1, +1 on every write of this namespace. A delete ends the row and its count. */
13551
+ revision: number().int().positive(),
13552
+ updatedAt: number().int(),
13553
+ /** The client id the last writer sent; `null` when it sent none. */
13554
+ updatedByDevice: PreferenceDeviceIdSchema.nullable()
13555
+ });
13556
+ object({
13557
+ /** Absent: every namespace the caller holds. */
13558
+ namespaces: array(PreferenceNamespaceSchema).max(32).optional() });
13559
+ object({ rows: array(PreferenceRowSchema) });
13560
+ object({
13561
+ namespace: PreferenceNamespaceSchema,
13562
+ value: PreferenceValueSchema,
13563
+ /**
13564
+ * The revision the edit was based on. Absent: last write wins. `0`: the
13565
+ * namespace must not exist yet. Any other value that is not the current
13566
+ * revision answers `conflict` and writes nothing.
13567
+ */
13568
+ baseRevision: number().int().nonnegative().optional(),
13569
+ deviceId: PreferenceDeviceIdSchema.optional()
13570
+ });
13571
+ discriminatedUnion("status", [object({
13572
+ status: literal("saved"),
13573
+ row: PreferenceRowSchema
13574
+ }), object({
13575
+ status: literal("conflict"),
13576
+ current: PreferenceRowSchema.nullable()
13577
+ })]);
13578
+ object({ namespace: PreferenceNamespaceSchema });
13579
+ object({
13580
+ /** `false` when the namespace did not exist. */
13581
+ deleted: boolean() });
13582
+ object({
13583
+ /** The revision the client holds per namespace; a namespace it does not list is new to it. */
13584
+ revisionByNamespace: record(PreferenceNamespaceSchema, number().int().nonnegative()).refine((map) => Object.keys(map).length <= 32, { message: `at most 32 namespaces` }) });
13585
+ object({
13586
+ /** Every row whose revision differs from the client's, and every row it did not list. */
13587
+ rows: array(PreferenceRowSchema),
13588
+ /** Namespaces the client listed that no longer exist. */
13589
+ deleted: array(PreferenceNamespaceSchema)
13590
+ });
13540
13591
  _enum(["new-session", "step-up"]);
13541
13592
  /** The languages the hub's app landing pages are written in (D858). */
13542
13593
  var AppPageLangSchema = _enum(["en", "it"]);
@@ -17684,7 +17735,19 @@ var DeviceHistorySubjectSchema = discriminatedUnion("kind", [object({
17684
17735
  kind: literal("node"),
17685
17736
  nodeId: string().min(1)
17686
17737
  })]);
17738
+ /**
17739
+ * `enum` stores a STATE as the ordinal of its value in the series' value list
17740
+ * (`DeviceHistorySeriesInfo.values`, append-only, so an ordinal never changes
17741
+ * meaning); a rollup keeps the time spent in each state (`states`).
17742
+ */
17687
17743
  var DeviceHistoryKindSchema = _enum([
17744
+ "gauge",
17745
+ "counter",
17746
+ "boolean",
17747
+ "enum"
17748
+ ]);
17749
+ /** What a PRODUCER may declare. `enum` is cap-only: its value list is the cap field's. */
17750
+ var DeviceHistoryProducerKindSchema = _enum([
17688
17751
  "gauge",
17689
17752
  "counter",
17690
17753
  "boolean"
@@ -17721,7 +17784,13 @@ var SeriesInfoSchema = object({
17721
17784
  /** `null` is unknown (a `unitFrom` series whose device does not state a unit right now), never a guess. */
17722
17785
  unit: string().nullable(),
17723
17786
  displayName: string(),
17724
- source: _enum(["cap", "addon"]),
17787
+ source: _enum([
17788
+ "cap",
17789
+ "addon",
17790
+ "derived"
17791
+ ]),
17792
+ /** `enum`: the value of each ordinal (index = ordinal); `null` for every other kind. */
17793
+ values: array(string()).readonly().nullable(),
17725
17794
  firstTs: number(),
17726
17795
  lastTs: number()
17727
17796
  });
@@ -17735,17 +17804,31 @@ var QueryPointSchema = object({
17735
17804
  twMean: number().nullable(),
17736
17805
  min: number(),
17737
17806
  max: number(),
17738
- /** `null` is unknown, never zero (D393). */
17739
- last: number().nullable()
17807
+ /** `null` is unknown, never zero (D393). For an `enum` series: the ordinal of {@link state}. */
17808
+ last: number().nullable(),
17809
+ /**
17810
+ * The increase over the point: a `counter`'s growth since the previous point
17811
+ * or bucket (a drop is a reset, counted from zero), and for
17812
+ * {@link DEVICE_HISTORY_ENERGY_KEY} the kWh used in the bucket. `null` for
17813
+ * every other kind, and when it cannot be known.
17814
+ */
17815
+ delta: number().nullable(),
17816
+ /** `enum`: the state in force at the end of the point (the name of `last`); `null` otherwise. */
17817
+ state: string().nullable(),
17818
+ /** `enum` rollup: milliseconds spent in each state inside the bucket; `null` for raw points and other kinds. */
17819
+ states: record(string(), number()).nullable()
17740
17820
  });
17741
17821
  var QuerySeriesSchema = object({
17742
17822
  scope: string(),
17743
17823
  /** The last point STRICTLY BEFORE `from` in the chosen tier, so a step chart can start at the held value. */
17744
17824
  before: object({
17745
17825
  t: number(),
17746
- value: number().nullable()
17826
+ value: number().nullable(),
17827
+ state: string().nullable()
17747
17828
  }).nullable(),
17748
- points: array(QueryPointSchema).readonly()
17829
+ points: array(QueryPointSchema).readonly(),
17830
+ /** A derived key: the stored key its points were computed from; `null` for a stored series. */
17831
+ derivedFrom: string().nullable()
17749
17832
  });
17750
17833
  /** The window part of a query, shared by the device and node forms. */
17751
17834
  var QueryWindowShape = {
@@ -17761,6 +17844,23 @@ var QueryResultSchema = object({
17761
17844
  series: array(QuerySeriesSchema).readonly(),
17762
17845
  truncated: boolean()
17763
17846
  });
17847
+ /** One read of a batch: a device's key or a node's key (exactly one subject). */
17848
+ var QueryManyItemSchema = union([object({
17849
+ deviceId: number().int(),
17850
+ key: string(),
17851
+ scope: string().optional()
17852
+ }), object({
17853
+ forNodeId: string().min(1),
17854
+ key: string(),
17855
+ scope: string().optional()
17856
+ })]);
17857
+ var QueryManyEntrySchema = discriminatedUnion("ok", [object({
17858
+ ok: literal(true),
17859
+ result: QueryResultSchema
17860
+ }), object({
17861
+ ok: literal(false),
17862
+ error: string()
17863
+ })]);
17764
17864
  var TierStatusSchema = object({
17765
17865
  tier: DeviceHistoryResolutionSchema,
17766
17866
  /** `null` until the first background count answered. */
@@ -17816,16 +17916,22 @@ var DeviceHistoryStatusSchema = object({
17816
17916
  lastRefreshAt: number().nullable()
17817
17917
  })
17818
17918
  });
17819
- method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly()), method(object({ nodeId: string().min(1) }), array(SeriesInfoSchema).readonly(), { auth: "admin" }), method(object({
17919
+ method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly()), method(object({ forNodeId: string().min(1) }), array(SeriesInfoSchema).readonly(), { auth: "admin" }), method(object({
17820
17920
  deviceId: number().int(),
17821
17921
  ...QueryWindowShape
17822
17922
  }), QueryResultSchema), method(object({
17823
- nodeId: string().min(1),
17923
+ forNodeId: string().min(1),
17824
17924
  ...QueryWindowShape
17825
17925
  }), QueryResultSchema, { auth: "admin" }), method(object({
17926
+ items: array(QueryManyItemSchema).min(1).max(24),
17927
+ from: QueryWindowShape.from,
17928
+ to: QueryWindowShape.to,
17929
+ resolution: QueryWindowShape.resolution,
17930
+ maxPoints: QueryWindowShape.maxPoints
17931
+ }), object({ results: array(QueryManyEntrySchema).readonly() }), { auth: "admin" }), method(object({
17826
17932
  name: string().regex(/^[a-z0-9-]+$/),
17827
17933
  subjectKind: _enum(["device", "node"]),
17828
- kind: DeviceHistoryKindSchema,
17934
+ kind: DeviceHistoryProducerKindSchema,
17829
17935
  unit: string().optional(),
17830
17936
  displayName: string().min(1),
17831
17937
  ingest: _enum(["points", "buckets"])
@@ -40496,38 +40602,37 @@ method(LlmRuntimeCompleteInputSchema, LlmGenerateResultSchema, {
40496
40602
  auth: "admin",
40497
40603
  timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
40498
40604
  });
40605
+ var LlmProfileKindSchema = string().regex(/^[a-z0-9][a-z0-9-]{0,63}$/, "a kind id is lower-case letters, digits and dashes");
40606
+ /** What a model (or, by default, every model of a kind) can do. */
40607
+ var LlmModelFeaturesSchema = object({
40608
+ vision: boolean(),
40609
+ tools: boolean(),
40610
+ streaming: boolean()
40611
+ });
40612
+ /** One model a provider offers. `features` overrides the kind's defaults, per field. */
40613
+ var LlmModelInfoSchema = object({
40614
+ id: string(),
40615
+ label: string().optional(),
40616
+ contextLength: number().int().positive().optional(),
40617
+ features: LlmModelFeaturesSchema.partial().optional()
40618
+ });
40499
40619
  /**
40500
- * `llm` — consumer-facing LLM surface (spec §1-§3). Collection-mode: array
40501
- * methods concat-fan across providers; single-row methods route to ONE
40502
- * provider by the `addonId` in the call input (the notification-output
40503
- * posture, notification-output.cap.ts:215-250). Provided by `addon-ai`
40504
- * (hub-placed); the cap stays open for future providers.
40505
- *
40506
- * Profiles are ROWS (data), not addons: one row = one usable model endpoint.
40507
- * `apiKey` is a password field — providers REDACT it on read and merge on
40508
- * write; a stored key NEVER round-trips to a client.
40620
+ * The provider-specific part of a profile, validated by the provider that owns
40621
+ * the kind (`upsertProfile` refuses what it does not accept). A field its
40622
+ * `connectionSchema` declares `type: 'password'` is a secret: it is held in the
40623
+ * keychain, never in the row, and reads back as the redaction marker.
40509
40624
  */
40510
- var LlmProfileKindSchema = _enum([
40511
- "openai-compatible",
40512
- "openai",
40513
- "anthropic",
40514
- "google",
40515
- "managed-local",
40516
- "apple-foundation"
40517
- ]);
40625
+ var LlmProviderConfigSchema = record(string(), unknown());
40518
40626
  var LlmProfileSchema = object({
40519
40627
  id: string(),
40520
40628
  name: string(),
40629
+ /** The provider-declared kind (`LlmProfileKindDescriptor.kind`). */
40521
40630
  kind: LlmProfileKindSchema,
40522
40631
  /** Stamped by the provider — keeps the fanned catalog routable. */
40523
40632
  addonId: string(),
40524
40633
  enabled: boolean(),
40525
40634
  /** Vendor model id, or the managed runtime's loaded model. */
40526
40635
  model: string(),
40527
- /** Required for openai-compatible; override for cloud kinds. */
40528
- baseUrl: string().optional(),
40529
- /** ConfigUISchema type:'password' — never round-trips (spec §5). */
40530
- apiKey: string().optional(),
40531
40636
  /** Vision on/off. A vision call against a `false` profile is REFUSED, never
40532
40637
  * degraded to text — that shipped once and produced a confident answer to a
40533
40638
  * question about a picture nobody sent. */
@@ -40535,15 +40640,11 @@ var LlmProfileSchema = object({
40535
40640
  temperature: number().min(0).max(2).optional(),
40536
40641
  /** Nucleus sampling. Every wire we speak has it. */
40537
40642
  topP: number().min(0).max(1).optional(),
40538
- /** Top-k sampling. Carried only by the wires that have it — NEITHER OpenAI
40539
- * wire does, and the client drops it there (measured: the request body gets
40540
- * `top_p` and no `top_k`). The profile editor hides the field wherever it
40541
- * would change nothing; `KINDS_WITH_TOP_K` is the single owner of that list. */
40643
+ /** Top-k sampling. Carried only by the wires that have it — a kind offers the
40644
+ * field in its editor only when its descriptor lists it in `profileFields`. */
40542
40645
  topK: number().int().positive().optional(),
40543
40646
  maxTokens: number().int().positive().optional(),
40544
- /** Prompt context window. Advisory for cloud kinds (they enforce their own);
40545
- * for `managed-local` it is the llama.cpp `--ctx-size` the runtime starts
40546
- * the model with, so it is the one field that changes a PROCESS. */
40647
+ /** Prompt context window. Advisory for cloud kinds (they enforce their own). */
40547
40648
  contextLength: number().int().positive().optional(),
40548
40649
  /** Default system prompt. A caller's `system` REPLACES it (never appends —
40549
40650
  * two system prompts fighting is worse than either alone). */
@@ -40569,16 +40670,37 @@ var LlmProfileSchema = object({
40569
40670
  * library; the REGISTRY of callable tools is ours and is empty in v1, so a
40570
40671
  * `true` here buys the wiring, not behaviour, until tools are registered. */
40571
40672
  toolsEnabled: boolean().default(false),
40572
- extraHeaders: record(string(), string()).optional(),
40573
- /** kind === 'managed-local' only (spec §4). */
40574
- runtime: ManagedRuntimeConfigSchema.optional(),
40575
- /**
40576
- * kind === 'apple-foundation' only: WHERE it runs — the only thing there is
40577
- * to configure (no key, no URL, no download; `model` is `apple-system`).
40578
- * `supportsVision` on such a row is stamped by the provider from the node's
40579
- * reported `imageInput`, never taken from the operator (D62).
40580
- */
40581
- appleFoundation: object({ nodeId: string() }).optional()
40673
+ /** Everything the kind's provider owns (endpoint, key, node, runtime…). */
40674
+ providerConfig: LlmProviderConfigSchema.default({})
40675
+ });
40676
+ /**
40677
+ * The common profile fields a kind's editor offers. The editor owns how each
40678
+ * one is drawn; the provider says which of them mean something on its wire.
40679
+ */
40680
+ var LlmProfileFieldSchema = _enum([
40681
+ "temperature",
40682
+ "topP",
40683
+ "topK",
40684
+ "maxTokens",
40685
+ "contextLength",
40686
+ "systemPrompt",
40687
+ "timeoutMs",
40688
+ "connectTimeoutMs",
40689
+ "firstTokenTimeoutMs",
40690
+ "idleTimeoutMs",
40691
+ "retry",
40692
+ "toolsEnabled"
40693
+ ]);
40694
+ /**
40695
+ * A provider-drawn part of the editor, by a generic widget id the admin UI
40696
+ * registers (`ai/apple-node`). `placement: 'model'` replaces the generic model
40697
+ * picker: that widget owns the model choice.
40698
+ */
40699
+ var LlmProviderWidgetSchema = object({
40700
+ id: string(),
40701
+ placement: _enum(["connection", "model"]),
40702
+ /** `providerConfig` keys this widget must fill before the profile can be saved. */
40703
+ requires: array(string()).optional()
40582
40704
  });
40583
40705
  /** ConfigUISchema tree passed through untyped on the wire (the
40584
40706
  * notification-output `ConfigSchemaPassthrough` precedent at
@@ -40587,11 +40709,56 @@ var ConfigSchemaPassthrough$3 = unknown();
40587
40709
  var LlmProfileKindDescriptorSchema = object({
40588
40710
  kind: LlmProfileKindSchema,
40589
40711
  label: string(),
40712
+ /** A generic icon name (`cloud`, `plug`, `cpu`) — never a glyph or a logo. */
40590
40713
  icon: string(),
40591
40714
  /** Stamped by each provider so the concat-fanned catalog stays routable. */
40592
40715
  addonId: string(),
40593
- configSchema: ConfigSchemaPassthrough$3
40716
+ /** The provider's own fields (`providerConfig`); `password` fields are keychain-held. */
40717
+ connectionSchema: ConfigSchemaPassthrough$3,
40718
+ /** Provider fields that belong under "Advanced" (extra headers, runtime tuning). */
40719
+ advancedSchema: ConfigSchemaPassthrough$3.optional(),
40720
+ /** The kind's defaults; a model from `listModels` may override any of them. */
40721
+ features: LlmModelFeaturesSchema,
40722
+ /** `false` = the provider stamps `supportsVision` itself (from what a node reports). */
40723
+ visionEditable: boolean(),
40724
+ /** Where the model list comes from: `listModels`, `staticModels`, or nowhere. */
40725
+ modelCatalog: _enum([
40726
+ "fetch",
40727
+ "static",
40728
+ "none"
40729
+ ]),
40730
+ staticModels: array(LlmModelInfoSchema).optional(),
40731
+ /** The common fields that mean something on this kind's wire. */
40732
+ profileFields: array(LlmProfileFieldSchema),
40733
+ providerWidgets: array(LlmProviderWidgetSchema).optional()
40734
+ });
40735
+ /**
40736
+ * `listModels` input. `connection` is an UNSAVED draft of `providerConfig`
40737
+ * (the editor's form); with `profileId` too, a secret the draft leaves
40738
+ * untouched (absent or the redaction marker) is resolved server-side from the
40739
+ * stored profile — the browser never receives it.
40740
+ */
40741
+ var LlmListModelsInputSchema = object({
40742
+ addonId: string(),
40743
+ kind: LlmProfileKindSchema,
40744
+ profileId: string().optional(),
40745
+ connection: LlmProviderConfigSchema.optional()
40594
40746
  });
40747
+ var LlmListModelsErrorCodeSchema = _enum([
40748
+ "auth",
40749
+ "network",
40750
+ "unsupported",
40751
+ "invalid"
40752
+ ]);
40753
+ /** A RESULT, never a throw: "wrong key" is an answer the editor renders inline. */
40754
+ var LlmListModelsResultSchema = discriminatedUnion("ok", [object({
40755
+ ok: literal(true),
40756
+ models: array(LlmModelInfoSchema)
40757
+ }), object({
40758
+ ok: literal(false),
40759
+ code: LlmListModelsErrorCodeSchema,
40760
+ message: string()
40761
+ })]);
40595
40762
  var LlmDefaultSelectorSchema = union([object({ consumer: string() }), object({ purpose: _enum(["text", "vision"]) })]);
40596
40763
  var LlmDefaultSchema = object({
40597
40764
  selector: LlmDefaultSelectorSchema,
@@ -40691,7 +40858,10 @@ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, {
40691
40858
  kind: "mutation",
40692
40859
  auth: "admin",
40693
40860
  timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
40694
- }), method(ProfileRefInputSchema, array(string())), method(object({}), array(LlmDefaultSchema)), method(object({
40861
+ }), method(LlmListModelsInputSchema, LlmListModelsResultSchema, {
40862
+ kind: "mutation",
40863
+ auth: "admin"
40864
+ }), method(object({}), array(LlmDefaultSchema)), method(object({
40695
40865
  selector: LlmDefaultSelectorSchema,
40696
40866
  profileId: string().nullable()
40697
40867
  }), _void(), {
@@ -40859,14 +41029,106 @@ var LogEntrySchema = object({
40859
41029
  meta: record(string(), unknown()).optional(),
40860
41030
  tags: record(string(), string()).optional()
40861
41031
  });
40862
- method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
40863
- scope: array(string()).optional(),
41032
+ /**
41033
+ * A history READ against one destination (D898).
41034
+ *
41035
+ * Every filter is applied by the PROVIDER, before the limit — a filter the
41036
+ * browser applied after the limit is what made a rare device's lines
41037
+ * unreachable behind a busy one's. `before` / `after` are cursors the provider
41038
+ * minted (opaque to everyone else): a file position for the rotated files, a
41039
+ * nanosecond timestamp for Loki.
41040
+ *
41041
+ * A read is BOUNDED by `budgetMs`: a filter that matches nothing on a 30-day
41042
+ * store answers `done: false` with the cursor it reached and the bytes it
41043
+ * scanned, and the caller decides whether to go on. That is what makes a long
41044
+ * scan show progress and stop when asked — `cancelRead` ends the slice in
41045
+ * flight, and not asking for the next slice ends the scan.
41046
+ */
41047
+ var LogReadQuerySchema = object({
41048
+ /** Correlates `cancelRead`. Caller-chosen, unique per in-flight read. */
41049
+ requestId: string().min(1).max(64).optional(),
41050
+ /** The device the line is about (`tags.deviceId`, numeric). */
41051
+ deviceId: number().int().optional(),
41052
+ /**
41053
+ * The emitting addon — bare manifest id; `@<version>` / `::<sub>` suffixes
41054
+ * match. Not `addonId`: a cap router reads that name as "which provider".
41055
+ */
41056
+ fromAddonId: string().min(1).max(200).optional(),
41057
+ /**
41058
+ * The emitting node: matches the agent that emitted the line, the node
41059
+ * itself, or a worker under it (`<agent>/<runner>`) — the `agentId`
41060
+ * semantics of `matchesLogTags`. Not `nodeId`: a cap router reads that
41061
+ * name as "which node's provider".
41062
+ */
41063
+ fromNodeId: string().min(1).max(200).optional(),
41064
+ /** Any other tag, exact match (AND). */
41065
+ tags: record(string(), union([string(), number()])).optional(),
41066
+ /** Severity FLOOR: this level and above. */
40864
41067
  level: LogLevelSchema.optional(),
40865
- since: date().optional(),
40866
- until: date().optional(),
40867
- limit: number().optional(),
40868
- tags: record(string(), string()).optional()
40869
- }), array(LogEntrySchema).readonly());
41068
+ /** Case-insensitive substring over message, scope, tag values and meta values. */
41069
+ text: string().min(1).max(200).optional(),
41070
+ /** Epoch ms, inclusive. */
41071
+ since: number().optional(),
41072
+ /** Epoch ms, inclusive. */
41073
+ until: number().optional(),
41074
+ /** Older than this cursor (exclusive). Absent with `after` absent ⇒ from the newest. */
41075
+ before: string().min(1).max(1024).optional(),
41076
+ /** Newer than this cursor (exclusive). */
41077
+ after: string().min(1).max(1024).optional(),
41078
+ limit: number().int().min(1).max(1e3).optional(),
41079
+ /** Wall-clock bound of this slice. The provider caps it. */
41080
+ budgetMs: number().int().min(50).max(1e4).optional()
41081
+ });
41082
+ var LogReadResultSchema = object({
41083
+ /** Newest first. */
41084
+ entries: array(object({
41085
+ /** `<bootId>.<seq>` minted by the emitting LogManager — the dedupe key. */
41086
+ id: string().optional(),
41087
+ /** Epoch ms. */
41088
+ timestamp: number(),
41089
+ level: LogLevelSchema,
41090
+ scope: string().optional(),
41091
+ message: string(),
41092
+ tags: record(string(), union([string(), number()])).optional(),
41093
+ meta: record(string(), unknown()).optional()
41094
+ })),
41095
+ /** Pass as `before` for the next older page; null when nothing older exists. */
41096
+ nextBefore: string().nullable(),
41097
+ /** Pass as `after` to read what arrived since; null when unknown. */
41098
+ nextAfter: string().nullable(),
41099
+ /** Bytes this slice read (files) or received (remote). Progress, not a promise. */
41100
+ scannedBytes: number().int().nonnegative(),
41101
+ /**
41102
+ * True when the scan in this direction reached the end of the store.
41103
+ * False with fewer than `limit` entries means the budget ran out first —
41104
+ * call again with `nextBefore` to go on.
41105
+ */
41106
+ done: boolean(),
41107
+ /** True when `cancelRead` ended this slice early. */
41108
+ cancelled: boolean().optional()
41109
+ });
41110
+ var LogReadCapabilitiesSchema = object({
41111
+ /** False ⇒ this destination only ships lines (console, forwarder, an unconfigured Loki). */
41112
+ readable: boolean(),
41113
+ /** Why not, when `readable` is false — rendered next to the source. */
41114
+ reason: string().nullable(),
41115
+ /** Filters the provider applies itself. A false one is applied by nobody. */
41116
+ filters: object({
41117
+ deviceId: boolean(),
41118
+ addonId: boolean(),
41119
+ nodeId: boolean(),
41120
+ tags: boolean(),
41121
+ level: boolean(),
41122
+ text: boolean(),
41123
+ timeRange: boolean()
41124
+ }),
41125
+ /** How far back the store reaches, when the provider knows (days). */
41126
+ retentionDays: number().nullable()
41127
+ });
41128
+ 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() }), {
41129
+ kind: "mutation",
41130
+ auth: "admin"
41131
+ });
40870
41132
  /**
40871
41133
  * `login-method` — collection cap through which auth addons contribute
40872
41134
  * their pre-auth login surfaces to the login page. This is the SINGLE,
@@ -43422,6 +43684,33 @@ var NcRuleTargetSchema = object({
43422
43684
  params: record(string(), unknown()).optional()
43423
43685
  });
43424
43686
  /**
43687
+ * WHAT THE NOTIFICATION'S PICTURE IS (D897) — the ONE media choice of a rule.
43688
+ *
43689
+ * Every mode starts from the same CLEAN source frame of the trigger moment
43690
+ * (keyFrame → sceneFrame → lastSceneFrame, narrowed to the trigger instant and
43691
+ * to the zone that fired the rule) and renders it once at send time:
43692
+ * - `scene-boxes` — the whole scene, the subject outlined thick in the accent
43693
+ * colour and every OTHER track visible at that instant outlined thin, each
43694
+ * labelled with class and confidence ("dog 87%").
43695
+ * - `crop` — the subject cut out of that frame around its box at that instant.
43696
+ * - `clean` — the whole scene with nothing drawn on it.
43697
+ * - `none` — no picture.
43698
+ *
43699
+ * A mode that cannot be honoured (no box at that instant, a photograph with no
43700
+ * tracked subject) ships `clean` and names the reason in the log, per camera.
43701
+ * It replaces the `attach` × `frame` × `zoneCrop` triple, which let one rule
43702
+ * ship a crop on one event and a boxed scene on the next depending on which
43703
+ * stored kind had landed.
43704
+ */
43705
+ var NcMediaImageSchema = _enum([
43706
+ "scene-boxes",
43707
+ "crop",
43708
+ "clean",
43709
+ "none"
43710
+ ]);
43711
+ /**
43712
+ * @deprecated Read only by `normalizeNcMediaPolicy` (D897) — see {@link NcMediaImageSchema}.
43713
+ *
43425
43714
  * Media attachment policy (P1 still-image subset).
43426
43715
  * - `best` — the best AVAILABLE subject image at dispatch time (D-3).
43427
43716
  * - `best-matching` — the media that explains WHY the rule fired: a rule
@@ -43435,6 +43724,8 @@ var NcRuleTargetSchema = object({
43435
43724
  * - `none` — no attachment.
43436
43725
  */
43437
43726
  /**
43727
+ * @deprecated Read only by `normalizeNcMediaPolicy` (D897) — see {@link NcMediaImageSchema}.
43728
+ *
43438
43729
  * WHAT THE PICTURE SHOWS — chosen explicitly, because the implicit ladders
43439
43730
  * conflate it with the selection strategy and betray the request: asking for
43440
43731
  * the clean scene frame on an object-event owner used to start at
@@ -43463,16 +43754,29 @@ var NcMediaFrameSchema = _enum([
43463
43754
  */
43464
43755
  var NcLinkedCameraModeSchema = _enum(["mosaic", "each"]);
43465
43756
  var NcMediaPolicySchema = object({
43757
+ /**
43758
+ * The picture — see {@link NcMediaImageSchema}. Absent on a rule nobody has
43759
+ * saved since D897: `normalizeNcMediaPolicy` derives it from the legacy
43760
+ * triple below, at load and at every write, and the store keeps only this.
43761
+ */
43762
+ image: NcMediaImageSchema.optional(),
43763
+ /**
43764
+ * Draw the zone that FIRED the rule on the picture (`scene-boxes` / `clean`;
43765
+ * a `crop` never shows it). Valid only on a rule whose trigger is a zone —
43766
+ * `conditions.zones` or an occupancy zone — and refused on save otherwise.
43767
+ * Replaces `zoneCrop`.
43768
+ */
43769
+ showTriggerZone: boolean().optional(),
43770
+ /** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
43466
43771
  attach: _enum([
43467
43772
  "best",
43468
43773
  "best-matching",
43469
43774
  "keyFrame",
43470
43775
  "none"
43471
- ]).default("best"),
43472
- /** What the still shows. Absent = `cropped` (the historical `best` shape). */
43776
+ ]).optional(),
43777
+ /** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
43473
43778
  frame: NcMediaFrameSchema.optional(),
43474
- /** Crop the attached still to the rule's condition-zone bbox (padded) —
43475
- * "show me the ZONE", not the whole scene or the subject crop. */
43779
+ /** @deprecated D897 — folded into `image: 'clean'` + `showTriggerZone` on save. */
43476
43780
  zoneCrop: boolean().optional(),
43477
43781
  /**
43478
43782
  * Also attach a short GIF cut from the stream broker's clip ring around the
@@ -43644,7 +43948,9 @@ var NcRuleInputSchema = object({
43644
43948
  * targets.
43645
43949
  */
43646
43950
  targetUsers: array(string()).optional(),
43647
- media: NcMediaPolicySchema.default({ attach: "best" }),
43951
+ /** Absent = the kind's default picture (`resolveNcMediaImage`): the subject crop for a
43952
+ * detection, the clean scene for a sensor or a sound. Set explicitly on save (D897). */
43953
+ media: NcMediaPolicySchema.default({}),
43648
43954
  throttle: NcThrottleSchema.default({
43649
43955
  cooldownSec: 60,
43650
43956
  scope: "rule-device"
@@ -44581,13 +44887,37 @@ var NcAlarmModeOpeningsSchema = object({
44581
44887
  /** Covered devices whose state could not be read (D49): neither open nor closed. */
44582
44888
  unknown: array(number().int())
44583
44889
  });
44890
+ /**
44891
+ * One alarm INPUT — a (rule, device) pair — the operator bypassed until the
44892
+ * next disarm ("Bypass this input until disarm" on a trigger notification, or
44893
+ * `nc.bypassAlarmInput`). Reported so an armed alarm with a silenced input
44894
+ * never looks fully armed (D62: off must never look like broken).
44895
+ */
44896
+ var NcAlarmInputBypassViewSchema = object({
44897
+ ruleId: string(),
44898
+ /** The rule's current name (its frozen name when the rule is gone). */
44899
+ ruleName: string(),
44900
+ /** The input: the sensor of the match, else its camera. */
44901
+ deviceId: number().int(),
44902
+ /** The input's current name. */
44903
+ name: string(),
44904
+ /** When it was bypassed (ms epoch). */
44905
+ since: number(),
44906
+ /** Triggers from this input dropped since. */
44907
+ dropped: number().int().min(0)
44908
+ });
44584
44909
  var NcAlarmLiveSchema = object({
44585
44910
  state: AlarmStateSchema,
44586
44911
  /** The mode being armed into (exit delay) or held; null when disarmed. */
44587
44912
  targetMode: AlarmArmModeSchema.nullable(),
44588
44913
  availableModes: array(AlarmArmModeSchema),
44589
44914
  openings: array(NcAlarmModeOpeningsSchema),
44590
- exclusions: array(NcAlarmExclusionViewSchema)
44915
+ exclusions: array(NcAlarmExclusionViewSchema),
44916
+ /**
44917
+ * Inputs bypassed for the rest of this arm session; cleared on disarm.
44918
+ * Defaulted so an older hub answer still parses (as "none known").
44919
+ */
44920
+ bypassedInputs: array(NcAlarmInputBypassViewSchema).default([])
44591
44921
  });
44592
44922
  var NcAlarmConfigSchema = object({
44593
44923
  /**
@@ -61940,26 +62270,6 @@ var ApiKeySummarySchema = object({
61940
62270
  createdAt: number(),
61941
62271
  lastUsedAt: number().optional()
61942
62272
  });
61943
- var ScopedTokenSummarySchema = object({
61944
- id: string(),
61945
- userId: string(),
61946
- name: string(),
61947
- tokenPrefix: string(),
61948
- scopes: array(TokenScopeSchema),
61949
- expiresAt: number().nullish(),
61950
- lastUsedAt: number().nullish(),
61951
- createdAt: number()
61952
- });
61953
- var CreateScopedTokenInputSchema = object({
61954
- userId: string(),
61955
- name: string(),
61956
- scopes: array(TokenScopeSchema),
61957
- expiresAt: number().optional()
61958
- });
61959
- var CreateScopedTokenResultSchema = object({
61960
- token: string(),
61961
- record: ScopedTokenSummarySchema
61962
- });
61963
62273
  var OauthSessionSummarySchema = object({
61964
62274
  id: string(),
61965
62275
  userId: string(),
@@ -61981,11 +62291,11 @@ var TotpStatusSchema = object({
61981
62291
  confirmedAt: number().nullable()
61982
62292
  });
61983
62293
  /**
61984
- * user-management — singleton capability for user accounts, API keys,
61985
- * and scoped tokens.
62294
+ * user-management — singleton capability for user accounts and the
62295
+ * legacy API-key rows.
61986
62296
  *
61987
62297
  * v2 model: every method gated by `auth: 'admin'`. Admin-only delegation
61988
- * — the subset check on `setUserScopes` / `createScopedToken` is moot
62298
+ * — the subset check on `setUserScopes` is moot
61989
62299
  * because non-admins never reach these. If/when we open non-admin
61990
62300
  * delegation, structural caller-scope subset check goes inside the
61991
62301
  * provider.
@@ -62042,15 +62352,7 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(CreateUserI
62042
62352
  kind: "mutation",
62043
62353
  auth: "admin",
62044
62354
  access: "delete"
62045
- }), method(CreateScopedTokenInputSchema, CreateScopedTokenResultSchema, {
62046
- kind: "mutation",
62047
- auth: "admin",
62048
- access: "create"
62049
- }), method(object({ id: string() }), object({ success: literal(true) }), {
62050
- kind: "mutation",
62051
- auth: "admin",
62052
- access: "delete"
62053
- }), method(object({ token: string() }), ScopedTokenSummarySchema.nullable(), { access: "view" }), method(object({ userId: string() }), array(ScopedTokenSummarySchema), { auth: "admin" }), method(object({ userId: string() }), TotpSetupResultSchema, {
62355
+ }), method(object({ userId: string() }), TotpSetupResultSchema, {
62054
62356
  kind: "mutation",
62055
62357
  auth: "admin",
62056
62358
  access: "create"
@@ -66206,7 +66508,7 @@ Object.freeze({
66206
66508
  capName: "llm",
66207
66509
  capScope: "system",
66208
66510
  addonId: null,
66209
- access: "view"
66511
+ access: "create"
66210
66512
  },
66211
66513
  "llm.listNodeModels": {
66212
66514
  capName: "llm",
@@ -66508,7 +66810,19 @@ Object.freeze({
66508
66810
  addonId: null,
66509
66811
  access: "view"
66510
66812
  },
66511
- "logDestination.query": {
66813
+ "logDestination.cancelRead": {
66814
+ capName: "log-destination",
66815
+ capScope: "system",
66816
+ addonId: null,
66817
+ access: "create"
66818
+ },
66819
+ "logDestination.describeRead": {
66820
+ capName: "log-destination",
66821
+ capScope: "system",
66822
+ addonId: null,
66823
+ access: "view"
66824
+ },
66825
+ "logDestination.read": {
66512
66826
  capName: "log-destination",
66513
66827
  capScope: "system",
66514
66828
  addonId: null,
@@ -70870,12 +71184,6 @@ Object.freeze({
70870
71184
  addonId: null,
70871
71185
  access: "create"
70872
71186
  },
70873
- "userManagement.createScopedToken": {
70874
- capName: "user-management",
70875
- capScope: "system",
70876
- addonId: null,
70877
- access: "create"
70878
- },
70879
71187
  "userManagement.createUser": {
70880
71188
  capName: "user-management",
70881
71189
  capScope: "system",
@@ -70924,12 +71232,6 @@ Object.freeze({
70924
71232
  addonId: null,
70925
71233
  access: "view"
70926
71234
  },
70927
- "userManagement.listScopedTokens": {
70928
- capName: "user-management",
70929
- capScope: "system",
70930
- addonId: null,
70931
- access: "view"
70932
- },
70933
71235
  "userManagement.listUsers": {
70934
71236
  capName: "user-management",
70935
71237
  capScope: "system",
@@ -70984,12 +71286,6 @@ Object.freeze({
70984
71286
  addonId: null,
70985
71287
  access: "delete"
70986
71288
  },
70987
- "userManagement.revokeScopedToken": {
70988
- capName: "user-management",
70989
- capScope: "system",
70990
- addonId: null,
70991
- access: "delete"
70992
- },
70993
71289
  "userManagement.setupTotp": {
70994
71290
  capName: "user-management",
70995
71291
  capScope: "system",
@@ -71020,12 +71316,6 @@ Object.freeze({
71020
71316
  addonId: null,
71021
71317
  access: "view"
71022
71318
  },
71023
- "userManagement.validateScopedToken": {
71024
- capName: "user-management",
71025
- capScope: "system",
71026
- addonId: null,
71027
- access: "view"
71028
- },
71029
71319
  "userManagement.verifyTotp": {
71030
71320
  capName: "user-management",
71031
71321
  capScope: "system",
@@ -72539,6 +72829,11 @@ Object.freeze({
72539
72829
  form: "single",
72540
72830
  optional: false
72541
72831
  }],
72832
+ "logDestination.read": [{
72833
+ name: "deviceId",
72834
+ form: "single",
72835
+ optional: true
72836
+ }],
72542
72837
  "mediaPlayer.getStatus": [{
72543
72838
  name: "deviceId",
72544
72839
  form: "single",