crewly 1.20.346 → 1.20.348

package/dist/backend/backend/src/services/messaging/agent-ask-ledger.service.js

@@ -0,0 +1,337 @@
+/**
+ * Agent ask ledger — the return path of agent-to-agent messages.
+ *
+ * When one agent hands work to another with a plain message (send-message /
+ * `/terminal/:to/write`), nothing brings the answer back: no WorkItem, no
+ * completion event. On 2026-10-14 Pia passed the owner's "replicate this X
+ * video" to Dex; Dex rendered the films in 24 minutes, wrote "both parts are
+ * done" into its own terminal and stopped. Nobody saw it for seven hours.
+ *
+ * This ledger remembers each agent message once it is delivered. When the
+ * receiver ends a turn that worked on it for a while and it neither wrote
+ * back to the sender nor posted anywhere, the harness passes the receiver's
+ * last words to the sender. The receiver's open asks also hold the owner's
+ * ticket open (an agent that handed the work on has not answered yet).
+ *
+ * Cheap by construction: no model call, one transcript read per forwarded
+ * ask. Off switch: `CREWLY_AGENT_ASK_RETURN=off`.
+ *
+ * @module services/messaging/agent-ask-ledger.service
+ */
+import * as fsSync from 'fs';
+import * as path from 'path';
+import { LoggerService } from '../core/logger.service.js';
+import { atomicWriteJson } from '../../utils/file-io.utils.js';
+/** Tunables. */
+export const AGENT_ASK_CONSTANTS = {
+    /** Store file under CREWLY_HOME */
+    FILE_NAME: 'agent-asks.json',
+    /** A turn this long after the delivery counts as having worked on the message (ms) */
+    MIN_WORK_MS: 2 * 60_000,
+    /**
+     * A turn that ends sooner than MIN_WORK_MS but at least this long after
+     * the delivery read it and let it go (an FYI, an "ok"): the ask is dropped
+     * without a word. Sooner than this, the turn that ended is the previous
+     * one, not the message's (ms).
+     */
+    MIN_READ_MS: 15_000,
+    /** An ask nobody answered is forgotten after this (ms) */
+    TTL_MS: 12 * 60 * 60_000,
+    /** Asks kept in the store */
+    MAX_ASKS: 300,
+    /** Characters of the asked message quoted back to the sender */
+    EXCERPT_CHARS: 200,
+    /** Characters of the receiver's last words passed on */
+    RESULT_CHARS: 3000,
+    /** Env switch: `off` disables the ledger */
+    ENV_SWITCH: 'CREWLY_AGENT_ASK_RETURN',
+};
+const C = AGENT_ASK_CONSTANTS;
+/**
+ * The member name in a session id: `flopost-dex-7f17ecbc` → `Dex`.
+ *
+ * @param session - Session name
+ * @returns Readable name
+ */
+export function memberName(session) {
+    const parts = session.split('-');
+    const name = parts.length >= 3 && /^[0-9a-f]{6,}$/.test(parts[parts.length - 1]) ? parts[parts.length - 2] : session;
+    return name.charAt(0).toUpperCase() + name.slice(1);
+}
+/**
+ * Text handed to the sender in place of the answer it never got.
+ *
+ * @param input - Names, the asked excerpt, minutes worked, the last words
+ * @returns Message for the sender
+ */
+export function renderReturnedAnswer(input) {
+    const head = `[ANSWER FROM ${input.target.toUpperCase()}] ${input.target} worked on your message for about ${input.minutes} min and ended without writing back to you or posting anywhere.`;
+    const asked = `Your message: "${input.excerpt}"`;
+    if (!input.lastWords) {
+        return `${head} Crewly could not read what it said. ${asked}\nAsk ${input.target} for the result.`;
+    }
+    return (`${head} Crewly is passing on its last words. ${asked}\n\n` +
+        `--- ${input.target} ---\n${input.lastWords}\n---\n\n` +
+        `If this is what you were waiting for, carry it on (for example, post it where the owner asked). No need to answer Crewly.`);
+}
+/**
+ * Remembers delivered agent messages and returns unsent answers. See module docs.
+ */
+export class AgentAskLedger {
+    deps;
+    asks = [];
+    posts = new Map();
+    logger;
+    now;
+    saving = Promise.resolve();
+    constructor(deps) {
+        this.deps = deps;
+        this.logger = LoggerService.getInstance().createComponentLogger('AgentAskLedger');
+        this.now = deps.now ?? Date.now;
+        this.load();
+    }
+    /**
+     * A message from `sender` reached `target`'s turn.
+     *
+     * @param target - Receiving agent
+     * @param sender - Sending agent
+     * @param text - What was delivered
+     */
+    noteDelivered(target, sender, text) {
+        if (!target || !sender || target === sender)
+            return;
+        const excerpt = text.replace(/\s+/g, ' ').trim().slice(0, C.EXCERPT_CHARS);
+        this.asks.push({ sender, target, excerpt, deliveredAt: this.now() });
+        this.prune();
+        this.save();
+    }
+    /**
+     * `from` wrote to `to`: every open ask of `to` to `from` is answered.
+     *
+     * @param from - Writing agent
+     * @param to - Agent written to
+     */
+    noteAnswered(from, to) {
+        const before = this.asks.length;
+        this.asks = this.asks.filter((a) => !(a.target === from && a.sender === to));
+        if (this.asks.length !== before)
+            this.save();
+    }
+    /**
+     * An agent posted in chat (an answer, not an interim note): asks delivered
+     * to it before now count as answered where they were asked to be.
+     *
+     * @param session - Posting agent
+     */
+    notePost(session) {
+        if (!session)
+            return;
+        this.posts.set(session, this.now());
+        this.save();
+    }
+    /**
+     * Asks `sender` made that are still unanswered.
+     *
+     * @param sender - Asking agent
+     * @returns Open asks, oldest first
+     */
+    openAsksBy(sender) {
+        this.prune();
+        return this.asks.filter((a) => a.sender === sender);
+    }
+    /**
+     * `target` finished a turn. An ask it worked on for at least
+     * {@link AGENT_ASK_CONSTANTS.MIN_WORK_MS} with no word back is answered
+     * for it: its last words go to the sender. One it answered in chat, or
+     * read in a short turn, is dropped. Never throws.
+     *
+     * @param target - Agent whose turn ended
+     * @returns Asks returned to their senders
+     */
+    async onTurnEnded(target) {
+        try {
+            this.prune();
+            const now = this.now();
+            const mine = this.asks.filter((a) => a.target === target);
+            if (mine.length === 0)
+                return 0;
+            const posted = this.posts.get(target) ?? 0;
+            const age = (a) => now - a.deliveredAt;
+            // Answered in chat, or read and let go after a short turn: drop quietly.
+            const quiet = mine.filter((a) => posted >= a.deliveredAt || (age(a) >= C.MIN_READ_MS && age(a) < C.MIN_WORK_MS));
+            const due = mine.filter((a) => posted < a.deliveredAt && age(a) >= C.MIN_WORK_MS);
+            if (quiet.length === 0 && due.length === 0)
+                return 0;
+            const settled = new Set([...quiet, ...due]);
+            this.asks = this.asks.filter((a) => !settled.has(a));
+            this.save();
+            // One message per sender, from the oldest ask it is waiting on.
+            const bySender = new Map();
+            for (const a of due)
+                if (!bySender.has(a.sender))
+                    bySender.set(a.sender, a);
+            let returned = 0;
+            for (const ask of bySender.values()) {
+                const lastWords = await this.deps.readLastWords(target, ask.deliveredAt).catch(() => null);
+                const text = renderReturnedAnswer({
+                    target: (this.deps.displayName ?? memberName)(target),
+                    excerpt: ask.excerpt,
+                    minutes: Math.max(1, Math.round((now - ask.deliveredAt) / 60_000)),
+                    lastWords: lastWords ? clipResult(lastWords) : null,
+                });
+                try {
+                    await this.deps.deliver(ask.sender, text);
+                    returned += 1;
+                    this.logger.info('Returned an unsent answer to its asker', { from: target, to: ask.sender, hadText: !!lastWords });
+                }
+                catch (err) {
+                    this.logger.warn('Could not return an unsent answer', { from: target, to: ask.sender, error: err instanceof Error ? err.message : String(err) });
+                }
+            }
+            return returned;
+        }
+        catch (err) {
+            this.logger.debug('Ask settle failed', { target, error: err instanceof Error ? err.message : String(err) });
+            return 0;
+        }
+    }
+    prune() {
+        const cutoff = this.now() - C.TTL_MS;
+        this.asks = this.asks.filter((a) => a.deliveredAt >= cutoff).slice(-C.MAX_ASKS);
+        for (const [s, at] of this.posts)
+            if (at < cutoff)
+                this.posts.delete(s);
+    }
+    load() {
+        if (!this.deps.file)
+            return;
+        try {
+            const raw = JSON.parse(fsSync.readFileSync(this.deps.file, 'utf-8'));
+            if (Array.isArray(raw.asks)) {
+                this.asks = raw.asks.filter((a) => !!a && typeof a.sender === 'string' && typeof a.target === 'string' && typeof a.excerpt === 'string' && typeof a.deliveredAt === 'number');
+            }
+            if (raw.posts && typeof raw.posts === 'object') {
+                for (const [s, at] of Object.entries(raw.posts))
+                    if (typeof at === 'number')
+                        this.posts.set(s, at);
+            }
+            this.prune();
+        }
+        catch {
+            // missing or unreadable: start empty
+        }
+    }
+    save() {
+        const file = this.deps.file;
+        if (!file)
+            return;
+        const data = { asks: this.asks, posts: Object.fromEntries(this.posts) };
+        this.saving = this.saving
+            .then(async () => {
+            fsSync.mkdirSync(path.dirname(file), { recursive: true });
+            await atomicWriteJson(file, data);
+        })
+            .catch((err) => {
+            this.logger.debug('Ask ledger not saved', { error: err instanceof Error ? err.message : String(err) });
+        });
+    }
+    /** Wait for pending writes (tests). */
+    async flush() {
+        await this.saving;
+    }
+}
+/**
+ * The agent's last message in a transcript since a time: the text of the
+ * newest assistant entry that has text (Claude Code JSONL or Codex rollout).
+ * Subagent (sidechain), meta and API-error entries are not the agent's words.
+ *
+ * @param text - Whole JSONL lines (a tail of the file is fine)
+ * @param kind - Transcript format
+ * @param sinceMs - Ignore entries older than this (epoch ms)
+ * @returns The text, or null when there is none
+ */
+export function lastWordsFromTranscript(text, kind, sinceMs) {
+    let last = null;
+    for (const line of text.split('\n')) {
+        if (line.length < 20)
+            continue;
+        if (kind === 'claude' && !(line.includes('"type":"assistant"') && line.includes('"type":"text"')))
+            continue;
+        if (kind === 'codex' && !line.includes('"agent_message"') && !line.includes('"output_text"'))
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const at = typeof entry.timestamp === 'string' ? Date.parse(entry.timestamp) : NaN;
+        if (!Number.isFinite(at) || at < sinceMs)
+            continue;
+        let found = null;
+        if (kind === 'claude') {
+            if (entry.type !== 'assistant' || entry.isSidechain === true || entry.isMeta === true || entry.isApiErrorMessage === true)
+                continue;
+            const content = entry.message?.content;
+            if (!Array.isArray(content))
+                continue;
+            const parts = content
+                .filter((b) => !!b && b.type === 'text' && typeof b.text === 'string')
+                .map((b) => b.text.trim())
+                .filter(Boolean);
+            if (parts.length > 0)
+                found = parts.join('\n');
+        }
+        else {
+            const p = entry.payload;
+            if (!p)
+                continue;
+            if (entry.type === 'event_msg' && p.type === 'agent_message' && typeof p.message === 'string')
+                found = p.message.trim();
+            else if (entry.type === 'response_item' && p.type === 'message' && p.role === 'assistant' && Array.isArray(p.content)) {
+                const parts = p.content
+                    .filter((b) => b?.type === 'output_text' && typeof b.text === 'string')
+                    .map((b) => b.text.trim())
+                    .filter(Boolean);
+                if (parts.length > 0)
+                    found = parts.join('\n');
+            }
+        }
+        if (found)
+            last = found;
+    }
+    return last;
+}
+/**
+ * Keep the end of a long text: the conclusion is at the end.
+ *
+ * @param text - Last words
+ * @returns At most {@link AGENT_ASK_CONSTANTS.RESULT_CHARS} characters
+ */
+function clipResult(text) {
+    const t = text.trim();
+    return t.length <= C.RESULT_CHARS ? t : `…${t.slice(-(C.RESULT_CHARS - 1))}`;
+}
+// ---------------------------------------------------------------------------
+// Singleton
+// ---------------------------------------------------------------------------
+let instance = null;
+/** @returns The wired ledger, or null before boot (and when switched off) */
+export function getAgentAskLedger() {
+    return instance;
+}
+/** @param ledger - The ledger to expose (null clears) */
+export function setAgentAskLedger(ledger) {
+    instance = ledger;
+}
+/**
+ * Whether the ledger is switched on.
+ *
+ * @param env - Environment
+ * @returns False when `CREWLY_AGENT_ASK_RETURN=off`
+ */
+export function agentAskReturnEnabled(env = process.env) {
+    return (env[C.ENV_SWITCH] ?? '').toLowerCase() !== 'off';
+}
+//# sourceMappingURL=agent-ask-ledger.service.js.map

package/dist/backend/backend/src/services/messaging/agent-ask-ledger.service.js.map

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

package/dist/backend/backend/src/services/messaging/agent-ask-ledger.wiring.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Boot wiring of the agent ask ledger: the store file, the transcript reader
+ * and the delivery used to hand an unsent answer to its asker.
+ *
+ * @module services/messaging/agent-ask-ledger.wiring
+ */
+import { AgentAskLedger } from './agent-ask-ledger.service.js';
+/** Bytes read from the end of a transcript: a long turn's last message is near the end. */
+export declare const LAST_WORDS_TAIL_BYTES: number;
+/** Where a session's transcript is (see the canvas transcript locator). */
+export type AskTranscriptLocator = (session: string) => Promise<{
+    kind: 'claude' | 'codex';
+    file: string;
+} | null>;
+/**
+ * Read the end of a file as whole lines (the first partial line is dropped).
+ *
+ * @param file - Path
+ * @param maxBytes - Bytes from the end
+ * @returns Text
+ */
+export declare function readTail(file: string, maxBytes?: number): Promise<string>;
+/**
+ * The last words of a session since a time, secrets masked.
+ *
+ * @param locate - Transcript locator
+ * @param session - Agent session
+ * @param sinceMs - Oldest entry to read (epoch ms)
+ * @returns Text, or null (no transcript, nothing said)
+ */
+export declare function readLastWords(locate: AskTranscriptLocator, session: string, sinceMs: number): Promise<string | null>;
+/**
+ * Create and expose the ledger. Returns null when switched off.
+ *
+ * @param deps.crewlyHome - CREWLY_HOME (store file location)
+ * @param deps.sendToAgent - Delivers a harness message to an agent
+ * @param deps.locate - Transcript locator
+ * @returns The ledger, or null
+ */
+export declare function createAgentAskLedger(deps: {
+    crewlyHome: string;
+    sendToAgent: (session: string, text: string) => Promise<unknown>;
+    locate: AskTranscriptLocator;
+}): AgentAskLedger | null;
+//# sourceMappingURL=agent-ask-ledger.wiring.d.ts.map

package/dist/backend/backend/src/services/messaging/agent-ask-ledger.wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ask-ledger.wiring.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/messaging/agent-ask-ledger.wiring.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAEN,cAAc,EAId,MAAM,+BAA+B,CAAC;AAEvC,2FAA2F;AAC3F,eAAO,MAAM,qBAAqB,QAAkB,CAAC;AAErD,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAAC;AAEnH;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAA8B,GAAG,OAAO,CAAC,MAAM,CAAC,CAYtG;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAK1H;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,MAAM,EAAE,oBAAoB,CAAC;CAC7B,GAAG,cAAc,GAAG,IAAI,CAYxB"}

package/dist/backend/backend/src/services/messaging/agent-ask-ledger.wiring.js

@@ -0,0 +1,71 @@
+/**
+ * Boot wiring of the agent ask ledger: the store file, the transcript reader
+ * and the delivery used to hand an unsent answer to its asker.
+ *
+ * @module services/messaging/agent-ask-ledger.wiring
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { collectSecretEnvValues } from '../../utils/secret-env.js';
+import { redactSecrets } from '../../utils/secret-redactor.js';
+import { AGENT_ASK_CONSTANTS, AgentAskLedger, agentAskReturnEnabled, lastWordsFromTranscript, setAgentAskLedger, } from './agent-ask-ledger.service.js';
+/** Bytes read from the end of a transcript: a long turn's last message is near the end. */
+export const LAST_WORDS_TAIL_BYTES = 2 * 1024 * 1024;
+/**
+ * Read the end of a file as whole lines (the first partial line is dropped).
+ *
+ * @param file - Path
+ * @param maxBytes - Bytes from the end
+ * @returns Text
+ */
+export async function readTail(file, maxBytes = LAST_WORDS_TAIL_BYTES) {
+    const handle = await fs.open(file, 'r');
+    try {
+        const { size } = await handle.stat();
+        const start = Math.max(0, size - maxBytes);
+        const buf = Buffer.alloc(size - start);
+        await handle.read(buf, 0, buf.length, start);
+        const text = buf.toString('utf-8');
+        return start > 0 ? text.slice(text.indexOf('\n') + 1) : text;
+    }
+    finally {
+        await handle.close();
+    }
+}
+/**
+ * The last words of a session since a time, secrets masked.
+ *
+ * @param locate - Transcript locator
+ * @param session - Agent session
+ * @param sinceMs - Oldest entry to read (epoch ms)
+ * @returns Text, or null (no transcript, nothing said)
+ */
+export async function readLastWords(locate, session, sinceMs) {
+    const target = await locate(session);
+    if (!target)
+        return null;
+    const words = lastWordsFromTranscript(await readTail(target.file), target.kind, sinceMs);
+    return words ? redactSecrets(words, collectSecretEnvValues(process.env)) : null;
+}
+/**
+ * Create and expose the ledger. Returns null when switched off.
+ *
+ * @param deps.crewlyHome - CREWLY_HOME (store file location)
+ * @param deps.sendToAgent - Delivers a harness message to an agent
+ * @param deps.locate - Transcript locator
+ * @returns The ledger, or null
+ */
+export function createAgentAskLedger(deps) {
+    if (!agentAskReturnEnabled()) {
+        setAgentAskLedger(null);
+        return null;
+    }
+    const ledger = new AgentAskLedger({
+        file: path.join(deps.crewlyHome, AGENT_ASK_CONSTANTS.FILE_NAME),
+        readLastWords: (session, sinceMs) => readLastWords(deps.locate, session, sinceMs),
+        deliver: deps.sendToAgent,
+    });
+    setAgentAskLedger(ledger);
+    return ledger;
+}
+//# sourceMappingURL=agent-ask-ledger.wiring.js.map

package/dist/backend/backend/src/services/messaging/agent-ask-ledger.wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ask-ledger.wiring.js","sourceRoot":"","sources":["../../../../../../backend/src/services/messaging/agent-ask-ledger.wiring.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EACN,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,GACjB,MAAM,+BAA+B,CAAC;AAEvC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAKrD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY,EAAE,WAAmB,qBAAqB;IACpF,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC;QACJ,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;QACvC,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,CAAC;YAAS,CAAC;QACV,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAA4B,EAAE,OAAe,EAAE,OAAe;IACjG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,KAAK,GAAG,uBAAuB,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzF,OAAO,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAIpC;IACA,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;QAC9B,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACb,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QACjC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,SAAS,CAAC;QAC/D,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;QACjF,OAAO,EAAE,IAAI,CAAC,WAAW;KACzB,CAAC,CAAC;IACH,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/backend/backend/src/services/orc/reply-destination.wiring.d.ts

@@ -8,6 +8,7 @@
  */
 import { type ReplyDestination, type ReplyHints, type ReplyReference, type ReplyResolverDeps } from './reply-destination-resolver.js';
 import { type WorkDestinationDeps } from './work-item-destination.wiring.js';
+import { type TurnTrigger } from '../trace/turn-trigger.js';
 /** Forget recent deliveries (tests). */
 export declare function resetReplyDeliveryGuardForTesting(): void;
 /** Delivery into a chat-v2 conversation (chat.controller `deliverAgentReplyToConversation`). */
@@ -43,6 +44,17 @@ export interface ReplyDeliveryDeps {
      * with `reply --decision D-n`. Omitted: no card lookup.
      */
     decisionOfCardThread?: (slackChannelId: string, threadTs: string) => Promise<string | null>;
+    /**
+     * What started the agent's current turn (turn-trigger.ts), for the
+     * "Triggered by" line and the provenance stored on the row. Omitted: none.
+     */
+    turnTrigger?: (session: string) => TurnTrigger | null;
+    /** The owner wrote to the agent in this conversation recently (its post there is an answer). Omitted: no. */
+    ownerAskedRecently?: (session: string, conversationId: string) => boolean;
+    /** The session's current run trace id. Omitted: none. */
+    currentTrace?: (session: string) => string | null;
+    /** A conversation as the owner knows it (`#content-team`, `the DM with Ella`). Omitted: unnamed. */
+    conversationPlace?: (conversationId: string) => string | null;
 }
 /** What a delivery did. */
 export type ReplyDelivery = {
@@ -89,6 +101,25 @@ export interface DeliverReplyInput {
  * @returns Where it landed, or an English error
  */
 export declare function deliverReply(input: DeliverReplyInput, deps?: ReplyDeliveryDeps): Promise<ReplyDelivery>;
+/**
+ * Provenance for a post an agent makes straight into a conversation
+ * (`reply-channel`, `POST /chat/channels/:id/messages`), outside
+ * {@link deliverReply}: the record to store and the text with the
+ * "Triggered by" line when one is shown. Never throws.
+ *
+ * @param input - Agent, conversation, text, interim flag
+ * @param deps - Collaborators (default: the real ones)
+ * @returns The text to store and the record, if any
+ */
+export declare function provenanceForAgentPost(input: {
+    session: string;
+    conversationId: string;
+    content: string;
+    interim?: boolean;
+}, deps?: Pick<ReplyDeliveryDeps, 'resolver' | 'turnTrigger' | 'ownerAskedRecently' | 'currentTrace' | 'conversationPlace'>): Promise<{
+    content: string;
+    triggeredBy?: Record<string, unknown>;
+}>;
 /**
  * The Slack place (channel + thread) the resolver gives, without posting —
  * for files and the `[DONE]` notice. Ticket threads that do not exist yet
@@ -119,4 +150,22 @@ export declare function notDelivered(why: string, fix: string): string;
  * @returns Deps
  */
 export declare function defaultReplyDeliveryDeps(): Promise<ReplyDeliveryDeps>;
+/** The chat-v2 lookups {@link chatConversationPlace} uses. */
+interface ChatChannelLookup {
+    getChannelForBridge(id: string): {
+        name: string;
+        type?: string;
+        agentSession?: string;
+    } | null;
+}
+/**
+ * A chat conversation as the owner knows it: `#name` for a channel or room,
+ * `the DM with <agent>` for a direct conversation.
+ *
+ * @param chat - chat-v2 lookups, or null
+ * @param conversationId - chat-v2 channel id
+ * @returns The place, or null when unknown
+ */
+export declare function chatConversationPlace(chat: ChatChannelLookup | null, conversationId: string): string | null;
+export {};
 //# sourceMappingURL=reply-destination.wiring.d.ts.map

package/dist/backend/backend/src/services/orc/reply-destination.wiring.d.ts.map

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