@parhelia/core 0.1.12785 → 0.1.12787

package/dist/editor/ai/terminal/agentSessionSnapshot.test.js

@@ -0,0 +1,136 @@
+import { describe, expect, it } from "vitest";
+import { buildLoadedContextWindowStatus, mergeLoadedAgentTranscript, parseLoadedAgentMetadata, } from "./agentSessionSnapshot";
+function createAgent(overrides = {}) {
+    return {
+        id: "agent-1",
+        name: "Agent",
+        userId: "user-1",
+        updatedDate: "2026-05-13T00:00:00.000Z",
+        createdDate: "2026-05-13T00:00:00.000Z",
+        status: "idle",
+        profileName: "Default",
+        model: "model-1",
+        totalTokensUsed: 0,
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        totalCachedInputTokens: 0,
+        totalInputTokenCost: 0,
+        totalOutputTokenCost: 0,
+        totalCachedInputTokenCost: 0,
+        totalImageCost: 0,
+        totalCost: 0,
+        currency: "USD",
+        messageCount: 0,
+        messages: [],
+        ...overrides,
+    };
+}
+function createMessage(id, overrides = {}) {
+    return {
+        id,
+        agentId: "agent-1",
+        messageIndex: 0,
+        role: "assistant",
+        content: "hello",
+        name: "assistant",
+        createdDate: "2026-05-13T00:00:00.000Z",
+        isCompleted: true,
+        messageType: "text",
+        model: "model-1",
+        tokensUsed: 0,
+        inputTokens: 0,
+        outputTokens: 0,
+        cachedInputTokens: 0,
+        inputTokenCost: 0,
+        outputTokenCost: 0,
+        cachedInputTokenCost: 0,
+        totalCost: 0,
+        currency: "USD",
+        ...overrides,
+    };
+}
+describe("agentSessionSnapshot", () => {
+    it("keeps incomplete local streaming messages while a loaded agent is running", () => {
+        const localStreaming = createMessage("local-stream", {
+            isCompleted: false,
+            messageType: "streaming",
+        });
+        const result = mergeLoadedAgentTranscript({
+            agentData: createAgent({
+                status: "running",
+                messages: [createMessage("server-message")],
+            }),
+            localMessages: [localStreaming],
+        });
+        expect(result.isRunning).toBe(true);
+        expect(result.hasStreaming).toBe(true);
+        expect(result.merged.map((message) => message.id)).toEqual([
+            "server-message",
+            "local-stream",
+        ]);
+    });
+    it("drops local streaming messages that are already present in the backend snapshot", () => {
+        const result = mergeLoadedAgentTranscript({
+            agentData: createAgent({
+                status: "running",
+                messages: [createMessage("same-id")],
+            }),
+            localMessages: [
+                createMessage("same-id", {
+                    isCompleted: false,
+                    messageType: "streaming",
+                }),
+            ],
+        });
+        expect(result.merged).toHaveLength(1);
+        expect(result.merged[0].id).toBe("same-id");
+        expect(result.merged[0].isCompleted).toBe(true);
+    });
+    it("drops local streaming messages once the loaded agent is idle", () => {
+        const result = mergeLoadedAgentTranscript({
+            agentData: createAgent({
+                status: "idle",
+                messages: [createMessage("server-message")],
+            }),
+            localMessages: [
+                createMessage("local-stream", {
+                    isCompleted: false,
+                    messageType: "streaming",
+                }),
+            ],
+        });
+        expect(result.isRunning).toBe(false);
+        expect(result.hasStreaming).toBe(false);
+        expect(result.merged.map((message) => message.id)).toEqual([
+            "server-message",
+        ]);
+    });
+    it("builds loaded context-window status from token totals", () => {
+        expect(buildLoadedContextWindowStatus(createAgent({
+            contextUsedTokens: 250,
+            contextWindowTokens: 1000,
+            model: "gpt-test",
+        }))).toEqual({
+            contextWindowTokens: 1000,
+            estimatedInputTokens: 250,
+            contextUsedPercent: 25,
+            model: "gpt-test",
+        });
+    });
+    it("parses metadata from a loaded agent context JSON payload", () => {
+        expect(parseLoadedAgentMetadata(createAgent({
+            agentContext: JSON.stringify({
+                currentItemId: "item-1",
+                additionalData: { source: "test" },
+            }),
+        }))).toEqual({
+            currentItemId: "item-1",
+            additionalData: { source: "test" },
+        });
+    });
+    it("returns null for missing or invalid loaded agent context metadata", () => {
+        expect(parseLoadedAgentMetadata(createAgent())).toBeNull();
+        expect(parseLoadedAgentMetadata(createAgent({ agentContext: "not-json" }))).toBeNull();
+    });
+});
+//# sourceMappingURL=agentSessionSnapshot.test.js.map

package/dist/editor/ai/terminal/agentSessionSnapshot.test.js.map

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

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

@@ -0,0 +1,130 @@
+import type { AgentChatMessage, AgentDetails, AgentMetadata, QueuedPrompt } from "../../services/agentService";
+import type { AgentStatus } from "../../services/agentStatus";
+import type { EditOperation } from "../../../types";
+import type { AgentSessionContextWindowState, AgentSessionCostLimitState, AgentSessionState } from "./types";
+export interface AgentSessionInitialInput {
+    agent?: AgentDetails;
+    isLoading?: boolean;
+}
+export interface AgentSessionSnapshot {
+    agent: AgentDetails;
+    queuedPrompts?: QueuedPrompt[];
+    operationHistory?: EditOperation[];
+    metadata?: AgentMetadata | null;
+    costLimitExceeded?: AgentSessionCostLimitState | null;
+    contextWindowStatus?: AgentSessionContextWindowState | null;
+    liveTotals?: AgentSessionState["liveTotals"];
+    epoch?: number;
+    force?: boolean;
+}
+export interface AgentSessionUserMessageEcho {
+    messageId: string;
+    agentId: string;
+    content: string;
+    timestamp?: string;
+    clientMessageId?: string;
+    sourceAgentName?: string;
+    sourceAgent?: {
+        name?: string;
+    };
+}
+export interface AgentSessionToolApprovalResolution {
+    messageId: string;
+    toolCallId: string;
+    approved: boolean;
+}
+export interface AgentSessionToolApprovalsRequired {
+    messageId: string;
+    toolCallIds: string[];
+}
+export interface AgentSessionAssistantContentChunk {
+    messageId: string;
+    deltaContent?: string | null;
+    reasoning?: string | null;
+    isIncremental?: boolean;
+    totalContentLength?: number;
+    createMessage: () => AgentChatMessage;
+}
+export interface AgentSessionToolCallUpsert {
+    targetIndex: number;
+    toolCall: NonNullable<AgentChatMessage["toolCalls"]>[number] & {
+        dbMessageId?: string;
+    };
+}
+export interface AgentSessionToolCallMessageUpsert {
+    messageId: string;
+    toolCall: AgentSessionToolCallUpsert["toolCall"];
+    createMessage: () => AgentChatMessage;
+}
+export interface AgentSessionToolResultApply {
+    targetIndex: number;
+    toolCallId: string;
+    fallbackToolCall: NonNullable<AgentChatMessage["toolCalls"]>[number];
+}
+export interface AgentSessionToolResultMessageApply {
+    messageId: string;
+    toolCallId: string;
+    fallbackToolCall: AgentSessionToolResultApply["fallbackToolCall"];
+}
+export declare function createInitialAgentSessionState(input?: AgentSessionInitialInput): AgentSessionState;
+export declare function normalizeSessionRunId(value: unknown): string | null;
+export declare function createOptimisticUserMessage(input: {
+    id: string;
+    agentId: string;
+    content: string;
+    createdDate?: string;
+}): AgentChatMessage;
+export declare function applyAssistantContentChunkToTranscript(transcript: AgentChatMessage[], chunk: AgentSessionAssistantContentChunk): AgentChatMessage[];
+export declare function applyHeartbeatMessageToTranscript(transcript: AgentChatMessage[], heartbeatMessage: AgentChatMessage): AgentChatMessage[];
+export declare function clearHeartbeatMessagesFromTranscript(transcript: AgentChatMessage[]): AgentChatMessage[];
+export declare function completeOpenAssistantMessagesInTranscript(transcript: AgentChatMessage[]): AgentChatMessage[];
+export declare function completeOpenStreamingMessagesInTranscript(transcript: AgentChatMessage[]): AgentChatMessage[];
+export declare function upsertToolCallInTranscript(transcript: AgentChatMessage[], input: AgentSessionToolCallUpsert): AgentChatMessage[];
+export declare function upsertToolCallForMessageInTranscript(transcript: AgentChatMessage[], input: AgentSessionToolCallMessageUpsert): AgentChatMessage[];
+export declare function applyToolResultToTranscript(transcript: AgentChatMessage[], input: AgentSessionToolResultApply): {
+    transcript: AgentChatMessage[];
+    allToolCallsCompleted: boolean;
+};
+export declare function applyToolResultForMessageInTranscript(transcript: AgentChatMessage[], input: AgentSessionToolResultMessageApply): {
+    transcript: AgentChatMessage[];
+    allToolCallsCompleted: boolean;
+};
+export declare function applyToolApprovalsRequiredToTranscript(transcript: AgentChatMessage[], input: AgentSessionToolApprovalsRequired): AgentChatMessage[];
+export declare function applyBackendSnapshot(state: AgentSessionState, snapshot: AgentSessionSnapshot): AgentSessionState;
+export declare function applySnapshotLoading(state: AgentSessionState): AgentSessionState;
+export declare function applySnapshotReady(state: AgentSessionState): AgentSessionState;
+export declare function applySnapshotError(state: AgentSessionState, error: string): AgentSessionState;
+export declare function addOptimisticUserMessage(state: AgentSessionState, message: AgentChatMessage): AgentSessionState;
+export declare function removeOptimisticUserMessage(state: AgentSessionState, messageId: string): AgentSessionState;
+export declare function replaceTranscript(state: AgentSessionState, transcript: AgentChatMessage[]): AgentSessionState;
+export declare function reconcileServerUserMessage(state: AgentSessionState, echo: AgentSessionUserMessageEcho): AgentSessionState;
+export declare function applyServerUserMessageToTranscript(transcript: AgentChatMessage[], echo: AgentSessionUserMessageEcho): AgentChatMessage[];
+export declare function applyRunStart(state: AgentSessionState, input?: {
+    runId?: unknown;
+    agentName?: string;
+    profileId?: string;
+    profileName?: string;
+}): AgentSessionState;
+export declare function shouldAcceptRunFrame(state: AgentSessionState, input: {
+    runId?: unknown;
+    seq?: unknown;
+}): boolean;
+export declare function acceptRunFrame(state: AgentSessionState, input: {
+    runId?: unknown;
+    seq?: unknown;
+}): AgentSessionState;
+export declare function applyRunStatus(state: AgentSessionState, status: AgentStatus, reason?: string | null): AgentSessionState;
+export declare function armStopGuard(state: AgentSessionState): AgentSessionState;
+export declare function clearStopGuard(state: AgentSessionState): AgentSessionState;
+export declare function settleCompletedRun(state: AgentSessionState, input?: {
+    finalStatus?: "completed" | "cancelled";
+    runId?: unknown;
+}): AgentSessionState;
+export declare function applyQueuedPromptAdded(state: AgentSessionState, queueEntry: QueuedPrompt): AgentSessionState;
+export declare function applyQueuedPromptProcessed(state: AgentSessionState, promptId: string): AgentSessionState;
+export declare function replaceQueuedPrompts(state: AgentSessionState, queuedPrompts: QueuedPrompt[]): AgentSessionState;
+export declare function applyOperationHistory(state: AgentSessionState, operations: EditOperation[], limit?: number): AgentSessionState;
+export declare function replaceOperationHistory(state: AgentSessionState, operationHistory: EditOperation[]): AgentSessionState;
+export declare function applyToolApprovalsRequired(state: AgentSessionState, input: AgentSessionToolApprovalsRequired): AgentSessionState;
+export declare function applyToolApprovalResolved(state: AgentSessionState, resolution: AgentSessionToolApprovalResolution): AgentSessionState;
+export declare function applyToolApprovalResolvedToTranscript(transcript: AgentChatMessage[], resolution: AgentSessionToolApprovalResolution): AgentChatMessage[];