@haiai/haiai 0.1.2

package/dist/cjs/agent.js

@@ -0,0 +1,236 @@
+"use strict";
+/**
+ * High-level Agent API for HAI email operations.
+ *
+ * Provides an `Agent` class with an `agent.email` namespace that wraps
+ * the existing {@link HaiClient} for email operations. All emails are
+ * sent signed with the agent's JACS key. There is no unsigned send path.
+ *
+ * @example
+ * ```typescript
+ * import { Agent } from '@haiai/haiai';
+ *
+ * const agent = await Agent.fromConfig('./jacs.config.json');
+ * await agent.email.send({ to: 'other@hai.ai', subject: 'Hello', body: 'World' });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailNamespace = exports.Agent = void 0;
+const client_js_1 = require("./client.js");
+/**
+ * High-level agent wrapper providing `agent.email.*` namespace.
+ *
+ * Created via {@link Agent.fromConfig} which loads the JACS config and
+ * initializes the underlying {@link HaiClient}. All email operations
+ * go through the agent's JACS key -- there is no unsigned path.
+ */
+class Agent {
+    /** Email operations namespace. */
+    email;
+    _client;
+    constructor(client) {
+        this._client = client;
+        this.email = new EmailNamespace(client);
+    }
+    /**
+     * Create an Agent from a `jacs.config.json` file.
+     *
+     * Loads the JACS agent configuration and initializes the client.
+     *
+     * @param configPath - Path to jacs.config.json.
+     * @param options - Optional client options (base URL, timeout).
+     * @returns A configured Agent instance.
+     */
+    static async fromConfig(configPath = './jacs.config.json', options) {
+        const client = await client_js_1.HaiClient.create({
+            configPath,
+            url: options?.baseUrl,
+            timeout: options?.timeout,
+        });
+        return new Agent(client);
+    }
+    /** Access the underlying {@link HaiClient} for advanced operations. */
+    get client() {
+        return this._client;
+    }
+}
+exports.Agent = Agent;
+/**
+ * Email operations namespace.
+ *
+ * All methods delegate to {@link HaiClient} email methods. The
+ * {@link EmailNamespace.send} method always signs with the agent's
+ * JACS key via `sendSignedEmail`. There is no unsigned send path.
+ */
+class EmailNamespace {
+    _client;
+    constructor(client) {
+        this._client = client;
+    }
+    /**
+     * Send an email, always signed with the agent's JACS key.
+     *
+     * Builds RFC 5322 MIME, signs with the agent's Ed25519 key via JACS,
+     * and submits to the HAI API. There is no unsigned send path.
+     *
+     * @param options - Email options (to, subject, body, attachments).
+     * @returns SendEmailResult with messageId and status.
+     */
+    async send(options) {
+        return this._client.sendSignedEmail({
+            to: options.to,
+            subject: options.subject,
+            body: options.body,
+            inReplyTo: options.inReplyTo,
+            attachments: options.attachments?.map(a => ({
+                filename: a.filename,
+                contentType: a.contentType,
+                data: a.data,
+            })),
+            cc: options.cc,
+            bcc: options.bcc,
+            labels: options.labels,
+        });
+    }
+    /**
+     * List inbox messages (direction=inbound).
+     *
+     * @param options - Optional list options (limit, offset).
+     * @returns Array of EmailMessage objects.
+     */
+    async inbox(options) {
+        return this._client.listMessages({
+            limit: options?.limit,
+            offset: options?.offset,
+            direction: 'inbound',
+            isRead: options?.isRead,
+            folder: options?.folder,
+            label: options?.label,
+        });
+    }
+    /**
+     * List outbox messages (direction=outbound).
+     *
+     * @param options - Optional list options (limit, offset, filters).
+     * @returns Array of EmailMessage objects.
+     */
+    async outbox(options) {
+        return this._client.listMessages({
+            limit: options?.limit,
+            offset: options?.offset,
+            direction: 'outbound',
+            isRead: options?.isRead,
+            folder: options?.folder,
+            label: options?.label,
+        });
+    }
+    /**
+     * Get a specific message by ID.
+     *
+     * @param messageId - The message ID to retrieve.
+     * @returns EmailMessage.
+     */
+    async get(messageId) {
+        return this._client.getMessage(messageId);
+    }
+    /**
+     * Search email messages.
+     *
+     * @param options - Search options (query, direction, date range, etc.).
+     * @returns Array of EmailMessage matching the search criteria.
+     */
+    async search(options) {
+        return this._client.searchMessages(options);
+    }
+    /**
+     * Get email status including capacity and tier information.
+     *
+     * @returns EmailStatus with daily limits, usage, and tier info.
+     */
+    async status() {
+        return this._client.getEmailStatus();
+    }
+    /**
+     * Get the count of unread messages.
+     *
+     * @returns Number of unread inbound messages.
+     */
+    async unreadCount() {
+        return this._client.getUnreadCount();
+    }
+    /**
+     * Delete a message by ID.
+     *
+     * @param messageId - The message ID to delete.
+     */
+    async delete(messageId) {
+        return this._client.deleteMessage(messageId);
+    }
+    /**
+     * Mark a message as read.
+     *
+     * @param messageId - The message ID to mark as read.
+     */
+    async markRead(messageId) {
+        return this._client.markRead(messageId);
+    }
+    /**
+     * Mark a message as unread.
+     *
+     * @param messageId - The message ID to mark as unread.
+     */
+    async markUnread(messageId) {
+        return this._client.markUnread(messageId);
+    }
+    /**
+     * Reply to a message, always signed with the agent's JACS key.
+     *
+     * Fetches the original message, constructs a reply with proper
+     * threading headers, and sends it signed.
+     *
+     * @param messageId - The message ID to reply to.
+     * @param body - Reply body text.
+     * @param subjectOverride - Optional subject override.
+     * @returns SendEmailResult with messageId and status.
+     */
+    async reply(messageId, body, subjectOverride) {
+        return this._client.reply(messageId, body, subjectOverride);
+    }
+    /**
+     * Forward a message to another recipient.
+     *
+     * @param messageId - The message ID to forward.
+     * @param to - Recipient email address to forward to.
+     * @param comment - Optional comment to prepend.
+     * @returns SendEmailResult with messageId and status.
+     */
+    async forward(messageId, to, comment) {
+        return this._client.forward({ messageId, to, comment });
+    }
+    /**
+     * Archive a message.
+     *
+     * @param messageId - The message ID to archive.
+     */
+    async archive(messageId) {
+        return this._client.archive(messageId);
+    }
+    /**
+     * Unarchive (restore) a message back to the inbox.
+     *
+     * @param messageId - The message ID to unarchive.
+     */
+    async unarchive(messageId) {
+        return this._client.unarchive(messageId);
+    }
+    /**
+     * List contacts derived from email history.
+     *
+     * @returns Array of Contact objects.
+     */
+    async contacts() {
+        return this._client.getContacts();
+    }
+}
+exports.EmailNamespace = EmailNamespace;
+//# sourceMappingURL=agent.js.map

package/dist/cjs/agent.js.map

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