The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
Keep warm sessions across project revision transitions (#17461)
Nicky Leach60ca3a903aa7
diff --git a/doc/DEVELOPING.md b/doc/DEVELOPING.mdindex a8c500a438..0e44d7feb8 100644--- a/doc/DEVELOPING.md+++ b/doc/DEVELOPING.md@@ -1776,6 +1776,11 @@ preparation. Both phases keep their original ordering in `heartbeat.ts`; theyacquire no runtime resources. Public-path characterization tests live in`server/src/__tests__/heartbeat-session-preparation.test.ts`.+Session compatibility uses effective workspace policy and settings. Generic issue+and project row timestamps do not reset a session. This includes the first+project-owned directory binding. Changes to effective execution configuration+still require a fresh session.+Run-log formatting is in `server/src/services/heartbeat/run-log.ts`. It boundsstored event payloads, redacts and shortens log chunks, and caps stdout/stderrexcerpts. `run-output.ts` owns per-attempt log handles, current-user redaction,diff --git a/server/src/__tests__/heartbeat-workspace-session.test.ts b/server/src/__tests__/heartbeat-workspace-session.test.tsindex 5df8621bbb..154a7ff060 100644--- a/server/src/__tests__/heartbeat-workspace-session.test.ts+++ b/server/src/__tests__/heartbeat-workspace-session.test.ts@@ -2427,6 +2427,57 @@ describe("effective run session config freshness", () => {});});+ it.each([null, "2026-06-01T00:00:00.000Z"])("does not reset for project row timestamps (%s) but still resets for project policy", async (revision) => {+ const base = await buildSessionConfigMetadata({+ workspaceConfig: {+ requestedMode: "agent_default",+ effectiveMode: "agent_default",+ projectConfigRevisionAt: revision,+ projectPolicy: null,+ },+ });+ const projectTouched = await buildSessionConfigMetadata({+ workspaceConfig: {+ requestedMode: "agent_default",+ effectiveMode: "agent_default",+ projectConfigRevisionAt: "2026-06-01T00:05:00.000Z",+ projectPolicy: null,+ },+ });+ const policyChanged = await buildSessionConfigMetadata({+ workspaceConfig: {+ requestedMode: "agent_default",+ effectiveMode: "agent_default",+ projectConfigRevisionAt: "2026-06-01T00:05:00.000Z",+ projectPolicy: { enabled: true, defaultMode: "isolated_workspace" },+ },+ });++ expect(+ resolveTaskSessionConfigFreshness({+ hasTaskSession: true,+ configuredModel: "gpt-5.4-mini",+ taskSessionParams: sessionParamsWithConfigMetadata(base),+ configMetadata: projectTouched,+ }),+ ).toMatchObject({+ reset: false,+ changedCategories: [],+ reasons: [],+ });+ expect(+ resolveTaskSessionConfigFreshness({+ hasTaskSession: true,+ configuredModel: "gpt-5.4-mini",+ taskSessionParams: sessionParamsWithConfigMetadata(base),+ configMetadata: policyChanged,+ }),+ ).toMatchObject({+ reset: true,+ changedCategories: ["workspaceConfig"],+ });+ });+it("does not reset when a reusable execution workspace becomes realized", async () => {const base = await buildSessionConfigMetadata({workspaceConfig: {diff --git a/server/src/services/heartbeat/workspaces.ts b/server/src/services/heartbeat/workspaces.tsindex c607e2426e..6b036657a8 100644--- a/server/src/services/heartbeat/workspaces.ts+++ b/server/src/services/heartbeat/workspaces.ts@@ -2800,6 +2800,7 @@ function buildSessionConfigCategoryValues(input: {// the timestamp here makes every comment invalidate an otherwise reusable// task session.delete workspaceConfig.issueConfigRevisionAt;+ delete workspaceConfig.projectConfigRevisionAt;// This row is runtime state, not requested configuration. It is absent// before the first reusable run is realized and present on the next turn;// fingerprinting that transition would rotate the native session exactly