@spinabot/brigade 1.3.2 → 1.5.0

package/dist/agents/extensions/loader.js

@@ -12,15 +12,27 @@
  * Activation traceability: EVERY module decision (activated / skipped) emits a
  * structured log line under the `extensions/loader` subsystem. The reason is a
  * stable enum (`disabled`/`requiresEnv`/`eligible`/`allowlist`/`configSchema`/
- * `registerFailed`) so an operator running `brigade doctor` or scraping the
- * JSONL log can answer "why didn't my plugin load" without source-diving.
+ * `registerFailed`/`activation-not-triggered`) so an operator running
+ * `brigade doctor` or scraping the JSONL log can answer "why didn't my plugin
+ * load" without source-diving.
+ *
+ * Step 5 — manifest-driven LAZY activation. User modules are no longer imported
+ * eagerly. The loader lists candidates WITHOUT importing, reads each one's
+ * sidecar `brigade.extension.json` manifest, and consults the activation planner
+ * (`activation-planner.ts`) against an active-config snapshot. A module whose
+ * declared `activation` triggers don't fire is NEVER imported (its top-level
+ * never runs) — O(manifest) boot. A module with no sidecar manifest is imported
+ * to recover its `manifest` field, then re-planned from the body, so back-compat
+ * holds (no manifest / no triggers ⇒ always activate). Skips here log
+ * `reason=activation-not-triggered`.
  */
 import { Check, Errors } from "typebox/value";
 import { resolveExtensionsDir } from "../../config/paths.js";
 import { withTimeout } from "../../core/extension-lifecycle.js";
 import { createSubsystemLogger } from "../../logging/subsystem-logger.js";
-import { discoverUserModules } from "./discovery.js";
-import { BrigadeExtensionRegistry } from "./registry.js";
+import { buildActivationSnapshot, planActivation, } from "./activation-planner.js";
+import { importDiscoveredModules, listDiscoveryCandidates, } from "./discovery.js";
+import { BrigadeExtensionRegistry, diffCapabilityIds } from "./registry.js";
 const log = createSubsystemLogger("extensions/loader");
 // A module's register() should just record capabilities and return; cap it so a
 // buggy/hung one can't wedge boot or a turn.
@@ -58,19 +70,69 @@ export async function loadModules(args) {
     const allow = ext?.allow ?? [];
     const entries = ext?.entries ?? {};
     // Bundled first; then user modules (deduped — a bundled id wins).
+    //
+    // Step 5 — manifest-driven LAZY activation. Instead of importing every user
+    // candidate up front (eager, O(modules)), we list candidates WITHOUT
+    // importing, read each one's sidecar `brigade.extension.json` manifest, and
+    // consult the activation planner against the active-config snapshot. A
+    // candidate whose declared activation triggers don't fire is NEVER imported
+    // (its top-level never runs) — that's the cold-boot win. A candidate with no
+    // sidecar manifest is imported to recover its `manifest` field, then planned
+    // again from the body so back-compat is preserved (no manifest / no triggers
+    // ⇒ always activate).
     const bundledIds = new Set(args.modules.map((m) => m.id));
     const userModules = [];
     if (!args.noDiscovery) {
-        const discovered = await discoverUserModules(args.extensionsDir ?? resolveExtensionsDir());
-        for (const d of discovered) {
-            if (bundledIds.has(d.module.id)) {
-                log.warn("user extension shadows a bundled module id — ignoring the user one", {
-                    id: d.module.id,
-                    source: d.source,
+        // Fold the command names the bundled modules declare in their manifest
+        // into the activation snapshot, so a user module gated only on
+        // `onCommands:["foo"]` can match when a bundled module contributes `foo`
+        // (the built-in channel commands are added by the snapshot itself when a
+        // channel is configured).
+        const declaredCommands = collectDeclaredCommandNames(args.modules);
+        const snapshot = buildActivationSnapshot(config, declaredCommands);
+        const candidates = listDiscoveryCandidates(args.extensionsDir ?? resolveExtensionsDir());
+        for (const cand of candidates) {
+            if (cand.safetyReason) {
+                log.warn("rejected user extension — POSIX safety check failed", {
+                    source: cand.source,
+                    reason: cand.safetyReason,
                 });
                 continue;
             }
-            userModules.push(d);
+            // (a) Sidecar present → plan BEFORE importing. A non-triggered module is
+            // skipped here and its body never runs (the lazy-activation win).
+            if (cand.manifest) {
+                const decision = planActivation(cand.manifest, snapshot);
+                if (!decision.activate) {
+                    logSkip(cand.manifest.id, "user", cand.source, "activation-not-triggered", decision.reason ?? "activation triggers did not match active config");
+                    continue;
+                }
+            }
+            // (b) Import the body (sidecar said activate, or there was no sidecar so
+            // we must read the module's own `manifest` field). The sidecar manifest,
+            // when present, is authoritative over a body-carried one.
+            const discovered = await importDiscoveredModules(cand.source, cand.manifest);
+            for (const d of discovered) {
+                // (c) No sidecar → re-plan from the body manifest (could carry its own
+                // activation triggers). If it doesn't trigger, skip registration —
+                // the body did run (no sidecar to gate on), but we still don't
+                // register a module the active config doesn't want.
+                if (!cand.manifest) {
+                    const decision = planActivation(d.manifest, snapshot);
+                    if (!decision.activate) {
+                        logSkip(d.module.id, "user", d.source, "activation-not-triggered", decision.reason ?? "activation triggers did not match active config");
+                        continue;
+                    }
+                }
+                if (bundledIds.has(d.module.id)) {
+                    log.warn("user extension shadows a bundled module id — ignoring the user one", {
+                        id: d.module.id,
+                        source: d.source,
+                    });
+                    continue;
+                }
+                userModules.push(d);
+            }
         }
     }
     const all = [
@@ -87,6 +149,19 @@ export async function loadModules(args) {
             logSkip(m.id, origin, source, "allowlist", "extensions.allow does not include this id");
             continue;
         }
+        // `enabledByDefault: false` opt-out — a module (typically a bundled one)
+        // can declare it does NOT auto-activate. It stays dormant unless the
+        // operator explicitly turns it back on via `extensions.entries[id].enabled
+        // = true` or by naming it in a non-empty `extensions.allow`. (An explicit
+        // `disabled` already short-circuited above; the allowlist gate above means
+        // that if we got here with a non-empty allow list, the id IS listed.)
+        if (m.manifest?.enabledByDefault === false) {
+            const forcedOn = entries[m.id]?.enabled === true || (allow.length > 0 && allow.includes(m.id));
+            if (!forcedOn) {
+                logSkip(m.id, origin, source, "enabledByDefault", "manifest enabledByDefault=false and not explicitly enabled (set extensions.entries[id].enabled=true to opt in)");
+                continue;
+            }
+        }
         if (m.requiresEnv) {
             const missing = m.requiresEnv.find((v) => !env[v] || env[v]?.trim() === "");
             if (missing) {
@@ -106,20 +181,56 @@ export async function loadModules(args) {
             logSkip(m.id, origin, source, "configSchema", `config invalid at ${first?.path ?? "<root>"}: ${first?.message ?? "validation error"}`);
             continue;
         }
+        // FIX 4 — mark the module discovered (it passed gating) and snapshot the
+        // registry's capability ids so we can attribute what THIS module registers.
+        registry.markModuleDiscovered(m.id);
+        const capsBefore = registry.capabilitySnapshot();
         try {
             // Time-box register so a hung module (e.g. a stray network await) can't
             // wedge boot or the per-turn path. A well-behaved register just records
             // and resolves instantly.
             await withTimeout(Promise.resolve(m.register(registry.context({ ...args.meta, moduleConfig }))), REGISTER_TIMEOUT_MS, `module ${m.id} register`);
             registry.loadedModules.push(m);
-            log.info("extension activated", { id: m.id, origin, source });
+            // FIX 4 — register() succeeded: attribute the newly-registered ids to
+            // this module and flip its record to `activated`.
+            registry.markModuleActivated(m.id, diffCapabilityIds(capsBefore, registry.capabilitySnapshot()));
+            // Per-module activation trace — one line per bundled module. At `info`
+            // this floods every short-lived CLI command (channels/pairing/agents all
+            // activate the full bundle just to enumerate adapters) and gateway boot.
+            // It's diagnostic detail, so it lives at `debug` (surface with --verbose
+            // / BRIGADE_LOG_LEVEL=debug). Failures + shadows still log at warn above.
+            log.debug("extension activated", { id: m.id, origin, source });
         }
         catch (err) {
+            // FIX 4 — record the register-phase failure so the CLI can show it live.
+            registry.markModuleFailed(m.id, "register");
             logSkip(m.id, origin, source, "registerFailed", err instanceof Error ? err.message : String(err));
         }
     }
     return registry;
 }
+/**
+ * Collect the command names the given (bundled) modules declare in their
+ * manifest's `provides.commands` slot. Used to seed the activation snapshot's
+ * `commands` set so an `onCommands` trigger on a USER module can match a command
+ * a BUNDLED module provides. Deduped + trimmed; empties dropped.
+ *
+ * Note: a module's runtime `command()` / `channelCommand()` registrations aren't
+ * known until it's imported + registered, so we use the declarative manifest
+ * rather than running anything — keeping lazy activation lazy.
+ */
+function collectDeclaredCommandNames(modules) {
+    const out = new Set();
+    for (const m of modules) {
+        const provided = m.manifest?.provides?.commands ?? [];
+        for (const name of provided) {
+            const norm = typeof name === "string" ? name.trim() : "";
+            if (norm)
+                out.add(norm);
+        }
+    }
+    return [...out];
+}
 /**
  * Emit a stable, structured `extension skipped` log line. The shape is
  * deliberately fixed (`id`/`origin`/`source`/`reason`/`cause`) so a future
@@ -136,7 +247,9 @@ function logSkip(id, origin, source, reason, cause) {
         log.warn("extension register failed", fields);
     }
     else {
-        log.info("extension skipped", fields);
+        // Per-module skip trace — same flood concern as "extension activated".
+        // Diagnostic detail → debug (surface with --verbose).
+        log.debug("extension skipped", fields);
     }
 }
 //# sourceMappingURL=loader.js.map

package/dist/agents/extensions/loader.js.map

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

package/dist/agents/extensions/registry.d.ts

@@ -16,6 +16,7 @@ import type { ExtensionFactory } from "@earendil-works/pi-coding-agent";
 import type { BrigadeConfig } from "../../config/io.js";
 import type { AnyBrigadeTool } from "../tools/types.js";
 import { type BrigadeHookName, type HookFireResult } from "./hook-runner.js";
+import type { ChannelMessagingAdapter, ChannelSecurityAdapter } from "../channels/types.adapters.js";
 import type { BrigadeExtensionContext, ChannelAdapter, ChannelCommand, GatewayMethodHandler, HttpRoute, Integration, MediaGenProvider, ProviderAuthMethodRegistration, Service, SpeechProvider, TranscriptionProvider } from "./types.js";
 /** Per-load context Brigade supplies to each module's `register(b)`. */
 export interface RegistryContextMeta {
@@ -26,6 +27,56 @@ export interface RegistryContextMeta {
     /** This module's validated config block (see `BrigadeExtensionContext.moduleConfig`). */
     moduleConfig?: unknown;
 }
+/**
+ * Lifecycle state of one module on the live registry (FIX 4 — the durable
+ * `PluginRecord` state machine the CLI can read live).
+ *
+ *   - `discovered` — the loader decided to run this module (it passed gating) but
+ *     `register()` has not completed yet.
+ *   - `activated`  — `register()` completed successfully; `capabilities` lists the
+ *     capability ids this module contributed (attributed by diffing the registry
+ *     before/after its `register()`).
+ *   - `failed`     — `register()` threw (or another register-phase step failed);
+ *     `failurePhase` names where.
+ *
+ * Unlike the discovery-only `brigade extensions list`, this reflects the
+ * REGISTER phase — so an operator can see a module that imported fine but threw
+ * while registering, which discovery alone never surfaces.
+ */
+export type PluginRecordStatus = "discovered" | "activated" | "failed";
+/** Capability ids a module contributed, grouped by kind (empty arrays omitted-as-[]). */
+export interface PluginCapabilityIds {
+    tools: string[];
+    hooks: string[];
+    commands: string[];
+    modelProviders: string[];
+    channels: string[];
+    channelCommands: string[];
+    channelMessagingAdapters: string[];
+    channelSecurityAdapters: string[];
+    speechProviders: string[];
+    transcriptionProviders: string[];
+    mediaGenProviders: string[];
+    memoryCapabilities: string[];
+    contextEngines: string[];
+    compactionProviders: string[];
+    agentHarnesses: string[];
+    webSearchProviders: string[];
+    webFetchProviders: string[];
+    integrations: string[];
+    services: string[];
+    httpRoutes: string[];
+    gatewayMethods: string[];
+}
+/** A per-module runtime record on the live registry. */
+export interface PluginRecord {
+    id: string;
+    status: PluginRecordStatus;
+    /** When `status === "failed"`, the phase that failed (e.g. `"register"`). */
+    failurePhase?: string;
+    /** Capability ids this module registered (populated on `activated`). */
+    capabilities: PluginCapabilityIds;
+}
 export declare class BrigadeExtensionRegistry {
     private readonly toolRegs;
     private readonly hookRegs;
@@ -34,6 +85,10 @@ export declare class BrigadeExtensionRegistry {
     private readonly providerAuthMethodRegs;
     private readonly channelMap;
     private readonly channelCommandMap;
+    /** OUTBOUND messaging adapters declared on a channel slot, keyed by lowercased channel id. */
+    private readonly channelMessagingMap;
+    /** SUPPLEMENTARY security adapters declared on a channel slot, keyed by lowercased channel id. */
+    private readonly channelSecurityMap;
     private readonly speechMap;
     private readonly transcriptionMap;
     private readonly mediaGenMap;
@@ -50,10 +105,56 @@ export declare class BrigadeExtensionRegistry {
     private readonly gatewayMethodMap;
     /** Modules that successfully registered — the loader fills this (used for reload). */
     readonly loadedModules: import("./types.js").BrigadeModule[];
+    /**
+     * Per-module runtime lifecycle records (FIX 4). The loader populates these as
+     * it registers each module: `discovered` before `register()`, then `activated`
+     * (with attributed capabilities) or `failed`. Insertion-ordered (Map) so the
+     * CLI renders them in load order. Read via `pluginRecord(id)` / `pluginRecords()`.
+     */
+    private readonly pluginRecordMap;
     /** Build the recording context a module's `register(b)` writes into. */
     context(meta: RegistryContextMeta): BrigadeExtensionContext;
+    /**
+     * Snapshot the FULL set of currently-registered capability ids, grouped by
+     * kind. The loader takes one of these BEFORE a module's `register()` and one
+     * AFTER, then diffs them to attribute the newly-registered ids to that module
+     * (see `diffCapabilityIds`). Pure read.
+     */
+    capabilitySnapshot(): PluginCapabilityIds;
+    /** Record that a module was selected to load (pre-`register()`). */
+    markModuleDiscovered(id: string): void;
+    /**
+     * Record that a module's `register()` succeeded. `capabilities` is the diff of
+     * the registry's capability ids across the module's `register()` (what THIS
+     * module added), produced by `diffCapabilityIds(before, after)` in the loader.
+     */
+    markModuleActivated(id: string, capabilities: PluginCapabilityIds): void;
+    /** Record that a module failed during a register-phase `phase`. */
+    markModuleFailed(id: string, phase: string): void;
+    /** Live lifecycle record for one module id, or `undefined` if never seen. */
+    pluginRecord(id: string): PluginRecord | undefined;
+    /** All live lifecycle records, in load order. */
+    pluginRecords(): PluginRecord[];
     get channels(): ChannelAdapter[];
     get channelCommands(): ChannelCommand[];
+    /**
+     * OUTBOUND messaging adapters declared via `b.channelMessaging(id, adapter)`,
+     * shaped `{ id, messaging }` so the boot can hand them straight to
+     * `syncChannelMessagingAdaptersFromPlugins(...)`. Parallel to `channels`.
+     */
+    get channelMessagingAdapters(): {
+        id: string;
+        messaging: ChannelMessagingAdapter;
+    }[];
+    /**
+     * SUPPLEMENTARY security adapters declared via `b.channelSecurity(id, adapter)`,
+     * shaped `{ id, security }` so the boot can hand them straight to
+     * `syncChannelSecurityAdaptersFromPlugins(...)`. Parallel to `channels`.
+     */
+    get channelSecurityAdapters(): {
+        id: string;
+        security: ChannelSecurityAdapter;
+    }[];
     get speechProviders(): SpeechProvider[];
     get transcriptionProviders(): TranscriptionProvider[];
     get mediaGenProviders(): MediaGenProvider[];
@@ -181,4 +282,12 @@ export declare class BrigadeExtensionRegistry {
         sessionKey?: string;
     }): ExtensionFactory;
 }
+/**
+ * Diff two capability-id snapshots (`before`/`after` a single module's
+ * `register()`), returning ONLY the ids the module added. Multiset-aware per
+ * kind: if `before` had one `web_search` tool and `after` has two, the new one
+ * is attributed. Used by the loader to attribute capabilities to the module that
+ * registered them for its `PluginRecord`.
+ */
+export declare function diffCapabilityIds(before: PluginCapabilityIds, after: PluginCapabilityIds): PluginCapabilityIds;
 //# sourceMappingURL=registry.d.ts.map

package/dist/agents/extensions/registry.d.ts.map

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

package/dist/agents/extensions/registry.js

@@ -13,6 +13,31 @@
  * Product registrations dedupe by id (last wins) so re-running modules is safe.
  */
 import { createHookRunner } from "./hook-runner.js";
+function emptyCapabilityIds() {
+    return {
+        tools: [],
+        hooks: [],
+        commands: [],
+        modelProviders: [],
+        channels: [],
+        channelCommands: [],
+        channelMessagingAdapters: [],
+        channelSecurityAdapters: [],
+        speechProviders: [],
+        transcriptionProviders: [],
+        mediaGenProviders: [],
+        memoryCapabilities: [],
+        contextEngines: [],
+        compactionProviders: [],
+        agentHarnesses: [],
+        webSearchProviders: [],
+        webFetchProviders: [],
+        integrations: [],
+        services: [],
+        httpRoutes: [],
+        gatewayMethods: [],
+    };
+}
 export class BrigadeExtensionRegistry {
     toolRegs = [];
     hookRegs = [];
@@ -21,6 +46,10 @@ export class BrigadeExtensionRegistry {
     providerAuthMethodRegs = [];
     channelMap = new Map();
     channelCommandMap = new Map();
+    /** OUTBOUND messaging adapters declared on a channel slot, keyed by lowercased channel id. */
+    channelMessagingMap = new Map();
+    /** SUPPLEMENTARY security adapters declared on a channel slot, keyed by lowercased channel id. */
+    channelSecurityMap = new Map();
     speechMap = new Map();
     transcriptionMap = new Map();
     mediaGenMap = new Map();
@@ -37,6 +66,13 @@ export class BrigadeExtensionRegistry {
     gatewayMethodMap = new Map();
     /** Modules that successfully registered — the loader fills this (used for reload). */
     loadedModules = [];
+    /**
+     * Per-module runtime lifecycle records (FIX 4). The loader populates these as
+     * it registers each module: `discovered` before `register()`, then `activated`
+     * (with attributed capabilities) or `failed`. Insertion-ordered (Map) so the
+     * CLI renders them in load order. Read via `pluginRecord(id)` / `pluginRecords()`.
+     */
+    pluginRecordMap = new Map();
     /** Build the recording context a module's `register(b)` writes into. */
     context(meta) {
         return {
@@ -87,6 +123,21 @@ export class BrigadeExtensionRegistry {
                 // case-insensitive dispatch (both sides use lowercase).
                 this.channelCommandMap.set(command.name.toLowerCase(), command);
             },
+            channelMessaging: (channelId, adapter) => {
+                // Lowercase the key so it agrees with the channel-messaging registry's
+                // case-insensitive lookup (which normalizes the same way). A blank id
+                // is dropped — the registry would reject it anyway.
+                const id = channelId.trim().toLowerCase();
+                if (id)
+                    this.channelMessagingMap.set(id, adapter);
+            },
+            channelSecurity: (channelId, adapter) => {
+                // Lowercase the key so it agrees with the channel-security registry's
+                // case-insensitive lookup. A blank id is dropped.
+                const id = channelId.trim().toLowerCase();
+                if (id)
+                    this.channelSecurityMap.set(id, adapter);
+            },
             tts: (provider) => {
                 this.speechMap.set(provider.id, provider);
             },
@@ -133,6 +184,71 @@ export class BrigadeExtensionRegistry {
             },
         };
     }
+    /* ── plugin lifecycle records (FIX 4) ── */
+    /**
+     * Snapshot the FULL set of currently-registered capability ids, grouped by
+     * kind. The loader takes one of these BEFORE a module's `register()` and one
+     * AFTER, then diffs them to attribute the newly-registered ids to that module
+     * (see `diffCapabilityIds`). Pure read.
+     */
+    capabilitySnapshot() {
+        return {
+            tools: this.toolRegs
+                .map((t) => (t.tool ? t.tool.name : t.factory?.create({ agentId: "", sessionKey: "" }).name))
+                .filter((n) => typeof n === "string"),
+            hooks: this.hookRegs.map((h) => h.event),
+            commands: this.commandRegs.map((c) => c.name),
+            modelProviders: this.modelProviderRegs.map((p) => p.name),
+            channels: [...this.channelMap.keys()],
+            channelCommands: [...this.channelCommandMap.keys()],
+            channelMessagingAdapters: [...this.channelMessagingMap.keys()],
+            channelSecurityAdapters: [...this.channelSecurityMap.keys()],
+            speechProviders: [...this.speechMap.keys()],
+            transcriptionProviders: [...this.transcriptionMap.keys()],
+            mediaGenProviders: [...this.mediaGenMap.keys()],
+            memoryCapabilities: [...this.memoryMap.keys()],
+            contextEngines: [...this.contextEngineMap.keys()],
+            compactionProviders: [...this.compactionProviderMap.keys()],
+            agentHarnesses: [...this.agentHarnessMap.keys()],
+            webSearchProviders: [...this.webSearchMap.keys()],
+            webFetchProviders: [...this.webFetchMap.keys()],
+            integrations: [...this.integrationMap.keys()],
+            services: [...this.serviceMap.keys()],
+            httpRoutes: [...this.httpRouteMap.keys()],
+            gatewayMethods: [...this.gatewayMethodMap.keys()],
+        };
+    }
+    /** Record that a module was selected to load (pre-`register()`). */
+    markModuleDiscovered(id) {
+        this.pluginRecordMap.set(id, { id, status: "discovered", capabilities: emptyCapabilityIds() });
+    }
+    /**
+     * Record that a module's `register()` succeeded. `capabilities` is the diff of
+     * the registry's capability ids across the module's `register()` (what THIS
+     * module added), produced by `diffCapabilityIds(before, after)` in the loader.
+     */
+    markModuleActivated(id, capabilities) {
+        this.pluginRecordMap.set(id, { id, status: "activated", capabilities });
+    }
+    /** Record that a module failed during a register-phase `phase`. */
+    markModuleFailed(id, phase) {
+        const prev = this.pluginRecordMap.get(id);
+        this.pluginRecordMap.set(id, {
+            id,
+            status: "failed",
+            failurePhase: phase,
+            capabilities: prev?.capabilities ?? emptyCapabilityIds(),
+        });
+    }
+    /** Live lifecycle record for one module id, or `undefined` if never seen. */
+    pluginRecord(id) {
+        const r = this.pluginRecordMap.get(id);
+        return r ? clonePluginRecord(r) : undefined;
+    }
+    /** All live lifecycle records, in load order. */
+    pluginRecords() {
+        return [...this.pluginRecordMap.values()].map(clonePluginRecord);
+    }
     /* ── product-level getters (the gateway consumes these) ── */
     get channels() {
         return [...this.channelMap.values()];
@@ -140,6 +256,22 @@ export class BrigadeExtensionRegistry {
     get channelCommands() {
         return [...this.channelCommandMap.values()];
     }
+    /**
+     * OUTBOUND messaging adapters declared via `b.channelMessaging(id, adapter)`,
+     * shaped `{ id, messaging }` so the boot can hand them straight to
+     * `syncChannelMessagingAdaptersFromPlugins(...)`. Parallel to `channels`.
+     */
+    get channelMessagingAdapters() {
+        return [...this.channelMessagingMap.entries()].map(([id, messaging]) => ({ id, messaging }));
+    }
+    /**
+     * SUPPLEMENTARY security adapters declared via `b.channelSecurity(id, adapter)`,
+     * shaped `{ id, security }` so the boot can hand them straight to
+     * `syncChannelSecurityAdaptersFromPlugins(...)`. Parallel to `channels`.
+     */
+    get channelSecurityAdapters() {
+        return [...this.channelSecurityMap.entries()].map(([id, security]) => ({ id, security }));
+    }
     get speechProviders() {
         return [...this.speechMap.values()];
     }
@@ -509,4 +641,44 @@ function filterByAllowDeny(candidates, allow, deny) {
         return true;
     });
 }
+/** Deep-ish clone of a PluginRecord so callers can't mutate the registry's copy. */
+function clonePluginRecord(r) {
+    const caps = {};
+    for (const key of Object.keys(r.capabilities)) {
+        caps[key] = [...r.capabilities[key]];
+    }
+    return {
+        id: r.id,
+        status: r.status,
+        ...(r.failurePhase !== undefined ? { failurePhase: r.failurePhase } : {}),
+        capabilities: caps,
+    };
+}
+/**
+ * Diff two capability-id snapshots (`before`/`after` a single module's
+ * `register()`), returning ONLY the ids the module added. Multiset-aware per
+ * kind: if `before` had one `web_search` tool and `after` has two, the new one
+ * is attributed. Used by the loader to attribute capabilities to the module that
+ * registered them for its `PluginRecord`.
+ */
+export function diffCapabilityIds(before, after) {
+    const out = {};
+    for (const key of Object.keys(after)) {
+        const beforeCounts = new Map();
+        for (const id of before[key])
+            beforeCounts.set(id, (beforeCounts.get(id) ?? 0) + 1);
+        const added = [];
+        for (const id of after[key]) {
+            const remaining = beforeCounts.get(id) ?? 0;
+            if (remaining > 0) {
+                beforeCounts.set(id, remaining - 1); // consumed a pre-existing one
+            }
+            else {
+                added.push(id);
+            }
+        }
+        out[key] = added;
+    }
+    return out;
+}
 //# sourceMappingURL=registry.js.map