crewly 1.20.355 → 1.20.356

package/dist/backend/backend/src/services/runtime-fallback/runtime-fallback.service.d.ts

@@ -24,6 +24,17 @@
  *    most every BILLING_PROBE_INTERVAL_MS. A switch-back that fails (the limit
  *    comes straight back) doubles the next probe interval.
  * 7. **Tell the owner once** per event, and once when it is over.
+ * 8. **Prefer the better target.** While the configured runtime is still out,
+ *    an agent on a fallback moves (at an idle boundary, or when it is next
+ *    started) to the earliest available entry of its chain when that is
+ *    earlier than the one it is on — orc on `claude-code@work` goes back to
+ *    `claude-code` once the default login has usage, even though its own
+ *    runtime (DeepSeek, out of credit) is not back.
+ * 9. **Stale marks are cleared** when the reset time passes and a probe
+ *    answers, when the owner signs that login in again
+ *    ({@link RuntimeFallbackService.onRuntimeLogin} /
+ *    {@link RuntimeFallbackService.onAccountLogin}), or when another session
+ *    on that target is seen working ({@link RuntimeFallbackService.reportWorking}).
  *
  * A chain entry may be one of the owner's other Claude Code accounts
  * (`claude-code@work`, issue #942): it is a runtime target of its own — out
@@ -65,7 +76,12 @@ export interface HandoverRequest {
     sessionName: string;
     from: string;
     to: string;
-    direction: 'switch' | 'revert';
+    /**
+     * `switch`: `from` ran out; `revert`: back to the configured runtime;
+     * `upgrade`: `to` is earlier in the fallback order and has usage again
+     * (the configured runtime is still out)
+     */
+    direction: 'switch' | 'revert' | 'upgrade';
     /** Conversation id on `from`, when known */
     conversationId: string | null;
     /** WorkItem the agent is on */
@@ -169,6 +185,8 @@ export declare class RuntimeFallbackService implements RuntimeFallbackHooks {
     private readonly noticeDue;
     /** Kickoff notes waiting for a session's next launch */
     private readonly kickoffNotes;
+    /** Last working-evidence look per session (throttle) */
+    private readonly workingSeen;
     /** Last switch-back per runtime, to recognise one that failed */
     private readonly recentRecoveries;
     private availability;
@@ -241,11 +259,46 @@ export declare class RuntimeFallbackService implements RuntimeFallbackHooks {
      */
     private reevaluateExhausted;
     /**
-     * If the account was marked signed out, probe it and bring it back.
+     * The owner signed a harness's default login in again (the re-login flow
+     * finished for it). A mark on that runtime — signed out, or out of usage:
+     * the new login may be another account, or the same one with usage bought
+     * — is probed now instead of at its reset time, and cleared when the
+     * probe answers.
      *
-     * @param target - `claude-code@<account>`
+     * @param runtime - Runtime id (`claude-code`, `codex-cli`, …; the harness id)
+     * @returns Resolves when done; never rejects
+     *
+     * @example
+     * ```ts
+     * relogin.setHarnessLoginHandler((harnessId) => service.onRuntimeLogin(harnessId));
+     * ```
+     */
+    onRuntimeLogin(runtime: string): Promise<void>;
+    /**
+     * A login of a runtime target was signed in again: if it is marked (signed
+     * out or out of usage), probe it and bring it back when it answers.
+     *
+     * @param target - Runtime target (`claude-code`, `claude-code@<account>`)
      */
-    private recoverSignedOutAccount;
+    private recheckAfterLogin;
+    /**
+     * A session's model just answered with a tool call (Claude Code
+     * PreToolUse hook). A model cannot do that while its account is out of
+     * usage, so a mark on the target the session runs on is stale: it is
+     * cleared (agents moved off it come back at their idle boundary). Marks
+     * newer than WORKING_EVIDENCE_GRACE_MS are kept (a turn already streaming
+     * when the limit hit proves nothing). Looked at most once a minute per
+     * session, and only while a Claude Code target is marked.
+     *
+     * @param sessionName - Session the hook came from
+     */
+    reportWorking(sessionName: string): void;
+    /**
+     * Clear the mark on the target a working session runs on.
+     *
+     * @param sessionName - Session
+     */
+    private onWorking;
     /**
      * Take the note for a session's next kickoff.
      *
@@ -279,6 +332,13 @@ export declare class RuntimeFallbackService implements RuntimeFallbackHooks {
      * @returns The decision
      */
     resolveLaunch(input: LaunchRuntimeInput): Promise<LaunchRuntimeDecision>;
+    /**
+     * The agent behind a launch (from the launch input when it is not known).
+     *
+     * @param input - Launch input
+     * @returns Agent
+     */
+    private launchAgent;
     /**
      * The configured runtime of a launching agent is not installed / not signed
      * in on this machine: record it like a signed-out account so the agent starts
@@ -358,6 +418,7 @@ export declare class RuntimeFallbackService implements RuntimeFallbackHooks {
      * @param from - Runtime it leaves (out of usage)
      * @param target - Runtime it goes to
      * @param handover - Handover file, when written
+     * @param direction - `switch` (`from` ran out) or `upgrade` (`target` ranks higher in the chain)
      */
     private recordSwitch;
     /**
@@ -382,6 +443,19 @@ export declare class RuntimeFallbackService implements RuntimeFallbackHooks {
      * @returns Chain
      */
     private chainFor;
+    /**
+     * Where an agent whose configured runtime is out should be instead of
+     * `current`: the earliest available entry of its chain (never its
+     * configured runtime, never one marked out of usage), when that ranks
+     * before `current` — or, with `orAnyWhenCurrentOut`, any available entry
+     * when `current` itself is marked out.
+     *
+     * @param agent - Agent (its configured runtime is out)
+     * @param current - Runtime target it is on
+     * @param orAnyWhenCurrentOut - Also move off a `current` that ran out to a lower-ranked entry
+     * @returns Better target, or null to stay
+     */
+    private betterTarget;
     /**
      * Whether some runtime could take over (synchronous; uses the cached
      * availability, optimistic when nothing is cached yet).
@@ -428,8 +502,29 @@ export declare class RuntimeFallbackService implements RuntimeFallbackHooks {
      * @param runtime - Runtime
      */
     recover(runtime: string): Promise<void>;
-    /** Revert every pending override whose agent is idle (or not running). */
+    /**
+     * Revert every pending override whose agent is idle (or not running), and
+     * move an idle agent whose configured runtime is still out to a better
+     * entry of its chain ({@link betterTarget}).
+     */
     private revertIdle;
+    /**
+     * Move an idle, running agent to a better entry of its chain. A stopped
+     * agent is left alone: its next start picks the best target.
+     *
+     * @param sessionName - Session
+     * @param override - Its override (the configured runtime is out)
+     */
+    private upgradeIfBetter;
+    /**
+     * Hand over and relaunch an idle agent on a better target.
+     *
+     * @param agent - Agent
+     * @param from - Target it is on
+     * @param target - Better target
+     * @returns Outcome
+     */
+    private doUpgrade;
     /**
      * Clear the override of an agent that is not running.
      *
@@ -475,6 +570,7 @@ export declare class RuntimeFallbackService implements RuntimeFallbackHooks {
     private notify;
     private formatTime;
     private switchNote;
+    private upgradeNote;
     private revertNote;
     /**
      * Badge data for an agent running on a fallback.

package/dist/backend/backend/src/services/runtime-fallback/runtime-fallback.service.d.ts.map

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

package/dist/backend/backend/src/services/runtime-fallback/runtime-fallback.service.js

@@ -24,6 +24,17 @@
  *    most every BILLING_PROBE_INTERVAL_MS. A switch-back that fails (the limit
  *    comes straight back) doubles the next probe interval.
  * 7. **Tell the owner once** per event, and once when it is over.
+ * 8. **Prefer the better target.** While the configured runtime is still out,
+ *    an agent on a fallback moves (at an idle boundary, or when it is next
+ *    started) to the earliest available entry of its chain when that is
+ *    earlier than the one it is on — orc on `claude-code@work` goes back to
+ *    `claude-code` once the default login has usage, even though its own
+ *    runtime (DeepSeek, out of credit) is not back.
+ * 9. **Stale marks are cleared** when the reset time passes and a probe
+ *    answers, when the owner signs that login in again
+ *    ({@link RuntimeFallbackService.onRuntimeLogin} /
+ *    {@link RuntimeFallbackService.onAccountLogin}), or when another session
+ *    on that target is seen working ({@link RuntimeFallbackService.reportWorking}).
  *
  * A chain entry may be one of the owner's other Claude Code accounts
  * (`claude-code@work`, issue #942): it is a runtime target of its own — out
@@ -41,6 +52,7 @@
  */
 import { ORCHESTRATOR_SESSION_NAME, RUNTIME_FALLBACK_CONSTANTS, RUNTIME_TYPES } from '../../constants.js';
 import { detectUsageLimit } from './usage-limit-rules.js';
+import { clearUsageLimit } from './usage-limit-state.js';
 import { traceRuntimeBlocked } from '../trace/trace-recorder.js';
 import { accountOf, baseRuntimeOf, parseRuntimeTarget, runtimeTarget } from '../harness/claude-accounts.js';
 import { applySettingsPatch, runtimeLabel, runtimeShortLabel, } from './runtime-fallback.types.js';
@@ -76,6 +88,8 @@ export class RuntimeFallbackService {
     noticeDue = new Map();
     /** Kickoff notes waiting for a session's next launch */
     kickoffNotes = new Map();
+    /** Last working-evidence look per session (throttle) */
+    workingSeen = new Map();
     /** Last switch-back per runtime, to recognise one that failed */
     recentRecoveries = new Map();
     availability = null;
@@ -179,7 +193,7 @@ export class RuntimeFallbackService {
         this.availability = null;
         const target = runtimeTarget(RUNTIME_TYPES.CLAUDE_CODE, account);
         try {
-            await this.recoverSignedOutAccount(target);
+            await this.recheckAfterLogin(target);
         }
         finally {
             // The owner is away: a freshly signed-in account must be usable at once,
@@ -254,27 +268,94 @@ export class RuntimeFallbackService {
         }
     }
     /**
-     * If the account was marked signed out, probe it and bring it back.
+     * The owner signed a harness's default login in again (the re-login flow
+     * finished for it). A mark on that runtime — signed out, or out of usage:
+     * the new login may be another account, or the same one with usage bought
+     * — is probed now instead of at its reset time, and cleared when the
+     * probe answers.
      *
-     * @param target - `claude-code@<account>`
+     * @param runtime - Runtime id (`claude-code`, `codex-cli`, …; the harness id)
+     * @returns Resolves when done; never rejects
+     *
+     * @example
+     * ```ts
+     * relogin.setHarnessLoginHandler((harnessId) => service.onRuntimeLogin(harnessId));
+     * ```
      */
-    async recoverSignedOutAccount(target) {
+    async onRuntimeLogin(runtime) {
+        this.availability = null;
+        try {
+            await this.recheckAfterLogin(runtime);
+        }
+        catch (err) {
+            this.logger.warn('Re-checking a runtime after a sign-in failed', { runtime, error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    /**
+     * A login of a runtime target was signed in again: if it is marked (signed
+     * out or out of usage), probe it and bring it back when it answers.
+     *
+     * @param target - Runtime target (`claude-code`, `claude-code@<account>`)
+     */
+    async recheckAfterLogin(target) {
         const entry = this.state.exhausted[target];
-        if (!entry || entry.kind !== 'login')
+        if (!entry)
             return;
         const result = await this.deps.probe(target).catch(() => 'unknown');
         entry.lastProbeAt = new Date(this.now()).toISOString();
         if (result === 'available') {
+            this.logger.info('Signed in again and the probe answers — clearing the out-of-usage mark', { runtime: target, kind: entry.kind ?? 'usage_limit' });
             await this.recover(target);
             return;
         }
-        if (result === 'limited') {
+        if (result === 'limited' && entry.kind === 'login') {
             // Signed in again, but that account is out of usage too.
             entry.kind = 'usage_limit';
             entry.ruleId = 'probe_limited';
         }
         this.save();
     }
+    /**
+     * A session's model just answered with a tool call (Claude Code
+     * PreToolUse hook). A model cannot do that while its account is out of
+     * usage, so a mark on the target the session runs on is stale: it is
+     * cleared (agents moved off it come back at their idle boundary). Marks
+     * newer than WORKING_EVIDENCE_GRACE_MS are kept (a turn already streaming
+     * when the limit hit proves nothing). Looked at most once a minute per
+     * session, and only while a Claude Code target is marked.
+     *
+     * @param sessionName - Session the hook came from
+     */
+    reportWorking(sessionName) {
+        if (!this.state.settings.enabled || this.isExempt(sessionName))
+            return;
+        if (!Object.keys(this.state.exhausted).some((r) => baseRuntimeOf(r) === RUNTIME_TYPES.CLAUDE_CODE))
+            return;
+        if (this.switching.has(sessionName))
+            return;
+        const now = this.now();
+        if (now - (this.workingSeen.get(sessionName) ?? Number.NEGATIVE_INFINITY) < C.WORKING_EVIDENCE_THROTTLE_MS)
+            return;
+        this.workingSeen.set(sessionName, now);
+        void this.onWorking(sessionName).catch((err) => this.logger.warn('Runtime fallback could not use a working signal', { sessionName, error: err instanceof Error ? err.message : String(err) }));
+    }
+    /**
+     * Clear the mark on the target a working session runs on.
+     *
+     * @param sessionName - Session
+     */
+    async onWorking(sessionName) {
+        const target = this.state.overrides[sessionName]?.runtime ?? (await this.deps.getAgent(sessionName).catch(() => null))?.primary;
+        if (!target || baseRuntimeOf(target) !== RUNTIME_TYPES.CLAUDE_CODE)
+            return;
+        const entry = this.state.exhausted[target];
+        if (!entry)
+            return;
+        if (this.now() - Date.parse(entry.since) < C.WORKING_EVIDENCE_GRACE_MS)
+            return;
+        this.logger.info('A session is working on a runtime marked out of usage — clearing the mark', { runtime: target, sessionName, since: entry.since });
+        await this.recover(target);
+    }
     /**
      * Take the note for a session's next kickoff.
      *
@@ -359,7 +440,20 @@ export class RuntimeFallbackService {
                 this.finishRevertOffline(input.sessionName, existing);
                 return configured;
             }
+            else if (!this.state.exhausted[existing.primary]) {
+                // Its runtime is back but not yet marked for revert: the next tick reverts it.
+                return this.decision(existing.runtime);
+            }
             else {
+                // Starting anyway: on the best target of its chain, not on one that ran
+                // out meanwhile or below one that came back.
+                const agent = await this.launchAgent(input);
+                const better = await this.betterTarget(agent, existing.runtime, true);
+                if (better) {
+                    await this.recordSwitch(agent, existing.runtime, better, null, this.state.exhausted[existing.runtime] ? 'switch' : 'upgrade');
+                    this.logger.info('Starting an agent on a better fallback runtime', { sessionName: input.sessionName, from: existing.runtime, runtime: better });
+                    return this.decision(better);
+                }
                 return this.decision(existing.runtime);
             }
         }
@@ -373,14 +467,7 @@ export class RuntimeFallbackService {
         }
         if (input.isOrchestrator && !this.state.settings.orcFollows)
             return configured;
-        const agent = (await this.deps.getAgent(input.sessionName).catch(() => null)) ?? {
-            sessionName: input.sessionName,
-            name: input.sessionName,
-            primary: input.configured,
-            memberId: input.memberId,
-            teamId: input.teamId,
-            isOrchestrator: input.isOrchestrator,
-        };
+        const agent = await this.launchAgent(input);
         const target = await this.pickFallback(agent, input.configured);
         if (!target) {
             this.markNoFallback(input.configured);
@@ -394,6 +481,22 @@ export class RuntimeFallbackService {
         });
         return this.decision(target);
     }
+    /**
+     * The agent behind a launch (from the launch input when it is not known).
+     *
+     * @param input - Launch input
+     * @returns Agent
+     */
+    async launchAgent(input) {
+        return ((await this.deps.getAgent(input.sessionName).catch(() => null)) ?? {
+            sessionName: input.sessionName,
+            name: input.sessionName,
+            primary: input.configured,
+            memberId: input.memberId,
+            teamId: input.teamId,
+            isOrchestrator: input.isOrchestrator,
+        });
+    }
     /**
      * The configured runtime of a launching agent is not installed / not signed
      * in on this machine: record it like a signed-out account so the agent starts
@@ -510,8 +613,11 @@ export class RuntimeFallbackService {
         }
         else {
             const confirmed = await this.confirm(runtime);
-            if (!confirmed)
+            if (!confirmed) {
+                // The probe answered normally: the session is not out of usage either.
+                clearUsageLimit(sessionName);
                 return;
+            }
             if (!this.state.exhausted[runtime]) {
                 // The limit came straight back after a switch-back: back off the
                 // next probe, and do not tell the owner a second time.
@@ -590,6 +696,10 @@ export class RuntimeFallbackService {
         }
         finally {
             this.switching.delete(sessionName);
+            // On another runtime now (or back on one that has usage again): the
+            // session's own usage-limit state no longer holds.
+            if (outcome === 'switched' || outcome === 'reverted')
+                clearUsageLimit(sessionName);
             await this.afterSwitch(sessionName, outcome, opts.flushAfter);
         }
     }
@@ -653,8 +763,9 @@ export class RuntimeFallbackService {
      * @param from - Runtime it leaves (out of usage)
      * @param target - Runtime it goes to
      * @param handover - Handover file, when written
+     * @param direction - `switch` (`from` ran out) or `upgrade` (`target` ranks higher in the chain)
      */
-    async recordSwitch(agent, from, target, handover = null) {
+    async recordSwitch(agent, from, target, handover = null, direction = 'switch') {
         const sessionName = agent.sessionName;
         const existing = this.state.overrides[sessionName];
         const exhausted = this.state.exhausted[from];
@@ -685,7 +796,7 @@ export class RuntimeFallbackService {
         }
         this.save();
         const workItem = await this.deps.getActiveWorkItem(sessionName).catch(() => null);
-        this.kickoffNotes.set(sessionName, this.switchNote(from, target, exhausted?.until, handover, workItem));
+        this.kickoffNotes.set(sessionName, direction === 'upgrade' ? this.upgradeNote(agent.primary, from, target, handover, workItem) : this.switchNote(from, target, exhausted?.until, handover, workItem));
         this.scheduleNotice(from);
     }
     /**
@@ -731,6 +842,33 @@ export class RuntimeFallbackService {
         const own = agent.memberId ? this.state.settings.memberChains[agent.memberId] : undefined;
         return own && own.length > 0 ? own : this.state.settings.chain;
     }
+    /**
+     * Where an agent whose configured runtime is out should be instead of
+     * `current`: the earliest available entry of its chain (never its
+     * configured runtime, never one marked out of usage), when that ranks
+     * before `current` — or, with `orAnyWhenCurrentOut`, any available entry
+     * when `current` itself is marked out.
+     *
+     * @param agent - Agent (its configured runtime is out)
+     * @param current - Runtime target it is on
+     * @param orAnyWhenCurrentOut - Also move off a `current` that ran out to a lower-ranked entry
+     * @returns Better target, or null to stay
+     */
+    async betterTarget(agent, current, orAnyWhenCurrentOut) {
+        const best = await this.pickFallback(agent, agent.primary);
+        if (!best || best === current)
+            return null;
+        const chain = this.chainFor(agent);
+        const rank = (r) => {
+            const i = chain.indexOf(r);
+            return i < 0 ? Number.POSITIVE_INFINITY : i;
+        };
+        if (rank(best) < rank(current))
+            return best;
+        if (orAnyWhenCurrentOut && this.state.exhausted[current])
+            return best;
+        return null;
+    }
     /**
      * Whether some runtime could take over (synchronous; uses the cached
      * availability, optimistic when nothing is cached yet).
@@ -894,11 +1032,17 @@ export class RuntimeFallbackService {
         }
         await this.revertIdle();
     }
-    /** Revert every pending override whose agent is idle (or not running). */
+    /**
+     * Revert every pending override whose agent is idle (or not running), and
+     * move an idle agent whose configured runtime is still out to a better
+     * entry of its chain ({@link betterTarget}).
+     */
     async revertIdle() {
         for (const [sessionName, override] of Object.entries(this.state.overrides)) {
-            if (this.state.exhausted[override.primary])
+            if (this.state.exhausted[override.primary]) {
+                await this.upgradeIfBetter(sessionName, override);
                 continue;
+            }
             if (!override.revertPending) {
                 // State from before a restart whose primary is no longer marked out of usage.
                 override.revertPending = true;
@@ -915,6 +1059,79 @@ export class RuntimeFallbackService {
             await this.revertSession(sessionName);
         }
     }
+    /**
+     * Move an idle, running agent to a better entry of its chain. A stopped
+     * agent is left alone: its next start picks the best target.
+     *
+     * @param sessionName - Session
+     * @param override - Its override (the configured runtime is out)
+     */
+    async upgradeIfBetter(sessionName, override) {
+        if (this.switching.has(sessionName) || this.isExempt(sessionName) || !this.deps.isLive(sessionName))
+            return;
+        // Cheap filter before reading the agent: some other chain entry must be open.
+        const { chain, memberChains } = this.state.settings;
+        const open = [...chain, ...Object.values(memberChains).flat()].some((r) => r !== override.runtime && r !== override.primary && !this.state.exhausted[r]);
+        if (!open)
+            return;
+        const agent = await this.deps.getAgent(sessionName).catch(() => null);
+        if (!agent || agent.primary !== override.primary)
+            return;
+        if (agent.isOrchestrator && !this.state.settings.orcFollows)
+            return;
+        const better = await this.betterTarget(agent, override.runtime, false);
+        if (!better)
+            return;
+        if (await this.deps.isBusy(sessionName).catch(() => true))
+            return;
+        if (this.switching.has(sessionName))
+            return;
+        this.switching.add(sessionName);
+        let outcome = 'skipped';
+        try {
+            outcome = await this.doUpgrade(agent, override.runtime, better);
+        }
+        catch (err) {
+            this.logger.warn('Moving an agent to a better fallback runtime failed', { sessionName, error: err instanceof Error ? err.message : String(err) });
+            outcome = 'failed';
+        }
+        finally {
+            this.switching.delete(sessionName);
+            await this.afterSwitch(sessionName, outcome, false);
+        }
+    }
+    /**
+     * Hand over and relaunch an idle agent on a better target.
+     *
+     * @param agent - Agent
+     * @param from - Target it is on
+     * @param target - Better target
+     * @returns Outcome
+     */
+    async doUpgrade(agent, from, target) {
+        const sessionName = agent.sessionName;
+        // Last look right before: anything that started since means "not now".
+        if (await this.deps.isBusy(sessionName).catch(() => true))
+            return 'skipped';
+        const handover = await this.deps
+            .writeHandover({
+            sessionName,
+            from,
+            to: target,
+            direction: 'upgrade',
+            conversationId: this.deps.conversation.get(sessionName) ?? null,
+            workItem: await this.deps.getActiveWorkItem(sessionName).catch(() => null),
+        })
+            .catch(() => null);
+        await this.recordSwitch(agent, from, target, handover, 'upgrade');
+        this.logger.info('Moving an idle agent to a better fallback runtime (its own runtime is still out)', { sessionName, from, to: target, primary: agent.primary });
+        const ok = await this.deps.relaunch(agent).catch(() => false);
+        if (!ok) {
+            this.logger.warn('Relaunch on the better fallback runtime failed (the override stays; the next start uses it)', { sessionName, runtime: target });
+            return 'failed';
+        }
+        return 'switched';
+    }
     /**
      * Clear the override of an agent that is not running.
      *
@@ -1156,6 +1373,17 @@ export class RuntimeFallbackService {
             parts.push(`Then continue WorkItem ${workItem.id} ("${workItem.title}") where you left off.`);
         return parts.join(' ');
     }
+    upgradeNote(primary, from, to, handover, workItem) {
+        const parts = [
+            `${this.label(to)} has usage again, so Crewly moved you there from ${this.label(from)}; ${this.label(primary)} is still unavailable and you will be moved back to it once it is.`,
+            handover
+                ? `This is a fresh conversation: after registering, read ${handover} once — it holds the end of your previous conversation.`
+                : 'This is a fresh conversation: your tasks, teams and wiki are all still in Crewly.',
+        ];
+        if (workItem)
+            parts.push(`Then continue WorkItem ${workItem.id} ("${workItem.title}") where you left off.`);
+        return parts.join(' ');
+    }
     revertNote(override, handover, workItem) {
         const parts = [
             `${this.label(override.primary)} is available again, so Crewly moved you back from ${this.label(override.runtime)}.`,