@lessly/sdk-app 76.0.0 → 77.0.0

package/src/gen/types.gen.ts

@@ -65652,13 +65652,7 @@ export interface BrainCognitionDigestInput {
 }
 
 export interface BrainCognitionDigestOutput {
-/**
- * Id of the queued run. The completion event carries the same `run_id`, which is how a waiting step ties the event back to this call; brain_cognition_status reports the same run.
- */
 run_id: string
-/**
- * Always true — the run was queued. The call fails outright rather than reporting a false here.
- */
 accepted: true
 }
 
@@ -65697,13 +65691,7 @@ export interface BrainCognitionSweepInput {
 }
 
 export interface BrainCognitionSweepOutput {
-/**
- * Id of the queued run. The completion event carries the same `run_id`, which is how a waiting step ties the event back to this call; brain_cognition_status reports the same run.
- */
 run_id: string
-/**
- * Always true — the run was queued. The call fails outright rather than reporting a false here.
- */
 accepted: true
 }
 
@@ -65741,9 +65729,6 @@ defaultBranch: string
 }[]
 
 export interface BrainDaemonBatchStatusInput {
-/**
- * Id of the ingestion daemon to act on, as returned by brain_daemons_list
- */
 id: string
 }
 
@@ -65831,9 +65816,6 @@ unmeasuredCount: number
 }
 
 export interface BrainDaemonGetInput {
-/**
- * Id of the ingestion daemon to act on, as returned by brain_daemons_list
- */
 id: string
 }
 
@@ -65859,13 +65841,8 @@ unmeasuredCount: number
 }
 
 export interface BrainDaemonReingestInput {
-/**
- * Id of the ingestion daemon that owns these documents, as returned by brain_daemons_list
- */
 id: string
 /**
- * Source paths to re-ingest, exactly as the daemon recorded them (a repo path such as docs/spec.md, a Drive file id, a ClickUp item id). 1-100 per call.
- * 
  * @minItems 1
  * @maxItems 100
  */
@@ -65873,36 +65850,14 @@ paths: [string, ...(string)[]]
 }
 
 export interface BrainDaemonReingestOutput {
-/**
- * The run started to pick the cleared paths up — brain/daemon.run-completed for this id is what finishes the step. Null when no run was started (see triggered/triggerError).
- */
-runId: (string | null)
-/**
- * Paths whose ingest state was cleared, so the next run will read them again from scratch
- */
 cleared: string[]
-/**
- * Paths this daemon has no ingest record for — usually a typo, or a document it never ingested
- */
 notFound: string[]
-/**
- * True when a run was started to pick the cleared paths up; false when the daemon is paused, a run is already in flight, or nothing was eligible
- */
 triggered: boolean
-/**
- * Why no run was started; absent when one was
- */
 triggerError?: string
-/**
- * Paths left alone because they are in an unfinished batch; re-ask once that run has finished
- */
 skippedPending: string[]
 }
 
 export interface BrainDaemonRemoveInput {
-/**
- * Id of the ingestion daemon to act on, as returned by brain_daemons_list
- */
 id: string
 }
 
@@ -65911,107 +65866,32 @@ ok: true
 }
 
 export interface BrainDaemonRunInput {
-/**
- * Id of the ingestion daemon to act on, as returned by brain_daemons_list
- */
 id: string
 }
 
 export interface BrainDaemonRunOutput {
-/**
- * True once the run has finished, whether it succeeded or failed
- */
 done: boolean
-/**
- * Id of the run being reported; null when this daemon has never run
- */
 runId: (string | null)
-/**
- * Where the run stands: 'queued' waiting to start, 'running' in progress, 'done' finished, 'failed' gave up, 'none' this daemon has never run
- */
 status: ("queued" | "running" | "done" | "failed" | "none")
-/**
- * Per-source progress as the connector reported it; the shape differs by connector type and is meant for display, not for binding a step to
- */
 sources: unknown[]
-/**
- * Document counts for the run; null when nothing has been counted yet
- */
 progress: ({
-/**
- * Totals for the whole run
- */
-counts: {
-/**
- * Documents that failed after retries — transient failures, worth re-running
- */
-error: number
-/**
- * Documents the source permanently refused (403/404/401) — a permissions or deletion problem, not a transient one
- */
-denied: number
-/**
- * Of those, how many were downloaded
- */
-fetched: number
-/**
- * Of those, how many became memories
- */
-ingested: number
-/**
- * Documents the run found at the source
- */
-discovered: number
-/**
- * Documents skipped because their content had not changed since the last run
- */
-skippedUnchanged: number
-}
-/**
- * The same totals split by source category; the keys are the connector's own (github: markdown/issues/pulls, clickup: tasks/comments/docs/chat, gdrive: files)
- */
+counts: BrainDaemonRunOutputCounts
 byCategory: {
-[k: string]: {
-/**
- * Documents that failed after retries — transient failures, worth re-running
- */
+[k: string]: BrainDaemonRunOutputCounts
+}
+} | null)
+routedTo: ("realtime" | "batch")
+triggered: boolean
+triggerError?: string
+}
+export interface BrainDaemonRunOutputCounts {
 error: number
-/**
- * Documents the source permanently refused (403/404/401) — a permissions or deletion problem, not a transient one
- */
 denied: number
-/**
- * Of those, how many were downloaded
- */
 fetched: number
-/**
- * Of those, how many became memories
- */
 ingested: number
-/**
- * Documents the run found at the source
- */
 discovered: number
-/**
- * Documents skipped because their content had not changed since the last run
- */
 skippedUnchanged: number
 }
-}
-} | null)
-/**
- * Which lane the run went to: 'realtime' finishes in minutes, 'batch' queues the work with the model provider and can take hours
- */
-routedTo: ("realtime" | "batch")
-/**
- * True when this call actually started a run; false when one was already in flight and nothing new was started
- */
-triggered: boolean
-/**
- * Why the run could not be started; absent when it was started
- */
-triggerError?: string
-}
 
 export interface BrainDaemonRunItemsInput {
 limit?: number
@@ -66031,212 +65911,68 @@ sourceKind: string
 }[]
 runId: string
 counts: {
-/**
- * Documents that failed after retries — transient failures, worth re-running
- */
 error: number
-/**
- * Documents the source permanently refused (403/404/401) — a permissions or deletion problem, not a transient one
- */
 denied: number
-/**
- * Of those, how many were downloaded
- */
 fetched: number
-/**
- * Of those, how many became memories
- */
 ingested: number
-/**
- * Documents the run found at the source
- */
 discovered: number
-/**
- * Documents skipped because their content had not changed since the last run
- */
 skippedUnchanged: number
 }
 nextCursor: (string | null)
 }
 
 export interface BrainDaemonRunsInput {
-/**
- * Id of the ingestion daemon whose run history to read, as returned by brain_daemons_list
- */
 id: string
-/**
- * How many of the most recent runs to return (default 20, max 100)
- */
 limit?: number
 }
 
 export interface BrainDaemonRunsOutput {
-/**
- * The most recent runs, newest first
- */
 runs: {
-/**
- * How the run was carried out: 'realtime' inline, 'batch' through the model provider's batch queue, 'reclaimed' a stalled run closed out by the janitor
- */
 lane: ("realtime" | "batch" | "reclaimed")
-/**
- * Id of this run
- */
 runId: string
-/**
- * Document counts for this run
- */
 counts: {
-/**
- * Documents that failed after retries — transient failures, worth re-running
- */
 error: number
-/**
- * Documents the source permanently refused (403/404/401) — a permissions or deletion problem, not a transient one
- */
 denied: number
-/**
- * Of those, how many were downloaded
- */
 fetched: number
-/**
- * Of those, how many became memories
- */
 ingested: number
-/**
- * Documents the run found at the source
- */
 discovered: number
-/**
- * Documents skipped because their content had not changed since the last run
- */
 skippedUnchanged: number
 }
-/**
- * Where the run ended up — 'queued', 'running', 'done' or 'failed'
- */
 status: string
-/**
- * How a batch run finished, in the batch pipeline's own words (e.g. finalized, timeout, crash); null for a realtime run
- */
 outcome: (string | null)
-/**
- * When the run started, ISO 8601 timestamp
- */
 startedAt: string
-/**
- * Documents that failed after retries during this run
- */
 errorCount: number
-/**
- * When the run finished, ISO 8601 timestamp; null while it is still going
- */
 finishedAt: (string | null)
-/**
- * Documents the source permanently refused during this run
- */
 deniedCount: number
-/**
- * Documents stored as raw text because the extraction step failed — NULL MEANS NOT MEASURED, never "clean": only realtime runs measure this, so every batch and reclaimed run reports null
- */
 degradedCount: (number | null)
 }[]
-/**
- * Id of the daemon these runs belong to
- */
 daemonId: string
 }
 
 export interface BrainDaemonStatusInput {
-/**
- * Id of the ingestion daemon to act on, as returned by brain_daemons_list
- */
 id: string
 }
 
 export interface BrainDaemonStatusOutput {
-/**
- * True once the run has finished, whether it succeeded or failed
- */
 done: boolean
-/**
- * Id of the run being reported; null when this daemon has never run
- */
 runId: (string | null)
-/**
- * Where the run stands: 'queued' waiting to start, 'running' in progress, 'done' finished, 'failed' gave up, 'none' this daemon has never run
- */
 status: ("queued" | "running" | "done" | "failed" | "none")
-/**
- * Per-source progress as the connector reported it; the shape differs by connector type and is meant for display, not for binding a step to
- */
 sources: unknown[]
-/**
- * Document counts for the run; null when nothing has been counted yet
- */
 progress: ({
-/**
- * Totals for the whole run
- */
-counts: {
-/**
- * Documents that failed after retries — transient failures, worth re-running
- */
-error: number
-/**
- * Documents the source permanently refused (403/404/401) — a permissions or deletion problem, not a transient one
- */
-denied: number
-/**
- * Of those, how many were downloaded
- */
-fetched: number
-/**
- * Of those, how many became memories
- */
-ingested: number
-/**
- * Documents the run found at the source
- */
-discovered: number
-/**
- * Documents skipped because their content had not changed since the last run
- */
-skippedUnchanged: number
-}
-/**
- * The same totals split by source category; the keys are the connector's own (github: markdown/issues/pulls, clickup: tasks/comments/docs/chat, gdrive: files)
- */
+counts: BrainDaemonStatusOutputCounts
 byCategory: {
-[k: string]: {
-/**
- * Documents that failed after retries — transient failures, worth re-running
- */
+[k: string]: BrainDaemonStatusOutputCounts
+}
+} | null)
+}
+export interface BrainDaemonStatusOutputCounts {
 error: number
-/**
- * Documents the source permanently refused (403/404/401) — a permissions or deletion problem, not a transient one
- */
 denied: number
-/**
- * Of those, how many were downloaded
- */
 fetched: number
-/**
- * Of those, how many became memories
- */
 ingested: number
-/**
- * Documents the run found at the source
- */
 discovered: number
-/**
- * Documents skipped because their content had not changed since the last run
- */
 skippedUnchanged: number
 }
-}
-} | null)
-}
 
 export interface BrainDaemonUpdateInput {
 id: string
@@ -66332,121 +66068,46 @@ entity_ref: string
 }
 
 export interface BrainKnowledgeEntityMemoriesOutput {
-/**
- * How many memories back this entity in total, across all pages
- */
 total: number
-/**
- * The entity the memories belong to; null when `entity_ref` matched nothing
- */
 entity: ({
-/**
- * How closely this entity matches the query, higher is closer; absent on an unscored read such as a plain type filter
- */
 score?: number
-/**
- * Other names the same entity appears under in the ingested text
- */
 aliases: string[]
-/**
- * Id of this entity; pass it as `entity_ref` to brain_knowledge_neighborhood or brain_knowledge_entity_memories
- */
 entity_id: string
-/**
- * What the entity is, as the engine summarised it from the memories mentioning it; null when it has not written one
- */
 description: (string | null)
-/**
- * Ontology type of the entity, e.g. Feature, Decision, Risk, Integration
- */
 entity_type: string
-/**
- * The name to show a person — usually the spelling the source text used
- */
 display_name: string
-/**
- * The one name this entity is stored under; use it when matching entities against each other
- */
 canonical_name: string
-/**
- * How many memories mention this entity — a rough measure of how well attested it is
- */
 evidence_count: number
 } | null)
-/**
- * One page of the memories this entity was drawn from — the same shape brain_memory_list returns
- */
 memories: {
 /**
  * Consumer-facing label derived from the layer; 'unknown' for an unrecognised layer
  */
 kind: ("schema" | "intention" | "identity" | "basic" | "fact" | "summary" | "knowledge" | "raw" | "unknown")
-/**
- * Engine tags on this memory; empty when it carries none
- */
 tags: string[]
 /**
  * Engine memory layer (l0_basic_info…l7_intention)
  */
 layer: ("l6_schema" | "l7_intention" | "l4_identity" | "l0_basic_info" | "l2_fact" | "l3_summary" | "l5_knowledge" | "l1_raw")
-/**
- * Free-form metadata, verbatim as the writer passed brain_memory_add's `metadata`; keys are the caller's
- */
 custom: {
 [k: string]: unknown
 }
-/**
- * Engine lifecycle status of the row — 'active' for a memory in use; superseded rows are not listed
- */
 status: string
-/**
- * The memory text itself
- */
 content: string
-/**
- * Engine user namespace the memory was written under
- */
 user_id: string
-/**
- * Engine agent namespace the memory was written under — the shared pool for a 'shared' write, the caller's own for a private one
- */
 agent_id: string
-/**
- * When the remembered EVENT happened, epoch milliseconds; null when the writer stated no time
- */
 memory_at: (number | null)
-/**
- * Engine id of this memory; pass it to brain_memory_get, _update or _delete
- */
 memory_id: string
-/**
- * The engine's own inference about this memory, or null when it recorded none
- */
 speculate: (string | null)
-/**
- * Engine session the memory was written in; empty when the writer opened none
- */
 session_id: string
-/**
- * When this memory row was written, epoch milliseconds
- */
 gmt_created: number
 /**
  * Source authority (highest→lowest): policy > official > team > informal
  */
 source_authority: ("policy" | "official" | "team" | "informal")
-/**
- * Id of the l1_raw memory this one was derived from; null when it was written directly
- */
 source_raw_memory_id: (string | null)
 }[]
-/**
- * How long the engine took to answer, milliseconds
- */
 elapsed_ms: number
-/**
- * Engine request id for this call — quote it when reporting a problem
- */
 request_id: string
 }
 
@@ -66462,92 +66123,29 @@ scope?: ("shared" | "private" | "both")
 }
 
 export interface BrainKnowledgeGraphOutput {
-/**
- * The typed relations between those entities
- */
 edges: {
-/**
- * Why the engine drew this edge, in its own words; null when it recorded none
- */
 reason: (string | null)
-/**
- * Id of the node the edge points FROM (a `nodes[].id`)
- */
 source: string
-/**
- * Id of the node the edge points TO (a `nodes[].id`)
- */
 target: string
-/**
- * True when the relation reads the same in both directions
- */
 symmetric: boolean
-/**
- * Ontology type of the relation, e.g. depends_on, competes_with, owns
- */
 relation_type: string
 }[]
-/**
- * The entities in the exported graph
- */
 nodes: {
-/**
- * Id of this entity; the `source` and `target` of an edge refer to it
- */
 id: string
-/**
- * How many edges touch this node — the hub concepts are the ones kept when the export is truncated
- */
 degree: number
-/**
- * Other names the same entity appears under in the ingested text
- */
 aliases: string[]
-/**
- * What the entity is, as the engine summarised it; null when it has not written one
- */
 description: (string | null)
-/**
- * Ontology type of the entity, e.g. Feature, Decision, Risk, Integration
- */
 entity_type: string
-/**
- * The name to show a person
- */
 display_name: string
-/**
- * The one name this entity is stored under
- */
 canonical_name: string
-/**
- * How many memories mention this entity
- */
 evidence_count: number
 }[]
-/**
- * Sizes of what was actually returned
- */
 totals: {
-/**
- * Edges returned in this export
- */
 edgeCount: number
-/**
- * Nodes returned in this export
- */
 nodeCount: number
 }
-/**
- * True when `limit` cut the export short — the highest-degree nodes were kept, so what you get is the hubs
- */
 truncated: boolean
-/**
- * How long the engine took to answer, milliseconds
- */
 elapsed_ms: number
-/**
- * Engine request id for this call — quote it when reporting a problem
- */
 request_id: string
 }
 
@@ -66579,128 +66177,38 @@ relation_type?: string
 }
 
 export interface BrainKnowledgeNeighborhoodOutput {
-/**
- * The entity that was expanded around; null when `entity_ref` matched nothing
- */
 root: ({
-/**
- * How closely this entity matches the query, higher is closer; absent on an unscored read such as a plain type filter
- */
 score?: number
-/**
- * Other names the same entity appears under in the ingested text
- */
 aliases: string[]
-/**
- * Id of this entity; pass it as `entity_ref` to brain_knowledge_neighborhood or brain_knowledge_entity_memories
- */
 entity_id: string
-/**
- * What the entity is, as the engine summarised it from the memories mentioning it; null when it has not written one
- */
 description: (string | null)
-/**
- * Ontology type of the entity, e.g. Feature, Decision, Risk, Integration
- */
 entity_type: string
-/**
- * The name to show a person — usually the spelling the source text used
- */
 display_name: string
-/**
- * The one name this entity is stored under; use it when matching entities against each other
- */
 canonical_name: string
-/**
- * How many memories mention this entity — a rough measure of how well attested it is
- */
 evidence_count: number
 } | null)
-/**
- * The neighbours reached within `depth` hops of the root, the root excluded
- */
 entities: {
-/**
- * How closely this entity matches the query, higher is closer; absent on an unscored read such as a plain type filter
- */
 score?: number
-/**
- * Other names the same entity appears under in the ingested text
- */
 aliases: string[]
-/**
- * Id of this entity; pass it as `entity_ref` to brain_knowledge_neighborhood or brain_knowledge_entity_memories
- */
 entity_id: string
-/**
- * What the entity is, as the engine summarised it from the memories mentioning it; null when it has not written one
- */
 description: (string | null)
-/**
- * Ontology type of the entity, e.g. Feature, Decision, Risk, Integration
- */
 entity_type: string
-/**
- * The name to show a person — usually the spelling the source text used
- */
 display_name: string
-/**
- * The one name this entity is stored under; use it when matching entities against each other
- */
 canonical_name: string
-/**
- * How many memories mention this entity — a rough measure of how well attested it is
- */
 evidence_count: number
 }[]
-/**
- * The relations that connect the root and the neighbours above
- */
 relations: {
-/**
- * Why the engine drew this relation, in its own words; null when it recorded none
- */
 reason: (string | null)
-/**
- * Id of the entity the relation points FROM
- */
 source_id: string
-/**
- * True when the relation reads the same in both directions, so source and target are interchangeable
- */
 symmetric: boolean
-/**
- * Id of the entity the relation points TO
- */
 target_id: string
-/**
- * Ontology type of the relation, e.g. depends_on, competes_with, owns
- */
 relation_type: string
-/**
- * Name to show for the source entity
- */
 source_display_name: string
-/**
- * Name to show for the target entity
- */
 target_display_name: string
-/**
- * Stored name of the source entity
- */
 source_canonical_name: string
-/**
- * Stored name of the target entity
- */
 target_canonical_name: string
 }[]
-/**
- * How long the engine took to answer, milliseconds
- */
 elapsed_ms: number
-/**
- * Engine request id for this call — quote it when reporting a problem
- */
 request_id: string
 }
 
@@ -66728,54 +66236,18 @@ target_entity?: string
 }
 
 export interface BrainKnowledgeRelationsOutput {
-/**
- * The relations matching the filters
- */
 relations: {
-/**
- * Why the engine drew this relation, in its own words; null when it recorded none
- */
 reason: (string | null)
-/**
- * Id of the entity the relation points FROM
- */
 source_id: string
-/**
- * True when the relation reads the same in both directions, so source and target are interchangeable
- */
 symmetric: boolean
-/**
- * Id of the entity the relation points TO
- */
 target_id: string
-/**
- * Ontology type of the relation, e.g. depends_on, competes_with, owns
- */
 relation_type: string
-/**
- * Name to show for the source entity
- */
 source_display_name: string
-/**
- * Name to show for the target entity
- */
 target_display_name: string
-/**
- * Stored name of the source entity
- */
 source_canonical_name: string
-/**
- * Stored name of the target entity
- */
 target_canonical_name: string
 }[]
-/**
- * How long the engine took to answer, milliseconds
- */
 elapsed_ms: number
-/**
- * Engine request id for this call — quote it when reporting a problem
- */
 request_id: string
 }
 
@@ -66803,54 +66275,18 @@ entity_type?: string
 }
 
 export interface BrainKnowledgeSearchOutput {
-/**
- * How many entities match in total, across all pages — not the length of this page
- */
 total: number
-/**
- * Matching entities, best match first
- */
 entities: {
-/**
- * How closely this entity matches the query, higher is closer; absent on an unscored read such as a plain type filter
- */
 score?: number
-/**
- * Other names the same entity appears under in the ingested text
- */
 aliases: string[]
-/**
- * Id of this entity; pass it as `entity_ref` to brain_knowledge_neighborhood or brain_knowledge_entity_memories
- */
 entity_id: string
-/**
- * What the entity is, as the engine summarised it from the memories mentioning it; null when it has not written one
- */
 description: (string | null)
-/**
- * Ontology type of the entity, e.g. Feature, Decision, Risk, Integration
- */
 entity_type: string
-/**
- * The name to show a person — usually the spelling the source text used
- */
 display_name: string
-/**
- * The one name this entity is stored under; use it when matching entities against each other
- */
 canonical_name: string
-/**
- * How many memories mention this entity — a rough measure of how well attested it is
- */
 evidence_count: number
 }[]
-/**
- * How long the engine took to answer, milliseconds
- */
 elapsed_ms: number
-/**
- * Engine request id for this call — quote it when reporting a problem
- */
 request_id: string
 }
 
@@ -66876,17 +66312,8 @@ source_authority?: ("policy" | "official" | "team" | "informal")
 }
 
 export interface BrainMemoryAddOutput {
-/**
- * True when the memory was stored
- */
 success: boolean
-/**
- * Engine id of the memory just stored; keep it to read, replace or delete the memory later
- */
 memory_id: string
-/**
- * Engine request id for this call — quote it when reporting a problem
- */
 request_id: string
 }
 
@@ -66898,17 +66325,8 @@ memory_id: string
 }
 
 export interface BrainMemoryDeleteOutput {
-/**
- * Always true — the call fails outright rather than reporting a false here
- */
 success: true
-/**
- * Engine request id for this call — quote it when reporting a problem
- */
 request_id: string
-/**
- * How many memory rows the engine removed for this id; 0 when it was already gone
- */
 deleted_count: number
 }
 
@@ -66920,179 +66338,74 @@ memory_id: string
 }
 
 export interface BrainMemoryGetOutput {
-/**
- * Engine tags on this memory; empty when it carries none
- */
 tags: string[]
 /**
  * Engine memory layer (l0_basic_info…l7_intention)
  */
 layer: ("l6_schema" | "l7_intention" | "l4_identity" | "l0_basic_info" | "l2_fact" | "l3_summary" | "l5_knowledge" | "l1_raw")
-/**
- * Free-form metadata, verbatim as the writer passed brain_memory_add's `metadata`; keys are the caller's
- */
 custom: {
 [k: string]: unknown
 }
-/**
- * Which store answered the read — 'vdb' the vector store, 'graph' the memory graph. Diagnostic; the content is the same either way.
- */
 source: ("vdb" | "graph")
-/**
- * Engine lifecycle status of the row — 'active' for a memory in use
- */
 status: string
-/**
- * The memory text itself
- */
 content: string
-/**
- * Engine user namespace the memory was written under
- */
 user_id: string
-/**
- * Engine agent namespace the memory was written under
- */
 agent_id: string
-/**
- * True when this is the current version of the memory; false when a newer one has replaced it
- */
 is_latest: boolean
-/**
- * When the remembered EVENT happened, epoch milliseconds; null when the writer stated no time
- */
 memory_at: (number | null)
-/**
- * Engine id of this memory — the id that was asked for
- */
 memory_id: string
-/**
- * The engine's own inference about this memory, or null when it recorded none
- */
 speculate: (string | null)
-/**
- * The engine's confidence in this memory, 0..1
- */
 confidence: number
-/**
- * How long the engine took to answer, milliseconds
- */
 elapsed_ms: number
-/**
- * Engine request id for this call — quote it when reporting a problem
- */
 request_id: string
-/**
- * Ids of the memories this one replaced; null when it replaced none
- */
 supersedes: (string[] | null)
-/**
- * When this memory row was written, epoch milliseconds
- */
 gmt_created: number
-/**
- * Ids of the memories that replaced this one; null while it is still current
- */
 superseded_by: (string[] | null)
 /**
  * Source authority (highest→lowest): policy > official > team > informal
  */
 source_authority: ("policy" | "official" | "team" | "informal")
-/**
- * Id of the l1_raw memory this one was derived from; null when it was written directly
- */
 source_raw_memory_id: (string | null)
 }
 
 export interface BrainMemoryListInput {
-/**
- * How many memories to return, max 1000. Omit to use the engine's own page size.
- */
 limit?: number
-/**
- * Sort by write time: 'desc' newest first, 'asc' oldest first. Omit to take the engine's own order.
- */
 order?: ("asc" | "desc")
 /**
  * Read scope; 'both' (default) unions shared + your private
  */
 scope?: ("shared" | "private" | "both")
-/**
- * How many memories to skip before this page — offset 100 with limit 100 is the second page. Omit to start at the beginning.
- */
 offset?: number
 }
 
 export interface BrainMemoryListOutput {
-/**
- * How many memories match in total, across all pages — not the length of this page
- */
 total: number
-/**
- * One page of memories, newest first unless `order` said otherwise
- */
 memories: {
 /**
  * Consumer-facing label derived from the layer; 'unknown' for an unrecognised layer
  */
 kind: ("schema" | "intention" | "identity" | "basic" | "fact" | "summary" | "knowledge" | "raw" | "unknown")
-/**
- * Engine tags on this memory; empty when it carries none
- */
 tags: string[]
 /**
  * Engine memory layer (l0_basic_info…l7_intention)
  */
 layer: ("l6_schema" | "l7_intention" | "l4_identity" | "l0_basic_info" | "l2_fact" | "l3_summary" | "l5_knowledge" | "l1_raw")
-/**
- * Free-form metadata, verbatim as the writer passed brain_memory_add's `metadata`; keys are the caller's
- */
 custom: {
 [k: string]: unknown
 }
-/**
- * Engine lifecycle status of the row — 'active' for a memory in use; superseded rows are not listed
- */
 status: string
-/**
- * The memory text itself
- */
 content: string
-/**
- * Engine user namespace the memory was written under
- */
 user_id: string
-/**
- * Engine agent namespace the memory was written under — the shared pool for a 'shared' write, the caller's own for a private one
- */
 agent_id: string
-/**
- * When the remembered EVENT happened, epoch milliseconds; null when the writer stated no time
- */
 memory_at: (number | null)
-/**
- * Engine id of this memory; pass it to brain_memory_get, _update or _delete
- */
 memory_id: string
-/**
- * The engine's own inference about this memory, or null when it recorded none
- */
 speculate: (string | null)
-/**
- * Engine session the memory was written in; empty when the writer opened none
- */
 session_id: string
-/**
- * When this memory row was written, epoch milliseconds
- */
 gmt_created: number
 /**
  * Source authority (highest→lowest): policy > official > team > informal
  */
 source_authority: ("policy" | "official" | "team" | "informal")
-/**
- * Id of the l1_raw memory this one was derived from; null when it was written directly
- */
 source_raw_memory_id: (string | null)
 }[]
 }
@@ -67113,17 +66426,8 @@ scope?: ("shared" | "private" | "both")
 }
 
 export interface BrainMemorySearchOutput {
-/**
- * Ordinary hits: the facts, summaries and raw notes that match the query
- */
 normal: BrainMemorySearchOutputItems[]
-/**
- * Hits describing WHO the subject is — stable identity and preference memories (l0/l4). Usually the ones worth carrying into a prompt.
- */
 profile: BrainMemorySearchOutputItems[]
-/**
- * Hits the engine offers unprompted — intentions and open threads (l7) it judged relevant to the query rather than matched to it
- */
 proactive: BrainMemorySearchOutputItems[]
 }
 export interface BrainMemorySearchOutputItems {
@@ -67131,53 +66435,23 @@ export interface BrainMemorySearchOutputItems {
  * Consumer-facing label derived from the layer; 'unknown' for an unrecognised layer
  */
 kind: ("schema" | "intention" | "identity" | "basic" | "fact" | "summary" | "knowledge" | "raw" | "unknown")
-/**
- * Engine tags on this memory; empty when it carries none
- */
 tags: string[]
 /**
  * Engine memory layer (l0_basic_info…l7_intention)
  */
 layer: ("l6_schema" | "l7_intention" | "l4_identity" | "l0_basic_info" | "l2_fact" | "l3_summary" | "l5_knowledge" | "l1_raw")
-/**
- * How closely this hit matches the query — higher is closer. An engine-internal scale, not a percentage; compare hits against each other, never against a fixed threshold.
- */
 score: number
-/**
- * The memory text itself
- */
 content: string
-/**
- * When the remembered EVENT happened, epoch milliseconds; null when the writer stated no time
- */
 memory_at: (number | null)
-/**
- * Engine id of this memory; pass it to brain_memory_get, _update or _delete
- */
 memory_id: string
-/**
- * The engine's own inference about this memory, or null when it recorded none
- */
 speculate: (string | null)
-/**
- * When this memory row was written, epoch milliseconds
- */
 gmt_created: number
-/**
- * Name of the l6_schema type this memory instantiates; absent on every other layer
- */
 schema_type?: string
-/**
- * Ids of the earlier memories this one grew out of, oldest first; absent when it has no history
- */
 evolution_chain?: string[]
 /**
  * Source authority (highest→lowest): policy > official > team > informal
  */
 source_authority: ("policy" | "official" | "team" | "informal")
-/**
- * Id of the l1_raw memory this one was derived from; null when it was written directly
- */
 source_raw_memory_id: (string | null)
 }
 
@@ -67189,52 +66463,19 @@ scope?: ("shared" | "private" | "both")
 }
 
 export interface BrainMemoryStatsOutput {
-/**
- * Size of the engine's memory graph
- */
 graph: {
-/**
- * Edges between those nodes
- */
 edgeCount: number
-/**
- * Nodes in the memory graph
- */
 nodeCount: number
 }
-/**
- * Memory counts for the requested scope
- */
 memories: {
-/**
- * How many memories the scope holds in total
- */
 total: number
-/**
- * Counts for the three derived layers the engine reports; the other layers are not broken out
- */
 byLayer: {
-/**
- * Count of l2_fact memories — extracted facts
- */
 l2: number
-/**
- * Count of l3_summary memories — summaries over facts
- */
 l3: number
-/**
- * Count of l4_identity memories — who the subject is
- */
 l4: number
 }
 }
-/**
- * Size of the product knowledge graph
- */
 knowledge: {
-/**
- * Entities in the product knowledge graph (see brain_knowledge_search)
- */
 entityCount: number
 }
 }
@@ -67251,17 +66492,8 @@ memory_id: string
 }
 
 export interface BrainMemoryUpdateOutput {
-/**
- * Always true — the call fails outright rather than reporting a false here
- */
 success: true
-/**
- * Engine id of the memory that was replaced
- */
 memory_id: string
-/**
- * Engine request id for this call — quote it when reporting a problem
- */
 request_id: string
 }
 
@@ -67316,9 +66548,6 @@ days?: number
 }
 
 export interface BrainUsageReportOutput {
-/**
- * A standing warning, in words, that product.rows and platform.meters have different subjects and need not match
- */
 note: string
 /**
  * Brain's own ledger, for THIS product only
@@ -67336,9 +66565,6 @@ days: number
  * Inclusive UTC start of the window, YYYY-MM-DD
  */
 from: string
-/**
- * One row per UTC day and meter dimension — the grain to join against a billing export
- */
 rows: {
 /**
  * 'sync' | 'batch'; '' when the push carried none
@@ -67377,72 +66603,27 @@ delivery_failed: number
  * The rows rolled up per meter across the whole window
  */
 totals: {
-/**
- * Manifest meter slug, e.g. llm-tokens
- */
 meter: string
-/**
- * How many metered calls landed in the window
- */
 events: number
-/**
- * Tokens metered for this meter across the whole window
- */
 tokens: number
-/**
- * Of those calls, how many billing did not accept — a non-zero here means our ledger and the invoice will differ
- */
 delivery_failed: number
 }[]
-/**
- * The product this ledger belongs to — the one the call was made for
- */
 product_id: string
 }
 /**
  * The platform billing aggregate for the whole ORG; null if it could not be read
  */
 platform: ({
-/**
- * The billing plan in force for that organisation
- */
 plan: string
-/**
- * Always 'org' — a reminder that these numbers are the whole organisation's, not this product's
- */
 scope: "org"
-/**
- * Per-meter allowance and month-to-date usage as billing reports it
- */
 meters: {
-/**
- * What the numbers below are counted in, e.g. tokens
- */
 unit?: string
-/**
- * How much of it has been used MONTH TO DATE, for the whole org — not for the window asked for here
- */
 used?: number
-/**
- * The plan's allowance for this meter; null or absent when there is no cap
- */
 limit?: (number | null)
-/**
- * Allowance left; null or absent when the meter is uncapped
- */
 remaining?: (number | null)
-/**
- * True when this meter has no cap at all
- */
 unlimited?: boolean
-/**
- * Platform meter slug, e.g. llm-tokens
- */
 meter_slug: string
 }[]
-/**
- * The organisation the billing aggregate was read for
- */
 org_id: string
 } | null)
 /**
@@ -88590,378 +87771,6 @@ export interface OrganizationYoutubeInstallOutput {
 url: string
 }
 
-export interface PlaygroundAnalyticsOverviewInput {
-/**
- * Max records per entity in recent[]; omit for the endpoint default
- */
-limit?: number
-}
-
-export interface PlaygroundAnalyticsOverviewOutput {
-ok: boolean
-minted: boolean
-overview?: unknown
-http_status: number
-}
-
-export interface PlaygroundBillingEntitlementsInput {
-
-}
-
-export interface PlaygroundBillingEntitlementsOutput {
-ok: boolean
-minted: boolean
-http_status: number
-entitlements?: unknown
-}
-
-export interface PlaygroundBillingRecordUsageInput {
-/**
- * Quantity of events to record against playground-events (SUM); defaults to 1
- */
-value?: number
-}
-
-export interface PlaygroundBillingRecordUsageOutput {
-minted: boolean
-accepted: (number | null)
-recorded: boolean
-duplicates: (number | null)
-http_status: number
-}
-
-export interface PlaygroundClickupCreateTaskInput {
-/**
- * Task title; defaults to a fixture label
- */
-name?: string
-/**
- * ClickUp list id; falls back to CLICKUP_TEST_LIST_ID
- */
-listId?: string
-}
-
-export interface PlaygroundClickupCreateTaskOutput {
-minted: boolean
-task_id: (string | null)
-list_status: number
-vend_status: number
-clickup_status: number
-installation_count: number
-}
-
-export interface PlaygroundClickupGetLastWebhookInput {
-
-}
-
-export type PlaygroundClickupGetLastWebhookOutput = ({
-payload: string
-event_id: string
-provider: string
-verified: boolean
-product_id: string
-occurred_at: string
-connector_id: string
-clickup_event: (string | null)
-receipt_count: number
-} | {
-found: false
-})
-
-export interface PlaygroundClickupGetOverviewInput {
-
-}
-
-export interface PlaygroundClickupGetOverviewOutput {
-team: ({
-teamId: string
-teamName: string
-} | null)
-lists: PlaygroundClickupGetOverviewOutputItems[]
-tasks: {
-id: string
-name: string
-status: (string | null)
-}[]
-minted: boolean
-spaces: PlaygroundClickupGetOverviewOutputItems[]
-list_status: number
-vend_status: number
-lists_status: number
-tasks_status: number
-spaces_status: number
-folders_status: number
-installation_count: number
-}
-export interface PlaygroundClickupGetOverviewOutputItems {
-id: string
-name: string
-}
-
-export interface PlaygroundEchoPingInput {
-/**
- * The text to echo back, 1–1024 characters
- */
-message: string
-}
-
-export interface PlaygroundEchoPingOutput {
-/**
- * The message exactly as it was received
- */
-message: string
-/**
- * The product the call was resolved to
- */
-productId: string
-/**
- * ISO-8601 instant (UTC) at which the call reached the service
- */
-receivedAt: string
-}
-
-export interface PlaygroundGdriveGetLastChangeInput {
-
-}
-
-export type PlaygroundGdriveGetLastChangeOutput = ({
-file_id: string
-removed: boolean
-file_name: (string | null)
-mime_type: (string | null)
-product_id: string
-occurred_at: string
-connector_id: string
-resource_state: string
-} | {
-found: false
-})
-
-export interface PlaygroundGdriveReadFileInput {
-/**
- * Drive file id; falls back to GDRIVE_TEST_FILE_ID, then the first picked file
- */
-fileId?: string
-}
-
-export interface PlaygroundGdriveReadFileOutput {
-minted: boolean
-file_id: (string | null)
-file_name: (string | null)
-mime_type: (string | null)
-file_count: number
-get_status: number
-list_status: number
-vend_status: number
-content_bytes: (number | null)
-}
-
-export interface PlaygroundGoogleadsReadCustomerInput {
-
-}
-
-export interface PlaygroundGoogleadsReadCustomerOutput {
-minted: boolean
-vended: boolean
-customer_id: (string | null)
-vend_status: number
-result_count: number
-search_status: number
-login_customer_id: (string | null)
-}
-
-export interface PlaygroundLifecycleGetStateInput {
-
-}
-
-export interface PlaygroundLifecycleGetStateOutput {
-blocked: boolean
-archived: boolean
-productId: string
-lastBlockTransition: ({
-eventId: string
-eventName: string
-productId: string
-occurredAt: string
-recordedAt: string
-receiptCount: number
-organizationId: string
-cascadedFromOrg: boolean
-} | null)
-lastArchiveTransition: ({
-eventId: string
-eventName: string
-productId: string
-occurredAt: string
-recordedAt: string
-receiptCount: number
-organizationId: string
-cascadedFromOrg: boolean
-} | null)
-}
-
-export interface PlaygroundLifecycleListEventsInput {
-
-}
-
-export type PlaygroundLifecycleListEventsOutput = {
-eventId: string
-eventName: string
-productId: string
-occurredAt: string
-recordedAt: string
-receiptCount: number
-organizationId: string
-cascadedFromOrg: boolean
-}[]
-
-export interface PlaygroundWebhookGetLastInput {
-
-}
-
-export type PlaygroundWebhookGetLastOutput = ({
-payload?: unknown
-event_id: string
-provider: string
-verified: boolean
-product_id: string
-occurred_at: string
-connector_id: string
-delivery_count: number
-} | {
-found: false
-})
-
-export interface PlaygroundWorkflowEchoInput {
-/**
- * The text to store, 1–1024 characters
- */
-note: string
-/**
- * Optional labels stored alongside the note, at most 20
- * 
- * @maxItems 20
- */
-tags?: []|[string]|[string, string]|[string, string, string]|[string, string, string, string]|[string, string, string, string, string]|[string, string, string, string, string, string]|[string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]
-}
-
-export interface PlaygroundWorkflowEchoOutput {
-/**
- * Identifier of the stored echo
- */
-id: string
-/**
- * The note exactly as it was received
- */
-note: string
-/**
- * The tags exactly as they were received
- */
-tags: string[]
-/**
- * Correlation id for this echo. The playground/workflow.echoed event published about two seconds later repeats it, which is how a composer matches the completion back to this step.
- */
-echo_id: string
-/**
- * ISO-8601 instant (UTC) at which the echo was stored
- */
-received_at: string
-}
-
-export interface PlaygroundWorkflowEchoListInput {
-
-}
-
-export type PlaygroundWorkflowEchoListOutput = {
-/**
- * Identifier of the stored echo
- */
-id: string
-/**
- * The note exactly as it was received
- */
-note: string
-/**
- * The tags exactly as they were received
- */
-tags: string[]
-/**
- * ISO-8601 instant (UTC) at which the echo was stored
- */
-received_at: string
-}[]
-
-export interface PlaygroundWorkflowPingInput {
-/**
- * Class of ping, echoed on the emitted event and filterable on the trigger. Defaults to 'manual'.
- */
-kind?: string
-}
-
-export interface PlaygroundWorkflowPingOutput {
-/**
- * Correlation id for this ping. The emitted playground/workflow.ping event repeats it, which is how a composer matches the event back to this step.
- */
-id: string
-/**
- * The name of the event that was published
- */
-event: string
-}
-
-export interface PlaygroundWorkflowSubjectsListInput {
-/**
- * How many subjects to return, 1–100. Defaults to 25.
- */
-limit?: number
-/**
- * The next_cursor of the previous page. Opaque — pass it back unchanged. Omit for the first page.
- */
-cursor?: string
-/**
- * ISO-8601 UTC instant. Return only subjects whose last_activity_at is AT OR AFTER this — the opposite question, the recently active population. Omit for no lower bound.
- */
-last_activity_after?: string
-/**
- * ISO-8601 UTC instant. Return only subjects whose last_activity_at is AT OR BEFORE this — the "inactive for N days" question: pass now minus N days. Omit for no upper bound.
- */
-last_activity_before?: string
-}
-
-export interface PlaygroundWorkflowSubjectsListOutput {
-/**
- * This page of subjects, most recently active first
- */
-items: {
-/**
- * Stable identifier for the subject. This is the field a batch trigger keys on, so a subject already served in an earlier run is skipped rather than served twice.
- */
-subject_key: string
-/**
- * Human-readable name of the subject
- */
-display_name: string
-/**
- * ISO-8601 instant (UTC) of the subject last activity
- */
-last_activity_at: string
-}[]
-/**
- * Whether another page follows. False and a null next_cursor both mark the last page, so a consumer that loops on either terminates.
- */
-has_more: boolean
-/**
- * Pass back as `cursor` to fetch the next page; null on the last page. Always null when has_more is false.
- */
-next_cursor: (string | null)
-}
-
-export interface PlaygroundWsEchoInput {
-
-}
-
-export type PlaygroundWsEchoOutput = unknown;
-
 export interface RealtimeArchiveExportInput {
 /**
  * Only entries with ts <= to_ts (epoch ms)
@@ -111017,37 +109826,13 @@ type: ("server" | "publishable")
 }
 
 export interface UsersApikeysCreateOutput {
-/**
- * Id of the key. Pass it to users_apikeys_revoke.
- */
 id: string
-/**
- * The full secret key, shown ONCE. Store it now — it is never returned again, and a lost key is replaced by minting a new one.
- */
 key: string
-/**
- * The label a human gave this key — which backend or environment holds it.
- */
 name: string
-/**
- * `server` for a secret backend key (usk_…), `publishable` for a browser-safe one (upk_…).
- */
 type: ("server" | "publishable")
-/**
- * The full value of a publishable key, which is not a secret. Null for a server key — that value exists in exactly one response, ever.
- */
 value: (string | null)
-/**
- * `usk_`/`upk_` plus six characters — enough to recognise a key, never to use one.
- */
 prefix: string
-/**
- * When the key was issued (ISO 8601).
- */
 createdAt: string
-/**
- * When the key was revoked (ISO 8601). Null while it still works.
- */
 revokedAt: (string | null)
 }
 
@@ -111057,33 +109842,12 @@ export interface UsersApikeysListInput {
 
 export interface UsersApikeysListOutput {
 keys: {
-/**
- * Id of the key. Pass it to users_apikeys_revoke.
- */
 id: string
-/**
- * The label a human gave this key — which backend or environment holds it.
- */
 name: string
-/**
- * `server` for a secret backend key (usk_…), `publishable` for a browser-safe one (upk_…).
- */
 type: ("server" | "publishable")
-/**
- * The full value of a publishable key, which is not a secret. Null for a server key — that value exists in exactly one response, ever.
- */
 value: (string | null)
-/**
- * `usk_`/`upk_` plus six characters — enough to recognise a key, never to use one.
- */
 prefix: string
-/**
- * When the key was issued (ISO 8601).
- */
 createdAt: string
-/**
- * When the key was revoked (ISO 8601). Null while it still works.
- */
 revokedAt: (string | null)
 }[]
 }
@@ -111096,13 +109860,7 @@ id: string
 }
 
 export interface UsersApikeysRevokeOutput {
-/**
- * Id of the key that was revoked.
- */
 id: string
-/**
- * Always true — revocation is immediate and final.
- */
 revoked: true
 }
 
@@ -111138,60 +109896,21 @@ targetType?: string
 }
 
 export interface UsersAuditListOutput {
-/**
- * The page of audit events, newest first.
- */
 events: {
-/**
- * Id of this audit row.
- */
 id: string
-/**
- * IP the action came from. Null when it was not an HTTP action.
- */
 ip: (string | null)
-/**
- * What happened, as a dotted name — `user.created`, `passkey.deleted`, `email_change.override_applied`.
- */
 action: string
-/**
- * Id of the actor. Null for a system action.
- */
 actorId: (string | null)
-/**
- * Action-specific detail — the reason text, counts, whatever the action recorded.
- */
 metadata: {
 [k: string]: unknown
 }
-/**
- * Id of the row the action was about. Null when there was none.
- */
 targetId: (string | null)
-/**
- * Who acted: `operator` (a human or agent on the management plane), `end_user`, or `system`.
- */
 actorType: ("operator" | "system" | "end_user")
-/**
- * When the action happened (ISO 8601).
- */
 createdAt: string
-/**
- * Product the audited action happened in.
- */
 productId: string
-/**
- * User agent the action came from. Null when none was sent.
- */
 userAgent: (string | null)
-/**
- * What kind of row the action was about — `user` or `product`. Null when it was about nothing in particular.
- */
 targetType: (string | null)
 }[]
-/**
- * Pass back as `cursor` to fetch the next page. Null when this page is the last.
- */
 nextCursor: (string | null)
 }
 
@@ -112174,33 +110893,12 @@ userId: string
 }
 
 export interface UsersFactorsListOutput {
-/**
- * Every second factor this user has — types and status only, never material.
- */
 factors: {
-/**
- * Kind of second factor: `totp` or `backup_codes`. No key material is ever returned.
- */
 type: ("totp" | "backup_codes" | "webauthn")
-/**
- * Whether this factor is enrolled and usable, or still pending verification.
- */
 status: ("unverified" | "verified")
-/**
- * When the factor was enrolled (ISO 8601).
- */
 createdAt: string
-/**
- * `backup_codes` only: how many of the batch are still unspent. Null for any other factor type.
- */
 remaining: (number | null)
-/**
- * When the factor was last used to sign in (ISO 8601). Null if it never was.
- */
 lastUsedAt: (string | null)
-/**
- * When the user first proved the factor works (ISO 8601). Null while it is unverified.
- */
 verifiedAt: (string | null)
 }[]
 }
@@ -112217,13 +110915,7 @@ userId: string
 }
 
 export interface UsersFactorsResetOutput {
-/**
- * Id of the scheduled reset. The same value arrives on `users/mfa.reset-settled`, which is what finishes this step.
- */
 requestId: string
-/**
- * When the removal happens, if nobody aborts it first (ISO 8601). The delay is this product's, not a fixed one.
- */
 scheduledFor: string
 }
 
@@ -112559,18 +111251,9 @@ export interface UsersPasskeysRevokeOutput {
  * Present when the revoke was refused — today, only because it was the last way in.
  */
 error: ({
-/**
- * Why it was refused. Today only `passkey_last_way_in`.
- */
 code: string
-/**
- * The refusal in a sentence, safe to show a human.
- */
 message: string
 } | null)
-/**
- * `deleted` when the credential is gone, `failed` when the revoke was refused.
- */
 status: ("deleted" | "failed")
 }
 
@@ -112582,13 +111265,7 @@ sessionId: string
 }
 
 export interface UsersSessionsGetOutput {
-/**
- * Id of this session. Pass it to users_sessions_revoke.
- */
 id: string
-/**
- * IP the session was opened from. Null when it was not recorded.
- */
 ip: (string | null)
 /**
  * `aal2` only if a verified second factor completed.
@@ -112598,42 +111275,18 @@ aal: ("aal1" | "aal2")
  * The factors this session was established with.
  */
 amr: string[]
-/**
- * Whether the session is still usable, expired, or revoked.
- */
 status: ("active" | "revoked")
-/**
- * The end user this session belongs to.
- */
 userId: string
-/**
- * When the session was opened (ISO 8601).
- */
 createdAt: string
-/**
- * When the current token stops working unless refreshed (ISO 8601).
- */
 expiresAt: string
-/**
- * When the session was revoked (ISO 8601). Null while it is live.
- */
 revokedAt: (string | null)
-/**
- * User agent the session was opened from. Null when none was sent.
- */
 userAgent: (string | null)
 revokedReason: (string | null)
 /**
  * The operator behind an impersonated session, or null for an ordinary one.
  */
 impersonatedBy: (string | null)
-/**
- * When the session last refreshed its tokens (ISO 8601). Null if it never has.
- */
 lastRefreshedAt: (string | null)
-/**
- * When the session ends no matter how often it refreshes (ISO 8601).
- */
 absoluteExpiresAt: string
 }
 
@@ -112673,49 +111326,16 @@ userId: string
 }
 
 export interface UsersSessionsListOutput {
-/**
- * The sessions matching the filter, newest first.
- */
 sessions: {
-/**
- * Id of this session. Pass it to users_sessions_revoke.
- */
 id: string
-/**
- * IP the session was opened from. Null when it was not recorded.
- */
 ip: (string | null)
-/**
- * Whether the session is still usable, expired, or revoked.
- */
 status: ("active" | "revoked")
-/**
- * The end user this session belongs to.
- */
 userId: string
-/**
- * When the session was opened (ISO 8601).
- */
 createdAt: string
-/**
- * When the current token stops working unless refreshed (ISO 8601).
- */
 expiresAt: string
-/**
- * When the session was revoked (ISO 8601). Null while it is live.
- */
 revokedAt: (string | null)
-/**
- * User agent the session was opened from. Null when none was sent.
- */
 userAgent: (string | null)
-/**
- * When the session last refreshed its tokens (ISO 8601). Null if it never has.
- */
 lastRefreshedAt: (string | null)
-/**
- * When the session ends no matter how often it refreshes (ISO 8601).
- */
 absoluteExpiresAt: string
 }[]
 }
@@ -112732,9 +111352,6 @@ sessionId?: string
 }
 
 export interface UsersSessionsRevokeOutput {
-/**
- * How many sessions were revoked. Zero when there was nothing live to revoke.
- */
 revoked: number
 }
 
@@ -112861,126 +111478,37 @@ userId: string
 }
 
 export interface UsersUsersBanOutput {
-/**
- * Id of this end user. Pass it to any users_users_* tool.
- */
 id: string
-/**
- * The user's display name. Null when nobody set one.
- */
 name: (string | null)
-/**
- * When the user was banned (ISO 8601). Null while they are not banned.
- */
 bannedAt: (string | null)
-/**
- * When this user's personal data was purged for good (ISO 8601). Null while it is intact.
- */
 erasedAt: (string | null)
-/**
- * URL of the user's avatar. Null when there is none.
- */
 imageUrl: (string | null)
-/**
- * Whether this is a test fixture — excluded from metering and from the default listing.
- */
 testUser: boolean
-/**
- * When the user was created (ISO 8601).
- */
 createdAt: string
-/**
- * When the user was soft-deleted (ISO 8601). Null while the account is live.
- */
 deletedAt: (string | null)
-/**
- * Product this user belongs to. Never an input — it comes from the calling identity.
- */
 productId: string
-/**
- * When the user was last changed (ISO 8601).
- */
 updatedAt: string
-/**
- * Whether this user is still on the waitlist and cannot sign in yet.
- */
 waitlisted: boolean
-/**
- * Every identifier of this user, the primary one flagged. To bind the primary address itself, use `primaryEmail` — `identifiers.0` means "the first", not "the primary".
- */
 identifiers: {
-/**
- * Id of this identifier row.
- */
 id: string
-/**
- * What kind of identifier this is. Today always `email`.
- */
 type: "email"
-/**
- * The address as the user typed it, for display.
- */
 value: string
-/**
- * Whether this is the identifier the user signs in with and is contacted at.
- */
 isPrimary: boolean
-/**
- * When this address was verified (ISO 8601). Null while it never was.
- */
 verifiedAt: (string | null)
-/**
- * The address lowercased and NFC-normalised — what uniqueness is checked against.
- */
 valueCanonical: string
-/**
- * `unverified`, `verified`, or `expired` when a verification link ran out before it was used.
- */
 verificationStatus: ("unverified" | "verified" | "expired")
 }[]
-/**
- * When a failed-attempt lockout expires (ISO 8601). Null when the user is not locked out.
- */
 lockedUntil: (string | null)
-/**
- * When the user last signed in (ISO 8601). Null if they never have.
- */
 lastSignInAt: (string | null)
-/**
- * The user's primary email address, as typed. Null when they have no primary identifier. Bind this rather than `identifiers.0.value`.
- */
-primaryEmail: (string | null)
-/**
- * Whether the user must set a new password at their next sign-in.
- */
 requiresReset: boolean
-/**
- * Metadata the end user may read; the only bag projected into their access token. Capped at 1.2 KB.
- */
-publicMetadata: {
-[k: string]: unknown
-}
-/**
- * Metadata the end user may write themselves. Treat it as untrusted.
- */
-unsafeMetadata: {
-[k: string]: unknown
+publicMetadata: UsersUsersBanOutputPublicMetadata
+unsafeMetadata: UsersUsersBanOutputPublicMetadata
+privateMetadata: UsersUsersBanOutputPublicMetadata
+emailChangeLockedUntil: (string | null)
 }
-/**
- * Metadata for the management plane only. Never reaches the end user or a token.
- */
-privateMetadata: {
+export interface UsersUsersBanOutputPublicMetadata {
 [k: string]: unknown
 }
-/**
- * Id of the primary identifier row. Null when there is no primary identifier.
- */
-primaryIdentifierId: (string | null)
-/**
- * Until this instant the user may not start another email change, because somebody reverted one (ISO 8601). Null for a user who never reverted one.
- */
-emailChangeLockedUntil: (string | null)
-}
 
 export interface UsersUsersCreateInput {
 /**
@@ -113083,126 +111611,37 @@ export interface UsersUsersCreateInputPublicMetadata1 {
 }
 
 export interface UsersUsersCreateOutput {
-/**
- * Id of this end user. Pass it to any users_users_* tool.
- */
 id: string
-/**
- * The user's display name. Null when nobody set one.
- */
 name: (string | null)
-/**
- * When the user was banned (ISO 8601). Null while they are not banned.
- */
 bannedAt: (string | null)
-/**
- * When this user's personal data was purged for good (ISO 8601). Null while it is intact.
- */
 erasedAt: (string | null)
-/**
- * URL of the user's avatar. Null when there is none.
- */
 imageUrl: (string | null)
-/**
- * Whether this is a test fixture — excluded from metering and from the default listing.
- */
 testUser: boolean
-/**
- * When the user was created (ISO 8601).
- */
 createdAt: string
-/**
- * When the user was soft-deleted (ISO 8601). Null while the account is live.
- */
 deletedAt: (string | null)
-/**
- * Product this user belongs to. Never an input — it comes from the calling identity.
- */
 productId: string
-/**
- * When the user was last changed (ISO 8601).
- */
 updatedAt: string
-/**
- * Whether this user is still on the waitlist and cannot sign in yet.
- */
 waitlisted: boolean
-/**
- * Every identifier of this user, the primary one flagged. To bind the primary address itself, use `primaryEmail` — `identifiers.0` means "the first", not "the primary".
- */
 identifiers: {
-/**
- * Id of this identifier row.
- */
 id: string
-/**
- * What kind of identifier this is. Today always `email`.
- */
 type: "email"
-/**
- * The address as the user typed it, for display.
- */
 value: string
-/**
- * Whether this is the identifier the user signs in with and is contacted at.
- */
 isPrimary: boolean
-/**
- * When this address was verified (ISO 8601). Null while it never was.
- */
 verifiedAt: (string | null)
-/**
- * The address lowercased and NFC-normalised — what uniqueness is checked against.
- */
 valueCanonical: string
-/**
- * `unverified`, `verified`, or `expired` when a verification link ran out before it was used.
- */
 verificationStatus: ("unverified" | "verified" | "expired")
 }[]
-/**
- * When a failed-attempt lockout expires (ISO 8601). Null when the user is not locked out.
- */
 lockedUntil: (string | null)
-/**
- * When the user last signed in (ISO 8601). Null if they never have.
- */
 lastSignInAt: (string | null)
-/**
- * The user's primary email address, as typed. Null when they have no primary identifier. Bind this rather than `identifiers.0.value`.
- */
-primaryEmail: (string | null)
-/**
- * Whether the user must set a new password at their next sign-in.
- */
 requiresReset: boolean
-/**
- * Metadata the end user may read; the only bag projected into their access token. Capped at 1.2 KB.
- */
-publicMetadata: {
-[k: string]: unknown
-}
-/**
- * Metadata the end user may write themselves. Treat it as untrusted.
- */
-unsafeMetadata: {
-[k: string]: unknown
+publicMetadata: UsersUsersCreateOutputPublicMetadata
+unsafeMetadata: UsersUsersCreateOutputPublicMetadata
+privateMetadata: UsersUsersCreateOutputPublicMetadata
+emailChangeLockedUntil: (string | null)
 }
-/**
- * Metadata for the management plane only. Never reaches the end user or a token.
- */
-privateMetadata: {
+export interface UsersUsersCreateOutputPublicMetadata {
 [k: string]: unknown
 }
-/**
- * Id of the primary identifier row. Null when there is no primary identifier.
- */
-primaryIdentifierId: (string | null)
-/**
- * Until this instant the user may not start another email change, because somebody reverted one (ISO 8601). Null for a user who never reverted one.
- */
-emailChangeLockedUntil: (string | null)
-}
 
 export interface UsersUsersDeleteInput {
 /**
@@ -113212,126 +111651,37 @@ userId: string
 }
 
 export interface UsersUsersDeleteOutput {
-/**
- * Id of this end user. Pass it to any users_users_* tool.
- */
 id: string
-/**
- * The user's display name. Null when nobody set one.
- */
 name: (string | null)
-/**
- * When the user was banned (ISO 8601). Null while they are not banned.
- */
 bannedAt: (string | null)
-/**
- * When this user's personal data was purged for good (ISO 8601). Null while it is intact.
- */
 erasedAt: (string | null)
-/**
- * URL of the user's avatar. Null when there is none.
- */
 imageUrl: (string | null)
-/**
- * Whether this is a test fixture — excluded from metering and from the default listing.
- */
 testUser: boolean
-/**
- * When the user was created (ISO 8601).
- */
 createdAt: string
-/**
- * When the user was soft-deleted (ISO 8601). Null while the account is live.
- */
 deletedAt: (string | null)
-/**
- * Product this user belongs to. Never an input — it comes from the calling identity.
- */
 productId: string
-/**
- * When the user was last changed (ISO 8601).
- */
 updatedAt: string
-/**
- * Whether this user is still on the waitlist and cannot sign in yet.
- */
 waitlisted: boolean
-/**
- * Every identifier of this user, the primary one flagged. To bind the primary address itself, use `primaryEmail` — `identifiers.0` means "the first", not "the primary".
- */
 identifiers: {
-/**
- * Id of this identifier row.
- */
 id: string
-/**
- * What kind of identifier this is. Today always `email`.
- */
 type: "email"
-/**
- * The address as the user typed it, for display.
- */
 value: string
-/**
- * Whether this is the identifier the user signs in with and is contacted at.
- */
 isPrimary: boolean
-/**
- * When this address was verified (ISO 8601). Null while it never was.
- */
 verifiedAt: (string | null)
-/**
- * The address lowercased and NFC-normalised — what uniqueness is checked against.
- */
 valueCanonical: string
-/**
- * `unverified`, `verified`, or `expired` when a verification link ran out before it was used.
- */
 verificationStatus: ("unverified" | "verified" | "expired")
 }[]
-/**
- * When a failed-attempt lockout expires (ISO 8601). Null when the user is not locked out.
- */
 lockedUntil: (string | null)
-/**
- * When the user last signed in (ISO 8601). Null if they never have.
- */
 lastSignInAt: (string | null)
-/**
- * The user's primary email address, as typed. Null when they have no primary identifier. Bind this rather than `identifiers.0.value`.
- */
-primaryEmail: (string | null)
-/**
- * Whether the user must set a new password at their next sign-in.
- */
 requiresReset: boolean
-/**
- * Metadata the end user may read; the only bag projected into their access token. Capped at 1.2 KB.
- */
-publicMetadata: {
-[k: string]: unknown
-}
-/**
- * Metadata the end user may write themselves. Treat it as untrusted.
- */
-unsafeMetadata: {
-[k: string]: unknown
+publicMetadata: UsersUsersDeleteOutputPublicMetadata
+unsafeMetadata: UsersUsersDeleteOutputPublicMetadata
+privateMetadata: UsersUsersDeleteOutputPublicMetadata
+emailChangeLockedUntil: (string | null)
 }
-/**
- * Metadata for the management plane only. Never reaches the end user or a token.
- */
-privateMetadata: {
+export interface UsersUsersDeleteOutputPublicMetadata {
 [k: string]: unknown
 }
-/**
- * Id of the primary identifier row. Null when there is no primary identifier.
- */
-primaryIdentifierId: (string | null)
-/**
- * Until this instant the user may not start another email change, because somebody reverted one (ISO 8601). Null for a user who never reverted one.
- */
-emailChangeLockedUntil: (string | null)
-}
 
 export interface UsersUsersExportInput {
 /**
@@ -113359,129 +111709,40 @@ includeDeleted?: boolean
 export interface UsersUsersExportOutput {
 count: number
 users: {
-/**
- * Id of this end user. Pass it to any users_users_* tool.
- */
 id: string
-/**
- * The user's display name. Null when nobody set one.
- */
 name: (string | null)
-/**
- * When the user was banned (ISO 8601). Null while they are not banned.
- */
 bannedAt: (string | null)
-/**
- * When this user's personal data was purged for good (ISO 8601). Null while it is intact.
- */
 erasedAt: (string | null)
-/**
- * URL of the user's avatar. Null when there is none.
- */
 imageUrl: (string | null)
-/**
- * Whether this is a test fixture — excluded from metering and from the default listing.
- */
 testUser: boolean
-/**
- * When the user was created (ISO 8601).
- */
 createdAt: string
-/**
- * When the user was soft-deleted (ISO 8601). Null while the account is live.
- */
 deletedAt: (string | null)
-/**
- * Product this user belongs to. Never an input — it comes from the calling identity.
- */
 productId: string
-/**
- * When the user was last changed (ISO 8601).
- */
 updatedAt: string
-/**
- * Whether this user is still on the waitlist and cannot sign in yet.
- */
 waitlisted: boolean
-/**
- * Every identifier of this user, the primary one flagged. To bind the primary address itself, use `primaryEmail` — `identifiers.0` means "the first", not "the primary".
- */
 identifiers: {
-/**
- * Id of this identifier row.
- */
 id: string
-/**
- * What kind of identifier this is. Today always `email`.
- */
 type: "email"
-/**
- * The address as the user typed it, for display.
- */
 value: string
-/**
- * Whether this is the identifier the user signs in with and is contacted at.
- */
 isPrimary: boolean
-/**
- * When this address was verified (ISO 8601). Null while it never was.
- */
 verifiedAt: (string | null)
-/**
- * The address lowercased and NFC-normalised — what uniqueness is checked against.
- */
 valueCanonical: string
-/**
- * `unverified`, `verified`, or `expired` when a verification link ran out before it was used.
- */
 verificationStatus: ("unverified" | "verified" | "expired")
 }[]
-/**
- * When a failed-attempt lockout expires (ISO 8601). Null when the user is not locked out.
- */
 lockedUntil: (string | null)
-/**
- * When the user last signed in (ISO 8601). Null if they never have.
- */
 lastSignInAt: (string | null)
-/**
- * The user's primary email address, as typed. Null when they have no primary identifier. Bind this rather than `identifiers.0.value`.
- */
-primaryEmail: (string | null)
-/**
- * Whether the user must set a new password at their next sign-in.
- */
 requiresReset: boolean
-/**
- * Metadata the end user may read; the only bag projected into their access token. Capped at 1.2 KB.
- */
-publicMetadata: {
-[k: string]: unknown
-}
-/**
- * Metadata the end user may write themselves. Treat it as untrusted.
- */
-unsafeMetadata: {
-[k: string]: unknown
-}
-/**
- * Metadata for the management plane only. Never reaches the end user or a token.
- */
-privateMetadata: {
-[k: string]: unknown
-}
-/**
- * Id of the primary identifier row. Null when there is no primary identifier.
- */
-primaryIdentifierId: (string | null)
-/**
- * Until this instant the user may not start another email change, because somebody reverted one (ISO 8601). Null for a user who never reverted one.
- */
+publicMetadata: UsersUsersExportOutputPublicMetadata
+unsafeMetadata: UsersUsersExportOutputPublicMetadata
+privateMetadata: UsersUsersExportOutputPublicMetadata
 emailChangeLockedUntil: (string | null)
 }[]
 exportedAt: string
 nextCursor: (string | null)
 }
+export interface UsersUsersExportOutputPublicMetadata {
+[k: string]: unknown
+}
 
 export interface UsersUsersGetInput {
 /**
@@ -113491,126 +111752,37 @@ userId: string
 }
 
 export interface UsersUsersGetOutput {
-/**
- * Id of this end user. Pass it to any users_users_* tool.
- */
 id: string
-/**
- * The user's display name. Null when nobody set one.
- */
 name: (string | null)
-/**
- * When the user was banned (ISO 8601). Null while they are not banned.
- */
 bannedAt: (string | null)
-/**
- * When this user's personal data was purged for good (ISO 8601). Null while it is intact.
- */
 erasedAt: (string | null)
-/**
- * URL of the user's avatar. Null when there is none.
- */
 imageUrl: (string | null)
-/**
- * Whether this is a test fixture — excluded from metering and from the default listing.
- */
 testUser: boolean
-/**
- * When the user was created (ISO 8601).
- */
 createdAt: string
-/**
- * When the user was soft-deleted (ISO 8601). Null while the account is live.
- */
 deletedAt: (string | null)
-/**
- * Product this user belongs to. Never an input — it comes from the calling identity.
- */
 productId: string
-/**
- * When the user was last changed (ISO 8601).
- */
 updatedAt: string
-/**
- * Whether this user is still on the waitlist and cannot sign in yet.
- */
 waitlisted: boolean
-/**
- * Every identifier of this user, the primary one flagged. To bind the primary address itself, use `primaryEmail` — `identifiers.0` means "the first", not "the primary".
- */
 identifiers: {
-/**
- * Id of this identifier row.
- */
 id: string
-/**
- * What kind of identifier this is. Today always `email`.
- */
 type: "email"
-/**
- * The address as the user typed it, for display.
- */
 value: string
-/**
- * Whether this is the identifier the user signs in with and is contacted at.
- */
 isPrimary: boolean
-/**
- * When this address was verified (ISO 8601). Null while it never was.
- */
 verifiedAt: (string | null)
-/**
- * The address lowercased and NFC-normalised — what uniqueness is checked against.
- */
 valueCanonical: string
-/**
- * `unverified`, `verified`, or `expired` when a verification link ran out before it was used.
- */
 verificationStatus: ("unverified" | "verified" | "expired")
 }[]
-/**
- * When a failed-attempt lockout expires (ISO 8601). Null when the user is not locked out.
- */
 lockedUntil: (string | null)
-/**
- * When the user last signed in (ISO 8601). Null if they never have.
- */
 lastSignInAt: (string | null)
-/**
- * The user's primary email address, as typed. Null when they have no primary identifier. Bind this rather than `identifiers.0.value`.
- */
-primaryEmail: (string | null)
-/**
- * Whether the user must set a new password at their next sign-in.
- */
 requiresReset: boolean
-/**
- * Metadata the end user may read; the only bag projected into their access token. Capped at 1.2 KB.
- */
-publicMetadata: {
-[k: string]: unknown
-}
-/**
- * Metadata the end user may write themselves. Treat it as untrusted.
- */
-unsafeMetadata: {
-[k: string]: unknown
+publicMetadata: UsersUsersGetOutputPublicMetadata
+unsafeMetadata: UsersUsersGetOutputPublicMetadata
+privateMetadata: UsersUsersGetOutputPublicMetadata
+emailChangeLockedUntil: (string | null)
 }
-/**
- * Metadata for the management plane only. Never reaches the end user or a token.
- */
-privateMetadata: {
+export interface UsersUsersGetOutputPublicMetadata {
 [k: string]: unknown
 }
-/**
- * Id of the primary identifier row. Null when there is no primary identifier.
- */
-primaryIdentifierId: (string | null)
-/**
- * Until this instant the user may not start another email change, because somebody reverted one (ISO 8601). Null for a user who never reverted one.
- */
-emailChangeLockedUntil: (string | null)
-}
 
 export interface UsersUsersImportInput {
 /**
@@ -113623,42 +111795,15 @@ users: [unknown, ...(unknown)[]]
 }
 
 export interface UsersUsersImportOutput {
-/**
- * How many rows could not be imported at all.
- */
 failed: number
-/**
- * How many users were created.
- */
 created: number
-/**
- * One row per submitted row, in the order you sent them.
- */
 results: {
-/**
- * Zero-based index of the row in the `users` array you sent.
- */
 row: number
-/**
- * Why it was skipped, or what went wrong. Null for a created row.
- */
 reason: (string | null)
-/**
- * What happened to this row.
- */
 status: ("created" | "skipped" | "failed")
-/**
- * The created user's id. Null for skipped and failed rows.
- */
 userId: (string | null)
 }[]
-/**
- * How many rows were passed over — an address already in the directory, typically.
- */
 skipped: number
-/**
- * How many rows you submitted.
- */
 requested: number
 }
 
@@ -113686,21 +111831,9 @@ privateMetadata?: {
 }
 
 export interface UsersUsersInviteOutput {
-/**
- * False when the re-invite cooldown or the mail toolkit refused the send. The invite is still live.
- */
 mailed: boolean
-/**
- * The invited user, created immediately and listed straight away — they simply cannot sign in until they accept.
- */
 userId: string
-/**
- * False when this address had already been invited; the same user is returned.
- */
 created: boolean
-/**
- * When the invite link stops working (ISO 8601).
- */
 expiresAt: string
 }
 
@@ -113736,135 +111869,40 @@ includeWaitlisted?: boolean
 }
 
 export interface UsersUsersListOutput {
-/**
- * The page of users, newest first.
- */
 users: {
-/**
- * Id of this end user. Pass it to any users_users_* tool.
- */
 id: string
-/**
- * The user's display name. Null when nobody set one.
- */
 name: (string | null)
-/**
- * When the user was banned (ISO 8601). Null while they are not banned.
- */
 bannedAt: (string | null)
-/**
- * When this user's personal data was purged for good (ISO 8601). Null while it is intact.
- */
 erasedAt: (string | null)
-/**
- * URL of the user's avatar. Null when there is none.
- */
 imageUrl: (string | null)
-/**
- * Whether this is a test fixture — excluded from metering and from the default listing.
- */
 testUser: boolean
-/**
- * When the user was created (ISO 8601).
- */
 createdAt: string
-/**
- * When the user was soft-deleted (ISO 8601). Null while the account is live.
- */
 deletedAt: (string | null)
-/**
- * Product this user belongs to. Never an input — it comes from the calling identity.
- */
 productId: string
-/**
- * When the user was last changed (ISO 8601).
- */
 updatedAt: string
-/**
- * Whether this user is still on the waitlist and cannot sign in yet.
- */
 waitlisted: boolean
-/**
- * Every identifier of this user, the primary one flagged. To bind the primary address itself, use `primaryEmail` — `identifiers.0` means "the first", not "the primary".
- */
 identifiers: {
-/**
- * Id of this identifier row.
- */
 id: string
-/**
- * What kind of identifier this is. Today always `email`.
- */
 type: "email"
-/**
- * The address as the user typed it, for display.
- */
 value: string
-/**
- * Whether this is the identifier the user signs in with and is contacted at.
- */
 isPrimary: boolean
-/**
- * When this address was verified (ISO 8601). Null while it never was.
- */
 verifiedAt: (string | null)
-/**
- * The address lowercased and NFC-normalised — what uniqueness is checked against.
- */
 valueCanonical: string
-/**
- * `unverified`, `verified`, or `expired` when a verification link ran out before it was used.
- */
 verificationStatus: ("unverified" | "verified" | "expired")
 }[]
-/**
- * When a failed-attempt lockout expires (ISO 8601). Null when the user is not locked out.
- */
 lockedUntil: (string | null)
-/**
- * When the user last signed in (ISO 8601). Null if they never have.
- */
 lastSignInAt: (string | null)
-/**
- * The user's primary email address, as typed. Null when they have no primary identifier. Bind this rather than `identifiers.0.value`.
- */
-primaryEmail: (string | null)
-/**
- * Whether the user must set a new password at their next sign-in.
- */
 requiresReset: boolean
-/**
- * Metadata the end user may read; the only bag projected into their access token. Capped at 1.2 KB.
- */
-publicMetadata: {
-[k: string]: unknown
-}
-/**
- * Metadata the end user may write themselves. Treat it as untrusted.
- */
-unsafeMetadata: {
-[k: string]: unknown
-}
-/**
- * Metadata for the management plane only. Never reaches the end user or a token.
- */
-privateMetadata: {
-[k: string]: unknown
-}
-/**
- * Id of the primary identifier row. Null when there is no primary identifier.
- */
-primaryIdentifierId: (string | null)
-/**
- * Until this instant the user may not start another email change, because somebody reverted one (ISO 8601). Null for a user who never reverted one.
- */
+publicMetadata: UsersUsersListOutputPublicMetadata
+unsafeMetadata: UsersUsersListOutputPublicMetadata
+privateMetadata: UsersUsersListOutputPublicMetadata
 emailChangeLockedUntil: (string | null)
 }[]
-/**
- * Pass back as `cursor` to fetch the next page. Null when this page is the last.
- */
 nextCursor: (string | null)
 }
+export interface UsersUsersListOutputPublicMetadata {
+[k: string]: unknown
+}
 
 export interface UsersUsersSetPrimaryIdentifierInput {
 /**
@@ -113882,13 +111920,7 @@ userId: string
 }
 
 export interface UsersUsersSetPrimaryIdentifierOutput {
-/**
- * Id of the scheduled change. It appears in the audit rows and in the abort link mailed to the old address.
- */
 requestId: string
-/**
- * When the swap becomes applicable, if nobody aborts it first (ISO 8601). The delay is this product's `emailChange.overrideDelayHours`, 72 by default.
- */
 scheduledFor: string
 }
 
@@ -113900,126 +111932,37 @@ userId: string
 }
 
 export interface UsersUsersUnbanOutput {
-/**
- * Id of this end user. Pass it to any users_users_* tool.
- */
 id: string
-/**
- * The user's display name. Null when nobody set one.
- */
 name: (string | null)
-/**
- * When the user was banned (ISO 8601). Null while they are not banned.
- */
 bannedAt: (string | null)
-/**
- * When this user's personal data was purged for good (ISO 8601). Null while it is intact.
- */
 erasedAt: (string | null)
-/**
- * URL of the user's avatar. Null when there is none.
- */
 imageUrl: (string | null)
-/**
- * Whether this is a test fixture — excluded from metering and from the default listing.
- */
 testUser: boolean
-/**
- * When the user was created (ISO 8601).
- */
 createdAt: string
-/**
- * When the user was soft-deleted (ISO 8601). Null while the account is live.
- */
 deletedAt: (string | null)
-/**
- * Product this user belongs to. Never an input — it comes from the calling identity.
- */
 productId: string
-/**
- * When the user was last changed (ISO 8601).
- */
 updatedAt: string
-/**
- * Whether this user is still on the waitlist and cannot sign in yet.
- */
 waitlisted: boolean
-/**
- * Every identifier of this user, the primary one flagged. To bind the primary address itself, use `primaryEmail` — `identifiers.0` means "the first", not "the primary".
- */
 identifiers: {
-/**
- * Id of this identifier row.
- */
 id: string
-/**
- * What kind of identifier this is. Today always `email`.
- */
 type: "email"
-/**
- * The address as the user typed it, for display.
- */
 value: string
-/**
- * Whether this is the identifier the user signs in with and is contacted at.
- */
 isPrimary: boolean
-/**
- * When this address was verified (ISO 8601). Null while it never was.
- */
 verifiedAt: (string | null)
-/**
- * The address lowercased and NFC-normalised — what uniqueness is checked against.
- */
 valueCanonical: string
-/**
- * `unverified`, `verified`, or `expired` when a verification link ran out before it was used.
- */
 verificationStatus: ("unverified" | "verified" | "expired")
 }[]
-/**
- * When a failed-attempt lockout expires (ISO 8601). Null when the user is not locked out.
- */
 lockedUntil: (string | null)
-/**
- * When the user last signed in (ISO 8601). Null if they never have.
- */
 lastSignInAt: (string | null)
-/**
- * The user's primary email address, as typed. Null when they have no primary identifier. Bind this rather than `identifiers.0.value`.
- */
-primaryEmail: (string | null)
-/**
- * Whether the user must set a new password at their next sign-in.
- */
 requiresReset: boolean
-/**
- * Metadata the end user may read; the only bag projected into their access token. Capped at 1.2 KB.
- */
-publicMetadata: {
-[k: string]: unknown
-}
-/**
- * Metadata the end user may write themselves. Treat it as untrusted.
- */
-unsafeMetadata: {
-[k: string]: unknown
+publicMetadata: UsersUsersUnbanOutputPublicMetadata
+unsafeMetadata: UsersUsersUnbanOutputPublicMetadata
+privateMetadata: UsersUsersUnbanOutputPublicMetadata
+emailChangeLockedUntil: (string | null)
 }
-/**
- * Metadata for the management plane only. Never reaches the end user or a token.
- */
-privateMetadata: {
+export interface UsersUsersUnbanOutputPublicMetadata {
 [k: string]: unknown
 }
-/**
- * Id of the primary identifier row. Null when there is no primary identifier.
- */
-primaryIdentifierId: (string | null)
-/**
- * Until this instant the user may not start another email change, because somebody reverted one (ISO 8601). Null for a user who never reverted one.
- */
-emailChangeLockedUntil: (string | null)
-}
 
 export interface UsersUsersUpdateInput {
 /**
@@ -114069,126 +112012,37 @@ export interface UsersUsersUpdateInputPublicMetadata1 {
 }
 
 export interface UsersUsersUpdateOutput {
-/**
- * Id of this end user. Pass it to any users_users_* tool.
- */
 id: string
-/**
- * The user's display name. Null when nobody set one.
- */
 name: (string | null)
-/**
- * When the user was banned (ISO 8601). Null while they are not banned.
- */
 bannedAt: (string | null)
-/**
- * When this user's personal data was purged for good (ISO 8601). Null while it is intact.
- */
 erasedAt: (string | null)
-/**
- * URL of the user's avatar. Null when there is none.
- */
 imageUrl: (string | null)
-/**
- * Whether this is a test fixture — excluded from metering and from the default listing.
- */
 testUser: boolean
-/**
- * When the user was created (ISO 8601).
- */
 createdAt: string
-/**
- * When the user was soft-deleted (ISO 8601). Null while the account is live.
- */
 deletedAt: (string | null)
-/**
- * Product this user belongs to. Never an input — it comes from the calling identity.
- */
 productId: string
-/**
- * When the user was last changed (ISO 8601).
- */
 updatedAt: string
-/**
- * Whether this user is still on the waitlist and cannot sign in yet.
- */
 waitlisted: boolean
-/**
- * Every identifier of this user, the primary one flagged. To bind the primary address itself, use `primaryEmail` — `identifiers.0` means "the first", not "the primary".
- */
 identifiers: {
-/**
- * Id of this identifier row.
- */
 id: string
-/**
- * What kind of identifier this is. Today always `email`.
- */
 type: "email"
-/**
- * The address as the user typed it, for display.
- */
 value: string
-/**
- * Whether this is the identifier the user signs in with and is contacted at.
- */
 isPrimary: boolean
-/**
- * When this address was verified (ISO 8601). Null while it never was.
- */
 verifiedAt: (string | null)
-/**
- * The address lowercased and NFC-normalised — what uniqueness is checked against.
- */
 valueCanonical: string
-/**
- * `unverified`, `verified`, or `expired` when a verification link ran out before it was used.
- */
 verificationStatus: ("unverified" | "verified" | "expired")
 }[]
-/**
- * When a failed-attempt lockout expires (ISO 8601). Null when the user is not locked out.
- */
 lockedUntil: (string | null)
-/**
- * When the user last signed in (ISO 8601). Null if they never have.
- */
 lastSignInAt: (string | null)
-/**
- * The user's primary email address, as typed. Null when they have no primary identifier. Bind this rather than `identifiers.0.value`.
- */
-primaryEmail: (string | null)
-/**
- * Whether the user must set a new password at their next sign-in.
- */
 requiresReset: boolean
-/**
- * Metadata the end user may read; the only bag projected into their access token. Capped at 1.2 KB.
- */
-publicMetadata: {
-[k: string]: unknown
-}
-/**
- * Metadata the end user may write themselves. Treat it as untrusted.
- */
-unsafeMetadata: {
-[k: string]: unknown
+publicMetadata: UsersUsersUpdateOutputPublicMetadata
+unsafeMetadata: UsersUsersUpdateOutputPublicMetadata
+privateMetadata: UsersUsersUpdateOutputPublicMetadata
+emailChangeLockedUntil: (string | null)
 }
-/**
- * Metadata for the management plane only. Never reaches the end user or a token.
- */
-privateMetadata: {
+export interface UsersUsersUpdateOutputPublicMetadata {
 [k: string]: unknown
 }
-/**
- * Id of the primary identifier row. Null when there is no primary identifier.
- */
-primaryIdentifierId: (string | null)
-/**
- * Until this instant the user may not start another email change, because somebody reverted one (ISO 8601). Null for a user who never reverted one.
- */
-emailChangeLockedUntil: (string | null)
-}
 
 export interface UsersWaitlistFunnelInput {
 
@@ -114368,42 +112222,15 @@ unsafeMetadata?: {
 }
 
 export interface UsersWaitlistImportOutput {
-/**
- * How many could not be imported at all.
- */
 failed: number
-/**
- * One row per submitted row, in the order you sent them.
- */
 results: {
-/**
- * Zero-based index of the row in the array you sent.
- */
 row: number
-/**
- * Why it was skipped, or what went wrong. Null for an imported row.
- */
 reason: (string | null)
-/**
- * What happened to this row.
- */
 status: ("imported" | "skipped" | "failed")
-/**
- * The waitlisted user this row created. Null for skipped and failed rows.
- */
 userId: (string | null)
 }[]
-/**
- * How many were already on the list or otherwise passed over.
- */
 skipped: number
-/**
- * How many became waitlist entries.
- */
 imported: number
-/**
- * How many rows you submitted.
- */
 requested: number
 }
 
@@ -114418,30 +112245,12 @@ userIds: [string, ...(string)[]]
 }
 
 export interface UsersWaitlistInviteOutput {
-/**
- * How many of the requested users were invited.
- */
 invited: number
-/**
- * One row per user you asked for, in the order you sent them.
- */
 results: {
-/**
- * Why this user was skipped. Null for an invited row.
- */
 reason: (("suppressed" | "not_found" | "already_registered") | null)
-/**
- * Whether this user was invited or passed over.
- */
 status: ("invited" | "skipped")
-/**
- * The user this row is about.
- */
 userId: string
 }[]
-/**
- * How many were passed over — see each row's `reason`.
- */
 skipped: number
 }
 
@@ -114465,62 +112274,23 @@ confirmed?: boolean
 }
 
 export interface UsersWaitlistListOutput {
-/**
- * The page of waitlist entries, newest first.
- */
 entries: {
-/**
- * Where in the funnel this entry is: `pending`, `invited`, `registered` or `withdrawn`.
- */
 status: ("pending" | "invited" | "registered" | "withdrawn")
-/**
- * The waitlisted user. Every users_users_* tool takes this id.
- */
 userId: string
-/**
- * When the entry joined the waitlist (ISO 8601).
- */
 createdAt: string
-/**
- * When the invite was sent (ISO 8601). Null while the entry is pending.
- */
 invitedAt: (string | null)
-/**
- * The email address that signed up.
- */
 identifier: string
-/**
- * Where the signup came from — the campaign, referrer and landing page recorded at the time.
- */
 attribution: {
 [k: string]: unknown
 }
-/**
- * When the address confirmed a double opt-in (ISO 8601). Null when it never did.
- */
 confirmedAt: (string | null)
-/**
- * When the address asked to be taken off the list (ISO 8601). Null when it did not.
- */
 withdrawnAt: (string | null)
-/**
- * What was recorded to show this address consented: when, from where, and under which wording.
- */
 consentProof: {
 [k: string]: unknown
 }
-/**
- * When the invitee finished signing up (ISO 8601). Null until they do.
- */
 registeredAt: (string | null)
-/**
- * Id of the live invite token. Null while the entry has not been invited.
- */
 inviteTokenId: (string | null)
 }[]
-/**
- * Pass back as `cursor` to fetch the next page. Null when this page is the last.
- */
 nextCursor: (string | null)
 }