crewly 1.20.169 → 1.20.170

package/dist/backend/backend/src/services/messaging/owner-message-watchdog.wiring.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Wiring for the unanswered-owner-message watchdog: turns deliveries into
+ * tracked entries, turns what the owner can see into "answered", and
+ * implements the nudge and the note on top of the real transports.
+ *
+ * Kept apart from the service so the timeline logic stays transport-free and
+ * the transport glue stays small and testable with plain fakes.
+ *
+ * @module services/messaging/owner-message-watchdog.wiring
+ * @see specs/2026-09-30-owner-message-guarantee.md
+ */
+import type { ChatChannelDTO, ChatMessageDTO } from '../chat-v2/types.js';
+import type { DispatchMessageResult } from '../chat-v2/chat-v2.dispatcher.service.js';
+import { OwnerMessageWatchdogService, type LoginHint, type NudgeOutcome, type OwnerMessageEntry, type OwnerMessageTrackInput } from './owner-message-watchdog.service.js';
+/**
+ * Whether a chat-v2 user turn was written by the owner: not by an agent (here
+ * or on another machine), and — for a Slack row, when the owner is known — by
+ * the owner's Slack user.
+ *
+ * @param message - The turn
+ * @param ownerSlackUserId - The workspace owner's Slack user id, when known
+ * @returns True for the owner's message
+ */
+export declare function isOwnerChatTurn(message: Pick<ChatMessageDTO, 'senderType' | 'metadata'>, ownerSlackUserId: string | null | undefined): boolean;
+/**
+ * Build the entry for a chat-v2 dispatch that reached at least one agent.
+ *
+ * Responsible agent: the first recipient that had to answer; with nobody
+ * required (an un-addressed room message the awake agents were only told
+ * about), the room lead when it got the message, else the first non-
+ * orchestrator recipient. An orchestrator that was only woken to route a
+ * private room's message is never made responsible: its hand-off re-dispatches
+ * the message, and that dispatch is tracked under the same key.
+ *
+ * @param channel - Channel the message was recorded in
+ * @param message - The owner's turn
+ * @param result - Dispatch outcome
+ * @param ctx - Owner id and the room lead, when known
+ * @returns Track input, or null when nothing should be tracked
+ */
+export declare function trackInputFromDispatch(channel: Pick<ChatChannelDTO, 'id' | 'type' | 'agentSession'>, message: ChatMessageDTO, result: DispatchMessageResult, ctx?: {
+    ownerSlackUserId?: string | null;
+    leader?: string | null;
+}): OwnerMessageTrackInput | null;
+/**
+ * Login hint for a runtime waiting on a sign-in ("reply 重新登录 claude").
+ *
+ * @param runtimeType - The runtime type recorded with the login request, if any
+ * @returns The hint
+ */
+export declare function loginHintFor(runtimeType: string | null | undefined): LoginHint;
+/**
+ * The reminder delivered to the responsible agent. Carries the same routing
+ * header a normal delivery does, so the agent's `reply` goes back to the
+ * owner's conversation (and thread).
+ *
+ * @param entry - The unanswered message
+ * @param waitedMinutes - How long it has waited
+ * @param opts - `withHeader: false` when the transport adds its own `[CHAT:…]` header (the orchestrator's queue)
+ * @returns The text to deliver
+ */
+export declare function buildNudgeMessage(entry: OwnerMessageEntry, waitedMinutes: number, opts?: {
+    withHeader?: boolean;
+}): string;
+/** What the wiring needs from the rest of the backend. */
+export interface OwnerWatchdogWiringDeps {
+    crewlyHome: string;
+    /** PTY / in-process delivery (sub-agents) */
+    sendToAgent: (session: string, text: string) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /** Whether the agent's runtime session exists */
+    sessionExists: (session: string) => boolean;
+    /** User-initiated activation (same path as the dispatcher's activate-on-send) */
+    activate: (session: string) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /** Orchestrator delivery (its message queue) */
+    enqueueForOrchestrator: (input: {
+        content: string;
+        conversationId: string;
+        source: string;
+        sourceMetadata?: Record<string, unknown>;
+    }) => void;
+    isBusy: (session: string) => boolean;
+    /** Pending sign-in record for the session, if any */
+    loginRequired: (session: string) => {
+        runtimeType?: string | null;
+    } | null | undefined;
+    displayNameOf?: (session: string) => string;
+    /** Slack posting (null while Slack is not wired) */
+    slack: () => {
+        isConnected(): boolean;
+        sendMessage(m: {
+            channelId: string;
+            text: string;
+            threadTs?: string;
+            botToken?: string;
+            notAnAnswer?: boolean;
+            skipChatV2Mirror?: boolean;
+        }): Promise<string>;
+    } | null;
+    /** Whether a placeholder shows in a Slack thread */
+    owesThread: (slackChannelId: string, threadTs: string) => boolean;
+    /** Bot token of the agent whose own app owns this Slack DM (the master bot cannot post there) */
+    agentDmBotToken: (slackChannelId: string) => string | undefined;
+    /** An agent's own bot token, when installed */
+    botTokenOf: (session: string) => string | undefined;
+    /** Record a system note in a chat-v2 channel; false when it could not be recorded */
+    recordChatNote: (chatChannelId: string, threadId: string | undefined, text: string) => boolean;
+    /** Tell the reply router which chat thread a nudge is about */
+    noteOriginThread?: (session: string, chatChannelId: string, threadId: string | undefined) => void;
+}
+/** chat-v2 metadata flag on the watchdog's own chat notes (never taken as an answer). */
+export declare const OWNER_WATCHDOG_NOTE_METADATA_KEY = "ownerWatchdogNote";
+/**
+ * Re-deliver an unanswered message to its responsible agent.
+ *
+ * @param deps - Wiring deps
+ * @param entry - The message
+ * @param waited - Minutes waited
+ * @returns Sent, or blocked with the reason
+ */
+export declare function nudgeAgent(deps: OwnerWatchdogWiringDeps, entry: OwnerMessageEntry, waited: number): Promise<NudgeOutcome>;
+/**
+ * Post the note where the owner wrote: the Slack thread (Crewly's master bot;
+ * in an agent-owned DM the agent's bot, the only one that can post there), or
+ * a system turn in the chat channel.
+ *
+ * @param deps - Wiring deps
+ * @param entry - The message
+ * @param text - The note
+ * @returns True when posted
+ */
+export declare function postOwnerNote(deps: OwnerWatchdogWiringDeps, entry: OwnerMessageEntry, text: string): Promise<boolean>;
+/**
+ * Build the watchdog on the real transports and expose it as the singleton.
+ *
+ * @param deps - Wiring deps
+ * @returns The started watchdog
+ */
+export declare function createOwnerMessageWatchdog(deps: OwnerWatchdogWiringDeps): OwnerMessageWatchdogService;
+/**
+ * Feed a chat-v2 turn to the watchdog: an agent turn in a watched chat
+ * channel is the answer (an interim one is a visible "working on it").
+ *
+ * @param service - The watchdog
+ * @param dto - The recorded turn
+ */
+export declare function onChatTurn(service: Pick<OwnerMessageWatchdogService, 'noteChatAnswer'>, dto: ChatMessageDTO): void;
+/**
+ * Feed a Slack post made through this machine's SlackService.
+ *
+ * @param service - The watchdog
+ * @param post - Channel, thread and whether it was flagged as not an answer
+ */
+export declare function onSlackOutbound(service: Pick<OwnerMessageWatchdogService, 'noteSlackAnswer'>, post: {
+    channelId: string;
+    threadTs?: string;
+    notAnAnswer?: boolean;
+    kind?: string;
+}): void;
+/**
+ * Feed an inbound Slack message: a colleague agent (any machine) posting in
+ * a watched thread answered it.
+ *
+ * @param service - The watchdog
+ * @param message - Inbound message fields
+ */
+export declare function onSlackInbound(service: Pick<OwnerMessageWatchdogService, 'noteSlackAnswer'>, message: {
+    channelId: string;
+    threadTs?: string;
+    authorAgentSession?: string;
+}): void;
+/** Log once when wiring is skipped (kept here so index.ts stays thin). */
+export declare function logWiringSkipped(reason: string): void;
+//# sourceMappingURL=owner-message-watchdog.wiring.d.ts.map

package/dist/backend/backend/src/services/messaging/owner-message-watchdog.wiring.d.ts.map

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

package/dist/backend/backend/src/services/messaging/owner-message-watchdog.wiring.js

@@ -0,0 +1,327 @@
+/**
+ * Wiring for the unanswered-owner-message watchdog: turns deliveries into
+ * tracked entries, turns what the owner can see into "answered", and
+ * implements the nudge and the note on top of the real transports.
+ *
+ * Kept apart from the service so the timeline logic stays transport-free and
+ * the transport glue stays small and testable with plain fakes.
+ *
+ * @module services/messaging/owner-message-watchdog.wiring
+ * @see specs/2026-09-30-owner-message-guarantee.md
+ */
+import * as path from 'path';
+import { AGENT_REPLY_CONSTANTS, MESSAGE_SOURCES, ORCHESTRATOR_SESSION_NAME, OWNER_EVIDENCE_METADATA, OWNER_MESSAGE_WATCHDOG_CONSTANTS as C, SLACK_TYPING_CONSTANTS, } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+import { slackThreadTag } from '../slack/slack-thread-key.js';
+import { OwnerMessageWatchdogService, setOwnerMessageWatchdog, } from './owner-message-watchdog.service.js';
+const logger = LoggerService.getInstance().createComponentLogger('OwnerMessageWatchdogWiring');
+// ---------------------------------------------------------------------------
+// Delivery → tracked entry
+// ---------------------------------------------------------------------------
+/**
+ * Whether a chat-v2 user turn was written by the owner: not by an agent (here
+ * or on another machine), and — for a Slack row, when the owner is known — by
+ * the owner's Slack user.
+ *
+ * @param message - The turn
+ * @param ownerSlackUserId - The workspace owner's Slack user id, when known
+ * @returns True for the owner's message
+ */
+export function isOwnerChatTurn(message, ownerSlackUserId) {
+    if (message.senderType !== 'user')
+        return false;
+    const meta = message.metadata ?? {};
+    if (meta[OWNER_EVIDENCE_METADATA.AUTHOR_AGENT_SESSION] || meta[OWNER_EVIDENCE_METADATA.REMOTE_AGENT_SESSION])
+        return false;
+    const source = typeof meta.source === 'string' ? meta.source : '';
+    if (OWNER_EVIDENCE_METADATA.AGENT_REPLY_SOURCES.includes(source))
+        return false;
+    if (source === 'slack') {
+        const slackUserId = typeof meta.slackUserId === 'string' ? meta.slackUserId : '';
+        if (!slackUserId)
+            return false;
+        return !ownerSlackUserId || slackUserId === ownerSlackUserId;
+    }
+    return true;
+}
+/**
+ * Build the entry for a chat-v2 dispatch that reached at least one agent.
+ *
+ * Responsible agent: the first recipient that had to answer; with nobody
+ * required (an un-addressed room message the awake agents were only told
+ * about), the room lead when it got the message, else the first non-
+ * orchestrator recipient. An orchestrator that was only woken to route a
+ * private room's message is never made responsible: its hand-off re-dispatches
+ * the message, and that dispatch is tracked under the same key.
+ *
+ * @param channel - Channel the message was recorded in
+ * @param message - The owner's turn
+ * @param result - Dispatch outcome
+ * @param ctx - Owner id and the room lead, when known
+ * @returns Track input, or null when nothing should be tracked
+ */
+export function trackInputFromDispatch(channel, message, result, ctx = {}) {
+    if (!result.dispatched)
+        return null;
+    if (!isOwnerChatTurn(message, ctx.ownerSlackUserId))
+        return null;
+    let recipients = [];
+    let required = [];
+    if (result.strategy === 'dm') {
+        if (channel.agentSession)
+            recipients = required = [channel.agentSession];
+    }
+    else if (result.strategy === 'huddle-broadcast') {
+        const got = (result.huddleOutcomes ?? []).filter((o) => o.dispatched);
+        recipients = got.map((o) => o.sessionName);
+        required = got.filter((o) => o.responseMode === 'required').map((o) => o.sessionName);
+    }
+    else if (result.strategy === 'channel-mentions') {
+        recipients = required = (result.mentionOutcomes ?? []).filter((o) => o.dispatched).map((o) => o.target.sessionName);
+    }
+    if (recipients.length === 0)
+        return null;
+    let responsible = required[0];
+    if (!responsible) {
+        const nonOrc = recipients.filter((s) => s !== ORCHESTRATOR_SESSION_NAME);
+        responsible = ctx.leader && nonOrc.includes(ctx.leader) ? ctx.leader : nonOrc[0];
+    }
+    if (!responsible)
+        return null;
+    const meta = message.metadata ?? {};
+    const isHuddle = channel.type !== 'dm';
+    // When the owner wrote it: the timeline starts there, and an answer that
+    // beat this call (a fast agent while a colleague cold-starts) still counts.
+    const receivedAt = typeof message.createdAt === 'number' && message.createdAt > 0 ? { receivedAt: message.createdAt } : {};
+    const chatThreadId = isHuddle ? message.threadId ?? message.id : undefined;
+    const slackChannelId = meta.source === 'slack' && typeof meta.slackChannelId === 'string' ? meta.slackChannelId : undefined;
+    if (slackChannelId) {
+        const sourceTs = typeof meta.slackTs === 'string' ? meta.slackTs : undefined;
+        const threadTs = typeof meta.slackThreadTs === 'string' ? meta.slackThreadTs : sourceTs;
+        return {
+            surface: 'slack',
+            slackChannelId,
+            ...(threadTs ? { threadTs } : {}),
+            ...(sourceTs ? { sourceTs } : {}),
+            chatChannelId: channel.id,
+            ...(chatThreadId ? { chatThreadId } : {}),
+            messageId: message.id,
+            responsible,
+            recipients,
+            required: required.length > 0,
+            text: message.content ?? '',
+            ...receivedAt,
+        };
+    }
+    return {
+        surface: 'chat',
+        chatChannelId: channel.id,
+        ...(chatThreadId ? { chatThreadId } : {}),
+        messageId: message.id,
+        responsible,
+        recipients,
+        required: required.length > 0,
+        text: message.content ?? '',
+        ...receivedAt,
+    };
+}
+/**
+ * Login hint for a runtime waiting on a sign-in ("reply 重新登录 claude").
+ *
+ * @param runtimeType - The runtime type recorded with the login request, if any
+ * @returns The hint
+ */
+export function loginHintFor(runtimeType) {
+    const rt = (runtimeType ?? '').toLowerCase();
+    if (rt.includes('codex'))
+        return { runtime: 'Codex', runtimeCmd: 'codex' };
+    if (rt.includes('gemini') || rt.includes('antigravity'))
+        return { runtime: 'Gemini', runtimeCmd: 'gemini' };
+    return { runtime: 'Claude', runtimeCmd: 'claude' };
+}
+/**
+ * The reminder delivered to the responsible agent. Carries the same routing
+ * header a normal delivery does, so the agent's `reply` goes back to the
+ * owner's conversation (and thread).
+ *
+ * @param entry - The unanswered message
+ * @param waitedMinutes - How long it has waited
+ * @param opts - `withHeader: false` when the transport adds its own `[CHAT:…]` header (the orchestrator's queue)
+ * @returns The text to deliver
+ */
+export function buildNudgeMessage(entry, waitedMinutes, opts = {}) {
+    const identity = /^[A-Za-z0-9._-]+$/.test(entry.responsible) ? `CREWLY_SESSION_NAME=${entry.responsible} ` : '';
+    const replyCmd = `${identity}bash ${AGENT_REPLY_CONSTANTS.SKILL_PATH} "<你的回复>"`;
+    const noneCmd = `${identity}bash ${AGENT_REPLY_CONSTANTS.SKILL_PATH} --none`;
+    const withHeader = opts.withHeader ?? true;
+    const head = withHeader && entry.chatChannelId ? `[CHAT:${entry.chatChannelId}] <owner@reminder>` : null;
+    const threadTag = entry.surface === 'slack' && entry.slackChannelId && (entry.threadTs ?? entry.sourceTs)
+        ? slackThreadTag(entry.slackChannelId, (entry.threadTs ?? entry.sourceTs))
+        : null;
+    return [
+        ...(head ? [head] : []),
+        ...(threadTag ? [threadTag] : []),
+        '',
+        C.NUDGE_TEXT.replace('{waited}', String(waitedMinutes)).replace('{replyCmd}', replyCmd).replace('{noneCmd}', noneCmd),
+        '',
+        `owner 的原话: ${entry.preview}`,
+    ].join('\n');
+}
+/** chat-v2 metadata flag on the watchdog's own chat notes (never taken as an answer). */
+export const OWNER_WATCHDOG_NOTE_METADATA_KEY = 'ownerWatchdogNote';
+/**
+ * Re-deliver an unanswered message to its responsible agent.
+ *
+ * @param deps - Wiring deps
+ * @param entry - The message
+ * @param waited - Minutes waited
+ * @returns Sent, or blocked with the reason
+ */
+export async function nudgeAgent(deps, entry, waited) {
+    const session = entry.responsible;
+    if (session === ORCHESTRATOR_SESSION_NAME) {
+        const text = buildNudgeMessage(entry, waited, { withHeader: false });
+        if (!entry.chatChannelId)
+            return { outcome: 'blocked', reason: 'error', detail: 'no conversation to re-deliver to' };
+        try {
+            deps.enqueueForOrchestrator({
+                content: text,
+                conversationId: entry.chatChannelId,
+                source: entry.surface === 'slack' ? MESSAGE_SOURCES.SLACK : MESSAGE_SOURCES.WEB_CHAT,
+                ...(entry.surface === 'slack' && entry.slackChannelId
+                    ? { sourceMetadata: { channelId: entry.slackChannelId, threadTs: entry.threadTs ?? entry.sourceTs } }
+                    : {}),
+            });
+            return { outcome: 'sent' };
+        }
+        catch (err) {
+            return { outcome: 'blocked', reason: 'error', detail: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    const text = buildNudgeMessage(entry, waited);
+    let woke = false;
+    if (!deps.sessionExists(session)) {
+        const res = await deps.activate(session).catch((err) => ({ success: false, error: err instanceof Error ? err.message : String(err) }));
+        if (!res.success)
+            return { outcome: 'blocked', reason: 'asleep', detail: res.error ?? 'activation failed' };
+        woke = true;
+    }
+    let result = await deps.sendToAgent(session, text).catch((err) => ({ success: false, error: err instanceof Error ? err.message : String(err) }));
+    if (!result.success && !woke && !deps.sessionExists(session)) {
+        const res = await deps.activate(session).catch((err) => ({ success: false, error: err instanceof Error ? err.message : String(err) }));
+        if (!res.success)
+            return { outcome: 'blocked', reason: 'asleep', detail: res.error ?? 'activation failed' };
+        result = await deps.sendToAgent(session, text).catch((err) => ({ success: false, error: err instanceof Error ? err.message : String(err) }));
+    }
+    if (!result.success)
+        return { outcome: 'blocked', reason: 'error', detail: result.error ?? 'delivery failed' };
+    if (entry.chatChannelId)
+        deps.noteOriginThread?.(session, entry.chatChannelId, entry.chatThreadId);
+    return { outcome: 'sent' };
+}
+/**
+ * Post the note where the owner wrote: the Slack thread (Crewly's master bot;
+ * in an agent-owned DM the agent's bot, the only one that can post there), or
+ * a system turn in the chat channel.
+ *
+ * @param deps - Wiring deps
+ * @param entry - The message
+ * @param text - The note
+ * @returns True when posted
+ */
+export async function postOwnerNote(deps, entry, text) {
+    if (entry.surface === 'chat') {
+        if (!entry.chatChannelId)
+            return false;
+        return deps.recordChatNote(entry.chatChannelId, entry.chatThreadId, text);
+    }
+    const slack = deps.slack();
+    if (!slack?.isConnected() || !entry.slackChannelId)
+        return false;
+    const threadTs = entry.threadTs ?? entry.sourceTs;
+    const base = { channelId: entry.slackChannelId, text, ...(threadTs ? { threadTs } : {}), notAnAnswer: true, skipChatV2Mirror: true };
+    const dmToken = deps.agentDmBotToken(entry.slackChannelId);
+    try {
+        await slack.sendMessage(dmToken ? { ...base, botToken: dmToken } : base);
+        return true;
+    }
+    catch (err) {
+        const fallback = !dmToken ? deps.botTokenOf(entry.responsible) : undefined;
+        if (!fallback)
+            throw err;
+        await slack.sendMessage({ ...base, botToken: fallback });
+        return true;
+    }
+}
+/**
+ * Build the watchdog on the real transports and expose it as the singleton.
+ *
+ * @param deps - Wiring deps
+ * @returns The started watchdog
+ */
+export function createOwnerMessageWatchdog(deps) {
+    const service = new OwnerMessageWatchdogService({
+        isBusy: deps.isBusy,
+        hasVisiblePlaceholder: (entry) => {
+            const threadTs = entry.threadTs ?? entry.sourceTs;
+            return !!entry.slackChannelId && !!threadTs && deps.owesThread(entry.slackChannelId, threadTs);
+        },
+        nudge: (entry, waited) => nudgeAgent(deps, entry, waited),
+        postNote: (entry, text) => postOwnerNote(deps, entry, text),
+        loginRequired: (session) => {
+            const info = deps.loginRequired(session);
+            return info ? loginHintFor(info.runtimeType) : null;
+        },
+        ...(deps.displayNameOf ? { displayNameOf: deps.displayNameOf } : {}),
+        storePath: path.join(deps.crewlyHome, C.STORE_FILENAME),
+    });
+    setOwnerMessageWatchdog(service);
+    service.start();
+    return service;
+}
+// ---------------------------------------------------------------------------
+// Answer signals
+// ---------------------------------------------------------------------------
+/**
+ * Feed a chat-v2 turn to the watchdog: an agent turn in a watched chat
+ * channel is the answer (an interim one is a visible "working on it").
+ *
+ * @param service - The watchdog
+ * @param dto - The recorded turn
+ */
+export function onChatTurn(service, dto) {
+    if (dto.senderType !== 'agent')
+        return;
+    if (dto.metadata?.[OWNER_WATCHDOG_NOTE_METADATA_KEY])
+        return;
+    const interim = dto.metadata?.[SLACK_TYPING_CONSTANTS.INTERIM_METADATA_KEY] === true;
+    service.noteChatAnswer(dto.channelId, dto.threadId ?? null, interim);
+}
+/**
+ * Feed a Slack post made through this machine's SlackService.
+ *
+ * @param service - The watchdog
+ * @param post - Channel, thread and whether it was flagged as not an answer
+ */
+export function onSlackOutbound(service, post) {
+    if (post.notAnAnswer)
+        return;
+    service.noteSlackAnswer(post.channelId, post.threadTs, post.kind ?? 'post');
+}
+/**
+ * Feed an inbound Slack message: a colleague agent (any machine) posting in
+ * a watched thread answered it.
+ *
+ * @param service - The watchdog
+ * @param message - Inbound message fields
+ */
+export function onSlackInbound(service, message) {
+    if (!message.authorAgentSession || !message.threadTs)
+        return;
+    service.noteSlackAnswer(message.channelId, message.threadTs, `agent ${message.authorAgentSession} posted`);
+}
+/** Log once when wiring is skipped (kept here so index.ts stays thin). */
+export function logWiringSkipped(reason) {
+    logger.warn('Owner message watchdog not started', { reason });
+}
+//# sourceMappingURL=owner-message-watchdog.wiring.js.map

package/dist/backend/backend/src/services/messaging/owner-message-watchdog.wiring.js.map

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

package/dist/backend/backend/src/services/orc/agent-reply-target.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Where an agent's `reply` goes — decided by the harness from the delivery
+ * the agent is answering, not by the agent picking the right tool and ids.
+ *
+ * Agents had to choose between reply-channel / reply-chat / reply-slack /
+ * report-status and pass the right ids; Codex agents in particular got this
+ * wrong and the owner's answer went to the orchestrator as "status" or into
+ * the wrong conversation. `reply "<text>"` names nothing: the answer goes to
+ * the turn origin recorded when the owner's message was delivered
+ * (`OrcReplyRouteService`). Explicit ids that are the agent's own still win.
+ *
+ * @module services/orc/agent-reply-target
+ * @see specs/2026-09-30-owner-message-guarantee.md §B
+ */
+import type { TurnOrigin } from './orc-reply-route.service.js';
+/** The decision. */
+export type AgentReplyPlan = 
+/** A report-status line: to the orchestrator, exactly like report-status. */
+{
+    kind: 'status';
+}
+/** No answer needed: close what the agent was asked, post nothing. */
+ | {
+    kind: 'none';
+    origin?: TurnOrigin;
+}
+/** Post as the agent into a chat-v2 conversation (DM / room / huddle), in `thread` when set. */
+ | {
+    kind: 'post';
+    conversationId: string;
+    thread?: string;
+    via: 'explicit' | 'origin';
+    reason: string;
+}
+/** The orchestrator answering a Slack thread it was asked in through the master bot. */
+ | {
+    kind: 'orc-slack';
+    channelId: string;
+    threadTs?: string;
+    reason: string;
+}
+/** The orchestrator answering in a chat conversation (its own reply routing applies). */
+ | {
+    kind: 'orc-chat';
+    conversationId?: string;
+    reason: string;
+}
+/** Nothing to answer into. */
+ | {
+    kind: 'no-target';
+    reason: string;
+};
+/** Inputs of {@link planAgentReply}. */
+export interface AgentReplyRequest {
+    /** Replying session (X-Agent-Session) */
+    session: string;
+    /** Whether it is the orchestrator */
+    isOrchestrator: boolean;
+    /** Reply text ('' with `none`) */
+    content: string;
+    /** `reply --none`: no answer needed */
+    none?: boolean;
+    /** Ids the agent passed, if any (may be missing, legacy or wrong) */
+    requested?: {
+        conversationId?: string;
+        thread?: string;
+    };
+    /** The recorded turn origin */
+    origin?: TurnOrigin;
+    /** Whether `conversationId` is one this agent may answer in (its DM, a room it is in) */
+    ownsConversation: (conversationId: string) => boolean;
+}
+/**
+ * Whether text is a report-status line for the orchestrator.
+ *
+ * @param content - Reply text
+ * @returns True for `[DONE]`, `[WORKING]`, … at the start
+ */
+export declare function isStatusReport(content: string): boolean;
+/**
+ * The thread an origin's answer belongs in: the Slack thread key when the
+ * message came from Slack, else the chat-v2 thread.
+ *
+ * @param origin - Turn origin
+ * @returns Thread reference, or undefined
+ */
+export declare function originThread(origin: TurnOrigin | undefined): string | undefined;
+/**
+ * Decide where a reply goes.
+ *
+ * @param req - Who is replying, what, the ids it passed and its turn origin
+ * @returns The plan
+ */
+export declare function planAgentReply(req: AgentReplyRequest): AgentReplyPlan;
+//# sourceMappingURL=agent-reply-target.d.ts.map

package/dist/backend/backend/src/services/orc/agent-reply-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-reply-target.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/orc/agent-reply-target.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,oBAAoB;AACpB,MAAM,MAAM,cAAc;AACxB,6EAA6E;AAC3E;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE;AACpB,sEAAsE;GACpE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAE;AACvC,gGAAgG;GAC9F;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,GAAG,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACvG,wFAAwF;GACtF;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC7E,yFAAyF;GACvF;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC/D,8BAA8B;GAC5B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,cAAc,EAAE,OAAO,CAAC;IACxB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,SAAS,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,+BAA+B;IAC/B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,yFAAyF;IACzF,gBAAgB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC;CACvD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE/E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,iBAAiB,GAAG,cAAc,CA2CrE"}