crewly 1.20.306 → 1.20.308

package/dist/backend/backend/src/services/board/canvas/canvas-transcript.tail.js

@@ -0,0 +1,385 @@
+/**
+ * Transcript tail for the canvas (crewly#1247 v2): the agent's own short text
+ * lines (and, for Codex, its tool calls) from the runtime's own transcript.
+ *
+ * - Claude Code: `<claude home>/projects/<cwd>/<session id>.jsonl` (located the
+ *   way the turn-state fallback does). Only `assistant` `text` blocks become
+ *   steps, reduced by {@link shortAgentLine}; a `tool_result`'s `is_error` flag
+ *   marks its step failed. Tool inputs, tool OUTPUTS, thinking and user
+ *   messages are never read into anything.
+ * - Codex: `<codex home>/sessions/.../rollout-*-<conversation id>.jsonl`.
+ *   Assistant `output_text` becomes text steps; shell / exec / apply_patch
+ *   calls become command / edit steps (reduced to executable + subcommand /
+ *   file name), paired with their output by call id for the duration. Output
+ *   bodies are not read.
+ *
+ * Incremental: a byte cursor per file, only whole new lines, at most
+ * {@link CANVAS_CONSTANTS.TAIL_MAX_READ_BYTES} per pass; lines that cannot be
+ * a text / error line are skipped by substring before any JSON.parse (tool
+ * results are the bulk of a transcript). Nothing is logged or stored beyond
+ * the redacted step.
+ *
+ * @module services/board/canvas/canvas-transcript.tail
+ */
+import { createHash } from 'crypto';
+import { promises as fs } from 'fs';
+import { CANVAS_CONSTANTS } from '../../../constants.js';
+import { relativePath } from '../board-redact.js';
+import { shortAgentLine } from './canvas-redact.js';
+import { stepOfTool } from './canvas-step.normalizer.js';
+const C = CANVAS_CONSTANTS;
+const toMs = (v, fallback) => {
+    const t = typeof v === 'string' ? Date.parse(v) : NaN;
+    return Number.isFinite(t) ? t : fallback;
+};
+/**
+ * Items from whole lines of a Claude Code transcript.
+ *
+ * @param text - Whole JSONL lines
+ * @param opts - Secrets to mask, oldest text to keep
+ * @param now - Fallback time for an entry with no timestamp
+ * @returns Items in file order
+ */
+export function parseClaudeTail(text, opts = {}, now = Date.now()) {
+    const out = [];
+    for (const line of text.split('\n')) {
+        if (line.length < 20)
+            continue;
+        const isAssistantText = line.includes('"type":"assistant"') && line.includes('"type":"text"');
+        const isError = line.includes('"is_error":true') && line.includes('"tool_result"');
+        if (!isAssistantText && !isError)
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        // A subagent's chatter is not the agent's; meta / API-error entries are not its words
+        if (entry.isSidechain === true || entry.isMeta === true || entry.isApiErrorMessage === true)
+            continue;
+        const message = entry.message;
+        const content = message?.content;
+        if (!Array.isArray(content))
+            continue;
+        const at = toMs(entry.timestamp, now);
+        if (entry.type === 'assistant') {
+            const uuid = typeof entry.uuid === 'string' ? entry.uuid : `${at}`;
+            content.forEach((block, i) => {
+                const b = block;
+                if (b?.type !== 'text')
+                    return;
+                if (opts.minAt !== undefined && at < opts.minAt)
+                    return;
+                const t = shortAgentLine(b.text, opts.secrets ?? []);
+                if (t)
+                    out.push({ kind: 'text', id: `${uuid}:${i}`, at, text: t });
+            });
+        }
+        else if (entry.type === 'user') {
+            for (const block of content) {
+                const b = block;
+                // Only the flag and the id are read; the result's content never is
+                if (b?.type === 'tool_result' && b.is_error === true && typeof b.tool_use_id === 'string' && /^[A-Za-z0-9_-]{1,128}$/.test(b.tool_use_id)) {
+                    out.push({ kind: 'tool_error', toolUseId: b.tool_use_id, at });
+                }
+            }
+        }
+    }
+    return out;
+}
+/** The shell command a Codex call runs, from its (JSON) arguments or its JS wrapper. */
+function codexCommand(name, raw) {
+    if (typeof raw !== 'string' || raw.length > 20_000)
+        return null;
+    if (name === 'exec') {
+        // The code-mode wrapper: `tools.exec_command({cmd:"..."})`
+        const m = /\bcmd\s*:\s*("(?:[^"\\]|\\.)*")/.exec(raw);
+        if (!m)
+            return null;
+        try {
+            return JSON.parse(m[1]);
+        }
+        catch {
+            return null;
+        }
+    }
+    try {
+        const args = JSON.parse(raw);
+        const c = args.command ?? args.cmd;
+        if (typeof c === 'string')
+            return c;
+        if (Array.isArray(c) && c.every((x) => typeof x === 'string')) {
+            const words = c;
+            // ["bash","-lc","git status"] runs the last word
+            return /^(?:ba|z|da)?sh$/.test(words[0] ?? '') && words.length >= 3 ? words[words.length - 1] : words.join(' ');
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+const PATCH_FILE = /^\*\*\* (?:Update|Add|Delete) File: (.+)$/m;
+/**
+ * Items from whole lines of a Codex rollout.
+ *
+ * @param text - Whole JSONL lines
+ * @param opts - Secrets to mask, project roots, oldest text to keep
+ * @param now - Fallback time for an entry with no timestamp
+ * @returns Items in file order
+ */
+export function parseCodexTail(text, opts = {}, now = Date.now()) {
+    const out = [];
+    const textId = (t) => `cx-${createHash('sha1').update(t).digest('hex').slice(0, 14)}`;
+    for (const line of text.split('\n')) {
+        if (line.length < 20)
+            continue;
+        const interesting = line.includes('"output_text"') || line.includes('"agent_message"') || line.includes('"function_call') || line.includes('"custom_tool_call');
+        if (!interesting)
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const p = entry.payload;
+        if (!p || typeof p !== 'object')
+            continue;
+        const at = toMs(entry.timestamp, now);
+        if (entry.type === 'event_msg' && p.type === 'agent_message' && typeof p.message === 'string') {
+            if (opts.minAt !== undefined && at < opts.minAt)
+                continue;
+            const t = shortAgentLine(p.message, opts.secrets ?? []);
+            if (t)
+                out.push({ kind: 'text', id: textId(t), at, text: t });
+            continue;
+        }
+        if (entry.type !== 'response_item')
+            continue;
+        if (p.type === 'message' && p.role === 'assistant' && Array.isArray(p.content)) {
+            if (opts.minAt !== undefined && at < opts.minAt)
+                continue;
+            for (const block of p.content) {
+                if (block?.type !== 'output_text')
+                    continue;
+                const t = shortAgentLine(block.text, opts.secrets ?? []);
+                if (t)
+                    out.push({ kind: 'text', id: textId(t), at, text: t });
+            }
+            continue;
+        }
+        const callId = typeof p.call_id === 'string' && /^[A-Za-z0-9_-]{1,128}$/.test(p.call_id) ? p.call_id : null;
+        if (!callId)
+            continue;
+        if (p.type === 'function_call' || p.type === 'custom_tool_call' || p.type === 'local_shell_call') {
+            if (opts.minAt !== undefined && at < opts.minAt)
+                continue;
+            const name = typeof p.name === 'string' ? p.name : '';
+            if (name === 'apply_patch') {
+                const file = PATCH_FILE.exec(typeof p.input === 'string' ? p.input : typeof p.arguments === 'string' ? p.arguments : '')?.[1]?.trim();
+                const shape = stepOfTool('Edit', file ? { filePath: file } : {}, { roots: opts.roots ?? [] });
+                out.push({ kind: 'step_start', id: callId, at, shape });
+                continue;
+            }
+            const command = codexCommand(name, name === 'exec' ? p.input : p.arguments);
+            if (command)
+                out.push({ kind: 'step_start', id: callId, at, shape: stepOfTool('Bash', { command }, { roots: opts.roots ?? [] }) });
+            else if (name && name !== 'exec')
+                out.push({ kind: 'step_start', id: callId, at, shape: stepOfTool(name, {}, { roots: opts.roots ?? [] }) });
+        }
+        else if (p.type === 'function_call_output' || p.type === 'custom_tool_call_output') {
+            out.push({ kind: 'step_end', id: callId, at });
+        }
+    }
+    return out;
+}
+/**
+ * Follows the transcripts of the agents and feeds the step stream.
+ */
+export class TranscriptTailService {
+    deps;
+    cursors = new Map();
+    located = new Map();
+    timer = null;
+    running = false;
+    started = false;
+    now;
+    setTimer;
+    clearTimer;
+    constructor(deps) {
+        this.deps = deps;
+        this.now = deps.now ?? Date.now;
+        this.setTimer =
+            deps.setTimeout ??
+                ((fn, ms) => {
+                    const t = setTimeout(fn, ms);
+                    t.unref?.();
+                    return t;
+                });
+        this.clearTimer = deps.clearTimeout ?? ((h) => clearTimeout(h));
+    }
+    /** Start polling. Idempotent. */
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.schedule();
+    }
+    /** Stop polling. */
+    stop() {
+        this.started = false;
+        if (this.timer)
+            this.clearTimer(this.timer);
+        this.timer = null;
+    }
+    schedule() {
+        if (!this.started)
+            return;
+        const live = this.deps.isLive?.() ?? false;
+        this.timer = this.setTimer(() => {
+            this.timer = null;
+            void this.tick().finally(() => this.schedule());
+        }, live ? C.TAIL_LIVE_INTERVAL_MS : C.TAIL_IDLE_INTERVAL_MS);
+    }
+    /**
+     * One pass over every followed session. Never throws.
+     *
+     * @returns Items fed to the stream
+     */
+    async tick() {
+        if (this.running)
+            return 0;
+        this.running = true;
+        let fed = 0;
+        try {
+            const sessions = this.deps.sessions();
+            for (const session of sessions) {
+                try {
+                    fed += await this.follow(session);
+                }
+                catch {
+                    // one unreadable transcript must not stop the others
+                }
+            }
+            const known = new Set(sessions);
+            for (const key of [...this.cursors.keys()])
+                if (!known.has(key))
+                    this.cursors.delete(key);
+            for (const key of [...this.located.keys()])
+                if (!known.has(key))
+                    this.located.delete(key);
+        }
+        finally {
+            this.running = false;
+        }
+        return fed;
+    }
+    async target(session) {
+        const now = this.now();
+        const hit = this.located.get(session);
+        if (hit && now - hit.at < C.TAIL_LOCATE_TTL_MS)
+            return hit.target;
+        let target = null;
+        try {
+            target = await this.deps.locate(session);
+        }
+        catch {
+            target = null;
+        }
+        this.located.set(session, { at: now, target });
+        return target;
+    }
+    async follow(session) {
+        const target = await this.target(session);
+        if (!target) {
+            this.cursors.delete(session);
+            return 0;
+        }
+        let size;
+        try {
+            size = (await fs.stat(target.file)).size;
+        }
+        catch {
+            this.located.delete(session);
+            return 0;
+        }
+        let cursor = this.cursors.get(session);
+        if (!cursor || cursor.file !== target.file || size < cursor.offset) {
+            cursor = { file: target.file, kind: target.kind, offset: Math.max(0, size - C.TAIL_FIRST_READ_BYTES), fresh: true };
+            this.cursors.set(session, cursor);
+        }
+        if (size === cursor.offset)
+            return 0;
+        let from = cursor.offset;
+        if (size - from > C.TAIL_MAX_READ_BYTES)
+            from = size - C.TAIL_MAX_READ_BYTES;
+        const handle = await fs.open(target.file, 'r');
+        let buf;
+        try {
+            buf = Buffer.alloc(size - from);
+            await handle.read(buf, 0, buf.length, from);
+        }
+        finally {
+            await handle.close();
+        }
+        // Work in bytes: a multi-byte character cut at the end must not shift the cursor
+        const lastNl = buf.lastIndexOf(0x0a);
+        if (lastNl < 0)
+            return 0;
+        // A read that starts mid-file starts mid-line: skip to the first whole line
+        const startedMidFile = from > 0 && (from !== cursor.offset || cursor.fresh);
+        const firstNl = startedMidFile ? buf.indexOf(0x0a) : -1;
+        if (startedMidFile && firstNl >= lastNl) {
+            cursor.offset = from + lastNl + 1;
+            return 0;
+        }
+        const complete = buf.subarray(startedMidFile ? firstNl + 1 : 0, lastNl).toString('utf-8');
+        cursor.offset = from + lastNl + 1;
+        const now = this.now();
+        const opts = {
+            secrets: this.deps.secrets?.() ?? [],
+            roots: this.deps.roots?.(session) ?? [],
+            ...(cursor.fresh ? { minAt: now - C.TAIL_FIRST_MAX_AGE_MS } : {}),
+        };
+        cursor.fresh = false;
+        const items = cursor.kind === 'claude' ? parseClaudeTail(complete, opts, now) : parseCodexTail(complete, opts, now);
+        return this.feed(session, items, cursor.kind === 'codex');
+    }
+    feed(session, items, callsAreSteps) {
+        let fed = 0;
+        const steps = this.deps.steps;
+        // A flood of narration (first look, a long pass) keeps the newest lines
+        const texts = items.filter((i) => i.kind === 'text');
+        const keep = new Set(texts.slice(-10));
+        for (const item of items) {
+            switch (item.kind) {
+                case 'text':
+                    if (keep.has(item) && steps.text(session, item.id, item.at, item.text))
+                        fed += 1;
+                    break;
+                case 'tool_error':
+                    steps.markError(session, item.toolUseId, item.at);
+                    break;
+                case 'step_start':
+                    // Codex has no hooks: its calls are the steps
+                    if (callsAreSteps) {
+                        steps.start(session, item.shape, { id: item.id }, item.at);
+                        fed += 1;
+                    }
+                    break;
+                case 'step_end':
+                    if (callsAreSteps)
+                        steps.finish(session, item.id, 'done', item.at);
+                    break;
+            }
+        }
+        return fed;
+    }
+}
+/** Re-exported for the wiring: a path made relative to project roots. */
+export { relativePath };
+//# sourceMappingURL=canvas-transcript.tail.js.map

package/dist/backend/backend/src/services/board/canvas/canvas-transcript.tail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-transcript.tail.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/board/canvas/canvas-transcript.tail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAkB,MAAM,6BAA6B,CAAC;AAGzE,MAAM,CAAC,GAAG,gBAAgB,CAAC;AAiB3B,MAAM,IAAI,GAAG,CAAC,CAAU,EAAE,QAAgB,EAAU,EAAE;IACrD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACtD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC1C,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAAyB,EAAE,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAClG,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;YAAE,SAAS;QAC/B,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QAC9F,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QACnF,IAAI,CAAC,eAAe,IAAI,CAAC,OAAO;YAAE,SAAS;QAC3C,IAAI,KAA8B,CAAC;QACnC,IAAI,CAAC;YACJ,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACR,SAAS;QACV,CAAC;QACD,sFAAsF;QACtF,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,iBAAiB,KAAK,IAAI;YAAE,SAAS;QACtG,MAAM,OAAO,GAAG,KAAK,CAAC,OAA4C,CAAC;QACnE,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;YACnE,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;gBAC5B,MAAM,CAAC,GAAG,KAA0C,CAAC;gBACrD,IAAI,CAAC,EAAE,IAAI,KAAK,MAAM;oBAAE,OAAO;gBAC/B,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK;oBAAE,OAAO;gBACxD,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBACrD,IAAI,CAAC;oBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACpE,CAAC,CAAC,CAAC;QACJ,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAClC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,CAAC,GAAG,KAAqE,CAAC;gBAChF,mEAAmE;gBACnE,IAAI,CAAC,EAAE,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC3I,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;gBAChE,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,wFAAwF;AACxF,SAAS,YAAY,CAAC,IAAY,EAAE,GAAY;IAC/C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,MAAM;QAAE,OAAO,IAAI,CAAC;IAChE,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACrB,2DAA2D;QAC3D,MAAM,CAAC,GAAG,iCAAiC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACpB,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAW,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyC,CAAC;QACrE,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC;QACnC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;QACpC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,CAAa,CAAC;YAC5B,iDAAiD;YACjD,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjH,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,GAAG,4CAA4C,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAyB,EAAE,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IACjG,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACtG,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;YAAE,SAAS;QAC/B,MAAM,WAAW,GAChB,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;QAC7I,IAAI,CAAC,WAAW;YAAE,SAAS;QAC3B,IAAI,KAA+E,CAAC;QACpF,IAAI,CAAC;YACJ,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACR,SAAS;QACV,CAAC;QACD,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;QACxB,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,SAAS;QAC1C,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC/F,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK;gBAAE,SAAS;YAC1D,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACxD,IAAI,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9D,SAAS;QACV,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;YAAE,SAAS;QAC7C,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YAChF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK;gBAAE,SAAS;YAC1D,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,OAAmD,EAAE,CAAC;gBAC3E,IAAI,KAAK,EAAE,IAAI,KAAK,aAAa;oBAAE,SAAS;gBAC5C,MAAM,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBACzD,IAAI,CAAC;oBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,SAAS;QACV,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5G,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YAClG,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK;gBAAE,SAAS;YAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;gBACtI,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC9F,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBACxD,SAAS;YACV,CAAC;YACD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC5E,IAAI,OAAO;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;iBAC9H,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9I,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,sBAAsB,IAAI,CAAC,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;YACtF,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAChD,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAkCD;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAUJ;IATZ,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpC,OAAO,GAAG,IAAI,GAAG,EAAqD,CAAC;IAChF,KAAK,GAAyC,IAAI,CAAC;IACnD,OAAO,GAAG,KAAK,CAAC;IAChB,OAAO,GAAG,KAAK,CAAC;IACP,GAAG,CAAe;IAClB,QAAQ,CAAgE;IACxE,UAAU,CAA6C;IAExE,YAA6B,IAAwB;QAAxB,SAAI,GAAJ,IAAI,CAAoB;QACpD,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QAChC,IAAI,CAAC,QAAQ;YACZ,IAAI,CAAC,UAAU;gBACf,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;oBACX,MAAM,CAAC,GAAG,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC7B,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;oBACZ,OAAO,CAAC,CAAC;gBACV,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,iCAAiC;IACjC,KAAK;QACJ,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,QAAQ,EAAE,CAAC;IACjB,CAAC;IAED,oBAAoB;IACpB,IAAI;QACH,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACnB,CAAC;IAEO,QAAQ;QACf,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,KAAK,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;YAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IAC9D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI;QACT,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAChC,IAAI,CAAC;oBACJ,GAAG,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACnC,CAAC;gBAAC,MAAM,CAAC;oBACR,qDAAqD;gBACtD,CAAC;YACF,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;YAChC,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1F,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3F,CAAC;gBAAS,CAAC;YACV,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACtB,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,OAAe;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,kBAAkB;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC;QAClE,IAAI,MAAM,GAAsB,IAAI,CAAC;QACrC,IAAI,CAAC;YACJ,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACR,MAAM,GAAG,IAAI,CAAC;QACf,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,OAAe;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO,CAAC,CAAC;QACV,CAAC;QACD,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACJ,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO,CAAC,CAAC;QACV,CAAC;QACD,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YACpE,MAAM,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACpH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,IAAI,KAAK,MAAM,CAAC,MAAM;YAAE,OAAO,CAAC,CAAC;QACrC,IAAI,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;QACzB,IAAI,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,mBAAmB;YAAE,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,mBAAmB,CAAC;QAC7E,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/C,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACJ,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;YAChC,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7C,CAAC;gBAAS,CAAC;YACV,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;QACD,iFAAiF;QACjF,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC;QACzB,4EAA4E;QAC5E,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,IAAI,cAAc,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACzC,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC;YAClC,OAAO,CAAC,CAAC;QACV,CAAC;QACD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC1F,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,IAAI,GAAqB;YAC9B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE;YACpC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE;YACvC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAC;QACF,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QACpH,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAC3D,CAAC;IAEO,IAAI,CAAC,OAAe,EAAE,KAAiB,EAAE,aAAsB;QACtE,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QAC9B,wEAAwE;QACxE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;gBACnB,KAAK,MAAM;oBACV,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC;wBAAE,GAAG,IAAI,CAAC,CAAC;oBACjF,MAAM;gBACP,KAAK,YAAY;oBAChB,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;oBAClD,MAAM;gBACP,KAAK,YAAY;oBAChB,8CAA8C;oBAC9C,IAAI,aAAa,EAAE,CAAC;wBACnB,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;wBAC3D,GAAG,IAAI,CAAC,CAAC;oBACV,CAAC;oBACD,MAAM;gBACP,KAAK,UAAU;oBACd,IAAI,aAAa;wBAAE,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;oBACnE,MAAM;YACR,CAAC;QACF,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC;CACD;AAED,yEAAyE;AACzE,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/backend/backend/src/services/board/canvas/canvas-wiring.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Production pieces of the canvas that need the running machine (crewly#1247
+ * v2): where an agent's transcript is, how an owner stop is done, which
+ * secrets to mask. Kept out of `index.ts`; each takes its collaborators, so
+ * each is tested with fakes.
+ *
+ * @module services/board/canvas/canvas-wiring
+ */
+import { type SecretEnvValue } from '../../../utils/secret-env.js';
+import type { AgentCapabilities } from './canvas.types.js';
+import type { TailTarget } from './canvas-transcript.tail.js';
+/** What the session registry knows about an agent's runtime conversation. */
+export interface SessionMeta {
+    runtimeType?: string;
+    claudeSessionId?: string;
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+}
+/** Collaborators of {@link createTranscriptLocator}. */
+export interface TranscriptLocatorDeps {
+    meta: (session: string) => SessionMeta | undefined;
+    /** Claude Code homes to look in (the session's CLAUDE_CONFIG_DIR first) */
+    claudeHomes: (meta: SessionMeta) => string[];
+    findClaude: (args: {
+        sessionId: string;
+        cwd: string;
+        claudeHomes: readonly string[];
+    }) => string | null;
+    codexHome: () => string;
+    findCodex: (codexHome: string, conversationId: string) => Promise<string | null>;
+}
+/**
+ * Where an agent's transcript is: a Claude Code conversation file or a Codex
+ * rollout. Gemini and agy keep none the canvas can read.
+ *
+ * @param deps - Session registry and the runtimes' finders
+ * @returns Locator for {@link TranscriptTailService}
+ */
+export declare function createTranscriptLocator(deps: TranscriptLocatorDeps): (session: string) => Promise<TailTarget | null>;
+/** Secret values of the backend's environment, recomputed at most once a minute. */
+export declare function createSecretsProvider(env?: () => NodeJS.ProcessEnv, ttlMs?: number, now?: () => number): () => SecretEnvValue[];
+/** A team as the stop needs it. */
+export interface StopTeam {
+    id: string;
+    name: string;
+    members: Array<{
+        id: string;
+        name: string;
+        sessionName?: string;
+        agentId?: string;
+    }>;
+}
+/** Collaborators of {@link createStopAgent}. */
+export interface StopAgentDeps {
+    webPort: number;
+    teams: () => Promise<StopTeam[]>;
+    /** Credentials of the owner's own calls (relay credential + API token) */
+    headers: () => Record<string, string>;
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Stop an agent the way the dashboard does: `POST /api/teams/:teamId/members/:memberId/stop`
+ * on the local API, with the relay's owner credential.
+ *
+ * @param deps - Teams, port, credentials
+ * @returns Stop function
+ */
+export declare function createStopAgent(deps: StopAgentDeps): (session: string) => Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/** The remote-browser session of an agent, as far as capabilities need it. */
+export interface BrowserSessionLike {
+    id: string;
+    status: string;
+    lastActionAt: number;
+}
+/** Collaborators of {@link computeCapabilities}. */
+export interface CapabilityDeps {
+    browserSession: (session: string) => BrowserSessionLike | undefined;
+    terminalExists: (session: string) => boolean;
+}
+/**
+ * What the owner can do with an agent from the canvas.
+ *
+ * - browser: the agent's Chrome-extension session (the existing remote-browser
+ *   session id) while it is live. Headless Playwright runs inside the agent's
+ *   own runtime as an MCP child process the harness has no handle on, so no
+ *   `headless` browser is ever offered;
+ * - terminal: the agent has a live PTY session;
+ * - message: every agent (a sleeping one is woken by the message);
+ * - stop: every running agent except the orchestrator.
+ *
+ * @param session - Agent session
+ * @param info - Whether the agent is stopped, and the time
+ * @param deps - Browser sessions and the PTY backend
+ * @returns Capabilities
+ */
+export declare function computeCapabilities(session: string, info: {
+    stopped: boolean;
+    now: number;
+}, deps: CapabilityDeps): AgentCapabilities;
+//# sourceMappingURL=canvas-wiring.d.ts.map

package/dist/backend/backend/src/services/board/canvas/canvas-wiring.d.ts.map

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

package/dist/backend/backend/src/services/board/canvas/canvas-wiring.js

@@ -0,0 +1,124 @@
+/**
+ * Production pieces of the canvas that need the running machine (crewly#1247
+ * v2): where an agent's transcript is, how an owner stop is done, which
+ * secrets to mask. Kept out of `index.ts`; each takes its collaborators, so
+ * each is tested with fakes.
+ *
+ * @module services/board/canvas/canvas-wiring
+ */
+import { CANVAS_CONSTANTS, ORCHESTRATOR_SESSION_NAME, RUNTIME_TYPES } from '../../../constants.js';
+import { collectSecretEnvValues } from '../../../utils/secret-env.js';
+import { resolveMemberSessionName } from '../../../utils/member-session-name.utils.js';
+/**
+ * Where an agent's transcript is: a Claude Code conversation file or a Codex
+ * rollout. Gemini and agy keep none the canvas can read.
+ *
+ * @param deps - Session registry and the runtimes' finders
+ * @returns Locator for {@link TranscriptTailService}
+ */
+export function createTranscriptLocator(deps) {
+    return async (session) => {
+        const meta = deps.meta(session);
+        if (!meta?.claudeSessionId)
+            return null;
+        if (meta.runtimeType === RUNTIME_TYPES.CLAUDE_CODE) {
+            if (!meta.cwd)
+                return null;
+            const file = deps.findClaude({ sessionId: meta.claudeSessionId, cwd: meta.cwd, claudeHomes: deps.claudeHomes(meta) });
+            return file ? { kind: 'claude', file } : null;
+        }
+        if (meta.runtimeType === RUNTIME_TYPES.CODEX_CLI) {
+            const file = await deps.findCodex(deps.codexHome(), meta.claudeSessionId);
+            return file ? { kind: 'codex', file } : null;
+        }
+        return null;
+    };
+}
+/** Secret values of the backend's environment, recomputed at most once a minute. */
+export function createSecretsProvider(env = () => process.env, ttlMs = 60_000, now = Date.now) {
+    let cache = null;
+    return () => {
+        const t = now();
+        if (!cache || t - cache.at > ttlMs)
+            cache = { at: t, values: collectSecretEnvValues(env()) };
+        return cache.values;
+    };
+}
+/**
+ * Stop an agent the way the dashboard does: `POST /api/teams/:teamId/members/:memberId/stop`
+ * on the local API, with the relay's owner credential.
+ *
+ * @param deps - Teams, port, credentials
+ * @returns Stop function
+ */
+export function createStopAgent(deps) {
+    const doFetch = deps.fetchImpl ?? fetch;
+    return async (session) => {
+        const teams = await deps.teams();
+        for (const team of teams) {
+            for (const member of team.members) {
+                if (!member?.id)
+                    continue;
+                let name;
+                try {
+                    name = resolveMemberSessionName(team.name, member);
+                }
+                catch {
+                    continue;
+                }
+                if (name !== session)
+                    continue;
+                try {
+                    const res = await doFetch(`http://127.0.0.1:${deps.webPort}/api/teams/${encodeURIComponent(team.id)}/members/${encodeURIComponent(member.id)}/stop`, {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json', ...deps.headers() },
+                        body: '{}',
+                    });
+                    if (res.ok)
+                        return { ok: true };
+                    const body = (await res.json().catch(() => null));
+                    return { ok: false, error: typeof body?.error === 'string' ? body.error : `HTTP ${res.status}` };
+                }
+                catch (error) {
+                    return { ok: false, error: error instanceof Error ? error.message : String(error) };
+                }
+            }
+        }
+        return { ok: false, error: 'No such team member' };
+    };
+}
+/**
+ * What the owner can do with an agent from the canvas.
+ *
+ * - browser: the agent's Chrome-extension session (the existing remote-browser
+ *   session id) while it is live. Headless Playwright runs inside the agent's
+ *   own runtime as an MCP child process the harness has no handle on, so no
+ *   `headless` browser is ever offered;
+ * - terminal: the agent has a live PTY session;
+ * - message: every agent (a sleeping one is woken by the message);
+ * - stop: every running agent except the orchestrator.
+ *
+ * @param session - Agent session
+ * @param info - Whether the agent is stopped, and the time
+ * @param deps - Browser sessions and the PTY backend
+ * @returns Capabilities
+ */
+export function computeCapabilities(session, info, deps) {
+    const browser = deps.browserSession(session);
+    const browserLive = !!browser && browser.status !== 'done' && browser.status !== 'stopped' && info.now - browser.lastActionAt <= CANVAS_CONSTANTS.BROWSER_ACTIVE_MS;
+    let hasTerminal = false;
+    try {
+        hasTerminal = !info.stopped && deps.terminalExists(session);
+    }
+    catch {
+        hasTerminal = false;
+    }
+    return {
+        hasBrowser: browserLive,
+        ...(browserLive && browser ? { browserKind: 'chrome', browserSessionId: browser.id } : {}),
+        hasTerminal,
+        canMessage: true,
+        canStop: !info.stopped && session !== ORCHESTRATOR_SESSION_NAME,
+    };
+}
+//# sourceMappingURL=canvas-wiring.js.map

package/dist/backend/backend/src/services/board/canvas/canvas-wiring.js.map

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