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

package/dist/hooks/traces/use-trace-or-branch-spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trace-or-branch-spans.d.ts","sourceRoot":"","sources":["../../../src/hooks/traces/use-trace-or-branch-spans.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC;;2FAEuF;IACvF,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,kBAAkB,CAAC,cAAc,EAAE,cAAc,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QAC1F,MAAM,CAAC,EAAE,kBAAkB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;KAC7D,CAAC;CACH;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC;IACrC,wFAAwF;IACxF,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,KAAK,EACL,YAAY,GACb,EAAE,yBAAyB,GAAG,2BAA2B,CA+BzD"}

package/dist/hooks/traces/use-trace-query.d.ts

@@ -0,0 +1,57 @@
+import { MastraClient } from '@mastra/client-js';
+import type { QueryTracesKeysetInput, TraceQueryKeysetTraceResponse } from '@mastra/client-js';
+import type { ListTracesArgs as StorageListTracesArgs } from '@mastra/core/storage';
+import type { MastraInfiniteQueryOptions } from '../shared/query-options.js';
+export declare const TRACE_QUERY_PER_PAGE = 25;
+type TraceQueryTrace = TraceQueryKeysetTraceResponse['traces'][number];
+type LegacyTraceListFilters = StorageListTracesArgs['filters'];
+type ListTracesLightResponse = Awaited<ReturnType<MastraClient['listTracesLight']>>;
+type LightSpanRecord = ListTracesLightResponse['spans'][number];
+export type TraceQueryArgs = Omit<QueryTracesKeysetInput, 'page' | 'pagination'>;
+export interface UseTraceQueryArgs {
+    query: TraceQueryArgs | undefined;
+    limit?: number;
+    enabled?: boolean;
+    /** When false, lists traces through the legacy `listTracesLight` endpoint instead of the trace-query API. */
+    withQueryTrace?: boolean;
+    /** Filters for the legacy endpoint, as built by `buildTraceListFilters`. Only read when `withQueryTrace` is false. */
+    legacyFilters?: LegacyTraceListFilters;
+    /** TanStack options spread last into the trace-query (`traceQuery`) and legacy (`legacy`) infinite queries. */
+    queryOptions?: {
+        traceQuery?: MastraInfiniteQueryOptions<TraceQueryKeysetTraceResponse, TraceQueryTrace[], readonly unknown[], string | undefined>;
+        legacy?: MastraInfiniteQueryOptions<ListTracesLightResponse, TraceQueryTrace[], readonly unknown[], number>;
+    };
+}
+export interface UseTraceQueryReturn {
+    data: TraceQueryTrace[] | undefined;
+    hasNextPage: boolean;
+    isFetchingNextPage: boolean;
+    fetchNextPage: () => void;
+    isLoading: boolean;
+    /** The rows belong to the previous query key (e.g. another thread) while the new one loads. */
+    isPlaceholderData: boolean;
+    isFetching: boolean;
+    isRefetching: boolean;
+    fetchStatus: 'idle' | 'fetching' | 'paused';
+    isError: boolean;
+    error: Error | null;
+    refetch: () => void;
+    setEndOfListElement: (node: HTMLDivElement | null) => void;
+}
+export declare function getTraceQueryNextPageParam(lastPage: TraceQueryKeysetTraceResponse | undefined): string | undefined;
+export declare function selectTraceQueryTraces(data: {
+    pages: TraceQueryKeysetTraceResponse[];
+}): TraceQueryTrace[];
+/** Maps a legacy light root span to a trace-query row. The light record carries no
+ *  environment, so it stays null. Running spans have no `endedAt` and may carry a
+ *  status outside the query API's enum; both are kept as-is (the list view handles them), hence the
+ *  assertion at this compatibility boundary. */
+export declare function lightSpanToTraceQueryTrace(span: LightSpanRecord): TraceQueryTrace;
+export declare function selectLegacyTraceQueryTraces(data: {
+    pages: ListTracesLightResponse[];
+}): TraceQueryTrace[];
+export declare function getLegacyTraceQueryNextPageParam(lastPage: ListTracesLightResponse): number | undefined;
+/** Queries traces with cursor pagination and viewport-driven loading. */
+export declare function useTraceQuery({ query, limit, enabled, withQueryTrace, legacyFilters, queryOptions, }: UseTraceQueryArgs): UseTraceQueryReturn;
+export {};
+//# sourceMappingURL=use-trace-query.d.ts.map

package/dist/hooks/traces/use-trace-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trace-query.d.ts","sourceRoot":"","sources":["../../../src/hooks/traces/use-trace-query.ts"],"names":[],"mappings":"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"}

package/dist/hooks/traces/use-trace-spans.d.ts

@@ -0,0 +1,46 @@
+import type { MastraClient } from '@mastra/client-js';
+import type { UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+/**
+ * Key, fetcher and stale policy of the `trace-spans` query. Every observer of this key must
+ * share these (rather than only the key) so one observer with a stricter `staleTime` does not
+ * refetch data another one considers fresh.
+ */
+type TraceResponse = Awaited<ReturnType<MastraClient['getTrace']>>;
+export declare const traceSpansQueryOptions: (client: MastraClient, traceId: string | null | undefined) => UseQueryOptions<TraceResponse, Error, TraceResponse, (string | null | undefined)[]>;
+/**
+ * Every span of a single trace, with its full payload.
+ *
+ * The lightweight projection exists to keep blob columns off the read path of a
+ * *list*, where the cost is paid once per trace on screen. A trace that is open
+ * has already narrowed that to one, and the panel both renders and searches
+ * these spans -- `input`, `output` and `attributes` included -- so the
+ * projection would only hide content the reader is looking at.
+ */
+export type TraceSpansData = Awaited<ReturnType<MastraClient['getTrace']>>;
+/**
+ * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+ */
+export declare function useTraceSpans<TData = TraceSpansData>({ traceId, passive, queryOptions, }: {
+    traceId: string | null | undefined;
+    passive?: boolean;
+    queryOptions?: MastraQueryOptions<TraceSpansData, TData, (string | null | undefined)[]>;
+}): UseQueryResult<TData>;
+/**
+ * Returns a function that loads a full trace through the shared `trace-spans` cache, so an
+ * imperative read (e.g. an export) and the trace panel always see the same payload.
+ */
+export declare function useFetchTraceSpans(): (traceId: string) => Promise<TraceSpansData>;
+/**
+ * Observes the `trace-spans` query of several traces at once and projects each one with `select`.
+ * Traces still loading (or failed) yield `fallback(traceId)` so the result always lines up with `traceIds`.
+ */
+export declare function useTraceSpansQueries<T>({ traceIds, select, fallback, queryOptions, }: {
+    traceIds: string[];
+    select: (traceId: string, data: TraceSpansData) => T;
+    fallback: (traceId: string) => T;
+    /** Applied to every per-trace query. */
+    queryOptions?: MastraQueryOptions<TraceSpansData, T, (string | null | undefined)[]>;
+}): T[];
+export {};
+//# sourceMappingURL=use-trace-spans.d.ts.map

package/dist/hooks/traces/use-trace-spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trace-spans.d.ts","sourceRoot":"","sources":["../../../src/hooks/traces/use-trace-spans.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;;;GAIG;AACH,KAAK,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAEnE,eAAO,MAAM,sBAAsB,WACzB,YAAY,WACX,MAAM,GAAG,IAAI,GAAG,SAAS,KACjC,eAAe,CAAC,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAYjF,CAAC;AAEL;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAE3E;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAG,cAAc,EAAE,EACpD,OAAO,EACP,OAAe,EACf,YAAY,GACb,EAAE;IACD,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,kBAAkB,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;CACzF,GAAG,cAAc,CAAC,KAAK,CAAC,CAgBxB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAKjF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,EACtC,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,YAAY,GACb,EAAE;IACD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,KAAK,CAAC,CAAC;IACrD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,CAAC,CAAC;IACjC,wCAAwC;IACxC,YAAY,CAAC,EAAE,kBAAkB,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;CACrF,GAAG,CAAC,EAAE,CAiBN"}

package/dist/hooks/traces/use-trace-usage.d.ts

@@ -0,0 +1,10 @@
+import type { UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+import type { TraceUsageSummary } from './types.js';
+export declare function useTraceUsage<TData = Map<string, TraceUsageSummary>>({ traceIds, enabled, autoRefetch, queryOptions, }: {
+    traceIds: readonly string[];
+    enabled: boolean;
+    autoRefetch: boolean;
+    queryOptions?: MastraQueryOptions<Map<string, TraceUsageSummary>, TData>;
+}): UseQueryResult<TData, Error>;
+//# sourceMappingURL=use-trace-usage.d.ts.map

package/dist/hooks/traces/use-trace-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trace-usage.d.ts","sourceRoot":"","sources":["../../../src/hooks/traces/use-trace-usage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAwEjD,wBAAgB,aAAa,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,EACpE,QAAQ,EACR,OAAO,EACP,WAAW,EACX,YAAY,GACb,EAAE;IACD,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,KAAK,CAAC,CAAC;CAC1E,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAqC/B"}

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

@@ -0,0 +1,292 @@
+import type { MastraClient } from '@mastra/client-js';
+import type { InfiniteData } from '@tanstack/react-query';
+import { useMastraClient } from '../../mastra-client-context.js';
+import type { MastraInfiniteQueryOptions, MastraQueryOptions } from '../shared/query-options.js';
+import type { TraceListMode } from './types.js';
+type ListBranchesArgs = NonNullable<Parameters<MastraClient['listBranches']>[0]>;
+type ListBranchesResponse = Awaited<ReturnType<MastraClient['listBranches']>>;
+type ListTracesArgs = NonNullable<Parameters<MastraClient['listTraces']>[0]>;
+type ListTracesLightResponse = Awaited<ReturnType<MastraClient['listTracesLight']>>;
+type LightSpanRecord = ListTracesLightResponse['spans'][number] | ListBranchesResponse['branches'][number];
+/** Tunables for live-tail polling. All fields optional — defaults below.
+ *  Platform consumers override individual fields to throttle traffic or
+ *  reshape the freshness/visibility trade-offs. */
+export interface TracesPollingConfig {
+    /** Interval between delta polls. Default 5_000ms. */
+    deltaPollIntervalMs?: number;
+    /** Refetch delay when the server signals `delta.hasMore` (chase remaining updates immediately). Default 100ms. */
+    deltaChaseIntervalMs?: number;
+    /** Max rows per delta poll. Server caps at 100. Default 100. */
+    deltaLimit?: number;
+    /** Page-mode refetch interval used when the configured store does not support delta polling. Default 10_000ms. */
+    pageModeRefetchIntervalMs?: number;
+    /** Periodic page-0 refetch interval while delta is active. Delta only delivers new rows, so this
+     *  is how we surface status flips (running → success/error) on rows already visible. Default 60_000ms. */
+    page0StatusRefreshIntervalMs?: number;
+    /** When the tab returns from being hidden and the last successful poll was older than this, the
+     *  cursor is treated as stale (ClickHouse delta tables TTL after 2 days; other stores may be more
+     *  aggressive). The infinite query is reset so page 0 refetches and delta resumes from a fresh
+     *  cursor. Default 900_000ms (15 min). */
+    idleGuardThresholdMs?: number;
+    /** Minimum visible duration for `isRefetching` after any query completes. On localhost a delta
+     *  poll can resolve in tens of ms — too brief for the spinner's 1s rotation to register visually,
+     *  and quick enough that React may batch the start/finish transitions. Pulsing for this duration
+     *  on completion (~144° of rotation at 400ms) makes each poll perceptible as a heartbeat.
+     *  Default 400ms. */
+    minRefetchSpinMs?: number;
+    /** Window during which a delta-arrived row's key stays in `recentlyAddedKeys` so the list view
+     *  can apply its `animate-row-highlight` class. Should match the CSS animation duration
+     *  (currently 1_000ms — see `index.css`). Default 1_000ms. */
+    deltaHighlightMs?: number;
+}
+/** Returns true when the cursor should be considered stale and re-seeded.
+ *  Exported for testing — pure function of timestamps. */
+export declare function shouldResetAfterIdle(lastSuccessAt: number, now: number, thresholdMs: number): boolean;
+/** Whether a failed light-list request should pin the session to the full endpoint.
+ *  `firstServerErrorAt` is undefined when this 500 opens a new run of them, so a single
+ *  fault never pins. Exported for testing — pure function of the status and timestamps. */
+export declare function shouldPinLightList(status: number | undefined, firstServerErrorAt: number | undefined, now: number): boolean;
+type FetchTracesFnArgs = TracesFilters & {
+    client: ReturnType<typeof useMastraClient>;
+} & ({
+    mode: 'delta';
+    after?: string;
+    limit?: number;
+} | {
+    mode?: 'page';
+    page: number;
+    perPage: number;
+});
+declare const fetchTracesFn: (args: FetchTracesFnArgs) => Promise<{
+    pagination?: {
+        total: number;
+        page: number;
+        perPage: number | false;
+        hasMore: boolean;
+    } | undefined;
+    delta?: {
+        limit: number;
+        hasMore: boolean;
+    } | undefined;
+    deltaCursor?: string | undefined;
+    branches: {
+        traceId: string;
+        spanId: string;
+        name: string;
+        spanType: "agent_run" | "agent_signal" | "classifier_evaluation" | "client_tool_call" | "generic" | "graph_action" | "mapping" | "mcp_server_request" | "mcp_tool_call" | "memory_operation" | "model_chunk" | "model_generation" | "model_inference" | "model_step" | "processor_run" | "provider_tool_call" | "rag_action" | "rag_embedding" | "rag_ingestion" | "rag_vector_operation" | "scorer_run" | "scorer_step" | "skill_action" | "skill_resolution" | "tool_call" | "workflow_conditional" | "workflow_conditional_eval" | "workflow_loop" | "workflow_parallel" | "workflow_run" | "workflow_sleep" | "workflow_step" | "workflow_wait_event" | "workspace_action";
+        isEvent: boolean;
+        startedAt: string;
+        parentSpanId?: (string | null) | undefined;
+        entityType?: (("agent" | "input_processor" | "input_step_processor" | "mcp_server" | "memory" | "output_processor" | "output_step_processor" | "rag_ingestion" | "scorer" | "tool" | "tool_result_processor" | "trajectory" | "workflow_run" | "workflow_step") | null) | undefined;
+        entityId?: (string | null) | undefined;
+        entityName?: (string | null) | undefined;
+        parentEntityType?: (("agent" | "input_processor" | "input_step_processor" | "mcp_server" | "memory" | "output_processor" | "output_step_processor" | "rag_ingestion" | "scorer" | "tool" | "tool_result_processor" | "trajectory" | "workflow_run" | "workflow_step") | null) | undefined;
+        parentEntityId?: (string | null) | undefined;
+        parentEntityName?: (string | null) | undefined;
+        rootEntityType?: (("agent" | "input_processor" | "input_step_processor" | "mcp_server" | "memory" | "output_processor" | "output_step_processor" | "rag_ingestion" | "scorer" | "tool" | "tool_result_processor" | "trajectory" | "workflow_run" | "workflow_step") | null) | undefined;
+        rootEntityId?: (string | null) | undefined;
+        rootEntityName?: (string | null) | undefined;
+        userId?: (string | null) | undefined;
+        organizationId?: (string | null) | undefined;
+        resourceId?: (string | null) | undefined;
+        runId?: (string | null) | undefined;
+        sessionId?: (string | null) | undefined;
+        threadId?: (string | null) | undefined;
+        requestId?: (string | null) | undefined;
+        environment?: (string | null) | undefined;
+        serviceName?: (string | null) | undefined;
+        scope?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        entityVersionId?: (string | null) | undefined;
+        parentEntityVersionId?: (string | null) | undefined;
+        rootEntityVersionId?: (string | null) | undefined;
+        experimentId?: (string | null) | undefined;
+        source?: (string | null) | undefined;
+        metadata?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        tags?: (string[] | null) | undefined;
+        attributes?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        links?: (unknown[] | null) | undefined;
+        input?: (unknown | null) | undefined;
+        output?: (unknown | null) | undefined;
+        error?: (unknown | null) | undefined;
+        endedAt?: string | null | undefined;
+        requestContext?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        createdAt: string;
+        updatedAt: string | null;
+        status: 'success' | 'error' | 'running';
+    }[];
+} | {
+    pagination?: {
+        total: number;
+        page: number;
+        perPage: number | false;
+        hasMore: boolean;
+    } | undefined;
+    delta?: {
+        limit: number;
+        hasMore: boolean;
+    } | undefined;
+    deltaCursor?: string | undefined;
+    spans: {
+        traceId: string;
+        spanId: string;
+        name: string;
+        spanType: "agent_run" | "agent_signal" | "classifier_evaluation" | "client_tool_call" | "generic" | "graph_action" | "mapping" | "mcp_server_request" | "mcp_tool_call" | "memory_operation" | "model_chunk" | "model_generation" | "model_inference" | "model_step" | "processor_run" | "provider_tool_call" | "rag_action" | "rag_embedding" | "rag_ingestion" | "rag_vector_operation" | "scorer_run" | "scorer_step" | "skill_action" | "skill_resolution" | "tool_call" | "workflow_conditional" | "workflow_conditional_eval" | "workflow_loop" | "workflow_parallel" | "workflow_run" | "workflow_sleep" | "workflow_step" | "workflow_wait_event" | "workspace_action";
+        isEvent: boolean;
+        startedAt: string;
+        parentSpanId?: (string | null) | undefined;
+        endedAt?: string | null | undefined;
+        error?: (unknown | null) | undefined;
+        status?: (('success' | 'error' | 'running') | null) | undefined;
+        entityType?: (("agent" | "input_processor" | "input_step_processor" | "mcp_server" | "memory" | "output_processor" | "output_step_processor" | "rag_ingestion" | "scorer" | "tool" | "tool_result_processor" | "trajectory" | "workflow_run" | "workflow_step") | null) | undefined;
+        entityId?: (string | null) | undefined;
+        entityName?: (string | null) | undefined;
+        threadId?: ((string | null) | undefined) | null;
+        resourceId?: ((string | null) | undefined) | null;
+        metadata?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        inputPreview?: (string | null) | undefined;
+        createdAt: string;
+        updatedAt: string | null;
+    }[];
+} | {
+    pagination?: {
+        total: number;
+        page: number;
+        perPage: number | false;
+        hasMore: boolean;
+    } | undefined;
+    delta?: {
+        limit: number;
+        hasMore: boolean;
+    } | undefined;
+    deltaCursor?: string | undefined;
+    spans: {
+        traceId: string;
+        spanId: string;
+        name: string;
+        spanType: "agent_run" | "agent_signal" | "classifier_evaluation" | "client_tool_call" | "generic" | "graph_action" | "mapping" | "mcp_server_request" | "mcp_tool_call" | "memory_operation" | "model_chunk" | "model_generation" | "model_inference" | "model_step" | "processor_run" | "provider_tool_call" | "rag_action" | "rag_embedding" | "rag_ingestion" | "rag_vector_operation" | "scorer_run" | "scorer_step" | "skill_action" | "skill_resolution" | "tool_call" | "workflow_conditional" | "workflow_conditional_eval" | "workflow_loop" | "workflow_parallel" | "workflow_run" | "workflow_sleep" | "workflow_step" | "workflow_wait_event" | "workspace_action";
+        isEvent: boolean;
+        startedAt: string;
+        parentSpanId?: (string | null) | undefined;
+        entityType?: (("agent" | "input_processor" | "input_step_processor" | "mcp_server" | "memory" | "output_processor" | "output_step_processor" | "rag_ingestion" | "scorer" | "tool" | "tool_result_processor" | "trajectory" | "workflow_run" | "workflow_step") | null) | undefined;
+        entityId?: (string | null) | undefined;
+        entityName?: (string | null) | undefined;
+        parentEntityType?: (("agent" | "input_processor" | "input_step_processor" | "mcp_server" | "memory" | "output_processor" | "output_step_processor" | "rag_ingestion" | "scorer" | "tool" | "tool_result_processor" | "trajectory" | "workflow_run" | "workflow_step") | null) | undefined;
+        parentEntityId?: (string | null) | undefined;
+        parentEntityName?: (string | null) | undefined;
+        rootEntityType?: (("agent" | "input_processor" | "input_step_processor" | "mcp_server" | "memory" | "output_processor" | "output_step_processor" | "rag_ingestion" | "scorer" | "tool" | "tool_result_processor" | "trajectory" | "workflow_run" | "workflow_step") | null) | undefined;
+        rootEntityId?: (string | null) | undefined;
+        rootEntityName?: (string | null) | undefined;
+        userId?: (string | null) | undefined;
+        organizationId?: (string | null) | undefined;
+        resourceId?: (string | null) | undefined;
+        runId?: (string | null) | undefined;
+        sessionId?: (string | null) | undefined;
+        threadId?: (string | null) | undefined;
+        requestId?: (string | null) | undefined;
+        environment?: (string | null) | undefined;
+        serviceName?: (string | null) | undefined;
+        scope?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        entityVersionId?: (string | null) | undefined;
+        parentEntityVersionId?: (string | null) | undefined;
+        rootEntityVersionId?: (string | null) | undefined;
+        experimentId?: (string | null) | undefined;
+        source?: (string | null) | undefined;
+        metadata?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        tags?: (string[] | null) | undefined;
+        attributes?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        links?: (unknown[] | null) | undefined;
+        input?: (unknown | null) | undefined;
+        output?: (unknown | null) | undefined;
+        error?: (unknown | null) | undefined;
+        endedAt?: string | null | undefined;
+        requestContext?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        createdAt: string;
+        updatedAt: string | null;
+        status: 'success' | 'error' | 'running';
+    }[];
+}>;
+export declare const TRACES_PER_PAGE = 25;
+export interface TracesFilters {
+    filters?: ListTracesArgs['filters'] | ListBranchesArgs['filters'];
+    listMode?: TraceListMode;
+}
+/** Returns the next page number if the server indicates more pages are available. */
+export declare function getTracesNextPageParam(lastPage: ListTracesLightResponse | ListBranchesResponse | undefined, _allPages: unknown, lastPageParam: number): number | undefined;
+type TracesPageResponse = ListTracesLightResponse | ListBranchesResponse;
+/** Deduplicates trace/branch rows by traceId + spanId across all loaded pages.
+ *  Also surfaces page 0's deltaCursor so the live-tail query can read it reactively. */
+export declare function selectUniqueTraces(data: {
+    pages: TracesPageResponse[];
+}): {
+    spans: LightSpanRecord[];
+    deltaCursor: string | undefined;
+};
+/** Replaces existing page-0 rows in place (keyed by traceId:spanId) with
+ *  refreshed copies from the server. Rows the server doesn't return are kept
+ *  as-is so delta-accumulated rows that have aged off the server's page 0
+ *  aren't dropped from the UI. New rows aren't added here — delta polling
+ *  delivers those. */
+export declare function refreshPage0Rows(old: InfiniteData<TracesPageResponse> | undefined, refreshed: ListTracesLightResponse | ListBranchesResponse, listMode: TraceListMode): InfiniteData<TracesPageResponse> | undefined;
+/** Prepends delta-mode rows into page 0 and advances its deltaCursor.
+ *  Delta responses come back in server cursor order (insertion order into
+ *  the per-store delta index), not the `startedAt DESC` order page-mode
+ *  uses — so we re-sort the merged page 0 to match what the user sees on
+ *  a fresh page-mode load. Cross-page duplication is handled later by
+ *  selectUniqueTraces. */
+export declare function mergeDeltaIntoPage0(old: InfiniteData<TracesPageResponse> | undefined, delta: ListTracesLightResponse | ListBranchesResponse, listMode: TraceListMode): InfiniteData<TracesPageResponse> | undefined;
+export interface UseTracesArgs extends TracesFilters {
+    enabled?: boolean;
+    /** Optional overrides for the live-tail polling tunables. Any omitted fields fall back to the
+     *  built-in defaults; pass only what you want to change. */
+    polling?: TracesPollingConfig;
+    /** TanStack overrides for each underlying query, spread last. The hook consumes each query's data internally, so `select` must keep the default shape. */
+    queryOptions?: {
+        traces?: MastraInfiniteQueryOptions<TracesPageResponse, ReturnType<typeof selectUniqueTraces>, readonly ['traces', TraceListMode, TracesFilters['filters']], number>;
+        delta?: MastraQueryOptions<Awaited<ReturnType<typeof fetchTracesFn>> | null>;
+        statusRefresh?: MastraQueryOptions<Awaited<ReturnType<typeof fetchTracesFn>>>;
+    };
+}
+interface UseTracesReturn {
+    data: {
+        spans: LightSpanRecord[];
+        deltaCursor: string | undefined;
+    } | undefined;
+    hasNextPage: boolean;
+    isFetchingNextPage: boolean;
+    fetchNextPage: () => void;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    setEndOfListElement: (node: HTMLDivElement | null) => void;
+    isRefetching: boolean;
+    autoRefetch: boolean;
+    setAutoRefetch: (v: boolean) => void;
+    recentlyAddedKeys: Set<string>;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    isFetching: boolean;
+    isSuccess: boolean;
+    fetchStatus: 'idle' | 'fetching' | 'paused';
+    refetch: () => void;
+}
+export declare const useTraces: (args: UseTracesArgs) => UseTracesReturn;
+export {};
+//# sourceMappingURL=use-traces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-traces.d.ts","sourceRoot":"","sources":["../../../src/hooks/traces/use-traces.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,KAAK,gBAAgB,GAAG,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,KAAK,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAC9E,KAAK,cAAc,GAAG,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7E,KAAK,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;AACpF,KAAK,eAAe,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AA8B3G;;mDAEmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kHAAkH;IAClH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kHAAkH;IAClH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC;8GAC0G;IAC1G,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC;;;8CAG0C;IAC1C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;yBAIqB;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;kEAE8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAaD;0DAC0D;AAC1D,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAGrG;AAgBD;;2FAE2F;AAC3F,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,GAAG,EAAE,MAAM,GACV,OAAO,CAKT;AAED,KAAK,iBAAiB,GAAG,aAAa,GAAG;IACvC,MAAM,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;CAC5C,GAAG,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE3G,QAAA,MAAM,aAAa,SAAgB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDnD,CAAC;AAEF,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAClE,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,qFAAqF;AACrF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,uBAAuB,GAAG,oBAAoB,GAAG,SAAS,EACpE,SAAS,EAAE,OAAO,EAClB,aAAa,EAAE,MAAM,sBAMtB;AAED,KAAK,kBAAkB,GAAG,uBAAuB,GAAG,oBAAoB,CAAC;AASzE;wFACwF;AACxF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,kBAAkB,EAAE,CAAA;CAAE,GAAG;IACzE,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAYA;AAYD;;;;sBAIsB;AACtB,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,YAAY,CAAC,kBAAkB,CAAC,GAAG,SAAS,EACjD,SAAS,EAAE,uBAAuB,GAAG,oBAAoB,EACzD,QAAQ,EAAE,aAAa,GACtB,YAAY,CAAC,kBAAkB,CAAC,GAAG,SAAS,CA0B9C;AAaD;;;;;0BAK0B;AAC1B,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,YAAY,CAAC,kBAAkB,CAAC,GAAG,SAAS,EACjD,KAAK,EAAE,uBAAuB,GAAG,oBAAoB,EACrD,QAAQ,EAAE,aAAa,GACtB,YAAY,CAAC,kBAAkB,CAAC,GAAG,SAAS,CA0B9C;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;gEAC4D;IAC5D,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,0JAA0J;IAC1J,YAAY,CAAC,EAAE;QACb,MAAM,CAAC,EAAE,0BAA0B,CACjC,kBAAkB,EAClB,UAAU,CAAC,OAAO,kBAAkB,CAAC,EACrC,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,EAC5D,MAAM,CACP,CAAC;QACF,KAAK,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7E,aAAa,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;KAC/E,CAAC;CACH;AAED,UAAU,eAAe;IACvB,IAAI,EAAE;QAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IAChF,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,mBAAmB,EAAE,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3D,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC5C,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,SAAS,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,eA2PhD,CAAC"}

package/dist/hooks/vectors/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/vectors/use-vectors.ts
+function useVectors({ queryOptions } = {}) {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: ["vectors"],
+		queryFn: async () => {
+			return await client.listVectors();
+		},
+		staleTime: 3e4,
+		...queryOptions
+	});
+}
+//#endregion
+exports.useVectors = useVectors;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["useMastraClient"],"sources":["../../../src/hooks/vectors/use-vectors.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 Vector {\n  name: string;\n  id: string;\n  description?: string;\n}\n\ntype VectorsResponse = Awaited<ReturnType<MastraClient['listVectors']>>;\n\nexport function useVectors<TData = VectorsResponse>({\n  queryOptions,\n}: {\n  queryOptions?: MastraQueryOptions<VectorsResponse, TData>;\n} = {}): UseQueryResult<TData, Error> {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['vectors'],\n    queryFn: async () => {\n      const data = await client.listVectors();\n      return data;\n    },\n    staleTime: 30000, // Cache for 30 seconds\n    ...queryOptions,\n  });\n}\n"],"mappings":";;;;AAcA,SAAgB,WAAoC,EAClD,iBAGE,CAAC,GAAiC;CACpC,MAAM,SAASA,8BAAAA,gBAAgB;CAE/B,QAAA,GAAA,sBAAA,SAAA,CAAgB;EACd,UAAU,CAAC,SAAS;EACpB,SAAS,YAAY;GAEnB,OAAO,MADY,OAAO,YAAY;EAExC;EACA,WAAW;EACX,GAAG;CACL,CAAC;AACH"}

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

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

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

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

package/dist/hooks/vectors/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/vectors/use-vectors.ts
+function useVectors({ queryOptions } = {}) {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: ["vectors"],
+		queryFn: async () => {
+			return await client.listVectors();
+		},
+		staleTime: 3e4,
+		...queryOptions
+	});
+}
+//#endregion
+export { useVectors };
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/vectors/use-vectors.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 Vector {\n  name: string;\n  id: string;\n  description?: string;\n}\n\ntype VectorsResponse = Awaited<ReturnType<MastraClient['listVectors']>>;\n\nexport function useVectors<TData = VectorsResponse>({\n  queryOptions,\n}: {\n  queryOptions?: MastraQueryOptions<VectorsResponse, TData>;\n} = {}): UseQueryResult<TData, Error> {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['vectors'],\n    queryFn: async () => {\n      const data = await client.listVectors();\n      return data;\n    },\n    staleTime: 30000, // Cache for 30 seconds\n    ...queryOptions,\n  });\n}\n"],"mappings":";;;AAcA,SAAgB,WAAoC,EAClD,iBAGE,CAAC,GAAiC;CACpC,MAAM,SAAS,gBAAgB;CAE/B,OAAO,SAAS;EACd,UAAU,CAAC,SAAS;EACpB,SAAS,YAAY;GAEnB,OAAO,MADY,OAAO,YAAY;EAExC;EACA,WAAW;EACX,GAAG;CACL,CAAC;AACH"}

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

@@ -0,0 +1,14 @@
+import type { MastraClient } from '@mastra/client-js';
+import type { UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+export interface Vector {
+    name: string;
+    id: string;
+    description?: string;
+}
+type VectorsResponse = Awaited<ReturnType<MastraClient['listVectors']>>;
+export declare function useVectors<TData = VectorsResponse>({ queryOptions, }?: {
+    queryOptions?: MastraQueryOptions<VectorsResponse, TData>;
+}): UseQueryResult<TData, Error>;
+export {};
+//# sourceMappingURL=use-vectors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-vectors.d.ts","sourceRoot":"","sources":["../../../src/hooks/vectors/use-vectors.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,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,KAAK,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;AAExE,wBAAgB,UAAU,CAAC,KAAK,GAAG,eAAe,EAAE,EAClD,YAAY,GACb,GAAE;IACD,YAAY,CAAC,EAAE,kBAAkB,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;CACtD,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAYpC"}

package/dist/hooks/voice/index.cjs

@@ -0,0 +1,87 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_mastra_client_context = require("../../mastra-client-context-DzX3f0RF.cjs");
+const require_voice = require("../../voice-BOtUdMi8.cjs");
+let react = require("react");
+//#region src/hooks/voice/use-read-aloud.ts
+/**
+* Read-aloud (text-to-speech) for assistant messages, replacing the assistant-ui
+* speech adapters (`VoiceAttachmentAdapter` / `WebSpeechSynthesisAdapter`).
+*
+* Prefers the agent's configured voice provider when it exposes speakers,
+* streaming the audio through Web Audio. Falls back to the browser
+* `speechSynthesis` API otherwise.
+*/
+const useReadAloud = (agentId, requestContext, options) => {
+	const onErrorRef = (0, react.useRef)(options?.onError);
+	onErrorRef.current = options?.onError;
+	const client = require_mastra_client_context.useMastraClient();
+	const [hasAgentVoice, setHasAgentVoice] = (0, react.useState)(false);
+	const [isSpeaking, setIsSpeaking] = (0, react.useState)(false);
+	const cleanupRef = (0, react.useRef)(null);
+	(0, react.useEffect)(() => {
+		let cancelled = false;
+		if (!agentId) {
+			setHasAgentVoice(false);
+			return () => {
+				cancelled = true;
+			};
+		}
+		client.getAgent(agentId).voice.getSpeakers(requestContext).then((speakers) => {
+			if (!cancelled) setHasAgentVoice(speakers.length > 0);
+		}).catch(() => {
+			if (!cancelled) setHasAgentVoice(false);
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [
+		agentId,
+		client,
+		requestContext
+	]);
+	const stop = (0, react.useCallback)(() => {
+		cleanupRef.current?.();
+		cleanupRef.current = null;
+		if (typeof window !== "undefined" && window.speechSynthesis) window.speechSynthesis.cancel();
+		setIsSpeaking(false);
+	}, []);
+	const readAloud = (0, react.useCallback)(async (text) => {
+		if (!text) return;
+		stop();
+		setIsSpeaking(true);
+		if (agentId && hasAgentVoice) try {
+			const response = await client.getAgent(agentId).voice.speak(text);
+			if (!response.body) throw new Error("No audio stream returned from voice.speak()");
+			const cleanup = await require_voice.playStreamWithWebAudio(response.body, () => setIsSpeaking(false));
+			cleanupRef.current = cleanup ?? null;
+			return;
+		} catch (error) {
+			setIsSpeaking(false);
+			onErrorRef.current?.(error);
+			return;
+		}
+		if (typeof window !== "undefined" && window.speechSynthesis) {
+			const utterance = new SpeechSynthesisUtterance(text);
+			utterance.onend = () => setIsSpeaking(false);
+			utterance.onerror = () => setIsSpeaking(false);
+			window.speechSynthesis.speak(utterance);
+			return;
+		}
+		setIsSpeaking(false);
+	}, [
+		agentId,
+		client,
+		hasAgentVoice,
+		stop
+	]);
+	(0, react.useEffect)(() => () => stop(), [stop]);
+	return {
+		isSpeaking,
+		readAloud,
+		stop
+	};
+};
+//#endregion
+exports.useReadAloud = useReadAloud;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["useMastraClient","playStreamWithWebAudio"],"sources":["../../../src/hooks/voice/use-read-aloud.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\nimport { useMastraClient } from '../../mastra-client-context';\nimport { playStreamWithWebAudio } from '../../voice';\n\ntype ClientAgent = ReturnType<ReturnType<typeof useMastraClient>['getAgent']>;\ntype VoiceRequestContext = Parameters<ClientAgent['voice']['getSpeakers']>[0];\n\n/**\n * Read-aloud (text-to-speech) for assistant messages, replacing the assistant-ui\n * speech adapters (`VoiceAttachmentAdapter` / `WebSpeechSynthesisAdapter`).\n *\n * Prefers the agent's configured voice provider when it exposes speakers,\n * streaming the audio through Web Audio. Falls back to the browser\n * `speechSynthesis` API otherwise.\n */\nexport const useReadAloud = (\n  agentId?: string,\n  requestContext?: VoiceRequestContext,\n  options?: { onError?: (error: unknown) => void },\n) => {\n  const onErrorRef = useRef(options?.onError);\n  onErrorRef.current = options?.onError;\n  const client = useMastraClient();\n  const [hasAgentVoice, setHasAgentVoice] = useState(false);\n  const [isSpeaking, setIsSpeaking] = useState(false);\n  const cleanupRef = useRef<(() => void) | null>(null);\n\n  useEffect(() => {\n    let cancelled = false;\n    if (!agentId) {\n      setHasAgentVoice(false);\n      return () => {\n        cancelled = true;\n      };\n    }\n    const agent = client.getAgent(agentId);\n    void agent.voice\n      .getSpeakers(requestContext)\n      .then(speakers => {\n        if (!cancelled) setHasAgentVoice(speakers.length > 0);\n      })\n      .catch(() => {\n        if (!cancelled) setHasAgentVoice(false);\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [agentId, client, requestContext]);\n\n  const stop = useCallback(() => {\n    cleanupRef.current?.();\n    cleanupRef.current = null;\n    if (typeof window !== 'undefined' && window.speechSynthesis) {\n      window.speechSynthesis.cancel();\n    }\n    setIsSpeaking(false);\n  }, []);\n\n  const readAloud = useCallback(\n    async (text: string) => {\n      if (!text) return;\n      stop();\n      setIsSpeaking(true);\n\n      if (agentId && hasAgentVoice) {\n        try {\n          const agent = client.getAgent(agentId);\n          const response = await agent.voice.speak(text);\n          if (!response.body) {\n            throw new Error('No audio stream returned from voice.speak()');\n          }\n          const cleanup = await playStreamWithWebAudio(response.body, () => setIsSpeaking(false));\n          cleanupRef.current = cleanup ?? null;\n          return;\n        } catch (error) {\n          setIsSpeaking(false);\n          onErrorRef.current?.(error);\n          return;\n        }\n      }\n\n      if (typeof window !== 'undefined' && window.speechSynthesis) {\n        const utterance = new SpeechSynthesisUtterance(text);\n        utterance.onend = () => setIsSpeaking(false);\n        utterance.onerror = () => setIsSpeaking(false);\n        window.speechSynthesis.speak(utterance);\n        return;\n      }\n\n      setIsSpeaking(false);\n    },\n    [agentId, client, hasAgentVoice, stop],\n  );\n\n  useEffect(() => () => stop(), [stop]);\n\n  return { isSpeaking, readAloud, stop };\n};\n"],"mappings":";;;;;;;;;;;;;AAeA,MAAa,gBACX,SACA,gBACA,YACG;CACH,MAAM,cAAA,GAAA,MAAA,OAAA,CAAoB,SAAS,OAAO;CAC1C,WAAW,UAAU,SAAS;CAC9B,MAAM,SAASA,8BAAAA,gBAAgB;CAC/B,MAAM,CAAC,eAAe,qBAAA,GAAA,MAAA,SAAA,CAA6B,KAAK;CACxD,MAAM,CAAC,YAAY,kBAAA,GAAA,MAAA,SAAA,CAA0B,KAAK;CAClD,MAAM,cAAA,GAAA,MAAA,OAAA,CAAyC,IAAI;CAEnD,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,IAAI,YAAY;EAChB,IAAI,CAAC,SAAS;GACZ,iBAAiB,KAAK;GACtB,aAAa;IACX,YAAY;GACd;EACF;EAEA,OADqB,SAAS,OACrB,CAAC,CAAC,MACR,YAAY,cAAc,CAAC,CAC3B,MAAK,aAAY;GAChB,IAAI,CAAC,WAAW,iBAAiB,SAAS,SAAS,CAAC;EACtD,CAAC,CAAC,CACD,YAAY;GACX,IAAI,CAAC,WAAW,iBAAiB,KAAK;EACxC,CAAC;EACH,aAAa;GACX,YAAY;EACd;CACF,GAAG;EAAC;EAAS;EAAQ;CAAc,CAAC;CAEpC,MAAM,QAAA,GAAA,MAAA,YAAA,OAAyB;EAC7B,WAAW,UAAU;EACrB,WAAW,UAAU;EACrB,IAAI,OAAO,WAAW,eAAe,OAAO,iBAC1C,OAAO,gBAAgB,OAAO;EAEhC,cAAc,KAAK;CACrB,GAAG,CAAC,CAAC;CAEL,MAAM,aAAA,GAAA,MAAA,YAAA,CACJ,OAAO,SAAiB;EACtB,IAAI,CAAC,MAAM;EACX,KAAK;EACL,cAAc,IAAI;EAElB,IAAI,WAAW,eACb,IAAI;GAEF,MAAM,WAAW,MADH,OAAO,SAAS,OACH,CAAC,CAAC,MAAM,MAAM,IAAI;GAC7C,IAAI,CAAC,SAAS,MACZ,MAAM,IAAI,MAAM,6CAA6C;GAE/D,MAAM,UAAU,MAAMC,cAAAA,uBAAuB,SAAS,YAAY,cAAc,KAAK,CAAC;GACtF,WAAW,UAAU,WAAW;GAChC;EACF,SAAS,OAAO;GACd,cAAc,KAAK;GACnB,WAAW,UAAU,KAAK;GAC1B;EACF;EAGF,IAAI,OAAO,WAAW,eAAe,OAAO,iBAAiB;GAC3D,MAAM,YAAY,IAAI,yBAAyB,IAAI;GACnD,UAAU,cAAc,cAAc,KAAK;GAC3C,UAAU,gBAAgB,cAAc,KAAK;GAC7C,OAAO,gBAAgB,MAAM,SAAS;GACtC;EACF;EAEA,cAAc,KAAK;CACrB,GACA;EAAC;EAAS;EAAQ;EAAe;CAAI,CACvC;CAEA,CAAA,GAAA,MAAA,UAAA,aAAsB,KAAK,GAAG,CAAC,IAAI,CAAC;CAEpC,OAAO;EAAE;EAAY;EAAW;CAAK;AACvC"}

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

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

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

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