@nghyane/arcane 0.1.29 → 0.1.30

package/examples/hooks/custom-compaction.ts

@@ -1,116 +0,0 @@
-/**
- * Custom Compaction Hook
- *
- * Replaces the default compaction behavior with a full summary of the entire context.
- * Instead of keeping the last 20k tokens of conversation turns, this hook:
- * 1. Summarizes ALL messages (messagesToSummarize + turnPrefixMessages)
- * 2. Discards all old turns completely, keeping only the summary
- *
- * This example also demonstrates using a different model (Gemini Flash) for summarization,
- * which can be cheaper/faster than the main conversation model.
- *
- * Usage:
- *   arcane --hook examples/hooks/custom-compaction.ts
- */
-
-import type { HookAPI } from "@nghyane/arcane";
-import { convertToLlm, serializeConversation } from "@nghyane/arcane";
-import { complete, getModel } from "@nghyane/arcane-ai";
-
-export default function (pi: HookAPI) {
-	pi.on("session_before_compact", async (event, ctx) => {
-		ctx.ui.notify("Custom compaction hook triggered", "info");
-
-		const { preparation, branchEntries: _, signal } = event;
-		const { messagesToSummarize, turnPrefixMessages, tokensBefore, firstKeptEntryId, previousSummary } = preparation;
-
-		// Use Gemini Flash for summarization (cheaper/faster than most conversation models)
-		const model = getModel("google", "gemini-2.5-flash");
-		if (!model) {
-			ctx.ui.notify(`Could not find Gemini Flash model, using default compaction`, "warning");
-			return;
-		}
-
-		// Resolve API key for the summarization model
-		const apiKey = await ctx.modelRegistry.getApiKey(model);
-		if (!apiKey) {
-			ctx.ui.notify(`No API key for ${model.provider}, using default compaction`, "warning");
-			return;
-		}
-
-		// Combine all messages for full summary
-		const allMessages = [...messagesToSummarize, ...turnPrefixMessages];
-
-		ctx.ui.notify(
-			`Custom compaction: summarizing ${allMessages.length} messages (${tokensBefore.toLocaleString()} tokens) with ${
-				model.id
-			}...`,
-			"info",
-		);
-
-		// Convert messages to readable text format
-		const conversationText = serializeConversation(convertToLlm(allMessages));
-
-		// Include previous summary context if available
-		const previousContext = previousSummary ? `\n\nPrevious session summary for context:\n${previousSummary}` : "";
-
-		// Build messages that ask for a comprehensive summary
-		const summaryMessages = [
-			{
-				role: "user" as const,
-				content: [
-					{
-						type: "text" as const,
-						text: `You are a conversation summarizer. Create a comprehensive summary of this conversation that captures:${previousContext}
-
-1. The main goals and objectives discussed
-2. Key decisions made and their rationale
-3. Important code changes, file modifications, or technical details
-4. Current state of any ongoing work
-5. Any blockers, issues, or open questions
-6. Next steps that were planned or suggested
-
-Be thorough but concise. The summary will replace the ENTIRE conversation history, so include all information needed to continue the work effectively.
-
-Format the summary as structured markdown with clear sections.
-
-<conversation>
-${conversationText}
-</conversation>`,
-					},
-				],
-				timestamp: Date.now(),
-			},
-		];
-
-		try {
-			// Pass signal to honor abort requests (e.g., user cancels compaction)
-			const response = await complete(model, { messages: summaryMessages }, { apiKey, maxTokens: 8192, signal });
-
-			const summary = response.content
-				.filter((c): c is { type: "text"; text: string } => c.type === "text")
-				.map(c => c.text)
-				.join("\n");
-
-			if (!summary.trim()) {
-				if (!signal.aborted) ctx.ui.notify("Compaction summary was empty, using default compaction", "warning");
-				return;
-			}
-
-			// Return compaction content - SessionManager adds id/parentId
-			// Use firstKeptEntryId from preparation to keep recent messages
-			return {
-				compaction: {
-					summary,
-					firstKeptEntryId,
-					tokensBefore,
-				},
-			};
-		} catch (error) {
-			const message = error instanceof Error ? error.message : String(error);
-			ctx.ui.notify(`Compaction failed: ${message}`, "error");
-			// Fall back to default compaction on error
-			return;
-		}
-	});
-}

package/src/modes/components/compaction-summary-message.ts

@@ -1,59 +0,0 @@
-import { Container, LeftBorderBox, Markdown, Spacer, Text } from "@nghyane/arcane-tui";
-import type { CompactionSummaryMessage } from "../../session/messages";
-import { getMarkdownTheme, theme } from "../../theme/theme";
-import { formatClickHint } from "../../ui/render-utils";
-
-/**
- * Component that renders a compaction message with collapsed/expanded state.
- */
-export class CompactionSummaryMessageComponent extends Container {
-	#box: LeftBorderBox;
-	#expanded = false;
-
-	constructor(private readonly message: CompactionSummaryMessage) {
-		super();
-		this.addChild(new Spacer(1));
-		this.#box = new LeftBorderBox(1, 1, s => theme.fg("dim", s));
-		this.addChild(this.#box);
-		this.#updateDisplay();
-	}
-
-	setExpanded(expanded: boolean): void {
-		this.#expanded = expanded;
-		this.#updateDisplay();
-	}
-
-	override invalidate(): void {
-		super.invalidate();
-		this.#updateDisplay();
-	}
-
-	#updateDisplay(): void {
-		this.#box.clear();
-
-		const tokenStr = this.message.tokensBefore.toLocaleString();
-		const label = theme.fg("customMessageLabel", theme.bold("[compaction]"));
-		this.#box.addChild(new Text(label, 0, 0));
-		this.#box.addChild(new Spacer(1));
-
-		if (this.#expanded) {
-			const header = `**Compacted from ${tokenStr} tokens**\n\n`;
-			this.#box.addChild(
-				new Markdown(header + this.message.summary, 0, 0, getMarkdownTheme(), {
-					color: (text: string) => theme.fg("customMessageText", text),
-				}),
-			);
-		} else {
-			this.#box.addChild(
-				new Text(
-					`${theme.fg("customMessageText", `Compacted from ${tokenStr} tokens`)} ${formatClickHint(theme)}`,
-					0,
-					0,
-				),
-			);
-			if (this.message.shortSummary) {
-				this.#box.addChild(new Text(theme.fg("customMessageText", this.message.shortSummary), 0, 1));
-			}
-		}
-	}
-}

package/src/prompts/compaction/compaction-short-summary.md

@@ -1,9 +0,0 @@
-Summarize what was done in this conversation. Write like a pull request description.
-
-Rules:
-- 2-3 sentences max
-- Describe the changes made, not the process
-- Do not mention running tests, builds, or other validation steps
-- Do not explain what the user asked for
-- Write in first person (I added..., I fixed...)
-- Never ask questions

package/src/prompts/compaction/compaction-summary-context.md

@@ -1,5 +0,0 @@
-Another language model started to solve this problem and produced a summary of its thinking process. You also have access to the state of the tools that were used by that language model. Use this to build on the work that has already been done and avoid duplicating work. Here is the summary produced by the other language model, use the information in this summary to assist with your own analysis:
-
-<summary>
-{{summary}}
-</summary>

package/src/prompts/compaction/compaction-summary.md

@@ -1,41 +0,0 @@
-Summarize conversation above into structured context checkpoint handoff summary for another LLM to resume task.
-
-IMPORTANT: If conversation ends with unanswered question to user or imperative/request awaiting user response (e.g., "Please run command and paste output"), preserve that exact question/request.
-
-Use this format (sections can be omitted if not applicable):
-
-## Goal
-[User goals; list multiple if session covers different tasks.]
-
-## Constraints & Preferences
-- [Constraints or requirements mentioned]
-
-## Progress
-
-### Done
-- [x] [Completed tasks/changes]
-
-### In Progress
-- [ ] [Current work]
-
-### Blocked
-- [Issues preventing progress]
-
-### Abandoned Approaches
-- [Approach tried and why it failed/was rejected — prevents re-trying dead ends]
-
-## Key Decisions
-- **[Decision]**: [Brief rationale]
-
-## Next Steps
-1. [Ordered list of next actions]
-
-## Critical Context
-- [Important data, pending questions, references]
-
-## Additional Notes
-[Anything else important not covered above]
-
-Output only structured summary; no extra text.
-
-Prioritize recent context over older context — the last 2-3 turns are most likely to contain the active work state. Preserve exact file paths, function names, error messages, and relevant tool outputs. Include repository state changes (branch, uncommitted changes) if mentioned.

package/src/prompts/compaction/compaction-turn-prefix.md

@@ -1,17 +0,0 @@
-This is the PREFIX of a turn that was too large to keep. The SUFFIX (recent work) is retained.
-
-Summarize the prefix to provide context for the retained suffix:
-
-## Original Request
-
-[What did the user ask for in this turn?]
-
-## Early Progress
-- [Key decisions and work done in the prefix]
-
-## Context for Suffix
-- [Information needed to understand the retained recent work]
-
-Output only the structured summary. No extra text.
-
-Be concise. Preserve exact file paths, function names, error messages, and relevant tool outputs or command results if they appear. Focus on what's needed to understand the kept suffix.

package/src/prompts/compaction/compaction-update-summary.md

@@ -1,45 +0,0 @@
-Incorporate new messages above into existing handoff summary in <previous-summary> tags, used by another LLM to resume task.
-RULES:
-- PRESERVE all information from previous summary
-- ADD new progress, decisions, and context from new messages
-- UPDATE Progress: move items from "In Progress" to "Done" when completed
-- UPDATE "Next Steps" based on what was accomplished
-- PRESERVE exact file paths, function names, and error messages
-- You may remove anything no longer relevant
-
-IMPORTANT: If new messages end with unanswered question or request to user, add it to Critical Context (replacing any previous pending question if answered).
-
-Use this format (omit sections if not applicable):
-
-## Goal
-[Preserve existing goals; add new ones if task expanded]
-
-## Constraints & Preferences
-- [Preserve existing; add new ones discovered]
-
-## Progress
-
-### Done
-- [x] [Include previously done and newly completed items]
-
-### In Progress
-- [ ] [Current work—update based on progress]
-
-### Blocked
-- [Current blockers—remove if resolved]
-
-## Key Decisions
-- **[Decision]**: [Brief rationale] (preserve all previous, add new)
-
-## Next Steps
-1. [Update based on current state]
-
-## Critical Context
-- [Preserve important context; add new if needed]
-
-## Additional Notes
-[Other important info not fitting above]
-
-Output only structured summary; no extra text.
-
-Keep sections concise. Preserve relevant tool outputs/command results. Include repository state changes (branch, uncommitted changes) if mentioned.