@nghyane/arcane 0.1.15 → 0.1.17

package/src/modes/controllers/command-controller.ts

@@ -14,10 +14,10 @@ import { Snowflake } from "@nghyane/arcane-utils";
 import { setProjectDir } from "@nghyane/arcane-utils/dirs";
 import { $ } from "bun";
 import { reset as resetCapabilities } from "../../capability";
+import { formatKeyHint, type KeyId } from "../../config/keybindings";
 import { loadCustomShare } from "../../export/custom-share";
 import type { CompactOptions } from "../../extensibility/extensions/types";
 import { getGatewayStatus } from "../../ipy/gateway-coordinator";
-import { buildMemoryToolDeveloperInstructions, clearMemoryData, enqueueMemoryConsolidation } from "../../memories";
 import { BashExecutionComponent } from "../../modes/components/bash-execution";
 import { BorderedLoader } from "../../modes/components/bordered-loader";
 import { DynamicBorder } from "../../modes/components/dynamic-border";
@@ -362,43 +362,44 @@ export class CommandController {
 	}
 
 	handleHotkeysCommand(): void {
-		const expandToolsKey = this.ctx.keybindings.getDisplayString("expandTools") || "Ctrl+O";
-		const sttKey = this.ctx.keybindings.getDisplayString("toggleSTT") || "Alt+H";
+		const k = (id: string) => formatKeyHint(id as KeyId);
+		const expandToolsKey = this.ctx.keybindings.getDisplayString("expandTools") || k("ctrl+o");
+		const sttKey = this.ctx.keybindings.getDisplayString("toggleSTT") || k("alt+h");
 		const hotkeys = `
 **Navigation**
 | Key | Action |
 |-----|--------|
 | \`Arrow keys\` | Move cursor / browse history (Up when empty) |
-| \`Option+Left/Right\` | Move by word |
-| \`Ctrl+A\` / \`Home\` / \`Cmd+Left\` | Start of line |
-| \`Ctrl+E\` / \`End\` / \`Cmd+Right\` | End of line |
+| \`${k("alt+left")}/${k("alt+right")}\` | Move by word |
+| \`${k("ctrl+a")}\` / \`Home\` | Start of line |
+| \`${k("ctrl+e")}\` / \`End\` | End of line |
 
 **Editing**
 | Key | Action |
 |-----|--------|
 | \`Enter\` | Send message |
-| \`Shift+Enter\` / \`Alt+Enter\` | New line |
-| \`Ctrl+W\` / \`Option+Backspace\` | Delete word backwards |
-| \`Ctrl+U\` | Delete to start of line |
-| \`Ctrl+K\` | Delete to end of line |
+| \`${k("shift+enter")}\` / \`${k("alt+enter")}\` | New line |
+| \`${k("ctrl+w")}\` / \`${k("alt+backspace")}\` | Delete word backwards |
+| \`${k("ctrl+u")}\` | Delete to start of line |
+| \`${k("ctrl+k")}\` | Delete to end of line |
 
 **Other**
 | Key | Action |
 |-----|--------|
 | \`Tab\` | Path completion / accept autocomplete |
 | \`Escape\` | Cancel autocomplete / abort streaming |
-| \`Ctrl+C\` | Clear editor (first) / exit (second) |
-| \`Ctrl+D\` | Exit (when editor is empty) |
-| \`Ctrl+Z\` | Suspend to background |
-| \`Shift+Tab\` | Cycle thinking level |
-| \`Ctrl+P\` | Cycle role models (slow/default/fast) |
-| \`Shift+Ctrl+P\` | Cycle role models (temporary) |
-| \`Alt+P\` | Select model (temporary) |
-| \`Ctrl+L\` | Select model (set roles) |
-| \`Ctrl+R\` | Search prompt history |
+| \`${k("ctrl+c")}\` | Clear editor (first) / exit (second) |
+| \`${k("ctrl+d")}\` | Exit (when editor is empty) |
+| \`${k("ctrl+z")}\` | Suspend to background |
+| \`${k("shift+tab")}\` | Cycle thinking level |
+| \`${k("ctrl+p")}\` | Cycle role models (slow/default/fast) |
+| \`${k("shift+ctrl+p")}\` | Cycle role models (temporary) |
+| \`${k("alt+p")}\` | Select model (temporary) |
+| \`${k("ctrl+l")}\` | Select model (set roles) |
+| \`${k("ctrl+r")}\` | Search prompt history |
 | \`${expandToolsKey}\` | Toggle tool output expansion |
-| \`Ctrl+T\` | Toggle todo list expansion |
-| \`Ctrl+G\` | Edit message in external editor |
+| \`${k("ctrl+t")}\` | Toggle todo list expansion |
+| \`${k("ctrl+g")}\` | Edit message in external editor |
 | \`${sttKey}\` | Toggle speech-to-text recording |
 | \`/\` | Slash commands |
 | \`!\` | Run bash command |
@@ -415,49 +416,10 @@ export class CommandController {
 		this.ctx.ui.requestRender();
 	}
 
-	async handleMemoryCommand(text: string): Promise<void> {
-		const argumentText = text.slice(7).trim();
-		const action = argumentText.split(/\s+/, 1)[0]?.toLowerCase() || "view";
-		const agentDir = this.ctx.settings.getAgentDir();
-
-		if (action === "view") {
-			const payload = await buildMemoryToolDeveloperInstructions(agentDir, this.ctx.settings);
-			if (!payload) {
-				this.ctx.showWarning("Memory payload is empty (memories disabled or no memory summary found).");
-				return;
-			}
-			this.ctx.chatContainer.addChild(new Spacer(1));
-			this.ctx.chatContainer.addChild(new DynamicBorder());
-			this.ctx.chatContainer.addChild(new Text(theme.bold(theme.fg("accent", "Memory Injection Payload")), 1, 0));
-			this.ctx.chatContainer.addChild(new Spacer(1));
-			this.ctx.chatContainer.addChild(new Markdown(payload, 1, 1, getMarkdownTheme()));
-			this.ctx.chatContainer.addChild(new DynamicBorder());
-			this.ctx.ui.requestRender();
-			return;
-		}
-
-		if (action === "reset" || action === "clear") {
-			try {
-				await clearMemoryData(agentDir, this.ctx.sessionManager.getCwd());
-				await this.ctx.session.refreshBaseSystemPrompt();
-				this.ctx.showStatus("Memory data cleared and system prompt refreshed.");
-			} catch (error) {
-				this.ctx.showError(`Memory clear failed: ${error instanceof Error ? error.message : String(error)}`);
-			}
-			return;
-		}
-
-		if (action === "enqueue" || action === "rebuild") {
-			try {
-				enqueueMemoryConsolidation(agentDir);
-				this.ctx.showStatus("Memory consolidation enqueued.");
-			} catch (error) {
-				this.ctx.showError(`Memory enqueue failed: ${error instanceof Error ? error.message : String(error)}`);
-			}
-			return;
-		}
-
-		this.ctx.showError("Usage: /memory <view|clear|reset|enqueue|rebuild>");
+	async handleMemoryCommand(_text: string): Promise<void> {
+		this.ctx.showWarning(
+			"The /memory command has been removed. Use save_memory tool or add facts to AGENTS.md directly.",
+		);
 	}
 
 	async handleClearCommand(): Promise<void> {

package/src/modes/utils/ui-helpers.ts

@@ -1,6 +1,7 @@
 import type { AgentMessage } from "@nghyane/arcane-agent";
 import type { AssistantMessage, Message } from "@nghyane/arcane-ai";
 import { Spacer, Text, TruncatedText } from "@nghyane/arcane-tui";
+import { formatKeyHint, type KeyId } from "../../config/keybindings";
 import { settings } from "../../config/settings";
 import { AssistantMessageComponent } from "../../modes/components/assistant-message";
 import { BashExecutionComponent } from "../../modes/components/bash-execution";
@@ -385,7 +386,7 @@ export class UiHelpers {
 				const queuedText = theme.fg("dim", `${entry.label}: ${entry.message}`);
 				this.ctx.pendingMessagesContainer.addChild(new TruncatedText(queuedText, 1, 0));
 			}
-			const dequeueKey = this.ctx.keybindings.getDisplayString("dequeue") || "Alt+Up";
+			const dequeueKey = this.ctx.keybindings.getDisplayString("dequeue") || formatKeyHint("alt+up" as KeyId);
 			const hintText = theme.fg("dim", `${theme.tree.hook} ${dequeueKey} to edit`);
 			this.ctx.pendingMessagesContainer.addChild(new TruncatedText(hintText, 1, 0));
 		}

package/src/patch/hashline.ts

@@ -566,6 +566,37 @@ export function validateLineRef(ref: { line: number; hash: string }, fileLines:
 // Edit Application
 // ═══════════════════════════════════════════════════════════════════════════
 
+/**
+ * Detect suspicious Unicode escape placeholders in edit lines.
+ * LLMs sometimes emit literal `\uDDDD` strings instead of actual Unicode characters.
+ * Returns a warning message if detected, undefined otherwise.
+ */
+function detectUnicodeEscapePlaceholders(lines: string[]): string | undefined {
+	for (const line of lines) {
+		if (/\\u[0-9A-Fa-f]{4}/.test(line)) {
+			return "Warning: edit content contains literal Unicode escape sequences (\\uXXXX). These may be intended as actual Unicode characters.";
+		}
+	}
+	return undefined;
+}
+
+/**
+ * Auto-correct escaped tab indentation in edit lines.
+ * When enabled via ARCANE_HASHLINE_AUTOCORRECT_ESCAPED_TABS=1, replaces
+ * leading `\\t` sequences (literal backslash-t from JSON) with real tab characters.
+ */
+function autocorrectEscapedTabs(lines: string[]): string[] {
+	if (Bun.env.ARCANE_HASHLINE_AUTOCORRECT_ESCAPED_TABS !== "1") {
+		return lines;
+	}
+	return lines.map(line => {
+		const match = line.match(/^((?:\\t)+)/);
+		if (!match) return line;
+		const tabCount = match[1].length / 2; // each \\t is 2 chars
+		return "\t".repeat(tabCount) + line.slice(match[1].length);
+	});
+}
+
 /**
  * Apply an array of hashline edits to file content.
  *
@@ -599,6 +630,16 @@ export function applyHashlineEdits(
 
 	const autocorrect = Bun.env.ARCANE_HL_AUTOCORRECT === "1";
 
+	// Collect warnings and auto-correct edit content
+	const warnings: string[] = [];
+	for (const edit of edits) {
+		const unicodeWarning = detectUnicodeEscapePlaceholders(edit.content);
+		if (unicodeWarning && !warnings.includes(unicodeWarning)) {
+			warnings.push(unicodeWarning);
+		}
+		edit.content = autocorrectEscapedTabs(edit.content);
+	}
+
 	function collectExplicitlyTouchedLines(): Set<number> {
 		const touched = new Set<number>();
 		for (const edit of edits) {
@@ -914,6 +955,7 @@ export function applyHashlineEdits(
 	return {
 		content: finalContent,
 		firstChangedLine,
+		...(warnings.length > 0 ? { warnings } : {}),
 		...(noopEdits.length > 0 ? { noopEdits } : {}),
 	};
 

package/src/prompts/system/system-prompt.md

@@ -162,6 +162,20 @@ Best practices:
 - Run multiple sub-agents concurrently if tasks are independent with disjoint write targets.
 {{/has}}
 
+### Cross-session Knowledge
+
+Tools: `find_thread`, `read_thread`, `save_memory`
+**Proactive search triggers** — use `find_thread` when:
+- User mentions past work: "we did this before", "last time", "in a previous session"
+- User asks "what did we do about X" or "how did we solve Y"
+- Task seems related to work that may have been done before
+- Handoff context references a parent thread and you need more detail
+**Do NOT search when:**
+- Question is about current session context
+- Generic coding question with no project-specific history
+- User explicitly provides all needed context
+**save_memory**: only when user says "remember this" or states a clear preference. If unsure, ask.
+
 ### Verification
 After completing changes, verify using commands from AGENTS.md or the project's config. Format → typecheck/lint → test (if relevant) → build (if required).
 Report evidence concisely: counts, pass/fail, error summary.
@@ -252,16 +266,6 @@ Scan descriptions vs task domain — read skill if ≥50% likely relevant.
 </rules>
 {{/if}}
 
-{{#if memories.length}}
-<memories>
-{{#each memories}}
-<memory path="{{path}}">
-{{content}}
-</memory>
-{{/each}}
-</memories>
-{{/if}}
-
 {{#if preloadedSkills.length}}
 {{#each preloadedSkills}}
 <skill name="{{name}}">

package/src/prompts/thread-extract.md

@@ -0,0 +1,16 @@
+You are helping extract relevant information from a conversation thread based on a goal.
+
+## Task
+
+I am providing a conversation thread rendered as markdown, along with a goal describing what information to extract.
+
+Your job is to:
+1. Analyze the thread content
+2. Identify information that is relevant to the goal
+3. Extract and preserve those relevant parts with full fidelity
+
+## Rules
+- Be concise but complete — include all relevant details
+- Preserve code snippets, file paths, commands, and decisions exactly as they appear
+- Omit pleasantries, failed attempts, and thinking-out-loud unless the goal asks for them
+- If nothing relevant is found, say so briefly

package/src/prompts/tools/render-mermaid.md

@@ -0,0 +1,9 @@
+Convert Mermaid graph source into ASCII diagram output.
+
+Parameters:
+- `mermaid` (required): Mermaid graph text to render.
+- `config` (optional): JSON render configuration (spacing and layout options).
+Behavior:
+- Returns ASCII diagram text.
+- Saves full ASCII output to an artifact URL (`artifact://<id>`) when artifact storage is available.
+- Returns an error when the Mermaid input is invalid or rendering fails.

package/src/sdk.ts

@@ -42,13 +42,11 @@ import {
 	ArtifactProtocolHandler,
 	DocsProtocolHandler,
 	InternalUrlRouter,
-	MemoryProtocolHandler,
 	RuleProtocolHandler,
 	SkillProtocolHandler,
 } from "./internal-urls";
 import { disposeAllKernelSessions } from "./ipy/executor";
 import { discoverAndLoadMCPTools, type MCPManager, type MCPToolsLoadResult } from "./mcp";
-import { buildMemoryToolDeveloperInstructions, getMemoryRoot, startMemoryStartupTask } from "./memories";
 import { collectEnvSecrets, loadSecrets, obfuscateMessages, SecretObfuscator } from "./secrets";
 import { AgentSession } from "./session/agent-session";
 import { AuthStorage } from "./session/auth-storage";
@@ -735,7 +733,7 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
 		settings,
 	};
 
-	// Initialize internal URL router for internal protocols (agent://, artifact://, memory://, skill://, rule://)
+	// Initialize internal URL router for internal protocols (agent://, artifact://, skill://, rule://)
 	const internalRouter = new InternalUrlRouter();
 	const getArtifactsDir = () => {
 		const sessionFile = sessionManager.getSessionFile();
@@ -743,11 +741,6 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
 	};
 	internalRouter.register(new AgentProtocolHandler({ getArtifactsDir }));
 	internalRouter.register(new ArtifactProtocolHandler({ getArtifactsDir }));
-	internalRouter.register(
-		new MemoryProtocolHandler({
-			getMemoryRoot: () => getMemoryRoot(agentDir, settings.getCwd()),
-		}),
-	);
 	internalRouter.register(
 		new SkillProtocolHandler({
 			getSkills: () => skills,
@@ -1027,7 +1020,6 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
 
 	const rebuildSystemPrompt = async (toolNames: string[], tools: Map<string, AgentTool>): Promise<string> => {
 		toolContextStore.setToolNames(toolNames);
-		const memoryInstructions = await buildMemoryToolDeveloperInstructions(agentDir, settings);
 		const defaultPrompt = await buildSystemPromptInternal({
 			cwd,
 			skills,
@@ -1037,7 +1029,6 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
 			toolNames,
 			rules: rulebookRules,
 			skillsSettings: settings.getGroup("skills") as SkillsSettings,
-			appendSystemPrompt: memoryInstructions,
 		});
 
 		if (options.systemPrompt === undefined) {
@@ -1054,7 +1045,6 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
 				rules: rulebookRules,
 				skillsSettings: settings.getGroup("skills") as SkillsSettings,
 				customPrompt: options.systemPrompt,
-				appendSystemPrompt: memoryInstructions,
 			});
 		}
 		return options.systemPrompt(defaultPrompt);
@@ -1258,14 +1248,6 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
 		}
 	}
 
-	startMemoryStartupTask({
-		session,
-		settings,
-		modelRegistry,
-		agentDir,
-		isSubagent,
-	});
-
 	return {
 		session,
 		extensionsResult,

package/src/session/agent-session.ts

@@ -2067,9 +2067,10 @@ Be thorough - include exact file paths, function names, error messages, and tech
 				return undefined;
 			}
 
-			// Start a new session
+			// Start a new session with parent reference
+			const parentThreadId = this.sessionManager.getSessionId();
 			await this.sessionManager.flush();
-			await this.sessionManager.newSession();
+			await this.sessionManager.newSession({ parentSession: parentThreadId });
 			this.agent.reset();
 			this.agent.sessionId = this.sessionManager.getSessionId();
 			this.#steeringMessages = [];
@@ -2078,7 +2079,7 @@ Be thorough - include exact file paths, function names, error messages, and tech
 			this.#todoReminderCount = 0;
 
 			// Inject the handoff document as a custom message
-			const handoffContent = `<handoff-context>\n${handoffText}\n</handoff-context>\n\nThe above is a handoff document from a previous session. Use this context to continue the work seamlessly.`;
+			const handoffContent = `<handoff-context thread="${parentThreadId}">\n${handoffText}\n</handoff-context>\n\nThe above is a handoff document from thread \`${parentThreadId}\`. Use this context to continue the work seamlessly. If you need additional details not covered above, use \`read_thread("${parentThreadId}", "your specific question")\` to query the original session.`;
 			this.sessionManager.appendCustomMessageEntry("handoff", handoffContent, true);
 
 			// Rebuild agent messages from session

package/src/session/retry-utils.ts

@@ -17,7 +17,7 @@ export function isRetryableErrorMessage(errorMessage: string): boolean {
  * Check if an error message indicates a usage/billing limit (non-transient).
  */
 export function isUsageLimitErrorMessage(errorMessage: string): boolean {
-	return /usage.?limit|usage_limit_reached|limit_reached/i.test(errorMessage);
+	return /usage.?limit|usage_limit_reached|limit_reached|quota.?exhaust/i.test(errorMessage);
 }
 
 /**