crewly 1.20.150 → 1.20.151

package/dist/backend/backend/src/services/cloud/agent-roster.utils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The agent roster this machine reports to Crewly Cloud — on the Slack
+ * registry heartbeat and on the conversation uploader's periodic probe — so
+ * the portal lists every agent (spec §C.3 `roster[]`), including agents that
+ * have no messages yet and machines that do not use Slack.
+ *
+ * Session names are the machine's own (`crewly-orc` for the orchestrator,
+ * never the per-machine Slack spelling), the same names the uploaded
+ * conversation log and Cloud Talk use.
+ *
+ * @module services/cloud/agent-roster.utils
+ */
+import type { Team } from '../../types/index.js';
+import type { AgentRosterEntry } from './conversation-ingest.contract.js';
+/**
+ * Build the roster: the orchestrator first, then every team member with a
+ * session (orchestrator-role members are the orchestrator itself and are
+ * skipped). A session listed twice keeps its first entry.
+ *
+ * @param teams - Stored teams
+ * @returns Roster entries
+ *
+ * @example
+ * ```typescript
+ * buildAgentRoster(await storage.getTeams());
+ * // [{ agentSession: 'crewly-orc', displayName: 'Crewly Orc', role: 'orchestrator' },
+ * //  { agentSession: 'dev-ella', displayName: 'Ella', role: 'developer', teamName: 'Web' }]
+ * ```
+ */
+export declare function buildAgentRoster(teams: readonly Team[]): AgentRosterEntry[];
+//# sourceMappingURL=agent-roster.utils.d.ts.map

package/dist/backend/backend/src/services/cloud/agent-roster.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-roster.utils.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/agent-roster.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,gBAAgB,EAAE,CAoB3E"}

package/dist/backend/backend/src/services/cloud/agent-roster.utils.js

@@ -0,0 +1,53 @@
+/**
+ * The agent roster this machine reports to Crewly Cloud — on the Slack
+ * registry heartbeat and on the conversation uploader's periodic probe — so
+ * the portal lists every agent (spec §C.3 `roster[]`), including agents that
+ * have no messages yet and machines that do not use Slack.
+ *
+ * Session names are the machine's own (`crewly-orc` for the orchestrator,
+ * never the per-machine Slack spelling), the same names the uploaded
+ * conversation log and Cloud Talk use.
+ *
+ * @module services/cloud/agent-roster.utils
+ */
+import { CLOUD_TALK_CONSTANTS, ORCHESTRATOR_SESSION_NAME } from '../../constants.js';
+import { resolveMemberSessionName } from '../../utils/member-session-name.utils.js';
+/**
+ * Build the roster: the orchestrator first, then every team member with a
+ * session (orchestrator-role members are the orchestrator itself and are
+ * skipped). A session listed twice keeps its first entry.
+ *
+ * @param teams - Stored teams
+ * @returns Roster entries
+ *
+ * @example
+ * ```typescript
+ * buildAgentRoster(await storage.getTeams());
+ * // [{ agentSession: 'crewly-orc', displayName: 'Crewly Orc', role: 'orchestrator' },
+ * //  { agentSession: 'dev-ella', displayName: 'Ella', role: 'developer', teamName: 'Web' }]
+ * ```
+ */
+export function buildAgentRoster(teams) {
+    const out = [
+        { agentSession: ORCHESTRATOR_SESSION_NAME, displayName: CLOUD_TALK_CONSTANTS.ORCHESTRATOR_DISPLAY_NAME, role: 'orchestrator' },
+    ];
+    const seen = new Set([ORCHESTRATOR_SESSION_NAME]);
+    for (const team of teams) {
+        for (const member of team.members ?? []) {
+            if (!member?.id || String(member.role) === 'orchestrator')
+                continue;
+            const agentSession = resolveMemberSessionName(team.name, member);
+            if (!agentSession || seen.has(agentSession))
+                continue;
+            seen.add(agentSession);
+            out.push({
+                agentSession,
+                displayName: member.name || agentSession,
+                ...(member.role ? { role: String(member.role) } : {}),
+                ...(team.name ? { teamName: team.name } : {}),
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=agent-roster.utils.js.map

package/dist/backend/backend/src/services/cloud/agent-roster.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-roster.utils.js","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/agent-roster.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAGpF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,MAAM,GAAG,GAAuB;QAC9B,EAAE,YAAY,EAAE,yBAAyB,EAAE,WAAW,EAAE,oBAAoB,CAAC,yBAAyB,EAAE,IAAI,EAAE,cAAc,EAAE;KAC/H,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,cAAc;gBAAE,SAAS;YACpE,MAAM,YAAY,GAAG,wBAAwB,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACjE,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;gBAAE,SAAS;YACtD,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC;gBACP,YAAY;gBACZ,WAAW,EAAE,MAAM,CAAC,IAAI,IAAI,YAAY;gBACxC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -113,7 +113,7 @@ export interface HeartbeatPayload {
     timestamp: string;
 }
 /** All supported message types for inter-device communication. */
-export type MessageType = 'command' | 'sync_teams' | 'sync_settings' | 'notification' | 'relay' | 'ping' | 'task_update' | 'agent_message' | 'cross-machine' | 'browser_command' | 'browser_response' | 'chat_request' | 'chat_response' | 'chat_event' | 'slack_event';
+export type MessageType = 'command' | 'sync_teams' | 'sync_settings' | 'notification' | 'relay' | 'ping' | 'task_update' | 'agent_message' | 'cross-machine' | 'browser_command' | 'browser_response' | 'chat_request' | 'chat_response' | 'chat_event' | 'slack_event' | 'talk_message';
 /** Valid message type values for runtime validation. */
 export declare const MESSAGE_TYPES: readonly MessageType[];
 /**

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

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

package/dist/backend/backend/src/services/cloud/cloud-sync.types.js

@@ -27,6 +27,7 @@ export const MESSAGE_TYPES = [
     'chat_response',
     'chat_event',
     'slack_event',
+    'talk_message',
 ];
 /**
  * Check if an object satisfies the AgentMessagePayload interface shape.

package/dist/backend/backend/src/services/cloud/cloud-sync.types.js.map

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

package/dist/backend/backend/src/services/cloud/cloud-talk-inbound.service.d.ts

@@ -0,0 +1,125 @@
+/**
+ * CloudTalkInboundService — the machine side of Cloud Talk
+ * (specs/unified-conversations-cloud-store.md §D.3, Phase 3).
+ *
+ * The owner talks to an agent from the Crewly Cloud portal. Cloud stores the
+ * message and pushes a `talk_message` relay message to this machine with
+ * only ids in it (`{messageId, clientMessageId, instanceId, agentSession}`).
+ * This service:
+ *
+ *  1. fetches the text from Cloud with this machine's own Cloud token
+ *     (`GET /api/cloud/conversations/talk/:messageId?instanceId=`). Cloud only
+ *     answers for a message stored on the token's account and addressed to
+ *     this machine, so a push anybody else managed to drop in the relay
+ *     queue is never delivered;
+ *  2. records it in the agent's DM — the channel the dashboard and the
+ *     agent's Slack DM use — with `source: 'cloud-talk'` and the Talk
+ *     `clientMessageId` (idempotent: a re-push records nothing new). The
+ *     conversation uploader then sends it back to Cloud with that
+ *     `clientMessageId`, which is what marks it `delivered` there;
+ *  3. hands it to the agent exactly like a Crewly Chat DM (ticket intake +
+ *     the chat-v2 dispatcher, which wakes a sleeping agent). The agent
+ *     answers in that DM; the reply-affinity rule (G6) keeps the answer off
+ *     Slack because the owner's latest turn there came from Cloud Talk.
+ *
+ * A message for an agent this machine does not have is refused
+ * (`POST …/talk/:messageId/failed`) so the portal says so. Fetch failures are
+ * retried a few times; after that Cloud re-pushes the message on its own.
+ *
+ * Older OSS versions ignore `talk_message` (every relay listener filters on
+ * its own `type`), and Cloud only sends it to machines that advertise the
+ * `talk_message` capability, which this service turns on when it starts.
+ *
+ * @module services/cloud/cloud-talk-inbound.service
+ */
+import { type ComponentLogger } from '../core/logger.service.js';
+import type { ChatChannelDTO, ChatMessageDTO, ChatPrincipal } from '../chat-v2/types.js';
+import { type CloudTalkChat } from '../chat-v2/owner-inbound.utils.js';
+import type { IncomingMessage } from './cloud-sync.types.js';
+/** Emitter of relay messages (CloudSyncService). */
+export interface CloudTalkSource {
+    on(event: 'message', listener: (msg: IncomingMessage) => void): unknown;
+    off(event: 'message', listener: (msg: IncomingMessage) => void): unknown;
+}
+/** The Cloud session (CloudClientService). */
+export interface CloudTalkCloud {
+    getToken(): string | null;
+    getCloudUrl(): string | null;
+    /** Refresh an expired access token; true when a new one is in place. */
+    tryRefreshToken?(): Promise<boolean>;
+}
+/** The chat-v2 operations needed (ChatV2Service). */
+export interface CloudTalkInboundChat extends CloudTalkChat {
+    getChannel(channelId: string, principal: ChatPrincipal): ChatChannelDTO;
+}
+/** `fetch` signature (injectable for tests). */
+export type CloudTalkFetch = (input: string, init: RequestInit) => Promise<Response>;
+/** Constructor dependencies. */
+export interface CloudTalkInboundDeps {
+    source: CloudTalkSource;
+    cloud: CloudTalkCloud;
+    chat: CloudTalkInboundChat;
+    /** This machine's id (device id = relay queue id = Cloud instance id) and name. */
+    identity: () => Promise<{
+        instanceId: string;
+        deviceName?: string;
+    }>;
+    /** Hand the recorded message to the agent (ticket intake + dispatcher). */
+    deliver: (channel: ChatChannelDTO, message: ChatMessageDTO) => Promise<void>;
+    /** Whether the agent exists here; omitted = assume it does. */
+    agentExists?: (agentSession: string) => Promise<boolean>;
+    /** Owner principal of the DM channels (default: the single-user OSS owner). */
+    ownerUserId?: string;
+    fetchImpl?: CloudTalkFetch;
+    sleep?: (ms: number) => Promise<void>;
+    logger?: ComponentLogger;
+}
+/** What {@link CloudTalkInboundService.handle} did with one push (tests, logs). */
+export type CloudTalkOutcome = 'delivered' | 'duplicate' | 'ignored' | 'not_for_this_machine' | 'unverified' | 'expired' | 'fetch_failed' | 'refused';
+/**
+ * Whether the Talk handler is running on this machine — Cloud is told the
+ * machine handles `talk_message` only then.
+ *
+ * @returns True once started
+ */
+export declare function isCloudTalkInboundActive(): boolean;
+/**
+ * Capabilities to advertise to Cloud (heartbeat and uploads).
+ *
+ * @returns `['talk_message']` while the handler runs, else `[]`
+ */
+export declare function cloudTalkCapabilities(): string[];
+/** Receives Cloud Talk messages — see module docs. */
+export declare class CloudTalkInboundService {
+    private readonly deps;
+    private readonly logger;
+    private readonly fetchImpl;
+    private readonly sleep;
+    private readonly ownerUserId;
+    private readonly inFlight;
+    private readonly listener;
+    private started;
+    constructor(deps: CloudTalkInboundDeps);
+    /** Subscribe to relay messages and advertise the capability. Idempotent. */
+    start(): void;
+    /** Unsubscribe; the capability is no longer advertised. */
+    stop(): void;
+    /**
+     * Handle one relay message. Anything but a well-formed `talk_message` is
+     * ignored. Never throws.
+     *
+     * @param msg - Relay message from CloudSyncService
+     * @returns What was done
+     */
+    handle(msg: IncomingMessage): Promise<CloudTalkOutcome>;
+    private process;
+    private url;
+    /**
+     * Fetch the Talk message from Cloud with this machine's token; one token
+     * refresh on 401, a few retries on network / 5xx errors.
+     */
+    private fetchMessage;
+    /** Tell Cloud this machine cannot deliver a message (best effort). */
+    private reportFailed;
+}
+//# sourceMappingURL=cloud-talk-inbound.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-talk-inbound.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/cloud-talk-inbound.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQ7D,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC;IACxE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC;CAC1E;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,IAAI,MAAM,GAAG,IAAI,CAAC;IAC7B,wEAAwE;IACxE,eAAe,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAED,qDAAqD;AACrD,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,cAAc,CAAC;CACzE;AAED,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAErF,gCAAgC;AAChC,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,mFAAmF;IACnF,QAAQ,EAAE,MAAM,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,2EAA2E;IAC3E,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,+DAA+D;IAC/D,WAAW,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AASD,mFAAmF;AACnF,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,WAAW,GACX,SAAS,GACT,sBAAsB,GACtB,YAAY,GACZ,SAAS,GACT,cAAc,GACd,SAAS,CAAC;AAId;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAcD,sDAAsD;AACtD,qBAAa,uBAAuB;IAWtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAVjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAEvB;IACF,OAAO,CAAC,OAAO,CAAS;gBAEK,IAAI,EAAE,oBAAoB;IAOvD,4EAA4E;IAC5E,KAAK,IAAI,IAAI;IAQb,2DAA2D;IAC3D,IAAI,IAAI,IAAI;IAOZ;;;;;;OAMG;IACG,MAAM,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAsB/C,OAAO;IAiErB,OAAO,CAAC,GAAG;IAKX;;;OAGG;YACW,YAAY;IAwC1B,sEAAsE;YACxD,YAAY;CAgB3B"}

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

@@ -0,0 +1,272 @@
+/**
+ * CloudTalkInboundService — the machine side of Cloud Talk
+ * (specs/unified-conversations-cloud-store.md §D.3, Phase 3).
+ *
+ * The owner talks to an agent from the Crewly Cloud portal. Cloud stores the
+ * message and pushes a `talk_message` relay message to this machine with
+ * only ids in it (`{messageId, clientMessageId, instanceId, agentSession}`).
+ * This service:
+ *
+ *  1. fetches the text from Cloud with this machine's own Cloud token
+ *     (`GET /api/cloud/conversations/talk/:messageId?instanceId=`). Cloud only
+ *     answers for a message stored on the token's account and addressed to
+ *     this machine, so a push anybody else managed to drop in the relay
+ *     queue is never delivered;
+ *  2. records it in the agent's DM — the channel the dashboard and the
+ *     agent's Slack DM use — with `source: 'cloud-talk'` and the Talk
+ *     `clientMessageId` (idempotent: a re-push records nothing new). The
+ *     conversation uploader then sends it back to Cloud with that
+ *     `clientMessageId`, which is what marks it `delivered` there;
+ *  3. hands it to the agent exactly like a Crewly Chat DM (ticket intake +
+ *     the chat-v2 dispatcher, which wakes a sleeping agent). The agent
+ *     answers in that DM; the reply-affinity rule (G6) keeps the answer off
+ *     Slack because the owner's latest turn there came from Cloud Talk.
+ *
+ * A message for an agent this machine does not have is refused
+ * (`POST …/talk/:messageId/failed`) so the portal says so. Fetch failures are
+ * retried a few times; after that Cloud re-pushes the message on its own.
+ *
+ * Older OSS versions ignore `talk_message` (every relay listener filters on
+ * its own `type`), and Cloud only sends it to machines that advertise the
+ * `talk_message` capability, which this service turns on when it starts.
+ *
+ * @module services/cloud/cloud-talk-inbound.service
+ */
+import { CLOUD_TALK_CONSTANTS, ORCHESTRATOR_SESSION_NAME, SLACK_AGENT_DM_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+import { recordCloudTalkTurn } from '../chat-v2/owner-inbound.utils.js';
+import { parseTalkFetchResponse, parseTalkRelayData, } from './conversation-ingest.contract.js';
+let active = false;
+/**
+ * Whether the Talk handler is running on this machine — Cloud is told the
+ * machine handles `talk_message` only then.
+ *
+ * @returns True once started
+ */
+export function isCloudTalkInboundActive() {
+    return active;
+}
+/**
+ * Capabilities to advertise to Cloud (heartbeat and uploads).
+ *
+ * @returns `['talk_message']` while the handler runs, else `[]`
+ */
+export function cloudTalkCapabilities() {
+    return active ? [CLOUD_TALK_CONSTANTS.CAPABILITY] : [];
+}
+/**
+ * The machine's own session name for an agent Cloud names. Cloud already
+ * uses local names; the per-machine Slack spelling of the orchestrator
+ * (`crewly-orc@<instance>`) is folded back defensively.
+ *
+ * @param agentSession - Session as Cloud sent it
+ * @returns Local session name
+ */
+function localSession(agentSession) {
+    return agentSession.startsWith(`${ORCHESTRATOR_SESSION_NAME}@`) ? ORCHESTRATOR_SESSION_NAME : agentSession;
+}
+/** Receives Cloud Talk messages — see module docs. */
+export class CloudTalkInboundService {
+    deps;
+    logger;
+    fetchImpl;
+    sleep;
+    ownerUserId;
+    inFlight = new Set();
+    listener = (msg) => {
+        void this.handle(msg);
+    };
+    started = false;
+    constructor(deps) {
+        this.deps = deps;
+        this.logger = deps.logger ?? LoggerService.getInstance().createComponentLogger('CloudTalkInbound');
+        this.fetchImpl = deps.fetchImpl ?? ((input, init) => fetch(input, init));
+        this.sleep = deps.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+        this.ownerUserId = deps.ownerUserId ?? SLACK_AGENT_DM_CONSTANTS.OWNER_USER_ID;
+    }
+    /** 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('Cloud Talk 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 `talk_message` is
+     * ignored. Never throws.
+     *
+     * @param msg - Relay message from CloudSyncService
+     * @returns What was done
+     */
+    async handle(msg) {
+        if (msg?.type !== CLOUD_TALK_CONSTANTS.RELAY_MESSAGE_TYPE)
+            return 'ignored';
+        const data = parseTalkRelayData(msg.payload);
+        if (!data) {
+            this.logger.warn('Ignored a malformed talk_message relay message');
+            return 'ignored';
+        }
+        if (this.inFlight.has(data.messageId))
+            return 'duplicate';
+        this.inFlight.add(data.messageId);
+        try {
+            return await this.process(data);
+        }
+        catch (error) {
+            this.logger.warn('Cloud Talk message handling failed', {
+                messageId: data.messageId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return 'fetch_failed';
+        }
+        finally {
+            this.inFlight.delete(data.messageId);
+        }
+    }
+    async process(data) {
+        const { instanceId, deviceName } = await this.deps.identity();
+        if (data.instanceId !== instanceId) {
+            this.logger.warn('Ignored a talk_message addressed to another machine', { target: data.instanceId });
+            return 'not_for_this_machine';
+        }
+        const fetched = await this.fetchMessage(data, instanceId);
+        if (fetched.kind === 'not_found') {
+            // Not a message Cloud stored for this account and machine: not from Cloud.
+            this.logger.warn('Ignored a talk_message Crewly Cloud does not know for this machine', { messageId: data.messageId });
+            return 'unverified';
+        }
+        if (fetched.kind === 'expired') {
+            this.logger.info('Skipped a Cloud Talk message already marked as not delivered', { messageId: data.messageId });
+            return 'expired';
+        }
+        if (fetched.kind === 'error') {
+            this.logger.warn('Could not fetch a Cloud Talk message; Cloud will push it again', { messageId: data.messageId, error: fetched.error });
+            return 'fetch_failed';
+        }
+        const message = fetched.message;
+        if (message.clientMessageId !== data.clientMessageId || message.agentSession !== data.agentSession || message.instanceId !== instanceId) {
+            this.logger.warn('Ignored a talk_message that does not match what Cloud stored', { messageId: data.messageId });
+            return 'unverified';
+        }
+        const agentSession = localSession(message.agentSession);
+        if (this.deps.agentExists && !(await this.deps.agentExists(agentSession))) {
+            await this.reportFailed(data, instanceId, `No agent named "${agentSession}" on ${deviceName || 'this machine'}`);
+            return 'refused';
+        }
+        let recorded;
+        try {
+            recorded = recordCloudTalkTurn(this.deps.chat, {
+                agentSession,
+                text: message.text,
+                clientMessageId: message.clientMessageId,
+                ownerUserId: this.ownerUserId,
+            });
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            await this.reportFailed(data, instanceId, `Could not record the message on ${deviceName || 'this machine'}: ${reason}`);
+            return 'refused';
+        }
+        if (recorded.deduped) {
+            // Already recorded (a re-push); the upload has confirmed it or will.
+            return 'duplicate';
+        }
+        this.logger.info('Cloud Talk message received', { agentSession, messageId: data.messageId });
+        try {
+            const channel = this.deps.chat.getChannel(recorded.channelId, { userId: this.ownerUserId, source: 'oss' });
+            await this.deps.deliver(channel, recorded.message);
+        }
+        catch (error) {
+            // Recorded (so Cloud shows it delivered), but the agent was not paged.
+            this.logger.warn('Cloud Talk message recorded but not handed to the agent', {
+                agentSession,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        return 'delivered';
+    }
+    url(suffix) {
+        const base = this.deps.cloud.getCloudUrl();
+        return base ? `${base.replace(/\/$/, '')}${CLOUD_TALK_CONSTANTS.MESSAGE_PATH}${suffix}` : null;
+    }
+    /**
+     * Fetch the Talk message from Cloud with this machine's token; one token
+     * refresh on 401, a few retries on network / 5xx errors.
+     */
+    async fetchMessage(data, instanceId) {
+        const url = this.url(`/${encodeURIComponent(data.messageId)}?instanceId=${encodeURIComponent(instanceId)}`);
+        if (!url)
+            return { kind: 'error', error: 'not signed in to Crewly Cloud' };
+        const delays = CLOUD_TALK_CONSTANTS.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]);
+            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(CLOUD_TALK_CONSTANTS.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 = parseTalkFetchResponse(await response.json().catch(() => null));
+                return parsed ? { kind: 'ok', message: 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 };
+    }
+    /** Tell Cloud this machine cannot deliver a message (best effort). */
+    async reportFailed(data, instanceId, error) {
+        this.logger.warn('Cloud Talk message refused', { messageId: data.messageId, error });
+        const url = this.url(`/${encodeURIComponent(data.messageId)}/failed`);
+        const token = this.deps.cloud.getToken();
+        if (!url || !token)
+            return;
+        try {
+            await this.fetchImpl(url, {
+                method: 'POST',
+                headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
+                body: JSON.stringify({ instanceId, error }),
+                signal: AbortSignal.timeout(CLOUD_TALK_CONSTANTS.REQUEST_TIMEOUT_MS),
+            });
+        }
+        catch {
+            // Cloud marks it failed after 24 h anyway.
+        }
+    }
+}
+//# sourceMappingURL=cloud-talk-inbound.service.js.map

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

@@ -20,6 +20,11 @@
  *   (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`.
  *
@@ -27,7 +32,7 @@
  */
 import { type ComponentLogger } from '../core/logger.service.js';
 import type { BackfillCursor, OutboxEntry, UploadMessageRow } from '../chat-v2/sqlite/cloud-outbox.store.js';
-import { type IngestUpsert } from './conversation-ingest.contract.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[];
@@ -72,6 +77,10 @@ export interface ConversationCloudSyncDeps {
     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;
@@ -129,6 +138,9 @@ export declare class ConversationCloudSyncService {
     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;
@@ -150,6 +162,14 @@ export declare class ConversationCloudSyncService {
     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.
      *