@spinabot/brigade 1.7.0 → 1.9.0

package/dist/agents/channels/bluebubbles/webhook.js

@@ -0,0 +1,249 @@
+/**
+ * BlueBubbles inbound gateway route.
+ *
+ * BlueBubbles POSTs each event to a Brigade gateway HTTP route. Because a
+ * BlueBubbles webhook CANNOT send custom headers, the server PASSWORD is embedded
+ * in the registered webhook URL's QUERY STRING (`?password=…` / `?guid=…`) and
+ * verified on each inbound POST. (Some BlueBubbles versions also send the token
+ * as a header — those are accepted too.) Verification happens FIRST, before the
+ * body is parsed / routed, so a forged event can't reach the agent.
+ *
+ * Mirrors `slack/webhook.ts` (the webhook-ingress blueprint): build an
+ * `HttpRoute`, register it via `b.httpRoute(...)` from the module, resolve the
+ * started adapter (`resolveSink`) at REQUEST time (late binding — the route is
+ * registered before the plugin starts accounts), always reply 200 so BlueBubbles
+ * doesn't retry-storm.
+ */
+import { timingSafeEqual } from "node:crypto";
+/** Cap on the webhook body (a BlueBubbles event is small; 4 MiB is generous). */
+const WEBHOOK_MAX_BODY_BYTES = 4 * 1024 * 1024;
+/** Default fixed-window rate-limit: max authenticated requests per window. */
+export const WEBHOOK_RATE_LIMIT_MAX = 240;
+/** Default fixed-window length (ms). 240 req / 10s ≈ 24 rps sustained per account. */
+export const WEBHOOK_RATE_LIMIT_WINDOW_MS = 10_000;
+/** Default bound on concurrently in-flight handler bodies (normalize/dedupe/dispatch). */
+export const WEBHOOK_MAX_IN_FLIGHT = 32;
+/** Build a fixed-window rate limiter (`max` requests per `windowMs`). */
+export function createFixedWindowRateLimiter(max, windowMs) {
+    const cap = Math.max(1, Math.floor(max));
+    const span = Math.max(1, Math.floor(windowMs));
+    let windowStart = 0;
+    let count = 0;
+    return {
+        hit(nowMs = Date.now()) {
+            if (nowMs - windowStart >= span) {
+                windowStart = nowMs;
+                count = 0;
+            }
+            count++;
+            return count <= cap;
+        },
+    };
+}
+/** Build an in-flight concurrency limiter capped at `max` simultaneous holders. */
+export function createInFlightLimiter(max) {
+    const cap = Math.max(1, Math.floor(max));
+    let active = 0;
+    return {
+        tryAcquire() {
+            if (active >= cap)
+                return null;
+            active++;
+            let released = false;
+            return () => {
+                if (released)
+                    return;
+                released = true;
+                active--;
+            };
+        },
+        inFlight: () => active,
+    };
+}
+/** Constant-time compare of two strings — avoids leaking via timing. */
+export function safeEqualToken(a, b) {
+    if (a.length !== b.length)
+        return false;
+    try {
+        return timingSafeEqual(Buffer.from(a, "utf8"), Buffer.from(b, "utf8"));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Verify a BlueBubbles webhook request's password. The supplied token comes from
+ * the URL query (`password` / `guid`) or, when present, a header. When
+ * `expectedPassword` is empty the check is SKIPPED (returns true) — the operator
+ * opted out (not recommended). Returns false when a password is configured but
+ * the supplied one is missing / wrong.
+ */
+export function verifyBlueBubblesWebhook(args) {
+    if (!args.expectedPassword)
+        return true; // no password configured → skip
+    const supplied = (args.suppliedToken ?? "").trim();
+    if (!supplied)
+        return false;
+    return safeEqualToken(supplied, args.expectedPassword);
+}
+/** Pull the auth token from the request URL query or a header. */
+function extractSuppliedToken(req) {
+    // URL query (BlueBubbles can't set custom headers, so this is the primary path).
+    const rawUrl = req.url ?? "";
+    const qIdx = rawUrl.indexOf("?");
+    if (qIdx >= 0) {
+        const params = new URLSearchParams(rawUrl.slice(qIdx + 1));
+        const fromQuery = params.get("password") ?? params.get("guid");
+        if (fromQuery)
+            return fromQuery;
+    }
+    // Header fallbacks (some BB proxy setups inject them).
+    const header = (name) => {
+        const v = req.headers[name];
+        const s = Array.isArray(v) ? v[0] : v;
+        return s ? s.replace(/^Bearer\s+/i, "").trim() : undefined;
+    };
+    return header("x-password") ?? header("x-guid") ?? header("x-bluebubbles-guid") ?? header("authorization");
+}
+/** Read a request body up to `maxBytes`, rejecting (→ null) when it overflows. */
+function readBody(req, maxBytes) {
+    return new Promise((resolve) => {
+        const chunks = [];
+        let size = 0;
+        let overflowed = false;
+        req.on("data", (chunk) => {
+            if (overflowed)
+                return;
+            size += chunk.length;
+            if (size > maxBytes) {
+                overflowed = true;
+                resolve(null);
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on("end", () => {
+            if (overflowed)
+                return;
+            resolve(Buffer.concat(chunks).toString("utf8"));
+        });
+        req.on("error", () => resolve(null));
+    });
+}
+/**
+ * Parse the request body. BlueBubbles delivers JSON; a form-encoded fallback
+ * (some proxy setups) carries the JSON under a `payload`/`data` field.
+ */
+export function parseBlueBubblesBody(rawBody, contentType) {
+    const ct = (contentType ?? "").toLowerCase();
+    const tryJson = (s) => {
+        try {
+            const v = JSON.parse(s);
+            return v && typeof v === "object" ? v : null;
+        }
+        catch {
+            return null;
+        }
+    };
+    let body = null;
+    if (ct.includes("application/x-www-form-urlencoded")) {
+        const params = new URLSearchParams(rawBody);
+        const inner = params.get("payload") ?? params.get("data") ?? params.get("message");
+        if (inner)
+            body = tryJson(inner);
+    }
+    if (!body)
+        body = tryJson(rawBody);
+    if (!body)
+        return null;
+    const type = typeof body.type === "string" ? body.type : undefined;
+    return { ...(type ? { type } : {}), payload: body };
+}
+/**
+ * Build the Brigade `HttpRoute` for the BlueBubbles webhook. Register it via
+ * `b.httpRoute(...)` from the module.
+ */
+export function buildBlueBubblesWebhookRoute(args) {
+    // Per-route limiters (one route = one account). Built once and closed over so
+    // the window/in-flight counters persist across requests.
+    const rateLimiter = createFixedWindowRateLimiter(args.rateLimitMax ?? WEBHOOK_RATE_LIMIT_MAX, args.rateLimitWindowMs ?? WEBHOOK_RATE_LIMIT_WINDOW_MS);
+    const inFlight = createInFlightLimiter(args.maxInFlight ?? WEBHOOK_MAX_IN_FLIGHT);
+    const handler = async (req, res) => {
+        const reply = (status, body) => {
+            res.statusCode = status;
+            res.setHeader("content-type", "application/json");
+            res.end(typeof body === "string" ? body : JSON.stringify(body));
+        };
+        if ((req.method ?? "").toUpperCase() !== "POST") {
+            reply(405, { ok: false, error: "method not allowed" });
+            return;
+        }
+        // Auth FIRST — verify the password before reading / parsing the body.
+        const supplied = extractSuppliedToken(req);
+        if (!verifyBlueBubblesWebhook({ expectedPassword: args.password, suppliedToken: supplied })) {
+            args.log?.("bluebubbles webhook rejected — bad password");
+            reply(401, { ok: false, error: "unauthorized" });
+            return;
+        }
+        // Rate-limit the authenticated stream — a replay-storm / hostile sender that
+        // has the password must not run the normalize/dedupe/dispatch path
+        // unbounded. Over-limit requests are dropped with 429 BEFORE the body is
+        // read, so the cost of an abusive burst is bounded.
+        if (!rateLimiter.hit(args.now?.())) {
+            args.log?.("bluebubbles webhook throttled — over rate limit");
+            reply(429, { ok: false, error: "rate limited" });
+            return;
+        }
+        // Bound concurrent in-flight handler bodies. When the cap is reached, shed
+        // load with 429 rather than letting unbounded parses/dispatches pile up.
+        const release = inFlight.tryAcquire();
+        if (!release) {
+            args.log?.("bluebubbles webhook throttled — in-flight cap reached");
+            reply(429, { ok: false, error: "busy" });
+            return;
+        }
+        try {
+            // The gateway dispatcher has ALREADY drained + buffered the body onto
+            // `req.body`. Read that first; only stream when exercised outside the gateway.
+            const pre = req.body;
+            const raw = pre ? pre.toString("utf8") : await readBody(req, WEBHOOK_MAX_BODY_BYTES);
+            if (raw === null) {
+                reply(413, { ok: false, error: "payload too large" });
+                return;
+            }
+            const contentType = (() => {
+                const c = req.headers["content-type"];
+                return Array.isArray(c) ? (c[0] ?? "") : (c ?? "");
+            })();
+            const parsed = parseBlueBubblesBody(raw, contentType);
+            if (!parsed) {
+                reply(400, { ok: false, error: "invalid body" });
+                return;
+            }
+            const sink = args.resolveSink();
+            if (sink) {
+                try {
+                    sink.feedWebhookEvent(parsed.type, parsed.payload);
+                }
+                catch (err) {
+                    args.log?.("bluebubbles webhook dispatch threw", { error: err instanceof Error ? err.message : String(err) });
+                }
+            }
+            // Always 200 so BlueBubbles doesn't retry-storm.
+            reply(200, { ok: true });
+        }
+        finally {
+            release();
+        }
+    };
+    return {
+        method: "POST",
+        path: args.path,
+        auth: "none", // BlueBubbles can't present operator-auth; the password query IS the auth.
+        match: "exact",
+        maxBodyBytes: WEBHOOK_MAX_BODY_BYTES,
+        skipSessionGuard: true,
+        handler,
+    };
+}
+//# sourceMappingURL=webhook.js.map

package/dist/agents/channels/bluebubbles/webhook.js.map

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

package/dist/agents/channels/bundled-channel-metas.d.ts

@@ -25,6 +25,19 @@ export declare const TELEGRAM_CHANNEL_META: ChannelMeta;
 export declare const SLACK_CHANNEL_META: ChannelMeta;
 /** Discord channel metadata (markdown-capable; visible everywhere by default). */
 export declare const DISCORD_CHANNEL_META: ChannelMeta;
+/**
+ * iMessage channel metadata. iMessage has NO rich markup (plain text only), so
+ * it is NOT markdown-capable — the assembler's markdown gate strips formatting
+ * for this channel. Driven by the `imsg` CLI as a JSON-RPC subprocess.
+ */
+export declare const IMESSAGE_CHANNEL_META: ChannelMeta;
+/**
+ * BlueBubbles channel metadata. Like iMessage, BlueBubbles has NO rich markup
+ * (plain text only), so it is NOT markdown-capable — the assembler's markdown
+ * gate strips formatting for this channel. Driven by the BlueBubbles macOS server
+ * over REST (outbound) + a webhook (inbound).
+ */
+export declare const BLUEBUBBLES_CHANNEL_META: ChannelMeta;
 /** Every bundled channel meta, in declaration order. The registry seeds from this. */
 export declare const BUNDLED_CHANNEL_METAS: readonly ChannelMeta[];
 //# sourceMappingURL=bundled-channel-metas.d.ts.map

package/dist/agents/channels/bundled-channel-metas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundled-channel-metas.d.ts","sourceRoot":"","sources":["../../../src/agents/channels/bundled-channel-metas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,EAAE,WAQnC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,EAAE,WAQnC,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,EAAE,WAQhC,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,EAAE,WAQlC,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,EAAE,SAAS,WAAW,EAKvD,CAAC"}
+{"version":3,"file":"bundled-channel-metas.d.ts","sourceRoot":"","sources":["../../../src/agents/channels/bundled-channel-metas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,EAAE,WAQnC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,EAAE,WAQnC,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,EAAE,WAQhC,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,EAAE,WAQlC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,WASnC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAStC,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,EAAE,SAAS,WAAW,EAOvD,CAAC"}

package/dist/agents/channels/bundled-channel-metas.js

@@ -56,11 +56,44 @@ export const DISCORD_CHANNEL_META = {
     order: 40,
     markdownCapable: true,
 };
+/**
+ * iMessage channel metadata. iMessage has NO rich markup (plain text only), so
+ * it is NOT markdown-capable — the assembler's markdown gate strips formatting
+ * for this channel. Driven by the `imsg` CLI as a JSON-RPC subprocess.
+ */
+export const IMESSAGE_CHANNEL_META = {
+    id: "imessage",
+    label: "iMessage",
+    selectionLabel: "iMessage",
+    docsPath: "channels/imessage",
+    blurb: "Drive native iMessage via the imsg CLI; DM/group chat over Messages.app.",
+    order: 50,
+    aliases: ["imsg"],
+    markdownCapable: false,
+};
+/**
+ * BlueBubbles channel metadata. Like iMessage, BlueBubbles has NO rich markup
+ * (plain text only), so it is NOT markdown-capable — the assembler's markdown
+ * gate strips formatting for this channel. Driven by the BlueBubbles macOS server
+ * over REST (outbound) + a webhook (inbound).
+ */
+export const BLUEBUBBLES_CHANNEL_META = {
+    id: "bluebubbles",
+    label: "BlueBubbles",
+    selectionLabel: "BlueBubbles (iMessage)",
+    docsPath: "channels/bluebubbles",
+    blurb: "Drive native iMessage via a BlueBubbles macOS server; REST-out + webhook-in, reactions/edit/unsend.",
+    order: 55,
+    aliases: ["bb"],
+    markdownCapable: false,
+};
 /** Every bundled channel meta, in declaration order. The registry seeds from this. */
 export const BUNDLED_CHANNEL_METAS = [
     WHATSAPP_CHANNEL_META,
     TELEGRAM_CHANNEL_META,
     SLACK_CHANNEL_META,
     DISCORD_CHANNEL_META,
+    IMESSAGE_CHANNEL_META,
+    BLUEBUBBLES_CHANNEL_META,
 ];
 //# sourceMappingURL=bundled-channel-metas.js.map

package/dist/agents/channels/bundled-channel-metas.js.map

@@ -1 +1 @@
-{"version":3,"file":"bundled-channel-metas.js","sourceRoot":"","sources":["../../../src/agents/channels/bundled-channel-metas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,mFAAmF;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAAgB;IACjD,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,UAAU;IACjB,cAAc,EAAE,UAAU;IAC1B,QAAQ,EAAE,mBAAmB;IAC7B,KAAK,EAAE,mDAAmD;IAC1D,KAAK,EAAE,EAAE;IACT,eAAe,EAAE,IAAI;CACrB,CAAC;AAEF,mFAAmF;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAAgB;IACjD,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,UAAU;IACjB,cAAc,EAAE,UAAU;IAC1B,QAAQ,EAAE,mBAAmB;IAC7B,KAAK,EAAE,8DAA8D;IACrE,KAAK,EAAE,EAAE;IACT,eAAe,EAAE,IAAI;CACrB,CAAC;AAEF,gFAAgF;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC9C,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,OAAO;IACd,cAAc,EAAE,OAAO;IACvB,QAAQ,EAAE,gBAAgB;IAC1B,KAAK,EAAE,mEAAmE;IAC1E,KAAK,EAAE,EAAE;IACT,eAAe,EAAE,IAAI;CACrB,CAAC;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAChD,EAAE,EAAE,SAAS;IACb,KAAK,EAAE,SAAS;IAChB,cAAc,EAAE,SAAS;IACzB,QAAQ,EAAE,kBAAkB;IAC5B,KAAK,EAAE,8DAA8D;IACrE,KAAK,EAAE,EAAE;IACT,eAAe,EAAE,IAAI;CACrB,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC5D,qBAAqB;IACrB,qBAAqB;IACrB,kBAAkB;IAClB,oBAAoB;CACpB,CAAC"}
+{"version":3,"file":"bundled-channel-metas.js","sourceRoot":"","sources":["../../../src/agents/channels/bundled-channel-metas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,mFAAmF;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAAgB;IACjD,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,UAAU;IACjB,cAAc,EAAE,UAAU;IAC1B,QAAQ,EAAE,mBAAmB;IAC7B,KAAK,EAAE,mDAAmD;IAC1D,KAAK,EAAE,EAAE;IACT,eAAe,EAAE,IAAI;CACrB,CAAC;AAEF,mFAAmF;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAAgB;IACjD,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,UAAU;IACjB,cAAc,EAAE,UAAU;IAC1B,QAAQ,EAAE,mBAAmB;IAC7B,KAAK,EAAE,8DAA8D;IACrE,KAAK,EAAE,EAAE;IACT,eAAe,EAAE,IAAI;CACrB,CAAC;AAEF,gFAAgF;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC9C,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,OAAO;IACd,cAAc,EAAE,OAAO;IACvB,QAAQ,EAAE,gBAAgB;IAC1B,KAAK,EAAE,mEAAmE;IAC1E,KAAK,EAAE,EAAE;IACT,eAAe,EAAE,IAAI;CACrB,CAAC;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAChD,EAAE,EAAE,SAAS;IACb,KAAK,EAAE,SAAS;IAChB,cAAc,EAAE,SAAS;IACzB,QAAQ,EAAE,kBAAkB;IAC5B,KAAK,EAAE,8DAA8D;IACrE,KAAK,EAAE,EAAE;IACT,eAAe,EAAE,IAAI;CACrB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgB;IACjD,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,UAAU;IACjB,cAAc,EAAE,UAAU;IAC1B,QAAQ,EAAE,mBAAmB;IAC7B,KAAK,EAAE,0EAA0E;IACjF,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,eAAe,EAAE,KAAK;CACtB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAgB;IACpD,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,aAAa;IACpB,cAAc,EAAE,wBAAwB;IACxC,QAAQ,EAAE,sBAAsB;IAChC,KAAK,EAAE,qGAAqG;IAC5G,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,eAAe,EAAE,KAAK;CACtB,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC5D,qBAAqB;IACrB,qBAAqB;IACrB,kBAAkB;IAClB,oBAAoB;IACpB,qBAAqB;IACrB,wBAAwB;CACxB,CAAC"}

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

@@ -0,0 +1,178 @@
+/**
+ * iMessage config-shape helpers (multi-ACCOUNT aware; mirrors Discord's
+ * `account-config.ts`).
+ *
+ * iMessage is driven through the third-party `imsg` CLI run as a long-lived
+ * JSON-RPC subprocess (`imsg rpc`). Unlike a token-based channel there is NO
+ * secret to seal — the auth surface is "the machine running the gateway is
+ * already signed into Messages.app". So instead of a bot token this module
+ * resolves the local-runtime knobs the transport needs:
+ *
+ *   - `cliPath`       path to the `imsg` binary (default `"imsg"`, found on PATH).
+ *   - `dbPath`        optional override for the chat.db the binary reads.
+ *   - `service`       default send service: `"imessage"` | `"sms"` | `"auto"`.
+ *   - `region`        default phone-number region for E.164 normalisation (US).
+ *   - `mediaMaxMb`    cap on an outbound attachment's size (MB).
+ *   - `probeTimeoutMs` RPC round-trip timeout for the doctor/probe call.
+ *   - `attachmentRoots` allow-list of dirs inbound media may be read from.
+ *
+ * Two config shapes are recognised so the surface lines up with the other
+ * channels:
+ *
+ *   Legacy (single-account):
+ *     channels.imessage = { enabled: true, cliPath: "imsg", service: "auto" }
+ *
+ *   Multi-account:
+ *     channels.imessage = {
+ *       enabled: true,
+ *       accounts: [
+ *         { id: "personal", dbPath: "~/Library/Messages/chat.db" },
+ *         { id: "work",     cliPath: "/opt/imsg/bin/imsg" },
+ *       ],
+ *     }
+ *
+ * A legacy config with no `accounts[]` reads as `[{ id: "default" }]`.
+ */
+import type { BrigadeConfig } from "../../../config/io.js";
+/** Canonical channel id + default account id. */
+declare const CHANNEL_ID = "imessage";
+declare const DEFAULT_ACCOUNT_ID = "default";
+/** Default `imsg` binary name — resolved on PATH when no explicit path is set. */
+declare const DEFAULT_CLI_PATH = "imsg";
+/** Default RPC probe / request timeout (ms). */
+export declare const DEFAULT_IMESSAGE_PROBE_TIMEOUT_MS = 10000;
+/** Default per-message outbound text chunk size (chars). iMessage's practical limit. */
+export declare const DEFAULT_IMESSAGE_TEXT_CHUNK_LIMIT = 4000;
+/**
+ * Default rolling-history depth for an untagged GROUP message (0 = off). iMessage
+ * delivers one notification per message with no thread context, so the monitor
+ * keeps the last N seen group messages and prepends them as context.
+ */
+export declare const DEFAULT_IMESSAGE_HISTORY_LIMIT = 0;
+/** Default macOS Messages attachment root inbound media may be read from. */
+export declare const DEFAULT_IMESSAGE_ATTACHMENT_ROOTS: readonly string[];
+/** Per-knob env var consulted as a last-resort fallback for the binary path. */
+declare const CLI_PATH_ENV_VAR = "IMSG_CLI_PATH";
+/** Outbound send service. `auto` lets the bridge pick iMessage vs SMS. */
+export type IMessageService = "imessage" | "sms" | "auto";
+/** Outbound chunk strategy. `length` = pack to the char limit (default); `newline` = prefer line breaks. */
+export type IMessageChunkMode = "length" | "newline";
+/** Resolved per-account info — what the adapter runtime reads. */
+export interface ResolvedIMessageAccount {
+    accountId: string;
+    enabled: boolean;
+    /** `imsg` binary path (default `"imsg"`). */
+    cliPath: string;
+    /** Optional chat.db override (`~`-expansion done by the client). */
+    dbPath: string;
+    /** Default send service for this account. */
+    service: IMessageService;
+    /** Default phone-number region (E.164 normalisation). */
+    region: string;
+    /** Outbound media size cap (bytes). */
+    mediaMaxBytes: number;
+    /** RPC probe / request timeout (ms). */
+    probeTimeoutMs: number;
+    /**
+     * The bot's OWN iMessage handle (normalised — digits for a phone, lower-case
+     * for an email). When set, a group message whose text names this handle gets a
+     * populated `mentions[]` so the central pipeline's group requireMention gate
+     * can fire. Empty when unset (group mention-gating then can't match the bot).
+     */
+    selfHandle: string;
+    /**
+     * Remote host (`user@host` / `host`) when the `imsg` bridge runs on a DIFFERENT
+     * machine than the gateway. When set, inbound attachments are SCP-copied from
+     * the remote root to a local temp before resolution. Empty for a same-host setup.
+     */
+    remoteHost: string;
+    /** When false, skip inbound media resolution entirely (text-only ingest). Default true. */
+    includeAttachments: boolean;
+    /** Default outbound recipient when a send omits an explicit target. Empty when unset. */
+    defaultTo: string;
+    /** Rolling-history depth for an untagged GROUP message (0 = off). */
+    historyLimit: number;
+    /** Rolling-history depth for an untagged DM (0 = off). */
+    dmHistoryLimit: number;
+    /** Per-message outbound text chunk size (chars). */
+    textChunkLimit: number;
+    /** Outbound chunk strategy. */
+    chunkMode: IMessageChunkMode;
+    verbose: boolean;
+}
+/** Coerce a loose `service` string to the typed union (defaults to `auto`). */
+export declare function coerceIMessageService(raw: unknown, fallback?: IMessageService): IMessageService;
+/** Is the iMessage channel switched on at all (any shape)? */
+export declare function imessageChannelEnabled(cfg: BrigadeConfig): boolean;
+/** List configured account ids. Legacy single-account configs surface `["default"]`. */
+export declare function listIMessageAccountIds(cfg: BrigadeConfig): string[];
+/**
+ * Resolve the `imsg` binary path for an account. Precedence: per-account config
+ * `${VAR}`/literal → top-level config → `IMSG_CLI_PATH` env → the default
+ * `"imsg"` (found on PATH).
+ */
+export declare function resolveIMessageCliPath(cfg: BrigadeConfig, accountId?: string | null, env?: NodeJS.ProcessEnv): string;
+/**
+ * Resolve the optional chat.db override for an account. Per-account → top-level
+ * → "" (the binary uses its own default location). `~`-expansion is the client's
+ * job — this returns the raw path.
+ */
+export declare function resolveIMessageDbPath(cfg: BrigadeConfig, accountId?: string | null, env?: NodeJS.ProcessEnv): string;
+/**
+ * Resolve the inbound attachment roots iMessage media may be read from
+ * (account-specific → channel-global → the macOS Messages Attachments floor).
+ */
+export declare function resolveIMessageAttachmentRoots(cfg: BrigadeConfig, accountId?: string | null): string[];
+/**
+ * Resolve the REMOTE inbound attachment roots (when the `imsg` bridge runs on a
+ * different host than the gateway). Falls back through the local roots so a
+ * same-host setup is unchanged.
+ */
+export declare function resolveIMessageRemoteAttachmentRoots(cfg: BrigadeConfig, accountId?: string | null): string[];
+/** Resolve the RPC probe / request timeout (ms) for an account. */
+export declare function resolveIMessageProbeTimeoutMs(cfg: BrigadeConfig, accountId?: string | null): number;
+/**
+ * Normalise a handle for self/mention matching: an email lower-cases; a phone
+ * keeps only its digits (so `+1 (555) 123-4567` and `15551234567` compare equal).
+ * Returns "" for an empty input. Mirrors BlueBubbles' `normalizeBlueBubblesSelfHandle`.
+ */
+export declare function normalizeIMessageSelfHandle(raw: string | undefined): string;
+/**
+ * Resolve the bot's own handle for an account (per-account `selfHandle` wins over
+ * the top-level slot), normalised. Empty when unset.
+ */
+export declare function resolveIMessageSelfHandle(cfg: BrigadeConfig, accountId?: string | null, env?: NodeJS.ProcessEnv): string;
+/**
+ * Resolve the REMOTE host (`user@host` / `host`) for an account when the `imsg`
+ * bridge runs on a different machine. Per-account → top-level → "". Returns the
+ * raw configured value; the SCP layer safety-validates it.
+ */
+export declare function resolveIMessageRemoteHost(cfg: BrigadeConfig, accountId?: string | null, env?: NodeJS.ProcessEnv): string;
+/**
+ * Resolve whether inbound media should be resolved at all. Per-account →
+ * top-level → DEFAULT TRUE (resolve media). Setting `includeAttachments:false`
+ * opts a noisy / privacy-sensitive account out of inbound media resolution.
+ */
+export declare function resolveIMessageIncludeAttachments(cfg: BrigadeConfig, accountId?: string | null): boolean;
+/** Resolve the default outbound recipient (per-account → top-level → ""). */
+export declare function resolveIMessageDefaultTo(cfg: BrigadeConfig, accountId?: string | null, env?: NodeJS.ProcessEnv): string;
+/** Resolve the rolling-history depth for an untagged GROUP message (0 = off). */
+export declare function resolveIMessageHistoryLimit(cfg: BrigadeConfig, accountId?: string | null): number;
+/** Resolve the rolling-history depth for an untagged DM (0 = off). */
+export declare function resolveIMessageDmHistoryLimit(cfg: BrigadeConfig, accountId?: string | null): number;
+/** Resolve the per-message outbound text chunk size (chars). */
+export declare function resolveIMessageTextChunkLimit(cfg: BrigadeConfig, accountId?: string | null): number;
+/** Coerce a loose `chunkMode` string to the typed union (defaults to `length`). */
+export declare function coerceIMessageChunkMode(raw: unknown): IMessageChunkMode;
+/** Resolve the outbound chunk strategy (per-account → top-level → `length`). */
+export declare function resolveIMessageChunkMode(cfg: BrigadeConfig, accountId?: string | null): IMessageChunkMode;
+/** Resolve a per-account view of the config (defaults filled in). */
+export declare function resolveIMessageAccount(cfg: BrigadeConfig, accountId?: string | null, env?: NodeJS.ProcessEnv): ResolvedIMessageAccount;
+/**
+ * Resolve the idle-thread-session TTL in ms, or `null` when unset / disabled.
+ * Accepts a number (ms) or a duration string (`"6h"`, `"30m"`, …). The cron
+ * session-reaper uses this to age out idle iMessage group sessions.
+ */
+export declare function imessageThreadIdleTtlMs(cfg: BrigadeConfig): number | null;
+export { CHANNEL_ID as IMESSAGE_CHANNEL_ID, DEFAULT_ACCOUNT_ID as IMESSAGE_DEFAULT_ACCOUNT_ID, CLI_PATH_ENV_VAR as IMESSAGE_CLI_PATH_ENV_VAR, DEFAULT_CLI_PATH as IMESSAGE_DEFAULT_CLI_PATH, };
+//# sourceMappingURL=account-config.d.ts.map

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

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