@stigmer/react 0.5.0 → 1.0.0

package/workflow/useGraphHistory.js

@@ -0,0 +1,106 @@
+"use client";
+import { useState, useCallback, useRef, useEffect } from "react";
+import { GraphHistory } from "./graph-commands";
+/**
+ * React wrapper around {@link GraphHistory} providing undo/redo state
+ * management and keyboard shortcut binding.
+ *
+ * Keyboard shortcuts (Ctrl/Cmd+Z, Ctrl/Cmd+Shift+Z) are only active
+ * when the referenced container element contains the active focus target,
+ * preventing conflicts with other editors on the page.
+ *
+ * @param initialModel - The starting graph model (from YAML parse).
+ * @param containerRef - Ref to the DOM element that scopes keyboard shortcuts.
+ *
+ * @since T15 Batch 2 (Node Authoring)
+ */
+export function useGraphHistory(initialModel, containerRef) {
+    const historyRef = useRef(null);
+    const [model, setModel] = useState(null);
+    const [, setVersion] = useState(0);
+    if (initialModel && !historyRef.current) {
+        historyRef.current = new GraphHistory(initialModel);
+        if (!model) {
+            setModel(initialModel);
+        }
+    }
+    const forceUpdate = useCallback(() => {
+        setVersion((v) => v + 1);
+    }, []);
+    const dispatch = useCallback((command) => {
+        const history = historyRef.current;
+        if (!history)
+            throw new Error("GraphHistory not initialized.");
+        const next = history.dispatch(command);
+        setModel(next);
+        forceUpdate();
+        return next;
+    }, [forceUpdate]);
+    const undo = useCallback(() => {
+        const history = historyRef.current;
+        if (!history?.canUndo)
+            return;
+        const next = history.undo();
+        setModel(next);
+        forceUpdate();
+    }, [forceUpdate]);
+    const redo = useCallback(() => {
+        const history = historyRef.current;
+        if (!history?.canRedo)
+            return;
+        const next = history.redo();
+        setModel(next);
+        forceUpdate();
+    }, [forceUpdate]);
+    const reset = useCallback((newModel) => {
+        if (historyRef.current) {
+            historyRef.current.reset(newModel);
+        }
+        else {
+            historyRef.current = new GraphHistory(newModel);
+        }
+        setModel(newModel);
+        forceUpdate();
+    }, [forceUpdate]);
+    // Keyboard shortcuts: Ctrl/Cmd+Z (undo), Ctrl/Cmd+Shift+Z (redo)
+    useEffect(() => {
+        const container = containerRef.current;
+        if (!container)
+            return;
+        function handleKeyDown(e) {
+            if (!container?.contains(document.activeElement) && document.activeElement !== container) {
+                return;
+            }
+            const isMod = e.metaKey || e.ctrlKey;
+            if (!isMod || e.key.toLowerCase() !== "z")
+                return;
+            e.preventDefault();
+            e.stopPropagation();
+            if (e.shiftKey) {
+                redo();
+            }
+            else {
+                undo();
+            }
+        }
+        document.addEventListener("keydown", handleKeyDown, true);
+        return () => document.removeEventListener("keydown", handleKeyDown, true);
+    }, [containerRef, undo, redo]);
+    const canUndo = historyRef.current?.canUndo ?? false;
+    const canRedo = historyRef.current?.canRedo ?? false;
+    const emptyModel = {
+        document: { dsl: "1.0.0", namespace: "", name: "", version: "0.0.1" },
+        nodes: [],
+        edges: [],
+    };
+    return {
+        currentModel: model ?? emptyModel,
+        canUndo,
+        canRedo,
+        dispatch,
+        undo,
+        redo,
+        reset,
+    };
+}
+//# sourceMappingURL=useGraphHistory.js.map

package/workflow/useGraphHistory.js.map

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

package/workflow/usePendingApprovals.d.ts

@@ -0,0 +1,35 @@
+import type { PendingApproval } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+export interface UsePendingApprovalsOptions {
+    /** Organization slug. When empty, the hook does not fetch. */
+    readonly org: string | null | undefined;
+    /** Maximum results per page. @default 20 */
+    readonly pageSize?: number;
+    /** Refetch interval in milliseconds. `0` or `false` disables. @default 30000 */
+    readonly refetchInterval?: number | false;
+}
+export interface UsePendingApprovalsReturn {
+    readonly approvals: readonly PendingApproval[];
+    readonly totalCount: number;
+    readonly isLoading: boolean;
+    readonly isRefetching: boolean;
+    readonly error: Error | null;
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches pending human_input approvals for an organization.
+ *
+ * Returns workflow executions with active human_input tasks awaiting
+ * reviewer decisions. Includes task name, requester, and timeout info.
+ *
+ * Auto-refreshes every 30 seconds by default since pending approvals
+ * are time-sensitive.
+ *
+ * @example
+ * ```tsx
+ * const { approvals, totalCount, isLoading } = usePendingApprovals({
+ *   org: "acme",
+ * });
+ * ```
+ */
+export declare function usePendingApprovals(options: UsePendingApprovalsOptions): UsePendingApprovalsReturn;
+//# sourceMappingURL=usePendingApprovals.d.ts.map

package/workflow/usePendingApprovals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePendingApprovals.d.ts","sourceRoot":"","sources":["../../src/workflow/usePendingApprovals.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+DAA+D,CAAC;AAKrG,MAAM,WAAW,0BAA0B;IACzC,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,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;AAYD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,yBAAyB,CAkC3B"}

package/workflow/usePendingApprovals.js

@@ -0,0 +1,50 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { ListPendingApprovalsRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { useFetch } from "../internal/useFetch";
+const INITIAL_DATA = {
+    approvals: [],
+    totalCount: 0,
+};
+/**
+ * Data hook that fetches pending human_input approvals for an organization.
+ *
+ * Returns workflow executions with active human_input tasks awaiting
+ * reviewer decisions. Includes task name, requester, and timeout info.
+ *
+ * Auto-refreshes every 30 seconds by default since pending approvals
+ * are time-sensitive.
+ *
+ * @example
+ * ```tsx
+ * const { approvals, totalCount, isLoading } = usePendingApprovals({
+ *   org: "acme",
+ * });
+ * ```
+ */
+export function usePendingApprovals(options) {
+    const stigmer = useStigmer();
+    const org = options.org ?? "";
+    const pageSize = options.pageSize ?? 20;
+    const refetchInterval = options.refetchInterval ?? 30_000;
+    const fetchFn = org
+        ? async () => {
+            const resp = await stigmer.workflowExecution.listPendingApprovals(create(ListPendingApprovalsRequestSchema, { org, pageSize }));
+            return {
+                approvals: [...resp.entries],
+                totalCount: resp.totalCount,
+            };
+        }
+        : null;
+    const { data, isLoading, isRefetching, error, refetch } = useFetch(fetchFn, [stigmer, org, pageSize], INITIAL_DATA, { refetchInterval: refetchInterval || false });
+    return {
+        approvals: data.approvals,
+        totalCount: data.totalCount,
+        isLoading,
+        isRefetching,
+        error,
+        refetch,
+    };
+}
+//# sourceMappingURL=usePendingApprovals.js.map

package/workflow/usePendingApprovals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePendingApprovals.js","sourceRoot":"","sources":["../../src/workflow/usePendingApprovals.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,iCAAiC,EAAE,MAAM,+DAA+D,CAAC;AAClH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAyBhD,MAAM,YAAY,GAAyB;IACzC,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAmC;IAEnC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IACxC,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,MAAM,CAAC;IAE1D,MAAM,OAAO,GAAG,GAAG;QACjB,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,oBAAoB,CAC/D,MAAM,CAAC,iCAAiC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAC7D,CAAC;YACF,OAAO;gBACL,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;gBAC5B,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,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,QAAQ,CAAC,EACxB,YAAY,EACZ,EAAE,eAAe,EAAE,eAAe,IAAI,KAAK,EAAE,CAC9C,CAAC;IAEJ,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS;QACT,YAAY;QACZ,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC"}

package/workflow/useRefineWorkflowFlow.d.ts

@@ -0,0 +1,75 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+/**
+ * Lifecycle phases for the workflow refinement flow.
+ *
+ * - `idle` — panel open, no conversation yet
+ * - `starting` — creating session (first turn) + execution
+ * - `streaming` — agent is working (tool calls, validation, refinement)
+ * - `complete` — agent finished, YAML was extracted (diff showing)
+ * - `ready` — agent finished without YAML (clarifying question / explanation),
+ *   or user accepted/discarded a previous result
+ * - `error` — a failure occurred (RPC, stream)
+ */
+export type RefinePhase = "idle" | "starting" | "streaming" | "complete" | "ready" | "error";
+/** Options for {@link useRefineWorkflowFlow}. */
+export interface UseRefineWorkflowFlowOptions {
+    /** Organization slug for session and execution creation. */
+    readonly org: string;
+    /** Live YAML from the editor. Captured via ref at send-time, not reactively. */
+    readonly currentYaml: string;
+    /** Called when any step fails. Also available via the `error` return. */
+    readonly onError?: (message: string) => void;
+}
+/** Return value of {@link useRefineWorkflowFlow}. */
+export interface UseRefineWorkflowFlowReturn {
+    /** Current lifecycle phase. */
+    readonly phase: RefinePhase;
+    /** Completed execution snapshots for MessageThread (chronological). */
+    readonly completedExecutions: readonly AgentExecution[];
+    /** Currently streaming execution, or null when idle/between turns. */
+    readonly activeExecution: AgentExecution | null;
+    /** `true` while the agent execution is actively streaming. */
+    readonly isStreaming: boolean;
+    /** Extracted YAML from the latest turn (null unless phase is `complete`). */
+    readonly extractedYaml: string | null;
+    /** Agent's explanation prose from the latest turn. */
+    readonly explanation: string | null;
+    /** Human-readable error message, or `null` when healthy. */
+    readonly error: string | null;
+    /** Send a refinement instruction. Creates session on first call. */
+    readonly sendInstruction: (instruction: string) => Promise<void>;
+    /** Accept the extracted YAML. Returns the YAML string. Transitions to `ready`. */
+    readonly acceptResult: () => string | null;
+    /** Discard the extracted YAML without applying. Transitions to `ready`. */
+    readonly discardResult: () => void;
+    /** Reset all state to initial values. Does not delete the server-side session. */
+    readonly reset: () => void;
+}
+/**
+ * Behavior hook that orchestrates agent-powered workflow refinement
+ * using the built-in Workflow Architect system agent.
+ *
+ * Manages a multi-turn conversation within a single Session:
+ * - First turn creates a Session + AgentExecution
+ * - Subsequent turns reuse the Session (conversational context)
+ * - Each turn streams agent messages via {@link useExecutionStream}
+ * - YAML is extracted from agent responses via {@link extractWorkflowYaml}
+ *
+ * The `currentYaml` prop is captured at send-time (ref-based, not reactive)
+ * and included in the message only when it differs from the last-sent version.
+ *
+ * Framework-agnostic (DD-004), referentially stable returns (DD-010).
+ *
+ * @example
+ * ```tsx
+ * const flow = useRefineWorkflowFlow({
+ *   org: "acme",
+ *   currentYaml: editor.yaml,
+ *   onError: (msg) => toast.error(msg),
+ * });
+ *
+ * <WorkflowRefinePanel flow={flow} onAccept={...} onClose={...} />
+ * ```
+ */
+export declare function useRefineWorkflowFlow(options: UseRefineWorkflowFlowOptions): UseRefineWorkflowFlowReturn;
+//# sourceMappingURL=useRefineWorkflowFlow.d.ts.map

package/workflow/useRefineWorkflowFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRefineWorkflowFlow.d.ts","sourceRoot":"","sources":["../../src/workflow/useRefineWorkflowFlow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAalG;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,UAAU,GACV,WAAW,GACX,UAAU,GACV,OAAO,GACP,OAAO,CAAC;AAEZ,iDAAiD;AACjD,MAAM,WAAW,4BAA4B;IAC3C,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,mBAAmB,EAAE,SAAS,cAAc,EAAE,CAAC;IACxD,sEAAsE;IACtE,QAAQ,CAAC,eAAe,EAAE,cAAc,GAAG,IAAI,CAAC;IAChD,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC3C,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;IACnC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,2BAA2B,CA0N7B"}

package/workflow/useRefineWorkflowFlow.js

@@ -0,0 +1,216 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { getUserMessage } from "@stigmer/sdk";
+import { useCreateSession } from "../session/useCreateSession";
+import { useCreateAgentExecution } from "../execution/useCreateAgentExecution";
+import { useExecutionStream } from "../execution/useExecutionStream";
+import { isTerminalPhase } from "../execution/execution-phases";
+import { useConversationStoreRef } from "../internal/store";
+import { extractWorkflowYaml, } from "./extract-workflow-yaml";
+const AGENT_REF = { org: "", slug: "workflow-architect" };
+const MIN_INSTRUCTION_LENGTH = 5;
+/**
+ * Behavior hook that orchestrates agent-powered workflow refinement
+ * using the built-in Workflow Architect system agent.
+ *
+ * Manages a multi-turn conversation within a single Session:
+ * - First turn creates a Session + AgentExecution
+ * - Subsequent turns reuse the Session (conversational context)
+ * - Each turn streams agent messages via {@link useExecutionStream}
+ * - YAML is extracted from agent responses via {@link extractWorkflowYaml}
+ *
+ * The `currentYaml` prop is captured at send-time (ref-based, not reactive)
+ * and included in the message only when it differs from the last-sent version.
+ *
+ * Framework-agnostic (DD-004), referentially stable returns (DD-010).
+ *
+ * @example
+ * ```tsx
+ * const flow = useRefineWorkflowFlow({
+ *   org: "acme",
+ *   currentYaml: editor.yaml,
+ *   onError: (msg) => toast.error(msg),
+ * });
+ *
+ * <WorkflowRefinePanel flow={flow} onAccept={...} onClose={...} />
+ * ```
+ */
+export function useRefineWorkflowFlow(options) {
+    const { org, currentYaml, onError } = options;
+    const [phase, setPhase] = useState("idle");
+    const [executionId, setExecutionId] = useState(null);
+    const [completedExecutions, setCompletedExecutions] = useState([]);
+    const [extracted, setExtracted] = useState(null);
+    const [error, setError] = useState(null);
+    const orgRef = useRef(org);
+    orgRef.current = org;
+    const yamlRef = useRef(currentYaml);
+    yamlRef.current = currentYaml;
+    const onErrorRef = useRef(onError);
+    onErrorRef.current = onError;
+    const sessionIdRef = useRef(null);
+    const lastSentYamlRef = useRef(null);
+    const prevTerminalRef = useRef(false);
+    const { create: createSession } = useCreateSession();
+    const { create: createExecution } = useCreateAgentExecution();
+    const conversationStore = useConversationStoreRef();
+    const stream = useExecutionStream(executionId, {
+        store: conversationStore,
+    });
+    // -------------------------------------------------------------------------
+    // Terminal phase detection — extract YAML or transition to ready
+    // -------------------------------------------------------------------------
+    useEffect(() => {
+        if (phase !== "streaming")
+            return;
+        const isTerminal = stream.phase !== ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED &&
+            isTerminalPhase(stream.phase);
+        if (isTerminal && !prevTerminalRef.current) {
+            prevTerminalRef.current = true;
+            if (stream.execution) {
+                setCompletedExecutions((prev) => [...prev, stream.execution]);
+            }
+            const result = extractWorkflowYaml(stream.execution);
+            if (result) {
+                setExtracted(result);
+                setPhase("complete");
+            }
+            else {
+                setPhase("ready");
+            }
+            setExecutionId(null);
+        }
+    }, [phase, stream.phase, stream.execution]);
+    // -------------------------------------------------------------------------
+    // Stream error surfacing
+    // -------------------------------------------------------------------------
+    useEffect(() => {
+        if (stream.error && phase === "streaming") {
+            const msg = getUserMessage(stream.error, "Agent stream interrupted");
+            setPhase("error");
+            setError(msg);
+            onErrorRef.current?.(msg);
+        }
+    }, [stream.error, phase]);
+    // -------------------------------------------------------------------------
+    // Build the message with optional YAML context
+    // -------------------------------------------------------------------------
+    const buildMessage = useCallback((instruction) => {
+        const capturedYaml = yamlRef.current;
+        const yamlChanged = capturedYaml !== lastSentYamlRef.current;
+        lastSentYamlRef.current = capturedYaml;
+        if (yamlChanged && capturedYaml) {
+            return ("Here is the current workflow YAML:\n\n" +
+                "```yaml\n" +
+                capturedYaml +
+                "\n```\n\n" +
+                instruction);
+        }
+        return instruction;
+    }, []);
+    // -------------------------------------------------------------------------
+    // Send a refinement instruction
+    // -------------------------------------------------------------------------
+    const sendInstruction = useCallback(async (instruction) => {
+        const trimmed = instruction.trim();
+        if (trimmed.length < MIN_INSTRUCTION_LENGTH) {
+            setError(`Instruction must be at least ${MIN_INSTRUCTION_LENGTH} characters`);
+            return;
+        }
+        if (phase !== "idle" &&
+            phase !== "ready" &&
+            phase !== "complete" &&
+            phase !== "error") {
+            return;
+        }
+        setPhase("starting");
+        setError(null);
+        setExtracted(null);
+        prevTerminalRef.current = false;
+        try {
+            let activeSessionId = sessionIdRef.current;
+            if (!activeSessionId) {
+                const { sessionId: newSessionId } = await createSession({
+                    org: orgRef.current,
+                    agentRef: { ...AGENT_REF, org: orgRef.current },
+                });
+                sessionIdRef.current = newSessionId;
+                activeSessionId = newSessionId;
+            }
+            const message = buildMessage(trimmed);
+            const { executionId: newExecutionId } = await createExecution({
+                org: orgRef.current,
+                sessionId: activeSessionId,
+                message,
+            });
+            setExecutionId(newExecutionId);
+            setPhase("streaming");
+        }
+        catch (err) {
+            const msg = getUserMessage(err, "Failed to start the Workflow Architect agent");
+            setPhase("error");
+            setError(msg);
+            onErrorRef.current?.(msg);
+        }
+    }, [phase, createSession, createExecution, buildMessage]);
+    // -------------------------------------------------------------------------
+    // Accept / discard extracted YAML
+    // -------------------------------------------------------------------------
+    const acceptResult = useCallback(() => {
+        if (phase !== "complete" || !extracted)
+            return null;
+        const yaml = extracted.yaml;
+        setExtracted(null);
+        setPhase("ready");
+        return yaml;
+    }, [phase, extracted]);
+    const discardResult = useCallback(() => {
+        if (phase !== "complete")
+            return;
+        setExtracted(null);
+        setPhase("ready");
+    }, [phase]);
+    // -------------------------------------------------------------------------
+    // Reset all state
+    // -------------------------------------------------------------------------
+    const reset = useCallback(() => {
+        setPhase("idle");
+        setExecutionId(null);
+        setCompletedExecutions([]);
+        setExtracted(null);
+        setError(null);
+        sessionIdRef.current = null;
+        lastSentYamlRef.current = null;
+        prevTerminalRef.current = false;
+    }, []);
+    // -------------------------------------------------------------------------
+    // Referentially stable return (DD-010)
+    // -------------------------------------------------------------------------
+    return useMemo(() => ({
+        phase,
+        completedExecutions,
+        activeExecution: stream.execution,
+        isStreaming: stream.isStreaming || stream.isConnecting,
+        extractedYaml: extracted?.yaml ?? null,
+        explanation: extracted?.explanation ?? null,
+        error,
+        sendInstruction,
+        acceptResult,
+        discardResult,
+        reset,
+    }), [
+        phase,
+        completedExecutions,
+        stream.execution,
+        stream.isStreaming,
+        stream.isConnecting,
+        extracted,
+        error,
+        sendInstruction,
+        acceptResult,
+        discardResult,
+        reset,
+    ]);
+}
+//# sourceMappingURL=useRefineWorkflowFlow.js.map

package/workflow/useRefineWorkflowFlow.js.map

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

package/workflow/useResolveAgentExecutionSession.d.ts

@@ -0,0 +1,33 @@
+/** Return value of {@link useResolveAgentExecutionSession}. */
+export interface UseResolveAgentExecutionSessionReturn {
+    /** The resolved session ID, or `null` while loading or on error. */
+    readonly sessionId: string | null;
+    /** `true` while the fetch is in flight. */
+    readonly isLoading: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+}
+/**
+ * Resolves an AgentExecution ID (`aex_*`) to its parent Session ID.
+ *
+ * This hook fetches the AgentExecution resource and extracts
+ * `spec.sessionId`. Use it when navigating from a workflow execution
+ * context (which knows the child agent execution ID) to the session
+ * page (which requires the session ID).
+ *
+ * Pass `null` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * function DrillDown({ agentExecutionId }: { agentExecutionId: string }) {
+ *   const { sessionId, isLoading } = useResolveAgentExecutionSession(agentExecutionId);
+ *   useEffect(() => {
+ *     if (sessionId) navigateToSession(sessionId);
+ *   }, [sessionId]);
+ *   if (isLoading) return <Spinner />;
+ *   return null;
+ * }
+ * ```
+ */
+export declare function useResolveAgentExecutionSession(agentExecutionId: string | null): UseResolveAgentExecutionSessionReturn;
+//# sourceMappingURL=useResolveAgentExecutionSession.d.ts.map

package/workflow/useResolveAgentExecutionSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolveAgentExecutionSession.d.ts","sourceRoot":"","sources":["../../src/workflow/useResolveAgentExecutionSession.ts"],"names":[],"mappings":"AAKA,+DAA+D;AAC/D,MAAM,WAAW,qCAAqC;IACpD,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,+BAA+B,CAC7C,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAC9B,qCAAqC,CAiBvC"}

package/workflow/useResolveAgentExecutionSession.js

@@ -0,0 +1,37 @@
+"use client";
+import { useStigmer } from "../hooks";
+import { useFetch } from "../internal/useFetch";
+/**
+ * Resolves an AgentExecution ID (`aex_*`) to its parent Session ID.
+ *
+ * This hook fetches the AgentExecution resource and extracts
+ * `spec.sessionId`. Use it when navigating from a workflow execution
+ * context (which knows the child agent execution ID) to the session
+ * page (which requires the session ID).
+ *
+ * Pass `null` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * function DrillDown({ agentExecutionId }: { agentExecutionId: string }) {
+ *   const { sessionId, isLoading } = useResolveAgentExecutionSession(agentExecutionId);
+ *   useEffect(() => {
+ *     if (sessionId) navigateToSession(sessionId);
+ *   }, [sessionId]);
+ *   if (isLoading) return <Spinner />;
+ *   return null;
+ * }
+ * ```
+ */
+export function useResolveAgentExecutionSession(agentExecutionId) {
+    const stigmer = useStigmer();
+    const fetchFn = agentExecutionId
+        ? async () => {
+            const execution = await stigmer.agentExecution.get(agentExecutionId);
+            return execution.spec?.sessionId ?? null;
+        }
+        : null;
+    const { data: sessionId, isLoading, error } = useFetch(fetchFn, [agentExecutionId, stigmer], null);
+    return { sessionId, isLoading, error };
+}
+//# sourceMappingURL=useResolveAgentExecutionSession.js.map

package/workflow/useResolveAgentExecutionSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolveAgentExecutionSession.js","sourceRoot":"","sources":["../../src/workflow/useResolveAgentExecutionSession.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAYhD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,+BAA+B,CAC7C,gBAA+B;IAE/B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,gBAAgB;QAC9B,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YACrE,OAAO,SAAS,CAAC,IAAI,EAAE,SAAS,IAAI,IAAI,CAAC;QAC3C,CAAC;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,QAAQ,CACpD,OAAO,EACP,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAC3B,IAAI,CACL,CAAC;IAEF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACzC,CAAC"}