crewly 1.20.186 → 1.20.187

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

@@ -0,0 +1,99 @@
+/**
+ * Spend caps from the owner's DM with the orc. Handled by the backend, not
+ * the orc — so it works while the orc itself is stopped by its cap:
+ *
+ * - `set daily cap for crewly-orc to $5` / `set daily cap for Ella to 3`
+ * - `set daily cap to $5` (the default for every agent)
+ * - `set daily total cap to $20` (all agents together)
+ * - `remove daily cap for Ella` / `remove daily cap` / `remove daily total cap`
+ * - `raise cap for orc to $10 today` / `raise total cap to $40 today`
+ *
+ * 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 SpendCapPatch } from './spend-cap.service.js';
+/** A parsed command. */
+export type SpendCapCommand = {
+    kind: 'set';
+    target: string | null;
+    usd: number;
+} | {
+    kind: 'set_total';
+    usd: number;
+} | {
+    kind: 'remove';
+    target: string | null;
+} | {
+    kind: 'remove_total';
+} | {
+    kind: 'raise';
+    target: string;
+    usd: number;
+};
+/**
+ * Parse a spend cap command.
+ *
+ * @param text - Message text
+ * @returns The command, or null when the message is not one
+ *
+ * @example
+ * parseSpendCapCommand('set daily cap for crewly-orc to $5') // { kind: 'set', target: 'crewly-orc', usd: 5 }
+ * parseSpendCapCommand('raise cap for orc to $10 today') // { kind: 'raise', target: 'orc', usd: 10 }
+ */
+export declare function parseSpendCapCommand(text: string | undefined): SpendCapCommand | null;
+/** An agent the owner can name. */
+export interface NamedAgent {
+    session: 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;
+/** 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[]>;
+    setCaps: (patch: SpendCapPatch) => Promise<unknown>;
+    raiseToday: (target: string, usd: number) => Promise<number>;
+    /** 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' | 'setCaps' | 'raiseToday'>): 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":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5E,wBAAwB;AACxB,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAsBnD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,IAAI,CAmBrF;AAED,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,GAAG,IAAI,CAO7E;AAED,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,YAAY,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC;IACxE,aAAa,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC;IAC1D,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,uCAAuC;IACvC,MAAM,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,8BAA8B;IAC9B,OAAO,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAItD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CA8CpJ;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAqB/G"}

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

@@ -0,0 +1,190 @@
+/**
+ * Spend caps from the owner's DM with the orc. Handled by the backend, not
+ * the orc — so it works while the orc itself is stopped by its cap:
+ *
+ * - `set daily cap for crewly-orc to $5` / `set daily cap for Ella to 3`
+ * - `set daily cap to $5` (the default for every agent)
+ * - `set daily total cap to $20` (all agents together)
+ * - `remove daily cap for Ella` / `remove daily cap` / `remove daily total cap`
+ * - `raise cap for orc to $10 today` / `raise total cap to $40 today`
+ *
+ * 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, SPEND_CAP_CONSTANTS as C } from '../../constants.js';
+import { formatUsd, spendCapReason } from './spend-cap.gate.js';
+import { suggestedRaise } from './spend-cap.service.js';
+const AMOUNT = String.raw `\$?\s*(\d+(?:\.\d{1,2})?)\s*(?:usd|dollars?)?`;
+const CAP = String.raw `(?:daily\s+)?(?:spend(?:ing)?\s+)?cap`;
+/**
+ * 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+/, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Parse a spend cap command.
+ *
+ * @param text - Message text
+ * @returns The command, or null when the message is not one
+ *
+ * @example
+ * parseSpendCapCommand('set daily cap for crewly-orc to $5') // { kind: 'set', target: 'crewly-orc', usd: 5 }
+ * parseSpendCapCommand('raise cap for orc to $10 today') // { kind: 'raise', target: 'orc', usd: 10 }
+ */
+export function parseSpendCapCommand(text) {
+    if (!text)
+        return null;
+    const t = norm(text);
+    let m = new RegExp(String.raw `^set (?:the )?(?:daily total|total daily|total)(?: spend(?:ing)?)? cap to ${AMOUNT}$`).exec(t);
+    if (m)
+        return { kind: 'set_total', usd: Number(m[1]) };
+    m = new RegExp(String.raw `^set (?:the )?${CAP}(?: for (.+?))? to ${AMOUNT}(?: (?:a|per) day)?$`).exec(t);
+    if (m)
+        return { kind: 'set', target: m[1]?.trim() || null, usd: Number(m[2]) };
+    m = /^(?:remove|clear|turn off|disable) (?:the )?(?:daily total|total daily|total)(?: spend(?:ing)?)? cap$/.exec(t);
+    if (m)
+        return { kind: 'remove_total' };
+    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 };
+    m = new RegExp(String.raw `^raise (?:the )?(?:daily total|total daily|total)(?: spend(?:ing)?)? cap to ${AMOUNT}(?: (?:for )?today)?$`).exec(t);
+    if (m)
+        return { kind: 'raise', target: C.TOTAL_TARGET, usd: Number(m[1]) };
+    m = new RegExp(String.raw `^raise (?:the )?${CAP} for (.+?) to ${AMOUNT}(?: (?:for )?today)?$`).exec(t);
+    if (m) {
+        const target = m[1].trim();
+        return { kind: 'raise', target: ['total', 'all', 'all agents'].includes(target) ? C.TOTAL_TARGET : target, usd: Number(m[2]) };
+    }
+    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;
+}
+/**
+ * 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 raise = suggestedRaise(stop.capUsd, stop.spentUsd);
+    const target = stop.scope === 'total' ? 'total' : 'orc';
+    return `${spendCapReason(stop, 'Orc')}. No new turns start until midnight; your message is queued. To raise it for today, reply \`raise cap for ${target} to $${raise} today\` (or Settings → System → Spend).`;
+}
+/**
+ * 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 who = (target) => {
+        const session = resolveAgent(target, agents);
+        if (!session)
+            return `I don't know an agent called "${target}". Use its name or session name (e.g. crewly-orc).`;
+        const name = session === ORCHESTRATOR_SESSION_NAME ? 'Orc' : agents.find((a) => a.session === session)?.name ?? session;
+        return { session, name };
+    };
+    switch (cmd.kind) {
+        case 'set_total':
+            await deps.setCaps({ totalCapUsd: cmd.usd });
+            return `Daily total spend cap set to ${formatUsd(cmd.usd)} for all agents together.`;
+        case 'remove_total':
+            await deps.setCaps({ totalCapUsd: null });
+            return 'Daily total spend cap removed.';
+        case 'set': {
+            if (!cmd.target) {
+                await deps.setCaps({ defaultAgentCapUsd: cmd.usd });
+                return `Daily spend cap set to ${formatUsd(cmd.usd)} per agent (agents with their own cap keep it).`;
+            }
+            const a = who(cmd.target);
+            if (typeof a === 'string')
+                return a;
+            await deps.setCaps({ agents: { [a.session]: cmd.usd } });
+            return `Daily spend cap for ${a.name} set to ${formatUsd(cmd.usd)}.`;
+        }
+        case 'remove': {
+            if (!cmd.target) {
+                await deps.setCaps({ defaultAgentCapUsd: null });
+                return 'Default daily spend cap removed (agents with their own cap keep it).';
+            }
+            const a = who(cmd.target);
+            if (typeof a === 'string')
+                return a;
+            await deps.setCaps({ agents: { [a.session]: null } });
+            return `${a.name} has no daily spend cap now.`;
+        }
+        case 'raise': {
+            if (cmd.target === C.TOTAL_TARGET) {
+                const cap = await deps.raiseToday(C.TOTAL_TARGET, cmd.usd);
+                return `Daily total spend cap raised to ${formatUsd(cap)} for today.`;
+            }
+            const a = who(cmd.target);
+            if (typeof a === 'string')
+                return a;
+            const cap = await deps.raiseToday(a.session, cmd.usd);
+            return `${a.name}'s daily spend cap raised to ${formatUsd(cap)} for today. 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,64 @@
+/**
+ * Spend 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; `total`: the all-agents daily total cap */
+    scope: 'agent' | 'total';
+    /** The cap in force (USD) */
+    capUsd: number;
+    /** What was spent today against it (USD) */
+    spentUsd: number;
+}
+/** 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;
+/**
+ * USD for owner text.
+ *
+ * @param usd - Amount
+ * @returns e.g. `$5.00`
+ */
+export declare function formatUsd(usd: number): string;
+/**
+ * The one-line reason, e.g. "Orc hit its daily spend cap ($5.00)".
+ *
+ * @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;AAEH,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;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;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE,MAAqC,GAAG,MAAM,CAKnG"}

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

@@ -0,0 +1,71 @@
+/**
+ * Spend 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
+ */
+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;
+    }
+}
+/**
+ * USD for owner text.
+ *
+ * @param usd - Amount
+ * @returns e.g. `$5.00`
+ */
+export function formatUsd(usd) {
+    return `$${(Math.round(usd * 100) / 100).toFixed(2)}`;
+}
+/**
+ * The one-line reason, e.g. "Orc hit its daily spend cap ($5.00)".
+ *
+ * @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 total spend cap (${formatUsd(stop.capUsd)})`;
+    }
+    return `${name} hit its daily spend cap (${formatUsd(stop.capUsd)})`;
+}
+//# 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;AAqBH,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;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACxD,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,mEAAmE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;IAC7G,CAAC;IACD,OAAO,GAAG,IAAI,6BAA6B,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;AACvE,CAAC"}

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

@@ -0,0 +1,225 @@
+/**
+ * Per-agent daily spend cap with a hard stop.
+ *
+ * - Caps are the owner's own limits (unlike the runtime fallback, which
+ *   reacts to a provider's usage limit). All are OFF until the owner sets
+ *   one: a default per-agent cap, per-agent overrides, and an optional
+ *   all-agents daily total.
+ * - At {@link SPEND_CAP_CONSTANTS.WARN_FRACTION} of a cap the owner gets ONE
+ *   heads-up.
+ * - At 100% the agent is hard-stopped: {@link stopOf} answers the delivery
+ *   and wake gates, so no new turn starts (the current one may finish) and
+ *   messages stay queued. The owner gets ONE decision card: "Raise to $Y
+ *   today" / "Keep stopped".
+ * - Local midnight resets everything; raises last for the day they were
+ *   made. When a stop lifts (midnight, raise, cap change) the queued
+ *   messages are released.
+ *
+ * Spend comes from {@link SpendLedger} (the shared token ledger and its one
+ * cost computation).
+ *
+ * specs/2026-10-02-spend-cap.md
+ *
+ * @module services/spend/spend-cap.service
+ */
+import type { OwnerDecision } from '../../types/decision.types.js';
+import type { SystemAskInput } from '../decisions/decision.service.js';
+import { type SpendCapGate, type SpendStop } from './spend-cap.gate.js';
+import { type SpendLedger, type SpendSummary } from './spend-ledger.service.js';
+import { type SpendCapConfig, type SpendCapStoreLike } from './spend-cap.store.js';
+/** Minimal logger. */
+export interface SpendCapLogger {
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+}
+/** The decision-card calls the service makes. */
+export interface SpendCapDecisions {
+    askSystem(input: SystemAskInput): Promise<OwnerDecision>;
+    replyInThread(id: string, text: string): Promise<boolean>;
+}
+/** Collaborators. */
+export interface SpendCapServiceDeps {
+    store: SpendCapStoreLike;
+    ledger: Pick<SpendLedger, 'spentToday' | 'totalToday' | 'summarize' | 'invalidate'>;
+    /** One line to the owner (Slack DM from this machine's orc bot); false/throw = not sent */
+    notifyOwner: (text: string) => Promise<unknown>;
+    /** Decision cards (null before they are wired: the stop is then a plain notice) */
+    decisions?: () => SpendCapDecisions | null;
+    /** Owner-facing name of a session ("Orc", "Ella") */
+    displayNameOf?: (session: string) => string;
+    /** Sessions the owner configured (orc + team members), for the caps view */
+    knownSessions?: () => Promise<string[]>;
+    /** Stops lifted: deliver what was queued for these sessions */
+    onReleased?: (sessions: string[]) => Promise<void>;
+    now?: () => Date;
+    logger?: SpendCapLogger;
+}
+/** Body of `PUT /api/system/spend/caps`. */
+export interface SpendCapPatch {
+    /** Default per-agent cap (USD); null turns it off */
+    defaultAgentCapUsd?: number | null;
+    /** All-agents total cap (USD); null turns it off */
+    totalCapUsd?: number | null;
+    /** Session → cap (USD), `null` = no cap for this agent, `"default"` = drop the override */
+    agents?: Record<string, number | null | 'default'>;
+}
+/** A rejected cap change. */
+export declare class SpendCapError extends Error {
+    readonly status: number;
+    /**
+     * @param status - HTTP status
+     * @param message - Owner-facing reason
+     */
+    constructor(status: number, message: string);
+}
+/** One agent in the view. */
+export interface SpendCapAgentView {
+    session: string;
+    name: string;
+    runtimes: string[];
+    todayUsd: number;
+    windowUsd: number;
+    daily: number[];
+    /** Cap in force today (USD), null = none */
+    capUsd: number | null;
+    /** Where the cap comes from */
+    capSource: 'override' | 'default' | 'raised' | 'none' | 'exempt';
+    /** Stopped right now, and why */
+    stopped: boolean;
+    stopReason?: string;
+}
+/** What `GET /api/system/spend` returns. */
+export interface SpendView extends Omit<SpendSummary, 'agents'> {
+    agents: SpendCapAgentView[];
+    caps: SpendCapConfig;
+    /** Raises in force today: target → USD */
+    raisedToday: Record<string, number>;
+    /** Total cap in force today (raise included), null = off */
+    totalCapTodayUsd: number | null;
+    /** Suggested default per-agent cap: last window's p90 agent-day, rounded up to whole dollars (null = no data) */
+    suggestedAgentCapUsd: number | null;
+    /** All agents together stopped by the total cap */
+    totalStopped: boolean;
+}
+/**
+ * The "Raise to $Y today" amount: the cap times RAISE_FACTOR, rounded up to
+ * whole dollars, and always above what was already spent.
+ *
+ * @param capUsd - Cap in force
+ * @param spentUsd - Spent today
+ * @returns USD
+ */
+export declare function suggestedRaise(capUsd: number, spentUsd: number): number;
+/**
+ * Read the amount out of a "Raise to $Y today" option label.
+ *
+ * @param label - Option label
+ * @returns USD, or null when the label is not a raise
+ */
+export declare function raiseAmountOf(label: string | undefined): number | null;
+/**
+ * Per-agent daily spend cap service.
+ */
+export declare class SpendCapService implements SpendCapGate {
+    private readonly deps;
+    private file;
+    private readonly now;
+    private readonly logger;
+    private timer;
+    /** Sessions stopped at the last evaluation (to release them when the stop lifts) */
+    private lastStopped;
+    /** Evaluation passes run one after another */
+    private chain;
+    private queuedPass;
+    /**
+     * @param deps - Collaborators
+     */
+    constructor(deps: SpendCapServiceDeps);
+    /** Start the enforcement tick. */
+    start(): void;
+    /** Stop the tick. */
+    stop(): void;
+    /** @returns The owner's caps (a copy) */
+    getConfig(): SpendCapConfig;
+    /**
+     * Change caps. Takes effect at once (a stop can lift or start).
+     *
+     * @param patch - Changes
+     * @returns The new caps
+     * @throws SpendCapError on a bad value
+     */
+    setCaps(patch: SpendCapPatch): Promise<SpendCapConfig>;
+    /**
+     * Lift a cap for today only.
+     *
+     * @param target - Agent session, or `*` for the all-agents total
+     * @param usd - New cap for today (must be above today's spend)
+     * @returns The new cap for today
+     * @throws SpendCapError when the amount is not above today's spend
+     */
+    raiseToday(target: string, usd: unknown): Promise<number>;
+    /**
+     * The stop in force for a session (the delivery / wake gate). Synchronous
+     * and live: it reads today's spend now, not at the last tick.
+     *
+     * @param session - Agent session
+     * @returns Stop, or null when the agent may run
+     */
+    stopOf(session: string): SpendStop | null;
+    /**
+     * Owner-facing name.
+     *
+     * @param session - Agent session
+     * @returns Name
+     */
+    displayNameOf(session: string): string;
+    /**
+     * Cap in force today for a target, and where it comes from.
+     *
+     * @param target - Agent session, or `*`
+     * @returns Cap (null = none) and source
+     */
+    capOf(target: string): {
+        capUsd: number | null;
+        source: SpendCapAgentView['capSource'];
+    };
+    /**
+     * Spend plus caps for the API / Settings panel.
+     *
+     * @param days - Window
+     * @returns View
+     */
+    view(days?: number): Promise<SpendView>;
+    /**
+     * One enforcement pass: day roll, 80% notices, stop announcements (one
+     * card per stop), and releasing agents whose stop lifted. Passes run
+     * one at a time; a call during a pass gets another pass after it.
+     */
+    evaluate(): Promise<void>;
+    /**
+     * React to a settled "cap reached" card (decision kind `spend_cap`).
+     *
+     * @param d - The settled decision
+     * @returns Always null (nobody else is told)
+     */
+    onSettled(d: OwnerDecision): Promise<null>;
+    private evaluateOnce;
+    private checkThresholds;
+    private announceStop;
+    private anyCap;
+    private computeStop;
+    private stopKey;
+    private scheduleEvaluate;
+    /** Reset today's bookkeeping when the local day changed. */
+    private rollDay;
+    private nextMidnight;
+    private nameOf;
+    private notify;
+    private reply;
+    private persist;
+}
+/** @returns The backend's service, or null before it is wired */
+export declare function getSpendCapService(): SpendCapService | null;
+/** @param service - Instance (null clears) */
+export declare function setSpendCapService(service: SpendCapService | null): void;
+//# sourceMappingURL=spend-cap.service.d.ts.map