@stigmer/react 1.0.4 → 2.0.0

package/workflow/useActiveTaskName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActiveTaskName.js","sourceRoot":"","sources":["../../src/workflow/useActiveTaskName.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAuBhC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAiD;IAEjD,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,YAAY,GAA0B,IAAI,CAAC;QAC/C,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;YACvC,IAAI,KAAK,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;gBACxC,6DAA6D;gBAC7D,OAAO;oBACL,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,kBAAkB;oBAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,eAAe,EAAE,KAAK,CAAC,eAAe;oBACtC,eAAe,EAAE,CAAC;iBACnB,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/B,YAAY,EAAE,CAAC;gBACf,IAAI,CAAC,YAAY,EAAE,CAAC;oBAClB,YAAY,GAAG;wBACb,QAAQ,EAAE,IAAI;wBACd,MAAM,EAAE,SAAS;wBACjB,UAAU,EAAE,KAAK,CAAC,UAAU;wBAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,eAAe,EAAE,KAAK,CAAC,eAAe;wBACtC,eAAe,EAAE,CAAC;qBACnB,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,YAAY,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,EAAE,GAAG,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;QAC5D,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/workflow/useCanvasKeyboardShortcuts.d.ts

@@ -12,6 +12,9 @@ export interface UseCanvasKeyboardShortcutsOptions {
         y: number;
     }, sourceNodeId?: string) => void;
     readonly onDismiss: () => void;
+    readonly copySelection?: () => void;
+    readonly pasteAtCenter?: () => void;
+    readonly cutSelection?: () => void;
 }
 /**
  * Canvas-scoped keyboard shortcuts for the workflow editor.
@@ -25,10 +28,13 @@ export interface UseCanvasKeyboardShortcutsOptions {
  * |-------------------|---------------------------------------|
  * | `Ctrl/Cmd+D`      | Duplicate selected node               |
  * | `Ctrl/Cmd+A`      | Select all non-sentinel nodes         |
+ * | `Ctrl/Cmd+C`      | Copy selected node(s) to clipboard    |
+ * | `Ctrl/Cmd+V`      | Paste from clipboard                  |
+ * | `Ctrl/Cmd+X`      | Cut (copy + delete)                   |
  * | `N` (bare key)    | Open task picker                      |
  * | `Escape`          | Clear selection / close open overlays |
  *
  * @internal Not exported from the SDK barrel.
  */
-export declare function useCanvasKeyboardShortcuts({ containerRef, selection, duplicateNode, selectAll, clearSelection, onRequestTaskPicker, onDismiss, }: UseCanvasKeyboardShortcutsOptions): void;
+export declare function useCanvasKeyboardShortcuts({ containerRef, selection, duplicateNode, selectAll, clearSelection, onRequestTaskPicker, onDismiss, copySelection, pasteAtCenter, cutSelection, }: UseCanvasKeyboardShortcutsOptions): void;
 //# sourceMappingURL=useCanvasKeyboardShortcuts.d.ts.map

package/workflow/useCanvasKeyboardShortcuts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCanvasKeyboardShortcuts.d.ts","sourceRoot":"","sources":["../../src/workflow/useCanvasKeyboardShortcuts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,sDAAsD;AACtD,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,CAC5B,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAClC,YAAY,CAAC,EAAE,MAAM,KAClB,IAAI,CAAC;IACV,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;CAChC;AAgBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,YAAY,EACZ,SAAS,EACT,aAAa,EACb,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,SAAS,GACV,EAAE,iCAAiC,GAAG,IAAI,CA0E1C"}
+{"version":3,"file":"useCanvasKeyboardShortcuts.d.ts","sourceRoot":"","sources":["../../src/workflow/useCanvasKeyboardShortcuts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,sDAAsD;AACtD,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,CAC5B,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAClC,YAAY,CAAC,EAAE,MAAM,KAClB,IAAI,CAAC;IACV,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CACpC;AAgBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,YAAY,EACZ,SAAS,EACT,aAAa,EACb,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,aAAa,EACb,aAAa,EACb,YAAY,GACb,EAAE,iCAAiC,GAAG,IAAI,CAwG1C"}

package/workflow/useCanvasKeyboardShortcuts.js

@@ -28,12 +28,15 @@ function isFocusInsideContainer(container) {
  * |-------------------|---------------------------------------|
  * | `Ctrl/Cmd+D`      | Duplicate selected node               |
  * | `Ctrl/Cmd+A`      | Select all non-sentinel nodes         |
+ * | `Ctrl/Cmd+C`      | Copy selected node(s) to clipboard    |
+ * | `Ctrl/Cmd+V`      | Paste from clipboard                  |
+ * | `Ctrl/Cmd+X`      | Cut (copy + delete)                   |
  * | `N` (bare key)    | Open task picker                      |
  * | `Escape`          | Clear selection / close open overlays |
  *
  * @internal Not exported from the SDK barrel.
  */
-export function useCanvasKeyboardShortcuts({ containerRef, selection, duplicateNode, selectAll, clearSelection, onRequestTaskPicker, onDismiss, }) {
+export function useCanvasKeyboardShortcuts({ containerRef, selection, duplicateNode, selectAll, clearSelection, onRequestTaskPicker, onDismiss, copySelection, pasteAtCenter, cutSelection, }) {
     useEffect(() => {
         const container = containerRef.current;
         if (!container)
@@ -60,6 +63,33 @@ export function useCanvasKeyboardShortcuts({ containerRef, selection, duplicateN
                 selectAll();
                 return;
             }
+            // Ctrl/Cmd+C — copy selection
+            if (isMod && !e.shiftKey && !e.altKey && e.key.toLowerCase() === "c") {
+                if (isTextInput(e.target))
+                    return;
+                e.preventDefault();
+                e.stopPropagation();
+                copySelection?.();
+                return;
+            }
+            // Ctrl/Cmd+V — paste
+            if (isMod && !e.shiftKey && !e.altKey && e.key.toLowerCase() === "v") {
+                if (isTextInput(e.target))
+                    return;
+                e.preventDefault();
+                e.stopPropagation();
+                pasteAtCenter?.();
+                return;
+            }
+            // Ctrl/Cmd+X — cut
+            if (isMod && !e.shiftKey && !e.altKey && e.key.toLowerCase() === "x") {
+                if (isTextInput(e.target))
+                    return;
+                e.preventDefault();
+                e.stopPropagation();
+                cutSelection?.();
+                return;
+            }
             // Bare-key shortcuts — skip when typing in a text field
             if (isMod || e.altKey)
                 return;
@@ -103,6 +133,9 @@ export function useCanvasKeyboardShortcuts({ containerRef, selection, duplicateN
         clearSelection,
         onRequestTaskPicker,
         onDismiss,
+        copySelection,
+        pasteAtCenter,
+        cutSelection,
     ]);
 }
 //# sourceMappingURL=useCanvasKeyboardShortcuts.js.map

package/workflow/useCanvasKeyboardShortcuts.js.map

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

package/workflow/useDiagnoseExecutionFlow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDiagnoseExecutionFlow.d.ts","sourceRoot":"","sources":["../../src/workflow/useDiagnoseExecutionFlow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAalG;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,UAAU,GACV,WAAW,GACX,UAAU,GACV,OAAO,GACP,OAAO,CAAC;AAEZ,oDAAoD;AACpD,MAAM,WAAW,+BAA+B;IAC9C,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,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,iFAAiF;IACjF,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,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,sFAAsF;IACtF,QAAQ,CAAC,SAAS,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACxC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAuQhC"}
+{"version":3,"file":"useDiagnoseExecutionFlow.d.ts","sourceRoot":"","sources":["../../src/workflow/useDiagnoseExecutionFlow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAclG;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,UAAU,GACV,WAAW,GACX,UAAU,GACV,OAAO,GACP,OAAO,CAAC;AAEZ,oDAAoD;AACpD,MAAM,WAAW,+BAA+B;IAC9C,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,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,iFAAiF;IACjF,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,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,sFAAsF;IACtF,QAAQ,CAAC,SAAS,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACxC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CA6RhC"}

package/workflow/useDiagnoseExecutionFlow.js

@@ -8,6 +8,7 @@ import { useExecutionStream } from "../execution/useExecutionStream";
 import { isTerminalPhase } from "../execution/execution-phases";
 import { useConversationStoreRef } from "../internal/store";
 import { extractWorkflowYaml, } from "./extract-workflow-yaml";
+import { WORKFLOW_DIAGNOSIS_RESPONSE_SCHEMA } from "./architect-response-schema";
 const AGENT_REF = { org: "", slug: "workflow-architect" };
 const MIN_FOLLOWUP_LENGTH = 5;
 /**
@@ -83,13 +84,31 @@ export function useDiagnoseExecutionFlow(options) {
             if (stream.execution) {
                 setCompletedExecutions((prev) => [...prev, stream.execution]);
             }
-            const result = extractWorkflowYaml(stream.execution);
-            if (result) {
-                setExtracted(result);
-                setPhase("complete");
+            // Primary: read from structured output (deterministic)
+            const structuredOutput = stream.execution?.status?.structuredOutput;
+            if (structuredOutput) {
+                const action = structuredOutput.action;
+                const yaml = structuredOutput.yaml;
+                const explanation = structuredOutput.explanation;
+                if (action === "fix_yaml" && yaml) {
+                    setExtracted({ yaml, explanation: explanation ?? "" });
+                    setPhase("complete");
+                }
+                else {
+                    // diagnosis or clarification — no YAML fix
+                    setPhase("ready");
+                }
             }
             else {
-                setPhase("ready");
+                // Fallback: regex extraction (backward compat / extraction failure)
+                const result = extractWorkflowYaml(stream.execution);
+                if (result) {
+                    setExtracted(result);
+                    setPhase("complete");
+                }
+                else {
+                    setPhase("ready");
+                }
             }
             setActiveExecutionId(null);
         }
@@ -130,6 +149,7 @@ export function useDiagnoseExecutionFlow(options) {
                 org: orgRef.current,
                 sessionId: activeSessionId,
                 message,
+                structuredOutputSchema: WORKFLOW_DIAGNOSIS_RESPONSE_SCHEMA,
             });
             setActiveExecutionId(newExecutionId);
             setPhase("streaming");
@@ -173,6 +193,7 @@ export function useDiagnoseExecutionFlow(options) {
                 org: orgRef.current,
                 sessionId: activeSessionId,
                 message: trimmed,
+                structuredOutputSchema: WORKFLOW_DIAGNOSIS_RESPONSE_SCHEMA,
             });
             setActiveExecutionId(newExecutionId);
             setPhase("streaming");

package/workflow/useDiagnoseExecutionFlow.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDiagnoseExecutionFlow.js","sourceRoot":"","sources":["../../src/workflow/useDiagnoseExecutionFlow.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EACL,mBAAmB,GAEpB,MAAM,yBAAyB,CAAC;AAkEjC,MAAM,SAAS,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAW,CAAC;AACnE,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAwC;IAExC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAEhE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,MAAM,CAAC,CAAC;IAC1D,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,QAAQ,CACxD,IAAI,CACL,CAAC;IACF,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,GAAG,QAAQ,CAE5D,EAAE,CAAC,CAAC;IACN,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CACxC,IAAI,CACL,CAAC;IACF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;IACrB,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3C,cAAc,CAAC,OAAO,GAAG,WAAW,CAAC;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,MAAM,YAAY,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IACjD,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAErC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACrD,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAC9D,MAAM,iBAAiB,GAAG,uBAAuB,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,kBAAkB,CAAC,iBAAiB,EAAE;QACnD,KAAK,EAAE,iBAAiB;KACzB,CAAC,CAAC;IAEH,8EAA8E;IAC9E,sCAAsC;IACtC,8EAA8E;IAC9E,MAAM,qBAAqB,GAAG,WAAW,CAAC,GAAW,EAAE;QACrD,OAAO,CACL,4CAA4C,cAAc,CAAC,OAAO,SAAS;YAC3E,4EAA4E;YAC5E,qEAAqE;YACrE,yFAAyF,CAC1F,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,8EAA8E;IAC9E,iEAAiE;IACjE,8EAA8E;IAC9E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,KAAK,WAAW;YAAE,OAAO;QAElC,MAAM,UAAU,GACd,MAAM,CAAC,KAAK,KAAK,cAAc,CAAC,2BAA2B;YAC3D,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEhC,IAAI,UAAU,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;YAC3C,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;YAE/B,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,sBAAsB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,SAAU,CAAC,CAAC,CAAC;YACjE,CAAC;YAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,MAAM,EAAE,CAAC;gBACX,YAAY,CAAC,MAAM,CAAC,CAAC;gBACrB,QAAQ,CAAC,UAAU,CAAC,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpB,CAAC;YAED,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IAE5C,8EAA8E;IAC9E,yBAAyB;IACzB,8EAA8E;IAC9E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM,CAAC,KAAK,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;YAC1C,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;YACrE,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClB,QAAQ,CAAC,GAAG,CAAC,CAAC;YACd,UAAU,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAE1B,8EAA8E;IAC9E,iCAAiC;IACjC,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACtC,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO;YAAE,OAAO;QAElD,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,eAAe,CAAC,OAAO,GAAG,KAAK,CAAC;QAEhC,IAAI,CAAC;YACH,IAAI,eAAe,GAAG,YAAY,CAAC,OAAO,CAAC;YAE3C,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,aAAa,CAAC;oBACtD,GAAG,EAAE,MAAM,CAAC,OAAO;oBACnB,QAAQ,EAAE,EAAE,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE;iBAChD,CAAC,CAAC;gBACH,YAAY,CAAC,OAAO,GAAG,YAAY,CAAC;gBACpC,eAAe,GAAG,YAAY,CAAC;YACjC,CAAC;YAED,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;YAExC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,MAAM,eAAe,CAAC;gBAC5D,GAAG,EAAE,MAAM,CAAC,OAAO;gBACnB,SAAS,EAAE,eAAe;gBAC1B,OAAO;aACR,CAAC,CAAC;YAEH,oBAAoB,CAAC,cAAc,CAAC,CAAC;YACrC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,cAAc,CACxB,GAAG,EACH,8CAA8C,CAC/C,CAAC;YACF,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClB,QAAQ,CAAC,GAAG,CAAC,CAAC;YACd,UAAU,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAEnE,8EAA8E;IAC9E,4BAA4B;IAC5B,8EAA8E;IAC9E,MAAM,YAAY,GAAG,WAAW,CAC9B,KAAK,EAAE,OAAe,EAAE,EAAE;QACxB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC;YACzC,QAAQ,CACN,8BAA8B,mBAAmB,aAAa,CAC/D,CAAC;YACF,OAAO;QACT,CAAC;QAED,IACE,KAAK,KAAK,OAAO;YACjB,KAAK,KAAK,UAAU;YACpB,KAAK,KAAK,OAAO,EACjB,CAAC;YACD,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,eAAe,CAAC,OAAO,GAAG,KAAK,CAAC;QAEhC,IAAI,CAAC;YACH,IAAI,eAAe,GAAG,YAAY,CAAC,OAAO,CAAC;YAE3C,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,aAAa,CAAC;oBACtD,GAAG,EAAE,MAAM,CAAC,OAAO;oBACnB,QAAQ,EAAE,EAAE,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE;iBAChD,CAAC,CAAC;gBACH,YAAY,CAAC,OAAO,GAAG,YAAY,CAAC;gBACpC,eAAe,GAAG,YAAY,CAAC;YACjC,CAAC;YAED,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,MAAM,eAAe,CAAC;gBAC5D,GAAG,EAAE,MAAM,CAAC,OAAO;gBACnB,SAAS,EAAE,eAAe;gBAC1B,OAAO,EAAE,OAAO;aACjB,CAAC,CAAC;YAEH,oBAAoB,CAAC,cAAc,CAAC,CAAC;YACrC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,cAAc,CACxB,GAAG,EACH,0DAA0D,CAC3D,CAAC;YACF,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClB,QAAQ,CAAC,GAAG,CAAC,CAAC;YACd,UAAU,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,EACD,CAAC,KAAK,EAAE,aAAa,EAAE,eAAe,CAAC,CACxC,CAAC;IAEF,8EAA8E;IAC9E,sCAAsC;IACtC,8EAA8E;IAC9E,MAAM,SAAS,GAAG,WAAW,CAAC,GAAkB,EAAE;QAChD,IAAI,KAAK,KAAK,UAAU,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QACpD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;QAC5B,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAEvB,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;QAClC,IAAI,KAAK,KAAK,UAAU;YAAE,OAAO;QACjC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,8EAA8E;IAC9E,kBAAkB;IAClB,8EAA8E;IAC9E,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjB,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC3B,sBAAsB,CAAC,EAAE,CAAC,CAAC;QAC3B,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;QAC5B,eAAe,CAAC,OAAO,GAAG,KAAK,CAAC;QAChC,cAAc,CAAC,OAAO,GAAG,KAAK,CAAC;IACjC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,8EAA8E;IAC9E,kCAAkC;IAClC,8EAA8E;IAC9E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,IAAI,KAAK,KAAK,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;YAC7D,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC;YAC9B,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEjC,8EAA8E;IAC9E,uCAAuC;IACvC,8EAA8E;IAC9E,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,KAAK;QACL,mBAAmB;QACnB,eAAe,EAAE,MAAM,CAAC,SAAS;QACjC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,YAAY;QACtD,aAAa,EAAE,SAAS,EAAE,IAAI,IAAI,IAAI;QACtC,WAAW,EAAE,SAAS,EAAE,WAAW,IAAI,IAAI;QAC3C,KAAK;QACL,QAAQ;QACR,YAAY;QACZ,SAAS;QACT,UAAU;QACV,KAAK;KACN,CAAC,EACF;QACE,KAAK;QACL,mBAAmB;QACnB,MAAM,CAAC,SAAS;QAChB,MAAM,CAAC,WAAW;QAClB,MAAM,CAAC,YAAY;QACnB,SAAS;QACT,KAAK;QACL,QAAQ;QACR,YAAY;QACZ,SAAS;QACT,UAAU;QACV,KAAK;KACN,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useDiagnoseExecutionFlow.js","sourceRoot":"","sources":["../../src/workflow/useDiagnoseExecutionFlow.ts"],"names":[],"mappings":"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"}

package/workflow/useExecutionAnnouncements.d.ts

@@ -0,0 +1,12 @@
+import type { DerivedTaskState } from "../internal/store/workflow-execution-event-store";
+/**
+ * Behavior hook that generates screen reader announcements when task
+ * execution states change. Diffs the `taskStates` map on each update
+ * and produces human-readable announcement strings.
+ *
+ * Returns the latest announcement string for rendering in an
+ * `aria-live="polite"` region. The string changes on each new event,
+ * allowing the live region to announce it.
+ */
+export declare function useExecutionAnnouncements(taskStates: ReadonlyMap<string, DerivedTaskState>): string;
+//# sourceMappingURL=useExecutionAnnouncements.d.ts.map

package/workflow/useExecutionAnnouncements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExecutionAnnouncements.d.ts","sourceRoot":"","sources":["../../src/workflow/useExecutionAnnouncements.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAEzF;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAChD,MAAM,CA6CR"}

package/workflow/useExecutionAnnouncements.js

@@ -0,0 +1,50 @@
+"use client";
+import { useEffect, useRef, useState } from "react";
+/**
+ * Behavior hook that generates screen reader announcements when task
+ * execution states change. Diffs the `taskStates` map on each update
+ * and produces human-readable announcement strings.
+ *
+ * Returns the latest announcement string for rendering in an
+ * `aria-live="polite"` region. The string changes on each new event,
+ * allowing the live region to announce it.
+ */
+export function useExecutionAnnouncements(taskStates) {
+    const [announcement, setAnnouncement] = useState("");
+    const prevStatesRef = useRef(new Map());
+    useEffect(() => {
+        const prev = prevStatesRef.current;
+        const announcements = [];
+        for (const [name, state] of taskStates) {
+            const prevState = prev.get(name);
+            const prevStatus = prevState?.status;
+            if (prevStatus === state.status)
+                continue;
+            switch (state.status) {
+                case "running":
+                    announcements.push(`Task ${name} started`);
+                    break;
+                case "completed":
+                    announcements.push(`Task ${name} completed`);
+                    break;
+                case "failed":
+                    announcements.push(state.error
+                        ? `Task ${name} failed: ${state.error.slice(0, 80)}`
+                        : `Task ${name} failed`);
+                    break;
+                case "waiting_approval":
+                    announcements.push(`Approval required for task ${name}`);
+                    break;
+                case "retrying":
+                    announcements.push(`Task ${name} retrying, attempt ${state.attemptNumber}`);
+                    break;
+            }
+        }
+        if (announcements.length > 0) {
+            setAnnouncement(announcements.join(". "));
+        }
+        prevStatesRef.current = taskStates;
+    }, [taskStates]);
+    return announcement;
+}
+//# sourceMappingURL=useExecutionAnnouncements.js.map

package/workflow/useExecutionAnnouncements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExecutionAnnouncements.js","sourceRoot":"","sources":["../../src/workflow/useExecutionAnnouncements.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGpD;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAiD;IAEjD,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrD,MAAM,aAAa,GAAG,MAAM,CAAwC,IAAI,GAAG,EAAE,CAAC,CAAC;IAE/E,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC;QACnC,MAAM,aAAa,GAAa,EAAE,CAAC;QAEnC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,UAAU,GAAG,SAAS,EAAE,MAAM,CAAC;YAErC,IAAI,UAAU,KAAK,KAAK,CAAC,MAAM;gBAAE,SAAS;YAE1C,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;gBACrB,KAAK,SAAS;oBACZ,aAAa,CAAC,IAAI,CAAC,QAAQ,IAAI,UAAU,CAAC,CAAC;oBAC3C,MAAM;gBACR,KAAK,WAAW;oBACd,aAAa,CAAC,IAAI,CAAC,QAAQ,IAAI,YAAY,CAAC,CAAC;oBAC7C,MAAM;gBACR,KAAK,QAAQ;oBACX,aAAa,CAAC,IAAI,CAChB,KAAK,CAAC,KAAK;wBACT,CAAC,CAAC,QAAQ,IAAI,YAAY,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;wBACpD,CAAC,CAAC,QAAQ,IAAI,SAAS,CAC1B,CAAC;oBACF,MAAM;gBACR,KAAK,kBAAkB;oBACrB,aAAa,CAAC,IAAI,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;oBACzD,MAAM;gBACR,KAAK,UAAU;oBACb,aAAa,CAAC,IAAI,CAAC,QAAQ,IAAI,sBAAsB,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;oBAC5E,MAAM;YACV,CAAC;QACH,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,CAAC;QAED,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;IACrC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/workflow/useExplainWorkflowFlow.d.ts

@@ -0,0 +1,41 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+/**
+ * Lifecycle phases for the workflow explain flow.
+ *
+ * Simplified single-turn flow (no multi-turn, no YAML extraction):
+ * - `idle` — not started
+ * - `starting` — creating session + execution
+ * - `streaming` — agent is working
+ * - `complete` — explanation received
+ * - `error` — something failed
+ */
+export type ExplainPhase = "idle" | "starting" | "streaming" | "complete" | "error";
+/** Options for {@link useExplainWorkflowFlow}. */
+export interface UseExplainWorkflowFlowOptions {
+    /** Organization slug. */
+    readonly org: string;
+    /** Current workflow YAML to explain. */
+    readonly currentYaml: string;
+    /** Called on error. */
+    readonly onError?: (message: string) => void;
+}
+/** Return value of {@link useExplainWorkflowFlow}. */
+export interface UseExplainWorkflowFlowReturn {
+    readonly phase: ExplainPhase;
+    readonly explanation: string | null;
+    readonly execution: AgentExecution | null;
+    readonly isStreaming: boolean;
+    readonly error: string | null;
+    readonly explain: () => Promise<void>;
+    readonly reset: () => void;
+}
+/**
+ * Behavior hook for the "Explain Workflow" feature.
+ *
+ * Single-turn flow using the `workflow-architect` agent with
+ * `action: "no_changes"` (explanation only, no YAML returned).
+ *
+ * @since T14 (AI-Assisted Workflow Creation)
+ */
+export declare function useExplainWorkflowFlow(options: UseExplainWorkflowFlowOptions): UseExplainWorkflowFlowReturn;
+//# sourceMappingURL=useExplainWorkflowFlow.d.ts.map

package/workflow/useExplainWorkflowFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExplainWorkflowFlow.d.ts","sourceRoot":"","sources":["../../src/workflow/useExplainWorkflowFlow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAUlG;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAEpF,kDAAkD;AAClD,MAAM,WAAW,6BAA6B;IAC5C,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,uBAAuB;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAUD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,GACrC,4BAA4B,CAqH9B"}

package/workflow/useExplainWorkflowFlow.js

@@ -0,0 +1,117 @@
+"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 { WORKFLOW_ARCHITECT_RESPONSE_SCHEMA } from "./architect-response-schema";
+const AGENT_REF = { org: "", slug: "workflow-architect" };
+const EXPLAIN_PROMPT_PREFIX = "Please explain the following workflow in plain language. " +
+    "Describe what each task does, how data flows between them, " +
+    "and any branching or error handling logic. " +
+    "Do NOT suggest any changes — just explain what it does.\n\n";
+/**
+ * Behavior hook for the "Explain Workflow" feature.
+ *
+ * Single-turn flow using the `workflow-architect` agent with
+ * `action: "no_changes"` (explanation only, no YAML returned).
+ *
+ * @since T14 (AI-Assisted Workflow Creation)
+ */
+export function useExplainWorkflowFlow(options) {
+    const { org, currentYaml, onError } = options;
+    const [phase, setPhase] = useState("idle");
+    const [executionId, setExecutionId] = useState(null);
+    const [explanation, setExplanation] = 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 prevTerminalRef = useRef(false);
+    const { create: createSession } = useCreateSession();
+    const { create: createExecution } = useCreateAgentExecution();
+    const conversationStore = useConversationStoreRef();
+    const stream = useExecutionStream(executionId, {
+        store: conversationStore,
+    });
+    // Terminal phase detection — extract explanation
+    useEffect(() => {
+        if (phase !== "streaming")
+            return;
+        const isTerminal = stream.phase !== ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED &&
+            isTerminalPhase(stream.phase);
+        if (isTerminal && !prevTerminalRef.current) {
+            prevTerminalRef.current = true;
+            const structuredOutput = stream.execution?.status?.structuredOutput;
+            if (structuredOutput?.explanation) {
+                setExplanation(structuredOutput.explanation);
+            }
+            setPhase("complete");
+            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]);
+    const explain = useCallback(async () => {
+        if (phase !== "idle" && phase !== "error" && phase !== "complete")
+            return;
+        setPhase("starting");
+        setError(null);
+        setExplanation(null);
+        prevTerminalRef.current = false;
+        try {
+            const { sessionId } = await createSession({
+                org: orgRef.current,
+                agentRef: { ...AGENT_REF, org: orgRef.current },
+            });
+            const message = EXPLAIN_PROMPT_PREFIX +
+                "```yaml\n" +
+                yamlRef.current +
+                "\n```";
+            const { executionId: newExecId } = await createExecution({
+                org: orgRef.current,
+                sessionId,
+                message,
+                structuredOutputSchema: WORKFLOW_ARCHITECT_RESPONSE_SCHEMA,
+            });
+            setExecutionId(newExecId);
+            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]);
+    const reset = useCallback(() => {
+        setPhase("idle");
+        setExecutionId(null);
+        setExplanation(null);
+        setError(null);
+        prevTerminalRef.current = false;
+    }, []);
+    return useMemo(() => ({
+        phase,
+        explanation,
+        execution: stream.execution,
+        isStreaming: stream.isStreaming || stream.isConnecting,
+        error,
+        explain,
+        reset,
+    }), [phase, explanation, stream.execution, stream.isStreaming, stream.isConnecting, error, explain, reset]);
+}
+//# sourceMappingURL=useExplainWorkflowFlow.js.map

package/workflow/useExplainWorkflowFlow.js.map

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

package/workflow/useFollowExecution.d.ts

@@ -0,0 +1,114 @@
+import type { Node, Viewport } from "@xyflow/react";
+/**
+ * Follow-execution state machine states.
+ *
+ * - `auto_fit`: Initial state — viewport fitted to all nodes.
+ * - `following`: Camera actively tracking the running task.
+ * - `user_control`: User manually panned/zoomed — follow is paused.
+ */
+export type FollowState = "auto_fit" | "following" | "user_control";
+/** Options for {@link useFollowExecution}. */
+export interface UseFollowExecutionOptions {
+    /** Whether follow-execution behavior is enabled (typically true when execution is running). */
+    readonly enabled: boolean;
+    /** The name of the currently active task (running or waiting_approval). */
+    readonly activeTaskName: string | null;
+    /** React Flow nodes array — used to find the active node's position. */
+    readonly nodes: readonly Node[];
+    /** Whether the initial fitView has completed. Follow waits for this. */
+    readonly didInitialFit: boolean;
+    /** Whether the execution has reached a terminal state. */
+    readonly isTerminal: boolean;
+    /**
+     * Pixel width of panels (e.g. inspector) that reduce effective viewport width.
+     * The follow center is offset leftward to account for this occluded area.
+     * Defaults to 0.
+     */
+    readonly panelOffsetPx?: number;
+}
+/** Return value of {@link useFollowExecution}. */
+export interface UseFollowExecutionReturn {
+    /** Current state machine state. */
+    readonly followState: FollowState;
+    /** Whether follow is currently active (state === "following"). */
+    readonly isFollowing: boolean;
+    /** Toggle follow back on after user took manual control. */
+    readonly enableFollow: () => void;
+    /** Disable follow (user wants manual control). */
+    readonly disableFollow: () => void;
+    /**
+     * Pass to React Flow's `onMoveStart` to detect user-initiated viewport changes.
+     * When event is not null (real user interaction), transitions to user_control.
+     */
+    readonly handleMoveStart: (event: MouseEvent | TouchEvent | null, viewport: Viewport) => void;
+}
+/** Inputs for the pure centering computation. */
+export interface FollowCenterInput {
+    /** Node position x in flow coordinates. */
+    readonly nodeX: number;
+    /** Node position y in flow coordinates. */
+    readonly nodeY: number;
+    /** Node width in flow coordinates. */
+    readonly nodeWidth: number;
+    /** Node height in flow coordinates. */
+    readonly nodeHeight: number;
+    /** Current viewport zoom level. */
+    readonly currentZoom: number;
+    /** Pixel width of an overlay panel occluding the viewport. 0 = no occlusion. */
+    readonly panelOffsetPx: number;
+}
+/** Result of the centering computation. */
+export interface FollowCenterResult {
+    /** X coordinate to pass to React Flow's setCenter. */
+    readonly x: number;
+    /** Y coordinate to pass to React Flow's setCenter. */
+    readonly y: number;
+    /** Zoom level to pass to React Flow's setCenter. */
+    readonly zoom: number;
+}
+/**
+ * Pure function that computes the viewport center point for following an
+ * active node. Extracted from hook internals for testability (DD-003).
+ *
+ * When `panelOffsetPx > 0`, the center is shifted leftward in flow coordinates
+ * so the node appears centered in the *unoccluded* portion of the viewport.
+ * The shift is inversely proportional to zoom (larger zoom → smaller shift).
+ */
+export declare function computeFollowCenter(input: FollowCenterInput): FollowCenterResult;
+/** Inputs for the follow-selection decision. */
+export interface FollowSelectionInput {
+    /** Whether the follow state machine is in "following" state. */
+    readonly isFollowing: boolean;
+    /** The currently active (running/waiting) task name, or null. */
+    readonly activeTaskName: string | null;
+    /** The currently selected task name in the graph, or null. */
+    readonly currentSelectedTask: string | null;
+}
+/**
+ * Pure function that determines whether follow-selection should update
+ * the selected task. Returns the task name to select, or `null` when
+ * no change is needed. Extracted for testability (DD-003).
+ *
+ * Selection should update when all three conditions hold:
+ * 1. Follow is active (`isFollowing`)
+ * 2. An active task exists (`activeTaskName`)
+ * 3. The active task differs from the current selection
+ */
+export declare function computeFollowSelection(input: FollowSelectionInput): string | null;
+/**
+ * Behavior hook implementing a follow-execution state machine for the
+ * workflow execution graph viewport.
+ *
+ * State machine transitions:
+ * - auto_fit → following: first active task detected after initial fit
+ * - following → user_control: user pans/zooms manually (event !== null)
+ * - user_control → following: user clicks the "Follow" toggle
+ * - following → following: active task changes (pan to new node)
+ * - any → auto_fit: execution reaches terminal state (re-fit all)
+ *
+ * Respects prefers-reduced-motion for all viewport animations.
+ * Offsets center point for inspector panel width.
+ * Never zooms OUT — only ensures minimum zoom of 1.0.
+ */
+export declare function useFollowExecution(options: UseFollowExecutionOptions): UseFollowExecutionReturn;
+//# sourceMappingURL=useFollowExecution.d.ts.map

package/workflow/useFollowExecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFollowExecution.d.ts","sourceRoot":"","sources":["../../src/workflow/useFollowExecution.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAKpD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC;AAEpE,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC;IAClC,kDAAkD;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,EAAE,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC/F;AAMD,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CAahF;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,8DAA8D;IAC9D,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI,CAIjF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,wBAAwB,CA2F/F"}