@stigmer/react 0.5.1 → 1.0.1

package/workflow/useWorkflowExecutionEventLog.js

@@ -0,0 +1,59 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { GetEventLogRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { useFetch } from "../internal/useFetch";
+const INITIAL_DATA = {
+    events: [],
+    hasMore: false,
+    latestSequence: BigInt(0),
+};
+/**
+ * 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 function useWorkflowExecutionEventLog(executionId, options) {
+    const stigmer = useStigmer();
+    const pageSize = options?.pageSize ?? 100;
+    const afterSequence = options?.afterSequence ?? BigInt(0);
+    const eventTypes = options?.eventTypes ?? [];
+    const taskName = options?.taskName ?? "";
+    const fetchFn = executionId
+        ? async () => {
+            const resp = await stigmer.workflowExecution.getEventLog(create(GetEventLogRequestSchema, {
+                executionId,
+                afterSequence,
+                eventTypes: [...eventTypes],
+                taskName,
+                pageSize,
+            }));
+            return {
+                events: [...resp.events],
+                hasMore: resp.hasMore,
+                latestSequence: resp.latestSequence,
+            };
+        }
+        : null;
+    const { data, isLoading, isRefetching, error, refetch } = useFetch(fetchFn, [executionId, stigmer, pageSize, afterSequence, taskName, ...eventTypes], INITIAL_DATA);
+    return {
+        events: data.events,
+        hasMore: data.hasMore,
+        latestSequence: data.latestSequence,
+        isLoading,
+        isRefetching,
+        error,
+        refetch,
+    };
+}
+//# sourceMappingURL=useWorkflowExecutionEventLog.js.map

package/workflow/useWorkflowExecutionEventLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowExecutionEventLog.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionEventLog.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAIb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+DAA+D,CAAC;AACzG,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAsChD,MAAM,YAAY,GAAiB;IACjC,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,KAAK;IACd,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,4BAA4B,CAC1C,WAA0B,EAC1B,OAA6C;IAE7C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC;IAC1C,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IAEzC,MAAM,OAAO,GAAG,WAAW;QACzB,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,WAAW,CACtD,MAAM,CAAC,wBAAwB,EAAE;gBAC/B,WAAW;gBACX,aAAa;gBACb,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC;gBAC3B,QAAQ;gBACR,QAAQ;aACT,CAAC,CACH,CAAC;YACF,OAAO;gBACL,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;gBACxB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,cAAc,EAAE,IAAI,CAAC,cAAc;aACpC,CAAC;QACJ,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAChE,OAAO,EACP,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,EACxE,YAAY,CACb,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,SAAS;QACT,YAAY;QACZ,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC"}

package/workflow/useWorkflowExecutionEventStream.d.ts

@@ -0,0 +1,61 @@
+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";
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+import { WorkflowExecutionEventStore, type WorkflowEventStreamState, type DerivedTaskState, type DerivedCostSummary } from "../internal/store";
+/** Options for {@link useWorkflowExecutionEventStream}. */
+export interface UseWorkflowExecutionEventStreamOptions {
+    /** Filter to specific event types for the subscription. */
+    readonly eventTypes?: readonly WorkflowEventType[];
+    /**
+     * External store instance. When provided, the hook writes to this
+     * store instead of creating an internal one. Useful for sharing
+     * event state across multiple components.
+     */
+    readonly store?: WorkflowExecutionEventStore;
+    /**
+     * The current execution phase. When provided, the hook uses this to
+     * decide between live streaming (non-terminal) and batch loading
+     * (terminal). When omitted, defaults to live streaming.
+     */
+    readonly executionPhase?: ExecutionPhase;
+}
+/** Return value of {@link useWorkflowExecutionEventStream}. */
+export interface UseWorkflowExecutionEventStreamReturn {
+    /** All accumulated events, ordered by sequence_number ascending. */
+    readonly events: readonly WorkflowExecutionEvent[];
+    /** Derived task states from the event log. */
+    readonly taskStates: ReadonlyMap<string, DerivedTaskState>;
+    /** Derived cost/budget summary from the latest checkpoint or aggregation. */
+    readonly costSummary: DerivedCostSummary;
+    /** Stream lifecycle state. */
+    readonly streamState: WorkflowEventStreamState;
+    /** Total tasks declared in the execution_started event. */
+    readonly totalTasks: number;
+    /** `true` while receiving live events. */
+    readonly isStreaming: boolean;
+    /** `true` while connecting to the event stream. */
+    readonly isConnecting: boolean;
+    /** Error from the last failed stream attempt, or `null`. */
+    readonly error: Error | null;
+    /** Re-establish the stream subscription. */
+    readonly reconnect: () => void;
+}
+/**
+ * Behavior hook that manages a live event stream subscription for a
+ * workflow execution, or batch-loads events for completed executions.
+ *
+ * Internally maintains a {@link WorkflowExecutionEventStore} and
+ * exposes its state via `useSyncExternalStore` for efficient React
+ * integration.
+ *
+ * For running executions: subscribes via `subscribeEvents` with
+ * replay+live-tail. On disconnect, reconnects from the last received
+ * sequence number.
+ *
+ * For terminal executions: loads the full event log via paginated
+ * `getEventLog` calls.
+ *
+ * Pass `null` for `executionId` to skip (stable no-op).
+ */
+export declare function useWorkflowExecutionEventStream(executionId: string | null, options?: UseWorkflowExecutionEventStreamOptions): UseWorkflowExecutionEventStreamReturn;
+//# sourceMappingURL=useWorkflowExecutionEventStream.d.ts.map

package/workflow/useWorkflowExecutionEventStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowExecutionEventStream.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionEventStream.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kEAAkE,CAAC;AAC/G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AAM1G,OAAO,EAAE,cAAc,EAAE,MAAM,iEAAiE,CAAC;AAGjG,OAAO,EACL,2BAA2B,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,2DAA2D;AAC3D,MAAM,WAAW,sCAAsC;IACrD,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,2BAA2B,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAED,+DAA+D;AAC/D,MAAM,WAAW,qCAAqC;IACpD,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACnD,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC3D,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,8BAA8B;IAC9B,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;IAC/C,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;CAChC;AASD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE,sCAAsC,GAC/C,qCAAqC,CAqJvC"}

package/workflow/useWorkflowExecutionEventStream.js

@@ -0,0 +1,161 @@
+"use client";
+import { startTransition, useCallback, useEffect, useRef, useState, useSyncExternalStore, } from "react";
+import { create } from "@bufbuild/protobuf";
+import { GetEventLogRequestSchema, SubscribeEventsRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+import { WorkflowExecutionEventStore, } from "../internal/store";
+const TERMINAL_PHASES = new Set([
+    ExecutionPhase.EXECUTION_COMPLETED,
+    ExecutionPhase.EXECUTION_FAILED,
+    ExecutionPhase.EXECUTION_CANCELLED,
+    ExecutionPhase.EXECUTION_TERMINATED,
+]);
+/**
+ * Behavior hook that manages a live event stream subscription for a
+ * workflow execution, or batch-loads events for completed executions.
+ *
+ * Internally maintains a {@link WorkflowExecutionEventStore} and
+ * exposes its state via `useSyncExternalStore` for efficient React
+ * integration.
+ *
+ * For running executions: subscribes via `subscribeEvents` with
+ * replay+live-tail. On disconnect, reconnects from the last received
+ * sequence number.
+ *
+ * For terminal executions: loads the full event log via paginated
+ * `getEventLog` calls.
+ *
+ * Pass `null` for `executionId` to skip (stable no-op).
+ */
+export function useWorkflowExecutionEventStream(executionId, options) {
+    const stigmer = useStigmer();
+    const internalStoreRef = useRef(null);
+    if (!options?.store && !internalStoreRef.current) {
+        internalStoreRef.current = new WorkflowExecutionEventStore();
+    }
+    const store = options?.store ?? internalStoreRef.current;
+    const [connectKey, setConnectKey] = useState(0);
+    const reconnect = useCallback(() => {
+        setConnectKey((k) => k + 1);
+    }, []);
+    const eventTypes = options?.eventTypes;
+    const executionPhase = options?.executionPhase;
+    // Stable ref for values that should not trigger re-subscription
+    const storeRef = useRef(store);
+    storeRef.current = store;
+    useEffect(() => {
+        if (!executionId) {
+            store.reset();
+            return;
+        }
+        const abortController = new AbortController();
+        const currentStore = storeRef.current;
+        const isTerminal = executionPhase !== undefined && TERMINAL_PHASES.has(executionPhase);
+        if (isTerminal) {
+            // Batch-load all events for completed executions
+            currentStore.setStreamState({ stage: "connecting", executionId });
+            (async () => {
+                try {
+                    let afterSequence = BigInt(0);
+                    let hasMore = true;
+                    while (hasMore && !abortController.signal.aborted) {
+                        const resp = await stigmer.workflowExecution.getEventLog(create(GetEventLogRequestSchema, {
+                            executionId,
+                            afterSequence,
+                            eventTypes: eventTypes ? [...eventTypes] : [],
+                            pageSize: 500,
+                        }));
+                        if (abortController.signal.aborted)
+                            return;
+                        startTransition(() => {
+                            currentStore.appendEvents(resp.events);
+                        });
+                        hasMore = resp.hasMore;
+                        afterSequence = resp.latestSequence;
+                    }
+                    if (!abortController.signal.aborted) {
+                        currentStore.setStreamState({ stage: "complete", executionId });
+                    }
+                }
+                catch (err) {
+                    if (abortController.signal.aborted)
+                        return;
+                    currentStore.setStreamState({
+                        stage: "error",
+                        executionId,
+                        error: toError(err),
+                    });
+                }
+            })();
+        }
+        else {
+            // Live-stream events for running executions
+            currentStore.setStreamState({ stage: "connecting", executionId });
+            (async () => {
+                try {
+                    const afterSequence = currentStore.getLatestSequence();
+                    for await (const event of stigmer.workflowExecution.subscribeEvents(create(SubscribeEventsRequestSchema, {
+                        executionId,
+                        afterSequence,
+                        eventTypes: eventTypes ? [...eventTypes] : [],
+                    }), abortController.signal)) {
+                        if (abortController.signal.aborted)
+                            return;
+                        startTransition(() => {
+                            currentStore.appendEvents([event]);
+                            if (currentStore.getStreamState().stage === "connecting") {
+                                currentStore.setStreamState({ stage: "streaming", executionId });
+                            }
+                        });
+                    }
+                    if (!abortController.signal.aborted) {
+                        currentStore.setStreamState({ stage: "complete", executionId });
+                    }
+                }
+                catch (err) {
+                    if (abortController.signal.aborted)
+                        return;
+                    const error = toError(err);
+                    const isUnimplemented = error.message.includes("UNIMPLEMENTED") ||
+                        error.message.includes("unimplemented");
+                    if (isUnimplemented) {
+                        currentStore.setStreamState({ stage: "unsupported", executionId });
+                    }
+                    else {
+                        currentStore.setStreamState({
+                            stage: "error",
+                            executionId,
+                            error,
+                        });
+                    }
+                }
+            })();
+        }
+        return () => {
+            abortController.abort();
+        };
+    }, [executionId, stigmer, connectKey, executionPhase]);
+    // Read from store via useSyncExternalStore
+    const events = useSyncExternalStore(store.subscribe, store.getEvents);
+    const taskStates = useSyncExternalStore(store.subscribe, store.getTaskStates);
+    const costSummary = useSyncExternalStore(store.subscribe, store.getCostSummary);
+    const streamState = useSyncExternalStore(store.subscribe, store.getStreamState);
+    const totalTasks = useSyncExternalStore(store.subscribe, store.getTotalTasks);
+    const isStreaming = streamState.stage === "streaming";
+    const isConnecting = streamState.stage === "connecting";
+    const error = streamState.stage === "error" ? streamState.error : null;
+    return {
+        events,
+        taskStates,
+        costSummary,
+        streamState,
+        totalTasks,
+        isStreaming,
+        isConnecting,
+        error,
+        reconnect,
+    };
+}
+//# sourceMappingURL=useWorkflowExecutionEventStream.js.map

package/workflow/useWorkflowExecutionEventStream.js.map

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

package/workflow/useWorkflowExecutionList.d.ts

@@ -0,0 +1,49 @@
+import type { WorkflowExecution } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+/** Options for {@link useWorkflowExecutionList}. */
+export interface UseWorkflowExecutionListOptions {
+    /** Maximum executions per page. @default 20 */
+    readonly pageSize?: number;
+    /** Opaque page token for cursor-based pagination. */
+    readonly pageToken?: string;
+    /**
+     * Workflow or WorkflowInstance ID to scope executions.
+     * When omitted, lists all executions across all workflows.
+     */
+    readonly workflowId?: string | null;
+}
+/** Return value of {@link useWorkflowExecutionList}. */
+export interface UseWorkflowExecutionListReturn {
+    /** Execution entries for the current page. */
+    readonly executions: readonly WorkflowExecution[];
+    /** Total pages available at the current page size. */
+    readonly totalPages: number;
+    /** `true` while the initial fetch or a refetch 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 paginated list of workflow executions.
+ *
+ * When `workflowId` is provided, fetches executions for that specific
+ * workflow via `listByWorkflow()`. When omitted, fetches all executions
+ * across all workflows via `list()`.
+ *
+ * @example
+ * ```tsx
+ * // All executions
+ * const { executions, isLoading } = useWorkflowExecutionList();
+ *
+ * // Executions for a specific workflow
+ * const { executions } = useWorkflowExecutionList({
+ *   workflowId: workflow.metadata?.id,
+ *   pageSize: 10,
+ * });
+ * ```
+ */
+export declare function useWorkflowExecutionList(options?: UseWorkflowExecutionListOptions): UseWorkflowExecutionListReturn;
+//# sourceMappingURL=useWorkflowExecutionList.d.ts.map

package/workflow/useWorkflowExecutionList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowExecutionList.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionList.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AASxG,oDAAoD;AACpD,MAAM,WAAW,+BAA+B;IAC9C,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,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;AAYD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,+BAA+B,GACxC,8BAA8B,CAiDhC"}

package/workflow/useWorkflowExecutionList.js

@@ -0,0 +1,65 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { ListWorkflowExecutionsRequestSchema, ListWorkflowExecutionsByWorkflowRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { useFetch } from "../internal/useFetch";
+const INITIAL_DATA = {
+    executions: [],
+    totalPages: 0,
+};
+/**
+ * Data hook that fetches a paginated list of workflow executions.
+ *
+ * When `workflowId` is provided, fetches executions for that specific
+ * workflow via `listByWorkflow()`. When omitted, fetches all executions
+ * across all workflows via `list()`.
+ *
+ * @example
+ * ```tsx
+ * // All executions
+ * const { executions, isLoading } = useWorkflowExecutionList();
+ *
+ * // Executions for a specific workflow
+ * const { executions } = useWorkflowExecutionList({
+ *   workflowId: workflow.metadata?.id,
+ *   pageSize: 10,
+ * });
+ * ```
+ */
+export function useWorkflowExecutionList(options) {
+    const stigmer = useStigmer();
+    const pageSize = options?.pageSize ?? 20;
+    const pageToken = options?.pageToken ?? "";
+    const workflowId = options?.workflowId ?? null;
+    const fetchFn = async () => {
+        if (workflowId) {
+            const resp = await stigmer.workflowExecution.listByWorkflow(create(ListWorkflowExecutionsByWorkflowRequestSchema, {
+                workflowId,
+                pageSize,
+                pageToken,
+            }));
+            return {
+                executions: [...resp.entries],
+                totalPages: resp.totalPages,
+            };
+        }
+        const resp = await stigmer.workflowExecution.list(create(ListWorkflowExecutionsRequestSchema, {
+            pageSize,
+            pageToken,
+        }));
+        return {
+            executions: [...resp.entries],
+            totalPages: resp.totalPages,
+        };
+    };
+    const { data, isLoading, isRefetching, error, refetch, } = useFetch(fetchFn, [stigmer, workflowId, pageSize, pageToken], INITIAL_DATA);
+    return {
+        executions: data.executions,
+        totalPages: data.totalPages,
+        isLoading,
+        isRefetching,
+        error,
+        refetch,
+    };
+}
+//# sourceMappingURL=useWorkflowExecutionList.js.map

package/workflow/useWorkflowExecutionList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowExecutionList.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionList.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,mCAAmC,EACnC,6CAA6C,GAC9C,MAAM,+DAA+D,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAoChD,MAAM,YAAY,GAAsB;IACtC,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAyC;IAEzC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;IAE/C,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,cAAc,CACzD,MAAM,CAAC,6CAA6C,EAAE;gBACpD,UAAU;gBACV,QAAQ;gBACR,SAAS;aACV,CAAC,CACH,CAAC;YACF,OAAO;gBACL,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;gBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAC/C,MAAM,CAAC,mCAAmC,EAAE;YAC1C,QAAQ;YACR,SAAS;SACV,CAAC,CACH,CAAC;QACF,OAAO;YACL,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,EACJ,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,KAAK,EACL,OAAO,GACR,GAAG,QAAQ,CAAoB,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,YAAY,CAAC,CAAC;IAEnG,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS;QACT,YAAY;QACZ,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC"}

package/workflow/useWorkflowInstances.d.ts

@@ -0,0 +1,30 @@
+import type { WorkflowInstance } from "@stigmer/protos/ai/stigmer/agentic/workflowinstance/v1/api_pb";
+/** Return value of {@link useWorkflowInstances}. */
+export interface UseWorkflowInstancesReturn {
+    /** Instances for the given workflow, or empty array while loading. */
+    readonly instances: readonly WorkflowInstance[];
+    /** `true` while the initial fetch or a refetch 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 instances from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches all instances for a specific workflow.
+ *
+ * Wraps `stigmer.workflowInstance.getByWorkflow()` with loading
+ * and error state management. Used on the Workflow detail page
+ * "Instances" tab to show environment-bound deployments.
+ *
+ * Pass `null` as `workflowId` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { instances, isLoading } = useWorkflowInstances(workflow.metadata?.id);
+ * ```
+ */
+export declare function useWorkflowInstances(workflowId: string | null | undefined): UseWorkflowInstancesReturn;
+//# sourceMappingURL=useWorkflowInstances.d.ts.map

package/workflow/useWorkflowInstances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowInstances.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowInstances.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+DAA+D,CAAC;AAMtG,oDAAoD;AACpD,MAAM,WAAW,0BAA0B;IACzC,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,gEAAgE;IAChE,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,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACpC,0BAA0B,CAuB5B"}

package/workflow/useWorkflowInstances.js

@@ -0,0 +1,33 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { GetWorkflowInstancesByWorkflowRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/workflowinstance/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { useFetch } from "../internal/useFetch";
+/**
+ * Data hook that fetches all instances for a specific workflow.
+ *
+ * Wraps `stigmer.workflowInstance.getByWorkflow()` with loading
+ * and error state management. Used on the Workflow detail page
+ * "Instances" tab to show environment-bound deployments.
+ *
+ * Pass `null` as `workflowId` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { instances, isLoading } = useWorkflowInstances(workflow.metadata?.id);
+ * ```
+ */
+export function useWorkflowInstances(workflowId) {
+    const stigmer = useStigmer();
+    const fetchFn = workflowId
+        ? async () => {
+            const resp = await stigmer.workflowInstance.getByWorkflow(create(GetWorkflowInstancesByWorkflowRequestSchema, {
+                workflowId,
+            }));
+            return resp.entries ? [...resp.entries] : [];
+        }
+        : null;
+    const { data: instances, isLoading, isRefetching, error, refetch, } = useFetch(fetchFn, [workflowId, stigmer], []);
+    return { instances, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useWorkflowInstances.js.map

package/workflow/useWorkflowInstances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowInstances.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowInstances.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,2CAA2C,EAAE,MAAM,8DAA8D,CAAC;AAC3H,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAgBhD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAqC;IAErC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,UAAU;QACxB,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,aAAa,CACvD,MAAM,CAAC,2CAA2C,EAAE;gBAClD,UAAU;aACX,CAAC,CACH,CAAC;YACF,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,EACJ,IAAI,EAAE,SAAS,EACf,SAAS,EACT,YAAY,EACZ,KAAK,EACL,OAAO,GACR,GAAG,QAAQ,CAA8B,OAAO,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IAE9E,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAChE,CAAC"}

package/workflow/useWorkflowList.d.ts

@@ -0,0 +1,57 @@
+import type { SearchResult } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+import { type ResourceListScope } from "../search";
+/** Options for {@link useWorkflowList}. */
+export interface UseWorkflowListOptions {
+    /** Maximum workflows per page. @default 20 */
+    readonly pageSize?: number;
+    /** Page number (1-indexed). @default 1 */
+    readonly page?: number;
+    /** Text query to filter workflows by name, description, or tags. */
+    readonly query?: string;
+    /**
+     * Controls which workflows are visible.
+     *
+     * - `"org"` — only workflows owned by the given organization.
+     * - `"all"` — includes public/platform workflows.
+     *
+     * @default "org"
+     */
+    readonly scope?: ResourceListScope;
+}
+/** Return value of {@link useWorkflowList}. */
+export interface UseWorkflowListReturn {
+    /** Paginated workflow entries for the current page. */
+    readonly workflows: readonly SearchResult[];
+    /** Total number of workflows matching the current filters. */
+    readonly totalCount: number;
+    /** Total pages available at the current page size. */
+    readonly totalPages: number;
+    /** The current page number (mirrors the `page` option). */
+    readonly currentPage: number;
+    /** `true` while the initial fetch or a refetch is in flight. */
+    readonly isLoading: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch the current page from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a paginated list of workflows for the Workflows section.
+ *
+ * Wraps `stigmer.workflow.list()` with pagination, scope filtering,
+ * and text search. All parameters are externally controlled — the
+ * consumer manages page state, query debouncing, and scope toggling.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { workflows, totalCount, isLoading } = useWorkflowList("acme", {
+ *   page: 1,
+ *   pageSize: 20,
+ *   scope: "org",
+ * });
+ * ```
+ */
+export declare function useWorkflowList(org: string | null, options?: UseWorkflowListOptions): UseWorkflowListReturn;
+//# sourceMappingURL=useWorkflowList.d.ts.map

package/workflow/useWorkflowList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowList.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowList.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE/E,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEpE,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,qBAAqB,CAavB"}

package/workflow/useWorkflowList.js

@@ -0,0 +1,29 @@
+"use client";
+import { useCallback } from "react";
+import { useStigmer } from "../hooks";
+import { useResourceList } from "../search";
+/**
+ * Data hook that fetches a paginated list of workflows for the Workflows section.
+ *
+ * Wraps `stigmer.workflow.list()` with pagination, scope filtering,
+ * and text search. All parameters are externally controlled — the
+ * consumer manages page state, query debouncing, and scope toggling.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { workflows, totalCount, isLoading } = useWorkflowList("acme", {
+ *   page: 1,
+ *   pageSize: 20,
+ *   scope: "org",
+ * });
+ * ```
+ */
+export function useWorkflowList(org, options) {
+    const stigmer = useStigmer();
+    const listFn = useCallback((params) => stigmer.workflow.list(params), [stigmer]);
+    const { entries, totalCount, totalPages, currentPage, isLoading, error, refetch } = useResourceList(listFn, org, options);
+    return { workflows: entries, totalCount, totalPages, currentPage, isLoading, error, refetch };
+}
+//# sourceMappingURL=useWorkflowList.js.map

package/workflow/useWorkflowList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowList.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowList.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,eAAe,EAA0B,MAAM,WAAW,CAAC;AAuCpE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAkB,EAClB,OAAgC;IAEhC,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,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAC/E,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAExC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAChG,CAAC"}

package/workflow/useWorkflowSave.d.ts

@@ -0,0 +1,25 @@
+/** Return value of {@link useWorkflowSave}. */
+export interface UseWorkflowSaveReturn {
+    /**
+     * Parse the YAML and call `workflow.apply()` on the server.
+     * Returns `true` on success, `false` on failure (check `error`).
+     */
+    readonly save: (yaml: string) => Promise<boolean>;
+    /** `true` while a save request is in flight. */
+    readonly isSaving: boolean;
+    /** Error from the last failed save, or `null` on success. */
+    readonly error: Error | null;
+}
+/**
+ * Behavior hook that persists workflow YAML to the server via `apply()`.
+ *
+ * Parses the YAML into a `WorkflowInput`, calls `stigmer.workflow.apply()`,
+ * and returns success/failure state. Handles UNIMPLEMENTED gracefully
+ * (backend not yet deployed) with a descriptive error message.
+ *
+ * @param org - Organization slug for the target workflow.
+ *
+ * @since T10 (YAML Editor with Graph Preview)
+ */
+export declare function useWorkflowSave(org: string): UseWorkflowSaveReturn;
+//# sourceMappingURL=useWorkflowSave.d.ts.map

package/workflow/useWorkflowSave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowSave.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowSave.ts"],"names":[],"mappings":"AAMA,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAuClE"}