@spinabot/brigade 1.1.0 → 1.2.0

package/dist/agents/channels/last-sent-message.js

@@ -0,0 +1,55 @@
+/**
+ * Per-agent last-sent-message registry.
+ *
+ * The additive `{ messageId }` return on `ChannelAdapter.sendText` / `sendMedia`
+ * lets the pipeline learn the native id of the message the agent just sent. This
+ * registry remembers that id per (agent, channel, conversation) so the agent can
+ * say "edit my last message" / "delete that" without having to have memorised an
+ * id — the `message_action` tool falls back to this record when no explicit
+ * `messageId` is supplied.
+ *
+ * Mirrors `last-channel.ts` exactly in scope + persistence: an in-memory map
+ * pinned via global-singleton (one record set across hot-reload / dual-build),
+ * updated whenever a reply send returns an id, read by `message_action`. NOT
+ * persisted across a gateway restart — the agent can always re-send and act on
+ * the fresh id; there is no correctness risk in losing the pin on reboot.
+ */
+import { resolveGlobalSingleton } from "../../shared/global-singleton.js";
+/** Pinned via global-singleton so hot-reload / dual-build share one record map. */
+const LAST_SENT_MESSAGE_KEY = Symbol.for("brigade.lastSentMessage.byKey");
+const lastSentByKey = resolveGlobalSingleton(LAST_SENT_MESSAGE_KEY, () => new Map());
+/** Key by (agent, channel, conversation) so each chat tracks its own last id. */
+function recordKey(agentId, channelId, conversationId) {
+    return `${agentId}::${channelId}::${conversationId}`;
+}
+/**
+ * Record the id of the message the agent just sent on this conversation. A
+ * no-op when any of the keys (or the id itself) is empty — channels that don't
+ * return an id simply never populate the registry.
+ */
+export function recordLastSentMessage(args) {
+    if (!args.agentId || !args.channelId || !args.conversationId)
+        return;
+    const id = (args.messageId ?? "").trim();
+    if (!id)
+        return;
+    lastSentByKey.set(recordKey(args.agentId, args.channelId, args.conversationId), {
+        messageId: id,
+        ...(args.threadId !== undefined ? { threadId: args.threadId } : {}),
+        ...(args.accountId !== undefined ? { accountId: args.accountId } : {}),
+        updatedAtMs: args.nowMs ?? Date.now(),
+    });
+}
+/**
+ * Look up the agent's most-recently-sent message id on a conversation, or
+ * `undefined` if none has been recorded (fresh boot, a channel that doesn't
+ * return ids, or no sends yet).
+ */
+export function getLastSentMessage(agentId, channelId, conversationId) {
+    return lastSentByKey.get(recordKey(agentId, channelId, conversationId));
+}
+/** Test-only — clear every recorded last-sent message. */
+export function resetLastSentMessageRegistryForTests() {
+    lastSentByKey.clear();
+}
+//# sourceMappingURL=last-sent-message.js.map

package/dist/agents/channels/last-sent-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"last-sent-message.js","sourceRoot":"","sources":["../../../src/agents/channels/last-sent-message.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAU1E,mFAAmF;AACnF,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAC1E,MAAM,aAAa,GAAG,sBAAsB,CAC3C,qBAAqB,EACrB,GAAG,EAAE,CAAC,IAAI,GAAG,EAAiC,CAC9C,CAAC;AAEF,iFAAiF;AACjF,SAAS,SAAS,CAAC,OAAe,EAAE,SAAiB,EAAE,cAAsB;IAC5E,OAAO,GAAG,OAAO,KAAK,SAAS,KAAK,cAAc,EAAE,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAQrC;IACA,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,cAAc;QAAE,OAAO;IACrE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,CAAC,EAAE;QAAE,OAAO;IAChB,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE;QAC/E,SAAS,EAAE,EAAE;QACb,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,WAAW,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE;KACrC,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CACjC,OAAe,EACf,SAAiB,EACjB,cAAsB;IAEtB,OAAO,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,oCAAoC;IACnD,aAAa,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC"}

package/dist/agents/channels/manager.d.ts

@@ -13,6 +13,14 @@
  * Failure isolation: a channel that fails to start is logged and skipped (the
  * others still come up); an inbound message that throws is logged and dropped
  * (the channel stays connected). Nothing here can crash the gateway.
+ *
+ * Runtime single-channel lifecycle (added for `connect_channel`): the manager
+ * captures its boot args + the FULL adapter catalog so a channel can be started
+ * or stopped LIVE — after boot, without a gateway restart — via `startChannel`
+ * / `stopChannel`. Each started adapter gets its OWN abort controller chained
+ * to the manager's master controller, so stopping ONE channel never signals the
+ * others (master `stop()` still cascades to all). WhatsApp's boot path does not
+ * call the new methods, so its behaviour is byte-identical to before.
  */
 import type { BrigadeConfig } from "../../config/io.js";
 import type { ChannelAdapter, ChannelCommand } from "../extensions/types.js";
@@ -50,6 +58,24 @@ export interface StartChannelsArgs {
         value: string;
     }) => void;
 }
+/** Outcome of a runtime single-channel start attempt. */
+export interface StartChannelResult {
+    /** True when the adapter is now started (either freshly or already running). */
+    ok: boolean;
+    /** True when this call actually started it; false when it was already running. */
+    started: boolean;
+    /** Machine-readable reason when `ok` is false. */
+    reason?: "unknown-channel" | "env-missing" | "not-configured" | "start-failed";
+    /** Human-facing detail (safe to surface). */
+    message?: string;
+}
+/** Outcome of a runtime single-channel stop attempt. */
+export interface StopChannelResult {
+    ok: boolean;
+    /** True when this call actually stopped a running adapter; false when it wasn't running. */
+    stopped: boolean;
+    message?: string;
+}
 export interface ChannelManager {
     /** Ids of channels that started successfully. */
     readonly started: string[];
@@ -66,11 +92,37 @@ export interface ChannelManager {
      * accounts onto one adapter so the arg is a no-op there.
      */
     adapter(id: string, accountId?: string): ChannelAdapter | undefined;
+    /**
+     * Start ONE channel adapter LIVE, after boot, without a gateway restart.
+     * The adapter is resolved from the FULL catalog the manager was built with
+     * (`startChannels({ adapters })`), gated the same way boot gates it
+     * (`requiresEnv` present + `adapter.isConfigured(config, env)`), then wired
+     * through the identical inbound pipeline. Idempotent: starting an
+     * already-running channel returns `{ ok: true, started: false }`.
+     *
+     * `config` (optional) overrides the snapshot the manager captured at boot —
+     * pass the freshly-written config when the caller has just enabled the
+     * channel + set its token via `mutateConfigAtomic`, so `isConfigured` and
+     * the adapter's `start()` see the new values without a manager rebuild.
+     */
+    startChannel(id: string, config?: BrigadeConfig): Promise<StartChannelResult>;
+    /**
+     * Stop ONE channel adapter LIVE without touching the others. Aborts only
+     * that channel's listener (its own controller, chained to the master), drops
+     * its approval dispatcher, clears its pending debounce slots, and calls
+     * `adapter.stop()`. Idempotent: stopping a channel that isn't running
+     * returns `{ ok: true, stopped: false }`.
+     */
+    stopChannel(id: string): Promise<StopChannelResult>;
 }
 /**
  * Start every configured channel adapter. Returns a handle whose `stop()` tears
  * them all down. Channels that aren't configured (missing keys/settings) are
  * skipped silently — only configured channels spin up a listener.
+ *
+ * The returned manager also supports LIVE single-channel start/stop
+ * (`startChannel` / `stopChannel`) so a tool can connect a new channel after
+ * boot without a gateway restart.
  */
 export declare function startChannels(args: StartChannelsArgs): Promise<ChannelManager>;
 //# sourceMappingURL=manager.d.ts.map

package/dist/agents/channels/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/agents/channels/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAuC,MAAM,wBAAwB,CAAC;AAClH,OAAO,EACN,KAAK,oBAAoB,EAGzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAIN,KAAK,iBAAiB,IAAI,yBAAyB,EAGnD,MAAM,uBAAuB,CAAC;AAI/B,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IACjC,8DAA8D;IAC9D,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,gFAAgF;IAChF,MAAM,EAAE,aAAa,CAAC;IACtB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;KAC5C,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACjC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACtF;AAED,MAAM,WAAW,cAAc;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,sEAAsE;IACtE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;CACpE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyGpF"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/agents/channels/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAuC,MAAM,wBAAwB,CAAC;AAClH,OAAO,EACN,KAAK,oBAAoB,EAGzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAIN,KAAK,iBAAiB,IAAI,yBAAyB,EAGnD,MAAM,uBAAuB,CAAC;AAI/B,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IACjC,8DAA8D;IAC9D,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,gFAAgF;IAChF,MAAM,EAAE,aAAa,CAAC;IACtB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;KAC5C,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACjC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACtF;AAED,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IAClC,gFAAgF;IAChF,EAAE,EAAE,OAAO,CAAC;IACZ,kFAAkF;IAClF,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,MAAM,CAAC,EAAE,iBAAiB,GAAG,aAAa,GAAG,gBAAgB,GAAG,cAAc,CAAC;IAC/E,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,4FAA4F;IAC5F,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,sEAAsE;IACtE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IACpE;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9E;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACpD;AAWD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4MpF"}

package/dist/agents/channels/manager.js

@@ -13,6 +13,14 @@
  * Failure isolation: a channel that fails to start is logged and skipped (the
  * others still come up); an inbound message that throws is logged and dropped
  * (the channel stays connected). Nothing here can crash the gateway.
+ *
+ * Runtime single-channel lifecycle (added for `connect_channel`): the manager
+ * captures its boot args + the FULL adapter catalog so a channel can be started
+ * or stopped LIVE — after boot, without a gateway restart — via `startChannel`
+ * / `stopChannel`. Each started adapter gets its OWN abort controller chained
+ * to the manager's master controller, so stopping ONE channel never signals the
+ * others (master `stop()` still cascades to all). WhatsApp's boot path does not
+ * call the new methods, so its behaviour is byte-identical to before.
  */
 import { createSubsystemLogger } from "../../logging/subsystem-logger.js";
 import { registerChannelApprovalDispatcher, removeChannelApprovalDispatcher, } from "./approval-router.js";
@@ -22,33 +30,70 @@ const log = createSubsystemLogger("channels/manager");
  * Start every configured channel adapter. Returns a handle whose `stop()` tears
  * them all down. Channels that aren't configured (missing keys/settings) are
  * skipped silently — only configured channels spin up a listener.
+ *
+ * The returned manager also supports LIVE single-channel start/stop
+ * (`startChannel` / `stopChannel`) so a tool can connect a new channel after
+ * boot without a gateway restart.
  */
 export async function startChannels(args) {
     const env = args.env ?? process.env;
-    const abort = new AbortController();
+    // Master controller — aborting it cascades to EVERY per-channel controller
+    // (they're chained below). `stop()` (all channels) aborts the master.
+    const master = new AbortController();
     const started = [];
     const userCommands = args.commands ?? [];
-    for (const adapter of args.adapters) {
+    // Mutable config snapshot — boot value, refreshable by a live `startChannel`
+    // that passes the just-written config so a late-started adapter sees it.
+    let activeConfig = args.config;
+    /**
+     * Start ONE adapter and register it in `started`. Shared by the boot loop
+     * and the runtime `startChannel` path so the gate + pipeline wiring + abort
+     * chaining + dispatcher registration stay byte-identical on both paths.
+     *
+     * Returns a structured result. Throwing is reserved for genuinely
+     * unexpected failures; a configured-but-failed start is captured as
+     * `{ ok:false, reason:"start-failed" }` (logged + skipped, never crashes).
+     */
+    async function startOneAdapter(adapter) {
+        // Already running → no-op (idempotent).
+        if (started.some((s) => s.id === adapter.id)) {
+            return { ok: true, started: false, message: `channel "${adapter.id}" already started` };
+        }
         // Gate: required env present AND the adapter says it's configured.
         const envMissing = adapter.requiresEnv?.some((v) => !env[v] || env[v]?.trim() === "");
         if (envMissing) {
             log.info("channel skipped — required env missing", { channel: adapter.id, requiresEnv: adapter.requiresEnv });
-            continue;
+            return {
+                ok: false,
+                started: false,
+                reason: "env-missing",
+                message: `channel "${adapter.id}" is missing required env (${(adapter.requiresEnv ?? []).join(", ")})`,
+            };
         }
         let configured = false;
         try {
-            configured = adapter.isConfigured(args.config, env);
+            configured = adapter.isConfigured(activeConfig, env);
         }
         catch (err) {
             log.warn("channel isConfigured threw — skipping", {
                 channel: adapter.id,
                 error: err instanceof Error ? err.message : String(err),
             });
-            continue;
+            return {
+                ok: false,
+                started: false,
+                reason: "not-configured",
+                message: `channel "${adapter.id}" configuration check failed`,
+            };
         }
         if (!configured) {
             log.info("channel skipped — not configured", { channel: adapter.id });
-            continue;
+            return {
+                ok: false,
+                started: false,
+                reason: "not-configured",
+                message: `channel "${adapter.id}" is not configured (enable it + provide credentials)`,
+            };
         }
         // Per-adapter command map: user-registered + bundled `/help` `/status` `/allowlist`.
         const commandMap = new Map();
@@ -56,19 +101,28 @@ export async function startChannels(args) {
             commandMap.set(c.name.toLowerCase(), c);
         for (const c of buildBundledCommands(adapter))
             commandMap.set(c.name.toLowerCase(), c);
+        // Per-channel abort controller, chained to the master so an all-channels
+        // `stop()` still cancels this channel, but a single-channel `stopChannel`
+        // can cancel ONLY this one without signalling the others.
+        const channelAbort = new AbortController();
+        const onMasterAbort = () => channelAbort.abort();
+        if (master.signal.aborted)
+            channelAbort.abort();
+        else
+            master.signal.addEventListener("abort", onMasterAbort, { once: true });
         // Adapt the boot-args `runTurn` into the pipeline's `RunChannelTurnFn`
         // shape — same payload, additive optional fields the pipeline reads.
         const pipelineRunTurn = (turn) => args.runTurn(turn);
         const pipeline = createInboundPipelineContext({
             adapter,
-            config: args.config,
+            config: activeConfig,
             agentId: args.agentId,
             runTurn: pipelineRunTurn,
             commandMap,
-            parentAbort: abort.signal,
+            parentAbort: channelAbort.signal,
         });
         const ctx = {
-            signal: abort.signal,
+            signal: channelAbort.signal,
             log: (msg, meta) => log.info(`[${adapter.id}] ${msg}`, meta),
             onPairing: args.onPairing ? (info) => args.onPairing?.(adapter.id, info) : undefined,
             onInbound: async (msg) => {
@@ -77,7 +131,7 @@ export async function startChannels(args) {
         };
         try {
             await adapter.start(ctx);
-            started.push({ id: adapter.id, adapter, pipeline });
+            started.push({ id: adapter.id, adapter, pipeline, abort: channelAbort });
             // Register the adapter's outbound surface so a gated tool call inside
             // a channel-routed turn surfaces the prompt INTO this conversation.
             // Single-account adapters land on the default-account dispatcher slot.
@@ -86,45 +140,101 @@ export async function startChannels(args) {
                 prettyName: adapter.label,
             });
             log.info("channel started", { channel: adapter.id, label: adapter.label });
+            return { ok: true, started: true, message: `channel "${adapter.id}" started` };
         }
         catch (err) {
+            // Clean up the abort chaining we set up before the failed start.
+            master.signal.removeEventListener("abort", onMasterAbort);
             log.warn("channel failed to start — skipping", {
                 channel: adapter.id,
                 error: err instanceof Error ? err.message : String(err),
             });
+            return {
+                ok: false,
+                started: false,
+                reason: "start-failed",
+                message: `channel "${adapter.id}" failed to start: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    /** Tear down ONE started entry: dispatcher, debounce slots, abort, stop(). */
+    async function teardownEntry(entry) {
+        // Drop the approval router's dispatcher BEFORE adapter.stop() so an
+        // in-flight bridge can't ask a torn-down channel to send.
+        removeChannelApprovalDispatcher(entry.id);
+        // Cancel pending debounce slots so a flush can't fire post-stop.
+        for (const slot of entry.pipeline.pendingDispatches.values())
+            clearTimeout(slot.timer);
+        entry.pipeline.pendingDispatches.clear();
+        // Abort only THIS channel's listener.
+        entry.abort.abort();
+        try {
+            await entry.adapter.stop();
+        }
+        catch (err) {
+            log.warn("channel stop failed", {
+                channel: entry.id,
+                error: err instanceof Error ? err.message : String(err),
+            });
         }
     }
+    // Boot loop — start every configured adapter (same gate + skip-on-failure
+    // semantics as before; the per-adapter body now lives in startOneAdapter).
+    for (const adapter of args.adapters) {
+        await startOneAdapter(adapter);
+    }
     let stopped = false;
     return {
-        started: started.map((s) => s.id),
+        // Live getter — reflects runtime single-channel start/stop, not a
+        // boot-time snapshot (startChannel / stopChannel mutate `started`).
+        get started() {
+            return started.map((s) => s.id);
+        },
         adapter(id) {
             const entry = started.find((s) => s.id === id);
             return entry?.adapter;
         },
+        async startChannel(id, config) {
+            if (stopped) {
+                return { ok: false, started: false, reason: "start-failed", message: "channel manager is stopped" };
+            }
+            // Refresh the config snapshot when the caller just wrote new values
+            // (enabled the channel + set its token) so the gate + start see them.
+            if (config)
+                activeConfig = config;
+            const adapter = args.adapters.find((a) => a.id === id);
+            if (!adapter) {
+                return {
+                    ok: false,
+                    started: false,
+                    reason: "unknown-channel",
+                    message: `no channel adapter registered with id "${id}"`,
+                };
+            }
+            return startOneAdapter(adapter);
+        },
+        async stopChannel(id) {
+            const idx = started.findIndex((s) => s.id === id);
+            if (idx === -1) {
+                return { ok: true, stopped: false, message: `channel "${id}" is not running` };
+            }
+            const entry = started[idx];
+            // Remove from `started` FIRST so a concurrent read of `.started`
+            // doesn't see a channel that's mid-teardown.
+            started.splice(idx, 1);
+            await teardownEntry(entry);
+            return { ok: true, stopped: true, message: `channel "${id}" stopped` };
+        },
         async stop() {
             if (stopped)
                 return;
             stopped = true;
-            // Cancel pending debounce slots so a flush can't fire post-stop.
-            for (const { pipeline } of started) {
-                for (const slot of pipeline.pendingDispatches.values())
-                    clearTimeout(slot.timer);
-                pipeline.pendingDispatches.clear();
-            }
-            abort.abort();
-            for (const { id, adapter } of started) {
-                // Drop the approval router's dispatcher BEFORE adapter.stop()
-                // so an in-flight bridge can't ask a torn-down channel to send.
-                removeChannelApprovalDispatcher(id);
-                try {
-                    await adapter.stop();
-                }
-                catch (err) {
-                    log.warn("channel stop failed", {
-                        channel: id,
-                        error: err instanceof Error ? err.message : String(err),
-                    });
-                }
+            // Abort the master FIRST — cascades to every per-channel controller.
+            master.abort();
+            // Snapshot + clear so teardownEntry's own splice-free path is safe.
+            const entries = started.splice(0, started.length);
+            for (const entry of entries) {
+                await teardownEntry(entry);
             }
         },
     };

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

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

package/dist/agents/channels/plugin-channel-manager-facade.d.ts

@@ -9,10 +9,21 @@
  * (back-compat for callers that don't yet pass accountId). Single-account
  * installs return their one account either way.
  */
+import type { ChannelAdapter } from "../extensions/types.js";
 import type { ChannelManager } from "./manager.js";
-import type { WhatsAppPluginHandle } from "./whatsapp/plugin.js";
+/**
+ * The minimal per-account introspection surface the facade needs from a plugin
+ * handle — `id` + which accounts are running + a per-account adapter lookup.
+ * Both `WhatsAppPluginHandle` and `TelegramPluginHandle` satisfy this, so the
+ * facade is channel-agnostic and one facade can front a mixed plugin list.
+ */
+export interface PluginChannelManagerHandle {
+    id: string;
+    startedAccountIds(): string[];
+    getAdapter(accountId: string): ChannelAdapter | undefined;
+}
 /** Build a manager facade over a list of plugin handles. */
 export declare function createPluginChannelManagerFacade(args: {
-    plugins: WhatsAppPluginHandle[];
+    plugins: PluginChannelManagerHandle[];
 }): ChannelManager;
 //# sourceMappingURL=plugin-channel-manager-facade.d.ts.map

package/dist/agents/channels/plugin-channel-manager-facade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-channel-manager-facade.d.ts","sourceRoot":"","sources":["../../../src/agents/channels/plugin-channel-manager-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,4DAA4D;AAC5D,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,oBAAoB,EAAE,CAAC;CAChC,GAAG,cAAc,CAiCjB"}
+{"version":3,"file":"plugin-channel-manager-facade.d.ts","sourceRoot":"","sources":["../../../src/agents/channels/plugin-channel-manager-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,cAAc,CAAC;AAE1F;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB,IAAI,MAAM,EAAE,CAAC;IAC9B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;CAC1D;AAED,4DAA4D;AAC5D,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,0BAA0B,EAAE,CAAC;CACtC,GAAG,cAAc,CAsDjB"}

package/dist/agents/channels/plugin-channel-manager-facade.js

@@ -47,6 +47,27 @@ export function createPluginChannelManagerFacade(args) {
             // Stop is owned by the `ChannelPluginManager` directly; the facade
             // is a read-only surface for the `send_message` tool.
         },
+        async startChannel(id) {
+            // The multi-account plugin path owns its own lifecycle through the
+            // `ChannelPluginManager` (per-account loops + restart-backoff), so a
+            // live single-channel start does NOT route through this read-only
+            // facade. Report it honestly so `connect_channel` falls back to
+            // "config written — restart the gateway to connect".
+            return {
+                ok: false,
+                started: false,
+                reason: "start-failed",
+                message: `live start for "${id}" is managed by the multi-account channel plugin manager — restart the gateway to apply config changes`,
+            };
+        },
+        async stopChannel(id) {
+            // Same ownership note as startChannel — the plugin manager owns stop.
+            return {
+                ok: true,
+                stopped: false,
+                message: `live stop for "${id}" is managed by the multi-account channel plugin manager`,
+            };
+        },
     };
 }
 //# sourceMappingURL=plugin-channel-manager-facade.js.map

package/dist/agents/channels/plugin-channel-manager-facade.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-channel-manager-facade.js","sourceRoot":"","sources":["../../../src/agents/channels/plugin-channel-manager-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,4DAA4D;AAC5D,MAAM,UAAU,gCAAgC,CAAC,IAEhD;IACA,MAAM,OAAO,GAAG,GAAa,EAAE;QAC9B,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC,MAAM,GAAG,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC,CAAC;IACF,OAAO;QACN,IAAI,OAAO;YACV,OAAO,OAAO,EAAE,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,EAAU,EAAE,SAAkB;YACrC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC9B,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE;oBAAE,SAAS;gBAC1B,MAAM,QAAQ,GAAG,CAAC,CAAC,iBAAiB,EAAE,CAAC;gBACvC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;oBAC7B,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;oBACpC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;wBAAE,OAAO,SAAS,CAAC;oBAC9C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;wBAAE,OAAO,SAAS,CAAC;oBACrD,OAAO,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;gBACjC,CAAC;gBACD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC1B,IAAI,CAAC,KAAK;oBAAE,OAAO,SAAS,CAAC;gBAC7B,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,KAAK,CAAC,IAAI;YACT,mEAAmE;YACnE,sDAAsD;QACvD,CAAC;KACD,CAAC;AACH,CAAC"}
+{"version":3,"file":"plugin-channel-manager-facade.js","sourceRoot":"","sources":["../../../src/agents/channels/plugin-channel-manager-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,4DAA4D;AAC5D,MAAM,UAAU,gCAAgC,CAAC,IAEhD;IACA,MAAM,OAAO,GAAG,GAAa,EAAE;QAC9B,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC,MAAM,GAAG,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC,CAAC;IACF,OAAO;QACN,IAAI,OAAO;YACV,OAAO,OAAO,EAAE,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,EAAU,EAAE,SAAkB;YACrC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC9B,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE;oBAAE,SAAS;gBAC1B,MAAM,QAAQ,GAAG,CAAC,CAAC,iBAAiB,EAAE,CAAC;gBACvC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;oBAC7B,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;oBACpC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;wBAAE,OAAO,SAAS,CAAC;oBAC9C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;wBAAE,OAAO,SAAS,CAAC;oBACrD,OAAO,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;gBACjC,CAAC;gBACD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC1B,IAAI,CAAC,KAAK;oBAAE,OAAO,SAAS,CAAC;gBAC7B,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,KAAK,CAAC,IAAI;YACT,mEAAmE;YACnE,sDAAsD;QACvD,CAAC;QACD,KAAK,CAAC,YAAY,CAAC,EAAU;YAC5B,mEAAmE;YACnE,qEAAqE;YACrE,kEAAkE;YAClE,gEAAgE;YAChE,qDAAqD;YACrD,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,cAAc;gBACtB,OAAO,EAAE,mBAAmB,EAAE,wGAAwG;aACtI,CAAC;QACH,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,EAAU;YAC3B,sEAAsE;YACtE,OAAO;gBACN,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,kBAAkB,EAAE,0DAA0D;aACvF,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}