@mastra/libsql 1.27.0 → 1.27.1-alpha.0

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

@@ -1,10 +1,9 @@
-//#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 +15,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 +31,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 +46,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 +61,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 +74,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 +87,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 +173,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 +232,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 +258,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 +280,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 +302,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 +328,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 +343,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 +358,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 +376,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 +394,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 +445,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 +508,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 +559,7 @@ declare const KNOWLEDGE_PROPOSALS_SCHEMA: {
     readonly nullable: false;
   };
 };
-type KnowledgeSchemaInspection = {
+export type KnowledgeSchemaInspection = {
   status: 'compatible';
   schemaVersion: typeof KNOWLEDGE_STORAGE_SCHEMA_VERSION;
 } | {
@@ -575,7 +574,7 @@ type KnowledgeSchemaInspection = {
   schemaVersion: null;
   reason: string;
 };
-interface KnowledgeSchemaSnapshot {
+export interface KnowledgeSchemaSnapshot {
   available: boolean;
   tableNames: readonly string[];
   schemaVersion?: number;
@@ -587,8 +586,7 @@ 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>;
-//#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 declare function assertKnowledgeV2CoreSupport(features: ReadonlySet<string>): void;
+export declare function createKnowledgeV2CoreLoader(features: ReadonlySet<string>, loadStorageModule: () => Promise<unknown>): () => Promise<KnowledgeV2Core>;
+export {};
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,4 +1,3 @@
-//#region src/memory/index.d.ts
 /**
  * Shared rules for observational memory lifecycle writes. Every storage adapter applies
  * these inside its own atomic section (lock, transaction, or conditional update), so the
@@ -9,18 +8,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 +37,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 +53,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 +77,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 +90,10 @@ 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;
-//#endregion
-export { OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS, ObservationalMemoryHeadOrderFields, ReflectionTextPlan, UpdateActiveObservationsResult, UpdateBufferedObservationsResult, assertActiveObservationsApplied, compareObservationalMemoryHeadOrder, isAppendOnlySince, isBufferedChunkCoveredByCursor, maxObservationCursor, planReflectionGenerationText, withObservationalMemoryLifecycleColumns };
+export declare function isAppendOnlySince(storedObservations: string, snapshotObservations: string): boolean;
 //# sourceMappingURL=index.d.ts.map

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-libsql
 description: Documentation for @mastra/libsql. Use when working with @mastra/libsql APIs, configuration, or implementation.
 metadata:
   package: "@mastra/libsql"
-  version: "1.27.0"
+  version: "1.27.1-alpha.0"
 ---
 
 ## When to use
@@ -25,6 +25,7 @@ Read the individual reference documents for detailed explanations and code examp
 - [Memory](references/docs-memory-overview.md) - Add memory to Mastra agents with message history, semantic recall, working memory, and observational memory across threads and multi-agent delegation.
 - [Semantic recall](references/docs-memory-semantic-recall.md) - Retrieve relevant messages from past Mastra conversations with semantic recall, vector search, embeddings, metadata filters, and configurable storage.
 - [Working memory](references/docs-memory-working-memory.md) - Persist user profiles, preferences, and application data with Mastra working memory using resource- or thread-scoped templates and storage adapters.
+- [Signals](references/docs-signals-overview.md) - Send asynchronous input into a Mastra agent thread while Mastra manages whether the agent is active or idle.
 - [Storage](references/docs-storage.md) - Configure Mastra storage to persist memory, workflow state, observability data, evals, schedules, and long-running agent state across restarts.
 - [Editor](references/docs-studio-editor.md) - Use Mastra Studio Editor so collaborators can change agent instructions and tools without modifying source code, from draft testing through publication.
 - [Snapshots](references/docs-workflows-snapshots.md) - Store and retrieve Mastra workflow snapshots so suspended executions preserve step results and state and can resume reliably across processes.

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.27.0",
+  "version": "1.27.1-alpha.0",
   "package": "@mastra/libsql",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-agents-human-in-the-loop.md

@@ -36,7 +36,7 @@ const deleteTool = createTool({
 const agent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
-  model: 'openai/gpt-5-mini',
+  model: 'openai/gpt-6-luna',
   tools: { deleteTool },
 })
 
@@ -179,7 +179,7 @@ const approvedFingerprints = new Set<string>()
 export const approvalBoundAgent = new Agent({
   id: 'approval-bound-agent',
   name: 'Approval Bound Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   tools: { issueRefundTool, deleteRecordTool },
   hooks: {
     beforeToolCall: ({ toolName, input }) => {
@@ -311,6 +311,9 @@ Instead of pausing every tool call at the agent level, you can mark individual t
 Set `requireApproval: true` on a tool definition. The tool pauses before execution regardless of whether `requireToolApproval` is set on the agent:
 
 ```typescript
+import { createTool } from '@mastra/core/tools'
+import { z } from 'zod'
+
 export const testTool = createTool({
   id: 'test-tool',
   description: 'Fetches weather for a location',
@@ -359,6 +362,9 @@ const handleApproval = async () => {
 With this approach, neither the agent nor the tool uses `requireApproval`. Instead, the tool's `execute` function calls `suspend()` to pause at a specific point and return context or confirmation prompts to the user. This is useful when approval depends on runtime conditions rather than being unconditional.
 
 ```typescript
+import { createTool } from '@mastra/core/tools'
+import { z } from 'zod'
+
 export const testToolB = createTool({
   id: 'test-tool-b',
   description: 'Fetches weather for a location',
@@ -410,6 +416,19 @@ const handleResume = async () => {
 }
 ```
 
+With `generate()`, the result has `finishReason: 'suspended'`. The tool's data from `suspend()` is in `suspendPayload.suspendPayload`. Call `resumeGenerate()` with the `resumeSchema` data and `runId`:
+
+```typescript
+const output = await agent.generate("What's the weather in London?")
+
+if (output.finishReason === 'suspended') {
+  console.log(output.suspendPayload.suspendPayload) // { reason: 'Approval required.' }
+
+  const resumed = await agent.resumeGenerate({ approved: true }, { runId: output.runId! })
+  console.log(resumed.text)
+}
+```
+
 When a suspended or approval-gated tool call resumes, the stream emits a `tool-call-resumed` chunk with the same `toolCallId` before the call's `tool-result`. Its `payload.kind` is `'suspension'` or `'approval'`, and the payload repeats the original `args`, `suspendPayload`, and `resumeSchema`. The chunk is only emitted when a real suspension or approval request is cleared.
 
 With `@mastra/ai-sdk`, it arrives as a `data-tool-call-suspended` part (or `data-tool-call-approval` part for approvals) with `resumed: true`, which replaces the original part and keeps its payload. Use this signal to mark a question as answered. Don't infer it from the shape of the tool output: when the suspension came from a sub-agent, the output of the delegation call is the sub-agent's result, not your answer.
@@ -426,7 +445,7 @@ const agent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5-mini',
+  model: 'openai/gpt-6-luna',
   tools: { weatherTool },
   memory: new Memory(),
   defaultOptions: {
@@ -604,7 +623,7 @@ const dataAgent = new Agent({
   id: 'data-agent',
   name: 'Data Agent',
   description: 'Handles database queries and user data retrieval',
-  model: 'openai/gpt-5-mini',
+  model: 'openai/gpt-6-luna',
   tools: { findUserTool },
 })
 
@@ -613,7 +632,7 @@ const supervisorAgent = new Agent({
   name: 'Supervisor Agent',
   instructions: `You coordinate data retrieval tasks.
     Delegate to data-agent for user lookups.`,
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   agents: { dataAgent },
   memory: new Memory(),
 })
@@ -649,6 +668,9 @@ for await (const chunk of stream.fullStream) {
 Tools can also use [`suspend()`](#approval-using-suspend) to pause execution and return context to the user. This approach works through the supervisor delegation chain the same way `requireApproval` does: the suspension surfaces at the supervisor level:
 
 ```typescript
+import { createTool } from '@mastra/core/tools'
+import { z } from 'zod'
+
 const conditionalTool = createTool({
   id: 'conditional-operation',
   description: 'Performs an operation that may require confirmation',

package/dist/docs/references/docs-agents-networks.md

@@ -31,7 +31,7 @@ export const routingAgent = new Agent({
   name: 'Routing Agent',
   instructions: `
     You are a network of writers and researchers. The user will ask you to research a topic. Always respond with a complete report—no bullet points. Write in full paragraphs, like a blog post. Do not answer with incomplete or uncertain information.`,
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   agents: {
     researchAgent,
     writingAgent,

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

@@ -57,7 +57,7 @@ const agent = new Agent({
   id: 'test-agent',
   name: 'Test Agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'memory-store',
@@ -109,7 +109,7 @@ import { openai } from '@ai-sdk/openai'
 const agent = new Agent({
   name: 'semantic-agent',
   instructions: 'You are a helpful assistant with semantic memory',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'memory-store',
@@ -159,7 +159,7 @@ import { openai } from '@ai-sdk/openai'
 const agent = new Agent({
   name: 'working-memory-agent',
   instructions: 'You are an assistant with working memory',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'memory-store',
@@ -191,7 +191,7 @@ const customMessageHistory = new MessageHistory({
 const agent = new Agent({
   name: 'custom-memory-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new LibSQLStore({ id: 'memory-store', url: 'file:memory.db' }),
     options: {
@@ -264,7 +264,7 @@ const agent = new Agent({
   id: 'safe-agent',
   name: 'safe-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({ options: { lastMessages: 10 } }),
   // Your guardrail runs BEFORE memory saves
   outputProcessors: [contentBlocker],
@@ -304,7 +304,7 @@ const agent = new Agent({
   id: 'validated-agent',
   name: 'validated-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({ options: { lastMessages: 10 } }),
   // Your guardrail runs AFTER memory loads history
   inputProcessors: [inputValidator],
@@ -381,7 +381,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({ options: { lastMessages: 10 } }),
   inputProcessors: [new AttachmentUploader()],
 })

package/dist/docs/references/docs-memory-message-history.md

@@ -116,7 +116,7 @@ You can use this history in two ways:
 - **Automatic inclusion**: Mastra automatically includes recent messages in the context window. The default of 10 messages keeps agents grounded in the conversation. Adjust it with `lastMessages` when needed.
 - [**Manual querying**](#querying): For more control, query threads and messages directly with `recall()`. Use the results to choose which memories enter the context window or to render conversation history in your UI.
 
-> **Note:** `lastMessages` counts every stored message, including tool calls, tool results, and [signals](https://mastra.ai/docs/harness/signals) of any kind, so a single turn can add several messages to the count. The window also slides forward on every request: once a thread grows past the limit, the oldest message leaves context on each turn, which changes the start of the prompt and invalidates the provider prompt cache. For long-running conversations, use [Observational Memory](https://mastra.ai/docs/memory/observational-memory), which keeps the prompt prefix stable.
+> **Note:** `lastMessages` counts every stored message, including tool calls, tool results, and [signals](https://mastra.ai/docs/signals/sending-signals) of any kind, so a single turn can add several messages to the count. The window also slides forward on every request: once a thread grows past the limit, the oldest message leaves context on each turn, which changes the start of the prompt and invalidates the provider prompt cache. For long-running conversations, use [Observational Memory](https://mastra.ai/docs/memory/observational-memory), which keeps the prompt prefix stable.
 
 ### Sending messages from a client
 
@@ -138,6 +138,9 @@ If you assemble the request input yourself and need it processed exactly as sent
 Message count is a poor proxy for context size: a tool result can be a few tokens or thousands. Use `messageHistory` to keep recent history within a token budget instead:
 
 ```typescript
+import { Agent } from '@mastra/core/agent'
+import { Memory } from '@mastra/memory'
+
 export const agent = new Agent({
   id: 'test-agent',
   memory: new Memory({
@@ -168,7 +171,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({
     options: {
       generateTitle: true,
@@ -191,7 +194,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({
     options: {
       generateTitle: {
@@ -226,11 +229,11 @@ 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({
     options: {
       generateTitle: {
-        model: 'openai/gpt-5-mini',
+        model: 'openai/gpt-6-luna',
         instructions: 'Generate a one-word title.',
       },
     },

package/dist/docs/references/docs-memory-multi-user-threads.md

@@ -69,7 +69,7 @@ const memory = new Memory({
 export const collabAgent = new Agent({
   id: 'collab',
   name: 'CollabAgent',
-  model: 'openai/gpt-5-mini',
+  model: 'openai/gpt-6-luna',
   memory,
   instructions: `
 You are a collaborative document assistant. Multiple users talk to you in the SAME thread.

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

@@ -164,6 +164,9 @@ const response = await memoryAgent.generate('Remember my favorite color is blue.
 Scopes can also come from the agent and from the request context. Mastra combines all three sources:
 
 ```typescript
+import { Agent } from '@mastra/core/agent'
+import { Memory } from '@mastra/memory'
+
 export const memoryAgent = new Agent({
   id: 'memory-agent',
   name: 'Memory Agent',
@@ -271,6 +274,9 @@ Open [Studio](https://mastra.ai/docs/studio/overview) and select the **Observabi
 Use [`RequestContext`](https://mastra.ai/docs/server/request-context) to access request-specific values. This lets you conditionally select different memory or storage configurations based on the context of the request.
 
 ```typescript
+import { Agent } from '@mastra/core/agent'
+import { Memory } from '@mastra/memory'
+
 export type UserTier = {
   'user-tier': 'enterprise' | 'pro'
 }