@elizaos/agent 2.0.0-alpha.344 → 2.0.0-alpha.346

package/packages/typescript/src/utils/context-routing.js

@@ -1,4 +1,5 @@
 import { resolveActionContexts, resolveProviderContexts, } from "./context-catalog";
+import { normalizeUserMessageText } from "./message-text";
 export const AVAILABLE_CONTEXTS_STATE_KEY = "availableContexts";
 export const CONTEXT_ROUTING_METADATA_KEY = "__responseContext";
 export const CONTEXT_ROUTING_STATE_KEY = "__contextRouting";
@@ -107,6 +108,9 @@ export function getActiveRoutingContexts(routing) {
     contextSet.add("general");
     return Array.from(contextSet);
 }
+export function getActiveRoutingContextsForTurn(state, message) {
+    return getActiveRoutingContexts(mergeContextRouting(state, message));
+}
 export function shouldIncludeByContext(declaredContexts, activeContexts) {
     if (!declaredContexts || declaredContexts.length === 0) {
         return true;
@@ -152,6 +156,90 @@ export function deriveAvailableContexts(actions, providers) {
     }
     return Array.from(contextSet).sort((a, b) => `${a}`.localeCompare(`${b}`));
 }
+const CONTEXT_SIGNALS = [
+    {
+        context: "code",
+        patterns: [
+            /\b(repo|repository|codebase|branch|commit|pull request|pr|diff|workspace|file|directory)\b/u,
+            /\b(code|coding|implement|debug|fix|refactor|patch|test|typecheck|lint|build|component|api|server|client)\b/u,
+            /\b(task agents?|sub-?agents?|coding agents?|codex|claude code|spawn an? agent|agent running|what are you working on)\b/u,
+        ],
+    },
+    {
+        context: "automation",
+        patterns: [
+            /\b(schedule|remind|reminder|cron|workflow|automate|automation|run this|execute|deploy|release|monitor)\b/u,
+            /\b(task agents?|sub-?agents?|agent running|pause that|resume that|stop that|continue that|what are you working on)\b/u,
+        ],
+    },
+    {
+        context: "knowledge",
+        patterns: [
+            /\b(uploaded|document|file|pdf|knowledge|remember|recall|search|lookup|find|summari[sz]e|analy[sz]e|research)\b/u,
+            /\b(what is|what was|where is|tell me about|explain)\b/u,
+        ],
+    },
+    {
+        context: "browser",
+        patterns: [
+            /\b(browser|browse|website|web page|url|click|type into|screenshot|navigate|extract page)\b/u,
+        ],
+    },
+    {
+        context: "media",
+        patterns: [
+            /\b(image|picture|photo|video|audio|voice|transcribe|screenshot|draw|generate an image)\b/u,
+        ],
+    },
+    {
+        context: "wallet",
+        patterns: [
+            /\b(wallet|token|swap|bridge|stake|unstake|balance|portfolio|transaction|sign message|contract)\b/u,
+        ],
+    },
+    {
+        context: "social",
+        patterns: [
+            /\b(message|dm|email|inbox|contact|relationship|follow up|calendar|meeting|call|send .* to)\b/u,
+        ],
+    },
+    {
+        context: "system",
+        patterns: [
+            /\b(settings?|configure|configuration|plugin|secret|api key|model provider|oauth|login|auth)\b/u,
+        ],
+    },
+];
+export function inferContextRoutingFromText(text) {
+    const normalized = normalizeUserMessageText({
+        content: { text: text ?? "" },
+    });
+    if (!normalized) {
+        return { primaryContext: "general", secondaryContexts: [] };
+    }
+    const scored = CONTEXT_SIGNALS.map((signal) => ({
+        context: signal.context,
+        score: signal.patterns.reduce((score, pattern) => score + (pattern.test(normalized) ? 1 : 0), 0),
+    }))
+        .filter((entry) => entry.score > 0)
+        .sort((left, right) => right.score - left.score);
+    if (scored.length === 0) {
+        return { primaryContext: "general", secondaryContexts: [] };
+    }
+    const primaryContext = scored[0].context;
+    const secondaryContexts = scored
+        .slice(1)
+        .filter((entry) => entry.score >= Math.max(1, scored[0].score - 1))
+        .map((entry) => entry.context);
+    return { primaryContext, secondaryContexts };
+}
+export function inferContextRoutingFromMessage(message) {
+    return inferContextRoutingFromText(typeof message.content === "string"
+        ? message.content
+        : typeof message.content?.text === "string"
+            ? message.content.text
+            : "");
+}
 export function attachAvailableContexts(state, runtime) {
     const availableContexts = deriveAvailableContexts(runtime.actions, runtime.providers);
     return {

package/packages/typescript/src/utils/message-text.d.ts

@@ -0,0 +1,5 @@
+import type { Memory } from "../types/memory";
+export declare function extractUserText(raw: string): string;
+export declare function getUserMessageText(message: Pick<Memory, "content"> | null | undefined): string;
+export declare function normalizeUserMessageText(message: Pick<Memory, "content"> | null | undefined): string;
+//# sourceMappingURL=message-text.d.ts.map

package/packages/typescript/src/utils/message-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-text.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/utils/message-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAO9C,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,MAAM,CAQR;AAED,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,MAAM,CAER"}

package/packages/typescript/src/utils/message-text.js

@@ -0,0 +1,24 @@
+const KNOWLEDGE_AUGMENTATION_PREFIX = "Answer the user request using the contextual knowledge";
+const USER_REQUEST_WRAPPER = /<user_request>\s*([\s\S]*?)\s*<\/user_request>/i;
+const LANGUAGE_INSTRUCTION_SUFFIX = /\n*\[language instruction:[^\]]*\]\s*$/i;
+export function extractUserText(raw) {
+    let text = raw;
+    if (text.trimStart().startsWith(KNOWLEDGE_AUGMENTATION_PREFIX)) {
+        const match = text.match(USER_REQUEST_WRAPPER);
+        if (match?.[1]) {
+            text = match[1];
+        }
+    }
+    return text.replace(LANGUAGE_INSTRUCTION_SUFFIX, "").trim();
+}
+export function getUserMessageText(message) {
+    const raw = typeof message?.content === "string"
+        ? message.content
+        : typeof message?.content?.text === "string"
+            ? message.content.text
+            : "";
+    return extractUserText(raw);
+}
+export function normalizeUserMessageText(message) {
+    return getUserMessageText(message).toLowerCase().replace(/\s+/g, " ").trim();
+}

package/packages/typescript/src/utils.d.ts

@@ -185,8 +185,9 @@ export declare function stringToUuid(target: string | number): UUID;
  */
 export declare function prewarmUuidCache(values: string[]): Promise<void>;
 export declare const getContentTypeFromMimeType: (mimeType: string) => ContentType | undefined;
-export { AVAILABLE_CONTEXTS_STATE_KEY, attachAvailableContexts, CONTEXT_ROUTING_METADATA_KEY, CONTEXT_ROUTING_STATE_KEY, type ContextRoutingDecision, deriveAvailableContexts, getActiveRoutingContexts, getContextRoutingFromMessage, getContextRoutingFromState, mergeContextRouting, parseContextList, parseContextRoutingMetadata, setContextRoutingMetadata, shouldIncludeByContext, } from "./utils/context-routing";
+export { AVAILABLE_CONTEXTS_STATE_KEY, attachAvailableContexts, CONTEXT_ROUTING_METADATA_KEY, CONTEXT_ROUTING_STATE_KEY, type ContextRoutingDecision, deriveAvailableContexts, getActiveRoutingContexts, getActiveRoutingContextsForTurn, getContextRoutingFromMessage, getContextRoutingFromState, inferContextRoutingFromMessage, inferContextRoutingFromText, mergeContextRouting, parseContextList, parseContextRoutingMetadata, setContextRoutingMetadata, shouldIncludeByContext, } from "./utils/context-routing";
 export { extractAndParseJSONObjectFromText } from "./utils/json-llm";
+export { extractUserText, getUserMessageText, normalizeUserMessageText, } from "./utils/message-text";
 export { getLocalServerUrl } from "./utils/node";
 export { extractFirstSentence, hasFirstSentence } from "./utils/text-splitting";
 //# sourceMappingURL=utils.d.ts.map

package/packages/typescript/src/utils.d.ts.map

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

package/packages/typescript/src/utils.js

@@ -1111,8 +1111,9 @@ export const getContentTypeFromMimeType = (mimeType) => {
     }
     return undefined;
 };
-export { AVAILABLE_CONTEXTS_STATE_KEY, attachAvailableContexts, CONTEXT_ROUTING_METADATA_KEY, CONTEXT_ROUTING_STATE_KEY, deriveAvailableContexts, getActiveRoutingContexts, getContextRoutingFromMessage, getContextRoutingFromState, mergeContextRouting, parseContextList, parseContextRoutingMetadata, setContextRoutingMetadata, shouldIncludeByContext, } from "./utils/context-routing";
+export { AVAILABLE_CONTEXTS_STATE_KEY, attachAvailableContexts, CONTEXT_ROUTING_METADATA_KEY, CONTEXT_ROUTING_STATE_KEY, deriveAvailableContexts, getActiveRoutingContexts, getActiveRoutingContextsForTurn, getContextRoutingFromMessage, getContextRoutingFromState, inferContextRoutingFromMessage, inferContextRoutingFromText, mergeContextRouting, parseContextList, parseContextRoutingMetadata, setContextRoutingMetadata, shouldIncludeByContext, } from "./utils/context-routing";
 export { extractAndParseJSONObjectFromText } from "./utils/json-llm";
+export { extractUserText, getUserMessageText, normalizeUserMessageText, } from "./utils/message-text";
 // `export * from "./utils"` (in index.node.ts etc.) resolves to this file, not
 // to a `./utils/index.ts`. Any helper in the `utils/` directory that needs to be
 // reachable from `@elizaos/core` must be re-exported here.

package/plugins/plugin-imessage/typescript/src/chatdb-reader.d.ts

@@ -197,6 +197,15 @@ export interface ChatDbReader {
      * local Apple account, converted to JavaScript epoch milliseconds.
      */
     getLatestOwnMessageTimestamp(): number | null;
+    /**
+     * Return the newest messages in chronological order, optionally scoped
+     * to a single chat identifier. Unlike `fetchNewMessages`, this is for
+     * ad-hoc inspection and UI reads rather than cursor-based polling.
+     */
+    listMessages(options?: {
+        chatId?: string;
+        limit?: number;
+    }): ChatDbMessage[];
     /**
      * List every chat the database knows about, joined with participant
      * handles. Reads from `chat`, `chat_handle_join`, and `handle`. This

package/plugins/plugin-imessage/typescript/src/chatdb-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chatdb-reader.d.ts","sourceRoot":"","sources":["../../../../../../../plugins/plugin-imessage/typescript/src/chatdb-reader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chatdb-reader.d.ts","sourceRoot":"","sources":["../../../../../../../plugins/plugin-imessage/typescript/src/chatdb-reader.ts"],"names":[],"mappings":"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"}

package/plugins/plugin-imessage/typescript/src/chatdb-reader.js

@@ -380,6 +380,73 @@ export async function openChatDb(dbPath = DEFAULT_CHAT_DB_PATH) {
     // Used once on service start to seed the polling cursor.
     const tipStmt = db.query("SELECT MAX(ROWID) AS max_row_id FROM message");
     const latestOwnMessageStmt = db.query("SELECT MAX(date) AS max_apple_date FROM message WHERE is_from_me = 1");
+    const recentMessagesStmt = db.query(`
+    SELECT
+      m.ROWID AS row_id,
+      m.guid AS guid,
+      m.text AS text,
+      m.attributedBody AS attributed_body,
+      m.date AS apple_date,
+      m.date_read AS apple_date_read,
+      m.date_edited AS apple_date_edited,
+      m.date_retracted AS apple_date_retracted,
+      m.is_from_me AS is_from_me,
+      m.is_read AS is_read,
+      m.is_sent AS is_sent,
+      m.is_delivered AS is_delivered,
+      m.item_type AS item_type,
+      m.reply_to_guid AS reply_to_guid,
+      m.associated_message_guid AS associated_message_guid,
+      m.associated_message_type AS associated_message_type,
+      m.associated_message_emoji AS associated_message_emoji,
+      m.cache_has_attachments AS cache_has_attachments,
+      m.service AS message_service,
+      h.id AS handle,
+      h.service AS handle_service,
+      c.chat_identifier AS chat_identifier,
+      c.display_name AS display_name,
+      c.style AS chat_style
+    FROM message m
+    LEFT JOIN handle h ON m.handle_id = h.ROWID
+    LEFT JOIN chat_message_join cmj ON m.ROWID = cmj.message_id
+    LEFT JOIN chat c ON cmj.chat_id = c.ROWID
+    ORDER BY m.ROWID DESC
+    LIMIT ?
+  `);
+    const recentMessagesByChatStmt = db.query(`
+    SELECT
+      m.ROWID AS row_id,
+      m.guid AS guid,
+      m.text AS text,
+      m.attributedBody AS attributed_body,
+      m.date AS apple_date,
+      m.date_read AS apple_date_read,
+      m.date_edited AS apple_date_edited,
+      m.date_retracted AS apple_date_retracted,
+      m.is_from_me AS is_from_me,
+      m.is_read AS is_read,
+      m.is_sent AS is_sent,
+      m.is_delivered AS is_delivered,
+      m.item_type AS item_type,
+      m.reply_to_guid AS reply_to_guid,
+      m.associated_message_guid AS associated_message_guid,
+      m.associated_message_type AS associated_message_type,
+      m.associated_message_emoji AS associated_message_emoji,
+      m.cache_has_attachments AS cache_has_attachments,
+      m.service AS message_service,
+      h.id AS handle,
+      h.service AS handle_service,
+      c.chat_identifier AS chat_identifier,
+      c.display_name AS display_name,
+      c.style AS chat_style
+    FROM message m
+    LEFT JOIN handle h ON m.handle_id = h.ROWID
+    LEFT JOIN chat_message_join cmj ON m.ROWID = cmj.message_id
+    LEFT JOIN chat c ON cmj.chat_id = c.ROWID
+    WHERE c.chat_identifier = ?
+    ORDER BY m.ROWID DESC
+    LIMIT ?
+  `);
     // List-chats statement: every chat joined to handles via
     // chat_handle_join, grouped so each chat returns one row with an
     // aggregated participant list.
@@ -399,6 +466,88 @@ export async function openChatDb(dbPath = DEFAULT_CHAT_DB_PATH) {
     ORDER BY c.last_read_message_timestamp DESC
   `);
     let closed = false;
+    function materializeMessages(rows) {
+        const out = [];
+        let undecodable = 0;
+        for (const row of rows) {
+            // Resolve the visible text: prefer the plain `text` column, fall
+            // back to decoding `attributedBody`, then empty string.
+            let text = "";
+            if (row.text && row.text.length > 0) {
+                text = row.text;
+            }
+            else if (row.attributed_body) {
+                const decoded = decodeAttributedBody(row.attributed_body);
+                if (decoded != null) {
+                    text = decoded;
+                }
+                else {
+                    undecodable++;
+                }
+            }
+            // Classify the row. Reactions get their own kind + a parsed
+            // reaction payload; system messages (group add/remove/rename)
+            // surface as `"system"` so the caller can log or ignore.
+            const assocType = row.associated_message_type ?? 0;
+            let kind = "text";
+            let reaction = null;
+            if (assocType >= 2000 && assocType < 4000) {
+                kind = "reaction";
+                reaction = parseReaction(row);
+            }
+            else if (row.item_type != null && row.item_type !== 0) {
+                kind = "system";
+            }
+            // Attachments — only fetched when the cache bit indicates any.
+            let attachments = [];
+            if (row.cache_has_attachments === 1) {
+                try {
+                    const attRows = attachmentsStmt.all(row.row_id);
+                    attachments = attRows.map((a) => ({
+                        guid: a.guid,
+                        filename: a.transfer_name ?? a.filename ?? null,
+                        uti: a.uti,
+                        mimeType: a.mime_type,
+                        totalBytes: a.total_bytes,
+                        isSticker: a.is_sticker === 1,
+                    }));
+                }
+                catch (error) {
+                    logger.debug(`[imessage] attachment query failed for rowid=${row.row_id}: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+            // Service resolution: prefer the message row's own service field,
+            // fall back to the handle's service (stable across messages from
+            // the same sender), else unknown.
+            const service = row.message_service ?? row.handle_service ?? null;
+            out.push({
+                rowId: row.row_id,
+                guid: row.guid,
+                text,
+                kind,
+                handle: row.handle ?? "",
+                chatId: row.chat_identifier ?? "",
+                chatType: row.chat_style === 43 ? "group" : "direct",
+                displayName: row.display_name,
+                timestamp: appleDateToJsMs(row.apple_date),
+                isFromMe: row.is_from_me === 1,
+                service,
+                isSent: row.is_sent === 1,
+                isDelivered: row.is_delivered === 1,
+                isRead: row.is_read === 1,
+                dateRead: appleDateToJsMs(row.apple_date_read ?? 0),
+                dateEdited: appleDateToJsMs(row.apple_date_edited ?? 0),
+                dateRetracted: appleDateToJsMs(row.apple_date_retracted ?? 0),
+                replyToGuid: row.reply_to_guid,
+                reaction,
+                attachments,
+            });
+        }
+        if (undecodable > 0) {
+            logger.debug(`[imessage] chat.db poll: ${undecodable} row(s) had attributedBody that could not be decoded; their text is empty`);
+        }
+        return out;
+    }
     return {
         fetchNewMessages(sinceRowId, limit) {
             if (closed)
@@ -411,86 +560,7 @@ export async function openChatDb(dbPath = DEFAULT_CHAT_DB_PATH) {
                 logger.error(`[imessage] chat.db query failed: ${error instanceof Error ? error.message : String(error)}`);
                 return [];
             }
-            const out = [];
-            let undecodable = 0;
-            for (const row of rows) {
-                // Resolve the visible text: prefer the plain `text` column, fall
-                // back to decoding `attributedBody`, then empty string.
-                let text = "";
-                if (row.text && row.text.length > 0) {
-                    text = row.text;
-                }
-                else if (row.attributed_body) {
-                    const decoded = decodeAttributedBody(row.attributed_body);
-                    if (decoded != null) {
-                        text = decoded;
-                    }
-                    else {
-                        undecodable++;
-                    }
-                }
-                // Classify the row. Reactions get their own kind + a parsed
-                // reaction payload; system messages (group add/remove/rename)
-                // surface as `"system"` so the caller can log or ignore.
-                const assocType = row.associated_message_type ?? 0;
-                let kind = "text";
-                let reaction = null;
-                if (assocType >= 2000 && assocType < 4000) {
-                    kind = "reaction";
-                    reaction = parseReaction(row);
-                }
-                else if (row.item_type != null && row.item_type !== 0) {
-                    kind = "system";
-                }
-                // Attachments — only fetched when the cache bit indicates any.
-                let attachments = [];
-                if (row.cache_has_attachments === 1) {
-                    try {
-                        const attRows = attachmentsStmt.all(row.row_id);
-                        attachments = attRows.map((a) => ({
-                            guid: a.guid,
-                            filename: a.transfer_name ?? a.filename ?? null,
-                            uti: a.uti,
-                            mimeType: a.mime_type,
-                            totalBytes: a.total_bytes,
-                            isSticker: a.is_sticker === 1,
-                        }));
-                    }
-                    catch (error) {
-                        logger.debug(`[imessage] attachment query failed for rowid=${row.row_id}: ${error instanceof Error ? error.message : String(error)}`);
-                    }
-                }
-                // Service resolution: prefer the message row's own service field,
-                // fall back to the handle's service (stable across messages from
-                // the same sender), else unknown.
-                const service = row.message_service ?? row.handle_service ?? null;
-                out.push({
-                    rowId: row.row_id,
-                    guid: row.guid,
-                    text,
-                    kind,
-                    handle: row.handle ?? "",
-                    chatId: row.chat_identifier ?? "",
-                    chatType: row.chat_style === 43 ? "group" : "direct",
-                    displayName: row.display_name,
-                    timestamp: appleDateToJsMs(row.apple_date),
-                    isFromMe: row.is_from_me === 1,
-                    service,
-                    isSent: row.is_sent === 1,
-                    isDelivered: row.is_delivered === 1,
-                    isRead: row.is_read === 1,
-                    dateRead: appleDateToJsMs(row.apple_date_read ?? 0),
-                    dateEdited: appleDateToJsMs(row.apple_date_edited ?? 0),
-                    dateRetracted: appleDateToJsMs(row.apple_date_retracted ?? 0),
-                    replyToGuid: row.reply_to_guid,
-                    reaction,
-                    attachments,
-                });
-            }
-            if (undecodable > 0) {
-                logger.debug(`[imessage] chat.db poll: ${undecodable} row(s) had attributedBody that could not be decoded; their text is empty`);
-            }
-            return out;
+            return materializeMessages(rows);
         },
         getLatestRowId() {
             if (closed)
@@ -517,6 +587,27 @@ export async function openChatDb(dbPath = DEFAULT_CHAT_DB_PATH) {
                 return null;
             }
         },
+        listMessages(options = {}) {
+            if (closed)
+                return [];
+            const chatId = options.chatId?.trim();
+            const requestedLimit = typeof options.limit === "number" && Number.isFinite(options.limit) ? options.limit : 50;
+            const limit = Math.max(1, Math.trunc(requestedLimit));
+            let rows;
+            try {
+                rows = chatId
+                    ? recentMessagesByChatStmt.all(chatId, limit)
+                    : recentMessagesStmt.all(limit);
+            }
+            catch (error) {
+                logger.error(`[imessage] chat.db listMessages query failed: ${error instanceof Error ? error.message : String(error)}`);
+                return [];
+            }
+            // Queries run DESC for efficiency on "latest N" reads. Reverse
+            // back to chronological order so API/UI callers can render in the
+            // natural oldest→newest sequence without a second sort.
+            return materializeMessages(rows).reverse();
+        },
         listChats() {
             if (closed)
                 return [];

package/plugins/plugin-imessage/typescript/src/index.d.ts

@@ -9,7 +9,7 @@ import { sendMessage } from "./actions/index.js";
 import { chatContextProvider, contactsProvider } from "./providers/index.js";
 import { chatDbMessageToPublicShape, IMessageService, parseChatsFromAppleScript, parseMessagesFromAppleScript } from "./service.js";
 export { DEFAULT_ACCOUNT_ID, type IMessageAccountConfig, type IMessageGroupConfig, type IMessageMultiAccountConfig, isIMessageMentionRequired, isIMessageUserAllowed, isMultiAccountEnabled, listEnabledIMessageAccounts, listIMessageAccountIds, normalizeAccountId, type ResolvedIMessageAccount, resolveDefaultIMessageAccountId, resolveIMessageAccount, resolveIMessageGroupConfig, } from "./accounts.js";
-export { appleDateToJsMs, type ChatDbMessage, type ChatDbReader, type ChatDbAccessIssue, createFullDiskAccessAction, DEFAULT_CHAT_DB_PATH, getLastChatDbAccessIssue, MACOS_FULL_DISK_ACCESS_SETTINGS_URL, openChatDb, } from "./chatdb-reader.js";
+export { appleDateToJsMs, type ChatDbAccessIssue, type ChatDbMessage, type ChatDbReader, createFullDiskAccessAction, DEFAULT_CHAT_DB_PATH, getLastChatDbAccessIssue, MACOS_FULL_DISK_ACCESS_SETTINGS_URL, openChatDb, } from "./chatdb-reader.js";
 export { addContact, type ContactPatch, type ContactsMap, deleteContact, type FullContact, listAllContacts, loadContacts, type NewContactInput, normalizeContactHandle, parseContactsOutput, type ResolvedContact, updateContact, } from "./contacts-reader.js";
 export { createIMessageRpcClient, DEFAULT_PROBE_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, getChatInfo, getContactInfo, getMessages, type IMessageAttachment, type IMessageChat, type IMessageContact, type IMessageMessage, IMessageRpcClient, type IMessageRpcClientOptions, type IMessageRpcError, type IMessageRpcNotification, type IMessageRpcResponse, listChats, listContacts, probeIMessageRpc, sendIMessageRpc, } from "./rpc.js";
 export * from "./types.js";

package/plugins/plugin-imessage/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../plugins/plugin-imessage/typescript/src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,yBAAyB,EACzB,4BAA4B,EAC7B,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,+BAA+B,EAC/B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,mCAAmC,EACnC,UAAU,GACX,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,aAAa,EACb,KAAK,WAAW,EAChB,eAAe,EACf,YAAY,EACZ,KAAK,eAAe,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,eAAe,EACpB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,WAAW,EACX,cAAc,EACd,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAChB,eAAe,EACf,yBAAyB,EACzB,4BAA4B,EAC5B,WAAW,GACZ,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,cAAc,EAAE,MAiCrB,CAAC;AAEF,eAAe,cAAc,CAAC;AAG9B,YAAY,EACV,cAAc,EACd,gCAAgC,GACjC,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../plugins/plugin-imessage/typescript/src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,yBAAyB,EACzB,4BAA4B,EAC7B,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,+BAA+B,EAC/B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,mCAAmC,EACnC,UAAU,GACX,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,aAAa,EACb,KAAK,WAAW,EAChB,eAAe,EACf,YAAY,EACZ,KAAK,eAAe,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,eAAe,EACpB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,WAAW,EACX,cAAc,EACd,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAChB,eAAe,EACf,yBAAyB,EACzB,4BAA4B,EAC5B,WAAW,GACZ,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,cAAc,EAAE,MAiCrB,CAAC;AAEF,eAAe,cAAc,CAAC;AAG9B,YAAY,EACV,cAAc,EACd,gCAAgC,GACjC,MAAM,aAAa,CAAC"}

package/plugins/plugin-imessage/typescript/src/service.d.ts

@@ -4,7 +4,7 @@
 import { type IAgentRuntime, Service } from "@elizaos/core";
 import { type ChatDbMessage } from "./chatdb-reader.js";
 import { type ContactPatch, type ContactsMap, type FullContact, type NewContactInput } from "./contacts-reader.js";
-import { type IIMessageService, type IMessageChat, type IMessageMessage, type IMessageServiceStatus, type IMessageSendOptions, type IMessageSendResult, type IMessageSettings } from "./types.js";
+import { type IIMessageService, type IMessageChat, type IMessageListMessagesOptions, type IMessageMessage, type IMessageSendOptions, type IMessageSendResult, type IMessageServiceStatus, type IMessageSettings } from "./types.js";
 /**
  * iMessage service for ElizaOS agents.
  * Note: This only works on macOS.
@@ -94,6 +94,12 @@ export declare class IMessageService extends Service implements IIMessageService
      * granted, etc.).
      */
     getRecentMessages(limit?: number): Promise<IMessageMessage[]>;
+    /**
+     * Return the newest messages in chronological order, optionally scoped
+     * to a single chat identifier. Returns an empty array if chat.db is not
+     * available and the connector is currently running in send-only mode.
+     */
+    getMessages(options?: IMessageListMessagesOptions): Promise<IMessageMessage[]>;
     /**
      * List every chat the Messages.app database knows about, joined with
      * participant handles. Returns an empty list if the chat.db reader is

package/plugins/plugin-imessage/typescript/src/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../../plugins/plugin-imessage/typescript/src/service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../../plugins/plugin-imessage/typescript/src/service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAQL,KAAK,aAAa,EAIlB,OAAO,EACR,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,WAAW,EAEhB,KAAK,WAAW,EAGhB,KAAK,eAAe,EAGrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,gBAAgB,EAErB,KAAK,YAAY,EAKjB,KAAK,2BAA2B,EAChC,KAAK,eAAe,EAEpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EAGtB,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,OAAQ,YAAW,gBAAgB;IACtE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAyB;IAEnD,qBAAqB,SAAkE;IAEvF,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,YAAY,CAA+B;IACnD;;;;;;OAMG;IACH,OAAO,CAAC,SAAS,CAAa;IAC9B;;;;;;;;;OASG;IACH,OAAO,CAAC,YAAY,CAAkB;IACtC;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU,CAA0B;IAC5C;;;OAGG;IACH,OAAO,CAAC,YAAY,CAA0B;IAC9C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAAgC;IAClD;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAA0B;IAE1C;;OAEG;WACU,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IA6EpE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB,SAAS,IAAI,qBAAqB;IAelC;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACG,WAAW,CACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IAoD9B;;;;;;;OAOG;IACG,iBAAiB,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIvE;;;;OAIG;IACG,WAAW,CAAC,OAAO,GAAE,2BAAgC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IASxF;;;;;;;;;OASG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAoBzC;;OAEG;IACH,WAAW,IAAI,gBAAgB,GAAG,IAAI;IAItC;;;;;;;;;;;;OAYG;IACH,WAAW,IAAI,WAAW;IAI1B;;;;;OAKG;IACG,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI/C;;;;;;;;OAQG;IACG,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQhE;;;;OAIG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ5E;;;OAGG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUvD,OAAO,CAAC,YAAY;YA0DN,gBAAgB;YAsBhB,iBAAiB;YAkBjB,UAAU;YAuBV,kBAAkB;YA8DlB,cAAc;IAU5B,OAAO,CAAC,YAAY;IAcpB;;;;;;;;;;;;;;;;;OAiBG;YACW,kBAAkB;YAkBlB,uBAAuB;IA2ErC;;;;;;;;;OASG;YACW,sBAAsB;IAuOpC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;IAgD1B,OAAO,CAAC,SAAS;IAuBjB;;;;;;;;;;;;;;;;;OAiBG;YACW,iBAAiB;CA6GhC;AAkBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,aAAa,GAAG,eAAe,CAiB9E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CA0C9E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CA+CxE"}

package/plugins/plugin-imessage/typescript/src/service.js

@@ -156,9 +156,7 @@ export class IMessageService extends Service {
     }
     getStatus() {
         const chatDbAvailable = this.chatDb !== null;
-        const accessIssue = chatDbAvailable
-            ? null
-            : getLastChatDbAccessIssue(this.chatDbPath);
+        const accessIssue = chatDbAvailable ? null : getLastChatDbAccessIssue(this.chatDbPath);
         return {
             available: true,
             connected: this.connected,
@@ -233,16 +231,18 @@ export class IMessageService extends Service {
      * granted, etc.).
      */
     async getRecentMessages(limit = 50) {
+        return this.getMessages({ limit });
+    }
+    /**
+     * Return the newest messages in chronological order, optionally scoped
+     * to a single chat identifier. Returns an empty array if chat.db is not
+     * available and the connector is currently running in send-only mode.
+     */
+    async getMessages(options = {}) {
         if (!this.chatDb) {
             return [];
         }
-        // `fetchNewMessages(0, limit)` returns the first `limit` rows in
-        // ROWID order, which for chat.db is also message-creation order.
-        // For "the most recent N messages" we'd ideally query with a
-        // different filter; fetching from 0 and slicing is fine for
-        // caller's expected use (startup inspection / debugging) because
-        // typical chat.db files have at most a few hundred thousand rows.
-        const rows = this.chatDb.fetchNewMessages(0, limit);
+        const rows = this.chatDb.listMessages(options);
         return rows.map(chatDbMessageToPublicShape);
     }
     /**
@@ -1018,7 +1018,14 @@ export function chatDbMessageToPublicShape(row) {
         chatId: row.chatId,
         timestamp: row.timestamp,
         isFromMe: row.isFromMe,
-        hasAttachments: false,
+        hasAttachments: row.attachments.length > 0,
+        ...(row.attachments.length > 0
+            ? {
+                attachmentPaths: row.attachments
+                    .map((attachment) => attachment.filename)
+                    .filter((filename) => Boolean(filename)),
+            }
+            : {}),
     };
 }
 /**

package/plugins/plugin-imessage/typescript/src/setup-routes.d.ts

@@ -9,7 +9,8 @@
  * Routes served (all under `/api/imessage`):
  *
  *   GET    /api/imessage/status         service health + connection state
- *   GET    /api/imessage/messages       recent messages from chat.db
+ *   GET    /api/imessage/messages       newest messages from chat.db
+ *   POST   /api/imessage/messages       send a message via Messages.app
  *   GET    /api/imessage/chats          list of chats (DMs + groups)
  *   GET    /api/imessage/contacts       every contact with full detail
  *   POST   /api/imessage/contacts       create a new contact

package/plugins/plugin-imessage/typescript/src/setup-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup-routes.d.ts","sourceRoot":"","sources":["../../../../../../../plugins/plugin-imessage/typescript/src/setup-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAiB,KAAK,EAA+B,MAAM,eAAe,CAAC;AAwTvF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,EA2CtC,CAAC"}
+{"version":3,"file":"setup-routes.d.ts","sourceRoot":"","sources":["../../../../../../../plugins/plugin-imessage/typescript/src/setup-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAiB,KAAK,EAA+B,MAAM,eAAe,CAAC;AAiZvF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,EAiDtC,CAAC"}