@nghyane/arcane 0.1.28 → 0.1.30

package/src/tools/github-fs.ts

@@ -0,0 +1,195 @@
+import type { AgentTool, AgentToolResult } from "@nghyane/arcane-agent";
+import { type Static, Type } from "@sinclair/typebox";
+import type { Theme } from "../theme/theme";
+import { githubClient } from "../web/github-client";
+import type { ToolSession } from ".";
+import { formatGitHubError, resolveOwnerRepo } from "./github-utils";
+import { type OutputMeta, toolResult } from "./output-meta";
+
+// =============================================================================
+// GitHub API Types
+// =============================================================================
+
+interface GitHubTreeEntry {
+	type: string;
+	path?: string;
+	name?: string;
+	size?: number;
+}
+
+// =============================================================================
+// Schema
+// =============================================================================
+const ActionEnum = Type.Union([Type.Literal("get_file"), Type.Literal("get_tree")]);
+
+const schema = Type.Object({
+	action: ActionEnum,
+	owner: Type.Optional(
+		Type.String({ description: "Repository owner (user or org). Auto-detected from git remote if omitted." }),
+	),
+	repo: Type.Optional(Type.String({ description: "Repository name. Auto-detected from git remote if omitted." })),
+	path: Type.Optional(Type.String({ description: "File or directory path within the repo" })),
+	ref: Type.Optional(Type.String({ description: "Branch, tag, or commit SHA" })),
+	recursive: Type.Optional(Type.Boolean({ description: "Recursively list tree contents" })),
+	limit: Type.Optional(Type.Number({ description: "Max number of results" })),
+});
+
+type GitHubFsInput = Static<typeof schema>;
+
+// =============================================================================
+// Details
+// =============================================================================
+
+export interface GitHubFsToolDetails {
+	action: string;
+	owner: string;
+	repo: string;
+	meta?: OutputMeta;
+}
+
+// =============================================================================
+// Helpers
+// =============================================================================
+
+function formatTreeEntry(entry: GitHubTreeEntry): string {
+	const icon = entry.type === "dir" || entry.type === "tree" ? "dir" : "file";
+	const size = entry.size ? ` (${formatSize(entry.size)})` : "";
+	const name = entry.path ?? entry.name;
+	return `[${icon}] ${name}${size}`;
+}
+
+function formatSize(bytes: number): string {
+	if (bytes < 1024) return `${bytes}B`;
+	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}K`;
+	return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
+}
+
+// =============================================================================
+// Action Handlers
+// =============================================================================
+
+const MAX_FILE_LINES = 500;
+
+async function handleAction(
+	input: GitHubFsInput,
+	owner: string,
+	repo: string,
+	signal?: AbortSignal,
+): Promise<{ text: string; url?: string }> {
+	const { action } = input;
+	const opts = { signal };
+	const base = `/repos/${owner}/${repo}`;
+
+	switch (action) {
+		case "get_file": {
+			const filePath = input.path ?? "README.md";
+			const ref = input.ref ? `?ref=${input.ref}` : "";
+			let res = await githubClient.request<string>(`${base}/contents/${filePath}${ref}`, {
+				...opts,
+				mediaType: "application/vnd.github.v3.raw",
+			});
+			// Fallback to Blob API for files >1MB (raw mediaType returns 403)
+			if (!res.ok && res.status === 403) {
+				const metaRes = await githubClient.request<{ sha: string; size: number }>(
+					`${base}/contents/${filePath}${ref}`,
+					opts,
+				);
+				if (metaRes.ok && metaRes.data?.sha) {
+					const blobRes = await githubClient.request<{ content: string; encoding: string }>(
+						`${base}/git/blobs/${metaRes.data.sha}`,
+						opts,
+					);
+					if (blobRes.ok && blobRes.data?.content) {
+						const decoded =
+							blobRes.data.encoding === "base64"
+								? Buffer.from(blobRes.data.content, "base64").toString("utf-8")
+								: blobRes.data.content;
+						res = { data: decoded as string, ok: true, status: 200 };
+					}
+				}
+			}
+			if (!res.ok) return formatGitHubError(res, `file ${filePath}`);
+			const content = String(res.data);
+			const lines = content.split("\n");
+			const truncated = lines.length > MAX_FILE_LINES;
+			const output = truncated ? lines.slice(0, MAX_FILE_LINES).join("\n") : content;
+			const note = truncated ? `\n\n[Truncated: showing ${MAX_FILE_LINES}/${lines.length} lines]` : "";
+			return {
+				text: `# ${owner}/${repo}:${filePath}${input.ref ? ` @${input.ref}` : ""}\n\n${output}${note}`,
+				url: `https://github.com/${owner}/${repo}/blob/${input.ref ?? "HEAD"}/${filePath}`,
+			};
+		}
+
+		case "get_tree": {
+			const treePath = input.path ?? "";
+			if (input.recursive) {
+				const ref = input.ref ?? "HEAD";
+				const res = await githubClient.request<{ tree: GitHubTreeEntry[]; truncated: boolean }>(
+					`${base}/git/trees/${ref}?recursive=1`,
+					opts,
+				);
+				if (!res.ok) return formatGitHubError(res, "tree");
+				const entries = (res.data.tree ?? [])
+					.filter(e => !treePath || (e.path ?? "").startsWith(treePath))
+					.slice(0, 500);
+				return {
+					text: `# Tree: ${owner}/${repo}${treePath ? `/${treePath}` : ""} (recursive)\n\n${entries.map(formatTreeEntry).join("\n")}`,
+				};
+			}
+			const ref = input.ref ? `?ref=${input.ref}` : "";
+			const endpoint = treePath ? `${base}/contents/${treePath}${ref}` : `${base}/contents${ref}`;
+			const res = await githubClient.request<GitHubTreeEntry[]>(endpoint, opts);
+			if (!res.ok) return formatGitHubError(res, "directory");
+			const entries = Array.isArray(res.data) ? res.data : [res.data];
+			return {
+				text: `# ${owner}/${repo}/${treePath}\n\n${entries.map(formatTreeEntry).join("\n")}`,
+			};
+		}
+
+		default:
+			return { text: `Unknown action: ${action}` };
+	}
+}
+
+// =============================================================================
+// Tool Class
+// =============================================================================
+
+export class GitHubFsTool implements AgentTool<typeof schema, GitHubFsToolDetails, Theme> {
+	readonly name = "github_fs";
+	readonly label = "GitHub FS";
+	readonly parameters = schema;
+	description = "Browse remote GitHub repository contents: read files and list directory trees.";
+
+	constructor(readonly _session: ToolSession) {}
+
+	async execute(
+		_toolCallId: string,
+		params: GitHubFsInput,
+		signal?: AbortSignal,
+	): Promise<AgentToolResult<GitHubFsToolDetails>> {
+		const resolved = await resolveOwnerRepo(params, this._session.cwd);
+		if (!resolved) {
+			return toolResult({ action: params.action, owner: "", repo: "" } as GitHubFsToolDetails)
+				.text(
+					"Error: owner and repo are required. Provide them explicitly or run from a git repo with a GitHub remote.",
+				)
+				.done();
+		}
+
+		const { owner, repo } = resolved;
+		const details: GitHubFsToolDetails = {
+			action: params.action,
+			owner,
+			repo,
+		};
+
+		const result = await handleAction(params, owner, repo, signal);
+
+		const builder = toolResult(details).text(result.text);
+		if (result.url) {
+			builder.sourceUrl(result.url);
+		}
+		return builder.done();
+	}
+}

package/src/tools/github-utils.ts

@@ -0,0 +1,35 @@
+import { $ } from "bun";
+import type { GitHubResponse } from "../web/github-client";
+
+export async function resolveOwnerRepo(
+	input: { owner?: string; repo?: string },
+	cwd: string,
+): Promise<{ owner: string; repo: string } | null> {
+	if (input.owner && input.repo) return { owner: input.owner, repo: input.repo };
+	try {
+		const result = await $`git remote get-url origin`.cwd(cwd).quiet().nothrow();
+		if (result.exitCode !== 0) return null;
+		const url = result.text().trim();
+		// https://github.com/owner/repo.git or git@github.com:owner/repo.git
+		const match = url.match(/github\.com[/:]([^/]+)\/([^/.]+)/);
+		if (!match) return null;
+		return { owner: match[1], repo: match[2] };
+	} catch {
+		return null;
+	}
+}
+
+export function formatGitHubError(res: GitHubResponse, resource: string): { text: string } {
+	const status = res.status;
+	if (status === 404) return { text: `Error: ${resource} not found (404)` };
+	if (status === 403) {
+		const rl = res.rateLimit;
+		if (rl && rl.remaining === 0) {
+			return { text: `Error: GitHub API rate limit exceeded. Resets at ${new Date(rl.reset * 1000).toISOString()}` };
+		}
+		return { text: `Error: Access denied to ${resource} (403). Check token permissions.` };
+	}
+	if (status === 401)
+		return { text: `Error: Authentication failed (401). Check GITHUB_TOKEN or run 'gh auth login'.` };
+	return { text: `Error: Failed to fetch ${resource} (HTTP ${status})` };
+}

package/src/tools/github.ts

@@ -1,8 +1,9 @@
 import type { AgentTool, AgentToolResult } from "@nghyane/arcane-agent";
 import { type Static, Type } from "@sinclair/typebox";
 import type { Theme } from "../theme/theme";
-import { type GitHubResponse, githubClient } from "../web/github-client";
+import { githubClient } from "../web/github-client";
 import type { ToolSession } from ".";
+import { formatGitHubError, resolveOwnerRepo } from "./github-utils";
 import { type OutputMeta, toolResult } from "./output-meta";
 
 // =============================================================================
@@ -35,13 +36,6 @@ interface GitHubRepo {
 	homepage: string | null;
 }
 
-interface GitHubTreeEntry {
-	type: string;
-	path?: string;
-	name?: string;
-	size?: number;
-}
-
 interface GitHubIssue {
 	number: number;
 	title: string;
@@ -109,8 +103,6 @@ interface GitHubSearchResult<T> {
 // =============================================================================
 const ActionEnum = Type.Union([
 	Type.Literal("get_repo"),
-	Type.Literal("get_file"),
-	Type.Literal("get_tree"),
 	Type.Literal("search_repos"),
 	Type.Literal("get_issue"),
 	Type.Literal("list_issues"),
@@ -122,8 +114,10 @@ const ActionEnum = Type.Union([
 
 const schema = Type.Object({
 	action: ActionEnum,
-	owner: Type.String({ description: "Repository owner (user or org)" }),
-	repo: Type.String({ description: "Repository name" }),
+	owner: Type.Optional(
+		Type.String({ description: "Repository owner (user or org). Auto-detected from git remote if omitted." }),
+	),
+	repo: Type.Optional(Type.String({ description: "Repository name. Auto-detected from git remote if omitted." })),
 	path: Type.Optional(Type.String({ description: "File or directory path within the repo" })),
 	ref: Type.Optional(Type.String({ description: "Branch, tag, or commit SHA" })),
 	number: Type.Optional(Type.Number({ description: "Issue or PR number" })),
@@ -132,7 +126,6 @@ const schema = Type.Object({
 	labels: Type.Optional(Type.String({ description: "Comma-separated label filter" })),
 	sha: Type.Optional(Type.String({ description: "Commit SHA" })),
 	include_diff: Type.Optional(Type.Boolean({ description: "Include diff in commit details" })),
-	recursive: Type.Optional(Type.Boolean({ description: "Recursively list tree contents" })),
 	limit: Type.Optional(Type.Number({ description: "Max number of results" })),
 });
 
@@ -170,19 +163,6 @@ function formatRepo(data: GitHubRepo): string {
 		.join("\n");
 }
 
-function formatTreeEntry(entry: GitHubTreeEntry): string {
-	const icon = entry.type === "dir" || entry.type === "tree" ? "dir" : "file";
-	const size = entry.size ? ` (${formatSize(entry.size)})` : "";
-	const name = entry.path ?? entry.name;
-	return `[${icon}] ${name}${size}`;
-}
-
-function formatSize(bytes: number): string {
-	if (bytes < 1024) return `${bytes}B`;
-	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}K`;
-	return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
-}
-
 function formatIssue(data: GitHubIssue, comments: GitHubComment[] = []): string {
 	const lines = [
 		`# #${data.number}: ${data.title}`,
@@ -275,87 +255,26 @@ function formatSearchReposResult(data: GitHubSearchResult<GitHubRepo>): string {
 // Action Handlers
 // =============================================================================
 
-const MAX_FILE_LINES = 500;
 const MAX_DIFF_CHARS = 50_000;
 const MAX_COMMENTS_PAGES = 5;
 
-async function handleAction(input: GitHubInput, signal?: AbortSignal): Promise<{ text: string; url?: string }> {
-	const { action, owner, repo } = input;
+async function handleAction(
+	input: GitHubInput,
+	owner: string,
+	repo: string,
+	signal?: AbortSignal,
+): Promise<{ text: string; url?: string }> {
+	const { action } = input;
 	const opts = { signal };
 	const base = `/repos/${owner}/${repo}`;
 
 	switch (action) {
 		case "get_repo": {
 			const res = await githubClient.request<GitHubRepo>(base, opts);
-			if (!res.ok) return error(res, "repository");
+			if (!res.ok) return formatGitHubError(res, "repository");
 			return { text: formatRepo(res.data), url: `https://github.com/${owner}/${repo}` };
 		}
 
-		case "get_file": {
-			const filePath = input.path ?? "README.md";
-			const ref = input.ref ? `?ref=${input.ref}` : "";
-			let res = await githubClient.request<string>(`${base}/contents/${filePath}${ref}`, {
-				...opts,
-				mediaType: "application/vnd.github.v3.raw",
-			});
-			// Fallback to Blob API for files >1MB (raw mediaType returns 403)
-			if (!res.ok && res.status === 403) {
-				const metaRes = await githubClient.request<{ sha: string; size: number }>(
-					`${base}/contents/${filePath}${ref}`,
-					opts,
-				);
-				if (metaRes.ok && metaRes.data?.sha) {
-					const blobRes = await githubClient.request<{ content: string; encoding: string }>(
-						`${base}/git/blobs/${metaRes.data.sha}`,
-						opts,
-					);
-					if (blobRes.ok && blobRes.data?.content) {
-						const decoded =
-							blobRes.data.encoding === "base64"
-								? Buffer.from(blobRes.data.content, "base64").toString("utf-8")
-								: blobRes.data.content;
-						res = { data: decoded as string, ok: true, status: 200 };
-					}
-				}
-			}
-			if (!res.ok) return error(res, `file ${filePath}`);
-			const content = String(res.data);
-			const lines = content.split("\n");
-			const truncated = lines.length > MAX_FILE_LINES;
-			const output = truncated ? lines.slice(0, MAX_FILE_LINES).join("\n") : content;
-			const note = truncated ? `\n\n[Truncated: showing ${MAX_FILE_LINES}/${lines.length} lines]` : "";
-			return {
-				text: `# ${owner}/${repo}:${filePath}${input.ref ? ` @${input.ref}` : ""}\n\n${output}${note}`,
-				url: `https://github.com/${owner}/${repo}/blob/${input.ref ?? "HEAD"}/${filePath}`,
-			};
-		}
-
-		case "get_tree": {
-			const treePath = input.path ?? "";
-			if (input.recursive) {
-				const ref = input.ref ?? "HEAD";
-				const res = await githubClient.request<{ tree: GitHubTreeEntry[]; truncated: boolean }>(
-					`${base}/git/trees/${ref}?recursive=1`,
-					opts,
-				);
-				if (!res.ok) return error(res, "tree");
-				const entries = (res.data.tree ?? [])
-					.filter(e => !treePath || (e.path ?? "").startsWith(treePath))
-					.slice(0, 500);
-				return {
-					text: `# Tree: ${owner}/${repo}${treePath ? `/${treePath}` : ""} (recursive)\n\n${entries.map(formatTreeEntry).join("\n")}`,
-				};
-			}
-			const ref = input.ref ? `?ref=${input.ref}` : "";
-			const endpoint = treePath ? `${base}/contents/${treePath}${ref}` : `${base}/contents${ref}`;
-			const res = await githubClient.request<GitHubTreeEntry[]>(endpoint, opts);
-			if (!res.ok) return error(res, "directory");
-			const entries = Array.isArray(res.data) ? res.data : [res.data];
-			return {
-				text: `# ${owner}/${repo}/${treePath}\n\n${entries.map(formatTreeEntry).join("\n")}`,
-			};
-		}
-
 		case "search_repos": {
 			const q = input.query ?? `${owner}/${repo}`;
 			const perPage = Math.min(input.limit ?? 30, 100);
@@ -363,7 +282,7 @@ async function handleAction(input: GitHubInput, signal?: AbortSignal): Promise<{
 				`/search/repositories?q=${encodeURIComponent(q)}&per_page=${perPage}`,
 				opts,
 			);
-			if (!res.ok) return error(res, "repository search");
+			if (!res.ok) return formatGitHubError(res, "repository search");
 			return { text: formatSearchReposResult(res.data) };
 		}
 
@@ -378,7 +297,7 @@ async function handleAction(input: GitHubInput, signal?: AbortSignal): Promise<{
 					maxPages: MAX_COMMENTS_PAGES,
 				}),
 			]);
-			if (!issueRes.ok) return error(issueRes, `issue #${num}`);
+			if (!issueRes.ok) return formatGitHubError(issueRes, `issue #${num}`);
 			return {
 				text: formatIssue(issueRes.data, commentsRes.ok ? commentsRes.data : []),
 				url: `https://github.com/${owner}/${repo}/issues/${num}`,
@@ -397,7 +316,7 @@ async function handleAction(input: GitHubInput, signal?: AbortSignal): Promise<{
 				perPage,
 				maxPages,
 			});
-			if (!res.ok) return error(res, "issues");
+			if (!res.ok) return formatGitHubError(res, "issues");
 			const issues = (res.data ?? []).filter(i => !i.pull_request).slice(0, limit);
 			const header = `${issues.length} issue(s)${issues.length >= limit ? " (limit reached, increase limit for more)" : ""}`;
 			return {
@@ -409,7 +328,7 @@ async function handleAction(input: GitHubInput, signal?: AbortSignal): Promise<{
 			const num = input.number;
 			if (!num) return { text: "Error: 'number' is required for get_pull" };
 			const prRes = await githubClient.request<GitHubPR>(`${base}/pulls/${num}`, opts);
-			if (!prRes.ok) return error(prRes, `PR #${num}`);
+			if (!prRes.ok) return formatGitHubError(prRes, `PR #${num}`);
 
 			let diff: string | undefined;
 			if (input.include_diff) {
@@ -442,7 +361,7 @@ async function handleAction(input: GitHubInput, signal?: AbortSignal): Promise<{
 				perPage,
 				maxPages,
 			});
-			if (!res.ok) return error(res, "pull requests");
+			if (!res.ok) return formatGitHubError(res, "pull requests");
 			const pulls = (res.data ?? []).slice(0, limit);
 			const header = `${pulls.length} PR(s)${pulls.length >= limit ? " (limit reached, increase limit for more)" : ""}`;
 			return {
@@ -462,7 +381,7 @@ async function handleAction(input: GitHubInput, signal?: AbortSignal): Promise<{
 				perPage,
 				maxPages,
 			});
-			if (!res.ok) return error(res, "commits");
+			if (!res.ok) return formatGitHubError(res, "commits");
 			const commits = (res.data ?? []).slice(0, limit);
 			const header = `${commits.length} commit(s)${commits.length >= limit ? " (limit reached, increase limit for more)" : ""}`;
 			return {
@@ -474,7 +393,7 @@ async function handleAction(input: GitHubInput, signal?: AbortSignal): Promise<{
 			const sha = input.sha;
 			if (!sha) return { text: "Error: 'sha' is required for get_commit" };
 			const res = await githubClient.request<GitHubCommit>(`${base}/commits/${sha}`, opts);
-			if (!res.ok) return error(res, `commit ${sha}`);
+			if (!res.ok) return formatGitHubError(res, `commit ${sha}`);
 
 			let diff: string | undefined;
 			if (input.include_diff) {
@@ -500,22 +419,6 @@ async function handleAction(input: GitHubInput, signal?: AbortSignal): Promise<{
 			return { text: `Unknown action: ${action}` };
 	}
 }
-
-function error(res: GitHubResponse, resource: string): { text: string } {
-	const status = res.status;
-	if (status === 404) return { text: `Error: ${resource} not found (404)` };
-	if (status === 403) {
-		const rl = res.rateLimit;
-		if (rl && rl.remaining === 0) {
-			return { text: `Error: GitHub API rate limit exceeded. Resets at ${new Date(rl.reset * 1000).toISOString()}` };
-		}
-		return { text: `Error: Access denied to ${resource} (403). Check token permissions.` };
-	}
-	if (status === 401)
-		return { text: `Error: Authentication failed (401). Check GITHUB_TOKEN or run 'gh auth login'.` };
-	return { text: `Error: Failed to fetch ${resource} (HTTP ${status})` };
-}
-
 // =============================================================================
 // Tool Class
 // =============================================================================
@@ -534,14 +437,23 @@ export class GitHubTool implements AgentTool<typeof schema, GitHubToolDetails, T
 		params: GitHubInput,
 		signal?: AbortSignal,
 	): Promise<AgentToolResult<GitHubToolDetails>> {
-		const input = params;
+		const resolved = await resolveOwnerRepo(params, this._session.cwd);
+		if (!resolved) {
+			return toolResult({ action: params.action, owner: "", repo: "" } as GitHubToolDetails)
+				.text(
+					"Error: owner and repo are required. Provide them explicitly or run from a git repo with a GitHub remote.",
+				)
+				.done();
+		}
+
+		const { owner, repo } = resolved;
 		const details: GitHubToolDetails = {
-			action: input.action,
-			owner: input.owner,
-			repo: input.repo,
+			action: params.action,
+			owner,
+			repo,
 		};
 
-		const result = await handleAction(input, signal);
+		const result = await handleAction(params, owner, repo, signal);
 
 		const builder = toolResult(details).text(result.text);
 		if (result.url) {

package/src/tools/index.ts

@@ -72,6 +72,7 @@ export {
 } from "./find";
 export { FindThreadTool, type FindThreadToolDetails } from "./find-thread";
 export { GitHubTool, type GitHubToolDetails } from "./github";
+export { GitHubFsTool, type GitHubFsToolDetails } from "./github-fs";
 export { GrepTool, type GrepToolDetails, type GrepToolInput } from "./grep";
 export { librarianConfig } from "./librarian";
 export { NotebookTool, type NotebookToolDetails } from "./notebook";

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;
-		}
-	});
-}