@stigmer/react 0.5.0 → 1.0.0

package/workflow/useWorkflowCount.d.ts

@@ -0,0 +1,47 @@
+import { type ResourceListScope } from "../search";
+/** Options for {@link useWorkflowCount}. */
+export interface UseWorkflowCountOptions {
+    /** Text query to filter workflows before counting. */
+    readonly query?: string;
+    /**
+     * Controls which workflows are counted.
+     *
+     * - `"org"` — only workflows owned by the given organization.
+     * - `"all"` — includes public/platform workflows.
+     *
+     * @default "org"
+     */
+    readonly scope?: ResourceListScope;
+}
+/** Return value of {@link useWorkflowCount}. */
+export interface UseWorkflowCountReturn {
+    /**
+     * Total number of workflows matching the current filters. `undefined`
+     * until the first successful fetch completes.
+     */
+    readonly count: number | undefined;
+    /** `true` while the count fetch is in flight. */
+    readonly isLoading: boolean;
+    /** Error message from the last failed fetch, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Re-fetch the count with the same parameters. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches the total count of workflows.
+ *
+ * Issues a minimal `stigmer.workflow.list()` call to retrieve only the
+ * total count — no workflow entries are returned or stored. Useful for
+ * summary cards, badges, and dashboard widgets.
+ *
+ * For the full paginated workflow list, use {@link useWorkflowList} instead.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { count, isLoading } = useWorkflowCount("acme");
+ * ```
+ */
+export declare function useWorkflowCount(org: string | null, options?: UseWorkflowCountOptions): UseWorkflowCountReturn;
+//# sourceMappingURL=useWorkflowCount.d.ts.map

package/workflow/useWorkflowCount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowCount.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowCount.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAErE,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAED,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,CAAC,EAAE,uBAAuB,GAChC,sBAAsB,CAUxB"}

package/workflow/useWorkflowCount.js

@@ -0,0 +1,26 @@
+"use client";
+import { useCallback } from "react";
+import { useStigmer } from "../hooks";
+import { useResourceCount } from "../search";
+/**
+ * Data hook that fetches the total count of workflows.
+ *
+ * Issues a minimal `stigmer.workflow.list()` call to retrieve only the
+ * total count — no workflow entries are returned or stored. Useful for
+ * summary cards, badges, and dashboard widgets.
+ *
+ * For the full paginated workflow list, use {@link useWorkflowList} instead.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { count, isLoading } = useWorkflowCount("acme");
+ * ```
+ */
+export function useWorkflowCount(org, options) {
+    const stigmer = useStigmer();
+    const listFn = useCallback((params) => stigmer.workflow.list(params), [stigmer]);
+    return useResourceCount(listFn, org, options);
+}
+//# sourceMappingURL=useWorkflowCount.js.map

package/workflow/useWorkflowCount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowCount.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowCount.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAA0B,MAAM,WAAW,CAAC;AAgCrE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAkB,EAClB,OAAiC;IAEjC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,MAAmD,EAAE,EAAE,CACtD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAC/B,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/workflow/useWorkflowDashboardSummary.d.ts

@@ -0,0 +1,34 @@
+import type { ExecutionSummary } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+import { SummaryTimeWindow } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+export type { SummaryTimeWindow };
+export interface UseWorkflowDashboardSummaryOptions {
+    /** Organization slug. When empty, the hook does not fetch. */
+    readonly org: string | null | undefined;
+    /** Time window for aggregation. @default SUMMARY_TIME_WINDOW_LAST_7D */
+    readonly timeWindow?: SummaryTimeWindow;
+    /** Refetch interval in milliseconds. `0` or `false` disables. @default 0 */
+    readonly refetchInterval?: number | false;
+}
+export interface UseWorkflowDashboardSummaryReturn {
+    readonly summary: ExecutionSummary | null;
+    readonly isLoading: boolean;
+    readonly isRefetching: boolean;
+    readonly error: Error | null;
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches aggregated execution statistics for an organization.
+ *
+ * Returns phase counts, cost totals, average duration, top failing workflows,
+ * and per-workflow cost breakdowns — scoped to a configurable time window.
+ *
+ * @example
+ * ```tsx
+ * const { summary, isLoading } = useWorkflowDashboardSummary({
+ *   org: "acme",
+ *   timeWindow: SummaryTimeWindow.SUMMARY_TIME_WINDOW_LAST_7D,
+ * });
+ * ```
+ */
+export declare function useWorkflowDashboardSummary(options: UseWorkflowDashboardSummaryOptions): UseWorkflowDashboardSummaryReturn;
+//# sourceMappingURL=useWorkflowDashboardSummary.d.ts.map

package/workflow/useWorkflowDashboardSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowDashboardSummary.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowDashboardSummary.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+DAA+D,CAAC;AACtG,OAAO,EAEL,iBAAiB,EAClB,MAAM,+DAA+D,CAAC;AAIvE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,MAAM,WAAW,kCAAkC;IACjD,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC3C;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,kCAAkC,GAC1C,iCAAiC,CAwBnC"}

package/workflow/useWorkflowDashboardSummary.js

@@ -0,0 +1,33 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { GetExecutionSummaryRequestSchema, SummaryTimeWindow, } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { useFetch } from "../internal/useFetch";
+/**
+ * Data hook that fetches aggregated execution statistics for an organization.
+ *
+ * Returns phase counts, cost totals, average duration, top failing workflows,
+ * and per-workflow cost breakdowns — scoped to a configurable time window.
+ *
+ * @example
+ * ```tsx
+ * const { summary, isLoading } = useWorkflowDashboardSummary({
+ *   org: "acme",
+ *   timeWindow: SummaryTimeWindow.SUMMARY_TIME_WINDOW_LAST_7D,
+ * });
+ * ```
+ */
+export function useWorkflowDashboardSummary(options) {
+    const stigmer = useStigmer();
+    const org = options.org ?? "";
+    const timeWindow = options.timeWindow ?? SummaryTimeWindow.LAST_7D;
+    const refetchInterval = options.refetchInterval ?? 0;
+    const fetchFn = org
+        ? async () => {
+            return await stigmer.workflowExecution.getExecutionSummary(create(GetExecutionSummaryRequestSchema, { org, timeWindow }));
+        }
+        : null;
+    const { data, isLoading, isRefetching, error, refetch } = useFetch(fetchFn, [stigmer, org, timeWindow], null, { refetchInterval: refetchInterval || false });
+    return { summary: data, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useWorkflowDashboardSummary.js.map

package/workflow/useWorkflowDashboardSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowDashboardSummary.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowDashboardSummary.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EACL,gCAAgC,EAChC,iBAAiB,GAClB,MAAM,+DAA+D,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAqBhD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAA2C;IAE3C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;IAC9B,MAAM,UAAU,GACd,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC,OAAO,CAAC;IAClD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC;IAErD,MAAM,OAAO,GAAG,GAAG;QACjB,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,OAAO,MAAM,OAAO,CAAC,iBAAiB,CAAC,mBAAmB,CACxD,MAAM,CAAC,gCAAgC,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAC9D,CAAC;QACJ,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GACrD,QAAQ,CACN,OAAO,EACP,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC,EAC1B,IAAI,EACJ,EAAE,eAAe,EAAE,eAAe,IAAI,KAAK,EAAE,CAC9C,CAAC;IAEJ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACpE,CAAC"}

package/workflow/useWorkflowEditor.d.ts

@@ -0,0 +1,45 @@
+import type { Diagnostic } from "@codemirror/lint";
+import { useWorkflowTopology } from "./useWorkflowTopology";
+/** Options for {@link useWorkflowEditor}. */
+export interface UseWorkflowEditorOptions {
+    /** Organization slug for the save path. */
+    readonly org: string;
+}
+/** Return value of {@link useWorkflowEditor}. */
+export interface UseWorkflowEditorReturn {
+    /** Current YAML content in the editor. */
+    readonly yaml: string;
+    /** Update the YAML content (called by the editor on change). */
+    readonly setYaml: (value: string) => void;
+    /** CodeMirror-compatible diagnostics from the validation pipeline. */
+    readonly diagnostics: readonly Diagnostic[];
+    /** `true` when the editor content differs from the initial value. */
+    readonly isDirty: boolean;
+    /** `true` while a save request is in flight. */
+    readonly isSaving: boolean;
+    /** Error from the last failed save, or `null` on success. */
+    readonly saveError: Error | null;
+    /** Persist the current YAML to the server. Returns `true` on success. */
+    readonly save: () => Promise<boolean>;
+    /** Reset the editor to the initial YAML (discards changes). */
+    readonly reset: () => void;
+    /** Topology data for the graph preview. */
+    readonly topology: ReturnType<typeof useWorkflowTopology>;
+    /** Count of error-level diagnostics. */
+    readonly errorCount: number;
+    /** Count of warning-level diagnostics. */
+    readonly warningCount: number;
+}
+/**
+ * Behavior hook that orchestrates the workflow YAML editor experience.
+ *
+ * Composes the validation pipeline, topology computation, and save logic
+ * into a single return value that the `WorkflowEditorView` renders.
+ *
+ * @param initialYaml - The YAML string to initialize the editor with.
+ * @param options - Editor configuration (organization slug).
+ *
+ * @since T10 (YAML Editor with Graph Preview)
+ */
+export declare function useWorkflowEditor(initialYaml: string, options: UseWorkflowEditorOptions): UseWorkflowEditorReturn;
+//# sourceMappingURL=useWorkflowEditor.d.ts.map

package/workflow/useWorkflowEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowEditor.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowEditor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAK5D,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC,2CAA2C;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;IACjC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;IAC1D,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,wBAAwB,GAChC,uBAAuB,CAiDzB"}

package/workflow/useWorkflowEditor.js

@@ -0,0 +1,52 @@
+"use client";
+import { useCallback, useMemo, useRef, useState } from "react";
+import { useWorkflowValidation } from "./useWorkflowValidation";
+import { useWorkflowTopology } from "./useWorkflowTopology";
+import { useWorkflowSave } from "./useWorkflowSave";
+import { useTaskKindRegistry } from "./useTaskKindRegistry";
+/**
+ * Behavior hook that orchestrates the workflow YAML editor experience.
+ *
+ * Composes the validation pipeline, topology computation, and save logic
+ * into a single return value that the `WorkflowEditorView` renders.
+ *
+ * @param initialYaml - The YAML string to initialize the editor with.
+ * @param options - Editor configuration (organization slug).
+ *
+ * @since T10 (YAML Editor with Graph Preview)
+ */
+export function useWorkflowEditor(initialYaml, options) {
+    const [yaml, setYaml] = useState(initialYaml);
+    const initialRef = useRef(initialYaml);
+    const registry = useTaskKindRegistry();
+    const { diagnostics } = useWorkflowValidation(yaml, registry);
+    const topology = useWorkflowTopology(yaml);
+    const { save: applySave, isSaving, error: saveError } = useWorkflowSave(options.org);
+    const isDirty = yaml !== initialRef.current;
+    const save = useCallback(async () => {
+        const success = await applySave(yaml);
+        if (success) {
+            initialRef.current = yaml;
+        }
+        return success;
+    }, [applySave, yaml]);
+    const reset = useCallback(() => {
+        setYaml(initialRef.current);
+    }, []);
+    const errorCount = useMemo(() => diagnostics.filter((d) => d.severity === "error").length, [diagnostics]);
+    const warningCount = useMemo(() => diagnostics.filter((d) => d.severity === "warning").length, [diagnostics]);
+    return useMemo(() => ({
+        yaml,
+        setYaml,
+        diagnostics,
+        isDirty,
+        isSaving,
+        saveError,
+        save,
+        reset,
+        topology,
+        errorCount,
+        warningCount,
+    }), [yaml, setYaml, diagnostics, isDirty, isSaving, saveError, save, reset, topology, errorCount, warningCount]);
+}
+//# sourceMappingURL=useWorkflowEditor.js.map

package/workflow/useWorkflowEditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowEditor.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowEditor.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAkC5D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAAmB,EACnB,OAAiC;IAEjC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvC,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IACvC,MAAM,EAAE,WAAW,EAAE,GAAG,qBAAqB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAErF,MAAM,OAAO,GAAG,IAAI,KAAK,UAAU,CAAC,OAAO,CAAC;IAE5C,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,IAAsB,EAAE;QACpD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,OAAO,EAAE,CAAC;YACZ,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IAEtB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,UAAU,GAAG,OAAO,CACxB,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,EAC9D,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM,EAChE,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,IAAI;QACJ,OAAO;QACP,WAAW;QACX,OAAO;QACP,QAAQ;QACR,SAAS;QACT,IAAI;QACJ,KAAK;QACL,QAAQ;QACR,UAAU;QACV,YAAY;KACb,CAAC,EACF,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC,CAC5G,CAAC;AACJ,CAAC"}

package/workflow/useWorkflowExecution.d.ts

@@ -0,0 +1,37 @@
+import type { WorkflowExecution } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+/** Return value of {@link useWorkflowExecution}. */
+export interface UseWorkflowExecutionReturn {
+    /** The resolved execution, or `null` while loading, on error, or when not found. */
+    readonly execution: WorkflowExecution | null;
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight and stale data is shown. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a single WorkflowExecution by ID.
+ *
+ * Pass `null` for `executionId` to skip fetching (stable no-op).
+ * When the ID changes, the previous request is discarded and a
+ * fresh fetch begins.
+ *
+ * If the API returns NOT_FOUND, `execution` is set to `null`
+ * without raising an error.
+ *
+ * @example
+ * ```tsx
+ * function ExecutionHeader({ id }: { id: string }) {
+ *   const { execution, isLoading, error } = useWorkflowExecution(id);
+ *   if (isLoading) return <Skeleton />;
+ *   if (error) return <ErrorMessage error={error} />;
+ *   if (!execution) return <NotFound />;
+ *   return <h2>{execution.metadata?.name}</h2>;
+ * }
+ * ```
+ */
+export declare function useWorkflowExecution(executionId: string | null): UseWorkflowExecutionReturn;
+//# sourceMappingURL=useWorkflowExecution.d.ts.map

package/workflow/useWorkflowExecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowExecution.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecution.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AAKxG,oDAAoD;AACpD,MAAM,WAAW,0BAA0B;IACzC,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC7C,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,0BAA0B,CAsB5B"}

package/workflow/useWorkflowExecution.js

@@ -0,0 +1,43 @@
+"use client";
+import { isNotFound } from "@stigmer/sdk";
+import { useStigmer } from "../hooks";
+import { useFetch } from "../internal/useFetch";
+/**
+ * Data hook that fetches a single WorkflowExecution by ID.
+ *
+ * Pass `null` for `executionId` to skip fetching (stable no-op).
+ * When the ID changes, the previous request is discarded and a
+ * fresh fetch begins.
+ *
+ * If the API returns NOT_FOUND, `execution` is set to `null`
+ * without raising an error.
+ *
+ * @example
+ * ```tsx
+ * function ExecutionHeader({ id }: { id: string }) {
+ *   const { execution, isLoading, error } = useWorkflowExecution(id);
+ *   if (isLoading) return <Skeleton />;
+ *   if (error) return <ErrorMessage error={error} />;
+ *   if (!execution) return <NotFound />;
+ *   return <h2>{execution.metadata?.name}</h2>;
+ * }
+ * ```
+ */
+export function useWorkflowExecution(executionId) {
+    const stigmer = useStigmer();
+    const fetchFn = executionId
+        ? async () => {
+            try {
+                return await stigmer.workflowExecution.get(executionId);
+            }
+            catch (err) {
+                if (isNotFound(err))
+                    return null;
+                throw err;
+            }
+        }
+        : null;
+    const { data: execution, isLoading, isRefetching, error, refetch } = useFetch(fetchFn, [executionId, stigmer], null, { cacheKey: executionId ? `workflow-execution:${executionId}` : undefined });
+    return { execution, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useWorkflowExecution.js.map

package/workflow/useWorkflowExecution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowExecution.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecution.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAgBhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAA0B;IAE1B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,WAAW;QACzB,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC1D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,UAAU,CAAC,GAAG,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACjC,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAC3E,OAAO,EACP,CAAC,WAAW,EAAE,OAAO,CAAC,EACtB,IAAI,EACJ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAC5E,CAAC;IAEF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAChE,CAAC"}

package/workflow/useWorkflowExecutionActions.d.ts

@@ -0,0 +1,41 @@
+import type { WorkflowExecution } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+import type { ApprovalAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+/** Return value of {@link useWorkflowExecutionActions}. */
+export interface UseWorkflowExecutionActionsReturn {
+    /** Cancel a running execution gracefully. */
+    readonly cancel: (reason?: string) => Promise<WorkflowExecution | null>;
+    /** Terminate a running execution immediately. */
+    readonly terminate: (reason?: string) => Promise<WorkflowExecution | null>;
+    /** Pause a running execution. */
+    readonly pause: (reason?: string) => Promise<WorkflowExecution | null>;
+    /** Resume a paused execution. */
+    readonly resume: () => Promise<WorkflowExecution | null>;
+    /** Recover a failed execution from its last checkpoint. */
+    readonly recover: (reason?: string) => Promise<WorkflowExecution | null>;
+    /** Submit an approval decision for a child agent's tool execution. */
+    readonly submitApproval: (toolCallId: string, action: ApprovalAction, comment?: string) => Promise<WorkflowExecution | null>;
+    /** `true` while any action is in flight. */
+    readonly isSubmitting: boolean;
+    /** Error from the last failed action, or `null`. */
+    readonly error: Error | null;
+}
+/**
+ * Behavior hook that encapsulates workflow execution lifecycle actions.
+ *
+ * Each action calls the corresponding RPC and returns the updated
+ * execution, or `null` on failure (with `error` populated).
+ *
+ * Pass `null` for `executionId` to disable all actions (they become
+ * no-ops that return `null`).
+ *
+ * @example
+ * ```tsx
+ * const actions = useWorkflowExecutionActions(executionId);
+ *
+ * <button onClick={() => actions.cancel("No longer needed")} disabled={actions.isSubmitting}>
+ *   Cancel
+ * </button>
+ * ```
+ */
+export declare function useWorkflowExecutionActions(executionId: string | null): UseWorkflowExecutionActionsReturn;
+//# sourceMappingURL=useWorkflowExecutionActions.d.ts.map

package/workflow/useWorkflowExecutionActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowExecutionActions.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionActions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AACxG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAanG,2DAA2D;AAC3D,MAAM,WAAW,iCAAiC;IAChD,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACxE,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC3E,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACvE,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACzD,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACzE,sEAAsE;IACtE,QAAQ,CAAC,cAAc,EAAE,CACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,MAAM,KACb,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACvC,4CAA4C;IAC5C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,iCAAiC,CAqHnC"}

package/workflow/useWorkflowExecutionActions.js

@@ -0,0 +1,86 @@
+"use client";
+import { useCallback, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { CancelWorkflowExecutionInputSchema, TerminateWorkflowExecutionInputSchema, PauseWorkflowExecutionInputSchema, ResumeWorkflowExecutionInputSchema, RecoverWorkflowExecutionInputSchema, SubmitWorkflowApprovalInputSchema, } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Behavior hook that encapsulates workflow execution lifecycle actions.
+ *
+ * Each action calls the corresponding RPC and returns the updated
+ * execution, or `null` on failure (with `error` populated).
+ *
+ * Pass `null` for `executionId` to disable all actions (they become
+ * no-ops that return `null`).
+ *
+ * @example
+ * ```tsx
+ * const actions = useWorkflowExecutionActions(executionId);
+ *
+ * <button onClick={() => actions.cancel("No longer needed")} disabled={actions.isSubmitting}>
+ *   Cancel
+ * </button>
+ * ```
+ */
+export function useWorkflowExecutionActions(executionId) {
+    const stigmer = useStigmer();
+    const [isSubmitting, setIsSubmitting] = useState(false);
+    const [error, setError] = useState(null);
+    const executionIdRef = useRef(executionId);
+    executionIdRef.current = executionId;
+    const stigmerRef = useRef(stigmer);
+    stigmerRef.current = stigmer;
+    const wrap = useCallback(async (fn) => {
+        if (!executionIdRef.current)
+            return null;
+        setIsSubmitting(true);
+        setError(null);
+        try {
+            const result = await fn();
+            return result;
+        }
+        catch (err) {
+            setError(toError(err));
+            return null;
+        }
+        finally {
+            setIsSubmitting(false);
+        }
+    }, []);
+    const cancel = useCallback((reason) => wrap(() => stigmerRef.current.workflowExecution.cancel(create(CancelWorkflowExecutionInputSchema, {
+        id: executionIdRef.current,
+        reason: reason ?? "",
+    }))), [wrap]);
+    const terminate = useCallback((reason) => wrap(() => stigmerRef.current.workflowExecution.terminate(create(TerminateWorkflowExecutionInputSchema, {
+        id: executionIdRef.current,
+        reason: reason ?? "",
+    }))), [wrap]);
+    const pause = useCallback((reason) => wrap(() => stigmerRef.current.workflowExecution.pause(create(PauseWorkflowExecutionInputSchema, {
+        id: executionIdRef.current,
+        reason: reason ?? "",
+    }))), [wrap]);
+    const resume = useCallback(() => wrap(() => stigmerRef.current.workflowExecution.resume(create(ResumeWorkflowExecutionInputSchema, {
+        id: executionIdRef.current,
+    }))), [wrap]);
+    const recover = useCallback((reason) => wrap(() => stigmerRef.current.workflowExecution.recover(create(RecoverWorkflowExecutionInputSchema, {
+        id: executionIdRef.current,
+        reason: reason ?? "",
+    }))), [wrap]);
+    const submitApproval = useCallback((toolCallId, action, comment) => wrap(() => stigmerRef.current.workflowExecution.submitApproval(create(SubmitWorkflowApprovalInputSchema, {
+        executionId: executionIdRef.current,
+        toolCallId,
+        action,
+        comment: comment ?? "",
+    }))), [wrap]);
+    return {
+        cancel,
+        terminate,
+        pause,
+        resume,
+        recover,
+        submitApproval,
+        isSubmitting,
+        error,
+    };
+}
+//# sourceMappingURL=useWorkflowExecutionActions.js.map

package/workflow/useWorkflowExecutionActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowExecutionActions.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionActions.ts"],"names":[],"mappings":"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"}

package/workflow/useWorkflowExecutionArtifacts.d.ts

@@ -0,0 +1,26 @@
+import type { Artifact } from "@stigmer/protos/ai/stigmer/agentic/artifact/v1/api_pb";
+/** Return value of {@link useWorkflowExecutionArtifacts}. */
+export interface UseWorkflowExecutionArtifactsReturn {
+    /** Artifacts produced by this execution. */
+    readonly artifacts: readonly Artifact[];
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight and stale data is shown. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches artifacts produced by a workflow execution.
+ *
+ * Pass `null` for `executionId` to skip fetching.
+ *
+ * @example
+ * ```tsx
+ * const { artifacts, isLoading } = useWorkflowExecutionArtifacts(executionId);
+ * ```
+ */
+export declare function useWorkflowExecutionArtifacts(executionId: string | null): UseWorkflowExecutionArtifactsReturn;
+//# sourceMappingURL=useWorkflowExecutionArtifacts.d.ts.map

package/workflow/useWorkflowExecutionArtifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowExecutionArtifacts.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionArtifacts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AAMtF,6DAA6D;AAC7D,MAAM,WAAW,mCAAmC;IAClD,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,mCAAmC,CAsBrC"}

package/workflow/useWorkflowExecutionArtifacts.js

@@ -0,0 +1,29 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { ListArtifactsByExecutionRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/artifact/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { useFetch } from "../internal/useFetch";
+/**
+ * Data hook that fetches artifacts produced by a workflow execution.
+ *
+ * Pass `null` for `executionId` to skip fetching.
+ *
+ * @example
+ * ```tsx
+ * const { artifacts, isLoading } = useWorkflowExecutionArtifacts(executionId);
+ * ```
+ */
+export function useWorkflowExecutionArtifacts(executionId) {
+    const stigmer = useStigmer();
+    const fetchFn = executionId
+        ? async () => {
+            const resp = await stigmer.artifact.listByExecution(create(ListArtifactsByExecutionRequestSchema, {
+                workflowExecutionId: executionId,
+            }));
+            return [...resp.entries];
+        }
+        : null;
+    const { data: artifacts, isLoading, isRefetching, error, refetch } = useFetch(fetchFn, [executionId, stigmer], [], { cacheKey: executionId ? `workflow-execution-artifacts:${executionId}` : undefined });
+    return { artifacts, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useWorkflowExecutionArtifacts.js.map

package/workflow/useWorkflowExecutionArtifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowExecutionArtifacts.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionArtifacts.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,qCAAqC,EAAE,MAAM,sDAAsD,CAAC;AAC7G,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAgBhD;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAC3C,WAA0B;IAE1B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,WAAW;QACzB,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,eAAe,CACjD,MAAM,CAAC,qCAAqC,EAAE;gBAC5C,mBAAmB,EAAE,WAAW;aACjC,CAAC,CACH,CAAC;YACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAC3E,OAAO,EACP,CAAC,WAAW,EAAE,OAAO,CAAC,EACtB,EAAyB,EACzB,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CACtF,CAAC;IAEF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAChE,CAAC"}

package/workflow/useWorkflowExecutionEventLog.d.ts

@@ -0,0 +1,47 @@
+import type { WorkflowExecutionEvent } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/event_pb";
+import type { WorkflowEventType } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/event_pb";
+/** Options for {@link useWorkflowExecutionEventLog}. */
+export interface UseWorkflowExecutionEventLogOptions {
+    /** Maximum events per page. @default 100 */
+    readonly pageSize?: number;
+    /** Cursor: return events with sequence_number > this value. @default 0 */
+    readonly afterSequence?: bigint;
+    /** Filter to specific event types. When empty, all types are returned. */
+    readonly eventTypes?: readonly WorkflowEventType[];
+    /** Filter to events for a specific task name. */
+    readonly taskName?: string;
+}
+/** Return value of {@link useWorkflowExecutionEventLog}. */
+export interface UseWorkflowExecutionEventLogReturn {
+    /** Events in the current page, ordered by sequence_number ascending. */
+    readonly events: readonly WorkflowExecutionEvent[];
+    /** Whether more events exist after the last event in this response. */
+    readonly hasMore: boolean;
+    /** Highest sequence_number returned, for cursor-based pagination. */
+    readonly latestSequence: bigint;
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight and stale data is shown. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches the paginated event log for a workflow execution.
+ *
+ * Pass `null` for `executionId` to skip fetching. Supports cursor-based
+ * pagination via `afterSequence` and optional filters by event type or
+ * task name.
+ *
+ * @example
+ * ```tsx
+ * const { events, hasMore, latestSequence } = useWorkflowExecutionEventLog(
+ *   executionId,
+ *   { pageSize: 50 },
+ * );
+ * ```
+ */
+export declare function useWorkflowExecutionEventLog(executionId: string | null, options?: UseWorkflowExecutionEventLogOptions): UseWorkflowExecutionEventLogReturn;
+//# sourceMappingURL=useWorkflowExecutionEventLog.d.ts.map

package/workflow/useWorkflowExecutionEventLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowExecutionEventLog.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionEventLog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kEAAkE,CAAC;AAC/G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AAM1G,wDAAwD;AACxD,MAAM,WAAW,mCAAmC;IAClD,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnD,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,4DAA4D;AAC5D,MAAM,WAAW,kCAAkC;IACjD,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACnD,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAcD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE,mCAAmC,GAC5C,kCAAkC,CAyCpC"}