@spinabot/brigade 0.1.2 → 1.0.1

package/dist/agents/channels/types.core.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Channel plugin contract — core types shared across every adapter.
+ *
+ * Brand-scrubbed analogue of upstream's `src/channels/plugins/types.core.ts`.
+ * The shapes here are domain-neutral (no upstream-specific identifiers),
+ * so the lift is mostly a rename pass: upstream `Config` type → `BrigadeConfig`.
+ *
+ * Conventions:
+ *
+ *   - `ChannelId` is the canonical, kebab-case plugin id (`whatsapp`,
+ *     `slack`, `telegram`, `discord`). It's also the directory name
+ *     under `extensions/<id>/` and the key under `cfg.channels.<id>`.
+ *
+ *   - `ChannelMeta` is the user-facing display surface (labels, blurb,
+ *     docs paths). The CLI setup wizard, the device-pairing UI, and
+ *     the `brigade status` view all read from this.
+ *
+ *   - `ChannelCapabilities` is the static "what this plugin can do"
+ *     declaration. Channel-manager (Step 16) uses these flags to pre-
+ *     check whether a sub-adapter call is even worth attempting (e.g.
+ *     `capabilities.reactions === false` → skip the `sendReaction`
+ *     dispatch entirely).
+ *
+ *   - `RuntimeEnv` is a placeholder for the cross-cutting runtime
+ *     context (process logger, abort signal, plugin runtime helpers,
+ *     etc.) that gets handed to every adapter that needs side effects.
+ *     Brigade narrows this in Step 16 when the channel-manager lift
+ *     wires the actual runtime; today it's deliberately loose so the
+ *     contract can be defined without dragging the manager in first.
+ */
+import type { ChatType } from "./chat-type.js";
+/** Canonical, kebab-case plugin id. */
+export type ChannelId = string;
+/** Exposure tier — controls which setup surfaces list the channel. */
+export type ChannelExposure = "public" | "internal" | "experimental";
+/**
+ * Static capability flags advertised by a channel plugin.
+ *
+ * Channel-manager (Step 16) reads these to pre-check sub-adapter calls
+ * — a plugin with `reactions: false` won't have `outbound.sendReaction`
+ * invoked, even if the dispatcher receives a reaction payload.
+ */
+export type ChannelCapabilities = {
+    /** Which chat shapes the plugin handles ("direct" | "group" | "channel" | "thread"). */
+    chatTypes: Array<ChatType | "thread">;
+    polls?: boolean;
+    reactions?: boolean;
+    edit?: boolean;
+    unsend?: boolean;
+    reply?: boolean;
+    effects?: boolean;
+    groupManagement?: boolean;
+    threads?: boolean;
+    media?: boolean;
+    nativeCommands?: boolean;
+    /**
+     * If `true`, streaming output must be buffered and sent as one final
+     * payload (e.g. SMS gateways that can't update a live message).
+     */
+    blockStreaming?: boolean;
+};
+/** User-facing metadata used in docs, pickers, and setup surfaces. */
+export type ChannelMeta = {
+    id: ChannelId;
+    label: string;
+    selectionLabel: string;
+    docsPath: string;
+    docsLabel?: string;
+    blurb: string;
+    order?: number;
+    aliases?: readonly string[];
+    selectionDocsPrefix?: string;
+    selectionDocsOmitLabel?: boolean;
+    selectionExtras?: readonly string[];
+    detailLabel?: string;
+    systemImage?: string;
+    markdownCapable?: boolean;
+    exposure?: ChannelExposure;
+    showConfigured?: boolean;
+    showInSetup?: boolean;
+    quickstartAllowFrom?: boolean;
+    forceAccountBinding?: boolean;
+    preferSessionLookupForAnnounceTarget?: boolean;
+    preferOver?: readonly string[];
+};
+/** "running" / "stopped" / "errored" — surfaced by `brigade status`. */
+export type ChannelAccountState = "running" | "stopped" | "errored" | "starting" | "stopping";
+/**
+ * Display snapshot returned by `status.buildAccountSnapshot`. The shape
+ * is intentionally open — different channels surface different fields.
+ */
+export type ChannelAccountSnapshot = {
+    id: string;
+    state?: ChannelAccountState;
+    displayName?: string;
+    description?: string;
+    [key: string]: unknown;
+};
+/** Single status row for `collectStatusIssues` callers. */
+export type ChannelStatusIssue = {
+    accountId: string;
+    severity: "info" | "warn" | "error";
+    message: string;
+};
+/** Lines emitted by `status.formatCapabilitiesProbe` — one diagnostic per line. */
+export type ChannelCapabilitiesDisplayLine = {
+    label: string;
+    value: string;
+    hint?: string;
+};
+/** Diagnostic block emitted by `status.buildCapabilitiesDiagnostics`. */
+export type ChannelCapabilitiesDiagnostics = {
+    target?: string;
+    lines: ChannelCapabilitiesDisplayLine[];
+};
+/**
+ * Cross-cutting runtime context handed to side-effect adapters.
+ *
+ * Step 16 narrows this to a concrete interface (logger + abortSignal +
+ * runtime helpers); for now the contract accepts an open shape so the
+ * plugin SDK can compile without the manager lift landing first.
+ */
+export type RuntimeEnv = {
+    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;
+        debug?: (message: string, meta?: Record<string, unknown>) => void;
+    };
+    signal?: AbortSignal;
+    [key: string]: unknown;
+};
+export type { ChatType };
+//# sourceMappingURL=types.core.d.ts.map

package/dist/agents/channels/types.core.d.ts.map

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

package/dist/agents/channels/types.core.js

@@ -0,0 +1,32 @@
+/**
+ * Channel plugin contract — core types shared across every adapter.
+ *
+ * Brand-scrubbed analogue of upstream's `src/channels/plugins/types.core.ts`.
+ * The shapes here are domain-neutral (no upstream-specific identifiers),
+ * so the lift is mostly a rename pass: upstream `Config` type → `BrigadeConfig`.
+ *
+ * Conventions:
+ *
+ *   - `ChannelId` is the canonical, kebab-case plugin id (`whatsapp`,
+ *     `slack`, `telegram`, `discord`). It's also the directory name
+ *     under `extensions/<id>/` and the key under `cfg.channels.<id>`.
+ *
+ *   - `ChannelMeta` is the user-facing display surface (labels, blurb,
+ *     docs paths). The CLI setup wizard, the device-pairing UI, and
+ *     the `brigade status` view all read from this.
+ *
+ *   - `ChannelCapabilities` is the static "what this plugin can do"
+ *     declaration. Channel-manager (Step 16) uses these flags to pre-
+ *     check whether a sub-adapter call is even worth attempting (e.g.
+ *     `capabilities.reactions === false` → skip the `sendReaction`
+ *     dispatch entirely).
+ *
+ *   - `RuntimeEnv` is a placeholder for the cross-cutting runtime
+ *     context (process logger, abort signal, plugin runtime helpers,
+ *     etc.) that gets handed to every adapter that needs side effects.
+ *     Brigade narrows this in Step 16 when the channel-manager lift
+ *     wires the actual runtime; today it's deliberately loose so the
+ *     contract can be defined without dragging the manager in first.
+ */
+export {};
+//# sourceMappingURL=types.core.js.map

package/dist/agents/channels/types.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.core.js","sourceRoot":"","sources":["../../../src/agents/channels/types.core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG"}

package/dist/agents/channels/types.plugin.d.ts

@@ -0,0 +1,78 @@
+/**
+ * `ChannelPlugin<R, P, A>` — the full plugin contract surface.
+ *
+ * Brand-scrubbed analogue of upstream's `src/channels/plugins/types.plugin.ts`.
+ * The shape carries all 28 optional adapter slots; only the eight
+ * lifted in `types.adapters.ts` have concrete shapes today. The
+ * remaining slots are typed as `unknown` so a channel plugin can declare
+ * them now and Step 16+ can tighten the types as the channel manager
+ * fans out.
+ *
+ * Generic parameters:
+ *
+ *   - `ResolvedAccount` — the channel's per-account state object (e.g.
+ *     `{ id, botToken, lastSeenAt, ... }`). Defaults to `unknown`.
+ *   - `Probe`           — the payload returned by `status.probeAccount`.
+ *   - `Audit`           — the payload returned by `status.auditAccount`.
+ *
+ * Required slots (every channel must define):
+ *   - `id`             — kebab-case canonical channel id.
+ *   - `meta`           — user-facing display info.
+ *   - `capabilities`   — boolean-flag capability declaration.
+ *   - `config`         — `ChannelConfigAdapter` (account discovery).
+ *
+ * Every other slot is optional. The channel-manager (Step 16) reads
+ * `capabilities.<flag>` BEFORE consulting an adapter — a channel with
+ * `capabilities.reactions: false` won't have its `outbound.sendReaction`
+ * called even if the dispatcher receives a reaction payload.
+ */
+import type { ChannelId, ChannelMeta, ChannelCapabilities } from "./types.core.js";
+import type { ChannelApprovalCapability, ChannelConfigAdapter, ChannelGatewayAdapter, ChannelOutboundAdapter, ChannelSecurityAdapter, ChannelLifecycleAdapter, ChannelStatusAdapter, ChannelMessageActionAdapter, ChannelSecretsAdapter } from "./types.adapters.js";
+/** Full capability contract for a native channel plugin. */
+export type ChannelPlugin<ResolvedAccount = any, Probe = unknown, Audit = unknown> = {
+    id: ChannelId;
+    meta: ChannelMeta;
+    capabilities: ChannelCapabilities;
+    config: ChannelConfigAdapter<ResolvedAccount>;
+    gateway?: ChannelGatewayAdapter<ResolvedAccount>;
+    outbound?: ChannelOutboundAdapter;
+    security?: ChannelSecurityAdapter<ResolvedAccount>;
+    lifecycle?: ChannelLifecycleAdapter;
+    status?: ChannelStatusAdapter<ResolvedAccount, Probe, Audit>;
+    actions?: ChannelMessageActionAdapter;
+    secrets?: ChannelSecretsAdapter;
+    /** Channel-native approval rendering + reply decoding (Step 17). */
+    approvalCapability?: ChannelApprovalCapability;
+    defaults?: {
+        queue?: {
+            debounceMs?: number;
+        };
+    };
+    reload?: {
+        configPrefixes: string[];
+        noopPrefixes?: string[];
+    };
+    setupWizard?: unknown;
+    configSchema?: unknown;
+    setup?: unknown;
+    pairing?: unknown;
+    groups?: unknown;
+    mentions?: unknown;
+    gatewayMethods?: string[];
+    auth?: unknown;
+    elevated?: unknown;
+    commands?: unknown;
+    allowlist?: unknown;
+    doctor?: unknown;
+    bindings?: unknown;
+    conversationBindings?: unknown;
+    streaming?: unknown;
+    threading?: unknown;
+    messaging?: unknown;
+    agentPrompt?: unknown;
+    directory?: unknown;
+    resolver?: unknown;
+    heartbeat?: unknown;
+    agentTools?: unknown;
+};
+//# sourceMappingURL=types.plugin.d.ts.map

package/dist/agents/channels/types.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.plugin.d.ts","sourceRoot":"","sources":["../../../src/agents/channels/types.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,KAAK,EACX,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,EACrB,MAAM,qBAAqB,CAAC;AAE7B,4DAA4D;AAE5D,MAAM,MAAM,aAAa,CAAC,eAAe,GAAG,GAAG,EAAE,KAAK,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,IAAI;IAEpF,EAAE,EAAE,SAAS,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,mBAAmB,CAAC;IAClC,MAAM,EAAE,oBAAoB,CAAC,eAAe,CAAC,CAAC;IAG9C,OAAO,CAAC,EAAE,qBAAqB,CAAC,eAAe,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,QAAQ,CAAC,EAAE,sBAAsB,CAAC,eAAe,CAAC,CAAC;IACnD,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,MAAM,CAAC,EAAE,oBAAoB,CAAC,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;IAG/C,QAAQ,CAAC,EAAE;QACV,KAAK,CAAC,EAAE;YACP,UAAU,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACF,CAAC;IACF,MAAM,CAAC,EAAE;QAAE,cAAc,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC/D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC"}

package/dist/agents/channels/types.plugin.js

@@ -0,0 +1,30 @@
+/**
+ * `ChannelPlugin<R, P, A>` — the full plugin contract surface.
+ *
+ * Brand-scrubbed analogue of upstream's `src/channels/plugins/types.plugin.ts`.
+ * The shape carries all 28 optional adapter slots; only the eight
+ * lifted in `types.adapters.ts` have concrete shapes today. The
+ * remaining slots are typed as `unknown` so a channel plugin can declare
+ * them now and Step 16+ can tighten the types as the channel manager
+ * fans out.
+ *
+ * Generic parameters:
+ *
+ *   - `ResolvedAccount` — the channel's per-account state object (e.g.
+ *     `{ id, botToken, lastSeenAt, ... }`). Defaults to `unknown`.
+ *   - `Probe`           — the payload returned by `status.probeAccount`.
+ *   - `Audit`           — the payload returned by `status.auditAccount`.
+ *
+ * Required slots (every channel must define):
+ *   - `id`             — kebab-case canonical channel id.
+ *   - `meta`           — user-facing display info.
+ *   - `capabilities`   — boolean-flag capability declaration.
+ *   - `config`         — `ChannelConfigAdapter` (account discovery).
+ *
+ * Every other slot is optional. The channel-manager (Step 16) reads
+ * `capabilities.<flag>` BEFORE consulting an adapter — a channel with
+ * `capabilities.reactions: false` won't have its `outbound.sendReaction`
+ * called even if the dispatcher receives a reaction payload.
+ */
+export {};
+//# sourceMappingURL=types.plugin.js.map

package/dist/agents/channels/types.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.plugin.js","sourceRoot":"","sources":["../../../src/agents/channels/types.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}

package/dist/agents/channels/whatsapp/account-config.d.ts

@@ -0,0 +1,50 @@
+/**
+ * WhatsApp config-shape helpers (multi-account aware).
+ *
+ * Brigade's WhatsApp config supports two shapes:
+ *
+ *   Legacy (single-account, back-compat):
+ *     channels.whatsapp = { enabled: true, verbose?: boolean }
+ *
+ *   Multi-account (Wave F):
+ *     channels.whatsapp = {
+ *       enabled: true,
+ *       accounts: [
+ *         { id: "personal", enabled?: true },
+ *         { id: "work",     enabled?: true, authDir?: "/custom/path" },
+ *       ],
+ *     }
+ *
+ * Helpers here normalise both shapes onto the multi-account surface the
+ * `ChannelPlugin` contract consumes (`listAccountIds`, `resolveAccount`).
+ * A legacy config with no `accounts[]` reads as `[{ id: "default" }]`.
+ */
+import type { BrigadeConfig } from "../../../config/io.js";
+declare const CHANNEL_ID = "whatsapp";
+declare const DEFAULT_ACCOUNT_ID = "default";
+/** Resolved per-account info — what the plugin runtime hands to handlers. */
+export interface ResolvedWhatsAppAccount {
+    accountId: string;
+    enabled: boolean;
+    authDir: string;
+    verbose: boolean;
+}
+/** Is the WhatsApp channel switched on at all (any shape)? */
+export declare function whatsappChannelEnabled(cfg: BrigadeConfig): boolean;
+/** List configured account ids. Legacy single-account configs surface `["default"]`. */
+export declare function listWhatsAppAccountIds(cfg: BrigadeConfig): string[];
+/**
+ * Resolve the on-disk auth directory for an account. Layout:
+ *   ~/.brigade/channels/whatsapp/<accountId>/auth/
+ *
+ * Legacy `default` account preserves the historical path
+ * (`~/.brigade/channels/whatsapp/auth/`) so existing single-account installs
+ * keep their creds without a migration. The plugin path always uses the
+ * per-account layout — `default` lives at the legacy path purely for
+ * compatibility with the legacy single-adapter boot.
+ */
+export declare function resolveWhatsAppAccountAuthDir(accountId: string): string;
+/** Resolve a per-account view of the config (defaults filled in). */
+export declare function resolveWhatsAppAccount(cfg: BrigadeConfig, accountId?: string | null): ResolvedWhatsAppAccount;
+export { CHANNEL_ID as WHATSAPP_CHANNEL_ID, DEFAULT_ACCOUNT_ID as WHATSAPP_DEFAULT_ACCOUNT_ID };
+//# sourceMappingURL=account-config.d.ts.map

package/dist/agents/channels/whatsapp/account-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-config.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/whatsapp/account-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D,QAAA,MAAM,UAAU,aAAa,CAAC;AAC9B,QAAA,MAAM,kBAAkB,YAAY,CAAC;AAiBrC,6EAA6E;AAC7E,MAAM,WAAW,uBAAuB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CACjB;AAOD,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAElE;AAED,wFAAwF;AACxF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,EAAE,CAgBnE;AAeD;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,aAAa,EAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,uBAAuB,CAezB;AAED,OAAO,EAAE,UAAU,IAAI,mBAAmB,EAAE,kBAAkB,IAAI,2BAA2B,EAAE,CAAC"}

package/dist/agents/channels/whatsapp/account-config.js

@@ -0,0 +1,105 @@
+/**
+ * WhatsApp config-shape helpers (multi-account aware).
+ *
+ * Brigade's WhatsApp config supports two shapes:
+ *
+ *   Legacy (single-account, back-compat):
+ *     channels.whatsapp = { enabled: true, verbose?: boolean }
+ *
+ *   Multi-account (Wave F):
+ *     channels.whatsapp = {
+ *       enabled: true,
+ *       accounts: [
+ *         { id: "personal", enabled?: true },
+ *         { id: "work",     enabled?: true, authDir?: "/custom/path" },
+ *       ],
+ *     }
+ *
+ * Helpers here normalise both shapes onto the multi-account surface the
+ * `ChannelPlugin` contract consumes (`listAccountIds`, `resolveAccount`).
+ * A legacy config with no `accounts[]` reads as `[{ id: "default" }]`.
+ */
+import path from "node:path";
+import { resolveChannelStateDir } from "../../../config/paths.js";
+const CHANNEL_ID = "whatsapp";
+const DEFAULT_ACCOUNT_ID = "default";
+/** Read `channels.whatsapp` loosely (schema keeps it open). */
+function whatsappChannelConfig(cfg) {
+    return cfg.channels?.[CHANNEL_ID];
+}
+/** Is the WhatsApp channel switched on at all (any shape)? */
+export function whatsappChannelEnabled(cfg) {
+    return whatsappChannelConfig(cfg)?.enabled === true;
+}
+/** List configured account ids. Legacy single-account configs surface `["default"]`. */
+export function listWhatsAppAccountIds(cfg) {
+    const slot = whatsappChannelConfig(cfg);
+    if (!slot || slot.enabled !== true)
+        return [];
+    const accounts = Array.isArray(slot.accounts) ? slot.accounts : undefined;
+    if (!accounts || accounts.length === 0)
+        return [DEFAULT_ACCOUNT_ID];
+    const ids = [];
+    const seen = new Set();
+    for (const entry of accounts) {
+        const id = typeof entry?.id === "string" ? entry.id.trim() : "";
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        ids.push(id);
+    }
+    // Empty / malformed `accounts:[]` still degrades to the default account so a
+    // half-typed config doesn't silently disable WhatsApp.
+    return ids.length === 0 ? [DEFAULT_ACCOUNT_ID] : ids;
+}
+/** Look up the raw account entry from config (or null when missing). */
+function findAccountEntry(cfg, accountId) {
+    const slot = whatsappChannelConfig(cfg);
+    if (!slot)
+        return null;
+    const accounts = Array.isArray(slot.accounts) ? slot.accounts : undefined;
+    if (!accounts)
+        return null;
+    for (const entry of accounts) {
+        const id = typeof entry?.id === "string" ? entry.id.trim() : "";
+        if (id === accountId)
+            return entry;
+    }
+    return null;
+}
+/**
+ * Resolve the on-disk auth directory for an account. Layout:
+ *   ~/.brigade/channels/whatsapp/<accountId>/auth/
+ *
+ * Legacy `default` account preserves the historical path
+ * (`~/.brigade/channels/whatsapp/auth/`) so existing single-account installs
+ * keep their creds without a migration. The plugin path always uses the
+ * per-account layout — `default` lives at the legacy path purely for
+ * compatibility with the legacy single-adapter boot.
+ */
+export function resolveWhatsAppAccountAuthDir(accountId) {
+    const id = (accountId || "").trim();
+    const base = resolveChannelStateDir(CHANNEL_ID);
+    if (!id || id === DEFAULT_ACCOUNT_ID) {
+        return path.join(base, "auth");
+    }
+    return path.join(base, id, "auth");
+}
+/** Resolve a per-account view of the config (defaults filled in). */
+export function resolveWhatsAppAccount(cfg, accountId) {
+    const slot = whatsappChannelConfig(cfg);
+    const id = accountId?.trim() || DEFAULT_ACCOUNT_ID;
+    const entry = findAccountEntry(cfg, id);
+    const enabled = entry?.enabled !== false && slot?.enabled === true;
+    const authDir = typeof entry?.authDir === "string" && entry.authDir.trim()
+        ? path.resolve(entry.authDir.trim())
+        : resolveWhatsAppAccountAuthDir(id);
+    return {
+        accountId: id,
+        enabled,
+        authDir,
+        verbose: slot?.verbose === true,
+    };
+}
+export { CHANNEL_ID as WHATSAPP_CHANNEL_ID, DEFAULT_ACCOUNT_ID as WHATSAPP_DEFAULT_ACCOUNT_ID };
+//# sourceMappingURL=account-config.js.map

package/dist/agents/channels/whatsapp/account-config.js.map

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

package/dist/agents/channels/whatsapp/adapter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * WhatsApp channel adapter.
+ *
+ * Implements the Brigade `ChannelAdapter` contract on top of the Baileys
+ * connection. Linking is QR-based (no API key): on first start it prints a QR
+ * to the gateway terminal and surfaces it via `ctx.onPairing`; once scanned,
+ * creds persist under `~/.brigade/channels/whatsapp/auth/` and subsequent boots
+ * reconnect silently.
+ *
+ * Enablement is explicit — `channels.whatsapp.enabled: true` in brigade.json —
+ * so the gateway never prints a QR unless the operator opted in.
+ */
+import type { ChannelAdapter } from "../../extensions/types.js";
+/** Adapter construction options — all optional for back-compat. */
+export interface CreateWhatsAppAdapterOptions {
+    /** Per-account scope (multi-account plugin path). Defaults to `"default"`. */
+    accountId?: string;
+    /** Override the on-disk auth directory. When omitted, derived from `accountId`. */
+    authDir?: string;
+}
+export declare function createWhatsAppAdapter(opts?: CreateWhatsAppAdapterOptions): ChannelAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/agents/channels/whatsapp/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/whatsapp/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EACX,cAAc,EAId,MAAM,2BAA2B,CAAC;AAanC,mEAAmE;AACnE,MAAM,WAAW,4BAA4B;IAC5C,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAkBD,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,4BAAiC,GAAG,cAAc,CA8O7F"}