@spinabot/brigade 1.6.1 → 1.8.0

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

@@ -0,0 +1,286 @@
+/**
+ * iMessage channel adapter.
+ *
+ * Implements the Brigade `ChannelAdapter` contract on top of the `imsg` CLI
+ * driven as a JSON-RPC subprocess (`connection.ts`). iMessage authenticates via
+ * the local Messages.app session — there is NO bot token, so enablement is just
+ * `channels.imessage.enabled: true` plus a runnable `imsg` binary. The adapter
+ * declares a `setup` wizard for the binary path (so `brigade channels add` can
+ * configure a non-PATH install) and has no QR/link flow.
+ *
+ * Modeled on `discord/adapter.ts`: same `isConfigured`→`start` config capture,
+ * same health-flag mirroring, same deferred-media passthrough on inbound, same
+ * chunk-then-send outbound (chunk the markdown, plain-text-ify each chunk, send).
+ *
+ * TEST SEAM: `connectImpl` overrides how the connection is built — production
+ * leaves it undefined and `connectIMessage` lazy-spawns the subprocess (which
+ * itself refuses in tests); a unit test injects a fake connection so send /
+ * health / inbound dispatch run with no real binary.
+ */
+import { loadConfig } from "../../../core/config.js";
+// Channel SDK barrel — the single import surface for the channel-authoring
+// contract + shared helpers.
+import { chunkText, } from "../sdk.js";
+import { imessageChannelEnabled, listIMessageAccountIds, resolveIMessageAccount, resolveIMessageCliPath, DEFAULT_IMESSAGE_TEXT_CHUNK_LIMIT, IMESSAGE_CHANNEL_ID, IMESSAGE_DEFAULT_ACCOUNT_ID, } from "./account-config.js";
+import { connectIMessage, } from "./connection.js";
+import { markdownToIMessageText } from "./format.js";
+/** iMessage's practical per-message text limit for chunked sends (default; config can override). */
+const IMESSAGE_TEXT_LIMIT = DEFAULT_IMESSAGE_TEXT_CHUNK_LIMIT;
+/** iMessage capabilities — DMs + groups, media + reply; no edit/unsend/reactions via the bridge. */
+export const IMESSAGE_CAPABILITIES = {
+    chatTypes: ["direct", "group"],
+    media: true,
+    reply: true,
+};
+async function loadStartConfig() {
+    return loadConfig();
+}
+/**
+ * For `chunkMode: "newline"`, break an already-limit-bounded chunk into one piece
+ * per line (dropping blank lines), so each non-empty line is delivered as its own
+ * message. A line longer than `limit` is left intact (the caller already bounded
+ * the chunk to `limit`, so this only ever sub-divides). Returns the original
+ * chunk in a single-element array when it has no internal line breaks.
+ */
+function splitChunkByNewline(chunk, limit) {
+    void limit;
+    const lines = chunk.split("\n").map((l) => l.trimEnd());
+    const out = lines.filter((l) => l.trim().length > 0);
+    return out.length > 0 ? out : [chunk];
+}
+export function createIMessageAdapter(opts = {}) {
+    const accountId = opts.accountId?.trim() || IMESSAGE_DEFAULT_ACCOUNT_ID;
+    const connectImpl = opts.connectImpl ?? connectIMessage;
+    let connection = null;
+    // The manager calls isConfigured(cfg, env) right before start(ctx); capture
+    // them so start() reads the resolved account without a second config load.
+    let lastConfig = null;
+    let lastEnv = process.env;
+    // Health flags mirrored from the connection lifecycle so health() never has to
+    // round-trip the subprocess.
+    let connected = false;
+    let closedReason = null;
+    // Captured from the resolved account at start() so the inbound/outbound paths
+    // don't re-resolve config per message.
+    let selfHandle = "";
+    let textChunkLimit = IMESSAGE_TEXT_LIMIT;
+    let chunkMode = "length";
+    const adapter = {
+        id: IMESSAGE_CHANNEL_ID,
+        label: "iMessage",
+        isConfigured(cfg, env) {
+            lastConfig = cfg;
+            lastEnv = env ?? process.env;
+            if (!imessageChannelEnabled(cfg))
+                return false;
+            // Need a resolvable `imsg` binary path (always resolves to at least the
+            // default "imsg"); enablement is the real gate.
+            if (!resolveIMessageCliPath(cfg, accountId, env ?? process.env))
+                return false;
+            // Multi-account: the plugin path owns lifecycle when >1 account; the
+            // legacy single adapter steps aside.
+            const isLegacyAdapter = accountId === IMESSAGE_DEFAULT_ACCOUNT_ID;
+            if (isLegacyAdapter && listIMessageAccountIds(cfg).length > 1)
+                return false;
+            return true;
+        },
+        async start(ctx) {
+            const cfg = lastConfig ?? (await loadStartConfig());
+            const account = resolveIMessageAccount(cfg, accountId, lastEnv);
+            selfHandle = account.selfHandle;
+            textChunkLimit = account.textChunkLimit;
+            chunkMode = account.chunkMode;
+            try {
+                const conn = await connectImpl({
+                    account,
+                    loadConfig: () => (lastConfig ?? cfg),
+                    log: ctx.log,
+                    ...(ctx.signal ? { signal: ctx.signal } : {}),
+                    onConnected: () => {
+                        connected = true;
+                        closedReason = null;
+                        ctx.log("iMessage connected");
+                        ctx.onConnected?.();
+                    },
+                    onClosed: (reason) => {
+                        connected = false;
+                        closedReason = reason;
+                        ctx.log(`iMessage transport closed: ${reason}`);
+                        ctx.onLoggedOut?.();
+                    },
+                    onMessage: (msg) => {
+                        // Prepend the rolling-history context block (untagged group msg) to
+                        // the body so the agent replies INTO the conversation.
+                        const body = msg.historyContext ? `${msg.historyContext}\n\n${msg.text}` : msg.text;
+                        void ctx.onInbound({
+                            channel: IMESSAGE_CHANNEL_ID,
+                            accountId,
+                            conversationId: msg.conversationId,
+                            ...(msg.messageId ? { messageId: msg.messageId } : {}),
+                            ...(msg.createdAtMs !== undefined ? { messageTimestampMs: msg.createdAtMs } : {}),
+                            from: msg.from,
+                            ...(msg.fromName !== undefined ? { fromName: msg.fromName } : {}),
+                            text: body,
+                            chatType: msg.isGroup ? "group" : "direct",
+                            isGroup: msg.isGroup,
+                            // Bot-handle mentions (group requireMention gate fires on these).
+                            ...(msg.mentions && msg.mentions.length > 0 ? { mentions: msg.mentions } : {}),
+                            ...(msg.replyTo ? { replyTo: msg.replyTo } : {}),
+                            // Deferred media thunk rides through untouched — the pipeline
+                            // resolves it only after the access gate admits the sender.
+                            ...(msg.resolveMedia ? { resolveMedia: msg.resolveMedia } : {}),
+                            raw: msg.raw,
+                        });
+                    },
+                });
+                connection = conn;
+            }
+            catch (err) {
+                connected = false;
+                closedReason = err instanceof Error ? err.message : String(err);
+                ctx.log(`iMessage failed to start: ${closedReason}`);
+            }
+        },
+        async stop() {
+            await connection?.close();
+            connection = null;
+            connected = false;
+        },
+        health() {
+            if (!connection) {
+                return { ok: false, kind: "starting", reason: "iMessage adapter is not started yet." };
+            }
+            if (!connected || !connection.isConnected()) {
+                return {
+                    ok: false,
+                    kind: "disconnected",
+                    reason: closedReason
+                        ? `iMessage is not connected — ${closedReason}.`
+                        : "iMessage is reconnecting — sends will fail until the imsg bridge resumes.",
+                    remediation: "Ensure the imsg CLI is installed and Messages.app is signed in.",
+                };
+            }
+            return { ok: true };
+        },
+        async sendText(conversationId, text, opts) {
+            if (!connection)
+                throw new Error("iMessage channel is not started");
+            // Chunk on the raw markdown (so fences/paragraphs aren't shredded), then
+            // plain-text-ify each chunk and send. The chunk size is config-driven
+            // (`textChunkLimit`); `chunkMode: "newline"` additionally breaks each chunk
+            // on single line boundaries (one message per line), where `length` (default)
+            // packs lines to the limit.
+            const limit = textChunkLimit > 0 ? textChunkLimit : IMESSAGE_TEXT_LIMIT;
+            let chunks = chunkText(text, { limit });
+            if (chunkMode === "newline") {
+                chunks = chunks.flatMap((chunk) => splitChunkByNewline(chunk, limit));
+            }
+            let first = true;
+            let lastMessageId;
+            for (const chunk of chunks) {
+                const body = markdownToIMessageText(chunk);
+                if (body.trim().length === 0)
+                    continue;
+                // Native reply target applies to the FIRST chunk only.
+                const replyOpt = first && opts?.replyToId ? { replyToId: opts.replyToId } : {};
+                const sent = await connection.sendText(conversationId, body, { ...replyOpt });
+                if (sent.messageId)
+                    lastMessageId = sent.messageId;
+                first = false;
+            }
+            return lastMessageId ? { messageId: lastMessageId } : undefined;
+        },
+        async sendMedia(conversationId, media) {
+            if (!connection)
+                throw new Error("iMessage channel is not started");
+            const sent = await connection.sendMedia(conversationId, media);
+            return sent.messageId ? { messageId: sent.messageId } : undefined;
+        },
+        // The bot's own iMessage handle (when the operator configured
+        // `channels.imessage.selfHandle`) — lets the central pipeline's group
+        // mention-gating match `msg.mentions` against the bot. Undefined when unset.
+        selfId() {
+            return selfHandle || undefined;
+        },
+        connectedAt() {
+            return connection?.connectedAt() ?? null;
+        },
+        // iMessage senders are phone numbers / emails on the operator's own device;
+        // the bot runs AS the operator (Messages.app), so the pairing card uses the
+        // "account" label and ownership is NOT bootstrapped from a separate bot.
+        pairing: { idLabel: "account" },
+        // iMessage has no bot token — the `imsg` binary path + Messages.app sign-in
+        // are the auth. `brigade channels add imessage` walks: cliPath → dmPolicy →
+        // allowFrom → selfHandle. The first prompt carries the macOS-permissions
+        // completion note (Full Disk Access + Automation) since the central setup
+        // surface has no separate "completion note" hook.
+        setup: {
+            credentialKeys: [
+                {
+                    key: "cliPath",
+                    prompt: "Path to the `imsg` CLI binary (leave blank to use `imsg` on PATH). " +
+                        "Requires Messages.app signed in on this Mac, and the terminal/app running `imsg` must be granted " +
+                        "macOS Full Disk Access (to read the Messages chat.db) + Automation permission for Messages " +
+                        "(System Settings → Privacy & Security). Tip: list chats with `imsg chats --limit 20`.",
+                    secret: false,
+                    envVar: "IMSG_CLI_PATH",
+                },
+                {
+                    key: "dmPolicy",
+                    prompt: "Who may DM this account? pairing (owner + approved; strangers challenged — default) / " +
+                        "allowlist (only allowFrom) / open (anyone) / disabled (drop all DMs). Leave blank for pairing.",
+                    secret: false,
+                },
+                {
+                    key: "allowFrom",
+                    prompt: "Allowlist of senders for allowlist mode — handles or chat targets, comma-separated " +
+                        "(e.g. +15555550123, user@example.com, chat_id:123). Leave blank for none.",
+                    secret: false,
+                },
+                {
+                    key: "selfHandle",
+                    prompt: "This bot's OWN iMessage handle (phone or email) — used so a group message naming the bot " +
+                        "counts as a mention for the group requireMention gate. Leave blank to skip.",
+                    secret: false,
+                },
+            ],
+            validateInput(key, value) {
+                const v = value.trim();
+                if (key === "cliPath" && v && /\s$/.test(value))
+                    return "Path must not end with whitespace.";
+                if (key === "dmPolicy" && v && !["pairing", "allowlist", "open", "disabled"].includes(v.toLowerCase())) {
+                    return "dmPolicy must be one of: pairing, allowlist, open, disabled.";
+                }
+                return null;
+            },
+            buildAccountConfig(values) {
+                const out = { enabled: true };
+                const cliPath = (values.cliPath ?? "").trim();
+                if (cliPath)
+                    out.cliPath = cliPath;
+                const dmPolicy = (values.dmPolicy ?? "").trim().toLowerCase();
+                if (dmPolicy && dmPolicy !== "pairing")
+                    out.dmPolicy = dmPolicy;
+                const allowFrom = (values.allowFrom ?? "")
+                    .split(/[\n,]+/g)
+                    .map((s) => s.trim())
+                    .filter(Boolean);
+                if (allowFrom.length > 0)
+                    out.allowFrom = allowFrom;
+                const selfHandleVal = (values.selfHandle ?? "").trim();
+                if (selfHandleVal)
+                    out.selfHandle = selfHandleVal;
+                return out;
+            },
+        },
+        capabilities: IMESSAGE_CAPABILITIES,
+        // iMessage has no edit/delete/react/pin via the bridge; the central
+        // message_action tool pre-checks `capabilities` (none advertised beyond
+        // reply), so this reports anything else unsupported cleanly.
+        async handleAction() {
+            return { ok: false, error: "iMessage does not support message actions" };
+        },
+    };
+    return adapter;
+}
+//# sourceMappingURL=adapter.js.map

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

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

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

@@ -0,0 +1,99 @@
+/**
+ * iMessage RPC client — newline-delimited JSON-RPC 2.0 over a child process's
+ * stdin/stdout.
+ *
+ * The transport spawns the third-party `imsg` CLI as `imsg rpc [--db <path>]`
+ * and speaks JSON-RPC 2.0 framed ONE object per `\n`:
+ *   - a request is `{ jsonrpc:"2.0", id, method, params }\n` written to stdin;
+ *   - a line with a non-null `id` is a RESPONSE matched against the pending map;
+ *   - a line with a `method` and NO `id` is an inbound NOTIFICATION dispatched to
+ *     `onNotification` (the monitor subscribes to these for new messages).
+ *
+ * This is the iMessage analogue of a token-channel's transport SDK. There is a
+ * hard TEST SEAM: the real client REFUSES to spawn a subprocess in tests (see
+ * {@link isTestEnv}). Unit tests inject a {@link IMessageRpcLike} fake on the
+ * adapter/connection seam instead, so send / normalize / probe / dedupe are all
+ * exercised with NO real `imsg` binary and NO live subprocess.
+ */
+/** A JSON-RPC error object. */
+export type IMessageRpcError = {
+    code?: number;
+    message?: string;
+    data?: unknown;
+};
+/** A parsed inbound notification (a line with a `method` and no `id`). */
+export type IMessageRpcNotification = {
+    method: string;
+    params?: unknown;
+};
+/** Cross-cutting runtime hooks the client surfaces (logging only). */
+export interface IMessageRpcRuntime {
+    error?: (message: string) => void;
+    info?: (message: string) => void;
+}
+/** Construction options for {@link IMessageRpcClient}. */
+export interface IMessageRpcClientOptions {
+    /** Path to the `imsg` binary. Defaults to `"imsg"` (found on PATH). */
+    cliPath?: string;
+    /** Optional chat.db override (`~`-expanded here). */
+    dbPath?: string;
+    /** Logging hooks (stderr lines, parse failures). */
+    runtime?: IMessageRpcRuntime;
+    /** Called for every inbound notification (`{ method, params }`). */
+    onNotification?: (msg: IMessageRpcNotification) => void;
+}
+/**
+ * The minimal transport surface the adapter / send path depend on. The real
+ * {@link IMessageRpcClient} implements it; tests inject a fake satisfying it.
+ * Keeping the dependency on this interface (NOT the concrete class) is the test
+ * seam — a unit test never touches a child process.
+ */
+export interface IMessageRpcLike {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    request<T = unknown>(method: string, params?: unknown, opts?: {
+        timeoutMs?: number;
+    }): Promise<T>;
+    waitForClose(): Promise<void>;
+}
+/**
+ * True in a test environment. The real client REFUSES to spawn `imsg rpc` here
+ * so a stray unit test can never shell out to the binary — tests must inject a
+ * mock {@link IMessageRpcLike} on the seam instead.
+ */
+export declare function isTestEnv(): boolean;
+/**
+ * Long-lived JSON-RPC 2.0 client over an `imsg rpc` child process. A pending-id
+ * map matches responses; an `onNotification` callback fans out inbound events;
+ * `failAll` rejects every in-flight request when the child errors or closes.
+ */
+export declare class IMessageRpcClient implements IMessageRpcLike {
+    private readonly cliPath;
+    private readonly dbPath;
+    private readonly runtime;
+    private readonly onNotification;
+    private readonly pending;
+    private readonly closed;
+    private closedResolve;
+    private child;
+    private reader;
+    private nextId;
+    constructor(opts?: IMessageRpcClientOptions);
+    /** Spawn the child + wire stdout (responses/notifications) and stderr (logs). Idempotent. */
+    start(): Promise<void>;
+    /** Gracefully end stdin, then SIGTERM after a 500ms grace if still alive. */
+    stop(): Promise<void>;
+    /** Resolves when the child has errored or closed. */
+    waitForClose(): Promise<void>;
+    /** Issue a JSON-RPC request and await its matching response (10s default timeout). */
+    request<T = unknown>(method: string, params?: unknown, opts?: {
+        timeoutMs?: number;
+    }): Promise<T>;
+    /** Parse one stdout line: a non-null `id` is a response, a bare `method` is a notification. */
+    private handleLine;
+    /** Reject every in-flight request with `err` and clear their timers. */
+    private failAll;
+}
+/** Construct + start a real RPC client. */
+export declare function createIMessageRpcClient(opts?: IMessageRpcClientOptions): Promise<IMessageRpcClient>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/imessage/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,+BAA+B;AAC/B,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnF,0EAA0E;AAC1E,MAAM,MAAM,uBAAuB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE3E,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IAClC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,0DAA0D;AAC1D,MAAM,WAAW,wBAAwB;IACxC,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,oEAAoE;IACpE,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,CAAC;CACxD;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAClG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AASD;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAInC;AAgBD;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuD;IACtF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAAK;gBAEP,IAAI,GAAE,wBAA6B;IAU/C,6FAA6F;IACvF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC5B,6EAA6E;IACvE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B3B,qDAAqD;IAC/C,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,sFAAsF;IAChF,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAwBvG,+FAA+F;IAC/F,OAAO,CAAC,UAAU;IA0ClB,wEAAwE;IACxE,OAAO,CAAC,OAAO;CAOf;AAED,2CAA2C;AAC3C,wBAAsB,uBAAuB,CAAC,IAAI,GAAE,wBAA6B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAI7G"}

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

@@ -0,0 +1,231 @@
+/**
+ * iMessage RPC client — newline-delimited JSON-RPC 2.0 over a child process's
+ * stdin/stdout.
+ *
+ * The transport spawns the third-party `imsg` CLI as `imsg rpc [--db <path>]`
+ * and speaks JSON-RPC 2.0 framed ONE object per `\n`:
+ *   - a request is `{ jsonrpc:"2.0", id, method, params }\n` written to stdin;
+ *   - a line with a non-null `id` is a RESPONSE matched against the pending map;
+ *   - a line with a `method` and NO `id` is an inbound NOTIFICATION dispatched to
+ *     `onNotification` (the monitor subscribes to these for new messages).
+ *
+ * This is the iMessage analogue of a token-channel's transport SDK. There is a
+ * hard TEST SEAM: the real client REFUSES to spawn a subprocess in tests (see
+ * {@link isTestEnv}). Unit tests inject a {@link IMessageRpcLike} fake on the
+ * adapter/connection seam instead, so send / normalize / probe / dedupe are all
+ * exercised with NO real `imsg` binary and NO live subprocess.
+ */
+import { spawn } from "node:child_process";
+import os from "node:os";
+import path from "node:path";
+import { createInterface } from "node:readline";
+import { DEFAULT_IMESSAGE_PROBE_TIMEOUT_MS } from "./account-config.js";
+/**
+ * True in a test environment. The real client REFUSES to spawn `imsg rpc` here
+ * so a stray unit test can never shell out to the binary — tests must inject a
+ * mock {@link IMessageRpcLike} on the seam instead.
+ */
+export function isTestEnv() {
+    if (process.env.NODE_ENV === "test")
+        return true;
+    const vitest = (process.env.VITEST ?? "").trim().toLowerCase();
+    return Boolean(vitest);
+}
+/** Expand a leading `~` to the user's home dir. */
+function expandUserPath(p) {
+    const trimmed = p.trim();
+    if (trimmed === "~")
+        return os.homedir();
+    if (trimmed.startsWith("~/") || trimmed.startsWith("~\\")) {
+        return path.join(os.homedir(), trimmed.slice(2));
+    }
+    return trimmed;
+}
+function formatErr(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/**
+ * Long-lived JSON-RPC 2.0 client over an `imsg rpc` child process. A pending-id
+ * map matches responses; an `onNotification` callback fans out inbound events;
+ * `failAll` rejects every in-flight request when the child errors or closes.
+ */
+export class IMessageRpcClient {
+    cliPath;
+    dbPath;
+    runtime;
+    onNotification;
+    pending = new Map();
+    closed;
+    closedResolve = null;
+    child = null;
+    reader = null;
+    nextId = 1;
+    constructor(opts = {}) {
+        this.cliPath = opts.cliPath?.trim() || "imsg";
+        this.dbPath = opts.dbPath?.trim() ? expandUserPath(opts.dbPath) : undefined;
+        this.runtime = opts.runtime;
+        this.onNotification = opts.onNotification;
+        this.closed = new Promise((resolve) => {
+            this.closedResolve = resolve;
+        });
+    }
+    /** Spawn the child + wire stdout (responses/notifications) and stderr (logs). Idempotent. */
+    async start() {
+        if (this.child)
+            return;
+        if (isTestEnv()) {
+            throw new Error("Refusing to start imsg rpc in test environment; inject a mock iMessage RPC client");
+        }
+        const args = ["rpc"];
+        if (this.dbPath)
+            args.push("--db", this.dbPath);
+        const child = spawn(this.cliPath, args, { stdio: ["pipe", "pipe", "pipe"] });
+        this.child = child;
+        this.reader = createInterface({ input: child.stdout });
+        this.reader.on("line", (line) => {
+            const trimmed = line.trim();
+            if (!trimmed)
+                return;
+            this.handleLine(trimmed);
+        });
+        child.stderr.on("data", (chunk) => {
+            for (const line of chunk.toString("utf8").split(/\r?\n/)) {
+                const t = line.trim();
+                if (t)
+                    this.runtime?.error?.(`imsg rpc: ${t}`);
+            }
+        });
+        child.on("error", (err) => {
+            this.failAll(err instanceof Error ? err : new Error(formatErr(err)));
+            this.closedResolve?.();
+        });
+        child.on("close", (code, signal) => {
+            if (code !== 0 && code !== null) {
+                const reason = signal ? `signal ${signal}` : `code ${code}`;
+                this.failAll(new Error(`imsg rpc exited (${reason})`));
+            }
+            else {
+                this.failAll(new Error("imsg rpc closed"));
+            }
+            this.closedResolve?.();
+        });
+    }
+    /** Gracefully end stdin, then SIGTERM after a 500ms grace if still alive. */
+    async stop() {
+        const child = this.child;
+        if (!child)
+            return;
+        this.reader?.close();
+        this.reader = null;
+        try {
+            child.stdin?.end();
+        }
+        catch {
+            /* best-effort */
+        }
+        this.child = null;
+        await Promise.race([
+            this.closed,
+            new Promise((resolve) => {
+                const t = setTimeout(() => {
+                    if (!child.killed) {
+                        try {
+                            child.kill("SIGTERM");
+                        }
+                        catch {
+                            /* best-effort */
+                        }
+                    }
+                    resolve();
+                }, 500);
+                if (typeof t.unref === "function")
+                    t.unref();
+            }),
+        ]);
+    }
+    /** Resolves when the child has errored or closed. */
+    async waitForClose() {
+        await this.closed;
+    }
+    /** Issue a JSON-RPC request and await its matching response (10s default timeout). */
+    async request(method, params, opts) {
+        if (!this.child || !this.child.stdin)
+            throw new Error("imsg rpc not running");
+        const id = this.nextId++;
+        const payload = { jsonrpc: "2.0", id, method, params: params ?? {} };
+        const line = `${JSON.stringify(payload)}\n`;
+        const timeoutMs = opts?.timeoutMs ?? DEFAULT_IMESSAGE_PROBE_TIMEOUT_MS;
+        const response = new Promise((resolve, reject) => {
+            const key = String(id);
+            const timer = timeoutMs > 0
+                ? setTimeout(() => {
+                    this.pending.delete(key);
+                    reject(new Error(`imsg rpc timeout (${method})`));
+                }, timeoutMs)
+                : undefined;
+            if (timer && typeof timer.unref === "function") {
+                timer.unref();
+            }
+            this.pending.set(key, { resolve: (v) => resolve(v), reject, timer });
+        });
+        this.child.stdin.write(line);
+        return await response;
+    }
+    /** Parse one stdout line: a non-null `id` is a response, a bare `method` is a notification. */
+    handleLine(line) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch (err) {
+            this.runtime?.error?.(`imsg rpc: failed to parse ${line}: ${formatErr(err)}`);
+            return;
+        }
+        if (parsed.id !== undefined && parsed.id !== null) {
+            const key = String(parsed.id);
+            const pending = this.pending.get(key);
+            if (!pending)
+                return;
+            if (pending.timer)
+                clearTimeout(pending.timer);
+            this.pending.delete(key);
+            if (parsed.error) {
+                const baseMessage = parsed.error.message ?? "imsg rpc error";
+                const details = parsed.error.data;
+                const code = parsed.error.code;
+                const suffixes = [];
+                if (typeof code === "number")
+                    suffixes.push(`code=${code}`);
+                if (details !== undefined) {
+                    const detailText = typeof details === "string" ? details : JSON.stringify(details);
+                    if (detailText)
+                        suffixes.push(detailText);
+                }
+                const msg = suffixes.length > 0 ? `${baseMessage}: ${suffixes.join(" ")}` : baseMessage;
+                pending.reject(new Error(msg));
+                return;
+            }
+            pending.resolve(parsed.result);
+            return;
+        }
+        if (parsed.method) {
+            this.onNotification?.({ method: parsed.method, params: parsed.params });
+        }
+    }
+    /** Reject every in-flight request with `err` and clear their timers. */
+    failAll(err) {
+        for (const [, pending] of this.pending) {
+            if (pending.timer)
+                clearTimeout(pending.timer);
+            pending.reject(err);
+        }
+        this.pending.clear();
+    }
+}
+/** Construct + start a real RPC client. */
+export async function createIMessageRpcClient(opts = {}) {
+    const client = new IMessageRpcClient(opts);
+    await client.start();
+    return client;
+}
+//# sourceMappingURL=client.js.map

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

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