@mastra/libsql 1.4.0 → 1.5.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, 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, MemoryStorage, TABLE_SCHEMAS, 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, ScorerDefinitionsStorage, SCORER_DEFINITIONS_SCHEMA, TABLE_SCORER_DEFINITIONS, SCORER_DEFINITION_VERSIONS_SCHEMA, TABLE_SCORER_DEFINITION_VERSIONS, ScoresStorage, SCORERS_SCHEMA, TABLE_SCORERS, transformScoreRow, WorkflowsStorage, TABLE_WORKFLOW_SNAPSHOT, MastraCompositeStore, TraceStatus, getSqlType } from '@mastra/core/storage';
+import { createVectorErrorId, AgentsStorage, AGENTS_SCHEMA, TABLE_AGENTS, AGENT_VERSIONS_SCHEMA, TABLE_AGENT_VERSIONS, createStorageErrorId, normalizePerPage, calculatePagination, BlobStore, TABLE_SKILL_BLOBS, SKILL_BLOBS_SCHEMA, 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, MemoryStorage, TABLE_SCHEMAS, 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, 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, TraceStatus, getSqlType } 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';
@@ -1092,7 +1092,7 @@ function buildSelectColumns(tableName) {
   return Object.keys(schema).map((col) => {
     const colDef = schema[col];
     const parsedCol = parseSqlIdentifier(col, "column name");
-    return colDef?.type === "jsonb" ? `json(${parsedCol}) as ${parsedCol}` : parsedCol;
+    return colDef?.type === "jsonb" ? `json("${parsedCol}") as "${parsedCol}"` : `"${parsedCol}"`;
   }).join(", ");
 }
 function isLockError(error) {
@@ -2053,23 +2053,6 @@ Note: This migration may take some time for large tables.
 };
 
 // src/storage/domains/agents/index.ts
-var SNAPSHOT_FIELDS = [
-  "name",
-  "description",
-  "instructions",
-  "model",
-  "tools",
-  "defaultOptions",
-  "workflows",
-  "agents",
-  "integrationTools",
-  "inputProcessors",
-  "outputProcessors",
-  "memory",
-  "scorers",
-  "mcpClients",
-  "requestContextSchema"
-];
 var AgentsLibSQL = class extends AgentsStorage {
   #db;
   #client;
@@ -2089,6 +2072,11 @@ var AgentsLibSQL = class extends AgentsStorage {
       schema: AGENTS_SCHEMA,
       ifNotExists: ["status", "authorId"]
     });
+    await this.#db.alterTable({
+      tableName: TABLE_AGENT_VERSIONS,
+      schema: AGENT_VERSIONS_SCHEMA,
+      ifNotExists: ["mcpClients", "requestContextSchema", "workspace", "skills", "skillsFormat"]
+    });
     await this.#migrateToolsToJsonbFormat();
     await this.#cleanupStaleDrafts();
   }
@@ -2360,8 +2348,8 @@ var AgentsLibSQL = class extends AgentsStorage {
   async update(input) {
     const { id, ...updates } = input;
     try {
-      const existingAgent = await this.getById(id);
-      if (!existingAgent) {
+      const existing = await this.getById(id);
+      if (!existing) {
         throw new MastraError({
           id: createStorageErrorId("LIBSQL", "UPDATE_AGENT", "NOT_FOUND"),
           domain: ErrorDomain.STORAGE,
@@ -2370,68 +2358,21 @@ var AgentsLibSQL = class extends AgentsStorage {
           details: { agentId: id }
         });
       }
-      const metadataFields = {
-        authorId: updates.authorId,
-        activeVersionId: updates.activeVersionId,
-        metadata: updates.metadata
-      };
-      const configFields = {};
-      for (const field of SNAPSHOT_FIELDS) {
-        if (updates[field] !== void 0) {
-          configFields[field] = updates[field];
-        }
-      }
-      if (Object.keys(configFields).length > 0) {
-        const latestVersion = await this.getLatestVersion(id);
-        const nextVersionNumber = latestVersion ? latestVersion.versionNumber + 1 : 1;
-        if (!latestVersion) {
-          throw new MastraError({
-            id: createStorageErrorId("LIBSQL", "UPDATE_AGENT", "NO_VERSION"),
-            domain: ErrorDomain.STORAGE,
-            category: ErrorCategory.USER,
-            text: `Cannot update config fields for agent ${id} - no versions exist`,
-            details: { id }
-          });
-        }
-        const latestSnapshot = {};
-        for (const field of SNAPSHOT_FIELDS) {
-          if (latestVersion[field] !== void 0) {
-            latestSnapshot[field] = latestVersion[field];
-          }
-        }
-        const sanitizedConfigFields = Object.fromEntries(
-          Object.entries(configFields).map(([key, value]) => [key, value === null ? void 0 : value])
-        );
-        const versionInput = {
-          id: crypto.randomUUID(),
-          agentId: id,
-          versionNumber: nextVersionNumber,
-          ...latestSnapshot,
-          // Start from latest version
-          ...sanitizedConfigFields,
-          // Apply updates (null values converted to undefined)
-          changedFields: Object.keys(configFields),
-          changeMessage: `Updated: ${Object.keys(configFields).join(", ")}`
-        };
-        await this.createVersion(versionInput);
-      }
-      const data = {
-        updatedAt: /* @__PURE__ */ new Date()
+      const { authorId, activeVersionId, metadata, status } = updates;
+      const updateData = {
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString()
       };
-      if (metadataFields.authorId !== void 0) data.authorId = metadataFields.authorId;
-      if (metadataFields.activeVersionId !== void 0) {
-        data.activeVersionId = metadataFields.activeVersionId;
-      }
-      if (metadataFields.metadata !== void 0) {
-        data.metadata = metadataFields.metadata;
-      }
-      if (Object.keys(data).length > 1) {
-        await this.#db.update({
-          tableName: TABLE_AGENTS,
-          keys: { id },
-          data
-        });
+      if (authorId !== void 0) updateData.authorId = authorId;
+      if (activeVersionId !== void 0) updateData.activeVersionId = activeVersionId;
+      if (status !== void 0) updateData.status = status;
+      if (metadata !== void 0) {
+        updateData.metadata = { ...existing.metadata, ...metadata };
       }
+      await this.#db.update({
+        tableName: TABLE_AGENTS,
+        keys: { id },
+        data: updateData
+      });
       const updatedAgent = await this.getById(id);
       if (!updatedAgent) {
         throw new MastraError({
@@ -2479,7 +2420,7 @@ var AgentsLibSQL = class extends AgentsStorage {
     }
   }
   async list(args) {
-    const { page = 0, perPage: perPageInput, orderBy } = args || {};
+    const { page = 0, perPage: perPageInput, orderBy, authorId, metadata, status } = args || {};
     const { field, direction } = this.parseOrderBy(orderBy);
     if (page < 0) {
       throw new MastraError(
@@ -2495,7 +2436,37 @@ var AgentsLibSQL = class extends AgentsStorage {
     const perPage = normalizePerPage(perPageInput, 100);
     const { offset, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
     try {
-      const total = await this.#db.selectTotalCount({ tableName: TABLE_AGENTS });
+      const conditions = [];
+      const queryParams = [];
+      if (status) {
+        conditions.push("status = ?");
+        queryParams.push(status);
+      }
+      if (authorId !== void 0) {
+        conditions.push("authorId = ?");
+        queryParams.push(authorId);
+      }
+      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)) {
+            throw new MastraError({
+              id: createStorageErrorId("LIBSQL", "LIST_AGENTS", "INVALID_METADATA_KEY"),
+              domain: ErrorDomain.STORAGE,
+              category: ErrorCategory.USER,
+              text: `Invalid metadata key: ${key}. Keys must be alphanumeric with underscores.`,
+              details: { key }
+            });
+          }
+          conditions.push(`json_extract(metadata, '$.${key}') = ?`);
+          queryParams.push(typeof value === "string" ? value : JSON.stringify(value));
+        }
+      }
+      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
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
       if (total === 0) {
         return {
           agents: [],
@@ -2506,12 +2477,11 @@ var AgentsLibSQL = class extends AgentsStorage {
         };
       }
       const limitValue = perPageInput === false ? total : perPage;
-      const rows = await this.#db.selectMany({
-        tableName: TABLE_AGENTS,
-        orderBy: `"${field}" ${direction}`,
-        limit: limitValue,
-        offset
+      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]
       });
+      const rows = result.rows ?? [];
       const agents = rows.map((row) => this.parseRow(row));
       return {
         agents,
@@ -2559,6 +2529,9 @@ var AgentsLibSQL = class extends AgentsStorage {
           scorers: input.scorers ?? null,
           mcpClients: input.mcpClients ?? null,
           requestContextSchema: input.requestContextSchema ?? null,
+          workspace: input.workspace ?? null,
+          skills: input.skills ?? null,
+          skillsFormat: input.skillsFormat ?? null,
           changedFields: input.changedFields ?? null,
           changeMessage: input.changeMessage ?? null,
           createdAt: now
@@ -2829,12 +2802,101 @@ var AgentsLibSQL = class extends AgentsStorage {
       scorers: this.parseJson(row.scorers, "scorers"),
       mcpClients: this.parseJson(row.mcpClients, "mcpClients"),
       requestContextSchema: this.parseJson(row.requestContextSchema, "requestContextSchema"),
+      workspace: this.parseJson(row.workspace, "workspace"),
+      skills: this.parseJson(row.skills, "skills"),
+      skillsFormat: row.skillsFormat,
       changedFields: this.parseJson(row.changedFields, "changedFields"),
       changeMessage: row.changeMessage,
       createdAt: new Date(row.createdAt)
     };
   }
 };
+var BlobsLibSQL = class extends BlobStore {
+  #db;
+  #client;
+  static MANAGED_TABLES = [TABLE_SKILL_BLOBS];
+  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_SKILL_BLOBS, schema: SKILL_BLOBS_SCHEMA });
+  }
+  async put(entry) {
+    const now = entry.createdAt ?? /* @__PURE__ */ new Date();
+    await this.#client.execute({
+      sql: `INSERT OR IGNORE INTO "${TABLE_SKILL_BLOBS}" ("hash", "content", "size", "mimeType", "createdAt") VALUES (?, ?, ?, ?, ?)`,
+      args: [entry.hash, entry.content, entry.size, entry.mimeType ?? null, now.toISOString()]
+    });
+  }
+  async get(hash) {
+    const result = await this.#client.execute({
+      sql: `SELECT ${buildSelectColumns(TABLE_SKILL_BLOBS)} FROM "${TABLE_SKILL_BLOBS}" WHERE "hash" = ?`,
+      args: [hash]
+    });
+    if (!result.rows.length) return null;
+    return this.#parseRow(result.rows[0]);
+  }
+  async has(hash) {
+    const result = await this.#client.execute({
+      sql: `SELECT 1 FROM "${TABLE_SKILL_BLOBS}" WHERE "hash" = ? LIMIT 1`,
+      args: [hash]
+    });
+    return result.rows.length > 0;
+  }
+  async delete(hash) {
+    const result = await this.#client.execute({
+      sql: `DELETE FROM "${TABLE_SKILL_BLOBS}" WHERE "hash" = ?`,
+      args: [hash]
+    });
+    return result.rowsAffected > 0;
+  }
+  async putMany(entries) {
+    if (entries.length === 0) return;
+    await this.#db.batchInsert({
+      tableName: TABLE_SKILL_BLOBS,
+      records: entries.map((entry) => ({
+        hash: entry.hash,
+        content: entry.content,
+        size: entry.size,
+        mimeType: entry.mimeType ?? null,
+        createdAt: (entry.createdAt ?? /* @__PURE__ */ new Date()).toISOString()
+      }))
+    });
+  }
+  async getMany(hashes) {
+    const result = /* @__PURE__ */ new Map();
+    if (hashes.length === 0) return result;
+    const batchSize = 500;
+    for (let i = 0; i < hashes.length; i += batchSize) {
+      const batch = hashes.slice(i, i + batchSize);
+      const placeholders = batch.map(() => "?").join(", ");
+      const queryResult = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_SKILL_BLOBS)} FROM "${TABLE_SKILL_BLOBS}" WHERE "hash" IN (${placeholders})`,
+        args: batch
+      });
+      for (const row of queryResult.rows) {
+        const entry = this.#parseRow(row);
+        result.set(entry.hash, entry);
+      }
+    }
+    return result;
+  }
+  async dangerouslyClearAll() {
+    await this.#db.deleteData({ tableName: TABLE_SKILL_BLOBS });
+  }
+  #parseRow(row) {
+    return {
+      hash: row.hash,
+      content: row.content,
+      size: Number(row.size),
+      mimeType: row.mimeType || void 0,
+      createdAt: new Date(row.createdAt)
+    };
+  }
+};
 function jsonbArg(value) {
   return value === void 0 || value === null ? null : JSON.stringify(value);
 }
@@ -2950,8 +3012,8 @@ var DatasetsLibSQL = class extends DatasetsStorage {
         name: input.name,
         description: input.description,
         metadata: input.metadata,
-        inputSchema: input.inputSchema,
-        groundTruthSchema: input.groundTruthSchema,
+        inputSchema: input.inputSchema ?? void 0,
+        groundTruthSchema: input.groundTruthSchema ?? void 0,
         version: 0,
         createdAt: now,
         updatedAt: now
@@ -3029,8 +3091,8 @@ var DatasetsLibSQL = class extends DatasetsStorage {
         name: args.name ?? existing.name,
         description: args.description ?? existing.description,
         metadata: args.metadata ?? existing.metadata,
-        inputSchema: args.inputSchema !== void 0 ? args.inputSchema : existing.inputSchema,
-        groundTruthSchema: args.groundTruthSchema !== void 0 ? args.groundTruthSchema : existing.groundTruthSchema,
+        inputSchema: (args.inputSchema !== void 0 ? args.inputSchema : existing.inputSchema) ?? void 0,
+        groundTruthSchema: (args.groundTruthSchema !== void 0 ? args.groundTruthSchema : existing.groundTruthSchema) ?? void 0,
         updatedAt: new Date(now)
       };
     } catch (error) {
@@ -4089,7 +4151,6 @@ var ExperimentsLibSQL = class extends ExperimentsStorage {
     }
   }
 };
-var SNAPSHOT_FIELDS2 = ["name", "description", "servers"];
 var MCPClientsLibSQL = class extends MCPClientsStorage {
   #db;
   #client;
@@ -4195,19 +4256,12 @@ var MCPClientsLibSQL = class extends MCPClientsStorage {
       if (!existing) {
         throw new Error(`MCP client with id ${id} not found`);
       }
-      const { authorId, activeVersionId, metadata, status, ...configFields } = updates;
-      const configFieldNames = SNAPSHOT_FIELDS2;
-      const hasConfigUpdate = configFieldNames.some((field) => field in configFields);
+      const { authorId, activeVersionId, metadata, status } = 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 = "published";
-        }
-      }
+      if (activeVersionId !== void 0) updateData.activeVersionId = activeVersionId;
       if (status !== void 0) updateData.status = status;
       if (metadata !== void 0) {
         updateData.metadata = { ...existing.metadata, ...metadata };
@@ -4217,36 +4271,6 @@ var MCPClientsLibSQL = class extends MCPClientsStorage {
         keys: { id },
         data: updateData
       });
-      if (hasConfigUpdate) {
-        const latestVersion = await this.getLatestVersion(id);
-        if (!latestVersion) {
-          throw new Error(`No versions found for MCP client ${id}`);
-        }
-        const {
-          id: _versionId,
-          mcpClientId: _mcpClientId,
-          versionNumber: _versionNumber,
-          changedFields: _changedFields,
-          changeMessage: _changeMessage,
-          createdAt: _createdAt,
-          ...latestConfig
-        } = latestVersion;
-        const newConfig = { ...latestConfig, ...configFields };
-        const changedFields = configFieldNames.filter(
-          (field) => field in configFields && JSON.stringify(configFields[field]) !== JSON.stringify(latestConfig[field])
-        );
-        if (changedFields.length > 0) {
-          const newVersionId = crypto.randomUUID();
-          await this.createVersion({
-            id: newVersionId,
-            mcpClientId: id,
-            versionNumber: latestVersion.versionNumber + 1,
-            ...newConfig,
-            changedFields,
-            changeMessage: `Updated ${changedFields.join(", ")}`
-          });
-        }
-      }
       const updated = await this.getById(id);
       if (!updated) {
         throw new MastraError({
@@ -4291,10 +4315,12 @@ var MCPClientsLibSQL = class extends MCPClientsStorage {
   }
   async list(args) {
     try {
-      const { page = 0, perPage: perPageInput, orderBy, authorId, metadata } = args || {};
+      const { page = 0, perPage: perPageInput, orderBy, authorId, metadata, status = "published" } = args || {};
       const { field, direction } = this.parseOrderBy(orderBy);
       const conditions = [];
       const queryParams = [];
+      conditions.push("status = ?");
+      queryParams.push(status);
       if (authorId !== void 0) {
         conditions.push("authorId = ?");
         queryParams.push(authorId);
@@ -4314,7 +4340,7 @@ var MCPClientsLibSQL = class extends MCPClientsStorage {
           queryParams.push(typeof value === "string" ? value : JSON.stringify(value));
         }
       }
-      const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+      const whereClause = `WHERE ${conditions.join(" AND ")}`;
       const countResult = await this.#client.execute({
         sql: `SELECT COUNT(*) as count FROM "${TABLE_MCP_CLIENTS}" ${whereClause}`,
         args: queryParams
@@ -5594,7 +5620,7 @@ var MemoryLibSQL = class extends MemoryStorage {
       const newThread = {
         id: newThreadId,
         resourceId: resourceId || sourceThread.resourceId,
-        title: title || (sourceThread.title ? `Clone of ${sourceThread.title}` : void 0),
+        title: title || (sourceThread.title ? `Clone of ${sourceThread.title}` : ""),
         metadata: {
           ...metadata,
           clone: cloneMetadata
@@ -5610,7 +5636,7 @@ var MemoryLibSQL = class extends MemoryStorage {
           args: [
             newThread.id,
             newThread.resourceId,
-            newThread.title || null,
+            newThread.title ?? "",
             JSON.stringify(newThread.metadata),
             nowStr,
             nowStr
@@ -6930,7 +6956,6 @@ var ObservabilityLibSQL = class extends ObservabilityStorage {
     }
   }
 };
-var SNAPSHOT_FIELDS3 = ["name", "description", "content", "rules"];
 var PromptBlocksLibSQL = class extends PromptBlocksStorage {
   #db;
   #client;
@@ -7028,19 +7053,12 @@ var PromptBlocksLibSQL = class extends PromptBlocksStorage {
       if (!existing) {
         throw new Error(`Prompt block with id ${id} not found`);
       }
-      const { authorId, activeVersionId, metadata, status, ...configFields } = updates;
-      const configFieldNames = SNAPSHOT_FIELDS3;
-      const hasConfigUpdate = configFieldNames.some((field) => field in configFields);
+      const { authorId, activeVersionId, metadata, status } = 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 = "published";
-        }
-      }
+      if (activeVersionId !== void 0) updateData.activeVersionId = activeVersionId;
       if (status !== void 0) updateData.status = status;
       if (metadata !== void 0) {
         updateData.metadata = { ...existing.metadata, ...metadata };
@@ -7050,34 +7068,6 @@ var PromptBlocksLibSQL = class extends PromptBlocksStorage {
         keys: { id },
         data: updateData
       });
-      if (hasConfigUpdate) {
-        const latestVersion = await this.getLatestVersion(id);
-        if (!latestVersion) {
-          throw new Error(`No versions found for prompt block ${id}`);
-        }
-        const {
-          id: _versionId,
-          blockId: _blockId,
-          versionNumber: _versionNumber,
-          changedFields: _changedFields,
-          changeMessage: _changeMessage,
-          createdAt: _createdAt,
-          ...latestConfig
-        } = latestVersion;
-        const newConfig = { ...latestConfig, ...configFields };
-        const changedFields = configFieldNames.filter(
-          (field) => field in configFields && JSON.stringify(configFields[field]) !== JSON.stringify(latestConfig[field])
-        );
-        const newVersionId = crypto.randomUUID();
-        await this.createVersion({
-          id: newVersionId,
-          blockId: id,
-          versionNumber: latestVersion.versionNumber + 1,
-          ...newConfig,
-          changedFields,
-          changeMessage: `Updated ${changedFields.join(", ")}`
-        });
-      }
       const updated = await this.getById(id);
       if (!updated) {
         throw new MastraError({
@@ -7122,10 +7112,12 @@ var PromptBlocksLibSQL = class extends PromptBlocksStorage {
   }
   async list(args) {
     try {
-      const { page = 0, perPage: perPageInput, orderBy, authorId, metadata } = args || {};
+      const { page = 0, perPage: perPageInput, orderBy, authorId, metadata, status = "published" } = args || {};
       const { field, direction } = this.parseOrderBy(orderBy);
       const conditions = [];
       const queryParams = [];
+      conditions.push("status = ?");
+      queryParams.push(status);
       if (authorId !== void 0) {
         conditions.push("authorId = ?");
         queryParams.push(authorId);
@@ -7145,7 +7137,7 @@ var PromptBlocksLibSQL = class extends PromptBlocksStorage {
           queryParams.push(typeof value === "string" ? value : JSON.stringify(value));
         }
       }
-      const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+      const whereClause = `WHERE ${conditions.join(" AND ")}`;
       const countResult = await this.#client.execute({
         sql: `SELECT COUNT(*) as count FROM "${TABLE_PROMPT_BLOCKS}" ${whereClause}`,
         args: queryParams
@@ -7437,16 +7429,6 @@ var PromptBlocksLibSQL = class extends PromptBlocksStorage {
     };
   }
 };
-var SNAPSHOT_FIELDS4 = [
-  "name",
-  "description",
-  "type",
-  "model",
-  "instructions",
-  "scoreRange",
-  "presetConfig",
-  "defaultSampling"
-];
 var ScorerDefinitionsLibSQL = class extends ScorerDefinitionsStorage {
   #db;
   #client;
@@ -7547,19 +7529,12 @@ var ScorerDefinitionsLibSQL = class extends ScorerDefinitionsStorage {
       if (!existing) {
         throw new Error(`Scorer definition with id ${id} not found`);
       }
-      const { authorId, activeVersionId, metadata, status, ...configFields } = updates;
-      const configFieldNames = SNAPSHOT_FIELDS4;
-      const hasConfigUpdate = configFieldNames.some((field) => field in configFields);
+      const { authorId, activeVersionId, metadata, status } = 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 = "published";
-        }
-      }
+      if (activeVersionId !== void 0) updateData.activeVersionId = activeVersionId;
       if (status !== void 0) updateData.status = status;
       if (metadata !== void 0) {
         updateData.metadata = { ...existing.metadata, ...metadata };
@@ -7569,34 +7544,6 @@ var ScorerDefinitionsLibSQL = class extends ScorerDefinitionsStorage {
         keys: { id },
         data: updateData
       });
-      if (hasConfigUpdate) {
-        const latestVersion = await this.getLatestVersion(id);
-        if (!latestVersion) {
-          throw new Error(`No versions found for scorer definition ${id}`);
-        }
-        const {
-          id: _versionId,
-          scorerDefinitionId: _scorerDefinitionId,
-          versionNumber: _versionNumber,
-          changedFields: _changedFields,
-          changeMessage: _changeMessage,
-          createdAt: _createdAt,
-          ...latestConfig
-        } = latestVersion;
-        const newConfig = { ...latestConfig, ...configFields };
-        const changedFields = configFieldNames.filter(
-          (field) => field in configFields && JSON.stringify(configFields[field]) !== JSON.stringify(latestConfig[field])
-        );
-        const newVersionId = crypto.randomUUID();
-        await this.createVersion({
-          id: newVersionId,
-          scorerDefinitionId: id,
-          versionNumber: latestVersion.versionNumber + 1,
-          ...newConfig,
-          changedFields,
-          changeMessage: `Updated ${changedFields.join(", ")}`
-        });
-      }
       const updated = await this.getById(id);
       if (!updated) {
         throw new MastraError({
@@ -7641,10 +7588,14 @@ var ScorerDefinitionsLibSQL = class extends ScorerDefinitionsStorage {
   }
   async list(args) {
     try {
-      const { page = 0, perPage: perPageInput, orderBy, authorId, metadata } = args || {};
+      const { page = 0, perPage: perPageInput, orderBy, authorId, metadata, status } = args || {};
       const { field, direction } = this.parseOrderBy(orderBy);
       const conditions = [];
       const queryParams = [];
+      if (status) {
+        conditions.push("status = ?");
+        queryParams.push(status);
+      }
       if (authorId !== void 0) {
         conditions.push("authorId = ?");
         queryParams.push(authorId);
@@ -8260,229 +8211,1237 @@ var ScoresLibSQL = class extends ScoresStorage {
     }
   }
 };
-var WorkflowsLibSQL = class extends WorkflowsStorage {
+var SNAPSHOT_FIELDS = [
+  "name",
+  "description",
+  "instructions",
+  "license",
+  "compatibility",
+  "source",
+  "references",
+  "scripts",
+  "assets",
+  "metadata",
+  "tree"
+];
+var SkillsLibSQL = class extends SkillsStorage {
   #db;
   #client;
-  executeWithRetry;
   constructor(config) {
     super();
     const client = resolveClient(config);
-    const maxRetries = config.maxRetries ?? 5;
-    const initialBackoffMs = config.initialBackoffMs ?? 500;
     this.#client = client;
-    this.#db = new LibSQLDB({ client, maxRetries, initialBackoffMs });
-    this.executeWithRetry = createExecuteWriteOperationWithRetry({
-      logger: this.logger,
-      maxRetries,
-      initialBackoffMs
+    this.#db = new LibSQLDB({ client, maxRetries: config.maxRetries, initialBackoffMs: config.initialBackoffMs });
+  }
+  async init() {
+    await this.#db.createTable({ tableName: TABLE_SKILLS, schema: SKILLS_SCHEMA });
+    await this.#db.createTable({
+      tableName: TABLE_SKILL_VERSIONS,
+      schema: SKILL_VERSIONS_SCHEMA
     });
-    this.setupPragmaSettings().catch(
-      (err) => this.logger.warn("LibSQL Workflows: Failed to setup PRAGMA settings.", err)
+    await this.#client.execute(
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_skill_versions_skill_version ON "${TABLE_SKILL_VERSIONS}" ("skillId", "versionNumber")`
     );
   }
-  parseWorkflowRun(row) {
-    let parsedSnapshot = row.snapshot;
-    if (typeof parsedSnapshot === "string") {
-      try {
-        parsedSnapshot = JSON.parse(row.snapshot);
-      } catch (e) {
-        this.logger.warn(`Failed to parse snapshot for workflow ${row.workflow_name}: ${e}`);
-      }
-    }
-    return {
-      workflowName: row.workflow_name,
-      runId: row.run_id,
-      snapshot: parsedSnapshot,
-      resourceId: row.resourceId,
-      createdAt: new Date(row.createdAt),
-      updatedAt: new Date(row.updatedAt)
-    };
+  async dangerouslyClearAll() {
+    await this.#db.deleteData({ tableName: TABLE_SKILLS });
+    await this.#db.deleteData({ tableName: TABLE_SKILL_VERSIONS });
   }
-  async init() {
-    const schema = TABLE_SCHEMAS[TABLE_WORKFLOW_SNAPSHOT];
-    await this.#db.createTable({ tableName: TABLE_WORKFLOW_SNAPSHOT, schema });
-    await this.#db.alterTable({
-      tableName: TABLE_WORKFLOW_SNAPSHOT,
-      schema,
-      ifNotExists: ["resourceId"]
-    });
-  }
-  async dangerouslyClearAll() {
-    await this.#db.deleteData({ tableName: TABLE_WORKFLOW_SNAPSHOT });
+  // ==========================================================================
+  // Skill CRUD
+  // ==========================================================================
+  async getById(id) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_SKILLS)} FROM "${TABLE_SKILLS}" WHERE id = ?`,
+        args: [id]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseSkillRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_SKILL", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
   }
-  async setupPragmaSettings() {
+  async create(input) {
+    const { skill } = input;
     try {
-      await this.#client.execute("PRAGMA busy_timeout = 10000;");
-      this.logger.debug("LibSQL Workflows: PRAGMA busy_timeout=10000 set.");
-      try {
-        await this.#client.execute("PRAGMA journal_mode = WAL;");
-        this.logger.debug("LibSQL Workflows: PRAGMA journal_mode=WAL set.");
-      } catch {
-        this.logger.debug("LibSQL Workflows: WAL mode not supported, using default journal mode.");
-      }
+      const now = /* @__PURE__ */ new Date();
+      await this.#db.insert({
+        tableName: TABLE_SKILLS,
+        record: {
+          id: skill.id,
+          status: "draft",
+          activeVersionId: null,
+          authorId: skill.authorId ?? null,
+          createdAt: now.toISOString(),
+          updatedAt: now.toISOString()
+        }
+      });
+      const { id: _id, authorId: _authorId, ...snapshotConfig } = skill;
+      const versionId = crypto.randomUUID();
       try {
-        await this.#client.execute("PRAGMA synchronous = NORMAL;");
-        this.logger.debug("LibSQL Workflows: PRAGMA synchronous=NORMAL set.");
-      } catch {
-        this.logger.debug("LibSQL Workflows: Failed to set synchronous mode.");
+        await this.createVersion({
+          id: versionId,
+          skillId: skill.id,
+          versionNumber: 1,
+          ...snapshotConfig,
+          changedFields: Object.keys(snapshotConfig),
+          changeMessage: "Initial version"
+        });
+      } catch (versionError) {
+        await this.#db.delete({ tableName: TABLE_SKILLS, keys: { id: skill.id } });
+        throw versionError;
       }
-    } catch (err) {
-      this.logger.warn("LibSQL Workflows: Failed to set PRAGMA settings.", err);
+      return {
+        id: skill.id,
+        status: "draft",
+        activeVersionId: void 0,
+        authorId: skill.authorId,
+        createdAt: now,
+        updatedAt: now
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "CREATE_SKILL", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
     }
   }
-  async updateWorkflowResults({
-    workflowName,
-    runId,
-    stepId,
-    result,
-    requestContext
-  }) {
-    return this.executeWithRetry(async () => {
-      const tx = await this.#client.transaction("write");
-      try {
-        const existingSnapshotResult = await tx.execute({
-          sql: `SELECT json(snapshot) as snapshot FROM ${TABLE_WORKFLOW_SNAPSHOT} WHERE workflow_name = ? AND run_id = ?`,
-          args: [workflowName, runId]
-        });
-        let snapshot;
-        if (!existingSnapshotResult.rows?.[0]) {
-          snapshot = {
-            context: {},
-            activePaths: [],
-            timestamp: Date.now(),
-            suspendedPaths: {},
-            activeStepsPath: {},
-            resumeLabels: {},
-            serializedStepGraph: [],
-            status: "pending",
-            value: {},
-            waitingPaths: {},
-            runId,
-            requestContext: {}
-          };
-        } else {
-          const existingSnapshot = existingSnapshotResult.rows[0].snapshot;
-          snapshot = typeof existingSnapshot === "string" ? JSON.parse(existingSnapshot) : existingSnapshot;
-        }
-        snapshot.context[stepId] = result;
-        snapshot.requestContext = { ...snapshot.requestContext, ...requestContext };
-        const now = (/* @__PURE__ */ new Date()).toISOString();
-        await tx.execute({
-          sql: `INSERT INTO ${TABLE_WORKFLOW_SNAPSHOT} (workflow_name, run_id, snapshot, createdAt, updatedAt)
-                VALUES (?, ?, jsonb(?), ?, ?)
-                ON CONFLICT(workflow_name, run_id)
-                DO UPDATE SET snapshot = excluded.snapshot, updatedAt = excluded.updatedAt`,
-          args: [workflowName, runId, JSON.stringify(snapshot), now, now]
+  async update(input) {
+    const { id, ...updates } = input;
+    try {
+      const existing = await this.getById(id);
+      if (!existing) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "UPDATE_SKILL", "NOT_FOUND"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          text: `Skill ${id} not found`,
+          details: { skillId: id }
         });
-        await tx.commit();
-        return snapshot.context;
-      } catch (error) {
-        if (!tx.closed) {
-          await tx.rollback();
+      }
+      const { authorId, activeVersionId, status, ...configFields } = updates;
+      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 (activeVersionId !== void 0) {
+        updateData.activeVersionId = activeVersionId;
+        if (status === void 0) {
+          updateData.status = "published";
         }
-        throw error;
       }
-    }, "updateWorkflowResults");
-  }
-  async updateWorkflowState({
-    workflowName,
-    runId,
-    opts
-  }) {
-    return this.executeWithRetry(async () => {
-      const tx = await this.#client.transaction("write");
-      try {
-        const existingSnapshotResult = await tx.execute({
-          sql: `SELECT json(snapshot) as snapshot FROM ${TABLE_WORKFLOW_SNAPSHOT} WHERE workflow_name = ? AND run_id = ?`,
-          args: [workflowName, runId]
-        });
-        if (!existingSnapshotResult.rows?.[0]) {
-          await tx.rollback();
-          return void 0;
+      if (status !== void 0) updateData.status = status;
+      await this.#db.update({
+        tableName: TABLE_SKILLS,
+        keys: { id },
+        data: updateData
+      });
+      if (hasConfigUpdate) {
+        const latestVersion = await this.getLatestVersion(id);
+        if (!latestVersion) {
+          throw new MastraError({
+            id: createStorageErrorId("LIBSQL", "UPDATE_SKILL", "NO_VERSIONS"),
+            domain: ErrorDomain.STORAGE,
+            category: ErrorCategory.USER,
+            text: `No versions found for skill ${id}`,
+            details: { skillId: id }
+          });
         }
-        const existingSnapshot = existingSnapshotResult.rows[0].snapshot;
-        const snapshot = typeof existingSnapshot === "string" ? JSON.parse(existingSnapshot) : existingSnapshot;
-        if (!snapshot || !snapshot?.context) {
-          await tx.rollback();
-          throw new Error(`Snapshot not found for runId ${runId}`);
+        const {
+          id: _versionId,
+          skillId: _skillId,
+          versionNumber: _versionNumber,
+          changedFields: _changedFields,
+          changeMessage: _changeMessage,
+          createdAt: _createdAt,
+          ...latestConfig
+        } = latestVersion;
+        const newConfig = { ...latestConfig, ...configFields };
+        const changedFields = configFieldNames.filter(
+          (field) => field in configFields && JSON.stringify(configFields[field]) !== JSON.stringify(latestConfig[field])
+        );
+        if (changedFields.length > 0) {
+          const newVersionId = crypto.randomUUID();
+          await this.createVersion({
+            id: newVersionId,
+            skillId: id,
+            versionNumber: latestVersion.versionNumber + 1,
+            ...newConfig,
+            changedFields,
+            changeMessage: `Updated ${changedFields.join(", ")}`
+          });
         }
-        const updatedSnapshot = { ...snapshot, ...opts };
-        await tx.execute({
-          sql: `UPDATE ${TABLE_WORKFLOW_SNAPSHOT} SET snapshot = jsonb(?) WHERE workflow_name = ? AND run_id = ?`,
-          args: [JSON.stringify(updatedSnapshot), workflowName, runId]
+      }
+      const updated = await this.getById(id);
+      if (!updated) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "UPDATE_SKILL", "NOT_FOUND_AFTER_UPDATE"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.SYSTEM,
+          text: `Skill ${id} not found after update`,
+          details: { id }
         });
-        await tx.commit();
-        return updatedSnapshot;
-      } catch (error) {
-        if (!tx.closed) {
-          await tx.rollback();
-        }
-        throw error;
       }
-    }, "updateWorkflowState");
-  }
-  async persistWorkflowSnapshot({
-    workflowName,
-    runId,
-    resourceId,
-    snapshot,
-    createdAt,
-    updatedAt
-  }) {
-    const now = /* @__PURE__ */ new Date();
-    const data = {
-      workflow_name: workflowName,
-      run_id: runId,
-      resourceId,
-      snapshot,
-      createdAt: createdAt ?? now,
-      updatedAt: updatedAt ?? now
-    };
-    this.logger.debug("Persisting workflow snapshot", { workflowName, runId, data });
-    await this.#db.insert({
-      tableName: TABLE_WORKFLOW_SNAPSHOT,
-      record: data
-    });
+      return updated;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "UPDATE_SKILL", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
   }
-  async loadWorkflowSnapshot({
-    workflowName,
-    runId
-  }) {
-    this.logger.debug("Loading workflow snapshot", { workflowName, runId });
-    const d = await this.#db.select({
-      tableName: TABLE_WORKFLOW_SNAPSHOT,
-      keys: { workflow_name: workflowName, run_id: runId }
+  async delete(id) {
+    try {
+      await this.deleteVersionsByParentId(id);
+      await this.#client.execute({
+        sql: `DELETE FROM "${TABLE_SKILLS}" WHERE "id" = ?`,
+        args: [id]
+      });
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "DELETE_SKILL", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async list(args) {
+    try {
+      const { page = 0, perPage: perPageInput, orderBy, authorId } = args || {};
+      const { field, direction } = this.parseOrderBy(orderBy);
+      const conditions = [];
+      const queryParams = [];
+      if (authorId !== void 0) {
+        conditions.push("authorId = ?");
+        queryParams.push(authorId);
+      }
+      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
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
+      if (total === 0) {
+        return {
+          skills: [],
+          total: 0,
+          page,
+          perPage: perPageInput ?? 100,
+          hasMore: false
+        };
+      }
+      const perPage = normalizePerPage(perPageInput, 100);
+      const { offset: start, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
+      const limitValue = perPageInput === false ? total : perPage;
+      const end = perPageInput === false ? total : start + perPage;
+      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]
+      });
+      const skills = result.rows?.map((row) => this.#parseSkillRow(row)) ?? [];
+      return {
+        skills,
+        total,
+        page,
+        perPage: perPageForResponse,
+        hasMore: end < total
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "LIST_SKILLS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  // ==========================================================================
+  // Skill Version Methods
+  // ==========================================================================
+  async createVersion(input) {
+    try {
+      const now = /* @__PURE__ */ new Date();
+      await this.#client.execute({
+        sql: `INSERT INTO "${TABLE_SKILL_VERSIONS}" (
+          id, "skillId", "versionNumber",
+          name, description, instructions, license, compatibility,
+          source, "references", scripts, assets, metadata, tree,
+          "changedFields", "changeMessage", "createdAt"
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        args: [
+          input.id,
+          input.skillId,
+          input.versionNumber,
+          input.name,
+          input.description ?? null,
+          input.instructions ?? null,
+          input.license ?? null,
+          input.compatibility ? JSON.stringify(input.compatibility) : null,
+          input.source ? JSON.stringify(input.source) : null,
+          input.references ? JSON.stringify(input.references) : null,
+          input.scripts ? JSON.stringify(input.scripts) : null,
+          input.assets ? JSON.stringify(input.assets) : null,
+          input.metadata ? JSON.stringify(input.metadata) : null,
+          input.tree ? JSON.stringify(input.tree) : null,
+          input.changedFields ? JSON.stringify(input.changedFields) : null,
+          input.changeMessage ?? null,
+          now.toISOString()
+        ]
+      });
+      return {
+        ...input,
+        createdAt: now
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "CREATE_SKILL_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getVersion(id) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_SKILL_VERSIONS)} FROM "${TABLE_SKILL_VERSIONS}" WHERE id = ?`,
+        args: [id]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseVersionRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_SKILL_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getVersionByNumber(skillId, versionNumber) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_SKILL_VERSIONS)} FROM "${TABLE_SKILL_VERSIONS}" WHERE skillId = ? AND versionNumber = ?`,
+        args: [skillId, versionNumber]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseVersionRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_SKILL_VERSION_BY_NUMBER", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async getLatestVersion(skillId) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_SKILL_VERSIONS)} FROM "${TABLE_SKILL_VERSIONS}" WHERE skillId = ? ORDER BY versionNumber DESC LIMIT 1`,
+        args: [skillId]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseVersionRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_LATEST_SKILL_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async listVersions(input) {
+    try {
+      const { skillId, page = 0, perPage: perPageInput, orderBy } = input;
+      const { field, direction } = this.parseVersionOrderBy(orderBy);
+      const countResult = await this.#client.execute({
+        sql: `SELECT COUNT(*) as count FROM "${TABLE_SKILL_VERSIONS}" WHERE skillId = ?`,
+        args: [skillId]
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
+      if (total === 0) {
+        return {
+          versions: [],
+          total: 0,
+          page,
+          perPage: perPageInput ?? 20,
+          hasMore: false
+        };
+      }
+      const perPage = normalizePerPage(perPageInput, 20);
+      const { offset: start, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
+      const limitValue = perPageInput === false ? total : perPage;
+      const end = perPageInput === false ? total : start + perPage;
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_SKILL_VERSIONS)} FROM "${TABLE_SKILL_VERSIONS}" WHERE skillId = ? ORDER BY ${field} ${direction} LIMIT ? OFFSET ?`,
+        args: [skillId, limitValue, start]
+      });
+      const versions = result.rows?.map((row) => this.#parseVersionRow(row)) ?? [];
+      return {
+        versions,
+        total,
+        page,
+        perPage: perPageForResponse,
+        hasMore: end < total
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "LIST_SKILL_VERSIONS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async deleteVersion(id) {
+    try {
+      await this.#client.execute({
+        sql: `DELETE FROM "${TABLE_SKILL_VERSIONS}" WHERE "id" = ?`,
+        args: [id]
+      });
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "DELETE_SKILL_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async deleteVersionsByParentId(entityId) {
+    try {
+      await this.#client.execute({
+        sql: `DELETE FROM "${TABLE_SKILL_VERSIONS}" WHERE "skillId" = ?`,
+        args: [entityId]
+      });
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "DELETE_SKILL_VERSIONS_BY_SKILL", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async countVersions(skillId) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT COUNT(*) as count FROM "${TABLE_SKILL_VERSIONS}" WHERE skillId = ?`,
+        args: [skillId]
+      });
+      return Number(result.rows?.[0]?.count ?? 0);
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "COUNT_SKILL_VERSIONS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  // ==========================================================================
+  // Private Helpers
+  // ==========================================================================
+  #parseSkillRow(row) {
+    return {
+      id: row.id,
+      status: row.status ?? "draft",
+      activeVersionId: row.activeVersionId ?? void 0,
+      authorId: row.authorId ?? void 0,
+      createdAt: new Date(row.createdAt),
+      updatedAt: new Date(row.updatedAt)
+    };
+  }
+  #parseVersionRow(row) {
+    const safeParseJSON = (val) => {
+      if (val === null || val === void 0) return void 0;
+      if (typeof val === "string") {
+        try {
+          return JSON.parse(val);
+        } catch {
+          return val;
+        }
+      }
+      return val;
+    };
+    return {
+      id: row.id,
+      skillId: row.skillId,
+      versionNumber: Number(row.versionNumber),
+      name: row.name,
+      description: row.description ?? void 0,
+      instructions: row.instructions ?? void 0,
+      license: row.license ?? void 0,
+      compatibility: safeParseJSON(row.compatibility),
+      source: safeParseJSON(row.source),
+      references: safeParseJSON(row.references),
+      scripts: safeParseJSON(row.scripts),
+      assets: safeParseJSON(row.assets),
+      metadata: safeParseJSON(row.metadata),
+      tree: safeParseJSON(row.tree),
+      changedFields: safeParseJSON(row.changedFields),
+      changeMessage: row.changeMessage ?? void 0,
+      createdAt: new Date(row.createdAt)
+    };
+  }
+};
+var WorkflowsLibSQL = class extends WorkflowsStorage {
+  #db;
+  #client;
+  executeWithRetry;
+  constructor(config) {
+    super();
+    const client = resolveClient(config);
+    const maxRetries = config.maxRetries ?? 5;
+    const initialBackoffMs = config.initialBackoffMs ?? 500;
+    this.#client = client;
+    this.#db = new LibSQLDB({ client, maxRetries, initialBackoffMs });
+    this.executeWithRetry = createExecuteWriteOperationWithRetry({
+      logger: this.logger,
+      maxRetries,
+      initialBackoffMs
+    });
+    this.setupPragmaSettings().catch(
+      (err) => this.logger.warn("LibSQL Workflows: Failed to setup PRAGMA settings.", err)
+    );
+  }
+  parseWorkflowRun(row) {
+    let parsedSnapshot = row.snapshot;
+    if (typeof parsedSnapshot === "string") {
+      try {
+        parsedSnapshot = JSON.parse(row.snapshot);
+      } catch (e) {
+        this.logger.warn(`Failed to parse snapshot for workflow ${row.workflow_name}: ${e}`);
+      }
+    }
+    return {
+      workflowName: row.workflow_name,
+      runId: row.run_id,
+      snapshot: parsedSnapshot,
+      resourceId: row.resourceId,
+      createdAt: new Date(row.createdAt),
+      updatedAt: new Date(row.updatedAt)
+    };
+  }
+  async init() {
+    const schema = TABLE_SCHEMAS[TABLE_WORKFLOW_SNAPSHOT];
+    await this.#db.createTable({ tableName: TABLE_WORKFLOW_SNAPSHOT, schema });
+    await this.#db.alterTable({
+      tableName: TABLE_WORKFLOW_SNAPSHOT,
+      schema,
+      ifNotExists: ["resourceId"]
+    });
+  }
+  async dangerouslyClearAll() {
+    await this.#db.deleteData({ tableName: TABLE_WORKFLOW_SNAPSHOT });
+  }
+  async setupPragmaSettings() {
+    try {
+      await this.#client.execute("PRAGMA busy_timeout = 10000;");
+      this.logger.debug("LibSQL Workflows: PRAGMA busy_timeout=10000 set.");
+      try {
+        await this.#client.execute("PRAGMA journal_mode = WAL;");
+        this.logger.debug("LibSQL Workflows: PRAGMA journal_mode=WAL set.");
+      } catch {
+        this.logger.debug("LibSQL Workflows: WAL mode not supported, using default journal mode.");
+      }
+      try {
+        await this.#client.execute("PRAGMA synchronous = NORMAL;");
+        this.logger.debug("LibSQL Workflows: PRAGMA synchronous=NORMAL set.");
+      } catch {
+        this.logger.debug("LibSQL Workflows: Failed to set synchronous mode.");
+      }
+    } catch (err) {
+      this.logger.warn("LibSQL Workflows: Failed to set PRAGMA settings.", err);
+    }
+  }
+  async updateWorkflowResults({
+    workflowName,
+    runId,
+    stepId,
+    result,
+    requestContext
+  }) {
+    return this.executeWithRetry(async () => {
+      const tx = await this.#client.transaction("write");
+      try {
+        const existingSnapshotResult = await tx.execute({
+          sql: `SELECT json(snapshot) as snapshot FROM ${TABLE_WORKFLOW_SNAPSHOT} WHERE workflow_name = ? AND run_id = ?`,
+          args: [workflowName, runId]
+        });
+        let snapshot;
+        if (!existingSnapshotResult.rows?.[0]) {
+          snapshot = {
+            context: {},
+            activePaths: [],
+            timestamp: Date.now(),
+            suspendedPaths: {},
+            activeStepsPath: {},
+            resumeLabels: {},
+            serializedStepGraph: [],
+            status: "pending",
+            value: {},
+            waitingPaths: {},
+            runId,
+            requestContext: {}
+          };
+        } else {
+          const existingSnapshot = existingSnapshotResult.rows[0].snapshot;
+          snapshot = typeof existingSnapshot === "string" ? JSON.parse(existingSnapshot) : existingSnapshot;
+        }
+        snapshot.context[stepId] = result;
+        snapshot.requestContext = { ...snapshot.requestContext, ...requestContext };
+        const now = (/* @__PURE__ */ new Date()).toISOString();
+        await tx.execute({
+          sql: `INSERT INTO ${TABLE_WORKFLOW_SNAPSHOT} (workflow_name, run_id, snapshot, createdAt, updatedAt)
+                VALUES (?, ?, jsonb(?), ?, ?)
+                ON CONFLICT(workflow_name, run_id)
+                DO UPDATE SET snapshot = excluded.snapshot, updatedAt = excluded.updatedAt`,
+          args: [workflowName, runId, JSON.stringify(snapshot), now, now]
+        });
+        await tx.commit();
+        return snapshot.context;
+      } catch (error) {
+        if (!tx.closed) {
+          await tx.rollback();
+        }
+        throw error;
+      }
+    }, "updateWorkflowResults");
+  }
+  async updateWorkflowState({
+    workflowName,
+    runId,
+    opts
+  }) {
+    return this.executeWithRetry(async () => {
+      const tx = await this.#client.transaction("write");
+      try {
+        const existingSnapshotResult = await tx.execute({
+          sql: `SELECT json(snapshot) as snapshot FROM ${TABLE_WORKFLOW_SNAPSHOT} WHERE workflow_name = ? AND run_id = ?`,
+          args: [workflowName, runId]
+        });
+        if (!existingSnapshotResult.rows?.[0]) {
+          await tx.rollback();
+          return void 0;
+        }
+        const existingSnapshot = existingSnapshotResult.rows[0].snapshot;
+        const snapshot = typeof existingSnapshot === "string" ? JSON.parse(existingSnapshot) : existingSnapshot;
+        if (!snapshot || !snapshot?.context) {
+          await tx.rollback();
+          throw new Error(`Snapshot not found for runId ${runId}`);
+        }
+        const updatedSnapshot = { ...snapshot, ...opts };
+        await tx.execute({
+          sql: `UPDATE ${TABLE_WORKFLOW_SNAPSHOT} SET snapshot = jsonb(?) WHERE workflow_name = ? AND run_id = ?`,
+          args: [JSON.stringify(updatedSnapshot), workflowName, runId]
+        });
+        await tx.commit();
+        return updatedSnapshot;
+      } catch (error) {
+        if (!tx.closed) {
+          await tx.rollback();
+        }
+        throw error;
+      }
+    }, "updateWorkflowState");
+  }
+  async persistWorkflowSnapshot({
+    workflowName,
+    runId,
+    resourceId,
+    snapshot,
+    createdAt,
+    updatedAt
+  }) {
+    const now = /* @__PURE__ */ new Date();
+    const data = {
+      workflow_name: workflowName,
+      run_id: runId,
+      resourceId,
+      snapshot,
+      createdAt: createdAt ?? now,
+      updatedAt: updatedAt ?? now
+    };
+    this.logger.debug("Persisting workflow snapshot", { workflowName, runId, data });
+    await this.#db.insert({
+      tableName: TABLE_WORKFLOW_SNAPSHOT,
+      record: data
+    });
+  }
+  async loadWorkflowSnapshot({
+    workflowName,
+    runId
+  }) {
+    this.logger.debug("Loading workflow snapshot", { workflowName, runId });
+    const d = await this.#db.select({
+      tableName: TABLE_WORKFLOW_SNAPSHOT,
+      keys: { workflow_name: workflowName, run_id: runId }
+    });
+    return d ? d.snapshot : null;
+  }
+  async getWorkflowRunById({
+    runId,
+    workflowName
+  }) {
+    const conditions = [];
+    const args = [];
+    if (runId) {
+      conditions.push("run_id = ?");
+      args.push(runId);
+    }
+    if (workflowName) {
+      conditions.push("workflow_name = ?");
+      args.push(workflowName);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT workflow_name, run_id, resourceId, json(snapshot) as snapshot, createdAt, updatedAt FROM ${TABLE_WORKFLOW_SNAPSHOT} ${whereClause} ORDER BY createdAt DESC LIMIT 1`,
+        args
+      });
+      if (!result.rows?.[0]) {
+        return null;
+      }
+      return this.parseWorkflowRun(result.rows[0]);
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_WORKFLOW_RUN_BY_ID", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async deleteWorkflowRunById({ runId, workflowName }) {
+    return this.executeWithRetry(async () => {
+      try {
+        await this.#client.execute({
+          sql: `DELETE FROM ${TABLE_WORKFLOW_SNAPSHOT} WHERE workflow_name = ? AND run_id = ?`,
+          args: [workflowName, runId]
+        });
+      } catch (error) {
+        throw new MastraError(
+          {
+            id: createStorageErrorId("LIBSQL", "DELETE_WORKFLOW_RUN_BY_ID", "FAILED"),
+            domain: ErrorDomain.STORAGE,
+            category: ErrorCategory.THIRD_PARTY,
+            details: { runId, workflowName }
+          },
+          error
+        );
+      }
+    }, "deleteWorkflowRunById");
+  }
+  async listWorkflowRuns({
+    workflowName,
+    fromDate,
+    toDate,
+    page,
+    perPage,
+    resourceId,
+    status
+  } = {}) {
+    try {
+      const conditions = [];
+      const args = [];
+      if (workflowName) {
+        conditions.push("workflow_name = ?");
+        args.push(workflowName);
+      }
+      if (status) {
+        conditions.push("json_extract(snapshot, '$.status') = ?");
+        args.push(status);
+      }
+      if (fromDate) {
+        conditions.push("createdAt >= ?");
+        args.push(fromDate.toISOString());
+      }
+      if (toDate) {
+        conditions.push("createdAt <= ?");
+        args.push(toDate.toISOString());
+      }
+      if (resourceId) {
+        const hasResourceId = await this.#db.hasColumn(TABLE_WORKFLOW_SNAPSHOT, "resourceId");
+        if (hasResourceId) {
+          conditions.push("resourceId = ?");
+          args.push(resourceId);
+        } else {
+          this.logger.warn(`[${TABLE_WORKFLOW_SNAPSHOT}] resourceId column not found. Skipping resourceId filter.`);
+        }
+      }
+      const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+      let total = 0;
+      const usePagination = typeof perPage === "number" && typeof page === "number";
+      if (usePagination) {
+        const countResult = await this.#client.execute({
+          sql: `SELECT COUNT(*) as count FROM ${TABLE_WORKFLOW_SNAPSHOT} ${whereClause}`,
+          args
+        });
+        total = Number(countResult.rows?.[0]?.count ?? 0);
+      }
+      const normalizedPerPage = usePagination ? normalizePerPage(perPage, Number.MAX_SAFE_INTEGER) : 0;
+      const offset = usePagination ? page * normalizedPerPage : 0;
+      const result = await this.#client.execute({
+        sql: `SELECT workflow_name, run_id, resourceId, json(snapshot) as snapshot, createdAt, updatedAt FROM ${TABLE_WORKFLOW_SNAPSHOT} ${whereClause} ORDER BY createdAt DESC${usePagination ? ` LIMIT ? OFFSET ?` : ""}`,
+        args: usePagination ? [...args, normalizedPerPage, offset] : args
+      });
+      const runs = (result.rows || []).map((row) => this.parseWorkflowRun(row));
+      return { runs, total: total || runs.length };
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "LIST_WORKFLOW_RUNS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+};
+var SNAPSHOT_FIELDS2 = [
+  "name",
+  "description",
+  "filesystem",
+  "sandbox",
+  "mounts",
+  "search",
+  "skills",
+  "tools",
+  "autoSync",
+  "operationTimeout"
+];
+var WorkspacesLibSQL = class extends WorkspacesStorage {
+  #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_WORKSPACES, schema: WORKSPACES_SCHEMA });
+    await this.#db.createTable({
+      tableName: TABLE_WORKSPACE_VERSIONS,
+      schema: WORKSPACE_VERSIONS_SCHEMA
     });
-    return d ? d.snapshot : null;
+    await this.#client.execute(
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_workspace_versions_workspace_version ON "${TABLE_WORKSPACE_VERSIONS}" ("workspaceId", "versionNumber")`
+    );
+  }
+  async dangerouslyClearAll() {
+    await this.#db.deleteData({ tableName: TABLE_WORKSPACES });
+    await this.#db.deleteData({ tableName: TABLE_WORKSPACE_VERSIONS });
+  }
+  // ==========================================================================
+  // Workspace CRUD
+  // ==========================================================================
+  async getById(id) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_WORKSPACES)} FROM "${TABLE_WORKSPACES}" WHERE id = ?`,
+        args: [id]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseWorkspaceRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_WORKSPACE", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async create(input) {
+    const { workspace } = input;
+    try {
+      const now = /* @__PURE__ */ new Date();
+      await this.#db.insert({
+        tableName: TABLE_WORKSPACES,
+        record: {
+          id: workspace.id,
+          status: "draft",
+          activeVersionId: null,
+          authorId: workspace.authorId ?? null,
+          metadata: workspace.metadata ?? null,
+          createdAt: now.toISOString(),
+          updatedAt: now.toISOString()
+        }
+      });
+      const { id: _id, authorId: _authorId, metadata: _metadata, ...snapshotConfig } = workspace;
+      const versionId = crypto.randomUUID();
+      try {
+        await this.createVersion({
+          id: versionId,
+          workspaceId: workspace.id,
+          versionNumber: 1,
+          ...snapshotConfig,
+          changedFields: Object.keys(snapshotConfig),
+          changeMessage: "Initial version"
+        });
+      } catch (versionError) {
+        await this.#db.delete({ tableName: TABLE_WORKSPACES, keys: { id: workspace.id } });
+        throw versionError;
+      }
+      return {
+        id: workspace.id,
+        status: "draft",
+        activeVersionId: void 0,
+        authorId: workspace.authorId,
+        metadata: workspace.metadata,
+        createdAt: now,
+        updatedAt: now
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "CREATE_WORKSPACE", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async update(input) {
+    const { id, ...updates } = input;
+    try {
+      const existing = await this.getById(id);
+      if (!existing) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "UPDATE_WORKSPACE", "NOT_FOUND"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.USER,
+          text: `Workspace ${id} not found`,
+          details: { workspaceId: id }
+        });
+      }
+      const { authorId, activeVersionId, metadata, status, ...configFields } = updates;
+      const configFieldNames = SNAPSHOT_FIELDS2;
+      const hasConfigUpdate = configFieldNames.some((field) => field in configFields);
+      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 = "published";
+        }
+      }
+      if (status !== void 0) updateData.status = status;
+      if (metadata !== void 0) {
+        updateData.metadata = { ...existing.metadata || {}, ...metadata };
+      }
+      await this.#db.update({
+        tableName: TABLE_WORKSPACES,
+        keys: { id },
+        data: updateData
+      });
+      if (hasConfigUpdate) {
+        const latestVersion = await this.getLatestVersion(id);
+        if (!latestVersion) {
+          throw new Error(`No versions found for workspace ${id}`);
+        }
+        const {
+          id: _versionId,
+          workspaceId: _workspaceId,
+          versionNumber: _versionNumber,
+          changedFields: _changedFields,
+          changeMessage: _changeMessage,
+          createdAt: _createdAt,
+          ...latestConfig
+        } = latestVersion;
+        const newConfig = { ...latestConfig, ...configFields };
+        const changedFields = configFieldNames.filter(
+          (field) => field in configFields && JSON.stringify(configFields[field]) !== JSON.stringify(latestConfig[field])
+        );
+        if (changedFields.length > 0) {
+          const newVersionId = crypto.randomUUID();
+          await this.createVersion({
+            id: newVersionId,
+            workspaceId: id,
+            versionNumber: latestVersion.versionNumber + 1,
+            ...newConfig,
+            changedFields,
+            changeMessage: `Updated ${changedFields.join(", ")}`
+          });
+        }
+      }
+      const updated = await this.getById(id);
+      if (!updated) {
+        throw new MastraError({
+          id: createStorageErrorId("LIBSQL", "UPDATE_WORKSPACE", "NOT_FOUND_AFTER_UPDATE"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.SYSTEM,
+          text: `Workspace ${id} not found after update`,
+          details: { id }
+        });
+      }
+      return updated;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "UPDATE_WORKSPACE", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async delete(id) {
+    try {
+      await this.deleteVersionsByParentId(id);
+      await this.#client.execute({
+        sql: `DELETE FROM "${TABLE_WORKSPACES}" WHERE "id" = ?`,
+        args: [id]
+      });
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "DELETE_WORKSPACE", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async list(args) {
+    try {
+      const { page = 0, perPage: perPageInput, orderBy, authorId, metadata } = args || {};
+      const { field, direction } = this.parseOrderBy(orderBy);
+      const conditions = [];
+      const queryParams = [];
+      if (authorId !== void 0) {
+        conditions.push("authorId = ?");
+        queryParams.push(authorId);
+      }
+      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)) {
+            throw new MastraError({
+              id: createStorageErrorId("LIBSQL", "LIST_WORKSPACES", "INVALID_METADATA_KEY"),
+              domain: ErrorDomain.STORAGE,
+              category: ErrorCategory.USER,
+              text: `Invalid metadata key: ${key}. Keys must be alphanumeric with underscores.`,
+              details: { key }
+            });
+          }
+          conditions.push(`json_extract(metadata, '$.${key}') = ?`);
+          queryParams.push(typeof value === "string" ? value : JSON.stringify(value));
+        }
+      }
+      const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+      const countResult = await this.#client.execute({
+        sql: `SELECT COUNT(*) as count FROM "${TABLE_WORKSPACES}" ${whereClause}`,
+        args: queryParams
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
+      if (total === 0) {
+        return {
+          workspaces: [],
+          total: 0,
+          page,
+          perPage: perPageInput ?? 100,
+          hasMore: false
+        };
+      }
+      const perPage = normalizePerPage(perPageInput, 100);
+      const { offset: start, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
+      const limitValue = perPageInput === false ? total : perPage;
+      const end = perPageInput === false ? total : start + perPage;
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_WORKSPACES)} FROM "${TABLE_WORKSPACES}" ${whereClause} ORDER BY ${field} ${direction} LIMIT ? OFFSET ?`,
+        args: [...queryParams, limitValue, start]
+      });
+      const workspaces = result.rows?.map((row) => this.#parseWorkspaceRow(row)) ?? [];
+      return {
+        workspaces,
+        total,
+        page,
+        perPage: perPageForResponse,
+        hasMore: end < total
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "LIST_WORKSPACES", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  // ==========================================================================
+  // Workspace Version Methods
+  // ==========================================================================
+  async createVersion(input) {
+    try {
+      const now = /* @__PURE__ */ new Date();
+      await this.#client.execute({
+        sql: `INSERT INTO "${TABLE_WORKSPACE_VERSIONS}" (
+  id, "workspaceId", "versionNumber",
+  name, description, filesystem, sandbox, mounts, search, skills, tools,
+  "autoSync", "operationTimeout",
+  "changedFields", "changeMessage", "createdAt"
+) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        args: [
+          input.id,
+          input.workspaceId,
+          input.versionNumber,
+          input.name,
+          input.description ?? null,
+          input.filesystem ? JSON.stringify(input.filesystem) : null,
+          input.sandbox ? JSON.stringify(input.sandbox) : null,
+          input.mounts ? JSON.stringify(input.mounts) : null,
+          input.search ? JSON.stringify(input.search) : null,
+          input.skills ? JSON.stringify(input.skills) : null,
+          input.tools ? JSON.stringify(input.tools) : null,
+          input.autoSync ? 1 : 0,
+          input.operationTimeout ?? null,
+          input.changedFields ? JSON.stringify(input.changedFields) : null,
+          input.changeMessage ?? null,
+          now.toISOString()
+        ]
+      });
+      return {
+        ...input,
+        createdAt: now
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "CREATE_WORKSPACE_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
   }
-  async getWorkflowRunById({
-    runId,
-    workflowName
-  }) {
-    const conditions = [];
-    const args = [];
-    if (runId) {
-      conditions.push("run_id = ?");
-      args.push(runId);
+  async getVersion(id) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_WORKSPACE_VERSIONS)} FROM "${TABLE_WORKSPACE_VERSIONS}" WHERE id = ?`,
+        args: [id]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseVersionRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_WORKSPACE_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
     }
-    if (workflowName) {
-      conditions.push("workflow_name = ?");
-      args.push(workflowName);
+  }
+  async getVersionByNumber(workspaceId, versionNumber) {
+    try {
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_WORKSPACE_VERSIONS)} FROM "${TABLE_WORKSPACE_VERSIONS}" WHERE "workspaceId" = ? AND "versionNumber" = ?`,
+        args: [workspaceId, versionNumber]
+      });
+      const row = result.rows?.[0];
+      return row ? this.#parseVersionRow(row) : null;
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "GET_WORKSPACE_VERSION_BY_NUMBER", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
     }
-    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  }
+  async getLatestVersion(workspaceId) {
     try {
       const result = await this.#client.execute({
-        sql: `SELECT workflow_name, run_id, resourceId, json(snapshot) as snapshot, createdAt, updatedAt FROM ${TABLE_WORKFLOW_SNAPSHOT} ${whereClause} ORDER BY createdAt DESC LIMIT 1`,
-        args
+        sql: `SELECT ${buildSelectColumns(TABLE_WORKSPACE_VERSIONS)} FROM "${TABLE_WORKSPACE_VERSIONS}" WHERE "workspaceId" = ? ORDER BY "versionNumber" DESC LIMIT 1`,
+        args: [workspaceId]
       });
-      if (!result.rows?.[0]) {
-        return null;
-      }
-      return this.parseWorkflowRun(result.rows[0]);
+      const row = result.rows?.[0];
+      return row ? this.#parseVersionRow(row) : null;
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
-          id: createStorageErrorId("LIBSQL", "GET_WORKFLOW_RUN_BY_ID", "FAILED"),
+          id: createStorageErrorId("LIBSQL", "GET_LATEST_WORKSPACE_VERSION", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -8490,85 +9449,100 @@ var WorkflowsLibSQL = class extends WorkflowsStorage {
       );
     }
   }
-  async deleteWorkflowRunById({ runId, workflowName }) {
-    return this.executeWithRetry(async () => {
-      try {
-        await this.#client.execute({
-          sql: `DELETE FROM ${TABLE_WORKFLOW_SNAPSHOT} WHERE workflow_name = ? AND run_id = ?`,
-          args: [workflowName, runId]
-        });
-      } catch (error) {
-        throw new MastraError(
-          {
-            id: createStorageErrorId("LIBSQL", "DELETE_WORKFLOW_RUN_BY_ID", "FAILED"),
-            domain: ErrorDomain.STORAGE,
-            category: ErrorCategory.THIRD_PARTY,
-            details: { runId, workflowName }
-          },
-          error
-        );
+  async listVersions(input) {
+    try {
+      const { workspaceId, page = 0, perPage: perPageInput, orderBy } = input;
+      const { field, direction } = this.parseVersionOrderBy(orderBy);
+      const countResult = await this.#client.execute({
+        sql: `SELECT COUNT(*) as count FROM "${TABLE_WORKSPACE_VERSIONS}" WHERE "workspaceId" = ?`,
+        args: [workspaceId]
+      });
+      const total = Number(countResult.rows?.[0]?.count ?? 0);
+      if (total === 0) {
+        return {
+          versions: [],
+          total: 0,
+          page,
+          perPage: perPageInput ?? 20,
+          hasMore: false
+        };
       }
-    }, "deleteWorkflowRunById");
+      const perPage = normalizePerPage(perPageInput, 20);
+      const { offset: start, perPage: perPageForResponse } = calculatePagination(page, perPageInput, perPage);
+      const limitValue = perPageInput === false ? total : perPage;
+      const end = perPageInput === false ? total : start + perPage;
+      const result = await this.#client.execute({
+        sql: `SELECT ${buildSelectColumns(TABLE_WORKSPACE_VERSIONS)} FROM "${TABLE_WORKSPACE_VERSIONS}" WHERE "workspaceId" = ? ORDER BY ${field} ${direction} LIMIT ? OFFSET ?`,
+        args: [workspaceId, limitValue, start]
+      });
+      const versions = result.rows?.map((row) => this.#parseVersionRow(row)) ?? [];
+      return {
+        versions,
+        total,
+        page,
+        perPage: perPageForResponse,
+        hasMore: end < total
+      };
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "LIST_WORKSPACE_VERSIONS", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
   }
-  async listWorkflowRuns({
-    workflowName,
-    fromDate,
-    toDate,
-    page,
-    perPage,
-    resourceId,
-    status
-  } = {}) {
+  async deleteVersion(id) {
+    try {
+      await this.#client.execute({
+        sql: `DELETE FROM "${TABLE_WORKSPACE_VERSIONS}" WHERE "id" = ?`,
+        args: [id]
+      });
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "DELETE_WORKSPACE_VERSION", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async deleteVersionsByParentId(entityId) {
+    try {
+      await this.#client.execute({
+        sql: `DELETE FROM "${TABLE_WORKSPACE_VERSIONS}" WHERE "workspaceId" = ?`,
+        args: [entityId]
+      });
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: createStorageErrorId("LIBSQL", "DELETE_WORKSPACE_VERSIONS_BY_WORKSPACE", "FAILED"),
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  async countVersions(workspaceId) {
     try {
-      const conditions = [];
-      const args = [];
-      if (workflowName) {
-        conditions.push("workflow_name = ?");
-        args.push(workflowName);
-      }
-      if (status) {
-        conditions.push("json_extract(snapshot, '$.status') = ?");
-        args.push(status);
-      }
-      if (fromDate) {
-        conditions.push("createdAt >= ?");
-        args.push(fromDate.toISOString());
-      }
-      if (toDate) {
-        conditions.push("createdAt <= ?");
-        args.push(toDate.toISOString());
-      }
-      if (resourceId) {
-        const hasResourceId = await this.#db.hasColumn(TABLE_WORKFLOW_SNAPSHOT, "resourceId");
-        if (hasResourceId) {
-          conditions.push("resourceId = ?");
-          args.push(resourceId);
-        } else {
-          this.logger.warn(`[${TABLE_WORKFLOW_SNAPSHOT}] resourceId column not found. Skipping resourceId filter.`);
-        }
-      }
-      const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-      let total = 0;
-      const usePagination = typeof perPage === "number" && typeof page === "number";
-      if (usePagination) {
-        const countResult = await this.#client.execute({
-          sql: `SELECT COUNT(*) as count FROM ${TABLE_WORKFLOW_SNAPSHOT} ${whereClause}`,
-          args
-        });
-        total = Number(countResult.rows?.[0]?.count ?? 0);
-      }
-      const normalizedPerPage = usePagination ? normalizePerPage(perPage, Number.MAX_SAFE_INTEGER) : 0;
-      const offset = usePagination ? page * normalizedPerPage : 0;
       const result = await this.#client.execute({
-        sql: `SELECT workflow_name, run_id, resourceId, json(snapshot) as snapshot, createdAt, updatedAt FROM ${TABLE_WORKFLOW_SNAPSHOT} ${whereClause} ORDER BY createdAt DESC${usePagination ? ` LIMIT ? OFFSET ?` : ""}`,
-        args: usePagination ? [...args, normalizedPerPage, offset] : args
+        sql: `SELECT COUNT(*) as count FROM "${TABLE_WORKSPACE_VERSIONS}" WHERE "workspaceId" = ?`,
+        args: [workspaceId]
       });
-      const runs = (result.rows || []).map((row) => this.parseWorkflowRun(row));
-      return { runs, total: total || runs.length };
+      return Number(result.rows?.[0]?.count ?? 0);
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
-          id: createStorageErrorId("LIBSQL", "LIST_WORKFLOW_RUNS", "FAILED"),
+          id: createStorageErrorId("LIBSQL", "COUNT_WORKSPACE_VERSIONS", "FAILED"),
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY
         },
@@ -8576,6 +9550,62 @@ var WorkflowsLibSQL = class extends WorkflowsStorage {
       );
     }
   }
+  // ==========================================================================
+  // Private Helpers
+  // ==========================================================================
+  #parseWorkspaceRow(row) {
+    const safeParseJSON = (val) => {
+      if (val === null || val === void 0) return void 0;
+      if (typeof val === "string") {
+        try {
+          return JSON.parse(val);
+        } catch {
+          return val;
+        }
+      }
+      return val;
+    };
+    return {
+      id: row.id,
+      status: row.status ?? "draft",
+      activeVersionId: row.activeVersionId ?? void 0,
+      authorId: row.authorId ?? void 0,
+      metadata: safeParseJSON(row.metadata),
+      createdAt: new Date(row.createdAt),
+      updatedAt: new Date(row.updatedAt)
+    };
+  }
+  #parseVersionRow(row) {
+    const safeParseJSON = (val) => {
+      if (val === null || val === void 0) return void 0;
+      if (typeof val === "string") {
+        try {
+          return JSON.parse(val);
+        } catch {
+          return val;
+        }
+      }
+      return val;
+    };
+    return {
+      id: row.id,
+      workspaceId: row.workspaceId,
+      versionNumber: Number(row.versionNumber),
+      name: row.name,
+      description: row.description ?? void 0,
+      filesystem: safeParseJSON(row.filesystem),
+      sandbox: safeParseJSON(row.sandbox),
+      mounts: safeParseJSON(row.mounts),
+      search: safeParseJSON(row.search),
+      skills: safeParseJSON(row.skills),
+      tools: safeParseJSON(row.tools),
+      autoSync: Boolean(row.autoSync),
+      operationTimeout: row.operationTimeout != null ? Number(row.operationTimeout) : void 0,
+      changedFields: safeParseJSON(row.changedFields),
+      changeMessage: row.changeMessage ?? void 0,
+      createdAt: new Date(row.createdAt)
+    };
+  }
 };
 
 // src/storage/index.ts
@@ -8621,6 +9651,9 @@ var LibSQLStore = class extends MastraCompositeStore {
     const promptBlocks = new PromptBlocksLibSQL(domainConfig);
     const scorerDefinitions = new ScorerDefinitionsLibSQL(domainConfig);
     const mcpClients = new MCPClientsLibSQL(domainConfig);
+    const workspaces = new WorkspacesLibSQL(domainConfig);
+    const skills = new SkillsLibSQL(domainConfig);
+    const blobs = new BlobsLibSQL(domainConfig);
     this.stores = {
       scores,
       workflows,
@@ -8631,7 +9664,10 @@ var LibSQLStore = class extends MastraCompositeStore {
       experiments,
       promptBlocks,
       scorerDefinitions,
-      mcpClients
+      mcpClients,
+      workspaces,
+      skills,
+      blobs
     };
   }
 };
@@ -8735,6 +9771,6 @@ Example Complex Query:
   ]
 }`;
 
-export { AgentsLibSQL, DatasetsLibSQL, LibSQLStore as DefaultStorage, ExperimentsLibSQL, LIBSQL_PROMPT, LibSQLStore, LibSQLVector, MCPClientsLibSQL, MemoryLibSQL, ObservabilityLibSQL, PromptBlocksLibSQL, ScorerDefinitionsLibSQL, ScoresLibSQL, WorkflowsLibSQL };
+export { AgentsLibSQL, BlobsLibSQL, DatasetsLibSQL, LibSQLStore as DefaultStorage, ExperimentsLibSQL, LIBSQL_PROMPT, LibSQLStore, LibSQLVector, MCPClientsLibSQL, MemoryLibSQL, ObservabilityLibSQL, PromptBlocksLibSQL, ScorerDefinitionsLibSQL, ScoresLibSQL, SkillsLibSQL, WorkflowsLibSQL, WorkspacesLibSQL };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map