@mastra/react 1.7.3-alpha.2 → 1.8.0-alpha.4

package/dist/hooks/datasets/use-dataset-versions.d.ts

@@ -0,0 +1,23 @@
+import type { MastraClient } from '@mastra/client-js';
+import type { QueryKey } from '@tanstack/react-query';
+import type { MastraInfiniteQueryOptions } from '../shared/query-options.js';
+export interface DatasetVersion {
+    id?: string;
+    datasetId?: string;
+    version: number;
+    createdAt?: Date | string;
+    isCurrent: boolean;
+}
+type DatasetVersionsPage = Awaited<ReturnType<MastraClient['listDatasetVersions']>>;
+/**
+ * Hook to fetch dataset versions from the API with infinite pagination.
+ * `data` defaults to the flattened `DatasetVersion[]`; a user `select` replaces that.
+ *
+ * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+ */
+export declare const useDatasetVersions: <TData = DatasetVersion[]>({ datasetId, queryOptions, }: {
+    datasetId: string;
+    queryOptions?: MastraInfiniteQueryOptions<DatasetVersionsPage, TData, QueryKey, number>;
+}) => import("@tanstack/react-query").UseInfiniteQueryResult<TData, Error>;
+export {};
+//# sourceMappingURL=use-dataset-versions.d.ts.map

package/dist/hooks/datasets/use-dataset-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dataset-versions.d.ts","sourceRoot":"","sources":["../../../src/hooks/datasets/use-dataset-versions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAgB,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,KAAK,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;AAIpF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,GAAG,cAAc,EAAE,gCAGxD;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,0BAA0B,CAAC,mBAAmB,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;CACzF,yEA8BA,CAAC"}

package/dist/hooks/datasets/use-datasets.d.ts

@@ -0,0 +1,44 @@
+import type { ExperimentTargetType, ListDatasetsParams, MastraClient } from '@mastra/client-js';
+import type { QueryKey, UseInfiniteQueryResult, UseQueryResult } from '@tanstack/react-query';
+import type { MastraInfiniteQueryOptions, MastraQueryOptions } from '../shared/query-options.js';
+type ListDatasetsResponse = Awaited<ReturnType<MastraClient['listDatasets']>>;
+type DatasetResponse = Awaited<ReturnType<MastraClient['getDataset']>>;
+/**
+ * Hook to list all datasets with optional pagination
+ */
+export declare const useDatasets: <TData = ListDatasetsResponse>({ pagination, queryOptions, }?: {
+    pagination?: {
+        page?: number;
+        perPage?: number;
+    };
+    queryOptions?: MastraQueryOptions<ListDatasetsResponse, TData>;
+}) => UseQueryResult<TData, Error>;
+export interface DatasetTargetFilter {
+    targetType?: ExperimentTargetType | '';
+    targetId?: string;
+}
+export type DatasetsOrderBy = NonNullable<ListDatasetsParams['orderBy']>;
+type DatasetRecord = ListDatasetsResponse['datasets'][number];
+export type UseInfiniteDatasetsResult<TData = DatasetRecord[]> = UseInfiniteQueryResult<TData, Error> & {
+    setEndOfListElement: (element: HTMLDivElement | null) => void;
+};
+/**
+ * Hook to list datasets with infinite scroll pagination, optionally scoped server-side to a target.
+ * `data` defaults to the flattened dataset list; a user `select` replaces that flattening.
+ */
+export declare const useInfiniteDatasets: <TData = DatasetRecord[]>({ filter, orderBy, queryOptions, }?: {
+    filter?: DatasetTargetFilter;
+    orderBy?: DatasetsOrderBy;
+    queryOptions?: MastraInfiniteQueryOptions<ListDatasetsResponse, TData, QueryKey, number>;
+}) => UseInfiniteDatasetsResult<TData>;
+/**
+ * Hook to fetch a single dataset by ID
+ *
+ * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+ */
+export declare const useDataset: <TData = DatasetResponse>({ datasetId, queryOptions, }: {
+    datasetId: string;
+    queryOptions?: MastraQueryOptions<DatasetResponse, TData>;
+}) => UseQueryResult<TData, Error>;
+export {};
+//# sourceMappingURL=use-datasets.d.ts.map

package/dist/hooks/datasets/use-datasets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-datasets.d.ts","sourceRoot":"","sources":["../../../src/hooks/datasets/use-datasets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEhG,OAAO,KAAK,EAAgB,QAAQ,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5G,OAAO,KAAK,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG9F,KAAK,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAC9E,KAAK,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,GAAG,oBAAoB,kCAGrD;IACD,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,YAAY,CAAC,EAAE,kBAAkB,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;CAChE,KAAQ,cAAc,CAAC,KAAK,EAAE,KAAK,CAQnC,CAAC;AAIF,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,oBAAoB,GAAG,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;AAEzE,KAAK,aAAa,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,MAAM,MAAM,yBAAyB,CAAC,KAAK,GAAG,aAAa,EAAE,IAAI,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG;IACtG,mBAAmB,EAAE,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAC;CAC/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,GAAG,aAAa,EAAE,uCAIxD;IACD,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,YAAY,CAAC,EAAE,0BAA0B,CAAC,oBAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;CAC1F,KAAQ,yBAAyB,CAAC,KAAK,CA6BvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,GAAG,eAAe,gCAG/C;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,kBAAkB,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;CAC3D,KAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAO9B,CAAC"}

package/dist/hooks/datasets/use-experiments.d.ts

@@ -0,0 +1,16 @@
+import type { MastraClient } from '@mastra/client-js';
+import type { UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+type ListExperimentsResponse = Awaited<ReturnType<MastraClient['listExperiments']>>;
+/**
+ * Hook to list all experiments across all datasets with optional pagination
+ */
+export declare const useExperiments: <TData = ListExperimentsResponse>({ pagination, queryOptions, }?: {
+    pagination?: {
+        page?: number;
+        perPage?: number;
+    };
+    queryOptions?: MastraQueryOptions<ListExperimentsResponse, TData>;
+}) => UseQueryResult<TData, Error>;
+export {};
+//# sourceMappingURL=use-experiments.d.ts.map

package/dist/hooks/datasets/use-experiments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-experiments.d.ts","sourceRoot":"","sources":["../../../src/hooks/datasets/use-experiments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,KAAK,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,GAAG,uBAAuB,kCAG3D;IACD,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,YAAY,CAAC,EAAE,kBAAkB,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;CACnE,KAAQ,cAAc,CAAC,KAAK,EAAE,KAAK,CAOnC,CAAC"}

package/dist/hooks/datasets/use-workflow-schema.d.ts

@@ -0,0 +1,16 @@
+import type { MastraClient } from '@mastra/client-js';
+import type { UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+type WorkflowSchemaResponse = Awaited<ReturnType<ReturnType<MastraClient['getWorkflow']>['getSchema']>>;
+/**
+ * Hook to fetch workflow input/output schema by workflow ID.
+ * Returns { inputSchema, outputSchema } where each is Record<string, unknown> | null.
+ *
+ * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+ */
+export declare function useWorkflowSchema<TData = WorkflowSchemaResponse>({ workflowId, queryOptions, }: {
+    workflowId: string | null;
+    queryOptions?: MastraQueryOptions<WorkflowSchemaResponse, TData>;
+}): UseQueryResult<TData, Error>;
+export {};
+//# sourceMappingURL=use-workflow-schema.d.ts.map

package/dist/hooks/datasets/use-workflow-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-workflow-schema.d.ts","sourceRoot":"","sources":["../../../src/hooks/datasets/use-workflow-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,KAAK,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAExG;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAG,sBAAsB,EAAE,EAChE,UAAU,EACV,YAAY,GACb,EAAE;IACD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,kBAAkB,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;CAClE,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAY/B"}

package/dist/hooks/embedders/index.cjs

@@ -0,0 +1,19 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_mastra_client_context = require("../../mastra-client-context-DzX3f0RF.cjs");
+let _tanstack_react_query = require("@tanstack/react-query");
+//#region src/hooks/embedders/use-embedders.ts
+function useEmbedders({ queryOptions } = {}) {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: ["embedders"],
+		queryFn: async () => {
+			return await client.listEmbedders();
+		},
+		staleTime: 3e4,
+		...queryOptions
+	});
+}
+//#endregion
+exports.useEmbedders = useEmbedders;
+
+//# sourceMappingURL=index.cjs.map

package/dist/hooks/embedders/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["useMastraClient"],"sources":["../../../src/hooks/embedders/use-embedders.ts"],"sourcesContent":["import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport interface Embedder {\n  id: string;\n  provider: string;\n  name: string;\n  description: string;\n  dimensions: number;\n  maxInputTokens: number;\n}\n\ntype ListEmbeddersResponse = Awaited<ReturnType<MastraClient['listEmbedders']>>;\n\nexport function useEmbedders<TData = ListEmbeddersResponse>({\n  queryOptions,\n}: { queryOptions?: MastraQueryOptions<ListEmbeddersResponse, TData> } = {}): UseQueryResult<TData, Error> {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['embedders'],\n    queryFn: async () => {\n      const data = await client.listEmbedders();\n      return data;\n    },\n    staleTime: 30000, // Cache for 30 seconds\n    ...queryOptions,\n  });\n}\n"],"mappings":";;;;AAiBA,SAAgB,aAA4C,EAC1D,iBACuE,CAAC,GAAiC;CACzG,MAAM,SAASA,8BAAAA,gBAAgB;CAE/B,QAAA,GAAA,sBAAA,SAAA,CAAgB;EACd,UAAU,CAAC,WAAW;EACtB,SAAS,YAAY;GAEnB,OAAO,MADY,OAAO,cAAc;EAE1C;EACA,WAAW;EACX,GAAG;CACL,CAAC;AACH"}

package/dist/hooks/embedders/index.d.ts

@@ -0,0 +1,2 @@
+export * from './use-embedders.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/embedders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/embedders/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/hooks/embedders/index.js

@@ -0,0 +1,18 @@
+import { n as useMastraClient } from "../../mastra-client-context-Bx_g84YB.js";
+import { useQuery } from "@tanstack/react-query";
+//#region src/hooks/embedders/use-embedders.ts
+function useEmbedders({ queryOptions } = {}) {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: ["embedders"],
+		queryFn: async () => {
+			return await client.listEmbedders();
+		},
+		staleTime: 3e4,
+		...queryOptions
+	});
+}
+//#endregion
+export { useEmbedders };
+
+//# sourceMappingURL=index.js.map

package/dist/hooks/embedders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/embedders/use-embedders.ts"],"sourcesContent":["import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport interface Embedder {\n  id: string;\n  provider: string;\n  name: string;\n  description: string;\n  dimensions: number;\n  maxInputTokens: number;\n}\n\ntype ListEmbeddersResponse = Awaited<ReturnType<MastraClient['listEmbedders']>>;\n\nexport function useEmbedders<TData = ListEmbeddersResponse>({\n  queryOptions,\n}: { queryOptions?: MastraQueryOptions<ListEmbeddersResponse, TData> } = {}): UseQueryResult<TData, Error> {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['embedders'],\n    queryFn: async () => {\n      const data = await client.listEmbedders();\n      return data;\n    },\n    staleTime: 30000, // Cache for 30 seconds\n    ...queryOptions,\n  });\n}\n"],"mappings":";;;AAiBA,SAAgB,aAA4C,EAC1D,iBACuE,CAAC,GAAiC;CACzG,MAAM,SAAS,gBAAgB;CAE/B,OAAO,SAAS;EACd,UAAU,CAAC,WAAW;EACtB,SAAS,YAAY;GAEnB,OAAO,MADY,OAAO,cAAc;EAE1C;EACA,WAAW;EACX,GAAG;CACL,CAAC;AACH"}

package/dist/hooks/embedders/use-embedders.d.ts

@@ -0,0 +1,17 @@
+import type { MastraClient } from '@mastra/client-js';
+import type { UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+export interface Embedder {
+    id: string;
+    provider: string;
+    name: string;
+    description: string;
+    dimensions: number;
+    maxInputTokens: number;
+}
+type ListEmbeddersResponse = Awaited<ReturnType<MastraClient['listEmbedders']>>;
+export declare function useEmbedders<TData = ListEmbeddersResponse>({ queryOptions, }?: {
+    queryOptions?: MastraQueryOptions<ListEmbeddersResponse, TData>;
+}): UseQueryResult<TData, Error>;
+export {};
+//# sourceMappingURL=use-embedders.d.ts.map

package/dist/hooks/embedders/use-embedders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-embedders.d.ts","sourceRoot":"","sources":["../../../src/hooks/embedders/use-embedders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,KAAK,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;AAEhF,wBAAgB,YAAY,CAAC,KAAK,GAAG,qBAAqB,EAAE,EAC1D,YAAY,GACb,GAAE;IAAE,YAAY,CAAC,EAAE,kBAAkB,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAA;CAAO,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAYzG"}

package/dist/hooks/experiments/index.cjs

@@ -0,0 +1,152 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_mastra_client_context = require("../../mastra-client-context-DzX3f0RF.cjs");
+const require_use_in_view = require("../../use-in-view-B6eJO9Zi.cjs");
+let react = require("react");
+let _tanstack_react_query = require("@tanstack/react-query");
+//#region src/hooks/experiments/use-experiment-metrics.ts
+/**
+* Experiment-scoped metrics (tokens, cost, avg agent latency).
+* Filters only by experimentId — no time window, since the experiment already bounds the row set.
+* Polls every 2 seconds while the experiment is running or pending.
+*
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useExperimentMetrics = ({ experimentId, experimentStatus, supportsMetrics, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	const isEnabled = Boolean(experimentId) && supportsMetrics;
+	const query = (0, _tanstack_react_query.useQuery)({
+		queryKey: ["experiment-metrics", experimentId],
+		refetchInterval: experimentStatus === "running" || experimentStatus === "pending" ? 2e3 : false,
+		queryFn: async () => {
+			if (!experimentId) throw new Error("experimentId is required");
+			const filters = { experimentId };
+			const [tokens, avgDuration, runs] = await Promise.all([
+				client.getMetricAggregate({
+					name: ["mastra_model_total_input_tokens", "mastra_model_total_output_tokens"],
+					aggregation: "sum",
+					filters
+				}),
+				client.getMetricAggregate({
+					name: ["mastra_agent_duration_ms"],
+					aggregation: "avg",
+					filters
+				}),
+				client.getMetricAggregate({
+					name: ["mastra_agent_duration_ms"],
+					aggregation: "count",
+					filters
+				})
+			]);
+			return {
+				totalTokens: tokens.value ?? null,
+				estimatedCost: tokens.estimatedCost ?? null,
+				costUnit: tokens.costUnit ?? null,
+				avgAgentDurationMs: avgDuration.value ?? null,
+				agentRuns: runs.value ?? null
+			};
+		},
+		...queryOptions
+	});
+	return {
+		data: query.data,
+		isLoading: query.isLoading,
+		isEnabled
+	};
+};
+//#endregion
+//#region src/hooks/experiments/use-experiment-trace.ts
+/**
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useExperimentTrace = ({ traceId, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: ["experiment-trace-light", traceId],
+		queryFn: async () => {
+			if (!traceId) throw new Error("Trace ID is required");
+			return client.getTraceLight(traceId);
+		},
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/experiments/use-experiments-for-dataset-filter.ts
+/** Explicit page size: server defaults are 20 (global) / 10 (per dataset), which is too small for the list. */
+const EXPERIMENTS_PAGE_SIZE = 100;
+function useExperimentsForDatasetFilter({ datasetId, target, queryOptions }) {
+	const client = require_mastra_client_context.useMastraClient();
+	const params = { perPage: 100 };
+	if (target?.targetType) params.targetType = target.targetType;
+	if (target?.targetId) params.targetId = target.targetId;
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: datasetId ? [
+			"dataset-experiments",
+			datasetId,
+			params
+		] : ["experiments", params],
+		queryFn: () => datasetId ? client.listDatasetExperiments(datasetId, params) : client.listExperiments(params),
+		...queryOptions
+	});
+}
+//#endregion
+//#region src/hooks/experiments/use-infinite-experiments.ts
+const EXPERIMENTS_PER_PAGE = 100;
+function useInfiniteExperiments({ datasetId, target, orderBy, queryOptions }) {
+	const client = require_mastra_client_context.useMastraClient();
+	const { inView: isEndOfListInView, setRef: setEndOfListElement } = require_use_in_view.useInView();
+	const targetType = target?.targetType || void 0;
+	const targetId = target?.targetId || void 0;
+	const query = (0, _tanstack_react_query.useInfiniteQuery)({
+		queryKey: datasetId ? [
+			"dataset-experiments",
+			datasetId,
+			"infinite",
+			{
+				targetType,
+				targetId,
+				orderBy
+			}
+		] : [
+			"experiments",
+			"infinite",
+			{
+				targetType,
+				targetId,
+				orderBy
+			}
+		],
+		queryFn: ({ pageParam }) => {
+			const params = {
+				page: pageParam,
+				perPage: 100
+			};
+			if (targetType) params.targetType = targetType;
+			if (targetId) params.targetId = targetId;
+			if (orderBy) params.orderBy = orderBy;
+			return datasetId ? client.listDatasetExperiments(datasetId, params) : client.listExperiments(params);
+		},
+		initialPageParam: 0,
+		getNextPageParam: (lastPage, _, lastPageParam) => {
+			if (!lastPage?.experiments?.length || !lastPage.pagination?.hasMore) return;
+			return lastPageParam + 1;
+		},
+		select: (data) => data.pages.flatMap((page) => page?.experiments ?? []),
+		...queryOptions
+	});
+	(0, react.useEffect)(() => {
+		if (isEndOfListInView && query.hasNextPage && !query.isFetchingNextPage) query.fetchNextPage();
+	}, [isEndOfListInView, query]);
+	return {
+		...query,
+		setEndOfListElement
+	};
+}
+//#endregion
+exports.EXPERIMENTS_PAGE_SIZE = EXPERIMENTS_PAGE_SIZE;
+exports.EXPERIMENTS_PER_PAGE = EXPERIMENTS_PER_PAGE;
+exports.useExperimentMetrics = useExperimentMetrics;
+exports.useExperimentTrace = useExperimentTrace;
+exports.useExperimentsForDatasetFilter = useExperimentsForDatasetFilter;
+exports.useInfiniteExperiments = useInfiniteExperiments;
+
+//# sourceMappingURL=index.cjs.map

package/dist/hooks/experiments/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["useMastraClient","useMastraClient","useMastraClient","useMastraClient","useInView"],"sources":["../../../src/hooks/experiments/use-experiment-metrics.ts","../../../src/hooks/experiments/use-experiment-trace.ts","../../../src/hooks/experiments/use-experiments-for-dataset-filter.ts","../../../src/hooks/experiments/use-infinite-experiments.ts"],"sourcesContent":["import type { DatasetExperiment } from '@mastra/client-js';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport interface ExperimentMetrics {\n  totalTokens: number | null;\n  estimatedCost: number | null;\n  costUnit: string | null;\n  avgAgentDurationMs: number | null;\n  agentRuns: number | null;\n}\n\ninterface UseExperimentMetricsArgs {\n  experimentId: string | undefined;\n  experimentStatus: DatasetExperiment['status'] | undefined;\n  /** Whether the observability store can serve metrics; no requests are made when false. */\n  supportsMetrics: boolean;\n  queryOptions?: MastraQueryOptions<ExperimentMetrics>;\n}\n\n/**\n * Experiment-scoped metrics (tokens, cost, avg agent latency).\n * Filters only by experimentId — no time window, since the experiment already bounds the row set.\n * Polls every 2 seconds while the experiment is running or pending.\n *\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useExperimentMetrics = ({\n  experimentId,\n  experimentStatus,\n  supportsMetrics,\n  queryOptions,\n}: UseExperimentMetricsArgs) => {\n  const client = useMastraClient();\n  const isEnabled = Boolean(experimentId) && supportsMetrics;\n  const isActive = experimentStatus === 'running' || experimentStatus === 'pending';\n\n  const query = useQuery({\n    queryKey: ['experiment-metrics', experimentId],\n    refetchInterval: isActive ? 2000 : false,\n    queryFn: async (): Promise<ExperimentMetrics> => {\n      // `enabled` already guards this; the check exists to narrow the type.\n      if (!experimentId) throw new Error('experimentId is required');\n      const filters = { experimentId };\n\n      const [tokens, avgDuration, runs] = await Promise.all([\n        client.getMetricAggregate({\n          name: ['mastra_model_total_input_tokens', 'mastra_model_total_output_tokens'],\n          aggregation: 'sum',\n          filters,\n        }),\n        client.getMetricAggregate({ name: ['mastra_agent_duration_ms'], aggregation: 'avg', filters }),\n        client.getMetricAggregate({ name: ['mastra_agent_duration_ms'], aggregation: 'count', filters }),\n      ]);\n\n      return {\n        totalTokens: tokens.value ?? null,\n        estimatedCost: tokens.estimatedCost ?? null,\n        costUnit: tokens.costUnit ?? null,\n        avgAgentDurationMs: avgDuration.value ?? null,\n        agentRuns: runs.value ?? null,\n      };\n    },\n    ...queryOptions,\n  });\n\n  return { data: query.data, isLoading: query.isLoading, isEnabled };\n};\n","import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\ntype TraceLightResponse = Awaited<ReturnType<MastraClient['getTraceLight']>>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useExperimentTrace = <TData = TraceLightResponse>({\n  traceId,\n  queryOptions,\n}: {\n  traceId: string | null | undefined;\n  queryOptions?: MastraQueryOptions<TraceLightResponse, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['experiment-trace-light', traceId],\n    queryFn: async () => {\n      if (!traceId) {\n        throw new Error('Trace ID is required');\n      }\n      return client.getTraceLight(traceId);\n    },\n    ...queryOptions,\n  });\n};\n","import type { ExperimentTargetType, ListExperimentsParams, MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\n/** Explicit page size: server defaults are 20 (global) / 10 (per dataset), which is too small for the list. */\nexport const EXPERIMENTS_PAGE_SIZE = 100;\n\nexport interface ExperimentTargetFilter {\n  targetType?: ExperimentTargetType | '';\n  targetId?: string;\n}\n\n/**\n * Experiments for the list page: the global list, or the dataset-scoped list when a dataset filter is active.\n * A dataset's runs may not be in the first page of the global list, so filtering client-side is not enough.\n * The optional target filter is applied server-side for the same reason.\n */\ntype ListExperimentsResponse = Awaited<ReturnType<MastraClient['listExperiments']>>;\n\nexport function useExperimentsForDatasetFilter<TData = ListExperimentsResponse>({\n  datasetId,\n  target,\n  queryOptions,\n}: {\n  datasetId: string | undefined;\n  target?: ExperimentTargetFilter;\n  queryOptions?: MastraQueryOptions<ListExperimentsResponse, TData>;\n}): UseQueryResult<TData, Error> {\n  const client = useMastraClient();\n  const params: ListExperimentsParams = { perPage: EXPERIMENTS_PAGE_SIZE };\n  if (target?.targetType) params.targetType = target.targetType;\n  if (target?.targetId) params.targetId = target.targetId;\n\n  return useQuery({\n    // Prefixes match the keys invalidated by dataset/experiment mutations.\n    queryKey: datasetId ? ['dataset-experiments', datasetId, params] : ['experiments', params],\n    queryFn: () => (datasetId ? client.listDatasetExperiments(datasetId, params) : client.listExperiments(params)),\n    ...queryOptions,\n  });\n}\n","import type { DatasetExperiment, ListExperimentsParams, MastraClient } from '@mastra/client-js';\nimport { useInfiniteQuery } from '@tanstack/react-query';\nimport type { InfiniteData, QueryKey, UseInfiniteQueryResult } from '@tanstack/react-query';\nimport { useEffect } from 'react';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraInfiniteQueryOptions } from '../shared/query-options';\nimport { useInView } from '../shared/use-in-view';\nimport type { ExperimentTargetFilter } from './use-experiments-for-dataset-filter';\n\nexport const EXPERIMENTS_PER_PAGE = 100;\n\n/**\n * Infinite-scroll experiments for the list page: the global list, or the dataset-scoped list when a\n * dataset filter is active (a dataset's runs may not be in the first pages of the global list). The\n * optional target filter is applied server-side for the same reason.\n */\nexport type ExperimentsOrderBy = NonNullable<ListExperimentsParams['orderBy']>;\n\ntype ListExperimentsResponse = Awaited<ReturnType<MastraClient['listExperiments']>>;\n\nexport function useInfiniteExperiments<TData = DatasetExperiment[]>({\n  datasetId,\n  target,\n  orderBy,\n  queryOptions,\n}: {\n  datasetId: string | undefined;\n  target?: ExperimentTargetFilter;\n  orderBy?: ExperimentsOrderBy;\n  queryOptions?: MastraInfiniteQueryOptions<ListExperimentsResponse, TData, QueryKey, number>;\n}): UseInfiniteQueryResult<TData, Error> & {\n  setEndOfListElement: (element: HTMLDivElement | null) => void;\n} {\n  const client = useMastraClient();\n  const { inView: isEndOfListInView, setRef: setEndOfListElement } = useInView();\n  const targetType = target?.targetType || undefined;\n  const targetId = target?.targetId || undefined;\n\n  const query = useInfiniteQuery({\n    // Prefixes match the keys invalidated by dataset/experiment mutations.\n    queryKey: datasetId\n      ? ['dataset-experiments', datasetId, 'infinite', { targetType, targetId, orderBy }]\n      : ['experiments', 'infinite', { targetType, targetId, orderBy }],\n    queryFn: ({ pageParam }) => {\n      const params: ListExperimentsParams = { page: pageParam, perPage: EXPERIMENTS_PER_PAGE };\n      if (targetType) params.targetType = targetType;\n      if (targetId) params.targetId = targetId;\n      if (orderBy) params.orderBy = orderBy;\n      return datasetId ? client.listDatasetExperiments(datasetId, params) : client.listExperiments(params);\n    },\n    initialPageParam: 0,\n    getNextPageParam: (lastPage, _, lastPageParam) => {\n      if (!lastPage?.experiments?.length || !lastPage.pagination?.hasMore) {\n        return undefined;\n      }\n      return lastPageParam + 1;\n    },\n    select: (data: InfiniteData<ListExperimentsResponse, number>) =>\n      data.pages.flatMap(page => page?.experiments ?? []) as TData,\n    ...queryOptions,\n  });\n\n  useEffect(() => {\n    if (isEndOfListInView && query.hasNextPage && !query.isFetchingNextPage) {\n      void query.fetchNextPage();\n    }\n  }, [isEndOfListInView, query]);\n\n  return { ...query, setEndOfListElement };\n}\n"],"mappings":"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"}

package/dist/hooks/experiments/index.d.ts

@@ -0,0 +1,5 @@
+export * from './use-experiment-metrics.js';
+export * from './use-experiment-trace.js';
+export * from './use-experiments-for-dataset-filter.js';
+export * from './use-infinite-experiments.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/experiments/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/experiments/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC"}

package/dist/hooks/experiments/index.js

@@ -0,0 +1,146 @@
+import { n as useMastraClient } from "../../mastra-client-context-Bx_g84YB.js";
+import { t as useInView } from "../../use-in-view-C9sYPGRm.js";
+import { useEffect } from "react";
+import { useInfiniteQuery, useQuery } from "@tanstack/react-query";
+//#region src/hooks/experiments/use-experiment-metrics.ts
+/**
+* Experiment-scoped metrics (tokens, cost, avg agent latency).
+* Filters only by experimentId — no time window, since the experiment already bounds the row set.
+* Polls every 2 seconds while the experiment is running or pending.
+*
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useExperimentMetrics = ({ experimentId, experimentStatus, supportsMetrics, queryOptions }) => {
+	const client = useMastraClient();
+	const isEnabled = Boolean(experimentId) && supportsMetrics;
+	const query = useQuery({
+		queryKey: ["experiment-metrics", experimentId],
+		refetchInterval: experimentStatus === "running" || experimentStatus === "pending" ? 2e3 : false,
+		queryFn: async () => {
+			if (!experimentId) throw new Error("experimentId is required");
+			const filters = { experimentId };
+			const [tokens, avgDuration, runs] = await Promise.all([
+				client.getMetricAggregate({
+					name: ["mastra_model_total_input_tokens", "mastra_model_total_output_tokens"],
+					aggregation: "sum",
+					filters
+				}),
+				client.getMetricAggregate({
+					name: ["mastra_agent_duration_ms"],
+					aggregation: "avg",
+					filters
+				}),
+				client.getMetricAggregate({
+					name: ["mastra_agent_duration_ms"],
+					aggregation: "count",
+					filters
+				})
+			]);
+			return {
+				totalTokens: tokens.value ?? null,
+				estimatedCost: tokens.estimatedCost ?? null,
+				costUnit: tokens.costUnit ?? null,
+				avgAgentDurationMs: avgDuration.value ?? null,
+				agentRuns: runs.value ?? null
+			};
+		},
+		...queryOptions
+	});
+	return {
+		data: query.data,
+		isLoading: query.isLoading,
+		isEnabled
+	};
+};
+//#endregion
+//#region src/hooks/experiments/use-experiment-trace.ts
+/**
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useExperimentTrace = ({ traceId, queryOptions }) => {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: ["experiment-trace-light", traceId],
+		queryFn: async () => {
+			if (!traceId) throw new Error("Trace ID is required");
+			return client.getTraceLight(traceId);
+		},
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/experiments/use-experiments-for-dataset-filter.ts
+/** Explicit page size: server defaults are 20 (global) / 10 (per dataset), which is too small for the list. */
+const EXPERIMENTS_PAGE_SIZE = 100;
+function useExperimentsForDatasetFilter({ datasetId, target, queryOptions }) {
+	const client = useMastraClient();
+	const params = { perPage: 100 };
+	if (target?.targetType) params.targetType = target.targetType;
+	if (target?.targetId) params.targetId = target.targetId;
+	return useQuery({
+		queryKey: datasetId ? [
+			"dataset-experiments",
+			datasetId,
+			params
+		] : ["experiments", params],
+		queryFn: () => datasetId ? client.listDatasetExperiments(datasetId, params) : client.listExperiments(params),
+		...queryOptions
+	});
+}
+//#endregion
+//#region src/hooks/experiments/use-infinite-experiments.ts
+const EXPERIMENTS_PER_PAGE = 100;
+function useInfiniteExperiments({ datasetId, target, orderBy, queryOptions }) {
+	const client = useMastraClient();
+	const { inView: isEndOfListInView, setRef: setEndOfListElement } = useInView();
+	const targetType = target?.targetType || void 0;
+	const targetId = target?.targetId || void 0;
+	const query = useInfiniteQuery({
+		queryKey: datasetId ? [
+			"dataset-experiments",
+			datasetId,
+			"infinite",
+			{
+				targetType,
+				targetId,
+				orderBy
+			}
+		] : [
+			"experiments",
+			"infinite",
+			{
+				targetType,
+				targetId,
+				orderBy
+			}
+		],
+		queryFn: ({ pageParam }) => {
+			const params = {
+				page: pageParam,
+				perPage: 100
+			};
+			if (targetType) params.targetType = targetType;
+			if (targetId) params.targetId = targetId;
+			if (orderBy) params.orderBy = orderBy;
+			return datasetId ? client.listDatasetExperiments(datasetId, params) : client.listExperiments(params);
+		},
+		initialPageParam: 0,
+		getNextPageParam: (lastPage, _, lastPageParam) => {
+			if (!lastPage?.experiments?.length || !lastPage.pagination?.hasMore) return;
+			return lastPageParam + 1;
+		},
+		select: (data) => data.pages.flatMap((page) => page?.experiments ?? []),
+		...queryOptions
+	});
+	useEffect(() => {
+		if (isEndOfListInView && query.hasNextPage && !query.isFetchingNextPage) query.fetchNextPage();
+	}, [isEndOfListInView, query]);
+	return {
+		...query,
+		setEndOfListElement
+	};
+}
+//#endregion
+export { EXPERIMENTS_PAGE_SIZE, EXPERIMENTS_PER_PAGE, useExperimentMetrics, useExperimentTrace, useExperimentsForDatasetFilter, useInfiniteExperiments };
+
+//# sourceMappingURL=index.js.map

package/dist/hooks/experiments/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/experiments/use-experiment-metrics.ts","../../../src/hooks/experiments/use-experiment-trace.ts","../../../src/hooks/experiments/use-experiments-for-dataset-filter.ts","../../../src/hooks/experiments/use-infinite-experiments.ts"],"sourcesContent":["import type { DatasetExperiment } from '@mastra/client-js';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport interface ExperimentMetrics {\n  totalTokens: number | null;\n  estimatedCost: number | null;\n  costUnit: string | null;\n  avgAgentDurationMs: number | null;\n  agentRuns: number | null;\n}\n\ninterface UseExperimentMetricsArgs {\n  experimentId: string | undefined;\n  experimentStatus: DatasetExperiment['status'] | undefined;\n  /** Whether the observability store can serve metrics; no requests are made when false. */\n  supportsMetrics: boolean;\n  queryOptions?: MastraQueryOptions<ExperimentMetrics>;\n}\n\n/**\n * Experiment-scoped metrics (tokens, cost, avg agent latency).\n * Filters only by experimentId — no time window, since the experiment already bounds the row set.\n * Polls every 2 seconds while the experiment is running or pending.\n *\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useExperimentMetrics = ({\n  experimentId,\n  experimentStatus,\n  supportsMetrics,\n  queryOptions,\n}: UseExperimentMetricsArgs) => {\n  const client = useMastraClient();\n  const isEnabled = Boolean(experimentId) && supportsMetrics;\n  const isActive = experimentStatus === 'running' || experimentStatus === 'pending';\n\n  const query = useQuery({\n    queryKey: ['experiment-metrics', experimentId],\n    refetchInterval: isActive ? 2000 : false,\n    queryFn: async (): Promise<ExperimentMetrics> => {\n      // `enabled` already guards this; the check exists to narrow the type.\n      if (!experimentId) throw new Error('experimentId is required');\n      const filters = { experimentId };\n\n      const [tokens, avgDuration, runs] = await Promise.all([\n        client.getMetricAggregate({\n          name: ['mastra_model_total_input_tokens', 'mastra_model_total_output_tokens'],\n          aggregation: 'sum',\n          filters,\n        }),\n        client.getMetricAggregate({ name: ['mastra_agent_duration_ms'], aggregation: 'avg', filters }),\n        client.getMetricAggregate({ name: ['mastra_agent_duration_ms'], aggregation: 'count', filters }),\n      ]);\n\n      return {\n        totalTokens: tokens.value ?? null,\n        estimatedCost: tokens.estimatedCost ?? null,\n        costUnit: tokens.costUnit ?? null,\n        avgAgentDurationMs: avgDuration.value ?? null,\n        agentRuns: runs.value ?? null,\n      };\n    },\n    ...queryOptions,\n  });\n\n  return { data: query.data, isLoading: query.isLoading, isEnabled };\n};\n","import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\ntype TraceLightResponse = Awaited<ReturnType<MastraClient['getTraceLight']>>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useExperimentTrace = <TData = TraceLightResponse>({\n  traceId,\n  queryOptions,\n}: {\n  traceId: string | null | undefined;\n  queryOptions?: MastraQueryOptions<TraceLightResponse, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['experiment-trace-light', traceId],\n    queryFn: async () => {\n      if (!traceId) {\n        throw new Error('Trace ID is required');\n      }\n      return client.getTraceLight(traceId);\n    },\n    ...queryOptions,\n  });\n};\n","import type { ExperimentTargetType, ListExperimentsParams, MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\n/** Explicit page size: server defaults are 20 (global) / 10 (per dataset), which is too small for the list. */\nexport const EXPERIMENTS_PAGE_SIZE = 100;\n\nexport interface ExperimentTargetFilter {\n  targetType?: ExperimentTargetType | '';\n  targetId?: string;\n}\n\n/**\n * Experiments for the list page: the global list, or the dataset-scoped list when a dataset filter is active.\n * A dataset's runs may not be in the first page of the global list, so filtering client-side is not enough.\n * The optional target filter is applied server-side for the same reason.\n */\ntype ListExperimentsResponse = Awaited<ReturnType<MastraClient['listExperiments']>>;\n\nexport function useExperimentsForDatasetFilter<TData = ListExperimentsResponse>({\n  datasetId,\n  target,\n  queryOptions,\n}: {\n  datasetId: string | undefined;\n  target?: ExperimentTargetFilter;\n  queryOptions?: MastraQueryOptions<ListExperimentsResponse, TData>;\n}): UseQueryResult<TData, Error> {\n  const client = useMastraClient();\n  const params: ListExperimentsParams = { perPage: EXPERIMENTS_PAGE_SIZE };\n  if (target?.targetType) params.targetType = target.targetType;\n  if (target?.targetId) params.targetId = target.targetId;\n\n  return useQuery({\n    // Prefixes match the keys invalidated by dataset/experiment mutations.\n    queryKey: datasetId ? ['dataset-experiments', datasetId, params] : ['experiments', params],\n    queryFn: () => (datasetId ? client.listDatasetExperiments(datasetId, params) : client.listExperiments(params)),\n    ...queryOptions,\n  });\n}\n","import type { DatasetExperiment, ListExperimentsParams, MastraClient } from '@mastra/client-js';\nimport { useInfiniteQuery } from '@tanstack/react-query';\nimport type { InfiniteData, QueryKey, UseInfiniteQueryResult } from '@tanstack/react-query';\nimport { useEffect } from 'react';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraInfiniteQueryOptions } from '../shared/query-options';\nimport { useInView } from '../shared/use-in-view';\nimport type { ExperimentTargetFilter } from './use-experiments-for-dataset-filter';\n\nexport const EXPERIMENTS_PER_PAGE = 100;\n\n/**\n * Infinite-scroll experiments for the list page: the global list, or the dataset-scoped list when a\n * dataset filter is active (a dataset's runs may not be in the first pages of the global list). The\n * optional target filter is applied server-side for the same reason.\n */\nexport type ExperimentsOrderBy = NonNullable<ListExperimentsParams['orderBy']>;\n\ntype ListExperimentsResponse = Awaited<ReturnType<MastraClient['listExperiments']>>;\n\nexport function useInfiniteExperiments<TData = DatasetExperiment[]>({\n  datasetId,\n  target,\n  orderBy,\n  queryOptions,\n}: {\n  datasetId: string | undefined;\n  target?: ExperimentTargetFilter;\n  orderBy?: ExperimentsOrderBy;\n  queryOptions?: MastraInfiniteQueryOptions<ListExperimentsResponse, TData, QueryKey, number>;\n}): UseInfiniteQueryResult<TData, Error> & {\n  setEndOfListElement: (element: HTMLDivElement | null) => void;\n} {\n  const client = useMastraClient();\n  const { inView: isEndOfListInView, setRef: setEndOfListElement } = useInView();\n  const targetType = target?.targetType || undefined;\n  const targetId = target?.targetId || undefined;\n\n  const query = useInfiniteQuery({\n    // Prefixes match the keys invalidated by dataset/experiment mutations.\n    queryKey: datasetId\n      ? ['dataset-experiments', datasetId, 'infinite', { targetType, targetId, orderBy }]\n      : ['experiments', 'infinite', { targetType, targetId, orderBy }],\n    queryFn: ({ pageParam }) => {\n      const params: ListExperimentsParams = { page: pageParam, perPage: EXPERIMENTS_PER_PAGE };\n      if (targetType) params.targetType = targetType;\n      if (targetId) params.targetId = targetId;\n      if (orderBy) params.orderBy = orderBy;\n      return datasetId ? client.listDatasetExperiments(datasetId, params) : client.listExperiments(params);\n    },\n    initialPageParam: 0,\n    getNextPageParam: (lastPage, _, lastPageParam) => {\n      if (!lastPage?.experiments?.length || !lastPage.pagination?.hasMore) {\n        return undefined;\n      }\n      return lastPageParam + 1;\n    },\n    select: (data: InfiniteData<ListExperimentsResponse, number>) =>\n      data.pages.flatMap(page => page?.experiments ?? []) as TData,\n    ...queryOptions,\n  });\n\n  useEffect(() => {\n    if (isEndOfListInView && query.hasNextPage && !query.isFetchingNextPage) {\n      void query.fetchNextPage();\n    }\n  }, [isEndOfListInView, query]);\n\n  return { ...query, setEndOfListElement };\n}\n"],"mappings":"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"}

package/dist/hooks/experiments/use-experiment-metrics.d.ts

@@ -0,0 +1,30 @@
+import type { DatasetExperiment } from '@mastra/client-js';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+export interface ExperimentMetrics {
+    totalTokens: number | null;
+    estimatedCost: number | null;
+    costUnit: string | null;
+    avgAgentDurationMs: number | null;
+    agentRuns: number | null;
+}
+interface UseExperimentMetricsArgs {
+    experimentId: string | undefined;
+    experimentStatus: DatasetExperiment['status'] | undefined;
+    /** Whether the observability store can serve metrics; no requests are made when false. */
+    supportsMetrics: boolean;
+    queryOptions?: MastraQueryOptions<ExperimentMetrics>;
+}
+/**
+ * Experiment-scoped metrics (tokens, cost, avg agent latency).
+ * Filters only by experimentId — no time window, since the experiment already bounds the row set.
+ * Polls every 2 seconds while the experiment is running or pending.
+ *
+ * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+ */
+export declare const useExperimentMetrics: ({ experimentId, experimentStatus, supportsMetrics, queryOptions, }: UseExperimentMetricsArgs) => {
+    data: ExperimentMetrics | undefined;
+    isLoading: boolean;
+    isEnabled: boolean;
+};
+export {};
+//# sourceMappingURL=use-experiment-metrics.d.ts.map

package/dist/hooks/experiments/use-experiment-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-experiment-metrics.d.ts","sourceRoot":"","sources":["../../../src/hooks/experiments/use-experiment-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,UAAU,wBAAwB;IAChC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,gBAAgB,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAC1D,0FAA0F;IAC1F,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;CACtD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,uEAK9B,wBAAwB;;;;CAmC1B,CAAC"}

package/dist/hooks/experiments/use-experiment-trace.d.ts

@@ -0,0 +1,13 @@
+import type { MastraClient } from '@mastra/client-js';
+import type { UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+type TraceLightResponse = Awaited<ReturnType<MastraClient['getTraceLight']>>;
+/**
+ * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+ */
+export declare const useExperimentTrace: <TData = TraceLightResponse>({ traceId, queryOptions, }: {
+    traceId: string | null | undefined;
+    queryOptions?: MastraQueryOptions<TraceLightResponse, TData>;
+}) => UseQueryResult<TData, Error>;
+export {};
+//# sourceMappingURL=use-experiment-trace.d.ts.map

package/dist/hooks/experiments/use-experiment-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-experiment-trace.d.ts","sourceRoot":"","sources":["../../../src/hooks/experiments/use-experiment-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,KAAK,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,GAAG,kBAAkB,8BAG1D;IACD,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,YAAY,CAAC,EAAE,kBAAkB,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;CAC9D,KAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAa9B,CAAC"}