@camstack/addon-export-google 0.1.96 → 0.1.98

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.
@@ -5488,7 +5488,7 @@ var ZodIssueCode = {
5488
5488
  var ZodFirstPartyTypeKind;
5489
5489
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5490
5490
  //#endregion
5491
- //#region ../types/dist/sleep-BxjU_fJM.mjs
5491
+ //#region ../types/dist/sleep-BSuCCFjf.mjs
5492
5492
  /**
5493
5493
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5494
5494
  * window to float samples (D455).
@@ -7871,9 +7871,9 @@ function normalizeAddonInitResult(result) {
7871
7871
  return result;
7872
7872
  }
7873
7873
  /**
7874
- * The share-view scope kinds a `csv_*` share token can carry. The hub mints
7875
- * and validates them (`share-token.service.ts` builds its enum from this
7876
- * list); a data plane names the kinds it ACCEPTS in `share`.
7874
+ * The share-view scope kinds a share-link token can carry. The hub mints
7875
+ * and validates them (`ShareViewGrantSchema` builds its
7876
+ * enum from this list); a data plane names the kinds it ACCEPTS in `share`.
7877
7877
  */
7878
7878
  var SHARE_VIEW_KINDS = ["grid-view", "events-view"];
7879
7879
  /** The wire shape of {@link PeerBytesTicket} — see the type for what it is. */
@@ -12638,7 +12638,7 @@ function scopesAllowDeviceCap(scopes, access) {
12638
12638
  * `super_admin` — collapsed onto the single boolean because every
12639
12639
  * non-admin caller is governed by the same scope-check rules; the
12640
12640
  * distinction was only ever used to route role-specific procedures
12641
- * which we no longer have. CLI / webhook integrations are `cst_*` tokens
12641
+ * which we no longer have. CLI / webhook integrations are tokens (`auth.mintToken`)
12642
12642
  * with `isAdmin: false` + an explicit scope list.
12643
12643
  */
12644
12644
  /** Per-method access flavour. Materialised on every cap method via codegen. */
@@ -12827,10 +12827,12 @@ var AddonRoutesScopeSchema = object({
12827
12827
  type: literal("addon-routes"),
12828
12828
  access: array(MethodAccessSchema).min(1)
12829
12829
  });
12830
+ var PreferencesSelfScopeSchema = object({ type: literal("preferences-self") });
12830
12831
  var CredentialScopeSchema = union([
12831
12832
  literal("*"),
12832
12833
  ShareViewScopeSchema,
12833
12834
  AddonRoutesScopeSchema,
12835
+ PreferencesSelfScopeSchema,
12834
12836
  TokenScopeSchema
12835
12837
  ]);
12836
12838
  object({
@@ -12839,6 +12841,55 @@ object({
12839
12841
  jti: string().min(16),
12840
12842
  scopes: array(CredentialScopeSchema).min(1)
12841
12843
  });
12844
+ var PreferenceNamespaceSchema = string().regex(/^[a-z][a-z0-9.-]{0,63}$/);
12845
+ /** A namespace's value: a JSON object, opaque to the hub. */
12846
+ var PreferenceValueSchema = record(string(), unknown());
12847
+ var PreferenceDeviceIdSchema = string().min(1).max(64);
12848
+ /** A stored row, as the owner reads it. */
12849
+ var PreferenceRowSchema = object({
12850
+ namespace: PreferenceNamespaceSchema,
12851
+ value: PreferenceValueSchema,
12852
+ /** Starts at 1, +1 on every write of this namespace. A delete ends the row and its count. */
12853
+ revision: number().int().positive(),
12854
+ updatedAt: number().int(),
12855
+ /** The client id the last writer sent; `null` when it sent none. */
12856
+ updatedByDevice: PreferenceDeviceIdSchema.nullable()
12857
+ });
12858
+ object({
12859
+ /** Absent: every namespace the caller holds. */
12860
+ namespaces: array(PreferenceNamespaceSchema).max(32).optional() });
12861
+ object({ rows: array(PreferenceRowSchema) });
12862
+ object({
12863
+ namespace: PreferenceNamespaceSchema,
12864
+ value: PreferenceValueSchema,
12865
+ /**
12866
+ * The revision the edit was based on. Absent: last write wins. `0`: the
12867
+ * namespace must not exist yet. Any other value that is not the current
12868
+ * revision answers `conflict` and writes nothing.
12869
+ */
12870
+ baseRevision: number().int().nonnegative().optional(),
12871
+ deviceId: PreferenceDeviceIdSchema.optional()
12872
+ });
12873
+ discriminatedUnion("status", [object({
12874
+ status: literal("saved"),
12875
+ row: PreferenceRowSchema
12876
+ }), object({
12877
+ status: literal("conflict"),
12878
+ current: PreferenceRowSchema.nullable()
12879
+ })]);
12880
+ object({ namespace: PreferenceNamespaceSchema });
12881
+ object({
12882
+ /** `false` when the namespace did not exist. */
12883
+ deleted: boolean() });
12884
+ object({
12885
+ /** The revision the client holds per namespace; a namespace it does not list is new to it. */
12886
+ revisionByNamespace: record(PreferenceNamespaceSchema, number().int().nonnegative()).refine((map) => Object.keys(map).length <= 32, { message: `at most 32 namespaces` }) });
12887
+ object({
12888
+ /** Every row whose revision differs from the client's, and every row it did not list. */
12889
+ rows: array(PreferenceRowSchema),
12890
+ /** Namespaces the client listed that no longer exist. */
12891
+ deleted: array(PreferenceNamespaceSchema)
12892
+ });
12842
12893
  _enum(["new-session", "step-up"]);
12843
12894
  /** The languages the hub's app landing pages are written in (D858). */
12844
12895
  var AppPageLangSchema = _enum(["en", "it"]);
@@ -17005,7 +17056,19 @@ var DeviceHistorySubjectSchema = discriminatedUnion("kind", [object({
17005
17056
  kind: literal("node"),
17006
17057
  nodeId: string().min(1)
17007
17058
  })]);
17059
+ /**
17060
+ * `enum` stores a STATE as the ordinal of its value in the series' value list
17061
+ * (`DeviceHistorySeriesInfo.values`, append-only, so an ordinal never changes
17062
+ * meaning); a rollup keeps the time spent in each state (`states`).
17063
+ */
17008
17064
  var DeviceHistoryKindSchema = _enum([
17065
+ "gauge",
17066
+ "counter",
17067
+ "boolean",
17068
+ "enum"
17069
+ ]);
17070
+ /** What a PRODUCER may declare. `enum` is cap-only: its value list is the cap field's. */
17071
+ var DeviceHistoryProducerKindSchema = _enum([
17009
17072
  "gauge",
17010
17073
  "counter",
17011
17074
  "boolean"
@@ -17042,7 +17105,13 @@ var SeriesInfoSchema = object({
17042
17105
  /** `null` is unknown (a `unitFrom` series whose device does not state a unit right now), never a guess. */
17043
17106
  unit: string().nullable(),
17044
17107
  displayName: string(),
17045
- source: _enum(["cap", "addon"]),
17108
+ source: _enum([
17109
+ "cap",
17110
+ "addon",
17111
+ "derived"
17112
+ ]),
17113
+ /** `enum`: the value of each ordinal (index = ordinal); `null` for every other kind. */
17114
+ values: array(string()).readonly().nullable(),
17046
17115
  firstTs: number(),
17047
17116
  lastTs: number()
17048
17117
  });
@@ -17056,17 +17125,31 @@ var QueryPointSchema = object({
17056
17125
  twMean: number().nullable(),
17057
17126
  min: number(),
17058
17127
  max: number(),
17059
- /** `null` is unknown, never zero (D393). */
17060
- last: number().nullable()
17128
+ /** `null` is unknown, never zero (D393). For an `enum` series: the ordinal of {@link state}. */
17129
+ last: number().nullable(),
17130
+ /**
17131
+ * The increase over the point: a `counter`'s growth since the previous point
17132
+ * or bucket (a drop is a reset, counted from zero), and for
17133
+ * {@link DEVICE_HISTORY_ENERGY_KEY} the kWh used in the bucket. `null` for
17134
+ * every other kind, and when it cannot be known.
17135
+ */
17136
+ delta: number().nullable(),
17137
+ /** `enum`: the state in force at the end of the point (the name of `last`); `null` otherwise. */
17138
+ state: string().nullable(),
17139
+ /** `enum` rollup: milliseconds spent in each state inside the bucket; `null` for raw points and other kinds. */
17140
+ states: record(string(), number()).nullable()
17061
17141
  });
17062
17142
  var QuerySeriesSchema = object({
17063
17143
  scope: string(),
17064
17144
  /** The last point STRICTLY BEFORE `from` in the chosen tier, so a step chart can start at the held value. */
17065
17145
  before: object({
17066
17146
  t: number(),
17067
- value: number().nullable()
17147
+ value: number().nullable(),
17148
+ state: string().nullable()
17068
17149
  }).nullable(),
17069
- points: array(QueryPointSchema).readonly()
17150
+ points: array(QueryPointSchema).readonly(),
17151
+ /** A derived key: the stored key its points were computed from; `null` for a stored series. */
17152
+ derivedFrom: string().nullable()
17070
17153
  });
17071
17154
  /** The window part of a query, shared by the device and node forms. */
17072
17155
  var QueryWindowShape = {
@@ -17082,6 +17165,23 @@ var QueryResultSchema = object({
17082
17165
  series: array(QuerySeriesSchema).readonly(),
17083
17166
  truncated: boolean()
17084
17167
  });
17168
+ /** One read of a batch: a device's key or a node's key (exactly one subject). */
17169
+ var QueryManyItemSchema = union([object({
17170
+ deviceId: number().int(),
17171
+ key: string(),
17172
+ scope: string().optional()
17173
+ }), object({
17174
+ forNodeId: string().min(1),
17175
+ key: string(),
17176
+ scope: string().optional()
17177
+ })]);
17178
+ var QueryManyEntrySchema = discriminatedUnion("ok", [object({
17179
+ ok: literal(true),
17180
+ result: QueryResultSchema
17181
+ }), object({
17182
+ ok: literal(false),
17183
+ error: string()
17184
+ })]);
17085
17185
  var TierStatusSchema = object({
17086
17186
  tier: DeviceHistoryResolutionSchema,
17087
17187
  /** `null` until the first background count answered. */
@@ -17137,16 +17237,22 @@ var DeviceHistoryStatusSchema = object({
17137
17237
  lastRefreshAt: number().nullable()
17138
17238
  })
17139
17239
  });
17140
- method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly()), method(object({ nodeId: string().min(1) }), array(SeriesInfoSchema).readonly(), { auth: "admin" }), method(object({
17240
+ method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly()), method(object({ forNodeId: string().min(1) }), array(SeriesInfoSchema).readonly(), { auth: "admin" }), method(object({
17141
17241
  deviceId: number().int(),
17142
17242
  ...QueryWindowShape
17143
17243
  }), QueryResultSchema), method(object({
17144
- nodeId: string().min(1),
17244
+ forNodeId: string().min(1),
17145
17245
  ...QueryWindowShape
17146
17246
  }), QueryResultSchema, { auth: "admin" }), method(object({
17247
+ items: array(QueryManyItemSchema).min(1).max(24),
17248
+ from: QueryWindowShape.from,
17249
+ to: QueryWindowShape.to,
17250
+ resolution: QueryWindowShape.resolution,
17251
+ maxPoints: QueryWindowShape.maxPoints
17252
+ }), object({ results: array(QueryManyEntrySchema).readonly() }), { auth: "admin" }), method(object({
17147
17253
  name: string().regex(/^[a-z0-9-]+$/),
17148
17254
  subjectKind: _enum(["device", "node"]),
17149
- kind: DeviceHistoryKindSchema,
17255
+ kind: DeviceHistoryProducerKindSchema,
17150
17256
  unit: string().optional(),
17151
17257
  displayName: string().min(1),
17152
17258
  ingest: _enum(["points", "buckets"])
@@ -39761,38 +39867,37 @@ method(LlmRuntimeCompleteInputSchema, LlmGenerateResultSchema, {
39761
39867
  auth: "admin",
39762
39868
  timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
39763
39869
  });
39870
+ var LlmProfileKindSchema = string().regex(/^[a-z0-9][a-z0-9-]{0,63}$/, "a kind id is lower-case letters, digits and dashes");
39871
+ /** What a model (or, by default, every model of a kind) can do. */
39872
+ var LlmModelFeaturesSchema = object({
39873
+ vision: boolean(),
39874
+ tools: boolean(),
39875
+ streaming: boolean()
39876
+ });
39877
+ /** One model a provider offers. `features` overrides the kind's defaults, per field. */
39878
+ var LlmModelInfoSchema = object({
39879
+ id: string(),
39880
+ label: string().optional(),
39881
+ contextLength: number().int().positive().optional(),
39882
+ features: LlmModelFeaturesSchema.partial().optional()
39883
+ });
39764
39884
  /**
39765
- * `llm` — consumer-facing LLM surface (spec §1-§3). Collection-mode: array
39766
- * methods concat-fan across providers; single-row methods route to ONE
39767
- * provider by the `addonId` in the call input (the notification-output
39768
- * posture, notification-output.cap.ts:215-250). Provided by `addon-ai`
39769
- * (hub-placed); the cap stays open for future providers.
39770
- *
39771
- * Profiles are ROWS (data), not addons: one row = one usable model endpoint.
39772
- * `apiKey` is a password field — providers REDACT it on read and merge on
39773
- * write; a stored key NEVER round-trips to a client.
39885
+ * The provider-specific part of a profile, validated by the provider that owns
39886
+ * the kind (`upsertProfile` refuses what it does not accept). A field its
39887
+ * `connectionSchema` declares `type: 'password'` is a secret: it is held in the
39888
+ * keychain, never in the row, and reads back as the redaction marker.
39774
39889
  */
39775
- var LlmProfileKindSchema = _enum([
39776
- "openai-compatible",
39777
- "openai",
39778
- "anthropic",
39779
- "google",
39780
- "managed-local",
39781
- "apple-foundation"
39782
- ]);
39890
+ var LlmProviderConfigSchema = record(string(), unknown());
39783
39891
  var LlmProfileSchema = object({
39784
39892
  id: string(),
39785
39893
  name: string(),
39894
+ /** The provider-declared kind (`LlmProfileKindDescriptor.kind`). */
39786
39895
  kind: LlmProfileKindSchema,
39787
39896
  /** Stamped by the provider — keeps the fanned catalog routable. */
39788
39897
  addonId: string(),
39789
39898
  enabled: boolean(),
39790
39899
  /** Vendor model id, or the managed runtime's loaded model. */
39791
39900
  model: string(),
39792
- /** Required for openai-compatible; override for cloud kinds. */
39793
- baseUrl: string().optional(),
39794
- /** ConfigUISchema type:'password' — never round-trips (spec §5). */
39795
- apiKey: string().optional(),
39796
39901
  /** Vision on/off. A vision call against a `false` profile is REFUSED, never
39797
39902
  * degraded to text — that shipped once and produced a confident answer to a
39798
39903
  * question about a picture nobody sent. */
@@ -39800,15 +39905,11 @@ var LlmProfileSchema = object({
39800
39905
  temperature: number().min(0).max(2).optional(),
39801
39906
  /** Nucleus sampling. Every wire we speak has it. */
39802
39907
  topP: number().min(0).max(1).optional(),
39803
- /** Top-k sampling. Carried only by the wires that have it — NEITHER OpenAI
39804
- * wire does, and the client drops it there (measured: the request body gets
39805
- * `top_p` and no `top_k`). The profile editor hides the field wherever it
39806
- * would change nothing; `KINDS_WITH_TOP_K` is the single owner of that list. */
39908
+ /** Top-k sampling. Carried only by the wires that have it — a kind offers the
39909
+ * field in its editor only when its descriptor lists it in `profileFields`. */
39807
39910
  topK: number().int().positive().optional(),
39808
39911
  maxTokens: number().int().positive().optional(),
39809
- /** Prompt context window. Advisory for cloud kinds (they enforce their own);
39810
- * for `managed-local` it is the llama.cpp `--ctx-size` the runtime starts
39811
- * the model with, so it is the one field that changes a PROCESS. */
39912
+ /** Prompt context window. Advisory for cloud kinds (they enforce their own). */
39812
39913
  contextLength: number().int().positive().optional(),
39813
39914
  /** Default system prompt. A caller's `system` REPLACES it (never appends —
39814
39915
  * two system prompts fighting is worse than either alone). */
@@ -39834,16 +39935,37 @@ var LlmProfileSchema = object({
39834
39935
  * library; the REGISTRY of callable tools is ours and is empty in v1, so a
39835
39936
  * `true` here buys the wiring, not behaviour, until tools are registered. */
39836
39937
  toolsEnabled: boolean().default(false),
39837
- extraHeaders: record(string(), string()).optional(),
39838
- /** kind === 'managed-local' only (spec §4). */
39839
- runtime: ManagedRuntimeConfigSchema.optional(),
39840
- /**
39841
- * kind === 'apple-foundation' only: WHERE it runs — the only thing there is
39842
- * to configure (no key, no URL, no download; `model` is `apple-system`).
39843
- * `supportsVision` on such a row is stamped by the provider from the node's
39844
- * reported `imageInput`, never taken from the operator (D62).
39845
- */
39846
- appleFoundation: object({ nodeId: string() }).optional()
39938
+ /** Everything the kind's provider owns (endpoint, key, node, runtime…). */
39939
+ providerConfig: LlmProviderConfigSchema.default({})
39940
+ });
39941
+ /**
39942
+ * The common profile fields a kind's editor offers. The editor owns how each
39943
+ * one is drawn; the provider says which of them mean something on its wire.
39944
+ */
39945
+ var LlmProfileFieldSchema = _enum([
39946
+ "temperature",
39947
+ "topP",
39948
+ "topK",
39949
+ "maxTokens",
39950
+ "contextLength",
39951
+ "systemPrompt",
39952
+ "timeoutMs",
39953
+ "connectTimeoutMs",
39954
+ "firstTokenTimeoutMs",
39955
+ "idleTimeoutMs",
39956
+ "retry",
39957
+ "toolsEnabled"
39958
+ ]);
39959
+ /**
39960
+ * A provider-drawn part of the editor, by a generic widget id the admin UI
39961
+ * registers (`ai/apple-node`). `placement: 'model'` replaces the generic model
39962
+ * picker: that widget owns the model choice.
39963
+ */
39964
+ var LlmProviderWidgetSchema = object({
39965
+ id: string(),
39966
+ placement: _enum(["connection", "model"]),
39967
+ /** `providerConfig` keys this widget must fill before the profile can be saved. */
39968
+ requires: array(string()).optional()
39847
39969
  });
39848
39970
  /** ConfigUISchema tree passed through untyped on the wire (the
39849
39971
  * notification-output `ConfigSchemaPassthrough` precedent at
@@ -39852,11 +39974,56 @@ var ConfigSchemaPassthrough$3 = unknown();
39852
39974
  var LlmProfileKindDescriptorSchema = object({
39853
39975
  kind: LlmProfileKindSchema,
39854
39976
  label: string(),
39977
+ /** A generic icon name (`cloud`, `plug`, `cpu`) — never a glyph or a logo. */
39855
39978
  icon: string(),
39856
39979
  /** Stamped by each provider so the concat-fanned catalog stays routable. */
39857
39980
  addonId: string(),
39858
- configSchema: ConfigSchemaPassthrough$3
39981
+ /** The provider's own fields (`providerConfig`); `password` fields are keychain-held. */
39982
+ connectionSchema: ConfigSchemaPassthrough$3,
39983
+ /** Provider fields that belong under "Advanced" (extra headers, runtime tuning). */
39984
+ advancedSchema: ConfigSchemaPassthrough$3.optional(),
39985
+ /** The kind's defaults; a model from `listModels` may override any of them. */
39986
+ features: LlmModelFeaturesSchema,
39987
+ /** `false` = the provider stamps `supportsVision` itself (from what a node reports). */
39988
+ visionEditable: boolean(),
39989
+ /** Where the model list comes from: `listModels`, `staticModels`, or nowhere. */
39990
+ modelCatalog: _enum([
39991
+ "fetch",
39992
+ "static",
39993
+ "none"
39994
+ ]),
39995
+ staticModels: array(LlmModelInfoSchema).optional(),
39996
+ /** The common fields that mean something on this kind's wire. */
39997
+ profileFields: array(LlmProfileFieldSchema),
39998
+ providerWidgets: array(LlmProviderWidgetSchema).optional()
39999
+ });
40000
+ /**
40001
+ * `listModels` input. `connection` is an UNSAVED draft of `providerConfig`
40002
+ * (the editor's form); with `profileId` too, a secret the draft leaves
40003
+ * untouched (absent or the redaction marker) is resolved server-side from the
40004
+ * stored profile — the browser never receives it.
40005
+ */
40006
+ var LlmListModelsInputSchema = object({
40007
+ addonId: string(),
40008
+ kind: LlmProfileKindSchema,
40009
+ profileId: string().optional(),
40010
+ connection: LlmProviderConfigSchema.optional()
39859
40011
  });
40012
+ var LlmListModelsErrorCodeSchema = _enum([
40013
+ "auth",
40014
+ "network",
40015
+ "unsupported",
40016
+ "invalid"
40017
+ ]);
40018
+ /** A RESULT, never a throw: "wrong key" is an answer the editor renders inline. */
40019
+ var LlmListModelsResultSchema = discriminatedUnion("ok", [object({
40020
+ ok: literal(true),
40021
+ models: array(LlmModelInfoSchema)
40022
+ }), object({
40023
+ ok: literal(false),
40024
+ code: LlmListModelsErrorCodeSchema,
40025
+ message: string()
40026
+ })]);
39860
40027
  var LlmDefaultSelectorSchema = union([object({ consumer: string() }), object({ purpose: _enum(["text", "vision"]) })]);
39861
40028
  var LlmDefaultSchema = object({
39862
40029
  selector: LlmDefaultSelectorSchema,
@@ -39956,7 +40123,10 @@ method(LlmGenerateBaseInputSchema, LlmGenerateResultSchema, {
39956
40123
  kind: "mutation",
39957
40124
  auth: "admin",
39958
40125
  timeoutMs: AI_CAP_TRANSPORT_TIMEOUT_MS
39959
- }), method(ProfileRefInputSchema, array(string())), method(object({}), array(LlmDefaultSchema)), method(object({
40126
+ }), method(LlmListModelsInputSchema, LlmListModelsResultSchema, {
40127
+ kind: "mutation",
40128
+ auth: "admin"
40129
+ }), method(object({}), array(LlmDefaultSchema)), method(object({
39960
40130
  selector: LlmDefaultSelectorSchema,
39961
40131
  profileId: string().nullable()
39962
40132
  }), _void(), {
@@ -40124,14 +40294,106 @@ var LogEntrySchema = object({
40124
40294
  meta: record(string(), unknown()).optional(),
40125
40295
  tags: record(string(), string()).optional()
40126
40296
  });
40127
- method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
40128
- scope: array(string()).optional(),
40297
+ /**
40298
+ * A history READ against one destination (D898).
40299
+ *
40300
+ * Every filter is applied by the PROVIDER, before the limit — a filter the
40301
+ * browser applied after the limit is what made a rare device's lines
40302
+ * unreachable behind a busy one's. `before` / `after` are cursors the provider
40303
+ * minted (opaque to everyone else): a file position for the rotated files, a
40304
+ * nanosecond timestamp for Loki.
40305
+ *
40306
+ * A read is BOUNDED by `budgetMs`: a filter that matches nothing on a 30-day
40307
+ * store answers `done: false` with the cursor it reached and the bytes it
40308
+ * scanned, and the caller decides whether to go on. That is what makes a long
40309
+ * scan show progress and stop when asked — `cancelRead` ends the slice in
40310
+ * flight, and not asking for the next slice ends the scan.
40311
+ */
40312
+ var LogReadQuerySchema = object({
40313
+ /** Correlates `cancelRead`. Caller-chosen, unique per in-flight read. */
40314
+ requestId: string().min(1).max(64).optional(),
40315
+ /** The device the line is about (`tags.deviceId`, numeric). */
40316
+ deviceId: number().int().optional(),
40317
+ /**
40318
+ * The emitting addon — bare manifest id; `@<version>` / `::<sub>` suffixes
40319
+ * match. Not `addonId`: a cap router reads that name as "which provider".
40320
+ */
40321
+ fromAddonId: string().min(1).max(200).optional(),
40322
+ /**
40323
+ * The emitting node: matches the agent that emitted the line, the node
40324
+ * itself, or a worker under it (`<agent>/<runner>`) — the `agentId`
40325
+ * semantics of `matchesLogTags`. Not `nodeId`: a cap router reads that
40326
+ * name as "which node's provider".
40327
+ */
40328
+ fromNodeId: string().min(1).max(200).optional(),
40329
+ /** Any other tag, exact match (AND). */
40330
+ tags: record(string(), union([string(), number()])).optional(),
40331
+ /** Severity FLOOR: this level and above. */
40129
40332
  level: LogLevelSchema.optional(),
40130
- since: date().optional(),
40131
- until: date().optional(),
40132
- limit: number().optional(),
40133
- tags: record(string(), string()).optional()
40134
- }), array(LogEntrySchema).readonly());
40333
+ /** Case-insensitive substring over message, scope, tag values and meta values. */
40334
+ text: string().min(1).max(200).optional(),
40335
+ /** Epoch ms, inclusive. */
40336
+ since: number().optional(),
40337
+ /** Epoch ms, inclusive. */
40338
+ until: number().optional(),
40339
+ /** Older than this cursor (exclusive). Absent with `after` absent ⇒ from the newest. */
40340
+ before: string().min(1).max(1024).optional(),
40341
+ /** Newer than this cursor (exclusive). */
40342
+ after: string().min(1).max(1024).optional(),
40343
+ limit: number().int().min(1).max(1e3).optional(),
40344
+ /** Wall-clock bound of this slice. The provider caps it. */
40345
+ budgetMs: number().int().min(50).max(1e4).optional()
40346
+ });
40347
+ var LogReadResultSchema = object({
40348
+ /** Newest first. */
40349
+ entries: array(object({
40350
+ /** `<bootId>.<seq>` minted by the emitting LogManager — the dedupe key. */
40351
+ id: string().optional(),
40352
+ /** Epoch ms. */
40353
+ timestamp: number(),
40354
+ level: LogLevelSchema,
40355
+ scope: string().optional(),
40356
+ message: string(),
40357
+ tags: record(string(), union([string(), number()])).optional(),
40358
+ meta: record(string(), unknown()).optional()
40359
+ })),
40360
+ /** Pass as `before` for the next older page; null when nothing older exists. */
40361
+ nextBefore: string().nullable(),
40362
+ /** Pass as `after` to read what arrived since; null when unknown. */
40363
+ nextAfter: string().nullable(),
40364
+ /** Bytes this slice read (files) or received (remote). Progress, not a promise. */
40365
+ scannedBytes: number().int().nonnegative(),
40366
+ /**
40367
+ * True when the scan in this direction reached the end of the store.
40368
+ * False with fewer than `limit` entries means the budget ran out first —
40369
+ * call again with `nextBefore` to go on.
40370
+ */
40371
+ done: boolean(),
40372
+ /** True when `cancelRead` ended this slice early. */
40373
+ cancelled: boolean().optional()
40374
+ });
40375
+ var LogReadCapabilitiesSchema = object({
40376
+ /** False ⇒ this destination only ships lines (console, forwarder, an unconfigured Loki). */
40377
+ readable: boolean(),
40378
+ /** Why not, when `readable` is false — rendered next to the source. */
40379
+ reason: string().nullable(),
40380
+ /** Filters the provider applies itself. A false one is applied by nobody. */
40381
+ filters: object({
40382
+ deviceId: boolean(),
40383
+ addonId: boolean(),
40384
+ nodeId: boolean(),
40385
+ tags: boolean(),
40386
+ level: boolean(),
40387
+ text: boolean(),
40388
+ timeRange: boolean()
40389
+ }),
40390
+ /** How far back the store reaches, when the provider knows (days). */
40391
+ retentionDays: number().nullable()
40392
+ });
40393
+ 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() }), {
40394
+ kind: "mutation",
40395
+ auth: "admin"
40396
+ });
40135
40397
  /**
40136
40398
  * `login-method` — collection cap through which auth addons contribute
40137
40399
  * their pre-auth login surfaces to the login page. This is the SINGLE,
@@ -42687,6 +42949,33 @@ var NcRuleTargetSchema = object({
42687
42949
  params: record(string(), unknown()).optional()
42688
42950
  });
42689
42951
  /**
42952
+ * WHAT THE NOTIFICATION'S PICTURE IS (D897) — the ONE media choice of a rule.
42953
+ *
42954
+ * Every mode starts from the same CLEAN source frame of the trigger moment
42955
+ * (keyFrame → sceneFrame → lastSceneFrame, narrowed to the trigger instant and
42956
+ * to the zone that fired the rule) and renders it once at send time:
42957
+ * - `scene-boxes` — the whole scene, the subject outlined thick in the accent
42958
+ * colour and every OTHER track visible at that instant outlined thin, each
42959
+ * labelled with class and confidence ("dog 87%").
42960
+ * - `crop` — the subject cut out of that frame around its box at that instant.
42961
+ * - `clean` — the whole scene with nothing drawn on it.
42962
+ * - `none` — no picture.
42963
+ *
42964
+ * A mode that cannot be honoured (no box at that instant, a photograph with no
42965
+ * tracked subject) ships `clean` and names the reason in the log, per camera.
42966
+ * It replaces the `attach` × `frame` × `zoneCrop` triple, which let one rule
42967
+ * ship a crop on one event and a boxed scene on the next depending on which
42968
+ * stored kind had landed.
42969
+ */
42970
+ var NcMediaImageSchema = _enum([
42971
+ "scene-boxes",
42972
+ "crop",
42973
+ "clean",
42974
+ "none"
42975
+ ]);
42976
+ /**
42977
+ * @deprecated Read only by `normalizeNcMediaPolicy` (D897) — see {@link NcMediaImageSchema}.
42978
+ *
42690
42979
  * Media attachment policy (P1 still-image subset).
42691
42980
  * - `best` — the best AVAILABLE subject image at dispatch time (D-3).
42692
42981
  * - `best-matching` — the media that explains WHY the rule fired: a rule
@@ -42700,6 +42989,8 @@ var NcRuleTargetSchema = object({
42700
42989
  * - `none` — no attachment.
42701
42990
  */
42702
42991
  /**
42992
+ * @deprecated Read only by `normalizeNcMediaPolicy` (D897) — see {@link NcMediaImageSchema}.
42993
+ *
42703
42994
  * WHAT THE PICTURE SHOWS — chosen explicitly, because the implicit ladders
42704
42995
  * conflate it with the selection strategy and betray the request: asking for
42705
42996
  * the clean scene frame on an object-event owner used to start at
@@ -42728,16 +43019,29 @@ var NcMediaFrameSchema = _enum([
42728
43019
  */
42729
43020
  var NcLinkedCameraModeSchema = _enum(["mosaic", "each"]);
42730
43021
  var NcMediaPolicySchema = object({
43022
+ /**
43023
+ * The picture — see {@link NcMediaImageSchema}. Absent on a rule nobody has
43024
+ * saved since D897: `normalizeNcMediaPolicy` derives it from the legacy
43025
+ * triple below, at load and at every write, and the store keeps only this.
43026
+ */
43027
+ image: NcMediaImageSchema.optional(),
43028
+ /**
43029
+ * Draw the zone that FIRED the rule on the picture (`scene-boxes` / `clean`;
43030
+ * a `crop` never shows it). Valid only on a rule whose trigger is a zone —
43031
+ * `conditions.zones` or an occupancy zone — and refused on save otherwise.
43032
+ * Replaces `zoneCrop`.
43033
+ */
43034
+ showTriggerZone: boolean().optional(),
43035
+ /** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
42731
43036
  attach: _enum([
42732
43037
  "best",
42733
43038
  "best-matching",
42734
43039
  "keyFrame",
42735
43040
  "none"
42736
- ]).default("best"),
42737
- /** What the still shows. Absent = `cropped` (the historical `best` shape). */
43041
+ ]).optional(),
43042
+ /** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
42738
43043
  frame: NcMediaFrameSchema.optional(),
42739
- /** Crop the attached still to the rule's condition-zone bbox (padded) —
42740
- * "show me the ZONE", not the whole scene or the subject crop. */
43044
+ /** @deprecated D897 — folded into `image: 'clean'` + `showTriggerZone` on save. */
42741
43045
  zoneCrop: boolean().optional(),
42742
43046
  /**
42743
43047
  * Also attach a short GIF cut from the stream broker's clip ring around the
@@ -42909,7 +43213,9 @@ var NcRuleInputSchema = object({
42909
43213
  * targets.
42910
43214
  */
42911
43215
  targetUsers: array(string()).optional(),
42912
- media: NcMediaPolicySchema.default({ attach: "best" }),
43216
+ /** Absent = the kind's default picture (`resolveNcMediaImage`): the subject crop for a
43217
+ * detection, the clean scene for a sensor or a sound. Set explicitly on save (D897). */
43218
+ media: NcMediaPolicySchema.default({}),
42913
43219
  throttle: NcThrottleSchema.default({
42914
43220
  cooldownSec: 60,
42915
43221
  scope: "rule-device"
@@ -43846,13 +44152,37 @@ var NcAlarmModeOpeningsSchema = object({
43846
44152
  /** Covered devices whose state could not be read (D49): neither open nor closed. */
43847
44153
  unknown: array(number().int())
43848
44154
  });
44155
+ /**
44156
+ * One alarm INPUT — a (rule, device) pair — the operator bypassed until the
44157
+ * next disarm ("Bypass this input until disarm" on a trigger notification, or
44158
+ * `nc.bypassAlarmInput`). Reported so an armed alarm with a silenced input
44159
+ * never looks fully armed (D62: off must never look like broken).
44160
+ */
44161
+ var NcAlarmInputBypassViewSchema = object({
44162
+ ruleId: string(),
44163
+ /** The rule's current name (its frozen name when the rule is gone). */
44164
+ ruleName: string(),
44165
+ /** The input: the sensor of the match, else its camera. */
44166
+ deviceId: number().int(),
44167
+ /** The input's current name. */
44168
+ name: string(),
44169
+ /** When it was bypassed (ms epoch). */
44170
+ since: number(),
44171
+ /** Triggers from this input dropped since. */
44172
+ dropped: number().int().min(0)
44173
+ });
43849
44174
  var NcAlarmLiveSchema = object({
43850
44175
  state: AlarmStateSchema,
43851
44176
  /** The mode being armed into (exit delay) or held; null when disarmed. */
43852
44177
  targetMode: AlarmArmModeSchema.nullable(),
43853
44178
  availableModes: array(AlarmArmModeSchema),
43854
44179
  openings: array(NcAlarmModeOpeningsSchema),
43855
- exclusions: array(NcAlarmExclusionViewSchema)
44180
+ exclusions: array(NcAlarmExclusionViewSchema),
44181
+ /**
44182
+ * Inputs bypassed for the rest of this arm session; cleared on disarm.
44183
+ * Defaulted so an older hub answer still parses (as "none known").
44184
+ */
44185
+ bypassedInputs: array(NcAlarmInputBypassViewSchema).default([])
43856
44186
  });
43857
44187
  var NcAlarmConfigSchema = object({
43858
44188
  /**
@@ -60986,26 +61316,6 @@ var ApiKeySummarySchema = object({
60986
61316
  createdAt: number(),
60987
61317
  lastUsedAt: number().optional()
60988
61318
  });
60989
- var ScopedTokenSummarySchema = object({
60990
- id: string(),
60991
- userId: string(),
60992
- name: string(),
60993
- tokenPrefix: string(),
60994
- scopes: array(TokenScopeSchema),
60995
- expiresAt: number().nullish(),
60996
- lastUsedAt: number().nullish(),
60997
- createdAt: number()
60998
- });
60999
- var CreateScopedTokenInputSchema = object({
61000
- userId: string(),
61001
- name: string(),
61002
- scopes: array(TokenScopeSchema),
61003
- expiresAt: number().optional()
61004
- });
61005
- var CreateScopedTokenResultSchema = object({
61006
- token: string(),
61007
- record: ScopedTokenSummarySchema
61008
- });
61009
61319
  var OauthSessionSummarySchema = object({
61010
61320
  id: string(),
61011
61321
  userId: string(),
@@ -61027,11 +61337,11 @@ var TotpStatusSchema = object({
61027
61337
  confirmedAt: number().nullable()
61028
61338
  });
61029
61339
  /**
61030
- * user-management — singleton capability for user accounts, API keys,
61031
- * and scoped tokens.
61340
+ * user-management — singleton capability for user accounts and the
61341
+ * legacy API-key rows.
61032
61342
  *
61033
61343
  * v2 model: every method gated by `auth: 'admin'`. Admin-only delegation
61034
- * — the subset check on `setUserScopes` / `createScopedToken` is moot
61344
+ * — the subset check on `setUserScopes` is moot
61035
61345
  * because non-admins never reach these. If/when we open non-admin
61036
61346
  * delegation, structural caller-scope subset check goes inside the
61037
61347
  * provider.
@@ -61088,15 +61398,7 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(CreateUserI
61088
61398
  kind: "mutation",
61089
61399
  auth: "admin",
61090
61400
  access: "delete"
61091
- }), method(CreateScopedTokenInputSchema, CreateScopedTokenResultSchema, {
61092
- kind: "mutation",
61093
- auth: "admin",
61094
- access: "create"
61095
- }), method(object({ id: string() }), object({ success: literal(true) }), {
61096
- kind: "mutation",
61097
- auth: "admin",
61098
- access: "delete"
61099
- }), method(object({ token: string() }), ScopedTokenSummarySchema.nullable(), { access: "view" }), method(object({ userId: string() }), array(ScopedTokenSummarySchema), { auth: "admin" }), method(object({ userId: string() }), TotpSetupResultSchema, {
61401
+ }), method(object({ userId: string() }), TotpSetupResultSchema, {
61100
61402
  kind: "mutation",
61101
61403
  auth: "admin",
61102
61404
  access: "create"
@@ -65252,7 +65554,7 @@ Object.freeze({
65252
65554
  capName: "llm",
65253
65555
  capScope: "system",
65254
65556
  addonId: null,
65255
- access: "view"
65557
+ access: "create"
65256
65558
  },
65257
65559
  "llm.listNodeModels": {
65258
65560
  capName: "llm",
@@ -65554,7 +65856,19 @@ Object.freeze({
65554
65856
  addonId: null,
65555
65857
  access: "view"
65556
65858
  },
65557
- "logDestination.query": {
65859
+ "logDestination.cancelRead": {
65860
+ capName: "log-destination",
65861
+ capScope: "system",
65862
+ addonId: null,
65863
+ access: "create"
65864
+ },
65865
+ "logDestination.describeRead": {
65866
+ capName: "log-destination",
65867
+ capScope: "system",
65868
+ addonId: null,
65869
+ access: "view"
65870
+ },
65871
+ "logDestination.read": {
65558
65872
  capName: "log-destination",
65559
65873
  capScope: "system",
65560
65874
  addonId: null,
@@ -69916,12 +70230,6 @@ Object.freeze({
69916
70230
  addonId: null,
69917
70231
  access: "create"
69918
70232
  },
69919
- "userManagement.createScopedToken": {
69920
- capName: "user-management",
69921
- capScope: "system",
69922
- addonId: null,
69923
- access: "create"
69924
- },
69925
70233
  "userManagement.createUser": {
69926
70234
  capName: "user-management",
69927
70235
  capScope: "system",
@@ -69970,12 +70278,6 @@ Object.freeze({
69970
70278
  addonId: null,
69971
70279
  access: "view"
69972
70280
  },
69973
- "userManagement.listScopedTokens": {
69974
- capName: "user-management",
69975
- capScope: "system",
69976
- addonId: null,
69977
- access: "view"
69978
- },
69979
70281
  "userManagement.listUsers": {
69980
70282
  capName: "user-management",
69981
70283
  capScope: "system",
@@ -70030,12 +70332,6 @@ Object.freeze({
70030
70332
  addonId: null,
70031
70333
  access: "delete"
70032
70334
  },
70033
- "userManagement.revokeScopedToken": {
70034
- capName: "user-management",
70035
- capScope: "system",
70036
- addonId: null,
70037
- access: "delete"
70038
- },
70039
70335
  "userManagement.setupTotp": {
70040
70336
  capName: "user-management",
70041
70337
  capScope: "system",
@@ -70066,12 +70362,6 @@ Object.freeze({
70066
70362
  addonId: null,
70067
70363
  access: "view"
70068
70364
  },
70069
- "userManagement.validateScopedToken": {
70070
- capName: "user-management",
70071
- capScope: "system",
70072
- addonId: null,
70073
- access: "view"
70074
- },
70075
70365
  "userManagement.verifyTotp": {
70076
70366
  capName: "user-management",
70077
70367
  capScope: "system",
@@ -71585,6 +71875,11 @@ Object.freeze({
71585
71875
  form: "single",
71586
71876
  optional: false
71587
71877
  }],
71878
+ "logDestination.read": [{
71879
+ name: "deviceId",
71880
+ form: "single",
71881
+ optional: true
71882
+ }],
71588
71883
  "mediaPlayer.getStatus": [{
71589
71884
  name: "deviceId",
71590
71885
  form: "single",