crewly 1.20.186 → 1.20.188

package/dist/backend/backend/src/services/spend/spend-cap-command.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Token caps and boosts from the owner's DM with the orc. Handled by the
+ * backend, not the orc — so it works while the orc itself is stopped:
+ *
+ * Caps (amounts in tokens: `5M`, `500k`, `2000万`, `5000000`):
+ * - `set daily cap for Ella to 5M` / `set daily cap to 5M` (default per agent)
+ * - `set team cap for CE to 50M` / `set daily cap for team CE to 50M`
+ * - `set daily total cap to 200M` (all agents together)
+ * - `remove daily cap for Ella` / `remove team cap for CE` / `remove daily cap` / `remove daily total cap`
+ *
+ * Boosts (until local midnight):
+ * - `boost CE by 20M today` / `boost Ella by 5M` / `boost everyone by 10M today`
+ * - `unlimited today for everyone` / `unlimited today for CE` / `CE unlimited today`
+ * - `放开 CE 今天` / `今天放开 CE` / `今天全部放开` / `给 CE 加 20M` / `CE 今天加 2000万`
+ *
+ * A target is everyone, a team (by name) or an agent (by name / session);
+ * a name that is both a team and an agent means the team. Replies are
+ * English (harness text rule).
+ *
+ * While the orc is stopped by a cap, every other owner DM to it gets one
+ * harness line saying so (the message itself stays queued for the orc).
+ *
+ * specs/2026-10-02-spend-cap.md
+ *
+ * @module services/spend/spend-cap-command
+ */
+import type { SlackIncomingMessage } from '../../types/slack.types.js';
+import { type SpendStop } from './spend-cap.gate.js';
+import { type BoostInput, type SpendCapPatch } from './spend-cap.service.js';
+/** A parsed command. `target` is the name as typed (resolved later). */
+export type SpendCapCommand = {
+    kind: 'set';
+    target: string | null;
+    team?: boolean;
+    tokens: number;
+} | {
+    kind: 'set_total';
+    tokens: number;
+} | {
+    kind: 'remove';
+    target: string | null;
+    team?: boolean;
+} | {
+    kind: 'remove_total';
+} | {
+    kind: 'boost';
+    target: string;
+    tokens: number;
+} | {
+    kind: 'unlimited';
+    target: string;
+} | {
+    kind: 'usd_hint';
+};
+/**
+ * Parse a cap / boost command.
+ *
+ * @param text - Message text
+ * @returns The command, or null when the message is not one
+ *
+ * @example
+ * parseSpendCapCommand('boost CE by 20M today') // { kind: 'boost', target: 'ce', tokens: 20000000 }
+ * parseSpendCapCommand('放开 CE 今天') // { kind: 'unlimited', target: 'ce' }
+ */
+export declare function parseSpendCapCommand(text: string | undefined): SpendCapCommand | null;
+/** An agent the owner can name. */
+export interface NamedAgent {
+    session: string;
+    name: string;
+}
+/** A team the owner can name. */
+export interface NamedTeam {
+    id: string;
+    name: string;
+}
+/**
+ * Resolve the agent the owner named.
+ *
+ * @param who - Session name, member name, or "orc" / "orchestrator"
+ * @param agents - Configured agents
+ * @returns Session, or null when unknown / ambiguous
+ */
+export declare function resolveAgent(who: string, agents: NamedAgent[]): string | null;
+/**
+ * Resolve the team the owner named.
+ *
+ * @param who - Team name or id (`team CE` works too)
+ * @param teams - Teams
+ * @returns Team, or null when unknown / ambiguous
+ */
+export declare function resolveTeam(who: string, teams: NamedTeam[]): NamedTeam | null;
+/** What the interceptor needs. */
+export interface SpendCapCommandDeps {
+    /** `orc` when the message is the owner writing in their DM with the orc */
+    ownerDmScope: (message: SlackIncomingMessage) => 'orc' | 'agent' | null;
+    replyTargetOf: (message: SlackIncomingMessage) => unknown;
+    reply: (text: string, target: unknown) => Promise<unknown>;
+    /** Configured agents (orc included) */
+    agents: () => Promise<NamedAgent[]>;
+    teams: () => Promise<NamedTeam[]>;
+    setCaps: (patch: SpendCapPatch) => Promise<unknown>;
+    boost: (input: BoostInput) => Promise<unknown>;
+    /** The orc's stop, or null */
+    orcStop: () => SpendStop | null;
+    onError?: (err: unknown) => void;
+}
+/**
+ * The orc's harness line while it is stopped by a cap.
+ *
+ * @param stop - The orc's stop
+ * @returns One line
+ */
+export declare function orcCappedReply(stop: SpendStop): string;
+/**
+ * Run a parsed command.
+ *
+ * @param cmd - Command
+ * @param deps - Collaborators
+ * @returns The owner's one-line answer
+ */
+export declare function runSpendCapCommand(cmd: SpendCapCommand, deps: Pick<SpendCapCommandDeps, 'agents' | 'teams' | 'setCaps' | 'boost'>): Promise<string>;
+/**
+ * The Slack bridge interceptor for the owner's orc DM.
+ *
+ * @param deps - Collaborators
+ * @returns Interceptor: true when the message was a cap command (consumed)
+ */
+export declare function createSpendCapInterceptor(deps: SpendCapCommandDeps): (message: SlackIncomingMessage) => boolean;
+//# sourceMappingURL=spend-cap-command.d.ts.map

package/dist/backend/backend/src/services/spend/spend-cap-command.d.ts.map

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

package/dist/backend/backend/src/services/spend/spend-cap-command.js

@@ -0,0 +1,323 @@
+/**
+ * Token caps and boosts from the owner's DM with the orc. Handled by the
+ * backend, not the orc — so it works while the orc itself is stopped:
+ *
+ * Caps (amounts in tokens: `5M`, `500k`, `2000万`, `5000000`):
+ * - `set daily cap for Ella to 5M` / `set daily cap to 5M` (default per agent)
+ * - `set team cap for CE to 50M` / `set daily cap for team CE to 50M`
+ * - `set daily total cap to 200M` (all agents together)
+ * - `remove daily cap for Ella` / `remove team cap for CE` / `remove daily cap` / `remove daily total cap`
+ *
+ * Boosts (until local midnight):
+ * - `boost CE by 20M today` / `boost Ella by 5M` / `boost everyone by 10M today`
+ * - `unlimited today for everyone` / `unlimited today for CE` / `CE unlimited today`
+ * - `放开 CE 今天` / `今天放开 CE` / `今天全部放开` / `给 CE 加 20M` / `CE 今天加 2000万`
+ *
+ * A target is everyone, a team (by name) or an agent (by name / session);
+ * a name that is both a team and an agent means the team. Replies are
+ * English (harness text rule).
+ *
+ * While the orc is stopped by a cap, every other owner DM to it gets one
+ * harness line saying so (the message itself stays queued for the orc).
+ *
+ * specs/2026-10-02-spend-cap.md
+ *
+ * @module services/spend/spend-cap-command
+ */
+import { ORCHESTRATOR_SESSION_NAME } from '../../constants.js';
+import { compactTokens, formatTokens, parseTokenAmount } from '../usage/token-format.js';
+import { spendCapReason } from './spend-cap.gate.js';
+import { suggestedBoost } from './spend-cap.service.js';
+/** A name a boost may target from free text: short ASCII, or an "everyone" word. */
+const NAME = /^[a-z0-9][a-z0-9 _.@-]{0,39}$/;
+/**
+ * Whether free text after a boost keyword is a plausible target (so an
+ * ordinary sentence that happens to start with 放开 / ends with "unlimited
+ * today" still goes to the orc).
+ *
+ * @param who - Candidate target
+ * @returns True when it may be a team / agent name or "everyone"
+ */
+function plausibleTarget(who) {
+    return EVERYONE.has(who) || NAME.test(who);
+}
+/** Words for "everyone". */
+const EVERYONE = new Set(['everyone', 'everybody', 'all', 'all agents', 'every agent', 'the whole crew', 'total', '所有人', '全部', '大家', '所有', '全员', '全部人']);
+const AMOUNT = String.raw `(\d+(?:\.\d+)?\s*(?:k|m|mil|million|b|bn|billion|万|亿)?)(?:\s*tokens?)?`;
+const CAP = String.raw `(?:daily\s+)?(?:token\s+|spend(?:ing)?\s+|usage\s+)?cap`;
+const TODAY = String.raw `(?:\s*(?:for\s+)?today)?`;
+/**
+ * Normalise a message for matching.
+ *
+ * @param text - Raw text
+ * @returns Lower-cased, mentions and trailing punctuation removed
+ */
+function norm(text) {
+    return text
+        .replace(/<@[A-Z0-9]+>/g, '')
+        .replace(/[`*_]/g, '')
+        .toLowerCase()
+        .replace(/[\s.。!！~～]+$/u, '')
+        .replace(/^(?:please|pls|请)\s*/u, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Amount text → tokens.
+ *
+ * @param text - e.g. `20m`, `2000万`
+ * @returns Tokens, or null
+ */
+function amount(text) {
+    return parseTokenAmount(text.replace(/\s+/g, ''));
+}
+/**
+ * Parse a cap / boost command.
+ *
+ * @param text - Message text
+ * @returns The command, or null when the message is not one
+ *
+ * @example
+ * parseSpendCapCommand('boost CE by 20M today') // { kind: 'boost', target: 'ce', tokens: 20000000 }
+ * parseSpendCapCommand('放开 CE 今天') // { kind: 'unlimited', target: 'ce' }
+ */
+export function parseSpendCapCommand(text) {
+    if (!text)
+        return null;
+    const t = norm(text);
+    if (!t)
+        return null;
+    let m;
+    const num = (s) => amount(s);
+    // ---- caps
+    m = new RegExp(String.raw `^set (?:the )?(?:daily total|total daily|total)(?: token| spend(?:ing)?)? cap to ${AMOUNT}$`).exec(t);
+    if (m && num(m[1]))
+        return { kind: 'set_total', tokens: num(m[1]) };
+    m = new RegExp(String.raw `^set (?:the )?(?:daily )?team (?:token )?cap for (.+?) to ${AMOUNT}(?: (?:a|per) day)?$`).exec(t);
+    if (m && num(m[2]))
+        return { kind: 'set', target: m[1].trim(), team: true, tokens: num(m[2]) };
+    m = new RegExp(String.raw `^set (?:the )?${CAP} for team (.+?) to ${AMOUNT}(?: (?:a|per) day)?$`).exec(t);
+    if (m && num(m[2]))
+        return { kind: 'set', target: m[1].trim(), team: true, tokens: num(m[2]) };
+    m = new RegExp(String.raw `^set (?:the )?${CAP}(?: for (.+?))? to ${AMOUNT}(?: (?:a|per) day)?$`).exec(t);
+    if (m && num(m[2]))
+        return { kind: 'set', target: m[1]?.trim() || null, tokens: num(m[2]) };
+    m = /^(?:remove|clear|turn off|disable) (?:the )?(?:daily total|total daily|total)(?: token| spend(?:ing)?)? cap$/.exec(t);
+    if (m)
+        return { kind: 'remove_total' };
+    m = /^(?:remove|clear|turn off|disable) (?:the )?(?:daily )?team cap for (.+)$/.exec(t) ?? new RegExp(String.raw `^(?:remove|clear|turn off|disable) (?:the )?${CAP} for team (.+)$`).exec(t);
+    if (m)
+        return { kind: 'remove', target: m[1].trim(), team: true };
+    m = new RegExp(String.raw `^(?:remove|clear|turn off|disable) (?:the )?${CAP}(?: for (.+))?$`).exec(t);
+    if (m)
+        return { kind: 'remove', target: m[1]?.trim() || null };
+    // ---- boosts (English)
+    m = new RegExp(String.raw `^boost (.+?) (?:by |\+)\s*${AMOUNT}${TODAY}$`).exec(t);
+    if (m && num(m[2]))
+        return { kind: 'boost', target: m[1].trim(), tokens: num(m[2]) };
+    m = new RegExp(String.raw `^give (.+?) (?:\+)?${AMOUNT} (?:more|extra)${TODAY}$`).exec(t);
+    if (m && num(m[2]))
+        return { kind: 'boost', target: m[1].trim(), tokens: num(m[2]) };
+    m = /^(?:unlimited|no (?:token )?cap|no limit)(?: tokens?)? (?:for )?today(?: for (.+))?$/.exec(t);
+    if (m)
+        return { kind: 'unlimited', target: m[1]?.trim() || 'everyone' };
+    m = /^(?:unlimited|no (?:token )?cap|no limit) (?:tokens? )?for (.+?)(?: (?:for )?today)?$/.exec(t);
+    if (m)
+        return { kind: 'unlimited', target: m[1].trim() };
+    m = /^(?:lift|remove|drop) (?:the )?(?:daily )?(?:token )?caps? (?:for|on) (.+?) (?:for )?today$/.exec(t);
+    if (m)
+        return { kind: 'unlimited', target: m[1].trim() };
+    m = /^(.+?) unlimited today$/.exec(t);
+    if (m && plausibleTarget(m[1].trim()))
+        return { kind: 'unlimited', target: m[1].trim() };
+    // ---- boosts (Chinese)
+    const zh = t.replace(/\s+/g, ' ');
+    m = /^(?:今天)?\s*(?:全部|全都|所有人|大家)?\s*放开(?:吧)?\s*(.*?)\s*(?:今天|今日)?(?:吧)?$/u.exec(zh);
+    if (m) {
+        const who = m[1].trim();
+        const all = /^(?:今天|今日)?\s*(?:全部|全都|所有人|大家)/u.test(zh) || EVERYONE.has(who) || who === '';
+        if (all)
+            return { kind: 'unlimited', target: 'everyone' };
+        if (plausibleTarget(who))
+            return { kind: 'unlimited', target: who };
+    }
+    m = /^(.+?)\s*(?:今天|今日)\s*(?:不限|不封顶|放开)$/u.exec(zh);
+    if (m && plausibleTarget(m[1].trim()))
+        return { kind: 'unlimited', target: m[1].trim() };
+    m = new RegExp(String.raw `^(?:今天)?\s*给\s*(.+?)\s*(?:今天)?\s*(?:加|多加|增加)\s*${AMOUNT}$`, 'u').exec(zh);
+    if (m && num(m[2]) && plausibleTarget(m[1].trim()))
+        return { kind: 'boost', target: m[1].trim(), tokens: num(m[2]) };
+    m = new RegExp(String.raw `^(.+?)\s*(?:今天|今日)\s*(?:加|多加|增加)\s*${AMOUNT}$`, 'u').exec(zh);
+    if (m && num(m[2]) && plausibleTarget(m[1].trim()))
+        return { kind: 'boost', target: m[1].trim(), tokens: num(m[2]) };
+    // ---- the pre-token dollar forms: answer with the token form instead of passing them on
+    if (/^(?:set|raise|remove) .*cap.*\$\s*\d/.test(t))
+        return { kind: 'usd_hint' };
+    return null;
+}
+/**
+ * Resolve the agent the owner named.
+ *
+ * @param who - Session name, member name, or "orc" / "orchestrator"
+ * @param agents - Configured agents
+ * @returns Session, or null when unknown / ambiguous
+ */
+export function resolveAgent(who, agents) {
+    const w = who.trim().toLowerCase().replace(/^@/, '');
+    if (['orc', 'the orc', 'orchestrator', 'the orchestrator', 'crewly orc', ORCHESTRATOR_SESSION_NAME].includes(w))
+        return ORCHESTRATOR_SESSION_NAME;
+    const bySession = agents.find((a) => a.session.toLowerCase() === w);
+    if (bySession)
+        return bySession.session;
+    const byName = agents.filter((a) => a.name.toLowerCase() === w);
+    return byName.length === 1 ? byName[0].session : null;
+}
+/**
+ * Resolve the team the owner named.
+ *
+ * @param who - Team name or id (`team CE` works too)
+ * @param teams - Teams
+ * @returns Team, or null when unknown / ambiguous
+ */
+export function resolveTeam(who, teams) {
+    const w = who.trim().toLowerCase().replace(/^(?:the )?team\s+/, '').replace(/\s+team$/, '');
+    const byId = teams.find((t) => t.id.toLowerCase() === w);
+    if (byId)
+        return byId;
+    const byName = teams.filter((t) => t.name.toLowerCase() === w);
+    return byName.length === 1 ? byName[0] : null;
+}
+/**
+ * The orc's harness line while it is stopped by a cap.
+ *
+ * @param stop - The orc's stop
+ * @returns One line
+ */
+export function orcCappedReply(stop) {
+    const extra = compactTokens(suggestedBoost(stop.capTokens));
+    const who = stop.scope === 'total' ? 'everyone' : stop.scope === 'team' ? (stop.teamName ?? 'the team') : 'orc';
+    return `${spendCapReason(stop, 'Orc')}. No new turns start until midnight; your message is queued. To lift it for today, reply \`boost ${who} by ${extra} today\` or \`unlimited today for ${who}\` (or Settings → System → Usage).`;
+}
+/**
+ * Run a parsed command.
+ *
+ * @param cmd - Command
+ * @param deps - Collaborators
+ * @returns The owner's one-line answer
+ */
+export async function runSpendCapCommand(cmd, deps) {
+    const agents = await deps.agents();
+    const teams = await deps.teams();
+    const agentOf = (target) => {
+        const session = resolveAgent(target, agents);
+        if (!session)
+            return null;
+        return { session, name: session === ORCHESTRATOR_SESSION_NAME ? 'Orc' : (agents.find((a) => a.session === session)?.name ?? session) };
+    };
+    const unknown = (target) => `I don't know a team or agent called "${target}". Use a team name (e.g. ${teams[0]?.name ?? 'CE'}), an agent's name or session name, or "everyone".`;
+    const resolve = (target, preferTeam) => {
+        if (EVERYONE.has(target.trim().toLowerCase()))
+            return { scope: 'all' };
+        const team = resolveTeam(target, teams);
+        const agent = agentOf(target);
+        if (team && (preferTeam || !agent))
+            return { scope: 'team', team };
+        if (agent)
+            return { scope: 'agent', ...agent };
+        return unknown(target);
+    };
+    const label = (t) => (t.scope === 'all' ? 'everyone' : t.scope === 'team' ? `team ${t.team.name}` : t.name);
+    const boostInput = (t) => t.scope === 'all' ? { scope: 'all' } : t.scope === 'team' ? { scope: 'team', id: t.team.id } : { scope: 'agent', id: t.session };
+    switch (cmd.kind) {
+        case 'usd_hint':
+            return 'Caps are counted in tokens now, not dollars. Try `set daily cap for orc to 5M`, `set team cap for CE to 50M`, or `boost CE by 20M today`.';
+        case 'set_total':
+            await deps.setCaps({ totalCapTokens: cmd.tokens });
+            return `Daily token cap set to ${formatTokens(cmd.tokens)} for all agents together.`;
+        case 'remove_total':
+            await deps.setCaps({ totalCapTokens: null });
+            return 'Daily total token cap removed.';
+        case 'set': {
+            if (!cmd.target) {
+                await deps.setCaps({ defaultAgentCapTokens: cmd.tokens });
+                return `Daily token cap set to ${formatTokens(cmd.tokens)} per agent (agents with their own cap keep it).`;
+            }
+            const t = resolve(cmd.target, cmd.team === true);
+            if (typeof t === 'string')
+                return t;
+            if (t.scope === 'all') {
+                await deps.setCaps({ totalCapTokens: cmd.tokens });
+                return `Daily token cap set to ${formatTokens(cmd.tokens)} for all agents together.`;
+            }
+            if (t.scope === 'team') {
+                await deps.setCaps({ teams: { [t.team.id]: cmd.tokens } });
+                return `Daily token cap for team ${t.team.name} set to ${formatTokens(cmd.tokens)} (all its members together).`;
+            }
+            await deps.setCaps({ agents: { [t.session]: cmd.tokens } });
+            return `Daily token cap for ${t.name} set to ${formatTokens(cmd.tokens)}.`;
+        }
+        case 'remove': {
+            if (!cmd.target) {
+                await deps.setCaps({ defaultAgentCapTokens: null });
+                return 'Default daily token cap removed (agents with their own cap keep it).';
+            }
+            const t = resolve(cmd.target, cmd.team === true);
+            if (typeof t === 'string')
+                return t;
+            if (t.scope === 'all') {
+                await deps.setCaps({ totalCapTokens: null });
+                return 'Daily total token cap removed.';
+            }
+            if (t.scope === 'team') {
+                await deps.setCaps({ teams: { [t.team.id]: null } });
+                return `Team ${t.team.name} has no daily token cap now.`;
+            }
+            await deps.setCaps({ agents: { [t.session]: null } });
+            return `${t.name} has no daily token cap now.`;
+        }
+        case 'boost': {
+            const t = resolve(cmd.target, true);
+            if (typeof t === 'string')
+                return t;
+            await deps.boost({ ...boostInput(t), extraTokens: cmd.tokens, by: 'orc-dm' });
+            return `Boosted ${label(t)} by +${formatTokens(cmd.tokens)} until midnight. Queued messages are being delivered.`;
+        }
+        case 'unlimited': {
+            const t = resolve(cmd.target, true);
+            if (typeof t === 'string')
+                return t;
+            await deps.boost({ ...boostInput(t), unlimited: true, by: 'orc-dm' });
+            return `No token cap for ${label(t)} until midnight. Queued messages are being delivered.`;
+        }
+    }
+}
+/**
+ * The Slack bridge interceptor for the owner's orc DM.
+ *
+ * @param deps - Collaborators
+ * @returns Interceptor: true when the message was a cap command (consumed)
+ */
+export function createSpendCapInterceptor(deps) {
+    return (message) => {
+        if (deps.ownerDmScope(message) !== 'orc')
+            return false;
+        const target = deps.replyTargetOf(message);
+        const cmd = message.hasFiles ? null : parseSpendCapCommand(message.text);
+        if (cmd) {
+            void runSpendCapCommand(cmd, deps)
+                .then((text) => deps.reply(text, target))
+                .catch((err) => {
+                deps.onError?.(err);
+                return deps.reply(`Couldn't change the cap: ${err instanceof Error ? err.message : String(err)}`, target).catch(() => undefined);
+            });
+            return true;
+        }
+        const stop = deps.orcStop();
+        if (stop) {
+            // Not consumed: the message goes on to the orc's queue and waits there.
+            void deps.reply(orcCappedReply(stop), target).catch((err) => deps.onError?.(err));
+        }
+        return false;
+    };
+}
+//# sourceMappingURL=spend-cap-command.js.map

package/dist/backend/backend/src/services/spend/spend-cap-command.js.map

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

package/dist/backend/backend/src/services/spend/spend-cap.gate.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Token cap gate — the process-wide hook the delivery and wake paths ask
+ * "may this agent start a new turn?". Kept apart from the service so the
+ * hot paths (agent registration, the orc queue processor, the owner-message
+ * watchdog) import a tiny module with no dependencies of its own.
+ *
+ * specs/2026-10-02-spend-cap.md
+ *
+ * @module services/spend/spend-cap.gate
+ */
+/** Why an agent may not start a new turn today. */
+export interface SpendStop {
+    session: string;
+    /** `agent`: its own cap; `team`: its team's cap; `total`: the all-agents cap */
+    scope: 'agent' | 'team' | 'total';
+    /** The cap in force (tokens, boosts included) */
+    capTokens: number;
+    /** Tokens used today against it */
+    usedTokens: number;
+    /** For a team stop: the team */
+    teamId?: string;
+    teamName?: string;
+}
+/** What the service exposes to the gate. */
+export interface SpendCapGate {
+    /** The stop in force for a session, or null when it may run */
+    stopOf(session: string): SpendStop | null;
+    /** Owner-facing name of a session ("Orc", "Ella") */
+    displayNameOf?(session: string): string;
+}
+/**
+ * Install (or clear) the gate.
+ *
+ * @param next - Gate, or null
+ */
+export declare function setSpendCapGate(next: SpendCapGate | null): void;
+/**
+ * The stop in force for a session. Never throws: a broken gate lets the
+ * agent run rather than silently dropping its work.
+ *
+ * @param session - Agent session
+ * @returns Stop, or null
+ */
+export declare function spendCapStopOf(session: string): SpendStop | null;
+/**
+ * Owner-facing name of a session.
+ *
+ * @param session - Agent session
+ * @returns Name (the session name when unknown)
+ */
+export declare function spendCapNameOf(session: string): string;
+/**
+ * The one-line reason, e.g. "Orc hit its daily token cap (5M tokens)".
+ *
+ * @param stop - The stop
+ * @param name - Owner-facing name (default: looked up)
+ * @returns Reason text
+ */
+export declare function spendCapReason(stop: SpendStop, name?: string): string;
+//# sourceMappingURL=spend-cap.gate.d.ts.map

package/dist/backend/backend/src/services/spend/spend-cap.gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-cap.gate.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/spend/spend-cap.gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC1C,qDAAqD;IACrD,aAAa,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACzC;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAMhE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE,MAAqC,GAAG,MAAM,CAQnG"}

package/dist/backend/backend/src/services/spend/spend-cap.gate.js

@@ -0,0 +1,66 @@
+/**
+ * Token cap gate — the process-wide hook the delivery and wake paths ask
+ * "may this agent start a new turn?". Kept apart from the service so the
+ * hot paths (agent registration, the orc queue processor, the owner-message
+ * watchdog) import a tiny module with no dependencies of its own.
+ *
+ * specs/2026-10-02-spend-cap.md
+ *
+ * @module services/spend/spend-cap.gate
+ */
+import { formatTokens } from '../usage/token-format.js';
+let gate = null;
+/**
+ * Install (or clear) the gate.
+ *
+ * @param next - Gate, or null
+ */
+export function setSpendCapGate(next) {
+    gate = next;
+}
+/**
+ * The stop in force for a session. Never throws: a broken gate lets the
+ * agent run rather than silently dropping its work.
+ *
+ * @param session - Agent session
+ * @returns Stop, or null
+ */
+export function spendCapStopOf(session) {
+    try {
+        return gate?.stopOf(session) ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Owner-facing name of a session.
+ *
+ * @param session - Agent session
+ * @returns Name (the session name when unknown)
+ */
+export function spendCapNameOf(session) {
+    try {
+        return gate?.displayNameOf?.(session) || session;
+    }
+    catch {
+        return session;
+    }
+}
+/**
+ * The one-line reason, e.g. "Orc hit its daily token cap (5M tokens)".
+ *
+ * @param stop - The stop
+ * @param name - Owner-facing name (default: looked up)
+ * @returns Reason text
+ */
+export function spendCapReason(stop, name = spendCapNameOf(stop.session)) {
+    if (stop.scope === 'total') {
+        return `${name} is stopped: all agents together hit the daily token cap (${formatTokens(stop.capTokens)})`;
+    }
+    if (stop.scope === 'team') {
+        return `${name} is stopped: team ${stop.teamName ?? stop.teamId ?? ''} hit its daily token cap (${formatTokens(stop.capTokens)})`;
+    }
+    return `${name} hit its daily token cap (${formatTokens(stop.capTokens)})`;
+}
+//# sourceMappingURL=spend-cap.gate.js.map

package/dist/backend/backend/src/services/spend/spend-cap.gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-cap.gate.js","sourceRoot":"","sources":["../../../../../../backend/src/services/spend/spend-cap.gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAwBxD,IAAI,IAAI,GAAwB,IAAI,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAyB;IACvD,IAAI,GAAG,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,aAAa,EAAE,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAe,EAAE,OAAe,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;IACzF,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;QAC3B,OAAO,GAAG,IAAI,6DAA6D,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;IAC7G,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,GAAG,IAAI,qBAAqB,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,6BAA6B,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;IACpI,CAAC;IACD,OAAO,GAAG,IAAI,6BAA6B,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;AAC7E,CAAC"}