@absolutejs/agent-exchange-email

中文文档
0.6.1发布于 2026/09/26Apache-2.0TypeScriptES Module近 30 天下载 1697

用于 @absolutejs/ agent- exchange的定型, 模式盲电子邮件校验码源 .

中文使用文档

@absolutejs/agent-exchange-email

电子邮件一次性代码是无记名证书. 此来源接受 明确 policy + bearer + purpose-bound 配置图或 webauthn-verifier-bound + token-confined-broker + purpose-bound后者 将供应商证书和检察官办公室的处理限于信任的经纪人,但确实如此 而不是让上游的持证者耐用钓鱼.

这个 0.5.x 线条还接受精确、密码输入 standing-mandate 具有相同的受约束和有目的要求。 已签署的任务 从未扩展主机拥有的邮箱配置 .

可互换的、决定性的电子邮件源 @absolutejs/agent-exchange它使用 @absolutejs/email/verification 以找到 一个精确的校验信息, 并将保护值直接返回给代理 交换加密.

Gmail 和 Microsoft Graph 浏览器是安全的 。 IMAP 仅为服务器, 并且是 创建于 @absolutejs/email/verification/imap 在经过这里之前.

bun add @absolutejs/agent-exchange @absolutejs/agent-exchange-email @absolutejs/email
import { createEmailVerificationCodeSource } from "@absolutejs/agent-exchange-email";
import { createGmailVerificationMessageLookup } from "@absolutejs/email/verification";

const source = createEmailVerificationCodeSource({
  lookup: createGmailVerificationMessageLookup({ accountEmail, client: gmail }),
  profiles: [
    {
      bodyMarkers: ["verification code"],
      correlation: { mode: "challenge-text" },
      id: "accounts-example-six-digit-v1",
      operations: ["verification.submit"],
      origins: ["https://accounts.example.com"],
      providers: ["gmail"],
      senderAddresses: ["[email protected]"],
      senderAuthentication: {
        allowedHeaderFromDomains: ["example.com"],
        trustedAuthservIds: ["mx.mailbox.example"],
      },
      subjectIncludesAny: ["sign in"],
    },
  ],
  resolveAccountEmail: (request) =>
    mailboxDirectory.get(request.resource.accountRef),
});

过 source 改为 createAgentExchangeSender不要把它登记为MCP, A2A, 显示或一般代理工具。 来源故意不返回字符串 API; Agent Exchange加密其可变字节结果,并在交付后清除.

规则失效

  • 仅 tool-confined,单用, email-one-time-code 接受请求.
  • 请求的精确提供者 HTTPS 来源和操作必须精确选择 一个简介.
  • challenge-text 相关性是默认安全配置模式:请求 challengeId 必须在选定的信件正文中准确出现.
  • temporal-only 配置文件既需要明确的配置模式,也需要 allowTemporalOnlyCorrelation: true; 仅在一个 上游电子邮件无法响应挑战 .
  • 可见的发件人必须有一个完全对齐的 DMARC 密码从配置, 信箱委托的RFC 8601 authserv-id。 。 。 .
  • 邮箱账户引用通过主机拥有的目录解决 从未被假定为电子邮件地址.
  • 默认的搜索窗口在机构请求前30秒开始并结束 (a) 执行时间或请求到期时间较早。 未来的时钟定是 明确启用.
  • 多个信件,多个标记绑定代码, 不信任的发送者, stille mail, 找错人了 找错人了 都安全了 source_failed 错误.

电子邮件检察官办公室仍然是无记名证书,不耐打网球。 偏爱 授权、密码、服务账户或提供者授权的行动 也许吧.

此发布使用 email 6.6.0 表示 standalone-after-marker 代码布局 并保留了 HTML 块边界。 保留现有的直接标记简介 他们的行为。 仅限时间的关联性仍需明确选择加入,而且是否 无法在提供者电子邮件和浏览器会话之间证明加密绑定; 呼叫者必须将尝试序列化,并将目的地分开.

selection: "newest" (与 @absolutejs/email 0.7)使用最新数据 发件人认证匹配,而不是在多个消息匹配时失败,以及 允许 maxLookbackMs 最多24小时 这是用来 temporal-only 服务 邮箱所有者选择的邮件中 "使用最新代码". 默认 unique 选择保留两分钟的上限.

createEmailVerificationCodeSource 接受可选选项 onFailure 观察员. 它只得到一个固定类别(no_match, (中文(简体) ), ambiguous_match, (中文(简体) ), candidate_limit, (中文(简体) ), invalid_profile, (中文(简体) ), lookup_failed,或 source_rejected) (中文(简体) ). 它从未收到 被捕获的例外,代码,消息正文,提供者响应,或源证据. 观察失败被忽略,检索继续失败被关闭. 主机可能 记录这些类别进行手术诊断,而不透露秘密.

版本与发布记录

@absolutejs/agent-exchange-email 共发布 12 个版本,首次发布于 2026/08/26;过去 12 个月发布了 12 个版本。

版本发布日期距今
0.6.1latest2026/09/261 个月前
0.6.02026/09/261 个月前
0.5.22026/09/261 个月前
0.5.12026/09/251 个月前
0.5.02026/08/272 个月前
0.4.12026/08/262 个月前

关于 @absolutejs/agent-exchange-email 的常见问题

@absolutejs/agent-exchange-email 是什么?

用于 @absolutejs/ agent- exchange的定型, 模式盲电子邮件校验码源 .

如何安装 @absolutejs/agent-exchange-email?

在项目目录运行 npm install @absolutejs/agent-exchange-email,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@absolutejs/agent-exchange(>=0.5.0 <0.6)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@absolutejs/agent-exchange-email 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@absolutejs/agent-exchange-email 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@absolutejs/agent-exchange-email 可以商用吗?

@absolutejs/agent-exchange-email 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@absolutejs/agent-exchange-email 的下载量有多少?

根据 npm 官方下载统计,@absolutejs/agent-exchange-email 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,697 次,日均约 57 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@absolutejs/agent-exchange-email 还在维护吗?

最新版本 0.6.1 发布于 2026/09/26(1 个月前);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/08/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。