crewly 1.20.308 → 1.20.310

package/dist/backend/backend/src/services/board/board-interaction-hooks.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Where the board learns that one agent talked to another (canvas
+ * `messaging` links): a middleware on the terminal-write API (what the
+ * `send-message` skill calls) and a chat-message listener for agent messages
+ * that @mention another agent (rooms, DMs, Slack mirrored into chat).
+ * Only sender, receiver and time are kept.
+ *
+ * @module services/board/board-interaction-hooks
+ */
+import type { NextFunction, Request, Response } from 'express';
+import { type AgentInteractionRecorder } from './board-interactions.js';
+/**
+ * Middleware (mounted on `/api`): an agent's successful write to another
+ * agent's terminal is a message.
+ *
+ * @param recorder - Where to record (default: process-wide)
+ * @returns Express middleware; never blocks or throws
+ */
+export declare function recordTerminalWrites(recorder?: AgentInteractionRecorder): (req: Request, res: Response, next: NextFunction) => void;
+/** The parts of a chat message the board reads. */
+export interface MentionMessage {
+    senderType: string;
+    senderId: string;
+    mentions?: string[];
+}
+/**
+ * An agent's chat message that @mentions other agents.
+ *
+ * @param message - Chat message
+ * @param resolve - Member id or session -> session (undefined for a team or the owner)
+ * @param recorder - Where to record
+ */
+export declare function recordChatMentions(message: MentionMessage, resolve: (idOrSession: string) => string | undefined, recorder?: AgentInteractionRecorder): void;
+//# sourceMappingURL=board-interaction-hooks.d.ts.map

package/dist/backend/backend/src/services/board/board-interaction-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-interaction-hooks.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/board/board-interaction-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D,OAAO,EAAwB,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAI9F;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,wBAAiD,IACvF,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,KAAG,IAAI,CAmB9D;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EAAE,QAAQ,GAAE,wBAAiD,GAAG,IAAI,CAOnL"}

package/dist/backend/backend/src/services/board/board-interaction-hooks.js

@@ -0,0 +1,60 @@
+/**
+ * Where the board learns that one agent talked to another (canvas
+ * `messaging` links): a middleware on the terminal-write API (what the
+ * `send-message` skill calls) and a chat-message listener for agent messages
+ * that @mention another agent (rooms, DMs, Slack mirrored into chat).
+ * Only sender, receiver and time are kept.
+ *
+ * @module services/board/board-interaction-hooks
+ */
+import { readAgentSessionHeader } from '../../utils/agent-caller.utils.js';
+import { getAgentInteractions } from './board-interactions.js';
+const WRITE_PATH = /^\/terminal\/([^/]+)\/write\/?$/;
+/**
+ * Middleware (mounted on `/api`): an agent's successful write to another
+ * agent's terminal is a message.
+ *
+ * @param recorder - Where to record (default: process-wide)
+ * @returns Express middleware; never blocks or throws
+ */
+export function recordTerminalWrites(recorder = getAgentInteractions()) {
+    return (req, res, next) => {
+        try {
+            if (req.method === 'POST') {
+                const match = WRITE_PATH.exec(req.path);
+                if (match) {
+                    const from = readAgentSessionHeader(req);
+                    const to = decodeURIComponent(match[1]);
+                    if (from && to && from !== to) {
+                        res.once('finish', () => {
+                            if (res.statusCode >= 200 && res.statusCode < 300)
+                                recorder.record(from, to);
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            /* observing never breaks the request */
+        }
+        next();
+    };
+}
+/**
+ * An agent's chat message that @mentions other agents.
+ *
+ * @param message - Chat message
+ * @param resolve - Member id or session -> session (undefined for a team or the owner)
+ * @param recorder - Where to record
+ */
+export function recordChatMentions(message, resolve, recorder = getAgentInteractions()) {
+    if (message.senderType !== 'agent' || !message.mentions || message.mentions.length === 0)
+        return;
+    const from = resolve(message.senderId) ?? message.senderId;
+    for (const m of message.mentions.slice(0, 10)) {
+        const to = resolve(m);
+        if (to && to !== from)
+            recorder.record(from, to);
+    }
+}
+//# sourceMappingURL=board-interaction-hooks.js.map

package/dist/backend/backend/src/services/board/board-interaction-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-interaction-hooks.js","sourceRoot":"","sources":["../../../../../../backend/src/services/board/board-interaction-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAiC,MAAM,yBAAyB,CAAC;AAE9F,MAAM,UAAU,GAAG,iCAAiC,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAqC,oBAAoB,EAAE;IAC/F,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAQ,EAAE;QAChE,IAAI,CAAC;YACJ,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACxC,IAAI,KAAK,EAAE,CAAC;oBACX,MAAM,IAAI,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;oBACzC,MAAM,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;oBACxC,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;wBAC/B,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;4BACvB,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG;gCAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBAC9E,CAAC,CAAC,CAAC;oBACJ,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,wCAAwC;QACzC,CAAC;QACD,IAAI,EAAE,CAAC;IACR,CAAC,CAAC;AACH,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAuB,EAAE,OAAoD,EAAE,WAAqC,oBAAoB,EAAE;IAC5K,IAAI,OAAO,CAAC,UAAU,KAAK,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACjG,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC;IAC3D,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC/C,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI;YAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;AACF,CAAC"}

package/dist/backend/backend/src/services/board/board-interactions.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Who messaged whom (crewly#1247 canvas links): a small in-memory record of
+ * agent-to-agent messages, kept for the last two hours. The board turns it into
+ * `messaging` links. Contents are never kept, only sender, receiver and time.
+ *
+ * @module services/board/board-interactions
+ */
+/** One sender -> receiver pair as the board reads it. */
+export interface InteractionPair {
+    from: string;
+    to: string;
+    /** Messages in the window */
+    count: number;
+    firstAt: number;
+    lastAt: number;
+}
+/** Records agent-to-agent messages. */
+export declare class AgentInteractionRecorder {
+    private readonly pairs;
+    private readonly listeners;
+    /**
+     * Note a message.
+     *
+     * @param from - Sender session (`<session>@<instanceId>` when on another machine)
+     * @param to - Receiver session
+     * @param now - Clock (tests)
+     */
+    record(from: string, to: string, now?: number): void;
+    /**
+     * Be told about each message (the push marks the sender dirty).
+     *
+     * @param listener - Called with sender and receiver
+     * @returns Unsubscribe
+     */
+    onRecord(listener: (from: string, to: string) => void): () => void;
+    /**
+     * Pairs with a message in the window; older entries are forgotten.
+     *
+     * @param now - Clock
+     * @returns Pairs
+     */
+    pairsNow(now?: number): InteractionPair[];
+    /** Forget everything (tests). */
+    clear(): void;
+}
+/**
+ * The process-wide recorder.
+ *
+ * @returns The recorder
+ */
+export declare function getAgentInteractions(): AgentInteractionRecorder;
+/** Drop the process-wide recorder (tests). */
+export declare function resetAgentInteractions(): void;
+//# sourceMappingURL=board-interactions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"board-interactions.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/board/board-interactions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,uCAAuC;AACvC,qBAAa,wBAAwB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoE;IAC1F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiD;IAE3E;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI;IAmBhE;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAKlE;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,GAAE,MAAmB,GAAG,eAAe,EAAE;IAerD,iCAAiC;IACjC,KAAK,IAAI,IAAI;CAGb;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,wBAAwB,CAG/D;AAED,8CAA8C;AAC9C,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/backend/backend/src/services/board/board-interactions.js

@@ -0,0 +1,92 @@
+/**
+ * Who messaged whom (crewly#1247 canvas links): a small in-memory record of
+ * agent-to-agent messages, kept for the last two hours. The board turns it into
+ * `messaging` links. Contents are never kept, only sender, receiver and time.
+ *
+ * @module services/board/board-interactions
+ */
+import { BOARD_CONSTANTS } from '../../constants.js';
+const C = BOARD_CONSTANTS;
+/** Records agent-to-agent messages. */
+export class AgentInteractionRecorder {
+    pairs = new Map();
+    listeners = new Set();
+    /**
+     * Note a message.
+     *
+     * @param from - Sender session (`<session>@<instanceId>` when on another machine)
+     * @param to - Receiver session
+     * @param now - Clock (tests)
+     */
+    record(from, to, now = Date.now()) {
+        if (!from || !to || from === to)
+            return;
+        const key = `${from}\u0000${to}`;
+        let pair = this.pairs.get(key);
+        if (!pair) {
+            pair = { from, to, times: [] };
+            this.pairs.set(key, pair);
+        }
+        pair.times.push(now);
+        if (pair.times.length > C.LINK_MESSAGING_MAX_PER_PAIR)
+            pair.times.splice(0, pair.times.length - C.LINK_MESSAGING_MAX_PER_PAIR);
+        for (const l of this.listeners) {
+            try {
+                l(from, to);
+            }
+            catch {
+                /* a listener never breaks the sender */
+            }
+        }
+    }
+    /**
+     * Be told about each message (the push marks the sender dirty).
+     *
+     * @param listener - Called with sender and receiver
+     * @returns Unsubscribe
+     */
+    onRecord(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Pairs with a message in the window; older entries are forgotten.
+     *
+     * @param now - Clock
+     * @returns Pairs
+     */
+    pairsNow(now = Date.now()) {
+        const out = [];
+        const cutoff = now - C.LINK_MESSAGING_WINDOW_MS;
+        for (const [key, pair] of this.pairs) {
+            const first = pair.times.findIndex((t) => t >= cutoff);
+            if (first < 0) {
+                this.pairs.delete(key);
+                continue;
+            }
+            if (first > 0)
+                pair.times.splice(0, first);
+            out.push({ from: pair.from, to: pair.to, count: pair.times.length, firstAt: pair.times[0], lastAt: pair.times[pair.times.length - 1] });
+        }
+        return out;
+    }
+    /** Forget everything (tests). */
+    clear() {
+        this.pairs.clear();
+    }
+}
+let instance = null;
+/**
+ * The process-wide recorder.
+ *
+ * @returns The recorder
+ */
+export function getAgentInteractions() {
+    instance ??= new AgentInteractionRecorder();
+    return instance;
+}
+/** Drop the process-wide recorder (tests). */
+export function resetAgentInteractions() {
+    instance = null;
+}
+//# sourceMappingURL=board-interactions.js.map

package/dist/backend/backend/src/services/board/board-interactions.js.map

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

package/dist/backend/backend/src/services/board/board-links.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Canvas links (crewly#1247, CANVAS-V2-CONTRACT.md): who reports to whom and
+ * who works with whom. Pure functions of what the board already read, so a
+ * delta never touches the disk.
+ *
+ * @module services/board/board-links
+ */
+import type { InteractionPair } from './board-interactions.js';
+import type { BoardTeamInfo, BoardTicket, BoardWorkItem } from './board-snapshot.builder.js';
+import { type BoardLink } from './board.types.js';
+/** What the structural links read. */
+export interface StructuralLinkInput {
+    now: number;
+    orchestrator: string;
+    teams: BoardTeamInfo[];
+    workItems: BoardWorkItem[];
+    tickets: BoardTicket[];
+    /** Each agent's current task (a WorkItem id or a ticket id) */
+    tasks: Map<string, {
+        id?: string;
+        title: string;
+        since: string;
+    }>;
+    /** Sessions that are stopped (their reporting line is not active) */
+    stopped: ReadonlySet<string>;
+}
+/**
+ * Reporting, delegation and shared-ticket links.
+ *
+ * @param input - Teams, work and tickets
+ * @returns Links, one per identity
+ */
+export declare function structuralLinks(input: StructuralLinkInput): BoardLink[];
+/**
+ * Messaging links from the recorder.
+ *
+ * @param pairs - Sender/receiver pairs in the last two hours
+ * @param now - Clock
+ * @param isKnown - Whether an endpoint is an agent of this machine or qualified
+ * @returns Links
+ */
+export declare function messagingLinks(pairs: readonly InteractionPair[], now: number, isKnown: (session: string) => boolean): BoardLink[];
+/**
+ * Cap a link list: messaging, then same_task, are dropped first.
+ *
+ * @param links - Links
+ * @param max - Most links to keep
+ * @returns At most `max` links
+ */
+export declare function capLinks(links: BoardLink[], max?: number): BoardLink[];
+//# sourceMappingURL=board-links.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"board-links.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/board/board-links.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC7F,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAkB3D,sCAAsC;AACtC,MAAM,WAAW,mBAAmB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,+DAA+D;IAC/D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,qEAAqE;IACrE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG,SAAS,EAAE,CA6FvE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,EAAE,CAOjI;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,GAAG,GAAE,MAAoB,GAAG,SAAS,EAAE,CAMnF"}

package/dist/backend/backend/src/services/board/board-links.js

@@ -0,0 +1,168 @@
+/**
+ * Canvas links (crewly#1247, CANVAS-V2-CONTRACT.md): who reports to whom and
+ * who works with whom. Pure functions of what the board already read, so a
+ * delta never touches the disk.
+ *
+ * @module services/board/board-links
+ */
+import { BOARD_CONSTANTS } from '../../constants.js';
+import { scrubText } from './board-redact.js';
+import { linkKey } from './board.types.js';
+const C = BOARD_CONSTANTS;
+/** Work states that no longer count as open. */
+const CLOSED = new Set(['done', 'verified', 'cancelled', 'rejected', 'failed']);
+/** Closed states that still show as finished delegations. */
+const FINISHED_OK = new Set(['done', 'verified']);
+const iso = (ms) => new Date(ms).toISOString();
+const msOf = (s) => (s ? Date.parse(s) : NaN);
+/** The label of a link: scrubbed, short. */
+function label(text) {
+    const t = text ? scrubText(text, C.LINK_LABEL_MAX) : '';
+    return t ? t.slice(0, C.LINK_LABEL_MAX) : undefined;
+}
+/**
+ * Reporting, delegation and shared-ticket links.
+ *
+ * @param input - Teams, work and tickets
+ * @returns Links, one per identity
+ */
+export function structuralLinks(input) {
+    const { now, orchestrator, teams, workItems, tickets, tasks, stopped } = input;
+    const out = new Map();
+    const put = (l) => {
+        if (l.from === l.to)
+            return;
+        out.set(linkKey(l), l);
+    };
+    const known = new Set([orchestrator]);
+    const teamOf = new Map();
+    for (const t of teams)
+        for (const m of t.members) {
+            known.add(m.session);
+            teamOf.set(m.session, t);
+        }
+    const isKnown = (s) => known.has(s) || s.includes('@');
+    // --- reports_to: members -> their leaders, leaders -> the orchestrator
+    for (const t of teams) {
+        if (t.teamId === 'orchestrator')
+            continue;
+        const leaders = (t.leaders ?? []).filter((s) => t.members.some((m) => m.session === s));
+        const since = t.createdAt ?? iso(now);
+        for (const m of t.members) {
+            if (leaders.includes(m.session)) {
+                put({ from: m.session, to: orchestrator, kind: 'reports_to', active: !stopped.has(m.session), since });
+            }
+            else {
+                for (const lead of leaders)
+                    put({ from: m.session, to: lead, kind: 'reports_to', active: !stopped.has(m.session), since });
+            }
+        }
+    }
+    // --- delegated: delegator -> worker, per pair
+    const windowStart = now - C.LINK_DELEGATION_WINDOW_MS;
+    const delegations = new Map();
+    for (const w of workItems) {
+        const to = w.target;
+        if (!to || !isKnown(to))
+            continue;
+        let from = w.delegatedBy;
+        if (!from) {
+            if (w.owner === 'orchestrator')
+                from = orchestrator;
+            else if (w.owner === 'team_lead')
+                from = teamOf.get(to)?.leaders?.find((s) => s !== to);
+        }
+        if (!from || from === to || !isKnown(from))
+            continue;
+        const open = !CLOSED.has(w.status);
+        const created = msOf(w.createdAt);
+        if (!open) {
+            const done = msOf(w.completedAt) || msOf(w.statusChangedAt) || created;
+            if (!FINISHED_OK.has(w.status) || !(done >= windowStart))
+                continue;
+        }
+        const key = `${from}\u0000${to}`;
+        const entry = delegations.get(key) ?? { from, to, items: [] };
+        entry.items.push({ w, open, at: Number.isFinite(created) ? created : now });
+        delegations.set(key, entry);
+    }
+    for (const { from, to, items } of delegations.values()) {
+        const open = items.filter((i) => i.open);
+        const pool = open.length > 0 ? open : items;
+        const newest = pool.reduce((a, b) => (b.at > a.at ? b : a));
+        put({ from, to, kind: 'delegated', active: open.length > 0, since: iso(newest.at), ...(label(newest.w.title) ? { label: label(newest.w.title) } : {}), weight: items.length });
+    }
+    // --- same_task: two agents on one ticket right now
+    const ticketTitle = new Map();
+    for (const t of tickets) {
+        ticketTitle.set(t.id, t.label ? `${t.label} ${t.title}` : t.title);
+        if (t.label)
+            ticketTitle.set(t.label, `${t.label} ${t.title}`);
+    }
+    const groups = new Map();
+    const join = (key, session, since) => {
+        const g = groups.get(key) ?? new Map();
+        g.set(session, Math.max(g.get(session) ?? 0, Number.isFinite(since) ? since : now));
+        groups.set(key, g);
+    };
+    for (const w of workItems) {
+        if (w.status !== 'running' || !w.target || !isKnown(w.target))
+            continue;
+        const key = w.projectTaskId ?? w.requestId;
+        if (key)
+            join(key, w.target, msOf(w.startedAt) || msOf(w.createdAt));
+    }
+    for (const [session, task] of tasks) {
+        if (task.id && ticketTitle.has(task.id) && isKnown(session))
+            join(task.id, session, msOf(task.since));
+    }
+    for (const [key, members] of groups) {
+        if (members.size < 2)
+            continue;
+        const sessions = [...members.keys()].sort().slice(0, C.LINK_SAME_TASK_MAX_GROUP);
+        const text = label(ticketTitle.get(key) ?? workItems.find((w) => w.projectTaskId === key || w.requestId === key)?.title);
+        for (let i = 0; i < sessions.length; i += 1) {
+            for (let j = i + 1; j < sessions.length; j += 1) {
+                const since = Math.max(members.get(sessions[i]) ?? now, members.get(sessions[j]) ?? now);
+                const link = { from: sessions[i], to: sessions[j], kind: 'same_task', active: true, since: iso(since), ...(text ? { label: text } : {}) };
+                // Two tickets shared by one pair: the earlier key keeps the pair
+                if (!out.has(linkKey(link)))
+                    put(link);
+            }
+        }
+    }
+    return [...out.values()];
+}
+/**
+ * Messaging links from the recorder.
+ *
+ * @param pairs - Sender/receiver pairs in the last two hours
+ * @param now - Clock
+ * @param isKnown - Whether an endpoint is an agent of this machine or qualified
+ * @returns Links
+ */
+export function messagingLinks(pairs, now, isKnown) {
+    const out = [];
+    for (const p of pairs) {
+        if (!isKnown(p.from) || !isKnown(p.to))
+            continue;
+        out.push({ from: p.from, to: p.to, kind: 'messaging', active: now - p.lastAt <= C.LINK_MESSAGING_ACTIVE_MS, since: iso(p.firstAt), weight: p.count });
+    }
+    return out;
+}
+/**
+ * Cap a link list: messaging, then same_task, are dropped first.
+ *
+ * @param links - Links
+ * @param max - Most links to keep
+ * @returns At most `max` links
+ */
+export function capLinks(links, max = C.LINKS_MAX) {
+    if (links.length <= max)
+        return links;
+    const rank = { reports_to: 0, delegated: 1, same_task: 2, messaging: 3 };
+    return [...links]
+        .sort((a, b) => rank[a.kind] - rank[b.kind] || Number(b.active) - Number(a.active) || Date.parse(b.since) - Date.parse(a.since))
+        .slice(0, max);
+}
+//# sourceMappingURL=board-links.js.map

package/dist/backend/backend/src/services/board/board-links.js.map

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

package/dist/backend/backend/src/services/board/board-push.service.d.ts

@@ -21,7 +21,8 @@
 import { type ComponentLogger } from '../core/logger.service.js';
 import type { BoardActivityTracker } from './board-activity.tracker.js';
 import type { BoardSnapshotBuilder } from './board-snapshot.builder.js';
-import type { BoardSnapshot } from './board.types.js';
+import { type AgentInteractionRecorder } from './board-interactions.js';
+import { type BoardSnapshot } from './board.types.js';
 /** The Cloud session (CloudClientService). */
 export interface BoardCloudSession {
     getToken(): string | null;
@@ -39,6 +40,8 @@ export interface BoardPushDeps {
     setTimeout?: (fn: () => void, ms: number) => ReturnType<typeof setTimeout>;
     clearTimeout?: (handle: ReturnType<typeof setTimeout>) => void;
     logger?: ComponentLogger;
+    /** Agent-to-agent messages (default: the process-wide recorder) */
+    interactions?: AgentInteractionRecorder;
 }
 /** What one push did. */
 export type BoardPushOutcome = 'sent' | 'nothing' | 'skipped' | 'paused' | 'failed';
@@ -72,6 +75,10 @@ export declare class BoardPushService {
     private readonly dirty;
     /** Rows Cloud has, as JSON, by session */
     private readonly lastSent;
+    /** Links Cloud has, as JSON, by identity */
+    private readonly lastLinks;
+    /** A message was recorded since the last delta: the links may differ */
+    private linksDirty;
     private lastToken;
     private fullOk;
     private fullAfterMs;

package/dist/backend/backend/src/services/board/board-push.service.d.ts.map

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

package/dist/backend/backend/src/services/board/board-push.service.js

@@ -21,6 +21,8 @@
 import { gzipSync } from 'zlib';
 import { BOARD_CONSTANTS, CANVAS_CONSTANTS } from '../../constants.js';
 import { LoggerService } from '../core/logger.service.js';
+import { getAgentInteractions } from './board-interactions.js';
+import { linkKey } from './board.types.js';
 const C = BOARD_CONSTANTS;
 const CV = CANVAS_CONSTANTS;
 /**
@@ -42,6 +44,9 @@ export function isBoardPushDisabled(env = process.env) {
  */
 export function fitSnapshot(snapshot) {
     const size = () => Buffer.byteLength(JSON.stringify(snapshot));
+    // Links go first: a map of lines is the least important part of the body
+    while (snapshot.links && snapshot.links.length > 0 && size() > C.MAX_BODY_BYTES)
+        snapshot.links.length = Math.floor(snapshot.links.length / 2);
     const lists = [snapshot.outcomes.doneToday, snapshot.outcomes.stuck, snapshot.outcomes.waitingOnOwner];
     let guard = 0;
     while (size() > C.MAX_BODY_BYTES && guard < 500) {
@@ -74,6 +79,10 @@ export class BoardPushService {
     dirty = new Set();
     /** Rows Cloud has, as JSON, by session */
     lastSent = new Map();
+    /** Links Cloud has, as JSON, by identity */
+    lastLinks = new Map();
+    /** A message was recorded since the last delta: the links may differ */
+    linksDirty = false;
     lastToken = null;
     fullOk = false;
     fullAfterMs = C.FULL_INTERVAL_MS;
@@ -124,9 +133,14 @@ export class BoardPushService {
         // A step changed: the agent's row did not necessarily, but a delta is due
         const offRows = this.deps.tracker.onChange((session) => this.markDirty(session));
         const offSteps = this.deps.tracker.steps.onChange((session) => this.markDirty(session));
+        const offMessages = (this.deps.interactions ?? getAgentInteractions()).onRecord((from) => {
+            this.linksDirty = true;
+            this.markDirty(from);
+        });
         this.unsubscribe = () => {
             offRows();
             offSteps();
+            offMessages();
         };
         this.scheduleFull(0);
     }
@@ -218,6 +232,10 @@ export class BoardPushService {
         for (const team of snapshot.teams)
             for (const a of team.agents)
                 this.lastSent.set(a.session, JSON.stringify(a));
+        this.lastLinks.clear();
+        for (const l of snapshot.links ?? [])
+            this.lastLinks.set(linkKey(l), JSON.stringify(l));
+        this.linksDirty = false;
         this.dirty.clear();
         // Timeline events ride in deltas
         const pending = new Set([...this.deps.tracker.sessionsWithUnsent(), ...this.deps.tracker.steps.sessionsWithUnsent()]);
@@ -249,7 +267,18 @@ export class BoardPushService {
         const changed = rows.filter((r) => this.lastSent.get(r.session) !== JSON.stringify(stripTeam(r)));
         const timeline = this.deps.tracker.peekUnsent(sessions);
         let steps = this.deps.tracker.steps.peekUnsent(sessions);
-        if (changed.length === 0 && timeline.length === 0 && steps.length === 0)
+        // Links are recomputed only after a message (the rest comes with the full build)
+        let links = [];
+        let removedLinks = [];
+        const linksWereDirty = this.linksDirty;
+        if (linksWereDirty) {
+            this.linksDirty = false;
+            const now = this.deps.builder.links();
+            links = now.filter((l) => this.lastLinks.get(linkKey(l)) !== JSON.stringify(l));
+            const keys = new Set(now.map(linkKey));
+            removedLinks = [...this.lastLinks.keys()].filter((k) => !keys.has(k));
+        }
+        if (changed.length === 0 && timeline.length === 0 && steps.length === 0 && links.length === 0 && removedLinks.length === 0)
             return 'nothing';
         const instanceId = (await this.deps.builder.identity()).instanceId;
         const body = {
@@ -259,6 +288,8 @@ export class BoardPushService {
             agents: changed,
             ...(timeline.length > 0 ? { timeline } : {}),
             ...(steps.length > 0 ? { steps } : {}),
+            ...(links.length > 0 ? { links } : {}),
+            ...(removedLinks.length > 0 ? { removedLinks } : {}),
         };
         // The body limit is on the uncompressed JSON: the newest steps go first when it does not fit
         for (let guard = 0; guard < 20 && body.steps && Buffer.byteLength(JSON.stringify(body)) > C.MAX_BODY_BYTES; guard += 1) {
@@ -272,6 +303,10 @@ export class BoardPushService {
         if (outcome === 'sent') {
             for (const r of changed)
                 this.lastSent.set(r.session, JSON.stringify(stripTeam(r)));
+            for (const l of links)
+                this.lastLinks.set(linkKey(l), JSON.stringify(l));
+            for (const k of removedLinks)
+                this.lastLinks.delete(k);
             this.deps.tracker.ackUnsent(timeline);
             this.deps.tracker.steps.ackUnsent(steps);
             // Steps the per-delta limit held back go in the next one
@@ -281,6 +316,8 @@ export class BoardPushService {
         }
         else if (outcome === 'failed') {
             // keep them dirty for the next try (the full push also repairs everything)
+            if (linksWereDirty)
+                this.linksDirty = true;
             for (const s of sessions)
                 this.dirty.add(s);
         }