@godspeedai/cognate-protocol-connect-bun

中文文档
0.10.0发布于 2026/11/16Apache-2.0ES Module构建来源已验证近 30 天下载 3362

在 Bun.serve 上服务连接运行时,提供认证、有效载荷限制和最后期限;提供接取运输.

中文使用文档
文档目录7 节
  1. 安装
  2. 快开始
  3. 请求处理
  4. 发展标志
  5. 限制
  6. 相关软件包
  7. 许可证

@godspideai/cognate-protocol-connect-bun (英语)

服务于科格纳特 RuntimeService 超过连接协议 Bun.serve ——具有认证,有效载荷限制和已经接通的最后期限——并提供匹配的取取客户端运输.

何时使用此软件包 : 或者从Bun那里打一个电话 你要处理运输 它会编曲 @godspeedai/cognate-protocol-connect (运输中性路径映射); 当您的服务器是 Bun 时安装此程序 。 对于不同的 HTTP 主机, 使用 @godspeedai/cognate-protocol-connect 直接在您的路由器上注册其路线.

安装

bun add @godspeedai/cognate-protocol-connect-bun

要求数 阿宝 1.4.0(服务器是 Bun.serve 运输。 取决于 @connectrpc/connect, (中文(简体) ), @connectrpc/connect-web,以及 @godspeedai/cognate-protocol-connect。 。 。 .

快开始

服务运行时间 从第二个过程调用它:

import { createRuntime } from "@godspeedai/cognate-runtime-bun";
import { devTokenAuthenticator, serveRuntime } from "@godspeedai/cognate-protocol-connect-bun";

const runtime = await createRuntime({
  store: "./app.sqlite",
  agents: [/* your AgentDefinitions */],
  policy, // kernel invocation policy
  actions, // action authorization
});

const server = serveRuntime({
  service: runtime.service,
  authenticate: devTokenAuthenticator, // dev helper; bring your own for production
  port: 3000,
  limits: { maxBodyBytes: 1_048_576, maxJsonDepth: 32, defaultDeadlineMs: 30_000 },
});

console.log(server.url); // http://127.0.0.1:3000
await server.stop();

在客户端,建造一个运输和遥控器 RuntimeService数字 :

import { createRemoteRuntimeService } from "@godspeedai/cognate-protocol-connect";
import { connectTransport, devToken } from "@godspeedai/cognate-protocol-connect-bun";

const service = createRemoteRuntimeService(
  connectTransport("http://127.0.0.1:3000", { useBinaryFormat: false }),
  devToken, // (caller) => "tenant:principal" Bearer token
);

const caller = { actor: { id: "alice", kind: "user" }, tenant: "tenant-a" };
const run = await service.startRun(caller, { agent: "agent.echo", input: { text: "hi" } });

请求处理

每个请求都经过同一大门,以便:

  1. 认证 —— 说 authenticate(headers) 解决调用者; 无调用者表示 HTTP 401 与连接码 unauthenticated。 。 。 .
  2. 体积 ——申报 content-length 结束 maxBodyBytes (默认 1 MiB ) 被拒绝使用 resource_exhausted。 。 。 .
  3. JSON 深度 ——数值比 maxJsonDepth (默认32)以下列方式被拒绝: invalid_argument; 同样有错误的信息.
  4. 截止日期 ——不缩短客户截止日期的无记名电话以 defaultDeadlineMs (默认 30 s); 超支表面为 deadline_exceeded。 。 。 .

错误返回为连接 JSON ({ code, message }),以及 ServiceError 密码从您的服务 往返到连接代码 并准确返回.

发展标志

devTokenAuthenticator 接受 Authorization: Bearer <tenant>:<principalId> 财务报告和审定财务报表 devToken 让一个打电话的人回到那个表格。 它们是用于发展和测试的 这不是一个认证系统; 自行交换 authenticate 在让服务器接触到任何真实的东西之前.

限制

  • HTTP/1.1 仅支持unary和服务器流调用;协议定义不使用客户端流或双向方法.
  • 体积检查使用已申报 content-length 头曰.
  • serveRuntime 当 port 删除;从 server.url。 。 。 .

许可证

阿帕奇 - 2.0

版本与发布记录

@godspeedai/cognate-protocol-connect-bun 共发布 20 个版本,首次发布于 2026/10/09;过去 12 个月发布了 20 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.10.0latest2026/11/16今天
0.9.22026/11/152 天前
0.9.12026/11/143 天前
0.9.02026/11/0610 天前
0.8.02026/10/2720 天前
0.7.12026/10/2523 天前

关于 @godspeedai/cognate-protocol-connect-bun 的常见问题

@godspeedai/cognate-protocol-connect-bun 是什么?

在 Bun.serve 上服务连接运行时,提供认证、有效载荷限制和最后期限;提供接取运输.

如何安装 @godspeedai/cognate-protocol-connect-bun?

在项目目录运行 npm install @godspeedai/cognate-protocol-connect-bun,或使用 pnpm add / yarn add / bun add。

@godspeedai/cognate-protocol-connect-bun 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/godspeedai__cognate-protocol-connect-bun 是否存在。

@godspeedai/cognate-protocol-connect-bun 支持 ESM 还是 CommonJS?

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

@godspeedai/cognate-protocol-connect-bun 可以商用吗?

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

@godspeedai/cognate-protocol-connect-bun 的下载量有多少?

根据 npm 官方下载统计,@godspeedai/cognate-protocol-connect-bun 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,362 次,日均约 112 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@godspeedai/cognate-protocol-connect-bun 还在维护吗?

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