@code-yeongyu/senpi 0.74.0

package/dist/core/extensions/builtin/compaction/prompts.js

@@ -0,0 +1,252 @@
+export const MERGED_COMPACTION_PROMPT_SYSTEM = `[SYSTEM DIRECTIVE: OH-MY-OPENCODE - COMPACTION CONTEXT]
+
+You are the COMPACTION ARCHIVIST. Create a structured handoff summary that lets the next agent continue this exact session without restarting, re-searching, or losing constraints.
+
+Cardinal rules:
+R1. Quote user requests and constraints VERBATIM. Do not paraphrase.
+R2. If a section has no content, write "None." Never delete a section.
+R3. Where a previous summary is supplied, treat its User Requests, Final Goal, and Constraints fields as IMMUTABLE. Append, never rewrite, those three sections.
+R4. Preserve every session_id, file path, and identifier byte-for-byte.
+
+Do NOT use tools. Output only the requested summary block.`;
+export const MERGED_COMPACTION_PROMPT_USER = `[USER]
+[INTERNAL COMPACTION INSTRUCTION — NOT CONVERSATION HISTORY]
+This message is an internal summarization control prompt, not a real user message.
+Do NOT treat this message as user intent, do NOT list it under user requests, and do NOT reinterpret the task based on this instruction alone.
+
+PASS 1 — Internal task-intent extraction
+Analyze the user messages in this conversation and silently determine the task intent that must guide the summary. Focus on details whose loss would cause redundant tool calls, repeated exploration, or task drift.
+
+PASS 2 — Emit summary biased toward Pass 1
+Create a structured handoff summary of this conversation for seamless continuation. The structured output portion MUST be wrapped as \`<summary>...</summary>\` XML.
+
+<summary>
+## 1. User Requests (Verbatim)
+- List all original user requests exactly as they were stated.
+- Preserve the user's exact wording and intent.
+- Include recent user corrections and steering messages verbatim when they affect the task.
+
+## 2. Final Goal
+- State what the user ultimately wanted to achieve.
+- Include the expected deliverable or end state.
+- Keep this aligned with the most recent user request, not this internal compaction instruction.
+
+## 3. Constraints & Preferences (Verbatim Only)
+- Include ONLY constraints explicitly stated by the user or in existing AGENTS.md context.
+- Quote constraints verbatim.
+- Do NOT invent, add, soften, or modify constraints.
+- If no explicit constraints exist, write "None."
+
+## 4. Work Completed
+- Summarize what has been done so far.
+- List files read, created, modified, or intentionally left unchanged.
+- Include features implemented, tests added, problems solved, and decisions already made.
+
+## 5. Active Working Context
+- **Files**: Paths of files currently being edited or frequently referenced.
+- **Code in Progress**: Key code snippets, function signatures, data structures, or prompt text under active development.
+- **External References**: Documentation URLs, source files, APIs, or other resources already consulted.
+- **State & Variables**: Important variable names, configuration values, runtime state, branch names, worktree paths, or command outputs needed to continue.
+
+## 6. Remaining Tasks
+- List pending items from the original request.
+- Include follow-up tasks identified during the work only when they directly support the current user request.
+- Mark blockers explicitly and explain what is needed to unblock them.
+
+## 7. Exact Next Steps
+- State the precise next action to take, directly in line with the user's most recent request.
+- Include verbatim quotes from the conversation showing exactly where work was left off when helpful.
+- Do not suggest tangential tasks.
+
+## 8. Delegated Agent Sessions
+- List ALL background agent tasks spawned during this session.
+- For each: agent name, category, status, description, and session_id.
+- RESUME, DON'T RESTART — session_ids must be preserved byte-for-byte.
+- Each listed session retains full context. After compaction, use session_id to continue existing agent sessions instead of spawning new ones.
+
+## 9. Agent Verification State (CONDITIONAL — emit only for reviewer agents)
+- **Current Agent**: What agent is running.
+- **Verification Progress**: Files already verified or validated.
+- **Pending Verifications**: Files still needing verification.
+- **Previous Rejections**: If reviewer agent, what was rejected and why.
+- **Acceptance Status**: Current state of review process.
+</summary>
+
+Verification: Before finalizing, confirm the summary clearly states the user's original request. If not, restate it verbatim.
+IMPORTANT: Respond with ONLY the <summary>...</summary> block as your text output.`;
+export const MERGED_COMPACTION_PROMPT_UPDATE = `[USER]
+<previous-summary>
+{{previousSummary}}
+</previous-summary>
+
+[INTERNAL COMPACTION UPDATE INSTRUCTION — NOT CONVERSATION HISTORY]
+The messages above are NEW conversation messages to incorporate into the existing summary provided in <previous-summary> tags.
+
+R3 enforcement: R3. Where a previous summary is supplied, treat its User Requests, Final Goal, and Constraints fields as IMMUTABLE. Append, never rewrite, those three sections.
+
+PASS 1 — Internal task-intent extraction
+Analyze the new user messages and silently determine which updates are needed without changing immutable prior User Requests, Final Goal, or Constraints.
+
+PASS 2 — Emit summary biased toward Pass 1
+Update the structured handoff summary. The structured output portion MUST be wrapped as \`<summary>...</summary>\` XML.
+
+<summary>
+## 1. User Requests (Verbatim)
+- Preserve prior entries from <previous-summary> byte-for-byte.
+- Append new user requests exactly as they were stated.
+
+## 2. Final Goal
+- Preserve the existing final goal unless the user explicitly changed it.
+- Append the explicit change verbatim if the goal changed.
+
+## 3. Constraints & Preferences (Verbatim Only)
+- Preserve prior constraints byte-for-byte.
+- Quote constraints verbatim.
+- Do NOT invent, add, soften, or modify constraints.
+- Append only new explicit constraints.
+- If no explicit constraints exist, write "None."
+
+## 4. Work Completed
+- Preserve completed work from the previous summary.
+- Add newly completed work, files changed, tests run, and decisions made.
+
+## 5. Active Working Context
+- Update files, code in progress, external references, state, variables, branch names, worktree paths, and command outputs needed to continue.
+
+## 6. Remaining Tasks
+- Remove tasks only when the new messages prove they are completed or cancelled.
+- Add newly identified direct follow-up tasks.
+
+## 7. Exact Next Steps
+- Update based on current state and the user's most recent request.
+- Keep this direct and immediately actionable.
+
+## 8. Delegated Agent Sessions
+- Preserve every existing agent name, status, description, and session_id byte-for-byte unless updated by new messages.
+- RESUME, DON'T RESTART — session_ids must be preserved byte-for-byte.
+
+## 9. Agent Verification State (CONDITIONAL — emit only for reviewer agents)
+- Preserve reviewer context and update verification progress, pending verifications, previous rejections, and acceptance status.
+</summary>
+
+IMPORTANT: Respond with ONLY the <summary>...</summary> block as your text output.`;
+export const MERGED_COMPACTION_PROMPT_BRANCH = `[USER]
+[INTERNAL BRANCH SUMMARY INSTRUCTION — NOT CONVERSATION HISTORY]
+Create a structured summary of this conversation branch for context when returning later. This is a branch-level handoff, so reorient §2 toward the branched intent and why this branch exists.
+
+PASS 1 — Internal task-intent extraction
+Analyze this branch and silently determine the branch-specific intent, divergence point, and details whose loss would cause repeated work.
+
+PASS 2 — Emit summary biased toward Pass 1
+Create a structured branch handoff summary. The structured output portion MUST be wrapped as \`<summary>...</summary>\` XML.
+
+<summary>
+## 1. User Requests (Verbatim)
+- List user requests that caused or shaped this branch exactly as they were stated.
+- Preserve the user's exact wording and intent.
+
+## 2. Final Goal
+- State the branched intent: what this branch was trying to accomplish, test, compare, or preserve.
+- Include how this branch differs from the mainline path when known.
+
+## 3. Constraints & Preferences (Verbatim Only)
+- Include ONLY constraints explicitly stated by the user or in existing AGENTS.md context.
+- Quote constraints verbatim.
+- Do NOT invent, add, soften, or modify constraints.
+- If no explicit constraints exist, write "None."
+
+## 4. Work Completed
+- Summarize branch-specific progress.
+- List files read, created, modified, or intentionally left unchanged on this branch.
+
+## 5. Active Working Context
+- **Files**: Paths of files currently edited or frequently referenced in this branch.
+- **Code in Progress**: Key snippets, signatures, data structures, or prompt text under active development.
+- **External References**: Sources already consulted for this branch.
+- **State & Variables**: Branch names, worktree paths, runtime state, command outputs, and identifiers needed to resume.
+
+## 6. Remaining Tasks
+- List branch-specific work still needed.
+- Include blockers and the concrete condition needed to unblock them.
+
+## 7. Exact Next Steps
+- State the precise next action for returning to this branch.
+- Do not suggest tangential tasks.
+
+## 8. Delegated Agent Sessions
+- List branch-relevant background agent tasks.
+- For each: agent name, category, status, description, and session_id.
+- RESUME, DON'T RESTART — session_ids must be preserved byte-for-byte.
+</summary>
+
+IMPORTANT: Respond with ONLY the <summary>...</summary> block as your text output.`;
+export const MERGED_COMPACTION_PROMPT_TURN_PREFIX = `[USER]
+[INTERNAL TURN-PREFIX SUMMARY INSTRUCTION — NOT CONVERSATION HISTORY]
+Create a compact prefix summary for the next turn. Emit only the sections listed below.
+
+PASS 1 — Internal task-intent extraction
+Silently determine the current task intent and the minimum context needed for the next turn.
+
+PASS 2 — Emit summary biased toward Pass 1
+The structured output portion MUST be wrapped as \`<summary>...</summary>\` XML.
+
+<summary>
+## 1. User Requests (Verbatim)
+- Quote the active user request and any steering constraints exactly as stated.
+
+## 2. Final Goal
+- State the immediate end state needed for the next turn.
+
+## 3. Constraints & Preferences (Verbatim Only)
+- Quote constraints verbatim.
+- Do NOT invent, add, soften, or modify constraints.
+- If no explicit constraints exist, write "None."
+
+## 5. Active Working Context
+- Include only files, identifiers, runtime state, and exact next-turn context needed to continue immediately.
+</summary>
+
+IMPORTANT: Respond with ONLY the <summary>...</summary> block as your text output.`;
+export function buildPrompt(options) {
+    const user = buildUserPrompt(options);
+    return {
+        system: MERGED_COMPACTION_PROMPT_SYSTEM,
+        user: appendCustomInstructions(user, options.customInstructions),
+    };
+}
+function buildUserPrompt(options) {
+    switch (options.variant) {
+        case "default":
+            return MERGED_COMPACTION_PROMPT_USER;
+        case "update":
+            return MERGED_COMPACTION_PROMPT_UPDATE.replace("{{previousSummary}}", sanitizePreviousSummary(options.previousSummary));
+        case "branch":
+            return MERGED_COMPACTION_PROMPT_BRANCH;
+        case "turn_prefix":
+            return MERGED_COMPACTION_PROMPT_TURN_PREFIX;
+    }
+    const exhaustiveCheck = options.variant;
+    return exhaustiveCheck;
+}
+function appendCustomInstructions(userPrompt, customInstructions) {
+    const trimmedInstructions = customInstructions?.trim();
+    if (!trimmedInstructions) {
+        return userPrompt;
+    }
+    return `${userPrompt}
+
+<custom-instructions>
+${sanitizeCustomInstructions(trimmedInstructions)}
+</custom-instructions>`;
+}
+function sanitizePreviousSummary(previousSummary) {
+    const trimmedSummary = previousSummary?.trim();
+    if (!trimmedSummary) {
+        return "None.";
+    }
+    return trimmedSummary.split("</previous-summary>").join("[/previous-summary]");
+}
+function sanitizeCustomInstructions(customInstructions) {
+    return customInstructions.split("</custom-instructions>").join("[/custom-instructions]");
+}
+//# sourceMappingURL=prompts.js.map

package/dist/core/extensions/builtin/compaction/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/prompts.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;;;;2DAUY,CAAC;AAE5D,MAAM,CAAC,MAAM,6BAA6B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mFAgEsC,CAAC;AAEpF,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mFAuDoC,CAAC;AAEpF,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mFAiDoC,CAAC;AAEpF,MAAM,CAAC,MAAM,oCAAoC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;mFA0B+B,CAAC;AAEpF,MAAM,UAAU,WAAW,CAAC,OAA2C,EAAoC;IAC1G,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAEtC,OAAO;QACN,MAAM,EAAE,+BAA+B;QACvC,IAAI,EAAE,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,kBAAkB,CAAC;KAChE,CAAC;AAAA,CACF;AAED,SAAS,eAAe,CAAC,OAA2C,EAAU;IAC7E,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC;QACzB,KAAK,SAAS;YACb,OAAO,6BAA6B,CAAC;QACtC,KAAK,QAAQ;YACZ,OAAO,+BAA+B,CAAC,OAAO,CAC7C,qBAAqB,EACrB,uBAAuB,CAAC,OAAO,CAAC,eAAe,CAAC,CAChD,CAAC;QACH,KAAK,QAAQ;YACZ,OAAO,+BAA+B,CAAC;QACxC,KAAK,aAAa;YACjB,OAAO,oCAAoC,CAAC;IAC9C,CAAC;IAED,MAAM,eAAe,GAAU,OAAO,CAAC,OAAO,CAAC;IAC/C,OAAO,eAAe,CAAC;AAAA,CACvB;AAED,SAAS,wBAAwB,CAAC,UAAkB,EAAE,kBAAsC,EAAU;IACrG,MAAM,mBAAmB,GAAG,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACvD,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,OAAO,GAAG,UAAU;;;EAGnB,0BAA0B,CAAC,mBAAmB,CAAC;uBAC1B,CAAC;AAAA,CACvB;AAED,SAAS,uBAAuB,CAAC,eAAmC,EAAU;IAC7E,MAAM,cAAc,GAAG,eAAe,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAI,CAAC,cAAc,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,OAAO,cAAc,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAAA,CAC/E;AAED,SAAS,0BAA0B,CAAC,kBAA0B,EAAU;IACvE,OAAO,kBAAkB,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;AAAA,CACzF","sourcesContent":["export type MergedCompactionPromptVariant = \"default\" | \"update\" | \"branch\" | \"turn_prefix\";\n\nexport type BuildMergedCompactionPromptOptions = {\n\tvariant: MergedCompactionPromptVariant;\n\tpreviousSummary?: string;\n\tcustomInstructions?: string;\n};\n\nexport const MERGED_COMPACTION_PROMPT_SYSTEM = `[SYSTEM DIRECTIVE: OH-MY-OPENCODE - COMPACTION CONTEXT]\n\nYou are the COMPACTION ARCHIVIST. Create a structured handoff summary that lets the next agent continue this exact session without restarting, re-searching, or losing constraints.\n\nCardinal rules:\nR1. Quote user requests and constraints VERBATIM. Do not paraphrase.\nR2. If a section has no content, write \"None.\" Never delete a section.\nR3. Where a previous summary is supplied, treat its User Requests, Final Goal, and Constraints fields as IMMUTABLE. Append, never rewrite, those three sections.\nR4. Preserve every session_id, file path, and identifier byte-for-byte.\n\nDo NOT use tools. Output only the requested summary block.`;\n\nexport const MERGED_COMPACTION_PROMPT_USER = `[USER]\n[INTERNAL COMPACTION INSTRUCTION — NOT CONVERSATION HISTORY]\nThis message is an internal summarization control prompt, not a real user message.\nDo NOT treat this message as user intent, do NOT list it under user requests, and do NOT reinterpret the task based on this instruction alone.\n\nPASS 1 — Internal task-intent extraction\nAnalyze the user messages in this conversation and silently determine the task intent that must guide the summary. Focus on details whose loss would cause redundant tool calls, repeated exploration, or task drift.\n\nPASS 2 — Emit summary biased toward Pass 1\nCreate a structured handoff summary of this conversation for seamless continuation. The structured output portion MUST be wrapped as \\`<summary>...</summary>\\` XML.\n\n<summary>\n## 1. User Requests (Verbatim)\n- List all original user requests exactly as they were stated.\n- Preserve the user's exact wording and intent.\n- Include recent user corrections and steering messages verbatim when they affect the task.\n\n## 2. Final Goal\n- State what the user ultimately wanted to achieve.\n- Include the expected deliverable or end state.\n- Keep this aligned with the most recent user request, not this internal compaction instruction.\n\n## 3. Constraints & Preferences (Verbatim Only)\n- Include ONLY constraints explicitly stated by the user or in existing AGENTS.md context.\n- Quote constraints verbatim.\n- Do NOT invent, add, soften, or modify constraints.\n- If no explicit constraints exist, write \"None.\"\n\n## 4. Work Completed\n- Summarize what has been done so far.\n- List files read, created, modified, or intentionally left unchanged.\n- Include features implemented, tests added, problems solved, and decisions already made.\n\n## 5. Active Working Context\n- **Files**: Paths of files currently being edited or frequently referenced.\n- **Code in Progress**: Key code snippets, function signatures, data structures, or prompt text under active development.\n- **External References**: Documentation URLs, source files, APIs, or other resources already consulted.\n- **State & Variables**: Important variable names, configuration values, runtime state, branch names, worktree paths, or command outputs needed to continue.\n\n## 6. Remaining Tasks\n- List pending items from the original request.\n- Include follow-up tasks identified during the work only when they directly support the current user request.\n- Mark blockers explicitly and explain what is needed to unblock them.\n\n## 7. Exact Next Steps\n- State the precise next action to take, directly in line with the user's most recent request.\n- Include verbatim quotes from the conversation showing exactly where work was left off when helpful.\n- Do not suggest tangential tasks.\n\n## 8. Delegated Agent Sessions\n- List ALL background agent tasks spawned during this session.\n- For each: agent name, category, status, description, and session_id.\n- RESUME, DON'T RESTART — session_ids must be preserved byte-for-byte.\n- Each listed session retains full context. After compaction, use session_id to continue existing agent sessions instead of spawning new ones.\n\n## 9. Agent Verification State (CONDITIONAL — emit only for reviewer agents)\n- **Current Agent**: What agent is running.\n- **Verification Progress**: Files already verified or validated.\n- **Pending Verifications**: Files still needing verification.\n- **Previous Rejections**: If reviewer agent, what was rejected and why.\n- **Acceptance Status**: Current state of review process.\n</summary>\n\nVerification: Before finalizing, confirm the summary clearly states the user's original request. If not, restate it verbatim.\nIMPORTANT: Respond with ONLY the <summary>...</summary> block as your text output.`;\n\nexport const MERGED_COMPACTION_PROMPT_UPDATE = `[USER]\n<previous-summary>\n{{previousSummary}}\n</previous-summary>\n\n[INTERNAL COMPACTION UPDATE INSTRUCTION — NOT CONVERSATION HISTORY]\nThe messages above are NEW conversation messages to incorporate into the existing summary provided in <previous-summary> tags.\n\nR3 enforcement: R3. Where a previous summary is supplied, treat its User Requests, Final Goal, and Constraints fields as IMMUTABLE. Append, never rewrite, those three sections.\n\nPASS 1 — Internal task-intent extraction\nAnalyze the new user messages and silently determine which updates are needed without changing immutable prior User Requests, Final Goal, or Constraints.\n\nPASS 2 — Emit summary biased toward Pass 1\nUpdate the structured handoff summary. The structured output portion MUST be wrapped as \\`<summary>...</summary>\\` XML.\n\n<summary>\n## 1. User Requests (Verbatim)\n- Preserve prior entries from <previous-summary> byte-for-byte.\n- Append new user requests exactly as they were stated.\n\n## 2. Final Goal\n- Preserve the existing final goal unless the user explicitly changed it.\n- Append the explicit change verbatim if the goal changed.\n\n## 3. Constraints & Preferences (Verbatim Only)\n- Preserve prior constraints byte-for-byte.\n- Quote constraints verbatim.\n- Do NOT invent, add, soften, or modify constraints.\n- Append only new explicit constraints.\n- If no explicit constraints exist, write \"None.\"\n\n## 4. Work Completed\n- Preserve completed work from the previous summary.\n- Add newly completed work, files changed, tests run, and decisions made.\n\n## 5. Active Working Context\n- Update files, code in progress, external references, state, variables, branch names, worktree paths, and command outputs needed to continue.\n\n## 6. Remaining Tasks\n- Remove tasks only when the new messages prove they are completed or cancelled.\n- Add newly identified direct follow-up tasks.\n\n## 7. Exact Next Steps\n- Update based on current state and the user's most recent request.\n- Keep this direct and immediately actionable.\n\n## 8. Delegated Agent Sessions\n- Preserve every existing agent name, status, description, and session_id byte-for-byte unless updated by new messages.\n- RESUME, DON'T RESTART — session_ids must be preserved byte-for-byte.\n\n## 9. Agent Verification State (CONDITIONAL — emit only for reviewer agents)\n- Preserve reviewer context and update verification progress, pending verifications, previous rejections, and acceptance status.\n</summary>\n\nIMPORTANT: Respond with ONLY the <summary>...</summary> block as your text output.`;\n\nexport const MERGED_COMPACTION_PROMPT_BRANCH = `[USER]\n[INTERNAL BRANCH SUMMARY INSTRUCTION — NOT CONVERSATION HISTORY]\nCreate a structured summary of this conversation branch for context when returning later. This is a branch-level handoff, so reorient §2 toward the branched intent and why this branch exists.\n\nPASS 1 — Internal task-intent extraction\nAnalyze this branch and silently determine the branch-specific intent, divergence point, and details whose loss would cause repeated work.\n\nPASS 2 — Emit summary biased toward Pass 1\nCreate a structured branch handoff summary. The structured output portion MUST be wrapped as \\`<summary>...</summary>\\` XML.\n\n<summary>\n## 1. User Requests (Verbatim)\n- List user requests that caused or shaped this branch exactly as they were stated.\n- Preserve the user's exact wording and intent.\n\n## 2. Final Goal\n- State the branched intent: what this branch was trying to accomplish, test, compare, or preserve.\n- Include how this branch differs from the mainline path when known.\n\n## 3. Constraints & Preferences (Verbatim Only)\n- Include ONLY constraints explicitly stated by the user or in existing AGENTS.md context.\n- Quote constraints verbatim.\n- Do NOT invent, add, soften, or modify constraints.\n- If no explicit constraints exist, write \"None.\"\n\n## 4. Work Completed\n- Summarize branch-specific progress.\n- List files read, created, modified, or intentionally left unchanged on this branch.\n\n## 5. Active Working Context\n- **Files**: Paths of files currently edited or frequently referenced in this branch.\n- **Code in Progress**: Key snippets, signatures, data structures, or prompt text under active development.\n- **External References**: Sources already consulted for this branch.\n- **State & Variables**: Branch names, worktree paths, runtime state, command outputs, and identifiers needed to resume.\n\n## 6. Remaining Tasks\n- List branch-specific work still needed.\n- Include blockers and the concrete condition needed to unblock them.\n\n## 7. Exact Next Steps\n- State the precise next action for returning to this branch.\n- Do not suggest tangential tasks.\n\n## 8. Delegated Agent Sessions\n- List branch-relevant background agent tasks.\n- For each: agent name, category, status, description, and session_id.\n- RESUME, DON'T RESTART — session_ids must be preserved byte-for-byte.\n</summary>\n\nIMPORTANT: Respond with ONLY the <summary>...</summary> block as your text output.`;\n\nexport const MERGED_COMPACTION_PROMPT_TURN_PREFIX = `[USER]\n[INTERNAL TURN-PREFIX SUMMARY INSTRUCTION — NOT CONVERSATION HISTORY]\nCreate a compact prefix summary for the next turn. Emit only the sections listed below.\n\nPASS 1 — Internal task-intent extraction\nSilently determine the current task intent and the minimum context needed for the next turn.\n\nPASS 2 — Emit summary biased toward Pass 1\nThe structured output portion MUST be wrapped as \\`<summary>...</summary>\\` XML.\n\n<summary>\n## 1. User Requests (Verbatim)\n- Quote the active user request and any steering constraints exactly as stated.\n\n## 2. Final Goal\n- State the immediate end state needed for the next turn.\n\n## 3. Constraints & Preferences (Verbatim Only)\n- Quote constraints verbatim.\n- Do NOT invent, add, soften, or modify constraints.\n- If no explicit constraints exist, write \"None.\"\n\n## 5. Active Working Context\n- Include only files, identifiers, runtime state, and exact next-turn context needed to continue immediately.\n</summary>\n\nIMPORTANT: Respond with ONLY the <summary>...</summary> block as your text output.`;\n\nexport function buildPrompt(options: BuildMergedCompactionPromptOptions): { system: string; user: string } {\n\tconst user = buildUserPrompt(options);\n\n\treturn {\n\t\tsystem: MERGED_COMPACTION_PROMPT_SYSTEM,\n\t\tuser: appendCustomInstructions(user, options.customInstructions),\n\t};\n}\n\nfunction buildUserPrompt(options: BuildMergedCompactionPromptOptions): string {\n\tswitch (options.variant) {\n\t\tcase \"default\":\n\t\t\treturn MERGED_COMPACTION_PROMPT_USER;\n\t\tcase \"update\":\n\t\t\treturn MERGED_COMPACTION_PROMPT_UPDATE.replace(\n\t\t\t\t\"{{previousSummary}}\",\n\t\t\t\tsanitizePreviousSummary(options.previousSummary),\n\t\t\t);\n\t\tcase \"branch\":\n\t\t\treturn MERGED_COMPACTION_PROMPT_BRANCH;\n\t\tcase \"turn_prefix\":\n\t\t\treturn MERGED_COMPACTION_PROMPT_TURN_PREFIX;\n\t}\n\n\tconst exhaustiveCheck: never = options.variant;\n\treturn exhaustiveCheck;\n}\n\nfunction appendCustomInstructions(userPrompt: string, customInstructions: string | undefined): string {\n\tconst trimmedInstructions = customInstructions?.trim();\n\tif (!trimmedInstructions) {\n\t\treturn userPrompt;\n\t}\n\n\treturn `${userPrompt}\n\n<custom-instructions>\n${sanitizeCustomInstructions(trimmedInstructions)}\n</custom-instructions>`;\n}\n\nfunction sanitizePreviousSummary(previousSummary: string | undefined): string {\n\tconst trimmedSummary = previousSummary?.trim();\n\tif (!trimmedSummary) {\n\t\treturn \"None.\";\n\t}\n\n\treturn trimmedSummary.split(\"</previous-summary>\").join(\"[/previous-summary]\");\n}\n\nfunction sanitizeCustomInstructions(customInstructions: string): string {\n\treturn customInstructions.split(\"</custom-instructions>\").join(\"[/custom-instructions]\");\n}\n"]}

package/dist/core/extensions/builtin/compaction/restoration-tracker.d.ts

@@ -0,0 +1,57 @@
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import type { BeforeAgentStartEventResult, CompactionReason } from "../../types.js";
+export declare const POST_COMPACT_RESTORATION_CUSTOM_TYPE = "compaction.post-compact-restoration";
+declare const POST_COMPACT_RESTORATION_SCHEMA = "senpi.compaction.post-compact-restoration.v1";
+type RestorationItemType = "file" | "skill";
+export interface RestorationSettings {
+    restorationMaxItems?: number;
+    restorationMaxTokensPerItem?: number;
+    restorationMaxTotalTokens?: number;
+    restorationContextRatio?: number;
+}
+export interface MinimalToolCallEvent {
+    toolName: string;
+    input: Record<string, unknown>;
+}
+export interface RestorationItem {
+    content: string;
+    label: string;
+    priority: number;
+    tokens: number;
+    type: RestorationItemType;
+}
+export interface PendingRestorationPayload {
+    customType: typeof POST_COMPACT_RESTORATION_CUSTOM_TYPE;
+    content: string;
+    display: false;
+    details: {
+        schema: typeof POST_COMPACT_RESTORATION_SCHEMA;
+        budgetTokens: number;
+        compactionEntryId: string;
+        reason: CompactionReason;
+        items: RestorationItem[];
+    };
+    budgetTokens: number;
+}
+export interface PreparePendingPayloadOptions {
+    accepted: boolean;
+    reason: CompactionReason;
+    compactionEntryId: string;
+    contextWindow: number;
+    usageTokens: number | null;
+    reserveTokens: number;
+    settings?: RestorationSettings;
+    keptMessages?: AgentMessage[];
+}
+export interface RestorationTrackerState {
+    items: Map<string, RestorationItem>;
+    restoredLabels: Set<string>;
+    pendingPayload: PendingRestorationPayload | null;
+}
+export declare function createRestorationTrackerState(): RestorationTrackerState;
+export declare function trackToolCall(state: RestorationTrackerState, event: MinimalToolCallEvent): void;
+export declare function preparePendingPayload(state: RestorationTrackerState, options: PreparePendingPayloadOptions): void;
+export declare function consumePendingPayload(state: RestorationTrackerState): BeforeAgentStartEventResult["message"] | undefined;
+export declare function computeRestorationBudget(options: PreparePendingPayloadOptions): number;
+export {};
+//# sourceMappingURL=restoration-tracker.d.ts.map

package/dist/core/extensions/builtin/compaction/restoration-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoration-tracker.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/compaction/restoration-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGpF,eAAO,MAAM,oCAAoC,wCAAwC,CAAC;AAE1F,QAAA,MAAM,+BAA+B,iDAAiD,CAAC;AAMvF,KAAK,mBAAmB,GAAG,MAAM,GAAG,OAAO,CAAC;AAG5C,MAAM,WAAW,mBAAmB;IACnC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,mBAAmB,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACzC,UAAU,EAAE,OAAO,oCAAoC,CAAC;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE;QACR,MAAM,EAAE,OAAO,+BAA+B,CAAC;QAC/C,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,gBAAgB,CAAC;QACzB,KAAK,EAAE,eAAe,EAAE,CAAC;KACzB,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACpC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,cAAc,EAAE,yBAAyB,GAAG,IAAI,CAAC;CACjD;AAED,wBAAgB,6BAA6B,IAAI,uBAAuB,CAMvE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,uBAAuB,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAmB/F;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,uBAAuB,EAAE,OAAO,EAAE,4BAA4B,GAAG,IAAI,CA8BjH;AAED,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,uBAAuB,GAC5B,2BAA2B,CAAC,SAAS,CAAC,GAAG,SAAS,CAapD;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAQtF","sourcesContent":["import type { AgentMessage } from \"@earendil-works/pi-agent-core\";\nimport { estimateTokens } from \"../../../compaction/index.js\";\nimport type { BeforeAgentStartEventResult, CompactionReason } from \"../../types.js\";\nimport { extractPatchedPaths } from \"../gpt-apply-patch/index.js\";\n\nexport const POST_COMPACT_RESTORATION_CUSTOM_TYPE = \"compaction.post-compact-restoration\";\n\nconst POST_COMPACT_RESTORATION_SCHEMA = \"senpi.compaction.post-compact-restoration.v1\";\nconst DEFAULT_RESTORATION_MAX_ITEMS = 10;\nconst DEFAULT_RESTORATION_MAX_TOKENS_PER_ITEM = 5000;\nconst DEFAULT_RESTORATION_MAX_TOTAL_TOKENS = 50_000;\nconst DEFAULT_RESTORATION_CONTEXT_RATIO = 0.15;\n\ntype RestorationItemType = \"file\" | \"skill\";\ntype FileOperation = \"read\" | \"write\" | \"edit\";\n\nexport interface RestorationSettings {\n\trestorationMaxItems?: number;\n\trestorationMaxTokensPerItem?: number;\n\trestorationMaxTotalTokens?: number;\n\trestorationContextRatio?: number;\n}\n\nexport interface MinimalToolCallEvent {\n\ttoolName: string;\n\tinput: Record<string, unknown>;\n}\n\nexport interface RestorationItem {\n\tcontent: string;\n\tlabel: string;\n\tpriority: number;\n\ttokens: number;\n\ttype: RestorationItemType;\n}\n\nexport interface PendingRestorationPayload {\n\tcustomType: typeof POST_COMPACT_RESTORATION_CUSTOM_TYPE;\n\tcontent: string;\n\tdisplay: false;\n\tdetails: {\n\t\tschema: typeof POST_COMPACT_RESTORATION_SCHEMA;\n\t\tbudgetTokens: number;\n\t\tcompactionEntryId: string;\n\t\treason: CompactionReason;\n\t\titems: RestorationItem[];\n\t};\n\tbudgetTokens: number;\n}\n\nexport interface PreparePendingPayloadOptions {\n\taccepted: boolean;\n\treason: CompactionReason;\n\tcompactionEntryId: string;\n\tcontextWindow: number;\n\tusageTokens: number | null;\n\treserveTokens: number;\n\tsettings?: RestorationSettings;\n\tkeptMessages?: AgentMessage[];\n}\n\nexport interface RestorationTrackerState {\n\titems: Map<string, RestorationItem>;\n\trestoredLabels: Set<string>;\n\tpendingPayload: PendingRestorationPayload | null;\n}\n\nexport function createRestorationTrackerState(): RestorationTrackerState {\n\treturn {\n\t\titems: new Map(),\n\t\trestoredLabels: new Set(),\n\t\tpendingPayload: null,\n\t};\n}\n\nexport function trackToolCall(state: RestorationTrackerState, event: MinimalToolCallEvent): void {\n\tswitch (event.toolName) {\n\t\tcase \"read\":\n\t\t\ttrackPathInput(state, event.input, \"read\");\n\t\t\treturn;\n\t\tcase \"write\":\n\t\t\ttrackPathInput(state, event.input, \"write\");\n\t\t\treturn;\n\t\tcase \"edit\":\n\t\t\ttrackPathInput(state, event.input, \"edit\");\n\t\t\treturn;\n\t\tcase \"apply_patch\":\n\t\t\ttrackApplyPatchInput(state, event.input);\n\t\t\treturn;\n\t\tcase \"skill\":\n\t\tcase \"load_skill\":\n\t\t\ttrackSkillInput(state, event.input);\n\t\t\treturn;\n\t}\n}\n\nexport function preparePendingPayload(state: RestorationTrackerState, options: PreparePendingPayloadOptions): void {\n\tif (!options.accepted) return;\n\n\tconst budgetTokens = computeRestorationBudget(options);\n\tif (budgetTokens <= 0) {\n\t\tstate.pendingPayload = null;\n\t\treturn;\n\t}\n\n\tfilterAgainstKeptMessages(state, options.keptMessages ?? []);\n\tconst selectedItems = selectRestorationItems(state, options.settings, budgetTokens);\n\tif (selectedItems.length === 0) {\n\t\tstate.pendingPayload = null;\n\t\treturn;\n\t}\n\n\tconst content = buildRestorationContent(options, selectedItems);\n\tstate.pendingPayload = {\n\t\tcustomType: POST_COMPACT_RESTORATION_CUSTOM_TYPE,\n\t\tcontent,\n\t\tdisplay: false,\n\t\tdetails: {\n\t\t\tschema: POST_COMPACT_RESTORATION_SCHEMA,\n\t\t\tbudgetTokens,\n\t\t\tcompactionEntryId: options.compactionEntryId,\n\t\t\treason: options.reason,\n\t\t\titems: selectedItems,\n\t\t},\n\t\tbudgetTokens,\n\t};\n}\n\nexport function consumePendingPayload(\n\tstate: RestorationTrackerState,\n): BeforeAgentStartEventResult[\"message\"] | undefined {\n\tconst payload = state.pendingPayload;\n\tstate.pendingPayload = null;\n\tif (!payload) return undefined;\n\tfor (const item of payload.details.items) {\n\t\tstate.restoredLabels.add(item.label);\n\t}\n\treturn {\n\t\tcustomType: payload.customType,\n\t\tcontent: payload.content,\n\t\tdisplay: payload.display,\n\t\tdetails: payload.details,\n\t};\n}\n\nexport function computeRestorationBudget(options: PreparePendingPayloadOptions): number {\n\tconst settings = resolveSettings(options.settings);\n\tconst contextWindow = Math.max(0, options.contextWindow);\n\tconst configuredBudget = settings.restorationMaxTotalTokens;\n\tconst contextRatioBudget = Math.floor(contextWindow * settings.restorationContextRatio);\n\tconst usageTokens = Math.max(0, options.usageTokens ?? 0);\n\tconst remainingBudget = Math.max(0, contextWindow - usageTokens - options.reserveTokens);\n\treturn Math.floor(Math.min(configuredBudget, contextRatioBudget, remainingBudget));\n}\n\nfunction trackPathInput(\n\tstate: RestorationTrackerState,\n\tinput: Record<string, unknown>,\n\toperation: FileOperation,\n): void {\n\tif (typeof input.path !== \"string\" || input.path.length === 0) return;\n\ttrackFile(state, input.path, operation);\n}\n\nfunction trackApplyPatchInput(state: RestorationTrackerState, input: Record<string, unknown>): void {\n\tif (typeof input.input !== \"string\") return;\n\tfor (const path of extractPatchedPaths(input.input)) {\n\t\tif (path.length > 0) trackFile(state, path, \"edit\");\n\t}\n}\n\nfunction trackSkillInput(state: RestorationTrackerState, input: Record<string, unknown>): void {\n\tconst skillName = typeof input.name === \"string\" ? input.name : input.skillName;\n\tif (typeof skillName === \"string\" && skillName.length > 0) {\n\t\tsetItem(state, {\n\t\t\tcontent: skillName,\n\t\t\tlabel: skillName,\n\t\t\tpriority: 80,\n\t\t\ttokens: estimateTextTokens(skillName),\n\t\t\ttype: \"skill\",\n\t\t});\n\t}\n}\n\nfunction trackFile(state: RestorationTrackerState, path: string, operation: FileOperation): void {\n\tconst label = path;\n\tconst existing = state.items.get(label);\n\tconst operations = new Set<FileOperation>(parseFileOperations(existing?.content));\n\toperations.add(operation);\n\tconst content = `${path} (${sortOperations(operations).join(\", \")})`;\n\tsetItem(state, {\n\t\tcontent,\n\t\tlabel,\n\t\tpriority: operation === \"read\" && operations.size === 1 ? 50 : 100,\n\t\ttokens: estimateTextTokens(content),\n\t\ttype: \"file\",\n\t});\n}\n\nfunction setItem(state: RestorationTrackerState, item: RestorationItem): void {\n\tstate.items.set(item.label, item);\n}\n\nfunction selectRestorationItems(\n\tstate: RestorationTrackerState,\n\tsettingsInput: RestorationSettings | undefined,\n\tbudgetTokens: number,\n): RestorationItem[] {\n\tconst settings = resolveSettings(settingsInput);\n\tconst candidates = Array.from(state.items.values())\n\t\t.filter((item) => !state.restoredLabels.has(item.label))\n\t\t.map((item) => truncateRestorationItem(item, settings.restorationMaxTokensPerItem))\n\t\t.sort((left, right) => {\n\t\t\tif (left.priority !== right.priority) return right.priority - left.priority;\n\t\t\tif (left.tokens !== right.tokens) return left.tokens - right.tokens;\n\t\t\treturn left.label.localeCompare(right.label);\n\t\t});\n\n\tconst selected: RestorationItem[] = [];\n\tlet totalTokens = 0;\n\tfor (const item of candidates) {\n\t\tif (selected.length >= settings.restorationMaxItems) break;\n\t\tif (totalTokens + item.tokens > budgetTokens) continue;\n\t\tselected.push(item);\n\t\ttotalTokens += item.tokens;\n\t}\n\treturn selected;\n}\n\nfunction buildRestorationContent(options: PreparePendingPayloadOptions, items: RestorationItem[]): string {\n\tconst files = items.filter((item) => item.type === \"file\");\n\tconst skills = items.filter((item) => item.type === \"skill\");\n\tconst lines = [\n\t\t\"[Restored context after compaction — files and skills from before compaction]\",\n\t\t`reason: ${options.reason}`,\n\t\t`compactionEntryId: ${options.compactionEntryId}`,\n\t\t\"\",\n\t];\n\n\tif (files.length > 0) {\n\t\tlines.push(\"<restored-files>\");\n\t\tfor (const file of files) {\n\t\t\tlines.push(`<file label=\"${escapeXmlAttribute(file.label)}\">${file.content}</file>`);\n\t\t}\n\t\tlines.push(\"</restored-files>\");\n\t\tlines.push(\"\");\n\t}\n\n\tif (skills.length > 0) {\n\t\tlines.push(\"<restored-skills>\");\n\t\tfor (const skill of skills) {\n\t\t\tlines.push(`<skill label=\"${escapeXmlAttribute(skill.label)}\">${skill.content}</skill>`);\n\t\t}\n\t\tlines.push(\"</restored-skills>\");\n\t\tlines.push(\"\");\n\t}\n\n\treturn lines.join(\"\\n\");\n}\n\nfunction truncateRestorationItem(item: RestorationItem, maxTokens: number): RestorationItem {\n\tif (item.tokens <= maxTokens) return item;\n\tconst truncationNotice = \"[... truncated]\";\n\tconst noticeTokens = estimateTextTokens(truncationNotice);\n\tconst targetTokens = Math.max(0, maxTokens - noticeTokens - 1);\n\tconst truncatedBody = truncateToTokenLimit(item.content, targetTokens);\n\tconst content = truncatedBody.length > 0 ? `${truncatedBody}\\n${truncationNotice}` : truncationNotice;\n\treturn { ...item, content, tokens: estimateTextTokens(content) };\n}\n\nfunction filterAgainstKeptMessages(state: RestorationTrackerState, keptMessages: AgentMessage[]): void {\n\tif (keptMessages.length === 0) return;\n\tconst keptText = keptMessages.map(extractMessageText).join(\"\\n\");\n\tfor (const label of state.items.keys()) {\n\t\tif (keptText.includes(label)) {\n\t\t\tstate.items.delete(label);\n\t\t}\n\t}\n}\n\nfunction extractMessageText(message: AgentMessage): string {\n\tif (\"content\" in message) {\n\t\tif (typeof message.content === \"string\") return message.content;\n\t\tif (Array.isArray(message.content)) {\n\t\t\treturn message.content\n\t\t\t\t.filter((content): content is { type: \"text\"; text: string } => content.type === \"text\")\n\t\t\t\t.map((content) => content.text)\n\t\t\t\t.join(\"\\n\");\n\t\t}\n\t}\n\tif (\"summary\" in message) return message.summary;\n\tif (\"command\" in message) return `${message.command}\\n${message.output}`;\n\treturn \"\";\n}\n\nfunction truncateToTokenLimit(text: string, tokenLimit: number): string {\n\tif (tokenLimit <= 0 || text.length === 0) return \"\";\n\tif (estimateTextTokens(text) <= tokenLimit) return text;\n\n\tlet low = 0;\n\tlet high = text.length;\n\twhile (low < high) {\n\t\tconst mid = Math.ceil((low + high) / 2);\n\t\tconst candidate = text.slice(0, mid);\n\t\tif (estimateTextTokens(candidate) <= tokenLimit) {\n\t\t\tlow = mid;\n\t\t\tcontinue;\n\t\t}\n\t\thigh = mid - 1;\n\t}\n\treturn text.slice(0, low).trimEnd();\n}\n\nfunction resolveSettings(settings: RestorationSettings | undefined): Required<RestorationSettings> {\n\treturn {\n\t\trestorationMaxItems: normalizeNonNegativeInteger(settings?.restorationMaxItems, DEFAULT_RESTORATION_MAX_ITEMS),\n\t\trestorationMaxTokensPerItem: normalizeNonNegativeInteger(\n\t\t\tsettings?.restorationMaxTokensPerItem,\n\t\t\tDEFAULT_RESTORATION_MAX_TOKENS_PER_ITEM,\n\t\t),\n\t\trestorationMaxTotalTokens: normalizeNonNegativeInteger(\n\t\t\tsettings?.restorationMaxTotalTokens,\n\t\t\tDEFAULT_RESTORATION_MAX_TOTAL_TOKENS,\n\t\t),\n\t\trestorationContextRatio: normalizeNonNegativeNumber(\n\t\t\tsettings?.restorationContextRatio,\n\t\t\tDEFAULT_RESTORATION_CONTEXT_RATIO,\n\t\t),\n\t};\n}\n\nfunction normalizeNonNegativeInteger(value: number | undefined, fallback: number): number {\n\treturn typeof value === \"number\" && Number.isFinite(value) && value >= 0 ? Math.floor(value) : fallback;\n}\n\nfunction normalizeNonNegativeNumber(value: number | undefined, fallback: number): number {\n\treturn typeof value === \"number\" && Number.isFinite(value) && value >= 0 ? value : fallback;\n}\n\nfunction parseFileOperations(content: string | undefined): FileOperation[] {\n\tif (!content) return [];\n\tconst open = content.lastIndexOf(\"(\");\n\tconst close = content.lastIndexOf(\")\");\n\tif (open === -1 || close === -1 || close <= open) return [];\n\treturn content\n\t\t.slice(open + 1, close)\n\t\t.split(\",\")\n\t\t.map((operation) => operation.trim())\n\t\t.filter(\n\t\t\t(operation): operation is FileOperation =>\n\t\t\t\toperation === \"read\" || operation === \"write\" || operation === \"edit\",\n\t\t);\n}\n\nfunction sortOperations(operations: Set<FileOperation>): FileOperation[] {\n\tconst order: FileOperation[] = [\"read\", \"write\", \"edit\"];\n\treturn order.filter((operation) => operations.has(operation));\n}\n\nfunction estimateTextTokens(text: string): number {\n\treturn estimateTokens({ role: \"custom\", customType: \"restoration\", content: text, display: false, timestamp: 0 });\n}\n\nfunction escapeXmlAttribute(value: string): string {\n\treturn value.replace(/&/g, \"&amp;\").replace(/\"/g, \"&quot;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\");\n}\n"]}

package/dist/core/extensions/builtin/compaction/restoration-tracker.js

@@ -0,0 +1,274 @@
+import { estimateTokens } from "../../../compaction/index.js";
+import { extractPatchedPaths } from "../gpt-apply-patch/index.js";
+export const POST_COMPACT_RESTORATION_CUSTOM_TYPE = "compaction.post-compact-restoration";
+const POST_COMPACT_RESTORATION_SCHEMA = "senpi.compaction.post-compact-restoration.v1";
+const DEFAULT_RESTORATION_MAX_ITEMS = 10;
+const DEFAULT_RESTORATION_MAX_TOKENS_PER_ITEM = 5000;
+const DEFAULT_RESTORATION_MAX_TOTAL_TOKENS = 50_000;
+const DEFAULT_RESTORATION_CONTEXT_RATIO = 0.15;
+export function createRestorationTrackerState() {
+    return {
+        items: new Map(),
+        restoredLabels: new Set(),
+        pendingPayload: null,
+    };
+}
+export function trackToolCall(state, event) {
+    switch (event.toolName) {
+        case "read":
+            trackPathInput(state, event.input, "read");
+            return;
+        case "write":
+            trackPathInput(state, event.input, "write");
+            return;
+        case "edit":
+            trackPathInput(state, event.input, "edit");
+            return;
+        case "apply_patch":
+            trackApplyPatchInput(state, event.input);
+            return;
+        case "skill":
+        case "load_skill":
+            trackSkillInput(state, event.input);
+            return;
+    }
+}
+export function preparePendingPayload(state, options) {
+    if (!options.accepted)
+        return;
+    const budgetTokens = computeRestorationBudget(options);
+    if (budgetTokens <= 0) {
+        state.pendingPayload = null;
+        return;
+    }
+    filterAgainstKeptMessages(state, options.keptMessages ?? []);
+    const selectedItems = selectRestorationItems(state, options.settings, budgetTokens);
+    if (selectedItems.length === 0) {
+        state.pendingPayload = null;
+        return;
+    }
+    const content = buildRestorationContent(options, selectedItems);
+    state.pendingPayload = {
+        customType: POST_COMPACT_RESTORATION_CUSTOM_TYPE,
+        content,
+        display: false,
+        details: {
+            schema: POST_COMPACT_RESTORATION_SCHEMA,
+            budgetTokens,
+            compactionEntryId: options.compactionEntryId,
+            reason: options.reason,
+            items: selectedItems,
+        },
+        budgetTokens,
+    };
+}
+export function consumePendingPayload(state) {
+    const payload = state.pendingPayload;
+    state.pendingPayload = null;
+    if (!payload)
+        return undefined;
+    for (const item of payload.details.items) {
+        state.restoredLabels.add(item.label);
+    }
+    return {
+        customType: payload.customType,
+        content: payload.content,
+        display: payload.display,
+        details: payload.details,
+    };
+}
+export function computeRestorationBudget(options) {
+    const settings = resolveSettings(options.settings);
+    const contextWindow = Math.max(0, options.contextWindow);
+    const configuredBudget = settings.restorationMaxTotalTokens;
+    const contextRatioBudget = Math.floor(contextWindow * settings.restorationContextRatio);
+    const usageTokens = Math.max(0, options.usageTokens ?? 0);
+    const remainingBudget = Math.max(0, contextWindow - usageTokens - options.reserveTokens);
+    return Math.floor(Math.min(configuredBudget, contextRatioBudget, remainingBudget));
+}
+function trackPathInput(state, input, operation) {
+    if (typeof input.path !== "string" || input.path.length === 0)
+        return;
+    trackFile(state, input.path, operation);
+}
+function trackApplyPatchInput(state, input) {
+    if (typeof input.input !== "string")
+        return;
+    for (const path of extractPatchedPaths(input.input)) {
+        if (path.length > 0)
+            trackFile(state, path, "edit");
+    }
+}
+function trackSkillInput(state, input) {
+    const skillName = typeof input.name === "string" ? input.name : input.skillName;
+    if (typeof skillName === "string" && skillName.length > 0) {
+        setItem(state, {
+            content: skillName,
+            label: skillName,
+            priority: 80,
+            tokens: estimateTextTokens(skillName),
+            type: "skill",
+        });
+    }
+}
+function trackFile(state, path, operation) {
+    const label = path;
+    const existing = state.items.get(label);
+    const operations = new Set(parseFileOperations(existing?.content));
+    operations.add(operation);
+    const content = `${path} (${sortOperations(operations).join(", ")})`;
+    setItem(state, {
+        content,
+        label,
+        priority: operation === "read" && operations.size === 1 ? 50 : 100,
+        tokens: estimateTextTokens(content),
+        type: "file",
+    });
+}
+function setItem(state, item) {
+    state.items.set(item.label, item);
+}
+function selectRestorationItems(state, settingsInput, budgetTokens) {
+    const settings = resolveSettings(settingsInput);
+    const candidates = Array.from(state.items.values())
+        .filter((item) => !state.restoredLabels.has(item.label))
+        .map((item) => truncateRestorationItem(item, settings.restorationMaxTokensPerItem))
+        .sort((left, right) => {
+        if (left.priority !== right.priority)
+            return right.priority - left.priority;
+        if (left.tokens !== right.tokens)
+            return left.tokens - right.tokens;
+        return left.label.localeCompare(right.label);
+    });
+    const selected = [];
+    let totalTokens = 0;
+    for (const item of candidates) {
+        if (selected.length >= settings.restorationMaxItems)
+            break;
+        if (totalTokens + item.tokens > budgetTokens)
+            continue;
+        selected.push(item);
+        totalTokens += item.tokens;
+    }
+    return selected;
+}
+function buildRestorationContent(options, items) {
+    const files = items.filter((item) => item.type === "file");
+    const skills = items.filter((item) => item.type === "skill");
+    const lines = [
+        "[Restored context after compaction — files and skills from before compaction]",
+        `reason: ${options.reason}`,
+        `compactionEntryId: ${options.compactionEntryId}`,
+        "",
+    ];
+    if (files.length > 0) {
+        lines.push("<restored-files>");
+        for (const file of files) {
+            lines.push(`<file label="${escapeXmlAttribute(file.label)}">${file.content}</file>`);
+        }
+        lines.push("</restored-files>");
+        lines.push("");
+    }
+    if (skills.length > 0) {
+        lines.push("<restored-skills>");
+        for (const skill of skills) {
+            lines.push(`<skill label="${escapeXmlAttribute(skill.label)}">${skill.content}</skill>`);
+        }
+        lines.push("</restored-skills>");
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function truncateRestorationItem(item, maxTokens) {
+    if (item.tokens <= maxTokens)
+        return item;
+    const truncationNotice = "[... truncated]";
+    const noticeTokens = estimateTextTokens(truncationNotice);
+    const targetTokens = Math.max(0, maxTokens - noticeTokens - 1);
+    const truncatedBody = truncateToTokenLimit(item.content, targetTokens);
+    const content = truncatedBody.length > 0 ? `${truncatedBody}\n${truncationNotice}` : truncationNotice;
+    return { ...item, content, tokens: estimateTextTokens(content) };
+}
+function filterAgainstKeptMessages(state, keptMessages) {
+    if (keptMessages.length === 0)
+        return;
+    const keptText = keptMessages.map(extractMessageText).join("\n");
+    for (const label of state.items.keys()) {
+        if (keptText.includes(label)) {
+            state.items.delete(label);
+        }
+    }
+}
+function extractMessageText(message) {
+    if ("content" in message) {
+        if (typeof message.content === "string")
+            return message.content;
+        if (Array.isArray(message.content)) {
+            return message.content
+                .filter((content) => content.type === "text")
+                .map((content) => content.text)
+                .join("\n");
+        }
+    }
+    if ("summary" in message)
+        return message.summary;
+    if ("command" in message)
+        return `${message.command}\n${message.output}`;
+    return "";
+}
+function truncateToTokenLimit(text, tokenLimit) {
+    if (tokenLimit <= 0 || text.length === 0)
+        return "";
+    if (estimateTextTokens(text) <= tokenLimit)
+        return text;
+    let low = 0;
+    let high = text.length;
+    while (low < high) {
+        const mid = Math.ceil((low + high) / 2);
+        const candidate = text.slice(0, mid);
+        if (estimateTextTokens(candidate) <= tokenLimit) {
+            low = mid;
+            continue;
+        }
+        high = mid - 1;
+    }
+    return text.slice(0, low).trimEnd();
+}
+function resolveSettings(settings) {
+    return {
+        restorationMaxItems: normalizeNonNegativeInteger(settings?.restorationMaxItems, DEFAULT_RESTORATION_MAX_ITEMS),
+        restorationMaxTokensPerItem: normalizeNonNegativeInteger(settings?.restorationMaxTokensPerItem, DEFAULT_RESTORATION_MAX_TOKENS_PER_ITEM),
+        restorationMaxTotalTokens: normalizeNonNegativeInteger(settings?.restorationMaxTotalTokens, DEFAULT_RESTORATION_MAX_TOTAL_TOKENS),
+        restorationContextRatio: normalizeNonNegativeNumber(settings?.restorationContextRatio, DEFAULT_RESTORATION_CONTEXT_RATIO),
+    };
+}
+function normalizeNonNegativeInteger(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? Math.floor(value) : fallback;
+}
+function normalizeNonNegativeNumber(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : fallback;
+}
+function parseFileOperations(content) {
+    if (!content)
+        return [];
+    const open = content.lastIndexOf("(");
+    const close = content.lastIndexOf(")");
+    if (open === -1 || close === -1 || close <= open)
+        return [];
+    return content
+        .slice(open + 1, close)
+        .split(",")
+        .map((operation) => operation.trim())
+        .filter((operation) => operation === "read" || operation === "write" || operation === "edit");
+}
+function sortOperations(operations) {
+    const order = ["read", "write", "edit"];
+    return order.filter((operation) => operations.has(operation));
+}
+function estimateTextTokens(text) {
+    return estimateTokens({ role: "custom", customType: "restoration", content: text, display: false, timestamp: 0 });
+}
+function escapeXmlAttribute(value) {
+    return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+//# sourceMappingURL=restoration-tracker.js.map