crewly 1.20.152 → 1.20.153

package/dist/backend/backend/src/services/cloud/waiting-actions-inbound.service.js

@@ -0,0 +1,279 @@
+/**
+ * WaitingActionsInboundService — the machine side of "Waiting on you"
+ * actions (specs/unified-conversations-cloud-store.md §F, Phase 5).
+ *
+ * The owner taps "Looks good" (验过了) or "Send back" (打回, with what still
+ * needs fixing) in the Crewly Cloud portal. Cloud stores the action and
+ * pushes a `waiting_action` relay message to this machine with only ids in
+ * it (`{actionId, itemId, instanceId, ticketId}`) — the same secure pattern
+ * as Cloud Talk. This service:
+ *
+ *  1. fetches the action with this machine's own Cloud token
+ *     (`GET /api/cloud/conversations/waiting/actions/:actionId?instanceId=`).
+ *     Cloud answers only for an action stored on the token's account and
+ *     addressed to this machine, so a push anybody else dropped in the relay
+ *     queue is never run; the fetched ids must match the push;
+ *  2. runs it through the ticket review service — the same code as the
+ *     board's `POST /api/tickets/:id/verify` / `…/reject` (a send-back from
+ *     Cloud behaves like one from the board: the reason becomes an acceptance
+ *     criterion and a rework WorkItem is queued for whoever answered);
+ *  3. reports the result (`POST …/actions/:actionId/result`) so Cloud removes
+ *     the item — or shows the owner why it could not be done — and asks the
+ *     waiting uploader for a fresh snapshot.
+ *
+ * Idempotent: an action already carried out is not run again when Cloud
+ * re-pushes it (it only re-reports), and the ticket service itself refuses
+ * to accept a ticket twice.
+ *
+ * Older OSS versions ignore `waiting_action` (every relay listener filters on
+ * its own `type`), and Cloud only sends it to machines advertising the
+ * `waiting_actions` capability, which this service turns on when it starts.
+ *
+ * @module services/cloud/waiting-actions-inbound.service
+ */
+import { WAITING_SYNC_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+import { parseWaitingActionFetchResponse, parseWaitingActionRelayData, } from './waiting-items.contract.js';
+const C = WAITING_SYNC_CONSTANTS;
+let active = false;
+/**
+ * Capabilities to advertise to Cloud (heartbeat and uploads).
+ *
+ * @returns `['waiting_actions']` while the handler runs, else `[]`
+ */
+export function waitingActionCapabilities() {
+    return active ? [C.CAPABILITY] : [];
+}
+/**
+ * Words for the owner when the machine could not do an action.
+ *
+ * @param reason - Ticket review refusal
+ * @param device - Machine name
+ * @returns Owner-readable text
+ */
+export function refusalText(reason, device) {
+    switch (reason) {
+        case 'open_work':
+            return `Work on this is still running on ${device}. Try again when it has finished.`;
+        case 'invalid':
+            return 'Say what still needs fixing.';
+        case 'not_found':
+            return `${device} no longer has this.`;
+        case 'not_in_review':
+            return 'This is no longer waiting for your review.';
+        case 'already_done':
+            return 'This was already accepted.';
+        case 'cancelled':
+            return 'This was cancelled.';
+        default:
+            return `${device} could not do this.`;
+    }
+}
+/** Runs accept / send-back pushed from Crewly Cloud — see module docs. */
+export class WaitingActionsInboundService {
+    deps;
+    logger;
+    fetchImpl;
+    sleep;
+    now;
+    inFlight = new Set();
+    /** Actions already carried out → the result to report again on a re-push. */
+    done = new Map();
+    listener = (msg) => {
+        void this.handle(msg);
+    };
+    started = false;
+    constructor(deps) {
+        this.deps = deps;
+        this.logger = deps.logger ?? LoggerService.getInstance().createComponentLogger('WaitingActionsInbound');
+        this.fetchImpl = deps.fetchImpl ?? ((input, init) => fetch(input, init));
+        this.sleep = deps.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+        this.now = deps.now ?? Date.now;
+    }
+    /** 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;
+        this.logger.info('"Waiting on you" action handler started');
+    }
+    /** Unsubscribe; the capability is no longer advertised. */
+    stop() {
+        if (!this.started)
+            return;
+        this.started = false;
+        this.deps.source.off('message', this.listener);
+        active = false;
+    }
+    /**
+     * Handle one relay message. Anything but a well-formed `waiting_action` is
+     * ignored. Never throws.
+     *
+     * @param msg - Relay message from CloudSyncService
+     * @returns What was done
+     */
+    async handle(msg) {
+        if (msg?.type !== C.RELAY_MESSAGE_TYPE)
+            return 'ignored';
+        const data = parseWaitingActionRelayData(msg.payload);
+        if (!data) {
+            this.logger.warn('Ignored a malformed waiting_action relay message');
+            return 'ignored';
+        }
+        if (this.inFlight.has(data.actionId))
+            return 'duplicate';
+        this.inFlight.add(data.actionId);
+        try {
+            return await this.process(data);
+        }
+        catch (error) {
+            this.logger.warn('"Waiting on you" action failed', {
+                actionId: data.actionId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return 'fetch_failed';
+        }
+        finally {
+            this.inFlight.delete(data.actionId);
+        }
+    }
+    async process(data) {
+        const { instanceId, deviceName } = await this.deps.identity();
+        if (data.instanceId !== instanceId) {
+            this.logger.warn('Ignored a waiting_action addressed to another machine', { target: data.instanceId });
+            return 'not_for_this_machine';
+        }
+        this.pruneDone();
+        const earlier = this.done.get(data.actionId);
+        if (earlier) {
+            // Cloud re-pushed an action already carried out (our report was lost): report again.
+            await this.report(data.actionId, earlier.result);
+            return 'duplicate';
+        }
+        const fetched = await this.fetchAction(data, instanceId);
+        if (fetched.kind === 'not_found') {
+            this.logger.warn('Ignored a waiting_action Crewly Cloud does not know for this machine', { actionId: data.actionId });
+            return 'unverified';
+        }
+        if (fetched.kind === 'expired')
+            return 'expired';
+        if (fetched.kind === 'error') {
+            this.logger.warn('Could not fetch a "waiting on you" action; Cloud will push it again', { actionId: data.actionId, error: fetched.error });
+            return 'fetch_failed';
+        }
+        const action = fetched.action;
+        if (action.actionId !== data.actionId || action.ticketId !== data.ticketId || action.instanceId !== instanceId || action.itemId !== data.itemId) {
+            this.logger.warn('Ignored a waiting_action that does not match what Cloud stored', { actionId: data.actionId });
+            return 'unverified';
+        }
+        const device = deviceName || 'this machine';
+        const review = this.deps.review();
+        if (!review) {
+            // Boot has not wired tickets yet — Cloud re-pushes in 5 minutes.
+            this.logger.warn('Ticket review is not ready; a "waiting on you" action will be retried', { actionId: data.actionId });
+            return 'fetch_failed';
+        }
+        const result = action.kind === 'accept' ? await review.verify(action.ticketId) : await review.reject(action.ticketId, action.reason ?? '', 'board');
+        const report = result.ok
+            ? { instanceId, ok: true }
+            : { instanceId, ok: false, code: result.reason, error: refusalText(result.reason, device) };
+        this.done.set(data.actionId, { at: this.now(), result: report });
+        this.logger.info(result.ok ? 'Ticket answered from Crewly Cloud' : 'Ticket action from Crewly Cloud refused', {
+            ticketId: action.ticketId,
+            kind: action.kind,
+            ...(result.ok ? {} : { reason: result.reason }),
+        });
+        await this.report(data.actionId, report);
+        this.deps.requestResync?.();
+        return result.ok ? 'done' : 'refused';
+    }
+    /** Forget carried-out actions after a day (bounded). */
+    pruneDone() {
+        const cutoff = this.now() - C.DONE_ACTIONS_TTL_MS;
+        for (const [id, entry] of this.done)
+            if (entry.at < cutoff)
+                this.done.delete(id);
+        while (this.done.size > C.DONE_ACTIONS_MAX) {
+            const oldest = this.done.keys().next().value;
+            this.done.delete(oldest);
+        }
+    }
+    url(suffix) {
+        const base = this.deps.cloud.getCloudUrl();
+        return base ? `${base.replace(/\/$/, '')}${C.ACTIONS_PATH}${suffix}` : null;
+    }
+    /**
+     * Fetch the action from Cloud with this machine's token; one token refresh
+     * on 401, a few retries on network / 5xx errors.
+     */
+    async fetchAction(data, instanceId) {
+        const url = this.url(`/${encodeURIComponent(data.actionId)}?instanceId=${encodeURIComponent(instanceId)}`);
+        if (!url)
+            return { kind: 'error', error: 'not signed in to Crewly Cloud' };
+        const delays = C.FETCH_RETRY_DELAYS_MS;
+        let refreshed = false;
+        let lastError = 'unknown';
+        for (let attempt = 0; attempt <= delays.length; attempt++) {
+            if (attempt > 0)
+                await this.sleep(delays[attempt - 1] ?? 0);
+            const token = this.deps.cloud.getToken();
+            if (!token)
+                return { kind: 'error', error: 'not signed in to Crewly Cloud' };
+            let response;
+            try {
+                response = await this.fetchImpl(url, {
+                    method: 'GET',
+                    headers: { Authorization: `Bearer ${token}` },
+                    signal: AbortSignal.timeout(C.REQUEST_TIMEOUT_MS),
+                });
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error.message : String(error);
+                continue;
+            }
+            if (response.status === 401 && !refreshed && this.deps.cloud.tryRefreshToken) {
+                refreshed = true;
+                if (await this.deps.cloud.tryRefreshToken().catch(() => false)) {
+                    attempt--; // the retry with the new token is free
+                    continue;
+                }
+            }
+            if (response.status === 404)
+                return { kind: 'not_found' };
+            if (response.status === 410)
+                return { kind: 'expired' };
+            if (response.ok) {
+                const parsed = parseWaitingActionFetchResponse(await response.json().catch(() => null));
+                return parsed ? { kind: 'ok', action: parsed } : { kind: 'error', error: 'unusable response from Crewly Cloud' };
+            }
+            lastError = `HTTP ${response.status}`;
+            if (response.status >= 400 && response.status < 500 && response.status !== 429)
+                break;
+        }
+        return { kind: 'error', error: lastError };
+    }
+    /** Report an action's result to Cloud (best effort; a re-push re-reports). */
+    async report(actionId, body) {
+        const url = this.url(`/${encodeURIComponent(actionId)}/result`);
+        const token = this.deps.cloud.getToken();
+        if (!url || !token)
+            return;
+        try {
+            const response = await this.fetchImpl(url, {
+                method: 'POST',
+                headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(C.REQUEST_TIMEOUT_MS),
+            });
+            if (!response.ok)
+                this.logger.debug('Crewly Cloud did not take an action result', { actionId, status: response.status });
+        }
+        catch (error) {
+            // The uploader's next snapshot removes the item anyway.
+            this.logger.debug('Could not report an action result to Crewly Cloud', { actionId, error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+}
+//# sourceMappingURL=waiting-actions-inbound.service.js.map

package/dist/backend/backend/src/services/cloud/waiting-actions-inbound.service.js.map

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

package/dist/backend/backend/src/services/cloud/waiting-items-sync.service.d.ts

@@ -0,0 +1,122 @@
+/**
+ * WaitingItemsSyncService — keeps Crewly Cloud's "Waiting on you" list in
+ * step with this machine (specs/unified-conversations-cloud-store.md §F,
+ * Phase 5).
+ *
+ * "Waiting on you" = tickets in 待验收 (board column `to_review`): work an
+ * agent handed back for the owner's OK. The column is derived, not stored,
+ * so this service recomputes the set and uploads a text snapshot
+ * (`POST /api/cloud/conversations/waiting/ingest`, `full: true`) whenever it
+ * changed:
+ *
+ * - on a Request write (RequestService.onChange), gathered for 2 s;
+ * - on a 30 s check (a WorkItem finishing can move a ticket into 待验收
+ *   without touching its Request file) — uploads only when the set differs
+ *   from what Cloud last took;
+ * - every 5 minutes regardless (a full resync: Cloud refreshes the items'
+ *   `syncedAt`, so the portal knows the machine is alive, and drops anything
+ *   this machine no longer has);
+ * - after an accept / send-back from the portal was carried out.
+ *
+ * Every upload is the whole set, so a ticket that left 待验收 disappears in
+ * Cloud with the next upload. Uses the machine's own Cloud token (same as
+ * the conversation uploader); signed out = nothing is sent. The conversation
+ * sync kill switch (`CREWLY_CONVERSATION_SYNC=0`) turns this off too.
+ *
+ * @module services/cloud/waiting-items-sync.service
+ */
+import { type ComponentLogger } from '../core/logger.service.js';
+import type { TicketListItem } from '../v3/ticket-intake.service.js';
+/** The Cloud session (CloudClientService). */
+export interface WaitingSyncCloud {
+    getToken(): string | null;
+    getCloudUrl(): string | null;
+    tryRefreshToken?(): Promise<boolean>;
+}
+/** `fetch` signature (injectable for tests). */
+export type WaitingSyncFetch = (input: string, init: RequestInit) => Promise<Response>;
+/** Constructor dependencies. */
+export interface WaitingItemsSyncDeps {
+    /** Tickets in 待验收 right now (board rows, `column: 'to_review'`). */
+    listWaiting: () => Promise<TicketListItem[]>;
+    cloud: WaitingSyncCloud;
+    /** This machine's id (device id = relay queue id = Cloud instance id) and name. */
+    identity: () => Promise<{
+        instanceId: string;
+        deviceName?: string;
+    }>;
+    crewlyVersion?: () => Promise<string>;
+    /** Display names of the machine's agents (session → name). */
+    agentNames?: () => Promise<Map<string, string>>;
+    /** What this machine handles right now (`waiting_actions`, …). */
+    capabilities?: () => string[];
+    /** Subscribe to ticket writes; returns an unsubscribe function. */
+    onTicketChange?: (listener: () => void) => () => void;
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: WaitingSyncFetch;
+    now?: () => number;
+    setTimeout?: (fn: () => void, ms: number) => ReturnType<typeof setTimeout>;
+    clearTimeout?: (handle: ReturnType<typeof setTimeout>) => void;
+    logger?: ComponentLogger;
+}
+/** What one {@link WaitingItemsSyncService.syncNow} did (tests, logs). */
+export type WaitingSyncOutcome = 'uploaded' | 'unchanged' | 'skipped' | 'failed' | 'paused';
+/** Uploads the machine's "waiting on you" set to Crewly Cloud. */
+export declare class WaitingItemsSyncService {
+    private readonly deps;
+    private readonly logger;
+    private readonly fetchImpl;
+    private readonly now;
+    private readonly setTimer;
+    private readonly clearTimer;
+    private started;
+    private running;
+    private rerun;
+    private checkTimer;
+    private debounceTimer;
+    private unsubscribe;
+    /** Snapshot Cloud last took (items + capabilities), per account. */
+    private lastKey;
+    private lastAccount;
+    private lastFullAt;
+    private failures;
+    private pausedUntil;
+    private pauseLogged;
+    constructor(deps: WaitingItemsSyncDeps);
+    /** Start watching tickets and the periodic check. Idempotent; never throws. */
+    start(): void;
+    /** Stop timers and the ticket subscription. */
+    stop(): void;
+    /**
+     * Upload soon (after the 2 s gather) — a ticket changed, or an action from
+     * the portal was carried out.
+     */
+    requestSync(): void;
+    /** Keep the periodic check going. */
+    private scheduleCheck;
+    /**
+     * Recompute the set and upload it when it changed (or a full resync is
+     * due). One upload at a time; a call during one runs again after it.
+     * Never throws.
+     *
+     * @param force - Upload even when nothing changed
+     * @returns What happened
+     */
+    syncNow(force?: boolean): Promise<WaitingSyncOutcome>;
+    private pass;
+    /** POST the snapshot and book the outcome. */
+    private upload;
+}
+/**
+ * Install the process-wide instance (composition root).
+ *
+ * @param service - The service, or null
+ */
+export declare function setWaitingItemsSyncService(service: WaitingItemsSyncService | null): void;
+/**
+ * The process-wide instance, or null before wiring.
+ *
+ * @returns The service or null
+ */
+export declare function getWaitingItemsSyncService(): WaitingItemsSyncService | null;
+//# sourceMappingURL=waiting-items-sync.service.d.ts.map

package/dist/backend/backend/src/services/cloud/waiting-items-sync.service.d.ts.map

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