@mastra/playground-ui 59.0.0 → 60.0.0-alpha.1

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

@@ -0,0 +1,541 @@
+import { GetWorkflowRunByIdResponse, MastraClient } from '@mastra/client-js';
+import { UseMutationResult, UseQueryOptions } from '@tanstack/react-query';
+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: string | {
+        [x: string]: unknown;
+    };
+    createdAt: string;
+    updatedAt: string;
+    resourceId?: string | undefined | undefined;
+}, "snapshot"> & {
+    snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+})[];
+export declare const useWorkflowRuns: (workflowId: string, { enabled }?: {
+    enabled?: boolean;
+}) => {
+    setEndOfListElement: import('react').Dispatch<import('react').SetStateAction<HTMLDivElement | null>>;
+    data: (Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[];
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    fetchNextPage: (options?: import('@tanstack/react-query').FetchNextPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    fetchPreviousPage: (options?: import('@tanstack/react-query').FetchPreviousPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchNextPageError: boolean;
+    isFetchingNextPage: boolean;
+    isFetchPreviousPageError: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[]>;
+} | {
+    setEndOfListElement: import('react').Dispatch<import('react').SetStateAction<HTMLDivElement | null>>;
+    data: (Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[];
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    fetchNextPage: (options?: import('@tanstack/react-query').FetchNextPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    fetchPreviousPage: (options?: import('@tanstack/react-query').FetchPreviousPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[]>;
+} | {
+    setEndOfListElement: import('react').Dispatch<import('react').SetStateAction<HTMLDivElement | null>>;
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    fetchNextPage: (options?: import('@tanstack/react-query').FetchNextPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    fetchPreviousPage: (options?: import('@tanstack/react-query').FetchPreviousPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[]>;
+} | {
+    setEndOfListElement: import('react').Dispatch<import('react').SetStateAction<HTMLDivElement | null>>;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    fetchNextPage: (options?: import('@tanstack/react-query').FetchNextPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    fetchPreviousPage: (options?: import('@tanstack/react-query').FetchPreviousPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[]>;
+} | {
+    setEndOfListElement: import('react').Dispatch<import('react').SetStateAction<HTMLDivElement | null>>;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    fetchNextPage: (options?: import('@tanstack/react-query').FetchNextPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    fetchPreviousPage: (options?: import('@tanstack/react-query').FetchPreviousPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[]>;
+} | {
+    setEndOfListElement: import('react').Dispatch<import('react').SetStateAction<HTMLDivElement | null>>;
+    data: (Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[];
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    status: "success";
+    fetchNextPage: (options?: import('@tanstack/react-query').FetchNextPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    fetchPreviousPage: (options?: import('@tanstack/react-query').FetchPreviousPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[], Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<(Omit<{
+        workflowName: string;
+        runId: string;
+        snapshot: string | {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+        updatedAt: string;
+        resourceId?: string | undefined | undefined;
+    }, "snapshot"> & {
+        snapshot: string | import('@mastra/core/workflows').WorkflowRunState;
+    })[]>;
+};
+export declare const workflowRunQueryKey: (workflowId: string, runId: string) => readonly ["workflow-run", string, string];
+export declare const useWorkflowRun: (workflowId: string, runId: string, refetchInterval?: UseQueryOptions<GetWorkflowRunByIdResponse>["refetchInterval"]) => import('@tanstack/react-query').UseQueryResult<GetWorkflowRunByIdResponse, Error>;
+export declare const useDeleteWorkflowRun: (workflowId: string) => UseMutationResult<unknown, Error, {
+    runId: string;
+}>;
+export {};

package/dist/src/domains/workflows/hooks/use-workflow.d.ts

@@ -0,0 +1 @@
+export declare const useWorkflow: (workflowId?: string, requestContext?: Record<string, any>) => import('@tanstack/react-query').UseQueryResult<import('@mastra/client-js').GetWorkflowResponse | null, Error>;

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

@@ -0,0 +1,22 @@
+import { ListWorkflowRunCountsResponse } from '@mastra/client-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: (options?: {
+    requestContext?: Record<string, any>;
+}) => ListWorkflowRunCountsResponse;

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

@@ -0,0 +1,6 @@
+export declare const useWorkflows: (options?: {
+    requestContext?: Record<string, any>;
+    enabled?: boolean;
+}) => import('@tanstack/react-query').UseQueryResult<{
+    [k: string]: import('@mastra/client-js').GetWorkflowResponse;
+}, Error>;

package/dist/src/domains/workflows/index.d.ts

@@ -0,0 +1,16 @@
+export * from './context/workflow-run-context';
+export * from './context/workflow-run-provider';
+export * from './context/workflow-step-detail-context';
+export * from './context/workflow-step-detail-provider';
+export * from './context/workflow-selected-step-context';
+export * from './workflow/workflow-graph';
+export * from './workflow/workflow-trigger';
+export * from './context/use-current-run';
+export * from './runs/workflow-run-details';
+export * from './components/workflows-list/workflows-list';
+export * from './components/workflows-list/no-workflows-info';
+export * from './components/workflow-information';
+export * from './components/workflow-combobox';
+export * from './utils';
+export * from './hooks';
+export * from './components/workflow-layout';

package/dist/src/domains/workflows/runs/workflow-run-details.d.ts

@@ -0,0 +1,8 @@
+import { WorkflowRunContextType } from '../context/workflow-run-context';
+import { WorkflowTriggerProps } from '../workflow/workflow-trigger';
+export interface WorkflowRunDetailProps extends Omit<WorkflowTriggerProps, 'paramsRunId' | 'workflowId' | 'observeWorkflowStream'> {
+    workflowId: string;
+    runId?: string;
+    observeWorkflowStream?: WorkflowRunContextType['observeWorkflowStream'];
+}
+export declare const WorkflowRunDetail: ({ workflowId, runId, observeWorkflowStream, ...triggerProps }: WorkflowRunDetailProps) => import("react").JSX.Element;

package/dist/src/domains/workflows/runs/workflow-run-list.d.ts

@@ -0,0 +1,6 @@
+export interface WorkflowRecentRunsProps {
+    workflowId: string;
+    runId?: string;
+    canDelete: boolean;
+}
+export declare const WorkflowRecentRuns: ({ workflowId, runId, canDelete: canDeleteRun }: WorkflowRecentRunsProps) => import("react").JSX.Element;

package/dist/src/domains/workflows/utils/nested-workflows.d.ts

@@ -0,0 +1,49 @@
+import { GetWorkflowResponse } from '@mastra/client-js';
+export interface WorkflowListEntry extends GetWorkflowResponse {
+    id: string;
+}
+interface TreeRowBase {
+    /** Unique per rendered row — the same child under two parents expands independently. */
+    pathKey: string;
+    depth: number;
+    /**
+     * Connector guides for ancestor levels (index 0 = outermost): `true` means
+     * that ancestor has more siblings below, so its vertical guide line passes
+     * through this row.
+     */
+    guides: boolean[];
+    /** Last child among its siblings — the connector closes with an L shape. */
+    isLastChild: boolean;
+}
+export type WorkflowTreeRow = (TreeRowBase & {
+    kind: 'workflow';
+    workflow: WorkflowListEntry;
+    /** Direct nested workflow step ids (registered or inline), for the badge and expansion. */
+    nestedIds: string[];
+}) | (TreeRowBase & {
+    kind: 'inline';
+    /** Nested workflow that is not registered standalone — rendered as a non-link leaf row. */
+    stepId: string;
+    description?: string;
+});
+/**
+ * Ids of workflows composed directly as steps of this workflow. A directly
+ * nested workflow appears in the top-level `steps` record and carries the
+ * `isWorkflow` flag in `allSteps` (which also holds deeper `a.b` descendants).
+ */
+export declare function getDirectNestedWorkflowIds(workflow: GetWorkflowResponse): string[];
+/**
+ * Nested step ids reference the child workflow's own id (its `name`), while
+ * the registry record may be keyed differently (e.g. camelCase config keys).
+ * This index resolves a step id to the registry key by either route.
+ */
+export declare function buildRegistryIndex(workflowsById: Record<string, GetWorkflowResponse>): Map<string, string>;
+/**
+ * Flattens the visible rows of the workflows tree: every root, plus the
+ * children of each expanded row, depth-first. Registered children recurse as
+ * full workflow rows; inline-only nested workflows render as leaf rows. An
+ * ancestor guard drops a child already on its own ancestry path, so mutually
+ * nested workflows cannot expand forever.
+ */
+export declare function flattenWorkflowTree(roots: WorkflowListEntry[], workflowsById: Record<string, GetWorkflowResponse>, expandedPaths: ReadonlySet<string>): WorkflowTreeRow[];
+export {};