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.