First Release of Claw3D (#11)

Co-authored-by: iamlukethedev <iamlukethedev@users.noreply.github.com>
2026-03-19 23:14:04 -05:00
parent 5ea96b2650
commit 4fa4f13558
431 changed files with 105438 additions and 14 deletions
@@ -0,0 +1,238 @@
+import { describe, expect, it } from "vitest";
+
+import {
+  buildHistoryMetadataPatch,
+  resolveHistoryRequestIntent,
+  resolveHistoryResponseDisposition,
+} from "@/features/agents/operations/historyLifecycleWorkflow";
+import type { AgentState } from "@/features/agents/state/store";
+
+const createAgent = (overrides?: Partial<AgentState>): AgentState => {
+  const base: AgentState = {
+    agentId: "agent-1",
+    name: "Agent One",
+    sessionKey: "agent:agent-1:main",
+    status: "idle",
+    sessionCreated: true,
+    awaitingUserInput: false,
+    hasUnseenActivity: false,
+    outputLines: [],
+    lastResult: null,
+    lastDiff: null,
+    runId: null,
+    runStartedAt: null,
+    streamText: null,
+    thinkingTrace: null,
+    latestOverride: null,
+    latestOverrideKind: null,
+    lastAssistantMessageAt: null,
+    lastActivityAt: null,
+    latestPreview: null,
+    lastUserMessage: null,
+    draft: "",
+    sessionSettingsSynced: true,
+    historyLoadedAt: null,
+    historyFetchLimit: null,
+    historyFetchedCount: null,
+    historyMaybeTruncated: false,
+    toolCallingEnabled: true,
+    showThinkingTraces: true,
+    model: "openai/gpt-5",
+    thinkingLevel: "medium",
+    avatarSeed: "seed-1",
+    avatarUrl: null,
+  };
+  return { ...base, ...(overrides ?? {}) };
+};
+
+describe("historyLifecycleWorkflow", () => {
+  it("returns skip intent when session is missing or not created", () => {
+    expect(
+      resolveHistoryRequestIntent({
+        agent: null,
+        defaultLimit: 200,
+        maxLimit: 5000,
+        inFlightSessionKeys: new Set<string>(),
+        requestId: "req-1",
+        loadedAt: 1000,
+      })
+    ).toEqual({ kind: "skip", reason: "missing-agent" });
+
+    expect(
+      resolveHistoryRequestIntent({
+        agent: createAgent({ sessionCreated: false }),
+        defaultLimit: 200,
+        maxLimit: 5000,
+        inFlightSessionKeys: new Set<string>(),
+        requestId: "req-1",
+        loadedAt: 1000,
+      })
+    ).toEqual({ kind: "skip", reason: "session-not-created" });
+
+    expect(
+      resolveHistoryRequestIntent({
+        agent: createAgent({ sessionKey: "   " }),
+        defaultLimit: 200,
+        maxLimit: 5000,
+        inFlightSessionKeys: new Set<string>(),
+        requestId: "req-1",
+        loadedAt: 1000,
+      })
+    ).toEqual({ kind: "skip", reason: "missing-session-key" });
+  });
+
+  it("plans history request with bounded limit and request identifiers", () => {
+    expect(
+      resolveHistoryRequestIntent({
+        agent: createAgent({ transcriptRevision: 14, outputLines: ["one", "two"] }),
+        requestedLimit: 9000,
+        defaultLimit: 200,
+        maxLimit: 5000,
+        inFlightSessionKeys: new Set<string>(),
+        requestId: "req-42",
+        loadedAt: 777,
+      })
+    ).toEqual({
+      kind: "fetch",
+      sessionKey: "agent:agent-1:main",
+      limit: 5000,
+      requestRevision: 14,
+      requestEpoch: 0,
+      requestId: "req-42",
+      loadedAt: 777,
+    });
+
+    expect(
+      resolveHistoryRequestIntent({
+        agent: createAgent(),
+        defaultLimit: 200,
+        maxLimit: 5000,
+        inFlightSessionKeys: new Set<string>(),
+        requestId: "req-2",
+        loadedAt: 2000,
+      })
+    ).toEqual({
+      kind: "fetch",
+      sessionKey: "agent:agent-1:main",
+      limit: 200,
+      requestRevision: 0,
+      requestEpoch: 0,
+      requestId: "req-2",
+      loadedAt: 2000,
+    });
+  });
+
+  it("drops stale responses when session key, epoch, or revision changed", () => {
+    expect(
+      resolveHistoryResponseDisposition({
+        latestAgent: createAgent({ sessionKey: "agent:agent-1:other" }),
+        expectedSessionKey: "agent:agent-1:main",
+        requestEpoch: 0,
+        requestRevision: 0,
+      })
+    ).toEqual({
+      kind: "drop",
+      reason: "session-key-changed",
+    });
+
+    expect(
+      resolveHistoryResponseDisposition({
+        latestAgent: createAgent({ sessionEpoch: 4 }),
+        expectedSessionKey: "agent:agent-1:main",
+        requestEpoch: 3,
+        requestRevision: 0,
+      })
+    ).toEqual({
+      kind: "drop",
+      reason: "session-epoch-changed",
+    });
+
+    expect(
+      resolveHistoryResponseDisposition({
+        latestAgent: createAgent({ transcriptRevision: 12 }),
+        expectedSessionKey: "agent:agent-1:main",
+        requestEpoch: 0,
+        requestRevision: 11,
+      })
+    ).toEqual({
+      kind: "drop",
+      reason: "transcript-revision-changed",
+    });
+
+    expect(
+      resolveHistoryResponseDisposition({
+        latestAgent: createAgent({ outputLines: ["one", "two"] }),
+        expectedSessionKey: "agent:agent-1:main",
+        requestEpoch: 0,
+        requestRevision: 1,
+      })
+    ).toEqual({
+      kind: "drop",
+      reason: "transcript-revision-changed",
+    });
+  });
+
+  it("applies history even while run is still active", () => {
+    expect(
+      resolveHistoryResponseDisposition({
+        latestAgent: createAgent({
+          status: "running",
+          runId: "run-1",
+          transcriptRevision: 9,
+        }),
+        expectedSessionKey: "agent:agent-1:main",
+        requestEpoch: 0,
+        requestRevision: 9,
+      })
+    ).toEqual({
+      kind: "apply",
+    });
+
+    expect(
+      resolveHistoryResponseDisposition({
+        latestAgent: createAgent({
+          status: "idle",
+          runId: null,
+          transcriptRevision: 9,
+        }),
+        expectedSessionKey: "agent:agent-1:main",
+        requestEpoch: 0,
+        requestRevision: 9,
+      })
+    ).toEqual({
+      kind: "apply",
+    });
+
+    expect(
+      resolveHistoryResponseDisposition({
+        latestAgent: createAgent({
+          status: "idle",
+          runId: null,
+          outputLines: ["> q1", "a1"],
+        }),
+        expectedSessionKey: "agent:agent-1:main",
+        requestEpoch: 0,
+        requestRevision: 2,
+      })
+    ).toEqual({
+      kind: "apply",
+    });
+  });
+
+  it("builds metadata patch with truncation semantics", () => {
+    expect(
+      buildHistoryMetadataPatch({
+        loadedAt: 123,
+        fetchedCount: 8,
+        limit: 8,
+        requestId: "req-77",
+      })
+    ).toEqual({
+      historyLoadedAt: 123,
+      historyFetchLimit: 8,
+      historyFetchedCount: 8,
+      historyMaybeTruncated: true,
+      lastAppliedHistoryRequestId: "req-77",
+    });
+  });
+});