@mastra/pg 1.32.0 → 1.33.0-alpha.1

package/dist/_types/@internal_core/dist/knowledge-compat/index.d.ts

@@ -1,10 +1,10 @@
 //#region src/knowledge-compat/index.d.ts
-declare const KNOWLEDGE_V2_CORE_FEATURE = "knowledge-v2";
-declare const KNOWLEDGE_STORAGE_CONTRACT_VERSION: 2;
-declare const KNOWLEDGE_STORAGE_SCHEMA_VERSION: 2;
+export declare const KNOWLEDGE_V2_CORE_FEATURE = "knowledge-v2";
+export declare const KNOWLEDGE_STORAGE_CONTRACT_VERSION: 2;
+export declare const KNOWLEDGE_STORAGE_SCHEMA_VERSION: 2;
 /** Hard cap on scope nodes returned by one `listScopeNodes` read. */
-declare const MAX_KNOWLEDGE_SCOPE_NODES = 1000;
-interface ListKnowledgeScopeNodesInput {
+export declare const MAX_KNOWLEDGE_SCOPE_NODES = 1000;
+export interface ListKnowledgeScopeNodesInput {
   /** Only the scope at this address and the scopes beneath it, following parent edges transitively. */
   withinAddress?: string;
   /** Only the scopes at these exact addresses. */
@@ -16,15 +16,15 @@ interface ListKnowledgeScopeNodesInput {
   /** Page size, from 1 to `MAX_KNOWLEDGE_SCOPE_NODES` (the default). */
   limit?: number;
 }
-interface ListKnowledgeScopeNodesOutput {
+export interface ListKnowledgeScopeNodesOutput {
   /** Scope nodes ordered by name, then id. */
   scopes: KnowledgeScopeNodeSummary[];
   /** Pass back as `cursor` for the next page; `null` when this is the last page. */
   nextCursor: string | null;
 }
-declare function createKnowledgeScopeNodeCursor(scope: Pick<KnowledgeScopeNodeSummary, 'name' | 'id'>, input: ListKnowledgeScopeNodesInput): string;
+export declare function createKnowledgeScopeNodeCursor(scope: Pick<KnowledgeScopeNodeSummary, 'name' | 'id'>, input: ListKnowledgeScopeNodesInput): string;
 /** Validates the page size and cursor of a `listScopeNodes` query; throws on a cursor from a different query. */
-declare function parseListKnowledgeScopeNodesInput(input?: ListKnowledgeScopeNodesInput): {
+export declare function parseListKnowledgeScopeNodesInput(input?: ListKnowledgeScopeNodesInput): {
   limit: number;
   after: {
     name: string;
@@ -32,9 +32,9 @@ declare function parseListKnowledgeScopeNodesInput(input?: ListKnowledgeScopeNod
   } | null;
 };
 /** Builds a page from up to `limit + 1` name/id-ordered scope nodes. */
-declare function pageKnowledgeScopeNodes(rows: KnowledgeScopeNodeSummary[], limit: number, input: ListKnowledgeScopeNodesInput): ListKnowledgeScopeNodesOutput;
+export declare function pageKnowledgeScopeNodes(rows: KnowledgeScopeNodeSummary[], limit: number, input: ListKnowledgeScopeNodesInput): ListKnowledgeScopeNodesOutput;
 /** A node placed inside a structural scope. Child scopes are members too, with `scope: null`. */
-interface KnowledgeScopeMember {
+export interface KnowledgeScopeMember {
   id: string;
   type: 'node';
   name: string;
@@ -47,14 +47,14 @@ interface KnowledgeScopeMember {
   createdAt: Date;
   updatedAt: Date;
 }
-interface ListKnowledgeScopeMembersInput {
+export interface ListKnowledgeScopeMembersInput {
   scopeNodeId: string;
   /** `nextCursor` from the previous page for the same scope. */
   cursor?: string;
   /** Members to return, 1–500 (default 500). */
   limit?: number;
 }
-interface ListKnowledgeScopeMembersOutput {
+export interface ListKnowledgeScopeMembersOutput {
   /** Most recently updated members first (ties by name, then ID), at most `limit`. */
   members: KnowledgeScopeMember[];
   /** True when the scope has more members than were returned. */
@@ -62,11 +62,11 @@ interface ListKnowledgeScopeMembersOutput {
   /** Pass as `cursor` to read the next page; `null` on the last page. */
   nextCursor: string | null;
 }
-declare const MAX_KNOWLEDGE_SCOPE_MEMBERS_LIMIT = 500;
+export declare const MAX_KNOWLEDGE_SCOPE_MEMBERS_LIMIT = 500;
 /** Clamps a requested member limit to 1–{@link MAX_KNOWLEDGE_SCOPE_MEMBERS_LIMIT}. */
-declare function knowledgeScopeMembersLimit(limit: number | undefined): number;
+export declare function knowledgeScopeMembersLimit(limit: number | undefined): number;
 /** Validates the page size and cursor of a `listScopeMembers` query; throws on a cursor from another scope. */
-declare function parseListKnowledgeScopeMembersInput(input: ListKnowledgeScopeMembersInput): {
+export declare function parseListKnowledgeScopeMembersInput(input: ListKnowledgeScopeMembersInput): {
   limit: number;
   after: {
     updatedAt: Date;
@@ -75,9 +75,9 @@ declare function parseListKnowledgeScopeMembersInput(input: ListKnowledgeScopeMe
   } | null;
 };
 /** Builds a page from up to `limit + 1` members in `listScopeMembers` order. */
-declare function pageKnowledgeScopeMembers(rows: KnowledgeScopeMember[], limit: number, input: ListKnowledgeScopeMembersInput): ListKnowledgeScopeMembersOutput;
+export declare function pageKnowledgeScopeMembers(rows: KnowledgeScopeMember[], limit: number, input: ListKnowledgeScopeMembersInput): ListKnowledgeScopeMembersOutput;
 /** A reconciled structural scope node with its containing scope nodes. */
-interface KnowledgeScopeNodeSummary {
+export interface KnowledgeScopeNodeSummary {
   /** UUID of the `isScope` node. */
   id: string;
   /** Canonical address the scope node was reconciled from (e.g. `features:memory`). */
@@ -88,22 +88,22 @@ interface KnowledgeScopeNodeSummary {
   /** UUIDs of the scope nodes that contain this scope (membership edges). */
   parentIds: string[];
 }
-declare const TABLE_KNOWLEDGE_NODE_SCOPES = "mastra_knowledge_node_scopes";
-declare const TABLE_KNOWLEDGE_RECORD_SCOPES = "mastra_knowledge_record_scopes";
-declare const TABLE_KNOWLEDGE_SCOPE_GRANTS = "mastra_knowledge_scope_grants";
-declare const TABLE_KNOWLEDGE_ACCESS_STATE = "mastra_knowledge_access_state";
-declare const TABLE_KNOWLEDGE_SCOPE_ADDRESSES = "mastra_knowledge_scope_addresses";
-declare const TABLE_KNOWLEDGE_NODE_ADDRESSES = "mastra_knowledge_node_addresses";
-declare const TABLE_KNOWLEDGE_IMPORT_STATE = "mastra_knowledge_import_state";
-declare const TABLE_KNOWLEDGE_IMPORT_RUNS = "mastra_knowledge_import_runs";
-declare const TABLE_KNOWLEDGE_PROPOSALS = "mastra_knowledge_proposals";
-declare const KNOWLEDGE_TABLE_NAMES: readonly ["mastra_knowledge_nodes", "mastra_knowledge_records", "mastra_knowledge_mentions", "mastra_knowledge_activity", "mastra_knowledge_semantic_outbox", "mastra_knowledge_node_scopes", "mastra_knowledge_record_scopes", "mastra_knowledge_scope_grants", "mastra_knowledge_access_state", "mastra_knowledge_scope_addresses", "mastra_knowledge_node_addresses", "mastra_knowledge_import_state", "mastra_knowledge_import_runs", "mastra_knowledge_proposals"];
+export declare const TABLE_KNOWLEDGE_NODE_SCOPES = "mastra_knowledge_node_scopes";
+export declare const TABLE_KNOWLEDGE_RECORD_SCOPES = "mastra_knowledge_record_scopes";
+export declare const TABLE_KNOWLEDGE_SCOPE_GRANTS = "mastra_knowledge_scope_grants";
+export declare const TABLE_KNOWLEDGE_ACCESS_STATE = "mastra_knowledge_access_state";
+export declare const TABLE_KNOWLEDGE_SCOPE_ADDRESSES = "mastra_knowledge_scope_addresses";
+export declare const TABLE_KNOWLEDGE_NODE_ADDRESSES = "mastra_knowledge_node_addresses";
+export declare const TABLE_KNOWLEDGE_IMPORT_STATE = "mastra_knowledge_import_state";
+export declare const TABLE_KNOWLEDGE_IMPORT_RUNS = "mastra_knowledge_import_runs";
+export declare const TABLE_KNOWLEDGE_PROPOSALS = "mastra_knowledge_proposals";
+export declare const KNOWLEDGE_TABLE_NAMES: readonly ["mastra_knowledge_nodes", "mastra_knowledge_records", "mastra_knowledge_mentions", "mastra_knowledge_activity", "mastra_knowledge_semantic_outbox", "mastra_knowledge_node_scopes", "mastra_knowledge_record_scopes", "mastra_knowledge_scope_grants", "mastra_knowledge_access_state", "mastra_knowledge_scope_addresses", "mastra_knowledge_node_addresses", "mastra_knowledge_import_state", "mastra_knowledge_import_runs", "mastra_knowledge_proposals"];
 /** Knowledge v1 tables with no v2 equivalent; an explicit schema reset drops them. */
-declare const RETIRED_KNOWLEDGE_TABLE_NAMES: readonly ['mastra_knowledge_cursors'];
+export declare const RETIRED_KNOWLEDGE_TABLE_NAMES: readonly ['mastra_knowledge_cursors'];
 /** Tables and indexes published v1 adapters created for every app, whether or not it used Knowledge. */
-declare const PUBLISHED_KNOWLEDGE_V1_TABLE_NAMES: ReadonlySet<string>;
-declare const PUBLISHED_KNOWLEDGE_V1_INDEX_NAMES: ReadonlySet<string>;
-declare const KNOWLEDGE_V2_NODES_SCHEMA: {
+export declare const PUBLISHED_KNOWLEDGE_V1_TABLE_NAMES: ReadonlySet<string>;
+export declare const PUBLISHED_KNOWLEDGE_V1_INDEX_NAMES: ReadonlySet<string>;
+export declare const KNOWLEDGE_V2_NODES_SCHEMA: {
   readonly id: {
     readonly type: 'text';
     readonly nullable: false;
@@ -174,7 +174,7 @@ declare const KNOWLEDGE_V2_NODES_SCHEMA: {
     readonly nullable: true;
   };
 };
-declare const KNOWLEDGE_V2_RECORDS_SCHEMA: {
+export declare const KNOWLEDGE_V2_RECORDS_SCHEMA: {
   readonly id: {
     readonly type: 'text';
     readonly nullable: false;
@@ -233,7 +233,7 @@ declare const KNOWLEDGE_V2_RECORDS_SCHEMA: {
     readonly nullable: true;
   };
 };
-declare const KNOWLEDGE_V2_MENTIONS_SCHEMA: {
+export declare const KNOWLEDGE_V2_MENTIONS_SCHEMA: {
   readonly recordId: {
     readonly type: 'text';
     readonly nullable: false;
@@ -259,7 +259,7 @@ declare const KNOWLEDGE_V2_MENTIONS_SCHEMA: {
     readonly nullable: true;
   };
 };
-declare const KNOWLEDGE_NODE_SCOPES_SCHEMA: {
+export declare const KNOWLEDGE_NODE_SCOPES_SCHEMA: {
   readonly nodeId: {
     readonly type: 'text';
     readonly nullable: false;
@@ -281,7 +281,7 @@ declare const KNOWLEDGE_NODE_SCOPES_SCHEMA: {
     readonly nullable: false;
   };
 };
-declare const KNOWLEDGE_RECORD_SCOPES_SCHEMA: {
+export declare const KNOWLEDGE_RECORD_SCOPES_SCHEMA: {
   readonly recordId: {
     readonly type: 'text';
     readonly nullable: false;
@@ -303,7 +303,7 @@ declare const KNOWLEDGE_RECORD_SCOPES_SCHEMA: {
     readonly nullable: false;
   };
 };
-declare const KNOWLEDGE_SCOPE_GRANTS_SCHEMA: {
+export declare const KNOWLEDGE_SCOPE_GRANTS_SCHEMA: {
   readonly scopeNodeId: {
     readonly type: 'text';
     readonly nullable: false;
@@ -329,7 +329,7 @@ declare const KNOWLEDGE_SCOPE_GRANTS_SCHEMA: {
     readonly nullable: true;
   };
 };
-declare const KNOWLEDGE_ACCESS_STATE_SCHEMA: {
+export declare const KNOWLEDGE_ACCESS_STATE_SCHEMA: {
   readonly id: {
     readonly type: 'text';
     readonly nullable: false;
@@ -344,7 +344,7 @@ declare const KNOWLEDGE_ACCESS_STATE_SCHEMA: {
     readonly nullable: false;
   };
 };
-declare const KNOWLEDGE_SCOPE_ADDRESSES_SCHEMA: {
+export declare const KNOWLEDGE_SCOPE_ADDRESSES_SCHEMA: {
   readonly address: {
     readonly type: 'text';
     readonly nullable: false;
@@ -359,7 +359,7 @@ declare const KNOWLEDGE_SCOPE_ADDRESSES_SCHEMA: {
     };
   };
 };
-declare const KNOWLEDGE_NODE_ADDRESSES_SCHEMA: {
+export declare const KNOWLEDGE_NODE_ADDRESSES_SCHEMA: {
   readonly source: {
     readonly type: 'text';
     readonly nullable: false;
@@ -377,7 +377,7 @@ declare const KNOWLEDGE_NODE_ADDRESSES_SCHEMA: {
     };
   };
 };
-declare const KNOWLEDGE_IMPORT_STATE_SCHEMA: {
+export declare const KNOWLEDGE_IMPORT_STATE_SCHEMA: {
   readonly importerId: {
     readonly type: 'text';
     readonly nullable: false;
@@ -395,7 +395,7 @@ declare const KNOWLEDGE_IMPORT_STATE_SCHEMA: {
     readonly nullable: false;
   };
 };
-declare const KNOWLEDGE_IMPORT_RUNS_SCHEMA: {
+export declare const KNOWLEDGE_IMPORT_RUNS_SCHEMA: {
   readonly id: {
     readonly type: 'text';
     readonly nullable: false;
@@ -446,7 +446,7 @@ declare const KNOWLEDGE_IMPORT_RUNS_SCHEMA: {
     readonly nullable: true;
   };
 };
-declare const KNOWLEDGE_V2_ACTIVITY_SCHEMA: {
+export declare const KNOWLEDGE_V2_ACTIVITY_SCHEMA: {
   readonly id: {
     readonly type: 'text';
     readonly nullable: false;
@@ -509,7 +509,7 @@ declare const KNOWLEDGE_V2_ACTIVITY_SCHEMA: {
     readonly nullable: true;
   };
 };
-declare const KNOWLEDGE_PROPOSALS_SCHEMA: {
+export declare const KNOWLEDGE_PROPOSALS_SCHEMA: {
   readonly id: {
     readonly type: 'text';
     readonly nullable: false;
@@ -560,7 +560,7 @@ declare const KNOWLEDGE_PROPOSALS_SCHEMA: {
     readonly nullable: false;
   };
 };
-type KnowledgeSchemaInspection = {
+export type KnowledgeSchemaInspection = {
   status: 'compatible';
   schemaVersion: typeof KNOWLEDGE_STORAGE_SCHEMA_VERSION;
 } | {
@@ -575,7 +575,7 @@ type KnowledgeSchemaInspection = {
   schemaVersion: null;
   reason: string;
 };
-interface KnowledgeSchemaSnapshot {
+export interface KnowledgeSchemaSnapshot {
   available: boolean;
   tableNames: readonly string[];
   schemaVersion?: number;
@@ -587,8 +587,8 @@ interface KnowledgeV2Core {
   assertKnowledgeSchemaCompatible(inspection: KnowledgeSchemaInspection): void;
   inspectKnowledgeSchema(snapshot: KnowledgeSchemaSnapshot): KnowledgeSchemaInspection;
 }
-declare function assertKnowledgeV2CoreSupport(features: ReadonlySet<string>): void;
-declare function createKnowledgeV2CoreLoader(features: ReadonlySet<string>, loadStorageModule: () => Promise<unknown>): () => Promise<KnowledgeV2Core>;
+export declare function assertKnowledgeV2CoreSupport(features: ReadonlySet<string>): void;
+export declare function createKnowledgeV2CoreLoader(features: ReadonlySet<string>, loadStorageModule: () => Promise<unknown>): () => Promise<KnowledgeV2Core>;
 //#endregion
-export { KNOWLEDGE_ACCESS_STATE_SCHEMA, KNOWLEDGE_IMPORT_RUNS_SCHEMA, KNOWLEDGE_IMPORT_STATE_SCHEMA, KNOWLEDGE_NODE_ADDRESSES_SCHEMA, KNOWLEDGE_NODE_SCOPES_SCHEMA, KNOWLEDGE_PROPOSALS_SCHEMA, KNOWLEDGE_RECORD_SCOPES_SCHEMA, KNOWLEDGE_SCOPE_ADDRESSES_SCHEMA, KNOWLEDGE_SCOPE_GRANTS_SCHEMA, KNOWLEDGE_STORAGE_CONTRACT_VERSION, KNOWLEDGE_STORAGE_SCHEMA_VERSION, KNOWLEDGE_TABLE_NAMES, KNOWLEDGE_V2_ACTIVITY_SCHEMA, KNOWLEDGE_V2_CORE_FEATURE, KNOWLEDGE_V2_MENTIONS_SCHEMA, KNOWLEDGE_V2_NODES_SCHEMA, KNOWLEDGE_V2_RECORDS_SCHEMA, KnowledgeSchemaInspection, KnowledgeSchemaSnapshot, KnowledgeScopeMember, KnowledgeScopeNodeSummary, ListKnowledgeScopeMembersInput, ListKnowledgeScopeMembersOutput, ListKnowledgeScopeNodesInput, ListKnowledgeScopeNodesOutput, MAX_KNOWLEDGE_SCOPE_MEMBERS_LIMIT, MAX_KNOWLEDGE_SCOPE_NODES, PUBLISHED_KNOWLEDGE_V1_INDEX_NAMES, PUBLISHED_KNOWLEDGE_V1_TABLE_NAMES, RETIRED_KNOWLEDGE_TABLE_NAMES, TABLE_KNOWLEDGE_ACCESS_STATE, TABLE_KNOWLEDGE_IMPORT_RUNS, TABLE_KNOWLEDGE_IMPORT_STATE, TABLE_KNOWLEDGE_NODE_ADDRESSES, TABLE_KNOWLEDGE_NODE_SCOPES, TABLE_KNOWLEDGE_PROPOSALS, TABLE_KNOWLEDGE_RECORD_SCOPES, TABLE_KNOWLEDGE_SCOPE_ADDRESSES, TABLE_KNOWLEDGE_SCOPE_GRANTS, assertKnowledgeV2CoreSupport, createKnowledgeScopeNodeCursor, createKnowledgeV2CoreLoader, knowledgeScopeMembersLimit, pageKnowledgeScopeMembers, pageKnowledgeScopeNodes, parseListKnowledgeScopeMembersInput, parseListKnowledgeScopeNodesInput };
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/_types/@internal_core/dist/memory/index.d.ts

@@ -9,18 +9,18 @@
  * into the table schema they get from `@mastra/core`, so the columns exist even when the
  * installed core predates them.
  */
-declare const OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS: {
+export declare const OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS: {
   readonly supersededBy: {
     readonly type: 'text';
     readonly nullable: true;
   };
 };
 /** `schema` plus {@link OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS}; `undefined` when `schema` is. */
-declare function withObservationalMemoryLifecycleColumns<T extends object>(schema: T | undefined): (T & typeof OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS) | undefined;
+export declare function withObservationalMemoryLifecycleColumns<T extends object>(schema: T | undefined): (T & typeof OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS) | undefined;
 /**
  * Result of `commitActiveObservations`.
  */
-interface UpdateActiveObservationsResult {
+export interface UpdateActiveObservationsResult {
   /** Whether the observations were written. */
   applied: boolean;
   /**
@@ -38,14 +38,14 @@ interface UpdateActiveObservationsResult {
  * the head's cursor. Chunks carry `lastObservedAt = max message time + 1ms`, so a chunk is
  * wholly covered iff `head.lastObservedAt >= chunk.lastObservedAt - 1ms`.
  */
-interface UpdateBufferedObservationsResult {
+export interface UpdateBufferedObservationsResult {
   /** Whether the chunk was stored. */
   persisted: boolean;
   /** The record the chunk was written to (or would have been written to). */
   recordId: string;
 }
 /** The fields of an observational memory record that decide head order. */
-interface ObservationalMemoryHeadOrderFields {
+export interface ObservationalMemoryHeadOrderFields {
   generationCount: number;
   createdAt: Date | string;
   id: string;
@@ -54,16 +54,16 @@ interface ObservationalMemoryHeadOrderFields {
  * Canonical head order: `generationCount DESC, createdAt ASC, id ASC`.
  * Returns a negative number when `a` sorts before `b` (i.e. `a` is the better head candidate).
  */
-declare function compareObservationalMemoryHeadOrder(a: ObservationalMemoryHeadOrderFields, b: ObservationalMemoryHeadOrderFields): number;
+export declare function compareObservationalMemoryHeadOrder(a: ObservationalMemoryHeadOrderFields, b: ObservationalMemoryHeadOrderFields): number;
 /**
  * A buffered chunk stores `lastObservedAt = max message time + 1ms`. It is wholly covered
  * (every message it observed is already at or before the cursor) iff
  * `cursor >= chunk.lastObservedAt - 1ms`.
  */
-declare function isBufferedChunkCoveredByCursor(chunkLastObservedAt: Date | string, cursor: Date | string | null | undefined): boolean;
+export declare function isBufferedChunkCoveredByCursor(chunkLastObservedAt: Date | string, cursor: Date | string | null | undefined): boolean;
 /** The later of two cursors; `undefined` only when both are absent. */
-declare function maxObservationCursor(a: Date | string | null | undefined, b: Date | string | null | undefined): Date | undefined;
-interface ReflectionTextPlan {
+export declare function maxObservationCursor(a: Date | string | null | undefined, b: Date | string | null | undefined): Date | undefined;
+export interface ReflectionTextPlan {
   /** `equal`: stored text equals the snapshot. `append`: observations were appended after the snapshot. */
   mode: 'equal' | 'append';
   observations: string;
@@ -78,7 +78,7 @@ interface ReflectionTextPlan {
  *   after the reflection, and its tokens are added.
  * - Anything else (a non-append rewrite): `null` — the reflection must not be applied.
  */
-declare function planReflectionGenerationText(input: {
+export declare function planReflectionGenerationText(input: {
   storedObservations: string;
   storedObservationTokenCount: number;
   snapshotObservations: string;
@@ -91,12 +91,11 @@ declare function planReflectionGenerationText(input: {
  * Callers of `updateActiveObservations` (which resolves `void`) can't see a commit result, so a
  * write that was not applied throws instead of resolving as if it had committed.
  */
-declare function assertActiveObservationsApplied(result: UpdateActiveObservationsResult, id: string): void;
+export declare function assertActiveObservationsApplied(result: UpdateActiveObservationsResult, id: string): void;
 /**
  * Whether the stored text can still accept a reflection built from `snapshot`
  * (equal, or only appended to since).
  */
-declare function isAppendOnlySince(storedObservations: string, snapshotObservations: string): boolean;
+export declare function isAppendOnlySince(storedObservations: string, snapshotObservations: string): boolean;
 //#endregion
-export { OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS, ObservationalMemoryHeadOrderFields, ReflectionTextPlan, UpdateActiveObservationsResult, UpdateBufferedObservationsResult, assertActiveObservationsApplied, compareObservationalMemoryHeadOrder, isAppendOnlySince, isBufferedChunkCoveredByCursor, maxObservationCursor, planReflectionGenerationText, withObservationalMemoryLifecycleColumns };
 //# sourceMappingURL=index.d.ts.map

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.32.0"
+  version: "1.33.0-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

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

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

@@ -34,7 +34,7 @@ const agent = new Agent({
   id: 'support-agent',
   name: 'SupportAgent',
   instructions: 'You are a helpful support agent.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'agent-storage',
@@ -64,7 +64,7 @@ const agent = new Agent({
   id: 'support-agent',
   name: 'SupportAgent',
   instructions: 'You are a helpful support agent.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new MongoDBStore({
       id: 'agent-storage',

package/dist/docs/references/docs-memory-working-memory.md

@@ -34,7 +34,7 @@ const agent = new Agent({
   id: 'personal-assistant',
   name: 'PersonalAssistant',
   instructions: 'You are a helpful personal assistant.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     options: {
       workingMemory: {
@@ -418,7 +418,7 @@ const response = await agent.generate('What do you know about me?', {
 
 ## Opt in to state signals (experimental)
 
-By default, working memory reaches the model as part of the system message. You can opt into delivering it as a [state signal](https://mastra.ai/docs/harness/signals) instead by setting `useStateSignals: true`:
+By default, working memory reaches the model as part of the system message. You can opt into delivering it as a [state signal](https://mastra.ai/docs/signals/state-signals) instead by setting `useStateSignals: true`:
 
 ```typescript
 const memory = new Memory({

package/dist/docs/references/docs-storage.md

@@ -146,7 +146,7 @@ export const supportAgent = new Agent({
   id: 'support-agent',
   name: 'Support agent',
   instructions: 'Answer customer support questions.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new PostgresStore({
       id: 'support-agent-storage',

package/dist/docs/references/integrations-databases-postgresql.md

@@ -365,7 +365,7 @@ export const pgAgent = new Agent({
   name: 'PG Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new PostgresStore({
       id: 'pg-agent-storage',

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

@@ -16,7 +16,7 @@ export const agent = new Agent({
   id: 'test-agent',
   name: 'test-agent',
   instructions: 'You are an agent with memory.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     options: {
       workingMemory: {
@@ -71,7 +71,7 @@ import { LibSQLStore, LibSQLVector } from '@mastra/libsql'
 export const agent = new Agent({
   name: 'test-agent',
   instructions: 'You are an agent with memory.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'test-agent-storage',
@@ -108,7 +108,7 @@ import { PostgresStore, PgVector } from '@mastra/pg'
 export const agent = new Agent({
   name: 'pg-agent',
   instructions: 'You are an agent with optimized PostgreSQL memory.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new PostgresStore({
       id: 'pg-agent-storage',

package/dist/docs/references/reference-processors-message-history-processor.md

@@ -23,7 +23,7 @@ const processor = new MessageHistory({
 
 **options.storage** (`MemoryStorage`): Storage instance for retrieving and persisting messages
 
-**options.lastMessages** (`number`): Maximum number of historical messages to retrieve. If not specified, retrieves all messages
+**options.lastMessages** (`number | false`): Maximum number of historical messages to retrieve. Set to false to retrieve all messages. If omitted, the storage adapter's default page size applies (40 messages for built-in adapters)
 
 ## Returns
 
@@ -51,7 +51,7 @@ export const agent = new Agent({
   id: 'memory-agent',
   name: 'memory-agent',
   instructions: 'You are a helpful assistant with conversation memory',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   inputProcessors: [
     new MessageHistory({
       storage,

package/dist/docs/references/reference-processors-semantic-recall-processor.md

@@ -30,7 +30,7 @@ const processor = new SemanticRecall({
 
 **options.vector** (`MastraVector`): Vector store for semantic search
 
-**options.embedder** (`MastraEmbeddingModel<string>`): Embedder for generating query embeddings
+**options.embedder** (`MastraEmbeddingModel<string>`): Embedder for generating query embeddings. Required unless the vector store embeds text itself (self-embedding)
 
 **options.topK** (`number`): Number of most similar messages to retrieve
 
@@ -86,7 +86,7 @@ export const agent = new Agent({
   id: 'semantic-memory-agent',
   name: 'semantic-memory-agent',
   instructions: 'You are a helpful assistant with semantic memory recall',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   inputProcessors: [semanticRecall, new MessageHistory({ storage, lastMessages: 50 })],
   outputProcessors: [semanticRecall, new MessageHistory({ storage })],
 })

package/dist/docs/references/reference-processors-working-memory-processor.md

@@ -35,7 +35,7 @@ const processor = new WorkingMemory({
 
 **options.template.format** (`'markdown' | 'json'`): Format of the working memory content
 
-**options.template.content** (`string`): Template content defining the structure of working memory data
+**options.template.content** (`string | Record<string, unknown>`): Template content defining the structure of working memory data. The object form is only valid when format is json
 
 **options.scope** (`'thread' | 'resource'`): Scope of working memory. 'thread' scopes to current thread, 'resource' shares across all threads for the resource
 
@@ -73,7 +73,7 @@ export const agent = new Agent({
   id: 'personalized-agent',
   name: 'personalized-agent',
   instructions: 'You are a helpful assistant that remembers user preferences',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   inputProcessors: [
     new WorkingMemory({
       storage,

package/dist/docs/references/reference-rag-chunking-and-embedding.md

@@ -63,7 +63,7 @@ For markdown documents where preserving the semantic relationships between secti
 const chunks = await doc.chunk({
   strategy: 'semantic-markdown',
   joinThreshold: 500,
-  modelName: 'gpt-5',
+  modelName: 'gpt-5.6',
 })
 ```
 

package/dist/docs/references/reference-rag-metadata-filters.md

@@ -36,7 +36,7 @@ const results = await store.query({
 
 ### Array Operators
 
-`$in`Matches any value in array{ category: { $in: \["A", "B"] } }Supported by: All except Couchbase`$nin`Matches none of the values{ status: { $nin: \["deleted", "archived"] } }Supported by: All except Couchbase`$all`Matches arrays containing all elements{ tags: { $all: \["urgent", "high"] } }Supported by: Astra, Pinecone, Upstash, MongoDB, OracleDB`$elemMatch`Matches array elements meeting criteria{ scores: { $elemMatch: { $gt: 80 } } }Supported by: libSQL, PgVector, MongoDB, OracleDB
+`$in`Matches any value in array{ category: { $in: \["A", "B"] } }Supported by: All except Couchbase`$nin`Matches none of the values{ status: { $nin: \["deleted", "archived"] } }Supported by: All except Couchbase`$all`Matches arrays containing all elements{ tags: { $all: \["urgent", "high"] } }Supported by: Astra, Pinecone, Qdrant, Upstash, MongoDB, OracleDB`$elemMatch`Matches array elements meeting criteria{ scores: { $elemMatch: { $gt: 80 } } }Supported by: libSQL, PgVector, MongoDB, OracleDB
 
 ### Logical Operators
 

package/dist/docs/references/reference-rag-retrieval.md

@@ -386,7 +386,7 @@ import { MONGODB_PROMPT } from '@mastra/mongodb'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${MONGODB_PROMPT}
@@ -403,7 +403,7 @@ import { PGVECTOR_PROMPT } from '@mastra/pg'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${PGVECTOR_PROMPT}
@@ -420,7 +420,7 @@ import { PINECONE_PROMPT } from '@mastra/pinecone'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${PINECONE_PROMPT}
@@ -437,7 +437,7 @@ import { QDRANT_PROMPT } from '@mastra/qdrant'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${QDRANT_PROMPT}
@@ -454,7 +454,7 @@ import { CHROMA_PROMPT } from '@mastra/chroma'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${CHROMA_PROMPT}
@@ -471,7 +471,7 @@ import { ASTRA_PROMPT } from '@mastra/astra'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${ASTRA_PROMPT}
@@ -488,7 +488,7 @@ import { LIBSQL_PROMPT } from '@mastra/libsql'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${LIBSQL_PROMPT}
@@ -505,7 +505,7 @@ import { UPSTASH_PROMPT } from '@mastra/upstash'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${UPSTASH_PROMPT}
@@ -522,7 +522,7 @@ import { VECTORIZE_PROMPT } from '@mastra/vectorize'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${VECTORIZE_PROMPT}
@@ -539,7 +539,7 @@ import { OPENSEARCH_PROMPT } from '@mastra/opensearch'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${OPENSEARCH_PROMPT}
@@ -556,7 +556,7 @@ import { ORACLEDB_PROMPT } from '@mastra/oracledb'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${ORACLEDB_PROMPT}
@@ -573,7 +573,7 @@ import { S3VECTORS_PROMPT } from '@mastra/s3vectors'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${S3VECTORS_PROMPT}
@@ -605,7 +605,7 @@ const initialResults = await pgVector.query({
 // Create a relevance scorer
 const relevanceProvider = new MastraAgentRelevanceScorer(
   'relevance-scorer',
-  'openai/gpt-5.6-sol',
+  'openai/gpt-6.1-sol',
 )
 
 // Re-rank the results

package/dist/docs/references/reference-storage-retention.md

@@ -294,7 +294,7 @@ const storage = new MongoDBStore({
 
 ## Reclaiming disk
 
-`prune()` deletes rows but doesn't shrink the database file. On SQLite/libSQL the freed pages go on a freelist and are reused by future writes, so the file stops growing: for most users this alone solves the unbounded-growth problem.
+`prune()` deletes rows but doesn't shrink the database file. On SQLite/libSQL the freed pages go on a freelist for reuse by future writes. Reusing these pages prevents unbounded file growth for most users.
 
 Handing that free space back to the OS is a separate concern that Mastra doesn't manage. If you specifically need to shrink the file, run the underlying database's compaction (for example `VACUUM` on self-hosted libSQL) yourself in a maintenance window. A full `VACUUM` locks the file and needs roughly twice the file size in free disk. On PostgreSQL, autovacuum reclaims dead tuples for reuse automatically. A manual `VACUUM FULL` is only needed if you must return disk to the OS.