@roll-agent/runtime 0.25.1 → 0.26.0

package/dist/engine/compaction-semantic-state.d.ts

@@ -1,10 +1,7 @@
 import { z } from "zod";
-import { type ToolCancellationExecutionState } from "../tool-bridge/normalize-result.ts";
 export declare const COMPACTION_SEMANTIC_STATE_VERSION: 1;
 export declare const COMPACTION_PROVENANCE_KINDS: readonly ["message", "tool_execution", "resource", "running_session", "legacy_snapshot"];
 export declare const COMPACTION_SEMANTIC_ITEM_KINDS: readonly ["goal", "constraint", "decision", "completed_work", "pending_work", "resource", "running_session", "uncertainty"];
-export declare const legacyCompactionTranscriptFragmentsSchema: z.ZodReadonly<z.ZodArray<z.ZodString, "many">>;
-export type LegacyCompactionTranscriptFragments = z.infer<typeof legacyCompactionTranscriptFragmentsSchema>;
 export declare const compactionSemanticItemIdSchema: z.ZodBranded<z.ZodString, "CompactionSemanticItemId">;
 export type CompactionSemanticItemId = z.infer<typeof compactionSemanticItemIdSchema>;
 /**
@@ -24,11 +21,11 @@ export declare const compactionProvenanceRefSchema: 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";
@@ -42,11 +39,11 @@ export declare const compactionProvenanceRefSchema: 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";
@@ -59,288 +56,253 @@ export declare const compactionProvenanceRefSchema: z.ZodReadonly<z.ZodEffects<z
     snapshotIndex?: number | null | undefined;
 }>>;
 export type CompactionProvenanceRef = z.infer<typeof compactionProvenanceRefSchema>;
-/**
- * Provider-portable structured output contract. All object properties are
- * required; goal is explicitly nullable and empty arrays mean "no candidate".
- */
-export declare const compactionModelDraftSchema: z.ZodReadonly<z.ZodObject<{
-    startsNewGoalScope: z.ZodBoolean;
-    goal: z.ZodNullable<z.ZodReadonly<z.ZodObject<{
-        priorItemId: z.ZodNullable<z.ZodString>;
-        text: z.ZodString;
-        sourceEvidenceIds: z.ZodArray<z.ZodString, "many">;
-        sourceQuotes: z.ZodArray<z.ZodString, "many">;
-    }, "strict", z.ZodTypeAny, {
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }, {
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>>>;
-    constraints: z.ZodArray<z.ZodReadonly<z.ZodObject<{
-        priorItemId: z.ZodNullable<z.ZodString>;
-        text: z.ZodString;
-        sourceEvidenceIds: z.ZodArray<z.ZodString, "many">;
-        sourceQuotes: z.ZodArray<z.ZodString, "many">;
-    }, "strict", z.ZodTypeAny, {
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }, {
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>>, "many">;
-    decisions: z.ZodArray<z.ZodReadonly<z.ZodObject<{
-        priorItemId: z.ZodNullable<z.ZodString>;
-        text: z.ZodString;
-        sourceEvidenceIds: z.ZodArray<z.ZodString, "many">;
-        sourceQuotes: z.ZodArray<z.ZodString, "many">;
-    }, "strict", z.ZodTypeAny, {
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }, {
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>>, "many">;
-    completedWork: z.ZodArray<z.ZodReadonly<z.ZodObject<{
-        priorItemId: z.ZodNullable<z.ZodString>;
-        text: z.ZodString;
-        sourceEvidenceIds: z.ZodArray<z.ZodString, "many">;
-        sourceQuotes: z.ZodArray<z.ZodString, "many">;
-    }, "strict", z.ZodTypeAny, {
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }, {
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>>, "many">;
-    pendingWork: z.ZodArray<z.ZodReadonly<z.ZodObject<{
-        priorItemId: z.ZodNullable<z.ZodString>;
-        text: z.ZodString;
-        sourceEvidenceIds: z.ZodArray<z.ZodString, "many">;
-        sourceQuotes: z.ZodArray<z.ZodString, "many">;
+export declare const semanticTextItemSchema: 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"]>;
+        messageSequence: z.ZodNullable<z.ZodNumber>;
+        toolExecutionId: z.ZodNullable<z.ZodString>;
+        resourceKey: z.ZodNullable<z.ZodString>;
+        managerInstanceId: z.ZodNullable<z.ZodString>;
+        sessionId: z.ZodNullable<z.ZodNumber>;
+        checkpointId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        snapshotIndex: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
     }, "strict", z.ZodTypeAny, {
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
+        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;
+        snapshotIndex: number | null;
     }, {
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>>, "many">;
-    resources: z.ZodArray<z.ZodReadonly<z.ZodObject<{
-        priorItemId: z.ZodNullable<z.ZodString>;
-        sourceEvidenceIds: z.ZodArray<z.ZodString, "many">;
-    }, "strict", z.ZodTypeAny, {
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
+        kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+        sessionId: number | null;
+        messageSequence: number | null;
+        toolExecutionId: string | null;
+        resourceKey: string | null;
+        managerInstanceId: string | null;
+        checkpointId?: string | null | undefined;
+        snapshotIndex?: number | null | undefined;
+    }>, {
+        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;
+        snapshotIndex: number | null;
     }, {
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
+        kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+        sessionId: number | null;
+        messageSequence: number | null;
+        toolExecutionId: string | null;
+        resourceKey: string | null;
+        managerInstanceId: string | null;
+        checkpointId?: string | null | undefined;
+        snapshotIndex?: number | null | undefined;
     }>>, "many">;
-    runningSessions: z.ZodArray<z.ZodReadonly<z.ZodObject<{
-        priorItemId: z.ZodNullable<z.ZodString>;
-        sourceEvidenceIds: z.ZodArray<z.ZodString, "many">;
+    sourceQuotes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    id: string & z.BRAND<"CompactionSemanticItemId">;
+    text: 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;
+        snapshotIndex: number | null;
+    }>[];
+    sourceQuotes: string[];
+    harnessKey?: string | undefined;
+    relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
+}, {
+    id: string;
+    text: string;
+    provenance: Readonly<{
+        kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+        sessionId: number | null;
+        messageSequence: number | null;
+        toolExecutionId: string | null;
+        resourceKey: string | null;
+        managerInstanceId: string | null;
+        checkpointId?: string | null | undefined;
+        snapshotIndex?: number | null | undefined;
+    }>[];
+    harnessKey?: string | undefined;
+    relatedItemId?: string | undefined;
+    sourceQuotes?: string[] | undefined;
+}>>;
+export declare const semanticResourceSchema: z.ZodReadonly<z.ZodObject<{
+    id: z.ZodBranded<z.ZodString, "CompactionSemanticItemId">;
+    resourceKey: z.ZodString;
+    provenance: z.ZodArray<z.ZodReadonly<z.ZodEffects<z.ZodObject<{
+        kind: z.ZodEnum<["message", "tool_execution", "resource", "running_session", "legacy_snapshot"]>;
+        messageSequence: z.ZodNullable<z.ZodNumber>;
+        toolExecutionId: z.ZodNullable<z.ZodString>;
+        resourceKey: z.ZodNullable<z.ZodString>;
+        managerInstanceId: z.ZodNullable<z.ZodString>;
+        sessionId: z.ZodNullable<z.ZodNumber>;
+        checkpointId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        snapshotIndex: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
     }, "strict", z.ZodTypeAny, {
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
+        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;
+        snapshotIndex: number | null;
     }, {
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-    }>>, "many">;
-    uncertainties: z.ZodArray<z.ZodReadonly<z.ZodObject<{
-        priorItemId: z.ZodNullable<z.ZodString>;
-        text: z.ZodString;
-        sourceEvidenceIds: z.ZodArray<z.ZodString, "many">;
-        sourceQuotes: z.ZodArray<z.ZodString, "many">;
-    }, "strict", z.ZodTypeAny, {
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
+        kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+        sessionId: number | null;
+        messageSequence: number | null;
+        toolExecutionId: string | null;
+        resourceKey: string | null;
+        managerInstanceId: string | null;
+        checkpointId?: string | null | undefined;
+        snapshotIndex?: number | null | undefined;
+    }>, {
+        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;
+        snapshotIndex: number | null;
     }, {
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
+        kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+        sessionId: number | null;
+        messageSequence: number | null;
+        toolExecutionId: string | null;
+        resourceKey: string | null;
+        managerInstanceId: string | null;
+        checkpointId?: string | null | undefined;
+        snapshotIndex?: number | null | undefined;
     }>>, "many">;
-    resolutions: z.ZodArray<z.ZodReadonly<z.ZodObject<{
-        targetItemId: z.ZodString;
-        targetCategory: z.ZodEnum<["constraint", "decision", "pending_work", "uncertainty"]>;
-        action: z.ZodEnum<["cancel", "supersede", "clarify", "revoke"]>;
-        reason: z.ZodString;
-        sourceEvidenceIds: z.ZodArray<z.ZodString, "many">;
-        sourceQuotes: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    id: string & z.BRAND<"CompactionSemanticItemId">;
+    resourceKey: 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;
+        snapshotIndex: number | null;
+    }>[];
+}, {
+    id: string;
+    resourceKey: string;
+    provenance: Readonly<{
+        kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+        sessionId: number | null;
+        messageSequence: number | null;
+        toolExecutionId: string | null;
+        resourceKey: string | null;
+        managerInstanceId: string | null;
+        checkpointId?: string | null | undefined;
+        snapshotIndex?: number | null | undefined;
+    }>[];
+}>>;
+export declare const semanticRunningSessionSchema: z.ZodReadonly<z.ZodObject<{
+    id: z.ZodBranded<z.ZodString, "CompactionSemanticItemId">;
+    managerInstanceId: z.ZodString;
+    sessionId: z.ZodNumber;
+    provenance: z.ZodArray<z.ZodReadonly<z.ZodEffects<z.ZodObject<{
+        kind: z.ZodEnum<["message", "tool_execution", "resource", "running_session", "legacy_snapshot"]>;
+        messageSequence: z.ZodNullable<z.ZodNumber>;
+        toolExecutionId: z.ZodNullable<z.ZodString>;
+        resourceKey: z.ZodNullable<z.ZodString>;
+        managerInstanceId: z.ZodNullable<z.ZodString>;
+        sessionId: z.ZodNullable<z.ZodNumber>;
+        checkpointId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        snapshotIndex: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
     }, "strict", z.ZodTypeAny, {
-        reason: string;
-        action: "cancel" | "supersede" | "clarify" | "revoke";
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-        targetItemId: string;
-        targetCategory: "decision" | "constraint" | "pending_work" | "uncertainty";
+        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;
+        snapshotIndex: number | null;
     }, {
-        reason: string;
-        action: "cancel" | "supersede" | "clarify" | "revoke";
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-        targetItemId: string;
-        targetCategory: "decision" | "constraint" | "pending_work" | "uncertainty";
-    }>>, "many">;
-    evidenceReviews: z.ZodArray<z.ZodReadonly<z.ZodObject<{
-        evidenceId: z.ZodString;
-        disposition: z.ZodEnum<["irrelevant", "uncertain"]>;
-        reason: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        reason: string;
-        evidenceId: string;
-        disposition: "irrelevant" | "uncertain";
+        kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+        sessionId: number | null;
+        messageSequence: number | null;
+        toolExecutionId: string | null;
+        resourceKey: string | null;
+        managerInstanceId: string | null;
+        checkpointId?: string | null | undefined;
+        snapshotIndex?: number | null | undefined;
+    }>, {
+        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;
+        snapshotIndex: number | null;
     }, {
-        reason: string;
-        evidenceId: string;
-        disposition: "irrelevant" | "uncertain";
+        kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+        sessionId: number | null;
+        messageSequence: number | null;
+        toolExecutionId: string | null;
+        resourceKey: string | null;
+        managerInstanceId: string | null;
+        checkpointId?: string | null | undefined;
+        snapshotIndex?: number | null | undefined;
     }>>, "many">;
 }, "strict", z.ZodTypeAny, {
-    resources: Readonly<{
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-    }>[];
-    goal: Readonly<{
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }> | null;
-    startsNewGoalScope: boolean;
-    constraints: Readonly<{
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>[];
-    decisions: Readonly<{
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>[];
-    completedWork: Readonly<{
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>[];
-    pendingWork: Readonly<{
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>[];
-    runningSessions: Readonly<{
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-    }>[];
-    uncertainties: Readonly<{
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>[];
-    resolutions: Readonly<{
-        reason: string;
-        action: "cancel" | "supersede" | "clarify" | "revoke";
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-        targetItemId: string;
-        targetCategory: "decision" | "constraint" | "pending_work" | "uncertainty";
-    }>[];
-    evidenceReviews: Readonly<{
-        reason: string;
-        evidenceId: string;
-        disposition: "irrelevant" | "uncertain";
+    id: string & z.BRAND<"CompactionSemanticItemId">;
+    sessionId: number;
+    managerInstanceId: 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;
+        snapshotIndex: number | null;
     }>[];
 }, {
-    resources: Readonly<{
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-    }>[];
-    goal: Readonly<{
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }> | null;
-    startsNewGoalScope: boolean;
-    constraints: Readonly<{
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>[];
-    decisions: Readonly<{
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>[];
-    completedWork: Readonly<{
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>[];
-    pendingWork: Readonly<{
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>[];
-    runningSessions: Readonly<{
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-    }>[];
-    uncertainties: Readonly<{
-        text: string;
-        priorItemId: string | null;
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-    }>[];
-    resolutions: Readonly<{
-        reason: string;
-        action: "cancel" | "supersede" | "clarify" | "revoke";
-        sourceEvidenceIds: string[];
-        sourceQuotes: string[];
-        targetItemId: string;
-        targetCategory: "decision" | "constraint" | "pending_work" | "uncertainty";
-    }>[];
-    evidenceReviews: Readonly<{
-        reason: string;
-        evidenceId: string;
-        disposition: "irrelevant" | "uncertain";
+    id: string;
+    sessionId: number;
+    managerInstanceId: string;
+    provenance: Readonly<{
+        kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+        sessionId: number | null;
+        messageSequence: number | null;
+        toolExecutionId: string | null;
+        resourceKey: string | null;
+        managerInstanceId: string | null;
+        checkpointId?: string | null | undefined;
+        snapshotIndex?: number | null | undefined;
     }>[];
 }>>;
-export type CompactionModelDraft = z.infer<typeof compactionModelDraftSchema>;
-export declare function createEmptyCompactionModelDraft(): CompactionModelDraft;
 export declare const compactionSemanticStateSchema: 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"]>;
@@ -354,11 +316,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -372,11 +334,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -392,17 +354,19 @@ export declare const compactionSemanticStateSchema: 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;
@@ -416,10 +380,14 @@ export declare const compactionSemanticStateSchema: 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"]>;
@@ -433,11 +401,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -451,11 +419,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -471,17 +439,19 @@ export declare const compactionSemanticStateSchema: 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;
@@ -495,10 +465,14 @@ export declare const compactionSemanticStateSchema: 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"]>;
@@ -512,11 +486,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -530,11 +504,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -550,17 +524,19 @@ export declare const compactionSemanticStateSchema: 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;
@@ -574,10 +550,14 @@ export declare const compactionSemanticStateSchema: 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"]>;
@@ -591,11 +571,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -609,11 +589,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -629,17 +609,19 @@ export declare const compactionSemanticStateSchema: 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;
@@ -653,10 +635,14 @@ export declare const compactionSemanticStateSchema: 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"]>;
@@ -670,11 +656,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -688,11 +674,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -708,17 +694,19 @@ export declare const compactionSemanticStateSchema: 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;
@@ -732,6 +720,8 @@ export declare const compactionSemanticStateSchema: 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<{
@@ -749,11 +739,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -767,11 +757,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -789,11 +779,11 @@ export declare const compactionSemanticStateSchema: 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;
         }>[];
     }, {
@@ -826,11 +816,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -844,11 +834,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -867,11 +857,11 @@ export declare const compactionSemanticStateSchema: 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;
         }>[];
     }, {
@@ -891,6 +881,8 @@ export declare const compactionSemanticStateSchema: 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"]>;
@@ -904,11 +896,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -922,11 +914,11 @@ export declare const compactionSemanticStateSchema: 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";
@@ -942,17 +934,19 @@ export declare const compactionSemanticStateSchema: 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;
@@ -966,6 +960,8 @@ export declare const compactionSemanticStateSchema: 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<{
@@ -1001,88 +997,98 @@ export declare const compactionSemanticStateSchema: 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">;
@@ -1091,28 +1097,30 @@ export declare const compactionSemanticStateSchema: 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;
@@ -1123,6 +1131,7 @@ export declare const compactionSemanticStateSchema: z.ZodReadonly<z.ZodEffects<z
         pending_work: number;
         uncertainty: number;
     }>;
+    scopeId?: string | undefined;
 }, {
     version: 1;
     resources: Readonly<{
@@ -1152,6 +1161,8 @@ export declare const compactionSemanticStateSchema: 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<{
@@ -1167,6 +1178,8 @@ export declare const compactionSemanticStateSchema: z.ZodReadonly<z.ZodEffects<z
             checkpointId?: string | null | undefined;
             snapshotIndex?: number | null | undefined;
         }>[];
+        harnessKey?: string | undefined;
+        relatedItemId?: string | undefined;
         sourceQuotes?: string[] | undefined;
     }>[];
     completedWork: Readonly<{
@@ -1182,6 +1195,8 @@ export declare const compactionSemanticStateSchema: z.ZodReadonly<z.ZodEffects<z
             checkpointId?: string | null | undefined;
             snapshotIndex?: number | null | undefined;
         }>[];
+        harnessKey?: string | undefined;
+        relatedItemId?: string | undefined;
         sourceQuotes?: string[] | undefined;
     }>[];
     pendingWork: Readonly<{
@@ -1197,6 +1212,8 @@ export declare const compactionSemanticStateSchema: z.ZodReadonly<z.ZodEffects<z
             checkpointId?: string | null | undefined;
             snapshotIndex?: number | null | undefined;
         }>[];
+        harnessKey?: string | undefined;
+        relatedItemId?: string | undefined;
         sourceQuotes?: string[] | undefined;
     }>[];
     runningSessions: Readonly<{
@@ -1227,8 +1244,11 @@ export declare const compactionSemanticStateSchema: 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;
@@ -1242,6 +1262,8 @@ export declare const compactionSemanticStateSchema: 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<{
@@ -1261,88 +1283,98 @@ export declare const compactionSemanticStateSchema: 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">;
@@ -1351,28 +1383,30 @@ export declare const compactionSemanticStateSchema: 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;
@@ -1383,6 +1417,7 @@ export declare const compactionSemanticStateSchema: z.ZodReadonly<z.ZodEffects<z
         pending_work: number;
         uncertainty: number;
     }>;
+    scopeId?: string | undefined;
 }, {
     version: 1;
     resources: Readonly<{
@@ -1412,6 +1447,8 @@ export declare const compactionSemanticStateSchema: 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<{
@@ -1427,6 +1464,8 @@ export declare const compactionSemanticStateSchema: z.ZodReadonly<z.ZodEffects<z
             checkpointId?: string | null | undefined;
             snapshotIndex?: number | null | undefined;
         }>[];
+        harnessKey?: string | undefined;
+        relatedItemId?: string | undefined;
         sourceQuotes?: string[] | undefined;
     }>[];
     completedWork: Readonly<{
@@ -1442,6 +1481,8 @@ export declare const compactionSemanticStateSchema: z.ZodReadonly<z.ZodEffects<z
             checkpointId?: string | null | undefined;
             snapshotIndex?: number | null | undefined;
         }>[];
+        harnessKey?: string | undefined;
+        relatedItemId?: string | undefined;
         sourceQuotes?: string[] | undefined;
     }>[];
     pendingWork: Readonly<{
@@ -1457,6 +1498,8 @@ export declare const compactionSemanticStateSchema: z.ZodReadonly<z.ZodEffects<z
             checkpointId?: string | null | undefined;
             snapshotIndex?: number | null | undefined;
         }>[];
+        harnessKey?: string | undefined;
+        relatedItemId?: string | undefined;
         sourceQuotes?: string[] | undefined;
     }>[];
     runningSessions: Readonly<{
@@ -1487,8 +1530,11 @@ export declare const compactionSemanticStateSchema: 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;
@@ -1502,6 +1548,8 @@ export declare const compactionSemanticStateSchema: 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<{
@@ -1516,8 +1564,6 @@ export declare const compactionSemanticStateSchema: z.ZodReadonly<z.ZodEffects<z
 }>>;
 export type CompactionSemanticState = z.infer<typeof compactionSemanticStateSchema>;
 export type CompactionSemanticTextItem = CompactionSemanticState["decisions"][number];
-export type CompactionSemanticResource = CompactionSemanticState["resources"][number];
-export type CompactionSemanticRunningSession = CompactionSemanticState["runningSessions"][number];
 export declare const compactionSemanticReminderProjectionSchema: z.ZodReadonly<z.ZodObject<{
     version: z.ZodLiteral<1>;
     items: z.ZodArray<z.ZodReadonly<z.ZodObject<{
@@ -1602,130 +1648,342 @@ export declare const compactionSemanticReminderProjectionSchema: z.ZodReadonly<z
     }>;
 }>>;
 export type CompactionSemanticReminderProjection = z.infer<typeof compactionSemanticReminderProjectionSchema>;
-export interface CompactionSemanticResolution {
-    readonly targetItemId: CompactionSemanticItemId;
-    readonly targetCategory: "constraint" | "decision" | "pending_work" | "uncertainty";
-    readonly action: "cancel" | "supersede" | "clarify" | "revoke";
-    readonly reason: string;
-    readonly provenance: readonly CompactionProvenanceRef[];
-}
-export interface CompactionSemanticMessageEvidence {
-    readonly sequence: number;
-    readonly role?: string;
-    readonly summary: string;
-}
-export interface CompactionSemanticToolEvidence {
-    readonly id: string;
-    readonly agentName?: string;
-    readonly toolName?: string;
-    /** Bounded and redacted by the Harness before entering model context. */
-    readonly inputSummary?: string;
-    /** Bounded and redacted by the Harness before entering model context. */
-    readonly resultSummary?: string;
-    readonly outcome: {
-        readonly kind: string;
-        readonly executionState?: ToolCancellationExecutionState;
-    };
-}
-export interface CompactionSemanticResourceEvidence {
-    readonly key: string;
-    readonly mode?: string;
-}
-export interface CompactionSemanticRunningSessionEvidence {
-    readonly managerInstanceId: string;
-    readonly sessionId: number;
-    readonly state?: string;
-}
-export interface BuildCompactionSemanticEvidenceRegistryInput {
-    readonly messages: readonly CompactionSemanticMessageEvidence[];
-    readonly toolExecutions: readonly CompactionSemanticToolEvidence[];
-    readonly resources: readonly CompactionSemanticResourceEvidence[];
-    readonly runningSessions: readonly CompactionSemanticRunningSessionEvidence[];
-}
-export interface CompactionSemanticEvidenceRegistryEntry {
-    readonly evidenceId: string;
-    readonly summary: string;
-    readonly provenance: CompactionProvenanceRef;
-    readonly messageRole?: string;
-    readonly toolOutcomeKind?: string;
-    readonly toolCancellationExecutionState?: ToolCancellationExecutionState;
-}
-export type CompactionSemanticEvidenceRegistry = readonly CompactionSemanticEvidenceRegistryEntry[];
-export interface ValidateCompactionModelDraftInput {
-    readonly draft: unknown;
-    readonly evidenceRegistry: CompactionSemanticEvidenceRegistry;
-    readonly presentedEvidenceIds?: readonly string[];
-    readonly previousState?: CompactionSemanticState;
-    readonly harnessGoal?: {
-        readonly verbatimRequest: string;
-        readonly sourceSequence: number;
-    };
-}
-export interface MergeCompactionSemanticStateOptions {
-    /** Computed by the Harness from durable goal sourceSequence, never from model wording or IDs. */
-    readonly startsNewGoalScope: boolean;
-}
-export declare const COMPACTION_SEMANTIC_REJECTION_REASONS: readonly ["unknown_provenance", "missing_required_provenance", "completed_work_without_success_evidence", "resource_not_observed", "running_session_not_observed", "unknown_resolution_target", "resolution_target_category_mismatch", "invalid_resolution_action", "unsupported_source_quote", "unknown_evidence_review"];
-export interface CompactionSemanticRejection {
-    readonly category: "goal" | "constraint" | "decision" | "completed_work" | "pending_work" | "resource" | "running_session" | "uncertainty" | "resolution" | "evidence_review";
-    readonly index: number;
-    readonly reason: (typeof COMPACTION_SEMANTIC_REJECTION_REASONS)[number];
-}
-export interface ValidatedCompactionSemanticCandidate {
-    readonly state: CompactionSemanticState;
-    readonly resolutions: readonly CompactionSemanticResolution[];
-    readonly rejections: readonly CompactionSemanticRejection[];
-    readonly coveredEvidenceIds: readonly string[];
-    readonly startsNewGoalScope: boolean;
-}
-/** Builds opaque model-facing handles backed by exact Harness-owned facts. */
-export declare function buildCompactionSemanticEvidenceRegistry(input: BuildCompactionSemanticEvidenceRegistryInput): CompactionSemanticEvidenceRegistry;
-/** Renders opaque evidence handles in caller-provided priority order with a hard bound. */
-export declare function renderCompactionSemanticEvidenceRegistry(registry: CompactionSemanticEvidenceRegistry, maxChars?: number): string;
-export interface CompactionSemanticModelContext {
-    readonly prompt: string;
-    readonly includedEvidenceIds: readonly string[];
-}
-/** Returns both the bounded prompt and the exact evidence handles shown to the model. */
-export declare function buildCompactionSemanticModelContext(registry: CompactionSemanticEvidenceRegistry, previousState: CompactionSemanticState | undefined, maxChars?: number): CompactionSemanticModelContext;
-/** Includes prior stable IDs/text so the model can explicitly retain or resolve known items. */
-export declare function renderCompactionSemanticModelContext(registry: CompactionSemanticEvidenceRegistry, previousState: CompactionSemanticState | undefined, maxChars?: number): string;
-/** Only failures in a newly assembled candidate are eligible for draft recovery. */
-export declare class CompactionSemanticCandidateError extends Error {
-    constructor(message: string, options?: ErrorOptions);
-}
-type CompactionSemanticItem = CompactionSemanticTextItem | CompactionSemanticResource | CompactionSemanticRunningSession;
-/** Coalesce grounded candidates before limits/uniqueness checks, never persisted state. */
-export declare function normalizeCompactionSemanticItems<T extends CompactionSemanticItem>(items: readonly T[]): T[];
-/**
- * Validates a model-authored semantic candidate against Harness-owned evidence.
- * Invalid individual claims are rejected without turning the remaining grounded
- * candidate into an all-or-nothing failure.
- */
-export declare function validateCompactionModelDraft(input: ValidateCompactionModelDraftInput): ValidatedCompactionSemanticCandidate;
+export declare const semanticArchiveItemSchema: z.ZodObject<{
+    category: z.ZodEnum<["goal", "constraint", "decision", "completed_work", "pending_work", "resource", "running_session", "uncertainty"]>;
+    item: z.ZodUnion<[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"]>;
+            messageSequence: z.ZodNullable<z.ZodNumber>;
+            toolExecutionId: z.ZodNullable<z.ZodString>;
+            resourceKey: z.ZodNullable<z.ZodString>;
+            managerInstanceId: z.ZodNullable<z.ZodString>;
+            sessionId: z.ZodNullable<z.ZodNumber>;
+            checkpointId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            snapshotIndex: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        }, "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;
+            snapshotIndex: number | null;
+        }, {
+            kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+            sessionId: number | null;
+            messageSequence: number | null;
+            toolExecutionId: string | null;
+            resourceKey: string | null;
+            managerInstanceId: string | null;
+            checkpointId?: string | null | undefined;
+            snapshotIndex?: number | null | undefined;
+        }>, {
+            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;
+            snapshotIndex: number | null;
+        }, {
+            kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+            sessionId: number | null;
+            messageSequence: number | null;
+            toolExecutionId: string | null;
+            resourceKey: string | null;
+            managerInstanceId: string | null;
+            checkpointId?: string | null | undefined;
+            snapshotIndex?: number | null | undefined;
+        }>>, "many">;
+        sourceQuotes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        id: string & z.BRAND<"CompactionSemanticItemId">;
+        text: 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;
+            snapshotIndex: number | null;
+        }>[];
+        sourceQuotes: string[];
+        harnessKey?: string | undefined;
+        relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
+    }, {
+        id: string;
+        text: string;
+        provenance: Readonly<{
+            kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+            sessionId: number | null;
+            messageSequence: number | null;
+            toolExecutionId: string | null;
+            resourceKey: string | null;
+            managerInstanceId: string | null;
+            checkpointId?: string | null | undefined;
+            snapshotIndex?: number | null | undefined;
+        }>[];
+        harnessKey?: string | undefined;
+        relatedItemId?: string | undefined;
+        sourceQuotes?: string[] | undefined;
+    }>>, z.ZodReadonly<z.ZodObject<{
+        id: z.ZodBranded<z.ZodString, "CompactionSemanticItemId">;
+        resourceKey: z.ZodString;
+        provenance: z.ZodArray<z.ZodReadonly<z.ZodEffects<z.ZodObject<{
+            kind: z.ZodEnum<["message", "tool_execution", "resource", "running_session", "legacy_snapshot"]>;
+            messageSequence: z.ZodNullable<z.ZodNumber>;
+            toolExecutionId: z.ZodNullable<z.ZodString>;
+            resourceKey: z.ZodNullable<z.ZodString>;
+            managerInstanceId: z.ZodNullable<z.ZodString>;
+            sessionId: z.ZodNullable<z.ZodNumber>;
+            checkpointId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            snapshotIndex: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        }, "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;
+            snapshotIndex: number | null;
+        }, {
+            kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+            sessionId: number | null;
+            messageSequence: number | null;
+            toolExecutionId: string | null;
+            resourceKey: string | null;
+            managerInstanceId: string | null;
+            checkpointId?: string | null | undefined;
+            snapshotIndex?: number | null | undefined;
+        }>, {
+            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;
+            snapshotIndex: number | null;
+        }, {
+            kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+            sessionId: number | null;
+            messageSequence: number | null;
+            toolExecutionId: string | null;
+            resourceKey: string | null;
+            managerInstanceId: string | null;
+            checkpointId?: string | null | undefined;
+            snapshotIndex?: number | null | undefined;
+        }>>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        id: string & z.BRAND<"CompactionSemanticItemId">;
+        resourceKey: 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;
+            snapshotIndex: number | null;
+        }>[];
+    }, {
+        id: string;
+        resourceKey: string;
+        provenance: Readonly<{
+            kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+            sessionId: number | null;
+            messageSequence: number | null;
+            toolExecutionId: string | null;
+            resourceKey: string | null;
+            managerInstanceId: string | null;
+            checkpointId?: string | null | undefined;
+            snapshotIndex?: number | null | undefined;
+        }>[];
+    }>>, z.ZodReadonly<z.ZodObject<{
+        id: z.ZodBranded<z.ZodString, "CompactionSemanticItemId">;
+        managerInstanceId: z.ZodString;
+        sessionId: z.ZodNumber;
+        provenance: z.ZodArray<z.ZodReadonly<z.ZodEffects<z.ZodObject<{
+            kind: z.ZodEnum<["message", "tool_execution", "resource", "running_session", "legacy_snapshot"]>;
+            messageSequence: z.ZodNullable<z.ZodNumber>;
+            toolExecutionId: z.ZodNullable<z.ZodString>;
+            resourceKey: z.ZodNullable<z.ZodString>;
+            managerInstanceId: z.ZodNullable<z.ZodString>;
+            sessionId: z.ZodNullable<z.ZodNumber>;
+            checkpointId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            snapshotIndex: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        }, "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;
+            snapshotIndex: number | null;
+        }, {
+            kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+            sessionId: number | null;
+            messageSequence: number | null;
+            toolExecutionId: string | null;
+            resourceKey: string | null;
+            managerInstanceId: string | null;
+            checkpointId?: string | null | undefined;
+            snapshotIndex?: number | null | undefined;
+        }>, {
+            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;
+            snapshotIndex: number | null;
+        }, {
+            kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+            sessionId: number | null;
+            messageSequence: number | null;
+            toolExecutionId: string | null;
+            resourceKey: string | null;
+            managerInstanceId: string | null;
+            checkpointId?: string | null | undefined;
+            snapshotIndex?: number | null | undefined;
+        }>>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        id: string & z.BRAND<"CompactionSemanticItemId">;
+        sessionId: number;
+        managerInstanceId: 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;
+            snapshotIndex: number | null;
+        }>[];
+    }, {
+        id: string;
+        sessionId: number;
+        managerInstanceId: string;
+        provenance: Readonly<{
+            kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+            sessionId: number | null;
+            messageSequence: number | null;
+            toolExecutionId: string | null;
+            resourceKey: string | null;
+            managerInstanceId: string | null;
+            checkpointId?: string | null | undefined;
+            snapshotIndex?: number | null | undefined;
+        }>[];
+    }>>]>;
+}, "strict", z.ZodTypeAny, {
+    item: Readonly<{
+        id: string & z.BRAND<"CompactionSemanticItemId">;
+        text: 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;
+            snapshotIndex: number | null;
+        }>[];
+        sourceQuotes: string[];
+        harnessKey?: string | undefined;
+        relatedItemId?: (string & z.BRAND<"CompactionSemanticItemId">) | undefined;
+    }> | Readonly<{
+        id: string & z.BRAND<"CompactionSemanticItemId">;
+        resourceKey: 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;
+            snapshotIndex: number | null;
+        }>[];
+    }> | Readonly<{
+        id: string & z.BRAND<"CompactionSemanticItemId">;
+        sessionId: number;
+        managerInstanceId: 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;
+            snapshotIndex: number | null;
+        }>[];
+    }>;
+    category: "resource" | "decision" | "running_session" | "goal" | "constraint" | "completed_work" | "pending_work" | "uncertainty";
+}, {
+    item: Readonly<{
+        id: string;
+        text: string;
+        provenance: Readonly<{
+            kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+            sessionId: number | null;
+            messageSequence: number | null;
+            toolExecutionId: string | null;
+            resourceKey: string | null;
+            managerInstanceId: string | null;
+            checkpointId?: string | null | undefined;
+            snapshotIndex?: number | null | undefined;
+        }>[];
+        harnessKey?: string | undefined;
+        relatedItemId?: string | undefined;
+        sourceQuotes?: string[] | undefined;
+    }> | Readonly<{
+        id: string;
+        resourceKey: string;
+        provenance: Readonly<{
+            kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+            sessionId: number | null;
+            messageSequence: number | null;
+            toolExecutionId: string | null;
+            resourceKey: string | null;
+            managerInstanceId: string | null;
+            checkpointId?: string | null | undefined;
+            snapshotIndex?: number | null | undefined;
+        }>[];
+    }> | Readonly<{
+        id: string;
+        sessionId: number;
+        managerInstanceId: string;
+        provenance: Readonly<{
+            kind: "message" | "resource" | "legacy_snapshot" | "tool_execution" | "running_session";
+            sessionId: number | null;
+            messageSequence: number | null;
+            toolExecutionId: string | null;
+            resourceKey: string | null;
+            managerInstanceId: string | null;
+            checkpointId?: string | null | undefined;
+            snapshotIndex?: number | null | undefined;
+        }>[];
+    }>;
+    category: "resource" | "decision" | "running_session" | "goal" | "constraint" | "completed_work" | "pending_work" | "uncertainty";
+}>;
+export type SemanticArchiveItem = z.infer<typeof semanticArchiveItemSchema>;
+export declare function listSemanticArchiveItems(state: CompactionSemanticState): SemanticArchiveItem[];
 export declare function createEmptyCompactionSemanticState(): CompactionSemanticState;
-/** Seeds V1/top-level constraint evidence into the V2 semantic state without language heuristics. */
-export declare function seedCompactionSemanticConstraints(stateInput: CompactionSemanticState | undefined, constraints: readonly {
-    readonly quote: string;
-    readonly sourceSequence: number;
-}[]): CompactionSemanticState;
-export interface LegacyCompactionSnapshotMigrationResult {
-    readonly state: CompactionSemanticState;
-    /** Every migrated fragment must remain visible in the first V2 checkpoint reminder. */
-    readonly requiredItemIds: readonly CompactionSemanticItemId[];
-    /** Exact, redacted fragments that must be archived in transcript when V1 is retired. */
-    readonly transcriptFragments: LegacyCompactionTranscriptFragments;
-    /** False means at least one legacy snapshot chunk did not fit and its active prefix must stay. */
-    readonly complete: boolean;
-}
-/**
- * Migrates an old active snapshot into low-confidence V2 state. It may only become uncertainty:
- * legacy prose is not authoritative user intent or Tool completion evidence.
- */
-export declare function seedLegacyCompactionSnapshotUncertainties(stateInput: CompactionSemanticState, input: {
-    readonly checkpointId: string;
-    readonly fragments: readonly string[];
-}): LegacyCompactionSnapshotMigrationResult;
 /** Deterministic truncate mode replaces only the constraint slice from verbatim user evidence. */
 export declare function replaceCompactionSemanticConstraints(stateInput: CompactionSemanticState, constraints: readonly {
     readonly quote: string;
@@ -1736,17 +1994,9 @@ export declare function replaceCompactionSemanticGoal(stateInput: CompactionSema
     readonly verbatimRequest: string;
     readonly sourceSequence: number;
 } | undefined): CompactionSemanticState;
-/**
- * Carries grounded state forward. Empty candidate arrays do not erase history;
- * removal requires an evidence-grounded, category-specific explicit resolution.
- */
-export declare function mergeCompactionSemanticState(previousInput: CompactionSemanticState | undefined, candidateInput: ValidatedCompactionSemanticCandidate, options: MergeCompactionSemanticStateOptions): CompactionSemanticState;
 /**
  * Projects the durable semantic state into a bounded, structured prompt reminder.
  * The complete state remains in the checkpoint and can be recovered through the
  * transcript path; omitted counts make prompt truncation explicit to the model.
  */
 export declare function createCompactionSemanticReminderProjection(stateInput: CompactionSemanticState, maxChars?: number): CompactionSemanticReminderProjection;
-/** Renders a deterministic, bounded presentation derived only from grounded state. */
-export declare function renderCompactionSemanticSummary(stateInput: CompactionSemanticState, maxChars?: number): string;
-export {};