@nghyane/arcane 0.1.19 → 0.1.20

package/src/tools/github.ts

@@ -429,10 +429,10 @@ export class GitHubTool implements AgentTool<typeof schema, GitHubToolDetails, T
 
 	async execute(
 		_toolCallId: string,
-		params: Record<string, unknown>,
+		params: GitHubInput,
 		signal?: AbortSignal,
 	): Promise<AgentToolResult<GitHubToolDetails>> {
-		const input = params as unknown as GitHubInput;
+		const input = params;
 		const details: GitHubToolDetails = {
 			action: input.action,
 			owner: input.owner,

package/src/tools/grep.ts

@@ -18,7 +18,7 @@ import { resolveToCwd } from "./path-utils";
 import { ToolError } from "./tool-errors";
 
 const grepSchema = Type.Object({
-	pattern: Type.String({ description: "Regex pattern to search for" }),
+	pattern: Type.String({ description: "Regex pattern to search for", minLength: 1 }),
 	path: Type.Optional(Type.String({ description: "Directory or file to search (default: cwd)" })),
 	glob: Type.Optional(Type.String({ description: 'Glob filter for file paths (e.g. "*.ts")' })),
 	type: Type.Optional(Type.String({ description: 'File extension filter without dot (e.g. "ts")' })),
@@ -278,7 +278,7 @@ export class GrepTool implements AgentTool<typeof grepSchema, GrepToolDetails, T
 		});
 	}
 
-	renderCall(args: GrepRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component {
+	renderCall(args: GrepRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component {
 		const meta: string[] = [];
 		if (args.path) meta.push(`in ${args.path}`);
 		if (args.glob) meta.push(`glob:${args.glob}`);
@@ -295,7 +295,7 @@ export class GrepTool implements AgentTool<typeof grepSchema, GrepToolDetails, T
 		if (args.offset !== undefined && args.offset > 0) meta.push(`offset:${args.offset}`);
 
 		const text = renderStatusLine(
-			{ icon: "pending", title: "Grep", description: args.pattern || "?", meta },
+			{ icon: "running", spinnerFrame: options.spinnerFrame, title: "Grep", description: args.pattern || "?", meta },
 			uiTheme,
 		);
 		return new Text(text, 0, 0);

package/src/tools/notebook.ts

@@ -178,7 +178,7 @@ export class NotebookTool implements AgentTool<typeof notebookSchema, NotebookTo
 		});
 	}
 
-	renderCall(args: NotebookRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component {
+	renderCall(args: NotebookRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component {
 		const meta: string[] = [];
 		const notebookPath = args.notebookPath ?? args.notebook_path;
 		const cellNumber = args.cellNumber ?? args.cell_index;
@@ -188,7 +188,13 @@ export class NotebookTool implements AgentTool<typeof notebookSchema, NotebookTo
 		if (cellType) meta.push(`type:${cellType}`);
 
 		const text = renderStatusLine(
-			{ icon: "pending", title: "Notebook", description: args.action || "?", meta },
+			{
+				icon: "running",
+				spinnerFrame: options.spinnerFrame,
+				title: "Notebook",
+				description: args.action || "?",
+				meta,
+			},
 			uiTheme,
 		);
 		return new Text(text, 0, 0);

package/src/tools/python.ts

@@ -476,7 +476,7 @@ export class PythonTool implements AgentTool<typeof pythonSchema, any, Theme> {
 		return context;
 	}
 
-	renderCall(args: PythonRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component {
+	renderCall(args: PythonRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component {
 		const cells = args.cells ?? [];
 		const cwd = getProjectDir();
 		let displayWorkdir = args.cwd;
@@ -526,8 +526,9 @@ export class PythonTool implements AgentTool<typeof pythonSchema, any, Theme> {
 							index: i,
 							total: cells.length,
 							title: combinedTitle,
-							status: "pending",
+							status: "running",
 							width,
+							spinnerFrame: options.spinnerFrame,
 							codeMaxLines: PYTHON_DEFAULT_PREVIEW_LINES,
 							expanded: true,
 						},

package/src/tools/read-thread.ts

@@ -377,9 +377,12 @@ export class ReadThreadTool implements AgentTool<typeof readThreadSchema, ReadTh
 		};
 	}
 
-	renderCall(args: ReadThreadRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component {
+	renderCall(args: ReadThreadRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component {
 		const meta = args.threadId ? [args.threadId] : [];
-		const text = renderStatusLine({ icon: "pending", title: "Read Thread", meta }, uiTheme);
+		const text = renderStatusLine(
+			{ icon: "running", spinnerFrame: options.spinnerFrame, title: "Read Thread", meta },
+			uiTheme,
+		);
 		return new Text(text, 0, 0);
 	}
 

package/src/tools/read.ts

@@ -1,5 +1,5 @@
 import * as fs from "node:fs/promises";
-import path from "node:path";
+import * as path from "node:path";
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@nghyane/arcane-agent";
 import type { ImageContent, TextContent } from "@nghyane/arcane-ai";
 import { FileType, glob } from "@nghyane/arcane-natives";
@@ -1055,7 +1055,7 @@ export class ReadTool implements AgentTool<typeof readSchema, ReadToolDetails, T
 		return resultBuilder.done();
 	}
 
-	renderCall(args: ReadRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component {
+	renderCall(args: ReadRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component {
 		const rawPath = args.file_path || args.path || "";
 		const filePath = shortenPath(rawPath);
 		const offset = args.offset;
@@ -1068,7 +1068,10 @@ export class ReadTool implements AgentTool<typeof readSchema, ReadToolDetails, T
 			pathDisplay += `:${startLine}${endLine ? `-${endLine}` : ""}`;
 		}
 
-		const text = renderStatusLine({ icon: "pending", title: "Read", description: pathDisplay }, uiTheme);
+		const text = renderStatusLine(
+			{ icon: "running", spinnerFrame: options.spinnerFrame, title: "Read", description: pathDisplay },
+			uiTheme,
+		);
 		return new Text(text, 0, 0);
 	}
 

package/src/tools/render-mermaid.ts

@@ -1,8 +1,6 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@nghyane/arcane-agent";
 import { type AsciiRenderOptions, renderMermaidAscii } from "@nghyane/arcane-utils";
 import { type Static, Type } from "@sinclair/typebox";
-import { renderPromptTemplate } from "../config/prompt-templates";
-import renderMermaidDescription from "../prompts/tools/render-mermaid.md" with { type: "text" };
 import type { ToolSession } from "./index";
 import { allocateOutputArtifact } from "./output-utils";
 
@@ -38,14 +36,12 @@ export interface RenderMermaidToolDetails {
 export class RenderMermaidTool implements AgentTool<typeof renderMermaidSchema, RenderMermaidToolDetails> {
 	readonly name = "render_mermaid";
 	readonly label = "RenderMermaid";
-	readonly description: string;
+	readonly description =
+		"Convert Mermaid graph source into ASCII diagram output. Returns ASCII diagram text. Saves full output to an artifact URL when artifact storage is available.";
 	readonly parameters = renderMermaidSchema;
 	readonly strict = true;
 
-	constructor(private readonly session: ToolSession) {
-		this.description = renderPromptTemplate(renderMermaidDescription);
-	}
-
+	constructor(private readonly session: ToolSession) {}
 	async execute(
 		_toolCallId: string,
 		params: RenderMermaidParams,

package/src/tools/save-memory.ts

@@ -11,7 +11,7 @@ import { shortenPath, TRUNCATE_LENGTHS, truncateToWidth } from "../ui/render-uti
 import type { ToolSession } from ".";
 
 const saveMemorySchema = Type.Object({
-	fact: Type.String({ description: "A clear, self-contained statement to remember across sessions" }),
+	fact: Type.String({ description: "A clear, self-contained statement to remember across sessions", minLength: 1 }),
 });
 
 type SaveMemoryParams = Static<typeof saveMemorySchema>;
@@ -153,10 +153,13 @@ export class SaveMemoryTool implements AgentTool<typeof saveMemorySchema, SaveMe
 		};
 	}
 
-	renderCall(args: SaveMemoryRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component {
+	renderCall(args: SaveMemoryRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component {
 		const preview = args.fact ? truncateToWidth(args.fact, TRUNCATE_LENGTHS.CONTENT) : "";
 		const meta = preview ? [preview] : [];
-		const text = renderStatusLine({ icon: "pending", title: "Save Memory", meta }, uiTheme);
+		const text = renderStatusLine(
+			{ icon: "running", spinnerFrame: options.spinnerFrame, title: "Save Memory", meta },
+			uiTheme,
+		);
 		return new Text(text, 0, 0);
 	}
 

package/src/tools/ssh.ts

@@ -22,7 +22,7 @@ const sshSchema = Type.Object({
 	host: Type.String({ description: "SSH host alias (from ~/.ssh/config)" }),
 	command: Type.String({ description: "Shell command to execute on the remote host" }),
 	cwd: Type.Optional(Type.String({ description: "Working directory on the remote host" })),
-	timeout: Type.Optional(Type.Number({ description: "Timeout in milliseconds" })),
+	timeout: Type.Optional(Type.Number({ description: "Timeout in seconds" })),
 });
 
 export interface SSHToolDetails {
@@ -187,10 +187,13 @@ export class SshTool implements AgentTool<typeof sshSchema, SSHToolDetails, Them
 		return resultBuilder.done();
 	}
 
-	renderCall(args: SshRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component {
+	renderCall(args: SshRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component {
 		const host = args.host || "…";
 		const command = args.command || "…";
-		const text = renderStatusLine({ icon: "pending", title: "SSH", description: `[${host}] $ ${command}` }, uiTheme);
+		const text = renderStatusLine(
+			{ icon: "running", spinnerFrame: options.spinnerFrame, title: "SSH", description: `[${host}] $ ${command}` },
+			uiTheme,
+		);
 		return new Text(text, 0, 0);
 	}
 

package/src/tools/todo-write.ts

@@ -1,4 +1,4 @@
-import path from "node:path";
+import * as path from "node:path";
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@nghyane/arcane-agent";
 import { StringEnum } from "@nghyane/arcane-ai";
 import type { Component } from "@nghyane/arcane-tui";
@@ -162,10 +162,13 @@ export class TodoWriteTool implements AgentTool<typeof todoWriteSchema, TodoWrit
 		};
 	}
 
-	renderCall(args: TodoWriteRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component {
+	renderCall(args: TodoWriteRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component {
 		const count = args.todos?.length ?? 0;
 		const meta = count > 0 ? [`${count} items`] : ["empty"];
-		const text = renderStatusLine({ icon: "pending", title: "Todo Write", meta }, uiTheme);
+		const text = renderStatusLine(
+			{ icon: "running", spinnerFrame: options.spinnerFrame, title: "Todo Write", meta },
+			uiTheme,
+		);
 		return new Text(text, 0, 0);
 	}
 

package/src/tools/undo-edit.ts

@@ -75,10 +75,13 @@ export class UndoEditTool implements AgentTool<typeof undoEditSchema, UndoEditTo
 		});
 	}
 
-	renderCall(args: UndoEditRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component {
+	renderCall(args: UndoEditRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component {
 		const filePath = shortenPath(args.path ?? "");
 		const pathDisplay = filePath ? uiTheme.fg("accent", filePath) : uiTheme.fg("toolOutput", "…");
-		const text = renderStatusLine({ icon: "pending", title: "Undo", description: pathDisplay }, uiTheme);
+		const text = renderStatusLine(
+			{ icon: "running", spinnerFrame: options.spinnerFrame, title: "Undo", description: pathDisplay },
+			uiTheme,
+		);
 		return new Text(text, 0, 0);
 	}
 

package/src/ui/render-utils.ts

@@ -25,7 +25,7 @@ const TOOL_TIERS: Record<string, ToolTier> = {
 	search_code: "quiet",
 	lsp: "quiet",
 	browser: "quiet",
-	github: "quiet",
+	github: "action",
 	notebook: "quiet",
 	undo_edit: "quiet",
 	generate_image: "quiet",

package/src/utils/file-mentions.ts

@@ -6,7 +6,7 @@
  * so the agent doesn't need to read them manually.
  */
 import * as fs from "node:fs/promises";
-import path from "node:path";
+import * as path from "node:path";
 import type { AgentMessage } from "@nghyane/arcane-agent";
 import { glob } from "@nghyane/arcane-natives";
 import { formatHashLines } from "../patch/hashline";

package/src/web/github-client.ts

@@ -197,7 +197,8 @@ async function request<T = unknown>(endpoint: string, options: RequestOptions =
 					return { data: null as T, ok: false, status: response.status, rateLimit };
 				}
 
-				const data = (await response.json()) as T;
+				const isRaw = response.headers.get("content-type")?.includes("application/json") === false;
+				const data = (isRaw ? await response.text() : await response.json()) as T;
 
 				// Cache with ETag
 				const etag = response.headers.get("etag");

package/src/web/scrapers/youtube.ts

@@ -1,6 +1,6 @@
 import * as fs from "node:fs/promises";
 import * as os from "node:os";
-import path from "node:path";
+import * as path from "node:path";
 import { ptree, Snowflake } from "@nghyane/arcane-utils";
 import { throwIfAborted } from "../../tools/tool-errors";
 import { ensureTool } from "../../utils/tools-manager";

package/src/web/search/render.ts

@@ -102,11 +102,20 @@ export function renderSearchResult(
 /** Render web search call (query preview) */
 export function renderSearchCall(
 	args: { query?: string; provider?: string; [key: string]: unknown },
-	_options: RenderResultOptions,
+	options: RenderResultOptions,
 	theme: Theme,
 ): Component {
 	const provider = args.provider ?? "auto";
 	const query = truncateToWidth(args.query ?? "", 80);
-	const text = renderStatusLine({ icon: "pending", title: "Web Search", description: query, meta: [provider] }, theme);
+	const text = renderStatusLine(
+		{
+			icon: "running",
+			spinnerFrame: options.spinnerFrame,
+			title: "Web Search",
+			description: query,
+			meta: [provider],
+		},
+		theme,
+	);
 	return new Text(text, 0, 0);
 }

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

@@ -1,9 +0,0 @@
-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.