@spinabot/brigade 0.1.2 → 1.0.1

package/dist/agents/channels/approval-router.js

@@ -0,0 +1,446 @@
+/**
+ * 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 { createSubsystemLogger } from "../../logging/subsystem-logger.js";
+import { resolveGlobalSingleton } from "../../shared/global-singleton.js";
+const log = createSubsystemLogger("brigade/channel-approvals");
+/** All three approval-router maps are pinned via global-singleton so a hot-reload / dual-build run shares one routing state. */
+const APPROVAL_ROUTER_DISPATCHERS_KEY = Symbol.for("brigade.approvalRouter.dispatchers");
+const APPROVAL_ROUTER_PENDING_BY_PEER_KEY = Symbol.for("brigade.approvalRouter.pendingByPeer");
+const APPROVAL_ROUTER_PENDING_BY_ID_KEY = Symbol.for("brigade.approvalRouter.pendingById");
+/** Keyed by `${channelId}::${accountId ?? '*'}` — multi-account adapters register one dispatcher per account. */
+const dispatchers = resolveGlobalSingleton(APPROVAL_ROUTER_DISPATCHERS_KEY, () => new Map());
+/**
+ * Keyed by `${channelId}::${accountId ?? '*'}::${threadId ?? '*'}::${conversationId}::${agentId ?? '*'}`.
+ * Disambiguates per (channel, account, thread, conversation, agent) so an
+ * approval prompt raised by one agent on one thread can't be matched by
+ * another agent's yes/no on a sibling thread / second account.
+ */
+const pendingByPeer = resolveGlobalSingleton(APPROVAL_ROUTER_PENDING_BY_PEER_KEY, () => new Map());
+/** Keyed by approval-request id — for `cancelChannelApprovalById` cleanup. */
+const pendingById = resolveGlobalSingleton(APPROVAL_ROUTER_PENDING_BY_ID_KEY, () => new Map());
+function dispatcherKey(channelId, accountId) {
+    return `${channelId}::${accountId && accountId.trim() ? accountId.trim() : "*"}`;
+}
+function peerKey(args) {
+    const account = args.accountId && args.accountId.trim() ? args.accountId.trim() : "*";
+    const thread = args.threadId && args.threadId.trim() ? args.threadId.trim() : "*";
+    const agent = args.agentId && args.agentId.trim() ? args.agentId.trim() : "*";
+    return `${args.channelId}::${account}::${thread}::${args.conversationId}::${agent}`;
+}
+function peerKeyFromRoute(route) {
+    return peerKey({
+        channelId: route.channelId,
+        conversationId: route.conversationId,
+        ...(route.accountId !== undefined ? { accountId: route.accountId } : {}),
+        ...(route.threadId !== undefined ? { threadId: route.threadId } : {}),
+        ...(route.agentId !== undefined ? { agentId: route.agentId } : {}),
+    });
+}
+/**
+ * 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 function registerChannelApprovalDispatcher(channelId, accountIdOrDispatcher, maybeDispatcher) {
+    // Back-compat: keep the 2-arg call shape working for callers that don't
+    // (yet) thread an accountId — single-account adapters land on the default
+    // dispatcher slot via accountId === undefined.
+    if (typeof accountIdOrDispatcher === "object" && accountIdOrDispatcher !== null) {
+        dispatchers.set(dispatcherKey(channelId), accountIdOrDispatcher);
+        return;
+    }
+    if (!maybeDispatcher) {
+        throw new Error("registerChannelApprovalDispatcher: missing dispatcher arg");
+    }
+    dispatchers.set(dispatcherKey(channelId, accountIdOrDispatcher ?? null), maybeDispatcher);
+}
+/**
+ * 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 function removeChannelApprovalDispatcher(channelId, accountId) {
+    if (accountId !== undefined) {
+        dispatchers.delete(dispatcherKey(channelId, accountId));
+    }
+    else {
+        const prefix = `${channelId}::`;
+        for (const key of [...dispatchers.keys()]) {
+            if (key === channelId || key.startsWith(prefix))
+                dispatchers.delete(key);
+        }
+    }
+    // Also reject any in-flight prompts the channel was carrying — the
+    // operator can't reply through a torn-down adapter, so we deny rather
+    // than leak.
+    for (const [key, entry] of pendingByPeer.entries()) {
+        if (entry.route.channelId !== channelId)
+            continue;
+        if (accountId !== undefined && (entry.route.accountId ?? "") !== accountId)
+            continue;
+        clearTimeout(entry.timer);
+        pendingByPeer.delete(key);
+        pendingById.delete(entry.request.id);
+        entry.resolveOnBridge({ kind: "deny", timedOut: true });
+    }
+}
+/** Diagnostic — used by tests + gateway `/health` checks. */
+export function listChannelApprovalDispatchers() {
+    return [...dispatchers.keys()];
+}
+/** Diagnostic — pending entries snapshot (returns shallow clones). */
+export function listPendingChannelApprovals() {
+    const now = Date.now();
+    return [...pendingByPeer.values()].map((p) => ({
+        id: p.request.id,
+        channelId: p.route.channelId,
+        conversationId: p.route.conversationId,
+        ...(p.route.threadId !== undefined ? { threadId: p.route.threadId } : {}),
+        ...(p.route.accountId !== undefined ? { accountId: p.route.accountId } : {}),
+        ...(p.route.agentId !== undefined ? { agentId: p.route.agentId } : {}),
+        command: p.request.command,
+        ageMs: now - p.createdAtMs,
+    }));
+}
+/**
+ * Build the human-readable approval prompt the operator sees in the
+ * channel. Kept short because some channels (Telegram captions, WhatsApp
+ * note-cards) impose length limits — the model's command preview is the
+ * informative part; the reply menu is the operator's actionable line.
+ *
+ * The 🦁 mark is the Brigade mascot — same brand-stamp used elsewhere in
+ * channel surfaces so the operator recognises this as a Brigade prompt and
+ * not an arbitrary chat partner asking for shell access.
+ */
+function buildPromptText(args) {
+    const flat = args.command
+        .replace(/[\r\n]+/g, " ")
+        .replace(/[\x00-\x1f\x7f]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    const preview = flat.length <= 180 ? flat : `${flat.slice(0, 177)}…`;
+    const agentSuffix = args.agentId && args.agentId.trim() && args.agentId.trim() !== "main"
+        ? ` [${args.agentId.trim()}]`
+        : "";
+    const who = args.subagentLabel
+        ? `Sub-agent "${args.subagentLabel}"${agentSuffix}`
+        : `🦁 Brigade${agentSuffix}`;
+    return [
+        `${who} wants to run a shell command:`,
+        `\`${preview}\``,
+        "",
+        "Reply *yes* to allow this once,",
+        "*always* to allowlist this exact command,",
+        "or *no* to deny.",
+        "",
+        "Times out in 5 minutes.",
+    ].join("\n");
+}
+/**
+ * Decode an operator's text reply into a decision kind. Liberal in what
+ * it accepts so the operator can type the obvious shapes without thinking:
+ *   yes / y / ok / allow / sure  → allow-once
+ *   always / save / remember     → allow-always
+ *   no / n / deny / cancel / nah → deny
+ *
+ * `null` means "couldn't decide — fall through to normal turn dispatch."
+ * That lets the operator change the subject mid-prompt (a fresh question
+ * they typed in the same chat) rather than have it eaten by the gate.
+ */
+function decodeReply(text) {
+    const t = text.trim().toLowerCase();
+    if (!t)
+        return null;
+    // Strip leading "/" so "/yes" works too — operators with slash-command
+    // muscle memory from Slack/Telegram won't be surprised.
+    const stripped = t.startsWith("/") ? t.slice(1) : t;
+    const first = stripped.split(/\s+/, 1)[0] ?? stripped;
+    switch (first) {
+        case "yes":
+        case "y":
+        case "ok":
+        case "okay":
+        case "sure":
+        case "allow":
+        case "approve":
+        case "approved":
+            return "allow-once";
+        case "always":
+        case "save":
+        case "remember":
+        case "allow-always":
+        case "allowalways":
+            return "allow-always";
+        case "no":
+        case "n":
+        case "nope":
+        case "nah":
+        case "deny":
+        case "denied":
+        case "cancel":
+        case "stop":
+        case "reject":
+            return "deny";
+        default:
+            return null;
+    }
+}
+/**
+ * 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 async function dispatchChannelApproval(args) {
+    const { request, route, resolveOnBridge } = args;
+    // Prefer the per-account dispatcher when one is registered; fall back to
+    // the channel's default-account dispatcher so single-account adapters
+    // (registered without an accountId) keep working unchanged.
+    const dispatcher = dispatchers.get(dispatcherKey(route.channelId, route.accountId ?? null)) ??
+        dispatchers.get(dispatcherKey(route.channelId));
+    if (!dispatcher) {
+        log.warn("no dispatcher for channel — falling back to WS broadcast", {
+            channelId: route.channelId,
+            conversationId: route.conversationId,
+            accountId: route.accountId,
+        });
+        return false;
+    }
+    const key = peerKeyFromRoute(route);
+    // If there's already a pending entry for this peer, deny the previous
+    // one. A second prompt overlapping the same peer means we'd be asking
+    // two questions at once — the operator can only answer one, the other
+    // would hang. Deny-the-older is the safer disposition: the model that
+    // raised the older prompt gets a clean "no" and can ask again, rather
+    // than a stale "deny on timeout" five minutes later.
+    const existing = pendingByPeer.get(key);
+    if (existing) {
+        clearTimeout(existing.timer);
+        pendingByPeer.delete(key);
+        pendingById.delete(existing.request.id);
+        existing.resolveOnBridge({ kind: "deny", timedOut: false });
+    }
+    const prompt = buildPromptText({
+        command: request.command,
+        ...(request.subagentLabel !== undefined ? { subagentLabel: request.subagentLabel } : {}),
+        ...(route.agentId !== undefined ? { agentId: route.agentId } : {}),
+    });
+    // Wave L P2#9 — reserve the peer slot SYNCHRONOUSLY before awaiting
+    // sendText. Two `dispatchChannelApproval` calls racing on the same
+    // peer-key would otherwise both pass the `pendingByPeer.get(key)` check
+    // above (since neither has set the slot yet) and both `pendingByPeer.set`
+    // after the await — silently losing one of the resolveOnBridge handles.
+    // Placeholder is replaced with the real entry below; on sendText failure
+    // the placeholder is removed so the caller falls back to the WS path.
+    const reservationToken = {
+        request,
+        route,
+        resolveOnBridge,
+        timer: setTimeout(() => undefined, 0),
+        createdAtMs: Date.now(),
+    };
+    clearTimeout(reservationToken.timer);
+    pendingByPeer.set(key, reservationToken);
+    try {
+        const sendOpts = {};
+        if (route.threadId)
+            sendOpts.threadId = route.threadId;
+        if (route.accountId)
+            sendOpts.accountId = route.accountId;
+        await dispatcher.sendText(route.conversationId, prompt, Object.keys(sendOpts).length > 0 ? sendOpts : undefined);
+    }
+    catch (err) {
+        // Release the reserved slot so the WS-fallback path can run cleanly.
+        if (pendingByPeer.get(key) === reservationToken) {
+            pendingByPeer.delete(key);
+        }
+        log.warn("approval prompt send failed — falling back to WS broadcast", {
+            channelId: route.channelId,
+            conversationId: route.conversationId,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return false;
+    }
+    // Internal watchdog independent of the bridge's own timeout: the bridge
+    // timer fires at `request.timeoutMs` and resolves the in-flight promise;
+    // when that happens we still need to clean OUR maps so a late operator
+    // reply doesn't intercept the next turn's text by mistake. We run a
+    // matching timer at the same horizon — whichever fires first wins, and
+    // the loser is a no-op because the entry is already gone.
+    const watchdog = setTimeout(() => {
+        const entry = pendingByPeer.get(key);
+        if (!entry || entry.request.id !== request.id)
+            return;
+        pendingByPeer.delete(key);
+        pendingById.delete(request.id);
+        // The bridge will fire its own timeout at the same moment; we don't
+        // need to call `resolveOnBridge` here because the bridge's timer
+        // already does. Setting our entry aside is enough.
+    }, request.timeoutMs);
+    if (typeof watchdog.unref === "function")
+        watchdog.unref();
+    const entry = {
+        request,
+        route,
+        resolveOnBridge,
+        timer: watchdog,
+        createdAtMs: Date.now(),
+    };
+    pendingByPeer.set(key, entry);
+    pendingById.set(request.id, entry);
+    log.info("approval prompt sent via channel", {
+        channelId: route.channelId,
+        conversationId: route.conversationId,
+        approvalId: request.id,
+        via: dispatcher.prettyName,
+    });
+    return true;
+}
+/**
+ * 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 function tryConsumeChannelApprovalReply(args) {
+    // First, try the exact-route key (covers thread + account + agent
+    // disambiguation). If nothing matches AND the caller didn't pin all
+    // dimensions, scan for any pending entry whose route's pinned dimensions
+    // agree with the caller — that handles the WhatsApp-style flat-DM case
+    // where the inbound carries no threadId but the approval was raised on
+    // the same channel+conversation.
+    const exactKey = peerKey({
+        channelId: args.channelId,
+        conversationId: args.conversationId,
+        ...(args.threadId !== undefined ? { threadId: args.threadId } : {}),
+        ...(args.accountId !== undefined ? { accountId: args.accountId } : {}),
+        ...(args.agentId !== undefined ? { agentId: args.agentId } : {}),
+    });
+    let entry = pendingByPeer.get(exactKey);
+    let entryKey = exactKey;
+    if (!entry) {
+        // Fall back to a per-channel + per-conversation scan that matches when
+        // the caller didn't pin every dimension (e.g. WhatsApp inbound has no
+        // thread/account). Stops on the first agreeing route to preserve the
+        // "one prompt per peer at a time" invariant.
+        for (const [k, candidate] of pendingByPeer.entries()) {
+            const r = candidate.route;
+            if (r.channelId !== args.channelId || r.conversationId !== args.conversationId)
+                continue;
+            if (args.threadId !== undefined && r.threadId !== undefined && r.threadId !== args.threadId)
+                continue;
+            if (args.accountId !== undefined && r.accountId !== undefined && r.accountId !== args.accountId)
+                continue;
+            if (args.agentId !== undefined && r.agentId !== undefined && r.agentId !== args.agentId)
+                continue;
+            entry = candidate;
+            entryKey = k;
+            break;
+        }
+    }
+    if (!entry)
+        return { matched: false };
+    const kind = decodeReply(args.text);
+    if (kind === null)
+        return { matched: false };
+    pendingByPeer.delete(entryKey);
+    pendingById.delete(entry.request.id);
+    clearTimeout(entry.timer);
+    const decision = { kind };
+    entry.resolveOnBridge(decision);
+    log.info("approval resolved via channel reply", {
+        channelId: args.channelId,
+        conversationId: args.conversationId,
+        approvalId: entry.request.id,
+        decision: kind,
+    });
+    return { matched: true, decision: kind, approvalId: entry.request.id };
+}
+/**
+ * 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 function cancelChannelApprovalById(approvalId) {
+    const entry = pendingById.get(approvalId);
+    if (!entry)
+        return;
+    const key = peerKeyFromRoute(entry.route);
+    clearTimeout(entry.timer);
+    pendingByPeer.delete(key);
+    pendingById.delete(approvalId);
+}
+/** Test-only — clear every registration + pending entry. */
+export function resetChannelApprovalRouterForTests() {
+    for (const entry of pendingByPeer.values())
+        clearTimeout(entry.timer);
+    pendingByPeer.clear();
+    pendingById.clear();
+    dispatchers.clear();
+}
+//# sourceMappingURL=approval-router.js.map

package/dist/agents/channels/approval-router.js.map

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

package/dist/agents/channels/channel-entry-contract.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Bundled channel-entry contract + factory.
+ *
+ * Brand-scrubbed analogue of upstream's `src/plugin-sdk/channel-entry-contract.ts`,
+ * trimmed to what Brigade's plugin loader needs today. The factory
+ * (`defineBundledChannelEntry`) emits a `BundledChannelEntryContract`
+ * descriptor object that:
+ *
+ *   1. Identifies the plugin (`id`, `name`, `description`).
+ *   2. Hands the loader a lazy `loadChannelPlugin()` accessor that
+ *      returns the `ChannelPlugin` definition only when the plugin is
+ *      activated (avoids paying for unused channel imports at boot).
+ *   3. Optionally surfaces `loadChannelSecrets()` and
+ *      `setChannelRuntime()` for plugins that need secret-target
+ *      registration + per-runtime side effects respectively.
+ *
+ * What Brigade DOES NOT do here (deferred to Pi 0.73 native extension
+ * engine + Step 16):
+ *
+ *   - It does NOT load the module from disk — that's the Pi engine's
+ *     job. The factory receives a direct `loadChannelPlugin` callable
+ *     instead of a `{ specifier, exportName }` import descriptor.
+ *
+ *   - It does NOT register with a `BrigadePluginApi` (no such object
+ *     exists yet in Brigade — Pi 0.73 owns plugin registration). The
+ *     factory just emits the descriptor; the Pi-side adapter consumes
+ *     it.
+ *
+ * Channel plugin authors call this once per plugin (typically from
+ * `extensions/<name>/index.ts`) and `export default` the result.
+ */
+import type { ChannelPlugin } from "./types.plugin.js";
+export type ChannelPluginRuntime = {
+    logger?: {
+        info?: (message: string, meta?: Record<string, unknown>) => void;
+        warn?: (message: string, meta?: Record<string, unknown>) => void;
+        error?: (message: string, meta?: Record<string, unknown>) => void;
+    };
+    [key: string]: unknown;
+};
+export interface DefineBundledChannelEntryOptions<TPlugin = ChannelPlugin> {
+    /** Kebab-case plugin id; must match `plugin.id`. */
+    id: string;
+    /** Human-readable display name. */
+    name: string;
+    /** One-line description. */
+    description: string;
+    /** Lazy accessor for the channel plugin module. */
+    loadChannelPlugin: () => TPlugin;
+    /** Optional accessor for secret-target registry entries. */
+    loadChannelSecrets?: () => ChannelPlugin["secrets"] | undefined;
+    /** Optional runtime initialiser called once on first plugin activation. */
+    setChannelRuntime?: (runtime: ChannelPluginRuntime) => void;
+}
+export interface BundledChannelEntryContract<TPlugin = ChannelPlugin> {
+    kind: "bundled-channel-entry";
+    id: string;
+    name: string;
+    description: string;
+    loadChannelPlugin: () => TPlugin;
+    loadChannelSecrets?: () => ChannelPlugin["secrets"] | undefined;
+    setChannelRuntime?: (runtime: ChannelPluginRuntime) => void;
+}
+/**
+ * Factory consumed by every bundled channel extension. Returns a
+ * descriptor the Pi-side plugin engine adapter (Step 16) registers
+ * against the gateway.
+ */
+export declare function defineBundledChannelEntry<TPlugin = ChannelPlugin>(opts: DefineBundledChannelEntryOptions<TPlugin>): BundledChannelEntryContract<TPlugin>;
+//# sourceMappingURL=channel-entry-contract.d.ts.map

package/dist/agents/channels/channel-entry-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-entry-contract.d.ts","sourceRoot":"","sources":["../../../src/agents/channels/channel-entry-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,MAAM,oBAAoB,GAAG;IAClC,MAAM,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACjE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACjE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KAClE,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,gCAAgC,CAAC,OAAO,GAAG,aAAa;IACxE,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,OAAO,CAAC;IACjC,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,aAAa,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAChE,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,2BAA2B,CAAC,OAAO,GAAG,aAAa;IACnE,IAAI,EAAE,uBAAuB,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,OAAO,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,aAAa,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAChE,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC5D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,GAAG,aAAa,EAChE,IAAI,EAAE,gCAAgC,CAAC,OAAO,CAAC,GAC7C,2BAA2B,CAAC,OAAO,CAAC,CAUtC"}

package/dist/agents/channels/channel-entry-contract.js

@@ -0,0 +1,48 @@
+/**
+ * Bundled channel-entry contract + factory.
+ *
+ * Brand-scrubbed analogue of upstream's `src/plugin-sdk/channel-entry-contract.ts`,
+ * trimmed to what Brigade's plugin loader needs today. The factory
+ * (`defineBundledChannelEntry`) emits a `BundledChannelEntryContract`
+ * descriptor object that:
+ *
+ *   1. Identifies the plugin (`id`, `name`, `description`).
+ *   2. Hands the loader a lazy `loadChannelPlugin()` accessor that
+ *      returns the `ChannelPlugin` definition only when the plugin is
+ *      activated (avoids paying for unused channel imports at boot).
+ *   3. Optionally surfaces `loadChannelSecrets()` and
+ *      `setChannelRuntime()` for plugins that need secret-target
+ *      registration + per-runtime side effects respectively.
+ *
+ * What Brigade DOES NOT do here (deferred to Pi 0.73 native extension
+ * engine + Step 16):
+ *
+ *   - It does NOT load the module from disk — that's the Pi engine's
+ *     job. The factory receives a direct `loadChannelPlugin` callable
+ *     instead of a `{ specifier, exportName }` import descriptor.
+ *
+ *   - It does NOT register with a `BrigadePluginApi` (no such object
+ *     exists yet in Brigade — Pi 0.73 owns plugin registration). The
+ *     factory just emits the descriptor; the Pi-side adapter consumes
+ *     it.
+ *
+ * Channel plugin authors call this once per plugin (typically from
+ * `extensions/<name>/index.ts`) and `export default` the result.
+ */
+/**
+ * Factory consumed by every bundled channel extension. Returns a
+ * descriptor the Pi-side plugin engine adapter (Step 16) registers
+ * against the gateway.
+ */
+export function defineBundledChannelEntry(opts) {
+    return {
+        kind: "bundled-channel-entry",
+        id: opts.id,
+        name: opts.name,
+        description: opts.description,
+        loadChannelPlugin: opts.loadChannelPlugin,
+        ...(opts.loadChannelSecrets ? { loadChannelSecrets: opts.loadChannelSecrets } : {}),
+        ...(opts.setChannelRuntime ? { setChannelRuntime: opts.setChannelRuntime } : {}),
+    };
+}
+//# sourceMappingURL=channel-entry-contract.js.map

package/dist/agents/channels/channel-entry-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-entry-contract.js","sourceRoot":"","sources":["../../../src/agents/channels/channel-entry-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAsCH;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACxC,IAA+C;IAE/C,OAAO;QACN,IAAI,EAAE,uBAAuB;QAC7B,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChF,CAAC;AACH,CAAC"}