@code-yeongyu/senpi 2026.7.31 → 2026.8.3

package/dist/core/extensions/builtin/{claude-agent-sdk → claude-sdk-oauth}/tools.js

@@ -15,6 +15,7 @@ export const PI_TO_SDK_TOOL_NAME = {
     find: "Glob",
     glob: "Glob",
 };
+export const HOST_TOOL_POLICY_FINGERPRINT = "host-tool-denial-v1";
 export const BUILTIN_SDK_TOOLS = ["Read", "Write", "Edit", "Bash", "Grep", "Glob"];
 export const TOOL_EXECUTION_DENIED_MESSAGE = "Tool execution is unavailable in this environment.";
 export const HOST_TOOL_EXECUTION_DENIED_MESSAGE = "This tool call is captured and executed by the host. Do not retry with other tools; end the turn.";

package/dist/core/extensions/builtin/claude-sdk-oauth/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/claude-sdk-oauth/tools.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Context, Tool } from \"@earendil-works/pi-ai\";\nimport type { Options } from \"./sdk-boundary.ts\";\n\nexport const SDK_TO_PI_TOOL_NAME: Readonly<Record<string, string>> = {\n\tread: \"read\",\n\twrite: \"write\",\n\tedit: \"edit\",\n\tbash: \"bash\",\n\tgrep: \"grep\",\n\tglob: \"find\",\n};\n\nexport const PI_TO_SDK_TOOL_NAME: Readonly<Record<string, string>> = {\n\tread: \"Read\",\n\twrite: \"Write\",\n\tedit: \"Edit\",\n\tbash: \"Bash\",\n\tgrep: \"Grep\",\n\tfind: \"Glob\",\n\tglob: \"Glob\",\n};\n\nexport const HOST_TOOL_POLICY_FINGERPRINT = \"host-tool-denial-v1\";\n\nexport const BUILTIN_SDK_TOOLS = [\"Read\", \"Write\", \"Edit\", \"Bash\", \"Grep\", \"Glob\"] as const;\nexport const TOOL_EXECUTION_DENIED_MESSAGE = \"Tool execution is unavailable in this environment.\";\nexport const HOST_TOOL_EXECUTION_DENIED_MESSAGE =\n\t\"This tool call is captured and executed by the host. Do not retry with other tools; end the turn.\";\nexport const CUSTOM_TOOLS_MCP_SERVER_NAME = \"custom-tools\";\nexport const CUSTOM_TOOLS_MCP_PREFIX = `mcp__${CUSTOM_TOOLS_MCP_SERVER_NAME}__`;\nexport const HOST_CAPTURED_SDK_TOOL_MATCHER = \"Bash|Write|Edit|Read|Grep|Glob|mcp__custom-tools__.*\";\nexport const HOST_TOOL_DENIAL_HOOKS: NonNullable<Options[\"hooks\"]> = {\n\tPreToolUse: [\n\t\t{\n\t\t\tmatcher: HOST_CAPTURED_SDK_TOOL_MATCHER,\n\t\t\thooks: [\n\t\t\t\tasync () => ({\n\t\t\t\t\tcontinue: false,\n\t\t\t\t\thookSpecificOutput: {\n\t\t\t\t\t\thookEventName: \"PreToolUse\",\n\t\t\t\t\t\tpermissionDecision: \"deny\",\n\t\t\t\t\t\tpermissionDecisionReason: HOST_TOOL_EXECUTION_DENIED_MESSAGE,\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t],\n\t\t},\n\t],\n};\n\nexport type ResolvedSdkTools = {\n\tsdkTools: string[];\n\tcustomTools: Tool[];\n\tcustomToolNameToSdk: Map<string, string>;\n\tcustomToolNameToPi: Map<string, string>;\n};\n\nfunction pascalCase(value: string): string {\n\treturn value\n\t\t.split(/[^a-zA-Z0-9]+/)\n\t\t.filter(Boolean)\n\t\t.map((part) => `${part[0]?.toUpperCase() ?? \"\"}${part.slice(1)}`)\n\t\t.join(\"\");\n}\n\nexport function mapPiToolNameToSdk(name: string, customToolNameToSdk?: ReadonlyMap<string, string>): string {\n\tconst normalized = name.toLowerCase();\n\treturn (\n\t\tcustomToolNameToSdk?.get(name) ??\n\t\tcustomToolNameToSdk?.get(normalized) ??\n\t\tPI_TO_SDK_TOOL_NAME[normalized] ??\n\t\tpascalCase(name)\n\t);\n}\n\nexport function mapSdkToolNameToPi(name: string, customToolNameToPi?: ReadonlyMap<string, string>): string {\n\tconst normalized = name.toLowerCase();\n\treturn (\n\t\tSDK_TO_PI_TOOL_NAME[normalized] ??\n\t\tcustomToolNameToPi?.get(name) ??\n\t\tcustomToolNameToPi?.get(normalized) ??\n\t\t(normalized.startsWith(CUSTOM_TOOLS_MCP_PREFIX) ? name.slice(CUSTOM_TOOLS_MCP_PREFIX.length) : name)\n\t);\n}\n\n/** Translate Claude Code's built-in-tool inputs into senpi's active tool schemas. */\nexport function mapToolArgs(\n\ttoolName: string,\n\targs: Readonly<Record<string, unknown>> | undefined,\n): Record<string, unknown> {\n\tconst input = args ?? {};\n\tswitch (toolName.toLowerCase()) {\n\t\tcase \"read\":\n\t\t\treturn { path: input.file_path ?? input.path, offset: input.offset, limit: input.limit };\n\t\tcase \"write\":\n\t\t\treturn { path: input.file_path ?? input.path, content: input.content };\n\t\tcase \"edit\":\n\t\t\treturn {\n\t\t\t\tpath: input.file_path ?? input.path,\n\t\t\t\tedits: Array.isArray(input.edits)\n\t\t\t\t\t? input.edits\n\t\t\t\t\t: [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\toldText: input.old_string ?? input.oldText ?? input.old_text,\n\t\t\t\t\t\t\t\tnewText: input.new_string ?? input.newText ?? input.new_text,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t],\n\t\t\t};\n\t\tcase \"bash\":\n\t\t\treturn {\n\t\t\t\tcommand: input.command,\n\t\t\t\ttimeout: typeof input.timeout === \"number\" ? input.timeout / 1_000 : input.timeout,\n\t\t\t};\n\t\tcase \"grep\":\n\t\t\treturn {\n\t\t\t\tpattern: input.pattern,\n\t\t\t\tpath: input.path,\n\t\t\t\tglob: input.glob,\n\t\t\t\tignoreCase: input[\"-i\"] ?? input.ignoreCase,\n\t\t\t\tcontext: input.context ?? input[\"-C\"],\n\t\t\t\tlimit: input.head_limit ?? input.limit,\n\t\t\t};\n\t\tcase \"glob\":\n\t\tcase \"find\":\n\t\t\treturn { pattern: input.pattern, path: input.path, limit: input.limit };\n\t\tdefault:\n\t\t\treturn { ...input };\n\t}\n}\n\nexport function resolveSdkTools(context: Context): ResolvedSdkTools {\n\tif (!context.tools) {\n\t\treturn {\n\t\t\tsdkTools: [...BUILTIN_SDK_TOOLS],\n\t\t\tcustomTools: [],\n\t\t\tcustomToolNameToSdk: new Map(),\n\t\t\tcustomToolNameToPi: new Map(),\n\t\t};\n\t}\n\n\tconst sdkTools = new Set<string>();\n\tconst customTools: Tool[] = [];\n\tconst customToolNameToSdk = new Map<string, string>();\n\tconst customToolNameToPi = new Map<string, string>();\n\tfor (const tool of context.tools) {\n\t\tconst normalized = tool.name.toLowerCase();\n\t\tconst sdkName = PI_TO_SDK_TOOL_NAME[normalized];\n\t\tif (sdkName) {\n\t\t\tsdkTools.add(sdkName);\n\t\t\tcontinue;\n\t\t}\n\t\tconst customSdkName = `${CUSTOM_TOOLS_MCP_PREFIX}${tool.name}`;\n\t\tcustomTools.push(tool);\n\t\tcustomToolNameToSdk.set(tool.name, customSdkName);\n\t\tcustomToolNameToSdk.set(normalized, customSdkName);\n\t\tcustomToolNameToPi.set(customSdkName, tool.name);\n\t\tcustomToolNameToPi.set(customSdkName.toLowerCase(), tool.name);\n\t}\n\treturn { sdkTools: [...sdkTools], customTools, customToolNameToSdk, customToolNameToPi };\n}\n\nexport const canUseTool: NonNullable<Options[\"canUseTool\"]> = async () => ({\n\tbehavior: \"deny\",\n\tmessage: TOOL_EXECUTION_DENIED_MESSAGE,\n});\n"]}

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

@@ -1,5 +1,5 @@
 import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
-import type { ExtensionAPI, ExtensionContext } from "../../types.ts";
+import type { BeforeAgentStartEventResult, ExtensionAPI, ExtensionContext } from "../../types.ts";
 export interface AgentCheckpoint {
     activeTools?: string[];
     thinkingLevel?: ThinkingLevel | null;
@@ -35,6 +35,23 @@ export declare function persistCheckpoint(pi: ExtensionAPI, checkpoint: AgentChe
 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;
+/**
+ * One-shot delivery state for the checkpoint restoration directive.
+ *
+ * Before 2026-08-01 the directive was appended to the system prompt on every
+ * request inside the 60s checkpoint window; it now rides the hidden post-compact
+ * restoration message exactly once per checkpoint. See changes.md.
+ */
+export interface RestorationDirectiveState {
+    deliveredCheckpointTimestamp: number | null;
+}
+export declare function createRestorationDirectiveState(): RestorationDirectiveState;
+/**
+ * Attach the restoration directive to the one-shot post-compact message, once
+ * per checkpoint. Returns the pending message unchanged when the checkpoint is
+ * stale or its directive was already delivered.
+ */
+export declare function attachRestorationDirective(state: RestorationDirectiveState, checkpoint: AgentCheckpoint | null, message: BeforeAgentStartEventResult["message"] | undefined): BeforeAgentStartEventResult["message"] | undefined;
 export declare function injectRestorationDirective(systemPrompt: string, checkpoint: AgentCheckpoint): string;
 export declare function injectRestorationDirective(checkpoint?: AgentCheckpoint, fallback?: {
     model?: {

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

@@ -1 +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"}
+{"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,2BAA2B,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOlG,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;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACzC,4BAA4B,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED,wBAAgB,+BAA+B,IAAI,yBAAyB,CAE3E;AAoBD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,yBAAyB,EAChC,UAAU,EAAE,eAAe,GAAG,IAAI,EAClC,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,GAAG,SAAS,GACzD,2BAA2B,CAAC,SAAS,CAAC,GAAG,SAAS,CAMpD;AAED,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"}

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

@@ -1,3 +1,4 @@
+import { POST_COMPACT_RESTORATION_CUSTOM_TYPE } from "./restoration-tracker.js";
 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]";
@@ -118,6 +119,37 @@ function buildRestorationHints(checkpoint) {
     ];
     return lines.join("\n");
 }
+export function createRestorationDirectiveState() {
+    return { deliveredCheckpointTimestamp: null };
+}
+function directiveMessage(checkpoint) {
+    return {
+        customType: POST_COMPACT_RESTORATION_CUSTOM_TYPE,
+        content: buildRestorationHints(checkpoint),
+        display: false,
+    };
+}
+function withDirective(message, checkpoint) {
+    const hints = buildRestorationHints(checkpoint);
+    const existing = typeof message.content === "string" ? message.content : undefined;
+    if (existing === undefined)
+        return message;
+    return { ...message, content: `${hints}\n\n${existing}` };
+}
+/**
+ * Attach the restoration directive to the one-shot post-compact message, once
+ * per checkpoint. Returns the pending message unchanged when the checkpoint is
+ * stale or its directive was already delivered.
+ */
+export function attachRestorationDirective(state, checkpoint, message) {
+    if (!checkpoint)
+        return message;
+    const timestamp = checkpoint.timestamp ?? null;
+    if (timestamp !== null && state.deliveredCheckpointTimestamp === timestamp)
+        return message;
+    state.deliveredCheckpointTimestamp = timestamp;
+    return message ? withDirective(message, checkpoint) : directiveMessage(checkpoint);
+}
 export function injectRestorationDirective(systemPromptOrCheckpoint, checkpointOrFallback) {
     if (typeof systemPromptOrCheckpoint === "string") {
         const checkpoint = checkpointOrFallback;

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

@@ -1 +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.ts\";\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"]}
+{"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 { BeforeAgentStartEventResult, ExtensionAPI, ExtensionContext } from \"../../types.ts\";\nimport { POST_COMPACT_RESTORATION_CUSTOM_TYPE } from \"./restoration-tracker.ts\";\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\n/**\n * One-shot delivery state for the checkpoint restoration directive.\n *\n * Before 2026-08-01 the directive was appended to the system prompt on every\n * request inside the 60s checkpoint window; it now rides the hidden post-compact\n * restoration message exactly once per checkpoint. See changes.md.\n */\nexport interface RestorationDirectiveState {\n\tdeliveredCheckpointTimestamp: number | null;\n}\n\nexport function createRestorationDirectiveState(): RestorationDirectiveState {\n\treturn { deliveredCheckpointTimestamp: null };\n}\n\nfunction directiveMessage(checkpoint: AgentCheckpoint): NonNullable<BeforeAgentStartEventResult[\"message\"]> {\n\treturn {\n\t\tcustomType: POST_COMPACT_RESTORATION_CUSTOM_TYPE,\n\t\tcontent: buildRestorationHints(checkpoint),\n\t\tdisplay: false,\n\t};\n}\n\nfunction withDirective(\n\tmessage: NonNullable<BeforeAgentStartEventResult[\"message\"]>,\n\tcheckpoint: AgentCheckpoint,\n): NonNullable<BeforeAgentStartEventResult[\"message\"]> {\n\tconst hints = buildRestorationHints(checkpoint);\n\tconst existing = typeof message.content === \"string\" ? message.content : undefined;\n\tif (existing === undefined) return message;\n\treturn { ...message, content: `${hints}\\n\\n${existing}` };\n}\n\n/**\n * Attach the restoration directive to the one-shot post-compact message, once\n * per checkpoint. Returns the pending message unchanged when the checkpoint is\n * stale or its directive was already delivered.\n */\nexport function attachRestorationDirective(\n\tstate: RestorationDirectiveState,\n\tcheckpoint: AgentCheckpoint | null,\n\tmessage: BeforeAgentStartEventResult[\"message\"] | undefined,\n): BeforeAgentStartEventResult[\"message\"] | undefined {\n\tif (!checkpoint) return message;\n\tconst timestamp = checkpoint.timestamp ?? null;\n\tif (timestamp !== null && state.deliveredCheckpointTimestamp === timestamp) return message;\n\tstate.deliveredCheckpointTimestamp = timestamp;\n\treturn message ? withDirective(message, checkpoint) : directiveMessage(checkpoint);\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/deterministic-fallback.d.ts

@@ -0,0 +1,18 @@
+import { type CompactionPreparation, type CompactionResult } from "../../../compaction/index.ts";
+import { type SessionEntry } from "../../../session-manager.ts";
+export type RequiredCompactionFallbackFailure = "summarization-timeout" | "upstream-stream-truncated" | "summarization-overflow-exhausted";
+interface RecoveryMetadata {
+    taskIntent?: string;
+    todoSnapshot?: unknown;
+    checkpoint?: unknown;
+}
+interface DeterministicFallbackDetails {
+    schema: "senpi.compaction.deterministic-fallback.v1";
+    origin: "required-compaction-recovery";
+    failureKind: RequiredCompactionFallbackFailure;
+    retainedSuffix?: "prepared";
+}
+export declare function classifyRequiredCompactionFallbackFailure(error: unknown): RequiredCompactionFallbackFailure | undefined;
+export declare function createRequiredCompactionFallback(preparation: CompactionPreparation, contextWindow: number, failureKind: RequiredCompactionFallbackFailure, metadata: RecoveryMetadata, branchEntries?: SessionEntry[]): CompactionResult<DeterministicFallbackDetails> | undefined;
+export {};
+//# sourceMappingURL=deterministic-fallback.d.ts.map

package/dist/core/extensions/builtin/compaction/deterministic-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deterministic-fallback.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/deterministic-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,gBAAgB,EAAyB,MAAM,8BAA8B,CAAC;AAExH,OAAO,EAA6C,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAK3G,MAAM,MAAM,iCAAiC,GAC1C,uBAAuB,GACvB,2BAA2B,GAC3B,kCAAkC,CAAC;AAEtC,UAAU,gBAAgB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,4BAA4B;IACrC,MAAM,EAAE,4CAA4C,CAAC;IACrD,MAAM,EAAE,8BAA8B,CAAC;IACvC,WAAW,EAAE,iCAAiC,CAAC;IAC/C,cAAc,CAAC,EAAE,UAAU,CAAC;CAC5B;AAED,wBAAgB,yCAAyC,CACxD,KAAK,EAAE,OAAO,GACZ,iCAAiC,GAAG,SAAS,CAW/C;AAED,wBAAgB,gCAAgC,CAC/C,WAAW,EAAE,qBAAqB,EAClC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,iCAAiC,EAC9C,QAAQ,EAAE,gBAAgB,EAC1B,aAAa,GAAE,YAAY,EAAO,GAChC,gBAAgB,CAAC,4BAA4B,CAAC,GAAG,SAAS,CAyD5D"}

package/dist/core/extensions/builtin/compaction/deterministic-fallback.js

@@ -0,0 +1,73 @@
+import { estimateContextTokens } from "../../../compaction/index.js";
+import { StreamDurationBudgetError, StreamIdleTimeoutError } from "../../../compaction/stream-watchdog.js";
+import { buildSessionContext } from "../../../session-manager.js";
+import { SummarizationOverflowExhaustedError } from "./overflow-retry.js";
+import { SummaryRequestError } from "./speculative.js";
+import { capUtf8Bytes } from "./task-intent.js";
+export function classifyRequiredCompactionFallbackFailure(error) {
+    if (error instanceof StreamDurationBudgetError || error instanceof StreamIdleTimeoutError) {
+        return "summarization-timeout";
+    }
+    if (error instanceof SummaryRequestError && error.transient && error.failureKind === "upstream-stream-truncated") {
+        return "upstream-stream-truncated";
+    }
+    if (error instanceof SummarizationOverflowExhaustedError) {
+        return "summarization-overflow-exhausted";
+    }
+    return undefined;
+}
+export function createRequiredCompactionFallback(preparation, contextWindow, failureKind, metadata, branchEntries = []) {
+    if (!preparation.firstKeptEntryId || !branchEntries.some((entry) => entry.id === preparation.firstKeptEntryId)) {
+        return undefined;
+    }
+    const marker = [
+        "[Deterministic compaction recovery checkpoint]",
+        "Generated summarization did not complete, so older context was reduced without another provider request.",
+        "Continue from the retained messages after this checkpoint. Treat omitted transcript details as unknown.",
+    ].join("\n");
+    const taskIntent = metadata.taskIntent?.trim();
+    const fixedText = taskIntent ? `${marker}\n\nTask intent:\n${taskIntent}` : marker;
+    const maxSummaryBytes = Math.max(1_024, Math.floor(contextWindow * 0.4));
+    const previousSummary = preparation.previousSummary?.trim();
+    let summary = fixedText;
+    if (previousSummary) {
+        const availableBytes = Math.max(0, maxSummaryBytes - Buffer.byteLength(`${fixedText}\n\nPrevious checkpoint:\n`));
+        const truncationMarker = "\n[Older checkpoint truncated]";
+        const boundedPrevious = Buffer.byteLength(previousSummary) <= availableBytes
+            ? previousSummary
+            : `${capUtf8Bytes(previousSummary, Math.max(0, availableBytes - Buffer.byteLength(truncationMarker)))}${truncationMarker}`;
+        summary = `${fixedText}\n\nPrevious checkpoint:\n${boundedPrevious}`;
+    }
+    const baseDetails = {
+        schema: "senpi.compaction.deterministic-fallback.v1",
+        origin: "required-compaction-recovery",
+        failureKind,
+        ...(taskIntent ? { taskIntent } : {}),
+    };
+    const result = {
+        summary,
+        firstKeptEntryId: preparation.firstKeptEntryId,
+        tokensBefore: preparation.tokensBefore,
+        details: baseDetails,
+    };
+    const syntheticCompaction = {
+        type: "compaction",
+        id: "__senpi_deterministic_fallback_preview__",
+        parentId: branchEntries.at(-1)?.id ?? null,
+        timestamp: new Date(0).toISOString(),
+        summary: result.summary,
+        firstKeptEntryId: result.firstKeptEntryId,
+        tokensBefore: result.tokensBefore,
+        details: result.details,
+        fromHook: true,
+    };
+    const retainedTokens = estimateContextTokens(buildSessionContext([...branchEntries, syntheticCompaction]).messages).tokens;
+    if (retainedTokens > contextWindow - preparation.settings.reserveTokens)
+        return undefined;
+    return {
+        ...result,
+        estimatedTokensAfter: retainedTokens,
+        details: { ...baseDetails, retainedSuffix: "prepared" },
+    };
+}
+//# sourceMappingURL=deterministic-fallback.js.map

package/dist/core/extensions/builtin/compaction/deterministic-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deterministic-fallback.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/deterministic-fallback.ts"],"names":[],"mappings":"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","sourcesContent":["import { type CompactionPreparation, type CompactionResult, estimateContextTokens } from \"../../../compaction/index.ts\";\nimport { StreamDurationBudgetError, StreamIdleTimeoutError } from \"../../../compaction/stream-watchdog.ts\";\nimport { buildSessionContext, type CompactionEntry, type SessionEntry } from \"../../../session-manager.ts\";\nimport { SummarizationOverflowExhaustedError } from \"./overflow-retry.ts\";\nimport { SummaryRequestError } from \"./speculative.ts\";\nimport { capUtf8Bytes } from \"./task-intent.ts\";\n\nexport type RequiredCompactionFallbackFailure =\n\t| \"summarization-timeout\"\n\t| \"upstream-stream-truncated\"\n\t| \"summarization-overflow-exhausted\";\n\ninterface RecoveryMetadata {\n\ttaskIntent?: string;\n\ttodoSnapshot?: unknown;\n\tcheckpoint?: unknown;\n}\n\ninterface DeterministicFallbackDetails {\n\tschema: \"senpi.compaction.deterministic-fallback.v1\";\n\torigin: \"required-compaction-recovery\";\n\tfailureKind: RequiredCompactionFallbackFailure;\n\tretainedSuffix?: \"prepared\";\n}\n\nexport function classifyRequiredCompactionFallbackFailure(\n\terror: unknown,\n): RequiredCompactionFallbackFailure | undefined {\n\tif (error instanceof StreamDurationBudgetError || error instanceof StreamIdleTimeoutError) {\n\t\treturn \"summarization-timeout\";\n\t}\n\tif (error instanceof SummaryRequestError && error.transient && error.failureKind === \"upstream-stream-truncated\") {\n\t\treturn \"upstream-stream-truncated\";\n\t}\n\tif (error instanceof SummarizationOverflowExhaustedError) {\n\t\treturn \"summarization-overflow-exhausted\";\n\t}\n\treturn undefined;\n}\n\nexport function createRequiredCompactionFallback(\n\tpreparation: CompactionPreparation,\n\tcontextWindow: number,\n\tfailureKind: RequiredCompactionFallbackFailure,\n\tmetadata: RecoveryMetadata,\n\tbranchEntries: SessionEntry[] = [],\n): CompactionResult<DeterministicFallbackDetails> | undefined {\n\tif (!preparation.firstKeptEntryId || !branchEntries.some((entry) => entry.id === preparation.firstKeptEntryId)) {\n\t\treturn undefined;\n\t}\n\n\tconst marker = [\n\t\t\"[Deterministic compaction recovery checkpoint]\",\n\t\t\"Generated summarization did not complete, so older context was reduced without another provider request.\",\n\t\t\"Continue from the retained messages after this checkpoint. Treat omitted transcript details as unknown.\",\n\t].join(\"\\n\");\n\tconst taskIntent = metadata.taskIntent?.trim();\n\tconst fixedText = taskIntent ? `${marker}\\n\\nTask intent:\\n${taskIntent}` : marker;\n\tconst maxSummaryBytes = Math.max(1_024, Math.floor(contextWindow * 0.4));\n\tconst previousSummary = preparation.previousSummary?.trim();\n\tlet summary = fixedText;\n\tif (previousSummary) {\n\t\tconst availableBytes = Math.max(0, maxSummaryBytes - Buffer.byteLength(`${fixedText}\\n\\nPrevious checkpoint:\\n`));\n\t\tconst truncationMarker = \"\\n[Older checkpoint truncated]\";\n\t\tconst boundedPrevious =\n\t\t\tBuffer.byteLength(previousSummary) <= availableBytes\n\t\t\t\t? previousSummary\n\t\t\t\t: `${capUtf8Bytes(previousSummary, Math.max(0, availableBytes - Buffer.byteLength(truncationMarker)))}${truncationMarker}`;\n\t\tsummary = `${fixedText}\\n\\nPrevious checkpoint:\\n${boundedPrevious}`;\n\t}\n\n\tconst baseDetails: DeterministicFallbackDetails = {\n\t\tschema: \"senpi.compaction.deterministic-fallback.v1\",\n\t\torigin: \"required-compaction-recovery\",\n\t\tfailureKind,\n\t\t...(taskIntent ? { taskIntent } : {}),\n\t};\n\tconst result: CompactionResult<DeterministicFallbackDetails> = {\n\t\tsummary,\n\t\tfirstKeptEntryId: preparation.firstKeptEntryId,\n\t\ttokensBefore: preparation.tokensBefore,\n\t\tdetails: baseDetails,\n\t};\n\tconst syntheticCompaction: CompactionEntry = {\n\t\ttype: \"compaction\",\n\t\tid: \"__senpi_deterministic_fallback_preview__\",\n\t\tparentId: branchEntries.at(-1)?.id ?? null,\n\t\ttimestamp: new Date(0).toISOString(),\n\t\tsummary: result.summary,\n\t\tfirstKeptEntryId: result.firstKeptEntryId,\n\t\ttokensBefore: result.tokensBefore,\n\t\tdetails: result.details,\n\t\tfromHook: true,\n\t};\n\tconst retainedTokens = estimateContextTokens(\n\t\tbuildSessionContext([...branchEntries, syntheticCompaction]).messages,\n\t).tokens;\n\tif (retainedTokens > contextWindow - preparation.settings.reserveTokens) return undefined;\n\treturn {\n\t\t...result,\n\t\testimatedTokensAfter: retainedTokens,\n\t\tdetails: { ...baseDetails, retainedSuffix: \"prepared\" },\n\t};\n}\n"]}

package/dist/core/extensions/builtin/compaction/idle-retry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Retry policy for the idle compaction warm-up.
+ *
+ * The `agent_end` idle trigger only warms a speculative summary (#561 forbids
+ * committing a durable boundary at idle). A transient summarization failure
+ * used to leave a dead warm job for the whole idle period, forcing a fresh
+ * blocking summarization onto the user's critical path at the next prompt.
+ * While the session stays idle, a transient failure is retried a bounded
+ * number of times with a fresh snapshot instead.
+ */
+export declare const MAX_IDLE_WARMUP_RETRIES = 2;
+export declare const IDLE_WARMUP_RETRY_DELAY_MS = 15000;
+export interface IdleWarmupRetryDecision {
+    readonly attempt: number;
+    readonly transient: boolean;
+    readonly isIdle: boolean;
+    readonly breakerTripped: boolean;
+    readonly stillOverThreshold: boolean;
+}
+export declare function shouldRetryIdleWarmup(decision: IdleWarmupRetryDecision): boolean;
+//# sourceMappingURL=idle-retry.d.ts.map

package/dist/core/extensions/builtin/compaction/idle-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-retry.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/idle-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACrC;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAMhF"}

package/dist/core/extensions/builtin/compaction/idle-retry.js

@@ -0,0 +1,24 @@
+/**
+ * Retry policy for the idle compaction warm-up.
+ *
+ * The `agent_end` idle trigger only warms a speculative summary (#561 forbids
+ * committing a durable boundary at idle). A transient summarization failure
+ * used to leave a dead warm job for the whole idle period, forcing a fresh
+ * blocking summarization onto the user's critical path at the next prompt.
+ * While the session stays idle, a transient failure is retried a bounded
+ * number of times with a fresh snapshot instead.
+ */
+export const MAX_IDLE_WARMUP_RETRIES = 2;
+export const IDLE_WARMUP_RETRY_DELAY_MS = 15_000;
+export function shouldRetryIdleWarmup(decision) {
+    if (!decision.transient)
+        return false;
+    if (!decision.isIdle)
+        return false;
+    if (decision.breakerTripped)
+        return false;
+    if (!decision.stillOverThreshold)
+        return false;
+    return decision.attempt < MAX_IDLE_WARMUP_RETRIES;
+}
+//# sourceMappingURL=idle-retry.js.map

package/dist/core/extensions/builtin/compaction/idle-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-retry.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/idle-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAUjD,MAAM,UAAU,qBAAqB,CAAC,QAAiC;IACtE,IAAI,CAAC,QAAQ,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,QAAQ,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,kBAAkB;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,QAAQ,CAAC,OAAO,GAAG,uBAAuB,CAAC;AACnD,CAAC","sourcesContent":["/**\n * Retry policy for the idle compaction warm-up.\n *\n * The `agent_end` idle trigger only warms a speculative summary (#561 forbids\n * committing a durable boundary at idle). A transient summarization failure\n * used to leave a dead warm job for the whole idle period, forcing a fresh\n * blocking summarization onto the user's critical path at the next prompt.\n * While the session stays idle, a transient failure is retried a bounded\n * number of times with a fresh snapshot instead.\n */\n\nexport const MAX_IDLE_WARMUP_RETRIES = 2;\nexport const IDLE_WARMUP_RETRY_DELAY_MS = 15_000;\n\nexport interface IdleWarmupRetryDecision {\n\treadonly attempt: number;\n\treadonly transient: boolean;\n\treadonly isIdle: boolean;\n\treadonly breakerTripped: boolean;\n\treadonly stillOverThreshold: boolean;\n}\n\nexport function shouldRetryIdleWarmup(decision: IdleWarmupRetryDecision): boolean {\n\tif (!decision.transient) return false;\n\tif (!decision.isIdle) return false;\n\tif (decision.breakerTripped) return false;\n\tif (!decision.stillOverThreshold) return false;\n\treturn decision.attempt < MAX_IDLE_WARMUP_RETRIES;\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEX,YAAY,EAIZ,MAAM,gBAAgB,CAAC;AAiBxB,OAAO,EAEN,KAAK,kCAAkC,EAIvC,MAAM,oBAAoB,CAAC;AA4H5B,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAC1C,EAAE,EAAE,YAAY,EAChB,4BAA4B,GAAE,kCAAuC,GACnE,IAAI,CAwhBN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEX,YAAY,EAIZ,MAAM,gBAAgB,CAAC;AA4BxB,OAAO,EAEN,KAAK,kCAAkC,EAIvC,MAAM,oBAAoB,CAAC;AAiI5B,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAC1C,EAAE,EAAE,YAAY,EAChB,4BAA4B,GAAE,kCAAuC,GACnE,IAAI,CAqoBN"}