@soat/sdk 0.108.0 → 0.110.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -1086,7 +1086,7 @@ var ApiKeys = class {
1086
1086
  /**
1087
1087
  * List API keys
1088
1088
  *
1089
- * Lists API keys accessible to the caller. - JWT admin: returns all API keys. - JWT regular user: returns only the user's own API keys. - Project-scoped credential (API key or OAuth token): returns the caller's own
1089
+ * Lists API keys accessible to the caller. - An unrestricted admin (a login, or a key bound to no project and narrowed by no policy): returns all API keys. - Any other unscoped credential: returns only its user's own API keys. - Project-scoped credential (API key or OAuth token): returns the caller's own
1090
1090
  * keys scoped to that project, or every key scoped to it when the credential
1091
1091
  * holds `api-keys:ListApiKeys` on the project. Confinement to a project is not
1092
1092
  * authority over it, and a key's metadata names its owner, prefix and attached
@@ -1106,7 +1106,7 @@ var ApiKeys = class {
1106
1106
  /**
1107
1107
  * Create an API key
1108
1108
  *
1109
- * Creates a new API key for the authenticated user. - `project_id` is optional. When set, the key is scoped to that single project. When omitted or null, the key is **unscoped** and spans every project its owner can reach. - If `policy_ids` is provided, the key's effective permissions are the intersection of the user's policies and the key's policies. - Otherwise the key inherits the user's permissions (confined to the key's project when scoped). - When the request is authenticated with a **project-scoped token** (an OAuth access token, a trigger run-as token, a run token or an IAM token), it returns `403 API_KEY_SCOPED_TOKEN`: such a token never creates a key. - When the request is authenticated with a **project-scoped API key**, the new key is confined to that same project: omitting `project_id` defaults to it, naming a different project returns `403 API_KEY_PROJECT_SCOPE`, and `project_id: null` (an unscoped key) is likewise refused. Minting an unscoped key requires an unscoped credential. - When the request is authenticated with an **API key narrowed by `policy_ids`**, the new key stays inside that boundary: omitting `policy_ids` inherits the caller's own, a non-empty subset of them is accepted, and an empty list or any other policy returns `403 API_KEY_POLICY_BOUNDARY`.
1109
+ * Creates a new API key for the authenticated user. - `project_id` is optional. When set, the key is scoped to that single project. When omitted or null, the key is **unscoped** and spans every project its owner can reach. - If `policy_ids` is provided, the key's effective permissions are the intersection of the user's policies and the key's policies. - Otherwise the key inherits the user's permissions (confined to the key's project when scoped). - When the request is narrowed beyond its credential's own grant (an OAuth access token, an IAM token, an `On-Behalf-Of` assertion, or a call durable work makes under its stored authority), it returns `403 CREDENTIAL_NARROWED`: a key would outlive that narrowing. - When the request is authenticated with a **project-scoped API key**, the new key is confined to that same project: omitting `project_id` defaults to it, naming a different project returns `403 API_KEY_PROJECT_SCOPE`, and `project_id: null` (an unscoped key) is likewise refused. Minting an unscoped key requires an unscoped credential. - When the request is authenticated with an **API key narrowed by `policy_ids`**, the new key stays inside that boundary: omitting `policy_ids` inherits the caller's own, a non-empty subset of them is accepted, and an empty list or any other policy returns `403 API_KEY_POLICY_BOUNDARY`.
1110
1110
  *
1111
1111
  */
1112
1112
  static createApiKey(options) {
@@ -1122,7 +1122,7 @@ var ApiKeys = class {
1122
1122
  /**
1123
1123
  * Delete an API key
1124
1124
  *
1125
- * Deletes an API key. Only the owner or an admin can delete it, and a project-scoped credential can only delete keys in its own project.
1125
+ * Deletes an API key. Only the owner or an unrestricted admin can delete it, and a project-scoped credential can only delete keys in its own project.
1126
1126
  */
1127
1127
  static deleteApiKey(options) {
1128
1128
  return (options.client ?? client).delete({
@@ -1133,7 +1133,7 @@ var ApiKeys = class {
1133
1133
  /**
1134
1134
  * Get an API key
1135
1135
  *
1136
- * Returns details of an API key. Only the owner or an admin can access it, and a project-scoped credential can only reach keys in its own project.
1136
+ * Returns details of an API key. Only the owner or an unrestricted admin can access it, and a project-scoped credential can only reach keys in its own project.
1137
1137
  */
1138
1138
  static getApiKey(options) {
1139
1139
  return (options.client ?? client).get({
@@ -1144,7 +1144,7 @@ var ApiKeys = class {
1144
1144
  /**
1145
1145
  * Update an API key
1146
1146
  *
1147
- * Updates an API key's name, project scope, or policies. The project scope can be changed to another project, set (scoping a previously unscoped key), or cleared with null (unscoping the key). Only the owner or an admin can update it. A project-scoped credential can only update keys in its own project, and cannot move a key to another project or unscope it. An API key narrowed by `policy_ids` can only set `policy_ids` to a non-empty subset of its own (`403 API_KEY_POLICY_BOUNDARY` otherwise). A project-scoped token (OAuth, trigger, run or IAM) never updates a key (`403 API_KEY_SCOPED_TOKEN`).
1147
+ * Updates an API key's name, project scope, or policies. The project scope can be changed to another project, set (scoping a previously unscoped key), or cleared with null (unscoping the key). Only the owner or an unrestricted admin (a login, or a key bound to no project and narrowed by no policy) can update it. A project-scoped credential can only update keys in its own project, and cannot move a key to another project or unscope it. An API key narrowed by `policy_ids` can only set `policy_ids` to a non-empty subset of its own (`403 API_KEY_POLICY_BOUNDARY` otherwise). A request narrowed beyond its credential's own grant (OAuth, trigger, run or IAM token, or `On-Behalf-Of`) never updates a key (`403 CREDENTIAL_NARROWED`).
1148
1148
  */
1149
1149
  static updateApiKey(options) {
1150
1150
  return (options.client ?? client).put({
@@ -3040,7 +3040,7 @@ var Iam = class {
3040
3040
  /**
3041
3041
  * Check a permission of the calling credential
3042
3042
  *
3043
- * Evaluates the calling credential's own policies (its owner's and, for an API key or OAuth token, its boundary and project scope) for an action the deployment registered (`IAM_REGISTRATIONS_CONFIG`), or an action the writer rule asks of whoever writes a resource that acts later (a target's start action, `secrets:UseSecret`), on an SRN, with the engine the runtime's own routes use. A denial is `200` with `allowed: false`, never `403`. Only policies are evaluated: the answer says nothing about whether the resource exists.
3043
+ * Evaluates the calling credential's own policies (its owner's and, for an API key or OAuth token, its boundary and project scope) for an action the deployment registered (`IAM_REGISTRATIONS_CONFIG`) or any built-in action, such as one a resource the deployment stores will perform later, on an SRN, with the engine the runtime's own routes use. A denial is `200` with `allowed: false`, never `403`. Only policies are evaluated: the answer says nothing about whether the resource exists.
3044
3044
  */
3045
3045
  static checkIamPermission(options) {
3046
3046
  return (options.client ?? client).post({
@@ -4229,7 +4229,7 @@ var Playbooks = class {
4229
4229
  /**
4230
4230
  * Run a node of a case
4231
4231
  *
4232
- * Runs one node now. The cascade already runs every node whose inputs are set once a write, a settle or a resume makes it runnable, and never reruns a `failed` or `done` one: this is how a failed node is retried, and how a `done` node is recomputed after an upgrade changed its executor. A `collect` node takes its own input values as its output, any other node starts its executor with the node's input values mapped through the executor's `input`. The executor runs as the author of the case's playbook version, whose permission to start it is checked again here (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`); an author that no longer exists is `409 PLAYBOOK_AUTHOR_UNAVAILABLE`. Only a `ready`, `stale`, `failed` or `done` node with every required input set runs; anything else is `409 PLAYBOOK_NODE_NOT_RUNNABLE`. A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`.
4232
+ * Runs one node now. The cascade already runs every node whose inputs are set once a write, a settle or a resume makes it runnable, and never reruns a `failed` or `done` one: this is how a failed node is retried, and how a `done` node is recomputed after an upgrade changed its executor. A `collect` node takes its own input values as its output, any other node starts its executor with the node's input values mapped through the executor's `input`. The executor runs as the author of the case's playbook version, whose permission to start it is checked again here (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`); an author that no longer exists is `409 WORK_AUTHORITY_MISSING`. Only a `ready`, `stale`, `failed` or `done` node with every required input set runs; anything else is `409 PLAYBOOK_NODE_NOT_RUNNABLE`. A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`.
4233
4233
  *
4234
4234
  * An `upstream` node has no executor: running it pulls the current output of the node it names in the bound case, which must be `done`. This is the only way to refresh one that an upstream change left `stale`.
4235
4235
  *
@@ -4411,7 +4411,7 @@ var Policies = class {
4411
4411
  /**
4412
4412
  * Delete a policy
4413
4413
  *
4414
- * Deletes a policy. A project policy needs `policies:DeletePolicy` in its project; a global one, the unrestricted admin. Refused with `409 POLICY_HAS_DEPENDENTS` while a trigger, agent or webhook names it in its `policy_ids`.
4414
+ * Deletes a policy. A project policy needs `policies:DeletePolicy` in its project; a global one, the unrestricted admin. Refused with `409 POLICY_HAS_DEPENDENTS` while a trigger, agent, webhook, user or API key names it in its `policy_ids`.
4415
4415
  */
4416
4416
  static deletePolicy(options) {
4417
4417
  return (options.client ?? client).delete({
package/dist/index.d.cts CHANGED
@@ -462,9 +462,13 @@ type Agent = {
462
462
  [key: string]: unknown;
463
463
  }> | null;
464
464
  /**
465
- * Policies capping every generation: it runs as the caller's permissions intersected with these. Null is no cap.
465
+ * Under `run_as: caller`, the policies capping the caller's permissions on every generation; null is no cap. Under `run_as: agent`, the agent's own grant.
466
466
  */
467
467
  policy_ids?: Array<string> | null;
468
+ /**
469
+ * What `policy_ids` are. `caller`: a turn runs as the caller's permissions intersected with `policy_ids`. `agent`: a turn runs as `policy_ids` alone, and the caller needs only `agents:CreateAgentGeneration` on the agent. See [Execution Identity](/docs/modules/agents#execution-identity).
470
+ */
471
+ run_as?: 'caller' | 'agent';
468
472
  /**
469
473
  * Sampling temperature
470
474
  */
@@ -732,9 +736,13 @@ type CreateAgentRequest = {
732
736
  */
733
737
  step_rules?: Array<AgentStepRule>;
734
738
  /**
735
- * Policies capping every generation: it runs as the caller's permissions intersected with these. The caller must hold every grant they carry inside the agent's project, else `403 POLICY_GRANT_NOT_HELD`. See [Execution Identity](/docs/modules/agents#execution-identity).
739
+ * Under `run_as: caller`, the policies capping the caller's permissions on every generation; under `run_as: agent`, the agent's own grant. The caller must hold every grant they carry inside the agent's project, else `403 POLICY_GRANT_NOT_HELD`. See [Execution Identity](/docs/modules/agents#execution-identity).
736
740
  */
737
741
  policy_ids?: Array<string>;
742
+ /**
743
+ * What `policy_ids` are: `caller` (default) caps the caller, `agent` makes them the agent's own grant. `agent` requires a non-empty `policy_ids`, else `400 AGENT_RUN_AS_REQUIRES_POLICIES`.
744
+ */
745
+ run_as?: 'caller' | 'agent';
738
746
  /**
739
747
  * Sampling temperature passed to the model. Omitted, the provider's default applies.
740
748
  */
@@ -880,9 +888,13 @@ type UpdateAgentRequest = {
880
888
  */
881
889
  step_rules?: Array<AgentStepRule> | null;
882
890
  /**
883
- * Replaces the policies capping every generation; `null` removes the cap. The caller must hold every grant of each policy it adds inside the agent's project, else `403 POLICY_GRANT_NOT_HELD`. See [Execution Identity](/docs/modules/agents#execution-identity).
891
+ * Replaces `policy_ids`; `null` removes them. The caller must hold every grant of each policy it adds inside the agent's project, else `403 POLICY_GRANT_NOT_HELD`. See [Execution Identity](/docs/modules/agents#execution-identity).
884
892
  */
885
893
  policy_ids?: Array<string> | null;
894
+ /**
895
+ * Replaces what `policy_ids` are: `caller` caps the caller, `agent` makes them the agent's own grant. An agent left `run_as: agent` with no `policy_ids` is `400 AGENT_RUN_AS_REQUIRES_POLICIES`.
896
+ */
897
+ run_as?: 'caller' | 'agent';
886
898
  /**
887
899
  * Sampling temperature passed to the model; `null` restores the provider's default.
888
900
  */
@@ -3064,9 +3076,13 @@ type AgentResourceProperties = {
3064
3076
  active_tool_ids?: Array<string> | null;
3065
3077
  }> | null;
3066
3078
  /**
3067
- * Policies capping every generation. The deployer must hold every grant they carry inside the agent's project, else `403 POLICY_GRANT_NOT_HELD`.
3079
+ * Under `run_as: caller`, the policies capping the caller's permissions on every generation; under `run_as: agent`, the agent's own grant. The deployer must hold every grant they carry inside the agent's project, else `403 POLICY_GRANT_NOT_HELD`.
3068
3080
  */
3069
3081
  policy_ids?: Array<string> | null;
3082
+ /**
3083
+ * What `policy_ids` are: `caller` (default) caps the caller, `agent` makes them the agent's own grant and requires a non-empty `policy_ids`.
3084
+ */
3085
+ run_as?: 'caller' | 'agent';
3070
3086
  /**
3071
3087
  * Sampling temperature
3072
3088
  */
@@ -5033,11 +5049,11 @@ type UpdateGuardrailRequest = {
5033
5049
  };
5034
5050
  type IamCheckRequest = {
5035
5051
  /**
5036
- * A `module:Operation` action the deployment registered, or one the writer rule asks (`agents:CreateAgentGeneration`, `tools:CallTool`, `deciders:CreateDecision`, `tasks:CreateTask`, `orchestrations:StartRun`, `evaluations:RunEval`, `secrets:UseSecret`); any other built-in action or a wildcard is `400`.
5052
+ * A `module:Operation` action the deployment registered or a built-in one (`agents:DeleteAgent`); an unknown action or a wildcard is `400`.
5037
5053
  */
5038
5054
  action: string;
5039
5055
  /**
5040
- * `srn:<project_id>:<resource_type>:<id>`, where the type is one the action's module registered and `<id>` may be `*` for an action on no single resource (a create or a list).
5056
+ * `srn:<project_id>:<resource_type>:<id>`, where the type is one the action's module registered, or for a built-in action one its module's routes check it on, and `<id>` may be `*` for an action on no single resource (a create or a list).
5041
5057
  */
5042
5058
  resource: string;
5043
5059
  /**
@@ -5269,6 +5285,10 @@ type MemoryKnowledgeResult = {
5269
5285
  type Memory = {
5270
5286
  id?: string;
5271
5287
  memory_store_id?: string;
5288
+ /**
5289
+ * The end user the memory belongs to; null for none. Set on create and never changed; a replacement written by a supersede belongs to the same actor.
5290
+ */
5291
+ actor_id?: string | null;
5272
5292
  /**
5273
5293
  * The text this memory currently holds. Stored once per distinct text per store and shared with every assertion that stated it, so a memory carries no copy of its own.
5274
5294
  */
@@ -5897,6 +5917,12 @@ type OrchestrationNode = {
5897
5917
  * For loop and sub_orchestration nodes — allowlist of the run's `tool_context` keys the child run inherits. When `null` (the default), the child inherits the parent's whole bag. When set, only the listed keys are handed down, so a run holding a broad credential can delegate one step to a shared sub-graph without passing on what that sub-graph does not need; `[]` hands down nothing. Matching is case-insensitive, since an entry names a key that becomes an HTTP header name; an entry outside that grammar is rejected at write time with `INVALID_TOOL_CONTEXT_KEY`. The server-derived identity keys (`session_id`, `actor_id`, `actor_external_id`) are unaffected — they are re-derived per generation in the child regardless of this list. Ignored for other node types.
5898
5918
  */
5899
5919
  context_keys?: Array<string> | null;
5920
+ /**
5921
+ * For loop nodes — per-item `tool_context` keys for each child run. Each key is a `tool_context` key; each value is JSON Logic evaluated against `{ <item_variable>: <item>, "state": <run state> }`. A child's bag is the inherited one (after `context_keys`) with these keys laid over it, matched case-insensitively. A value evaluating to `null` drops the key, the inherited value included. A value that evaluates to anything else but a string, or throws, fails that item: under `on_item_error: fail` the node fails before any child starts; under `collect` the item's entry in `results` is `{ "error": { "code", "message" } }` and no child runs for it. A key outside the header-name grammar, two keys differing only in case, or a server-reserved key (`session_id`, `actor_id`, `actor_external_id`, `calling_project_id`) is rejected at write time with `INVALID_TOOL_CONTEXT_KEY`. Ignored for other node types.
5922
+ */
5923
+ item_tool_context?: {
5924
+ [key: string]: unknown;
5925
+ };
5900
5926
  /**
5901
5927
  * For poll nodes — wait between attempts. Accepts a friendly suffix form (`5s`, `30s`, `5m`, `2h`, `500ms`) or ISO 8601 (e.g. PT5S).
5902
5928
  *
@@ -6295,7 +6321,7 @@ type NodeExecution = {
6295
6321
  */
6296
6322
  type RequiredAction = {
6297
6323
  /**
6298
- * Discriminator identifying the kind of pause. Open enum — new pause kinds may be added in minor releases; clients must tolerate unknown values. `child_run` is a `loop` or `sub_orchestration` node whose child runs, listed in `context.orchestration_run_ids`, have not settled; their settle resumes it, and it accepts no human input.
6324
+ * Discriminator identifying the kind of pause. Open enum — new pause kinds may be added in minor releases; clients must tolerate unknown values. `child_run` is a `loop` or `sub_orchestration` node whose child runs, listed in `context.orchestration_run_ids`, have not settled; their settle resumes it, and it accepts no human input. A `loop` collecting item errors also lists, in `context.item_errors` (`[{ index, code, message }]`), the items whose `item_tool_context` failed and started no child.
6299
6325
  */
6300
6326
  type: 'human_input' | 'webhook_receive' | 'approval' | 'paused' | 'child_run';
6301
6327
  /**
@@ -7661,7 +7687,7 @@ type Task = {
7661
7687
  */
7662
7688
  pause_reason?: string | null;
7663
7689
  /**
7664
- * Server-owned. How many machine-driven transitions have run back-to-back with no outside intervention — a dispatch outcome routed through `on_complete`/`on_failure`, or a `transition-task` call made by a dispatched run or agent with its run-as token. Any move by a person, a plain API key, or an approval resolution resets it to `0`. Once it would exceed the server's limit (`TASK_AUTOMATION_CHAIN_LIMIT`, default 50) the next such transition is refused with `TASK_AUTOMATION_CHAIN_LIMIT`, bounding a cycle composed across workflows and orchestrations.
7690
+ * Server-owned. How many machine-driven transitions have run back-to-back with no outside intervention — a dispatch outcome routed through `on_complete`/`on_failure`, or a `transition-task` call made by a dispatched run or agent under its stored authority. Any move by a person, a plain API key, or an approval resolution resets it to `0`. Once it would exceed the server's limit (`TASK_AUTOMATION_CHAIN_LIMIT`, default 50) the next such transition is refused with `TASK_AUTOMATION_CHAIN_LIMIT`, bounding a cycle composed across workflows and orchestrations.
7665
7691
  */
7666
7692
  automation_chain_depth?: number;
7667
7693
  /**
@@ -9423,6 +9449,10 @@ type FileRecordWritable = {
9423
9449
  */
9424
9450
  updated_at?: Date;
9425
9451
  };
9452
+ /**
9453
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
9454
+ */
9455
+ type ActorPin = string;
9426
9456
  /**
9427
9457
  * Agent public ID
9428
9458
  */
@@ -9503,10 +9533,6 @@ type PlaybookId = string;
9503
9533
  * The case ID
9504
9534
  */
9505
9535
  type CaseId = string;
9506
- /**
9507
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
9508
- */
9509
- type ActorPin = string;
9510
9536
  /**
9511
9537
  * The ID of a node of the case's playbook version
9512
9538
  */
@@ -19437,6 +19463,10 @@ type SearchKnowledgeData = {
19437
19463
  * Search memories within these specific memory stores
19438
19464
  */
19439
19465
  memory_store_ids?: Array<string>;
19466
+ /**
19467
+ * Searches only the memories that belong to this actor; documents are not narrowed. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent searches the memories of the end user it serves only.
19468
+ */
19469
+ actor_id?: string;
19440
19470
  /**
19441
19471
  * Filter results to documents whose file path starts with one of these prefixes
19442
19472
  */
@@ -19506,6 +19536,10 @@ type ListMemoriesData = {
19506
19536
  * Memory store to list memories from (mstore_...)
19507
19537
  */
19508
19538
  memory_store_id: string;
19539
+ /**
19540
+ * Only the memories that belong to this actor. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent lists the memories of the end user it serves only.
19541
+ */
19542
+ actor_id?: string;
19509
19543
  /**
19510
19544
  * Filter by tag pairs, written `key:value` (split on the first colon, so a value may contain colons). Repeat the parameter for several pairs; **all** must be present with exactly that value.
19511
19545
  *
@@ -19572,6 +19606,10 @@ type CreateMemoryData = {
19572
19606
  * The text content of the memory
19573
19607
  */
19574
19608
  content: string;
19609
+ /**
19610
+ * The end user the memory belongs to, an actor of the memory store's project; an unknown one is `400 ACTOR_NOT_FOUND`. The write compares, supersedes and creates among that actor's memories only. Omitted, the memory belongs to no actor and is compared with the other memories of no actor.
19611
+ */
19612
+ actor_id?: string;
19575
19613
  /**
19576
19614
  * Whether there is a source to point at. `conversation` requires `source_id`; `manual` rejects it.
19577
19615
  */
@@ -19661,6 +19699,10 @@ type DeleteMemoryData = {
19661
19699
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
19662
19700
  */
19663
19701
  memory_store_id?: string;
19702
+ /**
19703
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
19704
+ */
19705
+ actor_id?: string;
19664
19706
  };
19665
19707
  url: '/api/v1/memories/{memory_id}';
19666
19708
  };
@@ -19708,6 +19750,10 @@ type GetMemoryData = {
19708
19750
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
19709
19751
  */
19710
19752
  memory_store_id?: string;
19753
+ /**
19754
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
19755
+ */
19756
+ actor_id?: string;
19711
19757
  };
19712
19758
  url: '/api/v1/memories/{memory_id}';
19713
19759
  };
@@ -19778,6 +19824,10 @@ type UpdateMemoryData = {
19778
19824
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
19779
19825
  */
19780
19826
  memory_store_id?: string;
19827
+ /**
19828
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
19829
+ */
19830
+ actor_id?: string;
19781
19831
  };
19782
19832
  url: '/api/v1/memories/{memory_id}';
19783
19833
  };
@@ -19844,6 +19894,10 @@ type RetractMemoryData = {
19844
19894
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
19845
19895
  */
19846
19896
  memory_store_id?: string;
19897
+ /**
19898
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
19899
+ */
19900
+ actor_id?: string;
19847
19901
  };
19848
19902
  url: '/api/v1/memories/{memory_id}/retract';
19849
19903
  };
@@ -19899,6 +19953,10 @@ type ListMemoryAssertionsData = {
19899
19953
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
19900
19954
  */
19901
19955
  memory_store_id?: string;
19956
+ /**
19957
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
19958
+ */
19959
+ actor_id?: string;
19902
19960
  /**
19903
19961
  * Results per page. Above the maximum it is clamped; below 1 or not an integer it is `400 VALIDATION_FAILED`.
19904
19962
  */
@@ -19959,6 +20017,10 @@ type GetMemoryTagsData = {
19959
20017
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
19960
20018
  */
19961
20019
  memory_store_id?: string;
20020
+ /**
20021
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
20022
+ */
20023
+ actor_id?: string;
19962
20024
  };
19963
20025
  url: '/api/v1/memories/{memory_id}/tags';
19964
20026
  };
@@ -20009,6 +20071,10 @@ type MergeMemoryTagsData = {
20009
20071
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
20010
20072
  */
20011
20073
  memory_store_id?: string;
20074
+ /**
20075
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
20076
+ */
20077
+ actor_id?: string;
20012
20078
  };
20013
20079
  url: '/api/v1/memories/{memory_id}/tags';
20014
20080
  };
@@ -20063,6 +20129,10 @@ type ReplaceMemoryTagsData = {
20063
20129
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
20064
20130
  */
20065
20131
  memory_store_id?: string;
20132
+ /**
20133
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
20134
+ */
20135
+ actor_id?: string;
20066
20136
  };
20067
20137
  url: '/api/v1/memories/{memory_id}/tags';
20068
20138
  };
@@ -20684,6 +20754,10 @@ type ListMemoryStoreAssertionsData = {
20684
20754
  memory_store_id: string;
20685
20755
  };
20686
20756
  query?: {
20757
+ /**
20758
+ * Only the writes that resolved into this actor's memories. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` to confine it to the end user an agent serves.
20759
+ */
20760
+ actor_id?: string;
20687
20761
  /**
20688
20762
  * Only assertions that came through this door.
20689
20763
  */
@@ -20760,6 +20834,10 @@ type ExportMemoriesData = {
20760
20834
  memory_store_id: string;
20761
20835
  };
20762
20836
  query?: {
20837
+ /**
20838
+ * Only the memories that belong to this actor.
20839
+ */
20840
+ actor_id?: string;
20763
20841
  /**
20764
20842
  * Include memories that were retracted or superseded
20765
20843
  */
@@ -23605,7 +23683,7 @@ type DeletePlaybookCaseData = {
23605
23683
  };
23606
23684
  query?: {
23607
23685
  /**
23608
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
23686
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23609
23687
  */
23610
23688
  actor_id?: string;
23611
23689
  };
@@ -23659,7 +23737,7 @@ type GetPlaybookCaseData = {
23659
23737
  };
23660
23738
  query?: {
23661
23739
  /**
23662
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
23740
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23663
23741
  */
23664
23742
  actor_id?: string;
23665
23743
  };
@@ -23709,7 +23787,7 @@ type WritePlaybookCaseInputsData = {
23709
23787
  };
23710
23788
  query?: {
23711
23789
  /**
23712
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
23790
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23713
23791
  */
23714
23792
  actor_id?: string;
23715
23793
  };
@@ -23767,7 +23845,7 @@ type GetPlaybookCaseMissingData = {
23767
23845
  };
23768
23846
  query: {
23769
23847
  /**
23770
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
23848
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23771
23849
  */
23772
23850
  actor_id?: string;
23773
23851
  /**
@@ -23817,7 +23895,7 @@ type ListPlaybookCaseEntriesData = {
23817
23895
  };
23818
23896
  query?: {
23819
23897
  /**
23820
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
23898
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23821
23899
  */
23822
23900
  actor_id?: string;
23823
23901
  /**
@@ -23881,7 +23959,7 @@ type RunPlaybookCaseNodeData = {
23881
23959
  };
23882
23960
  query?: {
23883
23961
  /**
23884
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
23962
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23885
23963
  */
23886
23964
  actor_id?: string;
23887
23965
  };
@@ -23939,7 +24017,7 @@ type ListPlaybookCaseExecutionsData = {
23939
24017
  };
23940
24018
  query?: {
23941
24019
  /**
23942
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24020
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23943
24021
  */
23944
24022
  actor_id?: string;
23945
24023
  /**
@@ -24003,7 +24081,7 @@ type GetPlaybookCaseExecutionData = {
24003
24081
  };
24004
24082
  query?: {
24005
24083
  /**
24006
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24084
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24007
24085
  */
24008
24086
  actor_id?: string;
24009
24087
  };
@@ -24053,7 +24131,7 @@ type ExportPlaybookCaseNodeData = {
24053
24131
  };
24054
24132
  query?: {
24055
24133
  /**
24056
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24134
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24057
24135
  */
24058
24136
  actor_id?: string;
24059
24137
  };
@@ -24113,7 +24191,7 @@ type ListPlaybookCaseExportsData = {
24113
24191
  };
24114
24192
  query?: {
24115
24193
  /**
24116
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24194
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24117
24195
  */
24118
24196
  actor_id?: string;
24119
24197
  /**
@@ -24181,7 +24259,7 @@ type GetPlaybookCaseExportData = {
24181
24259
  };
24182
24260
  query?: {
24183
24261
  /**
24184
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24262
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24185
24263
  */
24186
24264
  actor_id?: string;
24187
24265
  };
@@ -24227,7 +24305,7 @@ type UpgradePlaybookCaseData = {
24227
24305
  };
24228
24306
  query?: {
24229
24307
  /**
24230
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24308
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24231
24309
  */
24232
24310
  actor_id?: string;
24233
24311
  };
@@ -24285,7 +24363,7 @@ type ListPlaybookCaseUpgradesData = {
24285
24363
  };
24286
24364
  query?: {
24287
24365
  /**
24288
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24366
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24289
24367
  */
24290
24368
  actor_id?: string;
24291
24369
  /**
@@ -24341,7 +24419,7 @@ type PausePlaybookCaseData = {
24341
24419
  };
24342
24420
  query?: {
24343
24421
  /**
24344
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24422
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24345
24423
  */
24346
24424
  actor_id?: string;
24347
24425
  };
@@ -24391,7 +24469,7 @@ type ResumePlaybookCaseData = {
24391
24469
  };
24392
24470
  query?: {
24393
24471
  /**
24394
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24472
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24395
24473
  */
24396
24474
  actor_id?: string;
24397
24475
  };
@@ -24449,7 +24527,7 @@ type ConfirmPlaybookCaseNodeData = {
24449
24527
  };
24450
24528
  query?: {
24451
24529
  /**
24452
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24530
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24453
24531
  */
24454
24532
  actor_id?: string;
24455
24533
  };
@@ -24629,7 +24707,7 @@ type DeletePolicyErrors = {
24629
24707
  */
24630
24708
  404: ErrorResponse;
24631
24709
  /**
24632
- * `POLICY_HAS_DEPENDENTS`: a trigger, agent or webhook still names the policy in its `policy_ids`. Detach it or delete them first.
24710
+ * `POLICY_HAS_DEPENDENTS`: a trigger, agent, webhook, user or API key still names the policy in its `policy_ids`. Detach it or delete them first.
24633
24711
  */
24634
24712
  409: ErrorResponse;
24635
24713
  /**
@@ -30853,7 +30931,7 @@ export declare class ApiKeys {
30853
30931
  /**
30854
30932
  * List API keys
30855
30933
  *
30856
- * Lists API keys accessible to the caller. - JWT admin: returns all API keys. - JWT regular user: returns only the user's own API keys. - Project-scoped credential (API key or OAuth token): returns the caller's own
30934
+ * Lists API keys accessible to the caller. - An unrestricted admin (a login, or a key bound to no project and narrowed by no policy): returns all API keys. - Any other unscoped credential: returns only its user's own API keys. - Project-scoped credential (API key or OAuth token): returns the caller's own
30857
30935
  * keys scoped to that project, or every key scoped to it when the credential
30858
30936
  * holds `api-keys:ListApiKeys` on the project. Confinement to a project is not
30859
30937
  * authority over it, and a key's metadata names its owner, prefix and attached
@@ -30864,26 +30942,26 @@ export declare class ApiKeys {
30864
30942
  /**
30865
30943
  * Create an API key
30866
30944
  *
30867
- * Creates a new API key for the authenticated user. - `project_id` is optional. When set, the key is scoped to that single project. When omitted or null, the key is **unscoped** and spans every project its owner can reach. - If `policy_ids` is provided, the key's effective permissions are the intersection of the user's policies and the key's policies. - Otherwise the key inherits the user's permissions (confined to the key's project when scoped). - When the request is authenticated with a **project-scoped token** (an OAuth access token, a trigger run-as token, a run token or an IAM token), it returns `403 API_KEY_SCOPED_TOKEN`: such a token never creates a key. - When the request is authenticated with a **project-scoped API key**, the new key is confined to that same project: omitting `project_id` defaults to it, naming a different project returns `403 API_KEY_PROJECT_SCOPE`, and `project_id: null` (an unscoped key) is likewise refused. Minting an unscoped key requires an unscoped credential. - When the request is authenticated with an **API key narrowed by `policy_ids`**, the new key stays inside that boundary: omitting `policy_ids` inherits the caller's own, a non-empty subset of them is accepted, and an empty list or any other policy returns `403 API_KEY_POLICY_BOUNDARY`.
30945
+ * Creates a new API key for the authenticated user. - `project_id` is optional. When set, the key is scoped to that single project. When omitted or null, the key is **unscoped** and spans every project its owner can reach. - If `policy_ids` is provided, the key's effective permissions are the intersection of the user's policies and the key's policies. - Otherwise the key inherits the user's permissions (confined to the key's project when scoped). - When the request is narrowed beyond its credential's own grant (an OAuth access token, an IAM token, an `On-Behalf-Of` assertion, or a call durable work makes under its stored authority), it returns `403 CREDENTIAL_NARROWED`: a key would outlive that narrowing. - When the request is authenticated with a **project-scoped API key**, the new key is confined to that same project: omitting `project_id` defaults to it, naming a different project returns `403 API_KEY_PROJECT_SCOPE`, and `project_id: null` (an unscoped key) is likewise refused. Minting an unscoped key requires an unscoped credential. - When the request is authenticated with an **API key narrowed by `policy_ids`**, the new key stays inside that boundary: omitting `policy_ids` inherits the caller's own, a non-empty subset of them is accepted, and an empty list or any other policy returns `403 API_KEY_POLICY_BOUNDARY`.
30868
30946
  *
30869
30947
  */
30870
30948
  static createApiKey<ThrowOnError extends boolean = false>(options: Options<CreateApiKeyData, ThrowOnError>): RequestResult<CreateApiKeyResponses, CreateApiKeyErrors, ThrowOnError>;
30871
30949
  /**
30872
30950
  * Delete an API key
30873
30951
  *
30874
- * Deletes an API key. Only the owner or an admin can delete it, and a project-scoped credential can only delete keys in its own project.
30952
+ * Deletes an API key. Only the owner or an unrestricted admin can delete it, and a project-scoped credential can only delete keys in its own project.
30875
30953
  */
30876
30954
  static deleteApiKey<ThrowOnError extends boolean = false>(options: Options<DeleteApiKeyData, ThrowOnError>): RequestResult<DeleteApiKeyResponses, DeleteApiKeyErrors, ThrowOnError>;
30877
30955
  /**
30878
30956
  * Get an API key
30879
30957
  *
30880
- * Returns details of an API key. Only the owner or an admin can access it, and a project-scoped credential can only reach keys in its own project.
30958
+ * Returns details of an API key. Only the owner or an unrestricted admin can access it, and a project-scoped credential can only reach keys in its own project.
30881
30959
  */
30882
30960
  static getApiKey<ThrowOnError extends boolean = false>(options: Options<GetApiKeyData, ThrowOnError>): RequestResult<GetApiKeyResponses, GetApiKeyErrors, ThrowOnError>;
30883
30961
  /**
30884
30962
  * Update an API key
30885
30963
  *
30886
- * Updates an API key's name, project scope, or policies. The project scope can be changed to another project, set (scoping a previously unscoped key), or cleared with null (unscoping the key). Only the owner or an admin can update it. A project-scoped credential can only update keys in its own project, and cannot move a key to another project or unscope it. An API key narrowed by `policy_ids` can only set `policy_ids` to a non-empty subset of its own (`403 API_KEY_POLICY_BOUNDARY` otherwise). A project-scoped token (OAuth, trigger, run or IAM) never updates a key (`403 API_KEY_SCOPED_TOKEN`).
30964
+ * Updates an API key's name, project scope, or policies. The project scope can be changed to another project, set (scoping a previously unscoped key), or cleared with null (unscoping the key). Only the owner or an unrestricted admin (a login, or a key bound to no project and narrowed by no policy) can update it. A project-scoped credential can only update keys in its own project, and cannot move a key to another project or unscope it. An API key narrowed by `policy_ids` can only set `policy_ids` to a non-empty subset of its own (`403 API_KEY_POLICY_BOUNDARY` otherwise). A request narrowed beyond its credential's own grant (OAuth, trigger, run or IAM token, or `On-Behalf-Of`) never updates a key (`403 CREDENTIAL_NARROWED`).
30887
30965
  */
30888
30966
  static updateApiKey<ThrowOnError extends boolean = false>(options: Options<UpdateApiKeyData, ThrowOnError>): RequestResult<UpdateApiKeyResponses, UpdateApiKeyErrors, ThrowOnError>;
30889
30967
  }
@@ -31867,7 +31945,7 @@ export declare class Iam {
31867
31945
  /**
31868
31946
  * Check a permission of the calling credential
31869
31947
  *
31870
- * Evaluates the calling credential's own policies (its owner's and, for an API key or OAuth token, its boundary and project scope) for an action the deployment registered (`IAM_REGISTRATIONS_CONFIG`), or an action the writer rule asks of whoever writes a resource that acts later (a target's start action, `secrets:UseSecret`), on an SRN, with the engine the runtime's own routes use. A denial is `200` with `allowed: false`, never `403`. Only policies are evaluated: the answer says nothing about whether the resource exists.
31948
+ * Evaluates the calling credential's own policies (its owner's and, for an API key or OAuth token, its boundary and project scope) for an action the deployment registered (`IAM_REGISTRATIONS_CONFIG`) or any built-in action, such as one a resource the deployment stores will perform later, on an SRN, with the engine the runtime's own routes use. A denial is `200` with `allowed: false`, never `403`. Only policies are evaluated: the answer says nothing about whether the resource exists.
31871
31949
  */
31872
31950
  static checkIamPermission<ThrowOnError extends boolean = false>(options: Options<CheckIamPermissionData, ThrowOnError>): RequestResult<CheckIamPermissionResponses, CheckIamPermissionErrors, ThrowOnError>;
31873
31951
  /**
@@ -32455,7 +32533,7 @@ export declare class Playbooks {
32455
32533
  /**
32456
32534
  * Run a node of a case
32457
32535
  *
32458
- * Runs one node now. The cascade already runs every node whose inputs are set once a write, a settle or a resume makes it runnable, and never reruns a `failed` or `done` one: this is how a failed node is retried, and how a `done` node is recomputed after an upgrade changed its executor. A `collect` node takes its own input values as its output, any other node starts its executor with the node's input values mapped through the executor's `input`. The executor runs as the author of the case's playbook version, whose permission to start it is checked again here (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`); an author that no longer exists is `409 PLAYBOOK_AUTHOR_UNAVAILABLE`. Only a `ready`, `stale`, `failed` or `done` node with every required input set runs; anything else is `409 PLAYBOOK_NODE_NOT_RUNNABLE`. A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`.
32536
+ * Runs one node now. The cascade already runs every node whose inputs are set once a write, a settle or a resume makes it runnable, and never reruns a `failed` or `done` one: this is how a failed node is retried, and how a `done` node is recomputed after an upgrade changed its executor. A `collect` node takes its own input values as its output, any other node starts its executor with the node's input values mapped through the executor's `input`. The executor runs as the author of the case's playbook version, whose permission to start it is checked again here (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`); an author that no longer exists is `409 WORK_AUTHORITY_MISSING`. Only a `ready`, `stale`, `failed` or `done` node with every required input set runs; anything else is `409 PLAYBOOK_NODE_NOT_RUNNABLE`. A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`.
32459
32537
  *
32460
32538
  * An `upstream` node has no executor: running it pulls the current output of the node it names in the bound case, which must be `done`. This is the only way to refresh one that an upstream change left `stale`.
32461
32539
  *
@@ -32552,7 +32630,7 @@ export declare class Policies {
32552
32630
  /**
32553
32631
  * Delete a policy
32554
32632
  *
32555
- * Deletes a policy. A project policy needs `policies:DeletePolicy` in its project; a global one, the unrestricted admin. Refused with `409 POLICY_HAS_DEPENDENTS` while a trigger, agent or webhook names it in its `policy_ids`.
32633
+ * Deletes a policy. A project policy needs `policies:DeletePolicy` in its project; a global one, the unrestricted admin. Refused with `409 POLICY_HAS_DEPENDENTS` while a trigger, agent, webhook, user or API key names it in its `policy_ids`.
32556
32634
  */
32557
32635
  static deletePolicy<ThrowOnError extends boolean = false>(options: Options<DeletePolicyData, ThrowOnError>): RequestResult<DeletePolicyResponses, DeletePolicyErrors, ThrowOnError>;
32558
32636
  /**
package/dist/index.d.mts CHANGED
@@ -462,9 +462,13 @@ type Agent = {
462
462
  [key: string]: unknown;
463
463
  }> | null;
464
464
  /**
465
- * Policies capping every generation: it runs as the caller's permissions intersected with these. Null is no cap.
465
+ * Under `run_as: caller`, the policies capping the caller's permissions on every generation; null is no cap. Under `run_as: agent`, the agent's own grant.
466
466
  */
467
467
  policy_ids?: Array<string> | null;
468
+ /**
469
+ * What `policy_ids` are. `caller`: a turn runs as the caller's permissions intersected with `policy_ids`. `agent`: a turn runs as `policy_ids` alone, and the caller needs only `agents:CreateAgentGeneration` on the agent. See [Execution Identity](/docs/modules/agents#execution-identity).
470
+ */
471
+ run_as?: 'caller' | 'agent';
468
472
  /**
469
473
  * Sampling temperature
470
474
  */
@@ -732,9 +736,13 @@ type CreateAgentRequest = {
732
736
  */
733
737
  step_rules?: Array<AgentStepRule>;
734
738
  /**
735
- * Policies capping every generation: it runs as the caller's permissions intersected with these. The caller must hold every grant they carry inside the agent's project, else `403 POLICY_GRANT_NOT_HELD`. See [Execution Identity](/docs/modules/agents#execution-identity).
739
+ * Under `run_as: caller`, the policies capping the caller's permissions on every generation; under `run_as: agent`, the agent's own grant. The caller must hold every grant they carry inside the agent's project, else `403 POLICY_GRANT_NOT_HELD`. See [Execution Identity](/docs/modules/agents#execution-identity).
736
740
  */
737
741
  policy_ids?: Array<string>;
742
+ /**
743
+ * What `policy_ids` are: `caller` (default) caps the caller, `agent` makes them the agent's own grant. `agent` requires a non-empty `policy_ids`, else `400 AGENT_RUN_AS_REQUIRES_POLICIES`.
744
+ */
745
+ run_as?: 'caller' | 'agent';
738
746
  /**
739
747
  * Sampling temperature passed to the model. Omitted, the provider's default applies.
740
748
  */
@@ -880,9 +888,13 @@ type UpdateAgentRequest = {
880
888
  */
881
889
  step_rules?: Array<AgentStepRule> | null;
882
890
  /**
883
- * Replaces the policies capping every generation; `null` removes the cap. The caller must hold every grant of each policy it adds inside the agent's project, else `403 POLICY_GRANT_NOT_HELD`. See [Execution Identity](/docs/modules/agents#execution-identity).
891
+ * Replaces `policy_ids`; `null` removes them. The caller must hold every grant of each policy it adds inside the agent's project, else `403 POLICY_GRANT_NOT_HELD`. See [Execution Identity](/docs/modules/agents#execution-identity).
884
892
  */
885
893
  policy_ids?: Array<string> | null;
894
+ /**
895
+ * Replaces what `policy_ids` are: `caller` caps the caller, `agent` makes them the agent's own grant. An agent left `run_as: agent` with no `policy_ids` is `400 AGENT_RUN_AS_REQUIRES_POLICIES`.
896
+ */
897
+ run_as?: 'caller' | 'agent';
886
898
  /**
887
899
  * Sampling temperature passed to the model; `null` restores the provider's default.
888
900
  */
@@ -3064,9 +3076,13 @@ type AgentResourceProperties = {
3064
3076
  active_tool_ids?: Array<string> | null;
3065
3077
  }> | null;
3066
3078
  /**
3067
- * Policies capping every generation. The deployer must hold every grant they carry inside the agent's project, else `403 POLICY_GRANT_NOT_HELD`.
3079
+ * Under `run_as: caller`, the policies capping the caller's permissions on every generation; under `run_as: agent`, the agent's own grant. The deployer must hold every grant they carry inside the agent's project, else `403 POLICY_GRANT_NOT_HELD`.
3068
3080
  */
3069
3081
  policy_ids?: Array<string> | null;
3082
+ /**
3083
+ * What `policy_ids` are: `caller` (default) caps the caller, `agent` makes them the agent's own grant and requires a non-empty `policy_ids`.
3084
+ */
3085
+ run_as?: 'caller' | 'agent';
3070
3086
  /**
3071
3087
  * Sampling temperature
3072
3088
  */
@@ -5033,11 +5049,11 @@ type UpdateGuardrailRequest = {
5033
5049
  };
5034
5050
  type IamCheckRequest = {
5035
5051
  /**
5036
- * A `module:Operation` action the deployment registered, or one the writer rule asks (`agents:CreateAgentGeneration`, `tools:CallTool`, `deciders:CreateDecision`, `tasks:CreateTask`, `orchestrations:StartRun`, `evaluations:RunEval`, `secrets:UseSecret`); any other built-in action or a wildcard is `400`.
5052
+ * A `module:Operation` action the deployment registered or a built-in one (`agents:DeleteAgent`); an unknown action or a wildcard is `400`.
5037
5053
  */
5038
5054
  action: string;
5039
5055
  /**
5040
- * `srn:<project_id>:<resource_type>:<id>`, where the type is one the action's module registered and `<id>` may be `*` for an action on no single resource (a create or a list).
5056
+ * `srn:<project_id>:<resource_type>:<id>`, where the type is one the action's module registered, or for a built-in action one its module's routes check it on, and `<id>` may be `*` for an action on no single resource (a create or a list).
5041
5057
  */
5042
5058
  resource: string;
5043
5059
  /**
@@ -5269,6 +5285,10 @@ type MemoryKnowledgeResult = {
5269
5285
  type Memory = {
5270
5286
  id?: string;
5271
5287
  memory_store_id?: string;
5288
+ /**
5289
+ * The end user the memory belongs to; null for none. Set on create and never changed; a replacement written by a supersede belongs to the same actor.
5290
+ */
5291
+ actor_id?: string | null;
5272
5292
  /**
5273
5293
  * The text this memory currently holds. Stored once per distinct text per store and shared with every assertion that stated it, so a memory carries no copy of its own.
5274
5294
  */
@@ -5897,6 +5917,12 @@ type OrchestrationNode = {
5897
5917
  * For loop and sub_orchestration nodes — allowlist of the run's `tool_context` keys the child run inherits. When `null` (the default), the child inherits the parent's whole bag. When set, only the listed keys are handed down, so a run holding a broad credential can delegate one step to a shared sub-graph without passing on what that sub-graph does not need; `[]` hands down nothing. Matching is case-insensitive, since an entry names a key that becomes an HTTP header name; an entry outside that grammar is rejected at write time with `INVALID_TOOL_CONTEXT_KEY`. The server-derived identity keys (`session_id`, `actor_id`, `actor_external_id`) are unaffected — they are re-derived per generation in the child regardless of this list. Ignored for other node types.
5898
5918
  */
5899
5919
  context_keys?: Array<string> | null;
5920
+ /**
5921
+ * For loop nodes — per-item `tool_context` keys for each child run. Each key is a `tool_context` key; each value is JSON Logic evaluated against `{ <item_variable>: <item>, "state": <run state> }`. A child's bag is the inherited one (after `context_keys`) with these keys laid over it, matched case-insensitively. A value evaluating to `null` drops the key, the inherited value included. A value that evaluates to anything else but a string, or throws, fails that item: under `on_item_error: fail` the node fails before any child starts; under `collect` the item's entry in `results` is `{ "error": { "code", "message" } }` and no child runs for it. A key outside the header-name grammar, two keys differing only in case, or a server-reserved key (`session_id`, `actor_id`, `actor_external_id`, `calling_project_id`) is rejected at write time with `INVALID_TOOL_CONTEXT_KEY`. Ignored for other node types.
5922
+ */
5923
+ item_tool_context?: {
5924
+ [key: string]: unknown;
5925
+ };
5900
5926
  /**
5901
5927
  * For poll nodes — wait between attempts. Accepts a friendly suffix form (`5s`, `30s`, `5m`, `2h`, `500ms`) or ISO 8601 (e.g. PT5S).
5902
5928
  *
@@ -6295,7 +6321,7 @@ type NodeExecution = {
6295
6321
  */
6296
6322
  type RequiredAction = {
6297
6323
  /**
6298
- * Discriminator identifying the kind of pause. Open enum — new pause kinds may be added in minor releases; clients must tolerate unknown values. `child_run` is a `loop` or `sub_orchestration` node whose child runs, listed in `context.orchestration_run_ids`, have not settled; their settle resumes it, and it accepts no human input.
6324
+ * Discriminator identifying the kind of pause. Open enum — new pause kinds may be added in minor releases; clients must tolerate unknown values. `child_run` is a `loop` or `sub_orchestration` node whose child runs, listed in `context.orchestration_run_ids`, have not settled; their settle resumes it, and it accepts no human input. A `loop` collecting item errors also lists, in `context.item_errors` (`[{ index, code, message }]`), the items whose `item_tool_context` failed and started no child.
6299
6325
  */
6300
6326
  type: 'human_input' | 'webhook_receive' | 'approval' | 'paused' | 'child_run';
6301
6327
  /**
@@ -7661,7 +7687,7 @@ type Task = {
7661
7687
  */
7662
7688
  pause_reason?: string | null;
7663
7689
  /**
7664
- * Server-owned. How many machine-driven transitions have run back-to-back with no outside intervention — a dispatch outcome routed through `on_complete`/`on_failure`, or a `transition-task` call made by a dispatched run or agent with its run-as token. Any move by a person, a plain API key, or an approval resolution resets it to `0`. Once it would exceed the server's limit (`TASK_AUTOMATION_CHAIN_LIMIT`, default 50) the next such transition is refused with `TASK_AUTOMATION_CHAIN_LIMIT`, bounding a cycle composed across workflows and orchestrations.
7690
+ * Server-owned. How many machine-driven transitions have run back-to-back with no outside intervention — a dispatch outcome routed through `on_complete`/`on_failure`, or a `transition-task` call made by a dispatched run or agent under its stored authority. Any move by a person, a plain API key, or an approval resolution resets it to `0`. Once it would exceed the server's limit (`TASK_AUTOMATION_CHAIN_LIMIT`, default 50) the next such transition is refused with `TASK_AUTOMATION_CHAIN_LIMIT`, bounding a cycle composed across workflows and orchestrations.
7665
7691
  */
7666
7692
  automation_chain_depth?: number;
7667
7693
  /**
@@ -9423,6 +9449,10 @@ type FileRecordWritable = {
9423
9449
  */
9424
9450
  updated_at?: Date;
9425
9451
  };
9452
+ /**
9453
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
9454
+ */
9455
+ type ActorPin = string;
9426
9456
  /**
9427
9457
  * Agent public ID
9428
9458
  */
@@ -9503,10 +9533,6 @@ type PlaybookId = string;
9503
9533
  * The case ID
9504
9534
  */
9505
9535
  type CaseId = string;
9506
- /**
9507
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
9508
- */
9509
- type ActorPin = string;
9510
9536
  /**
9511
9537
  * The ID of a node of the case's playbook version
9512
9538
  */
@@ -19437,6 +19463,10 @@ type SearchKnowledgeData = {
19437
19463
  * Search memories within these specific memory stores
19438
19464
  */
19439
19465
  memory_store_ids?: Array<string>;
19466
+ /**
19467
+ * Searches only the memories that belong to this actor; documents are not narrowed. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent searches the memories of the end user it serves only.
19468
+ */
19469
+ actor_id?: string;
19440
19470
  /**
19441
19471
  * Filter results to documents whose file path starts with one of these prefixes
19442
19472
  */
@@ -19506,6 +19536,10 @@ type ListMemoriesData = {
19506
19536
  * Memory store to list memories from (mstore_...)
19507
19537
  */
19508
19538
  memory_store_id: string;
19539
+ /**
19540
+ * Only the memories that belong to this actor. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent lists the memories of the end user it serves only.
19541
+ */
19542
+ actor_id?: string;
19509
19543
  /**
19510
19544
  * Filter by tag pairs, written `key:value` (split on the first colon, so a value may contain colons). Repeat the parameter for several pairs; **all** must be present with exactly that value.
19511
19545
  *
@@ -19572,6 +19606,10 @@ type CreateMemoryData = {
19572
19606
  * The text content of the memory
19573
19607
  */
19574
19608
  content: string;
19609
+ /**
19610
+ * The end user the memory belongs to, an actor of the memory store's project; an unknown one is `400 ACTOR_NOT_FOUND`. The write compares, supersedes and creates among that actor's memories only. Omitted, the memory belongs to no actor and is compared with the other memories of no actor.
19611
+ */
19612
+ actor_id?: string;
19575
19613
  /**
19576
19614
  * Whether there is a source to point at. `conversation` requires `source_id`; `manual` rejects it.
19577
19615
  */
@@ -19661,6 +19699,10 @@ type DeleteMemoryData = {
19661
19699
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
19662
19700
  */
19663
19701
  memory_store_id?: string;
19702
+ /**
19703
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
19704
+ */
19705
+ actor_id?: string;
19664
19706
  };
19665
19707
  url: '/api/v1/memories/{memory_id}';
19666
19708
  };
@@ -19708,6 +19750,10 @@ type GetMemoryData = {
19708
19750
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
19709
19751
  */
19710
19752
  memory_store_id?: string;
19753
+ /**
19754
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
19755
+ */
19756
+ actor_id?: string;
19711
19757
  };
19712
19758
  url: '/api/v1/memories/{memory_id}';
19713
19759
  };
@@ -19778,6 +19824,10 @@ type UpdateMemoryData = {
19778
19824
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
19779
19825
  */
19780
19826
  memory_store_id?: string;
19827
+ /**
19828
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
19829
+ */
19830
+ actor_id?: string;
19781
19831
  };
19782
19832
  url: '/api/v1/memories/{memory_id}';
19783
19833
  };
@@ -19844,6 +19894,10 @@ type RetractMemoryData = {
19844
19894
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
19845
19895
  */
19846
19896
  memory_store_id?: string;
19897
+ /**
19898
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
19899
+ */
19900
+ actor_id?: string;
19847
19901
  };
19848
19902
  url: '/api/v1/memories/{memory_id}/retract';
19849
19903
  };
@@ -19899,6 +19953,10 @@ type ListMemoryAssertionsData = {
19899
19953
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
19900
19954
  */
19901
19955
  memory_store_id?: string;
19956
+ /**
19957
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
19958
+ */
19959
+ actor_id?: string;
19902
19960
  /**
19903
19961
  * Results per page. Above the maximum it is clamped; below 1 or not an integer it is `400 VALIDATION_FAILED`.
19904
19962
  */
@@ -19959,6 +20017,10 @@ type GetMemoryTagsData = {
19959
20017
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
19960
20018
  */
19961
20019
  memory_store_id?: string;
20020
+ /**
20021
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
20022
+ */
20023
+ actor_id?: string;
19962
20024
  };
19963
20025
  url: '/api/v1/memories/{memory_id}/tags';
19964
20026
  };
@@ -20009,6 +20071,10 @@ type MergeMemoryTagsData = {
20009
20071
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
20010
20072
  */
20011
20073
  memory_store_id?: string;
20074
+ /**
20075
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
20076
+ */
20077
+ actor_id?: string;
20012
20078
  };
20013
20079
  url: '/api/v1/memories/{memory_id}/tags';
20014
20080
  };
@@ -20063,6 +20129,10 @@ type ReplaceMemoryTagsData = {
20063
20129
  * Pins the call to memories of this store, the same parameter that scopes the listing. A memory of another store is `404`, as if it did not exist.
20064
20130
  */
20065
20131
  memory_store_id?: string;
20132
+ /**
20133
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
20134
+ */
20135
+ actor_id?: string;
20066
20136
  };
20067
20137
  url: '/api/v1/memories/{memory_id}/tags';
20068
20138
  };
@@ -20684,6 +20754,10 @@ type ListMemoryStoreAssertionsData = {
20684
20754
  memory_store_id: string;
20685
20755
  };
20686
20756
  query?: {
20757
+ /**
20758
+ * Only the writes that resolved into this actor's memories. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` to confine it to the end user an agent serves.
20759
+ */
20760
+ actor_id?: string;
20687
20761
  /**
20688
20762
  * Only assertions that came through this door.
20689
20763
  */
@@ -20760,6 +20834,10 @@ type ExportMemoriesData = {
20760
20834
  memory_store_id: string;
20761
20835
  };
20762
20836
  query?: {
20837
+ /**
20838
+ * Only the memories that belong to this actor.
20839
+ */
20840
+ actor_id?: string;
20763
20841
  /**
20764
20842
  * Include memories that were retracted or superseded
20765
20843
  */
@@ -23605,7 +23683,7 @@ type DeletePlaybookCaseData = {
23605
23683
  };
23606
23684
  query?: {
23607
23685
  /**
23608
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
23686
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23609
23687
  */
23610
23688
  actor_id?: string;
23611
23689
  };
@@ -23659,7 +23737,7 @@ type GetPlaybookCaseData = {
23659
23737
  };
23660
23738
  query?: {
23661
23739
  /**
23662
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
23740
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23663
23741
  */
23664
23742
  actor_id?: string;
23665
23743
  };
@@ -23709,7 +23787,7 @@ type WritePlaybookCaseInputsData = {
23709
23787
  };
23710
23788
  query?: {
23711
23789
  /**
23712
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
23790
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23713
23791
  */
23714
23792
  actor_id?: string;
23715
23793
  };
@@ -23767,7 +23845,7 @@ type GetPlaybookCaseMissingData = {
23767
23845
  };
23768
23846
  query: {
23769
23847
  /**
23770
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
23848
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23771
23849
  */
23772
23850
  actor_id?: string;
23773
23851
  /**
@@ -23817,7 +23895,7 @@ type ListPlaybookCaseEntriesData = {
23817
23895
  };
23818
23896
  query?: {
23819
23897
  /**
23820
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
23898
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23821
23899
  */
23822
23900
  actor_id?: string;
23823
23901
  /**
@@ -23881,7 +23959,7 @@ type RunPlaybookCaseNodeData = {
23881
23959
  };
23882
23960
  query?: {
23883
23961
  /**
23884
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
23962
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23885
23963
  */
23886
23964
  actor_id?: string;
23887
23965
  };
@@ -23939,7 +24017,7 @@ type ListPlaybookCaseExecutionsData = {
23939
24017
  };
23940
24018
  query?: {
23941
24019
  /**
23942
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24020
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
23943
24021
  */
23944
24022
  actor_id?: string;
23945
24023
  /**
@@ -24003,7 +24081,7 @@ type GetPlaybookCaseExecutionData = {
24003
24081
  };
24004
24082
  query?: {
24005
24083
  /**
24006
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24084
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24007
24085
  */
24008
24086
  actor_id?: string;
24009
24087
  };
@@ -24053,7 +24131,7 @@ type ExportPlaybookCaseNodeData = {
24053
24131
  };
24054
24132
  query?: {
24055
24133
  /**
24056
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24134
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24057
24135
  */
24058
24136
  actor_id?: string;
24059
24137
  };
@@ -24113,7 +24191,7 @@ type ListPlaybookCaseExportsData = {
24113
24191
  };
24114
24192
  query?: {
24115
24193
  /**
24116
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24194
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24117
24195
  */
24118
24196
  actor_id?: string;
24119
24197
  /**
@@ -24181,7 +24259,7 @@ type GetPlaybookCaseExportData = {
24181
24259
  };
24182
24260
  query?: {
24183
24261
  /**
24184
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24262
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24185
24263
  */
24186
24264
  actor_id?: string;
24187
24265
  };
@@ -24227,7 +24305,7 @@ type UpgradePlaybookCaseData = {
24227
24305
  };
24228
24306
  query?: {
24229
24307
  /**
24230
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24308
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24231
24309
  */
24232
24310
  actor_id?: string;
24233
24311
  };
@@ -24285,7 +24363,7 @@ type ListPlaybookCaseUpgradesData = {
24285
24363
  };
24286
24364
  query?: {
24287
24365
  /**
24288
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24366
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24289
24367
  */
24290
24368
  actor_id?: string;
24291
24369
  /**
@@ -24341,7 +24419,7 @@ type PausePlaybookCaseData = {
24341
24419
  };
24342
24420
  query?: {
24343
24421
  /**
24344
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24422
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24345
24423
  */
24346
24424
  actor_id?: string;
24347
24425
  };
@@ -24391,7 +24469,7 @@ type ResumePlaybookCaseData = {
24391
24469
  };
24392
24470
  query?: {
24393
24471
  /**
24394
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24472
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24395
24473
  */
24396
24474
  actor_id?: string;
24397
24475
  };
@@ -24449,7 +24527,7 @@ type ConfirmPlaybookCaseNodeData = {
24449
24527
  };
24450
24528
  query?: {
24451
24529
  /**
24452
- * Acts only on a case that belongs to this actor: any other case, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's cases only.
24530
+ * Acts only on an item that belongs to this actor: any other item, one that belongs to no actor included, is `404` as if it did not exist. Pin it in a tool's `preset_parameters` as `{{context:actor_id}}` so an agent serving an end user reaches that user's items only.
24453
24531
  */
24454
24532
  actor_id?: string;
24455
24533
  };
@@ -24629,7 +24707,7 @@ type DeletePolicyErrors = {
24629
24707
  */
24630
24708
  404: ErrorResponse;
24631
24709
  /**
24632
- * `POLICY_HAS_DEPENDENTS`: a trigger, agent or webhook still names the policy in its `policy_ids`. Detach it or delete them first.
24710
+ * `POLICY_HAS_DEPENDENTS`: a trigger, agent, webhook, user or API key still names the policy in its `policy_ids`. Detach it or delete them first.
24633
24711
  */
24634
24712
  409: ErrorResponse;
24635
24713
  /**
@@ -30853,7 +30931,7 @@ export declare class ApiKeys {
30853
30931
  /**
30854
30932
  * List API keys
30855
30933
  *
30856
- * Lists API keys accessible to the caller. - JWT admin: returns all API keys. - JWT regular user: returns only the user's own API keys. - Project-scoped credential (API key or OAuth token): returns the caller's own
30934
+ * Lists API keys accessible to the caller. - An unrestricted admin (a login, or a key bound to no project and narrowed by no policy): returns all API keys. - Any other unscoped credential: returns only its user's own API keys. - Project-scoped credential (API key or OAuth token): returns the caller's own
30857
30935
  * keys scoped to that project, or every key scoped to it when the credential
30858
30936
  * holds `api-keys:ListApiKeys` on the project. Confinement to a project is not
30859
30937
  * authority over it, and a key's metadata names its owner, prefix and attached
@@ -30864,26 +30942,26 @@ export declare class ApiKeys {
30864
30942
  /**
30865
30943
  * Create an API key
30866
30944
  *
30867
- * Creates a new API key for the authenticated user. - `project_id` is optional. When set, the key is scoped to that single project. When omitted or null, the key is **unscoped** and spans every project its owner can reach. - If `policy_ids` is provided, the key's effective permissions are the intersection of the user's policies and the key's policies. - Otherwise the key inherits the user's permissions (confined to the key's project when scoped). - When the request is authenticated with a **project-scoped token** (an OAuth access token, a trigger run-as token, a run token or an IAM token), it returns `403 API_KEY_SCOPED_TOKEN`: such a token never creates a key. - When the request is authenticated with a **project-scoped API key**, the new key is confined to that same project: omitting `project_id` defaults to it, naming a different project returns `403 API_KEY_PROJECT_SCOPE`, and `project_id: null` (an unscoped key) is likewise refused. Minting an unscoped key requires an unscoped credential. - When the request is authenticated with an **API key narrowed by `policy_ids`**, the new key stays inside that boundary: omitting `policy_ids` inherits the caller's own, a non-empty subset of them is accepted, and an empty list or any other policy returns `403 API_KEY_POLICY_BOUNDARY`.
30945
+ * Creates a new API key for the authenticated user. - `project_id` is optional. When set, the key is scoped to that single project. When omitted or null, the key is **unscoped** and spans every project its owner can reach. - If `policy_ids` is provided, the key's effective permissions are the intersection of the user's policies and the key's policies. - Otherwise the key inherits the user's permissions (confined to the key's project when scoped). - When the request is narrowed beyond its credential's own grant (an OAuth access token, an IAM token, an `On-Behalf-Of` assertion, or a call durable work makes under its stored authority), it returns `403 CREDENTIAL_NARROWED`: a key would outlive that narrowing. - When the request is authenticated with a **project-scoped API key**, the new key is confined to that same project: omitting `project_id` defaults to it, naming a different project returns `403 API_KEY_PROJECT_SCOPE`, and `project_id: null` (an unscoped key) is likewise refused. Minting an unscoped key requires an unscoped credential. - When the request is authenticated with an **API key narrowed by `policy_ids`**, the new key stays inside that boundary: omitting `policy_ids` inherits the caller's own, a non-empty subset of them is accepted, and an empty list or any other policy returns `403 API_KEY_POLICY_BOUNDARY`.
30868
30946
  *
30869
30947
  */
30870
30948
  static createApiKey<ThrowOnError extends boolean = false>(options: Options<CreateApiKeyData, ThrowOnError>): RequestResult<CreateApiKeyResponses, CreateApiKeyErrors, ThrowOnError>;
30871
30949
  /**
30872
30950
  * Delete an API key
30873
30951
  *
30874
- * Deletes an API key. Only the owner or an admin can delete it, and a project-scoped credential can only delete keys in its own project.
30952
+ * Deletes an API key. Only the owner or an unrestricted admin can delete it, and a project-scoped credential can only delete keys in its own project.
30875
30953
  */
30876
30954
  static deleteApiKey<ThrowOnError extends boolean = false>(options: Options<DeleteApiKeyData, ThrowOnError>): RequestResult<DeleteApiKeyResponses, DeleteApiKeyErrors, ThrowOnError>;
30877
30955
  /**
30878
30956
  * Get an API key
30879
30957
  *
30880
- * Returns details of an API key. Only the owner or an admin can access it, and a project-scoped credential can only reach keys in its own project.
30958
+ * Returns details of an API key. Only the owner or an unrestricted admin can access it, and a project-scoped credential can only reach keys in its own project.
30881
30959
  */
30882
30960
  static getApiKey<ThrowOnError extends boolean = false>(options: Options<GetApiKeyData, ThrowOnError>): RequestResult<GetApiKeyResponses, GetApiKeyErrors, ThrowOnError>;
30883
30961
  /**
30884
30962
  * Update an API key
30885
30963
  *
30886
- * Updates an API key's name, project scope, or policies. The project scope can be changed to another project, set (scoping a previously unscoped key), or cleared with null (unscoping the key). Only the owner or an admin can update it. A project-scoped credential can only update keys in its own project, and cannot move a key to another project or unscope it. An API key narrowed by `policy_ids` can only set `policy_ids` to a non-empty subset of its own (`403 API_KEY_POLICY_BOUNDARY` otherwise). A project-scoped token (OAuth, trigger, run or IAM) never updates a key (`403 API_KEY_SCOPED_TOKEN`).
30964
+ * Updates an API key's name, project scope, or policies. The project scope can be changed to another project, set (scoping a previously unscoped key), or cleared with null (unscoping the key). Only the owner or an unrestricted admin (a login, or a key bound to no project and narrowed by no policy) can update it. A project-scoped credential can only update keys in its own project, and cannot move a key to another project or unscope it. An API key narrowed by `policy_ids` can only set `policy_ids` to a non-empty subset of its own (`403 API_KEY_POLICY_BOUNDARY` otherwise). A request narrowed beyond its credential's own grant (OAuth, trigger, run or IAM token, or `On-Behalf-Of`) never updates a key (`403 CREDENTIAL_NARROWED`).
30887
30965
  */
30888
30966
  static updateApiKey<ThrowOnError extends boolean = false>(options: Options<UpdateApiKeyData, ThrowOnError>): RequestResult<UpdateApiKeyResponses, UpdateApiKeyErrors, ThrowOnError>;
30889
30967
  }
@@ -31867,7 +31945,7 @@ export declare class Iam {
31867
31945
  /**
31868
31946
  * Check a permission of the calling credential
31869
31947
  *
31870
- * Evaluates the calling credential's own policies (its owner's and, for an API key or OAuth token, its boundary and project scope) for an action the deployment registered (`IAM_REGISTRATIONS_CONFIG`), or an action the writer rule asks of whoever writes a resource that acts later (a target's start action, `secrets:UseSecret`), on an SRN, with the engine the runtime's own routes use. A denial is `200` with `allowed: false`, never `403`. Only policies are evaluated: the answer says nothing about whether the resource exists.
31948
+ * Evaluates the calling credential's own policies (its owner's and, for an API key or OAuth token, its boundary and project scope) for an action the deployment registered (`IAM_REGISTRATIONS_CONFIG`) or any built-in action, such as one a resource the deployment stores will perform later, on an SRN, with the engine the runtime's own routes use. A denial is `200` with `allowed: false`, never `403`. Only policies are evaluated: the answer says nothing about whether the resource exists.
31871
31949
  */
31872
31950
  static checkIamPermission<ThrowOnError extends boolean = false>(options: Options<CheckIamPermissionData, ThrowOnError>): RequestResult<CheckIamPermissionResponses, CheckIamPermissionErrors, ThrowOnError>;
31873
31951
  /**
@@ -32455,7 +32533,7 @@ export declare class Playbooks {
32455
32533
  /**
32456
32534
  * Run a node of a case
32457
32535
  *
32458
- * Runs one node now. The cascade already runs every node whose inputs are set once a write, a settle or a resume makes it runnable, and never reruns a `failed` or `done` one: this is how a failed node is retried, and how a `done` node is recomputed after an upgrade changed its executor. A `collect` node takes its own input values as its output, any other node starts its executor with the node's input values mapped through the executor's `input`. The executor runs as the author of the case's playbook version, whose permission to start it is checked again here (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`); an author that no longer exists is `409 PLAYBOOK_AUTHOR_UNAVAILABLE`. Only a `ready`, `stale`, `failed` or `done` node with every required input set runs; anything else is `409 PLAYBOOK_NODE_NOT_RUNNABLE`. A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`.
32536
+ * Runs one node now. The cascade already runs every node whose inputs are set once a write, a settle or a resume makes it runnable, and never reruns a `failed` or `done` one: this is how a failed node is retried, and how a `done` node is recomputed after an upgrade changed its executor. A `collect` node takes its own input values as its output, any other node starts its executor with the node's input values mapped through the executor's `input`. The executor runs as the author of the case's playbook version, whose permission to start it is checked again here (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`); an author that no longer exists is `409 WORK_AUTHORITY_MISSING`. Only a `ready`, `stale`, `failed` or `done` node with every required input set runs; anything else is `409 PLAYBOOK_NODE_NOT_RUNNABLE`. A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`.
32459
32537
  *
32460
32538
  * An `upstream` node has no executor: running it pulls the current output of the node it names in the bound case, which must be `done`. This is the only way to refresh one that an upstream change left `stale`.
32461
32539
  *
@@ -32552,7 +32630,7 @@ export declare class Policies {
32552
32630
  /**
32553
32631
  * Delete a policy
32554
32632
  *
32555
- * Deletes a policy. A project policy needs `policies:DeletePolicy` in its project; a global one, the unrestricted admin. Refused with `409 POLICY_HAS_DEPENDENTS` while a trigger, agent or webhook names it in its `policy_ids`.
32633
+ * Deletes a policy. A project policy needs `policies:DeletePolicy` in its project; a global one, the unrestricted admin. Refused with `409 POLICY_HAS_DEPENDENTS` while a trigger, agent, webhook, user or API key names it in its `policy_ids`.
32556
32634
  */
32557
32635
  static deletePolicy<ThrowOnError extends boolean = false>(options: Options<DeletePolicyData, ThrowOnError>): RequestResult<DeletePolicyResponses, DeletePolicyErrors, ThrowOnError>;
32558
32636
  /**
package/dist/index.mjs CHANGED
@@ -1085,7 +1085,7 @@ var ApiKeys = class {
1085
1085
  /**
1086
1086
  * List API keys
1087
1087
  *
1088
- * Lists API keys accessible to the caller. - JWT admin: returns all API keys. - JWT regular user: returns only the user's own API keys. - Project-scoped credential (API key or OAuth token): returns the caller's own
1088
+ * Lists API keys accessible to the caller. - An unrestricted admin (a login, or a key bound to no project and narrowed by no policy): returns all API keys. - Any other unscoped credential: returns only its user's own API keys. - Project-scoped credential (API key or OAuth token): returns the caller's own
1089
1089
  * keys scoped to that project, or every key scoped to it when the credential
1090
1090
  * holds `api-keys:ListApiKeys` on the project. Confinement to a project is not
1091
1091
  * authority over it, and a key's metadata names its owner, prefix and attached
@@ -1105,7 +1105,7 @@ var ApiKeys = class {
1105
1105
  /**
1106
1106
  * Create an API key
1107
1107
  *
1108
- * Creates a new API key for the authenticated user. - `project_id` is optional. When set, the key is scoped to that single project. When omitted or null, the key is **unscoped** and spans every project its owner can reach. - If `policy_ids` is provided, the key's effective permissions are the intersection of the user's policies and the key's policies. - Otherwise the key inherits the user's permissions (confined to the key's project when scoped). - When the request is authenticated with a **project-scoped token** (an OAuth access token, a trigger run-as token, a run token or an IAM token), it returns `403 API_KEY_SCOPED_TOKEN`: such a token never creates a key. - When the request is authenticated with a **project-scoped API key**, the new key is confined to that same project: omitting `project_id` defaults to it, naming a different project returns `403 API_KEY_PROJECT_SCOPE`, and `project_id: null` (an unscoped key) is likewise refused. Minting an unscoped key requires an unscoped credential. - When the request is authenticated with an **API key narrowed by `policy_ids`**, the new key stays inside that boundary: omitting `policy_ids` inherits the caller's own, a non-empty subset of them is accepted, and an empty list or any other policy returns `403 API_KEY_POLICY_BOUNDARY`.
1108
+ * Creates a new API key for the authenticated user. - `project_id` is optional. When set, the key is scoped to that single project. When omitted or null, the key is **unscoped** and spans every project its owner can reach. - If `policy_ids` is provided, the key's effective permissions are the intersection of the user's policies and the key's policies. - Otherwise the key inherits the user's permissions (confined to the key's project when scoped). - When the request is narrowed beyond its credential's own grant (an OAuth access token, an IAM token, an `On-Behalf-Of` assertion, or a call durable work makes under its stored authority), it returns `403 CREDENTIAL_NARROWED`: a key would outlive that narrowing. - When the request is authenticated with a **project-scoped API key**, the new key is confined to that same project: omitting `project_id` defaults to it, naming a different project returns `403 API_KEY_PROJECT_SCOPE`, and `project_id: null` (an unscoped key) is likewise refused. Minting an unscoped key requires an unscoped credential. - When the request is authenticated with an **API key narrowed by `policy_ids`**, the new key stays inside that boundary: omitting `policy_ids` inherits the caller's own, a non-empty subset of them is accepted, and an empty list or any other policy returns `403 API_KEY_POLICY_BOUNDARY`.
1109
1109
  *
1110
1110
  */
1111
1111
  static createApiKey(options) {
@@ -1121,7 +1121,7 @@ var ApiKeys = class {
1121
1121
  /**
1122
1122
  * Delete an API key
1123
1123
  *
1124
- * Deletes an API key. Only the owner or an admin can delete it, and a project-scoped credential can only delete keys in its own project.
1124
+ * Deletes an API key. Only the owner or an unrestricted admin can delete it, and a project-scoped credential can only delete keys in its own project.
1125
1125
  */
1126
1126
  static deleteApiKey(options) {
1127
1127
  return (options.client ?? client).delete({
@@ -1132,7 +1132,7 @@ var ApiKeys = class {
1132
1132
  /**
1133
1133
  * Get an API key
1134
1134
  *
1135
- * Returns details of an API key. Only the owner or an admin can access it, and a project-scoped credential can only reach keys in its own project.
1135
+ * Returns details of an API key. Only the owner or an unrestricted admin can access it, and a project-scoped credential can only reach keys in its own project.
1136
1136
  */
1137
1137
  static getApiKey(options) {
1138
1138
  return (options.client ?? client).get({
@@ -1143,7 +1143,7 @@ var ApiKeys = class {
1143
1143
  /**
1144
1144
  * Update an API key
1145
1145
  *
1146
- * Updates an API key's name, project scope, or policies. The project scope can be changed to another project, set (scoping a previously unscoped key), or cleared with null (unscoping the key). Only the owner or an admin can update it. A project-scoped credential can only update keys in its own project, and cannot move a key to another project or unscope it. An API key narrowed by `policy_ids` can only set `policy_ids` to a non-empty subset of its own (`403 API_KEY_POLICY_BOUNDARY` otherwise). A project-scoped token (OAuth, trigger, run or IAM) never updates a key (`403 API_KEY_SCOPED_TOKEN`).
1146
+ * Updates an API key's name, project scope, or policies. The project scope can be changed to another project, set (scoping a previously unscoped key), or cleared with null (unscoping the key). Only the owner or an unrestricted admin (a login, or a key bound to no project and narrowed by no policy) can update it. A project-scoped credential can only update keys in its own project, and cannot move a key to another project or unscope it. An API key narrowed by `policy_ids` can only set `policy_ids` to a non-empty subset of its own (`403 API_KEY_POLICY_BOUNDARY` otherwise). A request narrowed beyond its credential's own grant (OAuth, trigger, run or IAM token, or `On-Behalf-Of`) never updates a key (`403 CREDENTIAL_NARROWED`).
1147
1147
  */
1148
1148
  static updateApiKey(options) {
1149
1149
  return (options.client ?? client).put({
@@ -3039,7 +3039,7 @@ var Iam = class {
3039
3039
  /**
3040
3040
  * Check a permission of the calling credential
3041
3041
  *
3042
- * Evaluates the calling credential's own policies (its owner's and, for an API key or OAuth token, its boundary and project scope) for an action the deployment registered (`IAM_REGISTRATIONS_CONFIG`), or an action the writer rule asks of whoever writes a resource that acts later (a target's start action, `secrets:UseSecret`), on an SRN, with the engine the runtime's own routes use. A denial is `200` with `allowed: false`, never `403`. Only policies are evaluated: the answer says nothing about whether the resource exists.
3042
+ * Evaluates the calling credential's own policies (its owner's and, for an API key or OAuth token, its boundary and project scope) for an action the deployment registered (`IAM_REGISTRATIONS_CONFIG`) or any built-in action, such as one a resource the deployment stores will perform later, on an SRN, with the engine the runtime's own routes use. A denial is `200` with `allowed: false`, never `403`. Only policies are evaluated: the answer says nothing about whether the resource exists.
3043
3043
  */
3044
3044
  static checkIamPermission(options) {
3045
3045
  return (options.client ?? client).post({
@@ -4228,7 +4228,7 @@ var Playbooks = class {
4228
4228
  /**
4229
4229
  * Run a node of a case
4230
4230
  *
4231
- * Runs one node now. The cascade already runs every node whose inputs are set once a write, a settle or a resume makes it runnable, and never reruns a `failed` or `done` one: this is how a failed node is retried, and how a `done` node is recomputed after an upgrade changed its executor. A `collect` node takes its own input values as its output, any other node starts its executor with the node's input values mapped through the executor's `input`. The executor runs as the author of the case's playbook version, whose permission to start it is checked again here (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`); an author that no longer exists is `409 PLAYBOOK_AUTHOR_UNAVAILABLE`. Only a `ready`, `stale`, `failed` or `done` node with every required input set runs; anything else is `409 PLAYBOOK_NODE_NOT_RUNNABLE`. A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`.
4231
+ * Runs one node now. The cascade already runs every node whose inputs are set once a write, a settle or a resume makes it runnable, and never reruns a `failed` or `done` one: this is how a failed node is retried, and how a `done` node is recomputed after an upgrade changed its executor. A `collect` node takes its own input values as its output, any other node starts its executor with the node's input values mapped through the executor's `input`. The executor runs as the author of the case's playbook version, whose permission to start it is checked again here (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`); an author that no longer exists is `409 WORK_AUTHORITY_MISSING`. Only a `ready`, `stale`, `failed` or `done` node with every required input set runs; anything else is `409 PLAYBOOK_NODE_NOT_RUNNABLE`. A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`.
4232
4232
  *
4233
4233
  * An `upstream` node has no executor: running it pulls the current output of the node it names in the bound case, which must be `done`. This is the only way to refresh one that an upstream change left `stale`.
4234
4234
  *
@@ -4410,7 +4410,7 @@ var Policies = class {
4410
4410
  /**
4411
4411
  * Delete a policy
4412
4412
  *
4413
- * Deletes a policy. A project policy needs `policies:DeletePolicy` in its project; a global one, the unrestricted admin. Refused with `409 POLICY_HAS_DEPENDENTS` while a trigger, agent or webhook names it in its `policy_ids`.
4413
+ * Deletes a policy. A project policy needs `policies:DeletePolicy` in its project; a global one, the unrestricted admin. Refused with `409 POLICY_HAS_DEPENDENTS` while a trigger, agent, webhook, user or API key names it in its `policy_ids`.
4414
4414
  */
4415
4415
  static deletePolicy(options) {
4416
4416
  return (options.client ?? client).delete({
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@soat/sdk",
3
- "version": "0.108.0",
3
+ "version": "0.110.0",
4
4
  "description": "TypeScript SDK for SOAT — open-source infrastructure for production-ready AI agents.",
5
5
  "keywords": [
6
6
  "ai-agents",