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

package/dist/hooks/voice/index.js

@@ -0,0 +1,86 @@
+import { n as useMastraClient } from "../../mastra-client-context-Bx_g84YB.js";
+import { n as playStreamWithWebAudio } from "../../voice-DgirjEyH.js";
+import { useCallback, useEffect, useRef, useState } from "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 = useRef(options?.onError);
+	onErrorRef.current = options?.onError;
+	const client = useMastraClient();
+	const [hasAgentVoice, setHasAgentVoice] = useState(false);
+	const [isSpeaking, setIsSpeaking] = useState(false);
+	const cleanupRef = useRef(null);
+	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 = useCallback(() => {
+		cleanupRef.current?.();
+		cleanupRef.current = null;
+		if (typeof window !== "undefined" && window.speechSynthesis) window.speechSynthesis.cancel();
+		setIsSpeaking(false);
+	}, []);
+	const readAloud = 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 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
+	]);
+	useEffect(() => () => stop(), [stop]);
+	return {
+		isSpeaking,
+		readAloud,
+		stop
+	};
+};
+//#endregion
+export { useReadAloud };
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"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,aAAa,OAAO,SAAS,OAAO;CAC1C,WAAW,UAAU,SAAS;CAC9B,MAAM,SAAS,gBAAgB;CAC/B,MAAM,CAAC,eAAe,oBAAoB,SAAS,KAAK;CACxD,MAAM,CAAC,YAAY,iBAAiB,SAAS,KAAK;CAClD,MAAM,aAAa,OAA4B,IAAI;CAEnD,gBAAgB;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,OAAO,kBAAkB;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,YAAY,YAChB,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,MAAM,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,sBAAsB,KAAK,GAAG,CAAC,IAAI,CAAC;CAEpC,OAAO;EAAE;EAAY;EAAW;CAAK;AACvC"}

package/dist/hooks/voice/use-read-aloud.d.ts

@@ -0,0 +1,20 @@
+import { useMastraClient } from '../../mastra-client-context.js';
+type ClientAgent = ReturnType<ReturnType<typeof useMastraClient>['getAgent']>;
+type VoiceRequestContext = Parameters<ClientAgent['voice']['getSpeakers']>[0];
+/**
+ * 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.
+ */
+export declare const useReadAloud: (agentId?: string, requestContext?: VoiceRequestContext, options?: {
+    onError?: (error: unknown) => void;
+}) => {
+    isSpeaking: boolean;
+    readAloud: (text: string) => Promise<void>;
+    stop: () => void;
+};
+export {};
+//# sourceMappingURL=use-read-aloud.d.ts.map

package/dist/hooks/voice/use-read-aloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-read-aloud.d.ts","sourceRoot":"","sources":["../../../src/hooks/voice/use-read-aloud.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,KAAK,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAC9E,KAAK,mBAAmB,GAAG,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,aACb,MAAM,mBACC,mBAAmB,YAC1B;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE;;sBAyCjC,MAAM;;CAsCtB,CAAC"}

package/dist/hooks/workflows/index.cjs

@@ -0,0 +1,173 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_mastra_client_context = require("../../mastra-client-context-DzX3f0RF.cjs");
+const require_hooks = require("../../hooks-DsDYaJ3T.cjs");
+const require_use_in_view = require("../../use-in-view-B6eJO9Zi.cjs");
+let _mastra_client_js = require("@mastra/client-js");
+let react = require("react");
+let _tanstack_react_query = require("@tanstack/react-query");
+//#region src/hooks/workflows/use-workflows.ts
+const useWorkflows = ({ requestContext, queryOptions } = {}) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: ["workflows", requestContext],
+		queryFn: async () => {
+			const workflows = await client.listWorkflows(requestContext);
+			return Object.fromEntries(Object.entries(workflows).filter(([_, workflow]) => !workflow.isProcessorWorkflow));
+		},
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/workflows/use-workflow.ts
+/**
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useWorkflow = ({ workflowId, requestContext, queryOptions } = {}) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: ["workflow", workflowId],
+		queryFn: () => workflowId ? client.getWorkflow(workflowId).details(requestContext) : null,
+		retry: false,
+		refetchOnWindowFocus: false,
+		throwOnError: false,
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/workflows/use-workflow-runs.ts
+const PER_PAGE = 20;
+function getWorkflowRunsNextPageParam(lastPage, _allPages, lastPageParam) {
+	if (lastPage.runs.length < 20) return;
+	return lastPageParam + 1;
+}
+function selectUniqueRuns(data) {
+	const seen = /* @__PURE__ */ new Set();
+	return data.pages.flatMap((page) => page.runs).filter((run) => {
+		if (seen.has(run.runId)) return false;
+		seen.add(run.runId);
+		return true;
+	});
+}
+/**
+* `summary: true` asks the server to reduce each run snapshot to `{ status, timestamp }`,
+* avoiding transfer of full snapshots when only list metadata is displayed.
+*/
+const useWorkflowRuns = ({ workflowId, summary = false, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	const { inView: isEndOfListInView, setRef: setEndOfListElement } = require_use_in_view.useInView();
+	const query = (0, _tanstack_react_query.useInfiniteQuery)({
+		queryKey: [
+			"workflow-runs",
+			workflowId,
+			{ summary }
+		],
+		queryFn: ({ pageParam }) => client.getWorkflow(workflowId).runs({
+			limit: 20,
+			offset: pageParam * 20,
+			...summary ? { summary: true } : {}
+		}),
+		initialPageParam: 0,
+		getNextPageParam: getWorkflowRunsNextPageParam,
+		select: (data) => selectUniqueRuns(data),
+		retry: false,
+		refetchInterval: 5e3,
+		...queryOptions
+	});
+	const { hasNextPage, isFetchingNextPage, fetchNextPage } = query;
+	(0, react.useEffect)(() => {
+		if (isEndOfListInView && hasNextPage && !isFetchingNextPage) fetchNextPage();
+	}, [
+		isEndOfListInView,
+		hasNextPage,
+		isFetchingNextPage,
+		fetchNextPage
+	]);
+	return {
+		...query,
+		setEndOfListElement
+	};
+};
+const workflowRunQueryKey = (workflowId, runId) => [
+	"workflow-run",
+	workflowId,
+	runId
+];
+/**
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useWorkflowRun = ({ workflowId, runId, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: workflowRunQueryKey(workflowId, runId),
+		queryFn: () => client.getWorkflow(workflowId).runById(runId),
+		gcTime: 0,
+		staleTime: 0,
+		...queryOptions
+	});
+};
+const useDeleteWorkflowRun = ({ workflowId, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	const queryClient = (0, _tanstack_react_query.useQueryClient)();
+	return (0, _tanstack_react_query.useMutation)({
+		mutationFn: ({ runId }) => client.getWorkflow(workflowId).deleteRunById(runId),
+		onSuccess: () => {
+			queryClient.invalidateQueries({ queryKey: ["workflow-runs", workflowId] });
+		},
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/workflows/use-workflows-run-counts.ts
+const RUN_COUNTS_REFETCH_INTERVAL_MS = 5e3;
+const NO_COUNTS = {};
+/** Older servers don't ship the endpoint — that (and only that) ends polling. */
+function isRunCountsUnsupported(error) {
+	return error instanceof _mastra_client_js.MastraClientError && error.status === 404;
+}
+/**
+* Poll cadence: keep polling through transient failures (a blip must not
+* silence the counts forever), but stop entirely once the server has said the
+* endpoint does not exist.
+*/
+function runCountsRefetchInterval(error) {
+	return isRunCountsUnsupported(error) ? false : RUN_COUNTS_REFETCH_INTERVAL_MS;
+}
+/**
+* Per-workflow counts of `running` (in-flight) and `suspended` (stopped at a
+* suspend() point awaiting resume — the human-in-the-loop state) runs, keyed
+* by the workflow registry key.
+*
+* One lightweight server request per poll — the server aggregates counts
+* across workflows (GET /workflows/run-counts). Older servers 404 the first
+* request; polling then stops and the list renders without count columns.
+*/
+const useWorkflowsRunCounts = ({ requestContext, queryOptions } = {}) => {
+	const client = require_mastra_client_context.useMastraClient();
+	const { data } = (0, _tanstack_react_query.useQuery)({
+		queryKey: ["workflow-run-counts", requestContext],
+		queryFn: () => client.listWorkflowRunCounts(requestContext),
+		retry: false,
+		refetchInterval: (query) => runCountsRefetchInterval(query.state.error),
+		...queryOptions
+	});
+	return data ?? NO_COUNTS;
+};
+//#endregion
+exports.PER_PAGE = PER_PAGE;
+exports.RUN_COUNTS_REFETCH_INTERVAL_MS = RUN_COUNTS_REFETCH_INTERVAL_MS;
+exports.getWorkflowRunsNextPageParam = getWorkflowRunsNextPageParam;
+exports.isRunCountsUnsupported = isRunCountsUnsupported;
+exports.runCountsRefetchInterval = runCountsRefetchInterval;
+exports.selectUniqueRuns = selectUniqueRuns;
+exports.useCancelWorkflowRun = require_hooks.useCancelWorkflowRun;
+exports.useCreateWorkflowRun = require_hooks.useCreateWorkflowRun;
+exports.useDeleteWorkflowRun = useDeleteWorkflowRun;
+exports.useStreamWorkflow = require_hooks.useStreamWorkflow;
+exports.useWorkflow = useWorkflow;
+exports.useWorkflowRun = useWorkflowRun;
+exports.useWorkflowRuns = useWorkflowRuns;
+exports.useWorkflows = useWorkflows;
+exports.useWorkflowsRunCounts = useWorkflowsRunCounts;
+exports.workflowRunQueryKey = workflowRunQueryKey;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["useMastraClient","useMastraClient","useMastraClient","useInView","MastraClientError","useMastraClient"],"sources":["../../../src/hooks/workflows/use-workflows.ts","../../../src/hooks/workflows/use-workflow.ts","../../../src/hooks/workflows/use-workflow-runs.ts","../../../src/hooks/workflows/use-workflows-run-counts.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\ntype WorkflowsResponse = Awaited<ReturnType<MastraClient['listWorkflows']>>;\n\nexport const useWorkflows = <TData = WorkflowsResponse>({\n  requestContext,\n  queryOptions,\n}: {\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<WorkflowsResponse, TData>;\n} = {}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['workflows', requestContext],\n    queryFn: async (): Promise<WorkflowsResponse> => {\n      const workflows = await client.listWorkflows(requestContext);\n      // Filter out processor workflows - they're shown on the Processors tab instead\n      return Object.fromEntries(Object.entries(workflows).filter(([_, workflow]) => !workflow.isProcessorWorkflow));\n    },\n    ...queryOptions,\n  });\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 WorkflowResponse = Awaited<ReturnType<ReturnType<MastraClient['getWorkflow']>['details']>> | null;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useWorkflow = <TData = WorkflowResponse>({\n  workflowId,\n  requestContext,\n  queryOptions,\n}: {\n  workflowId?: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<WorkflowResponse, TData>;\n} = {}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n  return useQuery({\n    queryKey: ['workflow', workflowId],\n    queryFn: () => (workflowId ? client.getWorkflow(workflowId).details(requestContext) : null),\n    retry: false,\n    refetchOnWindowFocus: false,\n    throwOnError: false,\n    ...queryOptions,\n  });\n};\n","import type { GetWorkflowRunByIdResponse, MastraClient } from '@mastra/client-js';\nimport type { QueryKey, UseInfiniteQueryResult, UseMutationResult, UseQueryResult } from '@tanstack/react-query';\nimport { useInfiniteQuery, useMutation, useQuery, useQueryClient } from '@tanstack/react-query';\nimport { useEffect } from 'react';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraInfiniteQueryOptions, MastraMutationOptions, MastraQueryOptions } from '../shared/query-options';\nimport { useInView } from '../shared/use-in-view';\n\ntype WorkflowRuns = Awaited<ReturnType<ReturnType<MastraClient['getWorkflow']>['runs']>>;\n\nexport const PER_PAGE = 20;\n\nexport function getWorkflowRunsNextPageParam(lastPage: WorkflowRuns, _allPages: unknown, lastPageParam: number) {\n  if (lastPage.runs.length < PER_PAGE) {\n    return undefined;\n  }\n  return lastPageParam + 1;\n}\n\nexport function selectUniqueRuns(data: { pages: WorkflowRuns[] }) {\n  const seen = new Set<string>();\n  return data.pages\n    .flatMap(page => page.runs)\n    .filter(run => {\n      if (seen.has(run.runId)) return false;\n      seen.add(run.runId);\n      return true;\n    });\n}\n\n/**\n * `summary: true` asks the server to reduce each run snapshot to `{ status, timestamp }`,\n * avoiding transfer of full snapshots when only list metadata is displayed.\n */\nexport const useWorkflowRuns = <TData = ReturnType<typeof selectUniqueRuns>>({\n  workflowId,\n  summary = false,\n  queryOptions,\n}: {\n  workflowId: string;\n  summary?: boolean;\n  queryOptions?: MastraInfiniteQueryOptions<WorkflowRuns, TData, QueryKey, number>;\n}): UseInfiniteQueryResult<TData, Error> & {\n  setEndOfListElement: ReturnType<typeof useInView>['setRef'];\n} => {\n  const client = useMastraClient();\n  const { inView: isEndOfListInView, setRef: setEndOfListElement } = useInView();\n  const query = useInfiniteQuery({\n    queryKey: ['workflow-runs', workflowId, { summary }],\n    queryFn: ({ pageParam }) =>\n      client\n        .getWorkflow(workflowId)\n        .runs({ limit: PER_PAGE, offset: pageParam * PER_PAGE, ...(summary ? { summary: true } : {}) }),\n    initialPageParam: 0,\n    getNextPageParam: getWorkflowRunsNextPageParam,\n    select: data => selectUniqueRuns(data) as TData,\n    retry: false,\n    refetchInterval: 5000,\n    ...queryOptions,\n  });\n\n  const { hasNextPage, isFetchingNextPage, fetchNextPage } = query;\n\n  useEffect(() => {\n    if (isEndOfListInView && hasNextPage && !isFetchingNextPage) {\n      void fetchNextPage();\n    }\n  }, [isEndOfListInView, hasNextPage, isFetchingNextPage, fetchNextPage]);\n\n  return { ...query, setEndOfListElement };\n};\n\nexport const workflowRunQueryKey = (workflowId: string, runId: string) => ['workflow-run', workflowId, runId] as const;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useWorkflowRun = <TData = GetWorkflowRunByIdResponse>({\n  workflowId,\n  runId,\n  queryOptions,\n}: {\n  workflowId: string;\n  runId: string;\n  queryOptions?: MastraQueryOptions<GetWorkflowRunByIdResponse, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n  return useQuery<GetWorkflowRunByIdResponse, Error, TData>({\n    queryKey: workflowRunQueryKey(workflowId, runId),\n    queryFn: () => client.getWorkflow(workflowId).runById(runId),\n    gcTime: 0,\n    staleTime: 0,\n    ...queryOptions,\n  });\n};\n\nexport const useDeleteWorkflowRun = ({\n  workflowId,\n  queryOptions,\n}: {\n  workflowId: string;\n  queryOptions?: MastraMutationOptions<unknown, { runId: string }>;\n}): UseMutationResult<unknown, Error, { runId: string }> => {\n  const client = useMastraClient();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: ({ runId }: { runId: string }) => client.getWorkflow(workflowId).deleteRunById(runId),\n    onSuccess: () => {\n      void queryClient.invalidateQueries({ queryKey: ['workflow-runs', workflowId] });\n    },\n    ...queryOptions,\n  });\n};\n","import type { ListWorkflowRunCountsResponse } from '@mastra/client-js';\nimport { MastraClientError } 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 const RUN_COUNTS_REFETCH_INTERVAL_MS = 5000;\n\nconst NO_COUNTS: ListWorkflowRunCountsResponse = {};\n\n/** Older servers don't ship the endpoint — that (and only that) ends polling. */\nexport function isRunCountsUnsupported(error: unknown): boolean {\n  return error instanceof MastraClientError && error.status === 404;\n}\n\n/**\n * Poll cadence: keep polling through transient failures (a blip must not\n * silence the counts forever), but stop entirely once the server has said the\n * endpoint does not exist.\n */\nexport function runCountsRefetchInterval(error: unknown): number | false {\n  return isRunCountsUnsupported(error) ? false : RUN_COUNTS_REFETCH_INTERVAL_MS;\n}\n\n/**\n * Per-workflow counts of `running` (in-flight) and `suspended` (stopped at a\n * suspend() point awaiting resume — the human-in-the-loop state) runs, keyed\n * by the workflow registry key.\n *\n * One lightweight server request per poll — the server aggregates counts\n * across workflows (GET /workflows/run-counts). Older servers 404 the first\n * request; polling then stops and the list renders without count columns.\n */\nexport const useWorkflowsRunCounts = ({\n  requestContext,\n  queryOptions,\n}: {\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<ListWorkflowRunCountsResponse>;\n} = {}): ListWorkflowRunCountsResponse => {\n  const client = useMastraClient();\n\n  const { data } = useQuery({\n    queryKey: ['workflow-run-counts', requestContext],\n    queryFn: () => client.listWorkflowRunCounts(requestContext),\n    retry: false,\n    refetchInterval: query => runCountsRefetchInterval(query.state.error),\n    ...queryOptions,\n  });\n\n  return data ?? NO_COUNTS;\n};\n"],"mappings":"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"}

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

@@ -0,0 +1,7 @@
+export * from '../../workflows/hooks.js';
+export type * from '../../workflows/types.js';
+export * from './use-workflows.js';
+export * from './use-workflow.js';
+export * from './use-workflow-runs.js';
+export * from './use-workflows-run-counts.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/workflows/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,mBAAmB,uBAAuB,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC"}

package/dist/hooks/workflows/index.js

@@ -0,0 +1,157 @@
+import { n as useMastraClient } from "../../mastra-client-context-Bx_g84YB.js";
+import { n as useCreateWorkflowRun, r as useStreamWorkflow, t as useCancelWorkflowRun } from "../../hooks-CjULNHpJ.js";
+import { t as useInView } from "../../use-in-view-C9sYPGRm.js";
+import { MastraClientError } from "@mastra/client-js";
+import { useEffect } from "react";
+import { useInfiniteQuery, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+//#region src/hooks/workflows/use-workflows.ts
+const useWorkflows = ({ requestContext, queryOptions } = {}) => {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: ["workflows", requestContext],
+		queryFn: async () => {
+			const workflows = await client.listWorkflows(requestContext);
+			return Object.fromEntries(Object.entries(workflows).filter(([_, workflow]) => !workflow.isProcessorWorkflow));
+		},
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/workflows/use-workflow.ts
+/**
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useWorkflow = ({ workflowId, requestContext, queryOptions } = {}) => {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: ["workflow", workflowId],
+		queryFn: () => workflowId ? client.getWorkflow(workflowId).details(requestContext) : null,
+		retry: false,
+		refetchOnWindowFocus: false,
+		throwOnError: false,
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/workflows/use-workflow-runs.ts
+const PER_PAGE = 20;
+function getWorkflowRunsNextPageParam(lastPage, _allPages, lastPageParam) {
+	if (lastPage.runs.length < 20) return;
+	return lastPageParam + 1;
+}
+function selectUniqueRuns(data) {
+	const seen = /* @__PURE__ */ new Set();
+	return data.pages.flatMap((page) => page.runs).filter((run) => {
+		if (seen.has(run.runId)) return false;
+		seen.add(run.runId);
+		return true;
+	});
+}
+/**
+* `summary: true` asks the server to reduce each run snapshot to `{ status, timestamp }`,
+* avoiding transfer of full snapshots when only list metadata is displayed.
+*/
+const useWorkflowRuns = ({ workflowId, summary = false, queryOptions }) => {
+	const client = useMastraClient();
+	const { inView: isEndOfListInView, setRef: setEndOfListElement } = useInView();
+	const query = useInfiniteQuery({
+		queryKey: [
+			"workflow-runs",
+			workflowId,
+			{ summary }
+		],
+		queryFn: ({ pageParam }) => client.getWorkflow(workflowId).runs({
+			limit: 20,
+			offset: pageParam * 20,
+			...summary ? { summary: true } : {}
+		}),
+		initialPageParam: 0,
+		getNextPageParam: getWorkflowRunsNextPageParam,
+		select: (data) => selectUniqueRuns(data),
+		retry: false,
+		refetchInterval: 5e3,
+		...queryOptions
+	});
+	const { hasNextPage, isFetchingNextPage, fetchNextPage } = query;
+	useEffect(() => {
+		if (isEndOfListInView && hasNextPage && !isFetchingNextPage) fetchNextPage();
+	}, [
+		isEndOfListInView,
+		hasNextPage,
+		isFetchingNextPage,
+		fetchNextPage
+	]);
+	return {
+		...query,
+		setEndOfListElement
+	};
+};
+const workflowRunQueryKey = (workflowId, runId) => [
+	"workflow-run",
+	workflowId,
+	runId
+];
+/**
+* Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+*/
+const useWorkflowRun = ({ workflowId, runId, queryOptions }) => {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: workflowRunQueryKey(workflowId, runId),
+		queryFn: () => client.getWorkflow(workflowId).runById(runId),
+		gcTime: 0,
+		staleTime: 0,
+		...queryOptions
+	});
+};
+const useDeleteWorkflowRun = ({ workflowId, queryOptions }) => {
+	const client = useMastraClient();
+	const queryClient = useQueryClient();
+	return useMutation({
+		mutationFn: ({ runId }) => client.getWorkflow(workflowId).deleteRunById(runId),
+		onSuccess: () => {
+			queryClient.invalidateQueries({ queryKey: ["workflow-runs", workflowId] });
+		},
+		...queryOptions
+	});
+};
+//#endregion
+//#region src/hooks/workflows/use-workflows-run-counts.ts
+const RUN_COUNTS_REFETCH_INTERVAL_MS = 5e3;
+const NO_COUNTS = {};
+/** Older servers don't ship the endpoint — that (and only that) ends polling. */
+function isRunCountsUnsupported(error) {
+	return error instanceof MastraClientError && error.status === 404;
+}
+/**
+* Poll cadence: keep polling through transient failures (a blip must not
+* silence the counts forever), but stop entirely once the server has said the
+* endpoint does not exist.
+*/
+function runCountsRefetchInterval(error) {
+	return isRunCountsUnsupported(error) ? false : RUN_COUNTS_REFETCH_INTERVAL_MS;
+}
+/**
+* Per-workflow counts of `running` (in-flight) and `suspended` (stopped at a
+* suspend() point awaiting resume — the human-in-the-loop state) runs, keyed
+* by the workflow registry key.
+*
+* One lightweight server request per poll — the server aggregates counts
+* across workflows (GET /workflows/run-counts). Older servers 404 the first
+* request; polling then stops and the list renders without count columns.
+*/
+const useWorkflowsRunCounts = ({ requestContext, queryOptions } = {}) => {
+	const client = useMastraClient();
+	const { data } = useQuery({
+		queryKey: ["workflow-run-counts", requestContext],
+		queryFn: () => client.listWorkflowRunCounts(requestContext),
+		retry: false,
+		refetchInterval: (query) => runCountsRefetchInterval(query.state.error),
+		...queryOptions
+	});
+	return data ?? NO_COUNTS;
+};
+//#endregion
+export { PER_PAGE, RUN_COUNTS_REFETCH_INTERVAL_MS, getWorkflowRunsNextPageParam, isRunCountsUnsupported, runCountsRefetchInterval, selectUniqueRuns, useCancelWorkflowRun, useCreateWorkflowRun, useDeleteWorkflowRun, useStreamWorkflow, useWorkflow, useWorkflowRun, useWorkflowRuns, useWorkflows, useWorkflowsRunCounts, workflowRunQueryKey };
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/workflows/use-workflows.ts","../../../src/hooks/workflows/use-workflow.ts","../../../src/hooks/workflows/use-workflow-runs.ts","../../../src/hooks/workflows/use-workflows-run-counts.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\ntype WorkflowsResponse = Awaited<ReturnType<MastraClient['listWorkflows']>>;\n\nexport const useWorkflows = <TData = WorkflowsResponse>({\n  requestContext,\n  queryOptions,\n}: {\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<WorkflowsResponse, TData>;\n} = {}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['workflows', requestContext],\n    queryFn: async (): Promise<WorkflowsResponse> => {\n      const workflows = await client.listWorkflows(requestContext);\n      // Filter out processor workflows - they're shown on the Processors tab instead\n      return Object.fromEntries(Object.entries(workflows).filter(([_, workflow]) => !workflow.isProcessorWorkflow));\n    },\n    ...queryOptions,\n  });\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 WorkflowResponse = Awaited<ReturnType<ReturnType<MastraClient['getWorkflow']>['details']>> | null;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useWorkflow = <TData = WorkflowResponse>({\n  workflowId,\n  requestContext,\n  queryOptions,\n}: {\n  workflowId?: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<WorkflowResponse, TData>;\n} = {}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n  return useQuery({\n    queryKey: ['workflow', workflowId],\n    queryFn: () => (workflowId ? client.getWorkflow(workflowId).details(requestContext) : null),\n    retry: false,\n    refetchOnWindowFocus: false,\n    throwOnError: false,\n    ...queryOptions,\n  });\n};\n","import type { GetWorkflowRunByIdResponse, MastraClient } from '@mastra/client-js';\nimport type { QueryKey, UseInfiniteQueryResult, UseMutationResult, UseQueryResult } from '@tanstack/react-query';\nimport { useInfiniteQuery, useMutation, useQuery, useQueryClient } from '@tanstack/react-query';\nimport { useEffect } from 'react';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraInfiniteQueryOptions, MastraMutationOptions, MastraQueryOptions } from '../shared/query-options';\nimport { useInView } from '../shared/use-in-view';\n\ntype WorkflowRuns = Awaited<ReturnType<ReturnType<MastraClient['getWorkflow']>['runs']>>;\n\nexport const PER_PAGE = 20;\n\nexport function getWorkflowRunsNextPageParam(lastPage: WorkflowRuns, _allPages: unknown, lastPageParam: number) {\n  if (lastPage.runs.length < PER_PAGE) {\n    return undefined;\n  }\n  return lastPageParam + 1;\n}\n\nexport function selectUniqueRuns(data: { pages: WorkflowRuns[] }) {\n  const seen = new Set<string>();\n  return data.pages\n    .flatMap(page => page.runs)\n    .filter(run => {\n      if (seen.has(run.runId)) return false;\n      seen.add(run.runId);\n      return true;\n    });\n}\n\n/**\n * `summary: true` asks the server to reduce each run snapshot to `{ status, timestamp }`,\n * avoiding transfer of full snapshots when only list metadata is displayed.\n */\nexport const useWorkflowRuns = <TData = ReturnType<typeof selectUniqueRuns>>({\n  workflowId,\n  summary = false,\n  queryOptions,\n}: {\n  workflowId: string;\n  summary?: boolean;\n  queryOptions?: MastraInfiniteQueryOptions<WorkflowRuns, TData, QueryKey, number>;\n}): UseInfiniteQueryResult<TData, Error> & {\n  setEndOfListElement: ReturnType<typeof useInView>['setRef'];\n} => {\n  const client = useMastraClient();\n  const { inView: isEndOfListInView, setRef: setEndOfListElement } = useInView();\n  const query = useInfiniteQuery({\n    queryKey: ['workflow-runs', workflowId, { summary }],\n    queryFn: ({ pageParam }) =>\n      client\n        .getWorkflow(workflowId)\n        .runs({ limit: PER_PAGE, offset: pageParam * PER_PAGE, ...(summary ? { summary: true } : {}) }),\n    initialPageParam: 0,\n    getNextPageParam: getWorkflowRunsNextPageParam,\n    select: data => selectUniqueRuns(data) as TData,\n    retry: false,\n    refetchInterval: 5000,\n    ...queryOptions,\n  });\n\n  const { hasNextPage, isFetchingNextPage, fetchNextPage } = query;\n\n  useEffect(() => {\n    if (isEndOfListInView && hasNextPage && !isFetchingNextPage) {\n      void fetchNextPage();\n    }\n  }, [isEndOfListInView, hasNextPage, isFetchingNextPage, fetchNextPage]);\n\n  return { ...query, setEndOfListElement };\n};\n\nexport const workflowRunQueryKey = (workflowId: string, runId: string) => ['workflow-run', workflowId, runId] as const;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useWorkflowRun = <TData = GetWorkflowRunByIdResponse>({\n  workflowId,\n  runId,\n  queryOptions,\n}: {\n  workflowId: string;\n  runId: string;\n  queryOptions?: MastraQueryOptions<GetWorkflowRunByIdResponse, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n  return useQuery<GetWorkflowRunByIdResponse, Error, TData>({\n    queryKey: workflowRunQueryKey(workflowId, runId),\n    queryFn: () => client.getWorkflow(workflowId).runById(runId),\n    gcTime: 0,\n    staleTime: 0,\n    ...queryOptions,\n  });\n};\n\nexport const useDeleteWorkflowRun = ({\n  workflowId,\n  queryOptions,\n}: {\n  workflowId: string;\n  queryOptions?: MastraMutationOptions<unknown, { runId: string }>;\n}): UseMutationResult<unknown, Error, { runId: string }> => {\n  const client = useMastraClient();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: ({ runId }: { runId: string }) => client.getWorkflow(workflowId).deleteRunById(runId),\n    onSuccess: () => {\n      void queryClient.invalidateQueries({ queryKey: ['workflow-runs', workflowId] });\n    },\n    ...queryOptions,\n  });\n};\n","import type { ListWorkflowRunCountsResponse } from '@mastra/client-js';\nimport { MastraClientError } 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 const RUN_COUNTS_REFETCH_INTERVAL_MS = 5000;\n\nconst NO_COUNTS: ListWorkflowRunCountsResponse = {};\n\n/** Older servers don't ship the endpoint — that (and only that) ends polling. */\nexport function isRunCountsUnsupported(error: unknown): boolean {\n  return error instanceof MastraClientError && error.status === 404;\n}\n\n/**\n * Poll cadence: keep polling through transient failures (a blip must not\n * silence the counts forever), but stop entirely once the server has said the\n * endpoint does not exist.\n */\nexport function runCountsRefetchInterval(error: unknown): number | false {\n  return isRunCountsUnsupported(error) ? false : RUN_COUNTS_REFETCH_INTERVAL_MS;\n}\n\n/**\n * Per-workflow counts of `running` (in-flight) and `suspended` (stopped at a\n * suspend() point awaiting resume — the human-in-the-loop state) runs, keyed\n * by the workflow registry key.\n *\n * One lightweight server request per poll — the server aggregates counts\n * across workflows (GET /workflows/run-counts). Older servers 404 the first\n * request; polling then stops and the list renders without count columns.\n */\nexport const useWorkflowsRunCounts = ({\n  requestContext,\n  queryOptions,\n}: {\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<ListWorkflowRunCountsResponse>;\n} = {}): ListWorkflowRunCountsResponse => {\n  const client = useMastraClient();\n\n  const { data } = useQuery({\n    queryKey: ['workflow-run-counts', requestContext],\n    queryFn: () => client.listWorkflowRunCounts(requestContext),\n    retry: false,\n    refetchInterval: query => runCountsRefetchInterval(query.state.error),\n    ...queryOptions,\n  });\n\n  return data ?? NO_COUNTS;\n};\n"],"mappings":"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"}

package/dist/hooks/workflows/use-workflow-runs.d.ts

@@ -0,0 +1,51 @@
+import type { GetWorkflowRunByIdResponse, MastraClient } from '@mastra/client-js';
+import type { QueryKey, UseInfiniteQueryResult, UseMutationResult, UseQueryResult } from '@tanstack/react-query';
+import type { MastraInfiniteQueryOptions, MastraMutationOptions, MastraQueryOptions } from '../shared/query-options.js';
+import { useInView } from '../shared/use-in-view.js';
+type WorkflowRuns = Awaited<ReturnType<ReturnType<MastraClient['getWorkflow']>['runs']>>;
+export declare const PER_PAGE = 20;
+export declare function getWorkflowRunsNextPageParam(lastPage: WorkflowRuns, _allPages: unknown, lastPageParam: number): number | undefined;
+export declare function selectUniqueRuns(data: {
+    pages: WorkflowRuns[];
+}): (Omit<{
+    workflowName: string;
+    runId: string;
+    snapshot: {
+        [key: string]: unknown;
+    } | string;
+    createdAt: string;
+    updatedAt: string;
+    resourceId?: string | undefined;
+}, "snapshot"> & {
+    snapshot: string | import("@mastra/core/workflows").WorkflowRunState;
+})[];
+/**
+ * `summary: true` asks the server to reduce each run snapshot to `{ status, timestamp }`,
+ * avoiding transfer of full snapshots when only list metadata is displayed.
+ */
+export declare const useWorkflowRuns: <TData = ReturnType<typeof selectUniqueRuns>>({ workflowId, summary, queryOptions, }: {
+    workflowId: string;
+    summary?: boolean;
+    queryOptions?: MastraInfiniteQueryOptions<WorkflowRuns, TData, QueryKey, number>;
+}) => UseInfiniteQueryResult<TData, Error> & {
+    setEndOfListElement: ReturnType<typeof useInView>['setRef'];
+};
+export declare const workflowRunQueryKey: (workflowId: string, runId: string) => readonly ['workflow-run', string, string];
+/**
+ * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+ */
+export declare const useWorkflowRun: <TData = GetWorkflowRunByIdResponse>({ workflowId, runId, queryOptions, }: {
+    workflowId: string;
+    runId: string;
+    queryOptions?: MastraQueryOptions<GetWorkflowRunByIdResponse, TData>;
+}) => UseQueryResult<TData, Error>;
+export declare const useDeleteWorkflowRun: ({ workflowId, queryOptions, }: {
+    workflowId: string;
+    queryOptions?: MastraMutationOptions<unknown, {
+        runId: string;
+    }>;
+}) => UseMutationResult<unknown, Error, {
+    runId: string;
+}>;
+export {};
+//# sourceMappingURL=use-workflow-runs.d.ts.map

package/dist/hooks/workflows/use-workflow-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-workflow-runs.d.ts","sourceRoot":"","sources":["../../../src/hooks/workflows/use-workflow-runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIjH,OAAO,KAAK,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACrH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,KAAK,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAEzF,eAAO,MAAM,QAAQ,KAAK,CAAC;AAE3B,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAK7G;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,YAAY,EAAE,CAAA;CAAE;;;;;;;;;;;KAS/D;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,0CAIxE;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,0BAA0B,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;CAClF,KAAG,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG;IACzC,mBAAmB,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC;CA2B7D,CAAC;AAEF,eAAO,MAAM,mBAAmB,eAAgB,MAAM,SAAS,MAAM,eAAM,cAAc,iBAA6B,CAAC;AAEvH;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,GAAG,0BAA0B,wCAI9D;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,kBAAkB,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;CACtE,KAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAS9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,kCAG9B;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,qBAAqB,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE,KAAG,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAUtD,CAAC"}

package/dist/hooks/workflows/use-workflow.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';
+type WorkflowResponse = Awaited<ReturnType<ReturnType<MastraClient['getWorkflow']>['details']>> | null;
+/**
+ * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+ */
+export declare const useWorkflow: <TData = WorkflowResponse>({ workflowId, requestContext, queryOptions, }?: {
+    workflowId?: string;
+    requestContext?: Record<string, any>;
+    queryOptions?: MastraQueryOptions<WorkflowResponse, TData>;
+}) => UseQueryResult<TData, Error>;
+export {};
+//# sourceMappingURL=use-workflow.d.ts.map

package/dist/hooks/workflows/use-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-workflow.d.ts","sourceRoot":"","sources":["../../../src/hooks/workflows/use-workflow.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,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AAEvG;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,GAAG,gBAAgB,kDAIjD;IACD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,kBAAkB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;CAC5D,KAAQ,cAAc,CAAC,KAAK,EAAE,KAAK,CAUnC,CAAC"}

package/dist/hooks/workflows/use-workflows-run-counts.d.ts

@@ -0,0 +1,25 @@
+import type { ListWorkflowRunCountsResponse } from '@mastra/client-js';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+export declare const RUN_COUNTS_REFETCH_INTERVAL_MS = 5000;
+/** Older servers don't ship the endpoint — that (and only that) ends polling. */
+export declare function isRunCountsUnsupported(error: unknown): boolean;
+/**
+ * Poll cadence: keep polling through transient failures (a blip must not
+ * silence the counts forever), but stop entirely once the server has said the
+ * endpoint does not exist.
+ */
+export declare function runCountsRefetchInterval(error: unknown): number | false;
+/**
+ * Per-workflow counts of `running` (in-flight) and `suspended` (stopped at a
+ * suspend() point awaiting resume — the human-in-the-loop state) runs, keyed
+ * by the workflow registry key.
+ *
+ * One lightweight server request per poll — the server aggregates counts
+ * across workflows (GET /workflows/run-counts). Older servers 404 the first
+ * request; polling then stops and the list renders without count columns.
+ */
+export declare const useWorkflowsRunCounts: ({ requestContext, queryOptions, }?: {
+    requestContext?: Record<string, any>;
+    queryOptions?: MastraQueryOptions<ListWorkflowRunCountsResponse>;
+}) => ListWorkflowRunCountsResponse;
+//# sourceMappingURL=use-workflows-run-counts.d.ts.map

package/dist/hooks/workflows/use-workflows-run-counts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-workflows-run-counts.d.ts","sourceRoot":"","sources":["../../../src/hooks/workflows/use-workflows-run-counts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAIvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,eAAO,MAAM,8BAA8B,OAAO,CAAC;AAInD,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAEvE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,uCAG/B;IACD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,kBAAkB,CAAC,6BAA6B,CAAC,CAAC;CAClE,KAAQ,6BAYR,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { MastraClient } from '@mastra/client-js';
+import type { UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+type WorkflowsResponse = Awaited<ReturnType<MastraClient['listWorkflows']>>;
+export declare const useWorkflows: <TData = WorkflowsResponse>({ requestContext, queryOptions, }?: {
+    requestContext?: Record<string, any>;
+    queryOptions?: MastraQueryOptions<WorkflowsResponse, TData>;
+}) => UseQueryResult<TData, Error>;
+export {};
+//# sourceMappingURL=use-workflows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-workflows.d.ts","sourceRoot":"","sources":["../../../src/hooks/workflows/use-workflows.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,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;AAE5E,eAAO,MAAM,YAAY,GAAI,KAAK,GAAG,iBAAiB,sCAGnD;IACD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,kBAAkB,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;CAC7D,KAAQ,cAAc,CAAC,KAAK,EAAE,KAAK,CAYnC,CAAC"}

package/dist/hooks/workspace/client-utils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Checks if a method exists on an object and is callable.
+ */
+export declare function hasMethod<T>(obj: T, method: string): boolean;
+//# sourceMappingURL=client-utils.d.ts.map