@code-yeongyu/senpi 0.74.0

package/dist/core/extensions/builtin/compaction/checkpoint-state.d.ts

@@ -0,0 +1,46 @@
+import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
+import type { ExtensionAPI, ExtensionContext } from "../../types.js";
+export interface AgentCheckpoint {
+    activeTools?: string[];
+    thinkingLevel?: ThinkingLevel | null;
+    modelId?: string | undefined;
+    agentName?: string | null;
+    timestamp?: number;
+    model?: {
+        provider: string;
+        modelId: string;
+    };
+}
+interface LegacyCaptureInput {
+    agentName?: string;
+    model?: {
+        provider: string;
+        modelId: string;
+    };
+    activeTools?: string[];
+}
+interface AppendEntryTarget {
+    appendEntry<T = unknown>(customType: string, data?: T): void;
+}
+interface LegacyCheckpointSource {
+    persistedCheckpoints?: AgentCheckpoint[];
+    appendCalls?: Array<{
+        customType: string;
+        data: unknown;
+    }>;
+}
+export declare function captureAgentCheckpoint(pi: ExtensionAPI, ctx: ExtensionContext): AgentCheckpoint;
+export declare function captureAgentCheckpoint(input: LegacyCaptureInput): AgentCheckpoint;
+export declare function persistCheckpoint(pi: ExtensionAPI, checkpoint: AgentCheckpoint): void;
+export declare function persistCheckpoint(checkpoint: AgentCheckpoint, pi: AppendEntryTarget): void;
+export declare function getLatestCheckpoint(ctx: ExtensionContext): AgentCheckpoint | null;
+export declare function getLatestCheckpoint(source: LegacyCheckpointSource): AgentCheckpoint | undefined;
+export declare function injectRestorationDirective(systemPrompt: string, checkpoint: AgentCheckpoint): string;
+export declare function injectRestorationDirective(checkpoint?: AgentCheckpoint, fallback?: {
+    model?: {
+        provider: string;
+        modelId: string;
+    };
+}): string;
+export {};
+//# sourceMappingURL=checkpoint-state.d.ts.map

package/dist/core/extensions/builtin/compaction/checkpoint-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-state.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/checkpoint-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAMrE,MAAM,WAAW,eAAe;IAC/B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;CACF;AAOD,UAAU,kBAAkB;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,UAAU,iBAAiB;IAC1B,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;CAC7D;AAED,UAAU,sBAAsB;IAC/B,oBAAoB,CAAC,EAAE,eAAe,EAAE,CAAC;IACzC,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC3D;AA2DD,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,gBAAgB,GAAG,eAAe,CAAC;AACjG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,eAAe,CAAC;AA2BnF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;AACvF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAAC;AAe5F,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,eAAe,GAAG,IAAI,CAAC;AACnF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,GAAG,eAAe,GAAG,SAAS,CAAC;AAwCjG,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,MAAM,CAAC;AACtG,wBAAgB,0BAA0B,CACzC,UAAU,CAAC,EAAE,eAAe,EAC5B,QAAQ,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC1D,MAAM,CAAC","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { ExtensionAPI, ExtensionContext } from \"../../types.js\";\n\nconst CHECKPOINT_CUSTOM_TYPE = \"compaction.agent-checkpoint\";\nconst CHECKPOINT_SCHEMA = \"senpi.compaction.agent-checkpoint.v1\";\nconst RESTORATION_DIRECTIVE = \"[restore checkpointed session agent configuration after compaction]\";\n\nexport interface AgentCheckpoint {\n\tactiveTools?: string[];\n\tthinkingLevel?: ThinkingLevel | null;\n\tmodelId?: string | undefined;\n\tagentName?: string | null;\n\ttimestamp?: number;\n\tmodel?: {\n\t\tprovider: string;\n\t\tmodelId: string;\n\t};\n}\n\ninterface PersistedCheckpointPayload {\n\tschema: typeof CHECKPOINT_SCHEMA;\n\tdata: AgentCheckpoint;\n}\n\ninterface LegacyCaptureInput {\n\tagentName?: string;\n\tmodel?: {\n\t\tprovider: string;\n\t\tmodelId: string;\n\t};\n\tactiveTools?: string[];\n}\n\ninterface AppendEntryTarget {\n\tappendEntry<T = unknown>(customType: string, data?: T): void;\n}\n\ninterface LegacyCheckpointSource {\n\tpersistedCheckpoints?: AgentCheckpoint[];\n\tappendCalls?: Array<{ customType: string; data: unknown }>;\n}\n\nfunction isExtensionAPI(value: ExtensionAPI | LegacyCaptureInput): value is ExtensionAPI {\n\treturn \"getActiveTools\" in value && \"getThinkingLevel\" in value;\n}\n\nfunction deriveAgentName(ctx: ExtensionContext): string | null {\n\tfor (let index = ctx.sessionManager.getEntries().length - 1; index >= 0; index--) {\n\t\tconst entry = ctx.sessionManager.getEntries()[index];\n\t\tif (entry.type !== \"custom\") continue;\n\t\tconst data = entry.data;\n\t\tif (isRecord(data) && typeof data.agentName === \"string\") {\n\t\t\treturn data.agentName;\n\t\t}\n\t\tif (isRecord(data) && typeof data.agent === \"string\") {\n\t\t\treturn data.agent;\n\t\t}\n\t}\n\treturn null;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction parseCheckpoint(value: unknown): AgentCheckpoint | null {\n\tif (!isRecord(value)) return null;\n\tif (value.schema === CHECKPOINT_SCHEMA && isRecord(value.data)) {\n\t\treturn parseCheckpoint(value.data);\n\t}\n\n\tconst activeTools = Array.isArray(value.activeTools)\n\t\t? value.activeTools.filter((tool): tool is string => typeof tool === \"string\")\n\t\t: [];\n\tconst model = isRecord(value.model)\n\t\t? {\n\t\t\t\tprovider: typeof value.model.provider === \"string\" ? value.model.provider : \"\",\n\t\t\t\tmodelId: typeof value.model.modelId === \"string\" ? value.model.modelId : \"\",\n\t\t\t}\n\t\t: undefined;\n\n\treturn {\n\t\tactiveTools,\n\t\tthinkingLevel: typeof value.thinkingLevel === \"string\" ? (value.thinkingLevel as ThinkingLevel) : null,\n\t\tmodelId: typeof value.modelId === \"string\" ? value.modelId : model?.modelId,\n\t\tagentName: typeof value.agentName === \"string\" ? value.agentName : null,\n\t\ttimestamp: typeof value.timestamp === \"number\" ? value.timestamp : undefined,\n\t\tmodel,\n\t};\n}\n\nfunction serializeCheckpoint(checkpoint: AgentCheckpoint): PersistedCheckpointPayload & AgentCheckpoint {\n\treturn {\n\t\t...checkpoint,\n\t\tschema: CHECKPOINT_SCHEMA,\n\t\tdata: checkpoint,\n\t};\n}\n\nexport function captureAgentCheckpoint(pi: ExtensionAPI, ctx: ExtensionContext): AgentCheckpoint;\nexport function captureAgentCheckpoint(input: LegacyCaptureInput): AgentCheckpoint;\nexport function captureAgentCheckpoint(\n\tpiOrInput: ExtensionAPI | LegacyCaptureInput,\n\tctx?: ExtensionContext,\n): AgentCheckpoint {\n\tif (isExtensionAPI(piOrInput) && ctx) {\n\t\treturn {\n\t\t\tactiveTools: piOrInput.getActiveTools(),\n\t\t\tthinkingLevel: piOrInput.getThinkingLevel(),\n\t\t\tmodelId: ctx.model?.id,\n\t\t\tagentName: deriveAgentName(ctx),\n\t\t\ttimestamp: Date.now(),\n\t\t\tmodel: ctx.model ? { provider: ctx.model.provider, modelId: ctx.model.id } : undefined,\n\t\t};\n\t}\n\n\tconst input = piOrInput as LegacyCaptureInput;\n\treturn {\n\t\tactiveTools: input.activeTools ?? [],\n\t\tthinkingLevel: null,\n\t\tmodelId: input.model?.modelId,\n\t\tagentName: input.agentName ?? null,\n\t\ttimestamp: Date.now(),\n\t\tmodel: input.model,\n\t};\n}\n\nexport function persistCheckpoint(pi: ExtensionAPI, checkpoint: AgentCheckpoint): void;\nexport function persistCheckpoint(checkpoint: AgentCheckpoint, pi: AppendEntryTarget): void;\nexport function persistCheckpoint(\n\tpiOrCheckpoint: ExtensionAPI | AgentCheckpoint,\n\tcheckpointOrPi: AgentCheckpoint | AppendEntryTarget,\n): void {\n\tif (\"appendEntry\" in piOrCheckpoint) {\n\t\tconst checkpoint = checkpointOrPi as AgentCheckpoint;\n\t\tpiOrCheckpoint.appendEntry(CHECKPOINT_CUSTOM_TYPE, serializeCheckpoint(checkpoint));\n\t\treturn;\n\t}\n\n\tconst pi = checkpointOrPi as AppendEntryTarget;\n\tpi.appendEntry(CHECKPOINT_CUSTOM_TYPE, serializeCheckpoint(piOrCheckpoint));\n}\n\nexport function getLatestCheckpoint(ctx: ExtensionContext): AgentCheckpoint | null;\nexport function getLatestCheckpoint(source: LegacyCheckpointSource): AgentCheckpoint | undefined;\nexport function getLatestCheckpoint(\n\tsource: ExtensionContext | LegacyCheckpointSource,\n): AgentCheckpoint | null | undefined {\n\tif (\"sessionManager\" in source) {\n\t\tconst entries = source.sessionManager.getEntries();\n\t\tfor (let index = entries.length - 1; index >= 0; index--) {\n\t\t\tconst entry = entries[index];\n\t\t\tif (entry.type !== \"custom\" || entry.customType !== CHECKPOINT_CUSTOM_TYPE) continue;\n\t\t\tconst checkpoint = parseCheckpoint(entry.data);\n\t\t\tif (checkpoint) return checkpoint;\n\t\t}\n\t\treturn null;\n\t}\n\n\tconst checkpoints = source.persistedCheckpoints ?? [];\n\tif (checkpoints.length > 0) {\n\t\treturn [...checkpoints].sort((left, right) => (right.timestamp ?? 0) - (left.timestamp ?? 0))[0];\n\t}\n\n\tconst appended = source.appendCalls\n\t\t?.filter((call) => call.customType === CHECKPOINT_CUSTOM_TYPE)\n\t\t.map((call) => parseCheckpoint(call.data))\n\t\t.filter((checkpoint): checkpoint is AgentCheckpoint => checkpoint !== null);\n\treturn appended?.sort((left, right) => (right.timestamp ?? 0) - (left.timestamp ?? 0))[0];\n}\n\nfunction buildRestorationHints(checkpoint: AgentCheckpoint): string {\n\tconst modelId = checkpoint.modelId ?? checkpoint.model?.modelId;\n\tconst lines = [\n\t\tRESTORATION_DIRECTIVE,\n\t\t\"\",\n\t\t\"Restore checkpointed session configuration:\",\n\t\t`- Agent: ${checkpoint.agentName ?? \"unknown\"}`,\n\t\t`- Tools: ${checkpoint.activeTools && checkpoint.activeTools.length > 0 ? checkpoint.activeTools.join(\", \") : \"none\"}`,\n\t\t`- Model: ${modelId ?? \"unknown\"}`,\n\t];\n\treturn lines.join(\"\\n\");\n}\n\nexport function injectRestorationDirective(systemPrompt: string, checkpoint: AgentCheckpoint): string;\nexport function injectRestorationDirective(\n\tcheckpoint?: AgentCheckpoint,\n\tfallback?: { model?: { provider: string; modelId: string } },\n): string;\nexport function injectRestorationDirective(\n\tsystemPromptOrCheckpoint?: string | AgentCheckpoint,\n\tcheckpointOrFallback?: AgentCheckpoint | { model?: { provider: string; modelId: string } },\n): string {\n\tif (typeof systemPromptOrCheckpoint === \"string\") {\n\t\tconst checkpoint = checkpointOrFallback as AgentCheckpoint;\n\t\treturn `${systemPromptOrCheckpoint}\\n\\n${buildRestorationHints(checkpoint)}`;\n\t}\n\n\tif (checkpointOrFallback && \"model\" in checkpointOrFallback && checkpointOrFallback.model) {\n\t\treturn `${RESTORATION_DIRECTIVE}\\nModel: ${checkpointOrFallback.model.modelId}`;\n\t}\n\n\treturn RESTORATION_DIRECTIVE;\n}\n"]}

package/dist/core/extensions/builtin/compaction/checkpoint-state.js

@@ -0,0 +1,131 @@
+const CHECKPOINT_CUSTOM_TYPE = "compaction.agent-checkpoint";
+const CHECKPOINT_SCHEMA = "senpi.compaction.agent-checkpoint.v1";
+const RESTORATION_DIRECTIVE = "[restore checkpointed session agent configuration after compaction]";
+function isExtensionAPI(value) {
+    return "getActiveTools" in value && "getThinkingLevel" in value;
+}
+function deriveAgentName(ctx) {
+    for (let index = ctx.sessionManager.getEntries().length - 1; index >= 0; index--) {
+        const entry = ctx.sessionManager.getEntries()[index];
+        if (entry.type !== "custom")
+            continue;
+        const data = entry.data;
+        if (isRecord(data) && typeof data.agentName === "string") {
+            return data.agentName;
+        }
+        if (isRecord(data) && typeof data.agent === "string") {
+            return data.agent;
+        }
+    }
+    return null;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function parseCheckpoint(value) {
+    if (!isRecord(value))
+        return null;
+    if (value.schema === CHECKPOINT_SCHEMA && isRecord(value.data)) {
+        return parseCheckpoint(value.data);
+    }
+    const activeTools = Array.isArray(value.activeTools)
+        ? value.activeTools.filter((tool) => typeof tool === "string")
+        : [];
+    const model = isRecord(value.model)
+        ? {
+            provider: typeof value.model.provider === "string" ? value.model.provider : "",
+            modelId: typeof value.model.modelId === "string" ? value.model.modelId : "",
+        }
+        : undefined;
+    return {
+        activeTools,
+        thinkingLevel: typeof value.thinkingLevel === "string" ? value.thinkingLevel : null,
+        modelId: typeof value.modelId === "string" ? value.modelId : model?.modelId,
+        agentName: typeof value.agentName === "string" ? value.agentName : null,
+        timestamp: typeof value.timestamp === "number" ? value.timestamp : undefined,
+        model,
+    };
+}
+function serializeCheckpoint(checkpoint) {
+    return {
+        ...checkpoint,
+        schema: CHECKPOINT_SCHEMA,
+        data: checkpoint,
+    };
+}
+export function captureAgentCheckpoint(piOrInput, ctx) {
+    if (isExtensionAPI(piOrInput) && ctx) {
+        return {
+            activeTools: piOrInput.getActiveTools(),
+            thinkingLevel: piOrInput.getThinkingLevel(),
+            modelId: ctx.model?.id,
+            agentName: deriveAgentName(ctx),
+            timestamp: Date.now(),
+            model: ctx.model ? { provider: ctx.model.provider, modelId: ctx.model.id } : undefined,
+        };
+    }
+    const input = piOrInput;
+    return {
+        activeTools: input.activeTools ?? [],
+        thinkingLevel: null,
+        modelId: input.model?.modelId,
+        agentName: input.agentName ?? null,
+        timestamp: Date.now(),
+        model: input.model,
+    };
+}
+export function persistCheckpoint(piOrCheckpoint, checkpointOrPi) {
+    if ("appendEntry" in piOrCheckpoint) {
+        const checkpoint = checkpointOrPi;
+        piOrCheckpoint.appendEntry(CHECKPOINT_CUSTOM_TYPE, serializeCheckpoint(checkpoint));
+        return;
+    }
+    const pi = checkpointOrPi;
+    pi.appendEntry(CHECKPOINT_CUSTOM_TYPE, serializeCheckpoint(piOrCheckpoint));
+}
+export function getLatestCheckpoint(source) {
+    if ("sessionManager" in source) {
+        const entries = source.sessionManager.getEntries();
+        for (let index = entries.length - 1; index >= 0; index--) {
+            const entry = entries[index];
+            if (entry.type !== "custom" || entry.customType !== CHECKPOINT_CUSTOM_TYPE)
+                continue;
+            const checkpoint = parseCheckpoint(entry.data);
+            if (checkpoint)
+                return checkpoint;
+        }
+        return null;
+    }
+    const checkpoints = source.persistedCheckpoints ?? [];
+    if (checkpoints.length > 0) {
+        return [...checkpoints].sort((left, right) => (right.timestamp ?? 0) - (left.timestamp ?? 0))[0];
+    }
+    const appended = source.appendCalls
+        ?.filter((call) => call.customType === CHECKPOINT_CUSTOM_TYPE)
+        .map((call) => parseCheckpoint(call.data))
+        .filter((checkpoint) => checkpoint !== null);
+    return appended?.sort((left, right) => (right.timestamp ?? 0) - (left.timestamp ?? 0))[0];
+}
+function buildRestorationHints(checkpoint) {
+    const modelId = checkpoint.modelId ?? checkpoint.model?.modelId;
+    const lines = [
+        RESTORATION_DIRECTIVE,
+        "",
+        "Restore checkpointed session configuration:",
+        `- Agent: ${checkpoint.agentName ?? "unknown"}`,
+        `- Tools: ${checkpoint.activeTools && checkpoint.activeTools.length > 0 ? checkpoint.activeTools.join(", ") : "none"}`,
+        `- Model: ${modelId ?? "unknown"}`,
+    ];
+    return lines.join("\n");
+}
+export function injectRestorationDirective(systemPromptOrCheckpoint, checkpointOrFallback) {
+    if (typeof systemPromptOrCheckpoint === "string") {
+        const checkpoint = checkpointOrFallback;
+        return `${systemPromptOrCheckpoint}\n\n${buildRestorationHints(checkpoint)}`;
+    }
+    if (checkpointOrFallback && "model" in checkpointOrFallback && checkpointOrFallback.model) {
+        return `${RESTORATION_DIRECTIVE}\nModel: ${checkpointOrFallback.model.modelId}`;
+    }
+    return RESTORATION_DIRECTIVE;
+}
+//# sourceMappingURL=checkpoint-state.js.map

package/dist/core/extensions/builtin/compaction/checkpoint-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-state.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/checkpoint-state.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { ExtensionAPI, ExtensionContext } from \"../../types.js\";\n\nconst CHECKPOINT_CUSTOM_TYPE = \"compaction.agent-checkpoint\";\nconst CHECKPOINT_SCHEMA = \"senpi.compaction.agent-checkpoint.v1\";\nconst RESTORATION_DIRECTIVE = \"[restore checkpointed session agent configuration after compaction]\";\n\nexport interface AgentCheckpoint {\n\tactiveTools?: string[];\n\tthinkingLevel?: ThinkingLevel | null;\n\tmodelId?: string | undefined;\n\tagentName?: string | null;\n\ttimestamp?: number;\n\tmodel?: {\n\t\tprovider: string;\n\t\tmodelId: string;\n\t};\n}\n\ninterface PersistedCheckpointPayload {\n\tschema: typeof CHECKPOINT_SCHEMA;\n\tdata: AgentCheckpoint;\n}\n\ninterface LegacyCaptureInput {\n\tagentName?: string;\n\tmodel?: {\n\t\tprovider: string;\n\t\tmodelId: string;\n\t};\n\tactiveTools?: string[];\n}\n\ninterface AppendEntryTarget {\n\tappendEntry<T = unknown>(customType: string, data?: T): void;\n}\n\ninterface LegacyCheckpointSource {\n\tpersistedCheckpoints?: AgentCheckpoint[];\n\tappendCalls?: Array<{ customType: string; data: unknown }>;\n}\n\nfunction isExtensionAPI(value: ExtensionAPI | LegacyCaptureInput): value is ExtensionAPI {\n\treturn \"getActiveTools\" in value && \"getThinkingLevel\" in value;\n}\n\nfunction deriveAgentName(ctx: ExtensionContext): string | null {\n\tfor (let index = ctx.sessionManager.getEntries().length - 1; index >= 0; index--) {\n\t\tconst entry = ctx.sessionManager.getEntries()[index];\n\t\tif (entry.type !== \"custom\") continue;\n\t\tconst data = entry.data;\n\t\tif (isRecord(data) && typeof data.agentName === \"string\") {\n\t\t\treturn data.agentName;\n\t\t}\n\t\tif (isRecord(data) && typeof data.agent === \"string\") {\n\t\t\treturn data.agent;\n\t\t}\n\t}\n\treturn null;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction parseCheckpoint(value: unknown): AgentCheckpoint | null {\n\tif (!isRecord(value)) return null;\n\tif (value.schema === CHECKPOINT_SCHEMA && isRecord(value.data)) {\n\t\treturn parseCheckpoint(value.data);\n\t}\n\n\tconst activeTools = Array.isArray(value.activeTools)\n\t\t? value.activeTools.filter((tool): tool is string => typeof tool === \"string\")\n\t\t: [];\n\tconst model = isRecord(value.model)\n\t\t? {\n\t\t\t\tprovider: typeof value.model.provider === \"string\" ? value.model.provider : \"\",\n\t\t\t\tmodelId: typeof value.model.modelId === \"string\" ? value.model.modelId : \"\",\n\t\t\t}\n\t\t: undefined;\n\n\treturn {\n\t\tactiveTools,\n\t\tthinkingLevel: typeof value.thinkingLevel === \"string\" ? (value.thinkingLevel as ThinkingLevel) : null,\n\t\tmodelId: typeof value.modelId === \"string\" ? value.modelId : model?.modelId,\n\t\tagentName: typeof value.agentName === \"string\" ? value.agentName : null,\n\t\ttimestamp: typeof value.timestamp === \"number\" ? value.timestamp : undefined,\n\t\tmodel,\n\t};\n}\n\nfunction serializeCheckpoint(checkpoint: AgentCheckpoint): PersistedCheckpointPayload & AgentCheckpoint {\n\treturn {\n\t\t...checkpoint,\n\t\tschema: CHECKPOINT_SCHEMA,\n\t\tdata: checkpoint,\n\t};\n}\n\nexport function captureAgentCheckpoint(pi: ExtensionAPI, ctx: ExtensionContext): AgentCheckpoint;\nexport function captureAgentCheckpoint(input: LegacyCaptureInput): AgentCheckpoint;\nexport function captureAgentCheckpoint(\n\tpiOrInput: ExtensionAPI | LegacyCaptureInput,\n\tctx?: ExtensionContext,\n): AgentCheckpoint {\n\tif (isExtensionAPI(piOrInput) && ctx) {\n\t\treturn {\n\t\t\tactiveTools: piOrInput.getActiveTools(),\n\t\t\tthinkingLevel: piOrInput.getThinkingLevel(),\n\t\t\tmodelId: ctx.model?.id,\n\t\t\tagentName: deriveAgentName(ctx),\n\t\t\ttimestamp: Date.now(),\n\t\t\tmodel: ctx.model ? { provider: ctx.model.provider, modelId: ctx.model.id } : undefined,\n\t\t};\n\t}\n\n\tconst input = piOrInput as LegacyCaptureInput;\n\treturn {\n\t\tactiveTools: input.activeTools ?? [],\n\t\tthinkingLevel: null,\n\t\tmodelId: input.model?.modelId,\n\t\tagentName: input.agentName ?? null,\n\t\ttimestamp: Date.now(),\n\t\tmodel: input.model,\n\t};\n}\n\nexport function persistCheckpoint(pi: ExtensionAPI, checkpoint: AgentCheckpoint): void;\nexport function persistCheckpoint(checkpoint: AgentCheckpoint, pi: AppendEntryTarget): void;\nexport function persistCheckpoint(\n\tpiOrCheckpoint: ExtensionAPI | AgentCheckpoint,\n\tcheckpointOrPi: AgentCheckpoint | AppendEntryTarget,\n): void {\n\tif (\"appendEntry\" in piOrCheckpoint) {\n\t\tconst checkpoint = checkpointOrPi as AgentCheckpoint;\n\t\tpiOrCheckpoint.appendEntry(CHECKPOINT_CUSTOM_TYPE, serializeCheckpoint(checkpoint));\n\t\treturn;\n\t}\n\n\tconst pi = checkpointOrPi as AppendEntryTarget;\n\tpi.appendEntry(CHECKPOINT_CUSTOM_TYPE, serializeCheckpoint(piOrCheckpoint));\n}\n\nexport function getLatestCheckpoint(ctx: ExtensionContext): AgentCheckpoint | null;\nexport function getLatestCheckpoint(source: LegacyCheckpointSource): AgentCheckpoint | undefined;\nexport function getLatestCheckpoint(\n\tsource: ExtensionContext | LegacyCheckpointSource,\n): AgentCheckpoint | null | undefined {\n\tif (\"sessionManager\" in source) {\n\t\tconst entries = source.sessionManager.getEntries();\n\t\tfor (let index = entries.length - 1; index >= 0; index--) {\n\t\t\tconst entry = entries[index];\n\t\t\tif (entry.type !== \"custom\" || entry.customType !== CHECKPOINT_CUSTOM_TYPE) continue;\n\t\t\tconst checkpoint = parseCheckpoint(entry.data);\n\t\t\tif (checkpoint) return checkpoint;\n\t\t}\n\t\treturn null;\n\t}\n\n\tconst checkpoints = source.persistedCheckpoints ?? [];\n\tif (checkpoints.length > 0) {\n\t\treturn [...checkpoints].sort((left, right) => (right.timestamp ?? 0) - (left.timestamp ?? 0))[0];\n\t}\n\n\tconst appended = source.appendCalls\n\t\t?.filter((call) => call.customType === CHECKPOINT_CUSTOM_TYPE)\n\t\t.map((call) => parseCheckpoint(call.data))\n\t\t.filter((checkpoint): checkpoint is AgentCheckpoint => checkpoint !== null);\n\treturn appended?.sort((left, right) => (right.timestamp ?? 0) - (left.timestamp ?? 0))[0];\n}\n\nfunction buildRestorationHints(checkpoint: AgentCheckpoint): string {\n\tconst modelId = checkpoint.modelId ?? checkpoint.model?.modelId;\n\tconst lines = [\n\t\tRESTORATION_DIRECTIVE,\n\t\t\"\",\n\t\t\"Restore checkpointed session configuration:\",\n\t\t`- Agent: ${checkpoint.agentName ?? \"unknown\"}`,\n\t\t`- Tools: ${checkpoint.activeTools && checkpoint.activeTools.length > 0 ? checkpoint.activeTools.join(\", \") : \"none\"}`,\n\t\t`- Model: ${modelId ?? \"unknown\"}`,\n\t];\n\treturn lines.join(\"\\n\");\n}\n\nexport function injectRestorationDirective(systemPrompt: string, checkpoint: AgentCheckpoint): string;\nexport function injectRestorationDirective(\n\tcheckpoint?: AgentCheckpoint,\n\tfallback?: { model?: { provider: string; modelId: string } },\n): string;\nexport function injectRestorationDirective(\n\tsystemPromptOrCheckpoint?: string | AgentCheckpoint,\n\tcheckpointOrFallback?: AgentCheckpoint | { model?: { provider: string; modelId: string } },\n): string {\n\tif (typeof systemPromptOrCheckpoint === \"string\") {\n\t\tconst checkpoint = checkpointOrFallback as AgentCheckpoint;\n\t\treturn `${systemPromptOrCheckpoint}\\n\\n${buildRestorationHints(checkpoint)}`;\n\t}\n\n\tif (checkpointOrFallback && \"model\" in checkpointOrFallback && checkpointOrFallback.model) {\n\t\treturn `${RESTORATION_DIRECTIVE}\\nModel: ${checkpointOrFallback.model.modelId}`;\n\t}\n\n\treturn RESTORATION_DIRECTIVE;\n}\n"]}

package/dist/core/extensions/builtin/compaction/circuit-breaker.d.ts

@@ -0,0 +1,23 @@
+import type { CompactionReason } from "../../types.js";
+import type { CompactionExtensionState } from "./state.js";
+export declare const FAILURE_TRIP_THRESHOLD = 3;
+export declare const COOLDOWN_MS = 60000;
+export interface BreakerNotification {
+    tripped: true;
+    failureCount: number;
+    trippedAt: number;
+    reason: CompactionReason | "threshold";
+}
+export interface RecordFailureOptions {
+    onTrip?: (notification: BreakerNotification) => void;
+    route?: CompactionReason;
+}
+export interface ShouldBypassOptions {
+    manual?: boolean;
+    reason?: CompactionReason;
+}
+export declare function recordSuccess(state: CompactionExtensionState): CompactionExtensionState;
+export declare function recordFailure(state: CompactionExtensionState, now: number, opts?: RecordFailureOptions): CompactionExtensionState;
+export declare function isTripped(state: CompactionExtensionState, now: number): boolean;
+export declare function shouldBypass(_state: CompactionExtensionState, opts?: ShouldBypassOptions): boolean;
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/core/extensions/builtin/compaction/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/circuit-breaker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,WAAW,QAAS,CAAC;AAElC,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,IAAI,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB;IACpC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACrD,KAAK,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,wBAAwB,GAAG,wBAAwB,CAEvF;AAED,wBAAgB,aAAa,CAC5B,KAAK,EAAE,wBAAwB,EAC/B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,oBAAoB,GACzB,wBAAwB,CAmB1B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,wBAAwB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/E;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,wBAAwB,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAIlG","sourcesContent":["import type { CompactionReason } from \"../../types.js\";\nimport type { CompactionExtensionState } from \"./state.js\";\n\nexport const FAILURE_TRIP_THRESHOLD = 3;\nexport const COOLDOWN_MS = 60_000;\n\nexport interface BreakerNotification {\n\ttripped: true;\n\tfailureCount: number;\n\ttrippedAt: number;\n\treason: CompactionReason | \"threshold\";\n}\n\nexport interface RecordFailureOptions {\n\tonTrip?: (notification: BreakerNotification) => void;\n\troute?: CompactionReason;\n}\n\nexport interface ShouldBypassOptions {\n\tmanual?: boolean;\n\treason?: CompactionReason;\n}\n\nexport function recordSuccess(state: CompactionExtensionState): CompactionExtensionState {\n\treturn { ...state, consecutiveFailures: 0, trippedAt: null };\n}\n\nexport function recordFailure(\n\tstate: CompactionExtensionState,\n\tnow: number,\n\topts?: RecordFailureOptions,\n): CompactionExtensionState {\n\tlet working = state;\n\tif (working.trippedAt !== null && now >= working.trippedAt + COOLDOWN_MS) {\n\t\tworking = { ...working, consecutiveFailures: 0, trippedAt: null };\n\t}\n\tconst next: CompactionExtensionState = {\n\t\t...working,\n\t\tconsecutiveFailures: working.consecutiveFailures + 1,\n\t};\n\tif (next.consecutiveFailures >= FAILURE_TRIP_THRESHOLD && next.trippedAt === null) {\n\t\tnext.trippedAt = now;\n\t\topts?.onTrip?.({\n\t\t\ttripped: true,\n\t\t\tfailureCount: next.consecutiveFailures,\n\t\t\ttrippedAt: now,\n\t\t\treason: opts.route ?? \"threshold\",\n\t\t});\n\t}\n\treturn next;\n}\n\nexport function isTripped(state: CompactionExtensionState, now: number): boolean {\n\treturn state.trippedAt !== null && now < state.trippedAt + COOLDOWN_MS;\n}\n\nexport function shouldBypass(_state: CompactionExtensionState, opts?: ShouldBypassOptions): boolean {\n\tif (opts?.manual === true) return true;\n\tif (opts?.reason === \"manual\") return true;\n\treturn false;\n}\n"]}

package/dist/core/extensions/builtin/compaction/circuit-breaker.js

@@ -0,0 +1,36 @@
+export const FAILURE_TRIP_THRESHOLD = 3;
+export const COOLDOWN_MS = 60_000;
+export function recordSuccess(state) {
+    return { ...state, consecutiveFailures: 0, trippedAt: null };
+}
+export function recordFailure(state, now, opts) {
+    let working = state;
+    if (working.trippedAt !== null && now >= working.trippedAt + COOLDOWN_MS) {
+        working = { ...working, consecutiveFailures: 0, trippedAt: null };
+    }
+    const next = {
+        ...working,
+        consecutiveFailures: working.consecutiveFailures + 1,
+    };
+    if (next.consecutiveFailures >= FAILURE_TRIP_THRESHOLD && next.trippedAt === null) {
+        next.trippedAt = now;
+        opts?.onTrip?.({
+            tripped: true,
+            failureCount: next.consecutiveFailures,
+            trippedAt: now,
+            reason: opts.route ?? "threshold",
+        });
+    }
+    return next;
+}
+export function isTripped(state, now) {
+    return state.trippedAt !== null && now < state.trippedAt + COOLDOWN_MS;
+}
+export function shouldBypass(_state, opts) {
+    if (opts?.manual === true)
+        return true;
+    if (opts?.reason === "manual")
+        return true;
+    return false;
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/core/extensions/builtin/compaction/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/circuit-breaker.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAmBlC,MAAM,UAAU,aAAa,CAAC,KAA+B,EAA4B;IACxF,OAAO,EAAE,GAAG,KAAK,EAAE,mBAAmB,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAAA,CAC7D;AAED,MAAM,UAAU,aAAa,CAC5B,KAA+B,EAC/B,GAAW,EACX,IAA2B,EACA;IAC3B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,CAAC,SAAS,GAAG,WAAW,EAAE,CAAC;QAC1E,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,mBAAmB,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACnE,CAAC;IACD,MAAM,IAAI,GAA6B;QACtC,GAAG,OAAO;QACV,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,GAAG,CAAC;KACpD,CAAC;IACF,IAAI,IAAI,CAAC,mBAAmB,IAAI,sBAAsB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QACnF,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACrB,IAAI,EAAE,MAAM,EAAE,CAAC;YACd,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,IAAI,CAAC,mBAAmB;YACtC,SAAS,EAAE,GAAG;YACd,MAAM,EAAE,IAAI,CAAC,KAAK,IAAI,WAAW;SACjC,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AAAA,CACZ;AAED,MAAM,UAAU,SAAS,CAAC,KAA+B,EAAE,GAAW,EAAW;IAChF,OAAO,KAAK,CAAC,SAAS,KAAK,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,WAAW,CAAC;AAAA,CACvE;AAED,MAAM,UAAU,YAAY,CAAC,MAAgC,EAAE,IAA0B,EAAW;IACnG,IAAI,IAAI,EAAE,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,IAAI,EAAE,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,KAAK,CAAC;AAAA,CACb","sourcesContent":["import type { CompactionReason } from \"../../types.js\";\nimport type { CompactionExtensionState } from \"./state.js\";\n\nexport const FAILURE_TRIP_THRESHOLD = 3;\nexport const COOLDOWN_MS = 60_000;\n\nexport interface BreakerNotification {\n\ttripped: true;\n\tfailureCount: number;\n\ttrippedAt: number;\n\treason: CompactionReason | \"threshold\";\n}\n\nexport interface RecordFailureOptions {\n\tonTrip?: (notification: BreakerNotification) => void;\n\troute?: CompactionReason;\n}\n\nexport interface ShouldBypassOptions {\n\tmanual?: boolean;\n\treason?: CompactionReason;\n}\n\nexport function recordSuccess(state: CompactionExtensionState): CompactionExtensionState {\n\treturn { ...state, consecutiveFailures: 0, trippedAt: null };\n}\n\nexport function recordFailure(\n\tstate: CompactionExtensionState,\n\tnow: number,\n\topts?: RecordFailureOptions,\n): CompactionExtensionState {\n\tlet working = state;\n\tif (working.trippedAt !== null && now >= working.trippedAt + COOLDOWN_MS) {\n\t\tworking = { ...working, consecutiveFailures: 0, trippedAt: null };\n\t}\n\tconst next: CompactionExtensionState = {\n\t\t...working,\n\t\tconsecutiveFailures: working.consecutiveFailures + 1,\n\t};\n\tif (next.consecutiveFailures >= FAILURE_TRIP_THRESHOLD && next.trippedAt === null) {\n\t\tnext.trippedAt = now;\n\t\topts?.onTrip?.({\n\t\t\ttripped: true,\n\t\t\tfailureCount: next.consecutiveFailures,\n\t\t\ttrippedAt: now,\n\t\t\treason: opts.route ?? \"threshold\",\n\t\t});\n\t}\n\treturn next;\n}\n\nexport function isTripped(state: CompactionExtensionState, now: number): boolean {\n\treturn state.trippedAt !== null && now < state.trippedAt + COOLDOWN_MS;\n}\n\nexport function shouldBypass(_state: CompactionExtensionState, opts?: ShouldBypassOptions): boolean {\n\tif (opts?.manual === true) return true;\n\tif (opts?.reason === \"manual\") return true;\n\treturn false;\n}\n"]}

package/dist/core/extensions/builtin/compaction/degradation-monitor.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Post-compaction degradation monitor.
+ *
+ * Watches the first POST_COMPACTION_MONITOR_COUNT assistant turns after a
+ * compaction completes and triggers a single recovery compaction if the
+ * model emits POST_COMPACTION_NO_TEXT_THRESHOLD consecutive assistant
+ * messages with no text content (only step-start/step-finish parts).
+ *
+ * Algorithm ported from omo's preemptive-compaction-degradation-monitor:
+ * `/Users/yeongyu/local-workspaces/omo/src/hooks/preemptive-compaction-degradation-monitor.ts`
+ *
+ * Pi extension surface differences vs omo:
+ * - Recovery dispatch: speculative generation plus `ctx.applyCompaction(...)`
+ *   instead of omo's `client.session.summarize(...)`. The "RECOVERY:" prefix
+ *   in customInstructions is the disambiguator; CompactionReason stays
+ *   "extension" (no new variant in v1).
+ * - Notification: `ctx.notify(message)` instead of omo's
+ *   `client.tui.showToast(...)`.
+ *
+ * Recovery cap: 1 per compaction cycle (gate via recoveryTriggeredThisCycle).
+ * MAX_RECOVERY_ATTEMPTS = 3 is exported for future iteration but the v1 cycle
+ * gate keeps the effective cap at 1 — recoveryAttempts is incremented only on
+ * successful trigger, so once it hits 1 the cycle gate also fires regardless.
+ */
+export declare const POST_COMPACTION_MONITOR_COUNT = 5;
+export declare const POST_COMPACTION_NO_TEXT_THRESHOLD = 3;
+export declare const MAX_RECOVERY_ATTEMPTS = 3;
+export declare const RECOVERY_COMPACTION_SUPPRESSION_MS = 5000;
+export declare const RECOVERY_INSTRUCTIONS = "RECOVERY: prior compaction caused degraded responses; rebuild context";
+export declare const RECOVERY_NOTIFICATION = "Detected repeated no-text assistant responses; retried compaction recovery.";
+export interface DegradationMonitorState {
+    postCompactionTurnsRemaining: number;
+    noTextCounter: number;
+    recoveryTriggeredThisCycle: boolean;
+    recoveryAttempts: number;
+}
+export interface DegradationMonitorContext {
+    applyCompaction: (options: {
+        customInstructions: string;
+    }) => Promise<{
+        applied: boolean;
+        reason: string;
+    }>;
+    notify: (message: string) => void;
+}
+interface MonitoredMessageContentPart {
+    type: string;
+    text?: string;
+}
+interface MonitoredMessageEvent {
+    message: {
+        role: string;
+        content: MonitoredMessageContentPart[];
+    };
+}
+export declare function createDegradationMonitorState(): DegradationMonitorState;
+/**
+ * Reset the per-cycle monitor fields when a fresh compaction completes.
+ * Opens a new POST_COMPACTION_MONITOR_COUNT-turn window and clears the
+ * cycle-trigger gate. recoveryAttempts is preserved across cycles so the
+ * MAX_RECOVERY_ATTEMPTS ceiling remains a session-wide guard.
+ */
+export declare function resetOnSessionCompact(state: DegradationMonitorState): void;
+export declare function handleMessageEnd(state: DegradationMonitorState, event: MonitoredMessageEvent, context: DegradationMonitorContext): Promise<void>;
+export declare function handleTurnEnd(state: DegradationMonitorState): void;
+export {};
+//# sourceMappingURL=degradation-monitor.d.ts.map

package/dist/core/extensions/builtin/compaction/degradation-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"degradation-monitor.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/degradation-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,iCAAiC,IAAI,CAAC;AACnD,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,kCAAkC,OAAQ,CAAC;AAExD,eAAO,MAAM,qBAAqB,0EAA0E,CAAC;AAC7G,eAAO,MAAM,qBAAqB,gFAAgF,CAAC;AAEnH,MAAM,WAAW,uBAAuB;IACvC,4BAA4B,EAAE,MAAM,CAAC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B,EAAE,OAAO,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACzC,eAAe,EAAE,CAAC,OAAO,EAAE;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5G,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,UAAU,2BAA2B;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,qBAAqB;IAC9B,OAAO,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,2BAA2B,EAAE,CAAC;KACvC,CAAC;CACF;AAED,wBAAgB,6BAA6B,IAAI,uBAAuB,CAOvE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAI1E;AAcD,wBAAsB,gBAAgB,CACrC,KAAK,EAAE,uBAAuB,EAC9B,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,yBAAyB,GAChC,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAIlE","sourcesContent":["/**\n * Post-compaction degradation monitor.\n *\n * Watches the first POST_COMPACTION_MONITOR_COUNT assistant turns after a\n * compaction completes and triggers a single recovery compaction if the\n * model emits POST_COMPACTION_NO_TEXT_THRESHOLD consecutive assistant\n * messages with no text content (only step-start/step-finish parts).\n *\n * Algorithm ported from omo's preemptive-compaction-degradation-monitor:\n * `/Users/yeongyu/local-workspaces/omo/src/hooks/preemptive-compaction-degradation-monitor.ts`\n *\n * Pi extension surface differences vs omo:\n * - Recovery dispatch: speculative generation plus `ctx.applyCompaction(...)`\n *   instead of omo's `client.session.summarize(...)`. The \"RECOVERY:\" prefix\n *   in customInstructions is the disambiguator; CompactionReason stays\n *   \"extension\" (no new variant in v1).\n * - Notification: `ctx.notify(message)` instead of omo's\n *   `client.tui.showToast(...)`.\n *\n * Recovery cap: 1 per compaction cycle (gate via recoveryTriggeredThisCycle).\n * MAX_RECOVERY_ATTEMPTS = 3 is exported for future iteration but the v1 cycle\n * gate keeps the effective cap at 1 — recoveryAttempts is incremented only on\n * successful trigger, so once it hits 1 the cycle gate also fires regardless.\n */\n\nexport const POST_COMPACTION_MONITOR_COUNT = 5;\nexport const POST_COMPACTION_NO_TEXT_THRESHOLD = 3;\nexport const MAX_RECOVERY_ATTEMPTS = 3;\nexport const RECOVERY_COMPACTION_SUPPRESSION_MS = 5_000;\n\nexport const RECOVERY_INSTRUCTIONS = \"RECOVERY: prior compaction caused degraded responses; rebuild context\";\nexport const RECOVERY_NOTIFICATION = \"Detected repeated no-text assistant responses; retried compaction recovery.\";\n\nexport interface DegradationMonitorState {\n\tpostCompactionTurnsRemaining: number;\n\tnoTextCounter: number;\n\trecoveryTriggeredThisCycle: boolean;\n\trecoveryAttempts: number;\n}\n\nexport interface DegradationMonitorContext {\n\tapplyCompaction: (options: { customInstructions: string }) => Promise<{ applied: boolean; reason: string }>;\n\tnotify: (message: string) => void;\n}\n\ninterface MonitoredMessageContentPart {\n\ttype: string;\n\ttext?: string;\n}\n\ninterface MonitoredMessageEvent {\n\tmessage: {\n\t\trole: string;\n\t\tcontent: MonitoredMessageContentPart[];\n\t};\n}\n\nexport function createDegradationMonitorState(): DegradationMonitorState {\n\treturn {\n\t\tpostCompactionTurnsRemaining: 0,\n\t\tnoTextCounter: 0,\n\t\trecoveryTriggeredThisCycle: false,\n\t\trecoveryAttempts: 0,\n\t};\n}\n\n/**\n * Reset the per-cycle monitor fields when a fresh compaction completes.\n * Opens a new POST_COMPACTION_MONITOR_COUNT-turn window and clears the\n * cycle-trigger gate. recoveryAttempts is preserved across cycles so the\n * MAX_RECOVERY_ATTEMPTS ceiling remains a session-wide guard.\n */\nexport function resetOnSessionCompact(state: DegradationMonitorState): void {\n\tstate.postCompactionTurnsRemaining = POST_COMPACTION_MONITOR_COUNT;\n\tstate.noTextCounter = 0;\n\tstate.recoveryTriggeredThisCycle = false;\n}\n\nfunction assistantMessageHasText(event: MonitoredMessageEvent): boolean {\n\tif (event.message.role !== \"assistant\") {\n\t\treturn true;\n\t}\n\tfor (const part of event.message.content) {\n\t\tif (part.type === \"text\" && typeof part.text === \"string\" && part.text.length > 0) {\n\t\t\treturn true;\n\t\t}\n\t}\n\treturn false;\n}\n\nexport async function handleMessageEnd(\n\tstate: DegradationMonitorState,\n\tevent: MonitoredMessageEvent,\n\tcontext: DegradationMonitorContext,\n): Promise<void> {\n\tif (state.postCompactionTurnsRemaining <= 0) {\n\t\treturn;\n\t}\n\n\tif (assistantMessageHasText(event)) {\n\t\tstate.noTextCounter = 0;\n\t\treturn;\n\t}\n\n\tstate.noTextCounter += 1;\n\n\tif (state.noTextCounter < POST_COMPACTION_NO_TEXT_THRESHOLD) {\n\t\treturn;\n\t}\n\n\tif (state.recoveryTriggeredThisCycle) {\n\t\treturn;\n\t}\n\n\tif (state.recoveryAttempts >= MAX_RECOVERY_ATTEMPTS) {\n\t\treturn;\n\t}\n\n\tstate.recoveryTriggeredThisCycle = true;\n\tstate.recoveryAttempts += 1;\n\tstate.noTextCounter = 0;\n\n\tawait context.applyCompaction({ customInstructions: RECOVERY_INSTRUCTIONS });\n\tcontext.notify(RECOVERY_NOTIFICATION);\n}\n\nexport function handleTurnEnd(state: DegradationMonitorState): void {\n\tif (state.postCompactionTurnsRemaining > 0) {\n\t\tstate.postCompactionTurnsRemaining -= 1;\n\t}\n}\n"]}

package/dist/core/extensions/builtin/compaction/degradation-monitor.js

@@ -0,0 +1,90 @@
+/**
+ * Post-compaction degradation monitor.
+ *
+ * Watches the first POST_COMPACTION_MONITOR_COUNT assistant turns after a
+ * compaction completes and triggers a single recovery compaction if the
+ * model emits POST_COMPACTION_NO_TEXT_THRESHOLD consecutive assistant
+ * messages with no text content (only step-start/step-finish parts).
+ *
+ * Algorithm ported from omo's preemptive-compaction-degradation-monitor:
+ * `/Users/yeongyu/local-workspaces/omo/src/hooks/preemptive-compaction-degradation-monitor.ts`
+ *
+ * Pi extension surface differences vs omo:
+ * - Recovery dispatch: speculative generation plus `ctx.applyCompaction(...)`
+ *   instead of omo's `client.session.summarize(...)`. The "RECOVERY:" prefix
+ *   in customInstructions is the disambiguator; CompactionReason stays
+ *   "extension" (no new variant in v1).
+ * - Notification: `ctx.notify(message)` instead of omo's
+ *   `client.tui.showToast(...)`.
+ *
+ * Recovery cap: 1 per compaction cycle (gate via recoveryTriggeredThisCycle).
+ * MAX_RECOVERY_ATTEMPTS = 3 is exported for future iteration but the v1 cycle
+ * gate keeps the effective cap at 1 — recoveryAttempts is incremented only on
+ * successful trigger, so once it hits 1 the cycle gate also fires regardless.
+ */
+export const POST_COMPACTION_MONITOR_COUNT = 5;
+export const POST_COMPACTION_NO_TEXT_THRESHOLD = 3;
+export const MAX_RECOVERY_ATTEMPTS = 3;
+export const RECOVERY_COMPACTION_SUPPRESSION_MS = 5_000;
+export const RECOVERY_INSTRUCTIONS = "RECOVERY: prior compaction caused degraded responses; rebuild context";
+export const RECOVERY_NOTIFICATION = "Detected repeated no-text assistant responses; retried compaction recovery.";
+export function createDegradationMonitorState() {
+    return {
+        postCompactionTurnsRemaining: 0,
+        noTextCounter: 0,
+        recoveryTriggeredThisCycle: false,
+        recoveryAttempts: 0,
+    };
+}
+/**
+ * Reset the per-cycle monitor fields when a fresh compaction completes.
+ * Opens a new POST_COMPACTION_MONITOR_COUNT-turn window and clears the
+ * cycle-trigger gate. recoveryAttempts is preserved across cycles so the
+ * MAX_RECOVERY_ATTEMPTS ceiling remains a session-wide guard.
+ */
+export function resetOnSessionCompact(state) {
+    state.postCompactionTurnsRemaining = POST_COMPACTION_MONITOR_COUNT;
+    state.noTextCounter = 0;
+    state.recoveryTriggeredThisCycle = false;
+}
+function assistantMessageHasText(event) {
+    if (event.message.role !== "assistant") {
+        return true;
+    }
+    for (const part of event.message.content) {
+        if (part.type === "text" && typeof part.text === "string" && part.text.length > 0) {
+            return true;
+        }
+    }
+    return false;
+}
+export async function handleMessageEnd(state, event, context) {
+    if (state.postCompactionTurnsRemaining <= 0) {
+        return;
+    }
+    if (assistantMessageHasText(event)) {
+        state.noTextCounter = 0;
+        return;
+    }
+    state.noTextCounter += 1;
+    if (state.noTextCounter < POST_COMPACTION_NO_TEXT_THRESHOLD) {
+        return;
+    }
+    if (state.recoveryTriggeredThisCycle) {
+        return;
+    }
+    if (state.recoveryAttempts >= MAX_RECOVERY_ATTEMPTS) {
+        return;
+    }
+    state.recoveryTriggeredThisCycle = true;
+    state.recoveryAttempts += 1;
+    state.noTextCounter = 0;
+    await context.applyCompaction({ customInstructions: RECOVERY_INSTRUCTIONS });
+    context.notify(RECOVERY_NOTIFICATION);
+}
+export function handleTurnEnd(state) {
+    if (state.postCompactionTurnsRemaining > 0) {
+        state.postCompactionTurnsRemaining -= 1;
+    }
+}
+//# sourceMappingURL=degradation-monitor.js.map

package/dist/core/extensions/builtin/compaction/degradation-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"degradation-monitor.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/degradation-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,kCAAkC,GAAG,KAAK,CAAC;AAExD,MAAM,CAAC,MAAM,qBAAqB,GAAG,uEAAuE,CAAC;AAC7G,MAAM,CAAC,MAAM,qBAAqB,GAAG,6EAA6E,CAAC;AA0BnH,MAAM,UAAU,6BAA6B,GAA4B;IACxE,OAAO;QACN,4BAA4B,EAAE,CAAC;QAC/B,aAAa,EAAE,CAAC;QAChB,0BAA0B,EAAE,KAAK;QACjC,gBAAgB,EAAE,CAAC;KACnB,CAAC;AAAA,CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAA8B,EAAQ;IAC3E,KAAK,CAAC,4BAA4B,GAAG,6BAA6B,CAAC;IACnE,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC;IACxB,KAAK,CAAC,0BAA0B,GAAG,KAAK,CAAC;AAAA,CACzC;AAED,SAAS,uBAAuB,CAAC,KAA4B,EAAW;IACvE,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACb,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnF,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC;AAAA,CACb;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,KAA8B,EAC9B,KAA4B,EAC5B,OAAkC,EAClB;IAChB,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,EAAE,CAAC;QAC7C,OAAO;IACR,CAAC;IAED,IAAI,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC;QACxB,OAAO;IACR,CAAC;IAED,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;IAEzB,IAAI,KAAK,CAAC,aAAa,GAAG,iCAAiC,EAAE,CAAC;QAC7D,OAAO;IACR,CAAC;IAED,IAAI,KAAK,CAAC,0BAA0B,EAAE,CAAC;QACtC,OAAO;IACR,CAAC;IAED,IAAI,KAAK,CAAC,gBAAgB,IAAI,qBAAqB,EAAE,CAAC;QACrD,OAAO;IACR,CAAC;IAED,KAAK,CAAC,0BAA0B,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,gBAAgB,IAAI,CAAC,CAAC;IAC5B,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC;IAExB,MAAM,OAAO,CAAC,eAAe,CAAC,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC7E,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAAA,CACtC;AAED,MAAM,UAAU,aAAa,CAAC,KAA8B,EAAQ;IACnE,IAAI,KAAK,CAAC,4BAA4B,GAAG,CAAC,EAAE,CAAC;QAC5C,KAAK,CAAC,4BAA4B,IAAI,CAAC,CAAC;IACzC,CAAC;AAAA,CACD","sourcesContent":["/**\n * Post-compaction degradation monitor.\n *\n * Watches the first POST_COMPACTION_MONITOR_COUNT assistant turns after a\n * compaction completes and triggers a single recovery compaction if the\n * model emits POST_COMPACTION_NO_TEXT_THRESHOLD consecutive assistant\n * messages with no text content (only step-start/step-finish parts).\n *\n * Algorithm ported from omo's preemptive-compaction-degradation-monitor:\n * `/Users/yeongyu/local-workspaces/omo/src/hooks/preemptive-compaction-degradation-monitor.ts`\n *\n * Pi extension surface differences vs omo:\n * - Recovery dispatch: speculative generation plus `ctx.applyCompaction(...)`\n *   instead of omo's `client.session.summarize(...)`. The \"RECOVERY:\" prefix\n *   in customInstructions is the disambiguator; CompactionReason stays\n *   \"extension\" (no new variant in v1).\n * - Notification: `ctx.notify(message)` instead of omo's\n *   `client.tui.showToast(...)`.\n *\n * Recovery cap: 1 per compaction cycle (gate via recoveryTriggeredThisCycle).\n * MAX_RECOVERY_ATTEMPTS = 3 is exported for future iteration but the v1 cycle\n * gate keeps the effective cap at 1 — recoveryAttempts is incremented only on\n * successful trigger, so once it hits 1 the cycle gate also fires regardless.\n */\n\nexport const POST_COMPACTION_MONITOR_COUNT = 5;\nexport const POST_COMPACTION_NO_TEXT_THRESHOLD = 3;\nexport const MAX_RECOVERY_ATTEMPTS = 3;\nexport const RECOVERY_COMPACTION_SUPPRESSION_MS = 5_000;\n\nexport const RECOVERY_INSTRUCTIONS = \"RECOVERY: prior compaction caused degraded responses; rebuild context\";\nexport const RECOVERY_NOTIFICATION = \"Detected repeated no-text assistant responses; retried compaction recovery.\";\n\nexport interface DegradationMonitorState {\n\tpostCompactionTurnsRemaining: number;\n\tnoTextCounter: number;\n\trecoveryTriggeredThisCycle: boolean;\n\trecoveryAttempts: number;\n}\n\nexport interface DegradationMonitorContext {\n\tapplyCompaction: (options: { customInstructions: string }) => Promise<{ applied: boolean; reason: string }>;\n\tnotify: (message: string) => void;\n}\n\ninterface MonitoredMessageContentPart {\n\ttype: string;\n\ttext?: string;\n}\n\ninterface MonitoredMessageEvent {\n\tmessage: {\n\t\trole: string;\n\t\tcontent: MonitoredMessageContentPart[];\n\t};\n}\n\nexport function createDegradationMonitorState(): DegradationMonitorState {\n\treturn {\n\t\tpostCompactionTurnsRemaining: 0,\n\t\tnoTextCounter: 0,\n\t\trecoveryTriggeredThisCycle: false,\n\t\trecoveryAttempts: 0,\n\t};\n}\n\n/**\n * Reset the per-cycle monitor fields when a fresh compaction completes.\n * Opens a new POST_COMPACTION_MONITOR_COUNT-turn window and clears the\n * cycle-trigger gate. recoveryAttempts is preserved across cycles so the\n * MAX_RECOVERY_ATTEMPTS ceiling remains a session-wide guard.\n */\nexport function resetOnSessionCompact(state: DegradationMonitorState): void {\n\tstate.postCompactionTurnsRemaining = POST_COMPACTION_MONITOR_COUNT;\n\tstate.noTextCounter = 0;\n\tstate.recoveryTriggeredThisCycle = false;\n}\n\nfunction assistantMessageHasText(event: MonitoredMessageEvent): boolean {\n\tif (event.message.role !== \"assistant\") {\n\t\treturn true;\n\t}\n\tfor (const part of event.message.content) {\n\t\tif (part.type === \"text\" && typeof part.text === \"string\" && part.text.length > 0) {\n\t\t\treturn true;\n\t\t}\n\t}\n\treturn false;\n}\n\nexport async function handleMessageEnd(\n\tstate: DegradationMonitorState,\n\tevent: MonitoredMessageEvent,\n\tcontext: DegradationMonitorContext,\n): Promise<void> {\n\tif (state.postCompactionTurnsRemaining <= 0) {\n\t\treturn;\n\t}\n\n\tif (assistantMessageHasText(event)) {\n\t\tstate.noTextCounter = 0;\n\t\treturn;\n\t}\n\n\tstate.noTextCounter += 1;\n\n\tif (state.noTextCounter < POST_COMPACTION_NO_TEXT_THRESHOLD) {\n\t\treturn;\n\t}\n\n\tif (state.recoveryTriggeredThisCycle) {\n\t\treturn;\n\t}\n\n\tif (state.recoveryAttempts >= MAX_RECOVERY_ATTEMPTS) {\n\t\treturn;\n\t}\n\n\tstate.recoveryTriggeredThisCycle = true;\n\tstate.recoveryAttempts += 1;\n\tstate.noTextCounter = 0;\n\n\tawait context.applyCompaction({ customInstructions: RECOVERY_INSTRUCTIONS });\n\tcontext.notify(RECOVERY_NOTIFICATION);\n}\n\nexport function handleTurnEnd(state: DegradationMonitorState): void {\n\tif (state.postCompactionTurnsRemaining > 0) {\n\t\tstate.postCompactionTurnsRemaining -= 1;\n\t}\n}\n"]}

package/dist/core/extensions/builtin/compaction/index.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "../../types.js";
+export default function compactionExtension(pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/extensions/builtin/compaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAqDrE,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA8LlE","sourcesContent":["import type { AgentMessage } from \"@earendil-works/pi-agent-core\";\nimport { repairOrphanedToolResults } from \"@earendil-works/pi-ai\";\nimport { type CompactionResult, DEFAULT_COMPACTION_SETTINGS } from \"../../../compaction/index.js\";\nimport { convertToLlm } from \"../../../messages.js\";\nimport type { CompactionEntry } from \"../../../session-manager.js\";\nimport type { ExtensionAPI, ExtensionContext } from \"../../types.js\";\nimport * as checkpointState from \"./checkpoint-state.js\";\nimport * as breaker from \"./circuit-breaker.js\";\nimport {\n\tcreateDegradationMonitorState,\n\thandleMessageEnd,\n\thandleTurnEnd,\n\tRECOVERY_INSTRUCTIONS,\n\tresetOnSessionCompact,\n} from \"./degradation-monitor.js\";\nimport * as overflow from \"./overflow-detection.js\";\nimport * as cap from \"./per-turn-cap.js\";\nimport * as policy from \"./policy.js\";\nimport * as restoration from \"./restoration-tracker.js\";\nimport {\n\tapplyGeneratedCompaction,\n\tcreateSpeculativeCompactionSnapshot,\n\tgetPromptVariant,\n\thardLimitEmergencyPrune,\n\trunExtensionCompaction,\n\ttype SpeculativeCompactionResult,\n\ttype SpeculativeCompactionSnapshot,\n} from \"./speculative.js\";\nimport { type CompactionExtensionState, createInitialState, resetTurnCounter } from \"./state.js\";\nimport * as todoBridge from \"./todo-bridge.js\";\nimport * as truncation from \"./tool-truncation.js\";\n\nconst DEFAULT_CONTEXT_WINDOW = 200_000;\nconst EMERGENCY_COMPACTION_INSTRUCTIONS =\n\t\"EMERGENCY: hard context limit reached. Produce an aggressive recovery summary that preserves current goal, constraints, files touched, tool outcomes, and exact next steps. Prefer concise factual state over transcript detail.\";\nconst PROACTIVE_COMPACTION_INSTRUCTIONS = \"Proactively compact before the next agent turn.\";\n\nfunction approxTokens(text: string): number {\n\treturn Math.ceil(text.length / 4);\n}\n\nfunction isMonitorableMessageEvent(event: { message: AgentMessage }): event is {\n\tmessage: AgentMessage & { content: Array<{ type: string; text?: string }> };\n} {\n\treturn \"content\" in event.message && Array.isArray(event.message.content);\n}\n\nfunction updateLastYield(state: CompactionExtensionState, entry: CompactionEntry): CompactionExtensionState {\n\tconst savedTokens = Math.max(0, entry.tokensBefore - approxTokens(entry.summary));\n\treturn { ...state, lastYield: { savedTokens, tokensBefore: entry.tokensBefore } };\n}\n\nfunction recentCheckpoint(ctx: ExtensionContext): checkpointState.AgentCheckpoint | null {\n\tconst checkpoint = checkpointState.getLatestCheckpoint(ctx);\n\tif (!checkpoint?.timestamp) return null;\n\treturn Date.now() - checkpoint.timestamp <= 60_000 ? checkpoint : null;\n}\n\nexport default function compactionExtension(pi: ExtensionAPI): void {\n\tlet state: CompactionExtensionState = createInitialState();\n\tconst degradationState = createDegradationMonitorState();\n\tconst restorationState = state.restoration ?? restoration.createRestorationTrackerState();\n\tstate = { ...state, restoration: restorationState };\n\tlet speculativeGeneration = 0;\n\tlet speculativeJob:\n\t\t| {\n\t\t\t\tgeneration: number;\n\t\t\t\tsnapshot: SpeculativeCompactionSnapshot;\n\t\t\t\tcontroller: AbortController;\n\t\t\t\tpromise: Promise<CompactionResult | undefined>;\n\t\t  }\n\t\t| undefined;\n\n\tfunction invalidateSpeculativeCompaction(): void {\n\t\tspeculativeGeneration++;\n\t\tspeculativeJob?.controller.abort();\n\t\tspeculativeJob = undefined;\n\t}\n\n\tfunction startSpeculativeCompaction(ctx: ExtensionContext, customInstructions: string): void {\n\t\tif (speculativeJob) return;\n\t\tconst generation = ++speculativeGeneration;\n\t\tconst snapshot = createSpeculativeCompactionSnapshot(ctx, { generation, customInstructions });\n\t\tif (!snapshot) return;\n\n\t\tconst controller = new AbortController();\n\t\tconst promise = runExtensionCompaction(ctx, snapshot, controller.signal).catch(() => undefined);\n\t\tspeculativeJob = { generation, snapshot, controller, promise };\n\t}\n\n\tasync function applyBlockingCompaction(\n\t\tctx: ExtensionContext,\n\t\tcustomInstructions: string,\n\t): Promise<SpeculativeCompactionResult> {\n\t\tconst pendingJob = speculativeJob;\n\t\tif (pendingJob) {\n\t\t\tconst compaction = await pendingJob.promise;\n\t\t\tconst result = await applyGeneratedCompaction(\n\t\t\t\tctx,\n\t\t\t\tpendingJob.snapshot,\n\t\t\t\t() => speculativeGeneration,\n\t\t\t\tcompaction,\n\t\t\t);\n\t\t\tif (result.applied || result.reason === \"stale\") {\n\t\t\t\tspeculativeJob = undefined;\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tspeculativeJob = undefined;\n\t\t}\n\n\t\tconst generation = ++speculativeGeneration;\n\t\tconst snapshot = createSpeculativeCompactionSnapshot(ctx, { generation, customInstructions });\n\t\tif (!snapshot) return { applied: false, reason: \"unavailable\" };\n\t\tconst compaction = await runExtensionCompaction(ctx, snapshot);\n\t\treturn await applyGeneratedCompaction(ctx, snapshot, () => speculativeGeneration, compaction);\n\t}\n\n\tpi.on(\"session_before_compact\", async (event, ctx) => {\n\t\tinvalidateSpeculativeCompaction();\n\t\tif (cap.shouldRejectByCap(state, { reason: event.reason }).cancel) return { cancel: true };\n\t\tif (breaker.isTripped(state, Date.now()) && !breaker.shouldBypass(state, { reason: event.reason }))\n\t\t\treturn { cancel: true };\n\n\t\tcheckpointState.persistCheckpoint(pi, checkpointState.captureAgentCheckpoint(pi, ctx));\n\t\ttodoBridge.captureTodoSnapshot(pi, ctx);\n\n\t\tconst model = ctx.model;\n\t\tif (!model) return undefined;\n\t\tconst snapshot = {\n\t\t\tgeneration: ++speculativeGeneration,\n\t\t\texpectedRevision: ctx.getMessageRevision(),\n\t\t\tmodel,\n\t\t\tcontextWindow: ctx.getContextUsage()?.contextWindow ?? model.contextWindow ?? DEFAULT_CONTEXT_WINDOW,\n\t\t\tpreparation: event.preparation,\n\t\t\tpromptVariant: getPromptVariant(event),\n\t\t\tcustomInstructions: event.customInstructions,\n\t\t};\n\t\tconst compaction = await runExtensionCompaction(ctx, snapshot, event.signal);\n\t\tif (!compaction) return { cancel: true };\n\n\t\treturn {\n\t\t\tcompaction,\n\t\t};\n\t});\n\n\tpi.on(\"session_compact\", async (event, ctx) => {\n\t\tinvalidateSpeculativeCompaction();\n\t\tif (event.accepted) {\n\t\t\tconst branchEntries = ctx.sessionManager.getBranch();\n\t\t\tconst firstKeptIndex = branchEntries.findIndex((entry) => entry.id === event.compactionEntry.firstKeptEntryId);\n\t\t\tconst keptEntries = firstKeptIndex === -1 ? [] : branchEntries.slice(firstKeptIndex);\n\t\t\tstate = cap.incrementAccepted(state);\n\t\t\tstate = breaker.recordSuccess(state);\n\t\t\tstate = updateLastYield(state, event.compactionEntry);\n\t\t\tresetOnSessionCompact(degradationState);\n\t\t\ttodoBridge.restoreTodosIfMissing(pi, ctx);\n\t\t\tconst usage = ctx.getContextUsage();\n\t\t\tif (DEFAULT_COMPACTION_SETTINGS.restorationEnabled) {\n\t\t\t\trestoration.preparePendingPayload(restorationState, {\n\t\t\t\t\taccepted: true,\n\t\t\t\t\treason: event.reason,\n\t\t\t\t\tcompactionEntryId: event.compactionEntry.id,\n\t\t\t\t\tcontextWindow: usage?.contextWindow ?? ctx.model?.contextWindow ?? DEFAULT_CONTEXT_WINDOW,\n\t\t\t\t\tusageTokens: usage?.tokens ?? null,\n\t\t\t\t\treserveTokens: DEFAULT_COMPACTION_SETTINGS.reserveTokens,\n\t\t\t\t\tsettings: DEFAULT_COMPACTION_SETTINGS,\n\t\t\t\t\tkeptMessages: keptEntries.flatMap((entry) => {\n\t\t\t\t\t\tif (entry.type !== \"message\") return [];\n\t\t\t\t\t\treturn [entry.message];\n\t\t\t\t\t}),\n\t\t\t\t});\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tstate = breaker.recordFailure(state, Date.now(), { route: event.reason });\n\t\tctx.ui.notify(`Compaction rejected: ${event.rejectionCause ?? \"unknown\"}`, \"warning\");\n\t});\n\n\tpi.on(\"before_agent_start\", async (event, ctx) => {\n\t\tlet systemPrompt = event.systemPrompt;\n\t\tconst message = restoration.consumePendingPayload(restorationState);\n\t\tconst checkpoint = recentCheckpoint(ctx);\n\t\tif (checkpoint) systemPrompt = checkpointState.injectRestorationDirective(systemPrompt, checkpoint);\n\n\t\tconst usage = ctx.getContextUsage();\n\t\tconst contextWindow = usage?.contextWindow ?? ctx.model?.contextWindow ?? DEFAULT_CONTEXT_WINDOW;\n\t\tconst settings = ctx.getCompactionSettings();\n\t\tif (usage && policy.isAtHardLimit(usage, contextWindow, settings.reserveTokens)) {\n\t\t\tawait applyBlockingCompaction(ctx, EMERGENCY_COMPACTION_INSTRUCTIONS);\n\t\t} else if (\n\t\t\tusage &&\n\t\t\tpolicy.shouldTriggerCompaction(usage, contextWindow, settings, state.lastYield ?? undefined)\n\t\t) {\n\t\t\tawait applyBlockingCompaction(ctx, PROACTIVE_COMPACTION_INSTRUCTIONS);\n\t\t} else if (\n\t\t\tusage &&\n\t\t\tpolicy.shouldStartSpeculativeCompaction(usage, contextWindow, settings, state.lastYield ?? undefined)\n\t\t) {\n\t\t\tstartSpeculativeCompaction(ctx, PROACTIVE_COMPACTION_INSTRUCTIONS);\n\t\t}\n\n\t\tif (systemPrompt === event.systemPrompt && !message) return undefined;\n\t\treturn message ? { systemPrompt, message } : { systemPrompt };\n\t});\n\n\tpi.on(\"context\", (event, ctx) => {\n\t\tconst contextWindow = ctx.getContextUsage()?.contextWindow ?? ctx.model?.contextWindow ?? DEFAULT_CONTEXT_WINDOW;\n\t\tconst emergency = hardLimitEmergencyPrune(event.messages, contextWindow);\n\t\treturn { messages: repairOrphanedToolResults(convertToLlm(emergency.messages)) };\n\t});\n\n\tpi.on(\"turn_end\", async (_event, ctx) => {\n\t\thandleTurnEnd(degradationState);\n\t\tif (degradationState.recoveryTriggeredThisCycle) return;\n\t\tif (state.lastYield && state.lastYield.savedTokens <= 0) {\n\t\t\tvoid applyBlockingCompaction(ctx, RECOVERY_INSTRUCTIONS);\n\t\t}\n\t});\n\n\tpi.on(\"agent_end\", () => {\n\t\tstate = resetTurnCounter(state, \"\");\n\t});\n\n\tpi.on(\"message_end\", async (event, ctx) => {\n\t\tif (isMonitorableMessageEvent(event)) {\n\t\t\tawait handleMessageEnd(degradationState, event, {\n\t\t\t\tapplyCompaction: async (options) => {\n\t\t\t\t\treturn await applyBlockingCompaction(ctx, options.customInstructions);\n\t\t\t\t},\n\t\t\t\tnotify: (message) => ctx.ui.notify(message, \"warning\"),\n\t\t\t});\n\t\t}\n\t\tif (event.message.role === \"assistant\" && event.message.stopReason === \"error\") {\n\t\t\tconst detected = overflow.isContextOverflowError(new Error(event.message.errorMessage ?? \"\"));\n\t\t\tif (detected.detected) {\n\t\t\t\tvoid applyBlockingCompaction(ctx, `RECOVERY: context overflow detected (${detected.confidence})`);\n\t\t\t}\n\t\t}\n\t});\n\n\tpi.on(\"tool_result\", (event) => {\n\t\tconst [truncated] = truncation.truncateOversizedToolResults([{ content: event.content, details: event.details }]);\n\t\treturn truncated ? { content: truncated.content, details: event.details, isError: event.isError } : undefined;\n\t});\n\n\tpi.on(\"tool_call\", (event) => {\n\t\trestoration.trackToolCall(restorationState, event);\n\t});\n}\n"]}