@perstack/react 0.0.56 → 0.0.58

package/README.md

@@ -5,9 +5,7 @@ Reusable React hooks and utilities for Perstack integration. This is the shared
 ## Installation
 
 ```bash
-npm install @perstack/react
-# or
-pnpm add @perstack/react
+bun add @perstack/react
 ```
 
 ## Usage

package/dist/src/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export { type JobStreamState, type StreamConnector, useJobStream, } from "./use-job-stream.js";
+export { type JobStreamSummary, useJobStreams } from "./use-job-streams.js";
+export { type ActivityProcessState, type RunResult, useRun } from "./use-run.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,YAAY,GACb,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,KAAK,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,SAAS,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA"}

package/dist/src/hooks/index.js

@@ -0,0 +1,4 @@
+export { useJobStream, } from "./use-job-stream.js";
+export { useJobStreams } from "./use-job-streams.js";
+export { useRun } from "./use-run.js";
+//# sourceMappingURL=index.js.map

package/dist/src/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,GACb,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAyB,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAA6C,MAAM,EAAE,MAAM,cAAc,CAAA"}

package/dist/src/hooks/use-job-stream.d.ts

@@ -0,0 +1,17 @@
+import type { ActivityOrGroup } from "@perstack/core";
+import type { StreamingState } from "../types/index.js";
+import { type StreamConnector } from "../utils/stream.js";
+export type { StreamConnector };
+export type JobStreamState = {
+    activities: ActivityOrGroup[];
+    streaming: StreamingState;
+    latestActivity: ActivityOrGroup | null;
+    isConnected: boolean;
+    error: Error | null;
+};
+export declare function useJobStream(options: {
+    jobId: string | null;
+    connect: StreamConnector;
+    enabled?: boolean;
+}): JobStreamState;
+//# sourceMappingURL=use-job-stream.d.ts.map

package/dist/src/hooks/use-job-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-job-stream.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-job-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAA+B,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGtF,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,SAAS,EAAE,cAAc,CAAA;IACzB,cAAc,EAAE,eAAe,GAAG,IAAI,CAAA;IACtC,WAAW,EAAE,OAAO,CAAA;IACpB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAAA;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,EAAE,eAAe,CAAA;IACxB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,GAAG,cAAc,CA8CjB"}

package/dist/src/hooks/use-job-stream.js

@@ -0,0 +1,45 @@
+import { useEffect, useMemo, useRef, useState } from "react";
+import { consumeStream, isAbortError } from "../utils/stream.js";
+import { useRun } from "./use-run.js";
+export function useJobStream(options) {
+    const { jobId, connect, enabled = true } = options;
+    const shouldConnect = Boolean(jobId && enabled);
+    const { activities, streaming, addEvent } = useRun();
+    const [isConnected, setIsConnected] = useState(false);
+    const [error, setError] = useState(null);
+    const addEventRef = useRef(addEvent);
+    addEventRef.current = addEvent;
+    const connectRef = useRef(connect);
+    connectRef.current = connect;
+    useEffect(() => {
+        if (!shouldConnect || !jobId) {
+            setIsConnected(false);
+            return;
+        }
+        const controller = new AbortController();
+        async function run() {
+            setError(null);
+            setIsConnected(true);
+            try {
+                await consumeStream(connectRef.current, jobId, controller.signal, (event) => {
+                    addEventRef.current(event);
+                });
+            }
+            catch (err) {
+                if (isAbortError(err))
+                    return;
+                setError(err instanceof Error ? err : new Error(String(err)));
+            }
+            finally {
+                setIsConnected(false);
+            }
+        }
+        run();
+        return () => {
+            controller.abort();
+        };
+    }, [shouldConnect, jobId]);
+    const latestActivity = useMemo(() => (activities.length > 0 ? activities[activities.length - 1] : null), [activities]);
+    return { activities, streaming, latestActivity, isConnected, error };
+}
+//# sourceMappingURL=use-job-stream.js.map

package/dist/src/hooks/use-job-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-job-stream.js","sourceRoot":"","sources":["../../../src/hooks/use-job-stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE5D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAwB,MAAM,oBAAoB,CAAA;AACtF,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAYrC,MAAM,UAAU,YAAY,CAAC,OAI5B;IACC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,OAAO,CAAA;IAClD,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,CAAA;IAC/C,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAA;IACpD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACrD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAA;IACtD,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACpC,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAA;IAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAClC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAA;IAE5B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,aAAa,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7B,cAAc,CAAC,KAAK,CAAC,CAAA;YACrB,OAAM;QACR,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QAExC,KAAK,UAAU,GAAG;YAChB,QAAQ,CAAC,IAAI,CAAC,CAAA;YACd,cAAc,CAAC,IAAI,CAAC,CAAA;YACpB,IAAI,CAAC;gBACH,MAAM,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,KAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;oBAC3E,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;gBAC5B,CAAC,CAAC,CAAA;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,YAAY,CAAC,GAAG,CAAC;oBAAE,OAAM;gBAC7B,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAC/D,CAAC;oBAAS,CAAC;gBACT,cAAc,CAAC,KAAK,CAAC,CAAA;YACvB,CAAC;QACH,CAAC;QAED,GAAG,EAAE,CAAA;QACL,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,KAAK,EAAE,CAAA;QACpB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,CAAA;IAE1B,MAAM,cAAc,GAAG,OAAO,CAC5B,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EACxE,CAAC,UAAU,CAAC,CACb,CAAA;IAED,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,EAAE,CAAA;AACtE,CAAC"}

package/dist/src/hooks/use-job-streams.d.ts

@@ -0,0 +1,14 @@
+import type { ActivityOrGroup } from "@perstack/core";
+import { type StreamConnector } from "../utils/stream.js";
+export type JobStreamSummary = {
+    latestActivity: ActivityOrGroup | null;
+    isConnected: boolean;
+};
+export declare function useJobStreams(options: {
+    jobs: Array<{
+        id: string;
+        enabled: boolean;
+    }>;
+    connect: StreamConnector;
+}): Map<string, JobStreamSummary>;
+//# sourceMappingURL=use-job-streams.d.ts.map

package/dist/src/hooks/use-job-streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-job-streams.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-job-streams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAOrD,OAAO,EAA+B,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEtF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,EAAE,eAAe,GAAG,IAAI,CAAA;IACtC,WAAW,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACrC,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAC7C,OAAO,EAAE,eAAe,CAAA;CACzB,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAwFhC"}

package/dist/src/hooks/use-job-streams.js

@@ -0,0 +1,89 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+import { createInitialActivityProcessState, processRunEventToActivity, } from "../utils/event-to-activity.js";
+import { consumeStream, isAbortError } from "../utils/stream.js";
+export function useJobStreams(options) {
+    const { jobs, connect } = options;
+    const [states, setStates] = useState(new Map());
+    const controllersRef = useRef(new Map());
+    const activityStateRef = useRef(new Map());
+    const connectRef = useRef(connect);
+    connectRef.current = connect;
+    const connectToJob = useCallback(async (jobId, signal) => {
+        setStates((prev) => {
+            const next = new Map(prev);
+            next.set(jobId, { latestActivity: null, isConnected: true });
+            return next;
+        });
+        let state = activityStateRef.current.get(jobId);
+        if (!state) {
+            state = createInitialActivityProcessState();
+            activityStateRef.current.set(jobId, state);
+        }
+        try {
+            await consumeStream(connectRef.current, jobId, signal, (event) => {
+                let latestActivity = null;
+                processRunEventToActivity(state, event, (activity) => {
+                    latestActivity = activity;
+                });
+                if (latestActivity) {
+                    setStates((prev) => {
+                        const next = new Map(prev);
+                        next.set(jobId, { latestActivity, isConnected: true });
+                        return next;
+                    });
+                }
+            });
+        }
+        catch (err) {
+            if (isAbortError(err))
+                return;
+            console.error(`Stream connection failed for job ${jobId}:`, err);
+        }
+        finally {
+            setStates((prev) => {
+                const current = prev.get(jobId);
+                if (!current)
+                    return prev;
+                const next = new Map(prev);
+                next.set(jobId, { ...current, isConnected: false });
+                return next;
+            });
+        }
+    }, []);
+    useEffect(() => {
+        const enabledIds = new Set(jobs.filter((j) => j.enabled).map((j) => j.id));
+        // Disconnect removed/disabled jobs
+        for (const [jobId, controller] of controllersRef.current) {
+            if (!enabledIds.has(jobId)) {
+                controller.abort();
+                controllersRef.current.delete(jobId);
+                activityStateRef.current.delete(jobId);
+                setStates((prev) => {
+                    const next = new Map(prev);
+                    next.delete(jobId);
+                    return next;
+                });
+            }
+        }
+        // Connect new jobs
+        for (const jobId of enabledIds) {
+            if (!controllersRef.current.has(jobId)) {
+                const controller = new AbortController();
+                controllersRef.current.set(jobId, controller);
+                connectToJob(jobId, controller.signal);
+            }
+        }
+    }, [jobs, connectToJob]);
+    // Cleanup on unmount only
+    useEffect(() => {
+        return () => {
+            for (const controller of controllersRef.current.values()) {
+                controller.abort();
+            }
+            controllersRef.current.clear();
+            activityStateRef.current.clear();
+        };
+    }, []);
+    return states;
+}
+//# sourceMappingURL=use-job-streams.js.map

package/dist/src/hooks/use-job-streams.js.map

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

package/dist/src/hooks/use-run.d.ts

@@ -0,0 +1,38 @@
+import type { ActivityOrGroup, PerstackEvent, StreamingEvent } from "@perstack/core";
+import type { StreamingState } from "../types/index.js";
+import { type ActivityProcessState } from "../utils/event-to-activity.js";
+export type { ActivityProcessState };
+export declare const isStreamingEvent: (event: PerstackEvent) => event is StreamingEvent;
+export type ProcessStreamingEventResult = {
+    newState: StreamingState;
+    handled: boolean;
+};
+export declare function processStreamingEvent(event: StreamingEvent, prevState: StreamingState): ProcessStreamingEventResult;
+export type RunResult = {
+    /** Accumulated activities from RunEvent (may include ParallelActivitiesGroup) */
+    activities: ActivityOrGroup[];
+    /** Current streaming state */
+    streaming: StreamingState;
+    /** Whether the run is complete */
+    isComplete: boolean;
+    /** Number of events processed */
+    eventCount: number;
+    /** Add a new event to be processed */
+    addEvent: (event: PerstackEvent) => void;
+    /** Append historical events (processes and appends to activities) */
+    appendHistoricalEvents: (events: PerstackEvent[]) => void;
+    /** Clear streaming state */
+    clearStreaming: () => void;
+};
+/**
+ * Hook for managing Run state from RunEvent stream.
+ *
+ * Architecture:
+ * - ExpertStateEvent → ActivityOrGroup[] (accumulated, append-only)
+ * - StreamingEvent → StreamingState (latest only, for display)
+ *
+ * IMPORTANT: activities are append-only and never cleared.
+ * This is required for compatibility with Ink's <Static> component.
+ */
+export declare function useRun(): RunResult;
+//# sourceMappingURL=use-run.d.ts.map

package/dist/src/hooks/use-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-run.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,+BAA+B,CAAA;AAEtC,YAAY,EAAE,oBAAoB,EAAE,CAAA;AAWpC,eAAO,MAAM,gBAAgB,GAAI,OAAO,aAAa,KAAG,KAAK,IAAI,cACiB,CAAA;AAElF,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,cAAc,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,cAAc,GACxB,2BAA2B,CA+G7B;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,iFAAiF;IACjF,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,8BAA8B;IAC9B,SAAS,EAAE,cAAc,CAAA;IACzB,kCAAkC;IAClC,UAAU,EAAE,OAAO,CAAA;IACnB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,sCAAsC;IACtC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IACxC,qEAAqE;IACrE,sBAAsB,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,IAAI,CAAA;IACzD,4BAA4B;IAC5B,cAAc,EAAE,MAAM,IAAI,CAAA;CAC3B,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,IAAI,SAAS,CAiGlC"}

package/dist/src/hooks/use-run.js

@@ -0,0 +1,200 @@
+import { useCallback, useRef, useState } from "react";
+import { createInitialActivityProcessState, processRunEventToActivity, } from "../utils/event-to-activity.js";
+const STREAMING_EVENT_TYPES = new Set([
+    "startStreamingReasoning",
+    "streamReasoning",
+    "completeStreamingReasoning",
+    "startStreamingRunResult",
+    "streamRunResult",
+    "completeStreamingRunResult",
+]);
+export const isStreamingEvent = (event) => "type" in event && "expertKey" in event && STREAMING_EVENT_TYPES.has(event.type);
+export function processStreamingEvent(event, prevState) {
+    const { runId, expertKey } = event;
+    switch (event.type) {
+        case "startStreamingReasoning": {
+            return {
+                newState: {
+                    ...prevState,
+                    runs: {
+                        ...prevState.runs,
+                        [runId]: {
+                            expertKey,
+                            reasoning: "",
+                            isReasoningActive: true,
+                        },
+                    },
+                },
+                handled: true,
+            };
+        }
+        case "streamReasoning": {
+            return {
+                newState: {
+                    ...prevState,
+                    runs: {
+                        ...prevState.runs,
+                        [runId]: {
+                            ...prevState.runs[runId],
+                            expertKey,
+                            reasoning: (prevState.runs[runId]?.reasoning ?? "") + event.delta,
+                        },
+                    },
+                },
+                handled: true,
+            };
+        }
+        case "completeStreamingReasoning": {
+            return {
+                newState: {
+                    ...prevState,
+                    runs: {
+                        ...prevState.runs,
+                        [runId]: {
+                            ...prevState.runs[runId],
+                            expertKey,
+                            isReasoningActive: false,
+                        },
+                    },
+                },
+                handled: false,
+            };
+        }
+        case "startStreamingRunResult": {
+            return {
+                newState: {
+                    ...prevState,
+                    runs: {
+                        ...prevState.runs,
+                        [runId]: {
+                            expertKey,
+                            reasoning: undefined,
+                            isReasoningActive: false,
+                            runResult: "",
+                            isRunResultActive: true,
+                        },
+                    },
+                },
+                handled: true,
+            };
+        }
+        case "streamRunResult": {
+            return {
+                newState: {
+                    ...prevState,
+                    runs: {
+                        ...prevState.runs,
+                        [runId]: {
+                            ...prevState.runs[runId],
+                            expertKey,
+                            runResult: (prevState.runs[runId]?.runResult ?? "") + event.delta,
+                        },
+                    },
+                },
+                handled: true,
+            };
+        }
+        case "completeStreamingRunResult": {
+            return {
+                newState: {
+                    ...prevState,
+                    runs: {
+                        ...prevState.runs,
+                        [runId]: {
+                            ...prevState.runs[runId],
+                            expertKey,
+                            isRunResultActive: false,
+                        },
+                    },
+                },
+                handled: true,
+            };
+        }
+        default:
+            return { newState: prevState, handled: false };
+    }
+}
+/**
+ * Hook for managing Run state from RunEvent stream.
+ *
+ * Architecture:
+ * - ExpertStateEvent → ActivityOrGroup[] (accumulated, append-only)
+ * - StreamingEvent → StreamingState (latest only, for display)
+ *
+ * IMPORTANT: activities are append-only and never cleared.
+ * This is required for compatibility with Ink's <Static> component.
+ */
+export function useRun() {
+    const [activities, setActivities] = useState([]);
+    const [streaming, setStreaming] = useState({ runs: {} });
+    const [eventCount, setEventCount] = useState(0);
+    const [isComplete, setIsComplete] = useState(false);
+    const stateRef = useRef(createInitialActivityProcessState());
+    const clearStreaming = useCallback(() => {
+        setStreaming({ runs: {} });
+    }, []);
+    const handleStreamingEvent = useCallback((event) => {
+        let handled = false;
+        setStreaming((prev) => {
+            const result = processStreamingEvent(event, prev);
+            handled = result.handled;
+            return result.newState;
+        });
+        return handled;
+    }, []);
+    const processEvent = useCallback((event) => {
+        const newActivities = [];
+        const addActivity = (activity) => newActivities.push(activity);
+        processRunEventToActivity(stateRef.current, event, addActivity);
+        if (newActivities.length > 0) {
+            setActivities((prev) => [...prev, ...newActivities]);
+        }
+        const rootRunComplete = Array.from(stateRef.current.runStates.values()).some((rs) => rs.isComplete && !rs.delegatedBy);
+        setIsComplete(rootRunComplete);
+    }, []);
+    const clearRunStreaming = useCallback((runId) => {
+        setStreaming((prev) => {
+            const { [runId]: _, ...rest } = prev.runs;
+            return { runs: rest };
+        });
+    }, []);
+    const addEvent = useCallback((event) => {
+        if (isStreamingEvent(event)) {
+            const handled = handleStreamingEvent(event);
+            if (handled) {
+                setEventCount((prev) => prev + 1);
+                return;
+            }
+        }
+        if ("type" in event &&
+            "runId" in event &&
+            (event.type === "completeRun" || event.type === "stopRunByError")) {
+            clearRunStreaming(event.runId);
+        }
+        processEvent(event);
+        setEventCount((prev) => prev + 1);
+    }, [handleStreamingEvent, clearRunStreaming, processEvent]);
+    const appendHistoricalEvents = useCallback((historicalEvents) => {
+        const newActivities = [];
+        const addActivity = (activity) => newActivities.push(activity);
+        for (const event of historicalEvents) {
+            processRunEventToActivity(stateRef.current, event, addActivity);
+        }
+        if (newActivities.length > 0) {
+            setActivities((prev) => [...prev, ...newActivities]);
+        }
+        setEventCount((prev) => prev + historicalEvents.length);
+        const rootRunComplete = Array.from(stateRef.current.runStates.values()).some((rs) => rs.isComplete && !rs.delegatedBy);
+        setIsComplete(rootRunComplete);
+    }, []);
+    return {
+        activities,
+        streaming,
+        isComplete,
+        eventCount,
+        addEvent,
+        appendHistoricalEvents,
+        clearStreaming,
+    };
+}
+//# sourceMappingURL=use-run.js.map

package/dist/src/hooks/use-run.js.map

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

package/dist/src/index.d.ts

@@ -1,157 +1,4 @@
-import { Activity, ActivityOrGroup, PerstackEvent, ToolCall, ToolResult } from "@perstack/core";
-
-//#region src/types/runtime-state.d.ts
-/** Per-run streaming state for real-time display */
-type PerRunStreamingState = {
-  /** Expert key for this run */expertKey: string; /** Accumulated reasoning text during extended thinking */
-  reasoning?: string; /** Accumulated run result text during generation */
-  runResult?: string; /** Whether reasoning is currently streaming */
-  isReasoningActive?: boolean; /** Whether run result is currently streaming */
-  isRunResultActive?: boolean;
-};
-/** Streaming state organized by run ID to support parallel execution */
-type StreamingState = {
-  /** Per-run streaming state, keyed by runId */runs: Record<string, PerRunStreamingState>;
-};
-//#endregion
-//#region src/utils/stream.d.ts
-type StreamConnector = (jobId: string, signal: AbortSignal) => Promise<AsyncIterable<PerstackEvent>>;
-//#endregion
-//#region src/hooks/use-job-stream.d.ts
-type JobStreamState = {
-  activities: ActivityOrGroup[];
-  streaming: StreamingState;
-  latestActivity: ActivityOrGroup | null;
-  isConnected: boolean;
-  error: Error | null;
-};
-declare function useJobStream(options: {
-  jobId: string | null;
-  connect: StreamConnector;
-  enabled?: boolean;
-}): JobStreamState;
-//#endregion
-//#region src/hooks/use-job-streams.d.ts
-type JobStreamSummary = {
-  latestActivity: ActivityOrGroup | null;
-  isConnected: boolean;
-};
-declare function useJobStreams(options: {
-  jobs: Array<{
-    id: string;
-    enabled: boolean;
-  }>;
-  connect: StreamConnector;
-}): Map<string, JobStreamSummary>;
-//#endregion
-//#region src/utils/event-to-activity.d.ts
-/**
- * Converts a tool call and result to an Activity.
- * Delegates to core's createBaseToolActivity/createGeneralToolActivity to avoid duplication.
- */
-declare function toolToActivity(toolCall: ToolCall, toolResult: ToolResult, reasoning: string | undefined, meta: {
-  id: string;
-  expertKey: string;
-  runId: string;
-  previousActivityId?: string;
-  delegatedBy?: {
-    expertKey: string;
-    runId: string;
-  };
-}): Activity;
-type ToolState = {
-  id: string;
-  toolCall: ToolCall;
-  logged: boolean;
-};
-/**
- * Per-run state to support parallel execution.
- * Each run maintains its own independent state.
- */
-type RunState = {
-  expertKey: string;
-  queryLogged: boolean;
-  completionLogged: boolean;
-  isComplete: boolean;
-  completedReasoning?: string;
-  lastActivityId?: string;
-  delegatedBy?: {
-    expertKey: string;
-    runId: string;
-  }; /** Track if this run has pending delegate tool calls (for delegation complete detection) */
-  pendingDelegateCount: number;
-};
-/**
- * State for processing RunEvent stream into Activity[].
- * This state tracks tool calls and their results to create complete Activity items.
- *
- * Supports the daisy chain architecture:
- * - Within-Run ordering via lastActivityId (per-run state)
- * - Cross-Run ordering via delegatedBy (per-run state)
- *
- * Note: `tools` is NOT cleared on new run to support delegation results
- * that arrive after parent expert resumes with a new runId.
- */
-type ActivityProcessState = {
-  /** Tool calls indexed by toolCallId - persisted across runs for delegation handling */tools: Map<string, ToolState>; /** Per-run state to support parallel execution */
-  runStates: Map<string, RunState>;
-};
-declare function createInitialActivityProcessState(): ActivityProcessState;
-/**
- * Processes a RunEvent and produces Activity or ParallelActivitiesGroup items.
- * Only processes RunEvent (state machine transitions), not RuntimeEvent.
- *
- * @param state - Mutable processing state
- * @param event - The event to process
- * @param addActivity - Callback to add a new Activity or ParallelActivitiesGroup
- */
-declare function processRunEventToActivity(state: ActivityProcessState, event: PerstackEvent, addActivity: (activity: ActivityOrGroup) => void): void;
-//#endregion
-//#region src/hooks/use-run.d.ts
-type RunResult = {
-  /** Accumulated activities from RunEvent (may include ParallelActivitiesGroup) */activities: ActivityOrGroup[]; /** Current streaming state */
-  streaming: StreamingState; /** Whether the run is complete */
-  isComplete: boolean; /** Number of events processed */
-  eventCount: number; /** Add a new event to be processed */
-  addEvent: (event: PerstackEvent) => void; /** Append historical events (processes and appends to activities) */
-  appendHistoricalEvents: (events: PerstackEvent[]) => void; /** Clear streaming state */
-  clearStreaming: () => void;
-};
-/**
- * Hook for managing Run state from RunEvent stream.
- *
- * Architecture:
- * - ExpertStateEvent → ActivityOrGroup[] (accumulated, append-only)
- * - StreamingEvent → StreamingState (latest only, for display)
- *
- * IMPORTANT: activities are append-only and never cleared.
- * This is required for compatibility with Ink's <Static> component.
- */
-declare function useRun(): RunResult;
-//#endregion
-//#region src/utils/group-by-run.d.ts
-/**
- * Represents a group of activities belonging to the same run
- */
-type RunGroup = {
-  runId: string;
-  expertKey: string;
-  activities: ActivityOrGroup[];
-  delegatedBy?: {
-    expertKey: string;
-    runId: string;
-  };
-};
-/**
- * Groups activities by their runId while preserving order.
- *
- * This function groups activities so that each run can be displayed in its own
- * visual section (e.g., separate <Static> components in Ink).
- *
- * @param activities - Array of activities or groups to group
- * @returns Array of RunGroup objects, ordered by first appearance
- */
-declare function groupActivitiesByRun(activities: ActivityOrGroup[]): RunGroup[];
-//#endregion
-export { type ActivityProcessState, type ActivityProcessState as UtilActivityProcessState, type JobStreamState, type JobStreamSummary, type PerRunStreamingState, type RunGroup, type RunResult, type StreamConnector, type StreamingState, createInitialActivityProcessState, groupActivitiesByRun, processRunEventToActivity, toolToActivity, useJobStream, useJobStreams, useRun };
+export { type ActivityProcessState, type JobStreamState, type JobStreamSummary, type RunResult, type StreamConnector, useJobStream, useJobStreams, useRun, } from "./hooks/index.js";
+export type { PerRunStreamingState, StreamingState } from "./types/index.js";
+export { type ActivityProcessState as UtilActivityProcessState, createInitialActivityProcessState, groupActivitiesByRun, processRunEventToActivity, type RunGroup, toolToActivity, } from "./utils/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,YAAY,EACZ,aAAa,EACb,MAAM,GACP,MAAM,kBAAkB,CAAA;AAGzB,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAG5E,OAAO,EACL,KAAK,oBAAoB,IAAI,wBAAwB,EACrD,iCAAiC,EACjC,oBAAoB,EACpB,yBAAyB,EACzB,KAAK,QAAQ,EACb,cAAc,GACf,MAAM,kBAAkB,CAAA"}