@soat/cli 0.46.0 → 0.48.0

package/dist/index.mjs

@@ -13,7 +13,7 @@ import * as os from "node:os";
 import { createHmac, timingSafeEqual } from "node:crypto";
 
 //#region package.json
-var version = "0.46.0";
+var version = "0.48.0";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -481,7 +481,7 @@ var routes = {
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/actors",
     httpMethod: "get",
     pathParams: [],
-    queryParams: ["project_id", "external_id", "name", "agent_id", "chat_id", "conversation_id", "limit", "offset"],
+    queryParams: ["project_id", "external_id", "name", "agent_id", "chat_id", "conversation_id", "tags", "limit", "offset"],
     flags: [{
       "name": "project_id",
       "description": "Project ID (optional)",
@@ -518,6 +518,12 @@ var routes = {
       "required": false,
       "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",
@@ -640,7 +646,7 @@ var routes = {
       "in": "body"
     }, {
       "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, knowledge search, and the IAM `soat:ResourceTag/<key>` condition.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -697,7 +703,7 @@ var 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://soat.ttoss.dev/docs/modules/actors",
     httpMethod: "patch",
     pathParams: ["actor_id"],
@@ -848,6 +854,12 @@ var routes = {
       "required": false,
       "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.",
@@ -1006,6 +1018,12 @@ var routes = {
       "required": false,
       "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.",
@@ -1148,6 +1166,12 @@ var routes = {
       "required": false,
       "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.",
@@ -1290,7 +1314,7 @@ var routes = {
       "in": "body"
     }, {
       "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"
@@ -2301,7 +2325,7 @@ var routes = {
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/conversations",
     httpMethod: "get",
     pathParams: [],
-    queryParams: ["project_id", "actor_id", "limit", "offset"],
+    queryParams: ["project_id", "actor_id", "tags", "limit", "offset"],
     flags: [{
       "name": "project_id",
       "description": "Project ID (optional)",
@@ -2314,6 +2338,12 @@ var routes = {
       "required": false,
       "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",
@@ -2599,7 +2629,7 @@ var 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://soat.ttoss.dev/docs/modules/conversations",
     httpMethod: "patch",
     pathParams: ["conversation_id"],
@@ -2619,7 +2649,7 @@ var routes = {
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/documents",
     httpMethod: "get",
     pathParams: [],
-    queryParams: ["project_id", "path_prefix", "limit", "offset"],
+    queryParams: ["project_id", "path_prefix", "tags", "limit", "offset"],
     flags: [{
       "name": "project_id",
       "description": "Project ID (optional)",
@@ -2632,6 +2662,12 @@ var routes = {
       "required": false,
       "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",
@@ -2692,7 +2728,7 @@ var routes = {
       "in": "body"
     }, {
       "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, knowledge search, and the IAM `soat:ResourceTag/<key>` condition.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -2750,7 +2786,7 @@ var routes = {
       "in": "body"
     }, {
       "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, knowledge search, and the IAM `soat:ResourceTag/<key>` condition.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -2830,7 +2866,7 @@ var routes = {
       "in": "body"
     }, {
       "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, knowledge search, and the IAM `soat:ResourceTag/<key>` condition.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -2977,7 +3013,7 @@ var 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://soat.ttoss.dev/docs/modules/documents",
     httpMethod: "patch",
     pathParams: ["document_id"],
@@ -3703,13 +3739,19 @@ var routes = {
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/files",
     httpMethod: "get",
     pathParams: [],
-    queryParams: ["project_id", "limit", "offset"],
+    queryParams: ["project_id", "tags", "limit", "offset"],
     flags: [{
       "name": "project_id",
       "description": "Filter files by project ID",
       "required": false,
       "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",
@@ -4045,7 +4087,7 @@ var 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://soat.ttoss.dev/docs/modules/files",
     httpMethod: "patch",
     pathParams: ["file_id"],
@@ -4925,7 +4967,7 @@ var 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://soat.ttoss.dev/docs/modules/knowledge",
     httpMethod: "post",
     pathParams: [],
@@ -4960,12 +5002,6 @@ var routes = {
       "required": false,
       "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",
@@ -4978,6 +5014,12 @@ var 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": "object",
+      "in": "body"
     }]
   },
   "list-memories": {
@@ -4996,7 +5038,7 @@ var routes = {
       "in": "query"
     }, {
       "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"
@@ -5042,9 +5084,9 @@ var routes = {
       "in": "body"
     }, {
       "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": "object",
       "in": "body"
     }]
   },
@@ -5092,9 +5134,9 @@ var routes = {
       "in": "body"
     }, {
       "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": "object",
       "in": "body"
     }]
   },
@@ -5114,6 +5156,54 @@ var routes = {
       "in": "path"
     }]
   },
+  "get-memory-tags": {
+    serviceClass: "Memories",
+    operationId: "getMemoryTags",
+    description: "Returns all tags attached to the memory",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memories",
+    httpMethod: "get",
+    pathParams: ["memory_id"],
+    queryParams: [],
+    flags: [{
+      "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://soat.ttoss.dev/docs/modules/memories",
+    httpMethod: "put",
+    pathParams: ["memory_id"],
+    queryParams: [],
+    flags: [{
+      "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://soat.ttoss.dev/docs/modules/memories",
+    httpMethod: "patch",
+    pathParams: ["memory_id"],
+    queryParams: [],
+    flags: [{
+      "name": "memory_id",
+      "description": "Memory ID",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
   "list-memory-entries": {
     serviceClass: "MemoryEntries",
     operationId: "listMemoryEntries",
@@ -5121,13 +5211,19 @@ var routes = {
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-entries",
     httpMethod: "get",
     pathParams: [],
-    queryParams: ["memory_id", "limit", "offset", "include_invalidated"],
+    queryParams: ["memory_id", "tags", "limit", "offset", "include_invalidated"],
     flags: [{
       "name": "memory_id",
       "description": "Memory container to list entries from (mem_...)",
       "required": true,
       "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",
@@ -5176,9 +5272,9 @@ var routes = {
       "in": "body"
     }, {
       "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": "object",
       "in": "body"
     }, {
       "name": "metadata",
@@ -5232,9 +5328,9 @@ var routes = {
       "in": "body"
     }, {
       "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": "object",
       "in": "body"
     }, {
       "name": "metadata",
@@ -5260,6 +5356,54 @@ var routes = {
       "in": "path"
     }]
   },
+  "get-memory-entry-tags": {
+    serviceClass: "MemoryEntries",
+    operationId: "getMemoryEntryTags",
+    description: "Returns all tags attached to the memory entry",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-entries",
+    httpMethod: "get",
+    pathParams: ["entry_id"],
+    queryParams: [],
+    flags: [{
+      "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://soat.ttoss.dev/docs/modules/memory-entries",
+    httpMethod: "put",
+    pathParams: ["entry_id"],
+    queryParams: [],
+    flags: [{
+      "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://soat.ttoss.dev/docs/modules/memory-entries",
+    httpMethod: "patch",
+    pathParams: ["entry_id"],
+    queryParams: [],
+    flags: [{
+      "name": "entry_id",
+      "description": "Memory entry ID",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
   "list-model-routes": {
     serviceClass: "ModelRoutes",
     operationId: "listModelRoutes",
@@ -6481,8 +6625,14 @@ var routes = {
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/sessions",
     httpMethod: "get",
     pathParams: [],
-    queryParams: ["agent_id", "actor_id", "status", "limit", "offset"],
+    queryParams: ["project_id", "agent_id", "actor_id", "status", "tags", "limit", "offset"],
     flags: [{
+      "name": "project_id",
+      "description": "Filter by project public ID. Required for `soat:ResourceTag` policy conditions to narrow the listing: a policy is read per project, so without it the listing is scoped to the projects the caller can access and nothing further.\n",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
       "name": "agent_id",
       "description": "Filter by agent public ID",
       "required": false,
@@ -6500,6 +6650,12 @@ var routes = {
       "required": false,
       "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": "",
@@ -6786,7 +6942,7 @@ var routes = {
       "in": "body"
     }, {
       "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, knowledge search, and the IAM `soat:ResourceTag/<key>` condition.",
       "required": false,
       "type": "object",
       "in": "body"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/cli",
-  "version": "0.46.0",
+  "version": "0.48.0",
   "description": "CLI for SOAT — open-source infrastructure for production-ready AI agents.",
   "keywords": [
     "ai-agents",
@@ -22,7 +22,7 @@
   "dependencies": {
     "@inquirer/input": "^5.1.2",
     "@inquirer/password": "^5.1.1",
-    "@soat/sdk": "0.46.0",
+    "@soat/sdk": "0.48.0",
     "@ttoss/logger": "^0.8.19",
     "commander": "^15.0.0",
     "js-yaml": "^5.2.1"