@naturali/cli 0.127.10 → 0.128.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.127.10";
+var version = "0.128.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -3041,7 +3041,7 @@ var Knowledge = class {
 	/**
 	* Search knowledge
 	*
-	* 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.
+	* 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.
 	*/
 	static searchKnowledge(options) {
 		return (options.client ?? client).post({
@@ -3058,7 +3058,7 @@ var Memories = class {
 	/**
 	* List memories
 	*
-	* Returns a list of memory configurations for a project
+	* Returns all memories in a memory store
 	*/
 	static listMemories(options) {
 		return (options.client ?? client).get({
@@ -3069,7 +3069,7 @@ var Memories = class {
 	/**
 	* Create a memory
 	*
-	* Creates a new memory configuration in a project
+	* 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.
 	*/
 	static createMemory(options) {
 		return (options.client ?? client).post({
@@ -3084,7 +3084,7 @@ var Memories = class {
 	/**
 	* Delete a memory
 	*
-	* Deletes a memory configuration
+	* Deletes a memory
 	*/
 	static deleteMemory(options) {
 		return (options.client ?? client).delete({
@@ -3095,7 +3095,7 @@ var Memories = class {
 	/**
 	* Get a memory
 	*
-	* Returns a single memory configuration by ID
+	* Returns a single memory by ID
 	*/
 	static getMemory(options) {
 		return (options.client ?? client).get({
@@ -3106,7 +3106,7 @@ var Memories = class {
 	/**
 	* Update a memory
 	*
-	* Updates an existing memory configuration
+	* Updates an existing memory. Regenerates the embedding if content changes.
 	*/
 	static updateMemory(options) {
 		return (options.client ?? client).put({
@@ -3160,26 +3160,26 @@ var Memories = class {
 		});
 	}
 };
-var MemoryEntries = class {
+var MemoryStores = class {
 	/**
-	* List memory entries
+	* List memory stores
 	*
-	* Returns all entries in a memory container
+	* Returns a list of memory store configurations for a project
 	*/
-	static listMemoryEntries(options) {
+	static listMemoryStores(options) {
 		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/memory-entries",
+			url: "/v1/projects/{project_id}/memory-stores",
 			...options
 		});
 	}
 	/**
-	* Create a memory entry
+	* Create a memory store
 	*
-	* 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.
+	* Creates a new memory store configuration in a project
 	*/
-	static createMemoryEntry(options) {
+	static createMemoryStore(options) {
 		return (options.client ?? client).post({
-			url: "/v1/projects/{project_id}/memory-entries",
+			url: "/v1/projects/{project_id}/memory-stores",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -3188,35 +3188,35 @@ var MemoryEntries = class {
 		});
 	}
 	/**
-	* Delete a memory entry
+	* Delete a memory store
 	*
-	* Deletes a memory entry
+	* Deletes a memory store configuration
 	*/
-	static deleteMemoryEntry(options) {
+	static deleteMemoryStore(options) {
 		return (options.client ?? client).delete({
-			url: "/v1/projects/{project_id}/memory-entries/{entry_id}",
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}",
 			...options
 		});
 	}
 	/**
-	* Get a memory entry
+	* Get a memory store
 	*
-	* Returns a single memory entry by ID
+	* Returns a single memory store configuration by ID
 	*/
-	static getMemoryEntry(options) {
+	static getMemoryStore(options) {
 		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/memory-entries/{entry_id}",
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}",
 			...options
 		});
 	}
 	/**
-	* Update a memory entry
+	* Update a memory store
 	*
-	* Updates an existing memory entry. Regenerates the embedding if content changes.
+	* Updates an existing memory store configuration
 	*/
-	static updateMemoryEntry(options) {
+	static updateMemoryStore(options) {
 		return (options.client ?? client).put({
-			url: "/v1/projects/{project_id}/memory-entries/{entry_id}",
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -3225,24 +3225,24 @@ var MemoryEntries = class {
 		});
 	}
 	/**
-	* Get memory entry tags
+	* Get memory store tags
 	*
-	* Returns all tags attached to the memory entry
+	* Returns all tags attached to the memory store
 	*/
-	static getMemoryEntryTags(options) {
+	static getMemoryStoreTags(options) {
 		return (options.client ?? client).get({
-			url: "/v1/projects/{project_id}/memory-entries/{entry_id}/tags",
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}/tags",
 			...options
 		});
 	}
 	/**
-	* Merge memory entry tags
+	* Merge memory store tags
 	*
-	* Merges provided tags into the memory entry's existing tags (existing tags are preserved unless overridden)
+	* Merges provided tags into the memory store's existing tags (existing tags are preserved unless overridden)
 	*/
-	static mergeMemoryEntryTags(options) {
+	static mergeMemoryStoreTags(options) {
 		return (options.client ?? client).patch({
-			url: "/v1/projects/{project_id}/memory-entries/{entry_id}/tags",
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}/tags",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -3251,13 +3251,13 @@ var MemoryEntries = class {
 		});
 	}
 	/**
-	* Replace memory entry tags
+	* Replace memory store tags
 	*
-	* Replaces all tags on the memory entry with the provided tags (not merged)
+	* Replaces all tags on the memory store with the provided tags (not merged)
 	*/
-	static replaceMemoryEntryTags(options) {
+	static replaceMemoryStoreTags(options) {
 		return (options.client ?? client).put({
-			url: "/v1/projects/{project_id}/memory-entries/{entry_id}/tags",
+			url: "/v1/projects/{project_id}/memory-stores/{memory_store_id}/tags",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -3844,7 +3844,7 @@ var Quotas = class {
 	*
 	* 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.
+	* `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.
 	*/
 	static createQuota(options) {
 		return (options.client ?? client).post({
@@ -4900,7 +4900,7 @@ var NaturaliClient = class {
 	ingestionRules;
 	knowledge;
 	memories;
-	memoryEntries;
+	memoryStores;
 	modelRoutes;
 	quotas;
 	models;
@@ -4950,7 +4950,7 @@ var NaturaliClient = class {
 		this.ingestionRules = bindResource(IngestionRules, this.http);
 		this.knowledge = bindResource(Knowledge, this.http);
 		this.memories = bindResource(Memories, this.http);
-		this.memoryEntries = bindResource(MemoryEntries, this.http);
+		this.memoryStores = bindResource(MemoryStores, this.http);
 		this.modelRoutes = bindResource(ModelRoutes, this.http);
 		this.quotas = bindResource(Quotas, this.http);
 		this.models = bindResource(Models, this.http);
@@ -4995,7 +4995,7 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	IngestionRules: () => IngestionRules,
 	Knowledge: () => Knowledge,
 	Memories: () => Memories,
-	MemoryEntries: () => MemoryEntries,
+	MemoryStores: () => MemoryStores,
 	ModelRoutes: () => ModelRoutes,
 	Models: () => Models,
 	NaturaliClient: () => NaturaliClient,
@@ -5103,6 +5103,21 @@ const parseFlagValue = (value) => {
 	return value;
 };
 /**
+* Parses a value for a flag the manifest declares `string`.
+*
+* `@ttoss/openapi-codegen` reports a schema with no `type` as `string`, so the
+* manifest cannot tell a real string from a union — `tool_choice` takes
+* `"auto"` or `{ "type": "tool", … }` and arrives here as `string`. An object
+* or array literal is therefore still parsed, while a scalar is left as
+* written: a digit-only phone number or external id must not become a number.
+* TriangulosTecnologia/naturali.ai#214
+*/
+const parseStringFlagValue = (value) => {
+	const trimmed = value.trim();
+	if (trimmed.startsWith("{") || trimmed.startsWith("[")) return parseFlagValue(value);
+	return value;
+};
+/**
 * Builds the value for an array-typed flag. Repeated occurrences
 * (`--capabilities a --capabilities b`) collect into a list; a single JSON
 * array literal (`--capabilities '["a","b"]'`) passes through unwrapped; a
@@ -5182,7 +5197,8 @@ const placeFlags = (args) => {
 	}));
 	for (const [flagKey, rawValue] of Object.entries(parsedFlags.single)) {
 		const canonical = toCanonical(flagKey);
-		const value = typeByCanonical.get(canonical) === "array" ? buildArrayFlagValue(parsedFlags.repeated[flagKey] ?? [rawValue]) : parseFlagValue(rawValue);
+		const declaredType = typeByCanonical.get(canonical);
+		const value = declaredType === "array" ? buildArrayFlagValue(parsedFlags.repeated[flagKey] ?? [rawValue]) : declaredType === "string" ? parseStringFlagValue(rawValue) : parseFlagValue(rawValue);
 		const pathParam = route.pathParams.find((param) => {
 			return toCanonical(param) === canonical;
 		});
@@ -6900,14 +6916,14 @@ const routes = {
 			},
 			{
 				"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"
@@ -12270,7 +12286,7 @@ const 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://docs.naturali.ai/docs/modules/knowledge",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -12313,7 +12329,7 @@ const routes = {
 			},
 			{
 				"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"
@@ -12326,8 +12342,8 @@ const routes = {
 				"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"
@@ -12348,7 +12364,7 @@ const routes = {
 			},
 			{
 				"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": "string",
 				"in": "body"
@@ -12358,14 +12374,16 @@ const 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://docs.naturali.ai/docs/modules/memories",
 		httpMethod: "get",
 		pathParams: ["project_id"],
 		queryParams: [
+			"memory_store_id",
 			"tags",
 			"limit",
-			"offset"
+			"offset",
+			"include_invalidated"
 		],
 		flags: [
 			{
@@ -12375,6 +12393,13 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
+			{
+				"name": "memory_store_id",
+				"description": "Memory store to list memories from (mstore_...)",
+				"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",
@@ -12395,13 +12420,20 @@ const 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://docs.naturali.ai/docs/modules/memories",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -12415,32 +12447,60 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "name",
-				"description": "Memory name",
+				"name": "memory_store_id",
+				"description": "Memory store to add the memory to (mstore_...)",
 				"required": true,
 				"type": "string",
 				"in": "body"
 			},
 			{
-				"name": "description",
-				"description": "Optional description",
+				"name": "content",
+				"description": "The text content of the memory",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"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": "string",
 				"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://docs.naturali.ai/docs/modules/memories",
 		httpMethod: "get",
 		pathParams: ["project_id", "memory_id"],
@@ -12462,7 +12522,7 @@ const 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://docs.naturali.ai/docs/modules/memories",
 		httpMethod: "put",
 		pathParams: ["project_id", "memory_id"],
@@ -12483,24 +12543,24 @@ const routes = {
 				"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",
 				"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": "string",
+				"type": "object",
 				"in": "body"
 			}
 		]
@@ -12508,7 +12568,7 @@ const routes = {
 	"delete-memory": {
 		serviceClass: "Memories",
 		operationId: "deleteMemory",
-		description: "Deletes a memory configuration",
+		description: "Deletes a memory",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memories",
 		httpMethod: "delete",
 		pathParams: ["project_id", "memory_id"],
@@ -12593,19 +12653,17 @@ const routes = {
 			"in": "path"
 		}]
 	},
-	"list-memory-entries": {
-		serviceClass: "MemoryEntries",
-		operationId: "listMemoryEntries",
-		description: "Returns all entries in a memory container",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+	"list-memory-stores": {
+		serviceClass: "MemoryStores",
+		operationId: "listMemoryStores",
+		description: "Returns a list of memory store configurations for a project",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "get",
 		pathParams: ["project_id"],
 		queryParams: [
-			"memory_id",
 			"tags",
 			"limit",
-			"offset",
-			"include_invalidated"
+			"offset"
 		],
 		flags: [
 			{
@@ -12615,13 +12673,6 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
-			{
-				"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",
@@ -12642,21 +12693,14 @@ const 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://docs.naturali.ai/docs/modules/memory-entries",
+	"create-memory-store": {
+		serviceClass: "MemoryStores",
+		operationId: "createMemoryStore",
+		description: "Creates a new memory store configuration in a project",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "post",
 		pathParams: ["project_id"],
 		queryParams: [],
@@ -12669,56 +12713,35 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"name": "memory_id",
-				"description": "Memory container to add the entry to (mem_...)",
-				"required": true,
-				"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.",
+				"description": "Optional key-value tags. Scopes the memory store in knowledge search, where every requested pair must match exactly.",
 				"required": false,
 				"type": "string",
 				"in": "body"
-			},
-			{
-				"name": "metadata",
-				"description": "Arbitrary structured metadata attached to the entry",
-				"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://docs.naturali.ai/docs/modules/memory-entries",
+	"get-memory-store": {
+		serviceClass: "MemoryStores",
+		operationId: "getMemoryStore",
+		description: "Returns a single memory store configuration by ID",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "get",
-		pathParams: ["project_id", "entry_id"],
+		pathParams: ["project_id", "memory_store_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -12727,20 +12750,20 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"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://docs.naturali.ai/docs/modules/memory-entries",
+	"update-memory-store": {
+		serviceClass: "MemoryStores",
+		operationId: "updateMemoryStore",
+		description: "Updates an existing memory store configuration",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "put",
-		pathParams: ["project_id", "entry_id"],
+		pathParams: ["project_id", "memory_store_id"],
 		queryParams: [],
 		flags: [
 			{
@@ -12751,42 +12774,42 @@ const routes = {
 				"in": "path"
 			},
 			{
-				"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": "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",
+				"type": "string",
 				"in": "body"
 			}
 		]
 	},
-	"delete-memory-entry": {
-		serviceClass: "MemoryEntries",
-		operationId: "deleteMemoryEntry",
-		description: "Deletes a memory entry",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-entries",
+	"delete-memory-store": {
+		serviceClass: "MemoryStores",
+		operationId: "deleteMemoryStore",
+		description: "Deletes a memory store configuration",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "delete",
-		pathParams: ["project_id", "entry_id"],
+		pathParams: ["project_id", "memory_store_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -12795,20 +12818,20 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"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://docs.naturali.ai/docs/modules/memory-entries",
+	"get-memory-store-tags": {
+		serviceClass: "MemoryStores",
+		operationId: "getMemoryStoreTags",
+		description: "Returns all tags attached to the memory store",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "get",
-		pathParams: ["project_id", "entry_id"],
+		pathParams: ["project_id", "memory_store_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -12817,20 +12840,20 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"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://docs.naturali.ai/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://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "put",
-		pathParams: ["project_id", "entry_id"],
+		pathParams: ["project_id", "memory_store_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -12839,20 +12862,20 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"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://docs.naturali.ai/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://docs.naturali.ai/docs/modules/memory-stores",
 		httpMethod: "patch",
-		pathParams: ["project_id", "entry_id"],
+		pathParams: ["project_id", "memory_store_id"],
 		queryParams: [],
 		flags: [{
 			"name": "project_id",
@@ -12861,8 +12884,8 @@ const routes = {
 			"type": "string",
 			"in": "path"
 		}, {
-			"name": "entry_id",
-			"description": "Memory entry ID",
+			"name": "memory_store_id",
+			"description": "Memory store ID",
 			"required": true,
 			"type": "string",
 			"in": "path"
@@ -14450,7 +14473,7 @@ const 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://docs.naturali.ai/docs/modules/quotas",
 		httpMethod: "post",
 		pathParams: ["project_id"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.127.10",
+  "version": "0.128.0",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -24,7 +24,7 @@
     "commander": "^15.0.0"
   },
   "devDependencies": {
-    "@naturali/sdk": "0.127.10",
+    "@naturali/sdk": "0.128.0",
     "@ttoss/openapi-codegen": "^0.3.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",