@soat/sdk 0.73.1 → 0.75.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
@@ -1037,6 +1037,7 @@ var AiProviders = class {
1037
1037
  * Listing resolves credentials the same way generation does, so a record that can generate can list. The API-key types (`openai`, `groq`, `xai`, `gateway`, `custom`, `anthropic`, `google`) use the record's linked secret and cannot list without one. `bedrock` and `vertex` use the linked secret — IAM keys or a Bedrock API key, a Google service-account key. A record with no `secret_id` would fall back to the server's own credentials (the AWS default credential chain, Google Application Default Credentials); it can list only on a deployment that allows a record to use them, and returns `400 AI_PROVIDER_MISCONFIGURED` otherwise.
1038
1038
  * A Vertex record needs no `config.project` when its secret is a service-account key, since the key file names its own project. A Vertex record in express mode (API key) cannot list at all: the publisher-model listing rejects API keys and needs a credential that asserts a principal, so it returns `400 MODEL_LISTING_UNSUPPORTED`.
1039
1039
  * The Vertex answer is the publisher catalogue the record's `config.location` region serves. The project behind the credential is billed and quota'd for the call but does not filter the result, so a listed model may still be unavailable to that project at generation time.
1040
+ * The provider answers its whole catalogue in one call; `q`, `limit` and `offset` narrow and page what it returned. A request without `limit` gets the first 50 models.
1040
1041
  *
1041
1042
  */
1042
1043
  static listAiProviderModels(options) {
@@ -2706,6 +2707,18 @@ var Generations = class {
2706
2707
  });
2707
2708
  }
2708
2709
  /**
2710
+ * List the memory writes a generation made
2711
+ *
2712
+ * Every memory write this turn made, oldest first: each memory rule's firings and the agent's own `write_memory` calls alike. The rows behind the generation's per-rule `extraction` counts. Reading them is reading the generation (`generations:GetGeneration`).
2713
+ *
2714
+ */
2715
+ static listGenerationMemoryAssertions(options) {
2716
+ return (options.client ?? client).get({
2717
+ url: "/api/v1/generations/{generation_id}/memory-assertions",
2718
+ ...options
2719
+ });
2720
+ }
2721
+ /**
2709
2722
  * Get a generation's transcript
2710
2723
  *
2711
2724
  * Returns one generation's turn read back as an ordered sequence of steps: what it was asked, each model step with its tool calls and results, and how it ended.
@@ -3456,8 +3469,8 @@ var Orchestrations = class {
3456
3469
  /**
3457
3470
  * Get orchestration queue stats
3458
3471
  *
3459
- * Returns a point-in-time snapshot of the orchestration run queue: how many tasks are waiting to be claimed (`queue_depth`), how many are currently claimed with a valid lease (`claimed_tasks`), the age of the oldest waiting task, recent claim-latency percentiles over a rolling in-process window, and a per-project breakdown. Intended for admin/operator policies; guarded by `orchestrations:GetQueueStats`.
3460
- * Every figure is scoped to what the caller may see. A project-scoped caller gets `per_project` for their own projects only, `queue_depth` and `claimed_tasks` summed over those same projects, and `null` for `oldest_queued_age_seconds` and the `claim_latency_ms` percentiles — both describe the whole deployment and cannot be narrowed, so they are withheld rather than approximated. An unrestricted caller (the action granted on every project) gets the deployment-wide figures.
3472
+ * Returns a point-in-time snapshot of the orchestration run queue: how many tasks are waiting to be claimed (`queue_depth`), how many are currently claimed with a valid lease (`claimed_tasks`), the age of the oldest waiting task, recent claim-latency percentiles over a rolling in-process window. The per-project breakdown is listed by `GET /api/v1/orchestrations/queue/stats/projects`. Intended for admin/operator policies; guarded by `orchestrations:GetQueueStats`.
3473
+ * Every figure is scoped to what the caller may see. A project-scoped caller gets `queue_depth` and `claimed_tasks` summed over their own projects, and `null` for `oldest_queued_age_seconds` and the `claim_latency_ms` percentiles — both describe the whole deployment and cannot be narrowed, so they are withheld rather than approximated. An unrestricted caller (the action granted on every project) gets the deployment-wide figures.
3461
3474
  *
3462
3475
  */
3463
3476
  static getQueueStats(options) {
@@ -3471,6 +3484,22 @@ var Orchestrations = class {
3471
3484
  });
3472
3485
  }
3473
3486
  /**
3487
+ * List the projects with queued orchestration work
3488
+ *
3489
+ * One row per project with any queued or claimed task, ordered by project ID: the per-project breakdown of `GET /api/v1/orchestrations/queue/stats`. A project-scoped caller sees its own projects only. Guarded by `orchestrations:GetQueueStats`.
3490
+ *
3491
+ */
3492
+ static listQueueStatsProjects(options) {
3493
+ return (options?.client ?? client).get({
3494
+ security: [{
3495
+ scheme: "bearer",
3496
+ type: "http"
3497
+ }],
3498
+ url: "/api/v1/orchestrations/queue/stats/projects",
3499
+ ...options
3500
+ });
3501
+ }
3502
+ /**
3474
3503
  * Delete an orchestration
3475
3504
  *
3476
3505
  * Deletes an orchestration definition and all its runs.
@@ -3644,6 +3673,17 @@ var Orchestrations = class {
3644
3673
  ...options
3645
3674
  });
3646
3675
  }
3676
+ /**
3677
+ * List a run's node executions
3678
+ *
3679
+ * The run's per-node execution records, oldest first: one per node attempt, retries and skipped nodes included. Each captures the resolved input, output, status and error of that attempt — the orchestration analogue of an LLM trace. Reading them is reading the run (`orchestrations:GetRun`).
3680
+ */
3681
+ static listOrchestrationRunNodeExecutions(options) {
3682
+ return (options.client ?? client).get({
3683
+ url: "/api/v1/orchestration-runs/{orchestration_run_id}/node-executions",
3684
+ ...options
3685
+ });
3686
+ }
3647
3687
  };
3648
3688
  var Policies = class {
3649
3689
  /**
@@ -4555,7 +4595,7 @@ var Traces = class {
4555
4595
  /**
4556
4596
  * Get trace tree
4557
4597
  *
4558
- * Returns the full execution tree rooted at the given trace (or its root if the given trace is a child). Each node represents one agent's execution session. The `children` array contains traces triggered by sub-agent tool calls from that trace.
4598
+ * Returns the full execution tree rooted at the given trace (or its root if the given trace is a child). Each node represents one agent's execution session. The `children` array contains traces triggered by sub-agent tool calls from that trace. A node's generations are listed by `GET /api/v1/generations?trace_id=`, and a node's direct children page by `GET /api/v1/traces?parent_trace_id=`.
4559
4599
  *
4560
4600
  */
4561
4601
  static getTraceTree(options) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@soat/sdk",
3
- "version": "0.73.1",
3
+ "version": "0.75.0",
4
4
  "description": "TypeScript SDK for SOAT — open-source infrastructure for production-ready AI agents.",
5
5
  "keywords": [
6
6
  "ai-agents",