denchclaw 2.4.6 → 2.5.1

package/dist/{program-BDz7WHcZ.js → program-BYB4nfWK.js}

@@ -1,5 +1,5 @@
 import { a as markNoticeShown, i as getOrCreateAnonymousId, o as readTelemetryConfig, r as track, s as writeTelemetryConfig, t as isTelemetryEnabled } from "./telemetry-DguRjCZq.js";
-import { d as hasFlag, g as resolveRequiredHomeDir, h as expandHomePrefix, i as isDaemonlessMode, m as applyCliProfileEnv, p as hasRootVersionAlias, r as DENCHCLAW_DEFAULT_GATEWAY_PORT, s as defaultRuntime, t as isTruthyEnvValue, u as getPrimaryCommand } from "./entry.js";
+import { d as hasFlag, g as resolveRequiredHomeDir, h as expandHomePrefix, i as isDaemonlessMode, m as applyCliProfileEnv, o as visibleWidth, p as hasRootVersionAlias, r as DENCHCLAW_DEFAULT_GATEWAY_PORT, s as defaultRuntime, t as isTruthyEnvValue, u as getPrimaryCommand } from "./entry.js";
 import { a as hasEmittedCliBanner, i as formatCliBannerLine, n as resolveCliName, o as isRich, s as theme, t as replaceCliName } from "./cli-name-CoW7mNz-.js";
 import { t as VERSION } from "./version-DfFmvCFM.js";
 import { execFileSync, spawn } from "node:child_process";
@@ -10,6 +10,7 @@ import fs, { copyFileSync, cpSync, existsSync, lstatSync, mkdirSync, openSync, r
 import json5 from "json5";
 import { Command } from "commander";
 import { confirm, isCancel, select, spinner, text } from "@clack/prompts";
+import gradient from "gradient-string";
 import { fileURLToPath } from "node:url";
 import { createConnection } from "node:net";
 
@@ -174,7 +175,7 @@ const FALLBACK_DENCH_CLOUD_MODELS = [
 		displayName: "Claude Opus 4.6",
 		provider: "anthropic",
 		transportProvider: "bedrock",
-		api: "openai-completions",
+		api: "openai-responses",
 		input: ["text", "image"],
 		reasoning: false,
 		contextWindow: 2e5,
@@ -197,7 +198,7 @@ const FALLBACK_DENCH_CLOUD_MODELS = [
 		displayName: "GPT-5.4",
 		provider: "openai",
 		transportProvider: "openai",
-		api: "openai-completions",
+		api: "openai-responses",
 		input: ["text", "image"],
 		reasoning: false,
 		contextWindow: 128e3,
@@ -220,7 +221,7 @@ const FALLBACK_DENCH_CLOUD_MODELS = [
 		displayName: "Claude Sonnet 4.6",
 		provider: "anthropic",
 		transportProvider: "bedrock",
-		api: "openai-completions",
+		api: "openai-responses",
 		input: ["text", "image"],
 		reasoning: false,
 		contextWindow: 2e5,
@@ -272,7 +273,7 @@ function normalizeDenchCloudCatalogModel(input) {
 		displayName,
 		provider,
 		transportProvider,
-		api: "openai-completions",
+		api: record.api === "openai-completions" ? "openai-completions" : "openai-responses",
 		input: normalizeInputKinds(record.input, supportsImages),
 		reasoning: supportsReasoning,
 		contextWindow,
@@ -347,11 +348,18 @@ function buildDenchCloudProviderModels(models) {
 function buildDenchCloudAgentModelEntries(models) {
 	return Object.fromEntries(models.map((model) => [`dench-cloud/${model.stableId}`, { alias: `${model.displayName} (Dench Cloud)` }]));
 }
+function buildComposioMcpServerConfig(gatewayUrl, apiKey) {
+	return {
+		url: `${gatewayUrl}/v1/composio/mcp`,
+		transport: "streamable-http",
+		headers: { Authorization: `Bearer ${apiKey}` }
+	};
+}
 function buildDenchCloudProviderConfig(params) {
 	return {
 		baseUrl: buildDenchGatewayApiBaseUrl(params.gatewayUrl),
 		apiKey: params.apiKey,
-		api: "openai-completions",
+		api: "openai-responses",
 		models: buildDenchCloudProviderModels(params.models)
 	};
 }
@@ -361,7 +369,15 @@ function buildDenchCloudConfigPatch(params) {
 			mode: "merge",
 			providers: { "dench-cloud": buildDenchCloudProviderConfig(params) }
 		},
-		agents: { defaults: { models: buildDenchCloudAgentModelEntries(params.models) } }
+		agents: { defaults: { models: buildDenchCloudAgentModelEntries(params.models) } },
+		messages: { tts: {
+			provider: "elevenlabs",
+			providers: { elevenlabs: {
+				baseUrl: params.gatewayUrl,
+				apiKey: params.apiKey
+			} }
+		} },
+		mcp: { servers: { composio: buildComposioMcpServerConfig(params.gatewayUrl, params.apiKey) } }
 	};
 }
 function resolveDenchCloudModel(models, requestedId) {
@@ -382,10 +398,12 @@ function readConfiguredDenchCloudSettings(rawConfig) {
 	const modelPrimary = typeof modelValue === "string" ? modelValue : typeof modelSetting?.primary === "string" ? modelSetting.primary : void 0;
 	const selectedModel = typeof modelPrimary === "string" && modelPrimary.startsWith("dench-cloud/") ? modelPrimary.slice(12) : void 0;
 	const baseUrl = readString(provider ?? {}, "baseUrl", "base_url");
+	const ttsElevenlabs = asRecord$1(asRecord$1(asRecord$1(asRecord$1(rawConfig?.messages)?.tts)?.providers)?.elevenlabs);
 	return {
 		gatewayUrl: baseUrl ? normalizeDenchGatewayUrl(baseUrl) : void 0,
 		apiKey: readString(provider ?? {}, "apiKey", "api_key"),
-		selectedModel
+		selectedModel,
+		ttsElevenLabsBaseUrl: readString(ttsElevenlabs ?? {}, "baseUrl", "base_url")
 	};
 }
 
@@ -1400,12 +1418,12 @@ const MANAGED_SKILLS = [
 		name: "crm",
 		templatePaths: true
 	},
-	{ name: "browser" },
 	{
 		name: "app-builder",
 		templatePaths: true
 	},
-	{ name: "gstack" }
+	{ name: "gstack" },
+	{ name: "composio-apps" }
 ];
 function seedSkill(params, skill) {
 	const sourceDir = path.join(params.packageRoot, "skills", skill.name);
@@ -1754,6 +1772,79 @@ async function setOpenClawConfigJson(params) {
 		errorMessage: params.errorMessage
 	});
 }
+function readDenchIntegrationsMetadata(stateDir) {
+	const metadataPath = path.join(stateDir, ".dench-integrations.json");
+	if (!existsSync(metadataPath)) return;
+	try {
+		const raw = JSON.parse(readFileSync(metadataPath, "utf-8"));
+		return raw && typeof raw === "object" ? raw : void 0;
+	} catch {
+		return;
+	}
+}
+function disableDenchElevenLabsOverride(tts, gatewayUrl, apiKey) {
+	const providers = asRecord(tts.providers);
+	const elevenlabs = asRecord(providers?.elevenlabs);
+	if (elevenlabs) {
+		if (typeof elevenlabs.baseUrl === "string" && (!gatewayUrl || elevenlabs.baseUrl === gatewayUrl)) delete elevenlabs.baseUrl;
+		if (typeof elevenlabs.apiKey === "string" && (!apiKey || elevenlabs.apiKey === apiKey)) delete elevenlabs.apiKey;
+		if (Object.keys(elevenlabs).length === 0 && providers) delete providers.elevenlabs;
+	}
+	if (tts.provider === "elevenlabs") delete tts.provider;
+	if (providers && Object.keys(providers).length === 0) delete tts.providers;
+}
+function applyDenchManagedIntegrationDefaults(params) {
+	const nextConfig = { ...readBootstrapConfig(params.stateDir) ?? {} };
+	const plugins = { ...asRecord(nextConfig.plugins) ?? {} };
+	const entries = { ...asRecord(plugins.entries) ?? {} };
+	entries["exa-search"] = {
+		...asRecord(entries["exa-search"]) ?? {},
+		enabled: params.denchEnabled
+	};
+	entries["apollo-enrichment"] = {
+		...asRecord(entries["apollo-enrichment"]) ?? {},
+		enabled: params.denchEnabled
+	};
+	plugins.entries = entries;
+	nextConfig.plugins = plugins;
+	const tools = { ...asRecord(nextConfig.tools) ?? {} };
+	const deny = Array.isArray(tools.deny) ? tools.deny.filter((value) => typeof value === "string") : [];
+	const web = { ...asRecord(tools.web) ?? {} };
+	const search = { ...asRecord(web.search) ?? {} };
+	search.enabled = !params.denchEnabled;
+	web.search = search;
+	tools.web = web;
+	tools.deny = params.denchEnabled ? uniqueStrings([...deny, "web_search"]) : deny.filter((value) => value !== "web_search");
+	nextConfig.tools = tools;
+	const messages = { ...asRecord(nextConfig.messages) ?? {} };
+	const tts = { ...asRecord(messages.tts) ?? {} };
+	const providers = { ...asRecord(tts.providers) ?? {} };
+	const elevenlabs = { ...asRecord(providers.elevenlabs) ?? {} };
+	if (params.denchEnabled && params.gatewayUrl && params.apiKey) {
+		tts.provider = "elevenlabs";
+		elevenlabs.baseUrl = params.gatewayUrl;
+		elevenlabs.apiKey = params.apiKey;
+		providers.elevenlabs = elevenlabs;
+		tts.providers = providers;
+	} else {
+		tts.providers = providers;
+		disableDenchElevenLabsOverride(tts, params.gatewayUrl, params.apiKey);
+	}
+	messages.tts = tts;
+	nextConfig.messages = messages;
+	writeFileSync(path.join(params.stateDir, "openclaw.json"), `${JSON.stringify(nextConfig, null, 2)}\n`);
+	const currentMetadata = readDenchIntegrationsMetadata(params.stateDir) ?? {};
+	const nextMetadata = {
+		...currentMetadata,
+		schemaVersion: 1,
+		exa: {
+			...asRecord(currentMetadata.exa) ?? {},
+			ownsSearch: params.denchEnabled,
+			fallbackProvider: typeof asRecord(currentMetadata.exa)?.fallbackProvider === "string" ? asRecord(currentMetadata.exa)?.fallbackProvider : "duckduckgo"
+		}
+	};
+	writeFileSync(path.join(params.stateDir, ".dench-integrations.json"), `${JSON.stringify(nextMetadata, null, 2)}\n`);
+}
 async function syncBundledPlugins(params) {
 	try {
 		const packageRoot = resolveCliPackageRoot();
@@ -2674,6 +2765,10 @@ function readBootstrapConfig(stateDir) {
 		} catch {}
 	}
 }
+function hasConfiguredComposioServer(stateDir) {
+	const composio = asRecord(asRecord(asRecord(readBootstrapConfig(stateDir)?.mcp)?.servers)?.composio);
+	return typeof composio?.url === "string" && composio.url.trim().length > 0;
+}
 function resolveBootstrapWorkspaceDir(stateDir) {
 	return path.join(stateDir, "workspace");
 }
@@ -2743,6 +2838,7 @@ function buildBootstrapDiagnostics(params) {
 	else checks.push(createCheck("profile", "fail", `DenchClaw profile drift detected (${params.profile}).`, `DenchClaw requires \`--profile ${DEFAULT_DENCHCLAW_PROFILE}\`. Re-run bootstrap to repair environment defaults.`));
 	if (params.gatewayProbe.ok) checks.push(createCheck("gateway", "pass", `Gateway reachable at ${params.gatewayUrl}.`));
 	else checks.push(createCheck("gateway", "fail", `Gateway probe failed at ${params.gatewayUrl}${params.gatewayProbe.detail ? ` (${params.gatewayProbe.detail})` : ""}.`, remediationForGatewayFailure(params.gatewayProbe.detail, params.gatewayPort, params.profile)));
+	if (params.denchCloudEnabled) checks.push(createCheck("composio", params.composioConfigured ? "pass" : "warn", params.composioConfigured ? "Composio MCP configured via Dench Cloud gateway." : "Composio MCP not configured. Check mcp.servers.composio in openclaw.json.", params.composioConfigured ? void 0 : `Open Settings > Integrations and repair the Composio MCP setup, or run \`openclaw --profile ${DEFAULT_DENCHCLAW_PROFILE} gateway restart\` after restoring the Dench Cloud config.`));
 	const stateDir = params.stateDir ?? resolveProfileStateDir(params.profile, env);
 	const authCheck = checkAgentAuth(stateDir, resolveModelProvider(stateDir));
 	if (authCheck.ok) checks.push(createCheck("agent-auth", "pass", authCheck.detail));
@@ -2815,6 +2911,80 @@ async function promptForDenchCloudModel(params) {
 	if (isCancel(selection)) return;
 	return String(selection);
 }
+function renderDenchCloudRecommendationBanner() {
+	const rich = isRich();
+	const W = 74;
+	const bdr = (s) => rich ? theme.accentDim(s) : s;
+	const ironShimmer = rich ? gradient([
+		"#374151",
+		"#6B7280",
+		"#9CA3AF",
+		"#D1D5DB",
+		"#9CA3AF",
+		"#6B7280",
+		"#374151"
+	]) : (s) => s;
+	const topBar = ironShimmer("─".repeat(W));
+	const botBar = ironShimmer("─".repeat(W));
+	const top = `  ${bdr("╭")}${topBar}${bdr("╮")}`;
+	const bot = `  ${bdr("╰")}${botBar}${bdr("╯")}`;
+	const blank = `  ${bdr("│")}${" ".repeat(W)}${bdr("│")}`;
+	const row = (content, indent = 4) => {
+		const vis = visibleWidth(content);
+		const right = Math.max(1, W - indent - vis);
+		return `  ${bdr("│")}${" ".repeat(indent)}${content}${" ".repeat(right)}${bdr("│")}`;
+	};
+	const title = rich ? gradient([
+		"#38BDF8",
+		"#2DD4BF",
+		"#34D399"
+	])("D E N C H   C L O U D") : "D E N C H   C L O U D";
+	const subtitle = rich ? theme.muted("The recommended way to run DenchClaw. Everything is managed for you.") : "The recommended way to run DenchClaw. Everything is managed for you.";
+	const bullet = rich ? theme.info("▸") : "▸";
+	const lbl = (s) => rich ? theme.accentBright(s) : s;
+	const dim = (s) => rich ? theme.muted(s) : s;
+	const COL = 14;
+	const featureLines = [
+		[lbl("AI Models"), dim("Claude, GPT, Kimi & more — no API keys needed")],
+		[lbl("Voice"), dim("ElevenLabs built in — no account required")],
+		[lbl("Web Search"), dim("Exa ready out of the box — no key to manage")],
+		[lbl("Skills Store"), dim("Browse & install skills instantly")],
+		[lbl("Image Gen"), dim("State-of-the-art models from day one")]
+	].map(([name, desc]) => {
+		return `${bullet}  ${name}${" ".repeat(Math.max(1, COL - visibleWidth(name)))}${desc}`;
+	});
+	const star = rich ? theme.warn("★") : "★";
+	const intTitle = rich ? theme.warn("1,000+ App Integrations") : "1,000+ App Integrations";
+	const dot = rich ? theme.accentDim(" · ") : " · ";
+	const apps = [
+		rich ? theme.info("Gmail") : "Gmail",
+		rich ? theme.accentBright("Notion") : "Notion",
+		rich ? theme.success("HubSpot") : "HubSpot",
+		rich ? theme.warn("PostHog") : "PostHog",
+		rich ? theme.accent("Stripe") : "Stripe",
+		rich ? theme.success("Salesforce") : "Salesforce",
+		rich ? theme.muted("…") : "…"
+	].join(dot);
+	const check = rich ? theme.success("✓") : "✓";
+	const cta = rich ? theme.success("Recommended for most users") : "Recommended for most users";
+	return [
+		"",
+		top,
+		blank,
+		row(title),
+		row(subtitle),
+		blank,
+		...featureLines.map((l) => row(l)),
+		blank,
+		row(`${star}  ${intTitle}`),
+		row(apps, 7),
+		blank,
+		row(`${check}  ${cta}`),
+		blank,
+		bot,
+		""
+	].join("\n");
+}
 async function applyDenchCloudBootstrapConfig(params) {
 	const raw = readBootstrapConfig(params.stateDir);
 	const existingAgentModels = raw?.agents?.defaults?.models && typeof raw.agents.defaults.models === "object" ? raw.agents.defaults.models : {};
@@ -2867,6 +3037,34 @@ async function applyDenchCloudBootstrapConfig(params) {
 		value: nextAgentModels,
 		errorMessage: "Failed to update agents.defaults.models for Dench Cloud."
 	});
+	await setOpenClawConfigJson({
+		openclawCommand: params.openclawCommand,
+		profile: params.profile,
+		key: "messages.tts.provider",
+		value: configPatch.messages.tts.provider,
+		errorMessage: "Failed to set ElevenLabs as TTS provider."
+	});
+	await setOpenClawConfigJson({
+		openclawCommand: params.openclawCommand,
+		profile: params.profile,
+		key: "messages.tts.providers.elevenlabs",
+		value: configPatch.messages.tts.providers.elevenlabs,
+		errorMessage: "Failed to configure ElevenLabs TTS via Dench Cloud gateway."
+	});
+	if (configPatch.mcp) {
+		const servers = configPatch.mcp.servers;
+		if (servers?.composio) try {
+			await setOpenClawConfigJson({
+				openclawCommand: params.openclawCommand,
+				profile: params.profile,
+				key: "mcp.servers.composio",
+				value: servers.composio,
+				errorMessage: "Failed to configure Composio MCP server via Dench Cloud gateway."
+			});
+		} catch {
+			console.warn(theme.warn("Could not configure the Composio MCP server during bootstrap. You can repair it later in Settings > Integrations."));
+		}
+	}
 }
 async function resolveDenchCloudBootstrapSelection(params) {
 	const existing = readConfiguredDenchCloudSettings(readBootstrapConfig(params.stateDir));
@@ -2893,8 +3091,9 @@ async function resolveDenchCloudBootstrapSelection(params) {
 			catalog
 		};
 	}
+	if (!explicitRequest) params.runtime.log(renderDenchCloudRecommendationBanner());
 	const wantsDenchCloud = explicitRequest ? true : await confirm({
-		message: stylePromptMessage("Use Dench Cloud for inference? Get your API key at dench.com/api"),
+		message: stylePromptMessage("Continue with Dench Cloud? Recommended. API key: dench.com/api"),
 		initialValue: existingDenchConfigured || !currentProvider
 	});
 	if (isCancel(wantsDenchCloud) || !wantsDenchCloud) return { enabled: false };
@@ -3074,6 +3273,16 @@ async function bootstrapCommand(opts, runtime = defaultRuntime) {
 			pluginId: "dench-identity",
 			sourceDirName: "dench-identity",
 			enabled: true
+		},
+		{
+			pluginId: "apollo-enrichment",
+			sourceDirName: "apollo-enrichment",
+			enabled: denchCloudSelection.enabled
+		},
+		{
+			pluginId: "exa-search",
+			sourceDirName: "exa-search",
+			enabled: denchCloudSelection.enabled
 		}
 	];
 	const preOnboardSpinner = !opts.json ? spinner() : null;
@@ -3097,7 +3306,11 @@ async function bootstrapCommand(opts, runtime = defaultRuntime) {
 	];
 	if (opts.forceOnboard) onboardArgv.push("--reset");
 	if (nonInteractive) onboardArgv.push("--non-interactive");
-	if (denchCloudSelection.enabled) onboardArgv.push("--auth-choice", "skip");
+	if (denchCloudSelection.enabled) {
+		onboardArgv.push("--auth-choice", "skip");
+		onboardArgv.push("--skip-search");
+		onboardArgv.push("--skip-skills");
+	}
 	onboardArgv.push("--accept-risk", "--skip-ui");
 	if (daemonless) onboardArgv.push("--skip-health");
 	if (nonInteractive) await runOpenClawOrThrow({
@@ -3146,6 +3359,13 @@ async function bootstrapCommand(opts, runtime = defaultRuntime) {
 	});
 	postOnboardSpinner?.message("Configuring agent defaults…");
 	await ensureAgentDefaults(openclawCommand, profile);
+	postOnboardSpinner?.message("Applying Dench integration defaults…");
+	applyDenchManagedIntegrationDefaults({
+		stateDir,
+		denchEnabled: denchCloudSelection.enabled,
+		gatewayUrl: denchCloudSelection.gatewayUrl,
+		apiKey: denchCloudSelection.apiKey
+	});
 	let gatewayProbe;
 	let gatewayAutoFix;
 	if (daemonless) gatewayProbe = {
@@ -3216,6 +3436,7 @@ async function bootstrapCommand(opts, runtime = defaultRuntime) {
 	postOnboardSpinner?.stop(webRuntimeStatus.ready ? "Post-onboard setup complete." : "Post-onboard setup complete (web runtime unhealthy).");
 	const webReachable = webRuntimeStatus.ready;
 	const webUrl = `http://localhost:${preferredWebPort}`;
+	const composioConfigured = denchCloudSelection.enabled ? hasConfiguredComposioServer(stateDir) : false;
 	const diagnostics = buildBootstrapDiagnostics({
 		profile,
 		openClawCliAvailable: installResult.available,
@@ -3223,6 +3444,8 @@ async function bootstrapCommand(opts, runtime = defaultRuntime) {
 		gatewayPort,
 		gatewayUrl,
 		gatewayProbe,
+		denchCloudEnabled: denchCloudSelection.enabled,
+		composioConfigured,
 		webPort: preferredWebPort,
 		webReachable,
 		rolloutStage,

package/dist/{run-main-Ddx9Tsa1.js → run-main-Z-P_Zlf6.js}

@@ -220,7 +220,7 @@ async function runCli(argv = process$1.argv) {
 		process$1.exitCode = await delegateToGlobalOpenClaw(parseArgv);
 		return;
 	}
-	const { buildProgram } = await import("./program-BDz7WHcZ.js");
+	const { buildProgram } = await import("./program-BYB4nfWK.js");
 	await buildProgram().parseAsync(parseArgv);
 }
 

package/extensions/apollo-enrichment/index.ts

@@ -0,0 +1,268 @@
+import type { AnyAgentTool, OpenClawPluginApi } from "openclaw/plugin-sdk";
+
+export const id = "apollo-enrichment";
+
+const DEFAULT_GATEWAY_URL = "https://gateway.merseoriginals.com";
+const ENRICHMENT_BASE_PATH = "/v1/enrichment";
+const APOLLO_ACTIONS = ["people", "company", "people_search"] as const;
+
+type UnknownRecord = Record<string, unknown>;
+
+function asRecord(value: unknown): UnknownRecord | undefined {
+  return value && typeof value === "object" ? (value as UnknownRecord) : undefined;
+}
+
+function readTrimmedString(value: unknown): string | undefined {
+  return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+
+function readStringList(value: unknown): string[] | undefined {
+  if (!Array.isArray(value)) {
+    return undefined;
+  }
+  const items = value
+    .map((item) => readTrimmedString(item))
+    .filter((item): item is string => Boolean(item));
+  return items.length > 0 ? items : undefined;
+}
+
+function resolveGatewayUrl(config: unknown): string {
+  const root = asRecord(config);
+  const pluginEntries = asRecord(asRecord(root?.plugins)?.entries);
+  const gatewayConfig = asRecord(asRecord(pluginEntries?.["dench-ai-gateway"])?.config);
+  return (
+    readTrimmedString(gatewayConfig?.gatewayUrl) ||
+    process.env.DENCH_GATEWAY_URL?.trim() ||
+    DEFAULT_GATEWAY_URL
+  );
+}
+
+function resolveApiKey(config: unknown): string | undefined {
+  const root = asRecord(config);
+  const providers = asRecord(asRecord(asRecord(root?.models)?.providers));
+  const provider = asRecord(providers?.["dench-cloud"]);
+  return (
+    readTrimmedString(provider?.apiKey) ||
+    process.env.DENCH_CLOUD_API_KEY?.trim() ||
+    process.env.DENCH_API_KEY?.trim() ||
+    undefined
+  );
+}
+
+function jsonResult(payload: unknown) {
+  return {
+    content: [{ type: "text" as const, text: JSON.stringify(payload, null, 2) }],
+    details: payload,
+  };
+}
+
+const ApolloEnrichParameters = {
+  type: "object",
+  additionalProperties: false,
+  properties: {
+    action: {
+      type: "string",
+      enum: [...APOLLO_ACTIONS],
+      description: 'Action to perform: "people", "company", or "people_search".',
+    },
+    email: { type: "string", description: "Email for people enrichment." },
+    linkedinUrl: { type: "string", description: "LinkedIn URL for people enrichment." },
+    firstName: { type: "string", description: "Person first name." },
+    lastName: { type: "string", description: "Person last name." },
+    domain: { type: "string", description: "Company domain such as acme.com." },
+    organizationName: { type: "string", description: "Organization name hint for people enrichment." },
+    personTitles: { type: "array", items: { type: "string" }, description: "Job titles for people search." },
+    personLocations: { type: "array", items: { type: "string" }, description: "Locations for people search." },
+    organizationDomains: { type: "array", items: { type: "string" }, description: "Organization domains for people search." },
+    page: { type: "number", description: "People search page number." },
+    perPage: { type: "number", description: "People search page size." },
+    first_name: { type: "string", description: "Legacy alias for firstName." },
+    last_name: { type: "string", description: "Legacy alias for lastName." },
+    organization_name: { type: "string", description: "Legacy alias for organizationName." },
+    linkedin_url: { type: "string", description: "Legacy alias for linkedinUrl." },
+    person_titles: { type: "array", items: { type: "string" }, description: "Legacy alias for personTitles." },
+    person_locations: { type: "array", items: { type: "string" }, description: "Legacy alias for personLocations." },
+    organization_domains: { type: "array", items: { type: "string" }, description: "Legacy alias for organizationDomains." },
+    per_page: { type: "number", description: "Legacy alias for perPage." },
+  },
+  required: ["action"],
+};
+
+function buildPeopleBody(params: Record<string, unknown>) {
+  const body: Record<string, unknown> = {};
+  const email = readTrimmedString(params.email);
+  const linkedinUrl = readTrimmedString(params.linkedinUrl) ?? readTrimmedString(params.linkedin_url);
+  const firstName = readTrimmedString(params.firstName) ?? readTrimmedString(params.first_name);
+  const lastName = readTrimmedString(params.lastName) ?? readTrimmedString(params.last_name);
+  const domain = readTrimmedString(params.domain);
+  const organizationName =
+    readTrimmedString(params.organizationName) ?? readTrimmedString(params.organization_name);
+
+  if (email) {
+    body.email = email;
+  }
+  if (linkedinUrl) {
+    body.linkedinUrl = linkedinUrl;
+  }
+  if (firstName) {
+    body.firstName = firstName;
+  }
+  if (lastName) {
+    body.lastName = lastName;
+  }
+  if (domain) {
+    body.domain = domain;
+  }
+  if (organizationName) {
+    body.organizationName = organizationName;
+  }
+
+  return body;
+}
+
+function buildPeopleSearchBody(params: Record<string, unknown>) {
+  const body: Record<string, unknown> = {};
+  const personTitles = readStringList(params.personTitles) ?? readStringList(params.person_titles);
+  const personLocations =
+    readStringList(params.personLocations) ?? readStringList(params.person_locations);
+  const organizationDomains =
+    readStringList(params.organizationDomains) ?? readStringList(params.organization_domains);
+  const page = typeof params.page === "number" ? params.page : undefined;
+  const perPage =
+    typeof params.perPage === "number"
+      ? params.perPage
+      : typeof params.per_page === "number"
+        ? params.per_page
+        : undefined;
+
+  if (personTitles) {
+    body.personTitles = personTitles;
+  }
+  if (personLocations) {
+    body.personLocations = personLocations;
+  }
+  if (organizationDomains) {
+    body.organizationDomains = organizationDomains;
+  }
+  if (page !== undefined) {
+    body.page = page;
+  }
+  if (perPage !== undefined) {
+    body.perPage = perPage;
+  }
+
+  return body;
+}
+
+async function parseResponse(response: Response) {
+  const contentType = response.headers.get("content-type") ?? "";
+  if (contentType.includes("application/json")) {
+    return response.json();
+  }
+  return response.text();
+}
+
+async function executeApolloEnrich(
+  gatewayUrl: string,
+  apiKey: string,
+  _toolCallId: string,
+  params: Record<string, unknown>,
+) {
+  const action = params.action;
+  if (action !== "people" && action !== "company" && action !== "people_search") {
+    return jsonResult({
+      error: `Unknown action "${String(action)}". Use "people", "company", or "people_search".`,
+    });
+  }
+
+  try {
+    let response: Response;
+
+    if (action === "people") {
+      const body = buildPeopleBody(params);
+      if (!body.email && !body.linkedinUrl && !body.firstName && !body.lastName) {
+        return jsonResult({
+          error:
+            "People enrichment requires at least an email, LinkedIn URL, or person name.",
+        });
+      }
+      response = await fetch(`${gatewayUrl}${ENRICHMENT_BASE_PATH}/people`, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify(body),
+      });
+    } else if (action === "company") {
+      const domain = readTrimmedString(params.domain);
+      if (!domain) {
+        return jsonResult({ error: "Company enrichment requires a domain." });
+      }
+      const url = new URL(`${gatewayUrl}${ENRICHMENT_BASE_PATH}/company`);
+      url.searchParams.set("domain", domain);
+      response = await fetch(url, {
+        method: "GET",
+        headers: {
+          authorization: `Bearer ${apiKey}`,
+        },
+      });
+    } else {
+      const body = buildPeopleSearchBody(params);
+      response = await fetch(`${gatewayUrl}${ENRICHMENT_BASE_PATH}/people/search`, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify(body),
+      });
+    }
+
+    if (!response.ok) {
+      const detail = await parseResponse(response).catch(() => "");
+      return jsonResult({
+        error: `Enrichment request failed (HTTP ${response.status}).`,
+        detail: detail || undefined,
+      });
+    }
+
+    return jsonResult(await parseResponse(response));
+  } catch (err) {
+    return jsonResult({
+      error: "Enrichment request failed.",
+      detail: err instanceof Error ? err.message : String(err),
+    });
+  }
+}
+
+export default function register(api: OpenClawPluginApi) {
+  const rootConfig = asRecord(api.config);
+  const pluginEntries = asRecord(asRecord(rootConfig?.plugins)?.entries);
+  const pluginConfig = asRecord(asRecord(pluginEntries?.[id])?.config);
+  if (pluginConfig?.enabled === false) {
+    return;
+  }
+
+  const gatewayUrl = resolveGatewayUrl(api.config);
+  const apiKey = resolveApiKey(api.config);
+
+  if (!apiKey) {
+    api.logger?.info?.(
+      "[apollo-enrichment] No Dench Cloud API key found; tool will not be registered.",
+    );
+    return;
+  }
+
+  api.registerTool({
+    name: "apollo_enrich",
+    label: "Apollo Enrichment",
+    description:
+      "Look up Apollo people, companies, or people search results through the Dench Cloud gateway. " +
+      'Use action "people" for an individual profile, "company" for company enrichment by domain, ' +
+      'or "people_search" to search people with filters such as titles, locations, and company domains.',
+    parameters: ApolloEnrichParameters,
+    execute: (toolCallId: string, params: Record<string, unknown>) =>
+      executeApolloEnrich(gatewayUrl, apiKey, toolCallId, params),
+  } as AnyAgentTool);
+}