@soat/cli 0.46.0 → 0.47.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.47.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"
@@ -1290,7 +1296,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 +2307,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 +2320,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",
@@ -2619,7 +2631,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 +2644,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 +2710,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 +2768,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 +2848,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"
@@ -3703,13 +3721,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",
@@ -4925,7 +4949,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 +4984,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 +4996,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 +5020,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 +5066,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 +5116,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 +5138,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 with 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 +5193,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 +5254,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 +5310,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 +5338,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 with 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 +6607,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 +6632,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 +6924,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.47.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.47.0",
     "@ttoss/logger": "^0.8.19",
     "commander": "^15.0.0",
     "js-yaml": "^5.2.1"