crewly 1.20.202 → 1.20.204

package/dist/cli/backend/src/services/runtime-fallback/reset-time.js.map

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

package/dist/cli/backend/src/services/runtime-fallback/usage-limit-rules.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Usage-limit rules — per-runtime patterns that mean "this runtime's account
+ * is out of usage", as opposed to a login that expired (login-expiry-rules.ts,
+ * the re-login flow) or a short rate limit the runtime retries by itself.
+ *
+ * Modelled on login-expiry-rules.ts: output is normalized with
+ * {@link normalizeTerminalOutput} and every pattern is matched against the
+ * normalized text and its spaceless copy (Claude Code places words with
+ * cursor moves instead of spaces), so patterns use `\s*` between words.
+ *
+ * Wording sources:
+ * - Claude Code 2.1.287 binary (`strings`, 2026-10-01): `Usage limit
+ *   reached`, `Usage limit reached again`, `continuing automatically {when}`,
+ *   `You're out of extra usage`, `You're out of usage credits`, `You've hit
+ *   your monthly spend limit`, ` resets $…`, `/upgrade to increase your usage
+ *   limit.`, the API's `billing_error` "spend limit reached (daily; resets …)",
+ *   and its own note that the client composes "You've hit your limit" from a
+ *   429. Older releases print `5-hour limit reached ∙ resets 3pm`, `Claude
+ *   usage limit reached. Your limit will reset at 3pm (America/Los_Angeles).`
+ *   and `Claude AI usage limit reached|<epoch>`.
+ * - Codex: `You've hit your usage limit. Upgrade to Pro (…) or try again in
+ *   4 days 7 hours 3 minutes.` / `… try again at 4:05 PM.`; transient:
+ *   `exceeded retry limit, last status: 429 Too Many Requests`.
+ * - Gemini / Antigravity: `RESOURCE_EXHAUSTED` with `Quota exceeded for quota
+ *   metric '… per day'`, `You exceeded your current quota`, `You have
+ *   exhausted your daily quota`; a bare 429 / RESOURCE_EXHAUSTED is transient.
+ * - DeepSeek (the in-process Crewly Agent): HTTP 402 `Insufficient Balance`
+ *   is a `billing` limit (no reset; the owner must top up); HTTP 429 `Rate Limit Reached` is transient.
+ *
+ * Context requirements keep an agent that merely reads or quotes this kind of
+ * text (for example while working on this file) from tripping a rule: the
+ * Claude UI rules need the `·` / `∙` separator, a reset time or a slash
+ * command next to the message; API rules need the API error context.
+ * Warnings that the limit is near ("Approaching usage limit", "You've used
+ * 90% of your session limit") are deliberately not matched.
+ *
+ * @module services/runtime-fallback/usage-limit-rules
+ */
+/**
+ * `usage_limit`: the account is out of usage until a window resets;
+ * `billing`: the account is out of money / credit (DeepSeek 402 "Insufficient
+ * Balance", "credit balance is too low") — it has no reset time and only
+ * comes back when the owner tops up, so it is never retried on a timer;
+ * `transient`: a short rate limit the runtime retries.
+ */
+export type UsageLimitKind = 'usage_limit' | 'billing' | 'transient';
+/**
+ * Whether a kind means the runtime cannot be used (as opposed to a transient
+ * rate limit).
+ *
+ * @param kind - Match kind
+ * @returns True for `usage_limit` and `billing`
+ */
+export declare function isExhaustingKind(kind: UsageLimitKind): boolean;
+/** One rule: every pattern must match (AND); `none` must not match. */
+export interface UsageLimitRule {
+    /** Stable id, used in logs (never contains output) */
+    id: string;
+    /** Runtime type the rule belongs to */
+    runtime: string;
+    kind: UsageLimitKind;
+    /** All must match the normalized text or its spaceless copy */
+    all: readonly RegExp[];
+    /** None of these may match (e.g. a warning, not the limit itself) */
+    none?: readonly RegExp[];
+}
+/** What {@link detectUsageLimit} found. */
+export interface UsageLimitMatch {
+    /** Runtime the rule belongs to */
+    runtime: string;
+    ruleId: string;
+    kind: UsageLimitKind;
+    /** When the limit lifts (epoch ms), when the message says so */
+    resetAt: number | null;
+}
+/** Claude Code rules (usage limits first, then transient). */
+export declare const CLAUDE_USAGE_RULES: readonly UsageLimitRule[];
+/** Codex rules. */
+export declare const CODEX_USAGE_RULES: readonly UsageLimitRule[];
+/** Antigravity CLI rules. */
+export declare const ANTIGRAVITY_USAGE_RULES: readonly UsageLimitRule[];
+/** Gemini CLI rules (retired runtime, detect only). */
+export declare const GEMINI_USAGE_RULES: readonly UsageLimitRule[];
+/**
+ * In-process Crewly Agent rules. These run on the error of a failed model
+ * call (never on text the model wrote), so they need no UI context.
+ */
+export declare const CREWLY_AGENT_USAGE_RULES: readonly UsageLimitRule[];
+/**
+ * Usage-limit rules for a runtime.
+ *
+ * @param runtime - Runtime type
+ * @returns Rules to try (empty for a runtime without rules)
+ */
+export declare function getUsageLimitRules(runtime: string): readonly UsageLimitRule[];
+/**
+ * Find a usage-limit (or transient rate-limit) message in a runtime's output.
+ * An expired login is never reported here — that is the re-login flow's.
+ *
+ * @param output - Raw PTY output (escape sequences allowed), captured screen, or an error message
+ * @param runtime - The runtime the output came from
+ * @param now - Current time (ms), for the reset time
+ * @param defaultTimeZone - Zone for reset clock times that name none
+ * @returns The match, or null
+ *
+ * @example
+ * ```ts
+ * detectUsageLimit("You've hit your limit · resets 3pm (America/Los_Angeles)", 'claude-code');
+ * // { runtime: 'claude-code', ruleId: 'claude.hit_your_limit', kind: 'usage_limit', resetAt: <next 3pm LA> }
+ * ```
+ */
+export declare function detectUsageLimit(output: string, runtime: string, now?: number, defaultTimeZone?: string): UsageLimitMatch | null;
+//# sourceMappingURL=usage-limit-rules.d.ts.map

package/dist/cli/backend/src/services/runtime-fallback/usage-limit-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-limit-rules.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/runtime-fallback/usage-limit-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAOH;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,SAAS,GAAG,WAAW,CAAC;AAErE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAE9D;AAED,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC9B,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,+DAA+D;IAC/D,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,qEAAqE;IACrE,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB;AAED,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC/B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,gEAAgE;IAChE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AASD,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,EAAE,SAAS,cAAc,EAuDvD,CAAC;AAEF,mBAAmB;AACnB,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAmBtD,CAAC;AAoBF,6BAA6B;AAC7B,eAAO,MAAM,uBAAuB,EAAE,SAAS,cAAc,EAA8D,CAAC;AAE5H,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAE,SAAS,cAAc,EAAoD,CAAC;AAE7G;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,cAAc,EAyB7D,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE,CAE7E;AAcD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAoB5I"}

package/dist/cli/backend/src/services/runtime-fallback/usage-limit-rules.js

@@ -0,0 +1,257 @@
+/**
+ * Usage-limit rules — per-runtime patterns that mean "this runtime's account
+ * is out of usage", as opposed to a login that expired (login-expiry-rules.ts,
+ * the re-login flow) or a short rate limit the runtime retries by itself.
+ *
+ * Modelled on login-expiry-rules.ts: output is normalized with
+ * {@link normalizeTerminalOutput} and every pattern is matched against the
+ * normalized text and its spaceless copy (Claude Code places words with
+ * cursor moves instead of spaces), so patterns use `\s*` between words.
+ *
+ * Wording sources:
+ * - Claude Code 2.1.287 binary (`strings`, 2026-10-01): `Usage limit
+ *   reached`, `Usage limit reached again`, `continuing automatically {when}`,
+ *   `You're out of extra usage`, `You're out of usage credits`, `You've hit
+ *   your monthly spend limit`, ` resets $…`, `/upgrade to increase your usage
+ *   limit.`, the API's `billing_error` "spend limit reached (daily; resets …)",
+ *   and its own note that the client composes "You've hit your limit" from a
+ *   429. Older releases print `5-hour limit reached ∙ resets 3pm`, `Claude
+ *   usage limit reached. Your limit will reset at 3pm (America/Los_Angeles).`
+ *   and `Claude AI usage limit reached|<epoch>`.
+ * - Codex: `You've hit your usage limit. Upgrade to Pro (…) or try again in
+ *   4 days 7 hours 3 minutes.` / `… try again at 4:05 PM.`; transient:
+ *   `exceeded retry limit, last status: 429 Too Many Requests`.
+ * - Gemini / Antigravity: `RESOURCE_EXHAUSTED` with `Quota exceeded for quota
+ *   metric '… per day'`, `You exceeded your current quota`, `You have
+ *   exhausted your daily quota`; a bare 429 / RESOURCE_EXHAUSTED is transient.
+ * - DeepSeek (the in-process Crewly Agent): HTTP 402 `Insufficient Balance`
+ *   is a `billing` limit (no reset; the owner must top up); HTTP 429 `Rate Limit Reached` is transient.
+ *
+ * Context requirements keep an agent that merely reads or quotes this kind of
+ * text (for example while working on this file) from tripping a rule: the
+ * Claude UI rules need the `·` / `∙` separator, a reset time or a slash
+ * command next to the message; API rules need the API error context.
+ * Warnings that the limit is near ("Approaching usage limit", "You've used
+ * 90% of your session limit") are deliberately not matched.
+ *
+ * @module services/runtime-fallback/usage-limit-rules
+ */
+import { RUNTIME_TYPES } from '../../constants.js';
+import { normalizeTerminalOutput } from '../harness/login-rules.js';
+import { detectLoginExpiry } from '../harness/login-expiry-rules.js';
+import { parseResetTime } from './reset-time.js';
+/**
+ * Whether a kind means the runtime cannot be used (as opposed to a transient
+ * rate limit).
+ *
+ * @param kind - Match kind
+ * @returns True for `usage_limit` and `billing`
+ */
+export function isExhaustingKind(kind) {
+    return kind === 'usage_limit' || kind === 'billing';
+}
+/** Claude UI context: the separator, a reset time, or a Claude slash command. */
+const CLAUDE_UI_CONTEXT = /[·∙•]|\bresets?\b|reset\s*at|continuing\s*automatically|\/(?:upgrade|extra-usage|usage-credits|rate-limit-options|model)\b|\|\s*\d{10}\b/i;
+/** API error context for Claude: a 429 / billing error. */
+const CLAUDE_API_429 = /\b429\b|rate_limit_error|billing_error/i;
+/** Wording that means "usage", not a per-minute rate. */
+const USAGE_WORDING = /usage\s*limit|limit\s*reached|hit\s*your\s*(?:[\w-]+\s*)?limit|spend\s*limit|quota|limit\s*will\s*reset|\bresets?\b|out\s*of\s*(?:extra\s*)?usage/i;
+/** Claude Code rules (usage limits first, then transient). */
+export const CLAUDE_USAGE_RULES = [
+    {
+        id: 'claude.api_usage_429',
+        runtime: RUNTIME_TYPES.CLAUDE_CODE,
+        kind: 'usage_limit',
+        all: [/API\s*Error|"type"\s*:\s*"error"/i, CLAUDE_API_429, USAGE_WORDING],
+    },
+    {
+        id: 'claude.api_credit_balance',
+        runtime: RUNTIME_TYPES.CLAUDE_CODE,
+        kind: 'billing',
+        all: [/API\s*Error|"type"\s*:\s*"error"/i, /credit\s*balance\s*(?:is\s*)?too\s*low/i],
+    },
+    {
+        id: 'claude.legacy_limit_reached',
+        runtime: RUNTIME_TYPES.CLAUDE_CODE,
+        kind: 'usage_limit',
+        all: [/Claude\s*(?:AI\s*)?usage\s*limit\s*reached\s*(?:\|\s*\d{10}|\.\s*Your\s*limit\s*will\s*reset)/i],
+    },
+    {
+        id: 'claude.hit_your_limit',
+        runtime: RUNTIME_TYPES.CLAUDE_CODE,
+        kind: 'usage_limit',
+        all: [/You['’]ve\s*hit\s*your\s*(?:[\w-]+\s*){0,3}limit/i, CLAUDE_UI_CONTEXT],
+    },
+    {
+        id: 'claude.usage_limit_reached',
+        runtime: RUNTIME_TYPES.CLAUDE_CODE,
+        kind: 'usage_limit',
+        all: [/usage\s*(?:credit\s*)?limit\s*reached/i, CLAUDE_UI_CONTEXT],
+    },
+    {
+        id: 'claude.window_limit_reached',
+        runtime: RUNTIME_TYPES.CLAUDE_CODE,
+        kind: 'usage_limit',
+        all: [/(?:5-hour|five-hour|weekly|session|daily|Opus|Sonnet|Fable)\s*limit\s*reached/i, CLAUDE_UI_CONTEXT],
+    },
+    {
+        id: 'claude.out_of_usage',
+        runtime: RUNTIME_TYPES.CLAUDE_CODE,
+        kind: 'usage_limit',
+        all: [/You['’]re\s*out\s*of\s*(?:extra\s*usage|usage\s*credits)/i, CLAUDE_UI_CONTEXT],
+    },
+    {
+        id: 'claude.api_rate_limited',
+        runtime: RUNTIME_TYPES.CLAUDE_CODE,
+        kind: 'transient',
+        all: [/API\s*Error/i, /\b429\b|rate_limit_error/i],
+    },
+    {
+        id: 'claude.api_overloaded',
+        runtime: RUNTIME_TYPES.CLAUDE_CODE,
+        kind: 'transient',
+        all: [/API\s*Error/i, /\b529\b|overloaded_error/i],
+    },
+];
+/** Codex rules. */
+export const CODEX_USAGE_RULES = [
+    {
+        id: 'codex.usage_limit',
+        runtime: RUNTIME_TYPES.CODEX_CLI,
+        kind: 'usage_limit',
+        all: [/You['’]ve\s*hit\s*your\s*usage\s*limit/i, /try\s*again|upgrade|resets?/i],
+    },
+    {
+        id: 'codex.quota_exceeded',
+        runtime: RUNTIME_TYPES.CODEX_CLI,
+        kind: 'billing',
+        all: [/insufficient_quota|exceeded\s*your\s*current\s*quota/i],
+    },
+    {
+        id: 'codex.rate_limited',
+        runtime: RUNTIME_TYPES.CODEX_CLI,
+        kind: 'transient',
+        all: [/\b429\b\s*Too\s*Many\s*Requests|exceeded\s*retry\s*limit|rate\s*limit\s*reached\s*for/i],
+    },
+];
+/** Gemini quota rules, shared by Antigravity CLI and Gemini CLI. */
+function geminiRules(runtime, prefix) {
+    return [
+        {
+            id: `${prefix}.quota_exceeded`,
+            runtime,
+            kind: 'usage_limit',
+            all: [/exceeded\s*your\s*current\s*quota|exhausted\s*your\s*(?:daily\s*)?quota|quota\s*exceeded\s*for\s*quota\s*metric[^\n]*per\s*day|daily\s*(?:quota|limit)\s*(?:exceeded|reached)/i],
+        },
+        {
+            id: `${prefix}.rate_limited`,
+            runtime,
+            kind: 'transient',
+            all: [/RESOURCE_EXHAUSTED|\b429\b\s*Too\s*Many\s*Requests|status\s*(?:code\s*)?:?\s*429|Resource\s*has\s*been\s*exhausted/i],
+        },
+    ];
+}
+/** Antigravity CLI rules. */
+export const ANTIGRAVITY_USAGE_RULES = geminiRules(RUNTIME_TYPES.ANTIGRAVITY_CLI, 'antigravity');
+/** Gemini CLI rules (retired runtime, detect only). */
+export const GEMINI_USAGE_RULES = geminiRules(RUNTIME_TYPES.GEMINI_CLI, 'gemini');
+/**
+ * In-process Crewly Agent rules. These run on the error of a failed model
+ * call (never on text the model wrote), so they need no UI context.
+ */
+export const CREWLY_AGENT_USAGE_RULES = [
+    {
+        id: 'crewly-agent.insufficient_balance',
+        runtime: RUNTIME_TYPES.CREWLY_AGENT,
+        kind: 'billing',
+        all: [/Insufficient\s*Balance|\b402\b[^\n]*(?:Payment\s*Required|balance)/i],
+    },
+    {
+        id: 'crewly-agent.out_of_credit',
+        runtime: RUNTIME_TYPES.CREWLY_AGENT,
+        kind: 'billing',
+        all: [/insufficient_quota|credit\s*balance\s*(?:is\s*)?too\s*low/i],
+    },
+    {
+        id: 'crewly-agent.quota_exceeded',
+        runtime: RUNTIME_TYPES.CREWLY_AGENT,
+        kind: 'usage_limit',
+        all: [/exceeded\s*your\s*current\s*quota|exhausted\s*your\s*(?:daily\s*)?quota|usage\s*limit\s*reached/i],
+    },
+    {
+        id: 'crewly-agent.rate_limited',
+        runtime: RUNTIME_TYPES.CREWLY_AGENT,
+        kind: 'transient',
+        all: [/statusCode:?\s*429\b|status\s*(?:code\s*)?:?\s*429\b|\b429\s*Too\s*Many|Rate\s*Limit\s*Reached|Too\s*Many\s*Requests|RESOURCE_EXHAUSTED|overloaded_error|\bOverloaded\b/i],
+    },
+];
+/** Rules by runtime. */
+const RULES_BY_RUNTIME = {
+    [RUNTIME_TYPES.CLAUDE_CODE]: CLAUDE_USAGE_RULES,
+    [RUNTIME_TYPES.CODEX_CLI]: CODEX_USAGE_RULES,
+    [RUNTIME_TYPES.ANTIGRAVITY_CLI]: ANTIGRAVITY_USAGE_RULES,
+    [RUNTIME_TYPES.GEMINI_CLI]: GEMINI_USAGE_RULES,
+    [RUNTIME_TYPES.CREWLY_AGENT]: CREWLY_AGENT_USAGE_RULES,
+};
+/**
+ * Usage-limit rules for a runtime.
+ *
+ * @param runtime - Runtime type
+ * @returns Rules to try (empty for a runtime without rules)
+ */
+export function getUsageLimitRules(runtime) {
+    return RULES_BY_RUNTIME[runtime] ?? [];
+}
+/**
+ * Whether a pattern matches the normalized text or its spaceless copy.
+ *
+ * @param pattern - Pattern
+ * @param screen - Normalized screen
+ * @returns True on a match
+ */
+function matches(pattern, screen) {
+    const nonGlobal = new RegExp(pattern.source, pattern.flags.replace('g', ''));
+    return nonGlobal.test(screen.text) || nonGlobal.test(screen.spaceless);
+}
+/**
+ * Find a usage-limit (or transient rate-limit) message in a runtime's output.
+ * An expired login is never reported here — that is the re-login flow's.
+ *
+ * @param output - Raw PTY output (escape sequences allowed), captured screen, or an error message
+ * @param runtime - The runtime the output came from
+ * @param now - Current time (ms), for the reset time
+ * @param defaultTimeZone - Zone for reset clock times that name none
+ * @returns The match, or null
+ *
+ * @example
+ * ```ts
+ * detectUsageLimit("You've hit your limit · resets 3pm (America/Los_Angeles)", 'claude-code');
+ * // { runtime: 'claude-code', ruleId: 'claude.hit_your_limit', kind: 'usage_limit', resetAt: <next 3pm LA> }
+ * ```
+ */
+export function detectUsageLimit(output, runtime, now = Date.now(), defaultTimeZone) {
+    if (!output)
+        return null;
+    const rules = getUsageLimitRules(runtime);
+    if (rules.length === 0)
+        return null;
+    if (detectLoginExpiry(output, runtime === RUNTIME_TYPES.CLAUDE_CODE || runtime === RUNTIME_TYPES.CODEX_CLI ? runtime : null)) {
+        return null;
+    }
+    const screen = normalizeTerminalOutput(output);
+    for (const rule of rules) {
+        if (!rule.all.every((pattern) => matches(pattern, screen)))
+            continue;
+        if (rule.none?.some((pattern) => matches(pattern, screen)))
+            continue;
+        return {
+            runtime: rule.runtime,
+            ruleId: rule.id,
+            kind: rule.kind,
+            // A billing limit has no reset time: it lifts when the owner tops up.
+            resetAt: rule.kind === 'usage_limit' ? parseResetTime(screen.text, now, defaultTimeZone) : null,
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=usage-limit-rules.js.map

package/dist/cli/backend/src/services/runtime-fallback/usage-limit-rules.js.map

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

package/dist/cli/backend/src/services/slack/room-responder.d.ts

@@ -0,0 +1,144 @@
+/**
+ * One responder per owner message in Slack rooms — the pure parts
+ * (specs/2026-10-03-one-responder-per-message.md).
+ *
+ * - {@link threadOwnerFromSlack}: who owns a Slack thread, read from the
+ *   thread itself, so every machine names the same agent.
+ * - {@link findPriorRoomAnswer} / {@link heldReplyMessage}: the reply gate —
+ *   a colleague already answered the owner's latest message in this thread.
+ *
+ * Incident (2026-10-03, #content-team): the owner's un-@'d reply to Atlas's
+ * D-92 reminder resolved the card (delivered to Atlas) and was also
+ * broadcast to the room; Atlas answered, and Ella answered the same thing
+ * six minutes later.
+ *
+ * @module services/slack/room-responder
+ */
+import type { SlackContextMessage, SlackThreadContext } from '../../types/slack.types.js';
+import type { ChatMessageDTO } from '../chat-v2/types.js';
+/** An agent of the room, on this machine or another. */
+export interface RoomAgentRef {
+    /** Session name (as this machine knows it; Cloud's for a remote agent) */
+    session: string;
+    /** Display name */
+    name: string;
+    /** Whether it runs on this machine */
+    local: boolean;
+}
+/** What {@link buildRoomAgentDirectory} needs. */
+export interface RoomAgentDirectoryInput {
+    /** This machine's room members, with their own bot user id when installed */
+    local: ReadonlyArray<{
+        session: string;
+        name: string;
+        botUserId?: string | null;
+    }>;
+    /** Room members on other machines (Cloud's room roster minus this machine) */
+    remote: ReadonlyArray<{
+        session: string;
+        name: string;
+    }>;
+}
+/** Maps Slack authors and names to room agents. */
+export interface RoomAgentDirectory {
+    /** The agent that wrote a Slack message, or null (a person, an unknown bot, or an unclear name) */
+    authorOf(m: SlackContextMessage): RoomAgentRef | null;
+}
+/**
+ * Whether two display names name the same agent: equal (case-insensitive),
+ * or one is the other plus a team suffix — "Ella" / "Ella (Crewly Marketing)".
+ *
+ * @param a - A name
+ * @param b - Another name
+ * @returns True when they match
+ */
+export declare function sameAgentName(a: string, b: string): boolean;
+/**
+ * Build the directory every machine uses to read the same thread the same way.
+ *
+ * A post by a local agent's own bot is that agent. Any other bot post is
+ * matched by name against the remote members — and against local members
+ * when it was posted with a username override (an agent with no app of its
+ * own). A name that matches several agents is unclear and maps to nobody.
+ *
+ * @param input - Local and remote room members
+ * @returns The directory
+ */
+export declare function buildRoomAgentDirectory(input: RoomAgentDirectoryInput): RoomAgentDirectory;
+/**
+ * Whether a Slack post is a decision card or a card reminder — the post an
+ * owner's reply in that thread answers. Cards carry `Decision D-n` (or
+ * `[D-n]` when titled by a ticket); the reminder says "Still waiting on you".
+ *
+ * @param text - Normalised Slack text
+ * @returns True for a card or reminder
+ */
+export declare function isDecisionCardText(text: string): boolean;
+/** Who owns a Slack thread, and by which rule. */
+export interface SlackThreadOwner {
+    agent: RoomAgentRef;
+    /**
+     * `card`: a decision card / reminder went up since a person last spoke —
+     * the reply answers it, and the card's machine handles it whatever Cloud's
+     * presence says. `last-speaker`: the agent that spoke last.
+     */
+    via: 'card' | 'last-speaker';
+}
+/**
+ * Who owns a Slack thread (specs/2026-10-03-one-responder-per-message.md §1 c):
+ *
+ * 1. a decision card or reminder an agent posted since a person last spoke
+ *    in the thread — the reply answers that card (the decision path's own
+ *    rule, read from Slack so every machine agrees);
+ * 2. otherwise the agent that spoke last (owner's rule, 2026-09-21: a bare
+ *    follow-up addresses whoever just spoke).
+ *
+ * @param ctx - The Slack thread before the owner's message (oldest first)
+ * @param dir - Room directory
+ * @returns The owner and the rule, or null when no agent has spoken in the thread
+ */
+export declare function threadOwnerFromSlack(ctx: SlackThreadContext | null | undefined, dir: RoomAgentDirectory): SlackThreadOwner | null;
+/** An answer already in the thread after the owner's latest message. */
+export interface PriorRoomAnswer {
+    /** Who wrote it (display name when known, else its session) */
+    by: string;
+    /** The agent's session (local) or the recorded sender id (a colleague's Slack post) */
+    bySession: string;
+    /** The start of the answer */
+    excerpt: string;
+    /** Its chat message id */
+    messageId: string;
+}
+/**
+ * The responders the harness chose for a room message, as recorded on its row.
+ *
+ * @param m - Chat row
+ * @returns Sessions (local or Cloud names), empty when none was recorded
+ */
+export declare function chosenRespondersOf(m: Pick<ChatMessageDTO, 'metadata'>): string[];
+/**
+ * The reply gate (specs/2026-10-03-one-responder-per-message.md §2). A post
+ * is held only when ALL of these hold:
+ *
+ * - the owner's latest message in the thread has recorded responders, and
+ *   the agent posting is not one of them nor @'d in it;
+ * - the agent owes no earlier owner message in this thread (it was the
+ *   responder for, or @'d in, one it has not posted after);
+ * - one of those responders already answered (an interim note is not an
+ *   answer), and that answer does not @ the agent posting.
+ *
+ * @param thread - The thread's rows, oldest first
+ * @param session - The agent about to post
+ * @param nameFor - Display name of a session, when known
+ * @returns The responder's answer when the post should be held, else null
+ */
+export declare function findPriorRoomAnswer(thread: readonly ChatMessageDTO[], session: string, nameFor?: (session: string) => string | undefined): PriorRoomAnswer | null;
+/**
+ * What the agent is told when its post is held. Never "drop it": an agent
+ * that was asked must still be able to answer.
+ *
+ * @param prior - The answer already there
+ * @returns English harness text
+ */
+export declare function heldReplyMessage(prior: Pick<PriorRoomAnswer, 'by' | 'excerpt'>): string;
+//# sourceMappingURL=room-responder.d.ts.map

package/dist/cli/backend/src/services/slack/room-responder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-responder.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/slack/room-responder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,kDAAkD;AAClD,MAAM,WAAW,uBAAuB;IACtC,6EAA6E;IAC7E,KAAK,EAAE,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACnF,8EAA8E;IAC9E,MAAM,EAAE,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,mGAAmG;IACnG,QAAQ,CAAC,CAAC,EAAE,mBAAmB,GAAG,YAAY,GAAG,IAAI,CAAC;CACvD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAqB1F;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB;;;;OAIG;IACH,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC;CAC9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,IAAI,CAoBjI;AAED,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAkBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG,MAAM,EAAE,CAGhF;AAkBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAChD,eAAe,GAAG,IAAI,CAwCxB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAKvF"}