feat(FN-2996): add research agent tools with extension wiring, remote setti

This merge brings multiple substantial features: new research extension tools wired through the AI engine (with full test coverage and documentation), legacy routines agentId backward compatibility with migration paths, migration of experimental remote settings to the global scope, Nerd Font glyph a

Fusion-Task-Id: FN-2996

packages/cli/src/__tests__/research-extension-tools.test.ts

@@ -0,0 +1,95 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtemp, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import kbExtension from "../extension.js";
+import { TaskStore } from "@fusion/core";
+
+interface RegisteredTool {
+  name: string;
+  execute: (
+    toolCallId: string,
+    params: any,
+    signal: AbortSignal | undefined,
+    onUpdate: ((update: any) => void) | undefined,
+    ctx: any,
+  ) => Promise<any>;
+}
+
+function createMockAPI() {
+  const tools = new Map<string, RegisteredTool>();
+  return {
+    registerTool(def: RegisteredTool) {
+      tools.set(def.name, def);
+    },
+    registerCommand() {},
+    registerShortcut() {},
+    registerFlag() {},
+    on() {},
+    tools,
+  } as any;
+}
+
+function makeCtx(cwd: string) {
+  return { cwd } as any;
+}
+
+describe("research extension tools", () => {
+  let tmpDir: string;
+  let api: ReturnType<typeof createMockAPI>;
+
+  beforeEach(async () => {
+    tmpDir = await mkdtemp(join(tmpdir(), "kb-ext-research-test-"));
+    api = createMockAPI();
+    kbExtension(api);
+  });
+
+  afterEach(async () => {
+    await rm(tmpDir, { recursive: true, force: true });
+  });
+
+  it("registers research extension tools", () => {
+    expect(api.tools.has("fn_research_run")).toBe(true);
+    expect(api.tools.has("fn_research_list")).toBe(true);
+    expect(api.tools.has("fn_research_get")).toBe(true);
+    expect(api.tools.has("fn_research_cancel")).toBe(true);
+  });
+
+  it("returns actionable disabled response when research is off", async () => {
+    const store = new TaskStore(tmpDir);
+    await store.init();
+    await store.updateSettings({ researchSettings: { enabled: false } });
+
+    const runTool = api.tools.get("fn_research_run")!;
+    const result = await runTool.execute("call-1", { query: "fusion" }, undefined, undefined, makeCtx(tmpDir));
+
+    expect(result.details.setup.code).toBe("feature-disabled");
+    expect(result.content[0].text).toContain("disabled");
+  });
+
+  it("creates, reads, lists, and cancels runs", async () => {
+    const store = new TaskStore(tmpDir);
+    await store.init();
+    await store.updateSettings({
+      researchWebSearchProvider: "tavily",
+      researchTavilyApiKey: "test-key",
+      researchSettings: { enabled: true, searchProvider: "tavily" },
+    });
+
+    const runTool = api.tools.get("fn_research_run")!;
+    const runResult = await runTool.execute("call-1", { query: "fusion architecture" }, undefined, undefined, makeCtx(tmpDir));
+    expect(runResult.details.runId).toBeTruthy();
+
+    const listTool = api.tools.get("fn_research_list")!;
+    const listResult = await listTool.execute("call-2", {}, undefined, undefined, makeCtx(tmpDir));
+    expect(listResult.details.runs.length).toBeGreaterThan(0);
+
+    const getTool = api.tools.get("fn_research_get")!;
+    const getResult = await getTool.execute("call-3", { id: runResult.details.runId }, undefined, undefined, makeCtx(tmpDir));
+    expect(getResult.details.runId).toBe(runResult.details.runId);
+
+    const cancelTool = api.tools.get("fn_research_cancel")!;
+    const cancelResult = await cancelTool.execute("call-4", { id: runResult.details.runId }, undefined, undefined, makeCtx(tmpDir));
+    expect(cancelResult.details.status).toBe("cancelled");
+  });
+});