@spinabot/brigade 0.1.1 → 1.0.0

package/dist/agents/channels/active-manager.js

@@ -0,0 +1,41 @@
+/**
+ * Process-wide channel-manager singleton accessor.
+ *
+ * The gateway boots exactly ONE `ChannelManager` instance at startup
+ * (`server.ts` → `startChannels`) which owns every started adapter. Agent
+ * tools that need to reach those adapters mid-turn — chiefly `send_message`,
+ * but also future `react`, `poll`, `edit` actions — call
+ * `getActiveChannelManager()` to find them.
+ *
+ * Following the same pattern as `cron/active-service.ts` (singleton mounted
+ * at boot, accessor returns `null` when no gateway is running). Tools that
+ * find a null accessor refuse politely so unit tests + standalone CLI
+ * invocations get a clear error instead of a confusing exception.
+ *
+ * P1#9 (Wave H) — pinned via `resolveGlobalSingleton` so dual-loaded
+ * Brigade modules (test harness + runtime in one process; hot-reload in
+ * dev) share ONE slot. Without the pin, an agent tool importing a
+ * different copy of this module than the boot path would silently see
+ * `null` even after the gateway started.
+ */
+import { resolveGlobalSingleton } from "../../shared/global-singleton.js";
+const ACTIVE_CHANNEL_MANAGER_KEY = Symbol.for("brigade.channels.activeManager");
+function getState() {
+    return resolveGlobalSingleton(ACTIVE_CHANNEL_MANAGER_KEY, () => ({
+        activeManager: null,
+    }));
+}
+/**
+ * Mount the gateway's channel manager so process-wide tools can reach it.
+ * Called by `server.ts` immediately after `startChannels` resolves so a
+ * cron job firing during boot (rare but possible) can still dispatch.
+ * Tests pass `null` in afterEach to clear leakage between cases.
+ */
+export function setActiveChannelManager(manager) {
+    getState().activeManager = manager;
+}
+/** Read the active channel manager. Returns `null` when none is mounted. */
+export function getActiveChannelManager() {
+    return getState().activeManager;
+}
+//# sourceMappingURL=active-manager.js.map

package/dist/agents/channels/active-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-manager.js","sourceRoot":"","sources":["../../../src/agents/channels/active-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAK1E,MAAM,0BAA0B,GAAG,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAEhF,SAAS,QAAQ;IAChB,OAAO,sBAAsB,CAA4B,0BAA0B,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3F,aAAa,EAAE,IAAI;KACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA8B;IACrE,QAAQ,EAAE,CAAC,aAAa,GAAG,OAAO,CAAC;AACpC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB;IACtC,OAAO,QAAQ,EAAE,CAAC,aAAa,CAAC;AACjC,CAAC"}

package/dist/agents/channels/agent-switch-command.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Channel slash commands for per-peer agent pinning:
+ *
+ *   - `/agent <id>`        — pin future messages from THIS peer on THIS
+ *                            channel+account to agent `<id>`
+ *   - `/agent main`        — clear the peer pin (route falls back to the
+ *                            configured default agent)
+ *   - `/agent <id> --force` — override an existing pin owned by a different
+ *                            agent for the same peer
+ *   - `/agents`            — list peer pins on this channel for the sender's
+ *                            (channel, account, peer) scope + the default
+ *   - `/whoami`            — debug aid: show which agent this peer currently
+ *                            routes to + the route tier
+ *
+ * Wiring: registered via `ChannelCommand` and consumed in
+ * `runChannelInboundPipeline` (inbound-pipeline.ts) BEFORE the resolver runs
+ * — a successful `/agent` flips the persisted binding and replies with a
+ * confirmation, never spawning an agent turn. Future inbound messages from
+ * the same (channel, account, peer) triple then land on tier-1
+ * (`binding.peer`) of the 8-tier resolver.
+ *
+ * Brigade-personal-first: no per-user authorize gate (single-operator
+ * install — the sender of the message owns the binding). The
+ * `ChannelCommandContext.from` field is still recorded as `boundBy` for
+ * the future multi-tenant cut.
+ *
+ * Persistence: every write goes through `mutateConfigAtomic` (the same
+ * atomic-write path `brigade agents add` and `agents bind` use), so the
+ * on-disk shape stays consistent with what the resolver's per-config
+ * WeakMap cache sees. The next inbound message reads the freshly-loaded
+ * config (`whatsapp/plugin.ts` calls `deps.loadConfig()` per inbound) and
+ * the resolver's cache invalidates automatically because `cfg.bindings`
+ * has a new reference identity.
+ */
+import { describeBinding } from "../../cli/commands/agents-bindings.js";
+import type { ChannelCommand } from "../extensions/types.js";
+/**
+ * Build the channel `ChannelCommand` entries (`/agent`, `/agents`,
+ * `/whoami`, `/org`) with no external dependency — the handlers read
+ * everything they need from `ChannelCommandContext` (which already carries
+ * `config` + the sender identity). The returned commands plug straight
+ * into the channel manager's command map alongside `/help` / `/status`
+ * / `/allowlist`.
+ *
+ * Keeping the factory shape (rather than exporting bare constants) gives
+ * the wiring layer a single place to inject test stubs later (e.g. a fake
+ * `mutateConfigAtomic` for golden-path tests) and matches `buildBundledCommands`
+ * in `inbound-pipeline.ts`.
+ */
+export declare function buildAgentSwitchCommands(): ChannelCommand[];
+/** Re-exported for tests + the inbound-pipeline describeBinding helper. */
+export { describeBinding };
+//# sourceMappingURL=agent-switch-command.d.ts.map

package/dist/agents/channels/agent-switch-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-switch-command.d.ts","sourceRoot":"","sources":["../../../src/agents/channels/agent-switch-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAWH,OAAO,EAEN,eAAe,EAIf,MAAM,uCAAuC,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,wBAAwB,CAAC;AAoTpF;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,IAAI,cAAc,EAAE,CAwB3D;AAED,2EAA2E;AAC3E,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/agents/channels/agent-switch-command.js

@@ -0,0 +1,349 @@
+/**
+ * Channel slash commands for per-peer agent pinning:
+ *
+ *   - `/agent <id>`        — pin future messages from THIS peer on THIS
+ *                            channel+account to agent `<id>`
+ *   - `/agent main`        — clear the peer pin (route falls back to the
+ *                            configured default agent)
+ *   - `/agent <id> --force` — override an existing pin owned by a different
+ *                            agent for the same peer
+ *   - `/agents`            — list peer pins on this channel for the sender's
+ *                            (channel, account, peer) scope + the default
+ *   - `/whoami`            — debug aid: show which agent this peer currently
+ *                            routes to + the route tier
+ *
+ * Wiring: registered via `ChannelCommand` and consumed in
+ * `runChannelInboundPipeline` (inbound-pipeline.ts) BEFORE the resolver runs
+ * — a successful `/agent` flips the persisted binding and replies with a
+ * confirmation, never spawning an agent turn. Future inbound messages from
+ * the same (channel, account, peer) triple then land on tier-1
+ * (`binding.peer`) of the 8-tier resolver.
+ *
+ * Brigade-personal-first: no per-user authorize gate (single-operator
+ * install — the sender of the message owns the binding). The
+ * `ChannelCommandContext.from` field is still recorded as `boundBy` for
+ * the future multi-tenant cut.
+ *
+ * Persistence: every write goes through `mutateConfigAtomic` (the same
+ * atomic-write path `brigade agents add` and `agents bind` use), so the
+ * on-disk shape stays consistent with what the resolver's per-config
+ * WeakMap cache sees. The next inbound message reads the freshly-loaded
+ * config (`whatsapp/plugin.ts` calls `deps.loadConfig()` per inbound) and
+ * the resolver's cache invalidates automatically because `cfg.bindings`
+ * has a new reference identity.
+ */
+import { resolveDefaultAgentId } from "../agent-scope.js";
+import { mutateConfigAtomic } from "../../config/io.js";
+import { DEFAULT_ACCOUNT_ID, normalizeAccountId, normalizeAgentId, } from "../routing/session-key.js";
+import { resolveAgentRoute } from "../routing/resolve-route.js";
+import { applyAgentBindings, describeBinding, listRouteBindings, removeAgentBindings, } from "../../cli/commands/agents-bindings.js";
+import { hasAgentEntry, listAgentEntries } from "../../cli/commands/agents-config.js";
+import { handleOrgSnapshot } from "../../core/server-methods/org.js";
+import { computeExplain, filterGraphToSubtree, formatExplain, parseOrgSlash, renderDepartmentsOnly, } from "../../cli/commands/org-slash.js";
+import { renderPrideChartWithPins } from "../org/pride-template.js";
+/** Sentinel an operator types to clear the peer pin. */
+const MAIN_KEYWORD = "main";
+/** Single-token id constraint — anything beyond a single non-empty word is rejected. */
+const SIMPLE_AGENT_ID_RE = /^[A-Za-z0-9._-]+$/;
+/**
+ * Build the binding identity used by both the writer and the resolver. The
+ * `match` shape mirrors what `agents bind` writes — channel + accountId +
+ * peer (kind, id). No guild/team/roles for channel-command pins (those tiers
+ * are CLI-only for now).
+ */
+function buildPeerBindingMatch(ctx) {
+    const accountId = normalizeAccountId(ctx.accountId ?? DEFAULT_ACCOUNT_ID);
+    return {
+        channel: ctx.channel,
+        accountId,
+        peer: { kind: ctx.isGroup ? "group" : "direct", id: ctx.from },
+    };
+}
+/**
+ * Format the peer label used in confirmation replies.
+ * `direct:+15551234567` → `+15551234567`; group ids surface verbatim with
+ * a `group:` prefix so the operator can disambiguate.
+ */
+function formatPeerHint(ctx) {
+    if (ctx.isGroup)
+        return `group:${ctx.from}`;
+    return ctx.from;
+}
+/**
+ * `/agent <id>` handler. Writes a peer-scoped binding (or clears it when
+ * `<id>` is `main` / the configured default agent).
+ */
+async function handleAgentSwitch(ctx) {
+    const tokens = ctx.args
+        .split(/\s+/)
+        .map((t) => t.trim())
+        .filter(Boolean);
+    if (tokens.length === 0) {
+        return [
+            "Usage: /agent <id>",
+            "  /agent main          — clear the pin and route to the default crew",
+            "  /agent <id> --force  — override an existing pin owned by another agent",
+            "Run /agents to list current pins.",
+        ].join("\n");
+    }
+    if (tokens.length > 2) {
+        return "Usage: /agent <id> [--force]";
+    }
+    const targetRaw = tokens[0] ?? "";
+    const forceFlag = tokens[1] === "--force";
+    if (tokens.length === 2 && !forceFlag) {
+        return "Usage: /agent <id> [--force]";
+    }
+    if (!SIMPLE_AGENT_ID_RE.test(targetRaw)) {
+        return `Invalid agent id "${targetRaw}". Agent ids are single tokens of letters, digits, '.', '_', or '-'.`;
+    }
+    const cfg = ctx.config;
+    const defaultId = normalizeAgentId(resolveDefaultAgentId(cfg));
+    const normalizedTarget = normalizeAgentId(targetRaw);
+    const isResetIntent = normalizedTarget === MAIN_KEYWORD || normalizedTarget === defaultId;
+    const peerMatch = buildPeerBindingMatch(ctx);
+    const peerHint = formatPeerHint(ctx);
+    // (a) Reset path — clear ANY peer pin for this (channel, account, peer).
+    if (isResetIntent) {
+        const removeBinding = {
+            agentId: "__placeholder__",
+            match: peerMatch,
+        };
+        const existingForPeer = listRouteBindings(cfg).filter((b) => b.match?.channel === peerMatch.channel &&
+            (normalizeAccountId(b.match?.accountId ?? DEFAULT_ACCOUNT_ID) ===
+                peerMatch.accountId) &&
+            b.match?.peer?.id === peerMatch.peer?.id &&
+            b.match?.peer?.kind === peerMatch.peer?.kind);
+        if (existingForPeer.length === 0) {
+            return `No pin to clear for ${peerHint} — already routing to the default crew (${defaultId}).`;
+        }
+        // Re-target the placeholder agent id at the existing owner so
+        // `removeAgentBindings` matches.
+        removeBinding.agentId = existingForPeer[0]?.agentId ?? defaultId;
+        await mutateConfigAtomic((cur) => {
+            const owners = listRouteBindings(cur).filter((b) => b.match?.channel === peerMatch.channel &&
+                normalizeAccountId(b.match?.accountId ?? DEFAULT_ACCOUNT_ID) ===
+                    peerMatch.accountId &&
+                b.match?.peer?.id === peerMatch.peer?.id &&
+                b.match?.peer?.kind === peerMatch.peer?.kind);
+            let next = cur;
+            for (const owner of owners) {
+                const remove = removeAgentBindings(next, [
+                    { agentId: owner.agentId, match: peerMatch },
+                ]);
+                next = remove.config;
+            }
+            return next;
+        });
+        return `Reset — future messages from ${peerHint} route to the default crew (${defaultId}).`;
+    }
+    // (b) Pin path — validate target agent exists, then upsert binding.
+    if (!hasAgentEntry(cfg, normalizedTarget)) {
+        const knownIds = listAgentEntries(cfg).map((e) => normalizeAgentId(e.id));
+        const knownStr = knownIds.length > 0 ? knownIds.join(", ") : "(none configured)";
+        return `Unknown agent "${targetRaw}". Crew: ${knownStr}. Run /agents to see pins.`;
+    }
+    const incoming = {
+        agentId: normalizedTarget,
+        match: {
+            ...peerMatch,
+            boundBy: ctx.from,
+            boundAt: new Date().toISOString(),
+            source: "channel-command",
+        },
+    };
+    const result = applyAgentBindings(cfg, [incoming]);
+    if (result.conflicts.length > 0 && !forceFlag) {
+        const c = result.conflicts[0];
+        const existingOwner = c ? c.existingAgentId : "(unknown)";
+        return [
+            `Refusing to pin ${peerHint} → agent:${normalizedTarget}: already pinned to agent:${existingOwner}.`,
+            `Run /agent ${normalizedTarget} --force to override.`,
+        ].join("\n");
+    }
+    // Force path — remove the conflicting binding first, then re-apply.
+    let overrideNote = "";
+    await mutateConfigAtomic((cur) => {
+        let next = cur;
+        if (forceFlag && result.conflicts.length > 0) {
+            for (const conflict of result.conflicts) {
+                const owner = conflict.existingAgentId;
+                overrideNote = ` (overrode previous pin to agent:${owner})`;
+                const remove = removeAgentBindings(next, [
+                    { agentId: owner, match: peerMatch },
+                ]);
+                next = remove.config;
+            }
+        }
+        const apply = applyAgentBindings(next, [incoming]);
+        next = apply.config;
+        return next;
+    });
+    if (result.added.length === 0 && result.updated.length === 0 && !forceFlag) {
+        // Same agent already pinned — surface idempotent confirmation.
+        return `Already pinned ${peerHint} → agent:${normalizedTarget}. No change.`;
+    }
+    return `Pinned ${peerHint} → agent:${normalizedTarget}${overrideNote}. Tier: binding.peer.`;
+}
+/**
+ * `/agents` handler — list peer pins for this channel + the configured
+ * default. Lists ALL pins on this channel (across accounts) so a multi-
+ * account install surfaces all of them; the sender's account is highlighted.
+ */
+function handleAgentsList(ctx) {
+    const cfg = ctx.config;
+    const accountId = normalizeAccountId(ctx.accountId ?? DEFAULT_ACCOUNT_ID);
+    const channelBindings = listRouteBindings(cfg).filter((b) => b.match?.channel === ctx.channel && b.match?.peer?.id);
+    const defaultId = normalizeAgentId(resolveDefaultAgentId(cfg));
+    if (channelBindings.length === 0) {
+        return [
+            `No pins on ${ctx.channel}.`,
+            `default: agent:${defaultId}`,
+        ].join("\n");
+    }
+    const lines = [`Pins on ${ctx.channel}:`];
+    for (const b of channelBindings) {
+        const m = b.match ?? {};
+        const peer = m.peer ?? {};
+        const peerLabel = `peer=${peer.kind ?? ""}:${peer.id ?? ""}`;
+        const acct = `account=${normalizeAccountId(m.accountId ?? DEFAULT_ACCOUNT_ID)}`;
+        const provenanceParts = [];
+        if (m.boundBy)
+            provenanceParts.push(`pinned by ${m.boundBy}`);
+        if (m.boundAt)
+            provenanceParts.push(`at ${m.boundAt}`);
+        const provenance = provenanceParts.length > 0 ? `  ${provenanceParts.join(" ")}` : "";
+        const isMine = normalizeAccountId(m.accountId ?? DEFAULT_ACCOUNT_ID) === accountId &&
+            peer.id === ctx.from;
+        const marker = isMine ? "*" : "-";
+        lines.push(`  ${marker} agent:${normalizeAgentId(b.agentId)}  ${peerLabel}  ${acct}${provenance}`);
+    }
+    lines.push(`default: agent:${defaultId}`);
+    return lines.join("\n");
+}
+/**
+ * `/whoami` handler — resolve the agent THIS peer is currently routing to
+ * and the matched tier. Useful when an operator wants to confirm a `/agent`
+ * pin took effect, or to see which tier of the 8-tier resolver claimed
+ * their peer (e.g. binding.peer vs binding.channel vs default).
+ */
+function handleWhoAmI(ctx) {
+    const cfg = ctx.config;
+    const accountId = normalizeAccountId(ctx.accountId ?? DEFAULT_ACCOUNT_ID);
+    const route = resolveAgentRoute({
+        cfg,
+        channel: ctx.channel,
+        accountId,
+        peer: {
+            kind: ctx.isGroup ? "group" : "direct",
+            id: ctx.from,
+        },
+    });
+    const peerHint = formatPeerHint(ctx);
+    return [
+        `Peer:    ${peerHint}`,
+        `Channel: ${ctx.channel}`,
+        `Account: ${accountId}`,
+        `Agent:   ${route.agentId}`,
+        `Tier:    ${route.matchedBy}`,
+    ].join("\n");
+}
+/**
+ * `/org` channel handler — render the Pride chart for the current crew.
+ *
+ * Forms (mirrors the TUI `/org` slash command — same parser, same
+ * filters, same template):
+ *
+ *   /org                       → full chart
+ *   /org <agent-id>            → subtree rooted at <agent-id>
+ *   /org --departments         → departments-only (skip Higher Office)
+ *   /org --explain <from> <to> → why this edge exists (or doesn't)
+ *
+ * When `cfg.org` is absent the redirect note is returned UN-wrapped (no
+ * code block) — the redirect is prose, not a chart, and wrapping it in
+ * monospace makes it harder to read on mobile.
+ */
+function handleOrg(ctx) {
+    const parsed = parseOrgSlash(ctx.args);
+    if (parsed.kind === "error")
+        return parsed.message;
+    const snap = handleOrgSnapshot(undefined, {
+        loadConfig: () => ctx.config,
+    });
+    if (snap.ok === false)
+        return snap.redirect;
+    // Explain — uses the snapshot graph directly, plain text reply (no
+    // code-block wrap, the chain is short and reads cleaner inline).
+    if (parsed.kind === "explain") {
+        const outcome = computeExplain(snap.graph, parsed.from, parsed.to);
+        return formatExplain(outcome);
+    }
+    const pins = ctx.config.org
+        ?.departmentHeads;
+    // Show — happy path. Use the pre-rendered channel chart from the
+    // snapshot so the byte-for-byte shape matches what every other
+    // caller sees.
+    if (parsed.kind === "show") {
+        return snap.charts.channel;
+    }
+    // Sub-tree — filter the graph then re-render via the SAME template
+    // engine (emoji on, ANSI off, triple-backtick wrap).
+    if (parsed.kind === "subtree") {
+        const filtered = filterGraphToSubtree(snap.graph, parsed.agentId);
+        if (!filtered) {
+            return `Unknown agent "${parsed.agentId}". Run /org to see the full chart.`;
+        }
+        const inner = renderPrideChartWithPins(filtered, pins, {
+            emoji: true,
+            ansi: false,
+        });
+        return ["```", inner, "```"].join("\n");
+    }
+    // Departments-only — render the chart with the Higher Office block
+    // elided. Re-uses the same template engine + monospace wrap.
+    const inner = renderDepartmentsOnly(snap.graph, pins, {
+        emoji: true,
+        ansi: false,
+    });
+    return ["```", inner, "```"].join("\n");
+}
+/**
+ * Build the channel `ChannelCommand` entries (`/agent`, `/agents`,
+ * `/whoami`, `/org`) with no external dependency — the handlers read
+ * everything they need from `ChannelCommandContext` (which already carries
+ * `config` + the sender identity). The returned commands plug straight
+ * into the channel manager's command map alongside `/help` / `/status`
+ * / `/allowlist`.
+ *
+ * Keeping the factory shape (rather than exporting bare constants) gives
+ * the wiring layer a single place to inject test stubs later (e.g. a fake
+ * `mutateConfigAtomic` for golden-path tests) and matches `buildBundledCommands`
+ * in `inbound-pipeline.ts`.
+ */
+export function buildAgentSwitchCommands() {
+    return [
+        {
+            name: "agent",
+            description: "Pin future messages from this peer to a specific agent.",
+            handler: (ctx) => handleAgentSwitch(ctx),
+        },
+        {
+            name: "agents",
+            description: "List peer pins on this channel.",
+            handler: (ctx) => handleAgentsList(ctx),
+        },
+        {
+            name: "whoami",
+            description: "Show which agent this peer currently routes to.",
+            handler: (ctx) => handleWhoAmI(ctx),
+        },
+        {
+            name: "org",
+            description: "Show the Pride hierarchy chart (or a sub-tree / explain).",
+            handler: (ctx) => handleOrg(ctx),
+        },
+    ];
+}
+/** Re-exported for tests + the inbound-pipeline describeBinding helper. */
+export { describeBinding };
+//# sourceMappingURL=agent-switch-command.js.map

package/dist/agents/channels/agent-switch-command.js.map

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

package/dist/agents/channels/approval-router.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Channel approval router — bridges Brigade's per-turn exec-gate to channel
+ * adapters so an approval prompt raised by a channel-routed turn lands IN
+ * the same conversation, not on the gateway WebSocket where nobody is
+ * watching.
+ *
+ * Why this exists. Connect-mode TUI works because the operator is sitting
+ * at the WebSocket consumer. Channel-routed turns (WhatsApp / Slack /
+ * Discord DMs into Brigade) raise the same approval prompts through the
+ * same bridge — but the operator is on their phone, not in the TUI. The
+ * default path broadcasts on WS and hangs for the full 5-minute timeout.
+ * This module re-routes those prompts back to the channel: send the prompt
+ * as an outbound message, intercept the next inbound from the same peer
+ * for a yes/no answer, resolve the bridge with the matching decision.
+ *
+ * Wiring at boot (in `startChannels`):
+ *
+ *   for each adapter:
+ *     registerChannelApprovalDispatcher(adapter.id, {
+ *       sendText: adapter.sendText,
+ *       prettyName: adapter.label,
+ *     });
+ *
+ * On every channel inbound, BEFORE the normal turn-dispatch path:
+ *
+ *   if (tryConsumeChannelApprovalReply({channelId, conversationId, text})) {
+ *     return; // handled — bridge resolved, prompt acknowledged
+ *   }
+ *
+ * On every channel-routed turn, the inbound carries an `ChannelApprovalRoute`
+ * through `runGatewayTurn` → `runResilientTurn` → `runSingleTurn` →
+ * `gateCtxRef.value.channelRoute`. The exec-gate then includes that route on
+ * its `bridge.requestApproval(...)` call, and `InMemoryApprovalBridge.requestApproval`
+ * — when it sees the route — calls `dispatchChannelApproval(...)` to send
+ * the prompt as outbound text instead of (well, in addition to) the WS
+ * broadcast.
+ *
+ * Process-wide singleton because there is exactly one channel manager per
+ * gateway process and the exec-gate / approval-bridge live module-level —
+ * threading a registry through 8 layers of args is the same fight as
+ * the bridge itself (see `approval-bridge.ts` for the same rationale).
+ */
+import type { ApprovalDecision, ApprovalDecisionKind, ApprovalRequest } from "../approval-bridge.js";
+/** A pending approval the channel router is waiting on a yes/no for. */
+export interface ChannelApprovalRoute {
+    channelId: string;
+    conversationId: string;
+    threadId?: string;
+    /** Channel-specific account id when the channel supports multi-account. */
+    accountId?: string;
+    /** Resolved agent id (route-resolver output) so concurrent agents sharing one peer don't collide on the pending-approval slot. */
+    agentId?: string;
+}
+/**
+ * Per-adapter dispatcher capability surface — minimal, exactly the bits
+ * `dispatchChannelApproval` needs to ask the operator and the bits that
+ * make the log lines useful. The channel manager constructs these at
+ * `startChannels` boot from each adapter's outbound surface.
+ */
+export interface ChannelApprovalDispatcher {
+    /** Send the approval prompt to the conversation. */
+    sendText: (conversationId: string, text: string, opts?: {
+        threadId?: string;
+        accountId?: string;
+    }) => Promise<void>;
+    /** Human-readable label for log lines + the prompt header (e.g. "WhatsApp"). */
+    prettyName: string;
+}
+/**
+ * Register an adapter's outbound surface so the bridge can route prompts
+ * through it. Called by `startChannels` for every adapter that started
+ * successfully. Idempotent — re-registering replaces the previous entry
+ * (channel hot-reload friendly). `accountId` lets multi-account adapters
+ * (one Slack workspace per account, two linked WhatsApp numbers, …)
+ * register one dispatcher per account; pass `undefined` for single-account
+ * adapters and the default-account slot is taken.
+ */
+export declare function registerChannelApprovalDispatcher(channelId: string, accountIdOrDispatcher: string | undefined | ChannelApprovalDispatcher, maybeDispatcher?: ChannelApprovalDispatcher): void;
+/**
+ * Drop a channel's dispatcher. Channel manager's `stop()` calls this for
+ * every started adapter so a torn-down WhatsApp can't be asked to send
+ * messages after the socket is gone. When `accountId` is omitted, drops
+ * every dispatcher belonging to the channel (multi-account-aware stop).
+ */
+export declare function removeChannelApprovalDispatcher(channelId: string, accountId?: string): void;
+/** Diagnostic — used by tests + gateway `/health` checks. */
+export declare function listChannelApprovalDispatchers(): string[];
+/** Diagnostic — pending entries snapshot (returns shallow clones). */
+export declare function listPendingChannelApprovals(): Array<{
+    id: string;
+    channelId: string;
+    conversationId: string;
+    threadId?: string;
+    accountId?: string;
+    agentId?: string;
+    command: string;
+    ageMs: number;
+}>;
+/**
+ * Send the approval prompt via the channel and register a pending entry
+ * the next inbound from the same peer will consume.
+ *
+ * Returns:
+ *   - `true`  → prompt dispatched, channel route owns this approval; the
+ *               bridge MUST wait for `tryConsumeChannelApprovalReply` (or
+ *               its watchdog timeout) to settle.
+ *   - `false` → no dispatcher registered for `channelId`, or `sendText`
+ *               threw. Caller (the approval-bridge) falls back to the
+ *               default WS-broadcast path so the prompt still goes
+ *               somewhere instead of vanishing.
+ */
+export declare function dispatchChannelApproval(args: {
+    request: ApprovalRequest;
+    route: ChannelApprovalRoute;
+    resolveOnBridge: (decision: ApprovalDecision) => void;
+}): Promise<boolean>;
+/**
+ * Try to consume `text` as a yes/no reply to a pending approval for this
+ * peer. Returns:
+ *   - `true`  → text WAS a yes/no answer + bridge has been resolved; the
+ *               caller (channel inbound handler) should `return` and NOT
+ *               dispatch a turn for this message.
+ *   - `false` → no pending approval for this peer, OR text wasn't a
+ *               yes/no shape. Caller proceeds with normal dispatch.
+ *
+ * Notes for the channel inbound:
+ *   - Must be called AFTER the access-policy check (we only intercept
+ *     trusted peers — strangers can't accidentally answer an approval).
+ *   - Must be called BEFORE the abort-trigger check (the abort word "stop"
+ *     overlaps the "no" vocabulary; pending-approval intent wins).
+ *   - The channel adapter's `sendText` for the acknowledgement is the
+ *     caller's responsibility — the router only does the bridge plumbing.
+ *     This keeps the router test-friendly (no I/O side effects on the
+ *     intercept path) and lets per-channel formatting differ.
+ */
+export declare function tryConsumeChannelApprovalReply(args: {
+    channelId: string;
+    conversationId: string;
+    text: string;
+    threadId?: string;
+    accountId?: string;
+    agentId?: string;
+}): {
+    matched: true;
+    decision: ApprovalDecisionKind;
+    approvalId: string;
+} | {
+    matched: false;
+};
+/**
+ * Cancel a pending approval by request id (e.g. on session abort).
+ * Bridge already cleans its own maps; this clears ours so a late reply
+ * doesn't get mis-routed to a different turn.
+ */
+export declare function cancelChannelApprovalById(approvalId: string): void;
+/** Test-only — clear every registration + pending entry. */
+export declare function resetChannelApprovalRouterForTests(): void;
+//# sourceMappingURL=approval-router.d.ts.map

package/dist/agents/channels/approval-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-router.d.ts","sourceRoot":"","sources":["../../../src/agents/channels/approval-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIrG,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kIAAkI;IAClI,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACzC,oDAAoD;IACpD,QAAQ,EAAE,CACT,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAC5C,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;CACnB;AAkED;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAChD,SAAS,EAAE,MAAM,EACjB,qBAAqB,EAAE,MAAM,GAAG,SAAS,GAAG,yBAAyB,EACrE,eAAe,CAAC,EAAE,yBAAyB,GACzC,IAAI,CAYN;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAoB3F;AAED,6DAA6D;AAC7D,wBAAgB,8BAA8B,IAAI,MAAM,EAAE,CAEzD;AAED,sEAAsE;AACtE,wBAAgB,2BAA2B,IAAI,KAAK,CAAC;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd,CAAC,CAYD;AA2FD;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,eAAe,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtD,GAAG,OAAO,CAAC,OAAO,CAAC,CAwGnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,CA+C7F;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAOlE;AAED,4DAA4D;AAC5D,wBAAgB,kCAAkC,IAAI,IAAI,CAKzD"}