crewly 1.20.355 → 1.20.358

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"}

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

@@ -0,0 +1,207 @@
+/**
+ * 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
+ */
+import { RUNTIME_FALLBACK_CONSTANTS, USAGE_LIMIT_STATE_CONSTANTS } from '../../constants.js';
+const states = new Map();
+/**
+ * When a state with this reset time may be tried again.
+ *
+ * @param resetAt - Reset time (ms), or null
+ * @param now - Current time (ms)
+ * @returns Epoch ms
+ */
+function retryAtFor(resetAt, now) {
+    return resetAt !== null
+        ? resetAt + USAGE_LIMIT_STATE_CONSTANTS.RESET_GRACE_MS
+        : now + USAGE_LIMIT_STATE_CONSTANTS.NO_RESET_BACKOFF_MS;
+}
+/**
+ * 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 function markUsageLimited(input, now = Date.now()) {
+    const existing = usageLimitOf(input.sessionName, now);
+    // A reset in the past or implausibly far ahead (an old dated message read
+    // as next year's) is not trusted: back off instead.
+    const resetAt = input.resetAt !== null && input.resetAt > now && input.resetAt - now <= USAGE_LIMIT_STATE_CONSTANTS.MAX_RESET_AHEAD_MS
+        ? input.resetAt
+        : null;
+    const until = resetAt !== null ? new Date(resetAt).toISOString() : undefined;
+    if (existing) {
+        if (until && existing.until !== until) {
+            existing.until = until;
+            existing.retryAt = new Date(retryAtFor(resetAt, now)).toISOString();
+        }
+        if (input.runtime && !existing.runtime)
+            existing.runtime = input.runtime;
+        if (input.source === 'menu')
+            existing.source = 'menu';
+        existing.lastSeenAt = new Date(now).toISOString();
+        return { info: existing, isNew: false };
+    }
+    const info = {
+        sessionName: input.sessionName,
+        runtime: input.runtime,
+        ruleId: input.ruleId,
+        source: input.source,
+        detectedAt: new Date(now).toISOString(),
+        lastSeenAt: new Date(now).toISOString(),
+        ...(until ? { until } : {}),
+        retryAt: new Date(retryAtFor(resetAt, now)).toISOString(),
+    };
+    states.set(input.sessionName, info);
+    return { info, isNew: true };
+}
+/**
+ * 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 function usageLimitOf(sessionName, now = Date.now()) {
+    const info = states.get(sessionName);
+    if (!info)
+        return null;
+    if (Date.parse(info.retryAt) <= now) {
+        states.delete(sessionName);
+        return null;
+    }
+    return info;
+}
+/**
+ * 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 function usageLimitRemainingMs(info, now = Date.now()) {
+    return Math.max(0, Date.parse(info.retryAt) - now);
+}
+/**
+ * Note that Crewly answered the usage-limit menu of a session.
+ *
+ * @param sessionName - Agent session
+ * @param now - Current time (ms)
+ */
+export function noteUsageLimitMenuAnswered(sessionName, now = Date.now()) {
+    const info = usageLimitOf(sessionName, now);
+    if (info)
+        info.menuAnsweredAt = new Date(now).toISOString();
+}
+/**
+ * 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 function clearUsageLimit(sessionName) {
+    return states.delete(sessionName);
+}
+/**
+ * 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 function liftUsageLimit(sessionName, now = Date.now()) {
+    const info = usageLimitOf(sessionName, now);
+    if (!info)
+        return null;
+    const lastSeen = Math.max(Date.parse(info.lastSeenAt), info.menuAnsweredAt ? Date.parse(info.menuAnsweredAt) : 0);
+    if (now - lastSeen < USAGE_LIMIT_STATE_CONSTANTS.LIFT_GRACE_MS)
+        return null;
+    states.delete(sessionName);
+    return info;
+}
+/**
+ * Every session that is usage-limited now.
+ *
+ * @param now - Current time (ms)
+ * @returns States
+ */
+export function listUsageLimited(now = Date.now()) {
+    return [...states.keys()].map((s) => usageLimitOf(s, now)).filter((i) => i !== null);
+}
+/**
+ * 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 function usageLimitedView(sessionName, now = Date.now()) {
+    const info = usageLimitOf(sessionName, now);
+    if (!info)
+        return undefined;
+    return { ...(info.until ? { until: info.until } : {}), retryAt: info.retryAt, detectedAt: info.detectedAt, runtime: info.runtime };
+}
+/**
+ * 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 function usageLimitReason(name, info) {
+    const runtime = info.runtime ? RUNTIME_FALLBACK_CONSTANTS.SHORT_LABELS[info.runtime] ?? info.runtime : null;
+    const what = runtime ? `out of ${runtime} usage` : 'out of usage';
+    return info.until
+        ? `${name} is ${what} until ${info.until}`
+        : `${name} is ${what} (reset time unknown; trying again at ${info.retryAt})`;
+}
+/** Forget every state (tests). */
+export function resetUsageLimitState() {
+    states.clear();
+}
+//# sourceMappingURL=usage-limit-state.js.map

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

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

package/dist/cli/backend/src/services/slack/agent-coordination.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Agent-to-agent coordination in Slack rooms (crewly#1340).
+ *
+ * 2026-10-16, #content-team: Ella, Max and Sam — all on the owner's Mac —
+ * posted 20+ top-level Slack messages to each other in 90 minutes ("@Max
+ * CREW-718 step 1 of 2 done…", "@Sam Got it, going with your first
+ * option…", "@Sam 1.0.217 is live…"). Each one was a new unread for the
+ * owner, who does not need that discussion; internal ticket ids leaked into
+ * every post; and Ella sent Sam the same conclusion three times.
+ *
+ * The model is a company group chat: whoever the room asked is the room's
+ * one voice; it reaches its helpers privately, and posts one update when
+ * their result is in. The pure pieces of that live here:
+ *  - {@link classifyAgentAddressing}: whom an agent's room post is for —
+ *    only agents on this machine (stays inside Crewly), agents elsewhere
+ *    (Slack, in a thread), or anyone else (unchanged);
+ *  - {@link stripTicketIds}: internal ticket ids out of anything an agent
+ *    posts to Slack, for real ticket prefixes only;
+ *  - {@link CoordinationDedupe}: the same agent sending a near-identical
+ *    message to the same recipients in the same room within 15 minutes.
+ *
+ * @module services/slack/agent-coordination
+ */
+/** Whom an agent's room post addresses. */
+export type AgentAddressing = 
+/** Only agents running on this machine: delivered inside Crewly, never posted to Slack. */
+'local-only'
+/** Only agents, at least one on another machine: Slack is the only way there, in a thread. */
+ | 'cross-machine'
+/** No agent @'d, or a person / broadcast / name nobody knows: posted as before. */
+ | 'other';
+/** What the room knows about the names an agent post @'s. */
+export interface AgentAddressingInput {
+    /** Agents @'d that run on this machine (sessions) */
+    localAgents: readonly string[];
+    /** Agents @'d that run on another machine (sessions or names) */
+    remoteAgents: readonly string[];
+    /** @-tokens or native ids that are neither: a person, or a name nobody knows */
+    others: readonly string[];
+    /** A person addressed by name without an @ ("Steve, …"), or @here/@channel */
+    addressesPeople: boolean;
+}
+/**
+ * Whom an agent's post addresses. Anything that may be for a person — a
+ * person's name, a broadcast, a name that matched nobody — keeps today's
+ * behaviour: the owner must never miss a message meant for them.
+ *
+ * @param input - The resolved names
+ * @returns The addressing class
+ *
+ * @example
+ * ```typescript
+ * classifyAgentAddressing({ localAgents: ['max'], remoteAgents: [], others: [], addressesPeople: false }); // 'local-only'
+ * classifyAgentAddressing({ localAgents: ['max'], remoteAgents: ['rex'], others: [], addressesPeople: false }); // 'cross-machine'
+ * classifyAgentAddressing({ localAgents: ['max'], remoteAgents: [], others: ['Steve'], addressesPeople: false }); // 'other'
+ * ```
+ */
+export declare function classifyAgentAddressing(input: AgentAddressingInput): AgentAddressing;
+/**
+ * The real ticket prefixes, normalised: upper case, two to ten letters or
+ * digits starting with a letter. One-letter prefixes (the `T` fallback,
+ * decisions' `D`) are left out — "T-5" or "D-3" in prose is too often not
+ * a ticket.
+ *
+ * @param prefixes - Prefixes as configured (project ticket counters, `TKT`)
+ * @returns Unique prefixes, longest first
+ */
+export declare function normaliseTicketPrefixes(prefixes: readonly string[]): string[];
+/**
+ * Take internal ticket ids out of a Slack post. Tickets are the harness's
+ * bookkeeping; the owner never sees their ids or mechanics.
+ *
+ * Only ids with a real prefix are touched, so "UTF-8", "GPT-6" or "ISO-27001"
+ * stay. An id that is part of a path, branch or URL ("fix/CREW-12",
+ * "/blog/CREW-12") stays too. A parenthetical of ids goes with its brackets,
+ * a leading "CREW-718:" with its colon, and a preposition left dangling
+ * before punctuation ("for CREW-718.") goes with the id.
+ *
+ * @param text - The post
+ * @param prefixes - Real ticket prefixes
+ * @returns The post without ticket ids (the original when nothing would be left)
+ *
+ * @example
+ * ```typescript
+ * stripTicketIds('@Max CREW-718 step 1 of 2 done', ['CREW']); // '@Max step 1 of 2 done'
+ * stripTicketIds('the fix (CREW-718) is live', ['CREW']);      // 'the fix is live'
+ * stripTicketIds('UTF-8 and GPT-6', ['CREW']);                 // unchanged
+ * ```
+ */
+export declare function stripTicketIds(text: string, prefixes: readonly string[]): string;
+/**
+ * Drops an agent's near-identical repeat to the same recipients in the same
+ * room within {@link AGENT_COORDINATION_CONSTANTS.DUPLICATE_WINDOW_MS} — Ella
+ * sent Sam one conclusion three times in six minutes (2026-10-16).
+ * In memory: a restart forgets, which only lets one repeat through.
+ */
+export declare class CoordinationDedupe {
+    private readonly windowMs;
+    private readonly threshold;
+    private readonly sent;
+    /**
+     * @param windowMs - How long a message counts as recent
+     * @param threshold - Similarity (0..1) at which two messages are one
+     */
+    constructor(windowMs?: number, threshold?: number);
+    /**
+     * Whether this message repeats one the same agent sent the same recipients
+     * here recently. A message that is not a repeat is remembered.
+     *
+     * @param room - Room id
+     * @param sender - Sending agent
+     * @param recipients - Addressed agents
+     * @param text - The message
+     * @param now - Current time (ms)
+     * @returns True for a repeat (drop it)
+     */
+    isRepeat(room: string, sender: string, recipients: readonly string[], text: string, now: number): boolean;
+}
+//# sourceMappingURL=agent-coordination.d.ts.map

package/dist/cli/backend/src/services/slack/agent-coordination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-coordination.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/slack/agent-coordination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,2CAA2C;AAC3C,MAAM,MAAM,eAAe;AACzB,2FAA2F;AACzF,YAAY;AACd,8FAA8F;GAC5F,eAAe;AACjB,mFAAmF;GACjF,OAAO,CAAC;AAEZ,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,iEAAiE;IACjE,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,gFAAgF;IAChF,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,8EAA8E;IAC9E,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,CAKpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAO7E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAoBhF;AAQD;;;;;GAKG;AACH,qBAAa,kBAAkB;IAQ3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAR5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;IAEvD;;;OAGG;gBAEgB,QAAQ,GAAE,MAAyD,EACnE,SAAS,GAAE,MAA0D;IAGxF;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;CAc1G"}