crewly 1.20.302 → 1.20.303

package/dist/backend/backend/src/controllers/usage-ledger/usage-ledger.controller.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Usage ledger endpoints: per-ticket time / token reports and the owner's
+ * report categories.
+ *
+ * - `GET    /api/usage-ledger/report?since=7d&until=&by=category|team|project|agent|ticket&categories=&limit=`
+ * - `GET    /api/usage-ledger/categories`
+ * - `PUT    /api/usage-ledger/categories`          `{ categories: CategoryDef[] }` (replaces all)
+ * - `POST   /api/usage-ledger/categories`          `CategoryDef` (adds or replaces one)
+ * - `DELETE /api/usage-ledger/categories/:name`
+ * - `GET    /api/usage-ledger/units/:id`           facts of one ticket (unit id or ticket label)
+ * - `POST   /api/usage-ledger/backfill`            one-time history rebuild (no-op once done)
+ *
+ * specs/2026-10-11-usage-ledger.md
+ *
+ * @module controllers/usage-ledger/usage-ledger.controller
+ */
+import type { Request, Response } from 'express';
+import { type UsageLedger } from '../../services/usage-ledger/usage-ledger.runtime.js';
+/** Ledger accessor (tests inject a fake). */
+export type LedgerAccessor = () => UsageLedger;
+/**
+ * Build the handlers.
+ *
+ * @param ledger - Ledger accessor
+ * @returns Express handlers
+ */
+export declare function createUsageLedgerHandlers(ledger?: LedgerAccessor): {
+    report(req: Request, res: Response): Promise<void>;
+    listCategories(_req: Request, res: Response): Promise<void>;
+    replaceCategories(req: Request, res: Response): Promise<void>;
+    setCategory(req: Request, res: Response): Promise<void>;
+    removeCategory(req: Request, res: Response): Promise<void>;
+    getUnit(req: Request, res: Response): Promise<void>;
+    backfill(_req: Request, res: Response): Promise<void>;
+};
+//# sourceMappingURL=usage-ledger.controller.d.ts.map

package/dist/backend/backend/src/controllers/usage-ledger/usage-ledger.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-ledger.controller.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/usage-ledger/usage-ledger.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGjD,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAGvG,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC;AAI/C;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,GAAE,cAA+B;gBAE7D,OAAO,OAAO,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;yBA0C7B,OAAO,OAAO,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;2BAQpC,OAAO,OAAO,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;qBAkB5C,OAAO,OAAO,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;wBAanC,OAAO,OAAO,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;iBAa7C,OAAO,OAAO,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;mBAwBpC,OAAO,OAAO,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;EAQ5D"}

package/dist/backend/backend/src/controllers/usage-ledger/usage-ledger.controller.js

@@ -0,0 +1,158 @@
+/**
+ * Usage ledger endpoints: per-ticket time / token reports and the owner's
+ * report categories.
+ *
+ * - `GET    /api/usage-ledger/report?since=7d&until=&by=category|team|project|agent|ticket&categories=&limit=`
+ * - `GET    /api/usage-ledger/categories`
+ * - `PUT    /api/usage-ledger/categories`          `{ categories: CategoryDef[] }` (replaces all)
+ * - `POST   /api/usage-ledger/categories`          `CategoryDef` (adds or replaces one)
+ * - `DELETE /api/usage-ledger/categories/:name`
+ * - `GET    /api/usage-ledger/units/:id`           facts of one ticket (unit id or ticket label)
+ * - `POST   /api/usage-ledger/backfill`            one-time history rebuild (no-op once done)
+ *
+ * specs/2026-10-11-usage-ledger.md
+ *
+ * @module controllers/usage-ledger/usage-ledger.controller
+ */
+import { formatError } from '../../utils/format-error.js';
+import { parseCategoriesParam } from '../../services/usage-ledger/categories-param.js';
+import { getUsageLedger } from '../../services/usage-ledger/usage-ledger.runtime.js';
+import { parseSince, REPORT_DIMENSIONS } from '../../services/usage-ledger/usage-report.service.js';
+const first = (v) => (typeof v === 'string' && v.trim() ? v.trim() : undefined);
+/**
+ * Build the handlers.
+ *
+ * @param ledger - Ledger accessor
+ * @returns Express handlers
+ */
+export function createUsageLedgerHandlers(ledger = getUsageLedger) {
+    return {
+        async report(req, res) {
+            try {
+                const now = Date.now();
+                const since = parseSince(first(req.query.since) ?? '7d', now);
+                const until = first(req.query.until) ? parseSince(first(req.query.until), now) : now;
+                if (since === null || until === null) {
+                    res.status(400).json({ success: false, error: 'since / until must look like 7d, 24h, 2w or an ISO date' });
+                    return;
+                }
+                const by = (first(req.query.by) ?? 'category');
+                if (!REPORT_DIMENSIONS.includes(by)) {
+                    res.status(400).json({ success: false, error: `by must be one of ${REPORT_DIMENSIONS.join(', ')}` });
+                    return;
+                }
+                const l = ledger();
+                let defs;
+                let only;
+                const categoriesArg = first(req.query.categories);
+                if (categoriesArg) {
+                    const parsed = parseCategoriesParam(categoriesArg, (await l.categories.list()).categories);
+                    if (typeof parsed === 'string') {
+                        res.status(400).json({ success: false, error: parsed });
+                        return;
+                    }
+                    defs = parsed.defs;
+                    only = parsed.only;
+                }
+                const limit = Number(first(req.query.limit));
+                const report = await l.reports.report({
+                    sinceMs: since,
+                    untilMs: until,
+                    by,
+                    ...(defs ? { categories: defs } : {}),
+                    ...(only && only.length > 0 ? { only } : {}),
+                    ...(Number.isFinite(limit) && limit > 0 ? { limit } : {}),
+                });
+                res.json({ success: true, data: report });
+            }
+            catch (error) {
+                res.status(500).json({ success: false, error: formatError(error) });
+            }
+        },
+        async listCategories(_req, res) {
+            try {
+                res.json({ success: true, data: await ledger().categories.list() });
+            }
+            catch (error) {
+                res.status(500).json({ success: false, error: formatError(error) });
+            }
+        },
+        async replaceCategories(req, res) {
+            try {
+                const body = req.body;
+                if (!Array.isArray(body?.categories)) {
+                    res.status(400).json({ success: false, error: 'body must be { "categories": [...] }' });
+                    return;
+                }
+                const result = await ledger().categories.replaceAll(body.categories);
+                if (typeof result === 'string') {
+                    res.status(400).json({ success: false, error: result });
+                    return;
+                }
+                res.json({ success: true, data: result });
+            }
+            catch (error) {
+                res.status(500).json({ success: false, error: formatError(error) });
+            }
+        },
+        async setCategory(req, res) {
+            try {
+                const result = await ledger().categories.set(req.body);
+                if (typeof result === 'string') {
+                    res.status(400).json({ success: false, error: result });
+                    return;
+                }
+                res.json({ success: true, data: result });
+            }
+            catch (error) {
+                res.status(500).json({ success: false, error: formatError(error) });
+            }
+        },
+        async removeCategory(req, res) {
+            try {
+                const result = await ledger().categories.remove(String(req.params.name ?? ''));
+                if (!result) {
+                    res.status(404).json({ success: false, error: 'no such category' });
+                    return;
+                }
+                res.json({ success: true, data: result });
+            }
+            catch (error) {
+                res.status(500).json({ success: false, error: formatError(error) });
+            }
+        },
+        async getUnit(req, res) {
+            try {
+                const l = ledger();
+                await l.recorder.flush();
+                await l.rollup.refresh(l.store);
+                const id = String(req.params.id ?? '');
+                const unit = l.rollup.units.get(id) ?? [...l.rollup.units.values()].find((u) => u.ticketId === id || u.requestId === id);
+                if (!unit) {
+                    res.status(404).json({ success: false, error: 'no such ticket in the ledger' });
+                    return;
+                }
+                res.json({
+                    success: true,
+                    data: {
+                        ...unit,
+                        agents: [...unit.agents.entries()].map(([agent, info]) => ({ agent, ...info })),
+                        ownerMessages: unit.ownerMessages.length,
+                    },
+                });
+            }
+            catch (error) {
+                res.status(500).json({ success: false, error: formatError(error) });
+            }
+        },
+        async backfill(_req, res) {
+            try {
+                res.json({ success: true, data: await ledger().backfill() });
+            }
+            catch (error) {
+                res.status(500).json({ success: false, error: formatError(error) });
+            }
+        },
+    };
+}
+//# sourceMappingURL=usage-ledger.controller.js.map

package/dist/backend/backend/src/controllers/usage-ledger/usage-ledger.controller.js.map

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

package/dist/backend/backend/src/controllers/usage-ledger/usage-ledger.routes.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Routes of the usage ledger (`/api/usage-ledger`).
+ *
+ * @module controllers/usage-ledger/usage-ledger.routes
+ */
+import { Router } from 'express';
+import { type LedgerAccessor } from './usage-ledger.controller.js';
+/**
+ * Create the usage ledger router.
+ *
+ * @param ledger - Ledger accessor (default: the process-wide ledger)
+ * @returns Express router
+ */
+export declare function createUsageLedgerRouter(ledger?: LedgerAccessor): Router;
+//# sourceMappingURL=usage-ledger.routes.d.ts.map

package/dist/backend/backend/src/controllers/usage-ledger/usage-ledger.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-ledger.routes.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/usage-ledger/usage-ledger.routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9F;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,CAWvE"}

package/dist/backend/backend/src/controllers/usage-ledger/usage-ledger.routes.js

@@ -0,0 +1,26 @@
+/**
+ * Routes of the usage ledger (`/api/usage-ledger`).
+ *
+ * @module controllers/usage-ledger/usage-ledger.routes
+ */
+import { Router } from 'express';
+import { createUsageLedgerHandlers } from './usage-ledger.controller.js';
+/**
+ * Create the usage ledger router.
+ *
+ * @param ledger - Ledger accessor (default: the process-wide ledger)
+ * @returns Express router
+ */
+export function createUsageLedgerRouter(ledger) {
+    const h = createUsageLedgerHandlers(ledger);
+    const router = Router();
+    router.get('/report', h.report);
+    router.get('/categories', h.listCategories);
+    router.put('/categories', h.replaceCategories);
+    router.post('/categories', h.setCategory);
+    router.delete('/categories/:name', h.removeCategory);
+    router.get('/units/:id', h.getUnit);
+    router.post('/backfill', h.backfill);
+    return router;
+}
+//# sourceMappingURL=usage-ledger.routes.js.map

package/dist/backend/backend/src/controllers/usage-ledger/usage-ledger.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-ledger.routes.js","sourceRoot":"","sources":["../../../../../../backend/src/controllers/usage-ledger/usage-ledger.routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAuB,MAAM,8BAA8B,CAAC;AAE9F;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC9D,MAAM,CAAC,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC/C,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/backend/backend/src/index.d.ts

@@ -67,6 +67,7 @@ export declare class CrewlyServer {
     /** Owner promises past due and never nudged at boot; their agents are restored and reminded once */
     private openCommitmentsAtBoot;
     private healthMonitoringInterval;
+    private backgroundWatchdog;
     constructor(config?: Partial<StartupConfig>);
     private initializeServices;
     private configureMiddleware;
@@ -354,6 +355,15 @@ export declare class CrewlyServer {
      */
     private startOwnerThreadSentinel;
     private startOwnerMessageWatchdog;
+    /**
+     * The one hook every stop path runs: what the stopped agent owes goes back
+     * in the queue and the agent is brought back with a reminder.
+     *
+     * @param sessionName - The agent that stopped
+     * @param why - Reason text
+     * @returns True when the agent is being brought back
+     */
+    private restoreStoppedOwing;
     /**
      * An agent went down with messages still queued for it: start it again so
      * they are delivered (registration drains the queue). Without this the

package/dist/backend/backend/src/index.d.ts.map

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

package/dist/backend/backend/src/index.js

@@ -142,7 +142,10 @@ import { getRuntimeFallbackService } from './services/runtime-fallback/runtime-f
 import { getSlackAgentIdentityService } from './services/slack/slack-agent-identity.service.js';
 import { getChatV2Service } from './services/chat-v2/chat-v2.singleton.js';
 import { isOwnerStopped } from './services/agent/owner-stopped.registry.js';
-import { createFollowThrough, settleFollowThrough, idlePendingWorkCheck, releaseWorkForStop, owedWorkReminder } from './services/agent/follow-through.wiring.js';
+import { pausedTeamOfSession } from './services/team/team-pause.registry.js';
+import { getFollowThrough } from './services/agent/follow-through.service.js';
+import { BackgroundWorkWatchdog } from './services/monitoring/background-work-watchdog.js';
+import { createFollowThrough, settleFollowThrough, idlePendingWorkCheck, releaseWorkForStop, restoreStoppedOwingWork, owedWorkReminder, OWED_REMINDER_MARKER } from './services/agent/follow-through.wiring.js';
 import { isSessionPaused } from './services/team/team-pause.registry.js';
 import { findPackageRoot } from './utils/package-root.js';
 import { getLocalApiBaseUrl, setLocalApiPort } from './utils/local-api-url.utils.js';
@@ -184,6 +187,7 @@ import { sessionsToRestore } from './services/agent/restore-filter.js';
 import { ProjectMemoryService } from './services/memory/project-memory.service.js';
 import { TaskHistorySubscriber } from './services/memory/task-history.subscriber.js';
 import { TeamHealthWatchdogService, LiveTeamHealthDataProvider, loadTeamHealthConfig, setTeamHealthWatchdogSingleton, getTeamHealthWatchdogSingleton, } from './services/team-health/index.js';
+import { getUsageLedger } from './services/usage-ledger/usage-ledger.runtime.js';
 import { traceHarness, traceTurnActivity } from './services/trace/trace-recorder.js';
 import { inputCircuitStats, setInputCircuitOpenListener } from './services/session/input-circuit-breaker.js';
 import { looksLikeShellPrompt } from './utils/screen-excerpt.js';
@@ -350,6 +354,7 @@ export class CrewlyServer {
     /** Owner promises past due and never nudged at boot; their agents are restored and reminded once */
     openCommitmentsAtBoot = [];
     healthMonitoringInterval = null;
+    backgroundWatchdog = null;
     constructor(config) {
         // Resolve ~ to actual home directory
         const resolveHomePath = (inputPath) => {
@@ -1297,7 +1302,14 @@ export class CrewlyServer {
         setSlackImageService(slackImageService);
         // Wire agent:idle events to thread status queue for delegation completion
         this.eventBusService.on('eventPublished', (event) => {
+            if (event.type === 'agent:busy' && event.sessionName)
+                getSlackTypingPlaceholderService()?.releaseHold(event.sessionName);
+            if ((event.type === 'agent:idle' || event.type === 'agent:busy') && event.sessionName) {
+                ResourceModeService.getInstance().noteWorkingStatus(event.sessionName, event.type === 'agent:idle');
+            }
             if (event.type === 'agent:inactive' && event.sessionName) {
+                // A runtime that exited while the agent owed work: same hook as the other stop paths.
+                void this.restoreStoppedOwing(event.sessionName, 'runtime exited');
                 this.wakeIfMessagesQueued(event.sessionName);
             }
             // A turn started: the harness's "working on it" watch may be waiting
@@ -1385,6 +1397,7 @@ export class CrewlyServer {
         // 2026-05-16: queued WIs for inactive Atlas could not get woken
         // because the floor was held by idle product/marketing agents).
         liveDataProvider.setAgentRegistrationService(this.apiController.agentRegistrationService);
+        liveDataProvider.setAgentStoppedHook((name, why) => { void this.restoreStoppedOwing(name, why); });
         // Initialize Reconciler Service (V2 — system truth recomputation)
         {
             const reconcilerLogger = LoggerService.getInstance().createComponentLogger('ReconcilerInit');
@@ -1960,6 +1973,14 @@ export class CrewlyServer {
                 crewlyHome: this.config.crewlyHome,
                 sendToAgent: (session, text) => this.apiController.agentRegistrationService.sendMessageToAgent(session, text),
             });
+            // Background subagents / forks that stopped writing are not busy work:
+            // the agent is told and no longer counted busy (2026-10-12, Pia).
+            this.backgroundWatchdog?.stop();
+            this.backgroundWatchdog = new BackgroundWorkWatchdog({
+                turnState: AgentTurnStateService.getInstance(),
+                sendToAgent: (session, text) => this.apiController.agentRegistrationService.sendMessageToAgent(session, text),
+            });
+            this.backgroundWatchdog.start();
             // An agent that owes work — a WorkItem (queued, accepted or running),
             // an assigned ticket, a promise to the owner, an unfulfilled "doing X
             // now" — is never idle-stopped. Under memory pressure it still can
@@ -1970,20 +1991,7 @@ export class CrewlyServer {
             // a slot frees, with a reminder of what it promised (the work itself is
             // already queued for it by the releaser).
             idleDetection.setOwedStopHook((sessionName) => {
-                void (async () => {
-                    const reminder = owedWorkReminder(await TaskPoolService.getInstance().getAllItems(), sessionName);
-                    if (!reminder)
-                        return;
-                    SubAgentMessageQueue.getInstance().enqueue(sessionName, reminder);
-                    this.logger.info('Stopped agent owes work — it will be restarted when a slot frees', { sessionName });
-                    const { scheduleDeferredStartRetry } = await import('./services/messaging/deferred-start-retry.js');
-                    const { activateAgentBySession } = await import('./controllers/team/team.controller.js');
-                    await scheduleDeferredStartRetry(sessionName, {
-                        activate: (name) => activateAgentBySession(this.apiController, name),
-                        hasPending: (name) => SubAgentMessageQueue.getInstance().hasPending(name),
-                        firstPauseMs: 60_000,
-                    });
-                })().catch(() => undefined);
+                void this.restoreStoppedOwing(sessionName, 'idle stop under memory pressure');
             });
             idleDetection.start();
             // Adaptive agent limits (pressure mode cap + start queue).
@@ -2031,12 +2039,21 @@ export class CrewlyServer {
                 // An agent mid-conversation with the owner is the last one stopped
                 // for a slot, and its owner thread hears when it is
                 // (specs/2026-10-08-owner-thread-sentinel.md).
-                owesOwnerThread: (name) => getOwnerThreadSentinel()?.owesRecently(name) === true,
-                onStoppedForSlot: (name) => reportOwnerThreadBlocking(name, { kind: 'stopped', why: 'slot' }),
+                owesOwnerThread: (name) => getOwnerThreadSentinel()?.owesOwner(name) === true || getFollowThrough()?.holdsIntent(name) === true,
+                onStoppedForSlot: (name) => {
+                    reportOwnerThreadBlocking(name, { kind: 'stopped', why: 'slot' });
+                    // Same hook as every other stop path: what it owes goes back to the queue and it is brought back.
+                    void this.restoreStoppedOwing(name, 'stopped to free a running-agent slot');
+                },
                 onStartDeferred: (name) => reportOwnerThreadBlocking(name, { kind: 'start_deferred' }),
                 stopAgent: async (name, role) => {
                     // Its work survives the stop: back in the queue, redelivered on the next start.
                     await releaseWorkForStop(name, 'stopped to free a running-agent slot');
+                    // An agent that still owes the answer keeps its "will pick this up" placeholder:
+                    // the turn-end settle the stop triggers must not call the thread answered.
+                    const owed = TaskPoolService.getInstance().getAllItems().then((items) => owedWorkReminder(items, name) !== null);
+                    if (await owed.catch(() => false))
+                        await getSlackTypingPlaceholderService()?.holdForRestart(name);
                     await agentRegistration.terminateAgentSession(name, role);
                     await StorageService.getInstance().updateAgentStatus(name, CREWLY_CONSTANTS.AGENT_STATUSES.INACTIVE, 'idle_exit');
                 },
@@ -3844,6 +3861,9 @@ export class CrewlyServer {
                 const tokenUsageService = TokenUsageService.getInstance();
                 await tokenUsageService.loadFromDisk();
                 tokenUsageService.startPeriodicFlush();
+                // Per-ticket time / token accounting (specs/2026-10-11-usage-ledger.md):
+                // records facts from here on and rebuilds history once, shortly after boot.
+                await getUsageLedger().start();
                 // Read Claude Code's own session transcripts on an interval so
                 // the Usage dashboard reflects claude-code agents, and so the
                 // context monitor gets a real context size for them (Claude
@@ -6238,6 +6258,34 @@ export class CrewlyServer {
             });
         }
     }
+    /**
+     * The one hook every stop path runs: what the stopped agent owes goes back
+     * in the queue and the agent is brought back with a reminder.
+     *
+     * @param sessionName - The agent that stopped
+     * @param why - Reason text
+     * @returns True when the agent is being brought back
+     */
+    restoreStoppedOwing(sessionName, why) {
+        if (sessionName === ORCHESTRATOR_SESSION_NAME)
+            return Promise.resolve(false);
+        return restoreStoppedOwingWork(sessionName, why, {
+            listWorkItems: () => TaskPoolService.getInstance().getAllItems(),
+            isHeldBack: (name) => isOwnerStopped(name) || !!pausedTeamOfSession(name),
+            hasReminder: (name) => SubAgentMessageQueue.getInstance().peek(name).some((m) => m.data.startsWith(OWED_REMINDER_MARKER)),
+            enqueue: (name, text) => SubAgentMessageQueue.getInstance().enqueue(name, text),
+            holdPlaceholders: (name) => getSlackTypingPlaceholderService()?.holdForRestart(name) ?? Promise.resolve(0),
+            restart: async (name) => {
+                const { scheduleDeferredStartRetry } = await import('./services/messaging/deferred-start-retry.js');
+                const { activateAgentBySession } = await import('./controllers/team/team.controller.js');
+                void scheduleDeferredStartRetry(name, {
+                    activate: (n) => activateAgentBySession(this.apiController, n),
+                    hasPending: (n) => SubAgentMessageQueue.getInstance().hasPending(n),
+                    firstPauseMs: 60_000,
+                });
+            },
+        });
+    }
     /**
      * An agent went down with messages still queued for it: start it again so
      * they are delivered (registration drains the queue). Without this the
@@ -6708,6 +6756,7 @@ export class CrewlyServer {
         }, timeoutMs);
         try {
             // Clear health monitoring interval first
+            this.backgroundWatchdog?.stop();
             if (this.healthMonitoringInterval) {
                 clearInterval(this.healthMonitoringInterval);
                 this.healthMonitoringInterval = null;
@@ -6935,6 +6984,15 @@ export class CrewlyServer {
             WorktreeJanitorService.getInstance().stop();
             // Stop auditor scheduler
             AuditorSchedulerService.getInstance().stop();
+            // Write the usage ledger's buffered buckets
+            try {
+                await getUsageLedger().stop();
+            }
+            catch (ledgerErr) {
+                this.logger.warn('Usage ledger flush on shutdown failed (non-fatal)', {
+                    error: ledgerErr instanceof Error ? ledgerErr.message : String(ledgerErr),
+                });
+            }
             // Persist the token ledger: it flushes every 5 minutes, so a restart
             // used to drop everything recorded since the last tick (2026-09-18).
             try {