@soat/sdk 0.56.0 → 0.57.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
@@ -3365,7 +3365,7 @@ var Projects = class {
3365
3365
  /**
3366
3366
  * Update a project
3367
3367
  *
3368
- * Updates a project's name, its attached guardrails (`guardrail_ids` — the project-scope baseline governing every tool call by every agent in the project), its orchestration concurrency limit (`max_concurrent_runs`), its continuation-chain ceiling (`max_chain_generations`), its orchestration nesting bound (`max_orchestration_run_depth`), its inherited model route (`default_model_route_id`), its read-auditing opt-in (`audit_reads_enabled`), its trace-content retention window (`trace_content_retention_days`), and/or its zero-retention setting (`trace_content_mode`). At least one field is required. Requires admin role. Detaching a guardrail (removing an id) additionally requires guardrails:DetachGuardrail.
3368
+ * Updates a project's name, its attached guardrails (`guardrail_ids` — the project-scope baseline governing every tool call by every agent in the project), its orchestration concurrency limit (`max_concurrent_runs`), its continuation-chain ceiling (`max_chain_generations`), its orchestration nesting bound (`max_orchestration_run_depth`), its inherited model route (`default_model_route_id`), its read-auditing opt-in (`audit_reads_enabled`), its priced-model requirement (`require_priced_model`), its trace-content retention window (`trace_content_retention_days`), and/or its zero-retention setting (`trace_content_mode`). At least one field is required. Requires admin role. Detaching a guardrail (removing an id) additionally requires guardrails:DetachGuardrail.
3369
3369
  */
3370
3370
  static updateProject(options) {
3371
3371
  return (options.client ?? client).patch({
package/dist/index.d.cts CHANGED
@@ -487,6 +487,16 @@ type Agent = {
487
487
  *
488
488
  */
489
489
  min_score?: number;
490
+ /**
491
+ * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
492
+ *
493
+ */
494
+ rrf_k?: number;
495
+ /**
496
+ * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
497
+ *
498
+ */
499
+ recency_half_life_days?: number;
490
500
  /**
491
501
  * Maximum number of results to inject. Omitted, 10 are injected.
492
502
  *
@@ -691,6 +701,16 @@ type CreateAgentRequest = {
691
701
  *
692
702
  */
693
703
  min_score?: number;
704
+ /**
705
+ * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
706
+ *
707
+ */
708
+ rrf_k?: number;
709
+ /**
710
+ * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
711
+ *
712
+ */
713
+ recency_half_life_days?: number;
694
714
  /**
695
715
  * Maximum number of results to inject. Omitted, 10 are injected.
696
716
  *
@@ -789,6 +809,16 @@ type UpdateAgentRequest = {
789
809
  *
790
810
  */
791
811
  min_score?: number;
812
+ /**
813
+ * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
814
+ *
815
+ */
816
+ rrf_k?: number;
817
+ /**
818
+ * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
819
+ *
820
+ */
821
+ recency_half_life_days?: number;
792
822
  /**
793
823
  * Maximum number of results to inject. Omitted, 10 are injected.
794
824
  *
@@ -883,7 +913,7 @@ type CreateAgentGenerationRequest = {
883
913
  [key: string]: unknown;
884
914
  } | null;
885
915
  /**
886
- * Per-generation knowledge retrieval override. Array filters (memory_store_ids, document_ids, document_paths) are unioned with the agent's stored knowledge_config; `tags` pairs are merged with the override winning per key; scalar fields (min_score, limit) use the per-generation value when present.
916
+ * Per-generation knowledge retrieval override. Array filters (memory_store_ids, document_ids, document_paths) are unioned with the agent's stored knowledge_config; `tags` pairs are merged with the override winning per key; scalar fields (min_score, rrf_k, recency_half_life_days, limit) use the per-generation value when present.
887
917
  */
888
918
  knowledge_config?: {
889
919
  memory_store_ids?: Array<string>;
@@ -898,6 +928,16 @@ type CreateAgentGenerationRequest = {
898
928
  *
899
929
  */
900
930
  min_score?: number;
931
+ /**
932
+ * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
933
+ *
934
+ */
935
+ rrf_k?: number;
936
+ /**
937
+ * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
938
+ *
939
+ */
940
+ recency_half_life_days?: number;
901
941
  /**
902
942
  * Maximum number of results to inject. Omitted, 10 are injected.
903
943
  *
@@ -2439,9 +2479,17 @@ type AgentResourceProperties = {
2439
2479
  */
2440
2480
  tags?: TagBag;
2441
2481
  /**
2442
- * Minimum similarity score (0–1) for retrieved chunks
2482
+ * Minimum raw cosine similarity (0–1) a vector candidate must reach to be ranked. Omitted, there is no floor.
2443
2483
  */
2444
2484
  min_score?: number;
2485
+ /**
2486
+ * The `k` in the fusion term `1 / (k + rank)`; smaller weights the top of each ranking more heavily
2487
+ */
2488
+ rrf_k?: number;
2489
+ /**
2490
+ * Half-life in days of the decay applied to memory results after fusion; `0` disables it
2491
+ */
2492
+ recency_half_life_days?: number;
2445
2493
  /**
2446
2494
  * Maximum number of chunks to inject
2447
2495
  */
@@ -2915,6 +2963,12 @@ type TriggerResourceProperties = {
2915
2963
  input?: {
2916
2964
  [key: string]: unknown;
2917
2965
  } | null;
2966
+ /**
2967
+ * Caller context every firing forwards to the run it starts, so an agent whose tools authorize through `{{context:<key>}}` can be scheduled. Write-only. A value may be a `{{secret:...}}` reference, which is what a template should carry — the credential stays in the secret store and only its name is checked in
2968
+ */
2969
+ tool_context?: {
2970
+ [key: string]: string;
2971
+ } | null;
2918
2972
  /**
2919
2973
  * 5-field cron expression (UTC). Required when type is schedule
2920
2974
  */
@@ -5033,12 +5087,6 @@ type OrchestrationRun = {
5033
5087
  input?: {
5034
5088
  [key: string]: unknown;
5035
5089
  } | null;
5036
- /**
5037
- * The `tool_context` supplied at run creation, forwarded as `X-Soat-Context-<key>` headers on every tool call the run's agent nodes make. Null when the run was started without one.
5038
- */
5039
- tool_context?: {
5040
- [key: string]: string;
5041
- } | null;
5042
5090
  /**
5043
5091
  * The caller-owned key/value metadata supplied at run creation, returned verbatim. Null when the run was started without any. The server writes nothing here and no key is reserved; the bag is never merged into `state`, so nothing in it reaches the graph.
5044
5092
  */
@@ -5213,7 +5261,7 @@ type StartOrchestrationRunRequest = {
5213
5261
  /**
5214
5262
  * Key-value pairs forwarded as `X-Soat-Context-<key>` headers on every `http`, `mcp` and `builtin` tool call made by an agent node of this run — including the agents of any child run a `loop` or `sub_orchestration` node starts. The header name is `X-Soat-Context-` plus the key verbatim; no character is re-cased.
5215
5263
  *
5216
- * The bag is stored on the run and re-read on every step, so it survives an `awaiting_input` pause, a `sleeping` wait, a background worker drive and a crash redrive. A key that is not a valid HTTP header name, or two keys that map to the same header, are rejected with `400 INVALID_TOOL_CONTEXT_KEY` and no run is created.
5264
+ * The bag is stored on the run and re-read on every step, so it survives an `awaiting_input` pause, a `sleeping` wait, a background worker drive and a crash redrive. It is **write-only**: a run is a record every principal who may read runs can read, and a credential in it is not theirs to see, so it is never returned on one. A key that is not a valid HTTP header name, or two keys that map to the same header, are rejected with `400 INVALID_TOOL_CONTEXT_KEY` and no run is created.
5217
5265
  *
5218
5266
  * The reserved identity keys (`session_id`, `actor_id`, `actor_external_id`) are stripped at generation time — a caller cannot address them from here.
5219
5267
  */
@@ -5309,6 +5357,10 @@ type ProjectRecord = {
5309
5357
  * Whether `GET` requests naming this project are recorded in the audit log. `false` by default — v1 audits mutations only.
5310
5358
  */
5311
5359
  audit_reads_enabled?: boolean;
5360
+ /**
5361
+ * Whether a generation whose model carries no price row is refused with `409 MODEL_NOT_PRICED`. `false` by default, where an unpriced model runs and meters at `cost_usd: null`.
5362
+ */
5363
+ require_priced_model?: boolean;
5312
5364
  /**
5313
5365
  * What a conversation that names no `retrieval` of its own does. `none` by default.
5314
5366
  */
@@ -6327,6 +6379,17 @@ type CreateTriggerRequest = {
6327
6379
  input?: {
6328
6380
  [key: string]: unknown;
6329
6381
  };
6382
+ /**
6383
+ * Caller context every firing forwards to the run it starts, so an agent whose tools authorize through `{{context:<key>}}` can be put on a schedule — a firing has no request to carry one. Each key is forwarded as one `X-Soat-Context-<key>` header.
6384
+ *
6385
+ * **Write-only.** It is accepted here and never returned on a read, so the record cannot be used to recover a value.
6386
+ *
6387
+ * A value may be a `{{secret:...}}` reference, which keeps the credential in the [secret](/docs/modules/secrets) store and leaves only its name on the trigger; it is resolved at fire time, so rotating the secret changes the next firing without touching the trigger. A reference naming a secret that does not exist in this project is refused here rather than at fire time.
6388
+ *
6389
+ */
6390
+ tool_context?: {
6391
+ [key: string]: string;
6392
+ };
6330
6393
  /**
6331
6394
  * 5-field cron expression (UTC). Required when type is schedule
6332
6395
  */
@@ -6347,6 +6410,13 @@ type UpdateTriggerRequest = {
6347
6410
  input?: {
6348
6411
  [key: string]: unknown;
6349
6412
  } | null;
6413
+ /**
6414
+ * Replaces the stored bag; `null` clears it. Write-only and resolved at fire time — see `CreateTriggerRequest.tool_context`.
6415
+ *
6416
+ */
6417
+ tool_context?: {
6418
+ [key: string]: string;
6419
+ } | null;
6350
6420
  cron?: string | null;
6351
6421
  event_pattern?: string | null;
6352
6422
  active?: boolean;
@@ -6359,6 +6429,15 @@ type FireTriggerRequest = {
6359
6429
  input?: {
6360
6430
  [key: string]: unknown;
6361
6431
  };
6432
+ /**
6433
+ * Fire-time caller context, shallow-merged per key over the trigger's stored `tool_context`. A manual fire has a caller, so this is the one path that can supply a value without storing it.
6434
+ *
6435
+ * Forwarded exactly as written: a `{{secret:...}}` reference is resolved only in the trigger's stored bag, never in one supplied here.
6436
+ *
6437
+ */
6438
+ tool_context?: {
6439
+ [key: string]: string;
6440
+ };
6362
6441
  };
6363
6442
  type TriggerSecretResponse = {
6364
6443
  secret?: string;
@@ -15497,6 +15576,10 @@ type UpdateProjectData = {
15497
15576
  * Opt the project into read auditing. When true, `GET` requests that name this project are recorded in the audit log alongside mutations. Defaults to `false`.
15498
15577
  */
15499
15578
  audit_reads_enabled?: boolean;
15579
+ /**
15580
+ * Refuse a generation whose model carries no price row for every billable token component, with `409 MODEL_NOT_PRICED`. Defaults to `false`, where an unpriced model runs and meters at `cost_usd: null`. The check runs before the provider is called, so a refused turn spends nothing, and covers every target of a model route the turn may fail over to.
15581
+ */
15582
+ require_priced_model?: boolean;
15500
15583
  /**
15501
15584
  * What a conversation that names no `retrieval` of its own does. `none` by default: a turn is embedded because someone asked for the conversation to be retrievable, never merely because it was said. Turns are stored and chunked on both settings.
15502
15585
  */
@@ -20208,7 +20291,7 @@ export declare class Projects {
20208
20291
  /**
20209
20292
  * Update a project
20210
20293
  *
20211
- * Updates a project's name, its attached guardrails (`guardrail_ids` — the project-scope baseline governing every tool call by every agent in the project), its orchestration concurrency limit (`max_concurrent_runs`), its continuation-chain ceiling (`max_chain_generations`), its orchestration nesting bound (`max_orchestration_run_depth`), its inherited model route (`default_model_route_id`), its read-auditing opt-in (`audit_reads_enabled`), its trace-content retention window (`trace_content_retention_days`), and/or its zero-retention setting (`trace_content_mode`). At least one field is required. Requires admin role. Detaching a guardrail (removing an id) additionally requires guardrails:DetachGuardrail.
20294
+ * Updates a project's name, its attached guardrails (`guardrail_ids` — the project-scope baseline governing every tool call by every agent in the project), its orchestration concurrency limit (`max_concurrent_runs`), its continuation-chain ceiling (`max_chain_generations`), its orchestration nesting bound (`max_orchestration_run_depth`), its inherited model route (`default_model_route_id`), its read-auditing opt-in (`audit_reads_enabled`), its priced-model requirement (`require_priced_model`), its trace-content retention window (`trace_content_retention_days`), and/or its zero-retention setting (`trace_content_mode`). At least one field is required. Requires admin role. Detaching a guardrail (removing an id) additionally requires guardrails:DetachGuardrail.
20212
20295
  */
20213
20296
  static updateProject<ThrowOnError extends boolean = false>(options: Options<UpdateProjectData, ThrowOnError>): RequestResult<UpdateProjectResponses, UpdateProjectErrors, ThrowOnError>;
20214
20297
  /**
package/dist/index.d.mts CHANGED
@@ -487,6 +487,16 @@ type Agent = {
487
487
  *
488
488
  */
489
489
  min_score?: number;
490
+ /**
491
+ * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
492
+ *
493
+ */
494
+ rrf_k?: number;
495
+ /**
496
+ * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
497
+ *
498
+ */
499
+ recency_half_life_days?: number;
490
500
  /**
491
501
  * Maximum number of results to inject. Omitted, 10 are injected.
492
502
  *
@@ -691,6 +701,16 @@ type CreateAgentRequest = {
691
701
  *
692
702
  */
693
703
  min_score?: number;
704
+ /**
705
+ * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
706
+ *
707
+ */
708
+ rrf_k?: number;
709
+ /**
710
+ * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
711
+ *
712
+ */
713
+ recency_half_life_days?: number;
694
714
  /**
695
715
  * Maximum number of results to inject. Omitted, 10 are injected.
696
716
  *
@@ -789,6 +809,16 @@ type UpdateAgentRequest = {
789
809
  *
790
810
  */
791
811
  min_score?: number;
812
+ /**
813
+ * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
814
+ *
815
+ */
816
+ rrf_k?: number;
817
+ /**
818
+ * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
819
+ *
820
+ */
821
+ recency_half_life_days?: number;
792
822
  /**
793
823
  * Maximum number of results to inject. Omitted, 10 are injected.
794
824
  *
@@ -883,7 +913,7 @@ type CreateAgentGenerationRequest = {
883
913
  [key: string]: unknown;
884
914
  } | null;
885
915
  /**
886
- * Per-generation knowledge retrieval override. Array filters (memory_store_ids, document_ids, document_paths) are unioned with the agent's stored knowledge_config; `tags` pairs are merged with the override winning per key; scalar fields (min_score, limit) use the per-generation value when present.
916
+ * Per-generation knowledge retrieval override. Array filters (memory_store_ids, document_ids, document_paths) are unioned with the agent's stored knowledge_config; `tags` pairs are merged with the override winning per key; scalar fields (min_score, rrf_k, recency_half_life_days, limit) use the per-generation value when present.
887
917
  */
888
918
  knowledge_config?: {
889
919
  memory_store_ids?: Array<string>;
@@ -898,6 +928,16 @@ type CreateAgentGenerationRequest = {
898
928
  *
899
929
  */
900
930
  min_score?: number;
931
+ /**
932
+ * The `k` in the fusion term `1 / (k + rank)`, the same knob knowledge search takes. Smaller weights the top of each ranking more heavily. Omitted, the deployment's `KNOWLEDGE_RRF_K` applies.
933
+ *
934
+ */
935
+ rrf_k?: number;
936
+ /**
937
+ * Half-life in days of the decay applied to **memory** results after fusion, the same knob knowledge search takes. `0` disables it. Omitted, the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` applies.
938
+ *
939
+ */
940
+ recency_half_life_days?: number;
901
941
  /**
902
942
  * Maximum number of results to inject. Omitted, 10 are injected.
903
943
  *
@@ -2439,9 +2479,17 @@ type AgentResourceProperties = {
2439
2479
  */
2440
2480
  tags?: TagBag;
2441
2481
  /**
2442
- * Minimum similarity score (0–1) for retrieved chunks
2482
+ * Minimum raw cosine similarity (0–1) a vector candidate must reach to be ranked. Omitted, there is no floor.
2443
2483
  */
2444
2484
  min_score?: number;
2485
+ /**
2486
+ * The `k` in the fusion term `1 / (k + rank)`; smaller weights the top of each ranking more heavily
2487
+ */
2488
+ rrf_k?: number;
2489
+ /**
2490
+ * Half-life in days of the decay applied to memory results after fusion; `0` disables it
2491
+ */
2492
+ recency_half_life_days?: number;
2445
2493
  /**
2446
2494
  * Maximum number of chunks to inject
2447
2495
  */
@@ -2915,6 +2963,12 @@ type TriggerResourceProperties = {
2915
2963
  input?: {
2916
2964
  [key: string]: unknown;
2917
2965
  } | null;
2966
+ /**
2967
+ * Caller context every firing forwards to the run it starts, so an agent whose tools authorize through `{{context:<key>}}` can be scheduled. Write-only. A value may be a `{{secret:...}}` reference, which is what a template should carry — the credential stays in the secret store and only its name is checked in
2968
+ */
2969
+ tool_context?: {
2970
+ [key: string]: string;
2971
+ } | null;
2918
2972
  /**
2919
2973
  * 5-field cron expression (UTC). Required when type is schedule
2920
2974
  */
@@ -5033,12 +5087,6 @@ type OrchestrationRun = {
5033
5087
  input?: {
5034
5088
  [key: string]: unknown;
5035
5089
  } | null;
5036
- /**
5037
- * The `tool_context` supplied at run creation, forwarded as `X-Soat-Context-<key>` headers on every tool call the run's agent nodes make. Null when the run was started without one.
5038
- */
5039
- tool_context?: {
5040
- [key: string]: string;
5041
- } | null;
5042
5090
  /**
5043
5091
  * The caller-owned key/value metadata supplied at run creation, returned verbatim. Null when the run was started without any. The server writes nothing here and no key is reserved; the bag is never merged into `state`, so nothing in it reaches the graph.
5044
5092
  */
@@ -5213,7 +5261,7 @@ type StartOrchestrationRunRequest = {
5213
5261
  /**
5214
5262
  * Key-value pairs forwarded as `X-Soat-Context-<key>` headers on every `http`, `mcp` and `builtin` tool call made by an agent node of this run — including the agents of any child run a `loop` or `sub_orchestration` node starts. The header name is `X-Soat-Context-` plus the key verbatim; no character is re-cased.
5215
5263
  *
5216
- * The bag is stored on the run and re-read on every step, so it survives an `awaiting_input` pause, a `sleeping` wait, a background worker drive and a crash redrive. A key that is not a valid HTTP header name, or two keys that map to the same header, are rejected with `400 INVALID_TOOL_CONTEXT_KEY` and no run is created.
5264
+ * The bag is stored on the run and re-read on every step, so it survives an `awaiting_input` pause, a `sleeping` wait, a background worker drive and a crash redrive. It is **write-only**: a run is a record every principal who may read runs can read, and a credential in it is not theirs to see, so it is never returned on one. A key that is not a valid HTTP header name, or two keys that map to the same header, are rejected with `400 INVALID_TOOL_CONTEXT_KEY` and no run is created.
5217
5265
  *
5218
5266
  * The reserved identity keys (`session_id`, `actor_id`, `actor_external_id`) are stripped at generation time — a caller cannot address them from here.
5219
5267
  */
@@ -5309,6 +5357,10 @@ type ProjectRecord = {
5309
5357
  * Whether `GET` requests naming this project are recorded in the audit log. `false` by default — v1 audits mutations only.
5310
5358
  */
5311
5359
  audit_reads_enabled?: boolean;
5360
+ /**
5361
+ * Whether a generation whose model carries no price row is refused with `409 MODEL_NOT_PRICED`. `false` by default, where an unpriced model runs and meters at `cost_usd: null`.
5362
+ */
5363
+ require_priced_model?: boolean;
5312
5364
  /**
5313
5365
  * What a conversation that names no `retrieval` of its own does. `none` by default.
5314
5366
  */
@@ -6327,6 +6379,17 @@ type CreateTriggerRequest = {
6327
6379
  input?: {
6328
6380
  [key: string]: unknown;
6329
6381
  };
6382
+ /**
6383
+ * Caller context every firing forwards to the run it starts, so an agent whose tools authorize through `{{context:<key>}}` can be put on a schedule — a firing has no request to carry one. Each key is forwarded as one `X-Soat-Context-<key>` header.
6384
+ *
6385
+ * **Write-only.** It is accepted here and never returned on a read, so the record cannot be used to recover a value.
6386
+ *
6387
+ * A value may be a `{{secret:...}}` reference, which keeps the credential in the [secret](/docs/modules/secrets) store and leaves only its name on the trigger; it is resolved at fire time, so rotating the secret changes the next firing without touching the trigger. A reference naming a secret that does not exist in this project is refused here rather than at fire time.
6388
+ *
6389
+ */
6390
+ tool_context?: {
6391
+ [key: string]: string;
6392
+ };
6330
6393
  /**
6331
6394
  * 5-field cron expression (UTC). Required when type is schedule
6332
6395
  */
@@ -6347,6 +6410,13 @@ type UpdateTriggerRequest = {
6347
6410
  input?: {
6348
6411
  [key: string]: unknown;
6349
6412
  } | null;
6413
+ /**
6414
+ * Replaces the stored bag; `null` clears it. Write-only and resolved at fire time — see `CreateTriggerRequest.tool_context`.
6415
+ *
6416
+ */
6417
+ tool_context?: {
6418
+ [key: string]: string;
6419
+ } | null;
6350
6420
  cron?: string | null;
6351
6421
  event_pattern?: string | null;
6352
6422
  active?: boolean;
@@ -6359,6 +6429,15 @@ type FireTriggerRequest = {
6359
6429
  input?: {
6360
6430
  [key: string]: unknown;
6361
6431
  };
6432
+ /**
6433
+ * Fire-time caller context, shallow-merged per key over the trigger's stored `tool_context`. A manual fire has a caller, so this is the one path that can supply a value without storing it.
6434
+ *
6435
+ * Forwarded exactly as written: a `{{secret:...}}` reference is resolved only in the trigger's stored bag, never in one supplied here.
6436
+ *
6437
+ */
6438
+ tool_context?: {
6439
+ [key: string]: string;
6440
+ };
6362
6441
  };
6363
6442
  type TriggerSecretResponse = {
6364
6443
  secret?: string;
@@ -15497,6 +15576,10 @@ type UpdateProjectData = {
15497
15576
  * Opt the project into read auditing. When true, `GET` requests that name this project are recorded in the audit log alongside mutations. Defaults to `false`.
15498
15577
  */
15499
15578
  audit_reads_enabled?: boolean;
15579
+ /**
15580
+ * Refuse a generation whose model carries no price row for every billable token component, with `409 MODEL_NOT_PRICED`. Defaults to `false`, where an unpriced model runs and meters at `cost_usd: null`. The check runs before the provider is called, so a refused turn spends nothing, and covers every target of a model route the turn may fail over to.
15581
+ */
15582
+ require_priced_model?: boolean;
15500
15583
  /**
15501
15584
  * What a conversation that names no `retrieval` of its own does. `none` by default: a turn is embedded because someone asked for the conversation to be retrievable, never merely because it was said. Turns are stored and chunked on both settings.
15502
15585
  */
@@ -20208,7 +20291,7 @@ export declare class Projects {
20208
20291
  /**
20209
20292
  * Update a project
20210
20293
  *
20211
- * Updates a project's name, its attached guardrails (`guardrail_ids` — the project-scope baseline governing every tool call by every agent in the project), its orchestration concurrency limit (`max_concurrent_runs`), its continuation-chain ceiling (`max_chain_generations`), its orchestration nesting bound (`max_orchestration_run_depth`), its inherited model route (`default_model_route_id`), its read-auditing opt-in (`audit_reads_enabled`), its trace-content retention window (`trace_content_retention_days`), and/or its zero-retention setting (`trace_content_mode`). At least one field is required. Requires admin role. Detaching a guardrail (removing an id) additionally requires guardrails:DetachGuardrail.
20294
+ * Updates a project's name, its attached guardrails (`guardrail_ids` — the project-scope baseline governing every tool call by every agent in the project), its orchestration concurrency limit (`max_concurrent_runs`), its continuation-chain ceiling (`max_chain_generations`), its orchestration nesting bound (`max_orchestration_run_depth`), its inherited model route (`default_model_route_id`), its read-auditing opt-in (`audit_reads_enabled`), its priced-model requirement (`require_priced_model`), its trace-content retention window (`trace_content_retention_days`), and/or its zero-retention setting (`trace_content_mode`). At least one field is required. Requires admin role. Detaching a guardrail (removing an id) additionally requires guardrails:DetachGuardrail.
20212
20295
  */
20213
20296
  static updateProject<ThrowOnError extends boolean = false>(options: Options<UpdateProjectData, ThrowOnError>): RequestResult<UpdateProjectResponses, UpdateProjectErrors, ThrowOnError>;
20214
20297
  /**
package/dist/index.mjs CHANGED
@@ -3364,7 +3364,7 @@ var Projects = class {
3364
3364
  /**
3365
3365
  * Update a project
3366
3366
  *
3367
- * Updates a project's name, its attached guardrails (`guardrail_ids` — the project-scope baseline governing every tool call by every agent in the project), its orchestration concurrency limit (`max_concurrent_runs`), its continuation-chain ceiling (`max_chain_generations`), its orchestration nesting bound (`max_orchestration_run_depth`), its inherited model route (`default_model_route_id`), its read-auditing opt-in (`audit_reads_enabled`), its trace-content retention window (`trace_content_retention_days`), and/or its zero-retention setting (`trace_content_mode`). At least one field is required. Requires admin role. Detaching a guardrail (removing an id) additionally requires guardrails:DetachGuardrail.
3367
+ * Updates a project's name, its attached guardrails (`guardrail_ids` — the project-scope baseline governing every tool call by every agent in the project), its orchestration concurrency limit (`max_concurrent_runs`), its continuation-chain ceiling (`max_chain_generations`), its orchestration nesting bound (`max_orchestration_run_depth`), its inherited model route (`default_model_route_id`), its read-auditing opt-in (`audit_reads_enabled`), its priced-model requirement (`require_priced_model`), its trace-content retention window (`trace_content_retention_days`), and/or its zero-retention setting (`trace_content_mode`). At least one field is required. Requires admin role. Detaching a guardrail (removing an id) additionally requires guardrails:DetachGuardrail.
3368
3368
  */
3369
3369
  static updateProject(options) {
3370
3370
  return (options.client ?? client).patch({
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@soat/sdk",
3
- "version": "0.56.0",
3
+ "version": "0.57.0",
4
4
  "description": "TypeScript SDK for SOAT — open-source infrastructure for production-ready AI agents.",
5
5
  "keywords": [
6
6
  "ai-agents",