@rynfar/meridian 1.48.1 → 1.49.1

package/README.md

@@ -99,6 +99,8 @@ Then in `~/.config/opencode/opencode.json`:
 
 > **Important:** Do not use `meridian setup` on NixOS. It writes an absolute Nix store path (e.g. `/nix/store/...-meridian-1.x.x/lib/...`) into your OpenCode config, which will break on the next `nixos-rebuild switch` or `home-manager switch` when the store path changes. Use one of the approaches above instead.
 
+> **Note:** The bundled Claude Code binary (`claude.exe`) is patched with `autoPatchelfHook` at build time, so it runs on NixOS out of the box. If you previously enabled `programs.nix-ld.enable = true` as a workaround for `Could not start dynamically linked executable` (#501), that is no longer required for Meridian.
+
 **Home Manager service** -- run Meridian as a user systemd service:
 
 ```nix
@@ -163,7 +165,8 @@ The Claude Code SDK provides programmatic access to Claude. But your favorite co
 - **Auto token refresh** — expired OAuth tokens are refreshed automatically; requests continue without interruption
 - **Passthrough mode** — forward tool calls to the client instead of executing internally
 - **Multimodal** — images, documents, file attachments, and multimodal tool results pass through to Claude
-- **Multi-profile** — switch between Claude accounts instantly, no restart needed
+- **Multi-profile** — switch between Claude accounts instantly, no restart needed; opt-in [sticky session routing](#sticky-session-routing) distributes sessions across accounts while keeping per-account prompt caches warm
+- **Adapter instances** — run several configurations of the same adapter side by side (per-instance thinking, system prompt, passthrough) selected by header or match rules — see [Adapter instances](#adapter-instances)
 - **Telemetry dashboard** — real-time performance metrics at `/telemetry`, including token usage and prompt cache efficiency ([`MONITORING.md`](MONITORING.md))
 - **Telemetry persistence** — opt-in SQLite storage for telemetry data that survives proxy restarts, with configurable retention
 - **Prometheus metrics** — `GET /metrics` endpoint for scraping request counters and duration histograms
@@ -288,6 +291,22 @@ curl -H "x-meridian-profile: work" ...
 
 You can also switch profiles from the web UI at `http://127.0.0.1:3456/profiles` — a dropdown appears in the nav bar on all pages when profiles are configured.
 
+### Sticky session routing
+
+With multiple profiles (e.g. two Claude Max subscriptions), Meridian can distribute sessions across profiles automatically while preserving **session affinity** — Anthropic's prompt caching is per-account, so a session must stay on one account to keep its ~99% cache hit rate:
+
+```bash
+MERIDIAN_ROUTING=sticky meridian     # or set "routing": "sticky" in ~/.config/meridian/settings.json
+```
+
+- Each session is assigned to a profile by rendezvous hashing of its session id — **deterministic and stateless**, so assignments survive proxy restarts with no state to lose
+- Adding/removing a profile only reassigns the sessions belonging to the changed arm — everything else keeps its warm cache
+- A session's subagent/fork requests share its assignment (same session id → same account)
+- The `x-meridian-profile` header still overrides everything, per request
+- Default is `active` (all traffic to the active profile — the pre-existing behavior); sticky is opt-in
+
+Request logs show the assignment (`profile=work(sticky)`), and `GET /profiles/list` reports the current `routing` mode.
+
 ### Profile commands
 
 | Command | Description |
@@ -331,6 +350,11 @@ Profile shapes:
 
 When `MERIDIAN_PROFILES` is set, it takes precedence over disk-configured profiles. When unset, Meridian auto-discovers profiles from `~/.config/meridian/profiles.json` on each request.
 
+Related environment variables:
+
+- `MERIDIAN_ROUTING=sticky` — enable [sticky session routing](#sticky-session-routing) across profiles (default `active`)
+- `MERIDIAN_ADAPTER_INSTANCES='{...}'` — define [adapter instances](#adapter-instances) inline instead of via `~/.config/meridian/adapter-instances.json`
+
 ## Agent Setup
 
 ### OpenCode
@@ -580,6 +604,27 @@ Requests flow through the Claude Code adapter which:
 - Leaves the SDK subprocess cwd on the proxy host (Claude Code's local paths don't exist there).
 - Runs in passthrough mode by default — Claude Code executes its own tools on the machine it runs on; Meridian just forwards tool_use blocks.
 
+### Adapter instances
+
+Run several configurations of the same adapter side by side — e.g. a passthrough variant with thinking enabled and one without, or a dedicated config for a specific client. Define instances in `~/.config/meridian/adapter-instances.json` (or the `MERIDIAN_ADAPTER_INSTANCES` env var as a JSON string):
+
+```jsonc
+{
+  "oc-thinky":  { "base": "opencode", "features": { "thinking": "enabled" } },
+  "lite-plain": { "base": "passthrough", "passthrough": true,
+                  "match": { "userAgentPrefix": "litellm/" } },
+  "team-webui": { "base": "opencode", "features": { "codeSystemPrompt": false },
+                  "match": { "header": { "x-team": "alpha" } } }
+}
+```
+
+- **`base`** — which built-in adapter provides the behavior (tool handling, session tracking, transforms). Existing plugins and transforms scoped to the base adapter apply to its instances automatically.
+- **`features`** — per-instance overrides of the [SDK feature toggles](#sdk-feature-toggles-experimental) (thinking, system prompts, memory, ...) layered over the base's settings. Same keys as the settings UI.
+- **`passthrough`** — per-instance passthrough mode, overriding the adapter default and `MERIDIAN_PASSTHROUGH`.
+- **`match`** — optional automatic selection: exact header values and/or a User-Agent prefix. Match rules outrank built-in User-Agent detection (that's their purpose). Without `match`, select the instance per request with `x-meridian-agent: <instance-name>`.
+
+Built-in adapter names are reserved and can't be shadowed. With no instances configured, detection is exactly the built-in chain. Config file changes apply within ~5s, no restart needed.
+
 ### Any Anthropic-compatible tool
 
 ```bash

package/dist/{cli-cx463q74.js → cli-f0yqy2d2.js}

@@ -7,6 +7,32 @@ import {
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
+
+// src/proxy/routing.ts
+import { createHash } from "node:crypto";
+function getRoutingMode(raw) {
+  return raw?.toLowerCase() === "sticky" ? "sticky" : "active";
+}
+function rendezvousScore(sessionKey, profileId) {
+  const digest = createHash("sha256").update(`${sessionKey}\x00${profileId}`).digest();
+  return digest.readBigUInt64BE(0);
+}
+function pickStickyProfile(sessionKey, profileIds) {
+  if (!sessionKey || profileIds.length === 0)
+    return;
+  let best;
+  let bestScore = -1n;
+  for (const id of profileIds) {
+    const score = rendezvousScore(sessionKey, id);
+    if (score > bestScore) {
+      bestScore = score;
+      best = id;
+    }
+  }
+  return best;
+}
+
+// src/proxy/profiles.ts
 var CONFIG_FILE = join(homedir(), ".config", "meridian", "profiles.json");
 var DISK_CACHE_TTL_MS = 5000;
 var diskProfilesCache = [];
@@ -72,12 +98,13 @@ function getEffectiveProfiles(configProfiles) {
 function hasProfiles(configProfiles) {
   return getEffectiveProfiles(configProfiles).length > 0;
 }
-function resolveProfile(profiles, defaultProfile, requestedId) {
+function resolveProfile(profiles, defaultProfile, requestedId, options) {
   const effective = getEffectiveProfiles(profiles);
   if (effective.length === 0) {
     return { id: DEFAULT_PROFILE_ID, type: "claude-max", env: {} };
   }
-  const resolvedId = requestedId || activeProfileId || defaultProfile || effective[0].id;
+  const stickyId = options?.routingMode === "sticky" && options.stickySessionKey ? pickStickyProfile(options.stickySessionKey, effective.map((p) => p.id)) : undefined;
+  const resolvedId = requestedId || stickyId || activeProfileId || defaultProfile || effective[0].id;
   const profile = effective.find((p) => p.id === resolvedId);
   if (!profile) {
     console.warn(`[meridian] Unknown profile "${resolvedId}". Using first configured profile.`);
@@ -120,4 +147,4 @@ function listProfiles(profiles, defaultProfile) {
   }));
 }
 
-export { loadProfilesFromDisk, setActiveProfile, getActiveProfileId, resetActiveProfile, restoreActiveProfile, enableDiskProfileDiscovery, getEffectiveProfiles, hasProfiles, resolveProfile, listProfiles };
+export { getRoutingMode, loadProfilesFromDisk, setActiveProfile, getActiveProfileId, resetActiveProfile, restoreActiveProfile, enableDiskProfileDiscovery, getEffectiveProfiles, hasProfiles, resolveProfile, listProfiles };

package/dist/{cli-vhrprwj4.js → cli-mjrt119g.js}

@@ -1,11 +1,12 @@
 import {
   getActiveProfileId,
   getEffectiveProfiles,
+  getRoutingMode,
   listProfiles,
   resolveProfile,
   restoreActiveProfile,
   setActiveProfile
-} from "./cli-cx463q74.js";
+} from "./cli-f0yqy2d2.js";
 import {
   isTrackedPlugin,
   recordError,
@@ -36,6 +37,9 @@ import {
   resolveSdkModelDefaults,
   stripExtendedContext
 } from "./cli-q6dz9r5p.js";
+import {
+  getSetting
+} from "./cli-340h1chz.js";
 import {
   checkPluginConfigured
 } from "./cli-je60fevk.js";
@@ -1198,14 +1202,14 @@ __export(exports_sdkFeatures, {
   getExplicitThinking: () => getExplicitThinking,
   getAllFeatureConfigs: () => getAllFeatureConfigs
 });
-import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync2, renameSync as renameSync2 } from "node:fs";
-import { join as join4 } from "node:path";
-import { homedir as homedir3 } from "node:os";
+import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync5, writeFileSync as writeFileSync2, renameSync as renameSync2 } from "node:fs";
+import { join as join5 } from "node:path";
+import { homedir as homedir4 } from "node:os";
 function getConfigPath() {
-  const dir = join4(homedir3(), ".config", "meridian");
-  if (!existsSync5(dir))
+  const dir = join5(homedir4(), ".config", "meridian");
+  if (!existsSync6(dir))
     mkdirSync2(dir, { recursive: true });
-  return join4(dir, "sdk-features.json");
+  return join5(dir, "sdk-features.json");
 }
 function readConfig() {
   const now = Date.now();
@@ -1213,8 +1217,8 @@ function readConfig() {
     return cachedConfig;
   const path3 = getConfigPath();
   try {
-    if (existsSync5(path3)) {
-      cachedConfig = JSON.parse(readFileSync4(path3, "utf-8"));
+    if (existsSync6(path3)) {
+      cachedConfig = JSON.parse(readFileSync5(path3, "utf-8"));
     } else {
       cachedConfig = {};
     }
@@ -3738,8 +3742,8 @@ var serve = (options, listeningListener) => {
 };
 
 // src/proxy/server.ts
-import { homedir as homedir4 } from "node:os";
-import { join as join5 } from "node:path";
+import { homedir as homedir5 } from "node:os";
+import { join as join6 } from "node:path";
 import { query } from "@anthropic-ai/claude-agent-sdk";
 
 // src/proxy/rateLimitStore.ts
@@ -11249,6 +11253,87 @@ var cherryAdapter = {
   }
 };
 
+// src/proxy/adapterInstances.ts
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "node:fs";
+import { join as join2 } from "node:path";
+import { homedir as homedir2 } from "node:os";
+var CONFIG_FILE = join2(homedir2(), ".config", "meridian", "adapter-instances.json");
+function parseAdapterInstances(raw2) {
+  if (!raw2)
+    return {};
+  let parsed;
+  try {
+    parsed = JSON.parse(raw2);
+  } catch {
+    console.warn("[meridian] adapter-instances config is not valid JSON — ignoring");
+    return {};
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+    return {};
+  const out = {};
+  for (const [name, value] of Object.entries(parsed)) {
+    const v = value;
+    if (!v || typeof v !== "object" || typeof v.base !== "string" || v.base.length === 0) {
+      console.warn(`[meridian] adapter instance "${name}" has no valid "base" — ignoring`);
+      continue;
+    }
+    if (v.features !== undefined && (typeof v.features !== "object" || v.features === null || Array.isArray(v.features))) {
+      console.warn(`[meridian] adapter instance "${name}" has invalid "features" — ignoring`);
+      continue;
+    }
+    if (v.match !== undefined && (typeof v.match !== "object" || v.match === null || Array.isArray(v.match))) {
+      console.warn(`[meridian] adapter instance "${name}" has invalid "match" — ignoring`);
+      continue;
+    }
+    out[name] = {
+      base: v.base,
+      ...v.features ? { features: v.features } : {},
+      ...typeof v.passthrough === "boolean" ? { passthrough: v.passthrough } : {},
+      ...v.match ? { match: v.match } : {}
+    };
+  }
+  return out;
+}
+var DISK_CACHE_TTL_MS = 5000;
+var diskCache = {};
+var diskCacheAt = 0;
+function loadAdapterInstances() {
+  const fromEnv = process.env.MERIDIAN_ADAPTER_INSTANCES;
+  if (fromEnv)
+    return parseAdapterInstances(fromEnv);
+  if (diskCacheAt > 0 && Date.now() - diskCacheAt < DISK_CACHE_TTL_MS)
+    return diskCache;
+  try {
+    diskCache = existsSync3(CONFIG_FILE) ? parseAdapterInstances(readFileSync2(CONFIG_FILE, "utf-8")) : {};
+  } catch (err) {
+    console.warn(`[meridian] Failed to read ${CONFIG_FILE}: ${err instanceof Error ? err.message : err}`);
+    diskCache = {};
+  }
+  diskCacheAt = Date.now();
+  return diskCache;
+}
+function matchesInstance(def, getHeader) {
+  const match2 = def.match;
+  if (!match2)
+    return false;
+  const hasHeaderRules = match2.header !== undefined && Object.keys(match2.header).length > 0;
+  const hasUaRule = typeof match2.userAgentPrefix === "string" && match2.userAgentPrefix.length > 0;
+  if (!hasHeaderRules && !hasUaRule)
+    return false;
+  if (hasHeaderRules) {
+    for (const [name, want] of Object.entries(match2.header)) {
+      if (getHeader(name.toLowerCase()) !== want)
+        return false;
+    }
+  }
+  if (hasUaRule) {
+    const ua = getHeader("user-agent") ?? "";
+    if (!ua.startsWith(match2.userAgentPrefix))
+      return false;
+  }
+  return true;
+}
+
 // src/proxy/adapters/detect.ts
 var ADAPTER_MAP = {
   opencode: openCodeAdapter,
@@ -11274,11 +11359,41 @@ function isLiteLLMRequest(c) {
   const headers = c.req.header();
   return Object.keys(headers).some((k) => k.toLowerCase().startsWith("x-litellm-"));
 }
+function makeInstanceAdapter(name, def) {
+  const base = ADAPTER_MAP[def.base.toLowerCase()];
+  if (!base) {
+    console.warn(`[meridian] adapter instance "${name}" references unknown base "${def.base}" — ignoring`);
+    return;
+  }
+  return {
+    ...base,
+    name,
+    baseName: base.name,
+    ...def.features ? { instanceFeatures: def.features } : {},
+    ...def.passthrough !== undefined ? { instancePassthrough: def.passthrough } : {}
+  };
+}
 function detectAdapter(c) {
   const agentOverride = c.req.header("x-meridian-agent")?.toLowerCase();
   if (agentOverride && ADAPTER_MAP[agentOverride]) {
     return ADAPTER_MAP[agentOverride];
   }
+  const instances = loadAdapterInstances();
+  const instanceNames = Object.keys(instances);
+  if (instanceNames.length > 0) {
+    if (agentOverride && instances[agentOverride]) {
+      const inst = makeInstanceAdapter(agentOverride, instances[agentOverride]);
+      if (inst)
+        return inst;
+    }
+    for (const name of instanceNames) {
+      if (matchesInstance(instances[name], (h) => c.req.header(h))) {
+        const inst = makeInstanceAdapter(name, instances[name]);
+        if (inst)
+          return inst;
+      }
+    }
+  }
   if (c.req.header("x-opencode-session") || c.req.header("x-session-affinity")) {
     return openCodeAdapter;
   }
@@ -17219,8 +17334,8 @@ function getAdapterTransforms(adapterName) {
 }
 
 // src/proxy/plugins/loader.ts
-import { readdirSync as readdirSync2, readFileSync as readFileSync2, existsSync as existsSync3 } from "fs";
-import { join as join2, isAbsolute as isAbsolute2, extname } from "path";
+import { readdirSync as readdirSync2, readFileSync as readFileSync3, existsSync as existsSync4 } from "fs";
+import { join as join3, isAbsolute as isAbsolute2, extname } from "path";
 import { pathToFileURL } from "url";
 
 // src/proxy/plugins/validation.ts
@@ -17261,10 +17376,10 @@ function validateTransform(exported) {
 // src/proxy/plugins/loader.ts
 var loadCounter = 0;
 function parsePluginConfig(configPath) {
-  if (!existsSync3(configPath))
+  if (!existsSync4(configPath))
     return [];
   try {
-    const raw2 = readFileSync2(configPath, "utf-8");
+    const raw2 = readFileSync3(configPath, "utf-8");
     const parsed = JSON.parse(raw2);
     return Array.isArray(parsed.plugins) ? parsed.plugins : [];
   } catch {
@@ -17274,7 +17389,7 @@ function parsePluginConfig(configPath) {
 async function loadPlugins(pluginDir, configPath) {
   resetAllPluginStats();
   const config = configPath ? parsePluginConfig(configPath) : [];
-  const pluginDirExists = existsSync3(pluginDir);
+  const pluginDirExists = existsSync4(pluginDir);
   let filenames = [];
   if (pluginDirExists) {
     try {
@@ -17305,7 +17420,7 @@ async function loadPlugins(pluginDir, configPath) {
   const loaded = [];
   const seenNames = new Set;
   for (const { filename, entry } of ordered) {
-    const filePath = isAbsolute2(filename) ? filename : join2(pluginDir, filename);
+    const filePath = isAbsolute2(filename) ? filename : join3(pluginDir, filename);
     if (entry && !entry.enabled) {
       loaded.push({
         name: filename,
@@ -17678,17 +17793,17 @@ function verifyLineage(cached, messages, cacheKey2, cache) {
 // src/proxy/sessionStore.ts
 import {
   closeSync,
-  existsSync as existsSync4,
+  existsSync as existsSync5,
   mkdirSync,
   openSync,
-  readFileSync as readFileSync3,
+  readFileSync as readFileSync4,
   renameSync,
   statSync,
   unlinkSync,
   writeFileSync
 } from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { join as join3 } from "node:path";
+import { homedir as homedir3 } from "node:os";
+import { join as join4 } from "node:path";
 var DEFAULT_MAX_STORED_SESSIONS = 1e4;
 var STALE_LOCK_THRESHOLD_MS = 30000;
 function getMaxStoredSessions() {
@@ -17736,17 +17851,17 @@ var sessionDirOverride = null;
 var skipLocking = false;
 function getStorePath() {
   const dir = sessionDirOverride || process.env.MERIDIAN_SESSION_DIR || process.env.CLAUDE_PROXY_SESSION_DIR || getDefaultCacheDir();
-  if (!existsSync4(dir)) {
+  if (!existsSync5(dir)) {
     mkdirSync(dir, { recursive: true });
   }
-  return join3(dir, "sessions.json");
+  return join4(dir, "sessions.json");
 }
 function getDefaultCacheDir() {
-  const newDir = join3(homedir2(), ".cache", "meridian");
-  const oldDir = join3(homedir2(), ".cache", "opencode-claude-max-proxy");
-  if (existsSync4(newDir))
+  const newDir = join4(homedir3(), ".cache", "meridian");
+  const oldDir = join4(homedir3(), ".cache", "opencode-claude-max-proxy");
+  if (existsSync5(newDir))
     return newDir;
-  if (existsSync4(oldDir)) {
+  if (existsSync5(oldDir)) {
     try {
       const { symlinkSync } = __require("fs");
       symlinkSync(oldDir, newDir);
@@ -17759,10 +17874,10 @@ function getDefaultCacheDir() {
 }
 function readStore() {
   const path3 = getStorePath();
-  if (!existsSync4(path3))
+  if (!existsSync5(path3))
     return {};
   try {
-    const data = readFileSync3(path3, "utf-8");
+    const data = readFileSync4(path3, "utf-8");
     return JSON.parse(data);
   } catch (e) {
     console.error("[sessionStore] read failed:", e.message);
@@ -18225,9 +18340,11 @@ function buildFreshPrompt(messages, sanitizeOpts = {}) {
     }();
   }
   return messages.map((m) => {
-    const role = m.role === "assistant" ? "Assistant" : "Human";
-    const content = m.role === "assistant" ? flattenAssistantContent(m.content) : flattenUserContent(m.content, sanitizeOpts, toolIndex);
-    return content ? `${role}: ${content}` : "";
+    if (m.role === "assistant") {
+      const assistantText = flattenAssistantContent(m.content);
+      return assistantText ? `[Assistant: ${assistantText}]` : "";
+    }
+    return flattenUserContent(m.content, sanitizeOpts, toolIndex);
   }).filter(Boolean).join(`
 
 `) || "";
@@ -18291,8 +18408,8 @@ function createProxyServer(config = {}) {
   const sessionDiscoveredTools = new Map;
   const sessionToolCache = new Map;
   const sessionMcpCache = new LRUMap(getMaxSessionsLimit());
-  const pluginDir = finalConfig.pluginDir ?? join5(homedir4(), ".config", "meridian", "plugins");
-  const pluginConfigPath = finalConfig.pluginConfigPath ?? join5(homedir4(), ".config", "meridian", "plugins.json");
+  const pluginDir = finalConfig.pluginDir ?? join6(homedir5(), ".config", "meridian", "plugins");
+  const pluginConfigPath = finalConfig.pluginConfigPath ?? join6(homedir5(), ".config", "meridian", "plugins.json");
   let loadedPlugins = [];
   let pluginTransforms = [];
   const app = new Hono2;
@@ -18374,7 +18491,8 @@ function createProxyServer(config = {}) {
           return c.json({ type: "error", error: { type: "invalid_request_error", message: parsedOutputFormat.message } }, 400);
         }
         const outputFormat = parsedOutputFormat.value;
-        const profile = resolveProfile(finalConfig.profiles, finalConfig.defaultProfile, c.req.header("x-meridian-profile") || undefined);
+        const routingMode = getRoutingMode(process.env.MERIDIAN_ROUTING ?? getSetting("routing"));
+        const profile = resolveProfile(finalConfig.profiles, finalConfig.defaultProfile, c.req.header("x-meridian-profile") || undefined, routingMode === "sticky" ? { routingMode, stickySessionKey: adapter.getSessionId(c, body) } : undefined);
         const authStatus = await getClaudeAuthStatusAsync(profile.id !== "default" ? profile.id : undefined, Object.keys(profile.env).length > 0 ? profile.env : undefined);
         const agentMode = c.req.header("x-opencode-agent-mode") ?? null;
         const requestSource = c.req.header("x-meridian-source")?.slice(0, 64) || undefined;
@@ -18414,10 +18532,11 @@ function createProxyServer(config = {}) {
 `);
           }
         }
-        const adapterTransforms = getAdapterTransforms(adapter.name);
+        const adapterBase = adapter.baseName ?? adapter.name;
+        const adapterTransforms = getAdapterTransforms(adapterBase);
         const pipeline = buildPipeline(adapterTransforms, pluginTransforms);
         const pipelineCtx = runTransformHook(pipeline, "onRequest", createRequestContext({
-          adapter: adapter.name,
+          adapter: adapterBase,
           body,
           headers: c.req.raw.headers,
           model,
@@ -18426,7 +18545,7 @@ function createProxyServer(config = {}) {
           tools: body.tools,
           stream: body.stream ?? false,
           workingDirectory
-        }), adapter.name);
+        }), adapterBase);
         const stream2 = pipelineCtx.prefersStreaming !== undefined ? pipelineCtx.prefersStreaming : body.stream ?? false;
         const effortHeader = c.req.header("x-opencode-effort");
         const thinkingHeader = c.req.header("x-opencode-thinking");
@@ -18446,8 +18565,8 @@ function createProxyServer(config = {}) {
           }
         }
         const { getFeaturesForAdapter: getFeaturesForAdapter2, getExplicitThinking: getExplicitThinking2 } = (init_sdkFeatures(), __toCommonJS(exports_sdkFeatures));
-        const sdkFeatures = getFeaturesForAdapter2(adapter.name);
-        if (getExplicitThinking2(adapter.name) === "disabled") {
+        const sdkFeatures = { ...getFeaturesForAdapter2(adapterBase), ...adapter.instanceFeatures ?? {} };
+        if ((adapter.instanceFeatures?.thinking ?? getExplicitThinking2(adapterBase)) === "disabled") {
           thinking = { type: "disabled" };
           effort = undefined;
           plog(`[PROXY] ${requestMeta.requestId} thinking disabled (per-adapter setting)`);
@@ -18473,10 +18592,10 @@ function createProxyServer(config = {}) {
         const profileScopedCwd = profile.id !== "default" ? `${clientWorkingDirectory}::profile=${profile.id}` : clientWorkingDirectory;
         const lastMessage = Array.isArray(body.messages) ? body.messages[body.messages.length - 1] : undefined;
         const lastIsToolResult = Array.isArray(lastMessage?.content) && lastMessage.content.some((b) => b?.type === "tool_result");
-        const isClientDrivenLoop = adapter.name !== "claude-code" && !agentSessionId && lastIsToolResult;
+        const isClientDrivenLoop = adapterBase !== "claude-code" && !agentSessionId && lastIsToolResult;
         const isIndependentSession = requestSource?.startsWith("fork-") || requestSource?.startsWith("subagent-") || isClientDrivenLoop || false;
         let lineageResult = isIndependentSession ? { type: "diverged" } : lookupSession(profileSessionId, body.messages || [], profileScopedCwd);
-        if (lineageResult.type === "undo" && adapter.name === "opencode" && !agentSessionId) {
+        if (lineageResult.type === "undo" && adapterBase === "opencode" && !agentSessionId) {
           lineageResult = { type: "diverged" };
         }
         const isResume = lineageResult.type === "continuation" || lineageResult.type === "compaction";
@@ -18491,7 +18610,7 @@ function createProxyServer(config = {}) {
         const lineageType = lineageResult.type === "diverged" && !cachedSession ? "new" : lineageResult.type;
         const msgCount = Array.isArray(body.messages) ? body.messages.length : 0;
         const toolCount = body.tools?.length ?? 0;
-        const requestLogLine = `${requestMeta.requestId} adapter=${adapter.name}${requestSource ? ` source=${requestSource}` : ""} model=${model} stream=${stream2} tools=${toolCount} lineage=${lineageType} session=${resumeSessionId?.slice(0, 8) || "new"}${isUndo && undoRollbackUuid ? ` rollback=${undoRollbackUuid.slice(0, 8)}` : ""}${agentMode ? ` agent=${agentMode}` : ""} active=${activeSessions}/${MAX_CONCURRENT_SESSIONS} msgCount=${msgCount}`;
+        const requestLogLine = `${requestMeta.requestId} adapter=${adapter.name}${requestSource ? ` source=${requestSource}` : ""}${profile.id !== "default" ? ` profile=${profile.id}${routingMode === "sticky" ? "(sticky)" : ""}` : ""} model=${model} stream=${stream2} tools=${toolCount} lineage=${lineageType} session=${resumeSessionId?.slice(0, 8) || "new"}${isUndo && undoRollbackUuid ? ` rollback=${undoRollbackUuid.slice(0, 8)}` : ""}${agentMode ? ` agent=${agentMode}` : ""} active=${activeSessions}/${MAX_CONCURRENT_SESSIONS} msgCount=${msgCount}`;
         plog(`[PROXY] ${requestLogLine} msgs=${msgSummary}`);
         diagnosticLog2.session(`${requestLogLine}`, requestMeta.requestId);
         if (lineageResult.type === "diverged" && profileSessionId && !isIndependentSession) {
@@ -18578,18 +18697,23 @@ function createProxyServer(config = {}) {
         } else {
           const toolIndex = buildToolUseIndex(allMessages ?? messagesToConvert ?? []);
           textPrompt = messagesToConvert?.map((m) => {
-            const role = m.role === "assistant" ? "Assistant" : "Human";
-            const content = m.role === "assistant" ? flattenAssistantContent(m.content) : flattenUserContent(m.content, sanitizeOpts, toolIndex);
-            return content ? `${role}: ${content}` : "";
+            if (m.role === "assistant") {
+              if (isResume)
+                return "";
+              const assistantText = flattenAssistantContent(m.content);
+              return assistantText ? `[Assistant: ${assistantText}]` : "";
+            }
+            return flattenUserContent(m.content, sanitizeOpts, toolIndex);
           }).filter(Boolean).join(`
 
 `) || "";
         }
-        const passthrough = pipelineCtx.passthrough !== undefined ? pipelineCtx.passthrough : envBool("PASSTHROUGH");
+        const passthrough = adapter.instancePassthrough !== undefined ? adapter.instancePassthrough : pipelineCtx.passthrough !== undefined ? pipelineCtx.passthrough : envBool("PASSTHROUGH");
         const settingSources = envBool("LOAD_CONTEXT") || sdkFeatures.claudeMd === "full" ? ["user", "project"] : sdkFeatures.claudeMd === "project" ? ["project"] : pipelineCtx.settingSources ?? [];
         const capturedToolUses = [];
         const capturedSignatures = new Set;
         const capturedToolNames = new Set;
+        const droppedToolUseIds = new Set;
         let sawDuplicateToolUse = false;
         const earlyStopEnabled = passthrough && process.env.MERIDIAN_PASSTHROUGH_EARLY_STOP !== "0";
         const earlyStop = createEarlyStopTracker();
@@ -18657,11 +18781,13 @@ function createProxyServer(config = {}) {
               }
               const signature = toolUseSignature(toolName, toolInput);
               const isExactDuplicate = capturedSignatures.has(signature);
-              const isSameToolRepeat = !isExactDuplicate && capturedToolNames.has(toolName);
+              const isSameToolRepeat = !earlyStopEnabled && !isExactDuplicate && capturedToolNames.has(toolName);
               const exceedsForcedSingle = forceSingleToolUse && capturedToolUses.length >= 1;
               if (isExactDuplicate) {
+                droppedToolUseIds.add(input.tool_use_id);
                 claudeLog("passthrough.duplicate_tool_use_dropped", { name: toolName });
               } else if (isSameToolRepeat || exceedsForcedSingle) {
+                droppedToolUseIds.add(input.tool_use_id);
                 sawDuplicateToolUse = true;
                 claudeLog("passthrough.extra_tool_use_dropped", {
                   name: toolName,
@@ -19091,6 +19217,14 @@ Subprocess stderr: ${stderrOutput}`;
             });
           }
           if (passthrough && capturedToolUses.length > 0) {
+            if (droppedToolUseIds.size > 0) {
+              for (let i = contentBlocks.length - 1;i >= 0; i--) {
+                const b = contentBlocks[i];
+                if (b.type === "tool_use" && droppedToolUseIds.has(b.id)) {
+                  contentBlocks.splice(i, 1);
+                }
+              }
+            }
             const capturedById = new Map(capturedToolUses.map((tu) => [tu.id, tu]));
             for (const block of contentBlocks) {
               if (block.type === "tool_use" && capturedById.has(block.id)) {
@@ -20320,7 +20454,8 @@ data: ${JSON.stringify({
     }));
     return c.json({
       profiles: enriched,
-      activeProfile: getActiveProfileId() || finalConfig.defaultProfile || profiles[0]?.id || "default"
+      activeProfile: getActiveProfileId() || finalConfig.defaultProfile || profiles[0]?.id || "default",
+      routing: getRoutingMode(process.env.MERIDIAN_ROUTING ?? getSetting("routing"))
     });
   });
   app.get("/profiles", async (c) => {

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   startProxyServer
-} from "./cli-vhrprwj4.js";
-import"./cli-cx463q74.js";
+} from "./cli-mjrt119g.js";
+import"./cli-f0yqy2d2.js";
 import"./cli-sry5aqdj.js";
 import"./cli-4rqtm83g.js";
 import {
@@ -167,7 +167,7 @@ async function runCli(start = startProxyServer, runAuthCheck = async () => {
     console.error("\x1B[33m⚠ Could not verify Claude auth status. If requests fail, run: claude login\x1B[0m");
   }
   if (!profiles) {
-    const { enableDiskProfileDiscovery } = await import("./profiles-rdd84b45.js");
+    const { enableDiskProfileDiscovery } = await import("./profiles-84hnbd6c.js");
     enableDiskProfileDiscovery();
   }
   const proxy = await start({ port, host, idleTimeoutSeconds, profiles, defaultProfile, version, installProcessErrorHandlers: true });

package/dist/{profiles-rdd84b45.js → profiles-84hnbd6c.js}

@@ -9,7 +9,7 @@ import {
   resolveProfile,
   restoreActiveProfile,
   setActiveProfile
-} from "./cli-cx463q74.js";
+} from "./cli-f0yqy2d2.js";
 import"./cli-340h1chz.js";
 import"./cli-p9swy5t3.js";
 export {

package/dist/proxy/adapter.d.ts

@@ -67,6 +67,18 @@ export interface AgentIdentity {
  * how to interact with the calling agent.
  */
 export interface AgentAdapter extends AgentIdentity {
+    /**
+     * For adapter INSTANCES (#476): the base adapter's name. Behavior keyed by
+     * adapter name — transforms, plugin scoping, agent-specific branches —
+     * must resolve via `baseName ?? name` so existing transforms/plugins keep
+     * applying to instances. Features resolve by instance definition instead.
+     * Undefined for built-in adapters.
+     */
+    readonly baseName?: string;
+    /** Instance feature overrides, layered over the base's resolved features. */
+    readonly instanceFeatures?: Partial<import("./sdkFeatures").AdapterFeatures>;
+    /** Instance passthrough override — beats the adapter transform's default. */
+    readonly instancePassthrough?: boolean;
     /**
      * SDK built-in tools to block (replaced by MCP equivalents).
      * These are tools where the agent provides its own implementation.

package/dist/proxy/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/proxy/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAEnE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;IAE5D;;;;;;;;;;;;;;;;OAgBG;IACH,uBAAuB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAAA;IAEtD;;;;;;;;;;;OAWG;IACH,6BAA6B,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAAA;IAE7D;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAAA;IAEtC;;;OAGG;IACH,gBAAgB,IAAI,MAAM,CAAA;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD;;;OAGG;IACH,sBAAsB,IAAI,SAAS,MAAM,EAAE,CAAA;IAE3C;;;;OAIG;IACH,yBAAyB,IAAI,SAAS,MAAM,EAAE,CAAA;IAE9C;;OAEG;IACH,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAAA;IAEvC;;;;OAIG;IACH,cAAc,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAEhF;;;OAGG;IACH,aAAa,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAA;IAE9D;;;OAGG;IACH,0BAA0B,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAA;IAE9E;;;;;;OAMG;IACH,gBAAgB,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAA;IAErC;;;;;;;;OAQG;IACH,eAAe,CAAC,IAAI,OAAO,CAAA;IAE3B;;;;;;;OAOG;IACH,gBAAgB,CAAC,IAAI,SAAS,MAAM,EAAE,CAAA;IAEtC;;;;;;;;;;;;;;OAcG;IACH,iBAAiB,CAAC,IAAI,aAAa,EAAE,CAAA;IAErC;;;;;;;OAOG;IACH,gBAAgB,CAAC,IAAI,OAAO,CAAA;IAE5B;;;;;;OAMG;IACH,sBAAsB,CAAC,IAAI,OAAO,CAAA;IAElC;;;;;;;;OAQG;IACH,yBAAyB,CAAC,IAAI,OAAO,CAAA;IAErC;;;;;;;;;;;;;;;OAeG;IACH,6BAA6B,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,eAAe,EAAE,UAAU,EAAE,CAAA;CAC3G"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/proxy/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAEnE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;IAE5D;;;;;;;;;;;;;;;;OAgBG;IACH,uBAAuB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAAA;IAEtD;;;;;;;;;;;OAWG;IACH,6BAA6B,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAAA;IAE7D;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAAA;IAEtC;;;OAGG;IACH,gBAAgB,IAAI,MAAM,CAAA;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAE1B,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC,OAAO,eAAe,EAAE,eAAe,CAAC,CAAA;IAE5E,6EAA6E;IAC7E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAEtC;;;OAGG;IACH,sBAAsB,IAAI,SAAS,MAAM,EAAE,CAAA;IAE3C;;;;OAIG;IACH,yBAAyB,IAAI,SAAS,MAAM,EAAE,CAAA;IAE9C;;OAEG;IACH,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAAA;IAEvC;;;;OAIG;IACH,cAAc,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAEhF;;;OAGG;IACH,aAAa,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAA;IAE9D;;;OAGG;IACH,0BAA0B,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAA;IAE9E;;;;;;OAMG;IACH,gBAAgB,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAA;IAErC;;;;;;;;OAQG;IACH,eAAe,CAAC,IAAI,OAAO,CAAA;IAE3B;;;;;;;OAOG;IACH,gBAAgB,CAAC,IAAI,SAAS,MAAM,EAAE,CAAA;IAEtC;;;;;;;;;;;;;;OAcG;IACH,iBAAiB,CAAC,IAAI,aAAa,EAAE,CAAA;IAErC;;;;;;;OAOG;IACH,gBAAgB,CAAC,IAAI,OAAO,CAAA;IAE5B;;;;;;OAMG;IACH,sBAAsB,CAAC,IAAI,OAAO,CAAA;IAElC;;;;;;;;OAQG;IACH,yBAAyB,CAAC,IAAI,OAAO,CAAA;IAErC;;;;;;;;;;;;;;;OAeG;IACH,6BAA6B,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,eAAe,EAAE,UAAU,EAAE,CAAA;CAC3G"}

package/dist/proxy/adapterInstances.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Adapter instances (#476, proposed by @Serpentiel).
+ *
+ * An instance is a named configuration of a base adapter:
+ *
+ *   {
+ *     "oc-thinky":  { "base": "opencode",    "features": { "thinking": "enabled" } },
+ *     "lite-plain": { "base": "passthrough", "passthrough": true,
+ *                     "match": { "userAgentPrefix": "litellm/" } }
+ *   }
+ *
+ * Selected explicitly via `x-meridian-agent: <instance-name>`, or
+ * automatically via match rules (exact header values and/or a User-Agent
+ * prefix). Instances resolve BEHAVIOR (transforms, plugin scoping, session
+ * handling) by their base adapter's name and FEATURES by their own
+ * definition — see detect.ts and server.ts for the resolution invariant.
+ *
+ * Config sources (first wins):
+ *   1. MERIDIAN_ADAPTER_INSTANCES env var (JSON string)
+ *   2. ~/.config/meridian/adapter-instances.json (5s TTL cache)
+ *
+ * With no instances configured, adapter detection is byte-identical to the
+ * built-in chain. Built-in adapter names cannot be shadowed.
+ *
+ * This is a leaf module — no imports from server.ts, adapters, or session/.
+ */
+import type { AdapterFeatures } from "./sdkFeatures";
+export interface AdapterInstanceMatch {
+    /** Exact header values — ALL listed headers must match (case-insensitive names). */
+    header?: Record<string, string>;
+    /** User-Agent prefix match. */
+    userAgentPrefix?: string;
+}
+export interface AdapterInstanceDef {
+    /** Base adapter name (opencode, passthrough, crush, ...). Behavior comes from here. */
+    base: string;
+    /** Per-instance feature overrides, layered over the base's resolved features. */
+    features?: Partial<AdapterFeatures>;
+    /** Per-instance passthrough override — beats the adapter transform's default. */
+    passthrough?: boolean;
+    /** Automatic selection rules. Omit to select only via x-meridian-agent. */
+    match?: AdapterInstanceMatch;
+}
+export type AdapterInstanceMap = Record<string, AdapterInstanceDef>;
+/**
+ * Parse and validate an instance map from raw JSON. Malformed input and
+ * invalid entries are dropped (with a warning) rather than crashing —
+ * a config typo must never take down adapter detection.
+ */
+export declare function parseAdapterInstances(raw: string | undefined): AdapterInstanceMap;
+/**
+ * Load the configured instance map. Env var wins over the disk file.
+ * Returns {} when nothing is configured — the common case, and the
+ * guarantee that unconfigured setups keep byte-identical detection.
+ */
+export declare function loadAdapterInstances(): AdapterInstanceMap;
+/**
+ * Does a request match an instance's rules? No rules = never auto-matched
+ * (explicit x-meridian-agent selection only). When both header and UA rules
+ * are present, both must match.
+ */
+export declare function matchesInstance(def: AdapterInstanceDef, getHeader: (name: string) => string | undefined): boolean;
+//# sourceMappingURL=adapterInstances.d.ts.map

package/dist/proxy/adapterInstances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterInstances.d.ts","sourceRoot":"","sources":["../../src/proxy/adapterInstances.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAIpD,MAAM,WAAW,oBAAoB;IACnC,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAA;IACZ,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;IACnC,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,oBAAoB,CAAA;CAC7B;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;AAEnE;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,kBAAkB,CAkCjF;AAOD;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,kBAAkB,CAazD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,kBAAkB,EACvB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAC9C,OAAO,CAiBT"}

package/dist/proxy/adapters/detect.d.ts

@@ -6,18 +6,5 @@
  */
 import type { Context } from "hono";
 import type { AgentAdapter } from "../adapter";
-/**
- * Detect which agent adapter to use based on request headers.
- *
- * Detection rules (evaluated in order):
- * 1. x-meridian-agent header               → explicit adapter override
- * 2. x-opencode-session or x-session-affinity header → OpenCode adapter
- * 3. User-Agent starts with "opencode/"     → OpenCode adapter
- * 4. User-Agent starts with "factory-cli/"  → Droid adapter
- * 5. User-Agent starts with "Charm-Crush/"  → Crush adapter
- * 6. User-Agent starts with "claude-cli/"  → Claude Code adapter
- * 7. litellm/* UA or x-litellm-* headers   → LiteLLM passthrough adapter
- * 8. Default                                → MERIDIAN_DEFAULT_AGENT env var, or OpenCode
- */
 export declare function detectAdapter(c: Context): AgentAdapter;
 //# sourceMappingURL=detect.d.ts.map

package/dist/proxy/adapters/detect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/proxy/adapters/detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAkD9C;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,YAAY,CAgDtD"}
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/proxy/adapters/detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAsF9C,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,YAAY,CAsEtD"}

package/dist/proxy/profiles.d.ts

@@ -13,6 +13,7 @@
  *
  * This is a leaf module — no imports from server.ts or session/.
  */
+import { type RoutingMode } from "./routing";
 /**
  * Load profiles from ~/.config/meridian/profiles.json.
  * Cached with a 5s TTL so new profiles are picked up without restart,
@@ -70,14 +71,28 @@ export declare function enableDiskProfileDiscovery(): void;
 export declare function getEffectiveProfiles(configProfiles: ProfileConfig[] | undefined): ProfileConfig[];
 /** Check if any profiles are available from any source */
 export declare function hasProfiles(configProfiles: ProfileConfig[] | undefined): boolean;
+/** Options for the sticky-routing resolution step (#383). */
+export interface ResolveProfileOptions {
+    /** Session identity for sticky assignment (adapter.getSessionId). */
+    stickySessionKey?: string;
+    /** Routing mode — "active" (default, pre-#383 chain) or "sticky". */
+    routingMode?: RoutingMode;
+}
 /**
  * Resolve a profile from the configuration.
  *
+ * Priority: header > sticky assignment (routing="sticky" only) > active >
+ * config default > first profile. The sticky step exists so multi-account
+ * setups can distribute sessions across profiles WITHOUT losing per-account
+ * prompt caching — see routing.ts. With routingMode unset/"active" the
+ * chain is exactly the pre-#383 behavior.
+ *
  * @param profiles - Configured profiles (from ProxyConfig)
  * @param defaultProfile - Default profile ID (from ProxyConfig)
  * @param requestedId - Explicit profile ID from request header
+ * @param options - Sticky-routing inputs (session key + mode)
  */
-export declare function resolveProfile(profiles: ProfileConfig[] | undefined, defaultProfile: string | undefined, requestedId?: string): ResolvedProfile;
+export declare function resolveProfile(profiles: ProfileConfig[] | undefined, defaultProfile: string | undefined, requestedId?: string, options?: ResolveProfileOptions): ResolvedProfile;
 /**
  * Get all configured profile IDs with their types.
  */

package/dist/proxy/profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/proxy/profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAcH;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,EAAE,CAkBtD;AAED,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,KAAK,GAAG,aAAa,CAAA;AAE9D,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAA;IACV;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,WAAW,CAAA;IACjB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC5B;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAEvD;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,CAY3E;AAUD;;kEAEkE;AAClE,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,SAAS,GAAG,aAAa,EAAE,CAOjG;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,SAAS,GAAG,OAAO,CAEhF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,EAAE,GAAG,SAAS,EACrC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,WAAW,CAAC,EAAE,MAAM,GACnB,eAAe,CAkBjB;AAkCD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,aAAa,EAAE,GAAG,SAAS,EACrC,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAU7D"}
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/proxy/profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AAS/D;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,EAAE,CAkBtD;AAED,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,KAAK,GAAG,aAAa,CAAA;AAE9D,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAA;IACV;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,WAAW,CAAA;IACjB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC5B;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAEvD;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,CAY3E;AAUD;;kEAEkE;AAClE,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,SAAS,GAAG,aAAa,EAAE,CAOjG;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,SAAS,GAAG,OAAO,CAEhF;AAED,6DAA6D;AAC7D,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,qEAAqE;IACrE,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,EAAE,GAAG,SAAS,EACrC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,eAAe,CAyBjB;AAkCD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,aAAa,EAAE,GAAG,SAAS,EACrC,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAU7D"}

package/dist/proxy/routing.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Sticky session-to-profile routing (#383, design by @ShreeMulay).
+ *
+ * With multiple profiles configured, `routing = "sticky"` distributes
+ * sessions across profiles while preserving session affinity — Anthropic's
+ * prompt caching is per-account, so a session that flip-flops between
+ * accounts pays a cold cache (full context re-creation) on every flip.
+ *
+ * Assignment uses rendezvous (highest-random-weight) hashing:
+ *   - deterministic and stateless — stickiness survives proxy restarts with
+ *     no persisted session→profile map to lose or corrupt
+ *   - minimal disruption — adding an arm only moves the sessions that hash
+ *     to the new arm; removing an arm only reassigns that arm's sessions
+ *
+ * Resolution priority (see resolveProfile): explicit x-meridian-profile
+ * header > sticky assignment > active profile > config default > first.
+ * Default mode is "active" (the pre-#383 chain) — existing setups are
+ * byte-identical unless routing is explicitly enabled.
+ *
+ * This is a leaf module — pure functions, no I/O.
+ */
+export type RoutingMode = "active" | "sticky";
+/**
+ * Parse a routing mode string (from settings or MERIDIAN_ROUTING).
+ * Unknown values fall back to "active" — a typo must never change
+ * routing behavior into something surprising.
+ */
+export declare function getRoutingMode(raw: string | undefined): RoutingMode;
+/**
+ * Pick the sticky profile for a session: the profile with the highest
+ * rendezvous score. Returns undefined when there is nothing to pick
+ * (no session identity or no profiles) — callers fall through to the
+ * normal resolution chain.
+ */
+export declare function pickStickyProfile(sessionKey: string, profileIds: readonly string[]): string | undefined;
+/**
+ * Pinned (sessionKey, profiles, expected) triples guarding hash stability.
+ * If an implementation change breaks these, every user's sessions would
+ * silently reshuffle onto different accounts (cold caches) on upgrade —
+ * treat that as a breaking change requiring a migration note, not a test
+ * to update casually.
+ */
+export declare const RENDEZVOUS_STABLE_GUARD: ReadonlyArray<readonly [string, readonly string[], string]>;
+//# sourceMappingURL=routing.d.ts.map

package/dist/proxy/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/proxy/routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE7C;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAEnE;AAaD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAYvG;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,CAAC,CAM/F,CAAA"}

package/dist/proxy/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/proxy/server.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACtE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA;AAGvD,YAAY,EACV,SAAS,EACT,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAA;AAKpB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAoCnG,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EAEpB,KAAK,aAAa,EAGnB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAA+B,iBAAiB,EAAE,mBAAmB,EAAsC,MAAM,iBAAiB,CAAA;AAGzI,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAA;AACjD,YAAY,EAAE,aAAa,EAAE,CAAA;AA2Q7B,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CA+pGhF;AAWD,wBAAgB,gCAAgC,IAAI,IAAI,CAavD;AAED,wBAAsB,gBAAgB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmGhG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/proxy/server.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACtE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA;AAGvD,YAAY,EACV,SAAS,EACT,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAA;AAKpB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAsCnG,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EAEpB,KAAK,aAAa,EAGnB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAA+B,iBAAiB,EAAE,mBAAmB,EAAsC,MAAM,iBAAiB,CAAA;AAGzI,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAA;AACjD,YAAY,EAAE,aAAa,EAAE,CAAA;AA+Q7B,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CA2tGhF;AAWD,wBAAgB,gCAAgC,IAAI,IAAI,CAavD;AAED,wBAAsB,gBAAgB,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmGhG"}

package/dist/proxy/settings.d.ts

@@ -10,6 +10,9 @@
 export interface MeridianSettings {
     /** Last active profile ID — restored on proxy startup */
     activeProfile?: string;
+    /** Profile routing mode (#383): "active" (default) or "sticky".
+     *  MERIDIAN_ROUTING env var takes precedence when set. */
+    routing?: string;
 }
 /** Read settings from disk. Returns empty object if file doesn't exist or is invalid. */
 export declare function loadSettings(): MeridianSettings;

package/dist/proxy/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/proxy/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,yFAAyF;AACzF,wBAAgB,YAAY,IAAI,gBAAgB,CAO/C;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CASrE;AAED,iCAAiC;AACjC,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAExF;AAED,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAErG"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/proxy/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;8DAC0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,yFAAyF;AACzF,wBAAgB,YAAY,IAAI,gBAAgB,CAO/C;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CASrE;AAED,iCAAiC;AACjC,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAExF;AAED,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAErG"}

package/dist/server.js

@@ -11,8 +11,8 @@ import {
   runObserveHook,
   runTransformHook,
   startProxyServer
-} from "./cli-vhrprwj4.js";
-import"./cli-cx463q74.js";
+} from "./cli-mjrt119g.js";
+import"./cli-f0yqy2d2.js";
 import"./cli-sry5aqdj.js";
 import"./cli-4rqtm83g.js";
 import"./cli-q6dz9r5p.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rynfar/meridian",
-  "version": "1.48.1",
+  "version": "1.49.1",
   "description": "Local Anthropic API powered by your Claude Max subscription. One subscription, every agent.",
   "type": "module",
   "main": "./dist/server.js",