crewly 1.20.279 → 1.20.281

package/dist/backend/backend/src/services/drive/drive-briefing-sync.service.js

@@ -0,0 +1,247 @@
+/**
+ * DriveBriefingSyncService — keeps this machine's Drive mode status snapshot
+ * fresh on Crewly Cloud (specs/2026-10-09-drive-mode-v3.md §1), so the voice
+ * answers "how is CE doing?" at once, built while work happens rather than
+ * pulled when the owner starts talking.
+ *
+ * - On events (a ticket changed, a work item moved, an agent wrote to the
+ *   owner, a card was created or settled) it gathers them, rebuilds the
+ *   snapshot and uploads it when it changed — at most one rebuild every
+ *   30 s; events in between are coalesced into the next one.
+ * - Every minute it rebuilds anyway (agent states, anything an event missed)
+ *   and uploads only on a change; every 5 minutes it uploads regardless, so
+ *   Cloud knows the snapshot is current.
+ * - Building costs no LLM call: see `drive-briefing-snapshot.ts`.
+ *
+ * Uses the machine's own Cloud token; signed out = nothing is sent.
+ * `CREWLY_DRIVE_BRIEFING=0` turns it off. A Cloud that does not take
+ * snapshots yet (404 / 400 / 503) is asked again in an hour. Never throws.
+ *
+ * @module services/drive/drive-briefing-sync.service
+ */
+import { DRIVE_BRIEFING_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+import { accountIdOfToken } from '../cloud/conversation-cloud-sync.service.js';
+import { INSTANCE_ID_PATTERN } from '../cloud/conversation-ingest.contract.js';
+const C = DRIVE_BRIEFING_CONSTANTS;
+/**
+ * Whether the snapshot push is switched off.
+ *
+ * @param env - Environment
+ * @returns True for `CREWLY_DRIVE_BRIEFING=0|off|false|no`
+ */
+export function isBriefingSyncDisabled(env) {
+    const v = env[C.KILL_SWITCH_ENV];
+    return typeof v === 'string' && ['0', 'off', 'false', 'no'].includes(v.trim().toLowerCase());
+}
+/**
+ * The snapshot's identity for change detection (its build time left out).
+ *
+ * @param s - Snapshot
+ * @returns Key
+ */
+export function snapshotKey(s) {
+    return JSON.stringify({ ...s, generatedAt: '' });
+}
+/** Pushes the machine's status snapshot to Crewly Cloud — see module docs. */
+export class DriveBriefingSyncService {
+    deps;
+    logger;
+    fetchImpl;
+    now;
+    setTimer;
+    clearTimer;
+    started = false;
+    running = null;
+    rerun = false;
+    checkTimer = null;
+    debounceTimer = null;
+    unsubscribers = [];
+    lastKey = null;
+    lastAccount = null;
+    lastUploadAt = 0;
+    lastBuildAt = 0;
+    failures = 0;
+    pausedUntil = 0;
+    pauseLogged = false;
+    /**
+     * @param deps - Collaborators
+     */
+    constructor(deps) {
+        this.deps = deps;
+        this.logger = deps.logger ?? LoggerService.getInstance().createComponentLogger('DriveBriefingSync');
+        this.fetchImpl = deps.fetchImpl ?? ((input, init) => fetch(input, init));
+        this.now = deps.now ?? Date.now;
+        this.setTimer = deps.setTimeout ?? ((fn, ms) => setTimeout(fn, ms));
+        this.clearTimer = deps.clearTimeout ?? ((h) => clearTimeout(h));
+    }
+    /** Subscribe to the event sources and start the periodic check. Idempotent; never throws. */
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        for (const source of this.deps.sources ?? []) {
+            try {
+                this.unsubscribers.push(source(() => this.requestSync()));
+            }
+            catch (error) {
+                this.logger.warn('Drive briefing: an event source could not be watched', { error: error instanceof Error ? error.message : String(error) });
+            }
+        }
+        this.scheduleCheck(0);
+    }
+    /** Stop timers and subscriptions. */
+    stop() {
+        this.started = false;
+        if (this.checkTimer)
+            this.clearTimer(this.checkTimer);
+        if (this.debounceTimer)
+            this.clearTimer(this.debounceTimer);
+        this.checkTimer = null;
+        this.debounceTimer = null;
+        for (const off of this.unsubscribers) {
+            try {
+                off();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.unsubscribers = [];
+    }
+    /**
+     * Something changed: rebuild after the gather window, and no sooner than
+     * the minimum interval after the last rebuild (events coalesce).
+     */
+    requestSync() {
+        if (!this.started || this.debounceTimer)
+            return;
+        const sinceBuild = this.now() - this.lastBuildAt;
+        const delay = Math.max(C.DEBOUNCE_MS, C.MIN_INTERVAL_MS - sinceBuild);
+        this.debounceTimer = this.setTimer(() => {
+            this.debounceTimer = null;
+            void this.syncNow();
+        }, delay);
+    }
+    scheduleCheck(delayMs = C.CHECK_INTERVAL_MS) {
+        if (!this.started)
+            return;
+        this.checkTimer = this.setTimer(() => {
+            this.checkTimer = null;
+            // A rebuild ran moments ago (an event): this check has nothing to add.
+            if (this.lastBuildAt > 0 && this.now() - this.lastBuildAt < C.MIN_INTERVAL_MS) {
+                this.scheduleCheck();
+                return;
+            }
+            void this.syncNow().finally(() => this.scheduleCheck());
+        }, delayMs);
+    }
+    /**
+     * Rebuild and upload when it changed (or the full resync is due). One pass
+     * at a time; a call during one runs again after it. Never throws.
+     *
+     * @param force - Upload even when unchanged
+     * @returns What happened
+     */
+    async syncNow(force = false) {
+        if (this.running) {
+            this.rerun = true;
+            return this.running;
+        }
+        this.running = (async () => {
+            let outcome = 'skipped';
+            try {
+                do {
+                    this.rerun = false;
+                    outcome = await this.pass(force);
+                } while (this.rerun);
+            }
+            catch (error) {
+                this.logger.warn('Drive briefing sync failed', { error: error instanceof Error ? error.message : String(error) });
+                outcome = 'failed';
+            }
+            return outcome;
+        })();
+        try {
+            return await this.running;
+        }
+        finally {
+            this.running = null;
+        }
+    }
+    async pass(force) {
+        if (isBriefingSyncDisabled(this.deps.env ?? process.env))
+            return 'skipped';
+        const token = this.deps.cloud.getToken();
+        const base = this.deps.cloud.getCloudUrl();
+        if (!token || !base)
+            return 'skipped';
+        if (this.now() < this.pausedUntil)
+            return 'paused';
+        const account = accountIdOfToken(token);
+        if (account !== this.lastAccount) {
+            this.lastAccount = account;
+            this.lastKey = null;
+            this.lastUploadAt = 0;
+        }
+        const { instanceId } = await this.deps.identity();
+        if (!INSTANCE_ID_PATTERN.test(instanceId))
+            return 'skipped';
+        this.lastBuildAt = this.now();
+        const snapshot = await this.deps.build();
+        const key = snapshotKey(snapshot);
+        const fullDue = this.now() - this.lastUploadAt >= C.FULL_SYNC_INTERVAL_MS;
+        if (!force && !fullDue && key === this.lastKey)
+            return 'unchanged';
+        return this.upload(base, token, instanceId, snapshot, key);
+    }
+    async upload(base, token, instanceId, snapshot, key, refreshed = false) {
+        const url = `${base.replace(/\/+$/, '')}${C.PUT_PATH.replace(':instanceId', encodeURIComponent(instanceId))}`;
+        let status = 0;
+        let code = null;
+        try {
+            const res = await this.fetchImpl(url, {
+                method: 'PUT',
+                headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
+                body: JSON.stringify({ snapshot }),
+                signal: AbortSignal.timeout(C.REQUEST_TIMEOUT_MS),
+            });
+            status = res.status;
+            if (res.ok) {
+                this.lastKey = key;
+                this.lastUploadAt = this.now();
+                this.failures = 0;
+                if (this.pauseLogged) {
+                    this.pauseLogged = false;
+                    this.logger.info('Crewly Cloud is taking Drive mode status updates again');
+                }
+                return 'uploaded';
+            }
+            const parsed = (await res.json().catch(() => null));
+            code = typeof parsed?.code === 'string' ? parsed.code : null;
+        }
+        catch (error) {
+            code = error instanceof Error ? error.message : String(error);
+        }
+        if (status === 401 && !refreshed && this.deps.cloud.tryRefreshToken && (await this.deps.cloud.tryRefreshToken().catch(() => false))) {
+            const fresh = this.deps.cloud.getToken();
+            if (fresh)
+                return this.upload(base, fresh, instanceId, snapshot, key, true);
+        }
+        if (status === 404 || status === 400 || status === 503) {
+            this.pausedUntil = this.now() + C.UNAVAILABLE_RETRY_MS;
+            if (!this.pauseLogged) {
+                this.pauseLogged = true;
+                this.logger.info('Crewly Cloud is not taking Drive mode status updates; checking again in an hour', { status, code });
+            }
+            return 'paused';
+        }
+        this.failures += 1;
+        const delay = Math.min(C.BACKOFF_INITIAL_MS * 2 ** (this.failures - 1), C.BACKOFF_MAX_MS);
+        this.pausedUntil = this.now() + delay;
+        if (this.failures === 1)
+            this.logger.warn('Drive mode status upload failed; will retry', { status, code, retryInMs: delay });
+        return 'failed';
+    }
+}
+//# sourceMappingURL=drive-briefing-sync.service.js.map

package/dist/backend/backend/src/services/drive/drive-briefing-sync.service.js.map

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

package/dist/backend/backend/src/services/drive/drive-briefing.contract.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Drive mode v3 status snapshot, machine half (mirrors crewly-services
+ * `auth/src/drive/drive-briefing.contract.ts`; specs/2026-10-09-drive-mode-v3.md §1).
+ *
+ * The snapshot is what the voice orchestrator answers status questions from
+ * ("how is CE doing?", "what is Ella on?", "where is CE-12?") without asking
+ * an agent. This machine rebuilds it from structured data on every change
+ * and pushes it:
+ *
+ *   PUT /api/cloud/instances/:instanceId/briefing {snapshot}   (this machine's Cloud token)
+ *
+ * Names, never secrets: every text field is clipped and passed through the
+ * secret redactor before it leaves the machine. Pure types.
+ *
+ * @module services/drive/drive-briefing.contract
+ */
+/** Where a piece of work is (normalised across tickets and work items). */
+export type BriefingItemStatus = 'open' | 'in_progress' | 'review' | 'blocked' | 'done' | 'cancelled';
+/** What an agent is doing. */
+export type BriefingAgentState = 'working' | 'idle' | 'starting' | 'stopped';
+/** One team. */
+export interface BriefingTeam {
+    name: string;
+    /** Lead's name */
+    lead?: string;
+    /** Members' names */
+    agents: string[];
+    open: number;
+    inProgress: number;
+    review: number;
+    blocked: number;
+    /** Finished in the last 24 h */
+    doneToday: number;
+}
+/** One agent. */
+export interface BriefingAgent {
+    session: string;
+    name: string;
+    team?: string;
+    role?: string;
+    state: BriefingAgentState;
+    /** What it is working on now, and since when */
+    activity?: {
+        title: string;
+        since: string;
+        ref?: string;
+    };
+    /** Its last few messages to the owner, newest first, clipped */
+    lastToOwner?: Array<{
+        at: string;
+        text: string;
+    }>;
+}
+/** A project ticket or a task-pool work item. */
+export interface BriefingItem {
+    /** `CE-12`, `wi:1a2b3c4d` */
+    ref: string;
+    kind: 'ticket' | 'work';
+    title: string;
+    status: BriefingItemStatus;
+    /** Assignee's name */
+    assignee?: string;
+    team?: string;
+    project?: string;
+    updatedAt: string;
+    /** The last thing said about it (ticket log line, work item summary) */
+    last?: string;
+}
+/** Something waiting on the owner (live card / question / review only). */
+export interface BriefingWaiting {
+    ref: string;
+    kind: 'decision' | 'question' | 'review';
+    from: string;
+    team?: string;
+    summary: string;
+    since: string;
+    urgency?: 'high' | 'normal' | 'low';
+}
+/** The snapshot this machine pushes. */
+export interface BriefingSnapshot {
+    v: 1;
+    generatedAt: string;
+    teams: BriefingTeam[];
+    agents: BriefingAgent[];
+    items: BriefingItem[];
+    waiting: BriefingWaiting[];
+}
+//# sourceMappingURL=drive-briefing.contract.d.ts.map

package/dist/backend/backend/src/services/drive/drive-briefing.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drive-briefing.contract.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/drive/drive-briefing.contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;AAEtG,8BAA8B;AAC9B,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7E,gBAAgB;AAChB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iBAAiB;AACjB,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,kBAAkB,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,gEAAgE;IAChE,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;IAC3B,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACrC;AAED,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,CAAC,CAAC;IACL,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B"}

package/dist/backend/backend/src/services/drive/drive-briefing.contract.js

@@ -0,0 +1,18 @@
+/**
+ * Drive mode v3 status snapshot, machine half (mirrors crewly-services
+ * `auth/src/drive/drive-briefing.contract.ts`; specs/2026-10-09-drive-mode-v3.md §1).
+ *
+ * The snapshot is what the voice orchestrator answers status questions from
+ * ("how is CE doing?", "what is Ella on?", "where is CE-12?") without asking
+ * an agent. This machine rebuilds it from structured data on every change
+ * and pushes it:
+ *
+ *   PUT /api/cloud/instances/:instanceId/briefing {snapshot}   (this machine's Cloud token)
+ *
+ * Names, never secrets: every text field is clipped and passed through the
+ * secret redactor before it leaves the machine. Pure types.
+ *
+ * @module services/drive/drive-briefing.contract
+ */
+export {};
+//# sourceMappingURL=drive-briefing.contract.js.map

package/dist/backend/backend/src/services/drive/drive-briefing.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drive-briefing.contract.js","sourceRoot":"","sources":["../../../../../../backend/src/services/drive/drive-briefing.contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/backend/backend/src/services/drive/drive-briefing.wiring.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Gather what the Drive mode status snapshot is built from
+ * (specs/2026-10-09-drive-mode-v3.md §1): teams and agents from storage,
+ * every project's tickets, the task pool, the briefing queue's live owner
+ * items and the agents' recent messages to the owner. Each source is read
+ * on its own; one that fails is left empty, never the whole snapshot.
+ *
+ * @module services/drive/drive-briefing.wiring
+ */
+import type { Team } from '../../types/index.js';
+import type { OwnerTurnMark } from '../briefing/briefing-cards.js';
+import type { RecallFeedMessage } from './drive-recall.js';
+import { type SnapshotSources, type SnapshotTicketSource, type SnapshotWaitingSource, type SnapshotWorkItemSource } from './drive-briefing-snapshot.js';
+/** Where the sources come from. */
+export interface BriefingWiringDeps {
+    getTeams: () => Promise<Team[]>;
+    getProjects: () => Promise<Array<{
+        name: string;
+        path: string;
+    }>>;
+    listTickets: (projectPath: string) => Promise<Array<Omit<SnapshotTicketSource, 'project'>>>;
+    listWorkItems: () => Promise<SnapshotWorkItemSource[]>;
+    /** Live owner items (the briefing queue) */
+    waiting: () => Promise<SnapshotWaitingSource[]>;
+    ownerFeed: (sinceMs: number, limit: number) => {
+        messages: RecallFeedMessage[];
+        ownerTurns: OwnerTurnMark[];
+    };
+    /** Whether the orchestrator's session runs */
+    orchestratorRunning: () => boolean;
+    /** The orchestrator's display name */
+    orchestratorName: string;
+    now?: () => Date;
+}
+/**
+ * Gather the snapshot sources.
+ *
+ * @param deps - Where they come from
+ * @returns Sources for `buildBriefingSnapshot`
+ */
+export declare function collectSnapshotSources(deps: BriefingWiringDeps): Promise<SnapshotSources>;
+/**
+ * Cached reads of the expensive sources (every project's tickets, the task
+ * pool), so a busy machine does not re-read them on each rebuild. A
+ * project's tickets are re-read after a change event for that project (or
+ * after {@link DRIVE_BRIEFING_CONSTANTS.TICKET_CACHE_MS}); the pool after a
+ * work-item event (or after {@link DRIVE_BRIEFING_CONSTANTS.POOL_CACHE_MS}).
+ */
+export declare class SnapshotSourceCache {
+    private readonly now;
+    private readonly tickets;
+    private pool;
+    /**
+     * @param now - Clock (ms)
+     */
+    constructor(now?: () => number);
+    /**
+     * Wrap ticket and pool readers with the cache.
+     *
+     * @param readers - The uncached readers
+     * @returns Cached readers for {@link BriefingWiringDeps}
+     */
+    wrap(readers: Pick<BriefingWiringDeps, 'listTickets' | 'listWorkItems'>): Pick<BriefingWiringDeps, 'listTickets' | 'listWorkItems'>;
+    /**
+     * A ticket of this project changed (or, without a path, any project).
+     *
+     * @param projectPath - Absolute project root
+     */
+    invalidateTickets(projectPath?: string): void;
+    /** A work item moved. */
+    invalidatePool(): void;
+}
+//# sourceMappingURL=drive-briefing.wiring.d.ts.map

package/dist/backend/backend/src/services/drive/drive-briefing.wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drive-briefing.wiring.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/drive/drive-briefing.wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAItK,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAClE,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5F,aAAa,EAAE,MAAM,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACvD,4CAA4C;IAC5C,OAAO,EAAE,MAAM,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAChD,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK;QAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAAC,UAAU,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAC9G,8CAA8C;IAC9C,mBAAmB,EAAE,MAAM,OAAO,CAAC;IACnC,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAWD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqC/F;AAUD;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAOlB,OAAO,CAAC,QAAQ,CAAC,GAAG;IANhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0F;IAClH,OAAO,CAAC,IAAI,CAAgE;IAE5E;;OAEG;gBAC0B,GAAG,GAAE,MAAM,MAAiB;IAEzD;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,eAAe,CAAC,GAAG,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,eAAe,CAAC;IAkBnI;;;;OAIG;IACH,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAK7C,yBAAyB;IACzB,cAAc,IAAI,IAAI;CAGvB"}

package/dist/backend/backend/src/services/drive/drive-briefing.wiring.js

@@ -0,0 +1,131 @@
+/**
+ * Gather what the Drive mode status snapshot is built from
+ * (specs/2026-10-09-drive-mode-v3.md §1): teams and agents from storage,
+ * every project's tickets, the task pool, the briefing queue's live owner
+ * items and the agents' recent messages to the owner. Each source is read
+ * on its own; one that fails is left empty, never the whole snapshot.
+ *
+ * @module services/drive/drive-briefing.wiring
+ */
+import { DRIVE_BRIEFING_CONSTANTS, ORCHESTRATOR_SESSION_NAME } from '../../constants.js';
+import { resolveMemberSessionName } from '../../utils/member-session-name.utils.js';
+import { getTeamLeads } from '../../utils/team.utils.js';
+import { agentStateOf } from './drive-briefing-snapshot.js';
+const C = DRIVE_BRIEFING_CONSTANTS;
+/** Read a source; a failure gives the fallback. */
+async function read(fn, fallback) {
+    try {
+        return await fn();
+    }
+    catch {
+        return fallback;
+    }
+}
+/**
+ * Gather the snapshot sources.
+ *
+ * @param deps - Where they come from
+ * @returns Sources for `buildBriefingSnapshot`
+ */
+export async function collectSnapshotSources(deps) {
+    const now = deps.now?.() ?? new Date();
+    const [teams, projects, workItems, waiting] = await Promise.all([
+        read(deps.getTeams, []),
+        read(deps.getProjects, []),
+        read(deps.listWorkItems, []),
+        read(deps.waiting, []),
+    ]);
+    const tickets = (await Promise.all(projects.map(async (p) => (await read(() => deps.listTickets(p.path), [])).map((t) => ({ ...t, project: p.name }))))).flat();
+    const agents = [
+        { agentSession: ORCHESTRATOR_SESSION_NAME, name: deps.orchestratorName, role: 'orchestrator', state: safeBool(deps.orchestratorRunning) ? 'idle' : 'stopped' },
+    ];
+    const seen = new Set([ORCHESTRATOR_SESSION_NAME]);
+    const teamRows = [];
+    for (const team of teams) {
+        const members = (team.members ?? []).filter((m) => m?.id && String(m.role) !== 'orchestrator');
+        const sessions = [];
+        for (const m of members) {
+            const session = resolveMemberSessionName(team.name, m);
+            if (!session)
+                continue;
+            sessions.push(session);
+            if (seen.has(session))
+                continue;
+            seen.add(session);
+            agents.push({ agentSession: session, name: m.name || session, team: team.name, ...(m.role ? { role: String(m.role) } : {}), state: agentStateOf(m.agentStatus, m.workingStatus) });
+        }
+        if (sessions.length === 0)
+            continue;
+        const lead = getTeamLeads(team)[0];
+        teamRows.push({ id: team.id, name: team.name, ...(lead ? { lead: resolveMemberSessionName(team.name, lead) } : { lead: sessions[0] }), members: sessions });
+    }
+    const feed = await read(() => deps.ownerFeed(now.getTime() - C.OWNER_FEED_WINDOW_MS, C.OWNER_FEED_SCAN_LIMIT), { messages: [], ownerTurns: [] });
+    return { now, agents, teams: teamRows, tickets, workItems, waiting, ownerFeed: feed };
+}
+function safeBool(fn) {
+    try {
+        return fn();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Cached reads of the expensive sources (every project's tickets, the task
+ * pool), so a busy machine does not re-read them on each rebuild. A
+ * project's tickets are re-read after a change event for that project (or
+ * after {@link DRIVE_BRIEFING_CONSTANTS.TICKET_CACHE_MS}); the pool after a
+ * work-item event (or after {@link DRIVE_BRIEFING_CONSTANTS.POOL_CACHE_MS}).
+ */
+export class SnapshotSourceCache {
+    now;
+    tickets = new Map();
+    pool = null;
+    /**
+     * @param now - Clock (ms)
+     */
+    constructor(now = Date.now) {
+        this.now = now;
+    }
+    /**
+     * Wrap ticket and pool readers with the cache.
+     *
+     * @param readers - The uncached readers
+     * @returns Cached readers for {@link BriefingWiringDeps}
+     */
+    wrap(readers) {
+        return {
+            listTickets: async (projectPath) => {
+                const hit = this.tickets.get(projectPath);
+                if (hit && this.now() - hit.at < C.TICKET_CACHE_MS)
+                    return hit.value;
+                const value = await readers.listTickets(projectPath);
+                this.tickets.set(projectPath, { at: this.now(), value });
+                return value;
+            },
+            listWorkItems: async () => {
+                if (this.pool && this.now() - this.pool.at < C.POOL_CACHE_MS)
+                    return this.pool.value;
+                const value = await readers.listWorkItems();
+                this.pool = { at: this.now(), value };
+                return value;
+            },
+        };
+    }
+    /**
+     * A ticket of this project changed (or, without a path, any project).
+     *
+     * @param projectPath - Absolute project root
+     */
+    invalidateTickets(projectPath) {
+        if (projectPath)
+            this.tickets.delete(projectPath);
+        else
+            this.tickets.clear();
+    }
+    /** A work item moved. */
+    invalidatePool() {
+        this.pool = null;
+    }
+}
+//# sourceMappingURL=drive-briefing.wiring.js.map

package/dist/backend/backend/src/services/drive/drive-briefing.wiring.js.map

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

package/dist/backend/backend/src/services/drive/drive-cloud.contract.d.ts

@@ -9,8 +9,11 @@
  *   GET  /api/cloud/talk/session/:sid/machine/state?instanceId=          → its conversations (after `end`)
  *   GET  /api/cloud/talk/session/:sid/machine/recalls/:id?instanceId=     → what to recall
  *   POST /api/cloud/talk/session/:sid/machine/recalls/:id {instanceId, messages}
+ *   (`op:'warm'` → `machine/state` also lists the agents to keep warm, with `warmUntil`)
  * Machine → Cloud (an agent's `reply --drive`):
- *   POST /api/cloud/talk/session/:sid/replies {instanceId, conversationId, agentSession, text, interim?, recap?, nextStep?}
+ *   POST /api/cloud/talk/session/:sid/replies {instanceId, conversationId, agentSession, text, interim?, ack?, recap?, nextStep?}
+ * Machine → Cloud (its status snapshot, specs/2026-10-09-drive-mode-v3.md):
+ *   PUT  /api/cloud/instances/:instanceId/briefing {snapshot}
  *
  * @module services/drive/drive-cloud.contract
  */
@@ -20,7 +23,7 @@ export type DriveTargetKind = 'agent' | 'team' | 'channel';
 export interface DriveRelayData {
     v: 1;
     kind: 'drive';
-    op: 'deliver' | 'end' | 'recall';
+    op: 'deliver' | 'end' | 'recall' | 'warm';
     sessionId: string;
     id?: string;
     instanceId: string;
@@ -53,6 +56,10 @@ export interface DriveStateFetch {
         conversationId: string;
         agentSession: string;
     }>;
+    /** Agents to keep warm while the session runs (v3) */
+    warm: string[];
+    /** Until when (ms); 0 when nothing is warm */
+    warmUntil: number;
 }
 /**
  * A Drive mode relay payload, or null (any other `talk_message`).

package/dist/backend/backend/src/services/drive/drive-cloud.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drive-cloud.contract.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/drive/drive-cloud.contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,kCAAkC;AAClC,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE3D,yBAAyB;AACzB,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,CAAC,CAAC;IACL,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAClI,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAwB;AACxB,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,KAAK,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxE;AAKD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAU3E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CA0B3E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAQrE"}
+{"version":3,"file":"drive-cloud.contract.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/drive/drive-cloud.contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,kCAAkC;AAClC,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE3D,yBAAyB;AACzB,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,CAAC,CAAC;IACL,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAClI,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAwB;AACxB,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,KAAK,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,sDAAsD;IACtD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAU3E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CA0B3E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAUrE"}