@mastra/pg 1.33.0-alpha.3 → 1.33.0

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-pg
 description: Documentation for @mastra/pg. Use when working with @mastra/pg APIs, configuration, or implementation.
 metadata:
   package: "@mastra/pg"
-  version: "1.33.0-alpha.3"
+  version: "1.33.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.33.0-alpha.3",
+  "version": "1.33.0",
   "package": "@mastra/pg",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-memory-semantic-recall.md

@@ -456,8 +456,10 @@ const agent = new Agent({
         indexConfig: {
           type: 'hnsw', // Use HNSW for better performance
           metric: 'dotproduct', // Best for OpenAI embeddings
-          m: 16, // Number of bi-directional links (default: 16)
-          efConstruction: 64, // Size of candidate list during construction (default: 64)
+          hnsw: {
+            m: 16, // Number of bi-directional links (default: 16)
+            efConstruction: 64, // Size of candidate list during construction (default: 64)
+          },
         },
       },
     },

package/dist/docs/references/reference-memory-memory-class.md

@@ -4,7 +4,7 @@
 
 # Memory class
 
-The `Memory` class provides a reliable system for managing conversation history and thread-based message storage in Mastra. It enables persistent storage of conversations, semantic search capabilities, and efficient message retrieval. You must configure a storage provider for conversation history, and if you enable semantic recall you will also need to provide a vector store and embedder.
+The `Memory` class provides a reliable system for managing conversation history and thread-based message storage in Mastra. It enables persistent storage of conversations, semantic search capabilities, and efficient message retrieval. You must configure a storage provider for conversation history, and if you enable semantic recall you will also need to provide a vector store and, unless that vector store embeds text itself, an embedder.
 
 ## Usage example
 
@@ -31,11 +31,11 @@ export const agent = new Agent({
 
 ## Constructor parameters
 
-**storage** (`MastraCompositeStore`): Storage implementation for persisting memory data. Defaults to new DefaultStorage({ config: { url: "file:memory.db" } }) if not provided.
+**storage** (`MastraCompositeStore`): Storage implementation for persisting memory data. Optional: when omitted, an agent uses the storage of the Mastra instance it belongs to. If neither is configured, accessing memory.storage throws Memory requires a storage provider to function.
 
 **vector** (`MastraVector | false`): Vector store for semantic search capabilities. Set to false to disable vector operations.
 
-**embedder** (`EmbeddingModel<string> | EmbeddingModelV2<string>`): Embedder instance for vector embeddings. Required when semantic recall is enabled.
+**embedder** (`string | EmbeddingModel<string> | EmbeddingModelV2<string>`): Embedder for vector embeddings, as a model-router ID string (for example "openai/text-embedding-3-small"), an EmbeddingModel, or an EmbeddingModelV2. Required when semantic recall is enabled and the vector store doesn't generate embeddings itself (vector.isSelfEmbedding is false).
 
 **embeddingDimension** (`number`): Output dimension of the embedder, as a positive integer. When set, Memory uses it to name the semantic recall index instead of embedding a probe string on first use. It must match the vectors the embedder returns: a mismatch throws a MASTRA_MEMORY_EMBEDDING_DIMENSION_MISMATCH error before any index is created. See Setting the embedding dimension.
 
@@ -49,7 +49,7 @@ export const agent = new Agent({
 
 **options.retainFullInput** (`boolean`): When true, the request input is processed exactly as supplied instead of being filtered against stored history. Use this when you assemble the input yourself and need the message sequence preserved. Stored history is still loaded underneath, and every input message that isn't already stored is saved to the thread, including few-shot examples. Can be set per call on memory.options or agent-wide in the memory constructor options.
 
-**options.semanticRecall** (`boolean | { topK: number; messageRange: number | { before: number; after: number }; scope?: 'thread' | 'resource' }`): Enable semantic search in message history. Can be a boolean or an object with configuration options. When enabled, requires both vector store and embedder to be configured. Default topK is 4, default messageRange is {before: 1, after: 1}.
+**options.semanticRecall** (`boolean | { topK: number; messageRange: number | { before: number; after: number }; scope?: 'thread' | 'resource' }`): Enable semantic search in message history. Can be a boolean or an object with configuration options. When enabled, requires a vector store, and an embedder unless the vector store embeds text itself (isSelfEmbedding). Default topK is 4, default messageRange is {before: 1, after: 1}.
 
 **options.workingMemory** (`WorkingMemory`): Configuration for working memory feature. Can be { enabled: boolean; template?: string; schema?: ZodObject\<any> | JSONSchema7; scope?: 'thread' | 'resource' } or { enabled: boolean } to disable.
 
@@ -128,8 +128,10 @@ export const agent = new Agent({
         indexConfig: {
           type: 'hnsw', // Use HNSW for better performance
           metric: 'dotproduct', // Optimal for OpenAI embeddings
-          m: 16, // Number of bi-directional links
-          efConstruction: 64, // Construction-time candidate list size
+          hnsw: {
+            m: 16, // Number of bi-directional links
+            efConstruction: 64, // Construction-time candidate list size
+          },
         },
       },
       workingMemory: {

package/dist/index.cjs

@@ -262,7 +262,7 @@ const createNumericOperator = (symbol) => {
 			sql: `(CASE WHEN jsonb_typeof(${jsonExtract}) = 'number' THEN (${textExtract})::numeric ${symbol} $${paramIndex}::numeric ELSE NULL END)`,
 			needsValue: true
 		};
-		else return {
+		return {
 			sql: `${textExtract} ${symbol} $${paramIndex}::text`,
 			needsValue: true
 		};
@@ -16126,6 +16126,51 @@ const SPAN_EVENT_COLUMNS = [
 		type: "double precision",
 		nullable: true
 	},
+	{
+		name: "externalParentSpanId",
+		type: "text",
+		nullable: true
+	},
+	{
+		name: "resumedFromSpanId",
+		type: "text",
+		nullable: true
+	},
+	{
+		name: "model",
+		type: "text",
+		nullable: true
+	},
+	{
+		name: "provider",
+		type: "text",
+		nullable: true
+	},
+	{
+		name: "outcome",
+		type: "text",
+		nullable: true
+	},
+	{
+		name: "stopReason",
+		type: "text",
+		nullable: true
+	},
+	{
+		name: "timeToFirstTokenMs",
+		type: "double precision",
+		nullable: true
+	},
+	{
+		name: "errorCount",
+		type: "integer",
+		nullable: true
+	},
+	{
+		name: "stopReasonContext",
+		type: "jsonb",
+		nullable: true
+	},
 	{
 		name: "tags",
 		type: "text[]",
@@ -16834,6 +16879,26 @@ function allTableDDL(schema, mode) {
 	];
 }
 /**
+* Span event columns added after the table first shipped, with their types. All
+* nullable with no default, so each ALTER is a catalog-only change; rows written
+* before it read NULL and readers fall back to the payload or attributes.
+*/
+const ADDED_SPAN_COLUMNS = [
+	["inputPreview", "text"],
+	["outputPreview", "text"],
+	["errorPreview", "text"],
+	["timeToFirstChunkMs", "double precision"],
+	["externalParentSpanId", "text"],
+	["resumedFromSpanId", "text"],
+	["model", "text"],
+	["provider", "text"],
+	["outcome", "text"],
+	["stopReason", "text"],
+	["timeToFirstTokenMs", "double precision"],
+	["errorCount", "integer"],
+	["stopReasonContext", "jsonb"]
+];
+/**
 * Additive column migrations for tables created by an older version of this
 * schema. `CREATE TABLE IF NOT EXISTS` is a no-op on an existing table, so new
 * columns have to be added out of band.
@@ -16850,20 +16915,11 @@ function additiveColumns(schema) {
 			column: "isPending",
 			ddl: `ALTER TABLE ${qualifiedTable(schema, TABLE_SPAN_EVENTS)} ADD COLUMN IF NOT EXISTS "isPending" boolean NOT NULL DEFAULT false`
 		},
-		...[
-			"inputPreview",
-			"outputPreview",
-			"errorPreview"
-		].map((column) => ({
+		...ADDED_SPAN_COLUMNS.map(([column, type]) => ({
 			table: TABLE_SPAN_EVENTS,
 			column,
-			ddl: `ALTER TABLE ${qualifiedTable(schema, TABLE_SPAN_EVENTS)} ADD COLUMN IF NOT EXISTS "${column}" text`
+			ddl: `ALTER TABLE ${qualifiedTable(schema, TABLE_SPAN_EVENTS)} ADD COLUMN IF NOT EXISTS "${column}" ${type}`
 		})),
-		{
-			table: TABLE_SPAN_EVENTS,
-			column: "timeToFirstChunkMs",
-			ddl: `ALTER TABLE ${qualifiedTable(schema, TABLE_SPAN_EVENTS)} ADD COLUMN IF NOT EXISTS "timeToFirstChunkMs" double precision`
-		},
 		{
 			table: TABLE_FEEDBACK_EVENTS,
 			column: "reviewStatus",
@@ -17416,6 +17472,11 @@ const PROMOTED_KEYS = /* @__PURE__ */ new Set([
 	"executionSource",
 	"serviceName"
 ]);
+function nullableNumber$1(value) {
+	if (value == null || value === "") return null;
+	const n = Number(value);
+	return Number.isNaN(n) ? null : n;
+}
 function nullableString(value) {
 	if (typeof value === "string") return value === "" ? null : value;
 	if (value == null) return null;
@@ -17577,6 +17638,15 @@ function spanRecordToRow(span) {
 		startedAt: toIsoOrDate(span.startedAt),
 		endedAt: toIsoOrDate(endedAt),
 		timeToFirstChunkMs: span.timeToFirstChunkMs ?? null,
+		externalParentSpanId: span.externalParentSpanId ?? null,
+		resumedFromSpanId: span.resumedFromSpanId ?? null,
+		model: span.model ?? null,
+		provider: span.provider ?? null,
+		outcome: span.outcome ?? null,
+		stopReason: span.stopReason ?? null,
+		stopReasonContext: jsonField(span.stopReasonContext),
+		timeToFirstTokenMs: span.timeToFirstTokenMs ?? null,
+		errorCount: span.errorCount ?? null,
 		tags: normalizeTags(span.tags),
 		metadataSearch: buildMetadataSearch(metadata),
 		metadataRaw: jsonField(metadata),
@@ -17606,6 +17676,7 @@ function rowToSpanRecord(row) {
 	const startedAt = toDate(row.startedAt);
 	const endedAt = spanRowEndedAt(row, startedAt);
 	const error = parsedJson(row.error);
+	const attributes = parsedJson(row.attributes);
 	const { executionSource, ...ctx } = rowToCommonContext(row);
 	return {
 		...ctx,
@@ -17618,10 +17689,19 @@ function rowToSpanRecord(row) {
 		isEvent: Boolean(row.isEvent),
 		startedAt,
 		endedAt,
+		externalParentSpanId: nullableString(row.externalParentSpanId),
+		resumedFromSpanId: nullableString(row.resumedFromSpanId),
+		model: nullableString(row.model) ?? (0, _mastra_core_storage.getStringAttribute)(attributes, "model"),
+		provider: nullableString(row.provider) ?? (0, _mastra_core_storage.getStringAttribute)(attributes, "provider"),
+		outcome: nullableString(row.outcome),
+		stopReason: nullableString(row.stopReason),
+		stopReasonContext: parsedJson(row.stopReasonContext) ?? null,
+		timeToFirstTokenMs: nullableNumber$1(row.timeToFirstTokenMs),
+		errorCount: nullableNumber$1(row.errorCount),
 		tags: normalizeTags(row.tags),
 		metadata: parsedJson(row.metadataRaw) ?? void 0,
 		scope: parsedJson(row.scope) ?? void 0,
-		attributes: parsedJson(row.attributes) ?? void 0,
+		attributes: attributes ?? void 0,
 		links: parsedJson(row.links) ?? void 0,
 		input: parsedJson(row.input) ?? void 0,
 		output: parsedJson(row.output) ?? void 0,