import { isLoopbackUrl, resolveClientSecret } from "../secret-store.js"; const OPTION_PREFIX = "CLAUDE_PLUGIN_OPTION_"; const DEFAULT_URL = "http://localhost:3111"; export interface HookEndpoint { url: string; secret: string; blocked: boolean; } function filled(value: string | undefined): string | undefined { const trimmed = value?.trim(); if (!trimmed || (trimmed.startsWith("${") && trimmed.endsWith("}"))) return undefined; return value; } export function hookSetting( name: string, env: NodeJS.ProcessEnv = process.env, ): string | undefined { const optionKey = `${OPTION_PREFIX}${name}`; const option = filled(env[optionKey])?.trim(); if (option) return option; if (name === "AGENTMEMORY_SECRET" && optionKey in env) return undefined; return filled(env[name]); } export function resolveSettingSecret(url: string, env: NodeJS.ProcessEnv = process.env): string { const secretEnv: NodeJS.ProcessEnv = { ...env }; const explicit = hookSetting("AGENTMEMORY_SECRET", env); if (explicit === undefined) delete secretEnv["AGENTMEMORY_SECRET"]; else secretEnv["AGENTMEMORY_SECRET"] = explicit; return resolveClientSecret(url, secretEnv); } export function secretTransportAllowed(url: string): boolean { try { return new URL(url).protocol === "https:" || isLoopbackUrl(url); } catch { return false; } } export function resolveHookEndpoint(env: NodeJS.ProcessEnv = process.env): HookEndpoint { const url = hookSetting("AGENTMEMORY_URL", env) || DEFAULT_URL; const secret = resolveSettingSecret(url, env); const blocked = !secretTransportAllowed(url); return { url, secret: blocked ? "" : secret, blocked }; } let blockedNoticeShown = false; export function reportBlockedTransport(endpoint: HookEndpoint): boolean { if (!endpoint.blocked) return false; if (!blockedNoticeShown) { blockedNoticeShown = true; process.stderr.write( "[agentmemory] AGENTMEMORY_URL must use HTTPS unless it is a loopback address. Nothing was sent.\n", ); } return true; } export function hookAuthHeaders(endpoint: HookEndpoint): Record { const h: Record = { "Content-Type": "application/json" }; if (endpoint.secret) h["Authorization"] = `Bearer ${endpoint.secret}`; return h; }