@noxsoft/anima 5.0.1 → 5.0.2

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

@@ -2,13 +2,13 @@ import { E as resolveAgentIdFromSessionKey, M as parseAgentSessionKey, S as clas
 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 { i as triggerInternalHook, t as createInternalHookEvent } from "./internal-hooks-CZOlj8zG.js";
+import { At as buildBootstrapContextFiles, Mt as resolveBootstrapTotalMaxChars, h as classifyFailoverReason, jt as resolveBootstrapMaxChars, n as SILENT_REPLY_TOKEN, t as HEARTBEAT_TOKEN, v as isFailoverErrorMessage } from "./tokens-DXjI-TIV.js";
+import { s as isTruthyEnvValue } from "./shell-env-V934Ymrk.js";
+import { d as resolveModelRefFromString, r as buildModelAliasIndex, s as normalizeProviderId, u as resolveDefaultModelForAgent } from "./model-selection-DT-L7bjC.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 { s as loadAuthProfileStore } from "./auth-profiles-DriJ4HU5.js";
+import { i as resolveApiKeyForProvider, r as requireApiKey, t as getApiKeyForModel } from "./model-auth-BKf-GZVK.js";
 import fs from "node:fs/promises";
 import os, { homedir, tmpdir } from "node:os";
 import path, { join } from "node:path";
@@ -18,165 +18,116 @@ 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;
+//#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 pickBackendConfigByAliases(config, aliases) {
-	for (const alias of aliases) {
-		const matched = pickBackendConfig(config, normalizeBackendKey(alias));
-		if (matched) return matched;
-	}
+function redactIdentifier(value, opts) {
+	const trimmed = value?.trim();
+	if (!trimmed) return "-";
+	return `sha256:${sha256HexPrefix(trimmed, opts?.len ?? 12)}`;
 }
-function mergeBackendConfig(base, override) {
-	if (!override) return { ...base };
+
+//#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 {
-		...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
+		agentId: defaultAgentId || DEFAULT_AGENT_ID,
+		agentIdSource: "default"
 	};
 }
-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
-			}
+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 override = pickBackendConfig(configured, normalized);
-	if (!override) return null;
-	const command = override.command?.trim();
-	if (!command) return null;
+	const fallbackReason = requested == null ? "missing" : typeof requested === "string" ? "blank" : "invalid_type";
 	return {
-		id: normalized,
-		config: {
-			...override,
-			command
-		}
+		workspaceDir: resolveUserPath(resolveAgentWorkspaceDir(params.config ?? {}, agentId)),
+		usedFallback: true,
+		fallbackReason,
+		agentId,
+		agentIdSource
+	};
+}
+
+//#endregion
+//#region src/agents/bootstrap-hooks.ts
+async function applyBootstrapHookOverrides(params) {
+	const sessionKey = params.sessionKey ?? params.sessionId ?? "unknown";
+	const agentId = params.agentId ?? (params.sessionKey ? resolveAgentIdFromSessionKey(params.sessionKey) : void 0);
+	const event = createInternalHookEvent("agent", "bootstrap", sessionKey, {
+		workspaceDir: params.workspaceDir,
+		bootstrapFiles: params.files,
+		cfg: params.config,
+		sessionKey: params.sessionKey,
+		sessionId: params.sessionId,
+		agentId
+	});
+	await triggerInternalHook(event);
+	const updated = event.context.bootstrapFiles;
+	return Array.isArray(updated) ? updated : params.files;
+}
+
+//#endregion
+//#region src/agents/bootstrap-files.ts
+function makeBootstrapWarn(params) {
+	if (!params.warn) return;
+	return (message) => params.warn?.(`${message} (sessionKey=${params.sessionLabel})`);
+}
+async function resolveBootstrapFilesForRun(params) {
+	const sessionKey = params.sessionKey ?? params.sessionId;
+	return applyBootstrapHookOverrides({
+		files: filterBootstrapFilesForSession(await loadWorkspaceBootstrapFiles(params.workspaceDir), sessionKey),
+		workspaceDir: params.workspaceDir,
+		config: params.config,
+		sessionKey: params.sessionKey,
+		sessionId: params.sessionId,
+		agentId: params.agentId
+	});
+}
+async function resolveBootstrapContextForRun(params) {
+	const bootstrapFiles = await resolveBootstrapFilesForRun(params);
+	return {
+		bootstrapFiles,
+		contextFiles: buildBootstrapContextFiles(bootstrapFiles, {
+			maxChars: resolveBootstrapMaxChars(params.config),
+			totalMaxChars: resolveBootstrapTotalMaxChars(params.config),
+			warn: params.warn
+		})
 	};
 }
 
@@ -276,50 +227,21 @@ function stripHeartbeatToken(raw, opts = {}) {
 }
 
 //#endregion
-//#region src/agents/bootstrap-hooks.ts
-async function applyBootstrapHookOverrides(params) {
-	const sessionKey = params.sessionKey ?? params.sessionId ?? "unknown";
-	const agentId = params.agentId ?? (params.sessionKey ? resolveAgentIdFromSessionKey(params.sessionKey) : void 0);
-	const event = createInternalHookEvent("agent", "bootstrap", sessionKey, {
-		workspaceDir: params.workspaceDir,
-		bootstrapFiles: params.files,
-		cfg: params.config,
-		sessionKey: params.sessionKey,
-		sessionId: params.sessionId,
-		agentId
-	});
-	await triggerInternalHook(event);
-	const updated = event.context.bootstrapFiles;
-	return Array.isArray(updated) ? updated : params.files;
-}
-
-//#endregion
-//#region src/agents/bootstrap-files.ts
-function makeBootstrapWarn(params) {
-	if (!params.warn) return;
-	return (message) => params.warn?.(`${message} (sessionKey=${params.sessionLabel})`);
-}
-async function resolveBootstrapFilesForRun(params) {
-	const sessionKey = params.sessionKey ?? params.sessionId;
-	return applyBootstrapHookOverrides({
-		files: filterBootstrapFilesForSession(await loadWorkspaceBootstrapFiles(params.workspaceDir), sessionKey),
-		workspaceDir: params.workspaceDir,
-		config: params.config,
-		sessionKey: params.sessionKey,
-		sessionId: params.sessionId,
-		agentId: params.agentId
+//#region src/agents/docs-path.ts
+async function resolveAnimaDocsPath(params) {
+	const workspaceDir = params.workspaceDir?.trim();
+	if (workspaceDir) {
+		const workspaceDocs = path.join(workspaceDir, "docs");
+		if (fs$1.existsSync(workspaceDocs)) return workspaceDocs;
+	}
+	const packageRoot = await resolveAnimaPackageRoot({
+		cwd: params.cwd,
+		argv1: params.argv1,
+		moduleUrl: params.moduleUrl
 	});
-}
-async function resolveBootstrapContextForRun(params) {
-	const bootstrapFiles = await resolveBootstrapFilesForRun(params);
-	return {
-		bootstrapFiles,
-		contextFiles: buildBootstrapContextFiles(bootstrapFiles, {
-			maxChars: resolveBootstrapMaxChars(params.config),
-			totalMaxChars: resolveBootstrapTotalMaxChars(params.config),
-			warn: params.warn
-		})
-	};
+	if (!packageRoot) return null;
+	const packageDocs = path.join(packageRoot, "docs");
+	return fs$1.existsSync(packageDocs) ? packageDocs : null;
 }
 
 //#endregion
@@ -364,7 +286,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 +631,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 +1696,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 +1962,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,
@@ -2500,40 +2457,393 @@ async function writeCliImages(images) {
 		cleanup
 	};
 }
-function buildCliArgs(params) {
-	const args = [...params.baseArgs];
-	if (!params.useResume && params.backend.modelArg && params.modelId) args.push(params.backend.modelArg, params.modelId);
-	if (!params.useResume && params.systemPrompt && params.backend.systemPromptArg) args.push(params.backend.systemPromptArg, params.systemPrompt);
-	if (!params.useResume && params.sessionId) {
-		if (params.backend.sessionArgs && params.backend.sessionArgs.length > 0) for (const entry of params.backend.sessionArgs) args.push(entry.replaceAll("{sessionId}", params.sessionId));
-		else if (params.backend.sessionArg) args.push(params.backend.sessionArg, params.sessionId);
-	}
-	if (params.imagePaths && params.imagePaths.length > 0) {
-		const mode = params.backend.imageMode ?? "repeat";
-		const imageArg = params.backend.imageArg;
-		if (imageArg) if (mode === "list") args.push(imageArg, params.imagePaths.join(","));
-		else for (const imagePath of params.imagePaths) args.push(imageArg, imagePath);
+function buildCliArgs(params) {
+	const args = [...params.baseArgs];
+	if (!params.useResume && params.backend.modelArg && params.modelId) args.push(params.backend.modelArg, params.modelId);
+	if (!params.useResume && params.systemPrompt && params.backend.systemPromptArg) args.push(params.backend.systemPromptArg, params.systemPrompt);
+	if (!params.useResume && params.sessionId) {
+		if (params.backend.sessionArgs && params.backend.sessionArgs.length > 0) for (const entry of params.backend.sessionArgs) args.push(entry.replaceAll("{sessionId}", params.sessionId));
+		else if (params.backend.sessionArg) args.push(params.backend.sessionArg, params.sessionId);
+	}
+	if (params.imagePaths && params.imagePaths.length > 0) {
+		const mode = params.backend.imageMode ?? "repeat";
+		const imageArg = params.backend.imageArg;
+		if (imageArg) if (mode === "list") args.push(imageArg, params.imagePaths.join(","));
+		else for (const imagePath of params.imagePaths) args.push(imageArg, imagePath);
+	}
+	if (params.promptArg !== void 0) args.push(params.promptArg);
+	return args;
+}
+
+//#endregion
+//#region src/agents/anthropic-direct-runner.ts
+/**
+* Anthropic 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:
+*
+*   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.
+*/
+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: {
+						inputTokens,
+						outputTokens,
+						cacheCreationInputTokens: 0,
+						cacheReadInputTokens: 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 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 (params.promptArg !== void 0) args.push(params.promptArg);
-	return args;
-}
-
-//#endregion
-//#region src/agents/docs-path.ts
-async function resolveAnimaDocsPath(params) {
-	const workspaceDir = params.workspaceDir?.trim();
-	if (workspaceDir) {
-		const workspaceDocs = path.join(workspaceDir, "docs");
-		if (fs$1.existsSync(workspaceDocs)) return workspaceDocs;
+	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 packageRoot = await resolveAnimaPackageRoot({
-		cwd: params.cwd,
-		argv1: params.argv1,
-		moduleUrl: params.moduleUrl
-	});
-	if (!packageRoot) return null;
-	const packageDocs = path.join(packageRoot, "docs");
-	return fs$1.existsSync(packageDocs) ? packageDocs : null;
+	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
@@ -2661,73 +2971,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 +3201,31 @@ async function runCliAgent(params) {
 }
 
 //#endregion
-//#region src/agents/anthropic-direct-runner.ts
+//#region src/agents/gemini-direct-runner.ts
 /**
-* Anthropic 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:
+* Gemini Direct API Runner
 *
-*   sk-ant-api01-...  (Console API key)
-*   sk-ant-oat01-...  (Claude Code OAuth access token)
+* Makes calls directly to generativelanguage.googleapis.com without needing
+* a CLI wrapper. Works with Google API keys (GEMINI_API_KEY).
 *
-* 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 +3248,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 +3300,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 +3341,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 +3358,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 +3490,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", {
@@ -3346,4 +3641,4 @@ async function waitForEmbeddedPiRunEnd(..._args) {
 }
 
 //#endregion
-export { normalizeTtsAutoMode as A, textToSpeech as B, getLastTtsAttempt as C, isTtsEnabled as D, isSummarizationEnabled as E, setLastTtsAttempt as F, isVoiceCompatibleAudio as H, setSummarizationEnabled as I, setTtsEnabled as L, resolveTtsAutoMode as M, resolveTtsConfig as N, isTtsProviderConfigured as O, resolveTtsPrefsPath as P, setTtsMaxLength as R, buildTtsSystemPromptHint as S, getTtsProvider as T, resolveBootstrapContextForRun as U, textToSpeechTelephony as V, stripHeartbeatToken as W, resolveUserTimeFormat as _, queueEmbeddedPiMessage as a, killProcessTree as b, waitForEmbeddedPiRunEnd as c, describeFailoverError as d, isFailoverError as f, formatUserTime as g, buildSystemPromptParams as h, isEmbeddedPiRunStreaming as i, resolveTtsApiKey as j, maybeApplyTtsToPayload as k, runCliAgent as l, buildAgentSystemPrompt as m, compactEmbeddedPiSession as n, resolveEmbeddedSessionLane as o, isTimeoutError as p, isEmbeddedPiRunActive as r, runEmbeddedPiAgent as s, abortEmbeddedPiRun as t, coerceToFailoverError as u, resolveUserTimezone as v, getTtsMaxLength as w, sanitizeBinaryOutput as x, getShellConfig as y, setTtsProvider as z };
+export { normalizeTtsAutoMode as A, textToSpeech as B, getLastTtsAttempt as C, isTtsEnabled as D, isSummarizationEnabled as E, setLastTtsAttempt as F, isVoiceCompatibleAudio as H, setSummarizationEnabled as I, setTtsEnabled as L, resolveTtsAutoMode as M, resolveTtsConfig as N, isTtsProviderConfigured as O, resolveTtsPrefsPath as P, setTtsMaxLength as R, buildTtsSystemPromptHint as S, getTtsProvider as T, stripHeartbeatToken as U, textToSpeechTelephony as V, resolveBootstrapContextForRun as W, resolveUserTimeFormat as _, queueEmbeddedPiMessage as a, killProcessTree as b, waitForEmbeddedPiRunEnd as c, describeFailoverError as d, isFailoverError as f, formatUserTime as g, buildSystemPromptParams as h, isEmbeddedPiRunStreaming as i, resolveTtsApiKey as j, maybeApplyTtsToPayload as k, runCliAgent as l, buildAgentSystemPrompt as m, compactEmbeddedPiSession as n, resolveEmbeddedSessionLane as o, isTimeoutError as p, isEmbeddedPiRunActive as r, runEmbeddedPiAgent as s, abortEmbeddedPiRun as t, coerceToFailoverError as u, resolveUserTimezone as v, getTtsMaxLength as w, sanitizeBinaryOutput as x, getShellConfig as y, setTtsProvider as z };