crewly 1.20.251 → 1.20.253

package/dist/backend/backend/src/services/apps/app-comment-audio.service.js

@@ -0,0 +1,217 @@
+/**
+ * Voice comments on Crewly Apps (crewly-services apps/SPEC.md §16).
+ *
+ * The owner records audio in the app's comment box; Cloud stores it and puts
+ * `attachments: [{ kind: 'audio', blobId, mime, durationMs, size }]` on the
+ * comment or reply. When such a comment is delivered — to an agent, to the
+ * room (team / channel) that owns the app, or mirrored to Slack — this module
+ * downloads the recording to `<CREWLY_HOME>/tmp/app-comment-audio/` (next to
+ * Slack's downloaded files) and builds the line that tells the agent where it
+ * is and to transcribe it with the transcribe-audio skill, the same way a
+ * Slack voice clip reaches an agent.
+ *
+ * A failed download never blocks delivery: the line then names the command
+ * that fetches it (`app-comments --audio <comment id>`).
+ *
+ * @module services/apps/app-comment-audio.service
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import { CREWLY_APPS_CONSTANTS } from '../../constants.js';
+const C = CREWLY_APPS_CONSTANTS;
+const V = C.VOICE;
+const APP_ID_RE = /^[a-z0-9]{10}$/;
+/**
+ * "0:42" / "2:05" for a length in milliseconds.
+ *
+ * @param ms - Milliseconds
+ * @returns m:ss
+ */
+export function formatVoiceClock(ms) {
+    const total = Math.max(0, Math.floor((typeof ms === 'number' && Number.isFinite(ms) ? ms : 0) / 1000));
+    const m = Math.floor(total / 60);
+    const s = total % 60;
+    return `${m}:${s < 10 ? '0' : ''}${s}`;
+}
+/** Valid audio attachments of a list (untrusted input). */
+function audioOf(list) {
+    if (!Array.isArray(list))
+        return [];
+    return list.filter((a) => !!a && typeof a === 'object' && a.kind === 'audio' && typeof a.blobId === 'string' && V.BLOB_ID_PATTERN.test(a.blobId));
+}
+/**
+ * The recordings a comment change is about: the comment's own for a new
+ * comment or a reopen, the reply's for a reply.
+ *
+ * @param change - A comment change (its `thread` as Cloud sent it)
+ * @returns Attachments with the comment id
+ */
+export function voiceAttachmentsOf(change) {
+    const info = change.comment;
+    const thread = info?.thread;
+    if (!info?.id || !thread || !C.COMMENTS.ID_PATTERN.test(info.id))
+        return [];
+    const list = info.op === 'reply' ? (thread.replies ?? []).find((r) => r.id === info.replyId)?.attachments : info.op === 'add' || info.op === 'reopen' ? thread.attachments : undefined;
+    return audioOf(list).map((attachment) => ({ commentId: info.id, attachment }));
+}
+/**
+ * Every recording in a thread (the comment and all replies).
+ *
+ * @param thread - The thread
+ * @returns Attachments
+ */
+export function threadVoiceAttachments(thread) {
+    if (!thread)
+        return [];
+    return [...audioOf(thread.attachments), ...(thread.replies ?? []).flatMap((r) => audioOf(r.attachments))];
+}
+/**
+ * The lines an agent reads for a comment change's recordings (indented under
+ * the comment). Downloaded: the path and the instruction to transcribe it
+ * first. Not downloaded: the reason and the command that fetches it.
+ *
+ * @param change - The comment change
+ * @param files - Recordings fetched for this delivery
+ * @param fetchCmd - `bash …/app-comments/execute.sh --app <id>` (the fallback command)
+ * @returns Lines (empty when the change has no recording)
+ */
+export function voiceLines(change, files, fetchCmd) {
+    const out = [];
+    for (const { commentId, attachment } of voiceAttachmentsOf(change)) {
+        const f = files?.[attachment.blobId];
+        const clock = formatVoiceClock(f?.durationMs ?? attachment.durationMs);
+        if (f?.path) {
+            const json = JSON.stringify(f.path);
+            out.push(`    Voice comment (${clock}): ${f.path} — transcribe it with the transcribe-audio skill before acting: {"audioFile":${json}}. ` +
+                'If it answers "needsSetup": true, run install-skill --id transcribe-audio first; do not guess what it says.');
+        }
+        else {
+            out.push(`    Voice comment (${clock}): not downloaded yet${f?.error ? ` (${f.error})` : ''}. Fetch it with: ${fetchCmd} --audio ${commentId} ` +
+                '— then transcribe it with the transcribe-audio skill before acting.');
+        }
+    }
+    return out;
+}
+/** Downloads voice comment recordings to this machine. */
+export class AppCommentAudioService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    dir() {
+        return path.join(this.deps.homeDir(), V.DIR);
+    }
+    /**
+     * One recording, cached by app + blob id.
+     *
+     * @param appId - App
+     * @param commentId - Thread it is attached to
+     * @param a - The attachment
+     * @returns The local file (or why not)
+     */
+    async fetchOne(appId, commentId, a) {
+        const base = { blobId: a.blobId, commentId, durationMs: typeof a.durationMs === 'number' ? a.durationMs : 0, mime: typeof a.mime === 'string' ? a.mime : 'audio/webm' };
+        if (!APP_ID_RE.test(appId) || !C.COMMENTS.ID_PATTERN.test(commentId) || !V.BLOB_ID_PATTERN.test(a.blobId))
+            return { ...base, error: 'bad id' };
+        const ext = V.EXT[base.mime] ?? 'audio';
+        const file = path.join(this.dir(), `${appId}-${a.blobId}.${ext}`);
+        try {
+            const st = await fs.stat(file).catch(() => null);
+            if (st && st.size > 0)
+                return { ...base, path: file };
+            const { data } = await this.deps.client.download(`/apps/${appId}/comments/${commentId}/audio/${a.blobId}`, { maxBytes: V.MAX_BYTES, timeoutMs: V.DOWNLOAD_TIMEOUT_MS });
+            if (data.length === 0)
+                return { ...base, error: 'empty recording' };
+            await fs.mkdir(this.dir(), { recursive: true });
+            const tmp = `${file}.${process.pid}.tmp`;
+            await fs.writeFile(tmp, data, { mode: 0o600 });
+            await fs.rename(tmp, file);
+            this.deps.log?.('info', 'Voice comment downloaded', { appId, commentId, blobId: a.blobId, bytes: data.length });
+            return { ...base, path: file };
+        }
+        catch (err) {
+            const why = err instanceof Error ? err.message : String(err);
+            this.deps.log?.('warn', 'Voice comment could not be downloaded', { appId, commentId, blobId: a.blobId, error: why });
+            return { ...base, error: why.slice(0, 120) };
+        }
+    }
+    /**
+     * The recordings of a batch of comment changes (at most VOICE.MAX_PER_WAKE).
+     * Never throws.
+     *
+     * @param appId - App
+     * @param comments - Comment changes
+     * @returns Files by blob id (empty when none)
+     */
+    async forChanges(appId, comments) {
+        const out = {};
+        const wanted = comments.flatMap((c) => voiceAttachmentsOf(c)).slice(-V.MAX_PER_WAKE);
+        for (const { commentId, attachment } of wanted) {
+            if (out[attachment.blobId])
+                continue;
+            out[attachment.blobId] = await this.fetchOne(appId, commentId, attachment).catch((err) => ({
+                blobId: attachment.blobId,
+                commentId,
+                durationMs: attachment.durationMs ?? 0,
+                mime: attachment.mime ?? 'audio/webm',
+                error: err instanceof Error ? err.message : String(err),
+            }));
+        }
+        return out;
+    }
+    /**
+     * Every recording of one thread (`app-comments --audio <id>`).
+     *
+     * @param appId - App
+     * @param commentId - Thread
+     * @param thread - The thread as Cloud returned it
+     * @returns Files, oldest first
+     */
+    async forThread(appId, commentId, thread) {
+        const out = [];
+        for (const a of threadVoiceAttachments(thread))
+            out.push(await this.fetchOne(appId, commentId, a));
+        return out;
+    }
+}
+/**
+ * Show a comment change's recordings in its Slack thread: each file uploaded
+ * as the thread's bot when it is on this machine and an uploader is wired;
+ * otherwise (or when the upload fails) one line with a link to the app,
+ * where the owner can play it.
+ *
+ * @param input - The change, its downloaded files, the thread and the senders
+ * @returns How many recordings were uploaded
+ */
+export async function mirrorVoiceToSlack(input) {
+    let uploaded = 0;
+    for (const { attachment } of voiceAttachmentsOf(input.change)) {
+        const f = input.files?.[attachment.blobId];
+        const clock = formatVoiceClock(f?.durationMs ?? attachment.durationMs);
+        if (f?.path && input.upload && input.agentSession) {
+            try {
+                await input.upload({
+                    agentSession: input.agentSession,
+                    channel: input.channel,
+                    threadTs: input.threadTs,
+                    filePath: f.path,
+                    filename: path.basename(f.path),
+                    title: `Voice comment (${clock})`,
+                });
+                uploaded++;
+                continue;
+            }
+            catch (err) {
+                input.log?.('warn', 'Voice comment could not be uploaded to Slack; posting a link instead', { error: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        try {
+            await input.post(`🎤 Voice comment (${clock}) — listen in the app: <${input.appUrl}|Open app>`);
+        }
+        catch {
+            /* a mirror problem never fails delivery */
+        }
+    }
+    return uploaded;
+}
+//# sourceMappingURL=app-comment-audio.service.js.map

package/dist/backend/backend/src/services/apps/app-comment-audio.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-comment-audio.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/apps/app-comment-audio.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,MAAM,CAAC,GAAG,qBAAqB,CAAC;AAChC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;AAClB,MAAM,SAAS,GAAG,gBAAgB,CAAC;AAgCnC;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAW;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACvG,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;IACrB,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACzC,CAAC;AAED,2DAA2D;AAC3D,SAAS,OAAO,CAAC,IAAa;IAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,OAAO,IAAI,CAAC,MAAM,CAChB,CAAC,CAAC,EAA8E,EAAE,CAChF,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAK,CAA0B,CAAC,IAAI,KAAK,OAAO,IAAI,OAAQ,CAA0B,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,eAAe,CAAC,IAAI,CAAE,CAA0B,CAAC,MAAgB,CAAC,CACjN,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,IAAI,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACvL,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,EAAY,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAgG;IACrI,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAC5G,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,MAAiB,EAAE,KAA6B,EAAE,QAAgB;IAC3F,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,gBAAgB,CAAC,CAAC,EAAE,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;QACvE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACpC,GAAG,CAAC,IAAI,CACN,sBAAsB,KAAK,MAAM,CAAC,CAAC,IAAI,gFAAgF,IAAI,KAAK;gBAC9H,6GAA6G,CAChH,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CACN,sBAAsB,KAAK,wBAAwB,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,oBAAoB,QAAQ,YAAY,SAAS,GAAG;gBACpI,qEAAqE,CACxE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0DAA0D;AAC1D,MAAM,OAAO,sBAAsB;IACJ;IAA7B,YAA6B,IAAyB;QAAzB,SAAI,GAAJ,IAAI,CAAqB;IAAG,CAAC;IAElD,GAAG;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,SAAiB,EAAE,CAA4C;QAC3F,MAAM,IAAI,GAAc,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;QACnL,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC/I,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,KAAK,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC;gBAAE,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACtD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,KAAK,aAAa,SAAS,UAAU,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;YACxK,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;YACpE,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;YACzC,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/C,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,0BAA0B,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAChH,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,uCAAuC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACrH,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,QAAqB;QACnD,MAAM,GAAG,GAAe,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QACrF,KAAK,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,MAAM,EAAE,CAAC;YAC/C,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,SAAS;YACrC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACzF,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,SAAS;gBACT,UAAU,EAAE,UAAU,CAAC,UAAU,IAAI,CAAC;gBACtC,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,YAAY;gBACrC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC,CAAC;QACN,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,SAAiB,EAAE,MAA6E;QAC7H,MAAM,GAAG,GAAgB,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,sBAAsB,CAAC,MAAM,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QACnG,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAKD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAUxC;IACC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,EAAE,UAAU,EAAE,IAAI,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,gBAAgB,CAAC,CAAC,EAAE,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;QACvE,IAAI,CAAC,EAAE,IAAI,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YAClD,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,MAAM,CAAC;oBACjB,YAAY,EAAE,KAAK,CAAC,YAAY;oBAChC,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,QAAQ,EAAE,CAAC,CAAC,IAAI;oBAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;oBAC/B,KAAK,EAAE,kBAAkB,KAAK,GAAG;iBAClC,CAAC,CAAC;gBACH,QAAQ,EAAE,CAAC;gBACX,SAAS;YACX,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,sEAAsE,EAAE,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3J,CAAC;QACH,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CAAC,qBAAqB,KAAK,2BAA2B,KAAK,CAAC,MAAM,YAAY,CAAC,CAAC;QAClG,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/backend/backend/src/services/apps/app-comment-room.service.d.ts

@@ -0,0 +1,156 @@
+/**
+ * App comments in the room that owns the app (crewly-services apps/SPEC.md
+ * §15). An app owned by a team or a Crewly channel gets its owner's comments
+ * where that team / channel talks, so every member sees them and the room's
+ * rules decide who picks one up:
+ *
+ * - Each comment thread is ONE thread in the room (the chat-v2 huddle) and,
+ *   when the room has a Slack channel, ONE Slack thread there (posted by a
+ *   member's bot). The link is stored with the Slack mirror's links
+ *   ({@link AppCommentsSlackService}), so the owner's reply in that Slack
+ *   thread is relayed back to the app — and, not being consumed, reaches the
+ *   room through the normal Slack routing.
+ * - The comment is written into the room as the owner's message
+ *   (`metadata.source: 'app-comment'`) and dispatched with the room rules:
+ *   an @mention in the comment wakes that member; otherwise the members awake
+ *   here read it and decide, and when nobody is awake the room's lead is
+ *   woken.
+ * - The owner's replies written in the app, and reopen, go into the same
+ *   thread (and its Slack thread). A reply the owner wrote in Slack is
+ *   already in the room: Cloud's `via: 'slack'` copy is skipped.
+ * - An agent's reply in the room thread (reply-channel) is added to the
+ *   app's comment as that agent's reply; an agent's reply or resolve made
+ *   with app-comments is written into the room thread as that agent, which
+ *   the room's Slack mirror posts as the agent's bot.
+ *
+ * Harness text is English; the comment text is the owner's words.
+ *
+ * @module services/apps/app-comment-room.service
+ */
+import type { ChatChannelDTO, ChatMessageDTO } from '../chat-v2/types.js';
+import type { RecordTurnInput } from '../chat-v2/chat-v2.service.js';
+import type { DispatchMessageOptions } from '../chat-v2/chat-v2.dispatcher.service.js';
+import { type AppChange } from './app-wake-message.js';
+import type { AppCommentsSlackService, CommentRoomRef } from './app-comments-slack.service.js';
+import { type SlackAudioUpload, type VoiceFiles } from './app-comment-audio.service.js';
+/** Where a room-owned comment goes on this machine. */
+export interface ResolvedRoom {
+    /** chat-v2 huddle id of the room */
+    chatChannelId: string;
+    /** Readable name (`#daily-brief`, `Dev team`) */
+    label: string;
+    /** The room's Slack channel, when it has one and Slack is connected */
+    slackChannelId: string | null;
+    /** Member agent sessions */
+    members: string[];
+}
+/** A room-owned batch of the owner's comment changes. */
+export interface RoomDelivery {
+    appId: string;
+    appName: string;
+    room: CommentRoomRef;
+    comments: AppChange[];
+    /** Voice comment recordings downloaded for this batch, by blob id (SPEC §16) */
+    voiceFiles?: VoiceFiles;
+}
+/** The chat-v2 slice used here. */
+export interface RoomChatApi {
+    recordTurn(input: RecordTurnInput): {
+        message: ChatMessageDTO;
+    };
+    getChannelForBridge(channelId: string): ChatChannelDTO | null;
+}
+/** Collaborators (all injectable). */
+export interface AppCommentRoomDeps {
+    /** Find the room on this machine (null: it is gone) */
+    resolveRoom: (room: CommentRoomRef) => Promise<ResolvedRoom | null>;
+    chat: () => RoomChatApi | null;
+    /** The chat-v2 dispatcher's `dispatchMessage` (null before it is wired) */
+    dispatch: () => ((channel: ChatChannelDTO, message: ChatMessageDTO, options?: DispatchMessageOptions) => Promise<unknown>) | null;
+    /** Whether an agent's session runs now (who is awake in the room) */
+    isRunning: (session: string) => boolean;
+    /** Upload a voice comment recording into the room's Slack thread as an agent's bot (SPEC §16) */
+    slackUploadAudio?: SlackAudioUpload;
+    /** Post into Slack as an agent's bot */
+    slackPost?: (req: {
+        agentSession: string;
+        target: string;
+        text: string;
+        threadTs?: string;
+    }) => Promise<{
+        channelId: string;
+        messageTs: string;
+    }>;
+    /** The link store shared with the Slack mirror */
+    links: Pick<AppCommentsSlackService, 'load' | 'linkOf' | 'saveLink' | 'noteReply' | 'linkOfChatRoot'>;
+    /** The agent that publishes an app here (preferred poster in Slack) */
+    publisherOf?: (appId: string) => Promise<string | null>;
+    /** This instance's Cloud id (to tell its mentions from another machine's) */
+    instanceId?: () => Promise<string | null>;
+    /** Add an agent's room reply to the app comment, as that agent */
+    relayAgentReply?: (appId: string, commentId: string, agentSession: string, text: string) => Promise<void>;
+    /** Agent skills root, for the command named in the room message */
+    skillsPath?: string;
+    /** Where the app opens */
+    appUrl?: (appId: string) => string;
+    /** Off switch for the Slack side (`CREWLY_APP_COMMENTS_SLACK=off`) */
+    slackOff?: () => boolean;
+    log?: (level: 'info' | 'warn', msg: string, meta?: Record<string, unknown>) => void;
+}
+/** Posts room-owned app comments into their room and relays the room's answers back. */
+export declare class AppCommentRoomService {
+    private readonly deps;
+    constructor(deps: AppCommentRoomDeps);
+    private log;
+    private url;
+    /**
+     * Post a batch of the owner's comment changes into the owning room.
+     *
+     * @param input - App, room and comment changes (oldest first)
+     * @returns True when every change was posted (false: retry the batch later)
+     */
+    deliver(input: RoomDelivery): Promise<boolean>;
+    /** The change's voice recordings into the room's Slack thread (upload, else a link line). Never throws. */
+    private voiceToSlack;
+    /** Which member's bot posts in Slack: the publisher when it is in the room, else the first member. */
+    private poster;
+    /**
+     * Members this change @mentions on this machine (they are addressed in the room).
+     *
+     * @param change - Comment change
+     * @param room - The room
+     * @returns Member sessions
+     */
+    private addressed;
+    private openThread;
+    private postInThread;
+    /**
+     * Dispatch with the room rules: @mentioned members must answer; otherwise
+     * the members awake here read it and decide, and with nobody awake the
+     * room's lead is woken (the dispatcher's no-presence rule).
+     */
+    private dispatch;
+    /**
+     * An agent replied with app-comments: write it into the room thread as that
+     * agent (the room's Slack mirror posts it as the agent's bot).
+     *
+     * @returns True when the comment has a room thread (handled here)
+     */
+    agentReplied(appId: string, commentId: string, agent: string, text: string): Promise<boolean>;
+    /**
+     * An agent resolved / reopened with app-comments: one line in the room thread.
+     *
+     * @returns True when the comment has a room thread
+     */
+    statusChanged(appId: string, commentId: string, agent: string, action: 'resolve' | 'reopen'): Promise<boolean>;
+    private agentRow;
+    /**
+     * A chat-v2 row was written: an agent's reply in a room-owned comment
+     * thread (not one written here) is added to the app's comment as that agent.
+     *
+     * @param dto - The row
+     * @returns True when it was relayed
+     */
+    onChatMessage(dto: ChatMessageDTO): Promise<boolean>;
+}
+//# sourceMappingURL=app-comment-room.service.d.ts.map

package/dist/backend/backend/src/services/apps/app-comment-room.service.d.ts.map

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