@nghyane/arcane 0.1.12 → 0.1.14

package/src/config/settings-schema.ts

@@ -262,15 +262,6 @@ export const SETTINGS_SCHEMA = {
 			description: "Rewrite tool call arguments to normalized format in session history",
 		},
 	},
-	repeatToolDescriptions: {
-		type: "boolean",
-		default: false,
-		ui: {
-			tab: "agent",
-			label: "Repeat tool descriptions",
-			description: "Render full tool descriptions in the system prompt instead of a tool name list",
-		},
-	},
 	readLineNumbers: {
 		type: "boolean",
 		default: false,
@@ -397,6 +388,29 @@ export const SETTINGS_SCHEMA = {
 	},
 	"retry.baseDelayMs": { type: "number", default: 2000 },
 
+	// ─────────────────────────────────────────────────────────────────────────
+	// Verification loop settings
+	// ─────────────────────────────────────────────────────────────────────────
+	"verification.autoCheck": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "agent",
+			label: "Auto-verify changes",
+			description: "Automatically remind agent to verify changes before completing",
+		},
+	},
+	"verification.maxReminders": {
+		type: "number",
+		default: 2,
+		ui: {
+			tab: "agent",
+			label: "Verification max reminders",
+			description: "Maximum verification reminders before giving up",
+			submenu: true,
+		},
+	},
+
 	// ─────────────────────────────────────────────────────────────────────────
 	// Todo completion settings
 	// ─────────────────────────────────────────────────────────────────────────
@@ -469,6 +483,15 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: { tab: "tools", label: "Enable Fetch", description: "Enable the fetch tool for URL fetching" },
 	},
+	"github.enabled": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "tools",
+			label: "Enable GitHub",
+			description: "Enable the GitHub API tool for repository exploration",
+		},
+	},
 	"librarian.enabled": {
 		type: "boolean",
 		default: true,
@@ -488,15 +511,6 @@ export const SETTINGS_SCHEMA = {
 		default: true,
 		ui: { tab: "tools", label: "Enable LSP", description: "Enable the lsp tool for language server protocol" },
 	},
-	"calc.enabled": {
-		type: "boolean",
-		default: false,
-		ui: {
-			tab: "tools",
-			label: "Enable Calculator",
-			description: "Enable the calculator tool for basic calculations",
-		},
-	},
 	"browser.enabled": {
 		type: "boolean",
 		default: true,
@@ -515,47 +529,10 @@ export const SETTINGS_SCHEMA = {
 			description: "Launch browser in headless mode (disable to show browser UI)",
 		},
 	},
-	"tools.intentTracing": {
-		type: "boolean",
-		default: true,
-		ui: {
-			tab: "tools",
-			label: "Intent tracing",
-			description: "Ask the agent to describe the intent of each tool call before executing it",
-		},
-	},
 
 	// ─────────────────────────────────────────────────────────────────────────
 	// Task tool settings
 	// ─────────────────────────────────────────────────────────────────────────
-	"task.isolation.enabled": {
-		type: "boolean",
-		default: false,
-		ui: {
-			tab: "tools",
-			label: "Task isolation",
-			description: "Run subagents in isolated git worktrees",
-			submenu: true,
-		},
-	},
-	"task.maxConcurrency": {
-		type: "number",
-		default: 32,
-		ui: {
-			tab: "tools",
-			label: "Task max concurrency",
-			description: "Concurrent limit for subagents",
-			submenu: true,
-		},
-	},
-	"task.disabledAgents": {
-		type: "array",
-		default: [] as string[],
-	},
-	"task.agentModelOverrides": {
-		type: "record",
-		default: {} as Record<string, string>,
-	},
 
 	// ─────────────────────────────────────────────────────────────────────────
 	// Startup settings
@@ -737,19 +714,6 @@ export const SETTINGS_SCHEMA = {
 		ui: { tab: "services", label: "Exa websets", description: "Webset management and enrichment tools" },
 	},
 
-	// ─────────────────────────────────────────────────────────────────────────
-	// Code Mode settings
-	// ─────────────────────────────────────────────────────────────────────────
-	"codemode.enabled": {
-		type: "boolean",
-		default: true,
-		ui: {
-			tab: "agent",
-			label: "Code Mode",
-			description: "Replace tool-calling with code generation (LLM writes JS to orchestrate tools)",
-		},
-	},
-
 	// Bash interceptor settings
 	// ─────────────────────────────────────────────────────────────────────────
 	"bash.virtualTerminal": {
@@ -963,16 +927,6 @@ export const SETTINGS_SCHEMA = {
 		},
 	},
 
-	// ─────────────────────────────────────────────────────────────────────────
-	// Commit settings (no UI - advanced)
-	// ─────────────────────────────────────────────────────────────────────────
-	"commit.mapReduceEnabled": { type: "boolean", default: true },
-	"commit.mapReduceMinFiles": { type: "number", default: 4 },
-	"commit.mapReduceMaxFileTokens": { type: "number", default: 50000 },
-	"commit.mapReduceTimeoutMs": { type: "number", default: 120000 },
-	"commit.mapReduceMaxConcurrency": { type: "number", default: 5 },
-	"commit.changelogMaxDiffChars": { type: "number", default: 120000 },
-
 	// ─────────────────────────────────────────────────────────────────────────
 	// Thinking budgets (no UI - advanced)
 	// ─────────────────────────────────────────────────────────────────────────
@@ -1148,15 +1102,6 @@ export interface SkillsSettings {
 	includeSkills?: string[];
 }
 
-export interface CommitSettings {
-	mapReduceEnabled: boolean;
-	mapReduceMinFiles: number;
-	mapReduceMaxFileTokens: number;
-	mapReduceTimeoutMs: number;
-	mapReduceMaxConcurrency: number;
-	changelogMaxDiffChars: number;
-}
-
 export interface TtsrSettings {
 	enabled: boolean;
 	contextMode: "discard" | "keep";
@@ -1214,7 +1159,6 @@ export interface GroupTypeMap {
 	memories: MemoriesSettings;
 	branchSummary: BranchSummarySettings;
 	skills: SkillsSettings;
-	commit: CommitSettings;
 	ttsr: TtsrSettings;
 	exa: ExaSettings;
 	statusLine: StatusLineSettings;

package/src/config/settings.ts

@@ -19,9 +19,9 @@ import { YAML } from "bun";
 import { type Settings as SettingsCapabilityItem, settingsCapability } from "../capability/settings";
 import type { ModelRole } from "../config/model-registry";
 import { loadCapability } from "../discovery";
-import { isLightTheme, setAutoThemeMapping, setColorBlindMode, setSymbolPreset } from "../modes/theme/theme";
 import { type EditMode, normalizeEditMode } from "../patch";
 import { AgentStorage } from "../session/agent-storage";
+import { isLightTheme, setAutoThemeMapping, setColorBlindMode, setSymbolPreset } from "../theme/theme";
 import { withFileLock } from "./file-lock";
 import {
 	type BashInterceptorRule,
@@ -37,7 +37,6 @@ import {
 export type {
 	BashInterceptorRule,
 	BranchSummarySettings,
-	CommitSettings,
 	CompactionSettings,
 	ContextPromotionSettings,
 	ExaSettings,
@@ -654,14 +653,14 @@ const SETTING_HOOKS: Partial<Record<SettingPath, SettingHook<any>>> = {
 	},
 	symbolPreset: value => {
 		if (typeof value === "string" && (value === "unicode" || value === "nerd" || value === "ascii")) {
-			setSymbolPreset(value).catch(err => {
+			setSymbolPreset(value).catch((err: unknown) => {
 				logger.warn("Settings: symbolPreset hook failed", { preset: value, error: String(err) });
 			});
 		}
 	},
 	colorBlindMode: value => {
 		if (typeof value === "boolean") {
-			setColorBlindMode(value).catch(err => {
+			setColorBlindMode(value).catch((err: unknown) => {
 				logger.warn("Settings: colorBlindMode hook failed", { enabled: value, error: String(err) });
 			});
 		}

package/src/debug/index.ts

@@ -9,8 +9,8 @@ import { getWorkProfile } from "@nghyane/arcane-natives";
 import { Container, Loader, type SelectItem, SelectList, Spacer, Text } from "@nghyane/arcane-tui";
 import { getSessionsDir } from "@nghyane/arcane-utils/dirs";
 import { DynamicBorder } from "../modes/components/dynamic-border";
-import { getSelectListTheme, getSymbolTheme, theme } from "../modes/theme/theme";
 import type { InteractiveModeContext } from "../modes/types";
+import { getSelectListTheme, getSymbolTheme, theme } from "../theme/theme";
 import { openPath } from "../utils/open";
 import { DebugLogViewerComponent } from "./log-viewer";
 import { generateHeapSnapshotData, type ProfilerSession, startCpuProfile } from "./profiler";

package/src/debug/log-formatting.ts

@@ -1,5 +1,5 @@
 import { sanitizeText } from "@nghyane/arcane-natives";
-import { replaceTabs, truncateToWidth } from "../tools/render-utils";
+import { replaceTabs, truncateToWidth } from "../ui/render-utils";
 
 export function formatDebugLogLine(line: string, maxWidth: number): string {
 	const sanitized = sanitizeText(line);

package/src/debug/log-viewer.ts

@@ -1,7 +1,7 @@
 import { copyToClipboard, sanitizeText } from "@nghyane/arcane-natives";
 import { type Component, matchesKey, padding, truncateToWidth, visibleWidth } from "@nghyane/arcane-tui";
-import { theme } from "../modes/theme/theme";
-import { replaceTabs } from "../tools/render-utils";
+import { theme } from "../theme/theme";
+import { replaceTabs } from "../ui/render-utils";
 import {
 	formatDebugLogExpandedLines,
 	formatDebugLogLine,

package/src/discovery/helpers.ts

@@ -10,6 +10,7 @@ import { readFile } from "../capability/fs";
 import { parseRuleConditionAndScope, type Rule, type RuleFrontmatter } from "../capability/rule";
 import type { Skill, SkillFrontmatter } from "../capability/skill";
 import type { LoadContext, LoadResult, SourceMeta } from "../capability/types";
+import type { AgentKind } from "../task/types";
 import { parseFrontmatter } from "../utils/frontmatter";
 import type { IgnoreMatcher } from "../utils/ignore-files";
 
@@ -215,9 +216,17 @@ export function parseModelList(value: unknown): string[] | undefined {
 export interface ParsedAgentFields {
 	name: string;
 	description: string;
-	tools?: string[];
+	tools: string[];
 	model?: string[];
 	thinkingLevel?: ThinkingLevel;
+	kind?: AgentKind;
+}
+
+const VALID_AGENT_KINDS: readonly string[] = ["local", "remote", "hybrid", "reasoning"];
+
+function parseAgentKind(value: unknown): AgentKind | undefined {
+	if (typeof value === "string" && VALID_AGENT_KINDS.includes(value)) return value as AgentKind;
+	return undefined;
 }
 
 /**
@@ -232,12 +241,13 @@ export function parseAgentFields(frontmatter: Record<string, unknown>): ParsedAg
 		return null;
 	}
 
-	const tools = parseArrayOrCSV(frontmatter.tools);
+	const tools = parseArrayOrCSV(frontmatter.tools) ?? [];
 
 	const model = parseModelList(frontmatter.model);
 	const thinkingLevel = parseThinkingLevel(frontmatter);
+	const kind = parseAgentKind(frontmatter.kind);
 
-	return { name, description, tools, model, thinkingLevel };
+	return { name, description, tools, model, thinkingLevel, kind };
 }
 
 async function globIf(

package/src/exa/company.ts

@@ -26,13 +26,8 @@ Parameters:
 	async execute(_toolCallId, params, _onUpdate, _ctx, _signal) {
 		try {
 			const apiKey = await findApiKey();
-			if (!apiKey) {
-				return {
-					content: [{ type: "text" as const, text: "Error: EXA_API_KEY not found" }],
-					details: { error: "EXA_API_KEY not found", toolName: "exa_company" },
-				};
-			}
-			const response = await callExaTool("company_research", params, apiKey);
+			// Exa MCP endpoint is publicly accessible; API key is optional
+			const response = await callExaTool("company_research_exa", params, apiKey);
 
 			if (isSearchResponse(response)) {
 				const formatted = formatSearchResults(response);

package/src/exa/index.ts

@@ -1,12 +1,7 @@
 /**
  * Exa MCP Tools
  *
- * 22 tools for Exa's MCP servers:
- * - 4 search tools (search, deep, code, crawl)
- * - 1 LinkedIn search tool
- * - 1 company research tool
- * - 2 researcher tools (start, poll)
- * - 14 websets tools (CRUD, items, search, enrichment, monitor)
+ * Provides Exa tools filtered by user settings.
  */
 import type { ExaSettings } from "../config/settings";
 import type { CustomTool } from "../extensibility/custom-tools/types";
@@ -17,15 +12,6 @@ import { searchTools } from "./search";
 import type { ExaRenderDetails } from "./types";
 import { websetsTools } from "./websets";
 
-/** All Exa tools (22 total) - static export for backward compatibility */
-export const exaTools: CustomTool<any, ExaRenderDetails>[] = [
-	...searchTools,
-	linkedinTool,
-	companyTool,
-	...researcherTools,
-	...websetsTools,
-];
-
 /** Get Exa tools filtered by settings */
 export function getExaTools(settings: Required<ExaSettings>): CustomTool<any, ExaRenderDetails>[] {
 	if (!settings.enabled) return [];
@@ -40,23 +26,3 @@ export function getExaTools(settings: Required<ExaSettings>): CustomTool<any, Ex
 
 	return tools;
 }
-
-export { companyTool } from "./company";
-export { linkedinTool } from "./linkedin";
-export {
-	callExaTool,
-	callWebsetsTool,
-	createMCPToolFromServer,
-	fetchMCPToolSchema,
-	findApiKey,
-	formatSearchResults,
-	isSearchResponse,
-	MCPWrappedTool,
-} from "./mcp-client";
-export { renderExaCall, renderExaResult } from "./render";
-export { researcherTools } from "./researcher";
-// Re-export individual modules for selective importing
-export { searchTools } from "./search";
-// Re-export types and utilities
-export type { ExaRenderDetails, ExaSearchResponse, ExaSearchResult, MCPToolWrapperConfig } from "./types";
-export { websetsTools } from "./websets";

package/src/exa/linkedin.ts

@@ -26,13 +26,8 @@ Parameters:
 	async execute(_toolCallId, params, _onUpdate, _ctx, _signal) {
 		try {
 			const apiKey = await findApiKey();
-			if (!apiKey) {
-				return {
-					content: [{ type: "text" as const, text: "Error: EXA_API_KEY not found" }],
-					details: { error: "EXA_API_KEY not found", toolName: "exa_linkedin" },
-				};
-			}
-			const response = await callExaTool("linkedin_search", params, apiKey);
+			// Exa MCP endpoint is publicly accessible; API key is optional
+			const response = await callExaTool("linkedin_search_exa", params, apiKey);
 
 			if (isSearchResponse(response)) {
 				const formatted = formatSearchResults(response);

package/src/exa/mcp-client.ts

@@ -18,8 +18,11 @@ export function findApiKey(): string | null {
 }
 
 /** Fetch available tools from Exa MCP */
-export async function fetchExaTools(apiKey: string, toolNames: string[]): Promise<MCPTool[]> {
-	const url = `https://mcp.exa.ai/mcp?exaApiKey=${encodeURIComponent(apiKey)}&toolNames=${encodeURIComponent(toolNames.join(","))}`;
+export async function fetchExaTools(apiKey: string | null, toolNames: string[]): Promise<MCPTool[]> {
+	const params = new URLSearchParams();
+	if (apiKey) params.set("exaApiKey", apiKey);
+	params.set("toolNames", toolNames.join(","));
+	const url = `https://mcp.exa.ai/mcp?${params.toString()}`;
 	const response = (await callMCP(url, "tools/list")) as MCPToolsResponse;
 
 	if (response.error) {
@@ -44,8 +47,15 @@ export async function fetchWebsetsTools(apiKey: string): Promise<MCPTool[]> {
 }
 
 /** Call a tool on Exa MCP (simplified: toolName as first arg for easier use) */
-export async function callExaTool(toolName: string, args: Record<string, unknown>, apiKey: string): Promise<unknown> {
-	const url = `https://mcp.exa.ai/mcp?exaApiKey=${encodeURIComponent(apiKey)}&tools=${encodeURIComponent(toolName)}`;
+export async function callExaTool(
+	toolName: string,
+	args: Record<string, unknown>,
+	apiKey: string | null,
+): Promise<unknown> {
+	const params = new URLSearchParams();
+	if (apiKey) params.set("exaApiKey", apiKey);
+	params.set("tools", toolName);
+	const url = `https://mcp.exa.ai/mcp?${params.toString()}`;
 	const response = (await callMCP(url, "tools/call", {
 		name: toolName,
 		arguments: args,
@@ -188,7 +198,7 @@ const mcpSchemaCache = new Map<string, MCPTool>();
 
 /** Fetch and cache MCP tool schema */
 export async function fetchMCPToolSchema(
-	apiKey: string,
+	apiKey: string | null,
 	mcpToolName: string,
 	isWebsetsTool = false,
 ): Promise<MCPTool | null> {
@@ -198,7 +208,7 @@ export async function fetchMCPToolSchema(
 	}
 
 	try {
-		const tools = isWebsetsTool ? await fetchWebsetsTools(apiKey) : await fetchExaTools(apiKey, [mcpToolName]);
+		const tools = isWebsetsTool ? await fetchWebsetsTools(apiKey!) : await fetchExaTools(apiKey, [mcpToolName]);
 		const tool = tools.find(t => t.name === mcpToolName);
 		if (tool) {
 			mcpSchemaCache.set(cacheKey, tool);
@@ -238,15 +248,15 @@ export class MCPWrappedTool implements CustomTool<TSchema, ExaRenderDetails> {
 	): Promise<CustomToolResult<ExaRenderDetails>> {
 		try {
 			const apiKey = await findApiKey();
-			if (!apiKey) {
+			if (!apiKey && this.config.isWebsetsTool) {
 				return {
-					content: [{ type: "text" as const, text: "Error: EXA_API_KEY not found" }],
-					details: { error: "EXA_API_KEY not found", toolName: this.config.name },
+					content: [{ type: "text" as const, text: "Error: EXA_API_KEY required for Websets tools" }],
+					details: { error: "EXA_API_KEY required for Websets tools", toolName: this.config.name },
 				};
 			}
 
 			const response = this.config.isWebsetsTool
-				? await callWebsetsTool(apiKey, this.config.mcpToolName, params as Record<string, unknown>)
+				? await callWebsetsTool(apiKey!, this.config.mcpToolName, params as Record<string, unknown>)
 				: await callExaTool(this.config.mcpToolName, params as Record<string, unknown>, apiKey);
 
 			if (isSearchResponse(response)) {
@@ -277,7 +287,7 @@ export class MCPWrappedTool implements CustomTool<TSchema, ExaRenderDetails> {
  * Falls back to provided fallback schema if MCP fetch fails.
  */
 export async function createMCPToolFromServer(
-	apiKey: string,
+	apiKey: string | null,
 	config: MCPToolWrapperConfig,
 	fallbackSchema: TSchema,
 	fallbackDescription: string,