feat: add "Anthropic — via Claude CLI" as a first-class provider

Replaces the stray useClaudeCli settings checkbox + onboarding question
with a proper provider-card UX. The card lives next to OAuth + API-key
cards in onboarding and settings, with Enable/Disable + Test actions.

Backend:
 - Vendors rchern/pi-claude-cli@0.3.1 as packages/pi-claude-cli
   (MIT, attribution in UPSTREAM.md). Lets us bump peer-dep on
   pi-coding-agent in lockstep with Fusion (upstream pinned ^0.52.0
   vs ours ^0.62.0) and fix bugs without waiting on upstream.
 - Adds @fusion/pi-claude-cli as a workspace dep of @runfusion/fusion
   so users don't have to `npm install -g pi-claude-cli` manually.
 - serve/daemon/dashboard conditionally load the extension via
   discoverAndLoadExtensions() when GlobalSettings.useClaudeCli is on;
   no side-effects on user ~/.fusion/agent/settings.json.
 - New GET /api/providers/claude-cli/status: claude --version probe
   + toggle state + cached extension resolution.
 - New POST /api/auth/claude-cli: flips useClaudeCli, refuses if the
   claude binary is missing, fires the existing skill-backfill hook.
 - /api/auth/status now injects a synthetic {id:"claude-cli", type:"cli"}
   provider entry so onboarding + settings see a consistent list.

Frontend:
 - New ClaudeCliProviderCard component shared between ModelOnboardingModal
   and SettingsModal's Authentication section.
 - New AuthProvider.type = "cli" variant.
 - Removed the old "Route AI calls through the Claude CLI" checkbox from
   Global Models settings and the opt-in step from the onboarding wizard.
 - ProviderIcon gets a composite Anthropic-mark-plus-terminal glyph for
   the claude-cli provider id.

Tests:
 - 8 unit tests for extension resolution (@fusion/pi-claude-cli is
   workspace-linked so these run in-tree).
 - 2 unit tests for the binary probe.
 - Existing /auth/status tests filter out the new synthetic entry so
   they keep asserting structural OAuth/API-key behavior in isolation.
 - The vendored package's own 296 tests still pass unchanged.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
gsxdsm
2026-04-23 16:48:57 -07:00
parent 64d829f924
commit 32da0aedac
44 changed files with 9390 additions and 76 deletions

View File

@@ -0,0 +1,148 @@
/**
* Probe for the locally-installed Claude CLI binary.
*
* Used by GET /api/providers/claude-cli/status to power the "Anthropic —
* via Claude CLI" provider card. The card shows `authenticated=true` only
* when the binary is on PATH *and* the user has flipped on `useClaudeCli`.
*
* Intentional design choices:
*
* - No caching. The user's PATH can change between requests (nvm switches,
* fresh terminal, etc.) — we'd rather pay one `spawn()` per poll than
* serve a stale "claude not installed" response. Claude's `--version`
* flag exits in ~40ms, so cost is negligible.
*
* - Short timeout. A misbehaving `claude` shim could hang indefinitely;
* we cap the probe at 2s and report `available: false` with a timeout
* reason rather than blocking the HTTP request.
*
* - No authorization. We never shell-interpolate PATH or user input.
* We spawn `claude --version` directly with argv, no shell.
*/
import { spawn } from "node:child_process";
/** Result shape returned to the dashboard status endpoint. */
export interface ClaudeCliBinaryStatus {
/** True if the `claude` binary was found on PATH and ran to completion. */
available: boolean;
/** Trimmed stdout from `claude --version`, if available. */
version?: string;
/** Absolute path, if we could resolve it via `which`. */
binaryPath?: string;
/** Human-readable failure reason when `available === false`. */
reason?: string;
/** Wall-clock duration of the probe, useful for debugging slow paths. */
probeDurationMs: number;
}
/** Default probe timeout. Claude's --version is fast; 2s is generous. */
const PROBE_TIMEOUT_MS = 2000;
/**
* Spawn `claude --version` and return a structured status result.
*
* Never throws — any failure is captured as `available: false` with a reason
* so the caller (an HTTP handler) can render the provider card without
* try/catch.
*/
export async function probeClaudeCli(
options: { timeoutMs?: number } = {},
): Promise<ClaudeCliBinaryStatus> {
const startedAt = Date.now();
const timeoutMs = options.timeoutMs ?? PROBE_TIMEOUT_MS;
const binaryPath = await tryResolveBinaryPath("claude");
return new Promise<ClaudeCliBinaryStatus>((resolvePromise) => {
const finish = (result: Omit<ClaudeCliBinaryStatus, "probeDurationMs">): void => {
resolvePromise({ ...result, probeDurationMs: Date.now() - startedAt });
};
let settled = false;
const child = spawn("claude", ["--version"], {
stdio: ["ignore", "pipe", "pipe"],
});
const timer = setTimeout(() => {
if (settled) return;
settled = true;
try {
child.kill("SIGKILL");
} catch {
// Process already gone — nothing to do.
}
finish({
available: false,
binaryPath,
reason: `Probe timed out after ${timeoutMs}ms`,
});
}, timeoutMs);
let stdout = "";
let stderr = "";
child.stdout?.on("data", (chunk) => {
stdout += chunk.toString("utf-8");
});
child.stderr?.on("data", (chunk) => {
stderr += chunk.toString("utf-8");
});
child.on("error", (err) => {
if (settled) return;
settled = true;
clearTimeout(timer);
const isNotFound = (err as NodeJS.ErrnoException).code === "ENOENT";
finish({
available: false,
binaryPath,
reason: isNotFound ? "`claude` not found on PATH" : err.message,
});
});
child.on("close", (code) => {
if (settled) return;
settled = true;
clearTimeout(timer);
if (code === 0) {
finish({
available: true,
version: stdout.trim() || undefined,
binaryPath,
});
} else {
finish({
available: false,
binaryPath,
reason:
stderr.trim() || `claude --version exited with code ${String(code)}`,
});
}
});
});
}
/**
* Best-effort `which claude`. We don't fail probe on inability to resolve
* the path — the spawn above is the actual authority. This is just for
* surfacing a friendly "found at /opt/homebrew/bin/claude" in the UI.
*/
async function tryResolveBinaryPath(binary: string): Promise<string | undefined> {
return new Promise((resolvePromise) => {
const which = process.platform === "win32" ? "where" : "which";
const child = spawn(which, [binary], { stdio: ["ignore", "pipe", "ignore"] });
let out = "";
child.stdout?.on("data", (chunk) => {
out += chunk.toString("utf-8");
});
child.on("error", () => resolvePromise(undefined));
child.on("close", (code) => {
if (code === 0) {
const first = out.trim().split(/\r?\n/)[0];
resolvePromise(first?.length ? first : undefined);
} else {
resolvePromise(undefined);
}
});
});
}