@soat/sdk 0.47.0 → 0.48.0

package/dist/index.cjs

@@ -714,7 +714,7 @@ var Actors = class {
 	/**
 	* Merge actor tags
 	*
-	* Merges provided tags with existing tags (existing tags are preserved unless overridden)
+	* Merges provided tags into the actor's existing tags (existing tags are preserved unless overridden)
 	*/
 	static mergeActorTags(options) {
 		return (options.client ?? client).patch({
@@ -1475,7 +1475,7 @@ var Conversations = class {
 	/**
 	* Merge conversation tags
 	*
-	* Merges provided tags with existing tags
+	* Merges provided tags into the conversation's existing tags (existing tags are preserved unless overridden)
 	*/
 	static mergeConversationTags(options) {
 		return (options.client ?? client).patch({
@@ -1669,7 +1669,7 @@ var Documents = class {
 	/**
 	* Merge document tags
 	*
-	* Merges provided tags with existing tags (existing tags are preserved unless overridden)
+	* Merges provided tags into the document's existing tags (existing tags are preserved unless overridden)
 	*/
 	static mergeDocumentTags(options) {
 		return (options.client ?? client).patch({
@@ -2209,7 +2209,7 @@ var Files = class {
 	/**
 	* Merge file tags
 	*
-	* Merges provided tags with existing tags
+	* Merges provided tags into the file's existing tags (existing tags are preserved unless overridden)
 	*/
 	static mergeFileTags(options) {
 		return (options.client ?? client).patch({
@@ -2722,7 +2722,7 @@ var Memories = class {
 	/**
 	* Merge memory tags
 	*
-	* Merges provided tags with existing tags (existing tags are preserved unless overridden)
+	* Merges provided tags into the memory's existing tags (existing tags are preserved unless overridden)
 	*/
 	static mergeMemoryTags(options) {
 		return (options.client ?? client).patch({
@@ -2828,7 +2828,7 @@ var MemoryEntries = class {
 	/**
 	* Merge memory entry tags
 	*
-	* Merges provided tags with existing tags (existing tags are preserved unless overridden)
+	* Merges provided tags into the memory entry's existing tags (existing tags are preserved unless overridden)
 	*/
 	static mergeMemoryEntryTags(options) {
 		return (options.client ?? client).patch({

package/dist/index.d.cts

@@ -338,9 +338,9 @@ type ActivityEntry = {
   id?: string;
   project_id?: string;
   /**
-   * How the entry was produced
+   * How the entry was produced. `tool_resolution_failed` means a tool binding's source could not be reached (an unreachable MCP server, most often) and the turn ran without it — the generation itself completes, carrying no error, so this is the only signal that it answered with fewer tools than it was configured to have.
    */
-  kind?: 'action_executed' | 'approval_created' | 'approval_resolved' | 'exception_created' | 'schedule_fired';
+  kind?: 'action_executed' | 'approval_created' | 'approval_resolved' | 'exception_created' | 'schedule_fired' | 'tool_resolution_failed';
   severity?: 'info' | 'warning' | 'critical';
   /**
    * One-line, human-readable description
@@ -538,6 +538,15 @@ type Agent = {
   output_schema?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Prompt caching for this agent's turns. `{"enabled": true}` marks a cache breakpoint at the end of the turn's static prefix — the tool definitions and the instructions together — so a provider that caches by explicit breakpoint reads that prefix back on every later step of the turn and every later turn of the session instead of being charged for it again. Null or omitted is off: a cache write costs more than an uncached token, so an agent whose prefix is never re-read would pay for the privilege. An agent with no `instructions` has no block to mark and caches nothing. Cache reads are reported as `cached_tokens` and cache writes as `cache_write_tokens` on usage.
+   */
+  prompt_caching?: {
+    /**
+     * Whether the breakpoint is marked. Defaults to false.
+     */
+    enabled?: boolean;
+  } | null;
   /**
    * Maximum number of recent messages to include in the context window sent to the model. When null, all messages are included.
    */
@@ -752,6 +761,15 @@ type CreateAgentRequest = {
   output_schema?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Prompt caching for this agent's turns. `{"enabled": true}` marks a cache breakpoint at the end of the turn's static prefix — the tool definitions and the instructions together — so a provider that caches by explicit breakpoint reads that prefix back on every later step of the turn and every later turn of the session instead of being charged for it again. Null or omitted is off: a cache write costs more than an uncached token, so an agent whose prefix is never re-read would pay for the privilege. An agent with no `instructions` has no block to mark and caches nothing. Cache reads are reported as `cached_tokens` and cache writes as `cache_write_tokens` on usage.
+   */
+  prompt_caching?: {
+    /**
+     * Whether the breakpoint is marked. Defaults to false.
+     */
+    enabled?: boolean;
+  } | null;
   /**
    * Maximum number of recent messages included in the context window. Null means no limit.
    */
@@ -860,6 +878,15 @@ type UpdateAgentRequest = {
   output_schema?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Prompt caching for this agent's turns. `{"enabled": true}` marks a cache breakpoint at the end of the turn's static prefix — the tool definitions and the instructions together — so a provider that caches by explicit breakpoint reads that prefix back on every later step of the turn and every later turn of the session instead of being charged for it again. Null or omitted is off: a cache write costs more than an uncached token, so an agent whose prefix is never re-read would pay for the privilege. An agent with no `instructions` has no block to mark and caches nothing. Cache reads are reported as `cached_tokens` and cache writes as `cache_write_tokens` on usage.
+   */
+  prompt_caching?: {
+    /**
+     * Whether the breakpoint is marked. Defaults to false.
+     */
+    enabled?: boolean;
+  } | null;
   /**
    * Maximum number of recent messages included in the context window. Null means no limit.
    */
@@ -1095,7 +1122,7 @@ type ProviderPrice = {
   provider?: string;
   model?: string;
   /**
-   * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`)
+   * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`, `cache_write_tokens`)
    */
   component?: string;
   /**
@@ -1119,7 +1146,7 @@ type UpsertProviderPricesRequest = {
   prices: Array<{
     model: string;
     /**
-     * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`)
+     * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`, `cache_write_tokens`)
      */
     component: string;
     /**
@@ -2399,6 +2426,15 @@ type AgentResourceProperties = {
   output_schema?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Prompt caching for this agent's turns. `{"enabled": true}` marks a cache breakpoint at the end of the turn's static prefix — the tool definitions and the instructions together. Null or omitted is off.
+   */
+  prompt_caching?: {
+    /**
+     * Whether the breakpoint is marked. Defaults to false.
+     */
+    enabled?: boolean;
+  } | null;
 };
 /**
  * Creates a stateful conversation actor that wraps an agent or chat session and optionally links to a memory store.
@@ -2928,7 +2964,7 @@ type ProjectPriceResourceProperties = {
    */
   model: string;
   /**
-   * The billable component this row prices (input_tokens, output_tokens, cached_tokens, compute_second, …)
+   * The billable component this row prices (input_tokens, output_tokens, cached_tokens, cache_write_tokens, compute_second, …)
    */
   component: string;
   /**
@@ -4770,11 +4806,18 @@ type UsageTotals = {
    */
   cost_usd?: number | null;
   /**
-   * Full prompt tokens (uncached input + cached), reconstructed from components
+   * Full prompt tokens — uncached input + `cached_tokens` + `cache_write_tokens` — reconstructed from components.
    */
   input_tokens?: number;
   output_tokens?: number;
+  /**
+   * Prompt tokens served from the provider's prompt cache.
+   */
   cached_tokens?: number;
+  /**
+   * Prompt tokens written into the provider's prompt cache.
+   */
+  cache_write_tokens?: number;
   reasoning_tokens?: number;
 };
 /**
@@ -5007,7 +5050,7 @@ type ProjectPrice = {
   provider?: string;
   model?: string;
   /**
-   * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`)
+   * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`, `cache_write_tokens`)
    */
   component?: string;
   /**
@@ -5032,7 +5075,7 @@ type UpsertProjectPricesRequest = {
     provider: string;
     model: string;
     /**
-     * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`)
+     * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`, `cache_write_tokens`)
      */
     component: string;
     /**
@@ -6013,7 +6056,9 @@ type TriggerFiringListResponse = {
   offset?: number;
 };
 /**
- * One priced dimension of a usage event. Every meter type is expressed as components, so tokens and infra are uniform: an `llm_tokens` event has `input_tokens` / `output_tokens` (+ `cached_tokens`, and a non-billable `reasoning_tokens` detail), a `compute_execution` event has one `compute_second` component.
+ * One priced dimension of a usage event. Every meter type is expressed as components, so tokens and infra are uniform: an `llm_tokens` event has `input_tokens` / `output_tokens` (+ `cached_tokens` for prompt-cache reads, `cache_write_tokens` for prompt-cache writes, and a non-billable `reasoning_tokens` detail), a `compute_execution` event has one `compute_second` component.
+ *
+ * The three input dimensions are disjoint and partition the provider's reported prompt tokens: `input_tokens` is the uncached input **alone**. They are separate components because they are separately priced — a cache read costs a fraction of an uncached token and a cache write costs more than one. A dimension with no price row of its own falls back to the `input_tokens` rate, never to zero.
  *
  */
 type UsageComponent = {
@@ -6161,7 +6206,7 @@ type UsageDistinct = {
  */
 type UsageAggregateComponent = {
   /**
-   * The measured dimension: `input_tokens`, `cached_tokens`, `output_tokens`, `reasoning_tokens`, `compute_second`, `request`, `gb_day`, `chunk_count`, …
+   * The measured dimension: `input_tokens`, `cached_tokens`, `cache_write_tokens`, `output_tokens`, `reasoning_tokens`, `compute_second`, `request`, `gb_day`, `chunk_count`, …
    *
    */
   component?: string;
@@ -6711,7 +6756,7 @@ type ListActivityData = {
     /**
      * Filter by activity kind
      */
-    kind?: 'action_executed' | 'approval_created' | 'approval_resolved' | 'exception_created' | 'schedule_fired';
+    kind?: 'action_executed' | 'approval_created' | 'approval_resolved' | 'exception_created' | 'schedule_fired' | 'tool_resolution_failed';
     /**
      * Filter by severity
      */
@@ -17912,7 +17957,7 @@ declare class Actors {
   /**
    * Merge actor tags
    *
-   * Merges provided tags with existing tags (existing tags are preserved unless overridden)
+   * Merges provided tags into the actor's existing tags (existing tags are preserved unless overridden)
    */
   static mergeActorTags<ThrowOnError extends boolean = false>(options: Options<MergeActorTagsData, ThrowOnError>): RequestResult<MergeActorTagsResponses, MergeActorTagsErrors, ThrowOnError>;
   /**
@@ -18311,7 +18356,7 @@ declare class Conversations {
   /**
    * Merge conversation tags
    *
-   * Merges provided tags with existing tags
+   * Merges provided tags into the conversation's existing tags (existing tags are preserved unless overridden)
    */
   static mergeConversationTags<ThrowOnError extends boolean = false>(options: Options<MergeConversationTagsData, ThrowOnError>): RequestResult<MergeConversationTagsResponses, MergeConversationTagsErrors, ThrowOnError>;
   /**
@@ -18417,7 +18462,7 @@ declare class Documents {
   /**
    * Merge document tags
    *
-   * Merges provided tags with existing tags (existing tags are preserved unless overridden)
+   * Merges provided tags into the document's existing tags (existing tags are preserved unless overridden)
    */
   static mergeDocumentTags<ThrowOnError extends boolean = false>(options: Options<MergeDocumentTagsData, ThrowOnError>): RequestResult<MergeDocumentTagsResponses, MergeDocumentTagsErrors, ThrowOnError>;
   /**
@@ -18689,7 +18734,7 @@ declare class Files {
   /**
    * Merge file tags
    *
-   * Merges provided tags with existing tags
+   * Merges provided tags into the file's existing tags (existing tags are preserved unless overridden)
    */
   static mergeFileTags<ThrowOnError extends boolean = false>(options: Options<MergeFileTagsData, ThrowOnError>): RequestResult<MergeFileTagsResponses, MergeFileTagsErrors, ThrowOnError>;
   /**
@@ -18958,7 +19003,7 @@ declare class Memories {
   /**
    * Merge memory tags
    *
-   * Merges provided tags with existing tags (existing tags are preserved unless overridden)
+   * Merges provided tags into the memory's existing tags (existing tags are preserved unless overridden)
    */
   static mergeMemoryTags<ThrowOnError extends boolean = false>(options: Options<MergeMemoryTagsData, ThrowOnError>): RequestResult<MergeMemoryTagsResponses, MergeMemoryTagsErrors, ThrowOnError>;
   /**
@@ -19008,7 +19053,7 @@ declare class MemoryEntries {
   /**
    * Merge memory entry tags
    *
-   * Merges provided tags with existing tags (existing tags are preserved unless overridden)
+   * Merges provided tags into the memory entry's existing tags (existing tags are preserved unless overridden)
    */
   static mergeMemoryEntryTags<ThrowOnError extends boolean = false>(options: Options<MergeMemoryEntryTagsData, ThrowOnError>): RequestResult<MergeMemoryEntryTagsResponses, MergeMemoryEntryTagsErrors, ThrowOnError>;
   /**

package/dist/index.d.mts

@@ -338,9 +338,9 @@ type ActivityEntry = {
   id?: string;
   project_id?: string;
   /**
-   * How the entry was produced
+   * How the entry was produced. `tool_resolution_failed` means a tool binding's source could not be reached (an unreachable MCP server, most often) and the turn ran without it — the generation itself completes, carrying no error, so this is the only signal that it answered with fewer tools than it was configured to have.
    */
-  kind?: 'action_executed' | 'approval_created' | 'approval_resolved' | 'exception_created' | 'schedule_fired';
+  kind?: 'action_executed' | 'approval_created' | 'approval_resolved' | 'exception_created' | 'schedule_fired' | 'tool_resolution_failed';
   severity?: 'info' | 'warning' | 'critical';
   /**
    * One-line, human-readable description
@@ -538,6 +538,15 @@ type Agent = {
   output_schema?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Prompt caching for this agent's turns. `{"enabled": true}` marks a cache breakpoint at the end of the turn's static prefix — the tool definitions and the instructions together — so a provider that caches by explicit breakpoint reads that prefix back on every later step of the turn and every later turn of the session instead of being charged for it again. Null or omitted is off: a cache write costs more than an uncached token, so an agent whose prefix is never re-read would pay for the privilege. An agent with no `instructions` has no block to mark and caches nothing. Cache reads are reported as `cached_tokens` and cache writes as `cache_write_tokens` on usage.
+   */
+  prompt_caching?: {
+    /**
+     * Whether the breakpoint is marked. Defaults to false.
+     */
+    enabled?: boolean;
+  } | null;
   /**
    * Maximum number of recent messages to include in the context window sent to the model. When null, all messages are included.
    */
@@ -752,6 +761,15 @@ type CreateAgentRequest = {
   output_schema?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Prompt caching for this agent's turns. `{"enabled": true}` marks a cache breakpoint at the end of the turn's static prefix — the tool definitions and the instructions together — so a provider that caches by explicit breakpoint reads that prefix back on every later step of the turn and every later turn of the session instead of being charged for it again. Null or omitted is off: a cache write costs more than an uncached token, so an agent whose prefix is never re-read would pay for the privilege. An agent with no `instructions` has no block to mark and caches nothing. Cache reads are reported as `cached_tokens` and cache writes as `cache_write_tokens` on usage.
+   */
+  prompt_caching?: {
+    /**
+     * Whether the breakpoint is marked. Defaults to false.
+     */
+    enabled?: boolean;
+  } | null;
   /**
    * Maximum number of recent messages included in the context window. Null means no limit.
    */
@@ -860,6 +878,15 @@ type UpdateAgentRequest = {
   output_schema?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Prompt caching for this agent's turns. `{"enabled": true}` marks a cache breakpoint at the end of the turn's static prefix — the tool definitions and the instructions together — so a provider that caches by explicit breakpoint reads that prefix back on every later step of the turn and every later turn of the session instead of being charged for it again. Null or omitted is off: a cache write costs more than an uncached token, so an agent whose prefix is never re-read would pay for the privilege. An agent with no `instructions` has no block to mark and caches nothing. Cache reads are reported as `cached_tokens` and cache writes as `cache_write_tokens` on usage.
+   */
+  prompt_caching?: {
+    /**
+     * Whether the breakpoint is marked. Defaults to false.
+     */
+    enabled?: boolean;
+  } | null;
   /**
    * Maximum number of recent messages included in the context window. Null means no limit.
    */
@@ -1095,7 +1122,7 @@ type ProviderPrice = {
   provider?: string;
   model?: string;
   /**
-   * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`)
+   * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`, `cache_write_tokens`)
    */
   component?: string;
   /**
@@ -1119,7 +1146,7 @@ type UpsertProviderPricesRequest = {
   prices: Array<{
     model: string;
     /**
-     * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`)
+     * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`, `cache_write_tokens`)
      */
     component: string;
     /**
@@ -2399,6 +2426,15 @@ type AgentResourceProperties = {
   output_schema?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Prompt caching for this agent's turns. `{"enabled": true}` marks a cache breakpoint at the end of the turn's static prefix — the tool definitions and the instructions together. Null or omitted is off.
+   */
+  prompt_caching?: {
+    /**
+     * Whether the breakpoint is marked. Defaults to false.
+     */
+    enabled?: boolean;
+  } | null;
 };
 /**
  * Creates a stateful conversation actor that wraps an agent or chat session and optionally links to a memory store.
@@ -2928,7 +2964,7 @@ type ProjectPriceResourceProperties = {
    */
   model: string;
   /**
-   * The billable component this row prices (input_tokens, output_tokens, cached_tokens, compute_second, …)
+   * The billable component this row prices (input_tokens, output_tokens, cached_tokens, cache_write_tokens, compute_second, …)
    */
   component: string;
   /**
@@ -4770,11 +4806,18 @@ type UsageTotals = {
    */
   cost_usd?: number | null;
   /**
-   * Full prompt tokens (uncached input + cached), reconstructed from components
+   * Full prompt tokens — uncached input + `cached_tokens` + `cache_write_tokens` — reconstructed from components.
    */
   input_tokens?: number;
   output_tokens?: number;
+  /**
+   * Prompt tokens served from the provider's prompt cache.
+   */
   cached_tokens?: number;
+  /**
+   * Prompt tokens written into the provider's prompt cache.
+   */
+  cache_write_tokens?: number;
   reasoning_tokens?: number;
 };
 /**
@@ -5007,7 +5050,7 @@ type ProjectPrice = {
   provider?: string;
   model?: string;
   /**
-   * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`)
+   * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`, `cache_write_tokens`)
    */
   component?: string;
   /**
@@ -5032,7 +5075,7 @@ type UpsertProjectPricesRequest = {
     provider: string;
     model: string;
     /**
-     * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`)
+     * The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`, `cache_write_tokens`)
      */
     component: string;
     /**
@@ -6013,7 +6056,9 @@ type TriggerFiringListResponse = {
   offset?: number;
 };
 /**
- * One priced dimension of a usage event. Every meter type is expressed as components, so tokens and infra are uniform: an `llm_tokens` event has `input_tokens` / `output_tokens` (+ `cached_tokens`, and a non-billable `reasoning_tokens` detail), a `compute_execution` event has one `compute_second` component.
+ * One priced dimension of a usage event. Every meter type is expressed as components, so tokens and infra are uniform: an `llm_tokens` event has `input_tokens` / `output_tokens` (+ `cached_tokens` for prompt-cache reads, `cache_write_tokens` for prompt-cache writes, and a non-billable `reasoning_tokens` detail), a `compute_execution` event has one `compute_second` component.
+ *
+ * The three input dimensions are disjoint and partition the provider's reported prompt tokens: `input_tokens` is the uncached input **alone**. They are separate components because they are separately priced — a cache read costs a fraction of an uncached token and a cache write costs more than one. A dimension with no price row of its own falls back to the `input_tokens` rate, never to zero.
  *
  */
 type UsageComponent = {
@@ -6161,7 +6206,7 @@ type UsageDistinct = {
  */
 type UsageAggregateComponent = {
   /**
-   * The measured dimension: `input_tokens`, `cached_tokens`, `output_tokens`, `reasoning_tokens`, `compute_second`, `request`, `gb_day`, `chunk_count`, …
+   * The measured dimension: `input_tokens`, `cached_tokens`, `cache_write_tokens`, `output_tokens`, `reasoning_tokens`, `compute_second`, `request`, `gb_day`, `chunk_count`, …
    *
    */
   component?: string;
@@ -6711,7 +6756,7 @@ type ListActivityData = {
     /**
      * Filter by activity kind
      */
-    kind?: 'action_executed' | 'approval_created' | 'approval_resolved' | 'exception_created' | 'schedule_fired';
+    kind?: 'action_executed' | 'approval_created' | 'approval_resolved' | 'exception_created' | 'schedule_fired' | 'tool_resolution_failed';
     /**
      * Filter by severity
      */
@@ -17912,7 +17957,7 @@ declare class Actors {
   /**
    * Merge actor tags
    *
-   * Merges provided tags with existing tags (existing tags are preserved unless overridden)
+   * Merges provided tags into the actor's existing tags (existing tags are preserved unless overridden)
    */
   static mergeActorTags<ThrowOnError extends boolean = false>(options: Options<MergeActorTagsData, ThrowOnError>): RequestResult<MergeActorTagsResponses, MergeActorTagsErrors, ThrowOnError>;
   /**
@@ -18311,7 +18356,7 @@ declare class Conversations {
   /**
    * Merge conversation tags
    *
-   * Merges provided tags with existing tags
+   * Merges provided tags into the conversation's existing tags (existing tags are preserved unless overridden)
    */
   static mergeConversationTags<ThrowOnError extends boolean = false>(options: Options<MergeConversationTagsData, ThrowOnError>): RequestResult<MergeConversationTagsResponses, MergeConversationTagsErrors, ThrowOnError>;
   /**
@@ -18417,7 +18462,7 @@ declare class Documents {
   /**
    * Merge document tags
    *
-   * Merges provided tags with existing tags (existing tags are preserved unless overridden)
+   * Merges provided tags into the document's existing tags (existing tags are preserved unless overridden)
    */
   static mergeDocumentTags<ThrowOnError extends boolean = false>(options: Options<MergeDocumentTagsData, ThrowOnError>): RequestResult<MergeDocumentTagsResponses, MergeDocumentTagsErrors, ThrowOnError>;
   /**
@@ -18689,7 +18734,7 @@ declare class Files {
   /**
    * Merge file tags
    *
-   * Merges provided tags with existing tags
+   * Merges provided tags into the file's existing tags (existing tags are preserved unless overridden)
    */
   static mergeFileTags<ThrowOnError extends boolean = false>(options: Options<MergeFileTagsData, ThrowOnError>): RequestResult<MergeFileTagsResponses, MergeFileTagsErrors, ThrowOnError>;
   /**
@@ -18958,7 +19003,7 @@ declare class Memories {
   /**
    * Merge memory tags
    *
-   * Merges provided tags with existing tags (existing tags are preserved unless overridden)
+   * Merges provided tags into the memory's existing tags (existing tags are preserved unless overridden)
    */
   static mergeMemoryTags<ThrowOnError extends boolean = false>(options: Options<MergeMemoryTagsData, ThrowOnError>): RequestResult<MergeMemoryTagsResponses, MergeMemoryTagsErrors, ThrowOnError>;
   /**
@@ -19008,7 +19053,7 @@ declare class MemoryEntries {
   /**
    * Merge memory entry tags
    *
-   * Merges provided tags with existing tags (existing tags are preserved unless overridden)
+   * Merges provided tags into the memory entry's existing tags (existing tags are preserved unless overridden)
    */
   static mergeMemoryEntryTags<ThrowOnError extends boolean = false>(options: Options<MergeMemoryEntryTagsData, ThrowOnError>): RequestResult<MergeMemoryEntryTagsResponses, MergeMemoryEntryTagsErrors, ThrowOnError>;
   /**

package/dist/index.mjs

@@ -713,7 +713,7 @@ var Actors = class {
 	/**
 	* Merge actor tags
 	*
-	* Merges provided tags with existing tags (existing tags are preserved unless overridden)
+	* Merges provided tags into the actor's existing tags (existing tags are preserved unless overridden)
 	*/
 	static mergeActorTags(options) {
 		return (options.client ?? client).patch({
@@ -1474,7 +1474,7 @@ var Conversations = class {
 	/**
 	* Merge conversation tags
 	*
-	* Merges provided tags with existing tags
+	* Merges provided tags into the conversation's existing tags (existing tags are preserved unless overridden)
 	*/
 	static mergeConversationTags(options) {
 		return (options.client ?? client).patch({
@@ -1668,7 +1668,7 @@ var Documents = class {
 	/**
 	* Merge document tags
 	*
-	* Merges provided tags with existing tags (existing tags are preserved unless overridden)
+	* Merges provided tags into the document's existing tags (existing tags are preserved unless overridden)
 	*/
 	static mergeDocumentTags(options) {
 		return (options.client ?? client).patch({
@@ -2208,7 +2208,7 @@ var Files = class {
 	/**
 	* Merge file tags
 	*
-	* Merges provided tags with existing tags
+	* Merges provided tags into the file's existing tags (existing tags are preserved unless overridden)
 	*/
 	static mergeFileTags(options) {
 		return (options.client ?? client).patch({
@@ -2721,7 +2721,7 @@ var Memories = class {
 	/**
 	* Merge memory tags
 	*
-	* Merges provided tags with existing tags (existing tags are preserved unless overridden)
+	* Merges provided tags into the memory's existing tags (existing tags are preserved unless overridden)
 	*/
 	static mergeMemoryTags(options) {
 		return (options.client ?? client).patch({
@@ -2827,7 +2827,7 @@ var MemoryEntries = class {
 	/**
 	* Merge memory entry tags
 	*
-	* Merges provided tags with existing tags (existing tags are preserved unless overridden)
+	* Merges provided tags into the memory entry's existing tags (existing tags are preserved unless overridden)
 	*/
 	static mergeMemoryEntryTags(options) {
 		return (options.client ?? client).patch({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/sdk",
-  "version": "0.47.0",
+  "version": "0.48.0",
   "description": "TypeScript SDK for SOAT — open-source infrastructure for production-ready AI agents.",
   "keywords": [
     "ai-agents",