@mastra/libsql 1.10.1 → 1.11.0

package/dist/index.js

@@ -1,6 +1,6 @@
 import { createClient } from '@libsql/client';
 import { MastraError, ErrorCategory, ErrorDomain } from '@mastra/core/error';
-import { createVectorErrorId, AgentsStorage, AGENTS_SCHEMA, TABLE_AGENTS, AGENT_VERSIONS_SCHEMA, TABLE_AGENT_VERSIONS, createStorageErrorId, normalizePerPage, calculatePagination, BackgroundTasksStorage, TABLE_SCHEMAS, TABLE_BACKGROUND_TASKS, BlobStore, TABLE_SKILL_BLOBS, SKILL_BLOBS_SCHEMA, ChannelsStorage, TABLE_CHANNEL_INSTALLATIONS, TABLE_CHANNEL_CONFIG, DatasetsStorage, DATASETS_SCHEMA, TABLE_DATASETS, DATASET_ITEMS_SCHEMA, TABLE_DATASET_ITEMS, DATASET_VERSIONS_SCHEMA, TABLE_DATASET_VERSIONS, ensureDate, safelyParseJSON, TABLE_EXPERIMENT_RESULTS, TABLE_EXPERIMENTS, ExperimentsStorage, EXPERIMENTS_SCHEMA, EXPERIMENT_RESULTS_SCHEMA, MCPClientsStorage, MCP_CLIENTS_SCHEMA, TABLE_MCP_CLIENTS, MCP_CLIENT_VERSIONS_SCHEMA, TABLE_MCP_CLIENT_VERSIONS, MCPServersStorage, MCP_SERVERS_SCHEMA, TABLE_MCP_SERVERS, MCP_SERVER_VERSIONS_SCHEMA, TABLE_MCP_SERVER_VERSIONS, MemoryStorage, TABLE_THREADS, TABLE_MESSAGES, TABLE_RESOURCES, ObservabilityStorage, SPAN_SCHEMA, TABLE_SPANS, listTracesArgsSchema, toTraceSpans, PromptBlocksStorage, PROMPT_BLOCKS_SCHEMA, TABLE_PROMPT_BLOCKS, PROMPT_BLOCK_VERSIONS_SCHEMA, TABLE_PROMPT_BLOCK_VERSIONS, SchedulesStorage, TABLE_SCHEDULES, TABLE_SCHEDULE_TRIGGERS, ScorerDefinitionsStorage, SCORER_DEFINITIONS_SCHEMA, TABLE_SCORER_DEFINITIONS, SCORER_DEFINITION_VERSIONS_SCHEMA, TABLE_SCORER_DEFINITION_VERSIONS, ScoresStorage, SCORERS_SCHEMA, TABLE_SCORERS, transformScoreRow, SkillsStorage, SKILLS_SCHEMA, TABLE_SKILLS, SKILL_VERSIONS_SCHEMA, TABLE_SKILL_VERSIONS, WorkflowsStorage, TABLE_WORKFLOW_SNAPSHOT, WorkspacesStorage, WORKSPACES_SCHEMA, TABLE_WORKSPACES, WORKSPACE_VERSIONS_SCHEMA, TABLE_WORKSPACE_VERSIONS, MastraCompositeStore, getSqlType, TraceStatus } from '@mastra/core/storage';
+import { createVectorErrorId, AgentsStorage, AGENTS_SCHEMA, TABLE_AGENTS, AGENT_VERSIONS_SCHEMA, TABLE_AGENT_VERSIONS, createStorageErrorId, normalizePerPage, calculatePagination, BackgroundTasksStorage, TABLE_SCHEMAS, TABLE_BACKGROUND_TASKS, BlobStore, TABLE_SKILL_BLOBS, SKILL_BLOBS_SCHEMA, ChannelsStorage, TABLE_CHANNEL_INSTALLATIONS, TABLE_CHANNEL_CONFIG, DatasetsStorage, DATASETS_SCHEMA, TABLE_DATASETS, DATASET_ITEMS_SCHEMA, TABLE_DATASET_ITEMS, DATASET_VERSIONS_SCHEMA, TABLE_DATASET_VERSIONS, ensureDate, safelyParseJSON, TABLE_EXPERIMENT_RESULTS, TABLE_EXPERIMENTS, ExperimentsStorage, EXPERIMENTS_SCHEMA, EXPERIMENT_RESULTS_SCHEMA, FavoritesStorage, FAVORITES_SCHEMA, TABLE_FAVORITES, TABLE_SKILLS, MCPClientsStorage, MCP_CLIENTS_SCHEMA, TABLE_MCP_CLIENTS, MCP_CLIENT_VERSIONS_SCHEMA, TABLE_MCP_CLIENT_VERSIONS, MCPServersStorage, MCP_SERVERS_SCHEMA, TABLE_MCP_SERVERS, MCP_SERVER_VERSIONS_SCHEMA, TABLE_MCP_SERVER_VERSIONS, MemoryStorage, TABLE_THREADS, TABLE_MESSAGES, TABLE_RESOURCES, ObservabilityStorage, SPAN_SCHEMA, TABLE_SPANS, listTracesArgsSchema, toTraceSpans, PromptBlocksStorage, PROMPT_BLOCKS_SCHEMA, TABLE_PROMPT_BLOCKS, PROMPT_BLOCK_VERSIONS_SCHEMA, TABLE_PROMPT_BLOCK_VERSIONS, SchedulesStorage, TABLE_SCHEDULES, TABLE_SCHEDULE_TRIGGERS, ScorerDefinitionsStorage, SCORER_DEFINITIONS_SCHEMA, TABLE_SCORER_DEFINITIONS, SCORER_DEFINITION_VERSIONS_SCHEMA, TABLE_SCORER_DEFINITION_VERSIONS, ScoresStorage, SCORERS_SCHEMA, TABLE_SCORERS, transformScoreRow, SkillsStorage, SKILLS_SCHEMA, SKILL_VERSIONS_SCHEMA, TABLE_SKILL_VERSIONS, WorkflowsStorage, TABLE_WORKFLOW_SNAPSHOT, WorkspacesStorage, WORKSPACES_SCHEMA, TABLE_WORKSPACES, WORKSPACE_VERSIONS_SCHEMA, TABLE_WORKSPACE_VERSIONS, MastraCompositeStore, getSqlType, TraceStatus } from '@mastra/core/storage';
 import { parseSqlIdentifier, parseFieldKey } from '@mastra/core/utils';
 import { MastraVector, validateTopK, validateUpsertInput } from '@mastra/core/vector';
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
@@ -1209,6 +1209,15 @@ function buildSelectColumns(tableName) {
     return colDef?.type === "jsonb" ? `json("${parsedCol}") as "${parsedCol}"` : `"${parsedCol}"`;
   }).join(", ");
 }
+function buildSelectColumnsWithAlias(tableName, alias) {
+  const parsedAlias = parseSqlIdentifier(alias, "table alias");
+  const schema = TABLE_SCHEMAS[tableName];
+  return Object.keys(schema).map((col) => {
+    const colDef = schema[col];
+    const parsedCol = parseSqlIdentifier(col, "column name");
+    return colDef?.type === "jsonb" ? `json(${parsedAlias}."${parsedCol}") as "${parsedCol}"` : `${parsedAlias}."${parsedCol}"`;
+  }).join(", ");
+}
 function isLockError(error) {
   return error.code === "SQLITE_BUSY" || error.code === "SQLITE_LOCKED" || error.message?.toLowerCase().includes("database is locked") || error.message?.toLowerCase().includes("database table is locked") || error.message?.toLowerCase().includes("table is locked") || error.constructor.name === "SqliteError" && error.message?.toLowerCase().includes("locked");
 }
@@ -2259,12 +2268,12 @@ var AgentsLibSQL = class extends AgentsStorage {
     await this.#db.alterTable({
       tableName: TABLE_AGENTS,
       schema: AGENTS_SCHEMA,
-      ifNotExists: ["status", "authorId"]
+      ifNotExists: ["status", "authorId", "visibility", "favoriteCount"]
     });
     await this.#db.alterTable({
       tableName: TABLE_AGENT_VERSIONS,
       schema: AGENT_VERSIONS_SCHEMA,
-      ifNotExists: ["mcpClients", "requestContextSchema", "workspace", "skills", "skillsFormat"]
+      ifNotExists: ["mcpClients", "requestContextSchema", "workspace", "skills", "skillsFormat", "browser"]
     });
     await this.#migrateToolsToJsonbFormat();
     await this.#cleanupStaleDrafts();
@@ -2355,14 +2364,23 @@ var AgentsLibSQL = class extends AgentsStorage {
     });
   }
   /**
-   * Removes stale draft agent records that have no activeVersionId.
+   * Removes stale draft agent records that have no versions at all.
    * These are left behind when createAgent partially fails (inserts thin record
    * but fails to create the version due to schema mismatch).
+   *
+   * A legitimate draft (never published) will have rows in the versions table,
+   * so we must only delete records with zero associated versions.
    */
   async #cleanupStaleDrafts() {
     try {
       await this.#client.execute({
-        sql: `DELETE FROM "${TABLE_AGENTS}" WHERE status = 'draft' AND activeVersionId IS NULL`
+        sql: `DELETE FROM "${TABLE_AGENTS}"
+              WHERE status = 'draft'
+                AND activeVersionId IS NULL
+                AND NOT EXISTS (
+                  SELECT 1 FROM "${TABLE_AGENT_VERSIONS}"
+                  WHERE "${TABLE_AGENT_VERSIONS}".agentId = "${TABLE_AGENTS}".id
+                )`
       });
     } catch {
     }
@@ -2457,7 +2475,9 @@ var AgentsLibSQL = class extends AgentsStorage {
       status: row.status,
       activeVersionId: row.activeVersionId,
       authorId: row.authorId,
+      visibility: row.visibility ?? void 0,
       metadata: this.parseJson(row.metadata, "metadata"),
+      favoriteCount: row.favoriteCount === null || row.favoriteCount === void 0 ? 0 : Number(row.favoriteCount),
       createdAt: new Date(row.createdAt),
       updatedAt: new Date(row.updatedAt)
     };
@@ -2486,6 +2506,7 @@ var AgentsLibSQL = class extends AgentsStorage {
     const { agent } = input;
     try {
       const now = /* @__PURE__ */ new Date();
+      const visibility = agent.visibility ?? (agent.authorId ? "private" : null);
       await this.#db.insert({
         tableName: TABLE_AGENTS,
         record: {
@@ -2493,12 +2514,14 @@ var AgentsLibSQL = class extends AgentsStorage {
           status: "draft",
           activeVersionId: null,
           authorId: agent.authorId ?? null,
+          visibility,
           metadata: agent.metadata ?? null,
+          favoriteCount: 0,
           createdAt: now,
           updatedAt: now
         }
       });
-      const { id: _id, authorId: _authorId, metadata: _metadata, ...snapshotConfig } = agent;
+      const { id: _id, authorId: _authorId, visibility: _visibility, metadata: _metadata, ...snapshotConfig } = agent;
       const versionId = crypto.randomUUID();
       await this.createVersion({
         id: versionId,
@@ -2547,13 +2570,14 @@ var AgentsLibSQL = class extends AgentsStorage {
           details: { agentId: id }
         });
       }
-      const { authorId, activeVersionId, metadata, status } = updates;
+      const { authorId, activeVersionId, metadata, status, visibility } = updates;
       const updateData = {
         updatedAt: (/* @__PURE__ */ new Date()).toISOString()
       };
       if (authorId !== void 0) updateData.authorId = authorId;
       if (activeVersionId !== void 0) updateData.activeVersionId = activeVersionId;
       if (status !== void 0) updateData.status = status;
+      if (visibility !== void 0) updateData.visibility = visibility;
       if (metadata !== void 0) {
         updateData.metadata = { ...existing.metadata, ...metadata };
       }
@@ -2609,7 +2633,18 @@ var AgentsLibSQL = class extends AgentsStorage {
     }
   }
   async list(args) {
-    const { page = 0, perPage: perPageInput, orderBy, authorId, metadata, status } = args || {};
+    const {
+      page = 0,
+      perPage: perPageInput,
+      orderBy,
+      authorId,
+      metadata,
+      status,
+      visibility,
+      entityIds,
+      pinFavoritedFor,
+      favoritedOnly
+    } = args || {};
     const { field, direction } = this.parseOrderBy(orderBy);
     if (page < 0) {
       throw new MastraError(
@@ -2625,16 +2660,29 @@ var AgentsLibSQL = class extends AgentsStorage {
     const perPage = normalizePerPage(perPageInput, 100);
     const { offset, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
     try {
+      if (entityIds && entityIds.length === 0) {
+        return {
+          agents: [],
+          total: 0,
+          page,
+          perPage: perPageForResponse,
+          hasMore: false
+        };
+      }
       const conditions = [];
       const queryParams = [];
       if (status) {
-        conditions.push("status = ?");
+        conditions.push("a.status = ?");
         queryParams.push(status);
       }
       if (authorId !== void 0) {
-        conditions.push("authorId = ?");
+        conditions.push("a.authorId = ?");
         queryParams.push(authorId);
       }
+      if (visibility !== void 0) {
+        conditions.push("a.visibility = ?");
+        queryParams.push(visibility);
+      }
       if (metadata && Object.keys(metadata).length > 0) {
         for (const [key, value] of Object.entries(metadata)) {
           if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(key)) {
@@ -2646,14 +2694,32 @@ var AgentsLibSQL = class extends AgentsStorage {
               details: { key }
             });
           }
-          conditions.push(`json_extract(metadata, '$.${key}') = ?`);
+          conditions.push(`json_extract(a.metadata, '$.${key}') = ?`);
           queryParams.push(typeof value === "string" ? value : JSON.stringify(value));
         }
       }
+      if (entityIds && entityIds.length > 0) {
+        const placeholders = entityIds.map(() => "?").join(", ");
+        conditions.push(`a.id IN (${placeholders})`);
+        queryParams.push(...entityIds);
+      }
+      const joinUserId = pinFavoritedFor;
+      const useJoin = Boolean(joinUserId);
+      let joinClause = "";
+      const joinParams = [];
+      if (useJoin && joinUserId) {
+        joinClause = `LEFT JOIN "${TABLE_FAVORITES}" s ON s."entityType" = 'agent' AND s."entityId" = a.id AND s."userId" = ?`;
+        joinParams.push(joinUserId);
+        if (favoritedOnly) {
+          conditions.push('s."userId" IS NOT NULL');
+        }
+      } else if (favoritedOnly) {
+        conditions.push("1=0");
+      }
       const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
       const countResult = await this.#client.execute({
-        sql: `SELECT COUNT(*) as count FROM "${TABLE_AGENTS}" ${whereClause}`,
-        args: queryParams
+        sql: `SELECT COUNT(*) as count FROM "${TABLE_AGENTS}" a ${joinClause} ${whereClause}`,
+        args: [...joinParams, ...queryParams]
       });
       const total = Number(countResult.rows?.[0]?.count ?? 0);
       if (total === 0) {
@@ -2665,10 +2731,18 @@ var AgentsLibSQL = class extends AgentsStorage {
           hasMore: false
         };
       }
+      const orderByParts = [];
+      if (useJoin && joinUserId) {
+        orderByParts.push(`(s."userId" IS NOT NULL) DESC`);
+      }
+      orderByParts.push(`a."${field}" ${direction}`);
+      orderByParts.push(`a."id" ASC`);
+      const orderByClause = `ORDER BY ${orderByParts.join(", ")}`;
       const limitValue = perPageInput === false ? total : perPage;
+      const selectCols = buildSelectColumnsWithAlias(TABLE_AGENTS, "a");
       const result = await this.#client.execute({
-        sql: `SELECT ${buildSelectColumns(TABLE_AGENTS)} FROM "${TABLE_AGENTS}" ${whereClause} ORDER BY "${field}" ${direction} LIMIT ? OFFSET ?`,
-        args: [...queryParams, limitValue, offset]
+        sql: `SELECT ${selectCols} FROM "${TABLE_AGENTS}" a ${joinClause} ${whereClause} ${orderByClause} LIMIT ? OFFSET ?`,
+        args: [...joinParams, ...queryParams, limitValue, offset]
       });
       const rows = result.rows ?? [];
       const agents = rows.map((row) => this.parseRow(row));
@@ -2721,6 +2795,7 @@ var AgentsLibSQL = class extends AgentsStorage {
           workspace: input.workspace ?? null,
           skills: input.skills ?? null,
           skillsFormat: input.skillsFormat ?? null,
+          browser: input.browser ?? null,
           changedFields: input.changedFields ?? null,
           changeMessage: input.changeMessage ?? null,
           createdAt: now
@@ -2994,6 +3069,7 @@ var AgentsLibSQL = class extends AgentsStorage {
       workspace: this.parseJson(row.workspace, "workspace"),
       skills: this.parseJson(row.skills, "skills"),
       skillsFormat: row.skillsFormat,
+      browser: this.parseJson(row.browser, "browser"),
       changedFields: this.parseJson(row.changedFields, "changedFields"),
       changeMessage: row.changeMessage,
       createdAt: new Date(row.createdAt)
@@ -4975,6 +5051,255 @@ var ExperimentsLibSQL = class extends ExperimentsStorage {
     }
   }
 };
+var ENTITY_TABLE = {
+  agent: TABLE_AGENTS,
+  skill: TABLE_SKILLS
+};
+var FavoritesLibSQL = class extends FavoritesStorage {
+  #db;
+  #client;
+  constructor(config) {
+    super();
+    const client = resolveClient(config);
+    this.#client = client;
+    this.#db = new LibSQLDB({ client, maxRetries: config.maxRetries, initialBackoffMs: config.initialBackoffMs });
+  }
+  async init() {
+    await this.#db.createTable({
+      tableName: TABLE_FAVORITES,
+      schema: FAVORITES_SCHEMA,
+      compositePrimaryKey: ["userId", "entityType", "entityId"]
+    });
+    await this.#client.execute(
+      `CREATE INDEX IF NOT EXISTS idx_favorites_entity ON "${TABLE_FAVORITES}" ("entityType", "entityId")`
+    );
+  }
+  async dangerouslyClearAll() {
+    const tx = await this.#client.transaction("write");
+    try {
+      await tx.execute(`DELETE FROM "${TABLE_FAVORITES}"`);
+      await tx.execute(`UPDATE "${TABLE_AGENTS}" SET "favoriteCount" = 0 WHERE "favoriteCount" > 0`);
+      await tx.execute(`UPDATE "${TABLE_SKILLS}" SET "favoriteCount" = 0 WHERE "favoriteCount" > 0`);
+      await tx.commit();
+    } catch (error) {
+      if (!tx.closed) {
+        await tx.rollback();
+      }
+      throw error;
+    }
+  }
+  async favorite(input) {
+    const { userId, entityType, entityId } = input;
+    const entityTable = ENTITY_TABLE[entityType];
+    try {
+      const tx = await this.#client.transaction("write");
+      try {
+        const entityRow = await tx.execute({
+          sql: `SELECT "favoriteCount" FROM "${entityTable}" WHERE id = ?`,
+          args: [entityId]
+        });
+        if (!entityRow.rows?.[0]) {
+          throw new MastraError({
+            id: createStorageErrorId("LIBSQL", "FAVORITE", "ENTITY_NOT_FOUND"),
+            domain: ErrorDomain.STORAGE,
+            category: ErrorCategory.USER,
+            text: `${entityType} ${entityId} not found`,
+            details: { entityType, entityId }
+          });
+        }
+        const inserted = await tx.execute({
+          sql: `INSERT OR IGNORE INTO "${TABLE_FAVORITES}" ("userId", "entityType", "entityId", "createdAt") VALUES (?, ?, ?, ?)`,
+          args: [userId, entityType, entityId, (/* @__PURE__ */ new Date()).toISOString()]
+        });
+        if ((inserted.rowsAffected ?? 0) > 0) {
+          await tx.execute({
+            sql: `UPDATE "${entityTable}" SET "favoriteCount" = COALESCE("favoriteCount", 0) + 1 WHERE id = ?`,
+            args: [entityId]
+          });
+        }
+        const after = await tx.execute({
+          sql: `SELECT "favoriteCount" FROM "${entityTable}" WHERE id = ?`,
+          args: [entityId]
+        });
+        const favoriteCount = Number(after.rows?.[0]?.favoriteCount ?? 0);
+        await tx.commit();
+        return { favorited: true, favoriteCount };
+      } catch (error) {
+        if (!tx.closed) {
+          await tx.rollback();
+        }
+        throw error;
+      }
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "FAVORITE", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { entityType, entityId }
+        },
+        error
+      );
+    }
+  }
+  async unfavorite(input) {
+    const { userId, entityType, entityId } = input;
+    const entityTable = ENTITY_TABLE[entityType];
+    try {
+      const tx = await this.#client.transaction("write");
+      try {
+        const entityRow = await tx.execute({
+          sql: `SELECT "favoriteCount" FROM "${entityTable}" WHERE id = ?`,
+          args: [entityId]
+        });
+        if (!entityRow.rows?.[0]) {
+          throw new MastraError({
+            id: createStorageErrorId("LIBSQL", "UNFAVORITE", "ENTITY_NOT_FOUND"),
+            domain: ErrorDomain.STORAGE,
+            category: ErrorCategory.USER,
+            text: `${entityType} ${entityId} not found`,
+            details: { entityType, entityId }
+          });
+        }
+        const deleted = await tx.execute({
+          sql: `DELETE FROM "${TABLE_FAVORITES}" WHERE "userId" = ? AND "entityType" = ? AND "entityId" = ?`,
+          args: [userId, entityType, entityId]
+        });
+        if ((deleted.rowsAffected ?? 0) > 0) {
+          await tx.execute({
+            sql: `UPDATE "${entityTable}" SET "favoriteCount" = MAX(COALESCE("favoriteCount", 0) - 1, 0) WHERE id = ?`,
+            args: [entityId]
+          });
+        }
+        const after = await tx.execute({
+          sql: `SELECT "favoriteCount" FROM "${entityTable}" WHERE id = ?`,
+          args: [entityId]
+        });
+        const favoriteCount = Number(after.rows?.[0]?.favoriteCount ?? 0);
+        await tx.commit();
+        return { favorited: false, favoriteCount };
+      } catch (error) {
+        if (!tx.closed) {
+          await tx.rollback();
+        }
+        throw error;
+      }
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "UNFAVORITE", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { entityType, entityId }
+        },
+        error
+      );
+    }
+  }
+  async isFavorited(input) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT 1 FROM "${TABLE_FAVORITES}" WHERE "userId" = ? AND "entityType" = ? AND "entityId" = ? LIMIT 1`,
+        args: [input.userId, input.entityType, input.entityId]
+      });
+      return (result.rows?.length ?? 0) > 0;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "IS_FAVORITED", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async isFavoritedBatch(input) {
+    const { userId, entityType, entityIds } = input;
+    if (entityIds.length === 0) {
+      return /* @__PURE__ */ new Set();
+    }
+    try {
+      const placeholders = entityIds.map(() => "?").join(", ");
+      const args = [userId, entityType, ...entityIds];
+      const result = await this.#client.execute({
+        sql: `SELECT "entityId" FROM "${TABLE_FAVORITES}" WHERE "userId" = ? AND "entityType" = ? AND "entityId" IN (${placeholders})`,
+        args
+      });
+      const set = /* @__PURE__ */ new Set();
+      for (const row of result.rows ?? []) {
+        set.add(row.entityId);
+      }
+      return set;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "IS_FAVORITED_BATCH", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async listFavoritedIds(input) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT "entityId" FROM "${TABLE_FAVORITES}" WHERE "userId" = ? AND "entityType" = ? ORDER BY "createdAt" DESC, "entityId" ASC`,
+        args: [input.userId, input.entityType]
+      });
+      return (result.rows ?? []).map((row) => row.entityId);
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "LIST_FAVORITED_IDS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async deleteFavoritesForEntity(input) {
+    const entityTable = ENTITY_TABLE[input.entityType];
+    try {
+      const tx = await this.#client.transaction("write");
+      try {
+        const result = await tx.execute({
+          sql: `DELETE FROM "${TABLE_FAVORITES}" WHERE "entityType" = ? AND "entityId" = ?`,
+          args: [input.entityType, input.entityId]
+        });
+        await tx.execute({
+          sql: `UPDATE "${entityTable}" SET "favoriteCount" = 0 WHERE id = ?`,
+          args: [input.entityId]
+        });
+        await tx.commit();
+        return Number(result.rowsAffected ?? 0);
+      } catch (txError) {
+        if (!tx.closed) {
+          await tx.rollback();
+        }
+        throw txError;
+      }
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "DELETE_FAVORITES_FOR_ENTITY", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { entityType: input.entityType, entityId: input.entityId }
+        },
+        error
+      );
+    }
+  }
+};
 var MCPClientsLibSQL = class extends MCPClientsStorage {
   #db;
   #client;
@@ -10046,6 +10371,7 @@ var SNAPSHOT_FIELDS = [
   "references",
   "scripts",
   "assets",
+  "files",
   "metadata",
   "tree"
 ];
@@ -10064,6 +10390,16 @@ var SkillsLibSQL = class extends SkillsStorage {
       tableName: TABLE_SKILL_VERSIONS,
       schema: SKILL_VERSIONS_SCHEMA
     });
+    await this.#db.alterTable({
+      tableName: TABLE_SKILLS,
+      schema: SKILLS_SCHEMA,
+      ifNotExists: ["visibility", "favoriteCount"]
+    });
+    await this.#db.alterTable({
+      tableName: TABLE_SKILL_VERSIONS,
+      schema: SKILL_VERSIONS_SCHEMA,
+      ifNotExists: ["files"]
+    });
     await this.#client.execute(
       `CREATE UNIQUE INDEX IF NOT EXISTS idx_skill_versions_skill_version ON "${TABLE_SKILL_VERSIONS}" ("skillId", "versionNumber")`
     );
@@ -10099,6 +10435,7 @@ var SkillsLibSQL = class extends SkillsStorage {
     const { skill } = input;
     try {
       const now = /* @__PURE__ */ new Date();
+      const visibility = skill.visibility ?? (skill.authorId ? "private" : void 0);
       await this.#db.insert({
         tableName: TABLE_SKILLS,
         record: {
@@ -10106,11 +10443,13 @@ var SkillsLibSQL = class extends SkillsStorage {
           status: "draft",
           activeVersionId: null,
           authorId: skill.authorId ?? null,
+          visibility: visibility ?? null,
+          favoriteCount: 0,
           createdAt: now.toISOString(),
           updatedAt: now.toISOString()
         }
       });
-      const { id: _id, authorId: _authorId, ...snapshotConfig } = skill;
+      const { id: _id, authorId: _authorId, visibility: _visibility, ...snapshotConfig } = skill;
       const versionId = crypto.randomUUID();
       try {
         await this.createVersion({
@@ -10158,13 +10497,18 @@ var SkillsLibSQL = class extends SkillsStorage {
           details: { skillId: id }
         });
       }
-      const { authorId, activeVersionId, status, ...configFields } = updates;
+      const { authorId, visibility, activeVersionId, status, ...rawConfigFields } = updates;
+      const configFields = {};
+      for (const [key, value] of Object.entries(rawConfigFields)) {
+        if (value !== void 0) configFields[key] = value;
+      }
       const configFieldNames = SNAPSHOT_FIELDS;
       const hasConfigUpdate = configFieldNames.some((field) => field in configFields);
       const updateData = {
         updatedAt: (/* @__PURE__ */ new Date()).toISOString()
       };
       if (authorId !== void 0) updateData.authorId = authorId;
+      if (visibility !== void 0) updateData.visibility = visibility;
       if (activeVersionId !== void 0) {
         updateData.activeVersionId = activeVersionId;
         if (status === void 0) {
@@ -10257,18 +10601,63 @@ var SkillsLibSQL = class extends SkillsStorage {
   }
   async list(args) {
     try {
-      const { page = 0, perPage: perPageInput, orderBy, authorId } = args || {};
+      const {
+        page = 0,
+        perPage: perPageInput,
+        orderBy,
+        authorId,
+        visibility,
+        status,
+        entityIds,
+        pinFavoritedFor,
+        favoritedOnly
+      } = args || {};
       const { field, direction } = this.parseOrderBy(orderBy);
+      if (entityIds && entityIds.length === 0) {
+        return {
+          skills: [],
+          total: 0,
+          page,
+          perPage: perPageInput ?? 100,
+          hasMore: false
+        };
+      }
       const conditions = [];
       const queryParams = [];
       if (authorId !== void 0) {
-        conditions.push("authorId = ?");
+        conditions.push("s_e.authorId = ?");
         queryParams.push(authorId);
       }
+      if (visibility !== void 0) {
+        conditions.push("s_e.visibility = ?");
+        queryParams.push(visibility);
+      }
+      if (status !== void 0) {
+        conditions.push("s_e.status = ?");
+        queryParams.push(status);
+      }
+      if (entityIds && entityIds.length > 0) {
+        const placeholders = entityIds.map(() => "?").join(", ");
+        conditions.push(`s_e.id IN (${placeholders})`);
+        queryParams.push(...entityIds);
+      }
+      const joinUserId = pinFavoritedFor;
+      const useJoin = Boolean(joinUserId);
+      let joinClause = "";
+      const joinParams = [];
+      if (useJoin && joinUserId) {
+        joinClause = `LEFT JOIN "${TABLE_FAVORITES}" st ON st."entityType" = 'skill' AND st."entityId" = s_e.id AND st."userId" = ?`;
+        joinParams.push(joinUserId);
+        if (favoritedOnly) {
+          conditions.push('st."userId" IS NOT NULL');
+        }
+      } else if (favoritedOnly) {
+        conditions.push("1=0");
+      }
       const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
       const countResult = await this.#client.execute({
-        sql: `SELECT COUNT(*) as count FROM "${TABLE_SKILLS}" ${whereClause}`,
-        args: queryParams
+        sql: `SELECT COUNT(*) as count FROM "${TABLE_SKILLS}" s_e ${joinClause} ${whereClause}`,
+        args: [...joinParams, ...queryParams]
       });
       const total = Number(countResult.rows?.[0]?.count ?? 0);
       if (total === 0) {
@@ -10284,9 +10673,17 @@ var SkillsLibSQL = class extends SkillsStorage {
       const { offset: start, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
       const limitValue = perPageInput === false ? total : perPage;
       const end = perPageInput === false ? total : start + perPage;
+      const orderByParts = [];
+      if (useJoin && joinUserId) {
+        orderByParts.push(`(st."userId" IS NOT NULL) DESC`);
+      }
+      orderByParts.push(`s_e."${field}" ${direction}`);
+      orderByParts.push(`s_e."id" ASC`);
+      const orderByClause = `ORDER BY ${orderByParts.join(", ")}`;
+      const selectCols = buildSelectColumnsWithAlias(TABLE_SKILLS, "s_e");
       const result = await this.#client.execute({
-        sql: `SELECT ${buildSelectColumns(TABLE_SKILLS)} FROM "${TABLE_SKILLS}" ${whereClause} ORDER BY ${field} ${direction} LIMIT ? OFFSET ?`,
-        args: [...queryParams, limitValue, start]
+        sql: `SELECT ${selectCols} FROM "${TABLE_SKILLS}" s_e ${joinClause} ${whereClause} ${orderByClause} LIMIT ? OFFSET ?`,
+        args: [...joinParams, ...queryParams, limitValue, start]
       });
       const skills = result.rows?.map((row) => this.#parseSkillRow(row)) ?? [];
       return {
@@ -10318,9 +10715,9 @@ var SkillsLibSQL = class extends SkillsStorage {
         sql: `INSERT INTO "${TABLE_SKILL_VERSIONS}" (
           id, "skillId", "versionNumber",
           name, description, instructions, license, compatibility,
-          source, "references", scripts, assets, metadata, tree,
+          source, "references", scripts, assets, files, metadata, tree,
           "changedFields", "changeMessage", "createdAt"
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
         args: [
           input.id,
           input.skillId,
@@ -10334,6 +10731,7 @@ var SkillsLibSQL = class extends SkillsStorage {
           input.references ? JSON.stringify(input.references) : null,
           input.scripts ? JSON.stringify(input.scripts) : null,
           input.assets ? JSON.stringify(input.assets) : null,
+          input.files ? JSON.stringify(input.files) : null,
           input.metadata ? JSON.stringify(input.metadata) : null,
           input.tree ? JSON.stringify(input.tree) : null,
           input.changedFields ? JSON.stringify(input.changedFields) : null,
@@ -10527,6 +10925,8 @@ var SkillsLibSQL = class extends SkillsStorage {
       status: row.status ?? "draft",
       activeVersionId: row.activeVersionId ?? void 0,
       authorId: row.authorId ?? void 0,
+      visibility: row.visibility ?? void 0,
+      favoriteCount: row.favoriteCount === null || row.favoriteCount === void 0 ? 0 : Number(row.favoriteCount),
       createdAt: new Date(row.createdAt),
       updatedAt: new Date(row.updatedAt)
     };
@@ -10556,6 +10956,7 @@ var SkillsLibSQL = class extends SkillsStorage {
       references: safeParseJSON(row.references),
       scripts: safeParseJSON(row.scripts),
       assets: safeParseJSON(row.assets),
+      files: safeParseJSON(row.files),
       metadata: safeParseJSON(row.metadata),
       tree: safeParseJSON(row.tree),
       changedFields: safeParseJSON(row.changedFields),
@@ -11007,7 +11408,11 @@ var WorkspacesLibSQL = class extends WorkspacesStorage {
           details: { workspaceId: id }
         });
       }
-      const { authorId, activeVersionId, metadata, status, ...configFields } = updates;
+      const { authorId, activeVersionId, metadata, status, ...rawConfigFields } = updates;
+      const configFields = {};
+      for (const [key, value] of Object.entries(rawConfigFields)) {
+        if (value !== void 0) configFields[key] = value;
+      }
       const configFieldNames = SNAPSHOT_FIELDS2;
       const hasConfigUpdate = configFieldNames.some((field) => field in configFields);
       const updateData = {
@@ -11492,6 +11897,7 @@ var LibSQLStore = class extends MastraCompositeStore {
     const mcpServers = new MCPServersLibSQL(domainConfig);
     const workspaces = new WorkspacesLibSQL(domainConfig);
     const skills = new SkillsLibSQL(domainConfig);
+    const favorites = new FavoritesLibSQL(domainConfig);
     const blobs = new BlobsLibSQL(domainConfig);
     const backgroundTasks = new BackgroundTasksLibSQL(domainConfig);
     const schedules = new SchedulesLibSQL(domainConfig);
@@ -11510,6 +11916,7 @@ var LibSQLStore = class extends MastraCompositeStore {
       mcpServers,
       workspaces,
       skills,
+      favorites,
       blobs,
       backgroundTasks,
       schedules
@@ -11673,6 +12080,6 @@ Example Complex Query:
   ]
 }`;
 
-export { AgentsLibSQL, BackgroundTasksLibSQL, BlobsLibSQL, ChannelsLibSQL, DatasetsLibSQL, LibSQLStore as DefaultStorage, ExperimentsLibSQL, LIBSQL_PROMPT, LibSQLStore, LibSQLVector, MCPClientsLibSQL, MCPServersLibSQL, MemoryLibSQL, ObservabilityLibSQL, PromptBlocksLibSQL, SchedulesLibSQL, ScorerDefinitionsLibSQL, ScoresLibSQL, SkillsLibSQL, WorkflowsLibSQL, WorkspacesLibSQL };
+export { AgentsLibSQL, BackgroundTasksLibSQL, BlobsLibSQL, ChannelsLibSQL, DatasetsLibSQL, LibSQLStore as DefaultStorage, ExperimentsLibSQL, FavoritesLibSQL, LIBSQL_PROMPT, LibSQLStore, LibSQLVector, MCPClientsLibSQL, MCPServersLibSQL, MemoryLibSQL, ObservabilityLibSQL, PromptBlocksLibSQL, SchedulesLibSQL, ScorerDefinitionsLibSQL, ScoresLibSQL, SkillsLibSQL, WorkflowsLibSQL, WorkspacesLibSQL };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map