import { describe, expect, it } from "vitest"; import type { agents } from "@paperclipai/db"; import { resolveDefaultAgentWorkspaceDir } from "../home-paths.js"; import { parseSessionCompactionPolicy, resolveRuntimeSessionParamsForWorkspace, shouldResetTaskSessionForWake, type ResolvedWorkspaceForRun, } from "../services/heartbeat.ts"; function buildResolvedWorkspace(overrides: Partial = {}): ResolvedWorkspaceForRun { return { cwd: "/tmp/project", source: "project_primary", projectId: "project-1", workspaceId: "workspace-1", repoUrl: null, repoRef: null, workspaceHints: [], warnings: [], ...overrides, }; } function buildAgent(adapterType: string, runtimeConfig: Record = {}) { return { id: "agent-1", companyId: "company-1", projectId: null, goalId: null, name: "Agent", role: "engineer", title: null, icon: null, status: "running", reportsTo: null, capabilities: null, adapterType, adapterConfig: {}, runtimeConfig, budgetMonthlyCents: 0, spentMonthlyCents: 0, permissions: {}, lastHeartbeatAt: null, metadata: null, createdAt: new Date(), updatedAt: new Date(), } as unknown as typeof agents.$inferSelect; } describe("resolveRuntimeSessionParamsForWorkspace", () => { it("migrates fallback workspace sessions to project workspace when project cwd becomes available", () => { const agentId = "agent-123"; const fallbackCwd = resolveDefaultAgentWorkspaceDir(agentId); const result = resolveRuntimeSessionParamsForWorkspace({ agentId, previousSessionParams: { sessionId: "session-1", cwd: fallbackCwd, workspaceId: "workspace-1", }, resolvedWorkspace: buildResolvedWorkspace({ cwd: "/tmp/new-project-cwd" }), }); expect(result.sessionParams).toMatchObject({ sessionId: "session-1", cwd: "/tmp/new-project-cwd", workspaceId: "workspace-1", }); expect(result.warning).toContain("Attempting to resume session"); }); it("does not migrate when previous session cwd is not the fallback workspace", () => { const result = resolveRuntimeSessionParamsForWorkspace({ agentId: "agent-123", previousSessionParams: { sessionId: "session-1", cwd: "/tmp/some-other-cwd", workspaceId: "workspace-1", }, resolvedWorkspace: buildResolvedWorkspace({ cwd: "/tmp/new-project-cwd" }), }); expect(result.sessionParams).toEqual({ sessionId: "session-1", cwd: "/tmp/some-other-cwd", workspaceId: "workspace-1", }); expect(result.warning).toBeNull(); }); it("does not migrate when resolved workspace id differs from previous session workspace id", () => { const agentId = "agent-123"; const fallbackCwd = resolveDefaultAgentWorkspaceDir(agentId); const result = resolveRuntimeSessionParamsForWorkspace({ agentId, previousSessionParams: { sessionId: "session-1", cwd: fallbackCwd, workspaceId: "workspace-1", }, resolvedWorkspace: buildResolvedWorkspace({ cwd: "/tmp/new-project-cwd", workspaceId: "workspace-2", }), }); expect(result.sessionParams).toEqual({ sessionId: "session-1", cwd: fallbackCwd, workspaceId: "workspace-1", }); expect(result.warning).toBeNull(); }); }); describe("shouldResetTaskSessionForWake", () => { it("resets session context on assignment wake", () => { expect(shouldResetTaskSessionForWake({ wakeReason: "issue_assigned" })).toBe(true); }); it("preserves session context on timer heartbeats", () => { expect(shouldResetTaskSessionForWake({ wakeSource: "timer" })).toBe(false); }); it("preserves session context on manual on-demand invokes by default", () => { expect( shouldResetTaskSessionForWake({ wakeSource: "on_demand", wakeTriggerDetail: "manual", }), ).toBe(false); }); it("resets session context when a fresh session is explicitly requested", () => { expect( shouldResetTaskSessionForWake({ wakeSource: "on_demand", wakeTriggerDetail: "manual", forceFreshSession: true, }), ).toBe(true); }); it("does not reset session context on mention wake comment", () => { expect( shouldResetTaskSessionForWake({ wakeReason: "issue_comment_mentioned", wakeCommentId: "comment-1", }), ).toBe(false); }); it("does not reset session context when commentId is present", () => { expect( shouldResetTaskSessionForWake({ wakeReason: "issue_commented", commentId: "comment-2", }), ).toBe(false); }); it("does not reset for comment wakes", () => { expect(shouldResetTaskSessionForWake({ wakeReason: "issue_commented" })).toBe(false); }); it("does not reset when wake reason is missing", () => { expect(shouldResetTaskSessionForWake({})).toBe(false); }); it("does not reset session context on callback on-demand invokes", () => { expect( shouldResetTaskSessionForWake({ wakeSource: "on_demand", wakeTriggerDetail: "callback", }), ).toBe(false); }); }); describe("parseSessionCompactionPolicy", () => { it("disables Paperclip-managed rotation by default for codex and claude local", () => { expect(parseSessionCompactionPolicy(buildAgent("codex_local"))).toEqual({ enabled: true, maxSessionRuns: 0, maxRawInputTokens: 0, maxSessionAgeHours: 0, }); expect(parseSessionCompactionPolicy(buildAgent("claude_local"))).toEqual({ enabled: true, maxSessionRuns: 0, maxRawInputTokens: 0, maxSessionAgeHours: 0, }); }); it("keeps conservative defaults for adapters without confirmed native compaction", () => { expect(parseSessionCompactionPolicy(buildAgent("cursor"))).toEqual({ enabled: true, maxSessionRuns: 200, maxRawInputTokens: 2_000_000, maxSessionAgeHours: 72, }); expect(parseSessionCompactionPolicy(buildAgent("opencode_local"))).toEqual({ enabled: true, maxSessionRuns: 200, maxRawInputTokens: 2_000_000, maxSessionAgeHours: 72, }); }); it("lets explicit agent overrides win over adapter defaults", () => { expect( parseSessionCompactionPolicy( buildAgent("codex_local", { heartbeat: { sessionCompaction: { maxSessionRuns: 25, maxRawInputTokens: 500_000, }, }, }), ), ).toEqual({ enabled: true, maxSessionRuns: 25, maxRawInputTokens: 500_000, maxSessionAgeHours: 0, }); }); });