crewly 1.20.355 → 1.20.356

package/dist/cli/backend/src/services/runtime-fallback/usage-limit-rules.js

@@ -36,7 +36,7 @@
  *
  * @module services/runtime-fallback/usage-limit-rules
  */
-import { RUNTIME_TYPES } from '../../constants.js';
+import { RUNTIME_TYPES, USAGE_LIMIT_STATE_CONSTANTS } from '../../constants.js';
 import { normalizeTerminalOutput } from '../harness/login-rules.js';
 import { detectLoginExpiry } from '../harness/login-expiry-rules.js';
 import { parseResetTime } from './reset-time.js';
@@ -254,4 +254,162 @@ export function detectUsageLimit(output, runtime, now = Date.now(), defaultTimeZ
     }
     return null;
 }
+/**
+ * Claude Code's usage-limit menu, shown when a turn hits the limit:
+ *
+ * ```
+ *   ⎿  You've hit your weekly limit · resets Oct 16 at 8pm (America/New_York)
+ *    What do you want to do?
+ *    ❯ 1. Stop and wait for limit to reset
+ *      2. Wait here, then continue automatically at 8pm
+ *    Enter to confirm · Esc to cancel
+ * ```
+ *
+ * Both options must be on screen. Matched against the spaceless screen tail.
+ */
+export const CLAUDE_USAGE_LIMIT_MENU = [
+    /Stopandwaitfor(?:the)?limittoreset/i,
+    /Waithere,?thencontinueautomatically/i,
+];
+/** Which option of the usage-limit menu is highlighted (`❯`). */
+const MENU_SELECTED = /❯\s*([12])\./;
+/** Option 2 of the usage-limit menu, from "continue automatically" to the end of its line. */
+const MENU_OPTION_2_TIME = /continue\s*automatically[^\n]*/i;
+/**
+ * The last `count` non-empty lines of a screen, normalized.
+ *
+ * @param screen - Captured screen (escape sequences allowed)
+ * @param count - Lines to keep
+ * @returns The tail as text
+ */
+function screenTail(screen, count) {
+    const lines = normalizeTerminalOutput(screen).text.split('\n').filter((line) => line.trim().length > 0);
+    return lines.slice(-count).join('\n');
+}
+/**
+ * A reset time a live screen may be trusted with: in the future and at most
+ * {@link USAGE_LIMIT_STATE_CONSTANTS.MAX_RESET_AHEAD_MS} away. A dated reset
+ * that already passed is read by {@link parseResetTime} as next year's, so a
+ * reset that far ahead means an old message.
+ *
+ * @param resetAt - Parsed reset time
+ * @param now - Current time (ms)
+ * @returns The reset time, or null when absent or implausible
+ */
+function plausibleReset(resetAt, now) {
+    if (resetAt === null)
+        return null;
+    return resetAt > now && resetAt - now <= USAGE_LIMIT_STATE_CONSTANTS.MAX_RESET_AHEAD_MS ? resetAt : null;
+}
+/**
+ * Find a usage-limit state on a captured screen — what the agent shows right
+ * now — as opposed to {@link detectUsageLimit}, which reads live output and
+ * error text.
+ *
+ * Only the bottom of the screen counts (old scrollback and resumed
+ * transcripts sit above it):
+ *
+ * - Claude Code's usage-limit menu ({@link CLAUDE_USAGE_LIMIT_MENU}) is a
+ *   modal waiting for an answer, so it always counts; the reset time comes
+ *   from the limit line above it or from option 2 ("continue automatically
+ *   at 8pm").
+ * - A plain limit line ("You've hit your … limit · resets …") counts only
+ *   when its reset names a calendar date and is plausible
+ *   ({@link plausibleReset}), so an old line that names a past date is not
+ *   read as a new limit. A line whose reset has no date ("resets 8pm",
+ *   "try again in 2h") never counts here: on a resumed conversation it may
+ *   be old. Only new live output may report it.
+ *
+ * Transient rate limits and expired logins are never reported.
+ *
+ * @param screen - Captured screen text (escape sequences allowed)
+ * @param runtime - Runtime the session runs
+ * @param now - Current time (ms)
+ * @param defaultTimeZone - Zone for reset clock times that name none
+ * @returns The match, or null
+ *
+ * @example
+ * ```ts
+ * detectUsageLimitScreen(screen, 'claude-code');
+ * // { runtime: 'claude-code', ruleId: 'claude.hit_your_limit', resetAt: <Oct 16 8pm New York>, menu: { selected: 1 } }
+ * ```
+ */
+export function detectUsageLimitScreen(screen, runtime, now = Date.now(), defaultTimeZone) {
+    if (!screen)
+        return null;
+    const tail = screenTail(screen, USAGE_LIMIT_STATE_CONSTANTS.SCREEN_TAIL_LINES);
+    if (!tail)
+        return null;
+    const lineMatch = detectUsageLimit(tail, runtime, now, defaultTimeZone);
+    const exhausting = lineMatch && isExhaustingKind(lineMatch.kind) ? lineMatch : null;
+    const spaceless = tail.replace(/[ \t]+/g, '');
+    if (runtime === RUNTIME_TYPES.CLAUDE_CODE && CLAUDE_USAGE_LIMIT_MENU.every((re) => re.test(spaceless))) {
+        const selected = MENU_SELECTED.exec(tail)?.[1];
+        // Option 2 names the reset ("continue automatically at 8pm"); read only
+        // that line — option 1's "limit to reset" is followed by "2." otherwise.
+        const option2 = MENU_OPTION_2_TIME.exec(tail)?.[0] ?? '';
+        const resetAt = plausibleReset(exhausting?.resetAt ?? parseResetTime(option2, now, defaultTimeZone), now);
+        return {
+            runtime,
+            ruleId: exhausting?.ruleId ?? 'claude.usage_limit_menu',
+            resetAt,
+            menu: { selected: selected === '1' ? 1 : selected === '2' ? 2 : null },
+        };
+    }
+    if (!exhausting)
+        return null;
+    // A screen holds history (a resumed conversation repaints old limit
+    // lines). A reset with only a clock time ("resets 8pm") or a duration
+    // cannot tell an old line from a new one — it would be read as the next
+    // 8pm — so only a dated reset counts here. Undated lines count only as
+    // new live output (detectUsageLimit on the output stream).
+    if (!hasDatedReset(tail))
+        return null;
+    const resetAt = plausibleReset(exhausting.resetAt, now);
+    if (resetAt === null)
+        return null;
+    return { runtime: exhausting.runtime, ruleId: exhausting.ruleId, resetAt, menu: null };
+}
+/** A calendar date in a reset phrase: "Oct 16", "2026-10-16", or the old "|<epoch>" form. */
+const DATED_RESET = /\b(?:jan|feb|mar|apr|may|jun|jul|aug|sep|sept|oct|nov|dec)[a-z]*\.?\s+\d{1,2}(?:st|nd|rd|th)?\b|\b\d{4}-\d{2}-\d{2}\b|\|\d{10}\b/i;
+/** The phrase that carries a reset time. */
+const RESET_PHRASE = /\b(?:resets?|reset\s+at|try\s+again|limit\s+will\s+reset)\b|\|\d{10}\b/i;
+/**
+ * Whether the last line naming a reset in `text` names a calendar date.
+ *
+ * @param text - Screen tail
+ * @returns True when the reset is dated
+ */
+function hasDatedReset(text) {
+    const line = text.split('\n').reverse().find((l) => RESET_PHRASE.test(l));
+    return line !== undefined && DATED_RESET.test(line);
+}
+/** Words of a usage-limit screen (the limit line, its menu, Crewly's answer). */
+const LIMIT_SCREEN_WORDS = /limit|resets?\b|continue\s*automatically|wait\s*here|what\s*do\s*you\s*want\s*to\s*do|enter\s*to\s*confirm/i;
+/**
+ * Whether a live output chunk is fresh activity that is not a usage-limit
+ * message: at least {@link USAGE_LIMIT_STATE_CONSTANTS.FRESH_OUTPUT_MIN_CHARS}
+ * printable characters, no usage-limit match, and none of the words of the
+ * limit screen. Used to lift a usage-limit state once the agent works again.
+ *
+ * @param output - Output chunk (escape sequences allowed)
+ * @param runtime - Runtime the session runs
+ * @param now - Current time (ms)
+ * @returns True for fresh non-limit output
+ *
+ * @example
+ * ```ts
+ * isFreshNonLimitOutput('⏺ Read(src/app.ts) … 120 lines, editing the handler now', 'claude-code'); // true
+ * ```
+ */
+export function isFreshNonLimitOutput(output, runtime, now = Date.now()) {
+    if (!output)
+        return false;
+    const text = normalizeTerminalOutput(output).text.replace(/\s+/g, ' ').trim();
+    if (text.length < USAGE_LIMIT_STATE_CONSTANTS.FRESH_OUTPUT_MIN_CHARS)
+        return false;
+    if (LIMIT_SCREEN_WORDS.test(text))
+        return false;
+    return detectUsageLimit(text, runtime, now) === null;
+}
 //# sourceMappingURL=usage-limit-rules.js.map

package/dist/cli/backend/src/services/runtime-fallback/usage-limit-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage-limit-rules.js","sourceRoot":"","sources":["../../../../../../backend/src/services/runtime-fallback/usage-limit-rules.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"usage-limit-rules.js","sourceRoot":"","sources":["../../../../../../backend/src/services/runtime-fallback/usage-limit-rules.ts"],"names":[],"mappings":"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"}

package/dist/cli/backend/src/services/runtime-fallback/usage-limit-screen.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Read an agent's screen for a usage-limit state, record it, and answer
+ * Claude Code's usage-limit menu.
+ *
+ * One entry point ({@link inspectUsageLimitScreen}) for every place that
+ * already reads an agent's screen: the login/screen monitor's 30s sweep, the
+ * orchestrator heartbeat, and the delivery wait for a prompt. Detection is
+ * {@link detectUsageLimitScreen}; the state is {@link markUsageLimited}.
+ *
+ * The menu ("❯ 1. Stop and wait for limit to reset / 2. Wait here, then
+ * continue automatically at 8pm") is answered with option 2, like the other
+ * known start-up prompts are answered with the one right choice for an
+ * unattended agent: the turn waits and goes on by itself at the reset, so
+ * nobody has to come back and re-send it. Only while option 1 or 2 is the
+ * highlighted one, once per state, and Enter is pressed only after the
+ * screen shows option 2 highlighted.
+ *
+ * @module services/runtime-fallback/usage-limit-screen
+ */
+import { type UsageLimitedInfo } from './usage-limit-state.js';
+/** Keys and screen access, to answer the menu. */
+export interface UsageLimitMenuIO {
+    sendKey(sessionName: string, key: string): Promise<void>;
+    sendEnter(sessionName: string): Promise<void>;
+    /** Current screen of the session */
+    capture(sessionName: string): string;
+}
+/** Minimal logger. */
+export interface UsageLimitScreenLogger {
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+}
+/** Options of {@link inspectUsageLimitScreen}. */
+export interface InspectUsageLimitOptions {
+    /** Keys + capture; without it the menu is left alone */
+    io?: UsageLimitMenuIO;
+    logger?: UsageLimitScreenLogger;
+    now?: number;
+    /** Zone for reset clock times that name none */
+    timeZone?: string;
+    /** Hand a new detection to the runtime fallback (default true) */
+    reportToFallback?: boolean;
+}
+/**
+ * Look at a session's screen for a usage-limit state. On a match the state
+ * is recorded (a new one is logged and handed to the runtime fallback, which
+ * may move the agent to another runtime) and an open usage-limit menu is
+ * answered. Never throws.
+ *
+ * @param sessionName - Session
+ * @param screen - Captured screen
+ * @param runtime - Runtime the session runs (null when unknown: nothing is detected)
+ * @param options - Keys, logger, clock
+ * @returns The state in force (also one recorded earlier), or null
+ *
+ * @example
+ * ```ts
+ * const limited = await inspectUsageLimitScreen('crewly-orc', screen, 'claude-code', { io });
+ * if (limited) return; // do not restart / wait / write
+ * ```
+ */
+export declare function inspectUsageLimitScreen(sessionName: string, screen: string, runtime: string | null, options?: InspectUsageLimitOptions): Promise<UsageLimitedInfo | null>;
+//# sourceMappingURL=usage-limit-screen.d.ts.map

package/dist/cli/backend/src/services/runtime-fallback/usage-limit-screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-limit-screen.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/runtime-fallback/usage-limit-screen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,EAA8D,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE3H,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAChC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,oCAAoC;IACpC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC;AAED,sBAAsB;AACtB,MAAM,WAAW,sBAAsB;IACtC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC/D;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACxC,wDAAwD;IACxD,EAAE,CAAC,EAAE,gBAAgB,CAAC;IACtB,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAwBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,uBAAuB,CAC5C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,OAAO,GAAE,wBAA6B,GACpC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAwClC"}

package/dist/cli/backend/src/services/runtime-fallback/usage-limit-screen.js

@@ -0,0 +1,104 @@
+/**
+ * Read an agent's screen for a usage-limit state, record it, and answer
+ * Claude Code's usage-limit menu.
+ *
+ * One entry point ({@link inspectUsageLimitScreen}) for every place that
+ * already reads an agent's screen: the login/screen monitor's 30s sweep, the
+ * orchestrator heartbeat, and the delivery wait for a prompt. Detection is
+ * {@link detectUsageLimitScreen}; the state is {@link markUsageLimited}.
+ *
+ * The menu ("❯ 1. Stop and wait for limit to reset / 2. Wait here, then
+ * continue automatically at 8pm") is answered with option 2, like the other
+ * known start-up prompts are answered with the one right choice for an
+ * unattended agent: the turn waits and goes on by itself at the reset, so
+ * nobody has to come back and re-send it. Only while option 1 or 2 is the
+ * highlighted one, once per state, and Enter is pressed only after the
+ * screen shows option 2 highlighted.
+ *
+ * @module services/runtime-fallback/usage-limit-screen
+ */
+import { USAGE_LIMIT_STATE_CONSTANTS } from '../../constants.js';
+import { delay } from '../../utils/async.utils.js';
+import { reportRuntimeOutput } from './effective-runtime.js';
+import { detectUsageLimitScreen } from './usage-limit-rules.js';
+import { markUsageLimited, noteUsageLimitMenuAnswered, usageLimitOf } from './usage-limit-state.js';
+/** `❯` on option 2 of the usage-limit menu. */
+const OPTION_2_SELECTED = /❯\s*2\.\s*Wait\s*here/i;
+/**
+ * Answer the usage-limit menu with option 2 ("Wait here, then continue
+ * automatically"). Down + check + Enter from option 1; Enter from option 2.
+ *
+ * @param sessionName - Session
+ * @param selected - Highlighted option
+ * @param io - Keys + capture
+ * @returns True when Enter was pressed on option 2
+ */
+async function answerMenu(sessionName, selected, io) {
+    if (selected === 1) {
+        await io.sendKey(sessionName, 'Down');
+        await delay(USAGE_LIMIT_STATE_CONSTANTS.MENU_KEY_DELAY_MS);
+        if (!OPTION_2_SELECTED.test(io.capture(sessionName)))
+            return false;
+    }
+    await io.sendEnter(sessionName);
+    return true;
+}
+/**
+ * Look at a session's screen for a usage-limit state. On a match the state
+ * is recorded (a new one is logged and handed to the runtime fallback, which
+ * may move the agent to another runtime) and an open usage-limit menu is
+ * answered. Never throws.
+ *
+ * @param sessionName - Session
+ * @param screen - Captured screen
+ * @param runtime - Runtime the session runs (null when unknown: nothing is detected)
+ * @param options - Keys, logger, clock
+ * @returns The state in force (also one recorded earlier), or null
+ *
+ * @example
+ * ```ts
+ * const limited = await inspectUsageLimitScreen('crewly-orc', screen, 'claude-code', { io });
+ * if (limited) return; // do not restart / wait / write
+ * ```
+ */
+export async function inspectUsageLimitScreen(sessionName, screen, runtime, options = {}) {
+    const now = options.now ?? Date.now();
+    try {
+        const match = runtime ? detectUsageLimitScreen(screen, runtime, now, options.timeZone) : null;
+        if (!match)
+            return usageLimitOf(sessionName, now);
+        const { info, isNew } = markUsageLimited({ sessionName, runtime, ruleId: match.ruleId, resetAt: match.resetAt, source: match.menu ? 'menu' : 'screen' }, now);
+        if (isNew) {
+            options.logger?.warn('Agent runtime is out of usage — no restarts or deliveries until it resets', {
+                sessionName,
+                runtime,
+                rule: match.ruleId,
+                until: info.until ?? null,
+                retryAt: info.retryAt,
+                menu: match.menu !== null,
+            });
+            // The screen is live (bottom of it, a plausible reset): the fallback may
+            // move the agent to another runtime meanwhile.
+            if (options.reportToFallback !== false && runtime)
+                reportRuntimeOutput(sessionName, runtime, screen, 'output');
+        }
+        const selected = match.menu?.selected;
+        if (options.io && selected && !info.menuAnsweredAt) {
+            // Once per state: a menu that comes back is not pressed into again.
+            noteUsageLimitMenuAnswered(sessionName, now);
+            const answered = await answerMenu(sessionName, selected, options.io);
+            if (answered) {
+                options.logger?.info('Answered the usage-limit menu: wait and continue automatically at the reset', { sessionName, until: info.until ?? null });
+            }
+            else {
+                options.logger?.warn('Usage-limit menu: could not select "Wait here, then continue automatically"; left as is', { sessionName });
+            }
+        }
+        return info;
+    }
+    catch (err) {
+        options.logger?.warn('Usage-limit screen check failed (ignored)', { sessionName, error: err instanceof Error ? err.message : String(err) });
+        return usageLimitOf(sessionName, now);
+    }
+}
+//# sourceMappingURL=usage-limit-screen.js.map

package/dist/cli/backend/src/services/runtime-fallback/usage-limit-screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-limit-screen.js","sourceRoot":"","sources":["../../../../../../backend/src/services/runtime-fallback/usage-limit-screen.ts"],"names":[],"mappings":"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"}

package/dist/cli/backend/src/services/runtime-fallback/usage-limit-state.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Usage-limit state per agent session — "this agent's runtime is out of
+ * usage until …". Process-wide and dependency-free (like the spend-cap gate)
+ * so the hot paths can ask it cheaply: the orchestrator restart service and
+ * heartbeat monitor (no restarts while limited), delivery (no waiting on a
+ * prompt that will not come, messages held), dispatch, and the status APIs.
+ *
+ * Why (2026-10-16): the orchestrator sat on Claude Code's weekly-limit menu
+ * for ~38 hours. Crewly kept waiting for its prompt every ~17s, restarted it
+ * 12 times in 15 minutes, and `GET /api/orchestrator/status` said "active and
+ * ready" the whole time.
+ *
+ * Fed by the login/screen monitor (screen sweep + live output) through
+ * {@link markUsageLimited}. A state lifts on its own at the reset time (plus
+ * a short grace), or after {@link USAGE_LIMIT_STATE_CONSTANTS.NO_RESET_BACKOFF_MS}
+ * when no reset time was given; it is set again if the limit is still there.
+ * It is lifted early ({@link liftUsageLimit}) as soon as the agent works
+ * again: a finished turn or tool call (Claude Code hooks), or fresh live
+ * output that is not a limit message.
+ * It is held in memory only: it describes the live screen, and after a Crewly
+ * restart the screen is read again.
+ *
+ * Distinct from the runtime fallback's account-wide "exhausted runtime"
+ * record: that one moves agents to another runtime; this one says what a
+ * given session is doing right now. A session moved to another runtime is
+ * cleared ({@link clearUsageLimit}).
+ *
+ * @module services/runtime-fallback/usage-limit-state
+ */
+/** Where a usage-limit state was seen. */
+export type UsageLimitSource = 'menu' | 'screen' | 'output';
+/** A session that is out of usage. */
+export interface UsageLimitedInfo {
+    /** Agent session */
+    sessionName: string;
+    /** Runtime that is out of usage (null when unknown) */
+    runtime: string | null;
+    /** Detection rule (logs only) */
+    ruleId: string;
+    /** Where it was seen */
+    source: UsageLimitSource;
+    /** ISO time of first detection */
+    detectedAt: string;
+    /** ISO time the limit was last seen (every detection refreshes it) */
+    lastSeenAt: string;
+    /** ISO time the runtime says the limit resets, when it says so */
+    until?: string;
+    /** ISO time the session may be tried again (reset + grace, or the backoff) */
+    retryAt: string;
+    /** ISO time Crewly answered the usage-limit menu, when it did */
+    menuAnsweredAt?: string;
+}
+/** Input of {@link markUsageLimited}. */
+export interface MarkUsageLimitedInput {
+    sessionName: string;
+    runtime: string | null;
+    ruleId: string;
+    /** Reset time (epoch ms), or null when unknown */
+    resetAt: number | null;
+    source: UsageLimitSource;
+}
+/** API view of a usage-limited session (the `usageLimited` status field). */
+export interface UsageLimitedView {
+    /** ISO reset time, when known */
+    until?: string;
+    /** ISO time Crewly tries the session again */
+    retryAt: string;
+    /** ISO time of first detection */
+    detectedAt: string;
+    /** Runtime that is out of usage */
+    runtime: string | null;
+}
+/**
+ * Record that a session is out of usage. A state already in force keeps its
+ * first-detection time; a reset time seen later replaces the backoff, and a
+ * later detection without one does not extend it.
+ *
+ * @param input - Session, runtime, rule, reset time, source
+ * @param now - Current time (ms)
+ * @returns The state and whether it is new (not in force before this call)
+ *
+ * @example
+ * ```ts
+ * markUsageLimited({ sessionName: 'crewly-orc', runtime: 'claude-code', ruleId: 'claude.hit_your_limit', resetAt, source: 'menu' });
+ * ```
+ */
+export declare function markUsageLimited(input: MarkUsageLimitedInput, now?: number): {
+    info: UsageLimitedInfo;
+    isNew: boolean;
+};
+/**
+ * The usage-limit state in force for a session. A state past its retry time
+ * is dropped. Never throws.
+ *
+ * @param sessionName - Agent session
+ * @param now - Current time (ms)
+ * @returns The state, or null when the session may run
+ */
+export declare function usageLimitOf(sessionName: string, now?: number): UsageLimitedInfo | null;
+/**
+ * Milliseconds until a usage-limited session may be tried again.
+ *
+ * @param info - The state
+ * @param now - Current time (ms)
+ * @returns Milliseconds (at least 0)
+ */
+export declare function usageLimitRemainingMs(info: UsageLimitedInfo, now?: number): number;
+/**
+ * Note that Crewly answered the usage-limit menu of a session.
+ *
+ * @param sessionName - Agent session
+ * @param now - Current time (ms)
+ */
+export declare function noteUsageLimitMenuAnswered(sessionName: string, now?: number): void;
+/**
+ * Forget a session's usage-limit state (it moved to another runtime, or the
+ * owner changed its runtime).
+ *
+ * @param sessionName - Agent session
+ * @returns True when a state was in force
+ */
+export declare function clearUsageLimit(sessionName: string): boolean;
+/**
+ * Lift a session's usage-limit state because the agent works again: it
+ * finished a turn, or wrote fresh output that is not a limit message.
+ * Activity within {@link USAGE_LIMIT_STATE_CONSTANTS.LIFT_GRACE_MS} of the
+ * limit last being seen, or of Crewly answering its menu, is the repaint of
+ * that screen and does not count.
+ *
+ * @param sessionName - Agent session
+ * @param now - Current time (ms)
+ * @returns The lifted state, or null when none was in force or it was too soon
+ *
+ * @example
+ * ```ts
+ * if (liftUsageLimit('crewly-orc')) logger.info('Orchestrator works again');
+ * ```
+ */
+export declare function liftUsageLimit(sessionName: string, now?: number): UsageLimitedInfo | null;
+/**
+ * Every session that is usage-limited now.
+ *
+ * @param now - Current time (ms)
+ * @returns States
+ */
+export declare function listUsageLimited(now?: number): UsageLimitedInfo[];
+/**
+ * The status-API view of a session's state (`usageLimited`), or undefined.
+ *
+ * @param sessionName - Agent session
+ * @param now - Current time (ms)
+ * @returns View, or undefined when the session is not limited
+ */
+export declare function usageLimitedView(sessionName: string, now?: number): UsageLimitedView | undefined;
+/**
+ * One-line, owner-facing reason, e.g. "Orchestrator is out of Claude usage
+ * until 2026-10-17T00:00:00.000Z".
+ *
+ * @param name - Who is limited ("Orchestrator", "Ella")
+ * @param info - The state
+ * @returns Reason text
+ */
+export declare function usageLimitReason(name: string, info: UsageLimitedInfo): string;
+/** Forget every state (tests). */
+export declare function resetUsageLimitState(): void;
+//# sourceMappingURL=usage-limit-state.d.ts.map

package/dist/cli/backend/src/services/runtime-fallback/usage-limit-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-limit-state.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/runtime-fallback/usage-limit-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,0CAA0C;AAC1C,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAChC,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,MAAM,EAAE,gBAAgB,CAAC;IACzB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,yCAAyC;AACzC,MAAM,WAAW,qBAAqB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;CACzB;AAED,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAChC,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAiBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,GAAE,MAAmB,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CA+BnI;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,gBAAgB,GAAG,IAAI,CAQnG;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAE9F;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAG9F;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,gBAAgB,GAAG,IAAI,CAOrG;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAmB,GAAG,gBAAgB,EAAE,CAE7E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,gBAAgB,GAAG,SAAS,CAI5G;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAM7E;AAED,kCAAkC;AAClC,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}