@parhelia/core 0.1.12907 → 0.1.12909

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

@@ -0,0 +1,360 @@
+import { useCallback } from "react";
+import { parseAgentRunStatusData } from "../../services/agentStatus";
+import { toUserFacingAgentErrorMessage } from "../../services/agentErrorMessage";
+import { MACHINE_CAPACITY_REASON } from "../agentMessageHelpers";
+import { applyToolApprovalsRequiredToTranscript, completeOpenStreamingMessagesInTranscript, } from "./agentSessionState";
+import { hasNonZeroLiveTotals, liveTotalsFromStatusTotals, parseContextBreakdown, } from "./agentSessionLiveTotals";
+import { markStaleRunningLoadSuppressed } from "./useAgentSessionSync";
+import { isBrowserCaptureDialogType } from "../dialogs/agentDialogTypes";
+export function useAgentRunStatusSocketHandler(input) {
+    const { agent, agentStubId, actions, currentRunIdRef, isStoppingRef, isWaitingRef, messagesRef, shouldCreateNewMessageRef, lastNonHeartbeatUpdateAtRef, reconcileServerStateRef, normalizeRunId, noteMissingRunId, appendToolUiEvent, acceptRunSequenceFrame, clearStopGuard, clearHeartbeatMessages, schedulePendingDialogReplay, settleCompletedRun, setAgent, setAgentMetadata, setError, setLastRunStatusReason, setIsConnecting, setIsWaitingForResponse, setIsAgentThinking, } = input;
+    return useCallback((messageType, payload) => {
+        if (messageType !== "agent:run:status") {
+            return false;
+        }
+        const agentId = payload?.agentId;
+        // Drop stale-run status — see matching block in agent:run:delta handler.
+        const statusRunId = normalizeRunId(payload?.runId);
+        if (statusRunId === null) {
+            noteMissingRunId("agent:run:status");
+        }
+        else if (currentRunIdRef.current !== null &&
+            statusRunId !== currentRunIdRef.current) {
+            appendToolUiEvent("ui:stream-runid-dropped", `agent:run:status runId=${statusRunId} currentRunId=${currentRunIdRef.current}`);
+            return true;
+        }
+        const { seq, data: statusData } = payload;
+        if (!acceptRunSequenceFrame({
+            eventName: "agent:run:status",
+            runId: payload?.runId,
+            seq,
+        })) {
+            return true;
+        }
+        // Status events never carry a "Heartbeat" payload — heartbeats are deltas. Any
+        // status update is meaningful progress for the watchdog.
+        lastNonHeartbeatUpdateAtRef.current = Date.now();
+        // Route based on statusData.state
+        try {
+            // Normalize various status shapes and handle Cancelled uniformly
+            const normalizedStatus = parseAgentRunStatusData(statusData);
+            const statusReason = typeof statusData?.reason === "string"
+                ? statusData.reason.trim() || null
+                : null;
+            const statusMessage = typeof statusData?.message === "string"
+                ? statusData.message.trim() || null
+                : null;
+            if (normalizedStatus === "idle") {
+                const wasStopping = isStoppingRef.current;
+                if (wasStopping) {
+                    markStaleRunningLoadSuppressed(agentStubId);
+                }
+                clearStopGuard();
+                actions.clearStopGuard();
+                actions.runStatus("idle", statusReason);
+                setError(null);
+                // Stop indicators and mark any in-progress streaming messages as completed
+                clearHeartbeatMessages();
+                setAgent((prev) => (prev ? { ...prev, status: "idle" } : prev));
+                isWaitingRef.current = false;
+                shouldCreateNewMessageRef.current = false;
+                actions.patchRunState({
+                    isAgentThinking: false,
+                    isConnecting: false,
+                    isSubmitting: false,
+                    isWaitingForResponse: false,
+                    lastStatusReason: null,
+                });
+                messagesRef.current = completeOpenStreamingMessagesInTranscript(messagesRef.current);
+                actions.completeOpenStreamingMessages();
+                if (wasStopping) {
+                    return true;
+                }
+                void reconcileServerStateRef.current?.();
+                return true;
+            }
+            if (statusData?.state === "streamOpen") {
+                setIsConnecting(false);
+                return true;
+            }
+            if (statusData?.state === "tokenUsage") {
+                const totals = statusData?.totals;
+                if (totals) {
+                    const totalCost = Number(totals.totalCost) || 0;
+                    const statusCostLimit = (() => {
+                        try {
+                            const v = statusData?.costLimit;
+                            const n = v != null ? Number(v) : undefined;
+                            return Number.isFinite(n) && n > 0
+                                ? n
+                                : undefined;
+                        }
+                        catch {
+                            return undefined;
+                        }
+                    })();
+                    const nextTotals = liveTotalsFromStatusTotals(totals);
+                    if (nextTotals && hasNonZeroLiveTotals(nextTotals)) {
+                        actions.replaceLiveTotals(nextTotals);
+                    }
+                    // Fallback context usage update for providers that do not include
+                    // context usage in every stream delta (for example some OpenAI streams).
+                    // Prefer explicit status values when present; otherwise derive from totals.
+                    const contextWindowValue = Number(statusData?.contextWindow ??
+                        agent?.contextWindowTokens ??
+                        0);
+                    const contextUsedValue = Number(statusData?.contextUsed ??
+                        (Number(totals.totalInputTokens) || 0) +
+                            (Number(totals.totalCachedInputTokens) || 0) +
+                            (Number(totals.totalCacheWriteTokens) || 0));
+                    if (contextWindowValue > 0 &&
+                        Number.isFinite(contextUsedValue) &&
+                        contextUsedValue >= 0) {
+                        actions.replaceContextWindowStatus({
+                            contextWindowTokens: contextWindowValue,
+                            estimatedInputTokens: contextUsedValue,
+                            contextUsedPercent: (contextUsedValue / contextWindowValue) * 100,
+                            model: agent?.model || "",
+                            breakdown: parseContextBreakdown(statusData?.contextBreakdown ??
+                                agent?.contextBreakdown),
+                        });
+                    }
+                    // If server provides costLimit along with totals, persist it locally
+                    if (statusCostLimit) {
+                        setAgent((prev) => prev && (!prev.costLimit || prev.costLimit !== statusCostLimit)
+                            ? { ...prev, costLimit: statusCostLimit }
+                            : prev);
+                    }
+                    if (agent?.costLimit && totalCost > agent.costLimit) {
+                        actions.replaceCostLimitExceeded({
+                            totalCost: totalCost,
+                            costLimit: agent.costLimit,
+                            initialCostLimit: agent.costLimit,
+                        });
+                        setIsWaitingForResponse(false);
+                        shouldCreateNewMessageRef.current = false;
+                    }
+                }
+                return true;
+            }
+            if (statusData?.state === "ToolApprovalsRequired" ||
+                statusData?.state === "toolApprovalsRequired") {
+                setLastRunStatusReason(null);
+                const msgId = statusData.messageId;
+                const ids = statusData.toolCallIds || [];
+                if (msgId && Array.isArray(ids) && ids.length > 0) {
+                    messagesRef.current = applyToolApprovalsRequiredToTranscript(messagesRef.current, {
+                        messageId: msgId,
+                        toolCallIds: ids,
+                    });
+                    actions.toolApprovalsRequired({
+                        messageId: msgId,
+                        toolCallIds: ids,
+                    });
+                }
+                else {
+                    actions.runStatus("waitingForApproval");
+                }
+                // Update agent status to waiting for approval
+                setAgent((prev) => prev ? { ...prev, status: "waitingForApproval" } : prev);
+                setIsConnecting(false);
+                setIsWaitingForResponse(false);
+                return true;
+            }
+            // Handle waiting states explicitly
+            if (normalizedStatus === "waitingForApproval") {
+                clearStopGuard();
+                actions.clearStopGuard();
+                actions.runStatus("waitingForApproval", statusReason);
+                setLastRunStatusReason(null);
+                setError(null);
+                setAgent((prev) => prev ? { ...prev, status: "waitingForApproval" } : prev);
+                setIsConnecting(false);
+                setIsWaitingForResponse(false);
+                setIsAgentThinking(false);
+                void reconcileServerStateRef.current?.();
+                return true;
+            }
+            if (normalizedStatus === "waitingForInput") {
+                clearStopGuard();
+                actions.clearStopGuard();
+                actions.runStatus("waitingForInput", statusReason);
+                setLastRunStatusReason(null);
+                setError(null);
+                const dialogType = typeof statusData?.dialogType === "string"
+                    ? statusData.dialogType
+                    : null;
+                const callbackId = typeof statusData?.callbackId === "string" &&
+                    statusData.callbackId.trim()
+                    ? statusData.callbackId.trim()
+                    : null;
+                const isBrowserCaptureWait = isBrowserCaptureDialogType(dialogType);
+                // Captures are delivered/redelivered by the backend's background-capture routing, not the
+                // questionnaire dialog-replay mechanism.
+                if (callbackId && !isBrowserCaptureWait) {
+                    schedulePendingDialogReplay(agentId, callbackId, dialogType);
+                }
+                setAgent((prev) => prev
+                    ? {
+                        ...prev,
+                        status: "waitingForInput",
+                        statusMessage: isBrowserCaptureWait &&
+                            typeof statusData?.title === "string" &&
+                            statusData.title.trim()
+                            ? statusData.title.trim()
+                            : prev.statusMessage,
+                    }
+                    : prev);
+                setIsConnecting(false);
+                setIsWaitingForResponse(false);
+                setIsAgentThinking(false);
+                return true;
+            }
+            if (normalizedStatus === "costLimitReached") {
+                clearStopGuard();
+                actions.clearStopGuard();
+                actions.runStatus("costLimitReached", statusReason);
+                setError(null);
+                const totalCost = Number(statusData.totalCost) || 0;
+                const costLimit = Number(statusData.costLimit) || agent?.costLimit || 0;
+                actions.replaceCostLimitExceeded({
+                    totalCost: totalCost,
+                    costLimit: costLimit,
+                    initialCostLimit: costLimit,
+                });
+                // Update agent status to cost limit reached
+                setAgent((prev) => prev ? { ...prev, status: "costLimitReached" } : prev);
+                setIsWaitingForResponse(false);
+                setIsConnecting(false);
+                return true;
+            }
+            if (statusData?.state === "contextChanged") {
+                // Server sends additionalData directly (with todoList inside)
+                // Also may include ChildAgents for spawned agents
+                try {
+                    const serverAdditionalData = statusData.additionalData || {};
+                    setAgentMetadata((prev) => {
+                        const current = (prev || {});
+                        const updated = { ...current };
+                        // Merge additionalData (deep merge to preserve existing values)
+                        if (serverAdditionalData &&
+                            Object.keys(serverAdditionalData).length > 0) {
+                            updated.additionalData = {
+                                ...(current.additionalData || {}),
+                                ...serverAdditionalData,
+                            };
+                        }
+                        // Merge ChildAgents if present (for spawned agents) - replace entire array
+                        // Backend sends the complete updated list, not just additions
+                        if (statusData.childAgents) {
+                            const childAgents = statusData.childAgents;
+                            if (Array.isArray(childAgents)) {
+                                updated.childAgents = childAgents;
+                            }
+                        }
+                        return updated;
+                    });
+                }
+                catch (err) {
+                    console.error("[AgentTerminal] Error handling contextChanged:", err);
+                }
+                return true;
+            }
+            // Handle "completed" state (fallback for legacy code paths that send status instead of lifecycle event)
+            if (normalizedStatus === "completed") {
+                // Pass through the runId from the status payload so the
+                // run-scoped idempotency guard in settleCompletedRun can drop
+                // duplicates of agent:run:complete that already settled this run.
+                settleCompletedRun("completed", payload?.runId);
+                actions.settleRun({
+                    finalStatus: "completed",
+                    runId: payload?.runId,
+                });
+                return true;
+            }
+            // Handle "Running" state - agent is actively processing
+            if (normalizedStatus === "running") {
+                if (isStoppingRef.current) {
+                    return true;
+                }
+                if (statusReason === MACHINE_CAPACITY_REASON) {
+                    clearHeartbeatMessages();
+                    setLastRunStatusReason(statusReason);
+                    setAgent((prev) => prev
+                        ? {
+                            ...prev,
+                            status: "running",
+                            statusMessage: statusMessage ||
+                                "Waiting for capacity. The agent will start automatically when a slot becomes available.",
+                        }
+                        : prev);
+                    setIsWaitingForResponse(false);
+                    isWaitingRef.current = false;
+                    setIsConnecting(false);
+                    setIsAgentThinking(false);
+                    return true;
+                }
+                setLastRunStatusReason(null);
+                setError(null);
+                actions.runStatus("running", statusReason);
+                // Update agent status to running and clear any previous error statusMessage
+                setAgent((prev) => prev
+                    ? { ...prev, status: "running", statusMessage: undefined }
+                    : prev);
+                setIsWaitingForResponse(true);
+                isWaitingRef.current = true;
+                setIsAgentThinking(true);
+                return true;
+            }
+            // Handle "Error" state
+            if (normalizedStatus === "error") {
+                clearStopGuard();
+                actions.clearStopGuard();
+                actions.runStatus("error", statusReason);
+                setLastRunStatusReason(null);
+                const errorMsg = toUserFacingAgentErrorMessage(statusData?.statusMessage ??
+                    statusData?.message ??
+                    statusData?.error) || "Unknown error";
+                clearHeartbeatMessages();
+                setError(errorMsg);
+                setAgent((prev) => prev ? { ...prev, status: "error", statusMessage: errorMsg } : prev);
+                setIsWaitingForResponse(false);
+                isWaitingRef.current = false;
+                setIsConnecting(false);
+                setIsAgentThinking(false);
+                return true;
+            }
+        }
+        catch (err) {
+            console.error("[AgentTerminal] Error handling status update:", err);
+        }
+        return true;
+    }, [
+        acceptRunSequenceFrame,
+        actions,
+        agent,
+        agentStubId,
+        appendToolUiEvent,
+        clearHeartbeatMessages,
+        clearStopGuard,
+        currentRunIdRef,
+        isStoppingRef,
+        isWaitingRef,
+        lastNonHeartbeatUpdateAtRef,
+        messagesRef,
+        normalizeRunId,
+        noteMissingRunId,
+        reconcileServerStateRef,
+        schedulePendingDialogReplay,
+        setAgent,
+        setAgentMetadata,
+        setError,
+        setIsAgentThinking,
+        setIsConnecting,
+        setIsWaitingForResponse,
+        setLastRunStatusReason,
+        settleCompletedRun,
+        shouldCreateNewMessageRef,
+    ]);
+}
+//# sourceMappingURL=useAgentRunStatusSocketHandler.js.map

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

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

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

@@ -0,0 +1,11 @@
+import { useAgentStatusBarContent } from "./useAgentStatusBarContent";
+import { useAgentStreamWatchdog } from "./useAgentStreamWatchdog";
+type StatusBarInput = Parameters<typeof useAgentStatusBarContent>[0];
+type WatchdogInput = Parameters<typeof useAgentStreamWatchdog>[0];
+export declare function useAgentRuntimeStatus(input: {
+    statusBar: StatusBarInput;
+    watchdog: WatchdogInput;
+}): {
+    statusBarContent: import("react/jsx-runtime").JSX.Element | null;
+};
+export {};

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

@@ -0,0 +1,9 @@
+import { useAgentStatusBarContent } from "./useAgentStatusBarContent";
+import { useAgentStreamWatchdog } from "./useAgentStreamWatchdog";
+export function useAgentRuntimeStatus(input) {
+    const { statusBar, watchdog } = input;
+    const statusBarContent = useAgentStatusBarContent(statusBar);
+    useAgentStreamWatchdog(watchdog);
+    return { statusBarContent };
+}
+//# sourceMappingURL=useAgentRuntimeStatus.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentRuntimeStatus.js","sourceRoot":"","sources":["../../../../src/editor/ai/terminal/useAgentRuntimeStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAKlE,MAAM,UAAU,qBAAqB,CAAC,KAGrC;IACC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACtC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAC7D,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,5 @@
+export declare function useAgentServerReconciler(input: {
+    loadAgent: (options: {
+        silent?: boolean;
+    }) => Promise<void>;
+}): import("react").RefObject<(() => Promise<void>) | null>;

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

@@ -0,0 +1,22 @@
+import { useEffect, useRef } from "react";
+export function useAgentServerReconciler(input) {
+    const { loadAgent } = input;
+    const reconcileServerStateInFlightRef = useRef(false);
+    const reconcileServerStateRef = useRef(null);
+    useEffect(() => {
+        reconcileServerStateRef.current = async () => {
+            if (reconcileServerStateInFlightRef.current) {
+                return;
+            }
+            reconcileServerStateInFlightRef.current = true;
+            try {
+                await loadAgent({ silent: true });
+            }
+            finally {
+                reconcileServerStateInFlightRef.current = false;
+            }
+        };
+    }, [loadAgent]);
+    return reconcileServerStateRef;
+}
+//# sourceMappingURL=useAgentServerReconciler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentServerReconciler.js","sourceRoot":"","sources":["../../../../src/editor/ai/terminal/useAgentServerReconciler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,MAAM,UAAU,wBAAwB,CAAC,KAExC;IACC,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAC5B,MAAM,+BAA+B,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,uBAAuB,GAAG,MAAM,CAA+B,IAAI,CAAC,CAAC;IAE3E,SAAS,CAAC,GAAG,EAAE;QACb,uBAAuB,CAAC,OAAO,GAAG,KAAK,IAAI,EAAE;YAC3C,IAAI,+BAA+B,CAAC,OAAO,EAAE,CAAC;gBAC5C,OAAO;YACT,CAAC;YAED,+BAA+B,CAAC,OAAO,GAAG,IAAI,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACpC,CAAC;oBAAS,CAAC;gBACT,+BAA+B,CAAC,OAAO,GAAG,KAAK,CAAC;YAClD,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,OAAO,uBAAuB,CAAC;AACjC,CAAC"}

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

@@ -0,0 +1,50 @@
+import type { Agent, AgentChatMessage, AgentDetails, QueuedPrompt } from "../../services/agentService";
+import type { EditOperation } from "../../../types";
+import { acceptRunFrame, applyRunStart, applyRunStatus, settleCompletedRun, type AgentSessionToolApprovalResolution, type AgentSessionToolApprovalsRequired, type AgentSessionToolCallMessageUpsert, type AgentSessionToolResultMessageApply, type AgentSessionSnapshot, type AgentSessionAssistantContentChunk, type AgentSessionUserMessageEcho } from "./agentSessionState";
+import type { AgentSessionCommands, AgentSessionState } from "./types";
+export interface AgentSessionActions {
+    startLoading: () => void;
+    finishReady: () => void;
+    applySnapshot: (snapshot: AgentSessionSnapshot) => void;
+    applyError: (error: string) => void;
+    replaceError: (error: string | null) => void;
+    replaceAgent: (agent: AgentDetails | undefined) => void;
+    replaceMetadata: (metadata: AgentSessionState["metadata"]) => void;
+    replaceCostLimitExceeded: (costLimitExceeded: AgentSessionState["costLimitExceeded"]) => void;
+    replaceContextWindowStatus: (contextWindowStatus: AgentSessionState["contextWindowStatus"]) => void;
+    replaceLiveTotals: (liveTotals: AgentSessionState["liveTotals"]) => void;
+    setActiveInlineDialog: (activeInlineDialog: AgentSessionState["activeInlineDialog"]) => void;
+    patchRunState: (run: Partial<AgentSessionState["run"]>) => void;
+    replaceQueuedPrompts: (queuedPrompts: QueuedPrompt[]) => void;
+    addQueuedPrompt: (queuedPrompt: QueuedPrompt) => void;
+    processQueuedPrompt: (promptId: string) => void;
+    mergeOperationHistory: (operations: EditOperation[]) => void;
+    replaceOperationHistory: (operations: EditOperation[]) => void;
+    addOptimisticUserMessage: (message: AgentChatMessage) => void;
+    removeOptimisticUserMessage: (messageId: string) => void;
+    replaceTranscript: (transcript: AgentChatMessage[]) => void;
+    assistantContentChunk: (chunk: AgentSessionAssistantContentChunk) => void;
+    heartbeatMessage: (message: AgentChatMessage) => void;
+    clearHeartbeatMessages: () => void;
+    completeOpenAssistantMessages: () => void;
+    completeOpenStreamingMessages: () => void;
+    toolCall: (input: AgentSessionToolCallMessageUpsert) => void;
+    toolResult: (input: AgentSessionToolResultMessageApply) => void;
+    reconcileServerUserMessage: (echo: AgentSessionUserMessageEcho) => void;
+    runStart: (input: Parameters<typeof applyRunStart>[1]) => void;
+    runFrame: (input: Parameters<typeof acceptRunFrame>[1]) => void;
+    runStatus: (status: Parameters<typeof applyRunStatus>[1], reason?: string | null) => void;
+    armStopGuard: () => void;
+    clearStopGuard: () => void;
+    settleRun: (input: Parameters<typeof settleCompletedRun>[1]) => void;
+    toolApprovalsRequired: (input: AgentSessionToolApprovalsRequired) => void;
+    toolApprovalResolved: (resolution: AgentSessionToolApprovalResolution) => void;
+}
+export declare function useAgentSession(input: {
+    agentStub: Agent;
+}): {
+    state: AgentSessionState;
+    commands: AgentSessionCommands;
+    bindCommands: (commands: Partial<AgentSessionCommands>) => void;
+    actions: AgentSessionActions;
+};