@mastra/spanner 0.0.0 → 1.0.0

package/dist/storage/domains/mcp-servers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/mcp-servers/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,iBAAiB,EAMlB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,gBAAgB,EACjB,MAAM,0CAA0C,CAAC;AAElD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAIpD;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,iBAAiB;IACtD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAuB;IAEhD,MAAM,CAAC,QAAQ,CAAC,cAAc,gEAA2D;gBAE7E,MAAM,EAAE,mBAAmB;IAUvC,uFAAuF;IACjF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;;OAGG;YACW,kBAAkB;IAmBhC,yEAAyE;IACzE,0BAA0B,IAAI,kBAAkB,EAAE;IAuBlD,4EAA4E;IACtE,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3C,uFAAuF;IACjF,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C,uEAAuE;IACjE,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C,uEAAuE;IACvE,OAAO,CAAC,cAAc;IAatB,uEAAuE;IACvE,OAAO,CAAC,eAAe;IA0BvB,uEAAuE;IACjE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAuB/D,uFAAuF;IACjF,MAAM,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,2BAA2B,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAqF9F,gFAAgF;IAC1E,MAAM,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA+C/E,qFAAqF;IAC/E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCvC,gFAAgF;IAC1E,IAAI,CAAC,IAAI,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IA6FnF,sEAAsE;IAChE,aAAa,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwClF,8DAA8D;IACxD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAuB9D,oEAAoE;IAC9D,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA0BtG,8DAA8D;IACxD,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA0B7E,6DAA6D;IACvD,YAAY,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IA8D3F,0CAA0C;IACpC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB9C,mEAAmE;IAC7D,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/D,yEAAyE;IACnE,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAqB1D"}

package/dist/storage/domains/memory/index.d.ts

@@ -0,0 +1,101 @@
+import type { MastraMessageContentV2 } from '@mastra/core/agent';
+import type { MastraDBMessage, StorageThreadType } from '@mastra/core/memory';
+import { MemoryStorage } from '@mastra/core/storage';
+import type { StorageResourceType, StorageListMessagesInput, StorageListMessagesOutput, StorageListThreadsInput, StorageListThreadsOutput, CreateIndexOptions } from '@mastra/core/storage';
+import type { SpannerDomainConfig } from '../../db/index.js';
+/**
+ * Spanner-backed storage for memory primitives: threads, messages, and resources
+ * (the durable state surface used by `@mastra/memory`).
+ */
+export declare class MemorySpanner extends MemoryStorage {
+    private database;
+    private db;
+    private readonly skipDefaultIndexes?;
+    private readonly indexes?;
+    static readonly MANAGED_TABLES: readonly ["mastra_threads", "mastra_messages", "mastra_resources"];
+    constructor(config: SpannerDomainConfig);
+    /** Creates the threads/messages/resources tables and any indexes. */
+    init(): Promise<void>;
+    /** Returns the default index set this domain creates during `init()`. */
+    getDefaultIndexDefinitions(): CreateIndexOptions[];
+    /** Creates the default indexes; no-op when `skipDefaultIndexes` was set. */
+    createDefaultIndexes(): Promise<void>;
+    /** Creates custom indexes routed to this domain's tables; no-op when none supplied. */
+    createCustomIndexes(): Promise<void>;
+    /** Removes every row from threads/messages/resources tables. Intended for tests. */
+    dangerouslyClearAll(): Promise<void>;
+    /**
+     * Fetches a thread row by id, or `null` when absent.
+     *
+     * When `resourceId` is supplied (including the empty string) it scopes the
+     * lookup so callers can enforce multi-tenant isolation: a thread that
+     * exists under a different resourceId is reported as missing rather than
+     * leaking across tenants.
+     */
+    getThreadById({ threadId, resourceId, }: {
+        threadId: string;
+        resourceId?: string;
+    }): Promise<StorageThreadType | null>;
+    private formatThreadRow;
+    /** Paginated thread listing with optional resourceId/metadata/date-range filters. */
+    listThreads(args: StorageListThreadsInput): Promise<StorageListThreadsOutput>;
+    /** Upserts a thread row by id (`INSERT OR UPDATE` semantics). */
+    saveThread({ thread }: {
+        thread: StorageThreadType;
+    }): Promise<StorageThreadType>;
+    /** Updates a thread's title and merges the metadata payload. */
+    updateThread({ id, title, metadata, }: {
+        id: string;
+        title: string;
+        metadata: Record<string, unknown>;
+    }): Promise<StorageThreadType>;
+    /** Deletes a thread and all its messages atomically. */
+    deleteThread({ threadId }: {
+        threadId: string;
+    }): Promise<void>;
+    /** Parses raw message rows and converts them into the requested API format ('v1' or 'v2'). */
+    private parseAndFormatMessages;
+    /** Fetches a batch of messages by id; missing ids are silently dropped. */
+    listMessagesById({ messageIds }: {
+        messageIds: string[];
+    }): Promise<{
+        messages: MastraDBMessage[];
+    }>;
+    /** Resolves the `include` clause: pinned messages plus their before/after windows. */
+    private getIncludedMessages;
+    /** Paginated message listing for a thread, with optional pinned-include and date-range filters. */
+    listMessages(args: StorageListMessagesInput): Promise<StorageListMessagesOutput>;
+    /** Upserts a batch of messages and bumps every touched thread's `updatedAt` in a single transaction. */
+    saveMessages({ messages }: {
+        messages: MastraDBMessage[];
+    }): Promise<{
+        messages: MastraDBMessage[];
+    }>;
+    /** Merges partial updates onto existing messages and bumps affected thread `updatedAt`. */
+    updateMessages({ messages, }: {
+        messages: (Partial<Omit<MastraDBMessage, 'createdAt'>> & {
+            id: string;
+            content?: {
+                metadata?: MastraMessageContentV2['metadata'];
+                content?: MastraMessageContentV2['content'];
+            };
+        })[];
+    }): Promise<MastraDBMessage[]>;
+    /** Deletes a batch of messages and bumps the affected threads' `updatedAt`. */
+    deleteMessages(messageIds: string[]): Promise<void>;
+    /** Fetches a resource row by id, or `null` when absent. */
+    getResourceById({ resourceId }: {
+        resourceId: string;
+    }): Promise<StorageResourceType | null>;
+    /** Upserts a resource row by id (`INSERT OR UPDATE` semantics). */
+    saveResource({ resource }: {
+        resource: StorageResourceType;
+    }): Promise<StorageResourceType>;
+    /** Updates a resource's `workingMemory` and merges its `metadata`. */
+    updateResource({ resourceId, workingMemory, metadata, }: {
+        resourceId: string;
+        workingMemory?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<StorageResourceType>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/domains/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/index.ts"],"names":[],"mappings":"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"}

package/dist/storage/domains/observability/index.d.ts

@@ -0,0 +1,67 @@
+import { ObservabilityStorage } from '@mastra/core/storage';
+import type { BatchCreateMetricsArgs, BatchCreateSpansArgs, BatchDeleteTracesArgs, BatchUpdateSpansArgs, CreateIndexOptions, CreateSpanArgs, GetMetricAggregateArgs, GetMetricAggregateResponse, GetMetricBreakdownArgs, GetMetricBreakdownResponse, GetMetricLabelKeysArgs, GetMetricLabelKeysResponse, GetMetricLabelValuesArgs, GetMetricLabelValuesResponse, GetMetricNamesArgs, GetMetricNamesResponse, GetMetricPercentilesArgs, GetMetricPercentilesResponse, GetMetricTimeSeriesArgs, GetMetricTimeSeriesResponse, GetRootSpanArgs, GetRootSpanResponse, GetSpanArgs, GetSpanResponse, GetTraceArgs, GetTraceLightResponse, GetTraceResponse, ListMetricsArgs, ListMetricsResponse, ListTracesArgs, ListTracesResponse, TracingStorageStrategy, UpdateSpanArgs } from '@mastra/core/storage';
+import type { SpannerDomainConfig } from '../../db/index.js';
+/**
+ * Observability domain for Spanner. Stores AI tracing spans in `mastra_ai_spans`
+ * and supports the trace read/write surface that powers the Mastra observability
+ * UI: per-span CRUD, per-trace fetch, lightweight trace skeletons for the
+ * waterfall view, and root-span pagination with the listTraces filters.
+ */
+export declare class ObservabilitySpanner extends ObservabilityStorage {
+    private database;
+    private db;
+    private readonly skipDefaultIndexes?;
+    private readonly indexes?;
+    private readonly initMode;
+    /**
+     * Bounded-staleness window (in ms) applied to every metrics read path.
+     * Default 10000 (weak reads).
+     */
+    private readonly dashboardStalenessMs;
+    /**
+     * When true (the default), every metric method throws the base-class
+     * `*_NOT_IMPLEMENTED` error and the metrics table is not created during
+     * `init()`. See the option doc on `SpannerDomainDatabaseConfig` for the
+     * full rationale.
+     */
+    private readonly disableMetrics;
+    /** Tables managed by this domain */
+    static readonly MANAGED_TABLES: readonly ["mastra_ai_spans", "mastra_ai_metrics"];
+    constructor(config: SpannerDomainConfig);
+    /** Build the read-options object that every metrics read path threads through. */
+    private readOptions;
+    /**
+     * Throw the same shape of NOT_IMPLEMENTED error the base class would when
+     * a method isn't overridden
+     */
+    private metricsDisabledError;
+    init(): Promise<void>;
+    getDefaultIndexDefinitions(): CreateIndexOptions[];
+    createDefaultIndexes(): Promise<void>;
+    createCustomIndexes(): Promise<void>;
+    dangerouslyClearAll(): Promise<void>;
+    get tracingStrategy(): {
+        preferred: TracingStorageStrategy;
+        supported: TracingStorageStrategy[];
+    };
+    createSpan(args: CreateSpanArgs): Promise<void>;
+    batchCreateSpans(args: BatchCreateSpansArgs): Promise<void>;
+    updateSpan(args: UpdateSpanArgs): Promise<void>;
+    batchUpdateSpans(args: BatchUpdateSpansArgs): Promise<void>;
+    getSpan(args: GetSpanArgs): Promise<GetSpanResponse | null>;
+    getRootSpan(args: GetRootSpanArgs): Promise<GetRootSpanResponse | null>;
+    getTrace(args: GetTraceArgs): Promise<GetTraceResponse | null>;
+    getTraceLight(args: GetTraceArgs): Promise<GetTraceLightResponse | null>;
+    listTraces(args: ListTracesArgs): Promise<ListTracesResponse>;
+    batchDeleteTraces(args: BatchDeleteTracesArgs): Promise<void>;
+    batchCreateMetrics(args: BatchCreateMetricsArgs): Promise<void>;
+    listMetrics(args: ListMetricsArgs): Promise<ListMetricsResponse>;
+    getMetricAggregate(args: GetMetricAggregateArgs): Promise<GetMetricAggregateResponse>;
+    getMetricBreakdown(args: GetMetricBreakdownArgs): Promise<GetMetricBreakdownResponse>;
+    getMetricTimeSeries(args: GetMetricTimeSeriesArgs): Promise<GetMetricTimeSeriesResponse>;
+    getMetricPercentiles(args: GetMetricPercentilesArgs): Promise<GetMetricPercentilesResponse>;
+    getMetricNames(args: GetMetricNamesArgs): Promise<GetMetricNamesResponse>;
+    getMetricLabelKeys(args: GetMetricLabelKeysArgs): Promise<GetMetricLabelKeysResponse>;
+    getMetricLabelValues(args: GetMetricLabelValuesArgs): Promise<GetMetricLabelValuesResponse>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/domains/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/observability/index.ts"],"names":[],"mappings":"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"}

package/dist/storage/domains/observability/metrics.d.ts

@@ -0,0 +1,119 @@
+import type { Database } from '@google-cloud/spanner';
+import type { BatchCreateMetricsArgs, GetMetricAggregateArgs, GetMetricAggregateResponse, GetMetricBreakdownArgs, GetMetricBreakdownResponse, GetMetricLabelKeysArgs, GetMetricLabelKeysResponse, GetMetricLabelValuesArgs, GetMetricLabelValuesResponse, GetMetricNamesArgs, GetMetricNamesResponse, GetMetricPercentilesArgs, GetMetricPercentilesResponse, GetMetricTimeSeriesArgs, GetMetricTimeSeriesResponse, ListMetricsArgs, ListMetricsResponse } from '@mastra/core/storage';
+import type { SpannerInitMode } from '../../db/index.js';
+/** Physical table name. Not exposed by `@mastra/core/storage` (no TABLE_METRICS
+ *  constant exists), so the Spanner adapter owns the name itself. Follows the
+ *  same `mastra_ai_*` convention as `TABLE_SPANS = 'mastra_ai_spans'`. */
+export declare const TABLE_AI_METRICS = "mastra_ai_metrics";
+export type MetricIndexDef = {
+    name: string;
+    columns: string[];
+    /**
+     * Non-key columns copied into the secondary index so common aggregate reads
+     * can be index-only instead of joining back to the base metrics table.
+     */
+    storing?: string[];
+};
+/**
+ * Default secondary indexes. Every analytical query starts with a name filter
+ * and a timestamp range, so the leading composite index is `(name, timestamp DESC)`.
+ *
+ * Intentionally NOT here: a bare `(timestamp DESC)` index. A monotonically
+ * increasing leading column funnels every new row through a single Spanner
+ * split until the planner re-splits, capping per-region write throughput
+ * regardless of node count. The `(name, ...)` and `(provider, model, ...)`
+ * composites give the planner index access for the common queries while
+ * smearing writes across many splits via the leading low-cardinality column.
+ * Unfiltered "latest metrics" reads fall back to a full scan + sort, which
+ * is acceptable because they're bounded by `perPage` and rarely on the
+ * dashboard hot path.
+ */
+export declare function defaultMetricIndexDefs(): MetricIndexDef[];
+/**
+ * Create the metrics table + default indexes idempotently. Under
+ * `initMode: 'validate'` the function issues no DDL and instead verifies that
+ * the table and every default index already exist, throwing a typed user
+ * error otherwise. Mirrors the contract `SpannerDB.createTable` exposes for
+ * the core tables.
+ */
+export declare function ensureMetricsTable(database: Database, options: {
+    initMode: SpannerInitMode;
+    skipDefaultIndexes?: boolean;
+}): Promise<void>;
+/**
+ * Insert a batch of metric records as a single mutation.
+ *
+ * Uses the Spanner Mutations API (`tx.insert(table, rows)`) rather than DML
+ * because metrics are append-heavy: a single mutation commits the whole batch
+ * in one RPC, where the DML equivalent would round-trip per row. At dashboard
+ * scales this is several × the throughput, and it also avoids the per-row
+ * parameter-binding overhead.
+ *
+ * Encoding rules for mutations:
+ *   - JS `Date` instances are accepted directly for TIMESTAMP columns (the
+ *     client serializes via `.toJSON()`).
+ *   - Plain objects / arrays are accepted directly for JSON columns (the
+ *     client serializes with `JSON.stringify`); the server parses them
+ *     because the column schema is JSON.
+ *   - Whole-number JS numbers wrapped in `Spanner.float(n)` to force FLOAT64
+ *     encoding — without the wrapper the client serializes `100` as a string
+ *     and the server rejects it (same root cause as the DML path).
+ *   - `null` is passed through and respected per the column's nullability.
+ */
+export declare function batchCreateMetrics(database: Database, args: BatchCreateMetricsArgs): Promise<void>;
+/** Per-call read options accepted by every read function in this module. */
+export type MetricsReadOptions = {
+    /**
+     * Maximum acceptable staleness in milliseconds for the read. When set to a
+     * positive value, the query is issued as a single-use read-only transaction
+     * with `maxStaleness`, which lets Spanner serve it from any replica that
+     * already has data at least that fresh. The benefit is twofold:
+     *
+     *   1. Dashboard reads stop competing with leader-region writes for CPU.
+     *   2. The planner can route the query to the closest replica, often
+     *      shaving 10-50ms off the round-trip vs. a strong read.
+     *
+     * For metrics specifically, observability dashboards routinely tolerate a
+     * few seconds of staleness. `ObservabilitySpanner` defaults to 0 for
+     * backwards-compatible strong reads, and callers can opt into bounded
+     * staleness with `dashboardStalenessMs`. Note: maxStaleness is only valid
+     * for single-use read-only transactions, which is what `database.run` issues.
+     */
+    stalenessMs?: number;
+};
+/** Paginated listing with the metric-records filter surface. */
+export declare function listMetrics(database: Database, args: ListMetricsArgs, options?: MetricsReadOptions): Promise<ListMetricsResponse>;
+/** Single-value aggregate with optional period-over-period comparison. */
+export declare function getMetricAggregate(database: Database, args: GetMetricAggregateArgs, options?: MetricsReadOptions): Promise<GetMetricAggregateResponse>;
+/** Breakdown by one or more dimensions (columns or label keys). */
+export declare function getMetricBreakdown(database: Database, args: GetMetricBreakdownArgs, options?: MetricsReadOptions): Promise<GetMetricBreakdownResponse>;
+/** Bucketed time-series, optionally split into multiple series by groupBy. */
+export declare function getMetricTimeSeries(database: Database, args: GetMetricTimeSeriesArgs, options?: MetricsReadOptions): Promise<GetMetricTimeSeriesResponse>;
+/**
+ * Bucketed percentile series. Spanner GoogleSQL exposes `PERCENTILE_CONT`
+ * only as an analytic (window) function, which neither the local emulator
+ * nor older production releases support inside our query shape. Pulling raw
+ * values one-by-one to compute percentiles in JS would round-trip per row.
+ *
+ * Instead we use `ARRAY_AGG(value ORDER BY value) GROUP BY bucket` to ship
+ * one pre-sorted array per bucket, then interpolate every requested
+ * percentile in JS. That's:
+ *  - one SQL query for any number of percentiles (vs. one-per-p with a
+ *    window function), so listing p50/p90/p95/p99 is the same cost as one;
+ *  - portable across every Spanner version because ARRAY_AGG is a core
+ *    aggregate (not an analytic function);
+ *  - exact (linear-interpolation form, matching `PERCENTILE_CONT`'s
+ *    definition) rather than HyperLogLog-approximate.
+ *
+ * The trade-off is that each bucket's array materializes server-side; for
+ * pathological queries with millions of points per bucket the row could
+ * exceed Spanner's 4MB row limit. Typical dashboard percentile queries
+ * (single metric, recent window, modest cardinality) stay well under that.
+ */
+export declare function getMetricPercentiles(database: Database, args: GetMetricPercentilesArgs, options?: MetricsReadOptions): Promise<GetMetricPercentilesResponse>;
+export declare function getMetricNames(database: Database, args: GetMetricNamesArgs, options?: MetricsReadOptions): Promise<GetMetricNamesResponse>;
+export declare function getMetricLabelKeys(database: Database, args: GetMetricLabelKeysArgs, options?: MetricsReadOptions): Promise<GetMetricLabelKeysResponse>;
+export declare function getMetricLabelValues(database: Database, args: GetMetricLabelValuesArgs, options?: MetricsReadOptions): Promise<GetMetricLabelValuesResponse>;
+/** Wipes every metric row. Intended for `dangerouslyClearAll()`. */
+export declare function clearMetrics(database: Database): Promise<void>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/storage/domains/observability/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/observability/metrics.ts"],"names":[],"mappings":"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"}

package/dist/storage/domains/prompt-blocks/index.d.ts

@@ -0,0 +1,65 @@
+import { PromptBlocksStorage } from '@mastra/core/storage';
+import type { CreateIndexOptions, StoragePromptBlockType, StorageCreatePromptBlockInput, StorageListPromptBlocksInput, StorageListPromptBlocksOutput, StorageUpdatePromptBlockInput } from '@mastra/core/storage';
+import type { CreatePromptBlockVersionInput, ListPromptBlockVersionsInput, ListPromptBlockVersionsOutput, PromptBlockVersion } from '@mastra/core/storage/domains/prompt-blocks';
+import type { SpannerDomainConfig } from '../../db/index.js';
+/**
+ * Spanner-backed storage for prompt blocks and their immutable versions.
+ * Mirrors the thin-record + versions pattern used by agents/skills/scorer-definitions.
+ */
+export declare class PromptBlocksSpanner extends PromptBlocksStorage {
+    private database;
+    private db;
+    private readonly skipDefaultIndexes?;
+    private readonly indexes?;
+    static readonly MANAGED_TABLES: readonly ["mastra_prompt_blocks", "mastra_prompt_block_versions"];
+    constructor(config: SpannerDomainConfig);
+    /** Creates the prompt-block tables, indexes, and (when opted in) sweeps stale drafts. */
+    init(): Promise<void>;
+    /**
+     * Removes orphaned draft prompt-block records where the paired version row
+     * was never written. Skipped under `initMode: 'validate'` (no destructive
+     * DML in validate mode).
+     */
+    private cleanupStaleDrafts;
+    /** Returns the default index set this domain creates during `init()`. */
+    getDefaultIndexDefinitions(): CreateIndexOptions[];
+    /** Creates the default indexes; no-op when `skipDefaultIndexes` was set. */
+    createDefaultIndexes(): Promise<void>;
+    /** Creates custom indexes routed to this domain's tables; no-op when none supplied. */
+    createCustomIndexes(): Promise<void>;
+    /** Removes every row from this domain's tables. Intended for tests. */
+    dangerouslyClearAll(): Promise<void>;
+    /** Decodes a raw Spanner thin-row into the public prompt-block shape. */
+    private parsePromptBlockRow;
+    /** Decodes a raw Spanner version row into the public version shape. */
+    private parseVersionRow;
+    /** Fetches the thin prompt-block record by id, or `null` when absent. */
+    getById(id: string): Promise<StoragePromptBlockType | null>;
+    /** Atomically inserts a draft thin row + version 1 in a single Spanner transaction. */
+    create(input: {
+        promptBlock: StorageCreatePromptBlockInput;
+    }): Promise<StoragePromptBlockType>;
+    /** Updates thin-record fields (status, activeVersionId, authorId, metadata). */
+    update(input: StorageUpdatePromptBlockInput): Promise<StoragePromptBlockType>;
+    /** Removes a prompt block and all its versions atomically in a single transaction. */
+    delete(id: string): Promise<void>;
+    /** Paginated listing with optional status / authorId / metadata filters. */
+    list(args?: StorageListPromptBlocksInput): Promise<StorageListPromptBlocksOutput>;
+    /** Inserts a new immutable version row for an existing prompt block. */
+    createVersion(input: CreatePromptBlockVersionInput): Promise<PromptBlockVersion>;
+    /** Fetches a version row by its id, or `null` when absent. */
+    getVersion(id: string): Promise<PromptBlockVersion | null>;
+    /** Fetches a specific version by `(blockId, versionNumber)`. */
+    getVersionByNumber(blockId: string, versionNumber: number): Promise<PromptBlockVersion | null>;
+    /** Returns the highest-numbered version for a prompt block. */
+    getLatestVersion(blockId: string): Promise<PromptBlockVersion | null>;
+    /** Paginated listing of versions for a single prompt block. */
+    listVersions(input: ListPromptBlockVersionsInput): Promise<ListPromptBlockVersionsOutput>;
+    /** Deletes a single version row by id. */
+    deleteVersion(id: string): Promise<void>;
+    /** Deletes every version row belonging to the given prompt block. */
+    deleteVersionsByParentId(entityId: string): Promise<void>;
+    /** Returns the total number of version rows for the given prompt block. */
+    countVersions(blockId: string): Promise<number>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/domains/prompt-blocks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/prompt-blocks/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,mBAAmB,EAKpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,kBAAkB,EACnB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAIpD;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,mBAAmB;IAC1D,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAuB;IAEhD,MAAM,CAAC,QAAQ,CAAC,cAAc,oEAA+D;gBAEjF,MAAM,EAAE,mBAAmB;IAYvC,yFAAyF;IACnF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;;;OAIG;YACW,kBAAkB;IAmBhC,yEAAyE;IACzE,0BAA0B,IAAI,kBAAkB,EAAE;IAuBlD,4EAA4E;IACtE,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3C,uFAAuF;IACjF,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C,uEAAuE;IACjE,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C,yEAAyE;IACzE,OAAO,CAAC,mBAAmB;IAa3B,uEAAuE;IACvE,OAAO,CAAC,eAAe;IAoBvB,yEAAyE;IACnE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAuBjE,uFAAuF;IACjF,MAAM,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,6BAA6B,CAAA;KAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmFpG,gFAAgF;IAC1E,MAAM,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAiDnF,sFAAsF;IAChF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCvC,4EAA4E;IACtE,IAAI,CAAC,IAAI,CAAC,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IA2FvF,wEAAwE;IAClE,aAAa,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkCtF,8DAA8D;IACxD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAuBhE,gEAAgE;IAC1D,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IA0BpG,+DAA+D;IACzD,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IA0B3E,+DAA+D;IACzD,YAAY,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IA8D/F,0CAA0C;IACpC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB9C,qEAAqE;IAC/D,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/D,2EAA2E;IACrE,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAqBtD"}

package/dist/storage/domains/schedules/index.d.ts

@@ -0,0 +1,55 @@
+import { SchedulesStorage } from '@mastra/core/storage';
+import type { CreateIndexOptions, Schedule, ScheduleFilter, ScheduleTrigger, ScheduleTriggerListOptions, ScheduleUpdate } from '@mastra/core/storage';
+import type { SpannerDomainConfig } from '../../db/index.js';
+/**
+ * Spanner-backed storage for `WorkflowScheduler` schedules and trigger history.
+ *
+ * `mastra_schedule_triggers.id` is the table's only primary-key column
+ * (matches `TABLE_SCHEMAS[TABLE_SCHEDULE_TRIGGERS]`). `schedule_id` is filtered
+ * via a secondary index registered in {@link getDefaultIndexDefinitions}.
+ */
+export declare class SchedulesSpanner extends SchedulesStorage {
+    private database;
+    private db;
+    private readonly skipDefaultIndexes?;
+    private readonly indexes?;
+    static readonly MANAGED_TABLES: readonly ["mastra_schedules", "mastra_schedule_triggers"];
+    constructor(config: SpannerDomainConfig);
+    init(): Promise<void>;
+    getDefaultIndexDefinitions(): CreateIndexOptions[];
+    /**
+     * Creates the default indexes; no-op when `skipDefaultIndexes` was set.
+     * Filters out the target_workflow_id index when that generated column is
+     * absent (e.g. ensureTargetWorkflowIdColumn() failed, or `initMode: 'validate'`
+     * skipped the DDL). Otherwise the createIndex call would fail on a missing
+     * column.
+     */
+    createDefaultIndexes(): Promise<void>;
+    /**
+     * Spanner-specific optimization: add a STORED generated column that extracts
+     * `workflowId` from the JSON `target` payload, so the listSchedules workflowId
+     * filter can use a regular secondary index instead of a full JSON_VALUE scan.
+     */
+    private ensureTargetWorkflowIdColumn;
+    /**
+     * Cached lookup for whether the `target_workflow_id` generated column exists.
+     * Resolves true after `ensureTargetWorkflowIdColumn()` succeeds, otherwise
+     * falls back to an INFORMATION_SCHEMA probe (lets us still pick up the fast
+     * path on databases that already had the column from a prior deploy).
+     */
+    private targetWorkflowIdColumnAvailable;
+    /** Returns true when the `target_workflow_id` generated column exists. */
+    private hasTargetWorkflowIdColumn;
+    createCustomIndexes(): Promise<void>;
+    dangerouslyClearAll(): Promise<void>;
+    createSchedule(schedule: Schedule): Promise<Schedule>;
+    getSchedule(id: string): Promise<Schedule | null>;
+    listSchedules(filter?: ScheduleFilter): Promise<Schedule[]>;
+    listDueSchedules(now: number, limit?: number): Promise<Schedule[]>;
+    updateSchedule(id: string, patch: ScheduleUpdate): Promise<Schedule>;
+    updateScheduleNextFire(id: string, expectedNextFireAt: number, newNextFireAt: number, lastFireAt: number, lastRunId: string): Promise<boolean>;
+    deleteSchedule(id: string): Promise<void>;
+    recordTrigger(trigger: ScheduleTrigger): Promise<void>;
+    listTriggers(scheduleId: string, opts?: ScheduleTriggerListOptions): Promise<ScheduleTrigger[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/domains/schedules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/schedules/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,gBAAgB,EAIjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,kBAAkB,EAClB,QAAQ,EACR,cAAc,EAGd,eAAe,EACf,0BAA0B,EAC1B,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAgDpD;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAuB;IAEhD,MAAM,CAAC,QAAQ,CAAC,cAAc,4DAAuD;gBAEzE,MAAM,EAAE,mBAAmB;IASjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,0BAA0B,IAAI,kBAAkB,EAAE;IA4BlD;;;;;;OAMG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3C;;;;OAIG;YACW,4BAA4B;IAqB1C;;;;;OAKG;IACH,OAAO,CAAC,+BAA+B,CAAwB;IAC/D,0EAA0E;YAC5D,yBAAyB;IAUjC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKpC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKpC,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IA6DrD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAkBjD,aAAa,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAwD3D,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA4BlE,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAuDpE,sBAAsB,CAC1B,EAAE,EAAE,MAAM,EACV,kBAAkB,EAAE,MAAM,EAC1B,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC;IA0Cb,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCzC,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BtD,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CA0CtG"}

package/dist/storage/domains/scorer-definitions/index.d.ts

@@ -0,0 +1,64 @@
+import { ScorerDefinitionsStorage } from '@mastra/core/storage';
+import type { CreateIndexOptions, StorageScorerDefinitionType, StorageCreateScorerDefinitionInput, StorageListScorerDefinitionsInput, StorageListScorerDefinitionsOutput, StorageUpdateScorerDefinitionInput } from '@mastra/core/storage';
+import type { CreateScorerDefinitionVersionInput, ListScorerDefinitionVersionsInput, ListScorerDefinitionVersionsOutput, ScorerDefinitionVersion } from '@mastra/core/storage/domains/scorer-definitions';
+import type { SpannerDomainConfig } from '../../db/index.js';
+/**
+ * Spanner-backed storage for scorer definitions and their immutable versions.
+ * Mirrors the thin-record + versions pattern used by agents/skills/prompt-blocks.
+ */
+export declare class ScorerDefinitionsSpanner extends ScorerDefinitionsStorage {
+    private database;
+    private db;
+    private skipDefaultIndexes?;
+    private indexes?;
+    static readonly MANAGED_TABLES: readonly ["mastra_scorer_definitions", "mastra_scorer_definition_versions"];
+    constructor(config: SpannerDomainConfig);
+    /** Creates the scorer-definition tables, indexes, and (when opted in) sweeps stale drafts. */
+    init(): Promise<void>;
+    /**
+     * Sweeps orphaned draft thin-rows whose paired version row was never written.
+     * Skipped under `initMode: 'validate'` (no destructive DML in validate mode).
+     */
+    private cleanupStaleDrafts;
+    /** Returns the default index set this domain creates during `init()`. */
+    getDefaultIndexDefinitions(): CreateIndexOptions[];
+    /** Creates the default indexes; no-op when `skipDefaultIndexes` was set. */
+    createDefaultIndexes(): Promise<void>;
+    /** Creates custom indexes routed to this domain's tables; no-op when none supplied. */
+    createCustomIndexes(): Promise<void>;
+    /** Removes every row from this domain's tables. Intended for tests. */
+    dangerouslyClearAll(): Promise<void>;
+    /** Decodes a raw Spanner thin-row into the public scorer-definition shape. */
+    private parseScorerRow;
+    /** Decodes a raw Spanner version row into the public version shape. */
+    private parseVersionRow;
+    /** Fetches the thin scorer-definition record by id, or `null` when absent. */
+    getById(id: string): Promise<StorageScorerDefinitionType | null>;
+    /** Atomically inserts a draft thin row + version 1 in a single Spanner transaction. */
+    create(input: {
+        scorerDefinition: StorageCreateScorerDefinitionInput;
+    }): Promise<StorageScorerDefinitionType>;
+    /** Updates thin-record fields (status, activeVersionId, authorId, metadata). */
+    update(input: StorageUpdateScorerDefinitionInput): Promise<StorageScorerDefinitionType>;
+    /** Removes a scorer definition and all its versions atomically in a single transaction. */
+    delete(id: string): Promise<void>;
+    /** Paginated listing with optional status / authorId / metadata filters. */
+    list(args?: StorageListScorerDefinitionsInput): Promise<StorageListScorerDefinitionsOutput>;
+    /** Inserts a new immutable version row for an existing scorer definition. */
+    createVersion(input: CreateScorerDefinitionVersionInput): Promise<ScorerDefinitionVersion>;
+    /** Fetches a version row by its id, or `null` when absent. */
+    getVersion(id: string): Promise<ScorerDefinitionVersion | null>;
+    /** Fetches a specific version by `(scorerDefinitionId, versionNumber)`. */
+    getVersionByNumber(scorerDefinitionId: string, versionNumber: number): Promise<ScorerDefinitionVersion | null>;
+    /** Returns the highest-numbered version for a scorer definition. */
+    getLatestVersion(scorerDefinitionId: string): Promise<ScorerDefinitionVersion | null>;
+    /** Paginated listing of versions for a single scorer definition. */
+    listVersions(input: ListScorerDefinitionVersionsInput): Promise<ListScorerDefinitionVersionsOutput>;
+    /** Deletes a single version row by id. */
+    deleteVersion(id: string): Promise<void>;
+    /** Deletes every version row belonging to the given scorer definition. */
+    deleteVersionsByParentId(entityId: string): Promise<void>;
+    /** Returns the total number of version rows for the given scorer definition. */
+    countVersions(scorerDefinitionId: string): Promise<number>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/domains/scorer-definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/scorer-definitions/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,wBAAwB,EAKzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,kCAAkC,EAClC,iCAAiC,EACjC,kCAAkC,EAClC,kCAAkC,EACnC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,kCAAkC,EAClC,iCAAiC,EACjC,kCAAkC,EAClC,uBAAuB,EACxB,MAAM,iDAAiD,CAAC;AAEzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAIpD;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,wBAAwB;IACpE,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,kBAAkB,CAAC,CAAU;IACrC,OAAO,CAAC,OAAO,CAAC,CAAuB;IAEvC,MAAM,CAAC,QAAQ,CAAC,cAAc,8EAAyE;gBAE3F,MAAM,EAAE,mBAAmB;IAYvC,8FAA8F;IACxF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;;OAGG;YACW,kBAAkB;IAmBhC,yEAAyE;IACzE,0BAA0B,IAAI,kBAAkB,EAAE;IAuBlD,4EAA4E;IACtE,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3C,uFAAuF;IACjF,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C,uEAAuE;IACjE,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C,8EAA8E;IAC9E,OAAO,CAAC,cAAc;IAgBtB,uEAAuE;IACvE,OAAO,CAAC,eAAe;IAuBvB,8EAA8E;IACxE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC;IAuBtE,uFAAuF;IACjF,MAAM,CAAC,KAAK,EAAE;QAAE,gBAAgB,EAAE,kCAAkC,CAAA;KAAE,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAkFnH,gFAAgF;IAC1E,MAAM,CAAC,KAAK,EAAE,kCAAkC,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAiD7F,2FAA2F;IACrF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCvC,4EAA4E;IACtE,IAAI,CAAC,IAAI,CAAC,EAAE,iCAAiC,GAAG,OAAO,CAAC,kCAAkC,CAAC;IA+FjG,6EAA6E;IACvE,aAAa,CAAC,KAAK,EAAE,kCAAkC,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAqChG,8DAA8D;IACxD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAuBrE,2EAA2E;IACrE,kBAAkB,CAAC,kBAAkB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IA0BpH,oEAAoE;IAC9D,gBAAgB,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IA0B3F,oEAAoE;IAC9D,YAAY,CAAC,KAAK,EAAE,iCAAiC,GAAG,OAAO,CAAC,kCAAkC,CAAC;IA8DzG,0CAA0C;IACpC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB9C,0EAA0E;IACpE,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/D,gFAAgF;IAC1E,aAAa,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAqBjE"}

package/dist/storage/domains/scores/index.d.ts

@@ -0,0 +1,46 @@
+import type { ListScoresResponse, SaveScorePayload, ScoreRowData, ScoringSource } from '@mastra/core/evals';
+import type { StoragePagination, CreateIndexOptions } from '@mastra/core/storage';
+import { ScoresStorage } from '@mastra/core/storage';
+import type { SpannerDomainConfig } from '../../db/index.js';
+export declare class ScoresSpanner extends ScoresStorage {
+    private database;
+    private db;
+    private readonly skipDefaultIndexes?;
+    private readonly indexes?;
+    static readonly MANAGED_TABLES: readonly ["mastra_scorers"];
+    constructor(config: SpannerDomainConfig);
+    init(): Promise<void>;
+    getDefaultIndexDefinitions(): CreateIndexOptions[];
+    createDefaultIndexes(): Promise<void>;
+    createCustomIndexes(): Promise<void>;
+    dangerouslyClearAll(): Promise<void>;
+    getScoreById({ id }: {
+        id: string;
+    }): Promise<ScoreRowData | null>;
+    saveScore(score: SaveScorePayload): Promise<{
+        score: ScoreRowData;
+    }>;
+    private listScoresByConditions;
+    listScoresByScorerId({ scorerId, pagination, entityId, entityType, source, }: {
+        scorerId: string;
+        pagination: StoragePagination;
+        entityId?: string;
+        entityType?: string;
+        source?: ScoringSource;
+    }): Promise<ListScoresResponse>;
+    listScoresByRunId({ runId, pagination, }: {
+        runId: string;
+        pagination: StoragePagination;
+    }): Promise<ListScoresResponse>;
+    listScoresByEntityId({ entityId, entityType, pagination, }: {
+        pagination: StoragePagination;
+        entityId: string;
+        entityType: string;
+    }): Promise<ListScoresResponse>;
+    listScoresBySpan({ traceId, spanId, pagination, }: {
+        traceId: string;
+        spanId: string;
+        pagination: StoragePagination;
+    }): Promise<ListScoresResponse>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/domains/scores/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/scores/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE5G,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAEL,aAAa,EAMd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAWpD,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAuB;IAEhD,MAAM,CAAC,QAAQ,CAAC,cAAc,8BAA4B;gBAE9C,MAAM,EAAE,mBAAmB;IASjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,0BAA0B,IAAI,kBAAkB,EAAE;IA2B5C,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKpC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAuBlE,SAAS,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;YAuE5D,sBAAsB;IAkC9B,oBAAoB,CAAC,EACzB,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,UAAU,EACV,MAAM,GACP,EAAE;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,iBAAiB,CAAC;QAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,aAAa,CAAC;KACxB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA8BzB,iBAAiB,CAAC,EACtB,KAAK,EACL,UAAU,GACX,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,iBAAiB,CAAC;KAC/B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoBzB,oBAAoB,CAAC,EACzB,QAAQ,EACR,UAAU,EACV,UAAU,GACX,EAAE;QACD,UAAU,EAAE,iBAAiB,CAAC;QAC9B,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuBzB,gBAAgB,CAAC,EACrB,OAAO,EACP,MAAM,EACN,UAAU,GACX,EAAE;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,iBAAiB,CAAC;KAC/B,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAmBhC"}