@mastra/pg 1.34.0 → 1.35.0-alpha.0

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

@@ -1,92 +1,5 @@
-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. */
-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. */
-  addresses?: string[];
-  /** Only the scope nodes with these UUIDs. Combines with the other filters. */
-  ids?: string[];
-  /** `nextCursor` from the previous page of the same query. */
-  cursor?: string;
-  /** Page size, from 1 to `MAX_KNOWLEDGE_SCOPE_NODES` (the default). */
-  limit?: number;
-}
-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;
-}
-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. */
-export declare function parseListKnowledgeScopeNodesInput(input?: ListKnowledgeScopeNodesInput): {
-  limit: number;
-  after: {
-    name: string;
-    id: string;
-  } | null;
-};
-/** Builds a page from up to `limit + 1` name/id-ordered scope nodes. */
-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`. */
-export interface KnowledgeScopeMember {
-  id: string;
-  type: 'node';
-  name: string;
-  kind: string;
-  content?: string;
-  description?: string;
-  scope: string[] | null;
-  version: number;
-  mergedInto?: string;
-  createdAt: Date;
-  updatedAt: Date;
-}
-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;
-}
-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. */
-  hasMore: boolean;
-  /** Pass as `cursor` to read the next page; `null` on the last page. */
-  nextCursor: string | null;
-}
-export declare const MAX_KNOWLEDGE_SCOPE_MEMBERS_LIMIT = 500;
-/** Clamps a requested member limit to 1–{@link MAX_KNOWLEDGE_SCOPE_MEMBERS_LIMIT}. */
-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. */
-export declare function parseListKnowledgeScopeMembersInput(input: ListKnowledgeScopeMembersInput): {
-  limit: number;
-  after: {
-    updatedAt: Date;
-    name: string;
-    id: string;
-  } | null;
-};
-/** Builds a page from up to `limit + 1` members in `listScopeMembers` order. */
-export declare function pageKnowledgeScopeMembers(rows: KnowledgeScopeMember[], limit: number, input: ListKnowledgeScopeMembersInput): ListKnowledgeScopeMembersOutput;
-/** A reconciled structural scope node with its containing scope nodes. */
-export interface KnowledgeScopeNodeSummary {
-  /** UUID of the `isScope` node. */
-  id: string;
-  /** Canonical address the scope node was reconciled from (e.g. `features:memory`). */
-  address: string;
-  name: string;
-  kind?: string;
-  description?: string;
-  /** UUIDs of the scope nodes that contain this scope (membership edges). */
-  parentIds: string[];
-}
+export declare const KNOWLEDGE_STORAGE_CONTRACT_VERSION: 4;
+export declare const KNOWLEDGE_STORAGE_SCHEMA_VERSION: 4;
 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";
@@ -99,20 +12,35 @@ 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. */
 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. */
-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: {
+export declare const KNOWLEDGE_PAGES_CORE_FEATURE = "knowledge-pages";
+export declare const KNOWLEDGE_PAGES_SCHEMA_VERSION: 4;
+export declare const TABLE_KNOWLEDGE_PAGES = "mastra_knowledge_pages";
+export declare const TABLE_KNOWLEDGE_NOTES = "mastra_knowledge_notes";
+export declare const TABLE_KNOWLEDGE_NOTE_STAMPS = "mastra_knowledge_note_stamps";
+/** Same name as the schema-2 table; schema 4 re-keys it to note → page. */
+export declare const TABLE_KNOWLEDGE_PAGE_MENTIONS = "mastra_knowledge_mentions";
+export declare const TABLE_KNOWLEDGE_PINS = "mastra_knowledge_pins";
+/** Same name as schema 2; schema 4 re-keys it to scope/page/note. */
+export declare const TABLE_KNOWLEDGE_PAGE_ACTIVITY = "mastra_knowledge_activity";
+/** Holds `{ id: 'knowledge', schemaVersion: 4 }`, written when the schema-4 tables are created. */
+export declare const TABLE_KNOWLEDGE_PAGES_STATE = "mastra_knowledge_access_state";
+export declare const KNOWLEDGE_PAGES_TABLE_NAMES: readonly ["mastra_knowledge_pages", "mastra_knowledge_notes", "mastra_knowledge_note_stamps", "mastra_knowledge_mentions", "mastra_knowledge_pins", "mastra_knowledge_activity", "mastra_knowledge_access_state"];
+/** Every Knowledge table any schema version created. Reset drops these and nothing else. */
+export declare const KNOWLEDGE_RESETTABLE_TABLE_NAMES: readonly string[];
+/** Schema-1/2 tables whose presence means the store needs a reset before schema 4 can run. */
+export declare const LEGACY_KNOWLEDGE_TABLE_NAMES: ReadonlySet<string>;
+/** Pages and scope pages. `scopeId` equals `id` on scope pages; `address`/`declaration` only on scope pages. */
+export declare const KNOWLEDGE_PAGES_SCHEMA: {
   readonly id: {
     readonly type: 'text';
     readonly nullable: false;
     readonly primaryKey: true;
   };
-  readonly name: {
+  readonly scopeId: {
     readonly type: 'text';
     readonly nullable: false;
   };
-  readonly kind: {
+  readonly parentId: {
     readonly type: 'text';
     readonly nullable: true;
   };
@@ -120,86 +48,55 @@ export declare const KNOWLEDGE_V2_NODES_SCHEMA: {
     readonly type: 'boolean';
     readonly nullable: false;
   };
-  readonly metadata: {
-    readonly type: 'jsonb';
-    readonly nullable: true;
-  };
-  readonly version: {
-    readonly type: 'integer';
-    readonly nullable: false;
-  };
-  readonly createdAt: {
-    readonly type: 'timestamp';
-    readonly nullable: false;
-  };
-  readonly updatedAt: {
-    readonly type: 'timestamp';
-    readonly nullable: false;
-  };
-  readonly deletedAt: {
-    readonly type: 'timestamp';
-    readonly nullable: true;
-  };
-  readonly deletedBy: {
+  readonly address: {
     readonly type: 'text';
     readonly nullable: true;
   };
-  readonly type: {
+  readonly declaration: {
     readonly type: 'text';
     readonly nullable: true;
   };
-  readonly canonicalName: {
+  readonly key: {
     readonly type: 'text';
     readonly nullable: true;
   };
-  readonly content: {
+  readonly position: {
     readonly type: 'text';
-    readonly nullable: true;
+    readonly nullable: false;
   };
-  readonly description: {
+  readonly name: {
     readonly type: 'text';
-    readonly nullable: true;
+    readonly nullable: false;
   };
-  readonly scope: {
-    readonly type: 'jsonb';
-    readonly nullable: true;
+  readonly canonicalName: {
+    readonly type: 'text';
+    readonly nullable: false;
   };
-  readonly scopeKey: {
+  readonly description: {
     readonly type: 'text';
     readonly nullable: true;
   };
-  readonly mergedInto: {
+  readonly body: {
     readonly type: 'text';
     readonly nullable: true;
   };
-};
-export declare const KNOWLEDGE_V2_RECORDS_SCHEMA: {
-  readonly id: {
-    readonly type: 'text';
+  readonly version: {
+    readonly type: 'integer';
     readonly nullable: false;
-    readonly primaryKey: true;
   };
-  readonly node: {
+  readonly mergedInto: {
     readonly type: 'text';
-    readonly nullable: false;
-    readonly references: {
-      readonly table: "mastra_knowledge_nodes";
-      readonly column: 'id';
-    };
+    readonly nullable: true;
   };
-  readonly text: {
-    readonly type: 'text';
+  readonly createdBy: {
+    readonly type: 'jsonb';
     readonly nullable: false;
   };
-  readonly metadata: {
+  readonly updatedBy: {
     readonly type: 'jsonb';
-    readonly nullable: true;
-  };
-  readonly version: {
-    readonly type: 'integer';
     readonly nullable: false;
   };
-  readonly capturedAt: {
+  readonly createdAt: {
     readonly type: 'timestamp';
     readonly nullable: false;
   };
@@ -215,237 +112,125 @@ export declare const KNOWLEDGE_V2_RECORDS_SCHEMA: {
     readonly type: 'text';
     readonly nullable: true;
   };
-  readonly scope: {
-    readonly type: 'jsonb';
-    readonly nullable: true;
-  };
-  readonly scopeKey: {
-    readonly type: 'text';
-    readonly nullable: true;
-  };
-  readonly sourceThreadId: {
-    readonly type: 'text';
-    readonly nullable: true;
-  };
-  readonly when: {
-    readonly type: 'timestamp';
-    readonly nullable: true;
-  };
 };
-export declare const KNOWLEDGE_V2_MENTIONS_SCHEMA: {
-  readonly recordId: {
+export declare const KNOWLEDGE_NOTES_SCHEMA: {
+  readonly id: {
     readonly type: 'text';
     readonly nullable: false;
-    readonly references: {
-      readonly table: "mastra_knowledge_records";
-      readonly column: 'id';
-    };
+    readonly primaryKey: true;
   };
-  readonly targetNodeId: {
+  readonly pageId: {
     readonly type: 'text';
-    readonly nullable: true;
+    readonly nullable: false;
     readonly references: {
-      readonly table: "mastra_knowledge_nodes";
+      readonly table: "mastra_knowledge_pages";
       readonly column: 'id';
     };
   };
-  readonly sourceType: {
+  readonly text: {
     readonly type: 'text';
-    readonly nullable: true;
+    readonly nullable: false;
   };
-  readonly sourceId: {
-    readonly type: 'text';
+  readonly when: {
+    readonly type: 'timestamp';
     readonly nullable: true;
   };
-};
-export declare const KNOWLEDGE_NODE_SCOPES_SCHEMA: {
-  readonly nodeId: {
-    readonly type: 'text';
+  readonly provenance: {
+    readonly type: 'jsonb';
     readonly nullable: false;
-    readonly references: {
-      readonly table: "mastra_knowledge_nodes";
-      readonly column: 'id';
-    };
   };
-  readonly scopeNodeId: {
-    readonly type: 'text';
+  readonly version: {
+    readonly type: 'integer';
     readonly nullable: false;
-    readonly references: {
-      readonly table: "mastra_knowledge_nodes";
-      readonly column: 'id';
-    };
   };
-  readonly addedAt: {
+  readonly createdAt: {
     readonly type: 'timestamp';
     readonly nullable: false;
   };
-};
-export declare const KNOWLEDGE_RECORD_SCOPES_SCHEMA: {
-  readonly recordId: {
-    readonly type: 'text';
-    readonly nullable: false;
-    readonly references: {
-      readonly table: "mastra_knowledge_records";
-      readonly column: 'id';
-    };
-  };
-  readonly scopeNodeId: {
-    readonly type: 'text';
+  readonly updatedAt: {
+    readonly type: 'timestamp';
     readonly nullable: false;
-    readonly references: {
-      readonly table: "mastra_knowledge_nodes";
-      readonly column: 'id';
-    };
   };
-  readonly addedAt: {
+  readonly deletedAt: {
     readonly type: 'timestamp';
-    readonly nullable: false;
+    readonly nullable: true;
+  };
+  readonly deletedBy: {
+    readonly type: 'text';
+    readonly nullable: true;
   };
 };
-export declare const KNOWLEDGE_SCOPE_GRANTS_SCHEMA: {
-  readonly scopeNodeId: {
+/** One row per (note, stamp scope). Primary key is the pair. */
+export declare const KNOWLEDGE_NOTE_STAMPS_SCHEMA: {
+  readonly noteId: {
     readonly type: 'text';
     readonly nullable: false;
     readonly references: {
-      readonly table: "mastra_knowledge_nodes";
+      readonly table: "mastra_knowledge_notes";
       readonly column: 'id';
     };
   };
-  readonly scopeRefId: {
+  readonly scopeId: {
     readonly type: 'text';
     readonly nullable: false;
     readonly references: {
-      readonly table: "mastra_knowledge_nodes";
+      readonly table: "mastra_knowledge_pages";
       readonly column: 'id';
     };
   };
-  readonly role: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-  readonly canSuggest: {
-    readonly type: 'boolean';
-    readonly nullable: true;
-  };
-};
-export declare const KNOWLEDGE_ACCESS_STATE_SCHEMA: {
-  readonly id: {
-    readonly type: 'text';
-    readonly nullable: false;
-    readonly primaryKey: true;
-  };
-  readonly epoch: {
-    readonly type: 'integer';
-    readonly nullable: false;
-  };
-  readonly schemaVersion: {
-    readonly type: 'integer';
-    readonly nullable: false;
-  };
 };
-export declare const KNOWLEDGE_SCOPE_ADDRESSES_SCHEMA: {
-  readonly address: {
-    readonly type: 'text';
-    readonly nullable: false;
-    readonly primaryKey: true;
-  };
-  readonly scopeNodeId: {
+/** One row per (note, mentioned page). Primary key is the pair. */
+export declare const KNOWLEDGE_PAGE_MENTIONS_SCHEMA: {
+  readonly noteId: {
     readonly type: 'text';
     readonly nullable: false;
     readonly references: {
-      readonly table: "mastra_knowledge_nodes";
+      readonly table: "mastra_knowledge_notes";
       readonly column: 'id';
     };
   };
-};
-export declare const KNOWLEDGE_NODE_ADDRESSES_SCHEMA: {
-  readonly source: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-  readonly address: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-  readonly nodeId: {
+  readonly pageId: {
     readonly type: 'text';
     readonly nullable: false;
     readonly references: {
-      readonly table: "mastra_knowledge_nodes";
+      readonly table: "mastra_knowledge_pages";
       readonly column: 'id';
     };
   };
 };
-export declare const KNOWLEDGE_IMPORT_STATE_SCHEMA: {
-  readonly importerId: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-  readonly binding: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-  readonly key: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-  readonly value: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-};
-export declare const KNOWLEDGE_IMPORT_RUNS_SCHEMA: {
+/** `audience` is a JSON array of scope addresses (PG may store it as `text[]`, Mongo as an array). */
+export declare const KNOWLEDGE_PINS_SCHEMA: {
   readonly id: {
     readonly type: 'text';
     readonly nullable: false;
     readonly primaryKey: true;
   };
-  readonly importerId: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-  readonly binding: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-  readonly importKind: {
+  readonly pageId: {
     readonly type: 'text';
     readonly nullable: false;
+    readonly references: {
+      readonly table: "mastra_knowledge_pages";
+      readonly column: 'id';
+    };
   };
-  readonly triggerKind: {
-    readonly type: 'text';
+  readonly audience: {
+    readonly type: 'jsonb';
     readonly nullable: false;
   };
-  readonly status: {
+  readonly createdBy: {
     readonly type: 'text';
     readonly nullable: false;
   };
-  readonly error: {
-    readonly type: 'text';
-    readonly nullable: true;
-  };
-  readonly transcriptThreadId: {
-    readonly type: 'text';
-    readonly nullable: true;
-  };
-  readonly traceId: {
-    readonly type: 'text';
-    readonly nullable: true;
-  };
-  readonly queuedAt: {
+  readonly createdAt: {
     readonly type: 'timestamp';
     readonly nullable: false;
   };
-  readonly startedAt: {
-    readonly type: 'timestamp';
-    readonly nullable: true;
-  };
-  readonly completedAt: {
+  readonly updatedAt: {
     readonly type: 'timestamp';
-    readonly nullable: true;
+    readonly nullable: false;
   };
 };
-export declare const KNOWLEDGE_V2_ACTIVITY_SCHEMA: {
+export declare const KNOWLEDGE_PAGE_ACTIVITY_SCHEMA: {
   readonly id: {
     readonly type: 'text';
     readonly nullable: false;
@@ -455,113 +240,41 @@ export declare const KNOWLEDGE_V2_ACTIVITY_SCHEMA: {
     readonly type: 'text';
     readonly nullable: false;
   };
-  readonly targetType: {
-    readonly type: 'text';
-    readonly nullable: true;
-  };
-  readonly targetId: {
+  readonly scopeId: {
     readonly type: 'text';
-    readonly nullable: true;
+    readonly nullable: false;
   };
-  readonly contextScopeId: {
+  readonly pageId: {
     readonly type: 'text';
-    readonly nullable: true;
-    readonly references: {
-      readonly table: "mastra_knowledge_nodes";
-      readonly column: 'id';
-    };
+    readonly nullable: false;
   };
-  readonly importRunId: {
+  readonly noteId: {
     readonly type: 'text';
     readonly nullable: true;
-    readonly references: {
-      readonly table: "mastra_knowledge_import_runs";
-      readonly column: 'id';
-    };
   };
-  readonly details: {
+  readonly provenance: {
     readonly type: 'jsonb';
-    readonly nullable: true;
+    readonly nullable: false;
   };
   readonly createdAt: {
     readonly type: 'timestamp';
     readonly nullable: false;
   };
-  readonly recordType: {
-    readonly type: 'text';
-    readonly nullable: true;
-  };
-  readonly recordId: {
-    readonly type: 'text';
-    readonly nullable: true;
-  };
-  readonly scope: {
-    readonly type: 'jsonb';
-    readonly nullable: true;
-  };
-  readonly scopeKey: {
-    readonly type: 'text';
-    readonly nullable: true;
-  };
-  readonly sourceThreadId: {
-    readonly type: 'text';
-    readonly nullable: true;
-  };
 };
-export declare const KNOWLEDGE_PROPOSALS_SCHEMA: {
+export declare const KNOWLEDGE_PAGES_STATE_SCHEMA: {
   readonly id: {
     readonly type: 'text';
     readonly nullable: false;
     readonly primaryKey: true;
   };
-  readonly targetType: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-  readonly targetId: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-  readonly action: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-  readonly changes: {
-    readonly type: 'jsonb';
-    readonly nullable: false;
-  };
-  readonly reason: {
-    readonly type: 'text';
-    readonly nullable: true;
-  };
-  readonly proposerContextScopeId: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-  readonly expectedVersion: {
+  readonly schemaVersion: {
     readonly type: 'integer';
     readonly nullable: false;
   };
-  readonly status: {
-    readonly type: 'text';
-    readonly nullable: false;
-  };
-  readonly reviewerContextScopeId: {
-    readonly type: 'text';
-    readonly nullable: true;
-  };
-  readonly reviewedAt: {
-    readonly type: 'timestamp';
-    readonly nullable: true;
-  };
-  readonly createdAt: {
-    readonly type: 'timestamp';
-    readonly nullable: false;
-  };
 };
-export type KnowledgeSchemaInspection = {
+export type KnowledgePagesSchemaInspection = {
   status: 'compatible';
-  schemaVersion: typeof KNOWLEDGE_STORAGE_SCHEMA_VERSION;
+  schemaVersion: typeof KNOWLEDGE_PAGES_SCHEMA_VERSION;
 } | {
   status: 'uninitialized';
   schemaVersion: null;
@@ -569,24 +282,57 @@ export type KnowledgeSchemaInspection = {
   status: 'incompatible-reset-required';
   schemaVersion: number | null;
   reason: string;
-} | {
-  status: 'unavailable';
-  schemaVersion: null;
-  reason: string;
 };
-export interface KnowledgeSchemaSnapshot {
-  available: boolean;
+/**
+ * Classifies what an adapter found before creating schema-4 tables. `tableNames` is every
+ * `mastra_knowledge_*` table present; `schemaVersion` is the state row's version, if any.
+ */
+export declare function inspectKnowledgePagesSchema(snapshot: {
   tableNames: readonly string[];
   schemaVersion?: number;
-  reason?: string;
-}
-interface KnowledgeV2Core {
-  assertKnowledgeDescriptionWithinBound(description: string | undefined): void;
-  assertKnowledgeRecordTextWithinBound(text: string): void;
-  assertKnowledgeSchemaCompatible(inspection: KnowledgeSchemaInspection): void;
-  inspectKnowledgeSchema(snapshot: KnowledgeSchemaSnapshot): KnowledgeSchemaInspection;
+}): KnowledgePagesSchemaInspection;
+/**
+ * The old Knowledge tables an adapter drops on init, rows included: Knowledge before schema 4 was an
+ * experimental store with no migration. Every schema-1/2-only table present is dropped. The table
+ * names schema 4 reuses (mentions, activity, the state table) are dropped too, but only when an old
+ * table is present and no schema-4 state row exists, so they are old-shaped. Schema-4-only tables
+ * are never listed. On a schema-4 store this lists only tables an older process recreated during a
+ * rolling deploy. Drop order is safe for adapters that enforce references.
+ */
+export declare function legacyKnowledgeTablesToDrop(snapshot: {
+  tableNames: readonly string[];
+  schemaVersion?: number;
+}): string[];
+/** Message for the error an adapter throws on `incompatible-reset-required`. */
+export declare function knowledgePagesResetMessage(reason: string): string;
+/**
+ * The page-store runtime pieces adapters take from `@mastra/core/storage`. They are loaded through
+ * `createKnowledgePagesCoreLoader` instead of static imports so adapters keep loading on cores
+ * older than the `knowledge-pages` feature without raising their `@mastra/core` peer floor.
+ */
+export interface KnowledgePagesCore {
+  assertKnowledgePageDescriptionWithinBound(description: string | undefined): void;
+  assertKnowledgeNoteTextWithinBound(text: string): void;
+  canonicalKnowledgeName(name: string): string;
+  knowledgePositionBetween(before?: string, after?: string): string;
+  MAX_KNOWLEDGE_MOVE_PAGES: number;
+  MAX_KNOWLEDGE_PAGE_DEPTH: number;
+  MAX_KNOWLEDGE_PAGE_LIST_LIMIT: number;
+  KnowledgeMoveTooLargeError: new (pageId: string, pages: number) => Error;
+  KnowledgePageDepthError: new (pageId: string) => Error;
+  KnowledgePageHasChildrenError: new (pageId: string) => Error;
+  KnowledgePageKeyConflictError: new (key: string, parentId: string) => Error;
 }
-export declare function assertKnowledgeV2CoreSupport(features: ReadonlySet<string>): void;
-export declare function createKnowledgeV2CoreLoader(features: ReadonlySet<string>, loadStorageModule: () => Promise<unknown>): () => Promise<KnowledgeV2Core>;
-export {};
+/** Loads core's page-store runtime once, after checking core advertises `knowledge-pages`. */
+export declare function createKnowledgePagesCoreLoader(features: ReadonlySet<string>, loadStorageModule: () => Promise<unknown>): () => Promise<KnowledgePagesCore>;
+/**
+ * Keyword-search words: the query split on whitespace, lowercased, deduplicated. Every word must
+ * appear (as a case-insensitive substring) in a hit; an empty list means the search returns nothing.
+ */
+export declare function knowledgeSearchWords(query: string): string[];
+/**
+ * Why `key` can't be a Knowledge page key, or undefined when it can. Keys are one path segment:
+ * non-empty, with no `/` (path separator), `#` (scope/path separator) or `%` (escape character).
+ */
+export declare function knowledgePageKeyProblem(key: string): string | undefined;
 //# sourceMappingURL=index.d.ts.map