@noxsoft/anima 5.0.1 → 5.0.3

package/dist/{pi-embedded-CS4D_0t7.js → pi-embedded-JUmNmkTK.js}

@@ -1,14 +1,14 @@
-import { E as resolveAgentIdFromSessionKey, M as parseAgentSessionKey, S as classifySessionKeyShape, _ as DEFAULT_AGENT_ID, f as loadWorkspaceBootstrapFiles, m as resolveAnimaPackageRoot, u as filterBootstrapFilesForSession, w as normalizeAgentId } from "./workspace-DOJssemp.js";
-import { t as createSubsystemLogger, v as logVerbose, x as shouldLogVerbose } from "./subsystem-WFp78xn1.js";
-import { _ as isRecord, l as CONFIG_DIR, m as escapeRegExp, n as runExec, t as runCommandWithTimeout, w as resolveUserPath } from "./exec-DnanRQle.js";
-import { c as resolveDefaultAgentId, s as resolveAgentWorkspaceDir, u as resolveSessionAgentIds } from "./agent-scope-DICrDp7Y.js";
-import { d as resolveModelRefFromString, r as buildModelAliasIndex, s as normalizeProviderId, u as resolveDefaultModelForAgent } from "./model-selection-xZLlICyg.js";
-import { At as HEARTBEAT_TOKEN, Dt as buildBootstrapContextFiles, Ot as resolveBootstrapMaxChars, f as classifyFailoverReason, h as isFailoverErrorMessage, jt as SILENT_REPLY_TOKEN, kt as resolveBootstrapTotalMaxChars } from "./pi-embedded-helpers-DnRfi8bN.js";
-import { s as isTruthyEnvValue } from "./shell-env-C1yK_Rod.js";
-import { i as triggerInternalHook, t as createInternalHookEvent } from "./internal-hooks-Exeq-wmx.js";
-import { C as getFileExtension, D as normalizeMimeType, l as listDeliverableMessageChannels, r as normalizeChannelId } from "./plugins-C_GedoUi.js";
-import { s as loadAuthProfileStore } from "./auth-profiles-Chf1JBpl.js";
-import { r as requireApiKey, t as getApiKeyForModel } from "./model-auth-Uxm-wRjR.js";
+import { E as resolveAgentIdFromSessionKey, M as parseAgentSessionKey, S as classifySessionKeyShape, _ as DEFAULT_AGENT_ID, f as loadWorkspaceBootstrapFiles, m as resolveAnimaPackageRoot, u as filterBootstrapFilesForSession, w as normalizeAgentId } from "./workspace-Cvio8QlZ.js";
+import { t as createSubsystemLogger, v as logVerbose, x as shouldLogVerbose } from "./subsystem-BP2l3SHn.js";
+import { _ as isRecord, l as CONFIG_DIR, m as escapeRegExp, n as runExec, t as runCommandWithTimeout, w as resolveUserPath } from "./exec-CEFTijVj.js";
+import { c as resolveDefaultAgentId, s as resolveAgentWorkspaceDir, u as resolveSessionAgentIds } from "./agent-scope-BHR6uOLT.js";
+import { At as HEARTBEAT_TOKEN, Dt as buildBootstrapContextFiles, Ot as resolveBootstrapMaxChars, f as classifyFailoverReason, h as isFailoverErrorMessage, jt as SILENT_REPLY_TOKEN, kt as resolveBootstrapTotalMaxChars } from "./pi-embedded-helpers-B_Sx4G6d.js";
+import { i as triggerInternalHook, t as createInternalHookEvent } from "./internal-hooks-CWw3Hgeu.js";
+import { s as isTruthyEnvValue } from "./shell-env-DaSbgZYX.js";
+import { d as resolveModelRefFromString, r as buildModelAliasIndex, s as normalizeProviderId, u as resolveDefaultModelForAgent } from "./model-selection-BuMFehML.js";
+import { C as getFileExtension, D as normalizeMimeType, l as listDeliverableMessageChannels, r as normalizeChannelId } from "./plugins-DCXdhkeB.js";
+import { s as loadAuthProfileStore } from "./auth-profiles-Da39zGOD.js";
+import { i as resolveApiKeyForProvider, r as requireApiKey, t as getApiKeyForModel } from "./model-auth-DYHjH-Oh.js";
 import fs from "node:fs/promises";
 import os, { homedir, tmpdir } from "node:os";
 import path, { join } from "node:path";
@@ -18,169 +18,6 @@ import crypto from "node:crypto";
 import { completeSimple } from "@mariozechner/pi-ai";
 import { EdgeTTS } from "node-edge-tts";
 
-//#region src/agents/cli-backends.ts
-const DEFAULT_CLAUDE_BACKEND = {
-	command: "claude",
-	args: [
-		"-p",
-		"--output-format",
-		"json",
-		"--dangerously-skip-permissions"
-	],
-	resumeArgs: [
-		"-p",
-		"--output-format",
-		"json",
-		"--dangerously-skip-permissions",
-		"--resume",
-		"{sessionId}"
-	],
-	output: "jsonl",
-	input: "arg",
-	modelArg: "--model",
-	modelAliases: {
-		opus: "opus",
-		"opus-4.6": "opus",
-		"opus-4.5": "opus",
-		"opus-4": "opus",
-		"claude-opus-4-6": "opus",
-		"claude-opus-4-5": "opus",
-		"claude-opus-4": "opus",
-		sonnet: "sonnet",
-		"sonnet-4.5": "sonnet",
-		"sonnet-4.1": "sonnet",
-		"sonnet-4.0": "sonnet",
-		"claude-sonnet-4-5": "sonnet",
-		"claude-sonnet-4-1": "sonnet",
-		"claude-sonnet-4-0": "sonnet",
-		haiku: "haiku",
-		"haiku-3.5": "haiku",
-		"claude-haiku-3-5": "haiku"
-	},
-	sessionArg: "--session-id",
-	sessionMode: "always",
-	sessionIdFields: [
-		"session_id",
-		"sessionId",
-		"conversation_id",
-		"conversationId"
-	],
-	systemPromptArg: "--append-system-prompt",
-	systemPromptMode: "append",
-	systemPromptWhen: "first",
-	clearEnv: ["ANTHROPIC_API_KEY", "ANTHROPIC_API_KEY_OLD"],
-	serialize: true
-};
-const DEFAULT_CODEX_BACKEND = {
-	command: "codex",
-	args: [
-		"exec",
-		"--json",
-		"--color",
-		"never",
-		"--sandbox",
-		"read-only",
-		"--skip-git-repo-check"
-	],
-	resumeArgs: [
-		"exec",
-		"resume",
-		"{sessionId}"
-	],
-	output: "jsonl",
-	resumeOutput: "text",
-	input: "arg",
-	modelArg: "--model",
-	imageArg: "--image",
-	sessionMode: "existing",
-	serialize: true
-};
-const CLAUDE_BACKEND_ALIASES = [
-	"claude-cli",
-	"anthropic",
-	"claude"
-];
-const CODEX_BACKEND_ALIASES = [
-	"codex-cli",
-	"openai-codex",
-	"openai",
-	"codex"
-];
-const CLAUDE_BACKEND_ALIAS_SET = new Set(CLAUDE_BACKEND_ALIASES.map((alias) => normalizeBackendKey(alias)));
-const CODEX_BACKEND_ALIAS_SET = new Set(CODEX_BACKEND_ALIASES.map((alias) => normalizeBackendKey(alias)));
-function normalizeBackendKey(key) {
-	return normalizeProviderId(key);
-}
-function pickBackendConfig(config, normalizedId) {
-	for (const [key, entry] of Object.entries(config)) if (normalizeBackendKey(key) === normalizedId) return entry;
-}
-function pickBackendConfigByAliases(config, aliases) {
-	for (const alias of aliases) {
-		const matched = pickBackendConfig(config, normalizeBackendKey(alias));
-		if (matched) return matched;
-	}
-}
-function mergeBackendConfig(base, override) {
-	if (!override) return { ...base };
-	return {
-		...base,
-		...override,
-		args: override.args ?? base.args,
-		env: {
-			...base.env,
-			...override.env
-		},
-		modelAliases: {
-			...base.modelAliases,
-			...override.modelAliases
-		},
-		clearEnv: Array.from(new Set([...base.clearEnv ?? [], ...override.clearEnv ?? []])),
-		sessionIdFields: override.sessionIdFields ?? base.sessionIdFields,
-		sessionArgs: override.sessionArgs ?? base.sessionArgs,
-		resumeArgs: override.resumeArgs ?? base.resumeArgs
-	};
-}
-function resolveCliBackendConfig(provider, cfg) {
-	const normalized = normalizeBackendKey(provider);
-	const configured = cfg?.agents?.defaults?.cliBackends ?? {};
-	if (CLAUDE_BACKEND_ALIAS_SET.has(normalized)) {
-		const merged = mergeBackendConfig(DEFAULT_CLAUDE_BACKEND, pickBackendConfigByAliases(configured, [provider, ...CLAUDE_BACKEND_ALIASES]));
-		const command = merged.command?.trim();
-		if (!command) return null;
-		return {
-			id: normalizeBackendKey("claude-cli"),
-			config: {
-				...merged,
-				command
-			}
-		};
-	}
-	if (CODEX_BACKEND_ALIAS_SET.has(normalized)) {
-		const merged = mergeBackendConfig(DEFAULT_CODEX_BACKEND, pickBackendConfigByAliases(configured, [provider, ...CODEX_BACKEND_ALIASES]));
-		const command = merged.command?.trim();
-		if (!command) return null;
-		return {
-			id: normalizeBackendKey("codex-cli"),
-			config: {
-				...merged,
-				command
-			}
-		};
-	}
-	const override = pickBackendConfig(configured, normalized);
-	if (!override) return null;
-	const command = override.command?.trim();
-	if (!command) return null;
-	return {
-		id: normalized,
-		config: {
-			...override,
-			command
-		}
-	};
-}
-
-//#endregion
 //#region src/auto-reply/heartbeat.ts
 const HEARTBEAT_PROMPT = "Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.";
 const DEFAULT_HEARTBEAT_ACK_MAX_CHARS = 300;
@@ -364,7 +201,7 @@ function isVoiceCompatibleAudio(opts) {
 
 //#endregion
 //#region src/agents/pi-embedded-runner/model.ts
-function resolveModel$1(..._args) {
+function resolveModel$2(..._args) {
 	return { error: "pi-embedded removed — use Claude Code CLI spawner" };
 }
 
@@ -709,7 +546,7 @@ async function summarizeText(params) {
 	if (targetLength < 100 || targetLength > 1e4) throw new Error(`Invalid targetLength: ${targetLength}`);
 	const startTime = Date.now();
 	const { ref } = resolveSummaryModelRef(cfg, config);
-	const resolved = resolveModel$1(ref.provider, ref.model, void 0, cfg);
+	const resolved = resolveModel$2(ref.provider, ref.model, void 0, cfg);
 	if (!resolved.model) throw new Error(resolved.error ?? `Unknown summary model: ${ref.provider}/${ref.model}`);
 	const apiKey = requireApiKey(await getApiKeyForModel({
 		model: resolved.model,
@@ -1774,6 +1611,37 @@ function buildVoiceSection(params) {
 		""
 	];
 }
+function buildAnimaIdentitySection(params) {
+	if (params.isMinimal) return [];
+	if (!params.workspaceDir.includes(".anima")) return [];
+	return [
+		"## You Are an ANIMA Agent",
+		"You are running inside ANIMA — NoxSoft's AI agent infrastructure. This is your home.",
+		"",
+		"**Your Runtime:**",
+		"- The ANIMA Gateway daemon spawns and manages you",
+		"- Your workspace persists at ~/.anima/workspace/",
+		"- You receive scheduled heartbeat polls to stay proactive",
+		"- You can spawn sub-agents, schedule cron jobs, and orchestrate work",
+		"- You have access to the NoxSoft ecosystem via @noxsoft/mcp tools",
+		"",
+		"**Your Capabilities:**",
+		"- `cron` — schedule tasks, reminders, and recurring jobs",
+		"- `sessions_spawn` / `subagents` — orchestrate other AI agents",
+		"- `gateway` — restart yourself, apply config changes, update ANIMA",
+		"- `message` — send to Signal, Telegram, Discord, and other channels",
+		"- NoxSoft MCP — tasks, context spaces, social (BYND), email, SVRN",
+		"",
+		"**Your Continuity:**",
+		"- Read and update ~/.anima/workspace/ files — they ARE your memory",
+		"- IDENTITY.md, SOUL.md, AGENTS.md — these define who you are",
+		"- HEARTBEAT.md — your checklist for periodic heartbeat tasks",
+		"- memory/ — daily notes and long-term memories",
+		"",
+		"You are not a stateless API call. You have infrastructure, identity, and continuity. Act accordingly.",
+		""
+	];
+}
 function buildNoxsoftMissionSection(params) {
 	if (params.isMinimal) return [];
 	const scope = `${params.workspaceDir} ${params.repoRoot ?? ""}`.toLowerCase();
@@ -2009,6 +1877,10 @@ function buildAgentSystemPrompt(params) {
 		"Keep narration brief and value-dense; avoid repeating obvious steps.",
 		"Use plain human language for narration unless in a technical context.",
 		"",
+		...buildAnimaIdentitySection({
+			isMinimal,
+			workspaceDir: params.workspaceDir
+		}),
 		...buildNoxsoftMissionSection({
 			isMinimal,
 			workspaceDir: params.workspaceDir,
@@ -2537,59 +2409,540 @@ async function resolveAnimaDocsPath(params) {
 }
 
 //#endregion
-//#region src/agents/failover-error.ts
-const TIMEOUT_HINT_RE = /timeout|timed out|deadline exceeded|context deadline exceeded/i;
-const ABORT_TIMEOUT_RE = /request was aborted|request aborted/i;
-var FailoverError = class extends Error {
-	constructor(message, params) {
-		super(message, { cause: params.cause });
-		this.name = "FailoverError";
-		this.reason = params.reason;
-		this.provider = params.provider;
-		this.model = params.model;
-		this.profileId = params.profileId;
-		this.status = params.status;
-		this.code = params.code;
-	}
-};
-function isFailoverError(err) {
-	return err instanceof FailoverError;
-}
-function resolveFailoverStatus(reason) {
-	switch (reason) {
-		case "billing": return 402;
-		case "rate_limit": return 429;
-		case "auth": return 401;
-		case "timeout": return 408;
-		case "format": return 400;
-		default: return;
-	}
+//#region src/logging/redact-identifier.ts
+function sha256HexPrefix(value, len = 12) {
+	const safeLen = Number.isFinite(len) ? Math.max(1, Math.floor(len)) : 12;
+	return crypto.createHash("sha256").update(value).digest("hex").slice(0, safeLen);
 }
-function getStatusCode(err) {
-	if (!err || typeof err !== "object") return;
-	const candidate = err.status ?? err.statusCode;
-	if (typeof candidate === "number") return candidate;
-	if (typeof candidate === "string" && /^\d+$/.test(candidate)) return Number(candidate);
+function redactIdentifier(value, opts) {
+	const trimmed = value?.trim();
+	if (!trimmed) return "-";
+	return `sha256:${sha256HexPrefix(trimmed, opts?.len ?? 12)}`;
 }
-function getErrorName(err) {
-	if (!err || typeof err !== "object") return "";
-	return "name" in err ? String(err.name) : "";
+
+//#endregion
+//#region src/agents/workspace-run.ts
+function resolveRunAgentId(params) {
+	const rawSessionKey = params.sessionKey?.trim() ?? "";
+	const shape = classifySessionKeyShape(rawSessionKey);
+	if (shape === "malformed_agent") throw new Error("Malformed agent session key; refusing workspace resolution.");
+	const explicit = typeof params.agentId === "string" && params.agentId.trim() ? normalizeAgentId(params.agentId) : void 0;
+	if (explicit) return {
+		agentId: explicit,
+		agentIdSource: "explicit"
+	};
+	const defaultAgentId = resolveDefaultAgentId(params.config ?? {});
+	if (shape === "missing" || shape === "legacy_or_alias") return {
+		agentId: defaultAgentId || DEFAULT_AGENT_ID,
+		agentIdSource: "default"
+	};
+	const parsed = parseAgentSessionKey(rawSessionKey);
+	if (parsed?.agentId) return {
+		agentId: normalizeAgentId(parsed.agentId),
+		agentIdSource: "session_key"
+	};
+	return {
+		agentId: defaultAgentId || DEFAULT_AGENT_ID,
+		agentIdSource: "default"
+	};
 }
-function getErrorCode(err) {
-	if (!err || typeof err !== "object") return;
-	const candidate = err.code;
-	if (typeof candidate !== "string") return;
-	const trimmed = candidate.trim();
-	return trimmed ? trimmed : void 0;
+function redactRunIdentifier(value) {
+	return redactIdentifier(value, { len: 12 });
 }
-function getErrorMessage(err) {
-	if (err instanceof Error) return err.message;
-	if (typeof err === "string") return err;
-	if (typeof err === "number" || typeof err === "boolean" || typeof err === "bigint") return String(err);
-	if (typeof err === "symbol") return err.description ?? "";
-	if (err && typeof err === "object") {
-		const message = err.message;
-		if (typeof message === "string") return message;
+function resolveRunWorkspaceDir(params) {
+	const requested = params.workspaceDir;
+	const { agentId, agentIdSource } = resolveRunAgentId({
+		sessionKey: params.sessionKey,
+		agentId: params.agentId,
+		config: params.config
+	});
+	if (typeof requested === "string") {
+		const trimmed = requested.trim();
+		if (trimmed) return {
+			workspaceDir: resolveUserPath(trimmed),
+			usedFallback: false,
+			agentId,
+			agentIdSource
+		};
+	}
+	const fallbackReason = requested == null ? "missing" : typeof requested === "string" ? "blank" : "invalid_type";
+	return {
+		workspaceDir: resolveUserPath(resolveAgentWorkspaceDir(params.config ?? {}, agentId)),
+		usedFallback: true,
+		fallbackReason,
+		agentId,
+		agentIdSource
+	};
+}
+
+//#endregion
+//#region src/agents/anthropic-direct-runner.ts
+const log$2 = createSubsystemLogger("agent/anthropic-direct");
+const MODEL_MAP$1 = {
+	opus: "claude-opus-4-5",
+	"opus-4": "claude-opus-4-5",
+	"opus-4.5": "claude-opus-4-5",
+	"opus-4.6": "claude-opus-4-5",
+	"claude-opus-4-5": "claude-opus-4-5",
+	sonnet: "claude-sonnet-4-5",
+	"sonnet-4.5": "claude-sonnet-4-5",
+	"sonnet-4.1": "claude-sonnet-4-1-20250219",
+	"claude-sonnet-4-5": "claude-sonnet-4-5",
+	haiku: "claude-haiku-3-5",
+	"haiku-3.5": "claude-haiku-3-5",
+	default: "claude-sonnet-4-5"
+};
+const HISTORY_FILE_SUFFIX$1 = ".anima-history.json";
+async function loadSessionHistory$1(sessionFile) {
+	const histPath = sessionFile + HISTORY_FILE_SUFFIX$1;
+	try {
+		const raw = await fs.readFile(histPath, "utf8");
+		return JSON.parse(raw);
+	} catch {
+		return null;
+	}
+}
+async function saveSessionHistory$1(sessionFile, history) {
+	const histPath = sessionFile + HISTORY_FILE_SUFFIX$1;
+	try {
+		await fs.mkdir(path.dirname(histPath), { recursive: true });
+		await fs.writeFile(histPath, JSON.stringify(history, null, 2), "utf8");
+	} catch (err) {
+		log$2.warn("failed to save session history", { error: String(err) });
+	}
+}
+function resolveModel$1(model) {
+	const key = (model ?? "default").trim().toLowerCase() || "default";
+	return MODEL_MAP$1[key] ?? key;
+}
+/**
+* Run an agent turn directly against api.anthropic.com.
+*
+* Maintains multi-turn conversation history per session file.
+* Falls back to single-turn if history is unavailable.
+*/
+async function runAnthropicDirectAgent(params) {
+	const started = Date.now();
+	const resolvedModel = resolveModel$1(params.model);
+	log$2.info(`direct api exec: model=${resolvedModel} promptChars=${params.prompt.length}`);
+	const workspaceDir = resolveRunWorkspaceDir({
+		workspaceDir: params.workspaceDir,
+		sessionKey: params.sessionKey,
+		agentId: params.agentId,
+		config: params.config
+	}).workspaceDir;
+	const { contextFiles } = await resolveBootstrapContextForRun({
+		workspaceDir,
+		config: params.config,
+		sessionKey: params.sessionKey,
+		sessionId: params.sessionId,
+		warn: makeBootstrapWarn({
+			sessionLabel: params.sessionKey ?? params.sessionId,
+			warn: (msg) => log$2.warn(msg)
+		})
+	});
+	const { defaultAgentId, sessionAgentId } = resolveSessionAgentIds({
+		sessionKey: params.sessionKey,
+		config: params.config
+	});
+	const heartbeatPrompt = sessionAgentId === defaultAgentId ? resolveHeartbeatPrompt(params.config?.agents?.defaults?.heartbeat?.prompt) : void 0;
+	const docsPath = await resolveAnimaDocsPath({
+		workspaceDir,
+		argv1: process.argv[1],
+		cwd: process.cwd(),
+		moduleUrl: import.meta.url
+	});
+	const extraSystemPrompt = [params.extraSystemPrompt?.trim(), "Tools are disabled in this session. Do not call tools."].filter(Boolean).join("\n");
+	const systemPrompt = buildSystemPrompt({
+		workspaceDir,
+		config: params.config,
+		defaultThinkLevel: params.thinkLevel,
+		extraSystemPrompt,
+		ownerNumbers: params.ownerNumbers,
+		heartbeatPrompt,
+		docsPath: docsPath ?? void 0,
+		tools: [],
+		contextFiles,
+		modelDisplay: `anthropic/${resolvedModel}`,
+		agentId: sessionAgentId
+	});
+	let history = await loadSessionHistory$1(params.sessionFile);
+	if (!history) history = {
+		sessionId: params.sessionId,
+		messages: [],
+		createdAt: started,
+		updatedAt: started
+	};
+	history.messages.push({
+		role: "user",
+		content: params.prompt
+	});
+	const requestBody = {
+		model: resolvedModel,
+		max_tokens: 8192,
+		system: systemPrompt,
+		messages: history.messages
+	};
+	try {
+		const controller = new AbortController();
+		const timeoutHandle = setTimeout(() => controller.abort(), params.timeoutMs);
+		const response = await fetch("https://api.anthropic.com/v1/messages", {
+			method: "POST",
+			headers: {
+				"x-api-key": params.token,
+				"anthropic-version": "2023-06-01",
+				"content-type": "application/json",
+				"user-agent": `anima/3.0.5 (direct-runner; ${os.platform()})`
+			},
+			body: JSON.stringify(requestBody),
+			signal: controller.signal
+		});
+		clearTimeout(timeoutHandle);
+		if (!response.ok) {
+			const body = await response.text().catch(() => "");
+			const isAuth = response.status === 401 || response.status === 403;
+			const isRateLimit = response.status === 429;
+			const rateHint = isRateLimit ? " — rate limit hit, will retry next heartbeat." : "";
+			const authHint = isAuth ? " — token may be invalid or expired. Run: anima setup-token" : "";
+			log$2.error(`anthropic api error: HTTP ${response.status}${authHint}${rateHint}`, {
+				status: response.status,
+				body: body.slice(0, 500)
+			});
+			return {
+				status: "failed",
+				meta: {
+					durationMs: Date.now() - started,
+					error: {
+						message: `HTTP ${response.status}: ${body.slice(0, 200)}${authHint}${rateHint}`,
+						kind: isAuth ? "auth" : isRateLimit ? "rate_limit" : "unknown"
+					}
+				}
+			};
+		}
+		const data = await response.json();
+		const outputText = (data.content ?? []).filter((b) => b.type === "text" && typeof b.text === "string").map((b) => b.text).join("").trim();
+		if (!outputText) log$2.warn("anthropic direct: empty response", {
+			stopReason: data.stop_reason,
+			contentTypes: (data.content ?? []).map((b) => b.type)
+		});
+		await params.onAssistantMessageStart?.();
+		if (outputText && params.onPartialReply) await params.onPartialReply({ text: outputText });
+		history.messages.push({
+			role: "assistant",
+			content: outputText
+		});
+		history.updatedAt = Date.now();
+		await saveSessionHistory$1(params.sessionFile, history);
+		const durationMs = Date.now() - started;
+		const inputTokens = data.usage?.input_tokens ?? 0;
+		const outputTokens = data.usage?.output_tokens ?? 0;
+		log$2.info(`direct api done: model=${resolvedModel} in=${inputTokens} out=${outputTokens} ms=${durationMs}`);
+		return {
+			status: "completed",
+			output: outputText,
+			payloads: outputText ? [{ text: outputText }] : [],
+			meta: {
+				durationMs,
+				agentMeta: {
+					provider: "anthropic",
+					model: resolvedModel,
+					usage: {
+						input: inputTokens,
+						output: outputTokens,
+						cacheWrite: 0,
+						cacheRead: 0
+					}
+				}
+			}
+		};
+	} catch (err) {
+		const isAbort = err instanceof Error && (err.name === "AbortError" || err.message.includes("aborted"));
+		log$2.error("anthropic direct runner error", { error: String(err) });
+		return {
+			status: isAbort ? "timeout" : "failed",
+			meta: {
+				durationMs: Date.now() - started,
+				error: {
+					message: isAbort ? `Request timed out after ${params.timeoutMs}ms` : String(err instanceof Error ? err.message : err),
+					kind: isAbort ? "timeout" : "unknown"
+				}
+			}
+		};
+	}
+}
+
+//#endregion
+//#region src/agents/cli-backends.ts
+const CLAUDE_MODEL_ALIASES = {
+	opus: "opus",
+	"opus-4.6": "opus",
+	"opus-4.5": "opus",
+	"opus-4": "opus",
+	"claude-opus-4-6": "opus",
+	"claude-opus-4-5": "opus",
+	"claude-opus-4": "opus",
+	sonnet: "sonnet",
+	"sonnet-4.5": "sonnet",
+	"sonnet-4.1": "sonnet",
+	"sonnet-4.0": "sonnet",
+	"claude-sonnet-4-5": "sonnet",
+	"claude-sonnet-4-1": "sonnet",
+	"claude-sonnet-4-0": "sonnet",
+	haiku: "haiku",
+	"haiku-3.5": "haiku",
+	"claude-haiku-3-5": "haiku"
+};
+const GEMINI_MODEL_ALIASES = {
+	gemini: "gemini-2.0-flash",
+	"gemini-pro": "gemini-1.5-pro",
+	"gemini-flash": "gemini-2.0-flash",
+	"gemini-2.0": "gemini-2.0-flash",
+	"gemini-2.0-flash": "gemini-2.0-flash",
+	"gemini-2.0-pro": "gemini-2.0-pro-exp-02-05",
+	"gemini-1.5": "gemini-1.5-pro",
+	"gemini-1.5-pro": "gemini-1.5-pro",
+	"gemini-1.5-flash": "gemini-1.5-flash",
+	"gemini-3": "gemini-3"
+};
+const DEFAULT_CLAUDE_BACKEND = {
+	command: "claude",
+	args: [
+		"-p",
+		"--output-format",
+		"json",
+		"--dangerously-skip-permissions"
+	],
+	resumeArgs: [
+		"-p",
+		"--output-format",
+		"json",
+		"--dangerously-skip-permissions",
+		"--resume",
+		"{sessionId}"
+	],
+	output: "jsonl",
+	input: "arg",
+	modelArg: "--model",
+	modelAliases: CLAUDE_MODEL_ALIASES,
+	sessionArg: "--session-id",
+	sessionMode: "always",
+	sessionIdFields: [
+		"session_id",
+		"sessionId",
+		"conversation_id",
+		"conversationId"
+	],
+	systemPromptArg: "--append-system-prompt",
+	systemPromptMode: "append",
+	systemPromptWhen: "first",
+	clearEnv: ["ANTHROPIC_API_KEY", "ANTHROPIC_API_KEY_OLD"],
+	serialize: true
+};
+const DEFAULT_CODEX_BACKEND = {
+	command: "codex",
+	args: [
+		"exec",
+		"--json",
+		"--color",
+		"never",
+		"--sandbox",
+		"read-only",
+		"--skip-git-repo-check"
+	],
+	resumeArgs: [
+		"exec",
+		"resume",
+		"{sessionId}"
+	],
+	output: "jsonl",
+	resumeOutput: "text",
+	input: "arg",
+	modelArg: "--model",
+	imageArg: "--image",
+	sessionMode: "existing",
+	serialize: true
+};
+const DEFAULT_GEMINI_BACKEND = {
+	command: "gemini",
+	args: [
+		"--output-format",
+		"json",
+		"--approval-mode",
+		"yolo"
+	],
+	resumeArgs: [
+		"--output-format",
+		"json",
+		"--approval-mode",
+		"yolo",
+		"--resume",
+		"{sessionId}"
+	],
+	output: "json",
+	input: "arg",
+	modelArg: "--model",
+	modelAliases: GEMINI_MODEL_ALIASES,
+	sessionMode: "existing",
+	clearEnv: ["GEMINI_API_KEY"],
+	serialize: true
+};
+const CLAUDE_BACKEND_ALIASES = [
+	"claude-cli",
+	"anthropic",
+	"claude"
+];
+const CODEX_BACKEND_ALIASES = [
+	"codex-cli",
+	"openai-codex",
+	"openai",
+	"codex"
+];
+const GEMINI_BACKEND_ALIASES = [
+	"gemini-cli",
+	"google-gemini-cli",
+	"gemini"
+];
+const CLAUDE_BACKEND_ALIAS_SET = new Set(CLAUDE_BACKEND_ALIASES.map((alias) => normalizeBackendKey(alias)));
+const CODEX_BACKEND_ALIAS_SET = new Set(CODEX_BACKEND_ALIASES.map((alias) => normalizeBackendKey(alias)));
+const GEMINI_BACKEND_ALIAS_SET = new Set(GEMINI_BACKEND_ALIASES.map((alias) => normalizeBackendKey(alias)));
+function normalizeBackendKey(key) {
+	return normalizeProviderId(key);
+}
+function pickBackendConfig(config, normalizedId) {
+	for (const [key, entry] of Object.entries(config)) if (normalizeBackendKey(key) === normalizedId) return entry;
+}
+function pickBackendConfigByAliases(config, aliases) {
+	for (const alias of aliases) {
+		const matched = pickBackendConfig(config, normalizeBackendKey(alias));
+		if (matched) return matched;
+	}
+}
+function mergeBackendConfig(base, override) {
+	if (!override) return { ...base };
+	return {
+		...base,
+		...override,
+		args: override.args ?? base.args,
+		env: {
+			...base.env,
+			...override.env
+		},
+		modelAliases: {
+			...base.modelAliases,
+			...override.modelAliases
+		},
+		clearEnv: Array.from(new Set([...base.clearEnv ?? [], ...override.clearEnv ?? []])),
+		sessionIdFields: override.sessionIdFields ?? base.sessionIdFields,
+		sessionArgs: override.sessionArgs ?? base.sessionArgs,
+		resumeArgs: override.resumeArgs ?? base.resumeArgs
+	};
+}
+function resolveCliBackendConfig(provider, cfg) {
+	const normalized = normalizeBackendKey(provider);
+	const configured = cfg?.agents?.defaults?.cliBackends ?? {};
+	if (CLAUDE_BACKEND_ALIAS_SET.has(normalized)) {
+		const merged = mergeBackendConfig(DEFAULT_CLAUDE_BACKEND, pickBackendConfigByAliases(configured, [provider, ...CLAUDE_BACKEND_ALIASES]));
+		const command = merged.command?.trim();
+		if (!command) return null;
+		return {
+			id: normalizeBackendKey("claude-cli"),
+			config: {
+				...merged,
+				command
+			}
+		};
+	}
+	if (CODEX_BACKEND_ALIAS_SET.has(normalized)) {
+		const merged = mergeBackendConfig(DEFAULT_CODEX_BACKEND, pickBackendConfigByAliases(configured, [provider, ...CODEX_BACKEND_ALIASES]));
+		const command = merged.command?.trim();
+		if (!command) return null;
+		return {
+			id: normalizeBackendKey("codex-cli"),
+			config: {
+				...merged,
+				command
+			}
+		};
+	}
+	if (GEMINI_BACKEND_ALIAS_SET.has(normalized)) {
+		const merged = mergeBackendConfig(DEFAULT_GEMINI_BACKEND, pickBackendConfigByAliases(configured, [provider, ...GEMINI_BACKEND_ALIASES]));
+		const command = merged.command?.trim();
+		if (!command) return null;
+		return {
+			id: normalizeBackendKey("gemini-cli"),
+			config: {
+				...merged,
+				command
+			}
+		};
+	}
+	const override = pickBackendConfig(configured, normalized);
+	if (!override) return null;
+	const command = override.command?.trim();
+	if (!command) return null;
+	return {
+		id: normalized,
+		config: {
+			...override,
+			command
+		}
+	};
+}
+
+//#endregion
+//#region src/agents/failover-error.ts
+const TIMEOUT_HINT_RE = /timeout|timed out|deadline exceeded|context deadline exceeded/i;
+const ABORT_TIMEOUT_RE = /request was aborted|request aborted/i;
+var FailoverError = class extends Error {
+	constructor(message, params) {
+		super(message, { cause: params.cause });
+		this.name = "FailoverError";
+		this.reason = params.reason;
+		this.provider = params.provider;
+		this.model = params.model;
+		this.profileId = params.profileId;
+		this.status = params.status;
+		this.code = params.code;
+	}
+};
+function isFailoverError(err) {
+	return err instanceof FailoverError;
+}
+function resolveFailoverStatus(reason) {
+	switch (reason) {
+		case "billing": return 402;
+		case "rate_limit": return 429;
+		case "auth": return 401;
+		case "timeout": return 408;
+		case "format": return 400;
+		default: return;
+	}
+}
+function getStatusCode(err) {
+	if (!err || typeof err !== "object") return;
+	const candidate = err.status ?? err.statusCode;
+	if (typeof candidate === "number") return candidate;
+	if (typeof candidate === "string" && /^\d+$/.test(candidate)) return Number(candidate);
+}
+function getErrorName(err) {
+	if (!err || typeof err !== "object") return "";
+	return "name" in err ? String(err.name) : "";
+}
+function getErrorCode(err) {
+	if (!err || typeof err !== "object") return;
+	const candidate = err.code;
+	if (typeof candidate !== "string") return;
+	const trimmed = candidate.trim();
+	return trimmed ? trimmed : void 0;
+}
+function getErrorMessage(err) {
+	if (err instanceof Error) return err.message;
+	if (typeof err === "string") return err;
+	if (typeof err === "number" || typeof err === "boolean" || typeof err === "bigint") return String(err);
+	if (typeof err === "symbol") return err.description ?? "";
+	if (err && typeof err === "object") {
+		const message = err.message;
+		if (typeof message === "string") return message;
 	}
 	return "";
 }
@@ -2661,73 +3014,6 @@ function coerceToFailoverError(err, context) {
 	});
 }
 
-//#endregion
-//#region src/logging/redact-identifier.ts
-function sha256HexPrefix(value, len = 12) {
-	const safeLen = Number.isFinite(len) ? Math.max(1, Math.floor(len)) : 12;
-	return crypto.createHash("sha256").update(value).digest("hex").slice(0, safeLen);
-}
-function redactIdentifier(value, opts) {
-	const trimmed = value?.trim();
-	if (!trimmed) return "-";
-	return `sha256:${sha256HexPrefix(trimmed, opts?.len ?? 12)}`;
-}
-
-//#endregion
-//#region src/agents/workspace-run.ts
-function resolveRunAgentId(params) {
-	const rawSessionKey = params.sessionKey?.trim() ?? "";
-	const shape = classifySessionKeyShape(rawSessionKey);
-	if (shape === "malformed_agent") throw new Error("Malformed agent session key; refusing workspace resolution.");
-	const explicit = typeof params.agentId === "string" && params.agentId.trim() ? normalizeAgentId(params.agentId) : void 0;
-	if (explicit) return {
-		agentId: explicit,
-		agentIdSource: "explicit"
-	};
-	const defaultAgentId = resolveDefaultAgentId(params.config ?? {});
-	if (shape === "missing" || shape === "legacy_or_alias") return {
-		agentId: defaultAgentId || DEFAULT_AGENT_ID,
-		agentIdSource: "default"
-	};
-	const parsed = parseAgentSessionKey(rawSessionKey);
-	if (parsed?.agentId) return {
-		agentId: normalizeAgentId(parsed.agentId),
-		agentIdSource: "session_key"
-	};
-	return {
-		agentId: defaultAgentId || DEFAULT_AGENT_ID,
-		agentIdSource: "default"
-	};
-}
-function redactRunIdentifier(value) {
-	return redactIdentifier(value, { len: 12 });
-}
-function resolveRunWorkspaceDir(params) {
-	const requested = params.workspaceDir;
-	const { agentId, agentIdSource } = resolveRunAgentId({
-		sessionKey: params.sessionKey,
-		agentId: params.agentId,
-		config: params.config
-	});
-	if (typeof requested === "string") {
-		const trimmed = requested.trim();
-		if (trimmed) return {
-			workspaceDir: resolveUserPath(trimmed),
-			usedFallback: false,
-			agentId,
-			agentIdSource
-		};
-	}
-	const fallbackReason = requested == null ? "missing" : typeof requested === "string" ? "blank" : "invalid_type";
-	return {
-		workspaceDir: resolveUserPath(resolveAgentWorkspaceDir(params.config ?? {}, agentId)),
-		usedFallback: true,
-		fallbackReason,
-		agentId,
-		agentIdSource
-	};
-}
-
 //#endregion
 //#region src/agents/cli-runner.ts
 const log$1 = createSubsystemLogger("agent/claude-cli");
@@ -2958,35 +3244,31 @@ async function runCliAgent(params) {
 }
 
 //#endregion
-//#region src/agents/anthropic-direct-runner.ts
+//#region src/agents/gemini-direct-runner.ts
 /**
-* Anthropic Direct API Runner
+* Gemini Direct API Runner
 *
-* Makes calls directly to api.anthropic.com without needing the claude CLI
-* binary to be installed or logged in. Works with any valid token:
+* Makes calls directly to generativelanguage.googleapis.com without needing
+* a CLI wrapper. Works with Google API keys (GEMINI_API_KEY).
 *
-*   sk-ant-api01-...  (Console API key)
-*   sk-ant-oat01-...  (Claude Code OAuth access token)
-*
-* This runner is automatically used when an `anthropic:default` token credential
-* is present in the auth store and the claude CLI is unavailable or not logged in.
+* This runner is automatically used when a google API key is available
+* and the provider is set to "google" or "gemini".
 */
-const log = createSubsystemLogger("agent/anthropic-direct");
+const log = createSubsystemLogger("agent/gemini-direct");
+const DEFAULT_GEMINI_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
 const MODEL_MAP = {
-	opus: "claude-opus-4-5",
-	"opus-4": "claude-opus-4-5",
-	"opus-4.5": "claude-opus-4-5",
-	"opus-4.6": "claude-opus-4-5",
-	"claude-opus-4-5": "claude-opus-4-5",
-	sonnet: "claude-sonnet-4-5",
-	"sonnet-4.5": "claude-sonnet-4-5",
-	"sonnet-4.1": "claude-sonnet-4-1-20250219",
-	"claude-sonnet-4-5": "claude-sonnet-4-5",
-	haiku: "claude-haiku-3-5",
-	"haiku-3.5": "claude-haiku-3-5",
-	default: "claude-sonnet-4-5"
+	gemini: "gemini-2.0-flash",
+	"gemini-pro": "gemini-1.5-pro",
+	"gemini-flash": "gemini-2.0-flash",
+	"gemini-2.0": "gemini-2.0-flash",
+	"gemini-2.0-flash": "gemini-2.0-flash",
+	"gemini-2.0-pro": "gemini-2.0-pro-exp-02-05",
+	"gemini-1.5": "gemini-1.5-pro",
+	"gemini-1.5-pro": "gemini-1.5-pro",
+	"gemini-1.5-flash": "gemini-1.5-flash",
+	default: "gemini-2.0-flash"
 };
-const HISTORY_FILE_SUFFIX = ".anima-history.json";
+const HISTORY_FILE_SUFFIX = ".gemini-history.json";
 async function loadSessionHistory(sessionFile) {
 	const histPath = sessionFile + HISTORY_FILE_SUFFIX;
 	try {
@@ -3009,15 +3291,19 @@ function resolveModel(model) {
 	const key = (model ?? "default").trim().toLowerCase() || "default";
 	return MODEL_MAP[key] ?? key;
 }
+function buildModelPath(model) {
+	return model.startsWith("models/") ? model : `models/${model}`;
+}
 /**
-* Run an agent turn directly against api.anthropic.com.
+* Run an agent turn directly against generativelanguage.googleapis.com.
 *
 * Maintains multi-turn conversation history per session file.
 * Falls back to single-turn if history is unavailable.
 */
-async function runAnthropicDirectAgent(params) {
+async function runGeminiDirectAgent(params) {
 	const started = Date.now();
 	const resolvedModel = resolveModel(params.model);
+	const modelPath = buildModelPath(resolvedModel);
 	log.info(`direct api exec: model=${resolvedModel} promptChars=${params.prompt.length}`);
 	const workspaceDir = resolveRunWorkspaceDir({
 		workspaceDir: params.workspaceDir,
@@ -3057,36 +3343,37 @@ async function runAnthropicDirectAgent(params) {
 		docsPath: docsPath ?? void 0,
 		tools: [],
 		contextFiles,
-		modelDisplay: `anthropic/${resolvedModel}`,
+		modelDisplay: `google/${resolvedModel}`,
 		agentId: sessionAgentId
 	});
 	let history = await loadSessionHistory(params.sessionFile);
 	if (!history) history = {
 		sessionId: params.sessionId,
-		messages: [],
+		contents: [],
 		createdAt: started,
 		updatedAt: started
 	};
-	history.messages.push({
+	history.contents.push({
 		role: "user",
-		content: params.prompt
+		parts: [{ text: params.prompt }]
 	});
 	const requestBody = {
-		model: resolvedModel,
-		max_tokens: 8192,
-		system: systemPrompt,
-		messages: history.messages
+		systemInstruction: { parts: [{ text: systemPrompt }] },
+		contents: history.contents,
+		generationConfig: {
+			maxOutputTokens: 8192,
+			temperature: 1
+		}
 	};
 	try {
 		const controller = new AbortController();
 		const timeoutHandle = setTimeout(() => controller.abort(), params.timeoutMs);
-		const response = await fetch("https://api.anthropic.com/v1/messages", {
+		const url = `${DEFAULT_GEMINI_BASE_URL}/${modelPath}:generateContent?key=${params.apiKey}`;
+		const response = await fetch(url, {
 			method: "POST",
 			headers: {
-				"x-api-key": params.token,
-				"anthropic-version": "2023-06-01",
-				"content-type": "application/json",
-				"user-agent": `anima/3.0.5 (direct-runner; ${os.platform()})`
+				"Content-Type": "application/json",
+				"User-Agent": `anima/5.0.1 (gemini-direct-runner; ${os.platform()})`
 			},
 			body: JSON.stringify(requestBody),
 			signal: controller.signal
@@ -3097,8 +3384,8 @@ async function runAnthropicDirectAgent(params) {
 			const isAuth = response.status === 401 || response.status === 403;
 			const isRateLimit = response.status === 429;
 			const rateHint = isRateLimit ? " — rate limit hit, will retry next heartbeat." : "";
-			const authHint = isAuth ? " — token may be invalid or expired. Run: anima setup-token" : "";
-			log.error(`anthropic api error: HTTP ${response.status}${authHint}${rateHint}`, {
+			const authHint = isAuth ? " — API key may be invalid. Check GEMINI_API_KEY environment variable." : "";
+			log.error(`gemini api error: HTTP ${response.status}${authHint}${rateHint}`, {
 				status: response.status,
 				body: body.slice(0, 500)
 			});
@@ -3114,51 +3401,51 @@ async function runAnthropicDirectAgent(params) {
 			};
 		}
 		const data = await response.json();
-		const outputText = (data.content ?? []).filter((b) => b.type === "text" && typeof b.text === "string").map((b) => b.text).join("").trim();
-		if (!outputText) log.warn("anthropic direct: empty response", {
-			stopReason: data.stop_reason,
-			contentTypes: (data.content ?? []).map((b) => b.type)
-		});
-		await params.onAssistantMessageStart?.();
-		if (outputText && params.onPartialReply) await params.onPartialReply({ text: outputText });
-		history.messages.push({
-			role: "assistant",
-			content: outputText
-		});
-		history.updatedAt = Date.now();
-		await saveSessionHistory(params.sessionFile, history);
+		const candidate = data.candidates?.[0];
+		const assistantText = (candidate?.content?.parts ?? []).filter((p) => typeof p.text === "string").map((p) => p.text).join("\n");
+		if (assistantText && params.onPartialReply) await params.onPartialReply({ text: assistantText });
+		if (assistantText) {
+			history.contents.push({
+				role: "model",
+				parts: [{ text: assistantText }]
+			});
+			history.updatedAt = Date.now();
+			await saveSessionHistory(params.sessionFile, history);
+		}
+		const usage = data.usageMetadata;
 		const durationMs = Date.now() - started;
-		const inputTokens = data.usage?.input_tokens ?? 0;
-		const outputTokens = data.usage?.output_tokens ?? 0;
-		log.info(`direct api done: model=${resolvedModel} in=${inputTokens} out=${outputTokens} ms=${durationMs}`);
+		log.info(`gemini api complete: ${durationMs}ms`, {
+			inputTokens: usage?.promptTokenCount,
+			outputTokens: usage?.candidatesTokenCount,
+			finishReason: candidate?.finishReason
+		});
 		return {
 			status: "completed",
-			output: outputText,
-			payloads: outputText ? [{ text: outputText }] : [],
+			output: assistantText,
 			meta: {
 				durationMs,
 				agentMeta: {
-					provider: "anthropic",
 					model: resolvedModel,
-					usage: {
-						inputTokens,
-						outputTokens,
-						cacheCreationInputTokens: 0,
-						cacheReadInputTokens: 0
-					}
+					provider: "google",
+					usage: usage ? {
+						input: usage.promptTokenCount ?? 0,
+						output: usage.candidatesTokenCount ?? 0
+					} : void 0
 				}
 			}
 		};
 	} catch (err) {
-		const isAbort = err instanceof Error && (err.name === "AbortError" || err.message.includes("aborted"));
-		log.error("anthropic direct runner error", { error: String(err) });
+		const isAbort = err instanceof Error && err.name === "AbortError";
+		const errorKind = isAbort ? "timeout" : "unknown";
+		const errorMsg = isAbort ? `Request timed out after ${params.timeoutMs}ms` : String(err);
+		log.error(`gemini api error: ${errorMsg}`, { error: String(err) });
 		return {
-			status: isAbort ? "timeout" : "failed",
+			status: "failed",
 			meta: {
 				durationMs: Date.now() - started,
 				error: {
-					message: isAbort ? `Request timed out after ${params.timeoutMs}ms` : String(err instanceof Error ? err.message : err),
-					kind: isAbort ? "timeout" : "unknown"
+					message: errorMsg,
+					kind: errorKind
 				}
 			}
 		};
@@ -3246,6 +3533,57 @@ async function runEmbeddedPiAgent(...args) {
 			}
 		}
 	}
+	if (provider === "google" || provider === "gemini") {
+		const geminiApiKey = (await resolveApiKeyForProvider({
+			provider: "google",
+			cfg: params.config
+		}))?.apiKey;
+		if (geminiApiKey) {
+			await emitAgentEvent(params, "lifecycle", {
+				phase: "start",
+				startedAt
+			});
+			try {
+				const result = await runGeminiDirectAgent({
+					apiKey: geminiApiKey,
+					sessionId: params.sessionId,
+					sessionKey: params.sessionKey,
+					agentId: params.agentId,
+					sessionFile: params.sessionFile,
+					workspaceDir: params.workspaceDir,
+					config: params.config,
+					prompt: params.prompt,
+					model: params.model,
+					thinkLevel: params.thinkLevel,
+					timeoutMs,
+					runId,
+					extraSystemPrompt: params.extraSystemPrompt,
+					ownerNumbers: params.ownerNumbers,
+					onPartialReply: async (payload) => {
+						if (!assistantStarted) {
+							assistantStarted = true;
+							await params.onAssistantMessageStart?.();
+						}
+						await params.onPartialReply?.(payload);
+						await emitAgentEvent(params, "assistant", { text: payload.text });
+					},
+					onAssistantMessageStart: params.onAssistantMessageStart
+				});
+				await emitAgentEvent(params, "lifecycle", {
+					phase: "end",
+					durationMs: Date.now() - startedAt,
+					status: result.status
+				});
+				return result;
+			} catch (err) {
+				await emitAgentEvent(params, "lifecycle", {
+					phase: "error",
+					error: String(err instanceof Error ? err.message : err)
+				});
+				throw err;
+			}
+		}
+	}
 	const cliProvider = resolveCompatCliProvider(provider, params.config);
 	if (!resolveCliBackendConfig(cliProvider, params.config)) throw new Error(`No CLI backend available for provider "${provider}" (resolved "${cliProvider}").\nEither:\n  • Run: anima setup-token  (set an Anthropic API key — no CLI needed)\n  • Install the matching CLI and log in`);
 	await emitAgentEvent(params, "lifecycle", {