@mastra/core 1.4.0 → 1.5.0-alpha.1

package/dist/storage/index.js

@@ -1,4 +1,4 @@
-export { AgentsStorage, DatasetsInMemory, DatasetsStorage, ExperimentsInMemory, ExperimentsStorage, InMemoryAgentsStorage, InMemoryDB, InMemoryMCPClientsStorage, InMemoryMemory, InMemoryPromptBlocksStorage, InMemoryScorerDefinitionsStorage, InMemoryStore, MCPClientsStorage, MastraCompositeStore, MastraStorage, MemoryStorage, MockStore, ObservabilityInMemory, ObservabilityStorage, PromptBlocksStorage, ScorerDefinitionsStorage, ScoresInMemory, ScoresStorage, StorageDomain, StoreOperations, StoreOperationsInMemory, VersionedStorageDomain, WorkflowsInMemory, WorkflowsStorage, calculatePagination, createStorageErrorId, createStoreErrorId, createVectorErrorId, ensureDate, filterByDateRange, getDefaultValue, getSqlType, jsonValueEquals, normalizePerPage, safelyParseJSON, serializeDate, transformRow, transformScoreRow } from '../chunk-7NKUSQEV.js';
-export { AGENTS_SCHEMA, AGENT_VERSIONS_SCHEMA, DATASETS_SCHEMA, DATASET_ITEMS_SCHEMA, DATASET_VERSIONS_SCHEMA, EXPERIMENTS_SCHEMA, EXPERIMENT_RESULTS_SCHEMA, MCP_CLIENTS_SCHEMA, MCP_CLIENT_VERSIONS_SCHEMA, OBSERVATIONAL_MEMORY_SCHEMA, OBSERVATIONAL_MEMORY_TABLE_SCHEMA, OLD_SPAN_SCHEMA, PROMPT_BLOCKS_SCHEMA, PROMPT_BLOCK_VERSIONS_SCHEMA, SCORERS_SCHEMA, SCORER_DEFINITIONS_SCHEMA, SCORER_DEFINITION_VERSIONS_SCHEMA, SPAN_SCHEMA, TABLE_AGENTS, TABLE_AGENT_VERSIONS, TABLE_CONFIGS, TABLE_DATASETS, TABLE_DATASET_ITEMS, TABLE_DATASET_VERSIONS, TABLE_EXPERIMENTS, TABLE_EXPERIMENT_RESULTS, TABLE_MCP_CLIENTS, TABLE_MCP_CLIENT_VERSIONS, TABLE_MESSAGES, TABLE_OBSERVATIONAL_MEMORY, TABLE_PROMPT_BLOCKS, TABLE_PROMPT_BLOCK_VERSIONS, TABLE_RESOURCES, TABLE_SCHEMAS, TABLE_SCORERS, TABLE_SCORER_DEFINITIONS, TABLE_SCORER_DEFINITION_VERSIONS, TABLE_SPANS, TABLE_THREADS, TABLE_TRACES, TABLE_WORKFLOW_SNAPSHOT, TraceStatus, batchCreateSpansArgsSchema, batchDeleteTracesArgsSchema, batchUpdateSpansArgsSchema, buildStorageSchema, computeTraceStatus, createSpanArgsSchema, createSpanRecordSchema, createdAtField, dateRangeSchema, dbTimestamps, entityIdField, entityNameField, entityTypeField, environmentField, getRootSpanArgsSchema, getRootSpanResponseSchema, getSpanArgsSchema, getSpanResponseSchema, getTraceArgsSchema, getTraceResponseSchema, listScoresBySpanResponseSchema, listTracesArgsSchema, listTracesResponseSchema, organizationIdField, paginationArgsSchema, paginationInfoSchema, requestIdField, resourceIdField, runIdField, scoreTracesRequestSchema, scoreTracesResponseSchema, serviceNameField, sessionIdField, sortDirectionSchema, sourceField, spanIdField, spanIds, spanIdsSchema, spanRecordSchema, threadIdField, toTraceSpan, toTraceSpans, traceIdField, traceSpanSchema, tracesFilterSchema, tracesOrderByFieldSchema, tracesOrderBySchema, updateSpanArgsSchema, updateSpanRecordSchema, updatedAtField, userIdField } from '../chunk-PS5ONCXY.js';
+export { AgentsStorage, BlobStore, DatasetsInMemory, DatasetsStorage, ExperimentsInMemory, ExperimentsStorage, InMemoryAgentsStorage, InMemoryBlobStore, InMemoryDB, InMemoryMCPClientsStorage, InMemoryMemory, InMemoryPromptBlocksStorage, InMemoryScorerDefinitionsStorage, InMemorySkillsStorage, InMemoryStore, InMemoryWorkspacesStorage, MCPClientsStorage, MastraCompositeStore, MastraStorage, MemoryStorage, MockStore, ObservabilityInMemory, ObservabilityStorage, PromptBlocksStorage, ScorerDefinitionsStorage, ScoresInMemory, ScoresStorage, SkillsStorage, StorageDomain, StoreOperations, StoreOperationsInMemory, VersionedStorageDomain, WorkflowsInMemory, WorkflowsStorage, WorkspacesStorage, calculatePagination, createStorageErrorId, createStoreErrorId, createVectorErrorId, ensureDate, filterByDateRange, getDefaultValue, getSqlType, jsonValueEquals, normalizePerPage, safelyParseJSON, serializeDate, transformRow, transformScoreRow } from '../chunk-YIN5F7VO.js';
+export { AGENTS_SCHEMA, AGENT_VERSIONS_SCHEMA, DATASETS_SCHEMA, DATASET_ITEMS_SCHEMA, DATASET_VERSIONS_SCHEMA, EXPERIMENTS_SCHEMA, EXPERIMENT_RESULTS_SCHEMA, MCP_CLIENTS_SCHEMA, MCP_CLIENT_VERSIONS_SCHEMA, OBSERVATIONAL_MEMORY_SCHEMA, OBSERVATIONAL_MEMORY_TABLE_SCHEMA, OLD_SPAN_SCHEMA, PROMPT_BLOCKS_SCHEMA, PROMPT_BLOCK_VERSIONS_SCHEMA, SCORERS_SCHEMA, SCORER_DEFINITIONS_SCHEMA, SCORER_DEFINITION_VERSIONS_SCHEMA, SKILLS_SCHEMA, SKILL_BLOBS_SCHEMA, SKILL_VERSIONS_SCHEMA, SPAN_SCHEMA, TABLE_AGENTS, TABLE_AGENT_VERSIONS, TABLE_CONFIGS, TABLE_DATASETS, TABLE_DATASET_ITEMS, TABLE_DATASET_VERSIONS, TABLE_EXPERIMENTS, TABLE_EXPERIMENT_RESULTS, TABLE_MCP_CLIENTS, TABLE_MCP_CLIENT_VERSIONS, TABLE_MESSAGES, TABLE_OBSERVATIONAL_MEMORY, TABLE_PROMPT_BLOCKS, TABLE_PROMPT_BLOCK_VERSIONS, TABLE_RESOURCES, TABLE_SCHEMAS, TABLE_SCORERS, TABLE_SCORER_DEFINITIONS, TABLE_SCORER_DEFINITION_VERSIONS, TABLE_SKILLS, TABLE_SKILL_BLOBS, TABLE_SKILL_VERSIONS, TABLE_SPANS, TABLE_THREADS, TABLE_TRACES, TABLE_WORKFLOW_SNAPSHOT, TABLE_WORKSPACES, TABLE_WORKSPACE_VERSIONS, TraceStatus, WORKSPACES_SCHEMA, WORKSPACE_VERSIONS_SCHEMA, batchCreateSpansArgsSchema, batchDeleteTracesArgsSchema, batchUpdateSpansArgsSchema, buildStorageSchema, computeTraceStatus, createSpanArgsSchema, createSpanRecordSchema, createdAtField, dateRangeSchema, dbTimestamps, entityIdField, entityNameField, entityTypeField, environmentField, getRootSpanArgsSchema, getRootSpanResponseSchema, getSpanArgsSchema, getSpanResponseSchema, getTraceArgsSchema, getTraceResponseSchema, listScoresBySpanResponseSchema, listTracesArgsSchema, listTracesResponseSchema, organizationIdField, paginationArgsSchema, paginationInfoSchema, requestIdField, resourceIdField, runIdField, scoreTracesRequestSchema, scoreTracesResponseSchema, serviceNameField, sessionIdField, sortDirectionSchema, sourceField, spanIdField, spanIds, spanIdsSchema, spanRecordSchema, threadIdField, toTraceSpan, toTraceSpans, traceIdField, traceSpanSchema, tracesFilterSchema, tracesOrderByFieldSchema, tracesOrderBySchema, updateSpanArgsSchema, updateSpanRecordSchema, updatedAtField, userIdField } from '../chunk-UZFGMMKU.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/storage/mock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/storage/mock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAU7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAc,SAAQ,oBAAoB;;IACrD,MAAM,EAAE,cAAc,CAAC;gBASX,EAAE,EAAgB,EAAE,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO;IAqBtD;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,SAAS,sBAAgB,CAAC"}
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/storage/mock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAY7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAc,SAAQ,oBAAoB;;IACrD,MAAM,EAAE,cAAc,CAAC;gBASX,EAAE,EAAgB,EAAE,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO;IAuBtD;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,SAAS,sBAAgB,CAAC"}

package/dist/storage/types.d.ts

@@ -251,6 +251,8 @@ export type ThreadSortDirection = 'ASC' | 'DESC';
 export interface StorageToolConfig {
     /** Custom description override for this tool in this agent context */
     description?: string;
+    /** Conditional rules for when this tool should be available */
+    rules?: RuleGroup;
 }
 /**
  * Per-MCP-client tool configuration stored in agent snapshots.
@@ -265,8 +267,12 @@ export interface StorageMCPClientToolsConfig {
  * Scorer reference with optional sampling configuration
  */
 export interface StorageScorerConfig {
+    /** Custom description override for this scorer in this agent context */
+    description?: string;
     /** Sampling configuration for this scorer */
     sampling?: ScoringSamplingConfig;
+    /** Conditional rules for when this scorer should be active */
+    rules?: RuleGroup;
 }
 /**
  * Model configuration stored in agent snapshots.
@@ -334,10 +340,10 @@ export interface StorageAgentSnapshotType {
     tools?: StorageConditionalField<Record<string, StorageToolConfig>>;
     /** Default options for generate/stream calls — static or conditional on request context */
     defaultOptions?: StorageConditionalField<StorageDefaultOptions>;
-    /** Array of workflow keys to resolve from Mastra's workflow registry — static or conditional on request context */
-    workflows?: StorageConditionalField<string[]>;
-    /** Array of agent keys to resolve from Mastra's agent registry — static or conditional on request context */
-    agents?: StorageConditionalField<string[]>;
+    /** Workflow keys with optional per-workflow config — static or conditional on request context */
+    workflows?: StorageConditionalField<Record<string, StorageToolConfig>>;
+    /** Agent keys with optional per-agent config — static or conditional on request context */
+    agents?: StorageConditionalField<Record<string, StorageToolConfig>>;
     /**
      * Map of tool provider IDs to their tool configurations.
      * Keys are provider IDs (e.g., "composio"), values configure which tools from that provider to include.
@@ -354,6 +360,12 @@ export interface StorageAgentSnapshotType {
     scorers?: StorageConditionalField<Record<string, StorageScorerConfig>>;
     /** Map of stored MCP client IDs to their tool configurations — static or conditional on request context */
     mcpClients?: StorageConditionalField<Record<string, StorageMCPClientToolsConfig>>;
+    /** Workspace reference — ID of a stored workspace or inline config — static or conditional on request context */
+    workspace?: StorageConditionalField<StorageWorkspaceRef>;
+    /** Skill entity IDs with optional per-skill overrides — static or conditional on request context */
+    skills?: StorageConditionalField<Record<string, StorageSkillConfig>>;
+    /** Skill format for system message injection (default: 'xml') */
+    skillsFormat?: 'xml' | 'json' | 'markdown';
     /** JSON Schema for validating request context values. Stored as JSON Schema since Zod is not serializable. */
     requestContextSchema?: Record<string, unknown>;
 }
@@ -379,7 +391,10 @@ export interface StorageAgentType {
  * Resolved agent type that combines the thin agent record with version snapshot config.
  * Returned by getAgentByIdResolved and listAgentsResolved.
  */
-export type StorageResolvedAgentType = StorageAgentType & StorageAgentSnapshotType;
+export type StorageResolvedAgentType = StorageAgentType & StorageAgentSnapshotType & {
+    /** The version ID that was resolved (populated by resolveEntity) */
+    resolvedVersionId?: string;
+};
 /**
  * Input for creating a new agent. Flat union of thin record fields
  * and initial configuration (used to create version 1).
@@ -434,6 +449,11 @@ export type StorageListAgentsInput = {
      * All specified key-value pairs must match (AND logic).
      */
     metadata?: Record<string, unknown>;
+    /**
+     * Filter agents by status.
+     * Defaults to 'published' if not specified.
+     */
+    status?: 'draft' | 'published' | 'archived';
 };
 export type StorageListAgentsOutput = PaginationInfo & {
     agents: StorageAgentType[];
@@ -515,7 +535,9 @@ export interface StoragePromptBlockSnapshotType {
     rules?: RuleGroup;
 }
 /** Resolved prompt block: thin record merged with active version snapshot */
-export type StorageResolvedPromptBlockType = StoragePromptBlockType & StoragePromptBlockSnapshotType;
+export type StorageResolvedPromptBlockType = StoragePromptBlockType & StoragePromptBlockSnapshotType & {
+    resolvedVersionId?: string;
+};
 /** Input for creating a new prompt block */
 export type StorageCreatePromptBlockInput = {
     /** Unique identifier for the prompt block */
@@ -558,6 +580,11 @@ export type StorageListPromptBlocksInput = {
      * All specified key-value pairs must match (AND logic).
      */
     metadata?: Record<string, unknown>;
+    /**
+     * Filter prompt blocks by status.
+     * Defaults to 'published' if not specified.
+     */
+    status?: 'draft' | 'published' | 'archived';
 };
 /** Paginated list output for thin prompt block records */
 export type StorageListPromptBlocksOutput = PaginationInfo & {
@@ -622,7 +649,10 @@ export interface StorageScorerDefinitionType {
  * Resolved stored scorer type that combines the thin record with version snapshot config.
  * Returned by getScorerDefinitionByIdResolved and listScorerDefinitionsResolved.
  */
-export type StorageResolvedScorerDefinitionType = StorageScorerDefinitionType & StorageScorerDefinitionSnapshotType;
+export type StorageResolvedScorerDefinitionType = StorageScorerDefinitionType & StorageScorerDefinitionSnapshotType & {
+    /** The version ID that was resolved (populated by resolveEntity) */
+    resolvedVersionId?: string;
+};
 /**
  * Input for creating a new stored scorer. Flat union of thin record fields
  * and initial configuration (used to create version 1).
@@ -671,6 +701,11 @@ export type StorageListScorerDefinitionsInput = {
      * All specified key-value pairs must match (AND logic).
      */
     metadata?: Record<string, unknown>;
+    /**
+     * Filter scorers by status.
+     * Defaults to 'published' if not specified.
+     */
+    status?: 'draft' | 'published' | 'archived';
 };
 /** Paginated list output for thin stored scorer records */
 export type StorageListScorerDefinitionsOutput = PaginationInfo & {
@@ -1085,7 +1120,9 @@ export interface StorageMCPClientType {
  * Resolved stored MCP client type that combines the thin record with version snapshot config.
  * Returned by getMCPClientByIdResolved and listMCPClientsResolved.
  */
-export type StorageResolvedMCPClientType = StorageMCPClientType & StorageMCPClientSnapshotType;
+export type StorageResolvedMCPClientType = StorageMCPClientType & StorageMCPClientSnapshotType & {
+    resolvedVersionId?: string;
+};
 /**
  * Input for creating a new stored MCP client. Flat union of thin record fields
  * and initial configuration (used to create version 1).
@@ -1134,6 +1171,11 @@ export type StorageListMCPClientsInput = {
      * All specified key-value pairs must match (AND logic).
      */
     metadata?: Record<string, unknown>;
+    /**
+     * Filter MCP clients by status.
+     * Defaults to 'published' if not specified.
+     */
+    status?: 'draft' | 'published' | 'archived';
 };
 /** Paginated list output for thin stored MCP client records */
 export type StorageListMCPClientsOutput = PaginationInfo & {
@@ -1143,6 +1185,374 @@ export type StorageListMCPClientsOutput = PaginationInfo & {
 export type StorageListMCPClientsResolvedOutput = PaginationInfo & {
     mcpClients: StorageResolvedMCPClientType[];
 };
+/**
+ * Serializable filesystem configuration for storage.
+ * References a provider type string that the editor resolves at hydration time.
+ */
+export interface StorageFilesystemConfig {
+    /** Provider type identifier (e.g., 's3', 'gcs', 'local') — resolved by the editor's filesystem registry */
+    provider: string;
+    /** Provider-specific configuration (bucket, basePath, etc.) */
+    config: Record<string, unknown>;
+    /** Whether the filesystem is read-only */
+    readOnly?: boolean;
+}
+/**
+ * Serializable sandbox configuration for storage.
+ * References a provider type string that the editor resolves at hydration time.
+ */
+export interface StorageSandboxConfig {
+    /** Provider type identifier (e.g., 'e2b') — resolved by the editor's sandbox registry */
+    provider: string;
+    /** Provider-specific configuration */
+    config: Record<string, unknown>;
+}
+/**
+ * Serializable search configuration for storage.
+ * References vector store and embedder by provider/name rather than runtime instances.
+ */
+export interface StorageSearchConfig {
+    /** Vector store provider identifier (e.g., 'pg', 'pinecone') */
+    vectorProvider?: string;
+    /** Vector store provider-specific configuration */
+    vectorConfig?: Record<string, unknown>;
+    /** Embedder provider identifier (e.g., 'openai', 'fastembed') */
+    embedderProvider?: string;
+    /** Embedder model name */
+    embedderModel?: string;
+    /** Embedder provider-specific configuration */
+    embedderConfig?: Record<string, unknown>;
+    /** BM25 keyword search config — true for defaults, or object for custom params */
+    bm25?: boolean | {
+        k1?: number;
+        b?: number;
+    };
+    /** Custom index name for the vector store */
+    searchIndexName?: string;
+    /** Paths to auto-index on init */
+    autoIndexPaths?: string[];
+}
+/**
+ * Serializable per-tool configuration for workspace tools.
+ */
+export interface StorageWorkspaceToolConfig {
+    /** Whether the tool is enabled (default: true) */
+    enabled?: boolean;
+    /** Whether the tool requires user approval before execution (default: false) */
+    requireApproval?: boolean;
+    /** For write tools: require reading a file before writing to it */
+    requireReadBeforeWrite?: boolean;
+}
+/**
+ * Serializable workspace tools configuration for storage.
+ */
+export interface StorageWorkspaceToolsConfig {
+    /** Default: whether all tools are enabled (default: true) */
+    enabled?: boolean;
+    /** Default: whether all tools require user approval (default: false) */
+    requireApproval?: boolean;
+    /** Per-tool overrides, keyed by workspace tool name */
+    tools?: Record<string, StorageWorkspaceToolConfig>;
+}
+/**
+ * Workspace version snapshot type containing ALL workspace configuration fields.
+ * These fields live exclusively in version snapshot rows, not on the workspace record.
+ */
+export interface StorageWorkspaceSnapshotType {
+    /** Display name of the workspace */
+    name: string;
+    /** Purpose description */
+    description?: string;
+    /** Primary filesystem configuration */
+    filesystem?: StorageFilesystemConfig;
+    /** Sandbox configuration */
+    sandbox?: StorageSandboxConfig;
+    /** Mounted filesystems keyed by mount path */
+    mounts?: Record<string, StorageFilesystemConfig>;
+    /** Search configuration (vector, embedder, BM25) */
+    search?: StorageSearchConfig;
+    /** Skill entity IDs assigned to this workspace */
+    skills?: string[];
+    /** Workspace tool configuration */
+    tools?: StorageWorkspaceToolsConfig;
+    /** Auto-sync between fs and sandbox (default: false) */
+    autoSync?: boolean;
+    /** Timeout for individual operations in milliseconds */
+    operationTimeout?: number;
+}
+/**
+ * Thin workspace record type containing only metadata fields.
+ * All configuration lives in version snapshots (StorageWorkspaceSnapshotType).
+ */
+export interface StorageWorkspaceType {
+    /** Unique, immutable identifier */
+    id: string;
+    /** Workspace status: 'draft' on creation, 'published' when a version is activated */
+    status: 'draft' | 'published' | 'archived';
+    /** FK to workspace_versions.id - the currently active version */
+    activeVersionId?: string;
+    /** Author identifier for multi-tenant filtering */
+    authorId?: string;
+    /** Additional metadata for the workspace */
+    metadata?: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Resolved workspace type that combines the thin record with version snapshot config.
+ * Returned by getWorkspaceByIdResolved and listWorkspacesResolved.
+ */
+export type StorageResolvedWorkspaceType = StorageWorkspaceType & StorageWorkspaceSnapshotType & {
+    resolvedVersionId?: string;
+};
+/**
+ * Input for creating a new workspace. Flat union of thin record fields
+ * and initial configuration (used to create version 1).
+ */
+export type StorageCreateWorkspaceInput = {
+    /** Unique identifier for the workspace */
+    id: string;
+    /** Author identifier for multi-tenant filtering */
+    authorId?: string;
+    /** Additional metadata for the workspace */
+    metadata?: Record<string, unknown>;
+} & StorageWorkspaceSnapshotType;
+/**
+ * Input for updating a workspace. Includes metadata-level fields and optional config fields.
+ * The handler layer separates these into record updates vs new-version creation.
+ */
+export type StorageUpdateWorkspaceInput = {
+    id: string;
+    /** Author identifier for multi-tenant filtering */
+    authorId?: string;
+    /** Additional metadata for the workspace */
+    metadata?: Record<string, unknown>;
+    /** FK to workspace_versions.id - the currently active version */
+    activeVersionId?: string;
+    /** Workspace status */
+    status?: 'draft' | 'published' | 'archived';
+} & Partial<StorageWorkspaceSnapshotType>;
+export type StorageListWorkspacesInput = {
+    /**
+     * Number of items per page, or `false` to fetch all records without pagination limit.
+     * Defaults to 100 if not specified.
+     */
+    perPage?: number | false;
+    /**
+     * Zero-indexed page number for pagination.
+     * Defaults to 0 if not specified.
+     */
+    page?: number;
+    orderBy?: StorageOrderBy;
+    /**
+     * Filter workspaces by author identifier.
+     */
+    authorId?: string;
+    /**
+     * Filter workspaces by metadata key-value pairs.
+     * All specified key-value pairs must match (AND logic).
+     */
+    metadata?: Record<string, unknown>;
+};
+/** Paginated list output for thin workspace records */
+export type StorageListWorkspacesOutput = PaginationInfo & {
+    workspaces: StorageWorkspaceType[];
+};
+/** Paginated list output for resolved workspaces */
+export type StorageListWorkspacesResolvedOutput = PaginationInfo & {
+    workspaces: StorageResolvedWorkspaceType[];
+};
+/**
+ * Serializable content source for skill storage.
+ * Mirrors the runtime ContentSource but stored as plain JSON.
+ */
+export type StorageContentSource = {
+    type: 'external';
+    packagePath: string;
+} | {
+    type: 'local';
+    projectPath: string;
+} | {
+    type: 'managed';
+    mastraPath: string;
+};
+/**
+ * Skill version snapshot type containing ALL skill definition fields.
+ * These fields live exclusively in version snapshot rows, not on the skill record.
+ */
+export interface StorageSkillSnapshotType {
+    /** Skill name (1-64 chars, lowercase, hyphens only) */
+    name: string;
+    /** Description of what the skill does and when to use it */
+    description: string;
+    /** Markdown instructions from SKILL.md body */
+    instructions: string;
+    /** Optional license identifier */
+    license?: string;
+    /** Optional compatibility requirements */
+    compatibility?: unknown;
+    /** Source of the skill */
+    source?: StorageContentSource;
+    /** List of reference file paths */
+    references?: string[];
+    /** List of script file paths */
+    scripts?: string[];
+    /** List of asset file paths */
+    assets?: string[];
+    /** Optional arbitrary metadata */
+    metadata?: Record<string, unknown>;
+    /** Content-addressable file tree manifest for this skill version */
+    tree?: SkillVersionTree;
+}
+/**
+ * Thin skill record type containing only metadata fields.
+ * All definition content lives in version snapshots (StorageSkillSnapshotType).
+ */
+export interface StorageSkillType {
+    /** Unique, immutable identifier */
+    id: string;
+    /** Skill status: 'draft' on creation, 'published' when a version is activated */
+    status: 'draft' | 'published' | 'archived';
+    /** FK to skill_versions.id - the currently active version */
+    activeVersionId?: string;
+    /** Author identifier for multi-tenant filtering */
+    authorId?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Resolved skill type that combines the thin record with version snapshot content.
+ * Returned by getSkillByIdResolved and listSkillsResolved.
+ */
+export type StorageResolvedSkillType = StorageSkillType & StorageSkillSnapshotType & {
+    resolvedVersionId?: string;
+};
+/**
+ * Input for creating a new skill. Flat union of thin record fields
+ * and initial content (used to create version 1).
+ */
+export type StorageCreateSkillInput = {
+    /** Unique identifier for the skill */
+    id: string;
+    /** Author identifier for multi-tenant filtering */
+    authorId?: string;
+} & StorageSkillSnapshotType;
+/**
+ * Input for updating a skill. Includes metadata-level fields and optional content fields.
+ * The handler layer separates these into record updates vs new-version creation.
+ */
+export type StorageUpdateSkillInput = {
+    id: string;
+    /** Author identifier for multi-tenant filtering */
+    authorId?: string;
+    /** FK to skill_versions.id - the currently active version */
+    activeVersionId?: string;
+    /** Skill status */
+    status?: 'draft' | 'published' | 'archived';
+} & Partial<StorageSkillSnapshotType>;
+export type StorageListSkillsInput = {
+    /**
+     * Number of items per page, or `false` to fetch all records without pagination limit.
+     * Defaults to 100 if not specified.
+     */
+    perPage?: number | false;
+    /**
+     * Zero-indexed page number for pagination.
+     * Defaults to 0 if not specified.
+     */
+    page?: number;
+    orderBy?: StorageOrderBy;
+    /**
+     * Filter skills by author identifier.
+     */
+    authorId?: string;
+    /**
+     * Filter skills by metadata key-value pairs.
+     * All specified key-value pairs must match (AND logic).
+     */
+    metadata?: Record<string, unknown>;
+};
+/** Paginated list output for thin skill records */
+export type StorageListSkillsOutput = PaginationInfo & {
+    skills: StorageSkillType[];
+};
+/** Paginated list output for resolved skills */
+export type StorageListSkillsResolvedOutput = PaginationInfo & {
+    skills: StorageResolvedSkillType[];
+};
+/**
+ * Per-skill configuration stored in agent snapshots.
+ * Allows overriding skill description and instructions for a specific agent context.
+ */
+export interface StorageSkillConfig {
+    /** Custom description override for this skill in this agent context */
+    description?: string;
+    /** Custom instructions override for this skill in this agent context */
+    instructions?: string;
+    /** Pin to a specific version ID. Takes precedence over strategy. */
+    pin?: string;
+    /** Resolution strategy: 'latest' = latest published version, 'live' = read from filesystem */
+    strategy?: 'latest' | 'live';
+}
+/**
+ * A single entry in a skill version's file tree manifest.
+ * Maps a file path to its content-addressable blob hash.
+ */
+export interface SkillVersionTreeEntry {
+    /** SHA-256 hash of the file content (content-addressable key) */
+    blobHash: string;
+    /** File size in bytes */
+    size: number;
+    /** Optional MIME type */
+    mimeType?: string;
+    /**
+     * Content encoding used in the blob store.
+     * - 'utf-8' (default): content stored as UTF-8 text
+     * - 'base64': content stored as base64-encoded string (for binary files like images)
+     */
+    encoding?: 'utf-8' | 'base64';
+}
+/**
+ * Complete file tree manifest for a skill version.
+ * Maps relative file paths to their blob entries.
+ * This is stored as JSONB on the skill version row.
+ *
+ * Example:
+ * {
+ *   "SKILL.md": { blobHash: "abc123...", size: 1024, mimeType: "text/markdown" },
+ *   "references/api.md": { blobHash: "def456...", size: 512, mimeType: "text/markdown" },
+ *   "scripts/setup.sh": { blobHash: "ghi789...", size: 256, mimeType: "text/x-shellscript" }
+ * }
+ */
+export interface SkillVersionTree {
+    entries: Record<string, SkillVersionTreeEntry>;
+}
+/**
+ * A stored blob entry in the content-addressable blob store.
+ */
+export interface StorageBlobEntry {
+    /** SHA-256 hash of the content (primary key) */
+    hash: string;
+    /** The file content (text) */
+    content: string;
+    /** File size in bytes */
+    size: number;
+    /** Optional MIME type */
+    mimeType?: string;
+    /** When the blob was first stored */
+    createdAt: Date;
+}
+/**
+ * Workspace reference configuration stored in agent snapshots.
+ * Can reference a stored workspace by ID or provide inline workspace config.
+ */
+export type StorageWorkspaceRef = {
+    type: 'id';
+    workspaceId: string;
+} | {
+    type: 'inline';
+    config: StorageWorkspaceSnapshotType;
+};
 export interface UpdateWorkflowStateOptions {
     status: WorkflowRunStatus;
     result?: StepResult<any, any, any, any>;
@@ -1204,16 +1614,16 @@ export interface CreateDatasetInput {
     name: string;
     description?: string;
     metadata?: Record<string, unknown>;
-    inputSchema?: Record<string, unknown>;
-    groundTruthSchema?: Record<string, unknown>;
+    inputSchema?: Record<string, unknown> | null;
+    groundTruthSchema?: Record<string, unknown> | null;
 }
 export interface UpdateDatasetInput {
     id: string;
     name?: string;
     description?: string;
     metadata?: Record<string, unknown>;
-    inputSchema?: Record<string, unknown>;
-    groundTruthSchema?: Record<string, unknown>;
+    inputSchema?: Record<string, unknown> | null;
+    groundTruthSchema?: Record<string, unknown> | null;
 }
 export interface AddDatasetItemInput {
     datasetId: string;