@mastra/libsql 1.23.1-alpha.1 → 1.23.1-alpha.3

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.23.1-alpha.1"
+  version: "1.23.1-alpha.3"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

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

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

@@ -170,6 +170,43 @@ export const supportAgent = new Agent({
 
 Title generation runs asynchronously after the agent responds and doesn't affect response time.
 
+### Streaming the generated title
+
+By default title generation runs in the background and the run's stream doesn't wait for it, so HTTP clients only see the title on their next thread fetch. Set `emitEvent: true` to deliver the title on the run's stream instead: the stream waits for the title and emits a transient `data-thread-title` chunk before `finish`.
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { Memory } from '@mastra/memory'
+
+export const supportAgent = new Agent({
+  id: 'support-agent',
+  name: 'Support agent',
+  instructions: 'Answer customer support questions.',
+  model: 'openai/gpt-5.6-sol',
+  memory: new Memory({
+    options: {
+      generateTitle: {
+        emitEvent: true,
+      },
+    },
+  }),
+})
+```
+
+Stream consumers receive the chunk with the persisted title, so a chat UI can rename its thread list entry without polling:
+
+```typescript
+for await (const chunk of stream.fullStream) {
+  if (chunk.type === 'data-thread-title') {
+    renameThreadInSidebar(chunk.data.threadId, chunk.data.title)
+  }
+}
+```
+
+The chunk is transient: it's delivered to stream consumers but never persisted as part of the conversation's messages. Because the stream waits for the title, `emitEvent` delays the stream's `finish` on the turn that generates the title: the first turn of a thread, or a later turn when `minMessages` sets a higher threshold. Leave it off to keep title generation fully non-blocking.
+
+> **Note:** `emitEvent` applies to `stream()` runs. `generate()` returns JSON and can't carry the chunk, so it keeps non-blocking title generation. [Durable and evented agents](https://mastra.ai/docs/harness/durable-agents) don't emit this chunk yet. In all of these cases the title is still generated and persisted.
+
 To optimize cost or behavior, provide a smaller [`model`](https://mastra.ai/models) and custom `instructions`:
 
 ```typescript

package/dist/docs/references/integrations-channels-github.md

@@ -41,9 +41,13 @@ GitHub Signals requires:
 - A Mastra storage adapter with memory and notification support. The provider stores each subscription in the thread's metadata, so the thread must already exist.
 - The `gitcrawl` command on `PATH`, configured to access the repositories you want to monitor. The provider runs `gitcrawl sync` and reads its SQLite database.
 - The `sqlite3` command on `PATH`.
-- The [GitHub CLI](https://cli.github.com/) installed and authenticated. The provider uses `gh api` to check whether comment authors have access to the repository before notifying the agent.
+- The [GitHub CLI](https://cli.github.com/) installed and authenticated. The provider uses real `gh api` responses to check repository permissions and GitHub App ownership before notifying the agent.
 
-By default, comments from users with `admin`, `maintain`, or `write` access can trigger notifications. CodeRabbit and Devin bot comments are also allowed. Configure `authorizedPermissions`, `authorizedBots`, or `ignoredBots` when you need different rules.
+By default, comments from users with `admin`, `maintain`, or `write` access can trigger notifications. CodeRabbit and Devin bot comments are explicitly allowed.
+
+Bot authorization checks `ignoredBots` first, using an exact case-insensitive login match. Other bots can trigger notifications when they appear in `authorizedBots`, when the GitHub App is owned by a user whose repository permission appears in `authorizedPermissions`, or when the app is owned by the organization that owns the repository. The default authorized permissions are `admin`, `maintain`, and `write`.
+
+Failed, inaccessible, malformed, and unsupported app-owner lookups deny the bot comment. Successful app-owner lookups are cached for 24 hours; failed lookups aren't cached.
 
 ## Agent and subscription
 

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

@@ -51,7 +51,7 @@ export const agent = new Agent({
 
 **options.observationalMemory** (`boolean | ObservationalMemoryOptions`): Enable Observational Memory for long-context agentic memory. Set to true for defaults, or pass a config object to customize token budgets, models, and scope. See Observational Memory reference for configuration details.
 
-**options.generateTitle** (`boolean | { model: DynamicArgument<MastraLanguageModel>; instructions?: DynamicArgument<string> }`): Controls automatic thread title generation from the conversation transcript. Can be a boolean or an object with custom model and instructions.
+**options.generateTitle** (`boolean | { model?: DynamicArgument<MastraModelConfig>; instructions?: DynamicArgument<string>; minMessages?: number; emitEvent?: boolean }`): Controls automatic thread title generation from the conversation transcript. Accepts a boolean or an object with a custom model (any MastraModelConfig: a model instance, a "provider/model" ID, or an OpenAI-compatible config; defaults to the agent's own model), custom instructions, a minimum message count, and emitEvent. With emitEvent: true the run's stream waits for the title and emits it as a transient data-thread-title chunk before finish (durable and evented agents persist the title but don't emit the chunk yet).
 
 ## Returns
 

package/dist/index.cjs

@@ -3892,6 +3892,14 @@ var DatasetsLibSQL = class extends _mastra_core_storage.DatasetsStorage {
 	}
 	async listDatasets(args) {
 		try {
+			const orderBy = (0, _mastra_core_storage.resolveListOrderBy)(args.orderBy, [
+				"createdAt",
+				"updatedAt",
+				"name"
+			], {
+				field: "createdAt",
+				direction: "DESC"
+			});
 			const { page, perPage: perPageInput } = args.pagination;
 			const filterConditions = [];
 			const filterParams = [];
@@ -3945,7 +3953,7 @@ var DatasetsLibSQL = class extends _mastra_core_storage.DatasetsStorage {
 			const end = perPageInput === false ? total : start + perPage;
 			return {
 				datasets: (await this.#client.execute({
-					sql: `SELECT ${buildSelectColumns(_mastra_core_storage.TABLE_DATASETS)} FROM ${_mastra_core_storage.TABLE_DATASETS} ${whereClause} ORDER BY createdAt DESC, id ASC LIMIT ? OFFSET ?`,
+					sql: `SELECT ${buildSelectColumns(_mastra_core_storage.TABLE_DATASETS)} FROM ${_mastra_core_storage.TABLE_DATASETS} ${whereClause} ORDER BY ${orderBy.field} ${orderBy.direction}, id ASC LIMIT ? OFFSET ?`,
 					args: [
 						...filterParams,
 						limitValue,
@@ -4360,6 +4368,10 @@ var DatasetsLibSQL = class extends _mastra_core_storage.DatasetsStorage {
 	async listItems(args) {
 		try {
 			const { page, perPage: perPageInput } = args.pagination;
+			const itemsOrderBy = (0, _mastra_core_storage.resolveListOrderBy)(args.orderBy, ["createdAt", "updatedAt"], {
+				field: "createdAt",
+				direction: "DESC"
+			});
 			if (args.version !== void 0) {
 				const conditions = [
 					"datasetId = ?",
@@ -4406,7 +4418,7 @@ var DatasetsLibSQL = class extends _mastra_core_storage.DatasetsStorage {
 				const end = perPageInput === false ? total : start + perPage;
 				return {
 					items: (await this.#client.execute({
-						sql: `SELECT ${buildSelectColumns(_mastra_core_storage.TABLE_DATASET_ITEMS)} FROM ${_mastra_core_storage.TABLE_DATASET_ITEMS} ${whereClause} ORDER BY createdAt DESC, id ASC LIMIT ? OFFSET ?`,
+						sql: `SELECT ${buildSelectColumns(_mastra_core_storage.TABLE_DATASET_ITEMS)} FROM ${_mastra_core_storage.TABLE_DATASET_ITEMS} ${whereClause} ORDER BY ${itemsOrderBy.field} ${itemsOrderBy.direction}, id ASC LIMIT ? OFFSET ?`,
 						args: [
 							...queryParams,
 							limitValue,
@@ -4461,7 +4473,7 @@ var DatasetsLibSQL = class extends _mastra_core_storage.DatasetsStorage {
 			const end = perPageInput === false ? total : start + perPage;
 			return {
 				items: (await this.#client.execute({
-					sql: `SELECT ${buildSelectColumns(_mastra_core_storage.TABLE_DATASET_ITEMS)} FROM ${_mastra_core_storage.TABLE_DATASET_ITEMS} ${whereClause} ORDER BY createdAt DESC, id ASC LIMIT ? OFFSET ?`,
+					sql: `SELECT ${buildSelectColumns(_mastra_core_storage.TABLE_DATASET_ITEMS)} FROM ${_mastra_core_storage.TABLE_DATASET_ITEMS} ${whereClause} ORDER BY ${itemsOrderBy.field} ${itemsOrderBy.direction}, id ASC LIMIT ? OFFSET ?`,
 					args: [
 						...queryParams,
 						limitValue,
@@ -5156,6 +5168,10 @@ var ExperimentsLibSQL = class extends _mastra_core_storage.ExperimentsStorage {
 	}
 	async listExperiments(args) {
 		try {
+			const orderBy = (0, _mastra_core_storage.resolveListOrderBy)(args.orderBy, ["createdAt", "status"], {
+				field: "createdAt",
+				direction: "DESC"
+			});
 			const { page, perPage: perPageInput } = args.pagination;
 			const conditions = [];
 			const queryParams = [];
@@ -5227,7 +5243,7 @@ var ExperimentsLibSQL = class extends _mastra_core_storage.ExperimentsStorage {
 			const end = perPageInput === false ? total : start + perPage;
 			return {
 				experiments: (await this.#client.execute({
-					sql: `SELECT ${buildSelectColumns(_mastra_core_storage.TABLE_EXPERIMENTS)} FROM ${_mastra_core_storage.TABLE_EXPERIMENTS} ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
+					sql: `SELECT ${buildSelectColumns(_mastra_core_storage.TABLE_EXPERIMENTS)} FROM ${_mastra_core_storage.TABLE_EXPERIMENTS} ${whereClause} ORDER BY ${orderBy.field} ${orderBy.direction}, id ASC LIMIT ? OFFSET ?`,
 					args: [
 						...queryParams,
 						limitValue,
@@ -5474,6 +5490,10 @@ var ExperimentsLibSQL = class extends _mastra_core_storage.ExperimentsStorage {
 	}
 	async listExperimentResults(args) {
 		try {
+			const orderBy = (0, _mastra_core_storage.resolveListOrderBy)(args.orderBy, ["startedAt", "createdAt"], {
+				field: "startedAt",
+				direction: "ASC"
+			});
 			const { page, perPage: perPageInput } = args.pagination;
 			const conditions = ["experimentId = ?"];
 			const queryParams = [args.experimentId];
@@ -5521,7 +5541,7 @@ var ExperimentsLibSQL = class extends _mastra_core_storage.ExperimentsStorage {
 			const end = perPageInput === false ? total : start + perPage;
 			return {
 				results: (await this.#client.execute({
-					sql: `SELECT ${buildSelectColumns(_mastra_core_storage.TABLE_EXPERIMENT_RESULTS)} FROM ${_mastra_core_storage.TABLE_EXPERIMENT_RESULTS} ${whereClause} ORDER BY startedAt ASC LIMIT ? OFFSET ?`,
+					sql: `SELECT ${buildSelectColumns(_mastra_core_storage.TABLE_EXPERIMENT_RESULTS)} FROM ${_mastra_core_storage.TABLE_EXPERIMENT_RESULTS} ${whereClause} ORDER BY ${orderBy.field} ${orderBy.direction}, id ASC LIMIT ? OFFSET ?`,
 					args: [
 						...queryParams,
 						limitValue,
@@ -13503,7 +13523,7 @@ var WorkflowsLibSQL = class WorkflowsLibSQL extends _mastra_core_storage.Workflo
 			}
 		}, "deleteWorkflowRunById");
 	}
-	async listWorkflowRuns({ workflowName, fromDate, toDate, page, perPage, resourceId, status } = {}) {
+	async listWorkflowRuns({ workflowName, fromDate, toDate, page, perPage, resourceId, threadId, status } = {}) {
 		try {
 			const conditions = [];
 			const args = [];
@@ -13527,6 +13547,10 @@ var WorkflowsLibSQL = class WorkflowsLibSQL extends _mastra_core_storage.Workflo
 				conditions.push("resourceId = ?");
 				args.push(resourceId);
 			} else this.logger.warn(`[${_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT}] resourceId column not found. Skipping resourceId filter.`);
+			if (threadId) {
+				conditions.push(`(EXISTS (SELECT 1 FROM json_each(snapshot, '$.context') AS je WHERE json_extract(je.value, '$.status') = 'suspended' AND json_extract(je.value, '$.suspendPayload.__streamState.messageList.memoryInfo.threadId') = ?) OR json_extract(snapshot, '$.context.input.messageListState.memoryInfo.threadId') = ?)`);
+				args.push(threadId, threadId);
+			}
 			const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
 			let total = 0;
 			const usePagination = typeof perPage === "number" && typeof page === "number";