@spinabot/brigade 1.6.1 → 1.8.0

package/dist/agents/channels/imessage/send.d.ts

@@ -0,0 +1,61 @@
+/**
+ * iMessage outbound send — assemble + dispatch a `send` RPC.
+ *
+ * `sendMessageIMessage` parses the target (handle / chat_id / chat_guid /
+ * chat_identifier), converts markdown tables to plain text, resolves an optional
+ * media attachment to a local path (through the exfil guard), sanitizes a
+ * reply-to id, and writes the `send` JSON-RPC call. When the message has media
+ * but no text it delivers a `<media:kind>` placeholder so the echo cache + the
+ * transcript have a body.
+ *
+ * The RPC client is INJECTABLE (`opts.client`) — that is the test seam: a unit
+ * test passes a fake {@link IMessageRpcLike} and exercises every target kind +
+ * media + reply with NO real `imsg` binary. A client WE created here is stopped
+ * in the `finally`; an injected one is left for the caller to own.
+ */
+import { type IMessageRpcLike } from "./client.js";
+import { type IMessageMediaKind } from "./format.js";
+import type { IMessageService } from "./account-config.js";
+/** Options for {@link sendMessageIMessage}. */
+export interface IMessageSendOpts {
+    /** `imsg` binary path (only used when constructing a client ourselves). */
+    cliPath?: string;
+    /** Optional chat.db override. */
+    dbPath?: string;
+    /** Default send service when the target doesn't pin one (`auto`). */
+    service?: IMessageService;
+    /** Phone-number region for E.164 normalisation (default `US`). */
+    region?: string;
+    /** Native reply-to message id (sanitized before send). */
+    replyToId?: string;
+    /** Local media path to attach (validated through the exfil guard). */
+    mediaPath?: string;
+    /** Pre-inferred media kind for the `<media:kind>` placeholder (else inferred). */
+    mediaKind?: IMessageMediaKind;
+    /** Outbound media size cap (bytes). */
+    maxBytes?: number;
+    /** RPC timeout (ms). */
+    timeoutMs?: number;
+    /** Force a numeric chat-id target (wins over `to`). */
+    chatId?: number;
+    /** Inject a live RPC client (the test seam). When set, it is NOT stopped here. */
+    client?: IMessageRpcLike;
+    /** Inject a client factory (production default constructs the real one). */
+    createClient?: (args: {
+        cliPath?: string;
+        dbPath?: string;
+    }) => Promise<IMessageRpcLike>;
+}
+/** Result of a successful send. */
+export interface IMessageSendResult {
+    /** Resolved message id from the bridge, or a coarse fallback (`ok` / `unknown`). */
+    messageId: string;
+    /** The text actually delivered (post markdown-table conversion + placeholder). */
+    sentText: string;
+}
+/**
+ * Send an iMessage. `to` is the target string; `opts.chatId` (when set) wins and
+ * forces a `chat_id:` target. Resolves the message id (or a coarse fallback).
+ */
+export declare function sendMessageIMessage(to: string, text: string, opts?: IMessageSendOpts): Promise<IMessageSendResult>;
+//# sourceMappingURL=send.d.ts.map

package/dist/agents/channels/imessage/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/imessage/send.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEN,KAAK,eAAe,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAKN,KAAK,iBAAiB,EACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAChC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CACzF;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IAClC,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;CACjB;AAcD;;;GAGG;AACH,wBAAsB,mBAAmB,CACxC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,gBAAqB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAsE7B"}

package/dist/agents/channels/imessage/send.js

@@ -0,0 +1,108 @@
+/**
+ * iMessage outbound send — assemble + dispatch a `send` RPC.
+ *
+ * `sendMessageIMessage` parses the target (handle / chat_id / chat_guid /
+ * chat_identifier), converts markdown tables to plain text, resolves an optional
+ * media attachment to a local path (through the exfil guard), sanitizes a
+ * reply-to id, and writes the `send` JSON-RPC call. When the message has media
+ * but no text it delivers a `<media:kind>` placeholder so the echo cache + the
+ * transcript have a body.
+ *
+ * The RPC client is INJECTABLE (`opts.client`) — that is the test seam: a unit
+ * test passes a fake {@link IMessageRpcLike} and exercises every target kind +
+ * media + reply with NO real `imsg` binary. A client WE created here is stopped
+ * in the `finally`; an injected one is left for the caller to own.
+ */
+import { createIMessageRpcClient, } from "./client.js";
+import { markdownToIMessageText, resolveDeliveredText, sanitizeOutboundIMessageText, sanitizeReplyToId, } from "./format.js";
+import { resolveOutboundAttachment } from "./media.js";
+import { formatIMessageChatTarget, parseIMessageTarget } from "./targets.js";
+/** Extract a message id from the bridge's `send` result, trying common keys. */
+function resolveMessageId(result) {
+    if (!result || typeof result !== "object")
+        return null;
+    const r = result;
+    for (const key of ["messageId", "message_id", "id", "guid"]) {
+        const v = r[key];
+        if (typeof v === "string" && v.trim())
+            return v.trim();
+        if (typeof v === "number" && Number.isFinite(v))
+            return String(v);
+    }
+    return null;
+}
+/**
+ * Send an iMessage. `to` is the target string; `opts.chatId` (when set) wins and
+ * forces a `chat_id:` target. Resolves the message id (or a coarse fallback).
+ */
+export async function sendMessageIMessage(to, text, opts = {}) {
+    const cliPath = opts.cliPath?.trim() || "imsg";
+    const dbPath = opts.dbPath?.trim() || undefined;
+    // Target — an explicit chatId wins, else parse the `to` string.
+    const target = parseIMessageTarget(opts.chatId ? formatIMessageChatTarget(opts.chatId) : to);
+    // Service — explicit opt → the handle's parsed service → the account default.
+    const service = opts.service ?? (target.kind === "handle" ? target.service : undefined) ?? "auto";
+    const region = opts.region?.trim() || "US";
+    const maxBytes = typeof opts.maxBytes === "number" ? opts.maxBytes : 16 * 1024 * 1024;
+    let message = text ?? "";
+    let filePath;
+    let mediaKind = opts.mediaKind;
+    // Media resolution — validate the local path, infer the kind.
+    if (opts.mediaPath?.trim()) {
+        const resolved = resolveOutboundAttachment(opts.mediaPath.trim(), maxBytes);
+        filePath = resolved.path;
+        mediaKind = mediaKind ?? resolved.kind;
+        message = resolveDeliveredText(message, mediaKind);
+    }
+    if (!message.trim() && !filePath)
+        throw new Error("iMessage send requires text or media");
+    // Plain-text-ify markdown tables when there is text.
+    if (message.trim())
+        message = markdownToIMessageText(message);
+    // Last gate before the wire — strip any internal directive tags / role
+    // scaffolding / reasoning residue (the outbound twin of the reflection guard).
+    if (message.trim())
+        message = sanitizeOutboundIMessageText(message);
+    if (!message.trim() && !filePath)
+        throw new Error("iMessage send requires text or media");
+    const replyTo = sanitizeReplyToId(opts.replyToId);
+    // Assemble the wire params.
+    const params = {
+        text: message,
+        service: service || "auto",
+        region,
+    };
+    if (replyTo)
+        params.reply_to = replyTo;
+    if (filePath)
+        params.file = filePath;
+    if (target.kind === "chat_id")
+        params.chat_id = target.chatId;
+    else if (target.kind === "chat_guid")
+        params.chat_guid = target.chatGuid;
+    else if (target.kind === "chat_identifier")
+        params.chat_identifier = target.chatIdentifier;
+    else
+        params.to = target.to;
+    // Client lifecycle — an injected client is owned by the caller.
+    const client = opts.client ??
+        (opts.createClient
+            ? await opts.createClient({ cliPath, dbPath })
+            : await createIMessageRpcClient({ cliPath, dbPath }));
+    const shouldClose = !opts.client;
+    try {
+        const result = await client.request("send", params, {
+            ...(opts.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),
+        });
+        const resolvedId = resolveMessageId(result);
+        return {
+            messageId: resolvedId ?? (result && result.ok ? "ok" : "unknown"),
+            sentText: message,
+        };
+    }
+    finally {
+        if (shouldClose)
+            await client.stop();
+    }
+}
+//# sourceMappingURL=send.js.map

package/dist/agents/channels/imessage/send.js.map

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

package/dist/agents/channels/imessage/targets.d.ts

@@ -0,0 +1,91 @@
+/**
+ * iMessage target parsing + handle normalisation.
+ *
+ * An iMessage send can address four kinds of target, distinguished by a leading
+ * prefix (case-insensitive):
+ *
+ *   - `handle`          a phone number (`+15551234567`) or email
+ *                       (`user@example.com`), optionally service-prefixed
+ *                       (`imessage:`, `sms:`, `auto:`).
+ *   - `chat_id`         a numeric SQLite thread id      (`chat_id:42`, `chat:42`).
+ *   - `chat_guid`       a stable thread GUID            (`chat_guid:ABC-…`).
+ *   - `chat_identifier` a thread identifier             (`chat_identifier:…`).
+ *
+ * `parseIMessageTarget` (the SEND path) is STRICT — it throws on a malformed
+ * `chat_id`. `parseIMessageAllowTarget` (the ALLOW-LIST path) is LENIENT — it
+ * skips a malformed prefix rather than throwing. `normalizeIMessageHandle`
+ * canonicalises a handle (lowercase email, E.164 phone, chat prefixes preserved)
+ * so inbound senders and allow-list entries compare consistently.
+ *
+ * Condensed from the upstream `targets.ts` + `target-parsing-helpers.ts` +
+ * `normalize.ts` trio into one self-contained module (the brand-neutral
+ * chat-target-prefix engine lived in a shared SDK file there).
+ */
+import type { IMessageService } from "./account-config.js";
+/** A parsed outbound target. */
+export type IMessageTarget = {
+    kind: "chat_id";
+    chatId: number;
+} | {
+    kind: "chat_guid";
+    chatGuid: string;
+} | {
+    kind: "chat_identifier";
+    chatIdentifier: string;
+} | {
+    kind: "handle";
+    to: string;
+    service: IMessageService;
+};
+/** A parsed allow-list target (lenient — a bare handle string is the fallback). */
+export type IMessageAllowTarget = {
+    kind: "chat_id";
+    chatId: number;
+} | {
+    kind: "chat_guid";
+    chatGuid: string;
+} | {
+    kind: "chat_identifier";
+    chatIdentifier: string;
+} | {
+    kind: "handle";
+    handle: string;
+};
+/**
+ * Normalise a phone-ish string to E.164. Strips a leading `scheme:`, removes
+ * everything but digits and `+`, and prepends `+` when missing.
+ */
+export declare function normalizeE164(raw: string): string;
+/**
+ * Canonicalise an iMessage handle for comparison. Service prefixes are stripped
+ * (and re-applied by callers that care); chat prefixes are lowercased on the
+ * prefix only; an email lowercases whole; a phone becomes E.164; anything else
+ * has its whitespace stripped.
+ */
+export declare function normalizeIMessageHandle(raw: string): string;
+/**
+ * Parse an outbound target (SEND path). Throws when the target is empty or a
+ * chat prefix is malformed. A service-prefixed handle keeps its service; a bare
+ * handle defaults to `auto`.
+ */
+export declare function parseIMessageTarget(raw: string): IMessageTarget;
+/** Parse an allow-list target (LENIENT). A bare/unparseable string is a normalized handle. */
+export declare function parseIMessageAllowTarget(raw: string): IMessageAllowTarget;
+/** Format a numeric chat id into the canonical `chat_id:N` target form. */
+export declare function formatIMessageChatTarget(chatId?: number): string;
+/** True iff a string carries an explicit chat / service prefix (vs a bare name). */
+export declare function looksLikeIMessageTargetId(raw: string): boolean;
+/** Advisory chat-type guess from a (parsed) target — never throws. */
+export declare function inferIMessageTargetChatType(raw: string): "dm" | "group" | undefined;
+/**
+ * Decide whether a (normalized) inbound sender is allowed given a list of
+ * allow-from entries. `*` is a wildcard. Returns false on an empty list.
+ */
+export declare function isAllowedIMessageSender(params: {
+    allowFrom: ReadonlyArray<string | number>;
+    sender: string;
+    chatId?: number;
+    chatGuid?: string;
+    chatIdentifier?: string;
+}): boolean;
+//# sourceMappingURL=targets.d.ts.map

package/dist/agents/channels/imessage/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/imessage/targets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,gCAAgC;AAChC,MAAM,MAAM,cAAc,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAAC;AAE5D,mFAAmF;AACnF,MAAM,MAAM,mBAAmB,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAmBtC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmB3D;AAqDD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAiB/D;AAED,8FAA8F;AAC9F,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAgBzE;AAED,2EAA2E;AAC3E,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO9D;AAED,sEAAsE;AACtE,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,SAAS,CAOnF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC/C,SAAS,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAuBV"}

package/dist/agents/channels/imessage/targets.js

@@ -0,0 +1,245 @@
+/**
+ * iMessage target parsing + handle normalisation.
+ *
+ * An iMessage send can address four kinds of target, distinguished by a leading
+ * prefix (case-insensitive):
+ *
+ *   - `handle`          a phone number (`+15551234567`) or email
+ *                       (`user@example.com`), optionally service-prefixed
+ *                       (`imessage:`, `sms:`, `auto:`).
+ *   - `chat_id`         a numeric SQLite thread id      (`chat_id:42`, `chat:42`).
+ *   - `chat_guid`       a stable thread GUID            (`chat_guid:ABC-…`).
+ *   - `chat_identifier` a thread identifier             (`chat_identifier:…`).
+ *
+ * `parseIMessageTarget` (the SEND path) is STRICT — it throws on a malformed
+ * `chat_id`. `parseIMessageAllowTarget` (the ALLOW-LIST path) is LENIENT — it
+ * skips a malformed prefix rather than throwing. `normalizeIMessageHandle`
+ * canonicalises a handle (lowercase email, E.164 phone, chat prefixes preserved)
+ * so inbound senders and allow-list entries compare consistently.
+ *
+ * Condensed from the upstream `targets.ts` + `target-parsing-helpers.ts` +
+ * `normalize.ts` trio into one self-contained module (the brand-neutral
+ * chat-target-prefix engine lived in a shared SDK file there).
+ */
+const CHAT_ID_PREFIXES = ["chat_id:", "chatid:", "chat:"];
+const CHAT_GUID_PREFIXES = ["chat_guid:", "chatguid:", "guid:"];
+const CHAT_IDENTIFIER_PREFIXES = ["chat_identifier:", "chatidentifier:", "chatident:"];
+const SERVICE_PREFIXES = [
+    { prefix: "imessage:", service: "imessage" },
+    { prefix: "sms:", service: "sms" },
+    { prefix: "auto:", service: "auto" },
+];
+const CHAT_TARGET_PREFIX_RE = /^(chat_id:|chatid:|chat:|chat_guid:|chatguid:|guid:|chat_identifier:|chatidentifier:|chatident:)/i;
+const SERVICE_PREFIX_RE = /^(imessage:|sms:|auto:)/i;
+function stripPrefix(value, prefix) {
+    return value.slice(prefix.length).trim();
+}
+/**
+ * Normalise a phone-ish string to E.164. Strips a leading `scheme:`, removes
+ * everything but digits and `+`, and prepends `+` when missing.
+ */
+export function normalizeE164(raw) {
+    let v = raw.trim().replace(/^[a-z][a-z0-9-]*:/i, "");
+    v = v.replace(/[^0-9+]/g, "");
+    if (!v)
+        return "";
+    if (v.startsWith("+"))
+        return `+${v.slice(1).replace(/\+/g, "")}`;
+    return `+${v.replace(/\+/g, "")}`;
+}
+/**
+ * Canonicalise an iMessage handle for comparison. Service prefixes are stripped
+ * (and re-applied by callers that care); chat prefixes are lowercased on the
+ * prefix only; an email lowercases whole; a phone becomes E.164; anything else
+ * has its whitespace stripped.
+ */
+export function normalizeIMessageHandle(raw) {
+    const trimmed = (raw ?? "").trim();
+    if (!trimmed)
+        return "";
+    const lower = trimmed.toLowerCase();
+    // Strip a service prefix and recurse on the remainder.
+    for (const { prefix } of SERVICE_PREFIXES) {
+        if (lower.startsWith(prefix))
+            return normalizeIMessageHandle(trimmed.slice(prefix.length));
+    }
+    // Chat prefixes — lowercase the prefix, keep the value's case.
+    for (const prefix of [...CHAT_ID_PREFIXES, ...CHAT_GUID_PREFIXES, ...CHAT_IDENTIFIER_PREFIXES]) {
+        if (lower.startsWith(prefix)) {
+            const value = trimmed.slice(prefix.length).trim();
+            return `${prefix}${value}`;
+        }
+    }
+    if (trimmed.includes("@"))
+        return lower; // email handle
+    const e164 = normalizeE164(trimmed);
+    if (e164)
+        return e164;
+    return trimmed.replace(/\s+/g, "");
+}
+/** Strict chat-prefix parse — throws on a malformed `chat_id`. Returns null when no chat prefix matched. */
+function parseChatTargetStrict(trimmed, lower) {
+    for (const prefix of CHAT_ID_PREFIXES) {
+        if (lower.startsWith(prefix)) {
+            const value = stripPrefix(trimmed, prefix);
+            const chatId = Number.parseInt(value, 10);
+            if (!Number.isFinite(chatId))
+                throw new Error(`Invalid chat_id: ${value}`);
+            return { kind: "chat_id", chatId };
+        }
+    }
+    for (const prefix of CHAT_GUID_PREFIXES) {
+        if (lower.startsWith(prefix)) {
+            const value = stripPrefix(trimmed, prefix);
+            if (!value)
+                throw new Error("chat_guid is required");
+            return { kind: "chat_guid", chatGuid: value };
+        }
+    }
+    for (const prefix of CHAT_IDENTIFIER_PREFIXES) {
+        if (lower.startsWith(prefix)) {
+            const value = stripPrefix(trimmed, prefix);
+            if (!value)
+                throw new Error("chat_identifier is required");
+            return { kind: "chat_identifier", chatIdentifier: value };
+        }
+    }
+    return null;
+}
+/** Lenient chat-prefix parse — skips a malformed prefix (returns null). */
+function parseChatTargetLenient(trimmed, lower) {
+    for (const prefix of CHAT_ID_PREFIXES) {
+        if (lower.startsWith(prefix)) {
+            const chatId = Number.parseInt(stripPrefix(trimmed, prefix), 10);
+            if (!Number.isFinite(chatId))
+                return null;
+            return { kind: "chat_id", chatId };
+        }
+    }
+    for (const prefix of CHAT_GUID_PREFIXES) {
+        if (lower.startsWith(prefix)) {
+            const value = stripPrefix(trimmed, prefix);
+            return value ? { kind: "chat_guid", chatGuid: value } : null;
+        }
+    }
+    for (const prefix of CHAT_IDENTIFIER_PREFIXES) {
+        if (lower.startsWith(prefix)) {
+            const value = stripPrefix(trimmed, prefix);
+            return value ? { kind: "chat_identifier", chatIdentifier: value } : null;
+        }
+    }
+    return null;
+}
+/**
+ * Parse an outbound target (SEND path). Throws when the target is empty or a
+ * chat prefix is malformed. A service-prefixed handle keeps its service; a bare
+ * handle defaults to `auto`.
+ */
+export function parseIMessageTarget(raw) {
+    const trimmed = (raw ?? "").trim();
+    if (!trimmed)
+        throw new Error("iMessage target is required");
+    const lower = trimmed.toLowerCase();
+    // Service-prefixed: strip it, then either parse a chat target or a bare handle.
+    for (const { prefix, service } of SERVICE_PREFIXES) {
+        if (lower.startsWith(prefix)) {
+            const remainder = stripPrefix(trimmed, prefix);
+            if (!remainder)
+                throw new Error(`${prefix} target is required`);
+            const chat = parseChatTargetStrict(remainder, remainder.toLowerCase());
+            if (chat)
+                return chat;
+            return { kind: "handle", to: remainder, service };
+        }
+    }
+    const chat = parseChatTargetStrict(trimmed, lower);
+    if (chat)
+        return chat;
+    return { kind: "handle", to: trimmed, service: "auto" };
+}
+/** Parse an allow-list target (LENIENT). A bare/unparseable string is a normalized handle. */
+export function parseIMessageAllowTarget(raw) {
+    const trimmed = (raw ?? "").trim();
+    if (!trimmed)
+        return { kind: "handle", handle: "" };
+    const lower = trimmed.toLowerCase();
+    for (const { prefix } of SERVICE_PREFIXES) {
+        if (lower.startsWith(prefix)) {
+            const remainder = stripPrefix(trimmed, prefix);
+            if (!remainder)
+                return { kind: "handle", handle: "" };
+            const chat = parseChatTargetLenient(remainder, remainder.toLowerCase());
+            if (chat)
+                return chat;
+            return { kind: "handle", handle: normalizeIMessageHandle(remainder) };
+        }
+    }
+    const chat = parseChatTargetLenient(trimmed, lower);
+    if (chat)
+        return chat;
+    return { kind: "handle", handle: normalizeIMessageHandle(trimmed) };
+}
+/** Format a numeric chat id into the canonical `chat_id:N` target form. */
+export function formatIMessageChatTarget(chatId) {
+    if (chatId === undefined || chatId === null || !Number.isFinite(chatId))
+        return "";
+    return `chat_id:${chatId}`;
+}
+/** True iff a string carries an explicit chat / service prefix (vs a bare name). */
+export function looksLikeIMessageTargetId(raw) {
+    const trimmed = (raw ?? "").trim();
+    if (!trimmed)
+        return false;
+    if (CHAT_TARGET_PREFIX_RE.test(trimmed))
+        return true;
+    if (SERVICE_PREFIX_RE.test(trimmed))
+        return true;
+    if (trimmed.includes("@"))
+        return true;
+    return /^\+?\d{3,}$/.test(trimmed);
+}
+/** Advisory chat-type guess from a (parsed) target — never throws. */
+export function inferIMessageTargetChatType(raw) {
+    try {
+        const t = parseIMessageTarget(raw);
+        return t.kind === "handle" ? "dm" : "group";
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Decide whether a (normalized) inbound sender is allowed given a list of
+ * allow-from entries. `*` is a wildcard. Returns false on an empty list.
+ */
+export function isAllowedIMessageSender(params) {
+    const entries = params.allowFrom.map((e) => String(e).trim()).filter(Boolean);
+    if (entries.length === 0)
+        return false;
+    if (entries.includes("*"))
+        return true;
+    const senderNorm = normalizeIMessageHandle(params.sender);
+    for (const entry of entries) {
+        const target = parseIMessageAllowTarget(entry);
+        switch (target.kind) {
+            case "chat_id":
+                if (params.chatId !== undefined && target.chatId === params.chatId)
+                    return true;
+                break;
+            case "chat_guid":
+                if (params.chatGuid && target.chatGuid === params.chatGuid)
+                    return true;
+                break;
+            case "chat_identifier":
+                if (params.chatIdentifier && target.chatIdentifier === params.chatIdentifier)
+                    return true;
+                break;
+            case "handle":
+                if (target.handle && target.handle === senderNorm)
+                    return true;
+                break;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=targets.js.map

package/dist/agents/channels/imessage/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../../../src/agents/channels/imessage/targets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAkBH,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AACnE,MAAM,kBAAkB,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,OAAO,CAAU,CAAC;AACzE,MAAM,wBAAwB,GAAG,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,YAAY,CAAU,CAAC;AAChG,MAAM,gBAAgB,GAAgE;IACrF,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE;IAC5C,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;IAClC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE;CACpC,CAAC;AAEF,MAAM,qBAAqB,GAC1B,mGAAmG,CAAC;AACrG,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAErD,SAAS,WAAW,CAAC,KAAa,EAAE,MAAc;IACjD,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACxC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;IAClE,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAW;IAClD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,uDAAuD;IACvD,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,uBAAuB,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,CAAC;IACD,+DAA+D;IAC/D,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,gBAAgB,EAAE,GAAG,kBAAkB,EAAE,GAAG,wBAAwB,CAAC,EAAE,CAAC;QAChG,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,OAAO,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC;QAC5B,CAAC;IACF,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,eAAe;IACxD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,4GAA4G;AAC5G,SAAS,qBAAqB,CAAC,OAAe,EAAE,KAAa;IAC5D,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAC;YAC3E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACpC,CAAC;IACF,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,kBAAkB,EAAE,CAAC;QACzC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACrD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC/C,CAAC;IACF,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,wBAAwB,EAAE,CAAC;QAC/C,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC3D,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;QAC3D,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,2EAA2E;AAC3E,SAAS,sBAAsB,CAAC,OAAe,EAAE,KAAa;IAC7D,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YACjE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC1C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACpC,CAAC;IACF,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,kBAAkB,EAAE,CAAC;QACzC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9D,CAAC;IACF,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,wBAAwB,EAAE,CAAC;QAC/C,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1E,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC9C,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,gFAAgF;IAChF,KAAK,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,gBAAgB,EAAE,CAAC;QACpD,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC/C,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,qBAAqB,CAAC,CAAC;YAChE,MAAM,IAAI,GAAG,qBAAqB,CAAC,SAAS,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;YACvE,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC;YACtB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;QACnD,CAAC;IACF,CAAC;IACD,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACnD,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACzD,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,wBAAwB,CAAC,GAAW;IACnD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC/C,IAAI,CAAC,SAAS;gBAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YACtD,MAAM,IAAI,GAAG,sBAAsB,CAAC,SAAS,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;YACxE,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC;YACtB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,CAAC,SAAS,CAAC,EAAE,CAAC;QACvE,CAAC;IACF,CAAC;IACD,MAAM,IAAI,GAAG,sBAAsB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,CAAC,OAAO,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,wBAAwB,CAAC,MAAe;IACvD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IACnF,OAAO,WAAW,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACpD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,2BAA2B,CAAC,GAAW;IACtD,IAAI,CAAC;QACJ,MAAM,CAAC,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAMvC;IACA,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,UAAU,GAAG,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAC/C,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,SAAS;gBACb,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;oBAAE,OAAO,IAAI,CAAC;gBAChF,MAAM;YACP,KAAK,WAAW;gBACf,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ;oBAAE,OAAO,IAAI,CAAC;gBACxE,MAAM;YACP,KAAK,iBAAiB;gBACrB,IAAI,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,cAAc,KAAK,MAAM,CAAC,cAAc;oBAAE,OAAO,IAAI,CAAC;gBAC1F,MAAM;YACP,KAAK,QAAQ;gBACZ,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU;oBAAE,OAAO,IAAI,CAAC;gBAC/D,MAAM;QACR,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/agents/channels/imessage/watch-error.d.ts

@@ -0,0 +1,23 @@
+/**
+ * iMessage watch-error payload sanitization.
+ *
+ * The `imsg rpc` stream can emit an `error` notification whose `params` is an
+ * arbitrary, attacker-influenced object (a remote bridge, a malformed row). The
+ * connection logs it — so before logging we reduce it to a finite, bounded shape:
+ * a numeric `code` (only when finite) + a sanitized, length-capped `message`
+ * (terminal control chars stripped so a crafted payload can't smuggle ANSI /
+ * cursor escapes into the operator's terminal or log file).
+ *
+ * Ported from the upstream `sanitizeIMessageWatchErrorPayload`.
+ */
+/** The safe, bounded watch-error shape that is logged. */
+export interface SanitizedIMessageWatchErrorPayload {
+    code?: number;
+    message?: string;
+}
+/**
+ * Reduce a raw watch `error` notification's `params` to a finite `code` +
+ * sanitized/truncated `message`. Anything that isn't a plain object → `{}`.
+ */
+export declare function sanitizeIMessageWatchErrorPayload(payload: unknown): SanitizedIMessageWatchErrorPayload;
+//# sourceMappingURL=watch-error.d.ts.map

package/dist/agents/channels/imessage/watch-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-error.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/imessage/watch-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,0DAA0D;AAC1D,MAAM,WAAW,kCAAkC;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAiCD;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,kCAAkC,CAgBtG"}

package/dist/agents/channels/imessage/watch-error.js

@@ -0,0 +1,69 @@
+/**
+ * iMessage watch-error payload sanitization.
+ *
+ * The `imsg rpc` stream can emit an `error` notification whose `params` is an
+ * arbitrary, attacker-influenced object (a remote bridge, a malformed row). The
+ * connection logs it — so before logging we reduce it to a finite, bounded shape:
+ * a numeric `code` (only when finite) + a sanitized, length-capped `message`
+ * (terminal control chars stripped so a crafted payload can't smuggle ANSI /
+ * cursor escapes into the operator's terminal or log file).
+ *
+ * Ported from the upstream `sanitizeIMessageWatchErrorPayload`.
+ */
+/** Max retained chars of a watch-error message before truncation. */
+const MAX_WATCH_ERROR_MESSAGE_CHARS = 200;
+function isRecord(v) {
+    return Boolean(v) && typeof v === "object" && !Array.isArray(v);
+}
+/**
+ * Strip terminal/control characters from untrusted text for single-line log
+ * rendering: CR/LF/TAB become visible escapes, then every remaining C0/C1
+ * control char (incl. ANSI ESC 0x1b) is removed.
+ */
+function sanitizeTerminalText(input) {
+    const normalized = input.replace(/\r/g, "\\r").replace(/\n/g, "\\n").replace(/\t/g, "\\t");
+    let sanitized = "";
+    for (const char of normalized) {
+        const code = char.charCodeAt(0);
+        const isControl = (code >= 0x00 && code <= 0x1f) || (code >= 0x7f && code <= 0x9f);
+        if (!isControl)
+            sanitized += char;
+    }
+    return sanitized;
+}
+/** Truncate to `max` UTF-16 code units without splitting a surrogate pair. */
+function truncateUtf16Safe(text, max) {
+    if (max <= 0)
+        return "";
+    if (text.length <= max)
+        return text;
+    let end = max;
+    // Don't cut between a high + low surrogate.
+    const code = text.charCodeAt(end - 1);
+    if (code >= 0xd800 && code <= 0xdbff)
+        end -= 1;
+    return text.slice(0, end);
+}
+/**
+ * Reduce a raw watch `error` notification's `params` to a finite `code` +
+ * sanitized/truncated `message`. Anything that isn't a plain object → `{}`.
+ */
+export function sanitizeIMessageWatchErrorPayload(payload) {
+    if (!isRecord(payload))
+        return {};
+    const safe = {};
+    if (typeof payload.code === "number" && Number.isFinite(payload.code)) {
+        safe.code = payload.code;
+    }
+    if (typeof payload.message === "string") {
+        const sanitized = sanitizeTerminalText(payload.message);
+        if (sanitized) {
+            safe.message =
+                sanitized.length > MAX_WATCH_ERROR_MESSAGE_CHARS
+                    ? `${truncateUtf16Safe(sanitized, MAX_WATCH_ERROR_MESSAGE_CHARS - 1)}…`
+                    : sanitized;
+        }
+    }
+    return safe;
+}
+//# sourceMappingURL=watch-error.js.map

package/dist/agents/channels/imessage/watch-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-error.js","sourceRoot":"","sources":["../../../../src/agents/channels/imessage/watch-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qEAAqE;AACrE,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAQ1C,SAAS,QAAQ,CAAC,CAAU;IAC3B,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,KAAa;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3F,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,SAAS,GAAG,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC;QACnF,IAAI,CAAC,SAAS;YAAE,SAAS,IAAI,IAAI,CAAC;IACnC,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,SAAS,iBAAiB,CAAC,IAAY,EAAE,GAAW;IACnD,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACxB,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,4CAA4C;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACtC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM;QAAE,GAAG,IAAI,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iCAAiC,CAAC,OAAgB;IACjE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,IAAI,GAAuC,EAAE,CAAC;IACpD,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,OAAO;gBACX,SAAS,CAAC,MAAM,GAAG,6BAA6B;oBAC/C,CAAC,CAAC,GAAG,iBAAiB,CAAC,SAAS,EAAE,6BAA6B,GAAG,CAAC,CAAC,GAAG;oBACvE,CAAC,CAAC,SAAS,CAAC;QACf,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}