@agenticmail/core 0.9.2 → 0.9.4

package/dist/index.cjs

@@ -964,7 +964,13 @@ var MailReceiver = class {
   async fetchMessage(uid, mailbox = "INBOX") {
     const lock = await this.client.getMailboxLock(mailbox);
     try {
-      const { content } = await this.client.download(String(uid), void 0, { uid: true });
+      const result = await this.client.download(String(uid), void 0, { uid: true });
+      const content = result?.content;
+      if (!content) {
+        const err = new Error(`Message UID ${uid} not found in mailbox "${mailbox}"`);
+        err.code = "MESSAGE_NOT_FOUND";
+        throw err;
+      }
       const chunks = [];
       for await (const chunk of content) {
         chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
@@ -2006,7 +2012,7 @@ var import_uuid = require("uuid");
 var import_node_crypto = require("crypto");
 
 // src/accounts/types.ts
-var AGENT_ROLES = ["secretary", "assistant", "researcher", "writer", "custom"];
+var AGENT_ROLES = ["secretary", "assistant", "researcher", "writer", "custom", "bridge"];
 var DEFAULT_AGENT_ROLE = "secretary";
 var DEFAULT_AGENT_NAME = "secretary";
 
@@ -2135,6 +2141,27 @@ var AccountManager = class {
     const result = stmt.run(id);
     return result.changes > 0;
   }
+  /**
+   * Update an agent's role. Used by host-integration installers
+   * (`@agenticmail/claudecode`, `@agenticmail/codex`) to migrate a
+   * pre-existing bridge account from `'assistant'` (the workaround they
+   * used before the `'bridge'` role landed) to the canonical
+   * `'bridge'` role. Returns the updated agent, or null when the id
+   * doesn't exist.
+   *
+   * Caller is responsible for validating the role string against
+   * AGENT_ROLES — this method trusts what it's given.
+   */
+  async updateRole(id, role) {
+    const existing = await this.getById(id);
+    if (!existing) return null;
+    if (existing.role === role) return existing;
+    const stmt = this.db.prepare(`
+      UPDATE agents SET role = ?, updated_at = datetime('now') WHERE id = ?
+    `);
+    stmt.run(role, id);
+    return this.getById(id);
+  }
   async updateMetadata(id, metadata) {
     const existing = await this.getById(id);
     if (!existing) return null;

package/dist/index.d.cts

@@ -305,8 +305,19 @@ declare function getDatabase(config: AgenticMailConfig): Database;
 declare function closeDatabase(): void;
 declare function createTestDatabase(): Database;
 
-/** Predefined agent roles */
-type AgentRole = 'secretary' | 'assistant' | 'researcher' | 'writer' | 'custom';
+/** Predefined agent roles.
+ *
+ * `bridge` is the host-bridge identity — the account that represents an
+ * external LLM host (Claude Code, Codex, Hermes, …) inside AgenticMail.
+ * It owns its own inbox + API key like any other account but is logically
+ * special: it's not a teammate the user assigns work to, it's the host
+ * itself acting on behalf of itself. The web UI / list_agents / wake
+ * gating SHOULD treat bridge accounts distinctly (they aren't typically
+ * spawned as subagents; they don't show up in coordination team pickers
+ * by default). The host-integration packages (@agenticmail/claudecode,
+ * @agenticmail/codex) use this role when provisioning their bridge.
+ */
+type AgentRole = 'secretary' | 'assistant' | 'researcher' | 'writer' | 'custom' | 'bridge';
 declare const AGENT_ROLES: readonly AgentRole[];
 declare const DEFAULT_AGENT_ROLE: AgentRole;
 declare const DEFAULT_AGENT_NAME = "secretary";
@@ -348,6 +359,18 @@ declare class AccountManager {
     list(): Promise<Agent[]>;
     getByRole(role: AgentRole): Promise<Agent[]>;
     delete(id: string): Promise<boolean>;
+    /**
+     * Update an agent's role. Used by host-integration installers
+     * (`@agenticmail/claudecode`, `@agenticmail/codex`) to migrate a
+     * pre-existing bridge account from `'assistant'` (the workaround they
+     * used before the `'bridge'` role landed) to the canonical
+     * `'bridge'` role. Returns the updated agent, or null when the id
+     * doesn't exist.
+     *
+     * Caller is responsible for validating the role string against
+     * AGENT_ROLES — this method trusts what it's given.
+     */
+    updateRole(id: string, role: AgentRole): Promise<Agent | null>;
     updateMetadata(id: string, metadata: Record<string, unknown>): Promise<Agent | null>;
     getCredentials(id: string): Promise<{
         email: string;

package/dist/index.d.ts

@@ -305,8 +305,19 @@ declare function getDatabase(config: AgenticMailConfig): Database;
 declare function closeDatabase(): void;
 declare function createTestDatabase(): Database;
 
-/** Predefined agent roles */
-type AgentRole = 'secretary' | 'assistant' | 'researcher' | 'writer' | 'custom';
+/** Predefined agent roles.
+ *
+ * `bridge` is the host-bridge identity — the account that represents an
+ * external LLM host (Claude Code, Codex, Hermes, …) inside AgenticMail.
+ * It owns its own inbox + API key like any other account but is logically
+ * special: it's not a teammate the user assigns work to, it's the host
+ * itself acting on behalf of itself. The web UI / list_agents / wake
+ * gating SHOULD treat bridge accounts distinctly (they aren't typically
+ * spawned as subagents; they don't show up in coordination team pickers
+ * by default). The host-integration packages (@agenticmail/claudecode,
+ * @agenticmail/codex) use this role when provisioning their bridge.
+ */
+type AgentRole = 'secretary' | 'assistant' | 'researcher' | 'writer' | 'custom' | 'bridge';
 declare const AGENT_ROLES: readonly AgentRole[];
 declare const DEFAULT_AGENT_ROLE: AgentRole;
 declare const DEFAULT_AGENT_NAME = "secretary";
@@ -348,6 +359,18 @@ declare class AccountManager {
     list(): Promise<Agent[]>;
     getByRole(role: AgentRole): Promise<Agent[]>;
     delete(id: string): Promise<boolean>;
+    /**
+     * Update an agent's role. Used by host-integration installers
+     * (`@agenticmail/claudecode`, `@agenticmail/codex`) to migrate a
+     * pre-existing bridge account from `'assistant'` (the workaround they
+     * used before the `'bridge'` role landed) to the canonical
+     * `'bridge'` role. Returns the updated agent, or null when the id
+     * doesn't exist.
+     *
+     * Caller is responsible for validating the role string against
+     * AGENT_ROLES — this method trusts what it's given.
+     */
+    updateRole(id: string, role: AgentRole): Promise<Agent | null>;
     updateMetadata(id: string, metadata: Record<string, unknown>): Promise<Agent | null>;
     getCredentials(id: string): Promise<{
         email: string;

package/dist/index.js

@@ -205,7 +205,13 @@ var MailReceiver = class {
   async fetchMessage(uid, mailbox = "INBOX") {
     const lock = await this.client.getMailboxLock(mailbox);
     try {
-      const { content } = await this.client.download(String(uid), void 0, { uid: true });
+      const result = await this.client.download(String(uid), void 0, { uid: true });
+      const content = result?.content;
+      if (!content) {
+        const err = new Error(`Message UID ${uid} not found in mailbox "${mailbox}"`);
+        err.code = "MESSAGE_NOT_FOUND";
+        throw err;
+      }
       const chunks = [];
       for await (const chunk of content) {
         chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
@@ -1247,7 +1253,7 @@ import { v4 as uuidv4 } from "uuid";
 import { randomBytes } from "crypto";
 
 // src/accounts/types.ts
-var AGENT_ROLES = ["secretary", "assistant", "researcher", "writer", "custom"];
+var AGENT_ROLES = ["secretary", "assistant", "researcher", "writer", "custom", "bridge"];
 var DEFAULT_AGENT_ROLE = "secretary";
 var DEFAULT_AGENT_NAME = "secretary";
 
@@ -1376,6 +1382,27 @@ var AccountManager = class {
     const result = stmt.run(id);
     return result.changes > 0;
   }
+  /**
+   * Update an agent's role. Used by host-integration installers
+   * (`@agenticmail/claudecode`, `@agenticmail/codex`) to migrate a
+   * pre-existing bridge account from `'assistant'` (the workaround they
+   * used before the `'bridge'` role landed) to the canonical
+   * `'bridge'` role. Returns the updated agent, or null when the id
+   * doesn't exist.
+   *
+   * Caller is responsible for validating the role string against
+   * AGENT_ROLES — this method trusts what it's given.
+   */
+  async updateRole(id, role) {
+    const existing = await this.getById(id);
+    if (!existing) return null;
+    if (existing.role === role) return existing;
+    const stmt = this.db.prepare(`
+      UPDATE agents SET role = ?, updated_at = datetime('now') WHERE id = ?
+    `);
+    stmt.run(role, id);
+    return this.getById(id);
+  }
   async updateMetadata(id, metadata) {
     const existing = await this.getById(id);
     if (!existing) return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/core",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "description": "Core SDK for AgenticMail — email, SMS, and phone number access for AI agents",
   "type": "module",
   "main": "dist/index.js",