@nghyane/arcane 0.1.16 → 0.1.18

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 ## [Unreleased]
 
+## [0.1.17] - 2026-03-02
+
+### Added
+
+- Thread search and retrieval tools (find-thread, read-thread)
+- Save-memory tool for cross-session fact storage
+- Mermaid diagram rendering tool (render-mermaid)
+- Kagi web search provider
+- Codex OAuth authentication support
+- AST auto-inclusion in subagent context
+- Ask tool abort support
+
+### Changed
+
+- Improved Gemini provider retry logic
+- Enhanced hashline tab handling
+
+### Removed
+
+- Memory system (replaced by thread/save-memory tools)
+
 ## [0.1.14] - 2026-03-02
 
 ### Removed

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@nghyane/arcane",
-	"version": "0.1.16",
+	"version": "0.1.18",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/nghyane/arcane",
 	"author": "Can Bölük",
@@ -44,12 +44,12 @@
 	},
 	"dependencies": {
 		"@mozilla/readability": "0.6.0",
-		"@nghyane/arcane-stats": "^0.1.9",
-		"@nghyane/arcane-agent": "^0.1.12",
-		"@nghyane/arcane-ai": "^0.1.9",
-		"@nghyane/arcane-natives": "^0.1.7",
-		"@nghyane/arcane-tui": "^0.1.11",
-		"@nghyane/arcane-utils": "^0.1.6",
+		"@nghyane/arcane-stats": "^0.1.11",
+		"@nghyane/arcane-agent": "^0.1.14",
+		"@nghyane/arcane-ai": "^0.1.11",
+		"@nghyane/arcane-natives": "^0.1.9",
+		"@nghyane/arcane-tui": "^0.1.13",
+		"@nghyane/arcane-utils": "^0.1.7",
 		"@sinclair/typebox": "^0.34.48",
 		"@xterm/headless": "^6.0.0",
 		"ajv": "^8.18.0",
@@ -242,14 +242,6 @@
 			"types": "./src/mcp/transports/*.ts",
 			"import": "./src/mcp/transports/*.ts"
 		},
-		"./memories": {
-			"types": "./src/memories/index.ts",
-			"import": "./src/memories/index.ts"
-		},
-		"./memories/*": {
-			"types": "./src/memories/*.ts",
-			"import": "./src/memories/*.ts"
-		},
 		"./modes": {
 			"types": "./src/modes/index.ts",
 			"import": "./src/modes/index.ts"

package/src/cli/setup-cli.ts

@@ -9,7 +9,7 @@ import { $ } from "bun";
 import chalk from "chalk";
 import { theme } from "../theme/theme";
 
-export type SetupComponent = "python" | "stt";
+export type SetupComponent = "python";
 
 export interface SetupCommandArgs {
 	component: SetupComponent;
@@ -19,7 +19,7 @@ export interface SetupCommandArgs {
 	};
 }
 
-const VALID_COMPONENTS: SetupComponent[] = ["python", "stt"];
+const VALID_COMPONENTS: SetupComponent[] = ["python"];
 
 const PYTHON_PACKAGES = ["jupyter_kernel_gateway", "ipykernel"];
 const MANAGED_PYTHON_ENV = getPythonEnvDir();
@@ -206,9 +206,6 @@ export async function runSetupCommand(cmd: SetupCommandArgs): Promise<void> {
 		case "python":
 			await handlePythonSetup(cmd.flags);
 			break;
-		case "stt":
-			await handleSttSetup(cmd.flags);
-			break;
 	}
 }
 
@@ -295,60 +292,6 @@ async function handlePythonSetup(flags: { json?: boolean; check?: boolean }): Pr
 	}
 }
 
-async function handleSttSetup(flags: { json?: boolean; check?: boolean }): Promise<void> {
-	const { checkDependencies, formatDependencyStatus } = await import("../stt/setup");
-	const status = await checkDependencies();
-
-	if (flags.json) {
-		console.log(JSON.stringify(status, null, 2));
-		if (!status.recorder.available || !status.python.available || !status.whisper.available) process.exit(1);
-		return;
-	}
-
-	console.log(formatDependencyStatus(status));
-
-	if (status.recorder.available && status.python.available && status.whisper.available) {
-		console.log(chalk.green(`\n${theme.status.success} Speech-to-text is ready`));
-		return;
-	}
-
-	if (flags.check) {
-		process.exit(1);
-	}
-
-	if (!status.python.available) {
-		console.error(chalk.red(`\n${theme.status.error} Python not found`));
-		console.error(chalk.dim("Install Python 3.8+ and ensure it's in your PATH"));
-		process.exit(1);
-	}
-
-	if (!status.recorder.available) {
-		console.error(chalk.yellow(`\n${theme.status.warning} No recording tool found`));
-		console.error(chalk.dim(status.recorder.installHint));
-	}
-
-	if (!status.whisper.available) {
-		console.log(chalk.dim(`\nInstalling openai-whisper...`));
-		const { resolvePython } = await import("../stt/transcriber");
-		const pythonCmd = resolvePython()!;
-		const result = await $`${pythonCmd} -m pip install -q openai-whisper`.nothrow();
-		if (result.exitCode !== 0) {
-			console.error(chalk.red(`\n${theme.status.error} Failed to install openai-whisper`));
-			console.error(chalk.dim("Try manually: pip install openai-whisper"));
-			process.exit(1);
-		}
-	}
-
-	const recheck = await checkDependencies();
-	if (recheck.recorder.available && recheck.python.available && recheck.whisper.available) {
-		console.log(chalk.green(`\n${theme.status.success} Speech-to-text is ready`));
-	} else {
-		console.error(chalk.red(`\n${theme.status.error} Setup incomplete`));
-		console.log(formatDependencyStatus(recheck));
-		process.exit(1);
-	}
-}
-
 /**
  * Print setup command help.
  */
@@ -360,7 +303,6 @@ ${chalk.bold("Usage:")}
 
 ${chalk.bold("Components:")}
   python    Install Jupyter kernel dependencies for Python code execution
-  stt       Install speech-to-text dependencies (openai-whisper, recording tools)
             Packages: ${PYTHON_PACKAGES.join(", ")}
 
 ${chalk.bold("Options:")}
@@ -369,8 +311,6 @@ ${chalk.bold("Options:")}
 
 ${chalk.bold("Examples:")}
   ${APP_NAME} setup python           Install Python execution dependencies
-  ${APP_NAME} setup stt              Install speech-to-text dependencies
-  ${APP_NAME} setup stt --check      Check if STT dependencies are available
   ${APP_NAME} setup python --check   Check if Python execution is available
 `);
 }

package/src/commands/setup.ts

@@ -5,7 +5,7 @@ import { Args, Command, Flags, renderCommandHelp } from "@nghyane/arcane-utils/c
 import { runSetupCommand, type SetupCommandArgs, type SetupComponent } from "../cli/setup-cli";
 import { initTheme } from "../theme/theme";
 
-const COMPONENTS: SetupComponent[] = ["python", "stt"];
+const COMPONENTS: SetupComponent[] = ["python"];
 
 export default class Setup extends Command {
 	static description = "Install dependencies for optional features";

package/src/config/keybindings.ts

@@ -34,8 +34,7 @@ export type AppAction =
 	| "newSession"
 	| "tree"
 	| "fork"
-	| "resume"
-	| "toggleSTT";
+	| "resume";
 
 /**
  * All configurable actions.
@@ -73,7 +72,6 @@ export const DEFAULT_APP_KEYBINDINGS: Record<AppAction, KeyId | KeyId[]> = {
 	tree: [],
 	fork: [],
 	resume: [],
-	toggleSTT: "alt+h",
 };
 
 /**
@@ -106,7 +104,6 @@ const APP_ACTIONS: AppAction[] = [
 	"tree",
 	"fork",
 	"resume",
-	"toggleSTT",
 ];
 
 function isAppAction(action: string): action is AppAction {

package/src/config/settings-schema.ts

@@ -204,7 +204,7 @@ export const SETTINGS_SCHEMA = {
 	steeringMode: {
 		type: "enum",
 		values: ["all", "one-at-a-time"] as const,
-		default: "one-at-a-time",
+		default: "all",
 		ui: {
 			tab: "agent",
 			label: "Steering mode",
@@ -214,7 +214,7 @@ export const SETTINGS_SCHEMA = {
 	followUpMode: {
 		type: "enum",
 		values: ["all", "one-at-a-time"] as const,
-		default: "one-at-a-time",
+		default: "all",
 		ui: {
 			tab: "agent",
 			label: "Follow-up mode",
@@ -253,15 +253,6 @@ export const SETTINGS_SCHEMA = {
 			submenu: true,
 		},
 	},
-	normativeRewrite: {
-		type: "boolean",
-		default: false,
-		ui: {
-			tab: "agent",
-			label: "Normative rewrite",
-			description: "Rewrite tool call arguments to normalized format in session history",
-		},
-	},
 	readLineNumbers: {
 		type: "boolean",
 		default: false,
@@ -345,33 +336,6 @@ export const SETTINGS_SCHEMA = {
 	},
 	"branchSummary.reserveTokens": { type: "number", default: 16384 },
 
-	// ─────────────────────────────────────────────────────────────────────────
-	// Memories settings
-	// ─────────────────────────────────────────────────────────────────────────
-	"memories.enabled": {
-		type: "boolean",
-		default: false,
-		ui: {
-			tab: "agent",
-			label: "Memories",
-			description: "Enable autonomous memory extraction and consolidation",
-		},
-	},
-	"memories.maxRolloutsPerStartup": { type: "number", default: 64 },
-	"memories.maxRolloutAgeDays": { type: "number", default: 30 },
-	"memories.minRolloutIdleHours": { type: "number", default: 12 },
-	"memories.threadScanLimit": { type: "number", default: 300 },
-	"memories.maxRawMemoriesForGlobal": { type: "number", default: 200 },
-	"memories.stage1Concurrency": { type: "number", default: 8 },
-	"memories.stage1LeaseSeconds": { type: "number", default: 120 },
-	"memories.stage1RetryDelaySeconds": { type: "number", default: 120 },
-	"memories.phase2LeaseSeconds": { type: "number", default: 180 },
-	"memories.phase2RetryDelaySeconds": { type: "number", default: 180 },
-	"memories.phase2HeartbeatSeconds": { type: "number", default: 30 },
-	"memories.rolloutPayloadPercent": { type: "number", default: 0.7 },
-	"memories.fallbackTokenLimit": { type: "number", default: 16000 },
-	"memories.summaryInjectionTokenLimit": { type: "number", default: 5000 },
-
 	// ─────────────────────────────────────────────────────────────────────────
 	// Retry settings
 	// ─────────────────────────────────────────────────────────────────────────
@@ -468,6 +432,25 @@ export const SETTINGS_SCHEMA = {
 			submenu: true,
 		},
 	},
+	"astGrep.enabled": {
+		type: "boolean",
+		default: false,
+		ui: { tab: "tools", label: "AST Grep", description: "Enable ast_grep tool for structural code search" },
+	},
+	"astEdit.enabled": {
+		type: "boolean",
+		default: false,
+		ui: { tab: "tools", label: "AST Edit", description: "Enable ast_edit tool for structural code rewrites" },
+	},
+	"renderMermaid.enabled": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "tools",
+			label: "Render Mermaid",
+			description: "Enable the render_mermaid tool for ASCII diagram output",
+		},
+	},
 	"notebook.enabled": {
 		type: "boolean",
 		default: true,
@@ -594,7 +577,7 @@ export const SETTINGS_SCHEMA = {
 		type: "boolean",
 		default: true,
 		ui: {
-			tab: "display",
+			tab: "input",
 			label: "Auto-resize images",
 			description: "Resize large images to 2000x2000 max for better model compatibility",
 		},
@@ -602,7 +585,7 @@ export const SETTINGS_SCHEMA = {
 	"images.blockImages": {
 		type: "boolean",
 		default: false,
-		ui: { tab: "display", label: "Block images", description: "Prevent images from being sent to LLM providers" },
+		ui: { tab: "input", label: "Block images", description: "Prevent images from being sent to LLM providers" },
 	},
 
 	// ─────────────────────────────────────────────────────────────────────────
@@ -804,36 +787,6 @@ export const SETTINGS_SCHEMA = {
 		},
 	},
 
-	// ─────────────────────────────────────────────────────────────────────────
-	// STT settings
-	// ─────────────────────────────────────────────────────────────────────────
-	"stt.enabled": {
-		type: "boolean",
-		default: false,
-		ui: { tab: "input", label: "Speech-to-text", description: "Enable speech-to-text input via microphone" },
-	},
-	"stt.language": {
-		type: "string",
-		default: "en",
-		ui: {
-			tab: "input",
-			label: "STT language",
-			description: "Language code for transcription (e.g., en, es, fr)",
-			submenu: true,
-		},
-	},
-	"stt.modelName": {
-		type: "enum",
-		values: ["tiny", "tiny.en", "base", "base.en", "small", "small.en", "medium", "medium.en", "large"] as const,
-		default: "base.en",
-		ui: {
-			tab: "input",
-			label: "STT model",
-			description: "Whisper model size (larger = more accurate but slower)",
-			submenu: true,
-		},
-	},
-
 	// ─────────────────────────────────────────────────────────────────────────
 	// Edit settings
 	// ─────────────────────────────────────────────────────────────────────────
@@ -1061,24 +1014,6 @@ export interface RetrySettings {
 	baseDelayMs: number;
 }
 
-export interface MemoriesSettings {
-	enabled: boolean;
-	maxRolloutsPerStartup: number;
-	maxRolloutAgeDays: number;
-	minRolloutIdleHours: number;
-	threadScanLimit: number;
-	maxRawMemoriesForGlobal: number;
-	stage1Concurrency: number;
-	stage1LeaseSeconds: number;
-	stage1RetryDelaySeconds: number;
-	phase2LeaseSeconds: number;
-	phase2RetryDelaySeconds: number;
-	phase2HeartbeatSeconds: number;
-	rolloutPayloadPercent: number;
-	fallbackTokenLimit: number;
-	summaryInjectionTokenLimit: number;
-}
-
 export interface TodoCompletionSettings {
 	enabled: boolean;
 	maxReminders: number;
@@ -1135,14 +1070,6 @@ export interface ThinkingBudgetsSettings {
 	high: number;
 }
 
-export interface SttSettings {
-	enabled: boolean;
-	language: string | undefined;
-	modelName: string;
-	whisperPath: string | undefined;
-	modelPath: string | undefined;
-}
-
 export interface BashInterceptorRule {
 	pattern: string;
 	flags?: string;
@@ -1156,14 +1083,12 @@ export interface GroupTypeMap {
 	compaction: CompactionSettings;
 	contextPromotion: ContextPromotionSettings;
 	retry: RetrySettings;
-	memories: MemoriesSettings;
 	branchSummary: BranchSummarySettings;
 	skills: SkillsSettings;
 	ttsr: TtsrSettings;
 	exa: ExaSettings;
 	statusLine: StatusLineSettings;
 	thinkingBudgets: ThinkingBudgetsSettings;
-	stt: SttSettings;
 	modelRoles: Record<string, string>;
 }
 

package/src/config/settings.ts

@@ -42,7 +42,6 @@ export type {
 	ExaSettings,
 	GroupPrefix,
 	GroupTypeMap,
-	MemoriesSettings,
 	RetrySettings,
 	SettingPath,
 	SettingValue,

package/src/exa/mcp-client.ts

@@ -17,6 +17,61 @@ export function findApiKey(): string | null {
 	return $env.EXA_API_KEY;
 }
 
+function asRecord(value: unknown): Record<string, unknown> | null {
+	if (typeof value !== "object" || value === null) return null;
+	return value as Record<string, unknown>;
+}
+
+function parseJsonContent(text: string): unknown | null {
+	try {
+		return JSON.parse(text);
+	} catch {
+		return null;
+	}
+}
+
+/**
+ * Normalize tools/call payloads across MCP servers.
+ *
+ * Exa currently returns different shapes depending on deployment/environment:
+ * - direct payload in result
+ * - structured payload under result.structuredContent / result.data / result.result
+ * - JSON payload embedded as text in result.content[]
+ */
+function normalizeMcpToolPayload(payload: unknown): unknown {
+	const candidates: unknown[] = [];
+	const root = asRecord(payload);
+
+	if (root) {
+		if (root.structuredContent !== undefined) candidates.push(root.structuredContent);
+		if (root.data !== undefined) candidates.push(root.data);
+		if (root.result !== undefined) candidates.push(root.result);
+		candidates.push(root);
+
+		const content = root.content;
+		if (Array.isArray(content)) {
+			for (const item of content) {
+				const part = asRecord(item);
+				if (!part) continue;
+				const text = part.text;
+				if (typeof text !== "string" || text.trim().length === 0) continue;
+				const parsed = parseJsonContent(text);
+				if (parsed !== null) candidates.push(parsed);
+			}
+		}
+	} else {
+		candidates.push(payload);
+	}
+
+	for (const candidate of candidates) {
+		if (isSearchResponse(candidate)) {
+			return candidate;
+		}
+	}
+
+	return payload;
+}
+
 /** Fetch available tools from Exa MCP */
 export async function fetchExaTools(apiKey: string | null, toolNames: string[]): Promise<MCPTool[]> {
 	const params = new URLSearchParams();
@@ -66,7 +121,7 @@ export async function callExaTool(
 		throw new Error(`MCP error: ${response.error.message}`);
 	}
 
-	return response.result;
+	return normalizeMcpToolPayload(response.result);
 }
 
 /** Call a tool on Websets MCP */
@@ -86,7 +141,7 @@ export async function callWebsetsTool(
 		throw new Error(`MCP error: ${response.error.message}`);
 	}
 
-	return response.result;
+	return normalizeMcpToolPayload(response.result);
 }
 
 /** Parse Exa markdown format into SearchResponse */

package/src/extensibility/custom-tools/types.ts

@@ -178,10 +178,10 @@ export interface CustomTool<TParams extends TSchema = TSchema, TDetails = any> {
 	execute(
 		toolCallId: string,
 		params: Static<TParams>,
-		onUpdate: AgentToolUpdateCallback<TDetails, TParams> | undefined,
+		onUpdate: AgentToolUpdateCallback<TDetails> | undefined,
 		ctx: CustomToolContext,
 		signal?: AbortSignal,
-	): Promise<AgentToolResult<TDetails, TParams>>;
+	): Promise<AgentToolResult<TDetails>>;
 
 	/** Called on session lifecycle events - use to reconstruct state or cleanup resources */
 	onSession?: (event: CustomToolSessionEvent, ctx: CustomToolContext) => void | Promise<void>;

package/src/extensibility/custom-tools/wrapper.ts

@@ -26,7 +26,7 @@ export class CustomToolAdapter<TParams extends TSchema = TSchema, TDetails = any
 		toolCallId: string,
 		params: Static<TParams>,
 		signal?: AbortSignal,
-		onUpdate?: AgentToolUpdateCallback<TDetails, TParams>,
+		onUpdate?: AgentToolUpdateCallback<TDetails>,
 		context?: CustomToolContext,
 	) {
 		return this.tool.execute(toolCallId, params, onUpdate, context ?? this.getContext(), signal);

package/src/extensibility/extensions/wrapper.ts

@@ -96,7 +96,7 @@ export class ExtensionToolWrapper<TParameters extends TSchema = TSchema, TDetail
 		toolCallId: string,
 		params: Static<TParameters>,
 		signal?: AbortSignal,
-		onUpdate?: AgentToolUpdateCallback<TDetails, TParameters>,
+		onUpdate?: AgentToolUpdateCallback<TDetails>,
 		context?: AgentToolContext,
 	) {
 		// Emit tool_call event - extensions can block execution

package/src/extensibility/hooks/tool-wrapper.ts

@@ -34,7 +34,7 @@ export class HookToolWrapper<TParameters extends TSchema = TSchema, TDetails = u
 		toolCallId: string,
 		params: Static<TParameters>,
 		signal?: AbortSignal,
-		onUpdate?: AgentToolUpdateCallback<TDetails, TParameters>,
+		onUpdate?: AgentToolUpdateCallback<TDetails>,
 		context?: AgentToolContext,
 	) {
 		// Emit tool_call event - hooks can block execution