crewly 1.20.277 → 1.20.279

package/dist/backend/backend/src/services/drive/drive-agent.service.d.ts

@@ -0,0 +1,228 @@
+/**
+ * DriveAgentService — the machine side of Drive mode
+ * (specs/2026-10-08-drive-mode.md §7). Crewly Cloud hosts the session (the
+ * voice, the targets, the inbox); this machine does what only it can:
+ *
+ *  - `deliver` (push `op:'deliver'`): fetch the owner's words from Cloud with
+ *    this machine's token, record them as the owner's voice turn in the
+ *    agent's DM (a team → its lead's DM; a channel → a thread in its room)
+ *    and deliver them, with a note: the owner is listening, answer with
+ *    `reply --drive <session>`, not in Slack;
+ *  - `agentReply` (`reply --drive`): record the answer in that conversation
+ *    (kept off Slack) and send it to Cloud for the phone;
+ *  - `noteChatTurn`: a plain `reply` in a Drive conversation still reaches
+ *    the phone;
+ *  - `recall` (push `op:'recall'`): read back an agent's recent messages to
+ *    the owner;
+ *  - `end` (push `op:'end'`): ask each agent with an open conversation for
+ *    ONE recap; the recap (`reply --drive … --recap`) is posted in the
+ *    owner's DM with the agent, or in the channel, and closes the
+ *    conversation: owner-message tracking stops, and the open-items tracker
+ *    takes it as delivered unless it names a next step.
+ *
+ * Nothing the owner or the agents say is logged.
+ *
+ * @module services/drive/drive-agent.service
+ */
+import { type ComponentLogger } from '../core/logger.service.js';
+import type { OwnerTurnMark } from '../briefing/briefing-cards.js';
+import type { IncomingMessage } from '../cloud/cloud-sync.types.js';
+import { type RecallFeedMessage } from './drive-recall.js';
+import { type DriveDeliveryFetch, type DriveTargetKind } from './drive-cloud.contract.js';
+import type { DriveConversationStore, DriveLocalConversation } from './drive-conversation.store.js';
+/** A Drive mode failure with an HTTP status (for the agent's `reply`). */
+export declare class DriveAgentError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+/** Emitter of relay messages (CloudSyncService). */
+export interface DriveRelaySource {
+    on(event: 'message', listener: (msg: IncomingMessage) => void): unknown;
+    off(event: 'message', listener: (msg: IncomingMessage) => void): unknown;
+}
+/** The Cloud session (CloudClientService). */
+export interface DriveCloud {
+    getToken(): string | null;
+    getCloudUrl(): string | null;
+    tryRefreshToken?(): Promise<boolean>;
+}
+/** A chat-v2 message the fallback pickup looks at. */
+export interface DriveChatTurn {
+    id: string;
+    channelId: string;
+    threadId?: string;
+    senderType: string;
+    senderId: string;
+    content: string;
+    createdAt: number;
+    metadata?: Record<string, unknown>;
+}
+/** Collaborators. */
+export interface DriveAgentDeps {
+    source?: DriveRelaySource;
+    cloud: DriveCloud;
+    /** This machine's Cloud instance id */
+    identity: () => Promise<{
+        instanceId: string;
+    }>;
+    /**
+     * Record the owner's words as an owner turn and deliver them: the agent's
+     * DM (agent / team lead), or the room of a team channel (a new thread on
+     * the first turn, then that thread). Text carries the Drive mode note.
+     */
+    deliverOwnerTurn: (input: {
+        kind: DriveTargetKind;
+        agentSession: string;
+        slackChannelId?: string;
+        channelId?: string;
+        threadId?: string;
+        text: string;
+    }) => Promise<{
+        channelId: string;
+        threadId?: string;
+    }>;
+    /** Record an agent's spoken answer in its conversation (chat-v2, kept off Slack) */
+    recordAgentTurn: (input: {
+        agentSession: string;
+        channelId: string;
+        threadId?: string;
+        text: string;
+        interim: boolean;
+        sessionId: string;
+    }) => Promise<void>;
+    /** A harness note to an agent (the recap request) */
+    notifyAgent: (agentSession: string, text: string) => Promise<boolean>;
+    /** Post the recap where the conversation belongs (the DM with the owner / the channel), to Slack too */
+    postRecap: (input: {
+        conversation: DriveLocalConversation;
+        agentSession: string;
+        text: string;
+        nextStep: boolean;
+    }) => Promise<{
+        where: string;
+    }>;
+    /** chat-v2 rows since a time and the owner's last turn per conversation (recall) */
+    ownerFeed: (sinceMs: number) => Promise<{
+        messages: RecallFeedMessage[];
+        ownerTurns: OwnerTurnMark[];
+    }>;
+    /** Stop owner-message tracking for a closed conversation (no more nudges) */
+    closeTracking?: (agentSession: string, channelId: string) => void;
+    /** Whether an agent exists here */
+    agentExists?: (agentSession: string) => Promise<boolean>;
+    store: DriveConversationStore;
+    fetchImpl?: (input: string, init: RequestInit) => Promise<Response>;
+    now?: () => Date;
+    logger?: ComponentLogger;
+}
+/**
+ * Capabilities to advertise to Cloud (heartbeat and uploads).
+ *
+ * @returns `['drive_message']` while the handler runs, else `[]`
+ */
+export declare function driveCapabilities(): string[];
+/** The machine side of Drive mode — see module docs. */
+export declare class DriveAgentService {
+    private readonly deps;
+    private readonly logger;
+    private readonly now;
+    private readonly fetchImpl;
+    private readonly inFlight;
+    private readonly listener;
+    private started;
+    /**
+     * @param deps - Collaborators
+     */
+    constructor(deps: DriveAgentDeps);
+    /** Subscribe to relay messages and advertise the capability. Idempotent. */
+    start(): void;
+    /** Unsubscribe. */
+    stop(): void;
+    /**
+     * One relay message; anything but a Drive mode push is ignored. Never throws.
+     *
+     * @param msg - Relay message
+     * @returns What was done
+     */
+    handle(msg: IncomingMessage): Promise<'ignored' | 'duplicate' | 'done' | 'failed'>;
+    private deliver;
+    /**
+     * Deliver the owner's words (already fetched from Cloud).
+     *
+     * @param d - Delivery
+     * @returns The local conversation
+     */
+    deliverFetched(d: DriveDeliveryFetch): Promise<DriveLocalConversation>;
+    /**
+     * An agent's answer for the owner's phone (`reply --drive <session>`), or
+     * its recap (`--recap`).
+     *
+     * @param agentSession - Who answers
+     * @param sessionId - Drive mode session
+     * @param input - `{ text, interim, recap }`
+     * @returns Which conversation, and whether it closed
+     * @throws DriveAgentError 400 / 404 (no such conversation) / 502 (Cloud unreachable)
+     */
+    agentReply(agentSession: string, sessionId: string, input: {
+        text: string;
+        interim: boolean;
+        recap: boolean;
+    }): Promise<{
+        conversationId: string;
+        closed: boolean;
+    }>;
+    /**
+     * Fallback: an agent answered a Drive mode conversation with a plain
+     * `reply` instead of `reply --drive`. Its words still reach the phone. Call
+     * for every chat-v2 message. Never throws.
+     *
+     * @param dto - The chat message
+     */
+    noteChatTurn(dto: DriveChatTurn): Promise<void>;
+    private recap;
+    /** Send an answer to Cloud and keep the local transcript. */
+    private forward;
+    private recall;
+    private end;
+    private cloudGet;
+    private cloudPost;
+    private cloudCall;
+}
+/**
+ * The owner's words as delivered: the Drive mode note, then the words.
+ *
+ * @param sessionId - Session
+ * @param kind - Target kind
+ * @param name - Target name
+ * @param text - The owner's words
+ * @returns Message text
+ */
+export declare function ownerTurnText(sessionId: string, kind: DriveTargetKind, name: string, text: string): string;
+/**
+ * The harness note asking an agent for its recap.
+ *
+ * @param c - Conversation
+ * @returns Note text
+ */
+export declare function recapRequest(c: DriveLocalConversation): string;
+/**
+ * The conversation an agent's reply belongs to: one it answers or is a
+ * member of; a recap goes to one whose recap was asked for; otherwise the one
+ * waiting for an answer, newest first.
+ *
+ * @param all - Local conversations
+ * @param sessionId - Session
+ * @param agentSession - Who replies
+ * @param recap - It is the recap
+ * @returns Conversation or undefined
+ */
+export declare function pickConversation(all: readonly DriveLocalConversation[], sessionId: string, agentSession: string, recap: boolean): DriveLocalConversation | undefined;
+/** @returns The running service, or null */
+export declare function getDriveAgentService(): DriveAgentService | null;
+/**
+ * Install the service (boot, tests).
+ *
+ * @param service - Service or null
+ */
+export declare function setDriveAgentService(service: DriveAgentService | null): void;
+//# sourceMappingURL=drive-agent.service.d.ts.map

package/dist/backend/backend/src/services/drive/drive-agent.service.d.ts.map

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

package/dist/backend/backend/src/services/drive/drive-agent.service.js

@@ -0,0 +1,412 @@
+/**
+ * DriveAgentService — the machine side of Drive mode
+ * (specs/2026-10-08-drive-mode.md §7). Crewly Cloud hosts the session (the
+ * voice, the targets, the inbox); this machine does what only it can:
+ *
+ *  - `deliver` (push `op:'deliver'`): fetch the owner's words from Cloud with
+ *    this machine's token, record them as the owner's voice turn in the
+ *    agent's DM (a team → its lead's DM; a channel → a thread in its room)
+ *    and deliver them, with a note: the owner is listening, answer with
+ *    `reply --drive <session>`, not in Slack;
+ *  - `agentReply` (`reply --drive`): record the answer in that conversation
+ *    (kept off Slack) and send it to Cloud for the phone;
+ *  - `noteChatTurn`: a plain `reply` in a Drive conversation still reaches
+ *    the phone;
+ *  - `recall` (push `op:'recall'`): read back an agent's recent messages to
+ *    the owner;
+ *  - `end` (push `op:'end'`): ask each agent with an open conversation for
+ *    ONE recap; the recap (`reply --drive … --recap`) is posted in the
+ *    owner's DM with the agent, or in the channel, and closes the
+ *    conversation: owner-message tracking stops, and the open-items tracker
+ *    takes it as delivered unless it names a next step.
+ *
+ * Nothing the owner or the agents say is logged.
+ *
+ * @module services/drive/drive-agent.service
+ */
+import { DRIVE_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+import { clip, speakable } from '../briefing/briefing.utils.js';
+import { isDriveModeRow } from './drive-row.utils.js';
+import { messagesToOwner, pickRecall } from './drive-recall.js';
+import { parseDeliveryFetch, parseDriveRelayData, parseRecallFetch, parseStateFetch, } from './drive-cloud.contract.js';
+const C = DRIVE_CONSTANTS;
+/** A recap that says nothing is left to do (the conversation is fully closed). */
+const NOTHING_PENDING = /nothing (is )?(pending|left|open)|no next step|next:\s*(none|nothing)\b|没有待办|无待办|没有后续|无后续|不需要后续|没有了/i;
+/** A Drive mode failure with an HTTP status (for the agent's `reply`). */
+export class DriveAgentError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'DriveAgentError';
+    }
+}
+let active = false;
+/**
+ * Capabilities to advertise to Cloud (heartbeat and uploads).
+ *
+ * @returns `['drive_message']` while the handler runs, else `[]`
+ */
+export function driveCapabilities() {
+    return active ? [C.CAPABILITY] : [];
+}
+/** The machine side of Drive mode — see module docs. */
+export class DriveAgentService {
+    deps;
+    logger;
+    now;
+    fetchImpl;
+    inFlight = new Set();
+    listener = (msg) => {
+        void this.handle(msg);
+    };
+    started = false;
+    /**
+     * @param deps - Collaborators
+     */
+    constructor(deps) {
+        this.deps = deps;
+        this.logger = deps.logger ?? LoggerService.getInstance().createComponentLogger('DriveAgent');
+        this.now = deps.now ?? (() => new Date());
+        this.fetchImpl = deps.fetchImpl ?? ((input, init) => fetch(input, init));
+    }
+    /** Subscribe to relay messages and advertise the capability. Idempotent. */
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.deps.source?.on('message', this.listener);
+        active = true;
+    }
+    /** Unsubscribe. */
+    stop() {
+        if (!this.started)
+            return;
+        this.started = false;
+        this.deps.source?.off('message', this.listener);
+        active = false;
+    }
+    /**
+     * One relay message; anything but a Drive mode push is ignored. Never throws.
+     *
+     * @param msg - Relay message
+     * @returns What was done
+     */
+    async handle(msg) {
+        if (msg?.type !== C.RELAY_MESSAGE_TYPE)
+            return 'ignored';
+        const data = parseDriveRelayData(msg.payload);
+        if (!data)
+            return 'ignored';
+        const key = `${data.op}:${data.sessionId}:${data.id ?? ''}`;
+        if (this.inFlight.has(key))
+            return 'duplicate';
+        this.inFlight.add(key);
+        try {
+            const { instanceId } = await this.deps.identity();
+            if (data.instanceId !== instanceId)
+                return 'ignored';
+            if (data.op === 'deliver')
+                await this.deliver(data, instanceId);
+            else if (data.op === 'recall')
+                await this.recall(data, instanceId);
+            else
+                await this.end(data, instanceId);
+            return 'done';
+        }
+        catch (error) {
+            this.logger.warn('Drive mode push failed', { op: data.op, sessionId: data.sessionId, error: error instanceof Error ? error.message : String(error) });
+            return 'failed';
+        }
+        finally {
+            this.inFlight.delete(key);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Owner → agent
+    // ---------------------------------------------------------------------------
+    async deliver(data, instanceId) {
+        const raw = await this.cloudGet(`/${data.sessionId}/machine/deliveries/${encodeURIComponent(data.id)}?instanceId=${encodeURIComponent(instanceId)}`);
+        const d = parseDeliveryFetch(raw);
+        if (!d)
+            throw new Error('Cloud sent a malformed delivery');
+        await this.deliverFetched(d);
+    }
+    /**
+     * Deliver the owner's words (already fetched from Cloud).
+     *
+     * @param d - Delivery
+     * @returns The local conversation
+     */
+    async deliverFetched(d) {
+        if (this.deps.agentExists && !(await this.deps.agentExists(d.target.agentSession))) {
+            throw new Error(`No agent ${d.target.agentSession} on this machine`);
+        }
+        const existing = await this.deps.store.get(d.sessionId, d.conversationId);
+        const where = await this.deps.deliverOwnerTurn({
+            kind: d.target.kind,
+            agentSession: d.target.agentSession,
+            ...(d.target.slackChannelId ? { slackChannelId: d.target.slackChannelId } : {}),
+            ...(existing ? { channelId: existing.channelId, ...(existing.threadId ? { threadId: existing.threadId } : {}) } : {}),
+            text: ownerTurnText(d.sessionId, d.target.kind, d.target.name, d.text),
+        });
+        const at = this.now().toISOString();
+        const conv = await this.deps.store.update(d.sessionId, d.conversationId, (cur) => {
+            const c = cur ?? {
+                sessionId: d.sessionId,
+                conversationId: d.conversationId,
+                kind: d.target.kind,
+                targetName: d.target.name,
+                agentSession: d.target.agentSession,
+                ...(d.target.members ? { members: d.target.members } : {}),
+                channelId: where.channelId,
+                ...(where.threadId ? { threadId: where.threadId } : {}),
+                startedAt: at,
+                turns: [],
+            };
+            if (!c.threadId && where.threadId)
+                c.threadId = where.threadId;
+            c.turns.push({ from: 'owner', name: 'owner', text: d.text, at });
+            return c;
+        }, this.now().getTime());
+        this.logger.info('Drive mode: owner words delivered', { sessionId: d.sessionId, conversationId: d.conversationId, kind: d.target.kind, agent: d.target.agentSession });
+        return conv;
+    }
+    // ---------------------------------------------------------------------------
+    // Agent → owner
+    // ---------------------------------------------------------------------------
+    /**
+     * An agent's answer for the owner's phone (`reply --drive <session>`), or
+     * its recap (`--recap`).
+     *
+     * @param agentSession - Who answers
+     * @param sessionId - Drive mode session
+     * @param input - `{ text, interim, recap }`
+     * @returns Which conversation, and whether it closed
+     * @throws DriveAgentError 400 / 404 (no such conversation) / 502 (Cloud unreachable)
+     */
+    async agentReply(agentSession, sessionId, input) {
+        if (!C.SESSION_ID_PATTERN.test(sessionId))
+            throw new DriveAgentError(400, 'That is not a Drive mode session id (drv_…).');
+        const text = (input.text ?? '').trim();
+        if (!text)
+            throw new DriveAgentError(400, 'Reply text is required.');
+        if (text.length > C.TEXT_MAX_CHARS)
+            throw new DriveAgentError(400, `Too long for Drive mode (max ${C.TEXT_MAX_CHARS} characters) — say it short; details go in a normal reply.`);
+        const conv = pickConversation(await this.deps.store.list(), sessionId, agentSession, input.recap);
+        if (!conv)
+            throw new DriveAgentError(404, 'You have no open Drive mode conversation in that session. Answer the usual way (reply).');
+        if (input.recap)
+            return this.recap(conv, agentSession, text);
+        await this.deps.recordAgentTurn({ agentSession, channelId: conv.channelId, ...(conv.threadId ? { threadId: conv.threadId } : {}), text, interim: input.interim, sessionId });
+        await this.forward(conv, agentSession, text, { interim: input.interim });
+        return { conversationId: conv.conversationId, closed: false };
+    }
+    /**
+     * Fallback: an agent answered a Drive mode conversation with a plain
+     * `reply` instead of `reply --drive`. Its words still reach the phone. Call
+     * for every chat-v2 message. Never throws.
+     *
+     * @param dto - The chat message
+     */
+    async noteChatTurn(dto) {
+        try {
+            if (dto.senderType !== 'agent' || isDriveModeRow(dto) || !dto.content.trim())
+                return;
+            const open = (await this.deps.store.list()).filter((c) => !c.closedAt && c.channelId === dto.channelId && (!c.threadId || dto.threadId === c.threadId));
+            for (const c of open.reverse()) {
+                if (dto.senderId !== c.agentSession && !(c.members ?? []).includes(dto.senderId))
+                    continue;
+                const lastOwner = [...c.turns].reverse().find((t) => t.from === 'owner');
+                const lastAgent = [...c.turns].reverse().find((t) => t.from === 'agent' && !t.interim);
+                if (!lastOwner || (lastAgent && Date.parse(lastAgent.at) >= Date.parse(lastOwner.at)))
+                    continue;
+                if (dto.createdAt < Date.parse(lastOwner.at))
+                    continue;
+                await this.forward(c, dto.senderId, dto.content, { interim: dto.metadata?.interim === true });
+                this.logger.info('Drive mode: picked up a plain reply', { sessionId: c.sessionId, conversationId: c.conversationId });
+                return;
+            }
+        }
+        catch (err) {
+            this.logger.warn('Drive mode: plain reply not forwarded', { error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    async recap(conv, agentSession, text) {
+        const nextStep = !NOTHING_PENDING.test(text);
+        const posted = await this.deps.postRecap({ conversation: conv, agentSession, text, nextStep });
+        await this.forward(conv, agentSession, text, { recap: true, nextStep }).catch((err) => {
+            // The recap is posted where it belongs; Cloud learning of it is best effort.
+            this.logger.warn('Drive mode: recap not reported to Cloud', { error: err instanceof Error ? err.message : String(err) });
+        });
+        await this.deps.store.update(conv.sessionId, conv.conversationId, (cur) => (cur ? { ...cur, closedAt: this.now().toISOString() } : null), this.now().getTime());
+        this.deps.closeTracking?.(conv.agentSession, conv.channelId);
+        this.logger.info('Drive mode recap posted; conversation closed', { sessionId: conv.sessionId, conversationId: conv.conversationId, where: posted.where, nextStep });
+        return { conversationId: conv.conversationId, closed: true };
+    }
+    /** Send an answer to Cloud and keep the local transcript. */
+    async forward(conv, agentSession, text, opts) {
+        const { instanceId } = await this.deps.identity();
+        await this.cloudPost(`/${conv.sessionId}/replies`, {
+            instanceId,
+            conversationId: conv.conversationId,
+            agentSession,
+            text: text.slice(0, C.TEXT_MAX_CHARS),
+            ...(opts.interim ? { interim: true } : {}),
+            ...(opts.recap ? { recap: true, nextStep: !!opts.nextStep } : {}),
+        });
+        if (opts.recap)
+            return;
+        const at = this.now().toISOString();
+        await this.deps.store.update(conv.sessionId, conv.conversationId, (cur) => (cur ? { ...cur, turns: [...cur.turns, { from: 'agent', name: agentSession, text: clip(speakable(text), 600), at, ...(opts.interim ? { interim: true } : {}) }] } : null), this.now().getTime());
+    }
+    // ---------------------------------------------------------------------------
+    // Recall / end
+    // ---------------------------------------------------------------------------
+    async recall(data, instanceId) {
+        const path = `/${data.sessionId}/machine/recalls/${encodeURIComponent(data.id)}`;
+        const req = parseRecallFetch(await this.cloudGet(`${path}?instanceId=${encodeURIComponent(instanceId)}`));
+        if (!req)
+            throw new Error('Cloud sent a malformed recall');
+        const feed = await this.deps.ownerFeed(this.now().getTime() - C.RECALL_WINDOW_MS);
+        const messages = pickRecall(messagesToOwner(feed.messages, feed.ownerTurns, req.agentSessions), req.hint);
+        await this.cloudPost(path, { instanceId, messages });
+    }
+    async end(data, instanceId) {
+        const state = parseStateFetch(await this.cloudGet(`/${data.sessionId}/machine/state?instanceId=${encodeURIComponent(instanceId)}`));
+        if (!state || !state.ended)
+            return;
+        const wanted = new Set(state.conversations.map((c) => c.conversationId));
+        const local = (await this.deps.store.list()).filter((c) => c.sessionId === data.sessionId && wanted.has(c.conversationId) && !c.closedAt && !c.recapAskedAt);
+        for (const c of local) {
+            const ok = await this.deps.notifyAgent(c.agentSession, recapRequest(c)).catch(() => false);
+            if (!ok) {
+                this.logger.warn('Drive mode: could not ask for a recap', { sessionId: c.sessionId, conversationId: c.conversationId, agent: c.agentSession });
+                continue;
+            }
+            await this.deps.store.update(c.sessionId, c.conversationId, (cur) => (cur ? { ...cur, recapAskedAt: this.now().toISOString() } : null), this.now().getTime());
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Cloud
+    // ---------------------------------------------------------------------------
+    async cloudGet(path) {
+        return this.cloudCall('GET', path);
+    }
+    async cloudPost(path, body) {
+        return this.cloudCall('POST', path, body);
+    }
+    async cloudCall(method, path, body, refreshed = false) {
+        const base = this.deps.cloud.getCloudUrl();
+        const token = this.deps.cloud.getToken();
+        if (!base || !token)
+            throw new DriveAgentError(503, 'This machine is not signed in to Crewly Cloud.');
+        let res;
+        try {
+            res = await this.fetchImpl(`${base.replace(/\/+$/, '')}${C.CLOUD_BASE_PATH}${path}`, {
+                method,
+                headers: { Authorization: `Bearer ${token}`, ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}) },
+                ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+                signal: AbortSignal.timeout(C.REQUEST_TIMEOUT_MS),
+            });
+        }
+        catch {
+            throw new DriveAgentError(502, 'Could not reach Crewly Cloud — try again in a moment.');
+        }
+        if (res.status === 401 && !refreshed && this.deps.cloud.tryRefreshToken && (await this.deps.cloud.tryRefreshToken())) {
+            return this.cloudCall(method, path, body, true);
+        }
+        let json = {};
+        try {
+            json = (await res.json());
+        }
+        catch {
+            json = {};
+        }
+        if (!res.ok || json.success === false) {
+            const why = typeof json.error === 'string' ? json.error : `Crewly Cloud answered ${res.status}`;
+            throw new DriveAgentError(res.status >= 500 ? 502 : res.status, why);
+        }
+        return json.data;
+    }
+}
+// ---------------------------------------------------------------------------
+// Pure helpers
+// ---------------------------------------------------------------------------
+/**
+ * The owner's words as delivered: the Drive mode note, then the words.
+ *
+ * @param sessionId - Session
+ * @param kind - Target kind
+ * @param name - Target name
+ * @param text - The owner's words
+ * @returns Message text
+ */
+export function ownerTurnText(sessionId, kind, name, text) {
+    const forTeam = kind === 'team' ? ` This is for the ${name} team: answer for the team, or hand it on.` : '';
+    return (`[Drive mode · session ${sessionId}] The owner is driving and LISTENING on the phone, not reading.${forTeam} ` +
+        `Answer with: reply --drive ${sessionId} "<1–3 short spoken sentences>". No URLs, tables, code or ids. ` +
+        'If it needs work, say so in one sentence first (reply --drive … --interim) and answer when done. Not in Slack.\n\n' +
+        text);
+}
+/**
+ * The harness note asking an agent for its recap.
+ *
+ * @param c - Conversation
+ * @returns Note text
+ */
+export function recapRequest(c) {
+    const where = c.kind === 'channel' ? c.targetName : c.kind === 'team' ? `your DM with the owner (for the ${c.targetName} team)` : 'your DM with the owner';
+    const transcript = c.turns
+        .slice(-12)
+        .map((t) => `${t.from === 'owner' ? 'Owner' : t.name}: ${clip(t.text, 400)}`)
+        .join('\n');
+    return [
+        `[Drive mode ended · session ${c.sessionId}] The owner ended the Drive mode conversation with you. Post ONE recap now, for reading:`,
+        `reply --drive ${c.sessionId} --recap "Drive mode recap — you said …; I did / answered …; next: … (or: nothing pending / waiting on X)"`,
+        `It is posted in ${where}. After it the conversation is closed: no follow-ups or nudges unless the recap names a next step.`,
+        '',
+        'The conversation:',
+        transcript,
+    ].join('\n');
+}
+/**
+ * The conversation an agent's reply belongs to: one it answers or is a
+ * member of; a recap goes to one whose recap was asked for; otherwise the one
+ * waiting for an answer, newest first.
+ *
+ * @param all - Local conversations
+ * @param sessionId - Session
+ * @param agentSession - Who replies
+ * @param recap - It is the recap
+ * @returns Conversation or undefined
+ */
+export function pickConversation(all, sessionId, agentSession, recap) {
+    const mine = all.filter((c) => c.sessionId === sessionId && !c.closedAt && (c.agentSession === agentSession || (c.members ?? []).includes(agentSession)));
+    const waiting = (c) => {
+        const lastOwner = [...c.turns].reverse().find((t) => t.from === 'owner');
+        const lastAgent = [...c.turns].reverse().find((t) => t.from === 'agent' && !t.interim);
+        return !!lastOwner && (!lastAgent || Date.parse(lastAgent.at) < Date.parse(lastOwner.at));
+    };
+    const pref = recap ? mine.filter((c) => c.recapAskedAt) : mine.filter(waiting);
+    const pool = pref.length > 0 ? pref : mine;
+    const own = pool.filter((c) => c.agentSession === agentSession);
+    const list = own.length > 0 ? own : pool;
+    const lastAt = (c) => Date.parse(c.turns[c.turns.length - 1]?.at ?? c.startedAt);
+    return [...list].sort((a, b) => lastAt(b) - lastAt(a))[0];
+}
+let instance = null;
+/** @returns The running service, or null */
+export function getDriveAgentService() {
+    return instance;
+}
+/**
+ * Install the service (boot, tests).
+ *
+ * @param service - Service or null
+ */
+export function setDriveAgentService(service) {
+    instance = service;
+}
+//# sourceMappingURL=drive-agent.service.js.map