@lawaty/lacode 0.10.0 → 1.0.0

package/dist/pool.js

@@ -33,6 +33,7 @@ var STUCK_IDLE_MS = 3 * 60 * 1e3;
 var MAX_CLAIM_AGE_MS = 30 * 60 * 1e3;
 var HANG_COOLDOWN_MS = 10 * 60 * 1e3;
 var UNAVAILABLE_COOLDOWN_MS = 60 * 1e3;
+var UNAVAILABLE_REASON = "endpoint-unavailable";
 var MAX_WEIGHT = 100;
 var SLOT_CEILING_FACTOR = 2;
 var slotCeiling = (slot) => slot.weight * SLOT_CEILING_FACTOR;
@@ -44,6 +45,10 @@ var QUOTA_COOLDOWN_MAX_MS = 6 * 60 * 60 * 1e3;
 var STRIKE_DECAY_MS = 30 * 60 * 1e3;
 var STATED_COOLDOWN_MAX_MS = QUOTA_COOLDOWN_MAX_MS;
 var isQuotaReason = (reason) => /quota|limit|rate|too-many|overloaded|429/i.test(reason);
+var MODEL_MISSING_REASON = "model-missing";
+var MODEL_MISSING_COOLDOWN_MS = QUOTA_COOLDOWN_MAX_MS;
+var MODEL_MISSING_PATTERN = /model\s+(?:not\s+found|does\s+not\s+exist|is\s+not\s+available)|(?:unknown|no\s+such)\s+model/i;
+var isModelMissingText = (text) => MODEL_MISSING_PATTERN.test(text);
 var BASES = ["explore", "implement", "context"];
 var PRESETS_DIR = join2(PACKAGE_ROOT, "presets");
 var DEFAULT_PRESET = join2(PRESETS_DIR, "free-tier.json");
@@ -52,7 +57,7 @@ var USER_MODELS_PATH = join2(USER_CONFIG_DIR, "pool.json");
 var USER_MODELS_TXT = join2(USER_CONFIG_DIR, "pool.txt");
 var FALLBACK_SLOTS = [
   { index: 1, model: "opencode/big-pickle", weight: 3 },
-  { index: 2, model: "opencode-go/minimax-m3.1-flash-free", weight: 2 },
+  { index: 2, model: "opencode-go/beam-free", weight: 2 },
   { index: 3, model: "opencode/deepseek-v4.1-flash-free", weight: 1 },
   { index: 4, model: "opencode/glm-5.3-flash-free", weight: 1 }
 ];
@@ -205,7 +210,14 @@ var LIMIT_PATTERNS = [
   /overloaded/i,
   UNAVAILABLE_PATTERN
 ];
-var isLimitText = (text) => LIMIT_PATTERNS.some((re) => re.test(text));
+var LIMIT_REACHED_PATTERN = /\blimits?[\s_-]?(?:reached|exceeded)\b|\breached\s+(?:your|the|its)\s+limit\b/i;
+var CONTEXT_LIMIT_PATTERN = /(?:context|token|length|window|prompt|char|character|byte|size)\s*(?:limit|length|size|window)/i;
+var LIMIT_REASON_PATTERN = /rate[\s_-]?limit|usage limit|too many requests|quota|freelimiterror|overloaded|limits?[\s_-]?(?:reached|exceeded)/i;
+var isLimitText = (text) => LIMIT_PATTERNS.some((re) => re.test(text)) || LIMIT_REACHED_PATTERN.test(text) && !CONTEXT_LIMIT_PATTERN.test(text);
+var limitReason = (text) => {
+  if (!isLimitText(text)) return void 0;
+  return text.match(LIMIT_REASON_PATTERN)?.[0]?.toLowerCase().replace(/[\s_]/g, "-");
+};
 var isUnavailableText = (text) => UNAVAILABLE_PATTERN.test(text);
 var TRANSIENT_GATEWAY_PATTERNS = [/queue budget/i, /exceeded queue/i, /aborted due to timeout/i, /timeout/i];
 var isTransientGatewayText = (text) => TRANSIENT_GATEWAY_PATTERNS.some((re) => re.test(text));
@@ -276,6 +288,21 @@ function ensureSlots(s, onWarn) {
   for (const problem of problems) onWarn(problem);
   return slots;
 }
+var slotSignature = (origin, slots) => `${origin}\0${slots.map((slot) => `${slot.index}:${slot.model}:${slot.weight}`).join("|")}`;
+function reloadSlots(s, onWarn) {
+  const { slots, problems, origin } = resolveModels({ models: s.inlineModels, modelsFile: s.modelsFile });
+  const changed = slotSignature(origin, slots) !== slotSignature(s.origin, s.slots);
+  if (!changed) return { changed, slots, origin };
+  s.slots = slots;
+  s.origin = origin;
+  for (const problem of problems) onWarn(problem);
+  return { changed, slots, origin };
+}
+function slotSources(input = {}) {
+  if (input.models !== void 0) return [];
+  if (input.modelsFile) return [input.modelsFile];
+  return [USER_MODELS_TXT, USER_MODELS_PATH, DEFAULT_PRESET];
+}
 var claimKey = (sessionID, callID) => `${sessionID}:${callID}`;
 var selfFile = (id) => `claims.${id}.json`;
 var limitFile = (model) => `limit.${model.replace(/[^a-zA-Z0-9._-]/g, "__")}.json`;
@@ -465,11 +492,12 @@ function readLimits(s) {
     try {
       const strike = JSON.parse(readFileSync2(path, "utf8"));
       if (typeof strike.until !== "number" || typeof strike.model !== "string") continue;
+      const countsAsStrike = strike.reason !== UNAVAILABLE_REASON;
       if (strike.until > now) {
         cooling.set(strike.model, strike);
-        memory.set(strike.model, strike);
+        if (countsAsStrike) memory.set(strike.model, strike);
       } else if (typeof strike.last === "number" && now - strike.last < STRIKE_DECAY_MS) {
-        memory.set(strike.model, strike);
+        if (countsAsStrike) memory.set(strike.model, strike);
       } else {
         unlinkSync(path);
       }
@@ -486,6 +514,7 @@ function readLimits(s) {
 }
 function recordStrike(s, model, reason, stated) {
   if (!s.dirReady) return;
+  if (reason === UNAVAILABLE_REASON) return coolUnavailable(s, model);
   const now = Date.now();
   const prior = s.strikes.get(model);
   const strikes = prior && now - prior.last < STRIKE_DECAY_MS ? prior.strikes + 1 : 1;
@@ -510,9 +539,8 @@ function coolUnavailable(s, model) {
   const prior = s.cooling.get(model);
   const until = now + UNAVAILABLE_COOLDOWN_MS;
   if (prior && prior.until > until) return prior;
-  const strike = { model, until, strikes: 1, reason: "endpoint-unavailable", last: now };
+  const strike = { model, until, strikes: 1, reason: UNAVAILABLE_REASON, last: now };
   s.cooling.set(model, strike);
-  s.strikes.set(model, strike);
   const path = join2(s.dir, limitFile(model));
   try {
     writeFileSync(`${path}.tmp`, JSON.stringify(strike));
@@ -598,48 +626,24 @@ function snapshot(s) {
 }
 var loadOf = (counts, model) => counts.get(model) ?? 0;
 var underCeiling = (slot, counts) => loadOf(counts, slot.model) < slotCeiling(slot);
-function roundRobinSequence(slots) {
-  const seq = [];
-  for (const slot of slots) for (let turn = 0; turn < slot.weight; turn++) seq.push(slot.index);
-  return seq;
-}
-var CURSOR_FILE = "cursor.json";
-function readCursor(s) {
-  try {
-    const parsed = JSON.parse(readFileSync2(join2(s.dir, CURSOR_FILE), "utf8"));
-    if (typeof parsed.seq === "number" && Number.isInteger(parsed.seq) && parsed.seq >= 0) return parsed.seq;
-  } catch {
+function pickSlot(s, snap) {
+  const slots = s.slots.length > 0 ? s.slots : FALLBACK_SLOTS;
+  const usable = slots.filter((slot) => isAvailable(s, slot.model, snap.cooling));
+  const pool = usable.length > 0 ? usable : slots;
+  for (const slot of usable) {
+    if (loadOf(snap.counts, slot.model) < slot.weight) return slot;
   }
-  return 0;
-}
-function writeCursor(s, seq) {
-  if (!s.dirReady) return;
-  const path = join2(s.dir, CURSOR_FILE);
-  try {
-    writeFileSync(`${path}.tmp`, JSON.stringify({ seq }));
-    renameSync(`${path}.tmp`, path);
-  } catch {
+  for (const slot of usable) {
+    if (loadOf(snap.counts, slot.model) < slotCeiling(slot)) return slot;
   }
+  return pool.reduce((best, slot) => loadOf(snap.counts, slot.model) < loadOf(snap.counts, best.model) ? slot : best, pool[0]);
 }
-function pickSlot(s, snap, options) {
-  const advance = options?.advance !== false;
+function poolPass(s, snap) {
   const slots = s.slots.length > 0 ? s.slots : FALLBACK_SLOTS;
-  const seq = roundRobinSequence(slots);
-  if (seq.length > 0) {
-    const byIndex = new Map(slots.map((slot) => [slot.index, slot]));
-    const start = readCursor(s) % seq.length;
-    for (let step = 0; step < seq.length; step++) {
-      const at = (start + step) % seq.length;
-      const slot = byIndex.get(seq[at]);
-      if (slot && isAvailable(s, slot.model, snap.cooling) && underCeiling(slot, snap.counts)) {
-        if (advance) writeCursor(s, at + 1);
-        return slot;
-      }
-    }
-  }
   const usable = slots.filter((slot) => isAvailable(s, slot.model, snap.cooling));
-  const pool = usable.length > 0 ? usable : slots;
-  return pool.reduce((best, slot) => loadOf(snap.counts, slot.model) < loadOf(snap.counts, best.model) ? slot : best, pool[0]);
+  if (usable.some((slot) => loadOf(snap.counts, slot.model) < slot.weight)) return 1;
+  if (usable.some((slot) => loadOf(snap.counts, slot.model) < slotCeiling(slot))) return 2;
+  return "overflow";
 }
 function agentFor(base, slot) {
   return `${base}-${slot}`;
@@ -755,6 +759,8 @@ export {
   MAX_CLAIM_AGE_MS,
   MAX_SLOTS,
   MAX_WEIGHT,
+  MODEL_MISSING_COOLDOWN_MS,
+  MODEL_MISSING_REASON,
   ORPHAN_TMP_MS,
   PACKAGE_ROOT,
   PRESETS_DIR,
@@ -766,6 +772,7 @@ export {
   STUCK_IDLE_MS,
   STUCK_MIN_AGE_MS,
   UNAVAILABLE_COOLDOWN_MS,
+  UNAVAILABLE_REASON,
   USER_CONFIG_DIR,
   USER_MODELS_PATH,
   USER_MODELS_TXT,
@@ -785,10 +792,12 @@ export {
   init,
   isAvailable,
   isLimitText,
+  isModelMissingText,
   isProbe,
   isQuotaReason,
   isTransientGatewayText,
   isUnavailableText,
+  limitReason,
   manualVariant,
   markProbe,
   noteActivity,
@@ -796,6 +805,7 @@ export {
   parseSlots,
   parseTextSlots,
   pickSlot,
+  poolPass,
   providerOf,
   pruneOwn,
   pruneSessions,
@@ -807,12 +817,13 @@ export {
   refreshCatalog,
   release,
   releaseStuck,
+  reloadSlots,
   resolveModels,
   retryAfterMs,
-  roundRobinSequence,
   selfFile,
   slotCeiling,
   slotFor,
+  slotSources,
   snapshot,
   splitModel,
   state,

package/dist/tunnel.js

@@ -1,6 +1,16 @@
 // src/tunnel/index.ts
 import { spawn, spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
+import { appendFileSync, existsSync as existsSync2, mkdirSync as mkdirSync3, readFileSync as readFileSync4, unlinkSync as unlinkSync3 } from "node:fs";
+import { homedir as homedir3 } from "node:os";
+import { join as join4 } from "node:path";
+
+// src/lib/notify.ts
+import { closeSync, mkdirSync as mkdirSync2, openSync, readFileSync as readFileSync3, renameSync as renameSync2, statSync as statSync2, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2, writeSync } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { join as join3 } from "node:path";
+
+// src/lib/pool.ts
+import { existsSync, mkdirSync, readdirSync, readFileSync as readFileSync2, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join as join2 } from "node:path";
 
@@ -24,6 +34,36 @@ var findPackageRoot = (start) => {
 };
 var PACKAGE_ROOT = findPackageRoot(dirname(fileURLToPath(import.meta.url)));
 
+// src/lib/pool.ts
+var CLAIM_TTL_MS = 10 * 60 * 1e3;
+var DEAD_FILE_MS = 2 * CLAIM_TTL_MS;
+var ORPHAN_TMP_MS = 60 * 1e3;
+var CATALOG_TTL_MS = 10 * 60 * 1e3;
+var STUCK_MIN_AGE_MS = 5 * 60 * 1e3;
+var STUCK_IDLE_MS = 3 * 60 * 1e3;
+var MAX_CLAIM_AGE_MS = 30 * 60 * 1e3;
+var HANG_COOLDOWN_MS = 10 * 60 * 1e3;
+var UNAVAILABLE_COOLDOWN_MS = 60 * 1e3;
+var COOLDOWN_BASE_MS = 60 * 1e3;
+var COOLDOWN_MAX_MS = 15 * 60 * 1e3;
+var QUOTA_COOLDOWN_BASE_MS = 15 * 60 * 1e3;
+var QUOTA_COOLDOWN_MAX_MS = 6 * 60 * 60 * 1e3;
+var STRIKE_DECAY_MS = 30 * 60 * 1e3;
+var PRESETS_DIR = join2(PACKAGE_ROOT, "presets");
+var DEFAULT_PRESET = join2(PRESETS_DIR, "free-tier.json");
+var USER_CONFIG_DIR = join2(homedir(), ".config", "lacode");
+var USER_MODELS_PATH = join2(USER_CONFIG_DIR, "pool.json");
+var USER_MODELS_TXT = join2(USER_CONFIG_DIR, "pool.txt");
+var STATE_SWEEP_INTERVAL_MS = 60 * 60 * 1e3;
+var CHILD_MEMORY_MS = 30 * 6e4;
+
+// src/lib/notify.ts
+var NOTIFY_SESSION_ENV = "LACODE_NOTIFY_SESSION";
+var NOTIFY_CLOSE_ENV = "LACODE_NOTIFY_CLOSE";
+var notificationStateDir = () => process.env.LACODE_NOTIFY_DIR ?? join3(homedir2(), ".local", "share", "opencode", "lacode", "notify");
+var safeCorrelationKey = (correlationKey) => correlationKey.replace(/[^A-Za-z0-9._-]/g, "_").slice(0, 64);
+var notificationIdFile = (correlationKey) => join3(notificationStateDir(), `${safeCorrelationKey(correlationKey)}.ids`);
+
 // src/tunnel/index.ts
 var ICONS = [
   "utilities-terminal",
@@ -46,7 +86,7 @@ function resolveTunnel(env = process.env) {
     user: env.OC_LOCAL_USER ?? "",
     host: env.OC_LOCAL_HOST ?? "",
     port: Number.isFinite(port) && port > 0 ? port : 10022,
-    key: env.OC_NOTIFY_KEY ?? join2(homedir(), ".ssh", "lacode_notify"),
+    key: env.OC_NOTIFY_KEY ?? join4(homedir3(), ".ssh", "lacode_notify"),
     connectTimeoutMs: Number(env.OC_CONNECT_TIMEOUT_MS) || 5e3
   };
 }
@@ -74,16 +114,32 @@ var safeRequestId = (raw) => {
   if (!clean) return void 0;
   return clean.length > 128 ? clean.slice(0, 128) : clean;
 };
+var CLOSE_REQUEST_PREFIX = "close:";
+var wireCorrelationKey = (raw) => safeText(raw ?? "", "", 200);
+var presentCorrelationKey = (raw) => {
+  const clean = wireCorrelationKey(raw);
+  return clean ? clean : void 0;
+};
+var isCloseRequest = (correlationKey) => typeof correlationKey === "string" && correlationKey.startsWith(CLOSE_REQUEST_PREFIX);
+var closeRequestTarget = (correlationKey) => {
+  if (!isCloseRequest(correlationKey)) return void 0;
+  const target = correlationKey?.slice(CLOSE_REQUEST_PREFIX.length).trim() ?? "";
+  return target ? target : void 0;
+};
 var FIELD_SEPARATOR = "\n";
 function parsePayload(raw) {
-  const [title, message, urgency, icon, sound, requestID] = raw.split(FIELD_SEPARATOR);
+  const [title, message, urgency, icon, sound, requestID, correlationKey] = raw.split(FIELD_SEPARATOR);
+  const key = wireCorrelationKey(correlationKey);
   return {
     title: safeTitle(title),
     message: safeMessage(message),
     urgency: normalizeUrgency(urgency),
     icon: normalizeIcon(icon),
     sound: normalizeSound(sound),
-    requestID: safeRequestId(requestID)
+    requestID: safeRequestId(requestID),
+    // The seventh field, empty when there is none. A close request keeps its
+    // marker here, so the receiver can still tell it apart from a session.
+    ...key ? { correlationKey: key } : {}
   };
 }
 var encodePayload = (request) => [
@@ -94,7 +150,11 @@ var encodePayload = (request) => [
   normalizeSound(request.sound),
   // The sixth field, empty when there is no request id: an absent id and an
   // empty one mean the same thing, and the field count never changes.
-  safeRequestId(request.requestID) ?? ""
+  safeRequestId(request.requestID) ?? "",
+  // The seventh field, the correlation key, empty when there is none. The
+  // `close:` marker of a close request is part of the key and travels with
+  // it, so the far end closes instead of raising.
+  wireCorrelationKey(request.correlationKey)
 ].join(FIELD_SEPARATOR);
 var SSH_OPTS = [
   "-o",
@@ -114,11 +174,16 @@ var CONTROL_OPTS = [
   "-o",
   "ControlPersist=300",
   "-o",
-  `ControlPath=${join2(homedir(), ".ssh", "lacode-cm-%C")}`
+  `ControlPath=${join4(homedir3(), ".ssh", "lacode-cm-%C")}`
 ];
-var run = (command, args, timeout) => {
+var run = (command, args, timeout, extraEnv) => {
   try {
-    const result = spawnSync(command, args, { timeout, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+    const result = spawnSync(command, args, {
+      timeout,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "pipe"],
+      ...extraEnv ? { env: { ...process.env, ...extraEnv } } : {}
+    });
     return {
       ok: result.status === 0,
       stdout: result.stdout ?? "",
@@ -178,20 +243,104 @@ var NO_CHANNEL = {
   darwin: "neither osascript nor terminal-notifier is installed"
 };
 var NEVER_EXPIRE_FLAG = "--expire-time=0";
+var APP_NAME_FLAG = "--app-name=LaCode";
 var NOTIFICATION_ACTIONS = [
   ["once", "Allow once"],
   ["always", "Always allow"],
   ["reject", "Deny"]
 ];
 var ACTION_WAIT_MS = 10 * 6e4;
+var isNotificationId = (id) => /^\d+$/.test(id);
+var recordNotificationId = (correlationKey, id) => {
+  if (!isNotificationId(id)) return false;
+  try {
+    mkdirSync3(notificationStateDir(), { recursive: true });
+    appendFileSync(notificationIdFile(correlationKey), `${id}
+`, "utf8");
+    return true;
+  } catch {
+    return false;
+  }
+};
+var sessionBusEnv = () => {
+  if (process.env.DBUS_SESSION_BUS_ADDRESS) return {};
+  const uid = typeof process.getuid === "function" ? process.getuid() : void 0;
+  return uid === void 0 ? {} : { DBUS_SESSION_BUS_ADDRESS: `unix:path=/run/user/${uid}/bus` };
+};
+var CLOSE_TIMEOUT_MS = 5e3;
+function closeNotification(id) {
+  if (!isNotificationId(id)) return false;
+  const env = sessionBusEnv();
+  const viaGdbus = run(
+    "gdbus",
+    [
+      "call",
+      "--session",
+      "--dest",
+      "org.freedesktop.Notifications",
+      "--object-path",
+      "/org/freedesktop/Notifications",
+      "--method",
+      "org.freedesktop.Notifications.CloseNotification",
+      id
+    ],
+    CLOSE_TIMEOUT_MS,
+    env
+  );
+  if (viaGdbus.ok) return true;
+  const viaDbusSend = run(
+    "dbus-send",
+    [
+      "--session",
+      "--dest=org.freedesktop.Notifications",
+      "--type=method_call",
+      "/org/freedesktop/Notifications",
+      "org.freedesktop.Notifications.CloseNotification",
+      `uint32:${id}`
+    ],
+    CLOSE_TIMEOUT_MS,
+    env
+  );
+  return viaDbusSend.ok;
+}
+function closeCorrelationKey(correlationKey) {
+  const file = notificationIdFile(correlationKey);
+  let content = "";
+  try {
+    content = readFileSync4(file, "utf8");
+  } catch {
+    return true;
+  }
+  let closed = true;
+  for (const line of content.split("\n")) {
+    const id = line.trim();
+    if (!isNotificationId(id)) continue;
+    if (!closeNotification(id)) closed = false;
+  }
+  try {
+    unlinkSync3(file);
+  } catch {
+  }
+  return closed;
+}
+var splitNotifyOutput = (stdout) => {
+  const newline = stdout.indexOf("\n");
+  if (newline === -1) return { id: stdout.trim(), action: "" };
+  return { id: stdout.slice(0, newline).trim(), action: stdout.slice(newline + 1).trim() };
+};
 function sendLocal(request, platform = process.platform) {
+  const closing = closeRequestTarget(request.correlationKey);
+  if (closing !== void 0) {
+    const closed = closeCorrelationKey(closing);
+    return { ok: closed, detail: closed ? void 0 : "a popup could not be closed", transport: "local" };
+  }
   const sound = normalizeSound(request.sound);
   const playSound = () => {
     if (sound === "none") return;
     const channel2 = soundChannel(platform);
     if (channel2 === "none") return;
-    const path = join2(PACKAGE_ROOT, "sounds", `${sound}.wav`);
-    if (!existsSync(path)) return;
+    const path = join4(PACKAGE_ROOT, "sounds", `${sound}.wav`);
+    if (!existsSync2(path)) return;
     const child = spawn(channel2, [path], { detached: true, stdio: "ignore" });
     child.on("error", () => {
     });
@@ -207,13 +356,17 @@ function sendLocal(request, platform = process.platform) {
   const requestID = safeRequestId(request.requestID);
   const actionable = channel === "notify-send" && requestID !== void 0;
   const actionArgs = actionable ? NOTIFICATION_ACTIONS.map(([name, label]) => `--action=${name}=${label}`) : [];
+  const correlationKey = presentCorrelationKey(request.correlationKey);
+  const trackable = channel === "notify-send" && correlationKey !== void 0;
   const args = channel === "osascript" ? ["-e", DARWIN_SCRIPT, DARWIN_ARGV_MARKER, title, body] : channel === "terminal-notifier" ? ["-title", title, "-message", body, "-appName", "LaCode", "-priority", normalizeUrgency(request.urgency)] : (
     // Never auto-dismissed: the notification waits for the user to close it.
-    [title, body, `--urgency=${normalizeUrgency(request.urgency)}`, `--icon=${normalizeIcon(request.icon)}`, NEVER_EXPIRE_FLAG, ...actionArgs]
+    [title, body, APP_NAME_FLAG, `--urgency=${normalizeUrgency(request.urgency)}`, `--icon=${normalizeIcon(request.icon)}`, NEVER_EXPIRE_FLAG, ...trackable ? ["--print-id"] : [], ...actionArgs]
   );
   const result = run(CHANNEL_BINARY[channel], args, actionable ? ACTION_WAIT_MS : 5e3);
   playSound();
-  const action = actionable ? result.stdout.trim() : "";
+  const printed = trackable ? splitNotifyOutput(result.stdout) : { id: "", action: result.stdout.trim() };
+  const action = actionable ? printed.action : "";
+  if (correlationKey !== void 0 && printed.id) recordNotificationId(correlationKey, printed.id);
   return {
     ok: result.ok,
     detail: result.ok ? void 0 : result.stderr || result.detail,
@@ -262,7 +415,17 @@ function sendRemote(request, tunnel) {
 }
 function notify(request, env = process.env, platform = process.platform) {
   try {
-    const result = isRemote(env) ? sendRemote(request, resolveTunnel(env)) : sendLocal(request, platform);
+    const closeKey = (env[NOTIFY_CLOSE_ENV] ?? "").trim();
+    if (closeKey) {
+      if (!isRemote(env)) {
+        const closed = closeCorrelationKey(closeKey);
+        return { ok: closed, detail: closed ? void 0 : "a popup could not be closed", transport: "local" };
+      }
+      return sendRemote({ ...request, correlationKey: `${CLOSE_REQUEST_PREFIX}${closeKey}` }, resolveTunnel(env));
+    }
+    const sessionKey = presentCorrelationKey(env[NOTIFY_SESSION_ENV]);
+    const tracked = sessionKey ? { ...request, correlationKey: request.correlationKey ?? sessionKey } : request;
+    const result = isRemote(env) ? sendRemote(tracked, resolveTunnel(env)) : sendLocal(tracked, platform);
     return result.action ? { ...result, action: result.action } : result;
   } catch (error) {
     return { ok: false, detail: String(error), transport: "none" };
@@ -294,21 +457,30 @@ function describe(env = process.env, platform = process.platform) {
   };
 }
 export {
+  CLOSE_REQUEST_PREFIX,
   FIELD_SEPARATOR,
   ICONS,
   NOTIFICATION_ACTIONS,
   SOUNDS,
+  closeCorrelationKey,
+  closeNotification,
+  closeRequestTarget,
   describe,
   encodePayload,
   forward,
+  isCloseRequest,
+  isNotificationId,
   isRemote,
   localChannel,
   normalizeIcon,
   normalizeSound,
   normalizeUrgency,
+  notificationIdFile,
+  notificationStateDir,
   notify,
   parsePayload,
   resolveTunnel,
+  safeCorrelationKey,
   safeMessage,
   safeRequestId,
   safeTitle,

package/docs/CONFIGURATION.md

@@ -7,13 +7,16 @@ The plugin options, where the model pool gets its slots, and exactly what LaCode
 The slot list is the first of these that yields usable slots:
 
 1. plugin options — `models` in the [tuple](../README.md#configure)
-2. `~/.config/lacode/pool.json` (its parent directory is created for you)
-3. the bundled `presets/free-tier.json`
-4. a built-in fallback, so routing always works
+2. `~/.config/lacode/pool.txt` — flat `model [weight]` per line, preferred
+3. `~/.config/lacode/pool.json` (its parent directory is created for you)
+4. the bundled `presets/free-tier.json`
+5. a built-in fallback, so routing always works
 
 A missing, unreadable or structurally broken source falls through to the next and
-logs one warning; nothing here throws into opencode. Nothing hot-reloads —
-change a preset, then restart every opencode process.
+logs one warning; nothing here throws into opencode. Sources 2–4 are watched: a
+change reloads the slot table, re-binds the variant agents and validates every
+slot (one real request per model) without a restart. Only a change to the
+plugin's own code needs one.
 
 **Any model list is accepted, including paid ones** (US-7). There is no free-tier
 allowlist anywhere in the package, and no cost check of any kind: only the
@@ -65,12 +68,23 @@ fields are not affected; `permission`, `prompt`, `model`, `description`,
 The hidden pool variants (`explore-1`, `implement-2`, …) inherit
 nothing here — add a line per variant, or drop the global
 deny and scope it to the agents that should not have browser access instead.
-Note that you cannot *spawn* a variant by name: the pool refuses
-`explore-1` and friends and points you at the bare base, so per-variant
+Note that you cannot *spawn* a variant by name: the pool rewrites
+`explore-1` and friends to their base and routes them, so per-variant
 permissions only ever apply to a spawn the plugin routed itself.
 
-Nothing hot-reloads: after editing your config, restart every running opencode
-process.
+The pool files are the exception to the restart rule: editing `pool.txt`,
+`pool.json` or the bundled preset is picked up live — the table reloads, the
+variant agents re-bind and every slot is validated. A change to `opencode.jsonc`
+itself, or to the plugin's code, still needs a restart.
+
+**The delegation path matters.** The pool routes `task` tool calls whose
+`subagent_type` is `explore`, `implement` or `context`. A spawn with no
+`subagent_type`, an `@explore`/`@implement` mention, or a direct session prompt
+naming a base agent does not pass through that hook: it runs opencode's
+default/subagent path and inherits the caller's model. Spawn the bare base
+through the task tool (`subagent_type: "explore"`), not by mention or variant
+name. The plugin logs a warning for the no-`subagent_type` case; the
+mention/direct-session case cannot be detected before it runs.
 
 
 ## What gets injected

package/docs/OMNIROUTE.md

@@ -104,7 +104,7 @@ work (exploration, implementation, cartography) through the gateway, add an
 # ~/.config/lacode/pool.txt
 omniroute/free-mix
 opencode/big-pickle
-opencode-go/minimax-m3.1-flash-free
+opencode-go/beam-free
 ```
 
 OmniRoute is a provider like any other: the pool decides its place and weight,