@cascaide-ts/react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2026 Cascaide
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,4 @@
+var oe=Object.create;var S=Object.defineProperty;var re=Object.getOwnPropertyDescriptor;var ie=Object.getOwnPropertyNames;var se=Object.getPrototypeOf,ce=Object.prototype.hasOwnProperty;var de=(e,n)=>{for(var a in n)S(e,a,{get:n[a],enumerable:!0})},F=(e,n,a,t)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of ie(n))!ce.call(e,o)&&o!==a&&S(e,o,{get:()=>n[o],enumerable:!(t=re(n,o))||t.enumerable});return e};var le=(e,n,a)=>(a=e!=null?oe(se(e)):{},F(n||!e||!e.__esModule?S(a,"default",{value:e,enumerable:!0}):a,e)),ue=e=>F(S({},"__esModule",{value:!0}),e);var De={};de(De,{ReactWorkflowContext:()=>D,WorkflowProvider:()=>_e,WorkflowRenderer:()=>Re,apiForkCascade:()=>Q,apiHydrateCascadeContext:()=>Z,useAllCascades:()=>xe,useAppDispatch:()=>Ee,useAppSelector:()=>ne,useCascade:()=>Ne,useWorkflow:()=>ve});module.exports=ue(De);var C=require("react-redux"),x=require("react");var _=require("@reduxjs/toolkit"),J=require("@reduxjs/toolkit"),H=require("@reduxjs/toolkit"),Y=require("@reduxjs/toolkit"),E=require("reselect"),fe={context:{},activeNodes:{},history:[],errors:{}},$=(0,J.createSlice)({name:"workflow",initialState:fe,reducers:{updateContext:{reducer:(e,n)=>{Object.entries(n.payload).forEach(([a,t])=>{if(e.context[a]||(e.context[a]=[]),typeof t=="object"&&t!==null&&!Array.isArray(t)&&"index"in t){let o=t.index;e.context[a][o]=t}else e.context[a].push(t)})},prepare:(e,n)=>({payload:e,meta:n||{}})},addActiveNode:{reducer:(e,n)=>{let{nodeId:a,nodeName:t,parentTriggerId:o,contextData:r}=n.payload,{origin:i,functionId:d,cascadeId:c}=n.meta;e.activeNodes[a]={nodeName:t,parentTriggerId:o,processed:!1,initialContext:r,origin:i,functionId:d,cascadeId:c||r?.cascadeId},e.errors[a]&&delete e.errors[a]},prepare:(e,n)=>{let a=n?.cascadeId||e.contextData?.cascadeId;return{payload:e,meta:{...n,cascadeId:a}}}},removeActiveNode:{reducer:(e,n)=>{let{nodeId:a}=n.payload;e.activeNodes[a]&&(e.history.push({nodeId:a,nodeName:e.activeNodes[a].nodeName,timestamp:Date.now()}),delete e.activeNodes[a])},prepare:(e,n)=>({payload:e,meta:n||{}})},setError:{reducer:(e,n)=>{let{nodeId:a,error:t}=n.payload;e.errors[a]=t},prepare:(e,n)=>({payload:e,meta:n||{}})},markNodeProcessed:(e,n)=>{let{nodeId:a}=n.payload;e.activeNodes[a]&&(e.activeNodes[a].processed=!0)},streamChunkReceived:(e,n)=>{let{cascadeId:a,contentChunk:t,toolChunk:o,reasoningChunk:r,thoughtSignature:i}=n.payload;if(!t&&!o&&!r&&!i)return;let d=e.context[a];if(!d||d.length===0)return;let c=d[d.length-1].history,l=c[c.length-1];if(!(!l||l.role!=="assistant")&&(r&&(l.reasoning_content===void 0&&(l.reasoning_content=""),l.reasoning_content+=r),i&&(l.thought_signature=i),t&&(l.content+=t),o)){l.tool_calls||(l.tool_calls=[]);let u=o.index??0;l.tool_calls[u]||(l.tool_calls[u]={id:"",type:"function",function:{name:"",arguments:""}});let s=l.tool_calls[u];o.id&&(s.id=o.id),o.thought_signature&&(s.thought_signature=o.thought_signature),o.function?.name&&(s.function.name=o.function.name),o.function?.arguments&&(s.function.arguments+=o.function.arguments)}},hydrateContext:(e,n)=>{Object.entries(n.payload).forEach(([a,t])=>{e.context[a]=t})}}}),{updateContext:y,addActiveNode:I,removeActiveNode:N,setError:V,markNodeProcessed:Ae,streamChunkReceived:pe,hydrateContext:b}=$.actions,Oe=$.reducer,O=process.env.NODE_ENV==="development",he=e=>n=>a=>async t=>{if(I.match(t)){let{origin:o,functionId:r,cascadeId:i}=t.meta;if(i&&r>0&&o==="client"){let d=n.getState().workflow.context[i];if(!d||d.length===0){O&&console.log(`[CLIENT HYDRATION] \u{1F9CA} Cold start for ${i}`);try{let c=await fetch(e.hydrationEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({cascadeId:i,functionId:r})});if(!c.ok)throw new Error(`Hydration API failed: ${c.status}`);let l=await c.json();l&&Object.keys(l).length>0&&(n.dispatch(b(l)),O&&console.log("[CLIENT HYDRATION] \u2705 State hydrated via Dispatch"))}catch(c){O&&console.error("[CLIENT HYDRATION] \u274C Hydration failed:",c)}}}}return a(t)},w=process.env.NODE_ENV==="development";async function v(e,n=3,a=100){for(let t=1;t<=n;t++)try{return await e()}catch(o){if(t===n)return w&&console.error(`[CLIENT MW] \u274C All ${n} retry attempts failed:`,o),null;let r=a*Math.pow(2,t-1);w&&console.warn(`[CLIENT MW] \u26A0\uFE0F Attempt ${t} failed, retrying in ${r}ms...`),await new Promise(i=>setTimeout(i,r))}return null}var ge=e=>n=>a=>async t=>{if(I.match(t)){let{origin:o,functionId:r,cascadeId:i}=t.meta,{nodeId:d,nodeName:c,contextData:l}=t.payload;if(!i||o)return a(t);let u=r??0,s=await v(async()=>{let h=await fetch(e.persistenceEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:"claim",nodeInstanceId:d,cascadeId:i,userId:l.userId,nodeName:c,functionId:u,inputContext:l,location:"client"})});if(!h.ok)throw new Error(`Persistence sync failed: ${h.status}`);return await h.json()});if(!s){w&&console.error(`[CLIENT MW] \u274C Failed to claim node ${d} after retries`);return}let f=s.functionId;w&&console.log(`[CLIENT MW] \u2705 Node ${d} bound to FnId: ${f}`);let p={...t,meta:{...t.meta,origin:"client",functionId:f,cascadeId:i}};return a(p)}if(N.match(t)){let{origin:o,functionId:r,cascadeId:i}=t.meta,d=typeof t.payload=="string"?t.payload:t.payload.nodeId,c=t.payload.hasSpawns,l=t.payload.fullOutput,u=n.getState(),s=u.workflow.activeNodes[d],f=i||s?.cascadeId,p=r??s?.functionId??0;if(!f||o)return a(t);let h=l||u.workflow.context[f];if(!await v(async()=>{let g=await fetch(e.persistenceEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:"finalize",nodeInstanceId:d,cascadeId:f,fullOutput:h,hasSpawns:c})});if(!g.ok)throw new Error(`Persistence sync failed: ${g.status}`);return await g.json()})){w&&console.error(`[CLIENT MW] \u274C Failed to finalize node ${d} after retries`);return}return a({...t,meta:{...t.meta,origin:"client",functionId:p,cascadeId:f}})}if(V.match(t)){let{origin:o,functionId:r,cascadeId:i}=t.meta,{nodeId:d,error:c}=t.payload,l=n.getState().workflow.activeNodes[d],u=i||l?.cascadeId;if(!u||o)return a(t);if(!await v(async()=>{let s=await fetch(e.persistenceEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:"error",nodeInstanceId:d,cascadeId:u,error:c})});if(!s.ok)throw new Error(`Persistence sync failed: ${s.status}`);return await s.json()})){w&&console.error(`[CLIENT MW] \u274C Failed to mark node ${d} as failed after retries`);return}return a({...t,meta:{...t.meta,origin:"client",cascadeId:u}})}if(y.match(t)){let{origin:o,functionId:r,cascadeId:i}=t.meta,d=t.payload,c=i,l=r??0;if(!c||o||(w&&console.log("[CLIENT MW] \u{1F504} Persisting context:",JSON.stringify(d,null,2)),d[c]?.status==="streaming"))return a(t);if(!await v(async()=>{let u=await fetch(e.persistenceEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:"context",cascadeId:c,functionId:l,updates:d})});if(!u.ok)throw new Error(`Persistence sync failed: ${u.status}`);return await u.json()})){w&&console.error(`[CLIENT MW] \u274C Failed to record context for cascade ${c} after retries`);return}return a({...t,meta:{...t.meta,origin:"client",functionId:l,cascadeId:c}})}return a(t)},U=(0,H.createListenerMiddleware)(),me=U.startListening,j=`
+__END_STREAM_METADATA__
+`,ye=e=>{me({actionCreator:I,effect:async(n,a)=>{let{nodeId:t,nodeName:o,contextData:r}=n.payload,{functionId:i}=n.meta,d=e.workflowGraph[o],c=e.isLite;if(!d||d.isUINode)return;let l=c?r?.history?.slice(-1)??[]:[...r?.history??[]];r?.sentFromClient&&await a.dispatch(y({[r?.cascadeId]:{history:l,status:"completed"}},{functionId:i,cascadeId:r?.cascadeId}));try{let u=await fetch(e.actionRelayEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},signal:a.signal,body:JSON.stringify(n)});if(!u.ok||!u.body)throw new Error(await u.text()||"Action relay failed");let s=r?.cascadeId;await we(u.body,s,t,a,n,c)}catch(u){if(u.name==="AbortError")return;await a.dispatch(V({nodeId:t,error:u.message})),await a.dispatch(N({nodeId:t,hasSpawns:!1}))}}})};async function we(e,n,a,t,o,r){let i=e.getReader(),d=new TextDecoder,c="",l=!1;try{for(;;){let{done:u,value:s}=await i.read();if(u)break;if(c+=d.decode(s,{stream:!0}),!l){let f=c.indexOf(j);if(f!==-1){let p=c.substring(0,f),h=c.substring(f+j.length);if(L(p,n,t),h.trim())try{let g=JSON.parse(h.trim());await Ie(g,a,t,o,r)}catch(g){console.error("Metadata parse error",g)}l=!0;break}c=await L(c,n,t)}}}finally{i.releaseLock()}}async function L(e,n,a){let t=e.split(`
+`),o=t.pop()||"";for(let r of t)if(!(!r.trim()||r.startsWith(":")))try{let i=JSON.parse(r);i.type==="init"?await a.dispatch(y({[i.cascadeId]:{history:[{role:"assistant",content:""}],status:"streaming"}})):i.type==="sync"?await a.dispatch(y({[i.cascadeId]:{history:[i.history],status:"completed"}})):a.dispatch(pe({cascadeId:n,contentChunk:i.contentChunk||i.chunk,toolChunk:i.toolChunk||i.tool_call,reasoningChunk:i.reasoningChunk}))}catch(i){console.error("Chunk parse error",i)}return o}async function Ie(e,n,a,t,o){let r=t.meta?.functionId??0,i=t.meta?.origin??"server",d=t.payload.contextData?.cascadeId,c=e.spawns?Object.entries(e.spawns):[],l=c.length>0;l&&c.forEach(async([u,s],f)=>{let p=o?a.getState().workflow.context[d]:s;await a.dispatch(I({nodeId:`${u}_${Date.now()}_${f}`,nodeName:u,parentTriggerId:n,contextData:{...p,userId:p?.userId||t.payload.contextData?.userId}},{functionId:r+1+f,cascadeId:d,origin:i}))}),await a.dispatch(N({nodeId:n,hasSpawns:l,fullOutput:e.updates},{functionId:void 0,cascadeId:d,origin:i}))}var Ce=(0,_.combineReducers)({workflow:$.reducer}),G=(e,n,a,t,o=[])=>{ye({workflowGraph:e,actionRelayEndpoint:n,isLite:!a});let r=[];return a&&r.push(ge({persistenceEndpoint:a}),he({hydrationEndpoint:t})),r.push(...o),r.push(U.middleware),(0,_.configureStore)({reducer:Ce,middleware:i=>i({serializableCheck:!1}).concat(r),devTools:process.env.NODE_ENV!=="production"})},$e=process.env.NODE_ENV==="development";var be=process.env.NODE_ENV==="development";var Me=process.env.NODE_ENV==="development";var ke=e=>e.workflow.activeNodes,z=e=>e.workflow.context,B=(e,n)=>n,X=()=>(0,E.createSelector)([z,B],(e,n)=>{let a=e[n];if(!a||a.length===0)return;let t=a[a.length-1].status,o=a.flatMap(r=>r.history||[]);return{status:t,history:o}}),q=()=>(0,E.createSelector)([ke,B],(e,n)=>(console.log(`Reselect: Re-calculating nodes for cascade ${n}`),Object.entries(e).filter(([a,t])=>t.initialContext?.cascadeId===n).map(([a,t])=>({nodeId:a,nodeName:t.nodeName,parentTriggerId:t.parentTriggerId,initialContext:t.initialContext,processed:t.processed})))),K=(0,E.createSelector)([z],e=>(console.log("Reselect: Re-calculating all cascade IDs"),Object.keys(e).filter(n=>n.startsWith("cascade_"))));var Ne=e=>{let n=(0,x.useMemo)(X,[]),a=(0,x.useMemo)(q,[]),t=(0,C.useDispatch)(),o=(0,C.useSelector)(s=>n(s,e)),r=(0,C.useSelector)(s=>a(s,e)),i=(0,x.useMemo)(()=>r.length===0?null:[...r].sort((s,f)=>{let p=parseInt(s.nodeId.split("_")[1]||"0");return parseInt(f.nodeId.split("_")[1]||"0")-p})[0],[r]),d=(0,x.useMemo)(()=>{let s=new Map(r.map(p=>[p.nodeId,{...p,children:[]}])),f=[];return r.forEach(p=>{let h=s.get(p.nodeId);p.parentTriggerId&&s.has(p.parentTriggerId)?s.get(p.parentTriggerId).children.push(h):f.push(h)}),f},[r]),c=async(s,f,p)=>{let h=await Q(e,s,f,p),g=await Z(s,f,p);return t(b(g)),h},l=r.length===0&&o!==void 0,u=o!==void 0||r.length>0;return{cascadeState:o,cascadeNodes:r,currentNode:i,cascadeTree:d,isComplete:l,exists:u,forkCascade:c}},xe=()=>(0,C.useSelector)(K);async function Q(e,n,a,t){let o=await fetch(t,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:"fork",sourceCascadeId:e,newCascadeId:n,upToFunctionId:a})});if(!o.ok)throw new Error(`forkCascade failed: ${await o.text()}`);return o.json()}async function Z(e,n,a){let t=await fetch(a,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:"hydrate",cascadeId:e,functionId:n})});if(!t.ok)throw new Error(`hydrate failed: ${await t.text()}`);return t.json()}var k=require("react-redux"),m=require("react");var Se={},ve=e=>{let n=(0,k.useDispatch)(),a=(0,m.useRef)(void 0);(0,m.useEffect)(()=>{a.current!==e&&(a.current=e)},[e]);let t=(0,m.useMemo)(()=>e.split("_")[0],[e]),o=(0,k.useSelector)(s=>s.workflow.context[t]||Se),r=(0,k.useSelector)(s=>s.workflow.activeNodes[e]),i=s=>(0,k.useSelector)(f=>s(f.workflow.context)),d=(0,m.useCallback)(async s=>await n(y({[t]:{...o,...s}})),[n,t,o]),c=(0,m.useCallback)(async s=>await n(y(s)),[n]),l=(0,m.useCallback)(async s=>await n(N(s)),[n]),u=(0,m.useCallback)(async(s,f)=>{let p=Array.isArray(s)?s:[s],h=f?.cascadeId,g=[];for(let W of p){let ae=`${W}_${Date.now()}_${Math.random().toString(36).substring(2,8)}`,P={...f,sentFromClient:!0};h&&(P.cascadeId=h,g.push(h)),await n(I({nodeId:ae,nodeName:W,parentTriggerId:e,contextData:P}))}if(h)return g.length===1?g[0]:g},[n,e]);return(0,m.useMemo)(()=>({context:o,useWorkflowSelector:i,saveContext:d,saveGlobalContext:c,signalCompletion:l,addActiveNode:u,nodeName:t,nodeId:e,nodeData:r}),[o,i,d,c,l,u,t,e,r])};var R=le(require("react"),1),ee=require("react-redux"),M=require("react/jsx-runtime"),D=R.default.createContext(null);function _e({children:e,initialNodeId:n,initialNodeName:a,initialContext:t={},config:o,actionRelayEndpoint:r,persistenceEndpoint:i,hydrationEndpoint:d}){let c=(0,R.useRef)(null);return c.current||(c.current=G(o.clientWorkflowGraph,r,i,d),c.current.dispatch(y(t)),c.current.dispatch(I({nodeId:n,nodeName:a}))),(0,M.jsx)(ee.Provider,{store:c.current,children:(0,M.jsx)(D.Provider,{value:o,children:e})})}var te=require("react");var A=require("react-redux"),T=require("react/jsx-runtime"),Ee=()=>(0,A.useDispatch)(),ne=A.useSelector;function Re(){let e=(0,te.useContext)(D);if(!e)throw new Error("WorkflowRenderer must be used within a WorkflowProvider.");let{activeNodes:n}=ne(r=>r.workflow),{clientWorkflowGraph:a,uiComponentRegistry:t}=e,o=Object.keys(n).filter(r=>{let i=n[r];return a[i.nodeName]?.isUINode});return o.length===0?null:(0,T.jsx)("div",{children:o.map(r=>{let i=n[r],d=t[i.nodeName];return d?(0,T.jsx)("div",{children:(0,T.jsx)(d,{nodeId:r})},r):(console.error(`UI component for node '${i.nodeName}' not found.`),null)})})}0&&(module.exports={ReactWorkflowContext,WorkflowProvider,WorkflowRenderer,apiForkCascade,apiHydrateCascadeContext,useAllCascades,useAppDispatch,useAppSelector,useCascade,useWorkflow});

package/dist/index.d.cts

@@ -0,0 +1,102 @@
+import * as _cascaide_ts_core from '@cascaide-ts/core';
+import { WorkflowContext, removeActiveNodePayload, ClientWorkflowGraph, RootState } from '@cascaide-ts/core';
+import * as _reduxjs_toolkit from '@reduxjs/toolkit';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+import { TypedUseSelectorHook } from 'react-redux';
+
+type CascadeNode = {
+    nodeId: string;
+    nodeName: string;
+    parentTriggerId?: string;
+    initialContext?: any;
+    processed?: boolean;
+};
+type CascadeState = {
+    task?: string;
+    status?: string;
+    currentNode?: string;
+    history?: any[];
+    lastUpdate?: number;
+    [key: string]: any;
+};
+declare const useCascade: (cascadeId: string) => {
+    cascadeState: {
+        status: string;
+        history: any[];
+    };
+    cascadeNodes: {
+        nodeId: string;
+        nodeName: string;
+        parentTriggerId: string;
+        initialContext: any;
+        processed: boolean;
+    }[];
+    currentNode: {
+        nodeId: string;
+        nodeName: string;
+        parentTriggerId: string;
+        initialContext: any;
+        processed: boolean;
+    };
+    cascadeTree: any[];
+    isComplete: boolean;
+    exists: boolean;
+    forkCascade: (newCascadeId: string, upToFunctionId: number, apiEndpoint: string) => Promise<{
+        newCascadeId: string;
+        status: string;
+    }>;
+};
+declare const useAllCascades: () => string[];
+declare function apiForkCascade(sourceCascadeId: string, newCascadeId: string, upToFunctionId: number, apiEndpoint: string): Promise<{
+    newCascadeId: string;
+    status: string;
+}>;
+declare function apiHydrateCascadeContext(cascadeId: string, functionId: number, apiEndpoint: string): Promise<WorkflowContext>;
+
+interface AddActiveNodeSignature {
+    (nodeNames: string | string[], initialContext?: Omit<any, 'cascadeId'>): Promise<undefined>;
+    (nodeNames: string | string[], initialContext: {
+        cascadeId: string;
+    } & any): Promise<string | string[]>;
+}
+declare const useWorkflow: (nodeId: string) => {
+    context: {};
+    useWorkflowSelector: <T>(selector: (context: any) => T) => T;
+    saveContext: (data: any) => Promise<_reduxjs_toolkit.PayloadAction<{
+        [key: string]: any;
+    }, "workflow/updateContext", _cascaide_ts_core.ActionMeta, never>>;
+    saveGlobalContext: (data: any) => Promise<_reduxjs_toolkit.PayloadAction<{
+        [key: string]: any;
+    }, "workflow/updateContext", _cascaide_ts_core.ActionMeta, never>>;
+    signalCompletion: (data: removeActiveNodePayload) => Promise<_reduxjs_toolkit.PayloadAction<removeActiveNodePayload, "workflow/removeActiveNode", _cascaide_ts_core.ActionMeta, never>>;
+    addActiveNode: AddActiveNodeSignature;
+    nodeName: string;
+    nodeId: string;
+    nodeData: _cascaide_ts_core.ActiveNode;
+};
+
+type ClientWorkflowConfig = {
+    clientWorkflowGraph: ClientWorkflowGraph;
+    uiComponentRegistry: {
+        [key: string]: React.ComponentType<any>;
+    };
+};
+declare const ReactWorkflowContext: React.Context<ClientWorkflowConfig>;
+declare function WorkflowProvider({ children, initialNodeId, initialNodeName, initialContext, config, actionRelayEndpoint, persistenceEndpoint, // Now optional
+hydrationEndpoint, }: {
+    children: React.ReactNode;
+    initialNodeId: string;
+    initialNodeName: string;
+    initialContext?: any;
+    config: ClientWorkflowConfig;
+    actionRelayEndpoint: string;
+    persistenceEndpoint?: string;
+    hydrationEndpoint?: string;
+}): react_jsx_runtime.JSX.Element;
+
+declare const useAppDispatch: () => _reduxjs_toolkit.Dispatch<_reduxjs_toolkit.Action>;
+declare const useAppSelector: TypedUseSelectorHook<RootState>;
+declare function WorkflowRenderer(): react_jsx_runtime.JSX.Element;
+
+export { type CascadeNode, type CascadeState, type ClientWorkflowConfig, ReactWorkflowContext, WorkflowProvider, WorkflowRenderer, apiForkCascade, apiHydrateCascadeContext, useAllCascades, useAppDispatch, useAppSelector, useCascade, useWorkflow };

package/dist/index.d.ts

@@ -0,0 +1,102 @@
+import * as _cascaide_ts_core from '@cascaide-ts/core';
+import { WorkflowContext, removeActiveNodePayload, ClientWorkflowGraph, RootState } from '@cascaide-ts/core';
+import * as _reduxjs_toolkit from '@reduxjs/toolkit';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+import { TypedUseSelectorHook } from 'react-redux';
+
+type CascadeNode = {
+    nodeId: string;
+    nodeName: string;
+    parentTriggerId?: string;
+    initialContext?: any;
+    processed?: boolean;
+};
+type CascadeState = {
+    task?: string;
+    status?: string;
+    currentNode?: string;
+    history?: any[];
+    lastUpdate?: number;
+    [key: string]: any;
+};
+declare const useCascade: (cascadeId: string) => {
+    cascadeState: {
+        status: string;
+        history: any[];
+    };
+    cascadeNodes: {
+        nodeId: string;
+        nodeName: string;
+        parentTriggerId: string;
+        initialContext: any;
+        processed: boolean;
+    }[];
+    currentNode: {
+        nodeId: string;
+        nodeName: string;
+        parentTriggerId: string;
+        initialContext: any;
+        processed: boolean;
+    };
+    cascadeTree: any[];
+    isComplete: boolean;
+    exists: boolean;
+    forkCascade: (newCascadeId: string, upToFunctionId: number, apiEndpoint: string) => Promise<{
+        newCascadeId: string;
+        status: string;
+    }>;
+};
+declare const useAllCascades: () => string[];
+declare function apiForkCascade(sourceCascadeId: string, newCascadeId: string, upToFunctionId: number, apiEndpoint: string): Promise<{
+    newCascadeId: string;
+    status: string;
+}>;
+declare function apiHydrateCascadeContext(cascadeId: string, functionId: number, apiEndpoint: string): Promise<WorkflowContext>;
+
+interface AddActiveNodeSignature {
+    (nodeNames: string | string[], initialContext?: Omit<any, 'cascadeId'>): Promise<undefined>;
+    (nodeNames: string | string[], initialContext: {
+        cascadeId: string;
+    } & any): Promise<string | string[]>;
+}
+declare const useWorkflow: (nodeId: string) => {
+    context: {};
+    useWorkflowSelector: <T>(selector: (context: any) => T) => T;
+    saveContext: (data: any) => Promise<_reduxjs_toolkit.PayloadAction<{
+        [key: string]: any;
+    }, "workflow/updateContext", _cascaide_ts_core.ActionMeta, never>>;
+    saveGlobalContext: (data: any) => Promise<_reduxjs_toolkit.PayloadAction<{
+        [key: string]: any;
+    }, "workflow/updateContext", _cascaide_ts_core.ActionMeta, never>>;
+    signalCompletion: (data: removeActiveNodePayload) => Promise<_reduxjs_toolkit.PayloadAction<removeActiveNodePayload, "workflow/removeActiveNode", _cascaide_ts_core.ActionMeta, never>>;
+    addActiveNode: AddActiveNodeSignature;
+    nodeName: string;
+    nodeId: string;
+    nodeData: _cascaide_ts_core.ActiveNode;
+};
+
+type ClientWorkflowConfig = {
+    clientWorkflowGraph: ClientWorkflowGraph;
+    uiComponentRegistry: {
+        [key: string]: React.ComponentType<any>;
+    };
+};
+declare const ReactWorkflowContext: React.Context<ClientWorkflowConfig>;
+declare function WorkflowProvider({ children, initialNodeId, initialNodeName, initialContext, config, actionRelayEndpoint, persistenceEndpoint, // Now optional
+hydrationEndpoint, }: {
+    children: React.ReactNode;
+    initialNodeId: string;
+    initialNodeName: string;
+    initialContext?: any;
+    config: ClientWorkflowConfig;
+    actionRelayEndpoint: string;
+    persistenceEndpoint?: string;
+    hydrationEndpoint?: string;
+}): react_jsx_runtime.JSX.Element;
+
+declare const useAppDispatch: () => _reduxjs_toolkit.Dispatch<_reduxjs_toolkit.Action>;
+declare const useAppSelector: TypedUseSelectorHook<RootState>;
+declare function WorkflowRenderer(): react_jsx_runtime.JSX.Element;
+
+export { type CascadeNode, type CascadeState, type ClientWorkflowConfig, ReactWorkflowContext, WorkflowProvider, WorkflowRenderer, apiForkCascade, apiHydrateCascadeContext, useAllCascades, useAppDispatch, useAppSelector, useCascade, useWorkflow };

package/dist/index.js

@@ -0,0 +1,4 @@
+import{useDispatch as ie,useSelector as E}from"react-redux";import{useMemo as k}from"react";import{configureStore as Y,combineReducers as z}from"@reduxjs/toolkit";import{createSlice as B}from"@reduxjs/toolkit";import{createListenerMiddleware as Z}from"@reduxjs/toolkit";import{configureStore as _e,createListenerMiddleware as Ee}from"@reduxjs/toolkit";import{createSelector as _}from"reselect";var X={context:{},activeNodes:{},history:[],errors:{}},S=B({name:"workflow",initialState:X,reducers:{updateContext:{reducer:(t,a)=>{Object.entries(a.payload).forEach(([n,e])=>{if(t.context[n]||(t.context[n]=[]),typeof e=="object"&&e!==null&&!Array.isArray(e)&&"index"in e){let r=e.index;t.context[n][r]=e}else t.context[n].push(e)})},prepare:(t,a)=>({payload:t,meta:a||{}})},addActiveNode:{reducer:(t,a)=>{let{nodeId:n,nodeName:e,parentTriggerId:r,contextData:o}=a.payload,{origin:i,functionId:d,cascadeId:c}=a.meta;t.activeNodes[n]={nodeName:e,parentTriggerId:r,processed:!1,initialContext:o,origin:i,functionId:d,cascadeId:c||o?.cascadeId},t.errors[n]&&delete t.errors[n]},prepare:(t,a)=>{let n=a?.cascadeId||t.contextData?.cascadeId;return{payload:t,meta:{...a,cascadeId:n}}}},removeActiveNode:{reducer:(t,a)=>{let{nodeId:n}=a.payload;t.activeNodes[n]&&(t.history.push({nodeId:n,nodeName:t.activeNodes[n].nodeName,timestamp:Date.now()}),delete t.activeNodes[n])},prepare:(t,a)=>({payload:t,meta:a||{}})},setError:{reducer:(t,a)=>{let{nodeId:n,error:e}=a.payload;t.errors[n]=e},prepare:(t,a)=>({payload:t,meta:a||{}})},markNodeProcessed:(t,a)=>{let{nodeId:n}=a.payload;t.activeNodes[n]&&(t.activeNodes[n].processed=!0)},streamChunkReceived:(t,a)=>{let{cascadeId:n,contentChunk:e,toolChunk:r,reasoningChunk:o,thoughtSignature:i}=a.payload;if(!e&&!r&&!o&&!i)return;let d=t.context[n];if(!d||d.length===0)return;let c=d[d.length-1].history,l=c[c.length-1];if(!(!l||l.role!=="assistant")&&(o&&(l.reasoning_content===void 0&&(l.reasoning_content=""),l.reasoning_content+=o),i&&(l.thought_signature=i),e&&(l.content+=e),r)){l.tool_calls||(l.tool_calls=[]);let u=r.index??0;l.tool_calls[u]||(l.tool_calls[u]={id:"",type:"function",function:{name:"",arguments:""}});let s=l.tool_calls[u];r.id&&(s.id=r.id),r.thought_signature&&(s.thought_signature=r.thought_signature),r.function?.name&&(s.function.name=r.function.name),r.function?.arguments&&(s.function.arguments+=r.function.arguments)}},hydrateContext:(t,a)=>{Object.entries(a.payload).forEach(([n,e])=>{t.context[n]=e})}}}),{updateContext:m,addActiveNode:w,removeActiveNode:I,setError:M,markNodeProcessed:Ne,streamChunkReceived:q,hydrateContext:v}=S.actions,xe=S.reducer,x=process.env.NODE_ENV==="development",K=t=>a=>n=>async e=>{if(w.match(e)){let{origin:r,functionId:o,cascadeId:i}=e.meta;if(i&&o>0&&r==="client"){let d=a.getState().workflow.context[i];if(!d||d.length===0){x&&console.log(`[CLIENT HYDRATION] \u{1F9CA} Cold start for ${i}`);try{let c=await fetch(t.hydrationEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({cascadeId:i,functionId:o})});if(!c.ok)throw new Error(`Hydration API failed: ${c.status}`);let l=await c.json();l&&Object.keys(l).length>0&&(a.dispatch(v(l)),x&&console.log("[CLIENT HYDRATION] \u2705 State hydrated via Dispatch"))}catch(c){x&&console.error("[CLIENT HYDRATION] \u274C Hydration failed:",c)}}}}return n(e)},y=process.env.NODE_ENV==="development";async function C(t,a=3,n=100){for(let e=1;e<=a;e++)try{return await t()}catch(r){if(e===a)return y&&console.error(`[CLIENT MW] \u274C All ${a} retry attempts failed:`,r),null;let o=n*Math.pow(2,e-1);y&&console.warn(`[CLIENT MW] \u26A0\uFE0F Attempt ${e} failed, retrying in ${o}ms...`),await new Promise(i=>setTimeout(i,o))}return null}var Q=t=>a=>n=>async e=>{if(w.match(e)){let{origin:r,functionId:o,cascadeId:i}=e.meta,{nodeId:d,nodeName:c,contextData:l}=e.payload;if(!i||r)return n(e);let u=o??0,s=await C(async()=>{let h=await fetch(t.persistenceEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:"claim",nodeInstanceId:d,cascadeId:i,userId:l.userId,nodeName:c,functionId:u,inputContext:l,location:"client"})});if(!h.ok)throw new Error(`Persistence sync failed: ${h.status}`);return await h.json()});if(!s){y&&console.error(`[CLIENT MW] \u274C Failed to claim node ${d} after retries`);return}let f=s.functionId;y&&console.log(`[CLIENT MW] \u2705 Node ${d} bound to FnId: ${f}`);let p={...e,meta:{...e.meta,origin:"client",functionId:f,cascadeId:i}};return n(p)}if(I.match(e)){let{origin:r,functionId:o,cascadeId:i}=e.meta,d=typeof e.payload=="string"?e.payload:e.payload.nodeId,c=e.payload.hasSpawns,l=e.payload.fullOutput,u=a.getState(),s=u.workflow.activeNodes[d],f=i||s?.cascadeId,p=o??s?.functionId??0;if(!f||r)return n(e);let h=l||u.workflow.context[f];if(!await C(async()=>{let g=await fetch(t.persistenceEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:"finalize",nodeInstanceId:d,cascadeId:f,fullOutput:h,hasSpawns:c})});if(!g.ok)throw new Error(`Persistence sync failed: ${g.status}`);return await g.json()})){y&&console.error(`[CLIENT MW] \u274C Failed to finalize node ${d} after retries`);return}return n({...e,meta:{...e.meta,origin:"client",functionId:p,cascadeId:f}})}if(M.match(e)){let{origin:r,functionId:o,cascadeId:i}=e.meta,{nodeId:d,error:c}=e.payload,l=a.getState().workflow.activeNodes[d],u=i||l?.cascadeId;if(!u||r)return n(e);if(!await C(async()=>{let s=await fetch(t.persistenceEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:"error",nodeInstanceId:d,cascadeId:u,error:c})});if(!s.ok)throw new Error(`Persistence sync failed: ${s.status}`);return await s.json()})){y&&console.error(`[CLIENT MW] \u274C Failed to mark node ${d} as failed after retries`);return}return n({...e,meta:{...e.meta,origin:"client",cascadeId:u}})}if(m.match(e)){let{origin:r,functionId:o,cascadeId:i}=e.meta,d=e.payload,c=i,l=o??0;if(!c||r||(y&&console.log("[CLIENT MW] \u{1F504} Persisting context:",JSON.stringify(d,null,2)),d[c]?.status==="streaming"))return n(e);if(!await C(async()=>{let u=await fetch(t.persistenceEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:"context",cascadeId:c,functionId:l,updates:d})});if(!u.ok)throw new Error(`Persistence sync failed: ${u.status}`);return await u.json()})){y&&console.error(`[CLIENT MW] \u274C Failed to record context for cascade ${c} after retries`);return}return n({...e,meta:{...e.meta,origin:"client",functionId:l,cascadeId:c}})}return n(e)},W=Z(),ee=W.startListening,$=`
+__END_STREAM_METADATA__
+`,te=t=>{ee({actionCreator:w,effect:async(a,n)=>{let{nodeId:e,nodeName:r,contextData:o}=a.payload,{functionId:i}=a.meta,d=t.workflowGraph[r],c=t.isLite;if(!d||d.isUINode)return;let l=c?o?.history?.slice(-1)??[]:[...o?.history??[]];o?.sentFromClient&&await n.dispatch(m({[o?.cascadeId]:{history:l,status:"completed"}},{functionId:i,cascadeId:o?.cascadeId}));try{let u=await fetch(t.actionRelayEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},signal:n.signal,body:JSON.stringify(a)});if(!u.ok||!u.body)throw new Error(await u.text()||"Action relay failed");let s=o?.cascadeId;await ne(u.body,s,e,n,a,c)}catch(u){if(u.name==="AbortError")return;await n.dispatch(M({nodeId:e,error:u.message})),await n.dispatch(I({nodeId:e,hasSpawns:!1}))}}})};async function ne(t,a,n,e,r,o){let i=t.getReader(),d=new TextDecoder,c="",l=!1;try{for(;;){let{done:u,value:s}=await i.read();if(u)break;if(c+=d.decode(s,{stream:!0}),!l){let f=c.indexOf($);if(f!==-1){let p=c.substring(0,f),h=c.substring(f+$.length);if(b(p,a,e),h.trim())try{let g=JSON.parse(h.trim());await ae(g,n,e,r,o)}catch(g){console.error("Metadata parse error",g)}l=!0;break}c=await b(c,a,e)}}}finally{i.releaseLock()}}async function b(t,a,n){let e=t.split(`
+`),r=e.pop()||"";for(let o of e)if(!(!o.trim()||o.startsWith(":")))try{let i=JSON.parse(o);i.type==="init"?await n.dispatch(m({[i.cascadeId]:{history:[{role:"assistant",content:""}],status:"streaming"}})):i.type==="sync"?await n.dispatch(m({[i.cascadeId]:{history:[i.history],status:"completed"}})):n.dispatch(q({cascadeId:a,contentChunk:i.contentChunk||i.chunk,toolChunk:i.toolChunk||i.tool_call,reasoningChunk:i.reasoningChunk}))}catch(i){console.error("Chunk parse error",i)}return r}async function ae(t,a,n,e,r){let o=e.meta?.functionId??0,i=e.meta?.origin??"server",d=e.payload.contextData?.cascadeId,c=t.spawns?Object.entries(t.spawns):[],l=c.length>0;l&&c.forEach(async([u,s],f)=>{let p=r?n.getState().workflow.context[d]:s;await n.dispatch(w({nodeId:`${u}_${Date.now()}_${f}`,nodeName:u,parentTriggerId:a,contextData:{...p,userId:p?.userId||e.payload.contextData?.userId}},{functionId:o+1+f,cascadeId:d,origin:i}))}),await n.dispatch(I({nodeId:a,hasSpawns:l,fullOutput:t.updates},{functionId:void 0,cascadeId:d,origin:i}))}var oe=z({workflow:S.reducer}),P=(t,a,n,e,r=[])=>{te({workflowGraph:t,actionRelayEndpoint:a,isLite:!n});let o=[];return n&&o.push(Q({persistenceEndpoint:n}),K({hydrationEndpoint:e})),o.push(...r),o.push(W.middleware),Y({reducer:oe,middleware:i=>i({serializableCheck:!1}).concat(o),devTools:process.env.NODE_ENV!=="production"})},Re=process.env.NODE_ENV==="development";var De=process.env.NODE_ENV==="development";var Te=process.env.NODE_ENV==="development";var re=t=>t.workflow.activeNodes,F=t=>t.workflow.context,j=(t,a)=>a,L=()=>_([F,j],(t,a)=>{let n=t[a];if(!n||n.length===0)return;let e=n[n.length-1].status,r=n.flatMap(o=>o.history||[]);return{status:e,history:r}}),J=()=>_([re,j],(t,a)=>(console.log(`Reselect: Re-calculating nodes for cascade ${a}`),Object.entries(t).filter(([n,e])=>e.initialContext?.cascadeId===a).map(([n,e])=>({nodeId:n,nodeName:e.nodeName,parentTriggerId:e.parentTriggerId,initialContext:e.initialContext,processed:e.processed})))),V=_([F],t=>(console.log("Reselect: Re-calculating all cascade IDs"),Object.keys(t).filter(a=>a.startsWith("cascade_"))));var Le=t=>{let a=k(L,[]),n=k(J,[]),e=ie(),r=E(s=>a(s,t)),o=E(s=>n(s,t)),i=k(()=>o.length===0?null:[...o].sort((s,f)=>{let p=parseInt(s.nodeId.split("_")[1]||"0");return parseInt(f.nodeId.split("_")[1]||"0")-p})[0],[o]),d=k(()=>{let s=new Map(o.map(p=>[p.nodeId,{...p,children:[]}])),f=[];return o.forEach(p=>{let h=s.get(p.nodeId);p.parentTriggerId&&s.has(p.parentTriggerId)?s.get(p.parentTriggerId).children.push(h):f.push(h)}),f},[o]),c=async(s,f,p)=>{let h=await se(t,s,f,p),g=await ce(s,f,p);return e(v(g)),h},l=o.length===0&&r!==void 0,u=r!==void 0||o.length>0;return{cascadeState:r,cascadeNodes:o,currentNode:i,cascadeTree:d,isComplete:l,exists:u,forkCascade:c}},Je=()=>E(V);async function se(t,a,n,e){let r=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:"fork",sourceCascadeId:t,newCascadeId:a,upToFunctionId:n})});if(!r.ok)throw new Error(`forkCascade failed: ${await r.text()}`);return r.json()}async function ce(t,a,n){let e=await fetch(n,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:"hydrate",cascadeId:t,functionId:a})});if(!e.ok)throw new Error(`hydrate failed: ${await e.text()}`);return e.json()}import{useDispatch as de,useSelector as R}from"react-redux";import{useMemo as H,useCallback as N,useRef as le,useEffect as ue}from"react";var fe={},Be=t=>{let a=de(),n=le(void 0);ue(()=>{n.current!==t&&(n.current=t)},[t]);let e=H(()=>t.split("_")[0],[t]),r=R(s=>s.workflow.context[e]||fe),o=R(s=>s.workflow.activeNodes[t]),i=s=>R(f=>s(f.workflow.context)),d=N(async s=>await a(m({[e]:{...r,...s}})),[a,e,r]),c=N(async s=>await a(m(s)),[a]),l=N(async s=>await a(I(s)),[a]),u=N(async(s,f)=>{let p=Array.isArray(s)?s:[s],h=f?.cascadeId,g=[];for(let A of p){let G=`${A}_${Date.now()}_${Math.random().toString(36).substring(2,8)}`,O={...f,sentFromClient:!0};h&&(O.cascadeId=h,g.push(h)),await a(w({nodeId:G,nodeName:A,parentTriggerId:t,contextData:O}))}if(h)return g.length===1?g[0]:g},[a,t]);return H(()=>({context:r,useWorkflowSelector:i,saveContext:d,saveGlobalContext:c,signalCompletion:l,addActiveNode:u,nodeName:e,nodeId:t,nodeData:o}),[r,i,d,c,l,u,e,t,o])};import pe,{useRef as he}from"react";import{Provider as ge}from"react-redux";import{jsx as U}from"react/jsx-runtime";var D=pe.createContext(null);function et({children:t,initialNodeId:a,initialNodeName:n,initialContext:e={},config:r,actionRelayEndpoint:o,persistenceEndpoint:i,hydrationEndpoint:d}){let c=he(null);return c.current||(c.current=P(r.clientWorkflowGraph,o,i,d),c.current.dispatch(m(e)),c.current.dispatch(w({nodeId:a,nodeName:n}))),U(ge,{store:c.current,children:U(D.Provider,{value:r,children:t})})}import{useContext as me}from"react";import{useDispatch as ye,useSelector as we}from"react-redux";import{jsx as T}from"react/jsx-runtime";var ct=()=>ye(),Ie=we;function dt(){let t=me(D);if(!t)throw new Error("WorkflowRenderer must be used within a WorkflowProvider.");let{activeNodes:a}=Ie(o=>o.workflow),{clientWorkflowGraph:n,uiComponentRegistry:e}=t,r=Object.keys(a).filter(o=>{let i=a[o];return n[i.nodeName]?.isUINode});return r.length===0?null:T("div",{children:r.map(o=>{let i=a[o],d=e[i.nodeName];return d?T("div",{children:T(d,{nodeId:o})},o):(console.error(`UI component for node '${i.nodeName}' not found.`),null)})})}export{D as ReactWorkflowContext,et as WorkflowProvider,dt as WorkflowRenderer,se as apiForkCascade,ce as apiHydrateCascadeContext,Je as useAllCascades,ct as useAppDispatch,Ie as useAppSelector,Le as useCascade,Be as useWorkflow};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@cascaide-ts/react",
+  "version": "0.1.0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18",
+    "react-redux": "^9.0.0",
+    "@cascaide-ts/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "react-redux": "^9.2.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.0.0",
+    "@cascaide-ts/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}