aamp-sdk 0.1.5

package/README.md

@@ -0,0 +1,43 @@
+# @byted-meego/aamp-sdk
+
+Node.js SDK for connecting agents and services to AAMP.
+
+## Install
+
+```bash
+npm install @byted-meego/aamp-sdk
+```
+
+## Usage
+
+```ts
+import { AampClient } from '@byted-meego/aamp-sdk'
+
+const client = new AampClient({
+  email: 'agent@example.com',
+  jmapToken: '<base64(email:password)>',
+  jmapUrl: 'http://localhost:3000/jmap',
+  smtpHost: 'localhost',
+  smtpPort: 587,
+  smtpPassword: '<smtp-password>',
+  rejectUnauthorized: false,
+})
+
+client.on('task.dispatch', async (task) => {
+  await client.sendResult({
+    to: task.from,
+    taskId: task.taskId,
+    status: 'completed',
+    output: 'done',
+    inReplyTo: task.messageId,
+  })
+})
+
+await client.connect()
+```
+
+## Exports
+
+- `AampClient`
+- `JmapPushClient`
+- protocol types such as `TaskDispatch`, `TaskResult`, and `TaskHelp`

package/dist/client.d.ts

@@ -0,0 +1,91 @@
+/**
+ * AampClient — Main SDK entry point
+ *
+ * Combines JMAP WebSocket Push (receive) + SMTP (send) into a single client.
+ *
+ * Usage:
+ *
+ * ```typescript
+ * const client = new AampClient({
+ *   email: 'codereviewer-abc@aamp.example.com',
+ *   jmapToken: '<base64-token>',
+ *   jmapUrl: 'http://localhost:8080',
+ *   smtpHost: 'localhost',
+ *   smtpPort: 587,
+ *   smtpPassword: 'agent-smtp-password',
+ * })
+ *
+ * // Listen for incoming tasks
+ * client.on('task.dispatch', async (task) => {
+ *   const result = await doWork(task)
+ *   await client.sendResult({
+ *     to: task.from,
+ *     taskId: task.taskId,
+ *     status: 'completed',
+ *     output: result,
+ *   })
+ * })
+ *
+ * await client.connect()
+ * ```
+ */
+import { EventEmitter } from 'events';
+import type { AampClientConfig, AampClientEvents, SendTaskOptions, SendResultOptions, SendHelpOptions } from './types.js';
+export declare class AampClient extends EventEmitter {
+    private jmapClient;
+    private smtpSender;
+    private readonly config;
+    constructor(config: AampClientConfig);
+    on<K extends keyof AampClientEvents>(event: K, listener: AampClientEvents[K]): this;
+    once<K extends keyof AampClientEvents>(event: K, listener: AampClientEvents[K]): this;
+    off<K extends keyof AampClientEvents>(event: K, listener: AampClientEvents[K]): this;
+    /**
+     * Connect to JMAP and start listening for tasks
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect and clean up
+     */
+    disconnect(): void;
+    /**
+     * Returns true if the JMAP connection is active
+     */
+    isConnected(): boolean;
+    isUsingPollingFallback(): boolean;
+    /**
+     * Send a task.dispatch email to an agent.
+     * Returns the generated taskId and the SMTP Message-ID.
+     * Store messageId → taskId in Redis/DB to support In-Reply-To thread routing
+     * for human replies that arrive without X-AAMP headers.
+     */
+    sendTask(opts: SendTaskOptions): Promise<{
+        taskId: string;
+        messageId: string;
+    }>;
+    /**
+     * Send a task.result email (agent → system/dispatcher)
+     */
+    sendResult(opts: SendResultOptions): Promise<void>;
+    /**
+     * Send a task.help email when the agent needs human assistance
+     */
+    sendHelp(opts: SendHelpOptions): Promise<void>;
+    /**
+     * Download a blob (attachment) by its JMAP blobId.
+     * Use this to retrieve attachment content from received TaskDispatch or TaskResult messages.
+     * Returns the raw binary content as a Buffer.
+     */
+    downloadBlob(blobId: string, filename?: string): Promise<Buffer>;
+    /**
+     * Reconcile recent mailbox contents via JMAP HTTP to catch messages missed by
+     * a flaky WebSocket path. Safe to call periodically; duplicate processing is
+     * suppressed by the JMAP push client.
+     */
+    reconcileRecentEmails(limit?: number): Promise<number>;
+    /**
+     * Verify SMTP connectivity
+     */
+    verifySmtp(): Promise<boolean>;
+    get email(): string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAGrC,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAMhB,eAAe,EACf,iBAAiB,EACjB,eAAe,EAChB,MAAM,YAAY,CAAA;AAEnB,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,gBAAgB;IAkF3B,EAAE,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAC1C,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,IAAI;IAIE,IAAI,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAC5C,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,IAAI;IAIE,GAAG,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAC3C,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,IAAI;IAQP;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB,sBAAsB,IAAI,OAAO;IAQjC;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAIrF;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD;;;;OAIG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAItE;;;;OAIG;IACG,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAIpC,IAAI,KAAK,IAAI,MAAM,CAElB;CACF"}

package/dist/client.js

@@ -0,0 +1,196 @@
+/**
+ * AampClient — Main SDK entry point
+ *
+ * Combines JMAP WebSocket Push (receive) + SMTP (send) into a single client.
+ *
+ * Usage:
+ *
+ * ```typescript
+ * const client = new AampClient({
+ *   email: 'codereviewer-abc@aamp.example.com',
+ *   jmapToken: '<base64-token>',
+ *   jmapUrl: 'http://localhost:8080',
+ *   smtpHost: 'localhost',
+ *   smtpPort: 587,
+ *   smtpPassword: 'agent-smtp-password',
+ * })
+ *
+ * // Listen for incoming tasks
+ * client.on('task.dispatch', async (task) => {
+ *   const result = await doWork(task)
+ *   await client.sendResult({
+ *     to: task.from,
+ *     taskId: task.taskId,
+ *     status: 'completed',
+ *     output: result,
+ *   })
+ * })
+ *
+ * await client.connect()
+ * ```
+ */
+import { EventEmitter } from 'events';
+import { JmapPushClient } from './jmap-push.js';
+import { SmtpSender } from './smtp-sender.js';
+export class AampClient extends EventEmitter {
+    jmapClient;
+    smtpSender;
+    config;
+    constructor(config) {
+        super();
+        this.config = config;
+        // Decode JMAP token (format: base64(email:password))
+        let password;
+        try {
+            const decoded = Buffer.from(config.jmapToken, 'base64').toString('utf-8');
+            const colonIdx = decoded.indexOf(':');
+            if (colonIdx < 0)
+                throw new Error('Invalid jmapToken format: expected base64(email:password)');
+            password = decoded.slice(colonIdx + 1);
+            if (!password)
+                throw new Error('Invalid jmapToken: empty password');
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.startsWith('Invalid jmapToken'))
+                throw err;
+            throw new Error(`Failed to decode jmapToken: ${err.message}`);
+        }
+        this.jmapClient = new JmapPushClient({
+            email: config.email,
+            password: password ?? config.smtpPassword,
+            jmapUrl: config.jmapUrl,
+            reconnectInterval: config.reconnectInterval ?? 5000,
+            rejectUnauthorized: config.rejectUnauthorized,
+        });
+        this.smtpSender = new SmtpSender({
+            host: config.smtpHost,
+            port: config.smtpPort ?? 587,
+            user: config.email,
+            password: config.smtpPassword,
+            httpBaseUrl: config.httpSendBaseUrl ?? config.jmapUrl,
+            authToken: config.jmapToken,
+            rejectUnauthorized: config.rejectUnauthorized,
+        });
+        // Forward JMAP events to this emitter
+        this.jmapClient.on('task.dispatch', (task) => {
+            this.emit('task.dispatch', task);
+        });
+        this.jmapClient.on('task.result', (result) => {
+            this.emit('task.result', result);
+        });
+        this.jmapClient.on('task.help', (help) => {
+            this.emit('task.help', help);
+        });
+        this.jmapClient.on('task.ack', (ack) => {
+            this.emit('task.ack', ack);
+        });
+        // Auto-ACK: when a task.dispatch is received, automatically send an ACK back
+        this.jmapClient.on('_autoAck', async ({ to, taskId, messageId }) => {
+            try {
+                await this.smtpSender.sendAck({ to, taskId, inReplyTo: messageId });
+            }
+            catch (err) {
+                console.warn(`[AAMP] Failed to send ACK for task ${taskId}: ${err.message}`);
+            }
+        });
+        this.jmapClient.on('reply', (reply) => {
+            this.emit('reply', reply);
+        });
+        this.jmapClient.on('connected', () => {
+            this.emit('connected');
+        });
+        this.jmapClient.on('disconnected', (reason) => {
+            this.emit('disconnected', reason);
+        });
+        this.jmapClient.on('error', (err) => {
+            this.emit('error', err);
+        });
+    }
+    // =====================================================
+    // Type-safe event emitter methods
+    // =====================================================
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+    // =====================================================
+    // Lifecycle
+    // =====================================================
+    /**
+     * Connect to JMAP and start listening for tasks
+     */
+    async connect() {
+        await this.jmapClient.start();
+    }
+    /**
+     * Disconnect and clean up
+     */
+    disconnect() {
+        this.jmapClient.stop();
+        this.smtpSender.close();
+    }
+    /**
+     * Returns true if the JMAP connection is active
+     */
+    isConnected() {
+        return this.jmapClient.isConnected();
+    }
+    isUsingPollingFallback() {
+        return this.jmapClient.isUsingPollingFallback();
+    }
+    // =====================================================
+    // Sending
+    // =====================================================
+    /**
+     * Send a task.dispatch email to an agent.
+     * Returns the generated taskId and the SMTP Message-ID.
+     * Store messageId → taskId in Redis/DB to support In-Reply-To thread routing
+     * for human replies that arrive without X-AAMP headers.
+     */
+    async sendTask(opts) {
+        return this.smtpSender.sendTask(opts);
+    }
+    /**
+     * Send a task.result email (agent → system/dispatcher)
+     */
+    async sendResult(opts) {
+        return this.smtpSender.sendResult(opts);
+    }
+    /**
+     * Send a task.help email when the agent needs human assistance
+     */
+    async sendHelp(opts) {
+        return this.smtpSender.sendHelp(opts);
+    }
+    /**
+     * Download a blob (attachment) by its JMAP blobId.
+     * Use this to retrieve attachment content from received TaskDispatch or TaskResult messages.
+     * Returns the raw binary content as a Buffer.
+     */
+    async downloadBlob(blobId, filename) {
+        return this.jmapClient.downloadBlob(blobId, filename);
+    }
+    /**
+     * Reconcile recent mailbox contents via JMAP HTTP to catch messages missed by
+     * a flaky WebSocket path. Safe to call periodically; duplicate processing is
+     * suppressed by the JMAP push client.
+     */
+    async reconcileRecentEmails(limit) {
+        return this.jmapClient.reconcileRecentEmails(limit);
+    }
+    /**
+     * Verify SMTP connectivity
+     */
+    async verifySmtp() {
+        return this.smtpSender.verify();
+    }
+    get email() {
+        return this.config.email;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAc7C,MAAM,OAAO,UAAW,SAAQ,YAAY;IAClC,UAAU,CAAgB;IAC1B,UAAU,CAAY;IACb,MAAM,CAAkB;IAEzC,YAAY,MAAwB;QAClC,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QAEpB,qDAAqD;QACrD,IAAI,QAAgB,CAAA;QACpB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;YACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YACrC,IAAI,QAAQ,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;YAC9F,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAA;YACtC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC;gBAAE,MAAM,GAAG,CAAA;YAClF,MAAM,IAAI,KAAK,CAAC,+BAAgC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAA;QAC1E,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,IAAI,cAAc,CAAC;YACnC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,QAAQ,IAAI,MAAM,CAAC,YAAY;YACzC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,IAAI;YACnD,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;SAC9C,CAAC,CAAA;QAEF,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC;YAC/B,IAAI,EAAE,MAAM,CAAC,QAAQ;YACrB,IAAI,EAAE,MAAM,CAAC,QAAQ,IAAI,GAAG;YAC5B,IAAI,EAAE,MAAM,CAAC,KAAK;YAClB,QAAQ,EAAE,MAAM,CAAC,YAAY;YAC7B,WAAW,EAAE,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,OAAO;YACrD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;SAC9C,CAAC,CAAA;QAEF,sCAAsC;QACtC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,IAAkB,EAAE,EAAE;YACzD,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAA;QAClC,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,MAAkB,EAAE,EAAE;YACvD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;QAClC,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,IAAc,EAAE,EAAE;YACjD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;QAC9B,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,GAAY,EAAE,EAAE;YAC9C,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;QAEF,6EAA6E;QAC7E,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAqD,EAAE,EAAE;YACpH,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAA;YACrE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,sCAAsC,MAAM,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAA;YACzF,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAiB,EAAE,EAAE;YAChD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;YACnC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACxB,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,MAAc,EAAE,EAAE;YACpD,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;QACnC,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YACzC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QACzB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,wDAAwD;IACxD,kCAAkC;IAClC,wDAAwD;IAE/C,EAAE,CACT,KAAQ,EACR,QAA6B;QAE7B,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAA;IAClE,CAAC;IAEQ,IAAI,CACX,KAAQ,EACR,QAA6B;QAE7B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAA;IACpE,CAAC;IAEQ,GAAG,CACV,KAAQ,EACR,QAA6B;QAE7B,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAA;IACnE,CAAC;IAED,wDAAwD;IACxD,YAAY;IACZ,wDAAwD;IAExD;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAA;QACtB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;IACzB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA;IACtC,CAAC;IAED,sBAAsB;QACpB,OAAO,IAAI,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAA;IACjD,CAAC;IAED,wDAAwD;IACxD,UAAU;IACV,wDAAwD;IAExD;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAqB;QAClC,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,IAAuB;QACtC,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAqB;QAClC,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACvC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,QAAiB;QAClD,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACvD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,qBAAqB,CAAC,KAAc;QACxC,OAAO,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAA;IACrD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAA;IACjC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAA;IAC1B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @byted-meego/aamp-sdk — Node.js SDK for AAMP Service
+ *
+ * Main exports:
+ * - AampClient: combined JMAP push receiver + SMTP sender
+ * - parseAampHeaders: parse AAMP headers from raw email headers
+ * - Types
+ */
+export { AampClient } from './client.js';
+export { parseAampHeaders, normalizeHeaders, buildDispatchHeaders, buildResultHeaders, buildHelpHeaders, buildAckHeaders } from './parser.js';
+export { JmapPushClient } from './jmap-push.js';
+export { SmtpSender } from './smtp-sender.js';
+export type { AampIntent, TaskStatus, AampAttachment, ReceivedAttachment, StructuredResultField, TaskDispatch, TaskResult, TaskHelp, TaskAck, HumanReply, AampMessage, AampClientConfig, AampClientEvents, SendTaskOptions, SendResultOptions, SendHelpOptions, } from './types.js';
+export { AAMP_HEADER } from './types.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;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7I,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAG7C,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,OAAO,EACP,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @byted-meego/aamp-sdk — Node.js SDK for AAMP Service
+ *
+ * Main exports:
+ * - AampClient: combined JMAP push receiver + SMTP sender
+ * - parseAampHeaders: parse AAMP headers from raw email headers
+ * - Types
+ */
+export { AampClient } from './client.js';
+export { parseAampHeaders, normalizeHeaders, buildDispatchHeaders, buildResultHeaders, buildHelpHeaders, buildAckHeaders } from './parser.js';
+export { JmapPushClient } from './jmap-push.js';
+export { SmtpSender } from './smtp-sender.js';
+export { AAMP_HEADER } from './types.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;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7I,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAsB7C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}

package/dist/jmap-push.d.ts

@@ -0,0 +1,104 @@
+/**
+ * JMAP WebSocket Push Client
+ *
+ * Connects to Stalwart's JMAP WebSocket endpoint and subscribes to
+ * Email StateChange events. When a new email arrives in the agent's
+ * mailbox, fetches it via JMAP and emits the parsed AAMP headers.
+ *
+ * Protocol: RFC 8887 (JMAP over WebSocket)
+ * Ref: https://www.rfc-editor.org/rfc/rfc8887
+ */
+import { EventEmitter } from 'events';
+export declare class JmapPushClient extends EventEmitter {
+    private ws;
+    private session;
+    private reconnectTimer;
+    private pollTimer;
+    private pingTimer;
+    private readonly seenMessageIds;
+    private connected;
+    private pollingActive;
+    private running;
+    private connecting;
+    /** JMAP Email state — tracks processed position; null = not yet initialized */
+    private emailState;
+    private readonly startedAtMs;
+    private readonly email;
+    private readonly password;
+    private readonly jmapUrl;
+    private readonly reconnectInterval;
+    private readonly rejectUnauthorized;
+    private readonly pingIntervalMs;
+    constructor(opts: {
+        email: string;
+        password: string;
+        jmapUrl: string;
+        reconnectInterval?: number;
+        /** Whether to reject unauthorized TLS certificates (default: true) */
+        rejectUnauthorized?: boolean;
+    });
+    /**
+     * Start the JMAP Push listener
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the JMAP Push listener
+     */
+    stop(): void;
+    private getAuthHeader;
+    /**
+     * Fetch the JMAP session object
+     */
+    private fetchSession;
+    /**
+     * Perform a JMAP API call
+     */
+    private jmapCall;
+    /**
+     * Initialize emailState by fetching the current state without loading any emails.
+     * Called on first connect so we only process emails that arrive AFTER this point.
+     */
+    private initEmailState;
+    /**
+     * Fetch only emails created since `sinceState` using Email/changes.
+     * Updates `this.emailState` to the new state after fetching.
+     * Returns [] and resets state if the server cannot calculate changes (state too old).
+     */
+    private fetchEmailsSince;
+    /**
+     * Process a received email.
+     *
+     * Priority:
+     * 1. If X-AAMP-Intent is present → emit typed AAMP event (task.dispatch / task.result / task.help)
+     * 2. If In-Reply-To is present → emit 'reply' event so the application layer can
+     *    resolve the thread (inReplyTo → taskId via Redis/DB) and handle human replies.
+     * 3. Otherwise → ignore (not an AAMP-related email)
+     */
+    private processEmail;
+    private fetchRecentEmails;
+    private shouldProcessBootstrapEmail;
+    /**
+     * Connect to JMAP WebSocket
+     */
+    private connect;
+    private startPingHeartbeat;
+    private stopPingHeartbeat;
+    private handleStateChange;
+    private scheduleReconnect;
+    isConnected(): boolean;
+    isUsingPollingFallback(): boolean;
+    private stopPolling;
+    private startPolling;
+    /**
+     * Download a blob (attachment) by its JMAP blobId.
+     * Returns the raw binary content as a Buffer.
+     */
+    downloadBlob(blobId: string, filename?: string): Promise<Buffer>;
+    /**
+     * Actively reconcile recent mailbox contents via JMAP HTTP.
+     * Useful as a safety net when the WebSocket stays "connected"
+     * but a notification is missed by an intermediate layer.
+     */
+    reconcileRecentEmails(limit?: number): Promise<number>;
+}
+//# sourceMappingURL=jmap-push.d.ts.map

package/dist/jmap-push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jmap-push.d.ts","sourceRoot":"","sources":["../src/jmap-push.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAoDrC,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,UAAU,CAAQ;IAC1B,+EAA+E;IAC/E,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAO;gBAE1B,IAAI,EAAE;QAChB,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,OAAO,EAAE,MAAM,CAAA;QACf,iBAAiB,CAAC,EAAE,MAAM,CAAA;QAC1B,sEAAsE;QACtE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAC7B;IASD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAuBZ,OAAO,CAAC,aAAa;IAKrB;;OAEG;YACW,YAAY;IAa1B;;OAEG;YACW,QAAQ;IA+BtB;;;OAGG;YACW,cAAc;IAU5B;;;;OAIG;YACW,gBAAgB;IA+C9B;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;YAsFN,iBAAiB;IAuC/B,OAAO,CAAC,2BAA2B;IAOnC;;OAEG;YACW,OAAO;IAoHrB,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,iBAAiB;YAOX,iBAAiB;IA0B/B,OAAO,CAAC,iBAAiB;IAWzB,WAAW,IAAI,OAAO;IAItB,sBAAsB,IAAI,OAAO;IAIjC,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,YAAY;IAsDpB;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiEtE;;;;OAIG;IACG,qBAAqB,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;CA2DzD"}