@lawaty/lacode 1.2.0 → 1.3.0-beta.1

package/CHANGELOG.md

@@ -7,6 +7,45 @@ All notable changes to LaCode are recorded here. The format follows
 Versions come from git release commits; the npm version is bumped in the same
 commit as the changelog entry it describes.
 
+## [1.3.0-beta.0] — provider readiness, timeline roots, and a reason on cancelled tasks
+
+### Added
+
+- **The pool gates slots on provider readiness.** Before routing, LaCode asks
+  opencode which providers are connected and which carry credentials, then
+  excludes slots whose provider is unconfigured or unauthenticated. Readiness
+  fails open until the first successful probe, so an offline start still routes;
+  `pool_status` names the provider to log in to.
+- **`/reprocess-timeline` rebuilds the root session.** A reprocess started from a
+  subagent walks the `parentID` chain (with cycle protection) and summarizes the
+  root session, instead of only the child it was invoked from.
+- **Host sync merges a Cloudflare Workers AI provider.** `bin/oc-sync` reads
+  `CLOUDFLARE_ACCOUNT_ID` (or derives it from the local provider URL) and merges
+  the provider into each host's `opencode.jsonc` after the auth sync; existing
+  providers are preserved and the write is backed up.
+- **`OC_AUTH_PROVIDERS` can come from the env file.** The post-publish host sync
+  falls back to `~/.config/lacode/env` when the variable is unset.
+
+### Changed
+
+- **A pool-cancelled subtask now carries its cause.** The bare `Task cancelled`
+  card is rewritten in place to `Task Cancelled by LaCode: <cause>` — slot,
+  model, elapsed time, failure kind and claim state. The old warning toast is
+  gone; the reason lives on the task itself. The rewrite is best-effort: if
+  opencode rejects the part update, a warning is logged and the original text
+  stays.
+- **A model that disappears is benched, not retried forever.** A terminal
+  model-not-found error cools the model for the cap and releases the claim.
+
+### Fixed
+
+- **Startup no longer waits on the provider endpoint.** The config hook used to
+  await `client.provider.list` while opencode was still bootstrapping the same
+  instance, which deadlocked startup. The first spawn now refreshes readiness
+  before routing, and `pool_status`/`pool_recheck` still force a refresh.
+- **A terminal session error, or an abort that does not confirm, releases the
+  claim** instead of holding it until the reaper.
+
 ## [1.2.0] — voice, a per-session timeline, and a pool without a cap
 
 ### Added
@@ -920,6 +959,7 @@ experimental; `latest` remains 0.4.2.
 - First published release: pooled subagents over a shared set of models.
 
 [Unreleased]: https://github.com/lawaty/lacode/compare/v1.2.0...HEAD
+[1.3.0-beta.0]: https://github.com/lawaty/lacode/releases/tag/v1.3.0-beta.0
 [1.2.0]: https://github.com/lawaty/lacode/compare/v1.1.0...v1.2.0
 [1.1.0]: https://github.com/lawaty/lacode/compare/v1.0.0...v1.1.0
 [1.0.0]: https://github.com/lawaty/lacode/compare/v0.11.0...v1.0.0

package/README.md

@@ -2,7 +2,7 @@
 
 > Ultimate opencode setup for Go users
 
-> LaCode 1.0.0 ships on the npm **`latest`** dist-tag. Prereleases use
+> LaCode 1.2.0 ships on the npm **`latest`** dist-tag. Prereleases use
 > `beta`: install `@lawaty/lacode@beta`, or pin an exact version.
 
 LaCode is an opencode plugin. It routes delegated work onto a weighted pool of
@@ -170,7 +170,7 @@ The running session keeps its loaded code; the new version takes effect on the
 next start, and the log says so. Run `lacode update` to do it on demand, or
 `lacode update --check` to just report.
 
-1.0.0 is published to the `latest` dist-tag; prereleases use `beta`. This check
+1.2.0 is published to the `latest` dist-tag; prereleases use `beta`. This check
 follows `latest`. A beta install is therefore reported as current even when a
 newer beta exists,
 and `lacode update` will not move it: pin the version you want in the `plugin`
@@ -186,7 +186,7 @@ lacode version
 ```
 
 ```
-version    1.0.0
+version    1.2.0
 root       /home/you/lacode
 source     checkout
 commit     <hash> (dirty)

package/dist/agents.js

@@ -1,5 +1,5 @@
 // src/lib/pool.ts
-import { existsSync, mkdirSync, readdirSync, readFileSync as readFileSync2, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { appendFileSync, 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";
 
@@ -25,9 +25,11 @@ var PACKAGE_ROOT = findPackageRoot(dirname(fileURLToPath(import.meta.url)));
 
 // src/lib/pool.ts
 var CLAIM_TTL_MS = 10 * 60 * 1e3;
+var UNBOUND_CLAIM_MS = 2 * 60 * 1e3;
 var DEAD_FILE_MS = 2 * CLAIM_TTL_MS;
 var ORPHAN_TMP_MS = 60 * 1e3;
 var CATALOG_TTL_MS = 10 * 60 * 1e3;
+var PROVIDER_LIST_TTL_MS = 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;

package/dist/commands.js

@@ -3,7 +3,7 @@ var AGENT_INSTRUCTIONS_COMMAND = "agent-instructions";
 var AGENT_INSTRUCTIONS_WRITER = "instructions";
 
 // src/lib/pool.ts
-import { existsSync, mkdirSync, readdirSync, readFileSync as readFileSync2, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { appendFileSync, 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";
 
@@ -29,9 +29,11 @@ var PACKAGE_ROOT = findPackageRoot(dirname(fileURLToPath(import.meta.url)));
 
 // src/lib/pool.ts
 var CLAIM_TTL_MS = 10 * 60 * 1e3;
+var UNBOUND_CLAIM_MS = 2 * 60 * 1e3;
 var DEAD_FILE_MS = 2 * CLAIM_TTL_MS;
 var ORPHAN_TMP_MS = 60 * 1e3;
 var CATALOG_TTL_MS = 10 * 60 * 1e3;
+var PROVIDER_LIST_TTL_MS = 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;

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/lib/pool.ts
-import { existsSync, mkdirSync, readdirSync, readFileSync as readFileSync2, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { appendFileSync, 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";
 
@@ -25,9 +25,11 @@ var PACKAGE_ROOT = findPackageRoot(dirname(fileURLToPath(import.meta.url)));
 
 // src/lib/pool.ts
 var CLAIM_TTL_MS = 10 * 60 * 1e3;
+var UNBOUND_CLAIM_MS = 2 * 60 * 1e3;
 var DEAD_FILE_MS = 2 * CLAIM_TTL_MS;
 var ORPHAN_TMP_MS = 60 * 1e3;
 var CATALOG_TTL_MS = 10 * 60 * 1e3;
+var PROVIDER_LIST_TTL_MS = 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;
@@ -294,6 +296,11 @@ function state(opts = {}) {
       reaping: false,
       lastSweep: 0,
       lastDirSweep: 0,
+      connected: /* @__PURE__ */ new Set(),
+      connectedAt: 0,
+      connectedReady: false,
+      credentialed: /* @__PURE__ */ new Set(),
+      configCreds: /* @__PURE__ */ new Set(),
       id,
       dir,
       modelsFile,
@@ -401,9 +408,16 @@ function sweepStateDir(s) {
   }
   return removed;
 }
+var claimExpired = (claim, now) => now - (claim.hb ?? claim.t) > CLAIM_TTL_MS || !claim.g && now - claim.t > UNBOUND_CLAIM_MS;
 function pruneOwn(s) {
   const now = Date.now();
-  for (const [key, claim] of s.own) if (now - (claim.hb ?? claim.t) > CLAIM_TTL_MS) s.own.delete(key);
+  let removed = false;
+  for (const [key, claim] of s.own)
+    if (claimExpired(claim, now)) {
+      s.own.delete(key);
+      removed = true;
+    }
+  if (removed) publish(s);
 }
 function pruneActivity(s, now) {
   if (s.activity.size === 0) return;
@@ -431,7 +445,7 @@ function publish(s) {
   if (!s.dirReady) return;
   const now = Date.now();
   const payload = {};
-  for (const [key, claim] of s.own) if (now - (claim.hb ?? claim.t) <= CLAIM_TTL_MS) payload[key] = claim;
+  for (const [key, claim] of s.own) if (!claimExpired(claim, now)) payload[key] = claim;
   try {
     writeFileSync(join2(s.dir, `${selfFile(s.id)}.tmp`), JSON.stringify(payload));
     renameSync(join2(s.dir, `${selfFile(s.id)}.tmp`), join2(s.dir, selfFile(s.id)));
@@ -490,7 +504,7 @@ function readSiblings(s) {
     try {
       const parsed = JSON.parse(readFileSync2(path5, "utf8"));
       const claims = Object.values(parsed).filter(
-        (c) => c && typeof c.v === "string" && typeof c.m === "string" && typeof c.k === "number" && Number.isFinite(c.k) && now - (c.hb ?? c.t) <= CLAIM_TTL_MS
+        (c) => c && typeof c.v === "string" && typeof c.m === "string" && typeof c.k === "number" && Number.isFinite(c.k) && !claimExpired(c, now)
       );
       siblings.push({ id: match[1], claims });
     } catch {
@@ -629,6 +643,12 @@ function clearCooldowns(s, models) {
 var markProbe = (s, sessionID) => s.probes.add(sessionID);
 var unmarkProbe = (s, sessionID) => s.probes.delete(sessionID);
 var isProbe = (s, sessionID) => s.probes.has(sessionID);
+function providerReady(s, model) {
+  if (!s.connectedReady) return true;
+  const provider = providerOf(model);
+  if (!s.connected.has(provider)) return false;
+  return s.credentialed.has(provider) || s.configCreds.has(provider) || provider === "opencode";
+}
 function refreshCatalog(s, serverUrl) {
   if (!serverUrl || Date.now() - s.catalogAt < CATALOG_TTL_MS) return;
   s.catalogAt = Date.now();
@@ -645,6 +665,7 @@ function refreshCatalog(s, serverUrl) {
   })();
 }
 function isAvailable(s, model, cooling) {
+  if (!providerReady(s, model)) return false;
   if (cooling.has(model)) return false;
   const status = s.catalog.get(model);
   return status === void 0 || status === "active" || status === "unknown";
@@ -664,8 +685,9 @@ var loadOf = (counts, slot) => counts.get(slot) ?? 0;
 var underCeiling = (slot, counts) => loadOf(counts, slot.index) < slotCeiling(slot);
 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;
+  const configured = slots.filter((slot) => providerReady(s, slot.model));
+  const usable = configured.filter((slot) => isAvailable(s, slot.model, snap.cooling));
+  const pool = usable.length > 0 ? usable : configured.length > 0 ? configured : slots;
   for (const slot of usable) {
     if (loadOf(snap.counts, slot.index) < slot.weight) return slot;
   }
@@ -777,6 +799,56 @@ function coolProvider(s, provider, until, reason) {
   }
   return affected;
 }
+function recordFailure(s, f) {
+  try {
+    const path5 = join2(s.dir, "failures.jsonl");
+    const trimSize = 64 * 1024;
+    const keepLines = 200;
+    if (existsSync(path5)) {
+      const st = statSync(path5);
+      if (typeof st.size === "number" && st.size > trimSize) {
+        try {
+          const content = readFileSync2(path5, "utf8");
+          const parts = content.split("\n");
+          const lines = parts.filter((line) => line.length > 0);
+          if (lines.length > keepLines) {
+            const kept = lines.slice(lines.length - keepLines);
+            writeFileSync(`${path5}.tmp`, kept.join("\n") + "\n");
+            renameSync(`${path5}.tmp`, path5);
+          } else if (lines.length === 0 && parts.length >= 1) {
+          }
+        } catch {
+        }
+      }
+    }
+    appendFileSync(path5, JSON.stringify(f) + "\n");
+  } catch (error) {
+    console.error("[agent-pool] failed to record failure:", String(error));
+  }
+}
+function readFailures(s, limit) {
+  const path5 = join2(s.dir, "failures.jsonl");
+  try {
+    if (!existsSync(path5)) return [];
+    const content = readFileSync2(path5, "utf8");
+    const parts = content.split("\n");
+    const records = [];
+    for (let i = 0; i < parts.length; i++) {
+      const line = parts[i];
+      if (line.length === 0) continue;
+      try {
+        const parsed = JSON.parse(line);
+        records.push(parsed);
+      } catch {
+      }
+    }
+    if (limit <= 0) return [];
+    if (records.length <= limit) return records;
+    return records.slice(records.length - limit);
+  } catch {
+    return [];
+  }
+}
 
 // src/lib/agent-instructions.ts
 var AGENT_INSTRUCTIONS_COMMAND = "agent-instructions";
@@ -2439,6 +2511,63 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
     s.warned.add(message);
     await log("warn", message);
   };
+  const refreshProviders = async (force = false) => {
+    if (!force && Date.now() - s.connectedAt < PROVIDER_LIST_TTL_MS) return;
+    s.connectedAt = Date.now();
+    try {
+      const providerApi = client.provider;
+      if (!providerApi || typeof providerApi.list !== "function") return;
+      const result = await providerApi.list({ query: { directory } });
+      const data = result?.data;
+      const connected = data?.connected;
+      const all = data?.all;
+      if (Array.isArray(connected) && Array.isArray(all)) {
+        s.connected = new Set(connected.filter((id) => typeof id === "string"));
+        const credentialed = /* @__PURE__ */ new Set();
+        for (const entry of all) {
+          if (!entry || typeof entry !== "object") continue;
+          const rec = entry;
+          const id = typeof rec.id === "string" ? rec.id : void 0;
+          if (!id) continue;
+          if (typeof rec.key === "string" && rec.key.trim() !== "") {
+            credentialed.add(id);
+            continue;
+          }
+          const options2 = rec.options;
+          if (options2 && typeof options2 === "object") {
+            const opts2 = options2;
+            if (typeof opts2.apiKey === "string" && opts2.apiKey.trim() !== "") {
+              credentialed.add(id);
+              continue;
+            }
+            const baseURL = typeof opts2.baseURL === "string" ? opts2.baseURL.trim() : "";
+            if (baseURL !== "") {
+              const envArr2 = Array.isArray(rec.env) ? rec.env : [];
+              const hasCredEnv = envArr2.some((e) => typeof e === "string" && /key|token|secret|password|credential|auth/i.test(e));
+              if (!hasCredEnv) {
+                credentialed.add(id);
+                continue;
+              }
+            }
+          }
+          const envArr = Array.isArray(rec.env) ? rec.env : [];
+          for (const e of envArr) {
+            if (typeof e === "string" && /key|token|secret|password|credential|auth/i.test(e)) {
+              if (typeof process.env[e] === "string" && process.env[e].trim() !== "") {
+                credentialed.add(id);
+                break;
+              }
+            }
+          }
+        }
+        s.credentialed = credentialed;
+        s.connectedReady = true;
+      } else if (Array.isArray(connected)) {
+        s.connected = new Set(connected.filter((id) => typeof id === "string"));
+      }
+    } catch {
+    }
+  };
   init(s, (m) => void warnOnce(m));
   const sweepDirIfDue = () => {
     if (Date.now() - s.lastDirSweep < STATE_SWEEP_INTERVAL_MS) return;
@@ -2466,6 +2595,8 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
     }
   };
   const abortReports = /* @__PURE__ */ new Map();
+  const spawns = /* @__PURE__ */ new Map();
+  const observedErrors = /* @__PURE__ */ new Map();
   const abortKind = (reason) => isQuotaReason(reason) || isLimitText(reason) ? "rate-limit" : "provider error";
   const abortLabel = (kind, elapsedMs) => {
     const seconds = Math.max(1, Math.round(elapsedMs / 1e3));
@@ -2475,6 +2606,60 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
     if (kind === "permission") return `permission denied after ${seconds}s`;
     return `provider error after ${seconds}s`;
   };
+  const pendingCancelledParts = /* @__PURE__ */ new Map();
+  const patchedCancelledParts = /* @__PURE__ */ new Set();
+  const cancelledPrefix = "Task Cancelled by LaCode:";
+  const patchCancelledPart = async (part, key, report) => {
+    if (patchedCancelledParts.has(key)) return;
+    patchedCancelledParts.add(key);
+    if (patchedCancelledParts.size > 64) {
+      const oldest = patchedCancelledParts.values().next().value;
+      if (oldest !== void 0) patchedCancelledParts.delete(oldest);
+    }
+    const error = `${cancelledPrefix} ${report.message}`;
+    const updated = { ...part, state: { ...part.state, error } };
+    try {
+      const updater = client.part?.update;
+      if (typeof updater === "function") {
+        const result = await updater({
+          sessionID: part.sessionID,
+          messageID: part.messageID,
+          partID: part.id,
+          directory,
+          part: updated,
+          signal: AbortSignal.timeout(5e3)
+        });
+        if (!result?.response?.ok) throw new Error(`server answered HTTP ${result?.response?.status ?? "?"}`);
+        abortReports.delete(key);
+        return;
+      }
+      const url = new URL(
+        `/session/${encodeURIComponent(part.sessionID)}/message/${encodeURIComponent(part.messageID)}/part/${encodeURIComponent(part.id)}`,
+        serverUrl
+      );
+      if (directory) url.searchParams.set("directory", directory);
+      const headers = { "Content-Type": "application/json" };
+      if (directory) headers["x-opencode-directory"] = directory;
+      const password = process.env.OPENCODE_SERVER_PASSWORD;
+      if (password) {
+        const username = process.env.OPENCODE_SERVER_USERNAME ?? "opencode";
+        headers.Authorization = `Basic ${Buffer.from(`${username}:${password}`).toString("base64")}`;
+      }
+      const response = await fetch(url, {
+        method: "PATCH",
+        headers,
+        body: JSON.stringify({ ...part, state: { ...part.state, error } }),
+        signal: AbortSignal.timeout(5e3)
+      });
+      if (!response.ok) throw new Error(`${response.status} ${response.statusText}`.trim());
+      abortReports.delete(key);
+    } catch (cause) {
+      await log("warn", `could not rewrite cancelled task ${part.callID}: ${cause instanceof Error ? cause.message : String(cause)}`, {
+        session: part.sessionID,
+        callID: part.callID
+      });
+    }
+  };
   const noteAbort = async (key, report) => {
     abortReports.set(key, report);
     if (abortReports.size > 32) {
@@ -2488,11 +2673,10 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
       failure: report.kind,
       released: report.released
     });
-    try {
-      await client.tui?.showToast?.({
-        body: { title: "pool spawn", message: report.message, variant: "warning", duration: 8e3 }
-      });
-    } catch {
+    const pending = pendingCancelledParts.get(key);
+    if (pending) {
+      pendingCancelledParts.delete(key);
+      await patchCancelledPart(pending, key, report);
     }
   };
   const MAX_ABORT_ATTEMPTS = 3;
@@ -2726,6 +2910,12 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
     const slots = ensureSlots(s, (m) => void warnOnce(m));
     const agents = cfg.agent;
     const providers = cfg.provider;
+    const configCreds = /* @__PURE__ */ new Set();
+    for (const [id, entry] of Object.entries(providers ?? {})) {
+      const options2 = entry.options;
+      if (typeof options2?.apiKey === "string" && options2.apiKey.trim() !== "") configCreds.add(id);
+    }
+    s.configCreds = configCreds;
     const known = /* @__PURE__ */ new Set();
     for (const [name, def] of Object.entries(cfg.agent ?? {})) if (def?.model) s.models.set(name, def.model);
     for (const slot of slots) {
@@ -2760,6 +2950,11 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
       const provider = slot.model.slice(0, slash);
       const id = slot.model.slice(slash + 1);
       const entry = providers?.[provider];
+      if (!providerReady(s, slot.model)) {
+        await warnOnce(
+          `provider ${provider} is not connected in opencode; slot ${slot.index} (${slot.model}) is excluded from routing until it is authenticated (run \`opencode auth login ${provider}\` or remove the line)`
+        );
+      }
       if (!entry) {
         await warnOnce(`provider ${provider} is not configured in opencode.jsonc; slot ${slot.index} (${slot.model}) cannot resolve`);
         continue;
@@ -2891,12 +3086,69 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
             await log("debug", `probe session ${sessionID} ended with an error; not cooling anything`);
             return;
           }
+          const own = claimFor(sessionID);
+          const missing2 = isModelMissingText(haystack2);
           const status2 = typeof error?.data?.statusCode === "number" ? error.data.statusCode : void 0;
           const auth2 = isAuthFailureText(haystack2) || status2 === 401 || status2 === 403;
           const limited2 = isLimitText(haystack2) || status2 === 429;
           const outage = isUnavailableText(haystack2);
-          if (!limited2 && !outage && !auth2) return;
-          const own = claimFor(sessionID);
+          if (missing2) {
+            const unbound = !own && sessionID ? [...s.own.entries()].find(([, claim]) => !claim.g && claim.s === sessionID && haystack2.includes(claim.m)) : void 0;
+            const target = own ?? (unbound ? { key: unbound[0], claim: unbound[1] } : void 0);
+            const model2 = target?.claim.m;
+            if (model2) {
+              const strike2 = recordStrike(s, model2, MODEL_MISSING_REASON, MODEL_MISSING_COOLDOWN_MS);
+              if (strike2) {
+                await log("warn", `bench ${model2} (${MODEL_MISSING_REASON}, strike ${strike2.strikes}) after a terminal model-not-found error`, {
+                  model: model2,
+                  slot: target?.claim.k,
+                  session: sessionID
+                });
+              }
+            }
+            if (target) {
+              release(s, target.key);
+              await log("warn", `released ${target.claim.v} claim on ${target.claim.m} after a terminal model-not-found error`, {
+                base: target.claim.v,
+                model: target.claim.m,
+                slot: target.claim.k,
+                session: sessionID
+              });
+            }
+            return;
+          }
+          if (!limited2 && !outage && !auth2) {
+            if (own) {
+              const detail = haystack2.slice(0, 400);
+              recordFailure(s, {
+                ts: Date.now(),
+                source: "observed",
+                base: own.claim.v,
+                slot: own.claim.k,
+                model: own.claim.m,
+                session: sessionID,
+                reason: "provider error",
+                elapsedMs: Date.now() - own.claim.t,
+                released: true,
+                detail
+              });
+              if (!observedErrors.has(own.key)) {
+                observedErrors.set(own.key, { reason: "provider error", detail });
+                if (observedErrors.size > 32) {
+                  const oldest = observedErrors.keys().next().value;
+                  if (oldest !== void 0) observedErrors.delete(oldest);
+                }
+              }
+              release(s, own.key);
+              await log("warn", `released ${own.claim.v} claim on ${own.claim.m} after a terminal session error`, {
+                base: own.claim.v,
+                model: own.claim.m,
+                slot: own.claim.k,
+                session: sessionID
+              });
+            }
+            return;
+          }
           const named = auth2 ? AUTH_FAILURE_REASON : outage ? UNAVAILABLE_REASON : limitReason(haystack2) ?? "rate-limited";
           let stated2;
           if (own) {
@@ -2928,6 +3180,15 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
             }
           }
           await failOver(sessionID, own?.claim.m ?? "?", named, { stated: stated2, cool: !own });
+          if (own && s.own.has(own.key)) {
+            release(s, own.key);
+            await log("warn", `released ${own.claim.v} claim on ${own.claim.m} after a terminal session error (abort did not confirm)`, {
+              base: own.claim.v,
+              model: own.claim.m,
+              slot: own.claim.k,
+              session: sessionID
+            });
+          }
           return;
         }
         if (event.type === "session.created") {
@@ -2941,6 +3202,39 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
           const sessionID = info2?.sessionID ?? part?.sessionID;
           if (sessionID) noteActivity(s, sessionID);
         }
+        if (event.type === "message.part.updated") {
+          const part = props.part;
+          if (part?.type === "tool" && part.tool === "task" && part.state?.status === "error" && part.state.error === "Task cancelled" && part.id && part.sessionID && part.messageID && part.callID) {
+            const key = claimKey(part.sessionID, part.callID);
+            const full = part;
+            const report = abortReports.get(key);
+            if (report) {
+              await patchCancelledPart(full, key, report);
+            } else if (observedErrors.has(key)) {
+              const spawn3 = spawns.get(key);
+              const seen = observedErrors.get(key);
+              const elapsedMs = spawn3 ? Date.now() - spawn3.t : 0;
+              const failureReport = {
+                slot: spawn3?.slot ?? 0,
+                model: spawn3?.model ?? "?",
+                elapsedMs,
+                kind: seen.reason,
+                released: true,
+                message: `${spawn3?.model ?? "?"} \u2014 ${seen.reason}${seen.detail ? `: ${seen.detail.slice(0, 200)}` : ""}`
+              };
+              await patchCancelledPart(full, key, failureReport);
+              observedErrors.delete(key);
+              spawns.delete(key);
+            } else {
+              pendingCancelledParts.set(key, full);
+              if (pendingCancelledParts.size > 32) {
+                const oldest = pendingCancelledParts.keys().next().value;
+                if (oldest !== void 0) pendingCancelledParts.delete(oldest);
+              }
+            }
+          }
+          return;
+        }
         if (event.type !== "message.updated") return;
         const info = props.info;
         if (!info || info.role !== "assistant" || !info.error) return;
@@ -2950,13 +3244,62 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
         const limited = isLimitText(haystack) || status === 429;
         const gateway5xx = status !== void 0 && status >= 500 && status <= 599;
         const transientGateway = gateway5xx || isTransientGatewayText(haystack);
-        if (!limited && !transientGateway && !auth) return;
+        const missing = isModelMissingText(haystack);
+        if (!limited && !transientGateway && !auth && !missing) {
+          const ownMsgUnclassified = claimFor(info.sessionID);
+          if (ownMsgUnclassified) {
+            recordFailure(s, {
+              ts: Date.now(),
+              source: "observed",
+              base: ownMsgUnclassified.claim.v,
+              slot: ownMsgUnclassified.claim.k,
+              model: ownMsgUnclassified.claim.m,
+              session: info.sessionID,
+              reason: "provider error",
+              elapsedMs: Date.now() - ownMsgUnclassified.claim.t,
+              released: false,
+              detail: haystack.slice(0, 400)
+            });
+            if (!observedErrors.has(ownMsgUnclassified.key)) {
+              observedErrors.set(ownMsgUnclassified.key, { reason: "provider error", detail: haystack.slice(0, 400) });
+              if (observedErrors.size > 32) {
+                const oldest = observedErrors.keys().next().value;
+                if (oldest !== void 0) observedErrors.delete(oldest);
+              }
+            }
+          }
+          return;
+        }
         const model = `${info.providerID ?? "?"}/${info.modelID ?? "?"}`;
         if (info.sessionID && isProbe(s, info.sessionID)) {
           await log("debug", `probe of ${model} hit a limit (${isLimitText(haystack) ? "limit" : "transient"}); leaving the cooldown to the probe`);
           return;
         }
         const ownMsg = claimFor(info.sessionID);
+        if (missing) {
+          const ownMsgMissing = ownMsg;
+          const missingModel = ownMsgMissing?.claim.m ?? model;
+          if (missingModel !== "?/?") {
+            const strike2 = recordStrike(s, missingModel, MODEL_MISSING_REASON, MODEL_MISSING_COOLDOWN_MS);
+            if (strike2) {
+              await log("warn", `bench ${missingModel} (${MODEL_MISSING_REASON}, strike ${strike2.strikes}) after a model-not-found error`, {
+                model: missingModel,
+                slot: ownMsgMissing?.claim.k,
+                session: info.sessionID
+              });
+            }
+          }
+          if (ownMsgMissing) {
+            release(s, ownMsgMissing.key);
+            await log("warn", `released ${ownMsgMissing.claim.v} claim on ${ownMsgMissing.claim.m} after a model-not-found error`, {
+              base: ownMsgMissing.claim.v,
+              model: ownMsgMissing.claim.m,
+              slot: ownMsgMissing.claim.k,
+              session: info.sessionID
+            });
+          }
+          return;
+        }
         if (isUnavailableText(haystack) || !limited && !auth && transientGateway) {
           const transient = coolUnavailable(s, model);
           if (transient) await log("warn", `cooling ${model} for ${Math.round((transient.until - Date.now()) / 1e3)}s (${transient.reason})`);
@@ -2991,6 +3334,7 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
       }
       try {
         await reapStuck();
+        await refreshProviders();
         refreshCatalog(s, serverUrl);
         const snap = snapshot(s);
         if (BASES.includes(requested)) {
@@ -3008,7 +3352,9 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
             load: (snap.counts.get(slot.index) ?? 0) + 1
           });
           output.args.subagent_type = variant;
-          acquire(s, requested, slot, input.sessionID, claimKey(input.sessionID, input.callID));
+          const routeKey = claimKey(input.sessionID, input.callID);
+          acquire(s, requested, slot, input.sessionID, routeKey);
+          spawns.set(routeKey, { base: requested, slot: slot.index, model: slot.model, t: Date.now() });
           return;
         }
         const pinned = s.models.get(requested);
@@ -3025,15 +3371,30 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
     "tool.execute.after": async (input, output) => {
       if (input.tool !== "task") return;
       const key = claimKey(input.sessionID, input.callID);
+      const spawn3 = spawns.get(key);
       release(s, key);
+      const text = typeof output.output === "string" ? output.output : "";
+      const failed = abortReports.has(key) || /task\s+cancel+ed/i.test(text);
+      spawns.delete(key);
       const report = abortReports.get(key);
       if (!report) return;
       abortReports.delete(key);
+      recordFailure(s, {
+        ts: Date.now(),
+        source: "pool",
+        base: void 0,
+        slot: report.slot,
+        model: report.model,
+        session: input.sessionID,
+        reason: report.kind,
+        elapsedMs: report.elapsedMs,
+        released: report.released,
+        detail: report.message
+      });
       const detail = [
-        `pool spawn: ${report.message}`,
+        `Task Cancelled by LaCode: ${report.message}`,
         `slot ${report.slot}; model ${report.model}; elapsed ${report.elapsedMs}ms; failure ${report.kind}; claim ${report.released ? "released" : "held"}`
       ].join("\n");
-      const text = typeof output.output === "string" ? output.output : "";
       output.output = /task\s+cancel+ed/i.test(text) ? detail : text ? `${text}
 
 ${detail}` : detail;
@@ -3045,6 +3406,7 @@ ${detail}` : detail;
           models: tool.schema.array(tool.schema.string()).optional().describe("Model ids to validate, as provider/model-id. Omit to probe only the models that are cooling.")
         },
         async execute(args) {
+          await refreshProviders(true);
           const models = args?.models;
           const report = models && models.length > 0 ? await runValidation(models) : await runProbe();
           return { title: `agent-pool: ${reportTitle(report)}`, output: reportText(report) };
@@ -3054,6 +3416,7 @@ ${detail}` : detail;
         description: "Show live pool load across every opencode process, per free model and per agent type, each slot's load against its ceiling, the slot marked <- next that the next spawn would take, and which models are cooling after a rate limit or a stuck task; COOLING/UNAVAILABLE = not routable. Check it before launching many parallel subagents.",
         args: {},
         async execute() {
+          await refreshProviders(true);
           refreshCatalog(s, serverUrl);
           const slots = ensureSlots(s, (m) => void warnOnce(m));
           const snap = snapshot(s);
@@ -3076,6 +3439,7 @@ ${detail}` : detail;
             const status = s.catalog.get(slot.model);
             const notes = [
               strike ? `UNAVAILABLE (COOLING ${Math.ceil((strike.until - now) / 1e3)}s, ${strike.reason}, strike ${strike.strikes})` : "",
+              !providerReady(s, slot.model) ? `UNAVAILABLE (provider-unconfigured: ${providerOf(slot.model)}; run \`opencode auth login ${providerOf(slot.model)}\`)` : "",
               status && status !== "active" && status !== "unknown" ? `catalog:${status}` : ""
             ].filter(Boolean);
             const marker = slot.index === next.index ? " <- next" : "";
@@ -3119,7 +3483,38 @@ one ordered pass in slot order: each slot fills to its weight, then overflow goe
               // different situations and this is the line that tells them apart.
               probeMs > 0 ? `cooldown probe: last ${s.lastProbe ? `${Math.max(0, Math.round((now - s.lastProbe) / 1e3))}s ago` : coolingNow.length > 0 ? "never in this process (cooldowns came from disk)" : "never (nothing has been cooling)"}, every ${Math.round(probeMs / 6e4)}m; call the pool_recheck tool (or run /pool-recheck) to ask now.` : "cooldown probe: off (probeMs: 0); call the pool_recheck tool (or run /pool-recheck) to ask now.",
               watchMs > 0 ? `pool config watch: ${sources.join(", ")} every ${watchMs}ms; a change reloads the slot table and validates every slot.` : "pool config watch: off (watchMs: 0).",
-              coolingNow.length === 0 ? "no models cooling down." : `unavailable/cooling: ${coolingNow.map(([m, st]) => `${m} for ${Math.ceil((st.until - now) / 1e3)}s`).join(", ")}`
+              coolingNow.length === 0 ? "no models cooling down." : `unavailable/cooling: ${coolingNow.map(([m, st]) => `${m} for ${Math.ceil((st.until - now) / 1e3)}s`).join(", ")}`,
+              (() => {
+                const recent = readFailures(s, 5);
+                if (recent.length === 0) {
+                  return "recent failures: none recorded";
+                }
+                const all = readFailures(s, 1e3);
+                const total2 = all.length;
+                const fmtAge = (ts) => {
+                  const diff = Math.max(0, Date.now() - ts);
+                  const sAge = Math.floor(diff / 1e3);
+                  if (sAge < 60) return `${sAge}s`;
+                  const mAge = Math.floor(sAge / 60);
+                  if (mAge < 60) return `${mAge}m`;
+                  const hAge = Math.floor(mAge / 60);
+                  if (hAge < 24) return `${hAge}h`;
+                  const dAge = Math.floor(hAge / 24);
+                  return `${dAge}d`;
+                };
+                const lines = [`recent failures: ${total2} recorded in ${s.dir}/failures.jsonl`];
+                const ordered = [...recent].reverse();
+                for (const rec of ordered) {
+                  const age = fmtAge(rec.ts);
+                  const slot = rec.slot === void 0 || rec.slot === null ? "-" : rec.slot;
+                  const model = rec.model;
+                  const reason = rec.reason;
+                  const source = rec.source;
+                  const suffix = source === "observed" ? " (unclassified)" : "";
+                  lines.push(`  ${age} ago  slot ${slot} ${model}  ${reason}  [${source}]${suffix}`);
+                }
+                return lines.join("\n");
+              })()
             ].join("\n")
           };
         }
@@ -5940,7 +6335,7 @@ import { writeFileSync as writeFileSync8, renameSync as renameSync6, rmSync as r
 import { tool as tool2 } from "@opencode-ai/plugin";
 
 // src/lib/timeline.ts
-import { appendFileSync, mkdirSync as mkdirSync7, readFileSync as readFileSync10, rmSync as rmSync2 } from "node:fs";
+import { appendFileSync as appendFileSync2, mkdirSync as mkdirSync7, readFileSync as readFileSync10, rmSync as rmSync2 } from "node:fs";
 import { homedir as homedir7 } from "node:os";
 import { dirname as dirname5, join as join11, resolve as resolve4 } from "node:path";
 function timelineDir() {
@@ -5989,7 +6384,7 @@ function appendEntriesAt(file, texts, now, through) {
     const ts = now ?? Date.now();
     const line = { ts, text: t };
     if (validThrough) line.through = validThrough;
-    appendFileSync(file, JSON.stringify(line) + "\n");
+    appendFileSync2(file, JSON.stringify(line) + "\n");
     count++;
   }
   return count;
@@ -6529,20 +6924,32 @@ function timelineHooks(input, options) {
       }
     }
   }
+  async function resolveRootSession(id) {
+    let current = id;
+    const seen = /* @__PURE__ */ new Set();
+    while (true) {
+      if (seen.has(current)) return current;
+      seen.add(current);
+      const info = await client.session.get({ path: { id: current }, query: { directory } }).then((result) => result?.data).catch(() => void 0);
+      if (!info?.parentID) return current;
+      current = info.parentID;
+    }
+  }
   async function reprocess(id, abort) {
-    if (reprocessing.has(id)) return "A timeline reprocess is already running for this session.";
-    if (sessions.get(id)?.running) return "The timeline is currently summarizing this session; try again in a moment.";
-    reprocessing.add(id);
-    const targetFile = timelineFile(id);
+    const rootId = await resolveRootSession(id);
+    if (reprocessing.has(rootId)) return "A timeline reprocess is already running for this session.";
+    if (sessions.get(rootId)?.running) return "The timeline is currently summarizing this session; try again in a moment.";
+    reprocessing.add(rootId);
+    const targetFile = timelineFile(rootId);
     const temp = targetFile + ".reprocess." + process.pid + "." + Date.now() + ".tmp";
     let cursor;
     let entries = 0;
     let calls = 0;
     try {
-      const infoRes = await client.session.get({ path: { id }, query: { directory } });
+      const infoRes = await client.session.get({ path: { id: rootId }, query: { directory } });
       const info = infoRes?.data;
       if (!info) return "Session not found.";
-      const msgRes = await client.session.messages({ path: { id }, query: { directory } });
+      const msgRes = await client.session.messages({ path: { id: rootId }, query: { directory } });
       const messages = msgRes?.data ?? [];
       writeFileSync8(temp, "");
       for (let i = 0; i < MAX_REPROCESS_SLICES; i++) {
@@ -6556,7 +6963,7 @@ function timelineHooks(input, options) {
         const excerpt = buildExcerpt(messages, cursor);
         if (!excerpt.text) break;
         const prior = readEntriesAt(temp, 4);
-        const result = await summarize(id, info.title ?? "untitled", excerpt.text, prior, abort);
+        const result = await summarize(rootId, info.title ?? "untitled", excerpt.text, prior, abort);
         calls++;
         if (!result.ok) {
           try {
@@ -6585,7 +6992,7 @@ function timelineHooks(input, options) {
         return "No entries generated; previous timeline kept.";
       }
       renameSync6(temp, targetFile);
-      const state2 = sessions.get(id);
+      const state2 = sessions.get(rootId);
       if (state2) {
         state2.cursor = cursor;
         state2.failures = 0;
@@ -6599,11 +7006,11 @@ function timelineHooks(input, options) {
       }
       return `Reprocess failed: ${String(error)}. Previous timeline kept.`;
     } finally {
-      reprocessing.delete(id);
+      reprocessing.delete(rootId);
     }
   }
   const timelineReprocess = tool2({
-    description: "Rebuild the current session's entire timeline from its transcript, replacing the existing entries. Used by /reprocess-timeline.",
+    description: "Rebuild the root session's entire timeline from its transcript, replacing the existing entries. Used by /reprocess-timeline.",
     args: {},
     execute: async (_args, ctx) => {
       const output = await reprocess(ctx.sessionID, ctx.abort);

package/dist/lacode.js

@@ -7,7 +7,7 @@ import { spawnSync as spawnSync3 } from "node:child_process";
 
 // src/tunnel/index.ts
 import { spawn, spawnSync } from "node:child_process";
-import { appendFileSync, existsSync as existsSync2, mkdirSync as mkdirSync3, readFileSync as readFileSync4, unlinkSync as unlinkSync3 } from "node:fs";
+import { appendFileSync as appendFileSync2, 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";
 
@@ -17,7 +17,7 @@ import { homedir as homedir2 } from "node:os";
 import { basename, 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 { appendFileSync, 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";
 
@@ -43,9 +43,11 @@ var PACKAGE_ROOT = findPackageRoot(dirname(fileURLToPath(import.meta.url)));
 
 // src/lib/pool.ts
 var CLAIM_TTL_MS = 10 * 60 * 1e3;
+var UNBOUND_CLAIM_MS = 2 * 60 * 1e3;
 var DEAD_FILE_MS = 2 * CLAIM_TTL_MS;
 var ORPHAN_TMP_MS = 60 * 1e3;
 var CATALOG_TTL_MS = 10 * 60 * 1e3;
+var PROVIDER_LIST_TTL_MS = 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;
@@ -262,7 +264,7 @@ var recordNotificationId = (correlationKey, id) => {
   if (!isNotificationId(id)) return false;
   try {
     mkdirSync3(notificationStateDir(), { recursive: true });
-    appendFileSync(notificationIdFile(correlationKey), `${id}
+    appendFileSync2(notificationIdFile(correlationKey), `${id}
 `, "utf8");
     return true;
   } catch {

package/dist/pool.js

@@ -1,5 +1,5 @@
 // src/lib/pool.ts
-import { existsSync, mkdirSync, readdirSync, readFileSync as readFileSync2, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { appendFileSync, 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";
 
@@ -25,9 +25,11 @@ var PACKAGE_ROOT = findPackageRoot(dirname(fileURLToPath(import.meta.url)));
 
 // src/lib/pool.ts
 var CLAIM_TTL_MS = 10 * 60 * 1e3;
+var UNBOUND_CLAIM_MS = 2 * 60 * 1e3;
 var DEAD_FILE_MS = 2 * CLAIM_TTL_MS;
 var ORPHAN_TMP_MS = 60 * 1e3;
 var CATALOG_TTL_MS = 10 * 60 * 1e3;
+var PROVIDER_LIST_TTL_MS = 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;
@@ -294,6 +296,11 @@ function state(opts = {}) {
       reaping: false,
       lastSweep: 0,
       lastDirSweep: 0,
+      connected: /* @__PURE__ */ new Set(),
+      connectedAt: 0,
+      connectedReady: false,
+      credentialed: /* @__PURE__ */ new Set(),
+      configCreds: /* @__PURE__ */ new Set(),
       id,
       dir,
       modelsFile,
@@ -401,9 +408,16 @@ function sweepStateDir(s) {
   }
   return removed;
 }
+var claimExpired = (claim, now) => now - (claim.hb ?? claim.t) > CLAIM_TTL_MS || !claim.g && now - claim.t > UNBOUND_CLAIM_MS;
 function pruneOwn(s) {
   const now = Date.now();
-  for (const [key, claim] of s.own) if (now - (claim.hb ?? claim.t) > CLAIM_TTL_MS) s.own.delete(key);
+  let removed = false;
+  for (const [key, claim] of s.own)
+    if (claimExpired(claim, now)) {
+      s.own.delete(key);
+      removed = true;
+    }
+  if (removed) publish(s);
 }
 function pruneActivity(s, now) {
   if (s.activity.size === 0) return;
@@ -431,7 +445,7 @@ function publish(s) {
   if (!s.dirReady) return;
   const now = Date.now();
   const payload = {};
-  for (const [key, claim] of s.own) if (now - (claim.hb ?? claim.t) <= CLAIM_TTL_MS) payload[key] = claim;
+  for (const [key, claim] of s.own) if (!claimExpired(claim, now)) payload[key] = claim;
   try {
     writeFileSync(join2(s.dir, `${selfFile(s.id)}.tmp`), JSON.stringify(payload));
     renameSync(join2(s.dir, `${selfFile(s.id)}.tmp`), join2(s.dir, selfFile(s.id)));
@@ -490,7 +504,7 @@ function readSiblings(s) {
     try {
       const parsed = JSON.parse(readFileSync2(path, "utf8"));
       const claims = Object.values(parsed).filter(
-        (c) => c && typeof c.v === "string" && typeof c.m === "string" && typeof c.k === "number" && Number.isFinite(c.k) && now - (c.hb ?? c.t) <= CLAIM_TTL_MS
+        (c) => c && typeof c.v === "string" && typeof c.m === "string" && typeof c.k === "number" && Number.isFinite(c.k) && !claimExpired(c, now)
       );
       siblings.push({ id: match[1], claims });
     } catch {
@@ -629,6 +643,12 @@ function clearCooldowns(s, models) {
 var markProbe = (s, sessionID) => s.probes.add(sessionID);
 var unmarkProbe = (s, sessionID) => s.probes.delete(sessionID);
 var isProbe = (s, sessionID) => s.probes.has(sessionID);
+function providerReady(s, model) {
+  if (!s.connectedReady) return true;
+  const provider = providerOf(model);
+  if (!s.connected.has(provider)) return false;
+  return s.credentialed.has(provider) || s.configCreds.has(provider) || provider === "opencode";
+}
 function refreshCatalog(s, serverUrl) {
   if (!serverUrl || Date.now() - s.catalogAt < CATALOG_TTL_MS) return;
   s.catalogAt = Date.now();
@@ -645,6 +665,7 @@ function refreshCatalog(s, serverUrl) {
   })();
 }
 function isAvailable(s, model, cooling) {
+  if (!providerReady(s, model)) return false;
   if (cooling.has(model)) return false;
   const status = s.catalog.get(model);
   return status === void 0 || status === "active" || status === "unknown";
@@ -664,8 +685,9 @@ var loadOf = (counts, slot) => counts.get(slot) ?? 0;
 var underCeiling = (slot, counts) => loadOf(counts, slot.index) < slotCeiling(slot);
 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;
+  const configured = slots.filter((slot) => providerReady(s, slot.model));
+  const usable = configured.filter((slot) => isAvailable(s, slot.model, snap.cooling));
+  const pool = usable.length > 0 ? usable : configured.length > 0 ? configured : slots;
   for (const slot of usable) {
     if (loadOf(snap.counts, slot.index) < slot.weight) return slot;
   }
@@ -780,6 +802,56 @@ function coolProvider(s, provider, until, reason) {
   }
   return affected;
 }
+function recordFailure(s, f) {
+  try {
+    const path = join2(s.dir, "failures.jsonl");
+    const trimSize = 64 * 1024;
+    const keepLines = 200;
+    if (existsSync(path)) {
+      const st = statSync(path);
+      if (typeof st.size === "number" && st.size > trimSize) {
+        try {
+          const content = readFileSync2(path, "utf8");
+          const parts = content.split("\n");
+          const lines = parts.filter((line) => line.length > 0);
+          if (lines.length > keepLines) {
+            const kept = lines.slice(lines.length - keepLines);
+            writeFileSync(`${path}.tmp`, kept.join("\n") + "\n");
+            renameSync(`${path}.tmp`, path);
+          } else if (lines.length === 0 && parts.length >= 1) {
+          }
+        } catch {
+        }
+      }
+    }
+    appendFileSync(path, JSON.stringify(f) + "\n");
+  } catch (error) {
+    console.error("[agent-pool] failed to record failure:", String(error));
+  }
+}
+function readFailures(s, limit) {
+  const path = join2(s.dir, "failures.jsonl");
+  try {
+    if (!existsSync(path)) return [];
+    const content = readFileSync2(path, "utf8");
+    const parts = content.split("\n");
+    const records = [];
+    for (let i = 0; i < parts.length; i++) {
+      const line = parts[i];
+      if (line.length === 0) continue;
+      try {
+        const parsed = JSON.parse(line);
+        records.push(parsed);
+      } catch {
+      }
+    }
+    if (limit <= 0) return [];
+    if (records.length <= limit) return records;
+    return records.slice(records.length - limit);
+  } catch {
+    return [];
+  }
+}
 export {
   AUTH_FAILURE_COOLDOWN_MS,
   AUTH_FAILURE_REASON,
@@ -797,6 +869,7 @@ export {
   ORPHAN_TMP_MS,
   PACKAGE_ROOT,
   PRESETS_DIR,
+  PROVIDER_LIST_TTL_MS,
   QUOTA_COOLDOWN_BASE_MS,
   QUOTA_COOLDOWN_MAX_MS,
   SLOTS_WARN_AT,
@@ -806,6 +879,7 @@ export {
   STUCK_MIN_AGE_MS,
   UNAVAILABLE_COOLDOWN_MS,
   UNAVAILABLE_REASON,
+  UNBOUND_CLAIM_MS,
   USER_CONFIG_DIR,
   USER_MODELS_PATH,
   USER_MODELS_TXT,
@@ -841,12 +915,15 @@ export {
   pickSlot,
   poolPass,
   providerOf,
+  providerReady,
   pruneOwn,
   pruneSessions,
   publish,
+  readFailures,
   readLimits,
   readSiblings,
   readSlotFile,
+  recordFailure,
   recordStrike,
   refreshCatalog,
   release,

package/dist/tunnel.js

@@ -1,6 +1,6 @@
 // src/tunnel/index.ts
 import { spawn, spawnSync } from "node:child_process";
-import { appendFileSync, existsSync as existsSync2, mkdirSync as mkdirSync3, readFileSync as readFileSync4, unlinkSync as unlinkSync3 } from "node:fs";
+import { appendFileSync as appendFileSync2, 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";
 
@@ -10,7 +10,7 @@ import { homedir as homedir2 } from "node:os";
 import { basename, 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 { appendFileSync, 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";
 
@@ -36,9 +36,11 @@ var PACKAGE_ROOT = findPackageRoot(dirname(fileURLToPath(import.meta.url)));
 
 // src/lib/pool.ts
 var CLAIM_TTL_MS = 10 * 60 * 1e3;
+var UNBOUND_CLAIM_MS = 2 * 60 * 1e3;
 var DEAD_FILE_MS = 2 * CLAIM_TTL_MS;
 var ORPHAN_TMP_MS = 60 * 1e3;
 var CATALOG_TTL_MS = 10 * 60 * 1e3;
+var PROVIDER_LIST_TTL_MS = 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;
@@ -255,7 +257,7 @@ var recordNotificationId = (correlationKey, id) => {
   if (!isNotificationId(id)) return false;
   try {
     mkdirSync3(notificationStateDir(), { recursive: true });
-    appendFileSync(notificationIdFile(correlationKey), `${id}
+    appendFileSync2(notificationIdFile(correlationKey), `${id}
 `, "utf8");
     return true;
   } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lawaty/lacode",
-  "version": "1.2.0",
+  "version": "1.3.0-beta.1",
   "description": "Ultimate opencode setup for Go users — cost-controlled pooled subagents, hang recovery, and notifications for opencode.",
   "license": "MIT",
   "type": "module",