@holon-run/agentinbox 1.7.0 → 1.7.1

package/dist/src/source_schema.js

@@ -235,6 +235,7 @@ const SOURCE_SCHEMAS = {
             { name: "account", type: "string", required: false, description: "Account alias; defaults to the auth profile username." },
             { name: "mailbox", type: "string", required: false, description: "Mailbox to watch; defaults to INBOX." },
             { name: "pollIntervalSecs", type: "number", required: false, description: "Provider poll interval in seconds (min 15, default 60)." },
+            { name: "initialFetchLimit", type: "number", required: false, description: "First-look backfill depth: 0 = new mail only, max 100, default 25." },
             { name: "smtpEndpoint", type: "string", required: false, description: "Default smtp:// endpoint for outbound reply/send delivery." },
             { name: "fromAddress", type: "string", required: false, description: "Default outbound From address for delivery." },
             { name: "addressAllowlist", type: "string[]", required: false, description: "Optional from/to address allowlist applied before inbox routing." },

package/dist/src/sources/email.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EmailDeliveryAdapter = exports.RpcEmailUxcClient = exports.GRAPH_MESSAGES_ENDPOINT = exports.GMAIL_MESSAGES_ENDPOINT = exports.EMAIL_EVENT_VERSION = exports.EMAIL_EVENT_TYPE = exports.EMAIL_MAILBOX_DEFAULT_POLL_INTERVAL_SECS = exports.EMAIL_DEFAULT_MAILBOX = void 0;
+exports.EmailDeliveryAdapter = exports.RpcEmailUxcClient = exports.GRAPH_MESSAGES_ENDPOINT = exports.GMAIL_MESSAGES_ENDPOINT = exports.EMAIL_EVENT_VERSION = exports.EMAIL_EVENT_TYPE = exports.EMAIL_MAILBOX_MAX_INITIAL_FETCH_LIMIT = exports.EMAIL_MAILBOX_DEFAULT_INITIAL_FETCH_LIMIT = exports.EMAIL_MAILBOX_DEFAULT_POLL_INTERVAL_SECS = exports.EMAIL_DEFAULT_MAILBOX = void 0;
 exports.parseEmailMailboxSourceConfig = parseEmailMailboxSourceConfig;
 exports.buildEmailMailboxSourceSpec = buildEmailMailboxSourceSpec;
 exports.normalizeEmailMailboxEvent = normalizeEmailMailboxEvent;
@@ -9,6 +9,8 @@ exports.invokeEmailDeliveryOperation = invokeEmailDeliveryOperation;
 const uxc_daemon_client_1 = require("@holon-run/uxc-daemon-client");
 exports.EMAIL_DEFAULT_MAILBOX = "INBOX";
 exports.EMAIL_MAILBOX_DEFAULT_POLL_INTERVAL_SECS = 60;
+exports.EMAIL_MAILBOX_DEFAULT_INITIAL_FETCH_LIMIT = 25;
+exports.EMAIL_MAILBOX_MAX_INITIAL_FETCH_LIMIT = 100;
 exports.EMAIL_EVENT_TYPE = "email_event";
 exports.EMAIL_EVENT_VERSION = "v1";
 exports.GMAIL_MESSAGES_ENDPOINT = "https://gmail.googleapis.com/gmail/v1/users/me/messages";
@@ -67,6 +69,18 @@ function parseEmailMailboxSourceConfig(source) {
         }
         pollIntervalSecs = parsed;
     }
+    const initialFetchLimitRaw = config.initialFetchLimit ?? config.initial_fetch_limit;
+    let initialFetchLimit = exports.EMAIL_MAILBOX_DEFAULT_INITIAL_FETCH_LIMIT;
+    if (initialFetchLimitRaw !== undefined && initialFetchLimitRaw !== null) {
+        const parsed = numberFromUnknown(initialFetchLimitRaw);
+        if (parsed === undefined ||
+            !Number.isInteger(parsed) ||
+            parsed < 0 ||
+            parsed > exports.EMAIL_MAILBOX_MAX_INITIAL_FETCH_LIMIT) {
+            throw new Error(`email_mailbox config.initialFetchLimit must be an integer between 0 and ${exports.EMAIL_MAILBOX_MAX_INITIAL_FETCH_LIMIT} (0 = new mail only); got ${String(initialFetchLimitRaw)}`);
+        }
+        initialFetchLimit = parsed;
+    }
     const smtpEndpoint = asString(config.smtpEndpoint);
     if (smtpEndpoint && !/^smtp:\/\/./i.test(smtpEndpoint)) {
         throw new Error(`email_mailbox config.smtpEndpoint must use smtp:// (uxc SMTP surface); got ${smtpEndpoint}`);
@@ -91,6 +105,7 @@ function parseEmailMailboxSourceConfig(source) {
         account: account?.trim() || undefined,
         mailbox,
         pollIntervalSecs,
+        initialFetchLimit,
         ...(smtpEndpoint ? { smtpEndpoint } : {}),
         ...(fromAddress ? { fromAddress } : {}),
         ...(addressAllowlist && addressAllowlist.length > 0 ? { addressAllowlist } : {}),
@@ -106,13 +121,27 @@ function buildEmailMailboxSourceSpec(config) {
             endpoint: config.endpoint,
             mode: "stream",
             transport_hint: "email_imap_idle",
-            args,
+            args: {
+                ...args,
+                initial_fetch_limit: config.initialFetchLimit,
+            },
             options: {
                 auth: config.uxcAuth,
                 artifact_compaction: false,
             },
         };
     }
+    // See EmailPollSubscriptionConfig: the extra field is tolerated by older
+    // daemons (serde ignores unknown poll_config fields).
+    const pollConfig = {
+        interval_secs: config.pollIntervalSecs,
+        initial_items_limit: config.initialFetchLimit,
+        extract_items_pointer: "/items",
+        checkpoint_strategy: {
+            type: "item_key",
+            item_key_pointer: "/message/uid",
+        },
+    };
     return {
         endpoint: config.endpoint,
         mode: "poll",
@@ -121,14 +150,7 @@ function buildEmailMailboxSourceSpec(config) {
             provider: config.provider,
             ...args,
         },
-        poll_config: {
-            interval_secs: config.pollIntervalSecs,
-            extract_items_pointer: "/items",
-            checkpoint_strategy: {
-                type: "item_key",
-                item_key_pointer: "/message/uid",
-            },
-        },
+        poll_config: pollConfig,
         options: {
             auth: config.uxcAuth,
             artifact_compaction: false,

package/dist/src/sources/remote_modules.js

@@ -659,6 +659,7 @@ const EMAIL_MAILBOX_MODULE = {
                 { name: "account", type: "string", required: false, description: "Account alias; defaults to the auth profile username." },
                 { name: "mailbox", type: "string", required: false, description: "Mailbox to watch; defaults to INBOX." },
                 { name: "pollIntervalSecs", type: "number", required: false, description: "Provider poll interval in seconds (min 15, default 60)." },
+                { name: "initialFetchLimit", type: "number", required: false, description: "First-look backfill depth: 0 = new mail only, max 100, default 25." },
                 { name: "smtpEndpoint", type: "string", required: false, description: "Default smtp:// endpoint for outbound delivery." },
                 { name: "fromAddress", type: "string", required: false, description: "Default outbound From address." },
                 { name: "addressAllowlist", type: "string[]", required: false, description: "Optional from/to address allowlist." },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holon-run/agentinbox",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "Local event subscription and delivery service for agents.",
   "license": "Apache-2.0",
   "repository": {