@lawaty/lacode 1.2.0 → 1.3.0-beta.0

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

@@ -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

@@ -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

@@ -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;
   }
@@ -2439,6 +2461,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;
@@ -2475,6 +2554,44 @@ 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}`;
+    try {
+      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" };
+      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 +2605,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 +2842,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 +2882,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 +3018,49 @@ 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) {
+              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 +3092,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 +3114,24 @@ 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 {
+              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 +3141,38 @@ 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) 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 +3207,7 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
       }
       try {
         await reapStuck();
+        await refreshProviders();
         refreshCatalog(s, serverUrl);
         const snap = snapshot(s);
         if (BASES.includes(requested)) {
@@ -3030,7 +3247,7 @@ var agentPoolHooks = (async ({ client, serverUrl, directory }, options) => {
       if (!report) return;
       abortReports.delete(key);
       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 : "";
@@ -3045,6 +3262,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 +3272,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 +3295,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" : "";
@@ -6529,20 +6749,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 +6788,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 +6817,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 +6831,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

@@ -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;

package/dist/pool.js

@@ -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;
   }
@@ -797,6 +819,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 +829,7 @@ export {
   STUCK_MIN_AGE_MS,
   UNAVAILABLE_COOLDOWN_MS,
   UNAVAILABLE_REASON,
+  UNBOUND_CLAIM_MS,
   USER_CONFIG_DIR,
   USER_MODELS_PATH,
   USER_MODELS_TXT,
@@ -841,6 +865,7 @@ export {
   pickSlot,
   poolPass,
   providerOf,
+  providerReady,
   pruneOwn,
   pruneSessions,
   publish,

package/dist/tunnel.js

@@ -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;

package/package.json

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