@soat/sdk 0.114.0 → 0.116.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.mjs CHANGED
@@ -3066,6 +3066,21 @@ var Iam = class {
3066
3066
  }
3067
3067
  });
3068
3068
  }
3069
+ /**
3070
+ * Revoke a principal
3071
+ *
3072
+ * Revokes, for good, a `principal` the caller's IAM tokens or `On-Behalf-Of` assertions act for in the project. Work started for it (a generation, a session turn, a task dispatch, an orchestration run, a trigger firing) resolves no caller from then on: its next step, a resume included, fails `WORK_AUTHORITY_MISSING`. Revoking a principal already revoked is `204` too.
3073
+ */
3074
+ static revokeIamPrincipal(options) {
3075
+ return (options.client ?? client).post({
3076
+ url: "/api/v1/iam/principal-revocations",
3077
+ ...options,
3078
+ headers: {
3079
+ "Content-Type": "application/json",
3080
+ ...options.headers
3081
+ }
3082
+ });
3083
+ }
3069
3084
  };
3070
3085
  var IngestionRules = class {
3071
3086
  /**
@@ -4228,7 +4243,7 @@ var Playbooks = class {
4228
4243
  /**
4229
4244
  * Run a node of a case
4230
4245
  *
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 under the `policy_ids` of the case's playbook version, which must allow starting it (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`). 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`.
4246
+ * 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 under the `policy_ids` of the case's playbook version, which must allow starting it: a decider, workflow or orchestration it may not start is `403 PLAYBOOK_EXECUTOR_FORBIDDEN`, and an agent or tool fails the execution (`FORBIDDEN`). 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
4247
  *
4233
4248
  * 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
4249
  *
@@ -4273,7 +4288,7 @@ var Playbooks = class {
4273
4288
  *
4274
4289
  * Renders one revision of a final node as files, one export per transformation: each transformation's tool is called with the case's `case_id` and `subject`, the `node_id`, the `revision` and that revision's `output`, and must answer a file (`execute.response_mode: base64`) of its `format`'s content type. The file is kept in the project's files under `/.system/playbooks/`. An export never feeds a node.
4275
4290
  *
4276
- * Without `revision` the node's current output is exported, which needs the node `done` (`409 PLAYBOOK_NODE_NOT_EXPORTABLE`); a `revision` names an earlier output or confirmation of the node. Each tool runs under the `policy_ids` of the case's playbook version, which must allow calling it (`403 PLAYBOOK_EXECUTOR_FORBIDDEN`). A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`.
4291
+ * Without `revision` the node's current output is exported, which needs the node `done` (`409 PLAYBOOK_NODE_NOT_EXPORTABLE`); a `revision` names an earlier output or confirmation of the node. Each tool runs under the `policy_ids` of the case's playbook version: an export whose tool it may not call fails (`FORBIDDEN`). A paused case is `409 PLAYBOOK_CASE_PAUSED`, and a case in a paused project `409 PROJECT_PAUSED`.
4277
4292
  *
4278
4293
  * Without `wait` every export answers `running` and settles in the background; with `wait: true` it answers once each has its file or its error.
4279
4294
  */
@@ -5371,7 +5386,7 @@ var Triggers = class {
5371
5386
  /**
5372
5387
  * Create a trigger
5373
5388
  *
5374
- * Creates a new trigger for a project. A `{{secret:...}}` reference in `tool_context` also needs `secrets:UseSecret` on that secret, else `403`.
5389
+ * Creates a new trigger for a project. A `{{secret:...}}` reference in `tool_context` also needs `secrets:UseSecret` on that secret, else `403`. An event trigger whose `policy_ids` cannot read a platform namespace its `events` subscribe to is refused with `400` `TRIGGER_EVENTS_UNREADABLE`.
5375
5390
  */
5376
5391
  static createTrigger(options) {
5377
5392
  return (options.client ?? client).post({
@@ -5419,7 +5434,7 @@ var Triggers = class {
5419
5434
  /**
5420
5435
  * Update a trigger
5421
5436
  *
5422
- * Updates an existing trigger's configuration. The type is immutable. Changing `target_type` or `target_id` re-checks the target-start action (`orchestrations:StartRun`, `agents:CreateAgentGeneration` or `tools:CallTool`) against the resulting target, because a firing acts under the trigger's `policy_ids` rather than the updater's grant. A caller who could not start the new target is answered `403` and the trigger keeps the target it had. A `{{secret:...}}` reference in a written `tool_context`, or in the stored one when the target changes, also needs `secrets:UseSecret` on that secret, else `403`.
5437
+ * Updates an existing trigger's configuration. The type is immutable. Changing `target_type` or `target_id` re-checks the target-start action (`orchestrations:StartRun`, `agents:CreateAgentGeneration` or `tools:CallTool`) against the resulting target, because a firing acts under the trigger's `policy_ids` rather than the updater's grant. A caller who could not start the new target is answered `403` and the trigger keeps the target it had. A `{{secret:...}}` reference in a written `tool_context`, or in the stored one when the target changes, also needs `secrets:UseSecret` on that secret, else `403`. An update leaving an event trigger's `policy_ids` unable to read a platform namespace its `events` subscribe to is refused with `400` `TRIGGER_EVENTS_UNREADABLE`.
5423
5438
  *
5424
5439
  */
5425
5440
  static updateTrigger(options) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@soat/sdk",
3
- "version": "0.114.0",
3
+ "version": "0.116.0",
4
4
  "description": "TypeScript SDK for SOAT — open-source infrastructure for production-ready AI agents.",
5
5
  "keywords": [
6
6
  "ai-agents",