@mastra/memory 1.28.0 → 1.28.1-alpha.1

package/dist/{src-BATJenuZ.js → src-BNtoxIHL.js}

@@ -11,7 +11,7 @@ import { isStandardSchemaWithJSON, standardSchemaToJSONSchema, toStandardSchema
 import { Mutex } from "async-mutex";
 import { LRUCache } from "lru-cache";
 import xxhash from "xxhash-wasm";
-import { InMemoryStore, assertKnowledgeScopeWithinCeiling, canonicalizeKnowledgeScope, createKnowledgeNodeCursor, expandKnowledgeScope, isKnowledgeScopeVisible, knowledgeScopeKey } from "@mastra/core/storage";
+import { InMemoryStore, MAX_KNOWLEDGE_NODE_DESCRIPTION_LENGTH, assertKnowledgeScopeWithinCeiling, canonicalizeKnowledgeScope, createKnowledgeNodeCursor, expandKnowledgeScope, isKnowledgeScopeVisible, knowledgeScopeKey } from "@mastra/core/storage";
 import { createHash, randomBytes, randomUUID } from "crypto";
 import { createTool } from "@mastra/core/tools";
 import { modelSupportsAttachments, resolveModelConfig } from "@mastra/core/llm";
@@ -206,7 +206,7 @@ let customAlphabet = (alphabet, defaultSize = 21) => {
 	return (size = defaultSize) => {
 		let id = "";
 		let i = size | 0;
-		while (i--) id += alphabet[Math.random() * alphabet.length | 0];
+		while (i-- > 0) id += alphabet[Math.random() * alphabet.length | 0];
 		return id;
 	};
 };
@@ -3713,7 +3713,7 @@ function trimStartOfStream() {
 	};
 }
 //#endregion
-//#region ../_vendored/ai_v5/dist/dist-nVfjvSbw.js
+//#region ../_vendored/ai_v5/dist/dist-Dqv4QeJJ.js
 var marker$1$4 = "vercel.ai.error";
 var symbol$1$3 = Symbol.for(marker$1$4);
 var _a$1$3;
@@ -8602,7 +8602,7 @@ var object$1 = ({ schema: inputSchema }) => {
 	};
 };
 //#endregion
-//#region ../_vendored/ai_v6/dist/dist-Gd4EIxPM.js
+//#region ../_vendored/ai_v6/dist/dist-Cx98_f-i.js
 var marker$1 = "vercel.ai.error";
 var symbol$1$1 = Symbol.for(marker$1);
 var _a$1$1;
@@ -10755,7 +10755,7 @@ function withoutTrailingSlash(url) {
 	return url == null ? void 0 : url.replace(/\/$/, "");
 }
 //#endregion
-//#region ../_vendored/ai_v6/dist/dist-BoeKQsDe.js
+//#region ../_vendored/ai_v6/dist/dist-pa8X6y1Z.js
 function getContext() {
 	return { headers: {} };
 }
@@ -15273,6 +15273,7 @@ Return nodes with short stable names, a freeform kind, and knowledge records nes
 Use common kinds such as person, task, event, project, organization, or document when they fit.
 Set node scope to the narrowest level where that identity and content should be shared. Omit it to use the configured default scope.
 Knowledge records must be grounded in the conversation, concise, and written as prose. Do not infer unstated information.
+When the conversation states a canonical identifier or URL for an entity, preserve it verbatim in the record text.
 Wrap every named node mentioned in record text in [[wikilinks]].
 Set a record scope only when the conversation establishes where it applies. Use org for organization-wide records, resource for records shared across this resource's conversations, and thread for conversation-private records.
 Omit scope when uncertain; omitted record scopes stay private to the current thread.
@@ -16144,7 +16145,7 @@ function createKnowledgeWriteTools(memory, options) {
 		}),
 		knowledge_update_node: createTool({
 			id: "knowledge_update_node",
-			description: "Update a visible node name or kind using optimistic concurrency.",
+			description: "Update a visible node name or kind using optimistic concurrency. Provide at least one of name or kind.",
 			inputSchema: {
 				type: "object",
 				properties: {
@@ -16166,11 +16167,11 @@ function createKnowledgeWriteTools(memory, options) {
 					}
 				},
 				required: ["node", "expectedVersion"],
-				anyOf: [{ required: ["name"] }, { required: ["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}`);
@@ -16248,6 +16249,48 @@ function createKnowledgeWriteTools(memory, options) {
 				});
 			}
 		}),
+		knowledge_write_node_description: createTool({
+			id: "knowledge_write_node_description",
+			description: `Write the bounded synopsis (max ${MAX_KNOWLEDGE_NODE_DESCRIPTION_LENGTH} UTF-16 code units) on an existing visible node using optimistic concurrency. Pass an empty string to clear it. Does not create nodes.`,
+			inputSchema: {
+				type: "object",
+				properties: {
+					node: {
+						type: "string",
+						minLength: 1
+					},
+					expectedVersion: {
+						type: "integer",
+						minimum: 1
+					},
+					description: {
+						type: "string",
+						minLength: 0,
+						maxLength: MAX_KNOWLEDGE_NODE_DESCRIPTION_LENGTH,
+						description: `One or two plain-text sentences describing the node, targeting 40-75 tokens. Hard limit ${MAX_KNOWLEDGE_NODE_DESCRIPTION_LENGTH} UTF-16 code units, enforced by storage on every write; the length check on execution is authoritative. Long-form detail belongs in node content, not here. An empty string clears the description.`
+					}
+				},
+				required: [
+					"node",
+					"expectedVersion",
+					"description"
+				],
+				additionalProperties: false
+			},
+			execute: async (input) => {
+				const value = input;
+				if (value.description.length > MAX_KNOWLEDGE_NODE_DESCRIPTION_LENGTH) throw new Error(`Node descriptions are limited to ${MAX_KNOWLEDGE_NODE_DESCRIPTION_LENGTH} UTF-16 code units. Shorten the description and retry.`);
+				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({
+					id: node.id,
+					version: value.expectedVersion,
+					description: value.description
+				});
+			}
+		}),
 		knowledge_write_node_content: createTool({
 			id: "knowledge_write_node_content",
 			description: "Create or replace long-form content on a scoped knowledge node. Existing nodes require expectedVersion.",
@@ -16456,7 +16499,7 @@ var KnowledgeSemanticIndexCoordinator = class {
 			const node = await this.#knowledge.getNode(entry.documentId.slice(15));
 			if (!node || node.mergedInto) return null;
 			return {
-				text: `${node.name}\n${node.content ?? ""}`,
+				text: node.description ? `${node.name}\n${node.description}\n${node.content ?? ""}` : `${node.name}\n${node.content ?? ""}`,
 				name: node.name,
 				scope: node.scope,
 				recordId: node.id,
@@ -16526,7 +16569,14 @@ var subconscious_exports = /* @__PURE__ */ __exportAll({
 });
 const BUILT_IN_OBSERVATION = /* @__PURE__ */ new Set(["capture", "remind"]);
 const BUILT_IN_REFLECTION = /* @__PURE__ */ new Set(["curate", "learn"]);
-const DEFAULT_MAX_STEPS = 5;
+const DEFAULT_MAX_STEPS = 50;
+/**
+* Curation walks a worklist that can reach hundreds of records, and its completion marker is
+* fail-closed: a curator that runs out of steps advances no cursor at all. It gets a much larger
+* default budget than the other agents, which each handle a single bounded prompt.
+*/
+const DEFAULT_MAX_STEPS_BY_AGENT = { curate: 200 };
+const MAX_MAX_STEPS = 500;
 const DEFAULT_RECENT_UPDATES = 10;
 const MAX_RECENT_UPDATES = 100;
 function entryName(entry) {
@@ -16543,7 +16593,7 @@ function assertUniqueNames(entries, phase) {
 }
 function boundedSteps(entry, fallback) {
 	const steps = entry?.maxSteps ?? fallback;
-	if (!Number.isInteger(steps) || steps < 1 || steps > 25) throw new Error("Subconscious maxSteps must be an integer between 1 and 25.");
+	if (!Number.isInteger(steps) || steps < 1 || steps > MAX_MAX_STEPS) throw new Error(`Subconscious maxSteps must be an integer between 1 and ${MAX_MAX_STEPS}.`);
 	return steps;
 }
 function resolveExtractor(entry) {
@@ -16558,12 +16608,13 @@ function resolveExtractor(entry) {
 function resolveAgent(entry, builtIns, globalModel, globalMaxSteps) {
 	const config = typeof entry === "string" ? void 0 : entry;
 	const name = entryName(entry);
+	const fallbackMaxSteps = globalMaxSteps ?? DEFAULT_MAX_STEPS_BY_AGENT[name] ?? DEFAULT_MAX_STEPS;
 	return {
 		name,
 		instructions: config?.instructions,
 		model: config?.model ?? globalModel,
 		agent: config?.agent,
-		maxSteps: boundedSteps(config, globalMaxSteps),
+		maxSteps: boundedSteps(config, fallbackMaxSteps),
 		builtIn: builtIns.has(name)
 	};
 }
@@ -16580,7 +16631,7 @@ var Subconscious = class {
 		const reflection = config.reflection ?? ["curate", "learn"];
 		assertUniqueNames(observation, "observation");
 		assertUniqueNames(reflection, "reflection");
-		const maxSteps = boundedSteps(config, DEFAULT_MAX_STEPS);
+		const maxSteps = config.maxSteps === void 0 ? void 0 : boundedSteps(config, DEFAULT_MAX_STEPS);
 		for (const entry of observation) this.#validateObservationEntry(entry);
 		for (const entry of reflection) this.#validateReflectionEntry(entry);
 		const recentUpdates = config.activity === false ? false : config.activity?.recentUpdates ?? DEFAULT_RECENT_UPDATES;
@@ -16674,6 +16725,8 @@ const DEFAULT_INSTRUCTIONS$1 = `Maintain durable scoped knowledge from the commi
 
 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.
 
+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.
+
 Process the worklist in ID order. Every time you finish processing a KnowledgeRecord, include <curation-complete through="RECORD_ID" /> in your next text response with that record's ID. The latest marker is your acknowledged cursor, so progress survives if you run out of steps mid-batch. Your final response must end with the marker for the last KnowledgeRecord you fully processed. If you cannot finish the batch, acknowledge only the last KnowledgeRecord you did finish. Do not emit a completion marker when no KnowledgeRecord was fully processed.`;
 const PINNED_INSTRUCTIONS = `Maintain the pin set with knowledge_pin, knowledge_edit_pin, and knowledge_unpin. Pinned entries are delivered to the main agent on every turn, so they cost tokens permanently and must stay short. Pin only knowledge that should apply without being asked for, such as standing instructions, durable preferences, and hard constraints. Pin only knowledge that is BOTH costly to rediscover AND not the kind of thing a future agent would think to search for; anything a reminder can surface on demand does not belong in the pin set. Unpin an entry as soon as it stops being unconditionally true.`;
 function resolveScope$1(context) {
@@ -16685,6 +16738,11 @@ function resolveScope$1(context) {
 		`thread:${context.parentThreadId}`
 	]);
 }
+/**
+* Upper bound on records pulled into a single reflection prompt. `hasMore` tells the agent the
+* worklist was truncated; the cursor it advances lets the next cycle pick up the remainder.
+*/
+const MAX_WORKLIST_RECORDS$1 = 1e3;
 async function readWorklist$1(store, sourceThreadId, scope, after) {
 	const records = [];
 	let cursor = after;
@@ -16698,7 +16756,7 @@ async function readWorklist$1(store, sourceThreadId, scope, after) {
 		});
 		records.push(...page.records);
 		cursor = page.nextCursor;
-	} while (cursor && records.length < 500);
+	} while (cursor && records.length < MAX_WORKLIST_RECORDS$1);
 	return {
 		records,
 		hasMore: Boolean(cursor)
@@ -16820,6 +16878,8 @@ function resolveScope(context) {
 		`thread:${context.parentThreadId}`
 	]);
 }
+/** Upper bound on records pulled into a single reflection prompt; `hasMore` signals truncation. */
+const MAX_WORKLIST_RECORDS = 1e3;
 async function readWorklist(store, sourceThreadId, scope, after) {
 	const records = [];
 	let cursor = after;
@@ -16832,7 +16892,7 @@ async function readWorklist(store, sourceThreadId, scope, after) {
 		});
 		records.push(...page.records);
 		cursor = page.nextCursor;
-	} while (cursor && records.length < 500);
+	} while (cursor && records.length < MAX_WORKLIST_RECORDS);
 	return {
 		records,
 		hasMore: Boolean(cursor)
@@ -31495,4 +31555,4 @@ Notes:
 //#endregion
 export { formatMessagesForObserver as A, OBSERVATION_CONTINUATION_HINT as B, SUMMARIZE_THREAD_DEFAULTS as C, buildObserverPrompt as D, OBSERVER_SYSTEM_PROMPT as E, parseAnchorId as F, ModelByInputTokens as G, KnowledgeSemanticIndexCoordinator as H, stripEphemeralAnchorIds as I, SUBCONSCIOUS_ACTIVITY_STATE_ID as J, SubconsciousCaptureExtractor as K, OBSERVATIONAL_MEMORY_DEFAULTS as L, optimizeObservationsForContext as M, parseObserverOutput as N, buildObserverSystemPrompt as O, injectAnchorIds as P, Extractor as Q, OBSERVATION_CONTEXT_INSTRUCTIONS as R, WorkingMemoryExtractor as S, TokenCounter as T, StaleKnowledgeSemanticIndexError as U, Subconscious as V, SubconsciousRemindExtractor as W, publishSubconsciousActivity as X, buildSubconsciousActivitySnapshot as Y, renderSubconsciousActivity as Z, wrapInObservationGroup as _, extractWorkingMemoryContent as a, WorkingMemoryStateProcessor as b, getObservationsAsOf as c, combineObservationGroupRanges as d, deriveObservationGroupProvenance as f, stripObservationGroups as g, renderObservationGroupsForReflection as h, WorkingMemory as i, hasCurrentTaskSection as j, extractCurrentTask as k, ObservationalMemoryProcessor as l, reconcileObservationGroupsFromReflection as m, MessageHistory$1 as n, extractWorkingMemoryTags as o, parseObservationGroups as p, subconsciousCaptureSchema as q, SemanticRecall as r, removeWorkingMemoryTags as s, Memory as t, ObservationalMemory as u, WORKING_MEMORY_STATE_ID as v, summarizeConversation as w, deepMergeWorkingMemory as x, WORKING_MEMORY_STATE_PROCESSOR_ID as y, OBSERVATION_CONTEXT_PROMPT as z };
 
-//# sourceMappingURL=src-BATJenuZ.js.map
+//# sourceMappingURL=src-BNtoxIHL.js.map