@parhelia/core 0.1.12785 → 0.1.12787

package/dist/editor/ai/terminal/useAgentRunMessagePipeline.d.ts

@@ -0,0 +1,42 @@
+import { useAgentContentChunkHandler } from "./useAgentContentChunkHandler";
+import { useAgentContextUpdateHandler } from "./useAgentContextUpdateHandler";
+import { useAgentHeartbeatMessages } from "./useAgentHeartbeatMessages";
+import { useAgentRunSequenceGuard } from "./useAgentRunSequenceGuard";
+import { useAgentSettleCompletedRun } from "./useAgentSettleCompletedRun";
+import { useAgentStreamMessageFactory } from "./useAgentStreamMessageFactory";
+import { useAgentToolCallHandler } from "./useAgentToolCallHandler";
+import { useAgentToolResultHandler } from "./useAgentToolResultHandler";
+type StreamMessageFactoryInput = Parameters<typeof useAgentStreamMessageFactory>[0];
+type ContextUpdateInput = Parameters<typeof useAgentContextUpdateHandler>[0];
+type SequenceGuardInput = Parameters<typeof useAgentRunSequenceGuard>[0];
+type HeartbeatInput = Parameters<typeof useAgentHeartbeatMessages>[0];
+type SettleInput = Parameters<typeof useAgentSettleCompletedRun>[0];
+type ContentChunkInput = Parameters<typeof useAgentContentChunkHandler>[0];
+type ToolCallInput = Parameters<typeof useAgentToolCallHandler>[0];
+type ToolResultInput = Parameters<typeof useAgentToolResultHandler>[0];
+export declare function useAgentRunMessagePipeline(input: {
+    streamMessageFactory: StreamMessageFactoryInput;
+    contextUpdate: ContextUpdateInput;
+    sequenceGuard: SequenceGuardInput;
+    heartbeat: HeartbeatInput;
+    settle: Omit<SettleInput, "clearHeartbeatMessages">;
+    contentChunk: Omit<ContentChunkInput, "createNewStreamMessage">;
+    toolCall: Omit<ToolCallInput, "createNewStreamMessage">;
+    toolResult: ToolResultInput;
+}): {
+    settleCompletedRun: (finalStatus?: "completed" | "cancelled", runId?: string | null) => void;
+    handleContentChunk: (message: import("../../services/agentService").AgentStreamMessage, agentData?: import("../../services/agentService").AgentDetails) => void;
+    handleToolCall: (message: import("../../services/agentService").AgentStreamMessage, agentData?: import("../../services/agentService").AgentDetails) => void;
+    handleToolResult: (message: import("../../services/agentService").AgentStreamMessage, agentData?: import("../../services/agentService").AgentDetails) => void;
+    stripHeartbeatMessages: (list: import("../../services/agentService").AgentChatMessage[]) => import("../../services/agentService").AgentChatMessage[];
+    handleHeartbeatMessage: (message: import("../../services/agentService").AgentStreamMessage) => void;
+    clearHeartbeatMessages: () => void;
+    createNewStreamMessage: (messageId: string, agentData?: import("../../services/agentService").AgentDetails) => import("../../services/agentService").AgentChatMessage;
+    handleContextUpdate: (contextData: any) => void;
+    acceptRunSequenceFrame: (frame: {
+        eventName: "agent:run:delta" | "agent:run:status";
+        runId: string | undefined;
+        seq: number | undefined;
+    }) => boolean;
+};
+export {};

package/dist/editor/ai/terminal/useAgentRunMessagePipeline.js

@@ -0,0 +1,39 @@
+import { useAgentContentChunkHandler } from "./useAgentContentChunkHandler";
+import { useAgentContextUpdateHandler } from "./useAgentContextUpdateHandler";
+import { useAgentHeartbeatMessages } from "./useAgentHeartbeatMessages";
+import { useAgentRunSequenceGuard } from "./useAgentRunSequenceGuard";
+import { useAgentSettleCompletedRun } from "./useAgentSettleCompletedRun";
+import { useAgentStreamMessageFactory } from "./useAgentStreamMessageFactory";
+import { useAgentToolCallHandler } from "./useAgentToolCallHandler";
+import { useAgentToolResultHandler } from "./useAgentToolResultHandler";
+export function useAgentRunMessagePipeline(input) {
+    const { streamMessageFactory, contextUpdate, sequenceGuard, heartbeat, settle, contentChunk, toolCall, toolResult, } = input;
+    const createNewStreamMessage = useAgentStreamMessageFactory(streamMessageFactory);
+    const handleContextUpdate = useAgentContextUpdateHandler(contextUpdate);
+    const acceptRunSequenceFrame = useAgentRunSequenceGuard(sequenceGuard);
+    const heartbeatHandlers = useAgentHeartbeatMessages(heartbeat);
+    const settleCompletedRun = useAgentSettleCompletedRun({
+        ...settle,
+        clearHeartbeatMessages: heartbeatHandlers.clearHeartbeatMessages,
+    });
+    const handleContentChunk = useAgentContentChunkHandler({
+        ...contentChunk,
+        createNewStreamMessage,
+    });
+    const handleToolCall = useAgentToolCallHandler({
+        ...toolCall,
+        createNewStreamMessage,
+    });
+    const handleToolResult = useAgentToolResultHandler(toolResult);
+    return {
+        createNewStreamMessage,
+        handleContextUpdate,
+        acceptRunSequenceFrame,
+        ...heartbeatHandlers,
+        settleCompletedRun,
+        handleContentChunk,
+        handleToolCall,
+        handleToolResult,
+    };
+}
+//# sourceMappingURL=useAgentRunMessagePipeline.js.map

package/dist/editor/ai/terminal/useAgentRunMessagePipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentRunMessagePipeline.js","sourceRoot":"","sources":["../../../../src/editor/ai/terminal/useAgentRunMessagePipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAaxE,MAAM,UAAU,0BAA0B,CAAC,KAS1C;IACC,MAAM,EACJ,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,SAAS,EACT,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,UAAU,GACX,GAAG,KAAK,CAAC;IAEV,MAAM,sBAAsB,GAC1B,4BAA4B,CAAC,oBAAoB,CAAC,CAAC;IACrD,MAAM,mBAAmB,GAAG,4BAA4B,CAAC,aAAa,CAAC,CAAC;IACxE,MAAM,sBAAsB,GAAG,wBAAwB,CAAC,aAAa,CAAC,CAAC;IACvE,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC/D,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;QACpD,GAAG,MAAM;QACT,sBAAsB,EAAE,iBAAiB,CAAC,sBAAsB;KACjE,CAAC,CAAC;IACH,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;QACrD,GAAG,YAAY;QACf,sBAAsB;KACvB,CAAC,CAAC;IACH,MAAM,cAAc,GAAG,uBAAuB,CAAC;QAC7C,GAAG,QAAQ;QACX,sBAAsB;KACvB,CAAC,CAAC;IACH,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAE/D,OAAO;QACL,sBAAsB;QACtB,mBAAmB;QACnB,sBAAsB;QACtB,GAAG,iBAAiB;QACpB,kBAAkB;QAClB,kBAAkB;QAClB,cAAc;QACd,gBAAgB;KACjB,CAAC;AACJ,CAAC"}

package/dist/editor/ai/terminal/useAgentRunRefs.d.ts

@@ -0,0 +1,17 @@
+export declare function useAgentRunRefs(input: {
+    isWaitingForResponse: boolean;
+}): {
+    isWaitingRef: import("react").RefObject<boolean>;
+    seenMessageIdsRef: import("react").RefObject<Set<string>>;
+    lastSeqRef: import("react").RefObject<number>;
+    shouldCreateNewMessageRef: import("react").RefObject<boolean>;
+    currentRunIdRef: import("react").RefObject<string | null>;
+    lastSettledRunIdRef: import("react").RefObject<string | null>;
+    lastResyncedMessageIdsRef: import("react").RefObject<Set<string>>;
+    subscribedAgentIdRef: import("react").RefObject<string | null>;
+    lastNonHeartbeatUpdateAtRef: import("react").RefObject<number>;
+    lastStallReloadAtRef: import("react").RefObject<number>;
+    toolCallFirstSeenAtRef: import("react").RefObject<Record<string, number>>;
+    pendingToolCompletionTimersRef: import("react").RefObject<Record<string, NodeJS.Timeout>>;
+    noteMissingRunId: (source: string) => void;
+};

package/dist/editor/ai/terminal/useAgentRunRefs.js

@@ -0,0 +1,44 @@
+import { useCallback, useEffect, useRef } from "react";
+export function useAgentRunRefs(input) {
+    const { isWaitingForResponse } = input;
+    const isWaitingRef = useRef(false);
+    const seenMessageIdsRef = useRef(new Set());
+    const lastSeqRef = useRef(0);
+    const shouldCreateNewMessageRef = useRef(false);
+    const currentRunIdRef = useRef(null);
+    const lastSettledRunIdRef = useRef(null);
+    const warnedMissingRunIdRef = useRef(false);
+    const lastResyncedMessageIdsRef = useRef(new Set());
+    const subscribedAgentIdRef = useRef(null);
+    const lastNonHeartbeatUpdateAtRef = useRef(0);
+    const lastStallReloadAtRef = useRef(0);
+    const toolCallFirstSeenAtRef = useRef({});
+    const pendingToolCompletionTimersRef = useRef({});
+    const noteMissingRunId = useCallback((source) => {
+        if (warnedMissingRunIdRef.current)
+            return;
+        warnedMissingRunIdRef.current = true;
+        console.warn("[AgentTerminal] received lifecycle/delta payload without runId; " +
+            "falling back to legacy run scoping. Server may need upgrade. source=" +
+            source);
+    }, []);
+    useEffect(() => {
+        isWaitingRef.current = isWaitingForResponse;
+    }, [isWaitingForResponse]);
+    return {
+        isWaitingRef,
+        seenMessageIdsRef,
+        lastSeqRef,
+        shouldCreateNewMessageRef,
+        currentRunIdRef,
+        lastSettledRunIdRef,
+        lastResyncedMessageIdsRef,
+        subscribedAgentIdRef,
+        lastNonHeartbeatUpdateAtRef,
+        lastStallReloadAtRef,
+        toolCallFirstSeenAtRef,
+        pendingToolCompletionTimersRef,
+        noteMissingRunId,
+    };
+}
+//# sourceMappingURL=useAgentRunRefs.js.map

package/dist/editor/ai/terminal/useAgentRunRefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentRunRefs.js","sourceRoot":"","sources":["../../../../src/editor/ai/terminal/useAgentRunRefs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEvD,MAAM,UAAU,eAAe,CAAC,KAAwC;IACtE,MAAM,EAAE,oBAAoB,EAAE,GAAG,KAAK,CAAC;IACvC,MAAM,YAAY,GAAG,MAAM,CAAU,KAAK,CAAC,CAAC;IAC5C,MAAM,iBAAiB,GAAG,MAAM,CAAc,IAAI,GAAG,EAAE,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,MAAM,CAAS,CAAC,CAAC,CAAC;IACrC,MAAM,yBAAyB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,eAAe,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IACpD,MAAM,mBAAmB,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IACxD,MAAM,qBAAqB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,yBAAyB,GAAG,MAAM,CAAc,IAAI,GAAG,EAAE,CAAC,CAAC;IACjE,MAAM,oBAAoB,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IACzD,MAAM,2BAA2B,GAAG,MAAM,CAAS,CAAC,CAAC,CAAC;IACtD,MAAM,oBAAoB,GAAG,MAAM,CAAS,CAAC,CAAC,CAAC;IAC/C,MAAM,sBAAsB,GAAG,MAAM,CAAyB,EAAE,CAAC,CAAC;IAClE,MAAM,8BAA8B,GAAG,MAAM,CAE3C,EAAE,CAAC,CAAC;IAEN,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,MAAc,EAAE,EAAE;QACtD,IAAI,qBAAqB,CAAC,OAAO;YAAE,OAAO;QAC1C,qBAAqB,CAAC,OAAO,GAAG,IAAI,CAAC;QACrC,OAAO,CAAC,IAAI,CACV,kEAAkE;YAChE,sEAAsE;YACtE,MAAM,CACT,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,CAAC,GAAG,EAAE;QACb,YAAY,CAAC,OAAO,GAAG,oBAAoB,CAAC;IAC9C,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAE3B,OAAO;QACL,YAAY;QACZ,iBAAiB;QACjB,UAAU;QACV,yBAAyB;QACzB,eAAe;QACf,mBAAmB;QACnB,yBAAyB;QACzB,oBAAoB;QACpB,2BAA2B;QAC3B,oBAAoB;QACpB,sBAAsB;QACtB,8BAA8B;QAC9B,gBAAgB;KACjB,CAAC;AACJ,CAAC"}

package/dist/editor/ai/terminal/useAgentRunResyncSocketHandler.d.ts

@@ -0,0 +1,15 @@
+import { type MutableRefObject } from "react";
+import type { AgentChatMessage, AgentDetails } from "../../services/agentService";
+import type { AgentSessionActions } from "./useAgentSession";
+export declare function useAgentRunResyncSocketHandler(input: {
+    agent: AgentDetails | undefined;
+    actions: AgentSessionActions;
+    messagesRef: MutableRefObject<AgentChatMessage[]>;
+    currentRunIdRef: MutableRefObject<string | null>;
+    lastSeqRef: MutableRefObject<number>;
+    lastResyncedMessageIdsRef: MutableRefObject<Set<string>>;
+    normalizeRunId: (value: unknown) => string | null;
+    noteMissingRunId: (source: string) => void;
+    appendToolUiEvent: (type: string, detail?: string | null, seq?: number | null) => void;
+    createNewStreamMessage: (messageId: string, agentData?: AgentDetails) => AgentChatMessage;
+}): (messageType: string, payload: any) => boolean;

package/dist/editor/ai/terminal/useAgentRunResyncSocketHandler.js

@@ -0,0 +1,101 @@
+import { useCallback } from "react";
+export function useAgentRunResyncSocketHandler(input) {
+    const { agent, actions, messagesRef, currentRunIdRef, lastSeqRef, lastResyncedMessageIdsRef, normalizeRunId, noteMissingRunId, appendToolUiEvent, createNewStreamMessage, } = input;
+    return useCallback((messageType, payload) => {
+        if (messageType !== "agent:run:resync") {
+            return false;
+        }
+        const resyncRunId = normalizeRunId(payload?.runId);
+        if (resyncRunId === null) {
+            noteMissingRunId("agent:run:resync");
+        }
+        else if (currentRunIdRef.current !== null &&
+            resyncRunId !== currentRunIdRef.current) {
+            appendToolUiEvent("ui:stream-runid-dropped", `agent:run:resync runId=${resyncRunId} currentRunId=${currentRunIdRef.current}`);
+            return true;
+        }
+        const resyncMessageId = payload?.messageId;
+        if (!resyncMessageId) {
+            return true;
+        }
+        const totalContent = String(payload?.totalContent ?? "");
+        const reasoning = String(payload?.reasoning ?? "");
+        const seq = Number(payload?.seq ?? 0);
+        const rawToolCalls = Array.isArray(payload?.toolCalls)
+            ? payload.toolCalls
+            : [];
+        const normalizedToolCalls = rawToolCalls
+            .filter((toolCall) => toolCall && typeof toolCall === "object")
+            .map((toolCall) => {
+            const toolCallId = toolCall.toolCallId || toolCall.id || crypto.randomUUID();
+            return {
+                id: toolCallId,
+                messageId: resyncMessageId,
+                toolCallId,
+                functionName: toolCall.functionName || toolCall.name || toolCall.displayName || "",
+                functionArguments: toolCall.functionArguments ?? toolCall.arguments ?? "",
+                functionResult: toolCall.functionResult ?? toolCall.result ?? "",
+                functionResultRichContent: toolCall.functionResultRichContent ??
+                    toolCall.richContent ??
+                    undefined,
+                functionError: toolCall.functionError ?? toolCall.error ?? "",
+                isCompleted: toolCall.isCompleted === true,
+                responseTimeMs: toolCall.responseTimeMs,
+                createdDate: toolCall.createdDate ||
+                    payload?.timestamp ||
+                    new Date().toISOString(),
+                requiresApproval: toolCall.requiresApproval,
+                ...(toolCall.dbMessageId
+                    ? { dbMessageId: toolCall.dbMessageId }
+                    : {}),
+            };
+        });
+        const existingIndex = messagesRef.current.findIndex((message) => message.id === resyncMessageId);
+        if (existingIndex === -1) {
+            const created = createNewStreamMessage(resyncMessageId, agent);
+            const seeded = {
+                ...created,
+                content: totalContent,
+                reasoning,
+                toolCalls: normalizedToolCalls,
+            };
+            const updated = [...messagesRef.current, seeded];
+            messagesRef.current = updated;
+            actions.replaceTranscript(updated);
+            return true;
+        }
+        else {
+            const updated = messagesRef.current.map((message, index) => index === existingIndex
+                ? {
+                    ...message,
+                    content: totalContent,
+                    reasoning,
+                    toolCalls: normalizedToolCalls,
+                }
+                : message);
+            messagesRef.current = updated;
+            actions.replaceTranscript(updated);
+        }
+        if (seq && seq > lastSeqRef.current) {
+            lastSeqRef.current = seq;
+        }
+        actions.runFrame({
+            runId: payload?.runId,
+            seq,
+        });
+        lastResyncedMessageIdsRef.current.add(resyncMessageId.toLowerCase());
+        return true;
+    }, [
+        actions,
+        agent,
+        appendToolUiEvent,
+        createNewStreamMessage,
+        currentRunIdRef,
+        lastResyncedMessageIdsRef,
+        lastSeqRef,
+        messagesRef,
+        normalizeRunId,
+        noteMissingRunId,
+    ]);
+}
+//# sourceMappingURL=useAgentRunResyncSocketHandler.js.map

package/dist/editor/ai/terminal/useAgentRunResyncSocketHandler.js.map

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

package/dist/editor/ai/terminal/useAgentRunSequenceGuard.d.ts

@@ -0,0 +1,11 @@
+import { type MutableRefObject } from "react";
+import type { AgentSessionActions } from "./useAgentSession";
+export declare function useAgentRunSequenceGuard(input: {
+    lastSeqRef: MutableRefObject<number>;
+    actions: AgentSessionActions;
+    appendToolUiEvent: (type: string, details?: string, seq?: number | null) => void;
+}): (frame: {
+    eventName: "agent:run:delta" | "agent:run:status";
+    runId: string | undefined;
+    seq: number | undefined;
+}) => boolean;

package/dist/editor/ai/terminal/useAgentRunSequenceGuard.js

@@ -0,0 +1,22 @@
+import { useCallback } from "react";
+export function useAgentRunSequenceGuard(input) {
+    const { lastSeqRef, actions, appendToolUiEvent } = input;
+    return useCallback((frame) => {
+        if (frame.seq === 1 && lastSeqRef.current > 0) {
+            lastSeqRef.current = 0;
+        }
+        if (frame.seq && frame.seq <= lastSeqRef.current) {
+            appendToolUiEvent("ui:stream-seq-dropped", `${frame.eventName} seq=${frame.seq} lastSeq=${lastSeqRef.current}`, frame.seq);
+            return false;
+        }
+        if (frame.seq) {
+            lastSeqRef.current = frame.seq;
+        }
+        actions.runFrame({
+            runId: frame.runId,
+            seq: frame.seq,
+        });
+        return true;
+    }, [actions, appendToolUiEvent, lastSeqRef]);
+}
+//# sourceMappingURL=useAgentRunSequenceGuard.js.map

package/dist/editor/ai/terminal/useAgentRunSequenceGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentRunSequenceGuard.js","sourceRoot":"","sources":["../../../../src/editor/ai/terminal/useAgentRunSequenceGuard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAyB,MAAM,OAAO,CAAC;AAG3D,MAAM,UAAU,wBAAwB,CAAC,KAQxC;IACC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,KAAK,CAAC;IAEzD,OAAO,WAAW,CAChB,CAAC,KAIA,EAAW,EAAE;QACZ,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,UAAU,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YAC9C,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC;QACzB,CAAC;QAED,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACjD,iBAAiB,CACf,uBAAuB,EACvB,GAAG,KAAK,CAAC,SAAS,QAAQ,KAAK,CAAC,GAAG,YAAY,UAAU,CAAC,OAAO,EAAE,EACnE,KAAK,CAAC,GAAG,CACV,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC;QACjC,CAAC;QAED,OAAO,CAAC,QAAQ,CAAC;YACf,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC,EACD,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,CAAC,CACzC,CAAC;AACJ,CAAC"}

package/dist/editor/ai/terminal/useAgentRunStartSocketHandler.d.ts

@@ -0,0 +1,25 @@
+import { type MutableRefObject, type SetStateAction } from "react";
+import type { AgentChatMessage, AgentDetails } from "../../services/agentService";
+import type { AgentSessionActions } from "./useAgentSession";
+type StateSetter<T> = (next: SetStateAction<T>) => void;
+export declare function useAgentRunStartSocketHandler(input: {
+    agent: AgentDetails | undefined;
+    isStoppingRef: MutableRefObject<boolean>;
+    currentRunIdRef: MutableRefObject<string | null>;
+    lastSettledRunIdRef: MutableRefObject<string | null>;
+    lastSeqRef: MutableRefObject<number>;
+    seenMessageIdsRef: MutableRefObject<Set<string>>;
+    lastResyncedMessageIdsRef: MutableRefObject<Set<string>>;
+    messagesRef: MutableRefObject<AgentChatMessage[]>;
+    shouldCreateNewMessageRef: MutableRefObject<boolean>;
+    isWaitingRef: MutableRefObject<boolean>;
+    actions: AgentSessionActions;
+    normalizeRunId: (value: unknown) => string | null;
+    noteMissingRunId: (source: string) => void;
+    setAgent: StateSetter<AgentDetails | undefined>;
+    setLastRunStatusReason: (reason: string | null) => void;
+    setIsConnecting: (isConnecting: boolean) => void;
+    setIsWaitingForResponse: (isWaitingForResponse: boolean) => void;
+    setIsAgentThinking: (isAgentThinking: boolean) => void;
+}): (messageType: string, payload: any) => boolean;
+export {};

package/dist/editor/ai/terminal/useAgentRunStartSocketHandler.js

@@ -0,0 +1,74 @@
+import { useCallback } from "react";
+export function useAgentRunStartSocketHandler(input) {
+    const { agent, isStoppingRef, currentRunIdRef, lastSettledRunIdRef, lastSeqRef, seenMessageIdsRef, lastResyncedMessageIdsRef, messagesRef, shouldCreateNewMessageRef, isWaitingRef, actions, normalizeRunId, noteMissingRunId, setAgent, setLastRunStatusReason, setIsConnecting, setIsWaitingForResponse, setIsAgentThinking, } = input;
+    return useCallback((messageType, payload) => {
+        if (messageType !== "agent:run:start") {
+            return false;
+        }
+        if (isStoppingRef.current) {
+            console.log("[AgentTerminal] Ignoring agent:run:start during stop operation");
+            return true;
+        }
+        const startRunId = normalizeRunId(payload?.runId);
+        if (startRunId === null) {
+            noteMissingRunId("agent:run:start");
+        }
+        if (startRunId !== null) {
+            if (lastSettledRunIdRef.current === startRunId) {
+                return true;
+            }
+            if (currentRunIdRef.current === startRunId) {
+                return true;
+            }
+            currentRunIdRef.current = startRunId;
+            lastSeqRef.current = 0;
+            seenMessageIdsRef.current.clear();
+            for (const message of messagesRef.current) {
+                if (message.id) {
+                    seenMessageIdsRef.current.add(message.id.toLowerCase());
+                }
+            }
+            lastResyncedMessageIdsRef.current.clear();
+        }
+        else {
+            lastSeqRef.current = 0;
+        }
+        actions.runStart({
+            runId: payload?.runId,
+        });
+        const currentStatus = agent?.status;
+        if (currentStatus === "waitingForInput" ||
+            currentStatus === "waitingForApproval" ||
+            currentStatus === "costLimitReached") {
+            return true;
+        }
+        setLastRunStatusReason(null);
+        setIsConnecting(true);
+        setIsWaitingForResponse(true);
+        isWaitingRef.current = true;
+        shouldCreateNewMessageRef.current = false;
+        setIsAgentThinking(true);
+        setAgent((prev) => (prev ? { ...prev, status: "running" } : prev));
+        return true;
+    }, [
+        actions,
+        agent,
+        currentRunIdRef,
+        isStoppingRef,
+        isWaitingRef,
+        lastResyncedMessageIdsRef,
+        lastSeqRef,
+        lastSettledRunIdRef,
+        messagesRef,
+        normalizeRunId,
+        noteMissingRunId,
+        seenMessageIdsRef,
+        setAgent,
+        setIsAgentThinking,
+        setIsConnecting,
+        setIsWaitingForResponse,
+        setLastRunStatusReason,
+        shouldCreateNewMessageRef,
+    ]);
+}
+//# sourceMappingURL=useAgentRunStartSocketHandler.js.map

package/dist/editor/ai/terminal/useAgentRunStartSocketHandler.js.map

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

package/dist/editor/ai/terminal/useAgentRunStatusSocketHandler.d.ts

@@ -0,0 +1,38 @@
+import { type MutableRefObject, type SetStateAction } from "react";
+import type { AgentDetails, AgentMetadata } from "../../services/agentService";
+import type { AgentSessionActions } from "./useAgentSession";
+type StateSetter<T> = (next: SetStateAction<T>) => void;
+export declare function useAgentRunStatusSocketHandler(input: {
+    agent: AgentDetails | undefined;
+    agentStubId: string;
+    actions: AgentSessionActions;
+    currentRunIdRef: MutableRefObject<string | null>;
+    isStoppingRef: MutableRefObject<boolean>;
+    isWaitingRef: MutableRefObject<boolean>;
+    messagesRef: MutableRefObject<any[]>;
+    shouldCreateNewMessageRef: MutableRefObject<boolean>;
+    lastNonHeartbeatUpdateAtRef: MutableRefObject<number>;
+    reconcileServerStateRef: MutableRefObject<(() => Promise<void>) | null>;
+    normalizeRunId: (value: unknown) => string | null;
+    noteMissingRunId: (source: string) => void;
+    appendToolUiEvent: (type: string, detail?: string | null, seq?: number | null) => void;
+    acceptRunSequenceFrame: (input: {
+        eventName: "agent:run:delta" | "agent:run:status";
+        runId: string | undefined;
+        seq: number | undefined;
+    }) => boolean;
+    clearStopGuard: () => void;
+    clearHeartbeatMessages: () => void;
+    clearPendingBrowserCaptureWait: () => void;
+    setPendingBrowserCaptureWait: (dialogType: string | null, callbackId: string | null) => void;
+    schedulePendingDialogReplay: (targetAgentId: string, callbackId: string, dialogType?: string | null) => void;
+    settleCompletedRun: (finalStatus?: "completed" | "cancelled", runId?: string | null) => void;
+    setAgent: StateSetter<AgentDetails | undefined>;
+    setAgentMetadata: StateSetter<AgentMetadata | null>;
+    setError: StateSetter<string | null>;
+    setLastRunStatusReason: (reason: string | null) => void;
+    setIsConnecting: (isConnecting: boolean) => void;
+    setIsWaitingForResponse: (isWaitingForResponse: boolean) => void;
+    setIsAgentThinking: (isAgentThinking: boolean) => void;
+}): (messageType: string, payload: any) => boolean;
+export {};