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

package/dist/hooks/scores/use-trace-span-scores.d.ts

@@ -0,0 +1,20 @@
+import type { ListScoresResponse } from '@mastra/client-js';
+import type { UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+export declare function getTraceSpanScoresRefetchInterval(query: {
+    state: {
+        error: unknown;
+    };
+}): 15000 | false;
+type useTraceSpanScoresProps<TData> = {
+    traceId?: string;
+    spanId?: string;
+    page?: number;
+    queryOptions?: MastraQueryOptions<ListScoresResponse, TData>;
+};
+/**
+ * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.
+ */
+export declare const useTraceSpanScores: <TData = ListScoresResponse>({ traceId, spanId, page, queryOptions, }: useTraceSpanScoresProps<TData>) => UseQueryResult<TData, Error>;
+export {};
+//# sourceMappingURL=use-trace-span-scores.d.ts.map

package/dist/hooks/scores/use-trace-span-scores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trace-span-scores.d.ts","sourceRoot":"","sources":["../../../src/hooks/scores/use-trace-span-scores.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,iBAQrF;AAED,KAAK,uBAAuB,CAAC,KAAK,IAAI;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,kBAAkB,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;CAC9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,GAAG,kBAAkB,4CAK1D,uBAAuB,CAAC,KAAK,CAAC,KAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAU9D,CAAC"}

package/dist/hooks/scores/use-trigger-scorer.d.ts

@@ -0,0 +1,17 @@
+import type { MastraClient } from '@mastra/client-js';
+import type { MastraMutationOptions } from '../shared/query-options.js';
+interface TriggerScoreArgs {
+    scorerName: string;
+    traceId: string;
+    spanId?: string;
+}
+type TriggerScorerResponse = Awaited<ReturnType<MastraClient['score']>>;
+export declare const useTriggerScorer: ({ queryOptions, }?: {
+    queryOptions?: MastraMutationOptions<TriggerScorerResponse, TriggerScoreArgs>;
+}) => import("@tanstack/react-query").UseMutationResult<{
+    status: string;
+    message: string;
+    traceCount: number;
+}, Error, TriggerScoreArgs, unknown>;
+export {};
+//# sourceMappingURL=use-trigger-scorer.d.ts.map

package/dist/hooks/scores/use-trigger-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trigger-scorer.d.ts","sourceRoot":"","sources":["../../../src/hooks/scores/use-trigger-scorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,UAAU,gBAAgB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAExE,eAAO,MAAM,gBAAgB,uBAE1B;IAAE,YAAY,CAAC,EAAE,qBAAqB,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,CAAA;CAAE;;;;oCAcnF,CAAC"}

package/dist/hooks/shared/cost.d.ts

@@ -0,0 +1,7 @@
+export interface CompactNumberFormatOptions {
+    currency?: string;
+}
+export declare function formatCompactNumber(value: number, { currency }?: CompactNumberFormatOptions): string;
+export declare function formatFullNumber(value: number, { currency }?: CompactNumberFormatOptions): string;
+export declare function formatCost(value: number, unit?: string | null): string;
+//# sourceMappingURL=cost.d.ts.map

package/dist/hooks/shared/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../../src/hooks/shared/cost.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAeD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,GAAE,0BAA+B,GAAG,MAAM,CAMxG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,GAAE,0BAA+B,GAAG,MAAM,CAQrG;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKtE"}

package/dist/hooks/shared/date-format.d.ts

@@ -0,0 +1,30 @@
+export type DateInput = Date | string | number | null | undefined;
+export type DatePreset = 'date' | 'date-time' | 'date-time-seconds' | 'day-time-seconds' | 'time' | 'time-seconds' | 'relative-time' | 'relative-long';
+type FormatOptions = {
+    locale?: string;
+    now?: Date | number;
+    timeZone?: string;
+};
+export declare function toDate(value: DateInput): Date | undefined;
+/** Short absolute date without time: `Sep 24` this year, `Sep 24, 2025` otherwise. */
+export declare function formatShortDate(value: DateInput, { locale, now, timeZone }?: FormatOptions): string | undefined;
+/**
+ * Uses the browser locale unless `locale` is given.
+ * - `date`: date only; omits the year when it matches `now` in the requested timezone
+ * - `date-time`: date, year and time to minutes, including historical dates
+ * - `date-time-seconds`: date, year and time to seconds
+ * - `day-time-seconds`: month, day and time to seconds, without the year
+ * - `time`: time to minutes, without a date
+ * - `time-seconds`: time to seconds, without a date
+ * - `relative-time`: short relative label; delegates to `date` at seven days
+ */
+export declare function formatDate(value: DateInput, preset: DatePreset, options?: FormatOptions): string | undefined;
+/** Locale-aware compact date range, e.g. `Sep 2 – 5, 2026`. */
+export declare function formatDateRange(start: DateInput, end: DateInput, options?: Omit<FormatOptions, 'now'>): string | undefined;
+/** Date and time down to milliseconds, for trace debugging. `withDate: false` keeps only the time. */
+export declare function formatTimestampPrecise(value: DateInput, { locale, withDate }?: {
+    locale?: string;
+    withDate?: boolean;
+}): string | undefined;
+export {};
+//# sourceMappingURL=date-format.d.ts.map

package/dist/hooks/shared/date-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-format.d.ts","sourceRoot":"","sources":["../../../src/hooks/shared/date-format.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAClE,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,WAAW,GACX,mBAAmB,GACnB,kBAAkB,GAClB,MAAM,GACN,cAAc,GACd,eAAe,GACf,eAAe,CAAC;AAEpB,KAAK,aAAa,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAIzD;AAqDD,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAE,aAAkB,sBAO9F;AAuBD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,aAAkB,sBA4B3F;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,GAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAM,sBAOzG;AAED,sGAAsG;AACtG,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,EAChB,EAAE,MAAM,EAAE,QAAe,EAAE,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,sBAI1E"}

package/dist/hooks/shared/map.d.ts

@@ -0,0 +1,2 @@
+export declare function getOrCreate<K, V>(map: Map<K, V>, key: K, create: () => V): V;
+//# sourceMappingURL=map.d.ts.map

package/dist/hooks/shared/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../src/hooks/shared/map.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAM5E"}

package/dist/hooks/shared/query-options.d.ts

@@ -0,0 +1,19 @@
+import type { DefaultError, QueryKey, UseInfiniteQueryOptions, UseMutationOptions, UseQueryOptions } from '@tanstack/react-query';
+/**
+ * TanStack `useQuery` options accepted by every Mastra query hook via `queryOptions`.
+ * Spread last into the underlying call, so any key (including `queryKey`, `queryFn`,
+ * `enabled`, `select`) overrides the hook's default.
+ */
+export type MastraQueryOptions<TQueryFnData, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey> = Partial<UseQueryOptions<TQueryFnData, DefaultError, TData, TQueryKey>>;
+/**
+ * TanStack `useInfiniteQuery` options accepted by every Mastra infinite query hook via `queryOptions`.
+ * Spread last into the underlying call, so any key overrides the hook's default.
+ */
+export type MastraInfiniteQueryOptions<TQueryFnData, TData, TQueryKey extends QueryKey = QueryKey, TPageParam = unknown> = Partial<UseInfiniteQueryOptions<TQueryFnData, DefaultError, TData, TQueryKey, TPageParam>>;
+/**
+ * TanStack `useMutation` options accepted by every Mastra mutation hook via `queryOptions`.
+ * Spread last into the underlying call: passing `onSuccess` replaces the hook's internal
+ * `onSuccess` (including its cache invalidation).
+ */
+export type MastraMutationOptions<TData, TVariables = void, TContext = unknown> = Partial<UseMutationOptions<TData, DefaultError, TVariables, TContext>>;
+//# sourceMappingURL=query-options.d.ts.map

package/dist/hooks/shared/query-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-options.d.ts","sourceRoot":"","sources":["../../../src/hooks/shared/query-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACR,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAE/B;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,YAAY,EAAE,KAAK,GAAG,YAAY,EAAE,SAAS,SAAS,QAAQ,GAAG,QAAQ,IAAI,OAAO,CACjH,eAAe,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,CAAC,CAC9D,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,0BAA0B,CACpC,YAAY,EACZ,KAAK,EACL,SAAS,SAAS,QAAQ,GAAG,QAAQ,EACrC,UAAU,GAAG,OAAO,IAClB,OAAO,CAAC,uBAAuB,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAE/F;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,EAAE,QAAQ,GAAG,OAAO,IAAI,OAAO,CACvF,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,CAAC,CAC9D,CAAC"}

package/dist/hooks/shared/use-in-view.d.ts

@@ -0,0 +1,23 @@
+import type { RefObject } from 'react';
+export type UseInViewOptions = {
+    /**
+     * Scroll container to observe against. When omitted, the browser viewport is used.
+     * Pass the list's own scroll viewport so the sentinel only fires when scrolled
+     * into view inside that container.
+     */
+    root?: RefObject<HTMLElement | null>;
+};
+/**
+ * Tracks whether or not the given element is currently in view.
+ * This is to replace framer-motion's `useInView` which has issues
+ * tracking a ref that is set at a time other than mount.
+ *
+ * The observer is created in an effect (not in the callback ref) so that an
+ * ancestor `root` ref, which React assigns after descendant refs, is already
+ * populated when the observer is constructed.
+ */
+export declare const useInView: ({ root }?: UseInViewOptions) => {
+    inView: boolean;
+    setRef: import("react").Dispatch<import("react").SetStateAction<HTMLDivElement | null>>;
+};
+//# sourceMappingURL=use-in-view.d.ts.map

package/dist/hooks/shared/use-in-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-in-view.d.ts","sourceRoot":"","sources":["../../../src/hooks/shared/use-in-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACtC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,cAAc,gBAAgB;;;CAmBnD,CAAC"}

package/dist/hooks/templates/index.cjs

@@ -0,0 +1,464 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_mastra_client_context = require("../../mastra-client-context-DzX3f0RF.cjs");
+let react = require("react");
+let _tanstack_react_query = require("@tanstack/react-query");
+let _mastra_core_request_context = require("@mastra/core/request-context");
+//#region src/hooks/templates/use-templates.ts
+async function getMastraTemplateRepos() {
+	const response = await fetch("https://mastra.ai/api/templates.json");
+	if (!response.ok) throw new Error(`Failed to fetch templates: ${response.statusText}`);
+	const allTemplates = [{
+		title: "Weather Agent",
+		slug: "weather-agent",
+		githubUrl: "https://github.com/mastra-ai/weather-agent",
+		description: "Get weather information of any city.",
+		longDescription: "One Agent, one Workflow and one Tool to bring you the weather in your city.",
+		imageURL: "",
+		tags: [
+			"Agent",
+			"Workflow",
+			"Tool"
+		],
+		useCase: "",
+		supportedProviders: [
+			"openai",
+			"anthropic",
+			"google",
+			"groq"
+		],
+		agents: ["weatherAgent"],
+		tools: ["weatherTool"],
+		workflows: ["weatherWorkflow"]
+	}, ...await response.json()];
+	return {
+		templates: allTemplates,
+		tags: Array.from(new Set(allTemplates.flatMap((t) => t.tags))),
+		providers: Array.from(new Set(allTemplates.flatMap((t) => t.supportedProviders)))
+	};
+}
+async function getTemplateRepoByRepoName({ repo, owner }) {
+	const response = await fetch(`https://api.github.com/repos/${owner}/${repo}`);
+	if (!response.ok) throw new Error(`Failed to fetch template: ${response.statusText}`);
+	const repoInfo = await response.json();
+	if (!repoInfo.is_template) throw new Error("Repo is not a template, please update the repo settings to make it a template");
+	return {
+		title: repoInfo.name,
+		slug: repoInfo.name,
+		description: repoInfo.description ?? "",
+		imageURL: "",
+		tags: [],
+		useCase: "",
+		longDescription: repoInfo.description ?? "",
+		githubUrl: repoInfo.html_url,
+		supportedProviders: []
+	};
+}
+async function getTemplateRepo({ repoOrSlug, owner }) {
+	const { templates } = await getMastraTemplateRepos();
+	const template = templates.find((t) => t.slug === repoOrSlug);
+	if (!template) {
+		if (owner === "mastra-ai" && repoOrSlug.startsWith("template-")) {
+			const templateRepo = templates.find((template) => `template-${template.slug}` === repoOrSlug);
+			if (templateRepo) return templateRepo;
+		}
+		const templateRepo = await getTemplateRepoByRepoName({
+			repo: repoOrSlug,
+			owner
+		});
+		if (templateRepo) return templateRepo;
+		throw new Error(`Template ${repoOrSlug} not found`);
+	}
+	return template;
+}
+async function getTemplateRepoEnvVars({ repo, owner, branch }) {
+	const envUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/.env.example`;
+	const envResponse = await fetch(envUrl);
+	if (envResponse.ok) return (await envResponse.text()).split("\n").reduce((acc, line) => {
+		if (!line || line.startsWith("#")) return acc;
+		const [key, value] = line.split("=");
+		if (key) acc[key] = value?.split("")?.every((item) => item === "*") ? "" : value?.replaceAll("\"", "");
+		return acc;
+	}, {});
+	return {};
+}
+const useMastraTemplates = ({ queryOptions } = {}) => {
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: ["mastra-templates"],
+		queryFn: getMastraTemplateRepos,
+		...queryOptions
+	});
+};
+const useTemplateRepo = ({ repoOrSlug, owner, queryOptions }) => {
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: [
+			"template-repo",
+			repoOrSlug,
+			owner
+		],
+		queryFn: () => getTemplateRepo({
+			repoOrSlug,
+			owner
+		}),
+		...queryOptions
+	});
+};
+const useTemplateRepoEnvVars = ({ repo, owner, branch, queryOptions }) => {
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: [
+			"template-repo-env-vars",
+			repo,
+			owner,
+			branch
+		],
+		queryFn: () => getTemplateRepoEnvVars({
+			repo,
+			owner,
+			branch
+		}),
+		...queryOptions
+	});
+};
+const useAgentBuilderWorkflow = ({ queryOptions } = {}) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: ["agent-builder-workflow"],
+		queryFn: async () => {
+			return await client.getAgentBuilderAction("merge-template").details();
+		},
+		...queryOptions
+	});
+};
+const useCreateTemplateInstallRun = ({ queryOptions } = {}) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useMutation)({
+		mutationFn: async ({ runId }) => {
+			return await client.getAgentBuilderAction("merge-template").createRun({ runId });
+		},
+		...queryOptions
+	});
+};
+const useGetTemplateInstallRun = ({ queryOptions } = {}) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useMutation)({
+		mutationFn: async ({ runId }) => {
+			return await client.getAgentBuilderAction("merge-template").runById(runId);
+		},
+		...queryOptions
+	});
+};
+const normalizeError = (error) => {
+	if (typeof error === "string") return error;
+	if (error == null) return "Unknown error";
+	if (error instanceof Error) return typeof error.message === "string" && error.message.length > 0 ? error.message : "Unknown error";
+	if (typeof error === "object") try {
+		return JSON.stringify(error);
+	} catch {
+		return String(error);
+	}
+	return String(error);
+};
+const processTemplateInstallRecord = (record, currentState, workflowInfo) => {
+	let newState = { ...currentState };
+	if (!(newState.payload?.workflowState?.steps && Object.keys(newState.payload.workflowState.steps).length > 0) && workflowInfo?.allSteps) newState.payload = {
+		...newState.payload,
+		workflowState: {
+			...newState.payload?.workflowState,
+			steps: Object.keys(workflowInfo.allSteps).reduce((acc, stepId) => {
+				acc[stepId] = {
+					id: stepId,
+					description: workflowInfo.allSteps[stepId].description,
+					status: "pending"
+				};
+				return acc;
+			}, {})
+		}
+	};
+	if (record.type === "start" || record.type === "workflow-start") {
+		const initialSteps = {};
+		if (workflowInfo?.allSteps) Object.entries(workflowInfo.allSteps).forEach(([stepId, stepData]) => {
+			initialSteps[stepId] = {
+				id: stepData.id,
+				description: stepData.description,
+				status: "pending"
+			};
+		});
+		const runId = record.runId || record.payload?.runId;
+		newState = {
+			...newState,
+			runId,
+			eventTimestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			status: "running",
+			phase: "initializing",
+			payload: {
+				workflowState: {
+					status: "running",
+					steps: initialSteps
+				},
+				currentStep: null
+			}
+		};
+	}
+	if (record.type === "step-start" || record.type === "workflow-step-start") {
+		const stepId = record.payload.id;
+		newState = {
+			...newState,
+			phase: "processing",
+			payload: {
+				...newState.payload,
+				currentStep: {
+					id: stepId,
+					status: "running",
+					startTime: /* @__PURE__ */ new Date(),
+					...record.payload
+				},
+				workflowState: {
+					...newState.payload.workflowState,
+					steps: {
+						...newState.payload.workflowState.steps,
+						[stepId]: {
+							...newState.payload.workflowState.steps[stepId],
+							status: "running",
+							startTime: /* @__PURE__ */ new Date(),
+							...record.payload
+						}
+					}
+				}
+			}
+		};
+	}
+	if (record.type === "step-result" || record.type === "workflow-step-result") {
+		const stepId = record.payload.id;
+		const status = record.payload.status;
+		const hasError = record.payload.error;
+		newState = {
+			...newState,
+			payload: {
+				...newState.payload,
+				currentStep: {
+					...newState.payload.currentStep,
+					status: record.payload.status,
+					output: record.payload.output,
+					error: record.payload.error,
+					endTime: /* @__PURE__ */ new Date()
+				},
+				workflowState: {
+					...newState.payload.workflowState,
+					steps: {
+						...newState.payload.workflowState.steps,
+						[stepId]: {
+							...newState.payload.workflowState.steps[stepId],
+							status: record.payload.status,
+							output: record.payload.output,
+							error: record.payload.error,
+							endTime: /* @__PURE__ */ new Date()
+						}
+					}
+				}
+			}
+		};
+		if (status === "failed" && hasError) {
+			const errorString = normalizeError(hasError);
+			newState = {
+				...newState,
+				status: "failed",
+				error: errorString,
+				phase: "error",
+				failedStep: {
+					id: stepId,
+					error: errorString,
+					description: record.payload.description || stepId
+				},
+				payload: {
+					...newState.payload,
+					workflowState: {
+						...newState.payload.workflowState,
+						status: "failed"
+					}
+				},
+				errorTimestamp: /* @__PURE__ */ new Date()
+			};
+		}
+	}
+	if (record.type === "step-finish" || record.type === "workflow-step-finish") newState = {
+		...newState,
+		payload: {
+			...newState.payload,
+			currentStep: null
+		}
+	};
+	if (record.type === "finish" || record.type === "workflow-finish") if (newState.phase === "error" || newState.status === "failed") newState = {
+		...newState,
+		completedAt: /* @__PURE__ */ new Date()
+	};
+	else newState = {
+		...newState,
+		status: record.payload.status || "completed",
+		phase: "completed",
+		payload: {
+			...newState.payload,
+			currentStep: null,
+			workflowState: {
+				...newState.payload.workflowState,
+				status: record.payload.status || "completed"
+			}
+		},
+		completedAt: /* @__PURE__ */ new Date()
+	};
+	if (record.type === "error") {
+		const errorStr = normalizeError(record.payload.error);
+		newState = {
+			...newState,
+			status: "failed",
+			error: errorStr,
+			phase: "error",
+			payload: {
+				...newState.payload,
+				workflowState: {
+					...newState.payload.workflowState,
+					status: "failed"
+				}
+			},
+			errorTimestamp: /* @__PURE__ */ new Date()
+		};
+	}
+	return { newState };
+};
+const saveTemplateStateToLocalStorage = (runId, state) => {
+	try {
+		localStorage.setItem(`template-install-${runId}`, JSON.stringify({
+			state,
+			timestamp: Date.now()
+		}));
+	} catch (error) {
+		console.warn("Failed to save template state to localStorage:", error);
+	}
+};
+const useTemplateStreamProcessor = (workflowInfo, runId) => {
+	const [streamResult, setStreamResult] = (0, react.useState)({});
+	const [isStreaming, setIsStreaming] = (0, react.useState)(false);
+	const processStream = async (stream, initialRunId) => {
+		setIsStreaming(true);
+		setStreamResult({});
+		if (!stream) throw new Error("No stream returned");
+		const reader = stream.getReader();
+		let currentState = {
+			runId: initialRunId || runId,
+			eventTimestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			phase: "running",
+			payload: {
+				workflowState: { steps: {} },
+				currentStep: null
+			}
+		};
+		try {
+			while (true) {
+				const { done, value } = await reader.read();
+				if (done) break;
+				const { newState } = processTemplateInstallRecord(value, currentState, workflowInfo);
+				currentState = newState;
+				setStreamResult(newState);
+				if (value.runId || initialRunId || runId) {
+					const effectiveRunId = value.runId || initialRunId || runId;
+					saveTemplateStateToLocalStorage(effectiveRunId, newState);
+				}
+			}
+		} catch (error) {
+			console.error("💥 [processStream] Error processing template installation stream:", error);
+			const { newState } = processTemplateInstallRecord({
+				type: "error",
+				payload: { error: error instanceof Error ? error.message : "Unknown error" }
+			}, currentState, workflowInfo);
+			setStreamResult(newState);
+		} finally {
+			setIsStreaming(false);
+			reader.releaseLock();
+		}
+	};
+	return {
+		streamResult,
+		isStreaming,
+		processStream
+	};
+};
+const useStreamTemplateInstall = ({ workflowInfo, queryOptions } = {}) => {
+	const client = require_mastra_client_context.useMastraClient();
+	const { streamResult, isStreaming, processStream } = useTemplateStreamProcessor(workflowInfo);
+	return {
+		streamInstall: (0, _tanstack_react_query.useMutation)({
+			mutationFn: async ({ inputData, selectedModel, runId }) => {
+				const maxRetries = 3;
+				for (let attempt = 1; attempt <= maxRetries; attempt++) try {
+					const template = client.getAgentBuilderAction("merge-template");
+					const requestContext = new _mastra_core_request_context.RequestContext();
+					requestContext.set("selectedModel", selectedModel);
+					const stream = await template.stream({
+						inputData,
+						requestContext
+					}, runId);
+					await processStream(stream, runId);
+					return;
+				} catch (error) {
+					console.error(`💥 [streamInstall] Attempt ${attempt} failed:`, error);
+					const isNetworkError = error?.message?.includes("Failed to fetch") || error?.message?.includes("NetworkError") || error?.message?.includes("network error") || error?.message?.includes("fetch") || error?.code === "NETWORK_ERROR" || error?.name === "TypeError";
+					console.warn(`Stream attempt ${attempt}/${maxRetries} failed:`, error);
+					if (isNetworkError) {
+						const errorMessage = runId ? `Network error during template installation (likely hot reload). Please refresh the page to resume from where you left off using runId: ${runId}` : "Network error during template installation (likely hot reload). Please try again.";
+						console.error("🔌 Stream network error:", errorMessage);
+						throw new Error(errorMessage);
+					}
+					console.error("❌ [streamInstall] Non-network error or max retries reached, throwing:", error);
+					throw error;
+				}
+			},
+			...queryOptions?.streamInstall
+		}),
+		streamResult,
+		isStreaming
+	};
+};
+/**
+* Hook for observing template installation with full replay capability.
+* Uses observeStream() which replays cached execution from beginning, then continues live.
+*/
+const useObserveStreamTemplateInstall = ({ workflowInfo, queryOptions } = {}) => {
+	const client = require_mastra_client_context.useMastraClient();
+	const { streamResult, isStreaming, processStream } = useTemplateStreamProcessor(workflowInfo);
+	return {
+		observeInstall: (0, _tanstack_react_query.useMutation)({
+			mutationFn: async ({ runId }) => {
+				const maxRetries = 3;
+				const retryDelay = 2e3;
+				for (let attempt = 1; attempt <= maxRetries; attempt++) try {
+					const stream = await client.getAgentBuilderAction("merge-template").observeStream({ runId });
+					await processStream(stream, runId);
+					return;
+				} catch (error) {
+					console.error(`💥 [observeInstall] Attempt ${attempt} failed:`, error);
+					const isNetworkError = error?.message?.includes("Failed to fetch") || error?.message?.includes("NetworkError") || error?.message?.includes("network error") || error?.message?.includes("fetch") || error?.code === "NETWORK_ERROR" || error?.name === "TypeError";
+					console.warn(`ObserveStream attempt ${attempt}/${maxRetries} failed:`, error);
+					if (isNetworkError && attempt < maxRetries) {
+						console.info(`🔄 ObserveStream network error detected (likely hot reload), retrying in ${retryDelay}ms... (attempt ${attempt + 1}/${maxRetries})`);
+						await new Promise((resolve) => setTimeout(resolve, retryDelay));
+						continue;
+					}
+					console.error("❌ [observeInstall] Non-network error or max retries reached, throwing:", error);
+					throw error;
+				}
+			},
+			...queryOptions?.observeInstall
+		}),
+		streamResult,
+		isStreaming
+	};
+};
+//#endregion
+exports.useAgentBuilderWorkflow = useAgentBuilderWorkflow;
+exports.useCreateTemplateInstallRun = useCreateTemplateInstallRun;
+exports.useGetTemplateInstallRun = useGetTemplateInstallRun;
+exports.useMastraTemplates = useMastraTemplates;
+exports.useObserveStreamTemplateInstall = useObserveStreamTemplateInstall;
+exports.useStreamTemplateInstall = useStreamTemplateInstall;
+exports.useTemplateRepo = useTemplateRepo;
+exports.useTemplateRepoEnvVars = useTemplateRepoEnvVars;
+
+//# sourceMappingURL=index.cjs.map