@roll-agent/runtime 0.25.2 → 0.26.0

package/dist/engine/compaction-checkpoint.d.ts

@@ -1,8 +1,11 @@
 import { type ModelMessage } from "ai";
 import { z } from "zod";
 import type { ToolExecutionRecord } from "../tool-bridge/tool-execution-record.ts";
-import { createCompactionSemanticReminderProjection, type CompactionSemanticState } from "./compaction-semantic-state.ts";
+import { type CompactionSemanticState } from "./compaction-semantic-state.ts";
+export { MAX_TASK_SUMMARY_CHARS } from "./compactor.ts";
+/** Legacy V2 version; retained for compatibility readers. */
 export declare const COMPACTION_CHECKPOINT_VERSION: 2;
+export declare const TASK_SUMMARY_CHECKPOINT_VERSION: 3;
 export declare const COMPACTION_CHECKPOINT_V1_VERSION: 1;
 export declare class UnsupportedCompactionCheckpointVersionError extends Error {
     readonly checkpointVersion: number;
@@ -23,12 +26,12 @@ declare const compactionGoalSchema: z.ZodReadonly<z.ZodObject<{
     status: z.ZodEnum<["active", "interrupted", "unknown"]>;
 }, "strict", z.ZodTypeAny, {
     status: "unknown" | "active" | "interrupted";
-    sourceSequence: number;
     verbatimRequest: string;
+    sourceSequence: number;
 }, {
     status: "unknown" | "active" | "interrupted";
-    sourceSequence: number;
     verbatimRequest: string;
+    sourceSequence: number;
 }>>;
 declare const compactionConstraintSchema: z.ZodReadonly<z.ZodObject<{
     quote: z.ZodString;
@@ -213,8 +216,8 @@ declare const compactionRunningWorkSchema: z.ZodReadonly<z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     sessionId: number;
     state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-    workdir: string;
     managerInstanceId: string;
+    workdir: string;
     recoverability: "unavailable" | "live" | "stale";
     commandPreview: string;
     observedAt: string;
@@ -225,8 +228,8 @@ declare const compactionRunningWorkSchema: z.ZodReadonly<z.ZodObject<{
 }, {
     sessionId: number;
     state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-    workdir: string;
     managerInstanceId: string;
+    workdir: string;
     recoverability: "unavailable" | "live" | "stale";
     commandPreview: string;
     observedAt: string;
@@ -251,20 +254,20 @@ declare const compactionContextSchema: z.ZodReadonly<z.ZodObject<{
     }>>, "many">;
     explicitSkillNames: z.ZodArray<z.ZodString, "many">;
 }, "strict", z.ZodTypeAny, {
+    cwd: string;
     skills: Readonly<{
         name: string;
         source: "config" | "user" | "agent" | "project";
     }>[];
-    cwd: string;
     stableRuleIds: string[];
     explicitSkillNames: string[];
     systemPromptSha256?: string | undefined;
 }, {
+    cwd: string;
     skills: Readonly<{
         name: string;
         source: "config" | "user" | "agent" | "project";
     }>[];
-    cwd: string;
     stableRuleIds: string[];
     explicitSkillNames: string[];
     systemPromptSha256?: string | undefined;
@@ -388,12 +391,12 @@ export declare const compactionCheckpointDraftSchema: z.ZodReadonly<z.ZodObject<
         status: z.ZodEnum<["active", "interrupted", "unknown"]>;
     }, "strict", z.ZodTypeAny, {
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }, {
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }>>>;
     constraints: z.ZodArray<z.ZodReadonly<z.ZodObject<{
         quote: z.ZodString;
@@ -578,8 +581,8 @@ export declare const compactionCheckpointDraftSchema: z.ZodReadonly<z.ZodObject<
     }, "strict", z.ZodTypeAny, {
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -590,8 +593,8 @@ export declare const compactionCheckpointDraftSchema: z.ZodReadonly<z.ZodObject<
     }, {
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -616,20 +619,20 @@ export declare const compactionCheckpointDraftSchema: z.ZodReadonly<z.ZodObject<
         }>>, "many">;
         explicitSkillNames: z.ZodArray<z.ZodString, "many">;
     }, "strict", z.ZodTypeAny, {
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
     }, {
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
@@ -667,11 +670,11 @@ export declare const compactionCheckpointDraftSchema: z.ZodReadonly<z.ZodObject<
     }>]>>;
 }, "strict", z.ZodTypeAny, {
     context: Readonly<{
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
@@ -728,8 +731,8 @@ export declare const compactionCheckpointDraftSchema: z.ZodReadonly<z.ZodObject<
     runningWork: Readonly<{
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -740,16 +743,16 @@ export declare const compactionCheckpointDraftSchema: z.ZodReadonly<z.ZodObject<
     }>[];
     goal?: Readonly<{
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }> | undefined;
 }, {
     context: Readonly<{
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
@@ -806,8 +809,8 @@ export declare const compactionCheckpointDraftSchema: z.ZodReadonly<z.ZodObject<
     runningWork: Readonly<{
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -818,8 +821,8 @@ export declare const compactionCheckpointDraftSchema: z.ZodReadonly<z.ZodObject<
     }>[];
     goal?: Readonly<{
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }> | undefined;
 }>>;
 export declare const compactionCheckpointV1Schema: z.ZodReadonly<z.ZodObject<{
@@ -889,12 +892,12 @@ export declare const compactionCheckpointV1Schema: z.ZodReadonly<z.ZodObject<{
         status: z.ZodEnum<["active", "interrupted", "unknown"]>;
     }, "strict", z.ZodTypeAny, {
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }, {
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }>>>;
     constraints: z.ZodArray<z.ZodReadonly<z.ZodObject<{
         quote: z.ZodString;
@@ -1079,8 +1082,8 @@ export declare const compactionCheckpointV1Schema: z.ZodReadonly<z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -1091,8 +1094,8 @@ export declare const compactionCheckpointV1Schema: z.ZodReadonly<z.ZodObject<{
     }, {
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -1117,20 +1120,20 @@ export declare const compactionCheckpointV1Schema: z.ZodReadonly<z.ZodObject<{
         }>>, "many">;
         explicitSkillNames: z.ZodArray<z.ZodString, "many">;
     }, "strict", z.ZodTypeAny, {
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
     }, {
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
@@ -1172,11 +1175,11 @@ export declare const compactionCheckpointV1Schema: z.ZodReadonly<z.ZodObject<{
     createdAt: string;
     generation: number;
     context: Readonly<{
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
@@ -1233,8 +1236,8 @@ export declare const compactionCheckpointV1Schema: z.ZodReadonly<z.ZodObject<{
     runningWork: Readonly<{
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -1256,8 +1259,8 @@ export declare const compactionCheckpointV1Schema: z.ZodReadonly<z.ZodObject<{
     }>;
     goal?: Readonly<{
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }> | undefined;
     previousCheckpointId?: (string & z.BRAND<"CompactionCheckpointId">) | undefined;
 }, {
@@ -1266,11 +1269,11 @@ export declare const compactionCheckpointV1Schema: z.ZodReadonly<z.ZodObject<{
     createdAt: string;
     generation: number;
     context: Readonly<{
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
@@ -1327,8 +1330,8 @@ export declare const compactionCheckpointV1Schema: z.ZodReadonly<z.ZodObject<{
     runningWork: Readonly<{
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -1350,8 +1353,8 @@ export declare const compactionCheckpointV1Schema: z.ZodReadonly<z.ZodObject<{
     }>;
     goal?: Readonly<{
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }> | undefined;
     previousCheckpointId?: string | undefined;
 }>>;
@@ -1418,8 +1421,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
     }>>;
     semanticState: z.ZodReadonly<z.ZodEffects<z.ZodObject<{
         version: z.ZodLiteral<1>;
+        scopeId: z.ZodOptional<z.ZodString>;
         goal: z.ZodNullable<z.ZodReadonly<z.ZodObject<{
             id: z.ZodBranded<z.ZodString, "CompactionSemanticItemId">;
+            harnessKey: z.ZodOptional<z.ZodString>;
+            relatedItemId: z.ZodOptional<z.ZodBranded<z.ZodString, "CompactionSemanticItemId">>;
             text: z.ZodString;
             provenance: z.ZodArray<z.ZodReadonly<z.ZodEffects<z.ZodObject<{
                 kind: z.ZodEnum<["message", "tool_execution", "resource", "running_session", "legacy_snapshot"]>;
@@ -1433,11 +1439,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }, "strict", z.ZodTypeAny, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1451,11 +1457,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }>, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1471,17 +1477,19 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
         }, "strict", z.ZodTypeAny, {
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }, {
             id: string;
             text: string;
@@ -1495,10 +1503,14 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>>>;
         constraints: z.ZodDefault<z.ZodArray<z.ZodReadonly<z.ZodObject<{
             id: z.ZodBranded<z.ZodString, "CompactionSemanticItemId">;
+            harnessKey: z.ZodOptional<z.ZodString>;
+            relatedItemId: z.ZodOptional<z.ZodBranded<z.ZodString, "CompactionSemanticItemId">>;
             text: z.ZodString;
             provenance: z.ZodArray<z.ZodReadonly<z.ZodEffects<z.ZodObject<{
                 kind: z.ZodEnum<["message", "tool_execution", "resource", "running_session", "legacy_snapshot"]>;
@@ -1512,11 +1524,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }, "strict", z.ZodTypeAny, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1530,11 +1542,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }>, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1550,17 +1562,19 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
         }, "strict", z.ZodTypeAny, {
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }, {
             id: string;
             text: string;
@@ -1574,10 +1588,14 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>>, "many">>;
         decisions: z.ZodArray<z.ZodReadonly<z.ZodObject<{
             id: z.ZodBranded<z.ZodString, "CompactionSemanticItemId">;
+            harnessKey: z.ZodOptional<z.ZodString>;
+            relatedItemId: z.ZodOptional<z.ZodBranded<z.ZodString, "CompactionSemanticItemId">>;
             text: z.ZodString;
             provenance: z.ZodArray<z.ZodReadonly<z.ZodEffects<z.ZodObject<{
                 kind: z.ZodEnum<["message", "tool_execution", "resource", "running_session", "legacy_snapshot"]>;
@@ -1591,11 +1609,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }, "strict", z.ZodTypeAny, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1609,11 +1627,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }>, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1629,17 +1647,19 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
         }, "strict", z.ZodTypeAny, {
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }, {
             id: string;
             text: string;
@@ -1653,10 +1673,14 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>>, "many">;
         completedWork: z.ZodArray<z.ZodReadonly<z.ZodObject<{
             id: z.ZodBranded<z.ZodString, "CompactionSemanticItemId">;
+            harnessKey: z.ZodOptional<z.ZodString>;
+            relatedItemId: z.ZodOptional<z.ZodBranded<z.ZodString, "CompactionSemanticItemId">>;
             text: z.ZodString;
             provenance: z.ZodArray<z.ZodReadonly<z.ZodEffects<z.ZodObject<{
                 kind: z.ZodEnum<["message", "tool_execution", "resource", "running_session", "legacy_snapshot"]>;
@@ -1670,11 +1694,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }, "strict", z.ZodTypeAny, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1688,11 +1712,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }>, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1708,17 +1732,19 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
         }, "strict", z.ZodTypeAny, {
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }, {
             id: string;
             text: string;
@@ -1732,10 +1758,14 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>>, "many">;
         pendingWork: z.ZodArray<z.ZodReadonly<z.ZodObject<{
             id: z.ZodBranded<z.ZodString, "CompactionSemanticItemId">;
+            harnessKey: z.ZodOptional<z.ZodString>;
+            relatedItemId: z.ZodOptional<z.ZodBranded<z.ZodString, "CompactionSemanticItemId">>;
             text: z.ZodString;
             provenance: z.ZodArray<z.ZodReadonly<z.ZodEffects<z.ZodObject<{
                 kind: z.ZodEnum<["message", "tool_execution", "resource", "running_session", "legacy_snapshot"]>;
@@ -1749,11 +1779,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }, "strict", z.ZodTypeAny, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1767,11 +1797,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }>, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1787,17 +1817,19 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
         }, "strict", z.ZodTypeAny, {
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }, {
             id: string;
             text: string;
@@ -1811,6 +1843,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>>, "many">;
         resources: z.ZodArray<z.ZodReadonly<z.ZodObject<{
@@ -1828,11 +1862,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }, "strict", z.ZodTypeAny, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1846,11 +1880,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }>, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1868,11 +1902,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
         }, {
@@ -1905,11 +1939,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }, "strict", z.ZodTypeAny, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1923,11 +1957,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }>, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -1946,11 +1980,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
         }, {
@@ -1970,6 +2004,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
         }>>, "many">;
         uncertainties: z.ZodArray<z.ZodReadonly<z.ZodObject<{
             id: z.ZodBranded<z.ZodString, "CompactionSemanticItemId">;
+            harnessKey: z.ZodOptional<z.ZodString>;
+            relatedItemId: z.ZodOptional<z.ZodBranded<z.ZodString, "CompactionSemanticItemId">>;
             text: z.ZodString;
             provenance: z.ZodArray<z.ZodReadonly<z.ZodEffects<z.ZodObject<{
                 kind: z.ZodEnum<["message", "tool_execution", "resource", "running_session", "legacy_snapshot"]>;
@@ -1983,11 +2019,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }, "strict", z.ZodTypeAny, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -2001,11 +2037,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             }>, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }, {
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
@@ -2021,17 +2057,19 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
         }, "strict", z.ZodTypeAny, {
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }, {
             id: string;
             text: string;
@@ -2045,6 +2083,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>>, "many">;
         prunedItemCounts: z.ZodDefault<z.ZodReadonly<z.ZodObject<{
@@ -2080,88 +2120,98 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
         }>[];
         goal: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }> | null;
         constraints: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         decisions: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         completedWork: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         pendingWork: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         runningSessions: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
@@ -2170,28 +2220,30 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
         }>[];
         uncertainties: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         prunedItemCounts: Readonly<{
             resource: number;
@@ -2202,6 +2254,7 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             pending_work: number;
             uncertainty: number;
         }>;
+        scopeId?: string | undefined;
     }, {
         version: 1;
         resources: Readonly<{
@@ -2231,6 +2284,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }> | null;
         decisions: Readonly<{
@@ -2246,6 +2301,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
         completedWork: Readonly<{
@@ -2261,6 +2318,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
         pendingWork: Readonly<{
@@ -2276,6 +2335,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
         runningSessions: Readonly<{
@@ -2306,8 +2367,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
+        scopeId?: string | undefined;
         constraints?: Readonly<{
             id: string;
             text: string;
@@ -2321,6 +2385,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[] | undefined;
         prunedItemCounts?: Readonly<{
@@ -2340,88 +2406,98 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
         }>[];
         goal: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }> | null;
         constraints: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         decisions: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         completedWork: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         pendingWork: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         runningSessions: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
@@ -2430,28 +2506,30 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
         }>[];
         uncertainties: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         prunedItemCounts: Readonly<{
             resource: number;
@@ -2462,6 +2540,7 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             pending_work: number;
             uncertainty: number;
         }>;
+        scopeId?: string | undefined;
     }, {
         version: 1;
         resources: Readonly<{
@@ -2491,6 +2570,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }> | null;
         decisions: Readonly<{
@@ -2506,6 +2587,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
         completedWork: Readonly<{
@@ -2521,6 +2604,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
         pendingWork: Readonly<{
@@ -2536,6 +2621,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
         runningSessions: Readonly<{
@@ -2566,8 +2653,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
+        scopeId?: string | undefined;
         constraints?: Readonly<{
             id: string;
             text: string;
@@ -2581,6 +2671,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[] | undefined;
         prunedItemCounts?: Readonly<{
@@ -2603,18 +2695,19 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
         messagesThroughSequence: number;
         toolExecutionsThroughSequence: number;
     }>>>;
+    toolEvidenceCursor: z.ZodOptional<z.ZodNumber>;
     goal: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
         verbatimRequest: z.ZodString;
         sourceSequence: z.ZodNumber;
         status: z.ZodEnum<["active", "interrupted", "unknown"]>;
     }, "strict", z.ZodTypeAny, {
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }, {
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }>>>;
     constraints: z.ZodArray<z.ZodReadonly<z.ZodObject<{
         quote: z.ZodString;
@@ -2799,8 +2892,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
     }, "strict", z.ZodTypeAny, {
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -2811,8 +2904,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
     }, {
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -2837,20 +2930,20 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
         }>>, "many">;
         explicitSkillNames: z.ZodArray<z.ZodString, "many">;
     }, "strict", z.ZodTypeAny, {
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
     }, {
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
@@ -2892,11 +2985,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
     createdAt: string;
     generation: number;
     context: Readonly<{
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
@@ -2953,8 +3046,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
     runningWork: Readonly<{
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -2982,88 +3075,98 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
         }>[];
         goal: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }> | null;
         constraints: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         decisions: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         completedWork: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         pendingWork: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         runningSessions: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
@@ -3072,28 +3175,30 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
         }>[];
         uncertainties: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         prunedItemCounts: Readonly<{
             resource: number;
@@ -3104,6 +3209,7 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             pending_work: number;
             uncertainty: number;
         }>;
+        scopeId?: string | undefined;
     }>;
     semanticEvidence: Readonly<{
         messagesThroughSequence: number;
@@ -3111,21 +3217,22 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
     }>;
     goal?: Readonly<{
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }> | undefined;
     previousCheckpointId?: (string & z.BRAND<"CompactionCheckpointId">) | undefined;
+    toolEvidenceCursor?: number | undefined;
 }, {
     version: 2;
     id: string;
     createdAt: string;
     generation: number;
     context: Readonly<{
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
@@ -3182,8 +3289,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
     runningWork: Readonly<{
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -3232,6 +3339,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }> | null;
         decisions: Readonly<{
@@ -3247,6 +3356,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
         completedWork: Readonly<{
@@ -3262,6 +3373,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
         pendingWork: Readonly<{
@@ -3277,6 +3390,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
         runningSessions: Readonly<{
@@ -3307,8 +3422,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
+        scopeId?: string | undefined;
         constraints?: Readonly<{
             id: string;
             text: string;
@@ -3322,6 +3440,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[] | undefined;
         prunedItemCounts?: Readonly<{
@@ -3336,25 +3456,26 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
     }>;
     goal?: Readonly<{
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }> | undefined;
     previousCheckpointId?: string | undefined;
     semanticEvidence?: Readonly<{
         messagesThroughSequence: number;
         toolExecutionsThroughSequence: number;
     }> | undefined;
+    toolEvidenceCursor?: number | undefined;
 }>, {
     version: 2;
     id: string & z.BRAND<"CompactionCheckpointId">;
     createdAt: string;
     generation: number;
     context: Readonly<{
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
@@ -3411,8 +3532,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
     runningWork: Readonly<{
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -3440,88 +3561,98 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
         }>[];
         goal: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }> | null;
         constraints: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         decisions: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         completedWork: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         pendingWork: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         runningSessions: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
@@ -3530,28 +3661,30 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
         }>[];
         uncertainties: Readonly<{
             id: string & z.BRAND<"CompactionSemanticItemId">;
             text: string;
-            sourceQuotes: string[];
             provenance: Readonly<{
                 kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
                 sessionId: number | null;
+                checkpointId: string | null;
                 messageSequence: number | null;
                 toolExecutionId: string | null;
                 resourceKey: string | null;
                 managerInstanceId: string | null;
-                checkpointId: string | null;
                 snapshotIndex: number | null;
             }>[];
+            sourceQuotes: string[];
+            harnessKey?: string | undefined;
+            relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
         }>[];
         prunedItemCounts: Readonly<{
             resource: number;
@@ -3562,6 +3695,7 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
             pending_work: number;
             uncertainty: number;
         }>;
+        scopeId?: string | undefined;
     }>;
     semanticEvidence: Readonly<{
         messagesThroughSequence: number;
@@ -3569,21 +3703,22 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
     }>;
     goal?: Readonly<{
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }> | undefined;
     previousCheckpointId?: (string & z.BRAND<"CompactionCheckpointId">) | undefined;
+    toolEvidenceCursor?: number | undefined;
 }, {
     version: 2;
     id: string;
     createdAt: string;
     generation: number;
     context: Readonly<{
+        cwd: string;
         skills: Readonly<{
             name: string;
             source: "config" | "user" | "agent" | "project";
         }>[];
-        cwd: string;
         stableRuleIds: string[];
         explicitSkillNames: string[];
         systemPromptSha256?: string | undefined;
@@ -3640,8 +3775,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
     runningWork: Readonly<{
         sessionId: number;
         state: "completed" | "cleanup-failed" | "running" | "draining" | "stopping";
-        workdir: string;
         managerInstanceId: string;
+        workdir: string;
         recoverability: "unavailable" | "live" | "stale";
         commandPreview: string;
         observedAt: string;
@@ -3690,6 +3825,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }> | null;
         decisions: Readonly<{
@@ -3705,6 +3842,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
         completedWork: Readonly<{
@@ -3720,6 +3859,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
         pendingWork: Readonly<{
@@ -3735,6 +3876,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
         runningSessions: Readonly<{
@@ -3765,8 +3908,11 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[];
+        scopeId?: string | undefined;
         constraints?: Readonly<{
             id: string;
             text: string;
@@ -3780,6 +3926,8 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
                 checkpointId?: string | null | undefined;
                 snapshotIndex?: number | null | undefined;
             }>[];
+            harnessKey?: string | undefined;
+            relatedItemId?: string | undefined;
             sourceQuotes?: string[] | undefined;
         }>[] | undefined;
         prunedItemCounts?: Readonly<{
@@ -3794,15 +3942,325 @@ export declare const compactionCheckpointV2Schema: z.ZodReadonly<z.ZodEffects<z.
     }>;
     goal?: Readonly<{
         status: "unknown" | "active" | "interrupted";
-        sourceSequence: number;
         verbatimRequest: string;
+        sourceSequence: number;
     }> | undefined;
     previousCheckpointId?: string | undefined;
     semanticEvidence?: Readonly<{
         messagesThroughSequence: number;
         toolExecutionsThroughSequence: number;
     }> | undefined;
+    toolEvidenceCursor?: number | undefined;
+}>>;
+/** Current checkpoints persist a lossy task summary and Harness facts, never semantic coverage. */
+export declare const compactionCheckpointV3Schema: z.ZodReadonly<z.ZodObject<{
+    version: z.ZodLiteral<3>;
+    id: z.ZodBranded<z.ZodString, "CompactionCheckpointId">;
+    generation: z.ZodNumber;
+    previousCheckpointId: z.ZodOptional<z.ZodBranded<z.ZodString, "CompactionCheckpointId">>;
+    createdAt: z.ZodString;
+    transcript: z.ZodReadonly<z.ZodObject<{
+        messages: z.ZodEffects<z.ZodObject<{
+            fromSequenceExclusive: z.ZodNumber;
+            throughSequence: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        }, {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        }>, {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        }, {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        }>;
+        toolExecutions: z.ZodEffects<z.ZodObject<{
+            fromSequenceExclusive: z.ZodNumber;
+            throughSequence: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        }, {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        }>, {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        }, {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        }>;
+        completeness: z.ZodEnum<["complete", "legacy_snapshot"]>;
+    }, "strict", z.ZodTypeAny, {
+        messages: {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        };
+        toolExecutions: {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        };
+        completeness: "complete" | "legacy_snapshot";
+    }, {
+        messages: {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        };
+        toolExecutions: {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        };
+        completeness: "complete" | "legacy_snapshot";
+    }>>;
+    taskSummary: z.ZodString;
+    toolState: z.ZodReadonly<z.ZodObject<{
+        countsByOutcome: z.ZodReadonly<z.ZodObject<{
+            success: z.ZodNumber;
+            user_rejected: z.ZodNumber;
+            policy_denied: z.ZodNumber;
+            invalid_input: z.ZodNumber;
+            cancelled: z.ZodNumber;
+            tool_failed: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            success: number;
+            cancelled: number;
+            invalid_input: number;
+            user_rejected: number;
+            policy_denied: number;
+            tool_failed: number;
+        }, {
+            success: number;
+            cancelled: number;
+            invalid_input: number;
+            user_rejected: number;
+            policy_denied: number;
+            tool_failed: number;
+        }>>;
+        recentRecords: z.ZodArray<z.ZodReadonly<z.ZodObject<{
+            executionId: z.ZodString;
+            sequence: z.ZodNumber;
+            toolCallId: z.ZodString;
+            agentName: z.ZodString;
+            toolName: z.ZodString;
+            outcome: z.ZodReadonly<z.ZodEffects<z.ZodObject<{
+                kind: z.ZodEnum<["success", "user_rejected", "policy_denied", "invalid_input", "cancelled", "tool_failed"]>;
+                reason: z.ZodOptional<z.ZodString>;
+                executionState: z.ZodOptional<z.ZodEnum<["not_executed", "outcome_unknown"]>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "success" | "cancelled" | "invalid_input" | "user_rejected" | "policy_denied" | "tool_failed";
+                reason?: string | undefined;
+                executionState?: "not_executed" | "outcome_unknown" | undefined;
+            }, {
+                kind: "success" | "cancelled" | "invalid_input" | "user_rejected" | "policy_denied" | "tool_failed";
+                reason?: string | undefined;
+                executionState?: "not_executed" | "outcome_unknown" | undefined;
+            }>, {
+                kind: "success" | "cancelled" | "invalid_input" | "user_rejected" | "policy_denied" | "tool_failed";
+                reason?: string | undefined;
+                executionState?: "not_executed" | "outcome_unknown" | undefined;
+            }, {
+                kind: "success" | "cancelled" | "invalid_input" | "user_rejected" | "policy_denied" | "tool_failed";
+                reason?: string | undefined;
+                executionState?: "not_executed" | "outcome_unknown" | undefined;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            toolCallId: string;
+            toolName: string;
+            agentName: string;
+            outcome: Readonly<{
+                kind: "success" | "cancelled" | "invalid_input" | "user_rejected" | "policy_denied" | "tool_failed";
+                reason?: string | undefined;
+                executionState?: "not_executed" | "outcome_unknown" | undefined;
+            }>;
+            sequence: number;
+            executionId: string;
+        }, {
+            toolCallId: string;
+            toolName: string;
+            agentName: string;
+            outcome: Readonly<{
+                kind: "success" | "cancelled" | "invalid_input" | "user_rejected" | "policy_denied" | "tool_failed";
+                reason?: string | undefined;
+                executionState?: "not_executed" | "outcome_unknown" | undefined;
+            }>;
+            sequence: number;
+            executionId: string;
+        }>>, "many">;
+        integrityStatus: z.ZodEnum<["valid", "sanitized", "invalid"]>;
+        anomalies: z.ZodArray<z.ZodReadonly<z.ZodObject<{
+            kind: z.ZodEnum<["orphan_result", "dangling_call", "duplicate_call", "duplicate_result", "record_without_call", "record_without_result", "result_without_record"]>;
+            toolCallId: z.ZodString;
+            count: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "orphan_result" | "dangling_call" | "duplicate_call" | "duplicate_result" | "record_without_call" | "record_without_result" | "result_without_record";
+            toolCallId: string;
+            count?: number | undefined;
+        }, {
+            kind: "orphan_result" | "dangling_call" | "duplicate_call" | "duplicate_result" | "record_without_call" | "record_without_result" | "result_without_record";
+            toolCallId: string;
+            count?: number | undefined;
+        }>>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        countsByOutcome: Readonly<{
+            success: number;
+            cancelled: number;
+            invalid_input: number;
+            user_rejected: number;
+            policy_denied: number;
+            tool_failed: number;
+        }>;
+        recentRecords: Readonly<{
+            toolCallId: string;
+            toolName: string;
+            agentName: string;
+            outcome: Readonly<{
+                kind: "success" | "cancelled" | "invalid_input" | "user_rejected" | "policy_denied" | "tool_failed";
+                reason?: string | undefined;
+                executionState?: "not_executed" | "outcome_unknown" | undefined;
+            }>;
+            sequence: number;
+            executionId: string;
+        }>[];
+        integrityStatus: "invalid" | "valid" | "sanitized";
+        anomalies: Readonly<{
+            kind: "orphan_result" | "dangling_call" | "duplicate_call" | "duplicate_result" | "record_without_call" | "record_without_result" | "result_without_record";
+            toolCallId: string;
+            count?: number | undefined;
+        }>[];
+    }, {
+        countsByOutcome: Readonly<{
+            success: number;
+            cancelled: number;
+            invalid_input: number;
+            user_rejected: number;
+            policy_denied: number;
+            tool_failed: number;
+        }>;
+        recentRecords: Readonly<{
+            toolCallId: string;
+            toolName: string;
+            agentName: string;
+            outcome: Readonly<{
+                kind: "success" | "cancelled" | "invalid_input" | "user_rejected" | "policy_denied" | "tool_failed";
+                reason?: string | undefined;
+                executionState?: "not_executed" | "outcome_unknown" | undefined;
+            }>;
+            sequence: number;
+            executionId: string;
+        }>[];
+        integrityStatus: "invalid" | "valid" | "sanitized";
+        anomalies: Readonly<{
+            kind: "orphan_result" | "dangling_call" | "duplicate_call" | "duplicate_result" | "record_without_call" | "record_without_result" | "result_without_record";
+            toolCallId: string;
+            count?: number | undefined;
+        }>[];
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    version: 3;
+    id: string & z.BRAND<"CompactionCheckpointId">;
+    createdAt: string;
+    generation: number;
+    toolState: Readonly<{
+        countsByOutcome: Readonly<{
+            success: number;
+            cancelled: number;
+            invalid_input: number;
+            user_rejected: number;
+            policy_denied: number;
+            tool_failed: number;
+        }>;
+        recentRecords: Readonly<{
+            toolCallId: string;
+            toolName: string;
+            agentName: string;
+            outcome: Readonly<{
+                kind: "success" | "cancelled" | "invalid_input" | "user_rejected" | "policy_denied" | "tool_failed";
+                reason?: string | undefined;
+                executionState?: "not_executed" | "outcome_unknown" | undefined;
+            }>;
+            sequence: number;
+            executionId: string;
+        }>[];
+        integrityStatus: "invalid" | "valid" | "sanitized";
+        anomalies: Readonly<{
+            kind: "orphan_result" | "dangling_call" | "duplicate_call" | "duplicate_result" | "record_without_call" | "record_without_result" | "result_without_record";
+            toolCallId: string;
+            count?: number | undefined;
+        }>[];
+    }>;
+    transcript: Readonly<{
+        messages: {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        };
+        toolExecutions: {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        };
+        completeness: "complete" | "legacy_snapshot";
+    }>;
+    taskSummary: string;
+    previousCheckpointId?: (string & z.BRAND<"CompactionCheckpointId">) | undefined;
+}, {
+    version: 3;
+    id: string;
+    createdAt: string;
+    generation: number;
+    toolState: Readonly<{
+        countsByOutcome: Readonly<{
+            success: number;
+            cancelled: number;
+            invalid_input: number;
+            user_rejected: number;
+            policy_denied: number;
+            tool_failed: number;
+        }>;
+        recentRecords: Readonly<{
+            toolCallId: string;
+            toolName: string;
+            agentName: string;
+            outcome: Readonly<{
+                kind: "success" | "cancelled" | "invalid_input" | "user_rejected" | "policy_denied" | "tool_failed";
+                reason?: string | undefined;
+                executionState?: "not_executed" | "outcome_unknown" | undefined;
+            }>;
+            sequence: number;
+            executionId: string;
+        }>[];
+        integrityStatus: "invalid" | "valid" | "sanitized";
+        anomalies: Readonly<{
+            kind: "orphan_result" | "dangling_call" | "duplicate_call" | "duplicate_result" | "record_without_call" | "record_without_result" | "result_without_record";
+            toolCallId: string;
+            count?: number | undefined;
+        }>[];
+    }>;
+    transcript: Readonly<{
+        messages: {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        };
+        toolExecutions: {
+            fromSequenceExclusive: number;
+            throughSequence: number;
+        };
+        completeness: "complete" | "legacy_snapshot";
+    }>;
+    taskSummary: string;
+    previousCheckpointId?: string | undefined;
 }>>;
+export type CompactionCheckpointV3 = z.infer<typeof compactionCheckpointV3Schema>;
+export type CreateSummaryCheckpointInput = {
+    readonly summary: CompactionCheckpointV3["taskSummary"];
+    readonly generation: CompactionCheckpointV3["generation"];
+    readonly transcript: CompactionCheckpointV3["transcript"];
+    readonly previousCheckpointId?: string;
+    readonly id?: string;
+    readonly createdAt?: string;
+    readonly toolState?: CompactionCheckpointV3["toolState"];
+};
+export declare function createSummaryCheckpoint(input: CreateSummaryCheckpointInput): CompactionCheckpointV3;
 export type CompactionGoal = z.infer<typeof compactionGoalSchema>;
 export type CompactionConstraint = z.infer<typeof compactionConstraintSchema>;
 export type CompactionResource = z.infer<typeof compactionResourceSchema>;
@@ -3817,7 +4275,7 @@ export type CompactionCheckpointDraft = z.infer<typeof compactionCheckpointDraft
 export type CompactionCheckpointDraftInput = z.input<typeof compactionCheckpointDraftSchema>;
 export type CompactionCheckpointV1 = z.infer<typeof compactionCheckpointV1Schema>;
 export type CompactionCheckpointV2 = z.infer<typeof compactionCheckpointV2Schema>;
-export type CompactionCheckpoint = CompactionCheckpointV1 | CompactionCheckpointV2;
+export type CompactionCheckpoint = CompactionCheckpointV1 | CompactionCheckpointV2 | CompactionCheckpointV3;
 export declare const archivedTranscriptMessageSchema: z.ZodReadonly<z.ZodObject<{
     sequence: z.ZodNumber;
     provenance: z.ZodEnum<["native", "legacy_snapshot"]>;
@@ -3835,17 +4293,6 @@ export declare const archivedTranscriptMessageSchema: z.ZodReadonly<z.ZodObject<
     provenance: "legacy_snapshot" | "native";
 }>>;
 export type ArchivedTranscriptMessage = z.infer<typeof archivedTranscriptMessageSchema>;
-export declare const compactionConstraintCandidateSchema: z.ZodReadonly<z.ZodObject<{
-    quote: z.ZodString;
-    sourceSequence: z.ZodNumber;
-}, "strict", z.ZodTypeAny, {
-    sourceSequence: number;
-    quote: string;
-}, {
-    sourceSequence: number;
-    quote: string;
-}>>;
-export type CompactionConstraintCandidate = z.infer<typeof compactionConstraintCandidateSchema>;
 export interface SequencedToolExecutionEvidence extends ToolExecutionRecord {
     readonly sequence: number;
 }
@@ -3858,38 +4305,36 @@ export interface CreateCompactionCheckpointInput {
     readonly createdAt?: string;
     readonly semanticState?: CompactionSemanticState;
     readonly semanticEvidence?: CompactionSemanticEvidenceWatermarks;
+    readonly toolEvidenceCursor?: CompactionCheckpointV2["toolEvidenceCursor"];
 }
-/** Uses the exact semantic budget applied by the production checkpoint reminder. */
-export declare function createCheckpointSemanticReminderProjection(state: CompactionSemanticState): ReturnType<typeof createCompactionSemanticReminderProjection>;
+export declare const MAX_CHECKPOINT_REMINDER_CHARS = 8000;
 export declare function createEmptyCompactionToolState(): CompactionToolState;
 export declare function buildCompactionToolState(evidenceMessages: readonly ModelMessage[], evidenceRecords: readonly SequencedToolExecutionEvidence[], recentLimit?: number, completeness?: CompactionTranscript["completeness"]): CompactionToolState;
-export declare function findLatestRealUserGoal(entries: readonly ArchivedTranscriptMessage[], status?: CompactionGoal["status"]): CompactionGoal | undefined;
-/**
- * Extracts conservative, verbatim constraint clauses from persisted user transcript evidence.
- * Every returned quote remains directly verifiable by sourceSequence; continuation-only turns
- * and ordinary goal prose do not become constraints.
- */
-export declare function extractExplicitCompactionConstraintCandidates(entries: readonly ArchivedTranscriptMessage[]): readonly CompactionConstraintCandidate[];
-/**
- * Resolves the bounded set of currently-active explicit constraints.
- *
- * Priority is transcript sequence: a later assertion replaces an earlier assertion for the same
- * normalized scope, while a later explicit allowance/revocation removes that scope. Matching is
- * intentionally exact after directive/punctuation normalization; implicit paraphrases, synonyms,
- * and cross-scope contradictions remain outside this deterministic Harness layer.
- */
-export declare function resolveActiveCompactionConstraints(entries: readonly ArchivedTranscriptMessage[], previous?: readonly CompactionConstraint[]): readonly CompactionConstraint[];
-export declare function verifyCompactionConstraintCandidates(entries: readonly ArchivedTranscriptMessage[], candidates: readonly CompactionConstraintCandidate[], previous?: readonly CompactionConstraint[]): readonly CompactionConstraint[];
 export declare function createCompactionSummary(text: string | undefined): CompactionSummary;
-/**
- * A non-authoritative quality hint for debug telemetry only. Recovery facts come
- * from the structured checkpoint, Tool ledger and transcript evidence instead
- * of language-specific words in the generated prose.
- */
-export declare function compactionSummaryQualityAdvisory(text: string | undefined): string | undefined;
 export declare function createCompactionCheckpointDraft(input: CompactionCheckpointDraftInput): CompactionCheckpointDraft;
 export declare function createCompactionCheckpoint(input: CreateCompactionCheckpointInput): CompactionCheckpointV2;
 export declare function parseCompactionCheckpoint(value: unknown): CompactionCheckpoint;
 export declare function isCompactionCheckpoint(value: unknown): value is CompactionCheckpoint;
-export declare function buildCompactionCheckpointReminder(checkpoint: CompactionCheckpoint, currentManagerInstanceId?: string, transcriptToolId?: string): string;
-export {};
+export declare function projectCompactionCheckpointReminder(checkpoint: CompactionCheckpoint, currentManagerInstanceId?: string, transcriptToolId?: string, contextToolId?: string, recoveryReminder?: string): {
+    text: string;
+    semanticProjection: Readonly<{
+        version: 1;
+        items: Readonly<{
+            text: string;
+            sourceQuotes: string[];
+            itemId: string & z.BRAND<"CompactionSemanticItemId">;
+            category: "resource" | "decision" | "running_session" | "goal" | "constraint" | "completed_work" | "pending_work" | "uncertainty";
+        }>[];
+        omittedCounts: Readonly<{
+            resource: number;
+            decision: number;
+            running_session: number;
+            goal: number;
+            constraint: number;
+            completed_work: number;
+            pending_work: number;
+            uncertainty: number;
+        }>;
+    }> | null;
+};
+export declare function buildCompactionCheckpointReminder(checkpoint: CompactionCheckpoint, currentManagerInstanceId?: string, transcriptToolId?: string, contextToolId?: string, recoveryReminder?: string): string;