@agentick/connector-imessage 0.5.0

package/README.md

@@ -0,0 +1,96 @@
+# @agentick/connector-imessage
+
+iMessage platform adapter for the Agentick connector system. macOS only.
+
+Polls `~/Library/Messages/chat.db` for incoming messages and sends responses
+via AppleScript through Messages.app.
+
+## Install
+
+```sh
+pnpm add @agentick/connector-imessage
+```
+
+Requires Node 22+ (`node:sqlite` built-in).
+
+## Prerequisites
+
+Grant **Full Disk Access** to your terminal application in System Settings >
+Privacy & Security > Full Disk Access. Without this, the agent cannot read
+`chat.db`.
+
+## Usage
+
+```typescript
+import { createConnector } from "@agentick/connector";
+import { IMessagePlatform } from "@agentick/connector-imessage";
+
+const connector = createConnector(
+  client,
+  new IMessagePlatform({
+    handle: "+15551234567",
+  }),
+  {
+    sessionId: "main",
+    contentPolicy: "summarized",
+    deliveryStrategy: "on-idle",
+  },
+);
+
+await connector.start();
+```
+
+## Options
+
+```typescript
+interface IMessageConnectorOptions {
+  handle: string;
+  pollIntervalMs?: number;
+  sendDelay?: number;
+  dbPath?: string;
+}
+```
+
+**`handle`** — Phone number (with country code) or email address to watch.
+
+**`pollIntervalMs`** — How often to poll `chat.db`. Default: 2000ms.
+
+**`sendDelay`** — Delay between sending multiple messages to avoid rate
+limiting by Messages.app. Default: 500ms.
+
+**`dbPath`** — Custom path to `chat.db` (for testing).
+
+## How It Works
+
+**Inbound**: Polls `chat.db` using `node:sqlite`. Tracks a ROWID watermark so
+each poll only returns new messages. Filters by handle and `is_from_me = 0`.
+Poll errors (e.g., `SQLITE_BUSY` when Messages.app holds a lock) are caught
+and retried on the next interval.
+
+**Outbound**: Sends via `osascript` driving Messages.app. Text is escaped to
+prevent AppleScript injection.
+
+**Confirmations**: Text-based only. Sends a prompt like "Allow shell to
+execute? Reply yes/no" and parses the next inbound message as the response.
+Natural language is supported — "yes but only in /tmp" is approved with the
+full text as reason.
+
+## Recommended Config
+
+```typescript
+{
+  contentPolicy: "summarized",   // clean summaries, no raw tool blocks
+  deliveryStrategy: "on-idle",   // one polished message per execution
+}
+```
+
+iMessage works best with `"on-idle"` delivery — one complete, well-composed
+message rather than a stream of fragments.
+
+## Exports
+
+```typescript
+export { IMessagePlatform, type IMessageConnectorOptions } from "./imessage-platform.js";
+export { IMessageDB, type IMessageRow } from "./imessage-db.js";
+export { sendIMessage, buildAppleScript } from "./imessage-send.js";
+```

package/dist/imessage-db.d.ts

@@ -0,0 +1,32 @@
+export interface IMessageRow {
+    rowid: number;
+    text: string;
+    date: number;
+    is_from_me: number;
+    handle_id: string;
+}
+/**
+ * Polls the iMessage chat.db for new incoming messages.
+ *
+ * Uses node:sqlite (Node 22+) to read the Messages database directly.
+ * Tracks a ROWID watermark so each poll only returns new messages.
+ *
+ * Requires Full Disk Access in System Settings > Privacy & Security
+ * for the terminal application running the agent.
+ */
+export declare class IMessageDB {
+    private _db;
+    private _watermark;
+    private readonly _handle;
+    private readonly _dbPath;
+    constructor(handle: string, dbPath?: string);
+    open(): void;
+    close(): void;
+    /**
+     * Poll for new incoming messages from the configured handle.
+     * Returns messages with ROWID > watermark, then advances watermark.
+     */
+    poll(): IMessageRow[];
+    private _getMaxRowId;
+}
+//# sourceMappingURL=imessage-db.d.ts.map

package/dist/imessage-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imessage-db.d.ts","sourceRoot":"","sources":["../src/imessage-db.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAA6B;IACxC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAK3C,IAAI,IAAI,IAAI;IAMZ,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,IAAI,IAAI,WAAW,EAAE;IA6BrB,OAAO,CAAC,YAAY;CAMrB"}

package/dist/imessage-db.js

@@ -0,0 +1,68 @@
+import { DatabaseSync } from "node:sqlite";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * Polls the iMessage chat.db for new incoming messages.
+ *
+ * Uses node:sqlite (Node 22+) to read the Messages database directly.
+ * Tracks a ROWID watermark so each poll only returns new messages.
+ *
+ * Requires Full Disk Access in System Settings > Privacy & Security
+ * for the terminal application running the agent.
+ */
+export class IMessageDB {
+    _db = null;
+    _watermark = 0;
+    _handle;
+    _dbPath;
+    constructor(handle, dbPath) {
+        this._handle = handle;
+        this._dbPath = dbPath ?? join(homedir(), "Library/Messages/chat.db");
+    }
+    open() {
+        this._db = new DatabaseSync(this._dbPath, { open: true, readOnly: true });
+        // Initialize watermark to current max ROWID so we only get new messages
+        this._watermark = this._getMaxRowId();
+    }
+    close() {
+        this._db?.close();
+        this._db = null;
+    }
+    /**
+     * Poll for new incoming messages from the configured handle.
+     * Returns messages with ROWID > watermark, then advances watermark.
+     */
+    poll() {
+        if (!this._db)
+            return [];
+        const stmt = this._db.prepare(`
+      SELECT
+        m.ROWID as rowid,
+        m.text as text,
+        m.date as date,
+        m.is_from_me as is_from_me,
+        h.id as handle_id
+      FROM message m
+      JOIN handle h ON m.handle_id = h.ROWID
+      WHERE h.id = ?
+        AND m.ROWID > ?
+        AND m.is_from_me = 0
+        AND m.text IS NOT NULL
+        AND m.text != ''
+      ORDER BY m.ROWID ASC
+    `);
+        const rows = stmt.all(this._handle, this._watermark);
+        if (rows.length > 0) {
+            this._watermark = rows[rows.length - 1].rowid;
+        }
+        return rows;
+    }
+    _getMaxRowId() {
+        if (!this._db)
+            return 0;
+        const stmt = this._db.prepare("SELECT MAX(ROWID) as max_id FROM message");
+        const result = stmt.get();
+        return result?.max_id ?? 0;
+    }
+}
+//# sourceMappingURL=imessage-db.js.map

package/dist/imessage-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imessage-db.js","sourceRoot":"","sources":["../src/imessage-db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAUjC;;;;;;;;GAQG;AACH,MAAM,OAAO,UAAU;IACb,GAAG,GAAwB,IAAI,CAAC;IAChC,UAAU,GAAG,CAAC,CAAC;IACN,OAAO,CAAS;IAChB,OAAO,CAAS;IAEjC,YAAY,MAAc,EAAE,MAAe;QACzC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,0BAA0B,CAAC,CAAC;IACvE,CAAC;IAED,IAAI;QACF,IAAI,CAAC,GAAG,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAS,CAAC,CAAC;QACjF,wEAAwE;QACxE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IACxC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QAEzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;KAe7B,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAA6B,CAAC;QAEjF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;QAChD,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAA2C,CAAC;QACnE,OAAO,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/dist/imessage-platform.d.ts

@@ -0,0 +1,43 @@
+import type { ConnectorPlatform, ConnectorBridge, ConnectorStatus } from "@agentick/connector";
+export interface IMessageConnectorOptions {
+    /** Phone number or email to watch for messages. */
+    handle: string;
+    /** How often to poll chat.db, in milliseconds. Default: 2000. */
+    pollIntervalMs?: number;
+    /** Delay between sending multiple messages, in milliseconds. Default: 500. */
+    sendDelay?: number;
+    /** Custom path to chat.db (for testing). */
+    dbPath?: string;
+}
+/**
+ * iMessage platform adapter for the Agentick connector system.
+ * macOS only.
+ *
+ * Polls ~/Library/Messages/chat.db for incoming messages and sends
+ * responses via AppleScript -> Messages.app.
+ *
+ * Recommended config:
+ * - deliveryStrategy: "on-idle"
+ * - contentPolicy: "summarized"
+ * - renderMode: "message"
+ */
+export declare class IMessagePlatform implements ConnectorPlatform {
+    private readonly _handle;
+    private readonly _pollIntervalMs;
+    private readonly _sendDelay;
+    private readonly _dbPath?;
+    private _db;
+    private _pollTimer;
+    private _bridge;
+    private _status;
+    private _pendingConfirmation;
+    constructor(options: IMessageConnectorOptions);
+    get status(): ConnectorStatus;
+    start(bridge: ConnectorBridge): Promise<void>;
+    stop(): Promise<void>;
+    private _scheduleNextPoll;
+    private _poll;
+    private _handleDelivery;
+    private _handleConfirmation;
+}
+//# sourceMappingURL=imessage-platform.d.ts.map

package/dist/imessage-platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imessage-platform.d.ts","sourceRoot":"","sources":["../src/imessage-platform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EAEf,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAElC,OAAO,CAAC,GAAG,CAA2B;IACtC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,OAAO,CAAmC;IAElD,OAAO,CAAC,oBAAoB,CAEZ;gBAEJ,OAAO,EAAE,wBAAwB;IAO7C,IAAI,MAAM,IAAI,eAAe,CAE5B;IAEK,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,KAAK;YA0BC,eAAe;YAaf,mBAAmB;CASlC"}

package/dist/imessage-platform.js

@@ -0,0 +1,115 @@
+import { extractText, parseTextConfirmation, formatConfirmationMessage } from "@agentick/connector";
+import { IMessageDB } from "./imessage-db.js";
+import { sendIMessage } from "./imessage-send.js";
+/**
+ * iMessage platform adapter for the Agentick connector system.
+ * macOS only.
+ *
+ * Polls ~/Library/Messages/chat.db for incoming messages and sends
+ * responses via AppleScript -> Messages.app.
+ *
+ * Recommended config:
+ * - deliveryStrategy: "on-idle"
+ * - contentPolicy: "summarized"
+ * - renderMode: "message"
+ */
+export class IMessagePlatform {
+    _handle;
+    _pollIntervalMs;
+    _sendDelay;
+    _dbPath;
+    _db = null;
+    _pollTimer = null;
+    _bridge = null;
+    _status = "disconnected";
+    _pendingConfirmation = null;
+    constructor(options) {
+        this._handle = options.handle;
+        this._pollIntervalMs = options.pollIntervalMs ?? 2000;
+        this._sendDelay = options.sendDelay ?? 500;
+        this._dbPath = options.dbPath;
+    }
+    get status() {
+        return this._status;
+    }
+    async start(bridge) {
+        this._bridge = bridge;
+        this._status = "connecting";
+        bridge.reportStatus("connecting");
+        this._db = new IMessageDB(this._handle, this._dbPath);
+        this._db.open();
+        bridge.onDeliver((output) => {
+            return this._handleDelivery(output);
+        });
+        bridge.onConfirmation((request, respond) => {
+            this._handleConfirmation(request, respond).catch((err) => {
+                console.error("iMessage confirmation error:", err);
+            });
+        });
+        this._status = "connected";
+        bridge.reportStatus("connected");
+        this._scheduleNextPoll();
+    }
+    async stop() {
+        if (this._pollTimer) {
+            clearTimeout(this._pollTimer);
+            this._pollTimer = null;
+        }
+        this._db?.close();
+        this._db = null;
+        this._bridge = null;
+        this._status = "disconnected";
+        this._pendingConfirmation = null;
+    }
+    // --- Private ---
+    _scheduleNextPoll() {
+        this._pollTimer = setTimeout(() => {
+            this._poll();
+            if (this._bridge)
+                this._scheduleNextPoll();
+        }, this._pollIntervalMs);
+    }
+    _poll() {
+        if (!this._db || !this._bridge)
+            return;
+        let messages;
+        try {
+            messages = this._db.poll();
+        }
+        catch (err) {
+            // chat.db may be locked by Messages.app — log and retry next interval
+            console.error("iMessage poll error (will retry):", err);
+            return;
+        }
+        for (const msg of messages) {
+            const text = msg.text;
+            if (this._pendingConfirmation) {
+                const { respond } = this._pendingConfirmation;
+                this._pendingConfirmation = null;
+                respond(parseTextConfirmation(text));
+                continue;
+            }
+            this._bridge.send(text);
+        }
+    }
+    async _handleDelivery(output) {
+        for (const message of output.messages) {
+            const text = extractText(message.content, "\n\n");
+            if (!text)
+                continue;
+            await sendIMessage(this._handle, text);
+            if (this._sendDelay > 0) {
+                await sleep(this._sendDelay);
+            }
+        }
+    }
+    async _handleConfirmation(request, respond) {
+        this._pendingConfirmation = { respond };
+        const msg = formatConfirmationMessage(request);
+        await sendIMessage(this._handle, `${msg}\n\nReply yes/no (or explain what you'd like instead)`);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=imessage-platform.js.map

package/dist/imessage-platform.js.map

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

package/dist/imessage-send.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Send an iMessage via AppleScript.
+ *
+ * Uses `osascript` to drive Messages.app. The handle can be a phone
+ * number (with country code) or an email address.
+ */
+export declare function sendIMessage(handle: string, text: string): Promise<void>;
+/**
+ * Build the AppleScript to send an iMessage.
+ *
+ * The message text is escaped to prevent AppleScript injection:
+ * - Backslashes are doubled
+ * - Double quotes are escaped
+ */
+export declare function buildAppleScript(handle: string, text: string): string;
+//# sourceMappingURL=imessage-send.d.ts.map

package/dist/imessage-send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imessage-send.d.ts","sourceRoot":"","sources":["../src/imessage-send.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYxE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAWrE"}

package/dist/imessage-send.js

@@ -0,0 +1,39 @@
+import { execFile } from "node:child_process";
+/**
+ * Send an iMessage via AppleScript.
+ *
+ * Uses `osascript` to drive Messages.app. The handle can be a phone
+ * number (with country code) or an email address.
+ */
+export function sendIMessage(handle, text) {
+    return new Promise((resolve, reject) => {
+        const script = buildAppleScript(handle, text);
+        execFile("osascript", ["-e", script], (error, _stdout, stderr) => {
+            if (error) {
+                reject(new Error(`Failed to send iMessage: ${stderr || error.message}`));
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+/**
+ * Build the AppleScript to send an iMessage.
+ *
+ * The message text is escaped to prevent AppleScript injection:
+ * - Backslashes are doubled
+ * - Double quotes are escaped
+ */
+export function buildAppleScript(handle, text) {
+    const escapedText = text.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    const escapedHandle = handle.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    return [
+        'tell application "Messages"',
+        "  set targetService to 1st service whose service type = iMessage",
+        `  set targetBuddy to buddy "${escapedHandle}" of targetService`,
+        `  send "${escapedText}" to targetBuddy`,
+        "end tell",
+    ].join("\n");
+}
+//# sourceMappingURL=imessage-send.js.map

package/dist/imessage-send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imessage-send.js","sourceRoot":"","sources":["../src/imessage-send.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,IAAY;IACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAE9C,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;YAC/D,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,IAAY;IAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrE,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAEzE,OAAO;QACL,6BAA6B;QAC7B,kEAAkE;QAClE,+BAA+B,aAAa,oBAAoB;QAChE,WAAW,WAAW,kBAAkB;QACxC,UAAU;KACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { IMessagePlatform, type IMessageConnectorOptions } from "./imessage-platform.js";
+export { IMessageDB, type IMessageRow } from "./imessage-db.js";
+export { sendIMessage, buildAppleScript } from "./imessage-send.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEzF,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { IMessagePlatform } from "./imessage-platform.js";
+export { IMessageDB } from "./imessage-db.js";
+export { sendIMessage, buildAppleScript } from "./imessage-send.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAiC,MAAM,wBAAwB,CAAC;AAEzF,OAAO,EAAE,UAAU,EAAoB,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@agentick/connector-imessage",
+  "version": "0.5.0",
+  "description": "iMessage connector for Agentick — bridge iMessage to agent sessions (macOS only)",
+  "keywords": [
+    "agent",
+    "ai",
+    "connector",
+    "imessage",
+    "macos"
+  ],
+  "license": "MIT",
+  "author": "Ryan Lindgren",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agenticklabs/agentick.git",
+    "directory": "packages/connector-imessage"
+  },
+  "files": [
+    "dist"
+  ],
+  "os": [
+    "darwin"
+  ],
+  "type": "module",
+  "main": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      }
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "echo \"Tests run from workspace root\"",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "lint": "oxlint src/",
+    "format:check": "oxfmt --check src/",
+    "clean": "rm -rf dist tsconfig.build.tsbuildinfo",
+    "prepublishOnly": "pnpm build",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@agentick/connector": "workspace:*",
+    "@agentick/shared": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export { IMessagePlatform, type IMessageConnectorOptions } from "./imessage-platform.js";
+
+export { IMessageDB, type IMessageRow } from "./imessage-db.js";
+export { sendIMessage, buildAppleScript } from "./imessage-send.js";