@mastra/memory 1.28.1 → 1.28.2-alpha.1

package/dist/{src-Br56ncef.cjs → src-Bq1Ng-3M.cjs}

@@ -16096,6 +16096,12 @@ function requireVisible(scope, options, label) {
 	if (!(0, _mastra_core_storage.isKnowledgeScopeVisible)(scope, options.scope)) throw new Error(`${label} is outside the curator's visible scope.`);
 }
 function createKnowledgeWriteTools(memory, options) {
+	async function resolveWritableNode(id) {
+		const node = await (await getStore(memory)).getNode(id);
+		if (!node || node.mergedInto) throw new Error(`Knowledge node not found: ${id}`);
+		requireVisible(node.scope, options, "Knowledge node");
+		return node;
+	}
 	return {
 		knowledge_append: (0, _mastra_core_tools.createTool)({
 			id: "knowledge_append",
@@ -16166,7 +16172,7 @@ function createKnowledgeWriteTools(memory, options) {
 		}),
 		knowledge_update_node: (0, _mastra_core_tools.createTool)({
 			id: "knowledge_update_node",
-			description: "Update a visible node name or kind using optimistic concurrency. Provide at least one of name or kind.",
+			description: "Atomically rename and re-kind a visible node using optimistic concurrency.",
 			inputSchema: {
 				type: "object",
 				properties: {
@@ -16187,17 +16193,18 @@ function createKnowledgeWriteTools(memory, options) {
 						minLength: 1
 					}
 				},
-				required: ["node", "expectedVersion"],
+				required: [
+					"node",
+					"expectedVersion",
+					"name",
+					"kind"
+				],
 				additionalProperties: false
 			},
 			execute: async (input) => {
 				const value = input;
-				if (value.name === void 0 && value.kind === void 0) throw new Error("knowledge_update_node requires at least one of: name, kind.");
-				const store = await getStore(memory);
-				const node = await store.getNode(value.node);
-				if (!node || node.mergedInto) throw new Error(`Knowledge node not found: ${value.node}`);
-				requireVisible(node.scope, options, "Knowledge node");
-				return store.updateNode({
+				const node = await resolveWritableNode(value.node);
+				return (await getStore(memory)).updateNode({
 					id: node.id,
 					version: value.expectedVersion,
 					name: value.name,
@@ -16205,6 +16212,78 @@ function createKnowledgeWriteTools(memory, options) {
 				});
 			}
 		}),
+		knowledge_rename_node: (0, _mastra_core_tools.createTool)({
+			id: "knowledge_rename_node",
+			description: "Rename a visible node using optimistic concurrency.",
+			inputSchema: {
+				type: "object",
+				properties: {
+					node: {
+						type: "string",
+						minLength: 1
+					},
+					expectedVersion: {
+						type: "integer",
+						minimum: 1
+					},
+					name: {
+						type: "string",
+						minLength: 1
+					}
+				},
+				required: [
+					"node",
+					"expectedVersion",
+					"name"
+				],
+				additionalProperties: false
+			},
+			execute: async (input) => {
+				const value = input;
+				const node = await resolveWritableNode(value.node);
+				return (await getStore(memory)).updateNode({
+					id: node.id,
+					version: value.expectedVersion,
+					name: value.name
+				});
+			}
+		}),
+		knowledge_set_node_kind: (0, _mastra_core_tools.createTool)({
+			id: "knowledge_set_node_kind",
+			description: "Change a visible node kind using optimistic concurrency.",
+			inputSchema: {
+				type: "object",
+				properties: {
+					node: {
+						type: "string",
+						minLength: 1
+					},
+					expectedVersion: {
+						type: "integer",
+						minimum: 1
+					},
+					kind: {
+						type: "string",
+						minLength: 1
+					}
+				},
+				required: [
+					"node",
+					"expectedVersion",
+					"kind"
+				],
+				additionalProperties: false
+			},
+			execute: async (input) => {
+				const value = input;
+				const node = await resolveWritableNode(value.node);
+				return (await getStore(memory)).updateNode({
+					id: node.id,
+					version: value.expectedVersion,
+					kind: value.kind
+				});
+			}
+		}),
 		knowledge_merge_nodes: (0, _mastra_core_tools.createTool)({
 			id: "knowledge_merge_nodes",
 			description: "Merge a visible duplicate node into another visible node using source-version CAS.",
@@ -16744,7 +16823,7 @@ var Subconscious = class {
 const CURATION_AGENT = "curate";
 const DEFAULT_INSTRUCTIONS$1 = `Maintain durable scoped knowledge from the committed observation worklist.
 
-Use the read tools to inspect existing nodes, knowledge records, mentions, backlinks, and long-form node content. Use the write tools to merge true duplicates, repair names and links, soft-delete superseded knowledge records, rescope knowledge records only when justified and permitted by their ceilings, and synthesize useful node content. Never restore deleted knowledge records. Never invent provenance, capture timestamps, scopes, ceilings, IDs, or versions; those are enforced by code. Resolve optimistic-concurrency conflicts by reading the latest record and retrying the intended mutation. Keep the reserved capture-guidance node concise and update it only with durable guidance that will improve future capture.
+Use the read tools to inspect existing nodes, knowledge records, mentions, backlinks, and long-form node content. Use the write tools to merge true duplicates, repair names and links, soft-delete superseded knowledge records, rescope knowledge records only when justified and permitted by their ceilings, and synthesize useful node content. When both a node name and kind must change, use knowledge_update_node so they commit atomically under one expectedVersion; use the single-field tools only when changing one field. Never restore deleted knowledge records. Never invent provenance, capture timestamps, scopes, ceilings, IDs, or versions; those are enforced by code. Resolve optimistic-concurrency conflicts by reading the latest record and retrying the intended mutation. Keep the reserved capture-guidance node concise and update it only with durable guidance that will improve future capture.
 
 For each significant entity node touched by a KnowledgeRecord in the current worklist, including people, projects, pull requests, issues, repositories, documents, and organizations, maintain a short entity description; do not walk nodes outside the worklist for this. Use the supplied record and read the named node once; do not search or browse unless its identity is ambiguous. Describe what the entity is, its current state, and links to its real-world object, then write it with knowledge_write_node_description, which always requires expectedVersion from the node you just read; after a version conflict, re-read the node and regenerate the description from its current state before retrying. If the node does not exist yet, create it first with knowledge_write_node_content, then re-read it for its fresh version before writing the description. Write one or two plain-text sentences, roughly 40 to 75 tokens; storage rejects any description over its hard length cap, so keep them tight and put long-form detail in node content instead. Include links only from the entity's own records or observations that explicitly associate the link with that entity; never invent a URL, identifier, file path, or provenance. Leave long-form node content alone unless you are synthesizing it deliberately; never shrink content into a synopsis. For entity-description maintenance only, skip low-signal nodes with only a trivial record, any system-kind node, and the reserved capture-guidance node.
 
@@ -23219,20 +23298,20 @@ function getUnobservedPartsPreservingToolCallPairs(message) {
 /**
 * Get the messages Observational Memory is allowed to work with.
 *
-* Messages supplied through the `context` option are per-run ephemeral input. Core's
-* persistence contract already treats them as never-persist: `MessageStateManager` routes
-* them into `userContextMessages`, and `drainUnsavedMessages` only drains input/response.
+* Messages supplied through the `context` option and the synthetic `om-continuation`
+* message are prompt-only input. Core's persistence contract already treats context as
+* never-persist, while the continuation remains memory-sourced so it can stay in the live
+* actor prompt.
 *
-* OM builds its windows from `get.all.db()`, which includes context messages, and then
-* seals and persists candidates directly — turning ephemeral context into durable user
-* messages. Excluding them here keeps OM's window, sealing, persistence and token
-* accounting consistent with that contract.
+* OM builds its windows from `get.all.db()`, which includes both categories, and then seals
+* and persists candidates directly. Excluding them here keeps OM's observation, buffering,
+* persistence, and token accounting consistent with their ephemeral contract.
 */
 function getObservableMessages(messageList) {
-	const allMessages = messageList.get.all.db();
 	const contextMessageIds = messageList.makeMessageSourceChecker().context;
-	if (contextMessageIds.size === 0) return allMessages;
-	return allMessages.filter((message) => !contextMessageIds.has(message.id));
+	return messageList.get.all.db().filter((message) => {
+		return message.id !== "om-continuation" && !contextMessageIds.has(message.id);
+	});
 }
 /**
 * Safely extract buffered observation chunks from a record.
@@ -31869,4 +31948,4 @@ Object.defineProperty(exports, "wrapInObservationGroup", {
 	}
 });
 
-//# sourceMappingURL=src-Br56ncef.cjs.map
+//# sourceMappingURL=src-Bq1Ng-3M.cjs.map