@acmekit/dashboard 2.13.33 → 2.13.35

package/dist/workflow-execution-rerun-WCYLYL3Q.mjs

@@ -0,0 +1,138 @@
+import {
+  useRunWorkflow,
+  useWorkflowExecution
+} from "./chunk-A7ULKHDE.mjs";
+import "./chunk-IUCDCPJU.mjs";
+import {
+  KeyboundForm,
+  RouteDrawer,
+  useRouteModal
+} from "./chunk-VEI6HW6L.mjs";
+import {
+  Form
+} from "./chunk-ND3ODI36.mjs";
+import "./chunk-FXYH54JP.mjs";
+import "./chunk-774WSTCC.mjs";
+import "./chunk-YKIWIMJX.mjs";
+import "./chunk-QZ7TP4HQ.mjs";
+
+// src/routes/workflow-executions/workflow-execution-rerun/workflow-execution-rerun.tsx
+import { zodResolver } from "@hookform/resolvers/zod";
+import { Button, Heading, Textarea, toast } from "@acmekit/ui";
+import { useForm } from "react-hook-form";
+import { useTranslation } from "react-i18next";
+import { useParams } from "react-router-dom";
+import * as zod from "zod";
+import { jsx, jsxs } from "react/jsx-runtime";
+var RerunSchema = zod.object({
+  input: zod.string().refine(
+    (val) => {
+      try {
+        JSON.parse(val);
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    { message: "Must be valid JSON" }
+  )
+});
+var WorkflowExecutionRerun = () => {
+  const { t } = useTranslation();
+  const { id } = useParams();
+  const { handleSuccess } = useRouteModal();
+  const {
+    workflow_execution,
+    isPending: isLoading,
+    isError,
+    error
+  } = useWorkflowExecution(id);
+  if (isError) {
+    throw error;
+  }
+  if (isLoading || !workflow_execution) {
+    return /* @__PURE__ */ jsx(RouteDrawer, { children: /* @__PURE__ */ jsx(RouteDrawer.Header, { children: /* @__PURE__ */ jsx(Heading, { children: t("workflowExecutions.rerun.title") }) }) });
+  }
+  return /* @__PURE__ */ jsxs(RouteDrawer, { children: [
+    /* @__PURE__ */ jsx(RouteDrawer.Header, { children: /* @__PURE__ */ jsx(Heading, { children: t("workflowExecutions.rerun.title") }) }),
+    /* @__PURE__ */ jsx(
+      RerunForm,
+      {
+        workflowId: workflow_execution.workflow_id,
+        defaultInput: workflow_execution?.context?.data?.payload || {},
+        onSuccess: handleSuccess
+      }
+    )
+  ] });
+};
+var RerunForm = ({
+  workflowId,
+  defaultInput,
+  onSuccess
+}) => {
+  const { t } = useTranslation();
+  const form = useForm({
+    defaultValues: {
+      input: JSON.stringify(defaultInput, null, 2)
+    },
+    resolver: zodResolver(RerunSchema)
+  });
+  const { mutateAsync, isPending } = useRunWorkflow(workflowId);
+  const handleSubmit = form.handleSubmit(async (values) => {
+    const parsed = JSON.parse(values.input);
+    await mutateAsync(
+      { input: parsed },
+      {
+        onSuccess: () => {
+          toast.success(t("workflowExecutions.rerun.success"));
+          onSuccess();
+        },
+        onError: (err) => {
+          toast.error(err.message);
+        }
+      }
+    );
+  });
+  return /* @__PURE__ */ jsx(RouteDrawer.Form, { form, children: /* @__PURE__ */ jsxs(
+    KeyboundForm,
+    {
+      onSubmit: handleSubmit,
+      className: "flex flex-1 flex-col overflow-hidden",
+      children: [
+        /* @__PURE__ */ jsxs(RouteDrawer.Body, { className: "flex max-w-full flex-1 flex-col gap-y-4 overflow-y-auto", children: [
+          /* @__PURE__ */ jsx("div", { className: "bg-ui-bg-field border-ui-border-base rounded-lg border px-3 py-2", children: /* @__PURE__ */ jsx("span", { className: "txt-compact-small text-ui-fg-muted", children: workflowId }) }),
+          /* @__PURE__ */ jsx(
+            Form.Field,
+            {
+              control: form.control,
+              name: "input",
+              render: ({ field }) => {
+                return /* @__PURE__ */ jsxs(Form.Item, { children: [
+                  /* @__PURE__ */ jsx(Form.Label, { children: t("workflowExecutions.rerun.inputLabel") }),
+                  /* @__PURE__ */ jsx(Form.Control, { children: /* @__PURE__ */ jsx(
+                    Textarea,
+                    {
+                      ...field,
+                      className: "font-mono text-xs",
+                      rows: 16
+                    }
+                  ) }),
+                  /* @__PURE__ */ jsx(Form.ErrorMessage, {})
+                ] });
+              }
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsx(RouteDrawer.Footer, { children: /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-end gap-x-2", children: [
+          /* @__PURE__ */ jsx(RouteDrawer.Close, { asChild: true, children: /* @__PURE__ */ jsx(Button, { size: "small", variant: "secondary", children: t("actions.cancel") }) }),
+          /* @__PURE__ */ jsx(Button, { size: "small", type: "submit", isLoading: isPending, children: t("workflowExecutions.rerun.submit") })
+        ] }) })
+      ]
+    }
+  ) });
+};
+var Component = WorkflowExecutionRerun;
+export {
+  Component,
+  WorkflowExecutionRerun
+};

package/dist/workflow-execution-run-MWN5KWNY.mjs

@@ -0,0 +1,135 @@
+import {
+  useRunWorkflow
+} from "./chunk-A7ULKHDE.mjs";
+import "./chunk-IUCDCPJU.mjs";
+import {
+  KeyboundForm,
+  RouteDrawer,
+  useRouteModal
+} from "./chunk-VEI6HW6L.mjs";
+import {
+  Form
+} from "./chunk-ND3ODI36.mjs";
+import "./chunk-FXYH54JP.mjs";
+import "./chunk-774WSTCC.mjs";
+import "./chunk-YKIWIMJX.mjs";
+import "./chunk-QZ7TP4HQ.mjs";
+
+// src/routes/workflow-executions/workflow-execution-run/workflow-execution-run.tsx
+import { zodResolver } from "@hookform/resolvers/zod";
+import { Button, Heading, Input, Textarea, toast } from "@acmekit/ui";
+import { useForm } from "react-hook-form";
+import { useTranslation } from "react-i18next";
+import * as zod from "zod";
+import { jsx, jsxs } from "react/jsx-runtime";
+var RunWorkflowSchema = zod.object({
+  workflow_id: zod.string().min(1, "Workflow ID is required"),
+  input: zod.string().refine(
+    (val) => {
+      if (!val.trim()) return true;
+      try {
+        JSON.parse(val);
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    { message: "Must be valid JSON" }
+  )
+});
+var WorkflowExecutionRun = () => {
+  const { t } = useTranslation();
+  const { handleSuccess } = useRouteModal();
+  return /* @__PURE__ */ jsxs(RouteDrawer, { children: [
+    /* @__PURE__ */ jsx(RouteDrawer.Header, { children: /* @__PURE__ */ jsx(Heading, { children: t("workflowExecutions.actions.runWorkflow") }) }),
+    /* @__PURE__ */ jsx(RunWorkflowForm, { onSuccess: handleSuccess })
+  ] });
+};
+var RunWorkflowForm = ({ onSuccess }) => {
+  const { t } = useTranslation();
+  const form = useForm({
+    defaultValues: {
+      workflow_id: "",
+      input: "{}"
+    },
+    resolver: zodResolver(RunWorkflowSchema)
+  });
+  const workflowId = form.watch("workflow_id");
+  const { mutateAsync, isPending } = useRunWorkflow(workflowId || "_placeholder");
+  const handleSubmit = form.handleSubmit(async (values) => {
+    const parsed = values.input.trim() ? JSON.parse(values.input) : {};
+    await mutateAsync(
+      { input: parsed },
+      {
+        onSuccess: () => {
+          toast.success(t("workflowExecutions.rerun.success"));
+          onSuccess();
+        },
+        onError: (err) => {
+          toast.error(err.message);
+        }
+      }
+    );
+  });
+  return /* @__PURE__ */ jsx(RouteDrawer.Form, { form, children: /* @__PURE__ */ jsxs(
+    KeyboundForm,
+    {
+      onSubmit: handleSubmit,
+      className: "flex flex-1 flex-col overflow-hidden",
+      children: [
+        /* @__PURE__ */ jsxs(RouteDrawer.Body, { className: "flex max-w-full flex-1 flex-col gap-y-4 overflow-y-auto", children: [
+          /* @__PURE__ */ jsx(
+            Form.Field,
+            {
+              control: form.control,
+              name: "workflow_id",
+              render: ({ field }) => {
+                return /* @__PURE__ */ jsxs(Form.Item, { children: [
+                  /* @__PURE__ */ jsx(Form.Label, { children: t("workflowExecutions.workflowIdLabel") }),
+                  /* @__PURE__ */ jsx(Form.Control, { children: /* @__PURE__ */ jsx(
+                    Input,
+                    {
+                      ...field,
+                      placeholder: "my-workflow-id"
+                    }
+                  ) }),
+                  /* @__PURE__ */ jsx(Form.ErrorMessage, {})
+                ] });
+              }
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            Form.Field,
+            {
+              control: form.control,
+              name: "input",
+              render: ({ field }) => {
+                return /* @__PURE__ */ jsxs(Form.Item, { children: [
+                  /* @__PURE__ */ jsx(Form.Label, { children: t("workflowExecutions.rerun.inputLabel") }),
+                  /* @__PURE__ */ jsx(Form.Control, { children: /* @__PURE__ */ jsx(
+                    Textarea,
+                    {
+                      ...field,
+                      className: "font-mono text-xs",
+                      rows: 12
+                    }
+                  ) }),
+                  /* @__PURE__ */ jsx(Form.ErrorMessage, {})
+                ] });
+              }
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsx(RouteDrawer.Footer, { children: /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-end gap-x-2", children: [
+          /* @__PURE__ */ jsx(RouteDrawer.Close, { asChild: true, children: /* @__PURE__ */ jsx(Button, { size: "small", variant: "secondary", children: t("actions.cancel") }) }),
+          /* @__PURE__ */ jsx(Button, { size: "small", type: "submit", isLoading: isPending, children: t("workflowExecutions.rerun.submit") })
+        ] }) })
+      ]
+    }
+  ) });
+};
+var Component = WorkflowExecutionRun;
+export {
+  Component,
+  WorkflowExecutionRun
+};

package/dist/workflow-scheduled-list-ZPXR7CZM.mjs

@@ -0,0 +1,174 @@
+import {
+  useWorkflowDefinitions
+} from "./chunk-GBPAZAJK.mjs";
+import {
+  SingleColumnPage
+} from "./chunk-RISX76YT.mjs";
+import {
+  useRunWorkflow
+} from "./chunk-A7ULKHDE.mjs";
+import "./chunk-FXYH54JP.mjs";
+import "./chunk-774WSTCC.mjs";
+import "./chunk-YKIWIMJX.mjs";
+import "./chunk-QZ7TP4HQ.mjs";
+
+// src/routes/workflow-scheduled/workflow-scheduled-list.tsx
+import { Badge, Button, Container, Heading, Text, toast } from "@acmekit/ui";
+import { keepPreviousData } from "@tanstack/react-query";
+import { formatDistanceToNow } from "date-fns";
+import { useTranslation } from "react-i18next";
+import { jsx, jsxs } from "react/jsx-runtime";
+function describeCron(cron) {
+  const parts = cron.trim().split(/\s+/);
+  if (parts.length < 5) return cron;
+  const [minute, hour, dom, month, dow] = parts;
+  if (minute === "*" && hour === "*" && dom === "*" && month === "*" && dow === "*") {
+    return "Every minute";
+  }
+  if (minute !== "*" && hour === "*" && dom === "*" && month === "*" && dow === "*") {
+    return `Every hour at minute ${minute}`;
+  }
+  if (minute !== "*" && hour !== "*" && dom === "*" && month === "*" && dow === "*") {
+    const h = parseInt(hour, 10);
+    const m = parseInt(minute, 10);
+    const ampm = h >= 12 ? "PM" : "AM";
+    const h12 = h % 12 || 12;
+    return `Daily at ${h12}:${String(m).padStart(2, "0")} ${ampm}`;
+  }
+  if (minute !== "*" && hour !== "*" && dom === "*" && month === "*" && dow !== "*") {
+    const days = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+    const dayNames = dow.split(",").map((d) => days[parseInt(d, 10)] ?? d).join(", ");
+    const h = parseInt(hour, 10);
+    const m = parseInt(minute, 10);
+    const ampm = h >= 12 ? "PM" : "AM";
+    const h12 = h % 12 || 12;
+    return `${dayNames} at ${h12}:${String(m).padStart(2, "0")} ${ampm}`;
+  }
+  if (minute !== "*" && hour !== "*" && dom !== "*" && month === "*" && dow === "*") {
+    return `Monthly on day ${dom} at ${hour}:${String(parseInt(minute, 10)).padStart(2, "0")}`;
+  }
+  return cron;
+}
+function getNextRunLabel(cron) {
+  try {
+    const parts = cron.trim().split(/\s+/);
+    if (parts.length < 5) return "Unknown";
+    const [minuteStr, hourStr] = parts;
+    const now = /* @__PURE__ */ new Date();
+    const next = new Date(now);
+    if (minuteStr === "*") {
+      next.setSeconds(0, 0);
+      next.setMinutes(now.getMinutes() + 1);
+    } else if (hourStr === "*") {
+      const m = parseInt(minuteStr, 10);
+      next.setMinutes(m, 0, 0);
+      if (next <= now) next.setHours(now.getHours() + 1);
+    } else {
+      const h = parseInt(hourStr, 10);
+      const m = parseInt(minuteStr, 10);
+      next.setHours(h, m, 0, 0);
+      if (next <= now) next.setDate(now.getDate() + 1);
+    }
+    return formatDistanceToNow(next, { addSuffix: true });
+  } catch {
+    return "Unknown";
+  }
+}
+var ScheduledRow = ({ def }) => {
+  const { t } = useTranslation();
+  const schedule = def.options?.schedule;
+  const cronStr = typeof schedule === "string" ? schedule : typeof schedule === "object" ? schedule?.cron ?? String(schedule?.interval ?? "") : "";
+  const humanSchedule = cronStr ? describeCron(cronStr) : "\u2014";
+  const nextRun = cronStr ? getNextRunLabel(cronStr) : "\u2014";
+  const { mutateAsync: runWorkflow, isPending } = useRunWorkflow(def.id);
+  const handleRunNow = async () => {
+    await runWorkflow(
+      { input: {} },
+      {
+        onSuccess: () => {
+          toast.success(t("workflowExecutions.actions.retrySuccess"));
+        }
+      }
+    );
+  };
+  return /* @__PURE__ */ jsxs("div", { className: "grid grid-cols-[1fr_1fr_1fr_auto] items-center gap-x-4 px-6 py-3", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-y-0.5", children: [
+      /* @__PURE__ */ jsx(Text, { size: "small", weight: "plus", leading: "compact", children: def.id }),
+      /* @__PURE__ */ jsxs(Text, { size: "xsmall", className: "text-ui-fg-muted", children: [
+        def.handler_count,
+        " ",
+        t("workflowExecutions.definitions.handlers")
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsx(Badge, { size: "2xsmall", className: "font-mono", children: cronStr || "\u2014" }),
+      /* @__PURE__ */ jsx(Text, { size: "xsmall", className: "text-ui-fg-subtle mt-0.5", children: humanSchedule })
+    ] }),
+    /* @__PURE__ */ jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: nextRun }),
+    /* @__PURE__ */ jsx(
+      Button,
+      {
+        size: "small",
+        variant: "secondary",
+        isLoading: isPending,
+        onClick: handleRunNow,
+        children: t("workflowExecutions.scheduled.runNow")
+      }
+    )
+  ] });
+};
+var WorkflowScheduledList = () => {
+  const { t } = useTranslation();
+  const { workflow_definitions, isPending } = useWorkflowDefinitions(
+    void 0,
+    { placeholderData: keepPreviousData }
+  );
+  const scheduled = (workflow_definitions ?? []).filter((def) => {
+    const opts = def.options;
+    return opts && (opts.schedule || opts.cron);
+  });
+  return /* @__PURE__ */ jsx(SingleColumnPage, { widgets: { before: [], after: [] }, children: /* @__PURE__ */ jsxs(Container, { className: "divide-y p-0", children: [
+    /* @__PURE__ */ jsx("div", { className: "flex items-center justify-between px-6 py-4", children: /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsx(Heading, { children: t("workflowExecutions.scheduled.domain") }),
+      /* @__PURE__ */ jsx(Text, { className: "text-ui-fg-subtle", size: "small", children: t("workflowExecutions.scheduled.subtitle") })
+    ] }) }),
+    /* @__PURE__ */ jsxs("div", { className: "grid grid-cols-[1fr_1fr_1fr_auto] gap-x-4 border-b border-ui-border-base px-6 py-2", children: [
+      /* @__PURE__ */ jsx(
+        Text,
+        {
+          size: "xsmall",
+          weight: "plus",
+          className: "text-ui-fg-subtle uppercase",
+          children: "Workflow"
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        Text,
+        {
+          size: "xsmall",
+          weight: "plus",
+          className: "text-ui-fg-subtle uppercase",
+          children: t("workflowExecutions.scheduled.schedule")
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        Text,
+        {
+          size: "xsmall",
+          weight: "plus",
+          className: "text-ui-fg-subtle uppercase",
+          children: t("workflowExecutions.scheduled.nextRun")
+        }
+      ),
+      /* @__PURE__ */ jsx("div", {})
+    ] }),
+    isPending && /* @__PURE__ */ jsx("div", { className: "px-6 py-4", children: /* @__PURE__ */ jsx(Text, { size: "small", className: "text-ui-fg-muted", children: "Loading..." }) }),
+    !isPending && scheduled.length === 0 && /* @__PURE__ */ jsx("div", { className: "px-6 py-8 text-center", children: /* @__PURE__ */ jsx(Text, { size: "small", className: "text-ui-fg-muted", children: t("workflowExecutions.scheduled.noRecordsMessage") }) }),
+    scheduled.map((def) => /* @__PURE__ */ jsx(ScheduledRow, { def }, def.id))
+  ] }) });
+};
+var Component = WorkflowScheduledList;
+export {
+  Component,
+  WorkflowScheduledList
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acmekit/dashboard",
-  "version": "2.13.33",
+  "version": "2.13.35",
   "scripts": {
     "generate:static": "node ./scripts/generate-currencies.js && prettier --write ./src/lib/currencies.ts",
     "dev": "../../../node_modules/.bin/vite",
@@ -39,10 +39,10 @@
     "dist"
   ],
   "dependencies": {
-    "@acmekit/admin-shared": "2.13.33",
-    "@acmekit/icons": "2.13.33",
-    "@acmekit/js-sdk": "2.13.33",
-    "@acmekit/ui": "4.1.29",
+    "@acmekit/admin-shared": "2.13.35",
+    "@acmekit/icons": "2.13.35",
+    "@acmekit/js-sdk": "2.13.35",
+    "@acmekit/ui": "4.1.31",
     "@ariakit/react": "^0.4.15",
     "@babel/runtime": "^7.26.10",
     "@dnd-kit/core": "^6.1.0",
@@ -80,10 +80,10 @@
     "zod": "3.25.76"
   },
   "devDependencies": {
-    "@acmekit/admin-shared": "2.13.33",
-    "@acmekit/admin-vite-plugin": "2.13.33",
-    "@acmekit/types": "2.13.33",
-    "@acmekit/ui-preset": "2.13.33"
+    "@acmekit/admin-shared": "2.13.35",
+    "@acmekit/admin-vite-plugin": "2.13.35",
+    "@acmekit/types": "2.13.35",
+    "@acmekit/ui-preset": "2.13.35"
   },
   "packageManager": "yarn@3.2.1"
 }

package/src/components/layout/main-layout/main-layout.tsx

@@ -1,4 +1,5 @@
 import {
+  Bolt,
   ChevronDownMini,
   CogSixTooth,
   EllipsisHorizontal,
@@ -128,7 +129,33 @@ const Header = () => {
 }
 
 const useCoreRoutes = (): Omit<INavItem, "pathname">[] => {
-  return []
+  const { t } = useTranslation()
+
+  return [
+    {
+      icon: <Bolt />,
+      label: t("workflowExecutions.domain"),
+      to: "/settings/workflows",
+      items: [
+        {
+          label: t("workflowExecutions.tabs.executions"),
+          to: "/settings/workflows",
+        },
+        {
+          label: t("workflowExecutions.tabs.definitions"),
+          to: "/settings/workflows/definitions",
+        },
+        {
+          label: t("workflowExecutions.tabs.scheduled"),
+          to: "/settings/workflows/scheduled",
+        },
+        {
+          label: t("workflowExecutions.tabs.analytics"),
+          to: "/settings/workflows/analytics",
+        },
+      ],
+    },
+  ]
 }
 
 const Searchbar = () => {

package/src/dashboard-app/routes/get-route.map.tsx

@@ -186,6 +186,15 @@ const defaultSettingsRouteChildren: RouteObject[] = [
         path: "",
         lazy: () =>
           import("../../routes/workflow-executions/workflow-execution-list"),
+        children: [
+          {
+            path: "run",
+            lazy: () =>
+              import(
+                "../../routes/workflow-executions/workflow-execution-run/workflow-execution-run"
+              ),
+          },
+        ],
       },
       {
         path: ":id",
@@ -203,6 +212,68 @@ const defaultSettingsRouteChildren: RouteObject[] = [
             },
           }
         },
+        children: [
+          {
+            path: "rerun",
+            lazy: () =>
+              import(
+                "../../routes/workflow-executions/workflow-execution-rerun/workflow-execution-rerun"
+              ),
+          },
+          {
+            path: "complete-step",
+            lazy: () =>
+              import(
+                "../../routes/workflow-executions/workflow-execution-complete-step/workflow-execution-complete-step"
+              ),
+          },
+        ],
+      },
+      {
+        path: "definitions",
+        element: <Outlet />,
+        handle: {
+          breadcrumb: () => t("workflowExecutions.definitions.domain"),
+        },
+        children: [
+          {
+            path: "",
+            lazy: () =>
+              import(
+                "../../routes/workflow-definitions/workflow-definition-list/workflow-definition-list"
+              ),
+          },
+          {
+            path: ":id",
+            lazy: () =>
+              import(
+                "../../routes/workflow-definitions/workflow-definition-detail/workflow-definition-detail"
+              ),
+            children: [
+              {
+                path: "run",
+                lazy: () =>
+                  import(
+                    "../../routes/workflow-executions/workflow-execution-run/workflow-execution-run"
+                  ),
+              },
+            ],
+          },
+        ],
+      },
+      {
+        path: "analytics",
+        lazy: () =>
+          import(
+            "../../routes/workflow-analytics/workflow-analytics"
+          ),
+      },
+      {
+        path: "scheduled",
+        lazy: () =>
+          import(
+            "../../routes/workflow-scheduled/workflow-scheduled-list"
+          ),
       },
     ],
   },

package/src/hooks/api/workflow-definitions.tsx

@@ -0,0 +1,79 @@
+import { QueryKey, UseQueryOptions, useQuery } from "@tanstack/react-query"
+import { sdk } from "../../lib/client"
+import { queryKeysFactory } from "../../lib/query-key-factory"
+import { FetchError } from "@acmekit/js-sdk"
+
+export type WorkflowDefinitionResponse = {
+  workflow_definitions: Array<{
+    id: string
+    handler_count: number
+    steps: Array<{
+      action: string
+      depth: number
+      noCompensation: boolean
+    }>
+    options: Record<string, unknown>
+  }>
+  count: number
+}
+
+export type WorkflowDefinitionDetailResponse = {
+  workflow_definition: {
+    id: string
+    handler_count: number
+    steps: Array<{
+      action: string
+      depth: number
+      noCompensation: boolean
+    }>
+    flow: Record<string, unknown> | null
+    options: Record<string, unknown>
+  }
+}
+
+const WORKFLOW_DEFINITIONS_QUERY_KEY = "workflow_definitions" as const
+export const workflowDefinitionsQueryKeys = queryKeysFactory(
+  WORKFLOW_DEFINITIONS_QUERY_KEY
+)
+
+export const useWorkflowDefinitions = (
+  query?: Record<string, unknown>,
+  options?: Omit<
+    UseQueryOptions<
+      WorkflowDefinitionResponse,
+      FetchError,
+      WorkflowDefinitionResponse,
+      QueryKey
+    >,
+    "queryKey" | "queryFn"
+  >
+) => {
+  const { data, ...rest } = useQuery({
+    queryFn: () => sdk.admin.workflowDefinition.list(query),
+    queryKey: workflowDefinitionsQueryKeys.list(query),
+    ...options,
+  })
+
+  return { ...data, ...rest }
+}
+
+export const useWorkflowDefinition = (
+  id: string,
+  options?: Omit<
+    UseQueryOptions<
+      WorkflowDefinitionDetailResponse,
+      FetchError,
+      WorkflowDefinitionDetailResponse,
+      QueryKey
+    >,
+    "queryKey" | "queryFn"
+  >
+) => {
+  const { data, ...rest } = useQuery({
+    queryFn: () => sdk.admin.workflowDefinition.retrieve(id),
+    queryKey: workflowDefinitionsQueryKeys.detail(id),
+    ...options,
+  })
+
+  return { ...data, ...rest }
+}