@mastra/react 1.13.0-alpha.3 → 1.13.0-alpha.5

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/traces/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,GACjC,MAAM,6BAA6B,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/traces/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,GACjC,MAAM,6BAA6B,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC"}

package/dist/hooks/traces/index.js

@@ -1,13 +1,13 @@
-import { n as useMastraClient } from "../../mastra-client-context-Bx_g84YB.js";
-import { t as useInView } from "../../use-in-view-C9sYPGRm.js";
-import { t as getOrCreate } from "../../map-CDv4fbu4.js";
-import { n as is403ForbiddenError } from "../../query-utils-D1NgFnWU.js";
-import { t as getFeedbackRefetchInterval } from "../../feedback-refetch-interval-DLHzQoVV.js";
+import { n as useMastraClient } from "../../mastra-client-context-DQ5z_ze9.js";
+import { t as useInView } from "../../use-in-view-CyjKdplM.js";
+import { n as is403ForbiddenError } from "../../query-utils-DvMERIwf.js";
+import { t as getFeedbackRefetchInterval } from "../../feedback-refetch-interval-C12Nzb2r.js";
+import { t as getOrCreate } from "../../map-5-4U5rwA.js";
 import { MastraClient, MastraClientError } from "@mastra/client-js";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { keepPreviousData, queryOptions, skipToken, useInfiniteQuery, useMutation, useQueries, useQuery, useQueryClient } from "@tanstack/react-query";
 import { EntityType } from "@mastra/core/observability";
-//#region src/hooks/traces/discovery-cache.ts
+// src/hooks/traces/discovery-cache.ts
 /**
 * How long discovery results (tags, environments, service names, entity
 * names) stay fresh on the client.
@@ -19,8 +19,7 @@ import { EntityType } from "@mastra/core/observability";
 * client from asking more often than the answer can change.
 */
 const DISCOVERY_STALE_TIME = 3e5;
-//#endregion
-//#region src/hooks/traces/use-branch.ts
+// src/hooks/traces/use-branch.ts
 /**
 * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
 */
@@ -45,8 +44,7 @@ function useBranch({ traceId, spanId, depth, queryOptions }) {
 		...queryOptions
 	});
 }
-//#endregion
-//#region src/hooks/traces/types.ts
+// src/hooks/traces/types.ts
 const ROOT_ENTITY_TYPES = {
 	AGENT: "agent",
 	WORKFLOW: "workflow_run",
@@ -54,8 +52,7 @@ const ROOT_ENTITY_TYPES = {
 	INGEST: "rag_ingestion",
 	CLASSIFIER: "classifier"
 };
-//#endregion
-//#region src/hooks/traces/use-entity-names.ts
+// src/hooks/traces/use-entity-names.ts
 function resolveEntityType(entityType) {
 	return Object.values(EntityType).find((candidate) => candidate === entityType);
 }
@@ -95,8 +92,7 @@ const useEntityNames = ({ entityType, rootOnly = false, queryOptions } = {}) =>
 		...queryOptions
 	});
 };
-//#endregion
-//#region src/hooks/traces/use-environments.ts
+// src/hooks/traces/use-environments.ts
 const useEnvironments = ({ queryOptions } = {}) => {
 	const client = useMastraClient();
 	return useQuery({
@@ -114,8 +110,7 @@ const useEnvironments = ({ queryOptions } = {}) => {
 		...queryOptions
 	});
 };
-//#endregion
-//#region src/hooks/traces/use-service-names.ts
+// src/hooks/traces/use-service-names.ts
 const useServiceNames = ({ queryOptions } = {}) => {
 	const client = useMastraClient();
 	return useQuery({
@@ -133,8 +128,7 @@ const useServiceNames = ({ queryOptions } = {}) => {
 		...queryOptions
 	});
 };
-//#endregion
-//#region src/hooks/traces/use-span-detail.ts
+// src/hooks/traces/use-span-detail.ts
 const IMMUTABLE_CACHE_TIME$1 = 2592e6;
 /**
 * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
@@ -158,8 +152,7 @@ function useSpanDetail({ traceId, spanId, queryOptions }) {
 		...queryOptions
 	});
 }
-//#endregion
-//#region src/hooks/traces/use-tags.ts
+// src/hooks/traces/use-tags.ts
 const useTags = ({ queryOptions } = {}) => {
 	const client = useMastraClient();
 	return useQuery({
@@ -177,8 +170,7 @@ const useTags = ({ queryOptions } = {}) => {
 		...queryOptions
 	});
 };
-//#endregion
-//#region src/hooks/traces/use-thread-has-other-traces.ts
+// src/hooks/traces/use-thread-has-other-traces.ts
 /**
 * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
 */
@@ -198,8 +190,7 @@ function useThreadHasOtherTraces({ threadId, queryOptions }) {
 	});
 	return data ?? false;
 }
-//#endregion
-//#region src/hooks/traces/use-trace-light-spans.ts
+// src/hooks/traces/use-trace-light-spans.ts
 const IMMUTABLE_CACHE_TIME = 2592e6;
 /**
 * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
@@ -219,8 +210,7 @@ function useTraceLightSpans({ traceId, queryOptions }) {
 		...queryOptions
 	});
 }
-//#endregion
-//#region src/hooks/traces/use-trace-spans.ts
+// src/hooks/traces/use-trace-spans.ts
 const traceSpansQueryOptions = (client, traceId) => queryOptions({
 	queryKey: ["trace-spans", traceId],
 	queryFn: async () => {
@@ -273,8 +263,7 @@ function useTraceSpansQueries({ traceIds, select, fallback, queryOptions }) {
 		combine: (results) => results.map((result, index) => result.data === void 0 ? fallback(traceIds[index] ?? "") : result.data)
 	});
 }
-//#endregion
-//#region src/hooks/traces/use-trace-or-branch-spans.ts
+// src/hooks/traces/use-trace-or-branch-spans.ts
 /**
 * Unified data source for the trace/span detail panel. Returns trace spans (full tree from the
 * root) in traces mode, or branch spans (subtree rooted at `anchorSpanId`) in branches mode.
@@ -316,8 +305,44 @@ function useTraceOrBranchSpans({ traceId, anchorSpanId, listMode, depth, queryOp
 		error: traceQuery.error
 	};
 }
-//#endregion
-//#region src/hooks/traces/use-trace-query.ts
+// src/hooks/traces/use-span-aggregate.ts
+/**
+* Runs `aggregateSpans()` for `request`. Check `useSpanAggregateAvailable()` before enabling it.
+*
+* Like `useTraceAggregate()`, it doesn't poll or retry: the client already retries server errors,
+* and a rejected request (4xx) fails once.
+*/
+function useSpanAggregate({ request, enabled = true, queryOptions }) {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: ["span-aggregate", request],
+		queryFn: () => client.aggregateSpans(request),
+		enabled,
+		retry: false,
+		refetchOnWindowFocus: false,
+		...queryOptions
+	});
+}
+// src/hooks/traces/use-trace-aggregate.ts
+/**
+* Runs `aggregateTraces()` for `request`. Check `useTraceAggregateAvailable()` before enabling it.
+*
+* It doesn't poll: grouped requests over large tenants take seconds, so it refetches only when the
+* request changes or the caller calls `refetch()`. The client already retries server errors, so
+* React Query doesn't retry on top of it, and a rejected request (4xx) fails once.
+*/
+function useTraceAggregate({ request, enabled = true, queryOptions }) {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: ["trace-aggregate", request],
+		queryFn: ({ signal }) => client.aggregateTraces(request, { signal }),
+		enabled,
+		retry: false,
+		refetchOnWindowFocus: false,
+		...queryOptions
+	});
+}
+// src/hooks/traces/use-trace-query.ts
 const TRACE_QUERY_PER_PAGE = 25;
 /** Max traces per delta request; the server caps `limit` at 100. */
 const TRACE_QUERY_DELTA_LIMIT = 100;
@@ -626,8 +651,7 @@ function useTraceQueryLatest({ query, limit = 25, enabled = true, refetchInterva
 		...queryOptions
 	});
 }
-//#endregion
-//#region src/hooks/traces/use-query-spans.ts
+// src/hooks/traces/use-query-spans.ts
 const SPAN_QUERY_PER_PAGE = 25;
 const selectSpans = (data) => data.pages.flatMap((page) => page.spans);
 /** Queries completed spans with cursor pagination and viewport-driven loading. */
@@ -678,8 +702,7 @@ function useQuerySpans({ query, limit = 25, enabled = true, queryOptions }) {
 		refetch: () => void refetch()
 	};
 }
-//#endregion
-//#region src/hooks/traces/use-query-threads.ts
+// src/hooks/traces/use-query-threads.ts
 const THREAD_QUERY_PER_PAGE = 25;
 const selectThreads = (data) => data.pages.flatMap((page) => page.threads);
 /** Queries thread rows with cursor pagination and viewport-driven loading. */
@@ -730,8 +753,7 @@ function useQueryThreads({ query, limit = 25, enabled = true, queryOptions }) {
 		refetch: () => void refetch()
 	};
 }
-//#endregion
-//#region src/hooks/traces/use-trace-usage.ts
+// src/hooks/traces/use-trace-usage.ts
 const INPUT_TOKEN_METRIC = "mastra_model_total_input_tokens";
 const OUTPUT_TOKEN_METRIC = "mastra_model_total_output_tokens";
 const TRACE_IDS_PER_REQUEST = 500;
@@ -807,8 +829,7 @@ function useTraceUsage({ traceIds, enabled, autoRefetch, queryOptions }) {
 		...queryOptions
 	});
 }
-//#endregion
-//#region src/hooks/traces/use-traces.tsx
+// src/hooks/traces/use-traces.tsx
 const deltaSupportByClient = /* @__PURE__ */ new WeakMap();
 const lightListSupportByClient = /* @__PURE__ */ new WeakMap();
 /** When the current run of light-endpoint 500s started, per client. Cleared by any light success. */
@@ -1198,8 +1219,7 @@ const useTraces = ({ filters, listMode = "traces", polling = {}, enabled = true,
 		recentlyAddedKeys
 	};
 };
-//#endregion
-//#region src/hooks/traces/use-create-feedback.tsx
+// src/hooks/traces/use-create-feedback.tsx
 /**
 * Submits a free-text comment as a feedback record, scoped to the trace or to a
 * single span, then invalidates the matching feedback list so it refreshes.
@@ -1223,8 +1243,7 @@ const useCreateFeedback = ({ traceId, spanId, queryOptions }) => {
 		...queryOptions
 	});
 };
-//#endregion
-//#region src/hooks/traces/use-delete-feedback.tsx
+// src/hooks/traces/use-delete-feedback.tsx
 /**
 * Deletes a single feedback record by id, then invalidates the matching
 * feedback list (trace- or span-scoped) so it refreshes.
@@ -1242,8 +1261,7 @@ const useDeleteFeedback = ({ traceId, spanId, queryOptions }) => {
 		...queryOptions
 	});
 };
-//#endregion
-//#region src/hooks/traces/use-span-feedback.tsx
+// src/hooks/traces/use-span-feedback.tsx
 /**
 * Feedback scoped to a single span. Both identifiers are required: without a `spanId`
 * the query stays disabled rather than falling back to trace-wide feedback.
@@ -1276,8 +1294,7 @@ const useSpanFeedback = ({ traceId = "", spanId = "", page, queryOptions }) => {
 		...queryOptions
 	});
 };
-//#endregion
-//#region src/hooks/traces/use-trace-feedback.tsx
+// src/hooks/traces/use-trace-feedback.tsx
 /** Loads a page of trace-level feedback and stops polling when storage cannot serve feedback. */
 /**
 * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
@@ -1319,8 +1336,7 @@ const useTraceFeedback = ({ traceId = "", page, queryOptions }) => {
 		...queryOptions
 	});
 };
-//#endregion
-//#region src/hooks/traces/use-trace-metadata-filter-fields.ts
+// src/hooks/traces/use-trace-metadata-filter-fields.ts
 const DISCOVERY_LIMIT = 100;
 const EMPTY_FIELDS = {
 	canonicalFields: [],
@@ -1393,17 +1409,16 @@ const useTraceMetadataFilterFields = ({ timeRange, queryOptions }) => {
 		error: query.error
 	};
 };
-//#endregion
-//#region src/hooks/traces/use-trace-column-preferences-storage-key.ts
+// src/hooks/traces/use-trace-column-preferences-storage-key.ts
 /**
 * Storage key for the trace list column preferences, scoped to the Mastra server the client
-* talks to so each project keeps its own column layout.
+* talks to so each project keeps its own column layout, and to the list (traces or spans)
+* so each list keeps its own selection.
 */
-function useTraceColumnPreferencesStorageKey() {
+function useTraceColumnPreferencesStorageKey(scope = "traces") {
 	const client = useMastraClient();
-	return `mastra:traces:columns:${client.options.baseUrl || (typeof window === "undefined" ? "local" : window.location.origin || "local")}:${client.options.apiPrefix ?? "/api"}`;
+	return `mastra:${scope}:columns:${client.options.baseUrl || (typeof window === "undefined" ? "local" : window.location.origin || "local")}:${client.options.apiPrefix ?? "/api"}`;
 }
-//#endregion
-export { DISCOVERY_STALE_TIME, ROOT_ENTITY_TYPES, SPAN_QUERY_PER_PAGE, THREAD_QUERY_PER_PAGE, TRACES_PER_PAGE, TRACE_QUERY_DELTA_LIMIT, TRACE_QUERY_PER_PAGE, createTraceQueryValuesResolver, getLegacyTraceQueryNextPageParam, getTraceQueryNextPageParam, getTracesNextPageParam, lightSpanToTraceQueryTrace, mergeDeltaIntoPage0, mergeTraceQueryDelta, refreshPage0Rows, selectLegacyTraceQueryTraces, selectTraceQueryTraces, selectUniqueTraces, shouldPinLightList, shouldResetAfterIdle, traceQueryFieldsQueryKey, traceQueryKey, traceSpansQueryOptions, useBranch, useCreateFeedback, useDeleteFeedback, useEntityNames, useEnvironments, useFetchTraceSpans, useQuerySpans, useQueryThreads, useServiceNames, useSpanDetail, useSpanFeedback, useTags, useThreadHasOtherTraces, useTraceColumnPreferencesStorageKey, useTraceFeedback, useTraceLightSpans, useTraceMetadataFilterFields, useTraceOrBranchSpans, useTraceQuery, useTraceQueryLatest, useTraceSpans, useTraceSpansQueries, useTraceUsage, useTraces };
+export { DISCOVERY_STALE_TIME, ROOT_ENTITY_TYPES, SPAN_QUERY_PER_PAGE, THREAD_QUERY_PER_PAGE, TRACES_PER_PAGE, TRACE_QUERY_DELTA_LIMIT, TRACE_QUERY_PER_PAGE, createTraceQueryValuesResolver, getLegacyTraceQueryNextPageParam, getTraceQueryNextPageParam, getTracesNextPageParam, lightSpanToTraceQueryTrace, mergeDeltaIntoPage0, mergeTraceQueryDelta, refreshPage0Rows, selectLegacyTraceQueryTraces, selectTraceQueryTraces, selectUniqueTraces, shouldPinLightList, shouldResetAfterIdle, traceQueryFieldsQueryKey, traceQueryKey, traceSpansQueryOptions, useBranch, useCreateFeedback, useDeleteFeedback, useEntityNames, useEnvironments, useFetchTraceSpans, useQuerySpans, useQueryThreads, useServiceNames, useSpanAggregate, useSpanDetail, useSpanFeedback, useTags, useThreadHasOtherTraces, useTraceAggregate, useTraceColumnPreferencesStorageKey, useTraceFeedback, useTraceLightSpans, useTraceMetadataFilterFields, useTraceOrBranchSpans, useTraceQuery, useTraceQueryLatest, useTraceSpans, useTraceSpansQueries, useTraceUsage, useTraces };
 
 //# sourceMappingURL=index.js.map