@naturali/sdk 0.209.3 → 0.209.4

package/dist/index.d.mts

@@ -537,7 +537,7 @@ type ChannelAction = {
    */
   repeat: 'every' | 'once' | {
     after_seconds: number;
-  };
+  } | null;
   /**
    * Preferred reply language; null lets the agent decide.
    */
@@ -804,6 +804,10 @@ type Price = {
    * Null on a global default row; set on a per-provider override.
    */
   ai_provider_id?: string | null;
+  /**
+   * Null on a global default row.
+   */
+  project_id?: string | null;
   meter_type?: string;
   /**
    * The SKU's vendor slug. Relayed exactly as stored — this is the operator surface, and the value the runtime recorded is the point.
@@ -820,6 +824,16 @@ type Price = {
    * USD per unit.
    */
   unit_price?: number;
+  /**
+   * The tool or agent a resource row prices; null on a SKU row.
+   */
+  resource?: string | null;
+  /**
+   * A resource row's quantity expression; null prices one per call.
+   */
+  quantity?: {
+    [key: string]: unknown;
+  } | null;
   /**
    * The row with the latest effective_from at or before now prices a call.
    */
@@ -1030,12 +1044,12 @@ type Agent = {
      */
     min_score?: number;
     /**
-     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
+     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the default of 60 applies.
      *
      */
     rrf_k?: number;
     /**
-     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
+     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the default of `0` applies.
      *
      */
     recency_half_life_days?: number;
@@ -1293,12 +1307,12 @@ type CreateAgentRequest = {
      */
     min_score?: number;
     /**
-     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
+     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the default of 60 applies.
      *
      */
     rrf_k?: number;
     /**
-     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
+     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the default of `0` applies.
      *
      */
     recency_half_life_days?: number;
@@ -1438,12 +1452,12 @@ type UpdateAgentRequest = {
      */
     min_score?: number;
     /**
-     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
+     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the default of 60 applies.
      *
      */
     rrf_k?: number;
     /**
-     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
+     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the default of `0` applies.
      *
      */
     recency_half_life_days?: number;
@@ -1578,12 +1592,12 @@ type CreateAgentGenerationRequest = {
      */
     min_score?: number;
     /**
-     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
+     * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the default of 60 applies.
      *
      */
     rrf_k?: number;
     /**
-     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
+     * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the default of `0` applies.
      *
      */
     recency_half_life_days?: number;
@@ -2541,6 +2555,11 @@ type ChannelRoute = ChannelAction & {
   status: 'active' | 'disabled';
   created_at: Date;
   updated_at: Date;
+  /**
+   * On a create or update response only, and only when non-empty. `unreachable_surface`: the channel's transport mode does not deliver this surface yet.
+   *
+   */
+  warnings?: Array<'unreachable_surface'>;
 };
 type ChannelRouteWrite = {
   surface?: string | null;
@@ -2655,10 +2674,10 @@ type Channel = {
  * the optional `modes` opting into the gateway flows. Discord runs over
  * the Gateway, so the bot token is kept in naturali's encrypted store
  * (the worker must present it to authenticate its WebSocket) rather than
- * as a secret on the runtime; deployments without `CHANNEL_TOKEN_KEY` configured
- * return `501`.
+ * as a secret on the runtime; a deployment that does not enable Discord
+ * channels returns `501`.
  *
- * No credential value is ever returned. `default` is required (CHANNELS-ROUTING.md §3.3.1) — connecting a channel without saying what it does when nothing else matches is the misconfiguration, so it is caught here rather than discovered as silence in production.
+ * No credential value is ever returned. `default` is required — connecting a channel without saying what it does when nothing else matches is the misconfiguration, so it is caught here rather than discovered as silence in production.
  *
  */
 type ChannelCreate = {
@@ -2686,7 +2705,7 @@ type ChannelCreate = {
    */
   access_token?: string;
   /**
-   * Required for `embedded_signup`. The short-lived authorization code from the Meta popup; naturali exchanges it for the access token server-side. Never stored or returned.
+   * Required for `embedded_signup`. The short-lived authorization code from the Meta popup; naturali exchanges it for the access token server-side. Never stored or returned. A code Meta rejects (malformed, expired or already used) is `400 invalid_signup_code`.
    *
    */
   code?: string;
@@ -2817,7 +2836,7 @@ type Conversation = {
    */
   address_id: string;
   /**
-   * The route this conversation's action came from — a real route id, or one of the two sentinels for "the address's own action" / "the channel default" (CHANNELS-ROUTING.md §3.8). A message resolving to a different action opens a new conversation rather than re-pointing this one.
+   * The route this conversation's action came from — a real route id, or one of the two sentinels for "the address's own action" / "the channel default". A message resolving to a different action opens a new conversation rather than re-pointing this one.
    *
    */
   route_id: string;
@@ -3239,7 +3258,7 @@ type Decision = {
   updated_at?: Date;
 };
 /**
- * Why a resource's work failed, in the shape of an error response's `error` without `hint` and `docs_url`. Every `error` field a resource records carries it, so `code` can be read without first checking the type of `error`.
+ * Why a resource's work failed, in the shape of an error response's `error`. Every `error` field a resource records carries it, so `code` can be read without first checking the type of `error`.
  */
 type StoredError = {
   /**
@@ -8069,6 +8088,31 @@ type ProjectUsageEvent = {
    * The caller-supplied action label, when one was given.
    */
   action_id?: string | null;
+  /**
+   * The tool a tool_execution event metered. Null on every other meter and for an inline tool definition.
+   *
+   */
+  tool_id?: string | null;
+  /**
+   * The project owning the resource metered, when the call reached it through an install. Null for the project's own resources.
+   *
+   */
+  publisher_project_id?: string | null;
+  /**
+   * The document an embedding event embedded a chunk of. Null on a query embedding and on every other meter.
+   *
+   */
+  document_id?: string | null;
+  /**
+   * The memory store an embedding event embedded written content for. Null on a query embedding and on every other meter.
+   *
+   */
+  memory_store_id?: string | null;
+  /**
+   * How a tool_execution call ended: ok, error (including a non-2xx answer) or timeout. Null on every other meter.
+   *
+   */
+  outcome?: string | null;
   /**
    * llm_tokens, compute_execution, api_request, storage or tool_execution.
    */
@@ -8253,7 +8297,7 @@ type ProjectUsage = {
     from: Date | null;
     to: Date | null;
   };
-  group_by: 'model' | 'ai_provider' | 'agent' | 'run' | 'day' | 'meter_type';
+  group_by: 'model' | 'ai_provider' | 'agent' | 'run' | 'day' | 'meter_type' | 'actor' | 'session' | 'source';
   /**
    * The meter-type filter applied, echoed back; null when unfiltered.
    */
@@ -10087,6 +10131,10 @@ type ListActivityErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -10151,6 +10199,10 @@ type ExportActivityErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -10227,6 +10279,10 @@ type ListActorsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -10288,6 +10344,10 @@ type CreateActorErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -11335,6 +11395,10 @@ type ListAgentsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -12148,6 +12212,10 @@ type ListAiProvidersErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -12240,6 +12308,10 @@ type CreateAiProviderErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -12283,7 +12355,7 @@ type DeleteAiProviderData = {
   };
   query?: {
     /**
-     * When `true`, delete the provider's price overrides and unlink its usage history so a provider with only soft dependents can be removed. Has no effect on live references (chats, agents, model routes), which always block deletion.
+     * When `true`, delete the provider's price overrides and unlink its usage history so a provider with only soft dependents can be removed. Has no effect on live references (agents, model routes), which always block deletion.
      *
      */
     force?: boolean;
@@ -12869,6 +12941,10 @@ type ListApprovalsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -12929,6 +13005,10 @@ type ListApprovalRecurrencesErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -13000,7 +13080,7 @@ type GetApprovalResponse = GetApprovalResponses[keyof GetApprovalResponses];
 type ApproveApprovalData = {
   body?: {
     /**
-     * Edited arguments to execute instead of the proposed ones. Editing composes a new call, so it additionally requires permission to make that call: `tools:CallTool` on the tool, and for a `builtin` proposal the action's own IAM action. Refused on an item with no `proposed_action`.
+     * Edited arguments to execute instead of the proposed ones. Editing composes a new call to the tool. Refused on an item with no `proposed_action`.
      */
     arguments?: {
       [key: string]: unknown;
@@ -13149,6 +13229,10 @@ type ListAssistantGrantsErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * `access_denied`: the credential is confined to one project. Account routes need an account-wide credential.
+   */
+  403: ErrorResponse;
 };
 type ListAssistantGrantsError = ListAssistantGrantsErrors[keyof ListAssistantGrantsErrors];
 type ListAssistantGrantsResponses = {
@@ -13176,6 +13260,10 @@ type RevokeAssistantGrantErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * `access_denied`: the credential is confined to one project. Account routes need an account-wide credential.
+   */
+  403: ErrorResponse;
   /**
    * The resource does not exist (existence is not leaked).
    */
@@ -13210,6 +13298,10 @@ type PreviewAssistantLinkErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * `access_denied`: the credential is confined to one project. Account routes need an account-wide credential.
+   */
+  403: ErrorResponse;
 };
 type PreviewAssistantLinkError = PreviewAssistantLinkErrors[keyof PreviewAssistantLinkErrors];
 type PreviewAssistantLinkResponses = {
@@ -13235,6 +13327,10 @@ type RedeemAssistantLinkErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * `access_denied`: the credential is confined to one project. Account routes need an account-wide credential.
+   */
+  403: ErrorResponse;
   /**
    * The identity is already linked to an account (`identity_already_linked`). One channel identity operates one naturali account: re-pointing it means revoking the existing grant first, which is explicit and auditable rather than silent.
    *
@@ -13599,6 +13695,10 @@ type ListAuditEntriesErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -13667,6 +13767,10 @@ type ExportAuditEntriesErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -13824,6 +13928,11 @@ type RefreshSessionData = {
   url: '/v1/auth/refresh';
 };
 type RefreshSessionErrors = {
+  /**
+   * Neither the body nor the cookie carries a refresh token (`bad_request`).
+   *
+   */
+  400: ErrorResponse;
   /**
    * The refresh token is invalid, expired or was reused.
    */
@@ -13898,6 +14007,10 @@ type ListChainsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -14322,7 +14435,7 @@ type CreateChannelErrors = {
    */
   409: ErrorResponse;
   /**
-   * The requested path is not enabled on this deployment (e.g. embedded signup before Meta App credentials are configured, or a Discord channel before `CHANNEL_TOKEN_KEY` is set).
+   * The requested path is not enabled on this deployment (e.g. embedded signup or a Discord channel where neither is enabled).
    *
    */
   501: ErrorResponse;
@@ -14369,7 +14482,7 @@ type CreateWhatsappSignupLinkErrors = {
    */
   404: ErrorResponse;
   /**
-   * The requested path is not enabled on this deployment (e.g. embedded signup before Meta App credentials are configured, or a Discord channel before `CHANNEL_TOKEN_KEY` is set).
+   * The requested path is not enabled on this deployment (e.g. embedded signup or a Discord channel where neither is enabled).
    *
    */
   501: ErrorResponse;
@@ -14406,7 +14519,7 @@ type CompleteWhatsappSignupErrors = {
    */
   409: ErrorResponse;
   /**
-   * The requested path is not enabled on this deployment (e.g. embedded signup before Meta App credentials are configured, or a Discord channel before `CHANNEL_TOKEN_KEY` is set).
+   * The requested path is not enabled on this deployment (e.g. embedded signup or a Discord channel where neither is enabled).
    *
    */
   501: ErrorResponse;
@@ -14846,6 +14959,10 @@ type ListConversationsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -14906,6 +15023,10 @@ type CreateConversationErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -15563,6 +15684,10 @@ type ListDecidersErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -15606,6 +15731,10 @@ type CreateDeciderErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * A decider with this name already exists in the project
    */
@@ -16056,6 +16185,10 @@ type ListDecisionsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -16099,6 +16232,10 @@ type CreateInlineDecisionErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * The project is paused
    */
@@ -16227,6 +16364,10 @@ type ListDocumentsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -16301,6 +16442,10 @@ type CreateDocumentErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `path` is held by another file in the project (`NAME_CONFLICT`), or the project's `storage_bytes` quota is exceeded (`QUOTA_STORAGE_EXCEEDED`). Delete stored content, or raise the quota — no window reset clears a stored total, so no `Retry-After` is sent.
    */
@@ -16385,6 +16530,10 @@ type IngestDocumentErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * The file already backs a Document (a file can only be ingested once — use `POST /documents/{document_id}/ingest` to re-process the existing document, or upload a new copy of the file to ingest it separately), the path it would be filed at is held by another file in the project (`NAME_CONFLICT`), or the project's `storage_bytes` quota is exceeded (`QUOTA_STORAGE_EXCEEDED`; delete stored content or raise the quota — no `Retry-After` is sent, since no window reset clears a stored total).
    */
@@ -16443,6 +16592,10 @@ type ExportDocumentsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -17367,6 +17520,10 @@ type CreateEmbeddingsErrors = {
    * The caller cannot write to the project
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -17425,6 +17582,10 @@ type ListDatasetsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -17477,6 +17638,10 @@ type CreateDatasetErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * A dataset with that name already exists in the project
    */
@@ -18004,6 +18169,10 @@ type ListEvalsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -18069,6 +18238,10 @@ type CreateEvalErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * An eval with that name already exists in the project
    */
@@ -18620,6 +18793,10 @@ type ListExceptionsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -18845,6 +19022,10 @@ type ListFilesErrors = {
    * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -18906,6 +19087,10 @@ type CreateFileErrors = {
    * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * The project's `storage_bytes` quota is exceeded (`QUOTA_STORAGE_EXCEEDED`). Delete stored content, or raise the quota — no window reset clears a stored total, so no `Retry-After` is sent.
    */
@@ -18937,10 +19122,6 @@ type UploadFileData = {
      * File content
      */
     file: Blob | File;
-    /**
-     * Project ID to associate the file with. Optional when authenticating with a project-scoped API key, which defaults to the key's project; required otherwise.
-     */
-    project_id?: string;
     /**
      * Directory within the project (e.g. /images). Optional; defaults to / (root).
      */
@@ -18973,6 +19154,10 @@ type UploadFileErrors = {
    * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * The project's `storage_bytes` quota is exceeded (`QUOTA_STORAGE_EXCEEDED`). Delete stored content, or raise the quota — no window reset clears a stored total, so no `Retry-After` is sent.
    */
@@ -19022,6 +19207,10 @@ type UploadFileBase64Errors = {
    * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * The project's `storage_bytes` quota is exceeded (`QUOTA_STORAGE_EXCEEDED`). Delete stored content, or raise the quota — no window reset clears a stored total, so no `Retry-After` is sent.
    */
@@ -19528,6 +19717,10 @@ type ValidateFormationErrors = {
    * Unauthorized
    */
   401: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -19586,6 +19779,10 @@ type PlanFormationErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -19640,6 +19837,10 @@ type ListFormationsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -19701,6 +19902,10 @@ type CreateFormationErrors = {
    * Forbidden — either the caller may not operate on formations in the project, or it lacks an action a resource this template declares requires. `error.meta.denied_actions` names every missing action; nothing is applied.
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * Formation with this name already exists
    */
@@ -20021,6 +20226,10 @@ type ListGenerationsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -20329,6 +20538,10 @@ type ListGuardrailsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -20372,6 +20585,10 @@ type CreateGuardrailErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -20809,6 +21026,10 @@ type ListIngestionRulesErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -20899,6 +21120,10 @@ type CreateIngestionRuleErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * A rule for this content_type_glob already exists in the project
    */
@@ -21288,11 +21513,11 @@ type SearchKnowledgeData = {
      */
     min_similarity?: number;
     /**
-     * The `k` in the reciprocal rank fusion term `1 / (k + rank)`, which sets how steeply a result's contribution decays with its position in each ranked list. A smaller value weights the very top of each list more heavily. Defaults to the deployment's `KNOWLEDGE_RRF_K`, itself 60 by default. Only applies when `query` is provided.
+     * The `k` in the reciprocal rank fusion term `1 / (k + rank)`, which sets how steeply a result's contribution decays with its position in each ranked list. A smaller value weights the very top of each list more heavily. Defaults to 60. Only applies when `query` is provided.
      */
     rrf_k?: number;
     /**
-     * Half-life, in days, of a recency decay applied to **memory store** results after fusion: a result's `score` is multiplied by `2 ^ (-age_in_days / recency_half_life_days)`, where age is measured from its `updated_at`. Document results are never decayed. `0` — the default, and the default of the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` — disables the blend entirely; it is a switch, not a lower bound, and sending `0` turns off a deployment-wide decay for this one request. Accepts fractions (`0.5` is twelve hours). How many ranks a given half-life costs depends on `rrf_k`. Only applies when `query` is provided. **No value is known to be safe in general**: every half-life measured against the reference corpus that lifted recency-sensitive queries also cost relevance-sensitive ones, which is why this ships disabled. Measure against your own corpus before setting it — see the Retrieval Quality guide.
+     * Half-life, in days, of a recency decay applied to **memory store** results after fusion: a result's `score` is multiplied by `2 ^ (-age_in_days / recency_half_life_days)`, where age is measured from its `updated_at`. Document results are never decayed. `0`, the default, disables the blend entirely. Accepts fractions (`0.5` is twelve hours). How many ranks a given half-life costs depends on `rrf_k`. Only applies when `query` is provided. **No value is known to be safe in general**: every half-life measured against the reference corpus that lifted recency-sensitive queries also cost relevance-sensitive ones, which is why this ships disabled. Measure against your own corpus before setting it.
      */
     recency_half_life_days?: number;
     /**
@@ -21350,6 +21575,10 @@ type SearchKnowledgeErrors = {
    * Forbidden, or a `query` and no project in scope the caller holds `embeddings:CreateEmbeddings` on to bill its embedding to
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -22773,6 +23002,10 @@ type ListMemoryStoresErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -22837,6 +23070,10 @@ type CreateMemoryStoreErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -23349,6 +23586,10 @@ type ListMetadataSchemasErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -23407,6 +23648,10 @@ type CreateMetadataSchemaErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * Conflict — this selector is already declared for this type
    */
@@ -23465,6 +23710,10 @@ type ValidateMetadataErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -23694,6 +23943,10 @@ type ListModelRoutesErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -23758,6 +24011,10 @@ type CreateModelRouteErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * A model route with this name already exists in the project
    */
@@ -24064,6 +24321,10 @@ type ListOrchestrationsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -24107,6 +24368,10 @@ type CreateOrchestrationErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -24148,6 +24413,10 @@ type ValidateOrchestrationErrors = {
    * Unauthorized
    */
   401: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -24193,6 +24462,10 @@ type GetQueueStatsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -24243,6 +24516,10 @@ type ListQueueStatsProjectsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -24650,6 +24927,10 @@ type ListOrchestrationRunsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -25094,6 +25375,10 @@ type ListPlaybooksErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -25137,6 +25422,10 @@ type CreatePlaybookErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * A playbook with this name already exists in the project
    */
@@ -25644,6 +25933,10 @@ type ListPlaybookCasesErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -27598,6 +27891,10 @@ type ListQuotasErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -27674,6 +27971,10 @@ type CreateQuotaErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * A matching quota already exists
    */
@@ -27896,6 +28197,10 @@ type ListSecretsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -27958,6 +28263,10 @@ type CreateSecretErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -28969,6 +29278,10 @@ type ListTasksErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -29564,6 +29877,10 @@ type ListToolsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -29607,6 +29924,10 @@ type CreateToolErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `REQUEST_REJECTED` — the request body is over the size the body parser accepts
    */
@@ -29879,6 +30200,10 @@ type ListTracesErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -30080,6 +30405,10 @@ type ListTriggersErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -30123,6 +30452,10 @@ type CreateTriggerErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * NAME_CONFLICT — a trigger with this name already exists in the project.
    */
@@ -30181,6 +30514,10 @@ type CountTriggersErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -31230,6 +31567,10 @@ type ListWebhooksErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
+   */
+  403: ErrorResponse;
   /**
    * The resource does not exist (existence is not leaked).
    */
@@ -31265,6 +31606,10 @@ type CreateWebhookErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
+   */
+  403: ErrorResponse;
   /**
    * The resource does not exist (existence is not leaked).
    */
@@ -31308,6 +31653,10 @@ type DeleteWebhookErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
+   */
+  403: ErrorResponse;
   /**
    * The resource does not exist (existence is not leaked).
    */
@@ -31341,6 +31690,10 @@ type GetWebhookErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
+   */
+  403: ErrorResponse;
   /**
    * The resource does not exist (existence is not leaked).
    */
@@ -31378,6 +31731,10 @@ type UpdateWebhookErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
+   */
+  403: ErrorResponse;
   /**
    * The resource does not exist (existence is not leaked).
    */
@@ -31411,6 +31768,10 @@ type RotateWebhookSecretErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
+   */
+  403: ErrorResponse;
   /**
    * The resource does not exist (existence is not leaked).
    */
@@ -31470,6 +31831,10 @@ type ListWebhookDeliveriesErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
+   */
+  403: ErrorResponse;
   /**
    * The resource does not exist (existence is not leaked).
    */
@@ -31505,6 +31870,10 @@ type GetWebhookDeliveryErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
+   */
+  403: ErrorResponse;
   /**
    * The resource does not exist (existence is not leaked).
    */
@@ -31538,6 +31907,10 @@ type RedeliverWebhookDeliveryErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
+   */
+  403: ErrorResponse;
   /**
    * The resource does not exist (existence is not leaked).
    */
@@ -31589,6 +31962,10 @@ type ListWorkflowsErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * `QUOTA_EXCEEDED` — a `requests` quota on the calling API key or its project is spent for the window; `Retry-After` says when it reopens
    */
@@ -31632,6 +32009,10 @@ type CreateWorkflowErrors = {
    * Forbidden
    */
   403: ErrorResponse;
+  /**
+   * The project does not exist or the caller is not a member of it (`not_found`).
+   */
+  404: ErrorResponse;
   /**
    * A workflow with this name already exists
    */
@@ -32192,6 +32573,8 @@ export declare class Channels {
    *
    * `actor_id` binds an actor of this project, so the address speaks as the same actor your own sessions use. A changed actor deletes the address's conversations and their sessions — a session's actor is fixed — and the next message opens a fresh one; the actor naturali created for the address is deleted with them. An actor you bind is never deleted here.
    *
+   * An identifier no channel kind produces is `400`.
+   *
    */
   static setAddress<ThrowOnError extends boolean = false>(options: Options<SetAddressData, ThrowOnError>): RequestResult<SetAddressResponses, SetAddressErrors, ThrowOnError>;
   /**
@@ -32246,7 +32629,7 @@ export declare class Channels {
   /**
    * Read the whole route table
    *
-   * Every route across every channel in the project, one read — the table is small by construction (CHANNELS-ROUTING.md §3.6), so this is unpaginated.
+   * Every route across every channel in the project, one read — the table is small by construction, so this is unpaginated.
    *
    */
   static listProjectChannelRoutes<ThrowOnError extends boolean = false>(options: Options<ListProjectChannelRoutesData, ThrowOnError>): RequestResult<ListProjectChannelRoutesResponses, ListProjectChannelRoutesErrors, ThrowOnError>;
@@ -32260,7 +32643,7 @@ export declare class Channels {
    * Connect a channel
    *
    * Connect a channel. The required fields depend on `channel`; no credential is ever returned.
-   * **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). The token is checked with Discord first: `400 invalid_bot_token` when Discord rejects it, `400 application_mismatch` when it belongs to another application. Returns `501` when the deployment has no `CHANNEL_TOKEN_KEY` configured.
+   * **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). The token is checked with Discord first: `400 invalid_bot_token` when Discord rejects it, `400 application_mismatch` when it belongs to another application. Returns `501` when this deployment does not enable Discord channels.
    * **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret:
    * * **BYOT** (`credential_source: byot`, default) — supply
    * `phone_number_id` and `access_token` from your own Meta app.
@@ -32577,7 +32960,7 @@ export declare class AiProviders {
    *
    * Deletes an AI provider configuration.
    *
-   * Live references — chats, agents, and model routes whose targets name this provider — always block deletion with `409 AI_PROVIDER_HAS_DEPENDENTS`; `force` does not override them, so delete or repoint those resources first. Soft dependents — price overrides and usage/generation records — also block with `409` unless `force=true`, which deletes the provider's price overrides and unlinks its usage history, preserving those rows: each usage event keeps the provider's id as its `ai_provider_id`. The `409` body's `error.meta` reports the counts, a sample of offending IDs, and a `forcible` flag that is `true` when a `force=true` retry would succeed.
+   * Live references — agents and model routes whose targets name this provider — always block deletion with `409 AI_PROVIDER_HAS_DEPENDENTS`; `force` does not override them, so delete or repoint those resources first. Soft dependents — price overrides and usage/generation records — also block with `409` unless `force=true`, which deletes the provider's price overrides and unlinks its usage history, preserving those rows: each usage event keeps the provider's id as its `ai_provider_id`. The `409` body's `error.meta` reports the counts, a sample of offending IDs, and a `forcible` flag that is `true` when a `force=true` retry would succeed.
    *
    */
   static deleteAiProvider<ThrowOnError extends boolean = false>(options: Options<DeleteAiProviderData, ThrowOnError>): RequestResult<DeleteAiProviderResponses, DeleteAiProviderErrors, ThrowOnError>;
@@ -32816,7 +33199,7 @@ export declare class Auth {
   /**
    * Refresh a session
    *
-   * Exchanges a valid refresh token for a new access JWT and a rotated refresh token, taken from the body or from the `refresh_token` cookie set at sign-in — a browser sends an empty body and the cookie carries the credential. Refresh tokens are single-use; presenting a previously-rotated token is treated as reuse and revokes the whole session family (createRefreshRotation reuse detection), except within a few seconds of the rotation, where it is treated as two tabs racing on one cookie and rotated again.
+   * Exchanges a valid refresh token for a new access JWT and a rotated refresh token, taken from the body or from the `refresh_token` cookie set at sign-in — a browser sends an empty body and the cookie carries the credential. Refresh tokens are single-use; presenting a previously-rotated token is treated as reuse and revokes the whole session family, except within a few seconds of the rotation, where it is treated as two tabs racing on one cookie and rotated again.
    *
    */
   static refreshSession<ThrowOnError extends boolean = false>(options: Options<RefreshSessionData, ThrowOnError>): RequestResult<RefreshSessionResponses, RefreshSessionErrors, ThrowOnError>;
@@ -34021,15 +34404,15 @@ export declare class Orchestrations {
   /**
    * Get orchestration queue stats
    *
-   * Returns a point-in-time snapshot of the orchestration run queue: how many tasks are waiting to be claimed (`queue_depth`), how many are currently claimed with a valid lease (`claimed_tasks`), the age of the oldest waiting task, recent claim-latency percentiles over a rolling in-process window. The per-project breakdown is listed by `GET /v1/projects/{project_id}/orchestrations/queue/stats/projects`. Intended for admin/operator policies; guarded by `orchestrations:GetQueueStats`.
-   * Every figure is scoped to what the caller may see. A project-scoped caller gets `queue_depth` and `claimed_tasks` summed over their own projects, and `null` for `oldest_queued_age_seconds` and the `claim_latency_ms` percentiles — both describe the whole deployment and cannot be narrowed, so they are withheld rather than approximated. An unrestricted caller (the action granted on every project) gets the deployment-wide figures.
+   * Returns a point-in-time snapshot of the orchestration run queue: how many tasks are waiting to be claimed (`queue_depth`), how many are currently claimed with a valid lease (`claimed_tasks`), the age of the oldest waiting task, recent claim-latency percentiles over a rolling in-process window. The per-project breakdown is listed by `GET /v1/projects/{project_id}/orchestrations/queue/stats/projects`.
+   * Every figure is scoped to what the caller may see. A project-scoped caller gets `queue_depth` and `claimed_tasks` summed over their own projects, and `null` for `oldest_queued_age_seconds` and the `claim_latency_ms` percentiles — both describe the whole deployment and cannot be narrowed, so they are withheld rather than approximated.
    *
    */
   static getQueueStats<ThrowOnError extends boolean = false>(options: Options<GetQueueStatsData, ThrowOnError>): RequestResult<GetQueueStatsResponses, GetQueueStatsErrors, ThrowOnError>;
   /**
    * List the projects with queued orchestration work
    *
-   * One row per project with any queued or claimed task, ordered by project ID: the per-project breakdown of `GET /v1/projects/{project_id}/orchestrations/queue/stats`. A project-scoped caller sees its own projects only. Guarded by `orchestrations:GetQueueStats`.
+   * One row per project with any queued or claimed task, ordered by project ID: the per-project breakdown of `GET /v1/projects/{project_id}/orchestrations/queue/stats`. A project-scoped caller sees its own projects only.
    *
    */
   static listQueueStatsProjects<ThrowOnError extends boolean = false>(options: Options<ListQueueStatsProjectsData, ThrowOnError>): RequestResult<ListQueueStatsProjectsResponses, ListQueueStatsProjectsErrors, ThrowOnError>;
@@ -34847,7 +35230,7 @@ export declare class Triggers {
   /**
    * Update a trigger
    *
-   * Updates an existing trigger's configuration. The type is immutable. Changing `target_type` or `target_id` re-checks the target-start action (`orchestrations:StartRun`, `agents:CreateAgentGeneration` or `tools:CallTool`) against the resulting target, because a firing runs with the trigger creator's authority rather than the updater's. A caller who could not start the new target is answered `403` and the trigger keeps the target it had.
+   * Updates an existing trigger's configuration. The type is immutable. Changing `target_type` or `target_id` re-checks that the caller may start the resulting target, because a firing runs with the trigger creator's authority rather than the updater's. A caller who could not start the new target is answered `403` and the trigger keeps the target it had.
    *
    */
   static updateTrigger<ThrowOnError extends boolean = false>(options: Options<UpdateTriggerData, ThrowOnError>): RequestResult<UpdateTriggerResponses, UpdateTriggerErrors, ThrowOnError>;