crewly 1.20.149 → 1.20.151

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

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

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

@@ -0,0 +1,229 @@
+/**
+ * ConversationCloudSyncService — uploads this machine's conversation log to
+ * Crewly Cloud (specs/unified-conversations-cloud-store.md §B).
+ *
+ * - **Live:** drains `cloud_outbox` (filled by triggers on `chat_messages`)
+ *   in `seq` order, one request in flight, batches of ≤ 50 messages /
+ *   256 KB, gzip. Wakes on every new chat message (after a 2 s gather) and
+ *   on a 10 s tick. Rows leave the outbox only once Cloud acknowledged them.
+ * - **Backfill:** after first sign-in (or an account switch, or a plan
+ *   upgrade that widens the window) it re-sends the history inside the
+ *   plan's retention window, oldest first, at most one request a second,
+ *   after the live queue.
+ * - **Disconnected / signed out:** the outbox stays on disk; it is only
+ *   trimmed (older than 90 days, more than 200k rows — a history gap).
+ * - **Failures:** exponential backoff 1 s → 5 min. A 404 (Cloud has no
+ *   conversation store yet), `403 sync_disabled`, `503` key missing or a
+ *   `400` batch Cloud refuses pause sync for an hour, logged once.
+ * - **O1:** on by default for a signed-in machine; the owner gets one Slack
+ *   DM the first time history reaches Cloud. `CREWLY_CONVERSATION_SYNC=0`
+ *   (or `CREWLY_CLOUD_CONVERSATIONS=off`) turns uploading off; the outbox
+ *   still fills.
+ * - **O4:** text only — attachments go as name / size / mime.
+ * - **Roster (Cloud Talk, Phase 3):** every 5 minutes, and whenever the
+ *   advertised capabilities change, an empty batch carries this machine's
+ *   agent roster and capabilities (`talk_message`), so Cloud lists agents
+ *   that have no messages yet and knows Talk can be sent here — also on
+ *   machines that do not use Slack (and so never send the Slack heartbeat).
+ *
+ * The wire contract lives in `conversation-ingest.contract.ts`.
+ *
+ * @module services/cloud/conversation-cloud-sync.service
+ */
+import { type ComponentLogger } from '../core/logger.service.js';
+import type { BackfillCursor, OutboxEntry, UploadMessageRow } from '../chat-v2/sqlite/cloud-outbox.store.js';
+import { type AgentRosterEntry, type IngestUpsert } from './conversation-ingest.contract.js';
+/** The outbox operations the uploader needs (see `CloudOutboxStore`). */
+export interface ConversationOutbox {
+    peek(limit: number): OutboxEntry[];
+    ackThrough(seq: number): number;
+    count(): number;
+    clear(): void;
+    trim(options: {
+        maxRows: number;
+        olderThanMs: number;
+    }): number;
+    getMessages(ids: readonly string[]): Map<string, UploadMessageRow>;
+    backfillPage(sinceMs: number, after: BackfillCursor | null, limit: number): UploadMessageRow[];
+    getState(key: string): string | null;
+    setState(key: string, value: string | null): void;
+    clearState(keep?: readonly string[]): void;
+}
+/** The Cloud session the uploader rides on (see `CloudClientService`). */
+export interface ConversationSyncCloud {
+    getToken(): string | null;
+    getCloudUrl(): string | null;
+    /** Refresh an expired access token; resolves true when a new one is in place. */
+    tryRefreshToken?(): Promise<boolean>;
+}
+/** `fetch` signature (injectable for tests). */
+export type SyncFetch = (input: string, init: RequestInit) => Promise<Response>;
+/** Constructor dependencies. */
+export interface ConversationCloudSyncDeps {
+    outbox: ConversationOutbox;
+    cloud: ConversationSyncCloud;
+    /** Machine id (= device id = relay queue id = Slack instance id) and display name. */
+    identity: () => Promise<{
+        instanceId: string;
+        deviceName?: string;
+    }>;
+    /** Short id of the Crewly home (`getCrewlyHomeId`). */
+    homeId?: string;
+    /** Crewly version reported with each batch. */
+    crewlyVersion?: () => Promise<string>;
+    /** Subscribe to new chat messages (wake-up); returns an unsubscribe function. */
+    onNewMessage?: (listener: () => void) => () => void;
+    /** Upgrade rows written before the owner's Slack id was known (run before a backfill). */
+    reclassifyOwnerRows?: () => void;
+    /** O1: tell the owner once that history now syncs. Resolves true when the DM was posted. */
+    notifyOwner?: (text: string) => Promise<boolean>;
+    /** This machine's agents, reported every few minutes (Cloud lists them before they have messages). */
+    roster?: () => Promise<AgentRosterEntry[]>;
+    /** What this machine handles right now (e.g. `talk_message`); a change is reported at once. */
+    capabilities?: () => string[];
+    /** Environment (kill switch). Defaults to `process.env`. */
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: SyncFetch;
+    now?: () => number;
+    setTimeout?: (fn: () => void, ms: number) => ReturnType<typeof setTimeout>;
+    clearTimeout?: (handle: ReturnType<typeof setTimeout>) => void;
+    logger?: ComponentLogger;
+}
+/**
+ * Whether the kill switch is set.
+ *
+ * @param env - Environment
+ * @returns True when uploading is switched off
+ */
+export declare function isConversationSyncDisabled(env: NodeJS.ProcessEnv): boolean;
+/**
+ * The account a Cloud access token belongs to — the JWT `sub`, read without
+ * verifying. An opaque token yields a constant, so token refreshes are never
+ * mistaken for an account switch.
+ *
+ * @param token - Access token
+ * @returns The account id
+ */
+export declare function accountIdOfToken(token: string): string;
+/**
+ * Map one stored message to the wire shape.
+ *
+ * @param row - Message row with its channel and attachment metadata
+ * @param localSeq - Outbox seq (live) or 0 (backfill)
+ * @returns The upsert, or null when the row must not leave the machine
+ */
+export declare function toIngestUpsert(row: UploadMessageRow, localSeq: number): IngestUpsert | null;
+/** Uploads the machine's conversation log to Crewly Cloud. */
+export declare class ConversationCloudSyncService {
+    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 tickTimer;
+    private wakeTimer;
+    private unsubscribe;
+    /** Consecutive failures; drives the exponential backoff. */
+    private failures;
+    /** No request before this time (backoff or an hour-long pause). */
+    private pausedUntil;
+    /** Reasons already logged, so a long pause logs once. */
+    private readonly loggedPauses;
+    /** Current live batch cap; halved on 413. */
+    private batchLimit;
+    private lastBackfillAt;
+    private lastNoticeAttemptAt;
+    private gapLogged;
+    /** When the roster last reached Cloud, and the capabilities it carried. */
+    private lastRosterAt;
+    private lastCapabilitiesKey;
+    constructor(deps: ConversationCloudSyncDeps);
+    /** Start the tick and the new-message wake-up. Idempotent; never throws. */
+    start(): void;
+    /** Stop timers and the wake-up subscription. */
+    stop(): void;
+    /**
+     * Run one sync pass now (tests, and the timers). Never throws; a pass
+     * already in flight makes this one run again right after it.
+     */
+    syncNow(): Promise<void>;
+    /**
+     * Schedule a pass after a new message: immediately once a full batch is
+     * waiting, otherwise after the gather delay.
+     *
+     * @param delayMs - Override the delay
+     */
+    private wake;
+    /** Keep the periodic tick going. */
+    private scheduleTick;
+    /** One pass: trim, check the session, drain live, then one backfill step. */
+    private pass;
+    /**
+     * The roster and capabilities when they are due: every
+     * {@link CLOUD_TALK_CONSTANTS.ROSTER_INTERVAL_MS}, or at once when the
+     * capabilities changed (the Talk handler starting after the uploader).
+     *
+     * @returns The fields to send, or null when nothing is due
+     */
+    private rosterIfDue;
+    /**
+     * Upload every waiting outbox row, oldest first.
+     *
+     * @returns False when a request failed (the pass stops)
+     */
+    private drainLive;
+    /**
+     * Send one page of history when a backfill is owed (first sign-in, account
+     * switch, or a wider window after an upgrade). At most one request per
+     * second; live rows always go first.
+     */
+    private backfillStep;
+    /**
+     * POST one batch (gzip). Never throws.
+     *
+     * @returns The parsed outcome
+     */
+    private send;
+    /**
+     * Book the result of a request: remember the retention window, reset or
+     * advance the backoff, pause on the hour-long conditions.
+     *
+     * @returns True on success
+     */
+    private settle;
+    /**
+     * Pause for an hour, logging the reason once.
+     *
+     * @param reason - Why
+     * @param message - Log line
+     */
+    private pause;
+    /**
+     * On an account switch, start over: the new account gets this machine's
+     * history through a fresh backfill, never the old account's queue.
+     *
+     * @param token - Current access token
+     */
+    private checkAccount;
+    /** Keep the outbox bounded; log a history gap once. */
+    private trimOutbox;
+    /** O1: one DM to the owner the first time history reaches Cloud. */
+    private maybeNotifyOwner;
+}
+/**
+ * Install the process-wide instance (composition root).
+ *
+ * @param service - The service, or null
+ */
+export declare function setConversationCloudSyncService(service: ConversationCloudSyncService | null): void;
+/**
+ * The process-wide instance, or null before wiring.
+ *
+ * @returns The service or null
+ */
+export declare function getConversationCloudSyncService(): ConversationCloudSyncService | null;
+//# sourceMappingURL=conversation-cloud-sync.service.d.ts.map

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

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