@spinabot/brigade 1.7.0 → 1.8.0

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

@@ -0,0 +1,101 @@
+/**
+ * iMessage transport connection — the live `imsg rpc` subprocess lifecycle.
+ *
+ * `connectIMessage` owns a long-lived {@link IMessageRpcLike} client, subscribes
+ * to inbound notifications (`watch.subscribe`), runs each `message` notification
+ * through the monitor's gating brain (`decideInbound`), and hands dispatched
+ * inbounds to `onMessage`. It also exposes the outbound `sendText` / `sendMedia`
+ * (which `remember` every send in the echo cache so the inbound poll drops the
+ * echo) + reconnect with the shared jittered backoff.
+ *
+ * TEST SEAM: `clientFactory` builds the RPC client — production lets it default
+ * to the real {@link createIMessageRpcClient} (which itself refuses to spawn in
+ * tests); a unit test injects a fake satisfying {@link IMessageRpcLike}. The
+ * adapter layers a second seam (`connectImpl`) on top, mirroring Discord. No
+ * `isTestEnv` flag is consulted here — the seam is pure dependency injection.
+ */
+import { type ResolvedIMessageAccount } from "./account-config.js";
+import { type IMessageRpcLike, type IMessageRpcNotification } from "./client.js";
+import { normalizeIMessageMessage, type NormalizedIMessage } from "./monitor.js";
+import { type IMessageProbeResult } from "./probe.js";
+import { type ScpCopyArgs, type ReadFileLike } from "./remote-attachments.js";
+import { sendMessageIMessage } from "./send.js";
+import type { BrigadeConfig } from "../sdk.js";
+import type { OutboundMedia, OutboundSendOptions, InboundMediaAttachment } from "../sdk.js";
+/** The inbound message the connection hands the adapter (carries the deferred-media thunk). */
+export interface IMessageInboundMessage extends NormalizedIMessage {
+    /** Deferred inbound-media resolver (invoked only after the access gate admits the sender). */
+    resolveMedia?: () => Promise<InboundMediaAttachment[]>;
+    /**
+     * Rolling-history context block (`[recent conversation context]…`) to PREPEND
+     * to the body, set for an untagged group message when `historyLimit > 0`. The
+     * adapter folds it into the dispatched text. Unset when no context applies.
+     */
+    historyContext?: string;
+}
+/** Args for {@link connectIMessage}. */
+export interface ConnectIMessageArgs {
+    account: ResolvedIMessageAccount;
+    /** Active config — used to resolve inbound attachment roots per message. */
+    loadConfig: () => BrigadeConfig;
+    log: (msg: string, meta?: Record<string, unknown>) => void;
+    /** Fired once the subscription is live. */
+    onConnected?: () => void;
+    /** Fired when the transport gives up (binary gone / fatal). */
+    onClosed?: (reason: string) => void;
+    /** Dispatched inbound (post gating + dedupe). */
+    onMessage: (msg: IMessageInboundMessage) => void;
+    signal?: AbortSignal;
+    /** TEST SEAM: build the RPC client. Defaults to the real subprocess client. */
+    clientFactory?: (opts: {
+        cliPath: string;
+        dbPath?: string;
+        onNotification: (msg: IMessageRpcNotification) => void;
+        runtime: {
+            error?: (m: string) => void;
+            info?: (m: string) => void;
+        };
+    }) => Promise<IMessageRpcLike>;
+    /** TEST SEAM: replace the real `sendMessageIMessage` (so outbound tests need no client). */
+    sendImpl?: typeof sendMessageIMessage;
+    /** TEST SEAM: replace the backoff sleep (instant reconnect in tests). */
+    sleepImpl?: (ms: number) => Promise<void>;
+    /**
+     * TEST SEAM: probe the transport readiness (the cold-bridge gate before the
+     * first subscribe). Defaults to the real `probeIMessage`.
+     */
+    probeImpl?: (args: {
+        cliPath: string;
+        dbPath?: string;
+        timeoutMs?: number;
+    }) => Promise<IMessageProbeResult>;
+    /** TEST SEAM: read an SSH-wrapper `cliPath` for remote-host auto-detection. */
+    readFileImpl?: ReadFileLike;
+    /** TEST SEAM: run the `scp` copy for a remote-host inbound attachment. */
+    scpRunner?: ScpCopyArgs["scpRunner"];
+    /** TEST SEAM: temp-dir factory for the remote-attachment copy. */
+    mkdtempImpl?: ScpCopyArgs["mkdtempImpl"];
+}
+/** The live connection handle the adapter drives. */
+export interface IMessageConnection {
+    isConnected(): boolean;
+    connectedAt(): number | null;
+    /** Send text; returns the bridge message id when available. */
+    sendText(conversationId: string, text: string, opts?: OutboundSendOptions): Promise<{
+        messageId?: string;
+    }>;
+    /** Send media; returns the bridge message id when available. */
+    sendMedia(conversationId: string, media: OutboundMedia): Promise<{
+        messageId?: string;
+    }>;
+    /** Tear down the subprocess + stop reconnecting. */
+    close(): Promise<void>;
+}
+/**
+ * Open the iMessage transport. Resolves once the first subscription is live (or
+ * the connect terminally fails). Keeps reconnecting in the background until
+ * `close()` / the abort signal fires.
+ */
+export declare function connectIMessage(args: ConnectIMessageArgs): Promise<IMessageConnection>;
+export { normalizeIMessageMessage };
+//# sourceMappingURL=connection.d.ts.map

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

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

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

@@ -0,0 +1,367 @@
+/**
+ * iMessage transport connection — the live `imsg rpc` subprocess lifecycle.
+ *
+ * `connectIMessage` owns a long-lived {@link IMessageRpcLike} client, subscribes
+ * to inbound notifications (`watch.subscribe`), runs each `message` notification
+ * through the monitor's gating brain (`decideInbound`), and hands dispatched
+ * inbounds to `onMessage`. It also exposes the outbound `sendText` / `sendMedia`
+ * (which `remember` every send in the echo cache so the inbound poll drops the
+ * echo) + reconnect with the shared jittered backoff.
+ *
+ * TEST SEAM: `clientFactory` builds the RPC client — production lets it default
+ * to the real {@link createIMessageRpcClient} (which itself refuses to spawn in
+ * tests); a unit test injects a fake satisfying {@link IMessageRpcLike}. The
+ * adapter layers a second seam (`connectImpl`) on top, mirroring Discord. No
+ * `isTestEnv` flag is consulted here — the seam is pure dependency injection.
+ */
+import { nextBackoffDelay } from "../sdk.js";
+import { resolveIMessageAttachmentRoots, resolveIMessageRemoteAttachmentRoots, } from "./account-config.js";
+import { createIMessageRpcClient, } from "./client.js";
+import { IMessageHistoryBuffer, renderIMessageHistoryBlock } from "./history.js";
+import { inferOutboundMediaKind, resolveInboundAttachments, resolveInboundAttachmentsRemote } from "./media.js";
+import { createMonitorState, decideInbound, echoScope, normalizeIMessageMessage, parseIMessageNotification, } from "./monitor.js";
+import { probeIMessage } from "./probe.js";
+import { detectRemoteHostFromCliPath, normalizeScpRemoteHost, } from "./remote-attachments.js";
+import { sendMessageIMessage } from "./send.js";
+import { sanitizeIMessageWatchErrorPayload } from "./watch-error.js";
+/** Reconnect schedule constants — mirror the shared WhatsApp curve. */
+const RECONNECT_INITIAL_MS = 2_000;
+const RECONNECT_MAX_MS = 30_000;
+const RECONNECT_FACTOR = 1.8;
+const RECONNECT_JITTER = 0.25;
+const RECONNECT_MAX_ATTEMPTS = 12;
+/** Watch-subscribe startup retry — 3 quick attempts before falling to backoff. */
+const WATCH_SUBSCRIBE_MAX_ATTEMPTS = 3;
+const WATCH_SUBSCRIBE_RETRY_DELAY_MS = 1_000;
+/** Transport-readiness gate — poll `probeIMessage` until the bridge is up. */
+const TRANSPORT_READY_TIMEOUT_MS = 30_000;
+const TRANSPORT_READY_POLL_INTERVAL_MS = 500;
+const TRANSPORT_READY_LOG_INTERVAL_MS = 10_000;
+/** Transient startup errors worth a quick subscribe retry (vs the slow backoff loop). */
+function isRetriableSubscribeStartupError(error) {
+    return /imsg rpc timeout \(watch\.subscribe\)|imsg rpc (closed|exited|not running)/i.test(String(error));
+}
+const defaultSleep = (ms) => new Promise((resolve) => {
+    const t = setTimeout(resolve, ms);
+    if (typeof t.unref === "function")
+        t.unref();
+});
+/**
+ * Open the iMessage transport. Resolves once the first subscription is live (or
+ * the connect terminally fails). Keeps reconnecting in the background until
+ * `close()` / the abort signal fires.
+ */
+export async function connectIMessage(args) {
+    const { account } = args;
+    const state = createMonitorState();
+    const sleep = args.sleepImpl ?? defaultSleep;
+    const sendFn = args.sendImpl ?? sendMessageIMessage;
+    const probe = args.probeImpl ?? ((a) => probeIMessage(a));
+    const clientFactory = args.clientFactory ??
+        (async (opts) => createIMessageRpcClient({
+            cliPath: opts.cliPath,
+            ...(opts.dbPath ? { dbPath: opts.dbPath } : {}),
+            onNotification: opts.onNotification,
+            runtime: opts.runtime,
+        }));
+    // Rolling per-conversation history buffer (untagged group-message context).
+    const history = new IMessageHistoryBuffer();
+    let client = null;
+    let connected = false;
+    let connectedAtMs = null;
+    let closed = false;
+    let attempt = 0;
+    // Resolve the remote host once: explicit config wins; else auto-detect from an
+    // SSH-wrapper `cliPath`. Only a safety-validated host is accepted (so it can
+    // never inject an option/arg into the SCP command). Empty ⇒ same-host setup.
+    let remoteHost = normalizeScpRemoteHost(account.remoteHost);
+    if (account.remoteHost && !remoteHost) {
+        args.log("imessage: ignoring unsafe channels.imessage.remoteHost value");
+    }
+    if (!remoteHost && account.cliPath && account.cliPath !== "imsg") {
+        const detected = await detectRemoteHostFromCliPath(account.cliPath, ...(args.readFileImpl ? [args.readFileImpl] : []));
+        const normalizedDetected = normalizeScpRemoteHost(detected);
+        if (detected && !normalizedDetected) {
+            args.log("imessage: ignoring unsafe auto-detected remoteHost from cliPath");
+        }
+        remoteHost = normalizedDetected;
+        if (remoteHost && account.verbose)
+            args.log(`imessage: detected remoteHost=${remoteHost} from cliPath`);
+    }
+    const handleNotification = (msg) => {
+        // Wrap the whole handler so a synchronous throw (malformed payload, a
+        // decideInbound bug, a downstream onMessage error) can NEVER escape into the
+        // RPC client's notification loop and wedge the watch / crash the gateway.
+        // The transport keeps reading; a single bad notification is logged + dropped.
+        try {
+            if (msg.method === "error") {
+                // Sanitize before logging — the payload is attacker-influenced (a
+                // crafted row / remote bridge could smuggle ANSI escapes or a huge
+                // blob). Keep only a finite code + a stripped/truncated message.
+                args.log("imessage watch error", { error: sanitizeIMessageWatchErrorPayload(msg.params) });
+                return;
+            }
+            if (msg.method !== "message")
+                return;
+            const payload = parseIMessageNotification(msg.params);
+            if (!payload) {
+                args.log("dropping malformed iMessage payload");
+                return;
+            }
+            // `selfHandle` lets a group message naming the bot populate `mentions[]`
+            // so the central group requireMention gate can fire.
+            const decision = decideInbound(state, account.accountId, payload, account.selfHandle);
+            if (decision.kind === "drop") {
+                if (account.verbose)
+                    args.log(`inbound dropped: ${decision.reason}`);
+                return;
+            }
+            const normalized = decision.message;
+            // Rolling-history context: for an UNTAGGED group message (no self-mention,
+            // not a reply) attach the last N seen messages as a fenced context block,
+            // then record THIS message for the next turn. iMessage's `imsg rpc`
+            // transport exposes no history method, so this is a pure in-memory buffer
+            // of messages the monitor has already seen (mirrors the upstream monitor).
+            const isUntaggedGroup = normalized.isGroup && (!normalized.mentions || normalized.mentions.length === 0) && !normalized.replyTo;
+            if (account.historyLimit > 0 && isUntaggedGroup && normalized.text.trim()) {
+                const entries = history.recent(normalized.conversationId, account.historyLimit);
+                const block = renderIMessageHistoryBlock(entries);
+                if (block)
+                    normalized.historyContext = block;
+            }
+            if (normalized.isGroup) {
+                history.record(normalized.conversationId, {
+                    sender: normalized.fromName || normalized.from || "Unknown",
+                    body: normalized.text,
+                });
+            }
+            // Deferred media — resolve only after the central access gate admits the
+            // sender (the bridge has already saved the bytes to disk; we just map them).
+            const inbound = { ...normalized };
+            // `includeAttachments:false` opts the account out of inbound media entirely.
+            if (account.includeAttachments && Array.isArray(payload.attachments) && payload.attachments.length > 0) {
+                const atts = payload.attachments;
+                inbound.resolveMedia = remoteHost
+                    ? async () => {
+                        const remoteRoots = resolveIMessageRemoteAttachmentRoots(args.loadConfig(), account.accountId);
+                        return resolveInboundAttachmentsRemote(atts, {
+                            remoteHost: remoteHost,
+                            remoteRoots,
+                            ...(args.scpRunner ? { scpRunner: args.scpRunner } : {}),
+                            ...(args.mkdtempImpl ? { mkdtempImpl: args.mkdtempImpl } : {}),
+                            log: (m) => args.log(m),
+                        });
+                    }
+                    : async () => {
+                        const roots = resolveIMessageAttachmentRoots(args.loadConfig(), account.accountId);
+                        return resolveInboundAttachments(atts, roots);
+                    };
+            }
+            args.onMessage(inbound);
+        }
+        catch (err) {
+            args.log("imessage notification handler threw (dropped, loop continues)", {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    };
+    /** Build a client + issue one `watch.subscribe`. Throws on failure (client torn down). */
+    const subscribeAttempt = async () => {
+        const c = await clientFactory({
+            cliPath: account.cliPath,
+            ...(account.dbPath ? { dbPath: account.dbPath } : {}),
+            onNotification: handleNotification,
+            runtime: {
+                error: (m) => args.log(m),
+                info: (m) => account.verbose && args.log(m),
+            },
+        });
+        try {
+            await c.request("watch.subscribe", { attachments: account.includeAttachments }, { timeoutMs: account.probeTimeoutMs });
+        }
+        catch (err) {
+            // Tear down the failed client before rethrowing so a slow subscribe
+            // can't keep emitting notifications into the next attempt's window.
+            try {
+                await c.stop();
+            }
+            catch {
+                /* best-effort */
+            }
+            throw err;
+        }
+        return c;
+    };
+    /**
+     * Subscribe with a short 3× startup retry (≈1s apart, tearing the client down
+     * between attempts) on transient startup errors, BEFORE the slow reconnect
+     * backoff loop takes over. A cold `imsg` bridge often fails the very first
+     * subscribe; this rides over it without waiting the full backoff.
+     */
+    const subscribeOnce = async () => {
+        let lastErr;
+        for (let i = 1; i <= WATCH_SUBSCRIBE_MAX_ATTEMPTS; i++) {
+            if (closed || args.signal?.aborted)
+                return;
+            try {
+                client = await subscribeAttempt();
+                connected = true;
+                connectedAtMs = Date.now();
+                attempt = 0;
+                args.onConnected?.();
+                return;
+            }
+            catch (err) {
+                lastErr = err;
+                const canRetry = i < WATCH_SUBSCRIBE_MAX_ATTEMPTS && isRetriableSubscribeStartupError(err);
+                if (!canRetry)
+                    throw err;
+                args.log(`imessage: watch.subscribe startup failed (attempt ${i}/${WATCH_SUBSCRIBE_MAX_ATTEMPTS}): ${err instanceof Error ? err.message : String(err)}; retrying`);
+                await sleep(WATCH_SUBSCRIBE_RETRY_DELAY_MS);
+            }
+        }
+        throw lastErr instanceof Error ? lastErr : new Error(String(lastErr));
+    };
+    /**
+     * Poll `probeIMessage` until the `imsg` bridge is reachable (or the timeout
+     * elapses), so a cold bridge surfaces as a "waiting for transport" log rather
+     * than an immediate connect failure. A FATAL probe (old binary) is rethrown.
+     * Returns true when ready, false on timeout / abort.
+     */
+    const waitForTransportReady = async () => {
+        const started = Date.now();
+        let nextLogAt = started + TRANSPORT_READY_LOG_INTERVAL_MS;
+        while (!closed && !args.signal?.aborted) {
+            let result;
+            try {
+                result = await probe({
+                    cliPath: account.cliPath,
+                    ...(account.dbPath ? { dbPath: account.dbPath } : {}),
+                    timeoutMs: account.probeTimeoutMs,
+                });
+            }
+            catch (err) {
+                result = { ok: false, error: err instanceof Error ? err.message : String(err), elapsedMs: 0 };
+            }
+            if (result.ok)
+                return true;
+            if (result.fatal)
+                throw new Error(result.error ?? "imsg rpc unavailable");
+            const now = Date.now();
+            if (now - started >= TRANSPORT_READY_TIMEOUT_MS)
+                return false;
+            if (now >= nextLogAt) {
+                args.log(`imessage: waiting for transport (imsg bridge not ready: ${result.error ?? "unreachable"})`);
+                nextLogAt = now + TRANSPORT_READY_LOG_INTERVAL_MS;
+            }
+            await sleep(TRANSPORT_READY_POLL_INTERVAL_MS);
+        }
+        return false;
+    };
+    /** Background supervise loop — reconnect with jittered backoff until closed. */
+    const supervise = async () => {
+        while (!closed && !args.signal?.aborted) {
+            try {
+                if (!connected)
+                    await subscribeOnce();
+                // Block on the client closing; on close, fall through to reconnect.
+                await client?.waitForClose();
+            }
+            catch (err) {
+                args.log("imessage connect attempt failed", { error: err instanceof Error ? err.message : String(err) });
+            }
+            connected = false;
+            try {
+                await client?.stop();
+            }
+            catch {
+                /* best-effort */
+            }
+            client = null;
+            if (closed || args.signal?.aborted)
+                break;
+            attempt += 1;
+            if (attempt > RECONNECT_MAX_ATTEMPTS) {
+                args.onClosed?.(`gave up after ${RECONNECT_MAX_ATTEMPTS} reconnect attempts`);
+                break;
+            }
+            const delay = nextBackoffDelay({
+                attempt,
+                initialMs: RECONNECT_INITIAL_MS,
+                maxMs: RECONNECT_MAX_MS,
+                factor: RECONNECT_FACTOR,
+                jitter: RECONNECT_JITTER,
+            });
+            await sleep(delay);
+        }
+    };
+    // First connect — gate on transport readiness (a cold `imsg` bridge logs
+    // "waiting for transport" instead of failing immediately), then subscribe.
+    // Surface a failure to the caller; keep the loop running after.
+    await waitForTransportReady();
+    await subscribeOnce();
+    void supervise();
+    if (args.signal) {
+        if (args.signal.aborted)
+            closed = true;
+        else
+            args.signal.addEventListener("abort", () => void close(), { once: true });
+    }
+    const remember = (conversationId, sent) => {
+        // Build the same scope the inbound poll keys on so the echo is suppressed.
+        const numericChat = conversationId.startsWith("chat:") ? Number.parseInt(conversationId.slice(5), 10) : NaN;
+        const scope = Number.isFinite(numericChat)
+            ? echoScope(account.accountId, { chat_id: numericChat })
+            : `${account.accountId}:imessage:${conversationId}`;
+        state.sentMessageCache.remember(scope, { text: sent.sentText, messageId: sent.messageId });
+    };
+    async function close() {
+        if (closed)
+            return;
+        closed = true;
+        try {
+            await client?.stop();
+        }
+        catch {
+            /* best-effort */
+        }
+        client = null;
+        connected = false;
+    }
+    return {
+        isConnected: () => connected,
+        connectedAt: () => connectedAtMs,
+        async sendText(conversationId, text, opts) {
+            const result = await sendFn(conversationId, text, {
+                cliPath: account.cliPath,
+                ...(account.dbPath ? { dbPath: account.dbPath } : {}),
+                service: account.service,
+                region: account.region,
+                maxBytes: account.mediaMaxBytes,
+                timeoutMs: account.probeTimeoutMs,
+                ...(client ? { client } : {}),
+                ...(opts?.replyToId ? { replyToId: opts.replyToId } : {}),
+            });
+            remember(conversationId, result);
+            return result.messageId ? { messageId: result.messageId } : {};
+        },
+        async sendMedia(conversationId, media) {
+            const result = await sendFn(conversationId, media.caption ?? "", {
+                cliPath: account.cliPath,
+                ...(account.dbPath ? { dbPath: account.dbPath } : {}),
+                service: account.service,
+                region: account.region,
+                maxBytes: account.mediaMaxBytes,
+                timeoutMs: account.probeTimeoutMs,
+                mediaPath: media.path,
+                mediaKind: inferOutboundMediaKind(media),
+                ...(client ? { client } : {}),
+            });
+            remember(conversationId, result);
+            return result.messageId ? { messageId: result.messageId } : {};
+        },
+        close,
+    };
+}
+export { normalizeIMessageMessage };
+//# sourceMappingURL=connection.js.map

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * iMessage outbound formatting helpers.
+ *
+ * iMessage has NO rich markup — a message is plain text. So unlike Telegram
+ * (HTML) or Discord (CommonMark), the only transform we need is to make markdown
+ * READABLE as plain text:
+ *   - a markdown pipe-table is flattened to `cell | cell` lines (the LLM emits
+ *     tables and an un-flattened one renders as raw `| --- |` noise);
+ *   - everything else passes through untouched (bold `**x**`, links `[a](b)` —
+ *     iMessage shows the literal characters, which is the honest fallback).
+ *
+ * Plus two send-path utilities ported from the upstream `send.ts`:
+ *   - `sanitizeReplyToId` — scrub a reply-to id of control chars / brackets so it
+ *     can't break the bridge's tag parsing, capped at 256 chars;
+ *   - `resolveDeliveredText` — when an outbound has media but no text, deliver a
+ *     `<media:kind>` placeholder so the echo cache + transcript have a body.
+ */
+/**
+ * Convert agent-style markdown to iMessage-friendly plain text. The only
+ * load-bearing transform is flattening pipe tables; all other markdown passes
+ * through verbatim (iMessage renders the literal characters).
+ */
+export declare function markdownToIMessageText(markdown: string): string;
+/**
+ * Sanitize an outbound reply-to id: trim, strip unsafe chars, cap at 256 chars.
+ * Returns undefined when nothing usable remains.
+ */
+export declare function sanitizeReplyToId(raw?: string): string | undefined;
+/**
+ * Strip Brigade-internal scaffolding from outbound text before it hits the wire.
+ * Returns the cleaned text; if stripping leaves nothing, returns the trimmed
+ * original (better to send something than confuse the recipient with silence).
+ */
+export declare function sanitizeOutboundIMessageText(text: string): string;
+/** Outbound media kind → the placeholder text used when the message has no body. */
+export type IMessageMediaKind = OutboundMediaKind;
+type OutboundMediaKind = "image" | "video" | "audio" | "voice" | "document" | "sticker";
+/**
+ * When an outbound carries media but no text, deliver a `<media:kind>`
+ * placeholder so the echo cache + transcript have a body to key on. Returns the
+ * text unchanged when it's non-empty.
+ */
+export declare function resolveDeliveredText(text: string, mediaKind?: OutboundMediaKind): string;
+export {};
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/imessage/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA+BH;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiB/D;AAcD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOlE;AA8CD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYjE;AAED,oFAAoF;AACpF,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAClD,KAAK,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAExF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAIxF"}