From 3de7768b115d892a27ab83893f24152f909099ff Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Mon, 2 Mar 2026 20:18:53 +0000
Subject: [PATCH] perf(routing): cache normalized agent-id lookups

---
 src/routing/resolve-route.ts | 46 ++++++++++++++++++++++++++++++------
 1 file changed, 39 insertions(+), 7 deletions(-)

diff --git a/src/routing/resolve-route.ts b/src/routing/resolve-route.ts
index 736727e2e75..1d6c8a93772 100644
--- a/src/routing/resolve-route.ts
+++ b/src/routing/resolve-route.ts
@@ -111,21 +111,53 @@ function listAgents(cfg: OpenClawConfig) {
   return Array.isArray(agents) ? agents : [];
 }
 
+type AgentLookupCache = {
+  agentsRef: OpenClawConfig["agents"] | undefined;
+  byNormalizedId: Map<string, string>;
+  fallbackDefaultAgentId: string;
+};
+
+const agentLookupCacheByCfg = new WeakMap<OpenClawConfig, AgentLookupCache>();
+
+function resolveAgentLookupCache(cfg: OpenClawConfig): AgentLookupCache {
+  const agentsRef = cfg.agents;
+  const existing = agentLookupCacheByCfg.get(cfg);
+  if (existing && existing.agentsRef === agentsRef) {
+    return existing;
+  }
+
+  const byNormalizedId = new Map<string, string>();
+  for (const agent of listAgents(cfg)) {
+    const rawId = agent.id?.trim();
+    if (!rawId) {
+      continue;
+    }
+    byNormalizedId.set(normalizeAgentId(rawId), sanitizeAgentId(rawId));
+  }
+  const next: AgentLookupCache = {
+    agentsRef,
+    byNormalizedId,
+    fallbackDefaultAgentId: sanitizeAgentId(resolveDefaultAgentId(cfg)),
+  };
+  agentLookupCacheByCfg.set(cfg, next);
+  return next;
+}
+
 function pickFirstExistingAgentId(cfg: OpenClawConfig, agentId: string): string {
+  const lookup = resolveAgentLookupCache(cfg);
   const trimmed = (agentId ?? "").trim();
   if (!trimmed) {
-    return sanitizeAgentId(resolveDefaultAgentId(cfg));
+    return lookup.fallbackDefaultAgentId;
   }
   const normalized = normalizeAgentId(trimmed);
-  const agents = listAgents(cfg);
-  if (agents.length === 0) {
+  if (lookup.byNormalizedId.size === 0) {
     return sanitizeAgentId(trimmed);
   }
-  const match = agents.find((agent) => normalizeAgentId(agent.id) === normalized);
-  if (match?.id?.trim()) {
-    return sanitizeAgentId(match.id.trim());
+  const resolved = lookup.byNormalizedId.get(normalized);
+  if (resolved) {
+    return resolved;
   }
-  return sanitizeAgentId(resolveDefaultAgentId(cfg));
+  return lookup.fallbackDefaultAgentId;
 }
 
 function matchesChannel(