@indigoai-us/hq-cli 5.154.0 → 5.156.0

package/dist/lib/lanes/spawn.js

@@ -11,18 +11,21 @@ import { spawn, spawnSync } from "node:child_process";
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { fileURLToPath } from "node:url";
-import { PROVIDER_HOME_ENV, accountStatus, isLoggedOut, resolveAccount, } from "./accounts.js";
+import { PROVIDER_HOME_ENV, accountStatus, isLoggedOut, resolveAccount, selectBalancedAccount, } from "./accounts.js";
 import { COMPACTION_PROMPT, compactionAfterUsage, compactionDue, compactLaneSession, } from "./compaction.js";
 import { installDrainHook } from "./hooks-install.js";
 import { loadLanesConfig, providerAutoCompactTokens, providerCompactAfterMs, } from "./config.js";
 import { appendEffortFlag, resolveLaneEffort } from "./effort.js";
-import { validateProfileLaneModel, } from "./models.js";
+import { defaultProbe, validateLaneModel, validateProfileLaneModel, } from "./models.js";
 import { claimableStatesFor, planLaneLaunch, providerSupportsSessionResume, } from "./delivery.js";
 import { AccountResolutionError, LanesError } from "./errors.js";
 import { ignoredWorkerProfileFields, loadWorkerProfile, materializeWorkerProfile, workerProfilePrompt, } from "./profile.js";
 import { resolveMachineIdentity, } from "./machine-identity.js";
-import { readLane, retryUpdateLane } from "./store.js";
+import { appendCappedHistory, listLaneIds, readLane, retryUpdateLane } from "./store.js";
+import { copySessionFiles, planSessionCopy } from "./move-account.js";
 import { ensureSessionHome } from "./session-relink.js";
+import { hasEarlierEligibleQueuedLane, laneAdmissionCapReason, withLaneAdmissionLock, } from "./admission.js";
+import { resolveAdmissionHost } from "./admission-host.js";
 import { LANE_ENVELOPE_JSON_SCHEMA, parseLaneProvider, } from "./types.js";
 export const LANES_RUNS_REL = path.join("workspace", "lanes-runs");
 /** Written by reconcile before a resume spawn; the worker prompt names this path. */
@@ -101,6 +104,365 @@ export function resolveLaneModel(input) {
     }
     return undefined;
 }
+function accountModelForSpawn(provider, accountId, config, pinnedModel, profileModel) {
+    return resolveLaneModel({
+        cliModel: pinnedModel,
+        profileModel,
+        accountModel: config.providers[provider].accounts[accountId]?.model,
+        providerModel: config.providers[provider].model,
+    });
+}
+function supportsSpawnModel(provider, accountId, config, pinnedModel, profileModel, modelDeps) {
+    const account = config.providers[provider].accounts[accountId];
+    if (account === undefined)
+        return false;
+    const model = accountModelForSpawn(provider, accountId, config, pinnedModel, profileModel);
+    if (model === undefined)
+        return true;
+    try {
+        validateLaneModel(provider, model, account.home, modelDeps);
+        return true;
+    }
+    catch (err) {
+        if (err instanceof LanesError && err.error === "model_unsupported")
+            return false;
+        throw err;
+    }
+}
+function spawnModelFailure(provider, accountId, config, pinnedModel, profileModel, profileId, modelDeps) {
+    const account = config.providers[provider].accounts[accountId];
+    if (account === undefined)
+        return new LanesError("unknown_account", `Unknown account ${accountId} for ${provider}`, { provider, account: accountId });
+    const model = accountModelForSpawn(provider, accountId, config, pinnedModel, profileModel);
+    if (model === undefined)
+        return null;
+    try {
+        validateLaneModel(provider, model, account.home, modelDeps);
+        return null;
+    }
+    catch (err) {
+        if (!(err instanceof LanesError) || err.error !== "model_unsupported")
+            throw err;
+        if (profileModel !== undefined && pinnedModel === undefined && profileId !== undefined) {
+            return new LanesError(err.error, err.message, {
+                ...err.details,
+                profile_id: profileId,
+                worker_profile: profileId,
+                model_source: "profile",
+            });
+        }
+        return err;
+    }
+}
+function selectSpawnAccount(input) {
+    const { hqRoot, lane, config, existsSync, accountDeps, modelDeps, pinnedModel, profileModel, currentModelValidated } = input;
+    const context = {
+        hqRoot,
+        existsSync,
+        accountDeps,
+        ...(pinnedModel ?? profileModel ? { model: pinnedModel ?? profileModel } : {}),
+    };
+    if (lane.account === undefined) {
+        const modelSpecified = pinnedModel !== undefined || profileModel !== undefined;
+        const allowedAccounts = modelSpecified
+            ? Object.keys(config.providers[lane.provider].accounts).filter((id) => supportsSpawnModel(lane.provider, id, config, pinnedModel, profileModel, modelDeps))
+            : undefined;
+        return {
+            account: selectBalancedAccount(lane.provider, config, {
+                ...context,
+                ...(allowedAccounts !== undefined ? { allowedAccounts } : {}),
+                preferredAccounts: config.providers[lane.provider].preferred_accounts ?? [],
+            }),
+            changeReason: "first_assignment",
+        };
+    }
+    const current = config.providers[lane.provider].accounts[lane.account];
+    let reason;
+    let refusal;
+    const operatorMovePending = lane.pending_resume !== undefined &&
+        lane.account_history?.at(-1)?.reason === "operator_move";
+    if (current === undefined || !current.enabled) {
+        reason = "account_unavailable";
+        refusal = new AccountResolutionError(current === undefined ? "unknown_account" : "account_disabled", `Account ${JSON.stringify(lane.account)} is unavailable for ${lane.provider}`, { provider: lane.provider, account: lane.account });
+    }
+    else {
+        const status = accountStatus(lane.provider, lane.account, config, {
+            existsSync,
+            ...(accountDeps?.probe ? { probe: accountDeps.probe } : {}),
+            ...(accountDeps?.env ? { env: accountDeps.env } : {}),
+        });
+        if (isLoggedOut(status)) {
+            reason = "account_unavailable";
+            refusal = new LanesError("account_not_logged_in", `Account ${lane.account} for ${lane.provider} is not logged in`, { provider: lane.provider, account: lane.account });
+        }
+        else {
+            try {
+                resolveAccount(lane.provider, lane.account, config, context);
+                const modelFailure = currentModelValidated
+                    ? null
+                    : spawnModelFailure(lane.provider, lane.account, config, pinnedModel, profileModel, lane.worker_profile, modelDeps);
+                if (modelFailure !== null) {
+                    reason = "model_change";
+                    refusal = modelFailure;
+                }
+                else {
+                    return { account: resolveAccount(lane.provider, lane.account, config, context) };
+                }
+            }
+            catch (err) {
+                if (err instanceof AccountResolutionError && err.error === "account_quota_exhausted") {
+                    reason = "usage_limit";
+                    refusal = err;
+                }
+                else if (err instanceof AccountResolutionError && err.error === "account_model_unavailable") {
+                    reason = "usage_limit";
+                    refusal = err;
+                }
+                else if (err instanceof LanesError && err.error === "model_unsupported") {
+                    reason = "model_change";
+                    refusal = err;
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+    }
+    if (operatorMovePending) {
+        if (refusal instanceof Error)
+            throw refusal;
+        throw new LanesError("account_unavailable", `Explicit account move target ${lane.account} is unavailable`, {
+            provider: lane.provider,
+            account: lane.account,
+        });
+    }
+    const allowedAccounts = Object.entries(config.providers[lane.provider].accounts)
+        .filter(([id, account]) => id !== lane.account && account.enabled)
+        .filter(([id]) => accountStatus(lane.provider, id, config, {
+        existsSync,
+        ...(accountDeps?.probe ? { probe: accountDeps.probe } : {}),
+        ...(accountDeps?.env ? { env: accountDeps.env } : {}),
+    }).logged_in === true)
+        .filter(([id]) => supportsSpawnModel(lane.provider, id, config, pinnedModel, profileModel, modelDeps))
+        .map(([id]) => id);
+    try {
+        return {
+            account: selectBalancedAccount(lane.provider, config, { ...context, allowedAccounts }),
+            changeReason: reason,
+        };
+    }
+    catch (err) {
+        if (reason === "account_unavailable") {
+            if (refusal instanceof Error)
+                throw refusal;
+            throw new LanesError("account_not_logged_in", `Account ${lane.account} for ${lane.provider} is not logged in or available, and no other logged-in account can serve this lane`, { provider: lane.provider, account: lane.account });
+        }
+        if (refusal instanceof Error)
+            throw refusal;
+        throw err;
+    }
+}
+function previouslyUnavailableAccounts(lane) {
+    const excluded = new Set();
+    for (const entry of [...(lane.account_history ?? [])].reverse()) {
+        if (entry.reason === "first_assignment" || entry.reason === "operator_move")
+            break;
+        if (entry.reason === "account_unavailable" && entry.from !== null)
+            excluded.add(entry.from);
+    }
+    return excluded;
+}
+function archivedResumeMessageText(hqRoot, laneId, messageId) {
+    if (!messageId || /[\\/\0]/.test(messageId))
+        return undefined;
+    const file = path.join(laneRunDir(hqRoot, laneId), "dropbox", "delivered", `${messageId}.resume.jsonl`);
+    let raw;
+    try {
+        raw = fs.readFileSync(file, "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return undefined;
+        throw new LanesError("account_retry_context_unreadable", `Could not read the archived message needed to resume lane ${laneId}`, { lane_id: laneId, message_id: messageId });
+    }
+    const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
+    if (lines.length !== 1) {
+        throw new LanesError("account_retry_context_invalid", `The archived message needed to resume lane ${laneId} is malformed`, { lane_id: laneId, message_id: messageId });
+    }
+    let value;
+    try {
+        value = JSON.parse(lines[0]);
+    }
+    catch {
+        throw new LanesError("account_retry_context_invalid", `The archived message needed to resume lane ${laneId} is malformed`, { lane_id: laneId, message_id: messageId });
+    }
+    if (value === null ||
+        typeof value !== "object" ||
+        value.message_id !== messageId ||
+        typeof value.text !== "string") {
+        throw new LanesError("account_retry_context_invalid", `The archived message needed to resume lane ${laneId} is malformed`, { lane_id: laneId, message_id: messageId });
+    }
+    return value.text;
+}
+function pendingResumeForRetry(hqRoot, lane, sessionId, at) {
+    const last = lane.last_resume;
+    if (last === undefined || last.session_id !== sessionId) {
+        return { session_id: sessionId, trigger: "resume", resumed_from: "interrupted", at };
+    }
+    const compact = last.compact === undefined ? {} : { compact: last.compact };
+    if (last.trigger === "answered_questions") {
+        return { session_id: sessionId, trigger: "answered_questions", at, ...compact };
+    }
+    if (last.trigger === "message") {
+        if (last.message_id === undefined) {
+            throw new LanesError("account_retry_context_missing", `The message id needed to resume lane ${lane.lane_id} is missing`, { lane_id: lane.lane_id, trigger: last.trigger });
+        }
+        const text = last.text ?? archivedResumeMessageText(hqRoot, lane.lane_id, last.message_id);
+        if (text === undefined) {
+            throw new LanesError("account_retry_context_missing", `The operator message needed to resume lane ${lane.lane_id} is unavailable`, { lane_id: lane.lane_id, message_id: last.message_id });
+        }
+        return {
+            session_id: sessionId,
+            trigger: "message",
+            text,
+            message_id: last.message_id,
+            at,
+            ...compact,
+        };
+    }
+    return {
+        session_id: sessionId,
+        trigger: "resume",
+        resumed_from: last.resumed_from ?? "interrupted",
+        ...(last.text !== undefined ? { text: last.text } : {}),
+        ...(last.message_id !== undefined ? { message_id: last.message_id } : {}),
+        at,
+        ...compact,
+    };
+}
+/** Change account only after a provider/runtime account failure, then re-admit. */
+export async function retryLaneOnAlternateAccount(hqRoot, lane, reason, writer = "watcher", deps = {}) {
+    const config = loadLanesConfig(hqRoot);
+    const existsSync = deps.existsSync ?? ((p) => fs.existsSync(p));
+    const env = deps.env ?? process.env;
+    const modelDeps = {
+        ...deps.modelDeps,
+        env: deps.modelDeps?.env ?? env,
+    };
+    const accountDeps = {
+        probe: modelDeps.probe ?? defaultProbe,
+        env,
+    };
+    const admissionHost = deps.admissionHost ?? resolveAdmissionHost();
+    const profile = lane.worker_profile ? loadWorkerProfile(hqRoot, lane.worker_profile) : undefined;
+    const profileModel = profile?.meta.provider === lane.provider ? profile.meta.model : undefined;
+    const pinnedModel = lane.model_source === undefined || lane.model_source === "cli" ? lane.model : undefined;
+    const unavailableAccounts = previouslyUnavailableAccounts(lane);
+    const allowedAccounts = Object.entries(config.providers[lane.provider].accounts)
+        .filter(([id, account]) => id !== lane.account && !unavailableAccounts.has(id) && account.enabled)
+        .filter(([id]) => accountStatus(lane.provider, id, config, {
+        existsSync,
+        ...(accountDeps?.probe ? { probe: accountDeps.probe } : {}),
+        ...(accountDeps?.env ? { env: accountDeps.env } : {}),
+    }).logged_in === true)
+        .filter(([id]) => supportsSpawnModel(lane.provider, id, config, pinnedModel, profileModel, modelDeps))
+        .map(([id]) => id);
+    const modelContext = {
+        hqRoot,
+        existsSync,
+        accountDeps,
+        ...(pinnedModel ?? profileModel ? { model: pinnedModel ?? profileModel } : {}),
+        allowedAccounts,
+    };
+    let target;
+    try {
+        target = selectBalancedAccount(lane.provider, config, modelContext);
+    }
+    catch (err) {
+        if (reason === "account_unavailable" || unavailableAccounts.size > 0) {
+            throw new LanesError("account_not_logged_in", `Account ${lane.account ?? "(none)"} for ${lane.provider} is unavailable and no other logged-in account can serve this lane`, { provider: lane.provider, account: lane.account ?? null });
+        }
+        throw err;
+    }
+    const source = lane.account ? config.providers[lane.provider].accounts[lane.account] : undefined;
+    const sessionId = providerSupportsSessionResume(lane.provider) &&
+        typeof lane.provider_session_id === "string" &&
+        lane.provider_session_id.trim().length > 0
+        ? lane.provider_session_id
+        : undefined;
+    if (source && sessionId) {
+        copySessionFiles(planSessionCopy(lane.provider, {
+            sourceHome: source.home,
+            targetHome: target.home,
+            cwd: hqRoot,
+            sessionId,
+        }));
+    }
+    const now = (deps.now ?? (() => new Date()))();
+    const at = now.toISOString();
+    const nowMs = now.getTime();
+    return withLaneAdmissionLock(hqRoot, lane.provider, async () => {
+        const current = readLane(hqRoot, lane.lane_id);
+        if (current.state !== "running" ||
+            current.account !== lane.account ||
+            current.provider_session_id !== lane.provider_session_id) {
+            throw new LanesError("account_retry_conflict", `Lane ${lane.lane_id} changed while account recovery was prepared`, {
+                lane_id: lane.lane_id,
+                state: current.state,
+                account: current.account ?? null,
+                provider_session_id_changed: current.provider_session_id !== lane.provider_session_id,
+            });
+        }
+        const moveToRetryQueue = (row) => {
+            const entry = {
+                from: row.account ?? null,
+                to: target.id,
+                at,
+                reason,
+            };
+            return {
+                ...row,
+                state: "queued",
+                queued_reason: "account_retry",
+                queued_at: at,
+                admission_reserved_at: undefined,
+                terminal_reason: undefined,
+                terminal_details: undefined,
+                account: target.id,
+                account_history: appendCappedHistory(row.account_history ?? [], entry),
+                pending_resume: sessionId
+                    ? pendingResumeForRetry(hqRoot, row, sessionId, at)
+                    : undefined,
+            };
+        };
+        const candidate = moveToRetryQueue(current);
+        const admissionLanes = listLaneIds(hqRoot)
+            .filter((id) => id !== current.lane_id)
+            .map((id) => readLane(hqRoot, id));
+        admissionLanes.push(candidate);
+        const profileMaxFor = (row) => row.worker_profile === undefined
+            ? undefined
+            : loadWorkerProfile(hqRoot, row.worker_profile).meta.max_concurrent;
+        const capacityReason = laneAdmissionCapReason(admissionLanes, candidate, config, admissionHost, profile?.meta.max_concurrent, nowMs);
+        const earlierEligibleLane = hasEarlierEligibleQueuedLane(admissionLanes, candidate, config, admissionHost, profileMaxFor, nowMs);
+        const moved = retryUpdateLane(hqRoot, lane.lane_id, writer, (row) => {
+            if (row.state !== "running" ||
+                row.account !== lane.account ||
+                row.provider_session_id !== lane.provider_session_id) {
+                throw new LanesError("account_retry_conflict", `Lane ${lane.lane_id} changed while account recovery was prepared`, {
+                    lane_id: lane.lane_id,
+                    state: row.state,
+                    account: row.account ?? null,
+                    provider_session_id_changed: row.provider_session_id !== lane.provider_session_id,
+                });
+            }
+            return moveToRetryQueue(row);
+        });
+        if (capacityReason !== undefined || earlierEligibleLane)
+            return moved;
+        return spawnLaneWorker(hqRoot, moved, deps);
+    });
+}
 export function appendModelFlag(provider, args, model) {
     if (model === undefined)
         return args;
@@ -1157,16 +1519,28 @@ export function spawnLaneWorker(hqRoot, lane, deps = {}, launch = {}) {
     const pinnedModel = existing.model_source === undefined || existing.model_source === "cli"
         ? existing.model
         : undefined;
-    let resolved;
+    const accountDeps = {
+        probe: modelDeps.probe ?? defaultProbe,
+        env,
+    };
+    let selection;
     try {
-        resolved = resolveAccount(lane.provider, lane.account, config, {
+        selection = selectSpawnAccount({
             hqRoot,
+            lane: existing,
+            config,
             existsSync,
-            model: pinnedModel ?? profileModel,
+            accountDeps,
+            modelDeps,
+            pinnedModel,
+            profileModel,
+            currentModelValidated: deps.currentModelValidated === true,
         });
     }
     catch (err) {
-        if (err instanceof AccountResolutionError) {
+        if (err instanceof AccountResolutionError ||
+            (err instanceof LanesError &&
+                (err.error === "account_not_logged_in" || err.error === "model_unsupported"))) {
             if (markPreSpawnFailure) {
                 markSpawnFailure(hqRoot, lane.lane_id, err.error, err.details);
             }
@@ -1175,6 +1549,7 @@ export function spawnLaneWorker(hqRoot, lane, deps = {}, launch = {}) {
         process.stderr.write(`hq lanes: account bind failed for ${lane.lane_id}: ${err instanceof Error ? err.message : String(err)}\n`);
         throw err;
     }
+    const resolved = selection.account;
     const status = accountStatus(lane.provider, resolved.id, config, { existsSync });
     if (isLoggedOut(status)) {
         const failed = markPreSpawnFailure
@@ -1185,8 +1560,20 @@ export function spawnLaneWorker(hqRoot, lane, deps = {}, launch = {}) {
             : existing;
         throw new LanesError("account_not_logged_in", `Account ${resolved.id} for ${lane.provider} is not logged in (no credential file)`, { provider: lane.provider, account: resolved.id, lane_id: lane.lane_id, lane: failed });
     }
-    if (profileDefaultsApply && profileModel !== undefined && pinnedModel === undefined) {
-        validateProfileLaneModel(existing.provider, profileModel, resolved.home, profile.id, modelDeps);
+    if (existing.account !== resolved.id) {
+        const source = existing.account
+            ? config.providers[existing.provider].accounts[existing.account]
+            : undefined;
+        if (source &&
+            existing.provider_session_id &&
+            providerSupportsSessionResume(existing.provider)) {
+            copySessionFiles(planSessionCopy(existing.provider, {
+                sourceHome: source.home,
+                targetHome: resolved.home,
+                cwd: hqRoot,
+                sessionId: existing.provider_session_id,
+            }));
+        }
     }
     if (plan.mode === "resume" && existing.provider !== "grok") {
         ensureSessionHome({
@@ -1199,11 +1586,26 @@ export function spawnLaneWorker(hqRoot, lane, deps = {}, launch = {}) {
             providerHomeAtSpawn: existing.provider_home_at_spawn,
         });
     }
-    if (lane.account !== resolved.id) {
+    if (existing.account !== resolved.id) {
+        const at = (deps.now ?? (() => new Date()))().toISOString();
+        const reason = selection.changeReason ?? "first_assignment";
         retryUpdateLane(hqRoot, lane.lane_id, "spawn", (current) => {
             if (current.account === resolved.id)
                 return current;
-            return { ...current, account: resolved.id };
+            if (current.account !== existing.account) {
+                throw new LanesError("account_bind_conflict", `Lane ${lane.lane_id} changed accounts while its worker spawn was prepared`, { lane_id: lane.lane_id, expected_account: existing.account ?? null, account: current.account ?? null });
+            }
+            const entry = {
+                from: current.account ?? null,
+                to: resolved.id,
+                at,
+                reason,
+            };
+            return {
+                ...current,
+                account: resolved.id,
+                account_history: appendCappedHistory(current.account_history ?? [], entry),
+            };
         });
     }
     try {
@@ -1255,10 +1657,10 @@ export function spawnLaneWorker(hqRoot, lane, deps = {}, launch = {}) {
                         ? trigger.text
                         : pendingResume?.text,
                 resumedFrom: trigger.kind === "resume" ? trigger.from : pendingResume?.resumed_from,
-                answersPath: trigger.kind === "answered_questions" && existsSync(answersPath)
+                answersPath: (trigger.kind === "answered_questions" || pendingResume?.trigger === "answered_questions") && existsSync(answersPath)
                     ? answersPath
                     : undefined,
-                answers: trigger.kind === "answered_questions" && existsSync(answersPath)
+                answers: (trigger.kind === "answered_questions" || pendingResume?.trigger === "answered_questions") && existsSync(answersPath)
                     ? readAnsweredQuestionLines(answersPath)
                     : undefined,
             }),
@@ -1425,6 +1827,7 @@ export function spawnLaneWorker(hqRoot, lane, deps = {}, launch = {}) {
                 ...(pendingResume.message_id !== undefined ? { message_id: pendingResume.message_id } : {}),
                 ...(pendingResume.resumed_from !== undefined ? { resumed_from: pendingResume.resumed_from } : {}),
                 ...(pendingResume.text !== undefined ? { text: pendingResume.text } : {}),
+                ...(pendingResume.compact !== undefined ? { compact: pendingResume.compact } : {}),
             };
         }
         else if (resume && trigger.kind !== "admit") {
@@ -1433,7 +1836,10 @@ export function spawnLaneWorker(hqRoot, lane, deps = {}, launch = {}) {
                 at: nowIso,
                 account: resolved.id,
                 trigger: trigger.kind,
-                ...(trigger.kind === "message" ? { message_id: trigger.message_id } : {}),
+                ...(trigger.kind === "message"
+                    ? { message_id: trigger.message_id, text: trigger.text }
+                    : {}),
+                ...(launch.compact !== undefined ? { compact: launch.compact } : {}),
                 ...(trigger.kind === "resume"
                     ? {
                         resumed_from: trigger.from,

package/dist/lib/lanes/types.d.ts

@@ -166,7 +166,7 @@ export declare const TERMINAL_LANE_STATES: readonly ["done", "failed", "interrup
 export type TerminalLaneState = (typeof TERMINAL_LANE_STATES)[number];
 export declare const LANE_PROVIDERS: readonly ["claude", "codex", "grok"];
 export type LaneProvider = (typeof LANE_PROVIDERS)[number];
-export declare const QUEUED_REASONS: readonly ["cap", "provider_cap", "account_cap", "profile_cap", "queue_position", "throttle", "provider_binary_missing"];
+export declare const QUEUED_REASONS: readonly ["cap", "provider_cap", "account_cap", "profile_cap", "queue_position", "throttle", "provider_binary_missing", "account_retry"];
 export type QueuedReason = (typeof QUEUED_REASONS)[number];
 export declare function isQueuedReason(value: unknown): value is QueuedReason;
 export declare const HOST_KINDS: readonly ["local", "outpost"];
@@ -436,11 +436,11 @@ export interface AccountHistoryEntry {
     from: string | null;
     to: string;
     at: string;
-    reason: "operator_move";
+    reason: "first_assignment" | "model_change" | "usage_limit" | "account_unavailable" | "operator_move";
 }
 export interface PendingResume {
     session_id: string;
-    trigger: "message" | "resume";
+    trigger: "answered_questions" | "message" | "resume";
     resumed_from?: "interrupted" | "done" | "blocked";
     text?: string;
     message_id?: string;
@@ -461,6 +461,8 @@ export interface LaneResumeRecord {
      */
     resumed_from?: "interrupted" | "done" | "blocked";
     text?: string;
+    /** False when the continued turn explicitly skipped compaction. */
+    compact?: boolean;
 }
 export interface LaneRunUsage {
     cache_read_input_tokens: number | null;
@@ -575,6 +577,8 @@ export interface ProviderConfig {
      * Account pick is least-loaded among enabled, logged-in accounts.
      */
     default_account?: string;
+    /** Ordered account preferences used only for a lane's first assignment. */
+    preferred_accounts?: string[];
     /** Default model for this provider when the account does not set one. */
     model?: string;
     /** Default effort for this provider when the account does not set one. */

package/dist/lib/lanes/types.js

@@ -103,6 +103,7 @@ export const QUEUED_REASONS = [
     "queue_position",
     "throttle",
     "provider_binary_missing",
+    "account_retry",
 ];
 export function isQueuedReason(value) {
     return typeof value === "string" && QUEUED_REASONS.includes(value);
@@ -215,11 +216,11 @@ export const LANE_FIELD_WRITERS = {
     schema_version: ["creator"], lane_id: ["creator"], company: ["creator"],
     project_id: ["command"], story_id: ["command"], stories: ["creator", "command", "watcher", "reconcile", "spawn"], thread_id: ["creator", "command", "spawn"], mesh_company: ["creator"],
     depth: ["command"], senior: ["command"], senior_history: ["command"],
-    state: ["creator", "command", "watcher", "reconcile", "spawn"], queued_reason: ["creator", "command", "spawn", "reconcile"], queued_at: ["creator", "command", "spawn"], admission_reserved_at: ["creator", "command", "reconcile", "spawn"],
+    state: ["creator", "command", "watcher", "reconcile", "spawn"], queued_reason: ["creator", "command", "spawn", "watcher", "reconcile"], queued_at: ["creator", "command", "spawn", "watcher", "reconcile"], admission_reserved_at: ["creator", "command", "reconcile", "spawn", "watcher"],
     pickup_validation_pending: ["creator", "command", "spawn", "reconcile"],
     pickup_validation_pending_since: ["creator", "command", "spawn", "reconcile"],
     priority: ["command"], worker: ["creator"], worker_path: ["creator"], worker_pack: ["creator"], worker_profile: ["creator"], worker_profile_hash: ["creator", "spawn"], worker_profile_ignored: ["creator", "spawn"],
-    provider: ["creator"], account: ["creator", "spawn", "command", "reconcile"], admission_accounts: ["creator", "command"], account_history: ["command"], pending_resume: ["command", "spawn"], host: ["creator"], origin_host: ["creator"], origin_host_source: ["creator"],
+    provider: ["creator"], account: ["creator", "spawn", "command", "watcher", "reconcile"], admission_accounts: ["creator", "command"], account_history: ["command", "spawn", "watcher", "reconcile"], pending_resume: ["command", "spawn", "watcher", "reconcile"], host: ["creator"], origin_host: ["creator"], origin_host_source: ["creator"],
     version: ["creator"], created_at: ["creator"], updated_at: ["creator"], attribution_history: ["command"],
     last_envelope: ["watcher", "reconcile"], model: ["creator", "spawn", "command"], model_source: ["creator", "spawn", "command"], effort: ["creator", "spawn"], effort_source: ["creator", "spawn"], fast_mode: ["spawn"],
     last_message_at: ["command"], last_compaction: ["spawn"], story_complete: ["watcher", "reconcile"], story_complete_reason: ["watcher", "reconcile"], story_status: ["watcher", "reconcile"],

package/dist/lib/lanes/watcher.d.ts

@@ -34,8 +34,9 @@
 import { type LaneEnvelope, type LaneRecord, type LaneState } from "./types.js";
 import { type QuotaSignal } from "./quota.js";
 import { type ProviderRejection } from "./provider-rejection.js";
+import type { AdmissionHost } from "./admission.js";
 import { type LaneMesh } from "./mesh-events.js";
-import { type EnvelopeRepairSpawnInput } from "./spawn.js";
+import { type EnvelopeRepairSpawnInput, type SpawnLaneDeps } from "./spawn.js";
 /** Spec §5.7: no signal for 20 minutes while the process is still alive. */
 export declare const SILENCE_MS: number;
 export declare const WATCHER_POLL_MS = 5000;
@@ -206,6 +207,12 @@ export interface WatcherLoopDeps {
     meshRequestTimeoutMs?: number;
     /** Spec §4 repair spawn. Default: `spawnEnvelopeRepair`. */
     spawnRepair?: (hqRoot: string, lane: LaneRecord, input: EnvelopeRepairSpawnInput) => number;
+    /** Rebind and respawn after a provider quota or authentication refusal. */
+    retryAccount?: (hqRoot: string, lane: LaneRecord, reason: "usage_limit" | "account_unavailable") => LaneRecord | Promise<LaneRecord>;
+    /** Shared process/Outpost identity used by command admission and watcher retries. */
+    resolveAdmissionHost?: () => AdmissionHost;
+    /** Spawn seams for account retry; host scope is supplied by the resolver above. */
+    retrySpawnDeps?: Omit<SpawnLaneDeps, "admissionHost">;
 }
 /**
  * Wrap one mesh call. A failed emit is logged as `mesh_event_failed` with