@naturali/cli 0.127.0 → 0.127.2

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.127.0";
+var version = "0.127.2";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -725,7 +725,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({
@@ -1943,7 +1943,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({
@@ -2113,7 +2113,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({
@@ -2623,7 +2623,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({
@@ -3045,7 +3045,7 @@ var Knowledge = class {
 	/**
 	* Search knowledge
 	*
-	* Searches across documents and memory entries using semantic search, file paths, document IDs, or memory IDs/tags. At least one of `query`, `document_paths`, `document_ids`, `memory_ids`, or `memory_tags` must be provided.
+	* Searches across documents and memory entries using semantic search, file paths, document IDs, memory IDs, or tags. At least one of `query`, `tags`, `document_paths`, `document_ids`, or `memory_ids` must be provided.
 	*/
 	static searchKnowledge(options) {
 		return (options.client ?? client).post({
@@ -3122,6 +3122,47 @@ var Memories = class {
 			}
 		});
 	}
+	/**
+	* Get memory tags
+	*
+	* Returns all tags attached to the memory
+	*/
+	static getMemoryTags(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/memories/{memory_id}/tags",
+			...options
+		});
+	}
+	/**
+	* Merge memory tags
+	*
+	* Merges provided tags into the memory's existing tags (existing tags are preserved unless overridden)
+	*/
+	static mergeMemoryTags(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/memories/{memory_id}/tags",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Replace memory tags
+	*
+	* Replaces all tags on the memory with the provided tags (not merged)
+	*/
+	static replaceMemoryTags(options) {
+		return (options.client ?? client).put({
+			url: "/v1/projects/{project_id}/memories/{memory_id}/tags",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
 };
 var MemoryEntries = class {
 	/**
@@ -3187,6 +3228,47 @@ var MemoryEntries = class {
 			}
 		});
 	}
+	/**
+	* Get memory entry tags
+	*
+	* Returns all tags attached to the memory entry
+	*/
+	static getMemoryEntryTags(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/memory-entries/{entry_id}/tags",
+			...options
+		});
+	}
+	/**
+	* Merge memory entry tags
+	*
+	* Merges provided tags into the memory entry's existing tags (existing tags are preserved unless overridden)
+	*/
+	static mergeMemoryEntryTags(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/memory-entries/{entry_id}/tags",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Replace memory entry tags
+	*
+	* Replaces all tags on the memory entry with the provided tags (not merged)
+	*/
+	static replaceMemoryEntryTags(options) {
+		return (options.client ?? client).put({
+			url: "/v1/projects/{project_id}/memory-entries/{entry_id}/tags",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
 };
 var ModelRoutes = class {
 	/**
@@ -5405,6 +5487,7 @@ const routes = {
 			"agent_id",
 			"chat_id",
 			"conversation_id",
+			"tags",
 			"limit",
 			"offset"
 		],
@@ -5451,6 +5534,13 @@ const routes = {
 				"type": "string",
 				"in": "query"
 			},
+			{
+				"name": "tags",
+				"description": "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.\n",
+				"required": false,
+				"type": "array",
+				"in": "query"
+			},
 			{
 				"name": "limit",
 				"description": "Maximum number of results to return",
@@ -5602,7 +5692,7 @@ const routes = {
 			},
 			{
 				"name": "tags",
-				"description": "",
+				"description": "Key-value labels on a resource. A flat object of string values — an array, a nested object or a number is rejected with `400 VALIDATION_FAILED`, never coerced. Keys are opaque and stored verbatim, so `cost_center` and `costCenter` are two different tags. Matched by JSONB containment wherever tags are read: the `?tags=` filter and knowledge search.",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -5678,7 +5768,7 @@ const routes = {
 	"merge-actor-tags": {
 		serviceClass: "Actors",
 		operationId: "mergeActorTags",
-		description: "Merges provided tags with existing tags (existing tags are preserved unless overridden)",
+		description: "Merges provided tags into the actor's existing tags (existing tags are preserved unless overridden)",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/actors",
 		httpMethod: "patch",
 		pathParams: ["project_id", "actor_id"],
@@ -6256,6 +6346,13 @@ const routes = {
 				"type": "object",
 				"in": "body"
 			},
+			{
+				"name": "prompt_caching",
+				"description": "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.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
 			{
 				"name": "max_context_messages",
 				"description": "Maximum number of recent messages included in the context window. Null means no limit.",
@@ -6450,6 +6547,13 @@ const routes = {
 				"type": "object",
 				"in": "body"
 			},
+			{
+				"name": "prompt_caching",
+				"description": "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.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
 			{
 				"name": "max_context_messages",
 				"description": "Maximum number of recent messages included in the context window. Null means no limit.",
@@ -6622,6 +6726,13 @@ const routes = {
 				"type": "object",
 				"in": "body"
 			},
+			{
+				"name": "prompt_caching",
+				"description": "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.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
 			{
 				"name": "max_context_messages",
 				"description": "Maximum number of recent messages included in the context window. Null means no limit.",
@@ -6800,7 +6911,7 @@ const routes = {
 			},
 			{
 				"name": "knowledge_config",
-				"description": "Per-generation knowledge retrieval override. Array filters (memory_ids, memory_tags, document_ids, document_paths) are unioned with the agent's stored knowledge_config; scalar fields (min_score, limit) use the per-generation value when present.",
+				"description": "Per-generation knowledge retrieval override. Array filters (memory_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.",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -8835,6 +8946,7 @@ const routes = {
 		pathParams: ["project_id"],
 		queryParams: [
 			"actor_id",
+			"tags",
 			"limit",
 			"offset"
 		],
@@ -8853,6 +8965,13 @@ const routes = {
 				"type": "string",
 				"in": "query"
 			},
+			{
+				"name": "tags",
+				"description": "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.\n",
+				"required": false,
+				"type": "array",
+				"in": "query"
+			},
 			{
 				"name": "limit",
 				"description": "Maximum number of results to return",
@@ -9233,7 +9352,7 @@ const routes = {
 	"merge-conversation-tags": {
 		serviceClass: "Conversations",
 		operationId: "mergeConversationTags",
-		description: "Merges provided tags with existing tags",
+		description: "Merges provided tags into the conversation's existing tags (existing tags are preserved unless overridden)",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/conversations",
 		httpMethod: "patch",
 		pathParams: ["project_id", "conversation_id"],
@@ -9261,6 +9380,7 @@ const routes = {
 		pathParams: ["project_id"],
 		queryParams: [
 			"path_prefix",
+			"tags",
 			"limit",
 			"offset"
 		],
@@ -9279,6 +9399,13 @@ const routes = {
 				"type": "string",
 				"in": "query"
 			},
+			{
+				"name": "tags",
+				"description": "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.\n",
+				"required": false,
+				"type": "array",
+				"in": "query"
+			},
 			{
 				"name": "limit",
 				"description": "Maximum number of results to return",
@@ -9348,7 +9475,7 @@ const routes = {
 			},
 			{
 				"name": "tags",
-				"description": "Key-value tags",
+				"description": "Key-value labels on a resource. A flat object of string values — an array, a nested object or a number is rejected with `400 VALIDATION_FAILED`, never coerced. Keys are opaque and stored verbatim, so `cost_center` and `costCenter` are two different tags. Matched by JSONB containment wherever tags are read: the `?tags=` filter and knowledge search.",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -9415,7 +9542,7 @@ const routes = {
 			},
 			{
 				"name": "tags",
-				"description": "Key-value tags to attach to the document.",
+				"description": "Key-value labels on a resource. A flat object of string values — an array, a nested object or a number is rejected with `400 VALIDATION_FAILED`, never coerced. Keys are opaque and stored verbatim, so `cost_center` and `costCenter` are two different tags. Matched by JSONB containment wherever tags are read: the `?tags=` filter and knowledge search.",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -9518,7 +9645,7 @@ const routes = {
 			},
 			{
 				"name": "tags",
-				"description": "Key-value tags",
+				"description": "Key-value labels on a resource. A flat object of string values — an array, a nested object or a number is rejected with `400 VALIDATION_FAILED`, never coerced. Keys are opaque and stored verbatim, so `cost_center` and `costCenter` are two different tags. Matched by JSONB containment wherever tags are read: the `?tags=` filter and knowledge search.",
 				"required": false,
 				"type": "object",
 				"in": "body"
@@ -9669,7 +9796,7 @@ const routes = {
 	"merge-document-tags": {
 		serviceClass: "Documents",
 		operationId: "mergeDocumentTags",
-		description: "Merges provided tags with existing tags (existing tags are preserved unless overridden)",
+		description: "Merges provided tags into the document's existing tags (existing tags are preserved unless overridden)",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/documents",
 		httpMethod: "patch",
 		pathParams: ["project_id", "document_id"],
@@ -10643,7 +10770,11 @@ const routes = {
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
 		httpMethod: "get",
 		pathParams: ["project_id"],
-		queryParams: ["limit", "offset"],
+		queryParams: [
+			"tags",
+			"limit",
+			"offset"
+		],
 		flags: [
 			{
 				"name": "project_id",
@@ -10652,6 +10783,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "tags",
+				"description": "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.\n",
+				"required": false,
+				"type": "array",
+				"in": "query"
+			},
 			{
 				"name": "limit",
 				"description": "Maximum number of results to return",
@@ -10991,7 +11129,7 @@ const routes = {
 	"merge-file-tags": {
 		serviceClass: "Files",
 		operationId: "mergeFileTags",
-		description: "Merges provided tags with existing tags",
+		description: "Merges provided tags into the file's existing tags (existing tags are preserved unless overridden)",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/files",
 		httpMethod: "patch",
 		pathParams: ["project_id", "file_id"],
@@ -12136,7 +12274,7 @@ const routes = {
 	"search-knowledge": {
 		serviceClass: "Knowledge",
 		operationId: "searchKnowledge",
-		description: "Searches across documents and memory entries using semantic search, file paths, document IDs, or memory IDs/tags. At least one of `query`, `document_paths`, `document_ids`, `memory_ids`, or `memory_tags` must be provided.",
+		description: "Searches across documents and memory entries using semantic search, file paths, document IDs, memory IDs, or tags. At least one of `query`, `tags`, `document_paths`, `document_ids`, or `memory_ids` must be provided.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/knowledge",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -12177,13 +12315,6 @@ const routes = {
 				"type": "array",
 				"in": "body"
 			},
-			{
-				"name": "memory_tags",
-				"description": "Search entries in memories whose tags match any of these patterns (glob supported)",
-				"required": false,
-				"type": "array",
-				"in": "body"
-			},
 			{
 				"name": "document_paths",
 				"description": "Filter results to documents whose file path starts with one of these prefixes",
@@ -12197,6 +12328,13 @@ const routes = {
 				"required": false,
 				"type": "array",
 				"in": "body"
+			},
+			{
+				"name": "tags",
+				"description": "Filter results to documents and memory entries whose `tags` contain every one of these key-value pairs (exact, case-sensitive match). The only filter that scopes both stores, so passing it alone searches both. For memory it matches at entry granularity: an entry is returned when its parent memory's tags match or its own do.",
+				"required": false,
+				"type": "string",
+				"in": "body"
 			}
 		]
 	},
@@ -12222,7 +12360,7 @@ const routes = {
 			},
 			{
 				"name": "tags",
-				"description": "Filter memories by tag patterns. Supports glob syntax (`*` matches any substring, `?` matches any single character). Multiple values are ORed — a memory is returned if any of its tags match any of the provided patterns. Omit to return all memories.\n",
+				"description": "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.\n",
 				"required": false,
 				"type": "array",
 				"in": "query"
@@ -12275,9 +12413,9 @@ const routes = {
 			},
 			{
 				"name": "tags",
-				"description": "Optional list of tags for filtering in knowledge search",
+				"description": "Optional key-value tags. Scopes the memory in knowledge search, where every requested pair must match exactly.",
 				"required": false,
-				"type": "array",
+				"type": "string",
 				"in": "body"
 			}
 		]
@@ -12343,9 +12481,9 @@ const routes = {
 			},
 			{
 				"name": "tags",
-				"description": "Optional list of tags for filtering in knowledge search",
+				"description": "Optional key-value tags. Replaces the stored bag; `null` clears it.",
 				"required": false,
-				"type": "array",
+				"type": "string",
 				"in": "body"
 			}
 		]
@@ -12372,6 +12510,72 @@ const routes = {
 			"in": "path"
 		}]
 	},
+	"get-memory-tags": {
+		serviceClass: "Memories",
+		operationId: "getMemoryTags",
+		description: "Returns all tags attached to the memory",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memories",
+		httpMethod: "get",
+		pathParams: ["project_id", "memory_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "memory_id",
+			"description": "Memory ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"replace-memory-tags": {
+		serviceClass: "Memories",
+		operationId: "replaceMemoryTags",
+		description: "Replaces all tags on the memory with the provided tags (not merged)",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memories",
+		httpMethod: "put",
+		pathParams: ["project_id", "memory_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "memory_id",
+			"description": "Memory ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"merge-memory-tags": {
+		serviceClass: "Memories",
+		operationId: "mergeMemoryTags",
+		description: "Merges provided tags into the memory's existing tags (existing tags are preserved unless overridden)",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memories",
+		httpMethod: "patch",
+		pathParams: ["project_id", "memory_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "memory_id",
+			"description": "Memory ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"list-memory-entries": {
 		serviceClass: "MemoryEntries",
 		operationId: "listMemoryEntries",
@@ -12381,6 +12585,7 @@ const routes = {
 		pathParams: ["project_id"],
 		queryParams: [
 			"memory_id",
+			"tags",
 			"limit",
 			"offset",
 			"include_invalidated"
@@ -12400,6 +12605,13 @@ const routes = {
 				"type": "string",
 				"in": "query"
 			},
+			{
+				"name": "tags",
+				"description": "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.\n",
+				"required": false,
+				"type": "array",
+				"in": "query"
+			},
 			{
 				"name": "limit",
 				"description": "Maximum number of results to return",
@@ -12462,9 +12674,9 @@ const routes = {
 			},
 			{
 				"name": "tags",
-				"description": "Per-entry tag strings, used for entry-granularity filtering in search-knowledge (memory_tags)",
+				"description": "Per-entry key-value tags, used for entry-granularity filtering by `tags` in search-knowledge.",
 				"required": false,
-				"type": "array",
+				"type": "string",
 				"in": "body"
 			},
 			{
@@ -12537,9 +12749,9 @@ const routes = {
 			},
 			{
 				"name": "tags",
-				"description": "Replaces the entry's tags. Pass null or an empty array to clear.",
+				"description": "Replaces the entry's tags. Pass null or an empty object to clear.",
 				"required": false,
-				"type": "array",
+				"type": "string",
 				"in": "body"
 			},
 			{
@@ -12573,6 +12785,72 @@ const routes = {
 			"in": "path"
 		}]
 	},
+	"get-memory-entry-tags": {
+		serviceClass: "MemoryEntries",
+		operationId: "getMemoryEntryTags",
+		description: "Returns all tags attached to the memory entry",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+		httpMethod: "get",
+		pathParams: ["project_id", "entry_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "entry_id",
+			"description": "Memory entry ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"replace-memory-entry-tags": {
+		serviceClass: "MemoryEntries",
+		operationId: "replaceMemoryEntryTags",
+		description: "Replaces all tags on the memory entry with the provided tags (not merged)",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+		httpMethod: "put",
+		pathParams: ["project_id", "entry_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "entry_id",
+			"description": "Memory entry ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"merge-memory-entry-tags": {
+		serviceClass: "MemoryEntries",
+		operationId: "mergeMemoryEntryTags",
+		description: "Merges provided tags into the memory entry's existing tags (existing tags are preserved unless overridden)",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+		httpMethod: "patch",
+		pathParams: ["project_id", "entry_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "entry_id",
+			"description": "Memory entry ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"list-model-routes": {
 		serviceClass: "ModelRoutes",
 		operationId: "listModelRoutes",
@@ -14484,6 +14762,7 @@ const routes = {
 			"agent_id",
 			"actor_id",
 			"status",
+			"tags",
 			"limit",
 			"offset"
 		],
@@ -14516,6 +14795,13 @@ const routes = {
 				"type": "string",
 				"in": "query"
 			},
+			{
+				"name": "tags",
+				"description": "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.\n",
+				"required": false,
+				"type": "array",
+				"in": "query"
+			},
 			{
 				"name": "limit",
 				"description": "",
@@ -14894,7 +15180,7 @@ const routes = {
 			},
 			{
 				"name": "tags",
-				"description": "Optional tags for the forked session",
+				"description": "Key-value labels on a resource. A flat object of string values — an array, a nested object or a number is rejected with `400 VALIDATION_FAILED`, never coerced. Keys are opaque and stored verbatim, so `cost_center` and `costCenter` are two different tags. Matched by JSONB containment wherever tags are read: the `?tags=` filter and knowledge search.",
 				"required": false,
 				"type": "object",
 				"in": "body"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.127.0",
+  "version": "0.127.2",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/sdk": "0.127.0"
+    "@naturali/sdk": "0.127.2"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",