@soat/cli 0.49.1 → 0.50.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.49.1";
+var version = "0.50.0";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -1308,13 +1308,13 @@ var routes = {
       "in": "body"
     }, {
       "name": "extract",
-      "description": "Per-turn override of the agent's `knowledge_config.extraction` default. Omit to follow the agent's stored config. Set `false` to suppress automatic memory extraction for this turn (e.g. an operational or tool-listing turn that would only add noise to a curated memory). Set `true` to force extraction on for this turn even when the agent does not enable it by default, provided the agent has a `write_memory_id`. Has no effect on streaming or `requires_action` turns, which never extract.",
+      "description": "Per-turn override of the agent's `knowledge_config.extraction` default. Omit to follow the agent's stored config. Set `false` to suppress automatic memory store extraction for this turn (e.g. an operational or tool-listing turn that would only add noise to a curated memory store). Set `true` to force extraction on for this turn even when the agent does not enable it by default, provided the agent has a `write_memory_store_id`. Has no effect on streaming or `requires_action` turns, which never extract.",
       "required": false,
       "type": "boolean",
       "in": "body"
     }, {
       "name": "knowledge_config",
-      "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.",
+      "description": "Per-generation knowledge retrieval override. Array filters (memory_store_ids, document_ids, document_paths) are unioned with the agent's stored knowledge_config; `tags` pairs are merged with the override winning per key; scalar fields (min_score, limit) use the per-generation value when present.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -4967,7 +4967,7 @@ var routes = {
   "search-knowledge": {
     serviceClass: "Knowledge",
     operationId: "searchKnowledge",
-    description: "Searches across documents and memory entries using hybrid retrieval — a vector query and a full-text query per source, fused by reciprocal rank — or by file paths, document IDs, memory IDs, or tags. At least one of `query`, `tags`, `document_paths`, `document_ids`, or `memory_ids` must be provided.",
+    description: "Searches across documents and memories using hybrid retrieval — a vector query and a full-text query per source, fused by reciprocal rank — or by file paths, document IDs, memory store IDs, or tags. At least one of `query`, `tags`, `document_paths`, `document_ids`, or `memory_store_ids` must be provided.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/knowledge",
     httpMethod: "post",
     pathParams: [],
@@ -5004,7 +5004,7 @@ var routes = {
       "in": "body"
     }, {
       "name": "recency_half_life_days",
-      "description": "Half-life, in days, of a recency decay applied to **memory** results after fusion: a result's `score` is multiplied by `2 ^ (-age_in_days / recency_half_life_days)`, where age is measured from its `updated_at`. Document results are never decayed. `0` — the default, and the default of the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` — disables the blend entirely; it is a switch, not a lower bound, and sending `0` turns off a deployment-wide decay for this one request. Accepts fractions (`0.5` is twelve hours). How many ranks a given half-life costs depends on `rrf_k`. Only applies when `query` is provided.",
+      "description": "Half-life, in days, of a recency decay applied to **memory store** results after fusion: a result's `score` is multiplied by `2 ^ (-age_in_days / recency_half_life_days)`, where age is measured from its `updated_at`. Document results are never decayed. `0` — the default, and the default of the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` — disables the blend entirely; it is a switch, not a lower bound, and sending `0` turns off a deployment-wide decay for this one request. Accepts fractions (`0.5` is twelve hours). How many ranks a given half-life costs depends on `rrf_k`. Only applies when `query` is provided.",
       "required": false,
       "type": "number",
       "in": "body"
@@ -5015,8 +5015,8 @@ var routes = {
       "type": "integer",
       "in": "body"
     }, {
-      "name": "memory_ids",
-      "description": "Search entries within these specific memories",
+      "name": "memory_store_ids",
+      "description": "Search memories within these specific memory stores",
       "required": false,
       "type": "array",
       "in": "body"
@@ -5034,7 +5034,7 @@ var routes = {
       "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.",
+      "description": "Filter results to documents and memories 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 memories it matches at memory granularity: a memory is returned when its parent memory store's tags match or its own do.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -5043,15 +5043,15 @@ var routes = {
   "list-memories": {
     serviceClass: "Memories",
     operationId: "listMemories",
-    description: "Returns a list of memory configurations for a project",
+    description: "Returns all memories in a memory store",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memories",
     httpMethod: "get",
     pathParams: [],
-    queryParams: ["project_id", "tags", "limit", "offset"],
+    queryParams: ["memory_store_id", "tags", "limit", "offset", "include_invalidated"],
     flags: [{
-      "name": "project_id",
-      "description": "Project ID (required if not using project key auth)",
-      "required": false,
+      "name": "memory_store_id",
+      "description": "Memory store to list memories from (mstore_...)",
+      "required": true,
       "type": "string",
       "in": "query"
     }, {
@@ -5072,46 +5072,70 @@ var routes = {
       "required": false,
       "type": "integer",
       "in": "query"
+    }, {
+      "name": "include_invalidated",
+      "description": "Include invalidated (superseded) memories. They are excluded by default; set this to audit the supersede history.",
+      "required": false,
+      "type": "boolean",
+      "in": "query"
     }]
   },
   "create-memory": {
     serviceClass: "Memories",
     operationId: "createMemory",
-    description: "Creates a new memory configuration in a project",
+    description: "Creates a new memory in the specified memory store. Automatically generates an embedding for semantic search, and skips the write when an existing memory is a near-duplicate (see `duplicate_threshold`). A merely similar fact is stored as its own memory: this path has no agent context and therefore no model to consolidate two facts into one.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memories",
     httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
-      "name": "project_id",
-      "description": "Project ID (required if not using project key auth)",
-      "required": false,
+      "name": "memory_store_id",
+      "description": "Memory store to add the memory to (mstore_...)",
+      "required": true,
       "type": "string",
       "in": "body"
     }, {
-      "name": "name",
-      "description": "Memory name",
+      "name": "content",
+      "description": "The text content of the memory",
       "required": true,
       "type": "string",
       "in": "body"
     }, {
-      "name": "description",
-      "description": "Optional description",
+      "name": "source_type",
+      "description": "Whether there is a source to point at. `conversation` requires `source_id`; `manual` rejects it.",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
+      "name": "source_id",
+      "description": "The conversation this fact was learned in. Required when `source_type` is `conversation`, and rejected otherwise.",
       "required": false,
       "type": "string",
       "in": "body"
     }, {
       "name": "tags",
-      "description": "Optional key-value tags. Scopes the memory in knowledge search, where every requested pair must match exactly.",
+      "description": "Per-memory key-value tags, used for memory-granularity filtering by `tags` in search-knowledge.",
       "required": false,
       "type": "object",
       "in": "body"
+    }, {
+      "name": "metadata",
+      "description": "Arbitrary structured metadata attached to the memory",
+      "required": false,
+      "type": "object",
+      "in": "body"
+    }, {
+      "name": "duplicate_threshold",
+      "description": "Cosine similarity score at or above which the incoming content is considered a duplicate of an existing memory and skipped (default 0.95). Below it the memory is always created.",
+      "required": false,
+      "type": "number",
+      "in": "body"
     }]
   },
   "get-memory": {
     serviceClass: "Memories",
     operationId: "getMemory",
-    description: "Returns a single memory configuration by ID",
+    description: "Returns a single memory by ID",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memories",
     httpMethod: "get",
     pathParams: ["memory_id"],
@@ -5127,7 +5151,7 @@ var routes = {
   "update-memory": {
     serviceClass: "Memories",
     operationId: "updateMemory",
-    description: "Updates an existing memory configuration",
+    description: "Updates an existing memory. Regenerates the embedding if content changes.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memories",
     httpMethod: "put",
     pathParams: ["memory_id"],
@@ -5139,20 +5163,20 @@ var routes = {
       "type": "string",
       "in": "path"
     }, {
-      "name": "name",
-      "description": "Memory name",
+      "name": "content",
+      "description": "Updated text content",
       "required": false,
       "type": "string",
       "in": "body"
     }, {
-      "name": "description",
-      "description": "Optional description",
+      "name": "tags",
+      "description": "Replaces the memory's tags. Pass null or an empty object to clear.",
       "required": false,
-      "type": "string",
+      "type": "object",
       "in": "body"
     }, {
-      "name": "tags",
-      "description": "Optional key-value tags. Replaces the stored bag; `null` clears it.",
+      "name": "metadata",
+      "description": "Replaces the memory's metadata. Pass null to clear.",
       "required": false,
       "type": "object",
       "in": "body"
@@ -5161,7 +5185,7 @@ var routes = {
   "delete-memory": {
     serviceClass: "Memories",
     operationId: "deleteMemory",
-    description: "Deletes a memory configuration",
+    description: "Deletes a memory",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memories",
     httpMethod: "delete",
     pathParams: ["memory_id"],
@@ -5222,18 +5246,18 @@ var routes = {
       "in": "path"
     }]
   },
-  "list-memory-entries": {
-    serviceClass: "MemoryEntries",
-    operationId: "listMemoryEntries",
-    description: "Returns all entries in a memory container",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-entries",
+  "list-memory-stores": {
+    serviceClass: "MemoryStores",
+    operationId: "listMemoryStores",
+    description: "Returns a list of memory store configurations for a project",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-stores",
     httpMethod: "get",
     pathParams: [],
-    queryParams: ["memory_id", "tags", "limit", "offset", "include_invalidated"],
+    queryParams: ["project_id", "tags", "limit", "offset"],
     flags: [{
-      "name": "memory_id",
-      "description": "Memory container to list entries from (mem_...)",
-      "required": true,
+      "name": "project_id",
+      "description": "Project ID (required if not using project key auth)",
+      "required": false,
       "type": "string",
       "in": "query"
     }, {
@@ -5254,169 +5278,151 @@ var routes = {
       "required": false,
       "type": "integer",
       "in": "query"
-    }, {
-      "name": "include_invalidated",
-      "description": "Include invalidated (superseded) entries. They are excluded by default; set this to audit the supersede history.",
-      "required": false,
-      "type": "boolean",
-      "in": "query"
     }]
   },
-  "create-memory-entry": {
-    serviceClass: "MemoryEntries",
-    operationId: "createMemoryEntry",
-    description: "Creates a new entry in the specified memory container. Automatically generates an embedding for semantic search, and skips the write when an existing entry is a near-duplicate (see `duplicate_threshold`). A merely similar fact is stored as its own entry: this path has no agent context and therefore no model to consolidate two facts into one.",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-entries",
+  "create-memory-store": {
+    serviceClass: "MemoryStores",
+    operationId: "createMemoryStore",
+    description: "Creates a new memory store configuration in a project",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-stores",
     httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
-      "name": "memory_id",
-      "description": "Memory container to add the entry to (mem_...)",
-      "required": true,
+      "name": "project_id",
+      "description": "Project ID (required if not using project key auth)",
+      "required": false,
       "type": "string",
       "in": "body"
     }, {
-      "name": "content",
-      "description": "The text content of the memory entry",
+      "name": "name",
+      "description": "Memory store name",
       "required": true,
       "type": "string",
       "in": "body"
     }, {
-      "name": "source_type",
-      "description": "How this entry was created",
+      "name": "description",
+      "description": "Optional description",
       "required": false,
       "type": "string",
       "in": "body"
     }, {
       "name": "tags",
-      "description": "Per-entry key-value tags, used for entry-granularity filtering by `tags` in search-knowledge.",
-      "required": false,
-      "type": "object",
-      "in": "body"
-    }, {
-      "name": "metadata",
-      "description": "Arbitrary structured metadata attached to the entry",
+      "description": "Optional key-value tags. Scopes the memory store in knowledge search, where every requested pair must match exactly.",
       "required": false,
       "type": "object",
       "in": "body"
-    }, {
-      "name": "duplicate_threshold",
-      "description": "Cosine similarity score at or above which the incoming content is considered a duplicate of an existing entry and skipped (default 0.95). Below it the entry is always created.",
-      "required": false,
-      "type": "number",
-      "in": "body"
     }]
   },
-  "get-memory-entry": {
-    serviceClass: "MemoryEntries",
-    operationId: "getMemoryEntry",
-    description: "Returns a single memory entry by ID",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-entries",
+  "get-memory-store": {
+    serviceClass: "MemoryStores",
+    operationId: "getMemoryStore",
+    description: "Returns a single memory store configuration by ID",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-stores",
     httpMethod: "get",
-    pathParams: ["entry_id"],
+    pathParams: ["memory_store_id"],
     queryParams: [],
     flags: [{
-      "name": "entry_id",
+      "name": "memory_store_id",
       "description": "",
       "required": true,
       "type": "string",
       "in": "path"
     }]
   },
-  "update-memory-entry": {
-    serviceClass: "MemoryEntries",
-    operationId: "updateMemoryEntry",
-    description: "Updates an existing memory entry. Regenerates the embedding if content changes.",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-entries",
+  "update-memory-store": {
+    serviceClass: "MemoryStores",
+    operationId: "updateMemoryStore",
+    description: "Updates an existing memory store configuration",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-stores",
     httpMethod: "put",
-    pathParams: ["entry_id"],
+    pathParams: ["memory_store_id"],
     queryParams: [],
     flags: [{
-      "name": "entry_id",
+      "name": "memory_store_id",
       "description": "",
       "required": true,
       "type": "string",
       "in": "path"
     }, {
-      "name": "content",
-      "description": "Updated text content",
+      "name": "name",
+      "description": "Memory store name",
       "required": false,
       "type": "string",
       "in": "body"
     }, {
-      "name": "tags",
-      "description": "Replaces the entry's tags. Pass null or an empty object to clear.",
+      "name": "description",
+      "description": "Optional description",
       "required": false,
-      "type": "object",
+      "type": "string",
       "in": "body"
     }, {
-      "name": "metadata",
-      "description": "Replaces the entry's metadata. Pass null to clear.",
+      "name": "tags",
+      "description": "Optional key-value tags. Replaces the stored bag; `null` clears it.",
       "required": false,
       "type": "object",
       "in": "body"
     }]
   },
-  "delete-memory-entry": {
-    serviceClass: "MemoryEntries",
-    operationId: "deleteMemoryEntry",
-    description: "Deletes a memory entry",
-    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-entries",
+  "delete-memory-store": {
+    serviceClass: "MemoryStores",
+    operationId: "deleteMemoryStore",
+    description: "Deletes a memory store configuration",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-stores",
     httpMethod: "delete",
-    pathParams: ["entry_id"],
+    pathParams: ["memory_store_id"],
     queryParams: [],
     flags: [{
-      "name": "entry_id",
+      "name": "memory_store_id",
       "description": "",
       "required": true,
       "type": "string",
       "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",
+  "get-memory-store-tags": {
+    serviceClass: "MemoryStores",
+    operationId: "getMemoryStoreTags",
+    description: "Returns all tags attached to the memory store",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-stores",
     httpMethod: "get",
-    pathParams: ["entry_id"],
+    pathParams: ["memory_store_id"],
     queryParams: [],
     flags: [{
-      "name": "entry_id",
-      "description": "Memory entry ID",
+      "name": "memory_store_id",
+      "description": "Memory store 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",
+  "replace-memory-store-tags": {
+    serviceClass: "MemoryStores",
+    operationId: "replaceMemoryStoreTags",
+    description: "Replaces all tags on the memory store with the provided tags (not merged)",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-stores",
     httpMethod: "put",
-    pathParams: ["entry_id"],
+    pathParams: ["memory_store_id"],
     queryParams: [],
     flags: [{
-      "name": "entry_id",
-      "description": "Memory entry ID",
+      "name": "memory_store_id",
+      "description": "Memory store 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",
+  "merge-memory-store-tags": {
+    serviceClass: "MemoryStores",
+    operationId: "mergeMemoryStoreTags",
+    description: "Merges provided tags into the memory store's existing tags (existing tags are preserved unless overridden)",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/memory-stores",
     httpMethod: "patch",
-    pathParams: ["entry_id"],
+    pathParams: ["memory_store_id"],
     queryParams: [],
     flags: [{
-      "name": "entry_id",
-      "description": "Memory entry ID",
+      "name": "memory_store_id",
+      "description": "Memory store ID",
       "required": true,
       "type": "string",
       "in": "path"
@@ -6299,7 +6305,7 @@ var routes = {
   "delete-project": {
     serviceClass: "Projects",
     operationId: "deleteProject",
-    description: "Deletes a project. Requires admin role. Fails with `409` if the project has any dependent resource, unless `force=true` is passed, in which case those resources are deleted along with the project. Every project-scoped resource counts: agents, ai providers, model routes, tools, ingestion rules, actors, chats, conversations, sessions, generations, traces, datasets, evals, workflows, tasks, triggers, orchestrations and their runs, formations, memories, secrets, files, guardrails, quotas, usage history — and the activity, approval, exception and guardrail-evaluation records a project accumulates while it runs. Audit log entries are the one exception: they outlive the project, keeping their record with `project_id` cleared.",
+    description: "Deletes a project. Requires admin role. Fails with `409` if the project has any dependent resource, unless `force=true` is passed, in which case those resources are deleted along with the project. Every project-scoped resource counts: agents, ai providers, model routes, tools, ingestion rules, actors, chats, conversations, sessions, generations, traces, datasets, evals, workflows, tasks, triggers, orchestrations and their runs, formations, memory stores, secrets, files, guardrails, quotas, usage history — and the activity, approval, exception and guardrail-evaluation records a project accumulates while it runs. Audit log entries are the one exception: they outlive the project, keeping their record with `project_id` cleared.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/projects",
     httpMethod: "delete",
     pathParams: ["project_id"],
@@ -6387,7 +6393,7 @@ var routes = {
   "create-quota": {
     serviceClass: "Quotas",
     operationId: "createQuota",
-    description: "Creates a project-scoped quota. `requests` is valid for `scope: project`/`api_key`; `tokens` and `cost_usd` are valid for `scope: project`/`agent`/`actor`; `storage_bytes` is valid for `scope: project` only. Any other scope/metric pair is rejected with 400 (no attribution exists to enforce it). An `actor` quota caps one end user's spend, matched from the generation's session; a null `scope_ref` means one budget *per* actor rather than a pooled project total. A `cost_usd` quota may name one `meter_type` to cap; omitting it caps every priced meter. A duplicate quota (same project, scope, scope_ref, metric, window, meter_type) is rejected with 409. `storage_bytes` caps a stored total rather than a windowed one, so it takes `window: current` and every other metric refuses that value (400 either way). It is enforced at the corpus write paths — file upload and create, document create, document ingest and re-ingest, memory-entry create — with `409 QUOTA_STORAGE_EXCEEDED` and no `Retry-After`, since no window reset clears a footprint.",
+    description: "Creates a project-scoped quota. `requests` is valid for `scope: project`/`api_key`; `tokens` and `cost_usd` are valid for `scope: project`/`agent`/`actor`; `storage_bytes` is valid for `scope: project` only. Any other scope/metric pair is rejected with 400 (no attribution exists to enforce it). An `actor` quota caps one end user's spend, matched from the generation's session; a null `scope_ref` means one budget *per* actor rather than a pooled project total. A `cost_usd` quota may name one `meter_type` to cap; omitting it caps every priced meter. A duplicate quota (same project, scope, scope_ref, metric, window, meter_type) is rejected with 409. `storage_bytes` caps a stored total rather than a windowed one, so it takes `window: current` and every other metric refuses that value (400 either way). It is enforced at the corpus write paths — file upload and create, document create, document ingest and re-ingest, memory create — with `409 QUOTA_STORAGE_EXCEEDED` and no `Retry-After`, since no window reset clears a footprint.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/quotas",
     httpMethod: "post",
     pathParams: [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/cli",
-  "version": "0.49.1",
+  "version": "0.50.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.6",
     "@inquirer/password": "^5.2.2",
-    "@soat/sdk": "0.49.1",
+    "@soat/sdk": "0.50.0",
     "@ttoss/logger": "^0.8.20",
     "commander": "^15.0.0",
     "js-yaml": "^5.4.2"