Documentation / @agentick/connector-imessage / IMessageDB
Class: IMessageDB
Defined in: imessage-db.ts:22
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.
Constructors
Constructor
new IMessageDB(
handle,dbPath?):IMessageDB
Defined in: imessage-db.ts:28
Parameters
handle
string
dbPath?
string
Returns
IMessageDB
Methods
close()
close():
void
Defined in: imessage-db.ts:39
Returns
void
open()
open():
void
Defined in: imessage-db.ts:33
Returns
void
poll()
poll():
IMessageRow[]
Defined in: imessage-db.ts:48
Poll for new incoming messages from the configured handle. Returns messages with ROWID > watermark, then advances watermark.