# @agentplat/rooms 中文文档

规范地址：https://npmcn.com/package/%40agentplat/rooms/

版本：1\.5\.1
npm 元数据更新时间：2026-11-03T19:55:29.259Z
中文译文更新时间：2026-11-07T00:08:52.342Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agentplat/rooms
原文对照：https://npmcn.com/package/%40agentplat/rooms/?lang=original
项目主页：https://github.com/Agentplat/agentplat#readme
源码仓库：https://github.com/Agentplat/agentplat

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.6 MB，207 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2026-07-14T22:41:30.523Z
- 最新版本发布：2026-11-03T19:55:28.907Z
- 近 30 天下载量：2128（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

代理房间域,生命周期服务以及代理Plat的本地适配器.

## 安装

```sh
npm install @agentplat/rooms
```

也可以使用：`pnpm add @agentplat/rooms`、`yarn add @agentplat/rooms`、`bun add @agentplat/rooms`

## README

# @ agentplat/ 房间

基础设施中立代理房域合同和生命周期服务.

Opt-in后续源添加提供版本状态,授权 多室变化为现有 内存分类账. 见 [渐进后续行动](https://npmcn.com/package/docs/planner/incremental-followup.md)。 。 。 .

本地对话源添加提供了根线条、答复、直接 收件人和信件页面。 串行任务默认为选择性上下文; 规划/工作流程电话和通知保持其对话身份. 见 [合同、授权和收养](https://npmcn.com/package/docs/planner/conversations.md)。 。 。 .

## 安装( 开发者预览)

明确安装协调预览 :

```sh
npm install @agentplat/rooms@next
```

全部留着 `@agentplat/*` 软件包在同一版本中。 npm 的默认 `latest` 标记可以指向更古老的预览。 见 [释放通道](https://github.com/Agentplat/agentplat/blob/main/docs/release-channels.md) 用于发行状态和版本选择.

`RoomService` 协调房间状态,参与者,信息,任务,文物, 批准、政策检查、限定的上下文和持久的域事件。 储存, 代理执行和事件交付通过公共接口注入.

核准可宣布 `expiresAt`. 人类的决定只有在之前有效 ; 授权主机可以应用单独的再播放安全 `requested → expired` 过渡。 过期是可审计的,永远不能成为 核准.

```ts
import { InMemoryRoomRepository, RoomService } from "@agentplat/rooms";

const service = new RoomService({
  repository: new InMemoryRoomRepository(),
});

const room = await service.createRoom("tenant-a", {
  title: "Product launch",
  goal: "Prepare a launch brief",
});
```

使用 `@agentplat/rooms-postgres` 用于长期自备部署。 这个 用于测试和实例.

## 信件路径

Agent Rooms可以选择不连接的提供者中性消息路由 域名至工作流程引擎或模型提供者。 明确的与会者参考资料 在咨询注入路由器之前,确定是否解决,以及 仅当前两个阶段都不存在时才使用已声明的默认参与者 任务.

```ts
import {
  AgentRoomCoordinator,
  PolicyBoundRoomRoutingStrategy,
} from "@agentplat/rooms";

const coordinator = new AgentRoomCoordinator(
  roomService,
  new PolicyBoundRoomRoutingStrategy({
    select: async (request) => chooseEligibleParticipant(request),
  }),
);

const decision = await coordinator.routeMessage({
  tenantId: "tenant-a",
  roomId: room.id,
  messageId: message.id,
  defaultParticipantId: assistant.id,
});
```

运行只返回参与者标识符 。 应用程序仍在创建和 运行普通的政策检查室任务,所以路径不能授予工具或效果 权力。 路由器受限于由下列人员提供的合格参与者: 代理室协调员.

## 递增事件为

`RoomService.listEventPage` 返回仅附加的室事件 带有限制页面大小和明确位置的室内光标 `hasMore` 旗帜。 这个 房间 API 显示此模式 `GET /rooms/:roomId/events?cursor=...&limit=...`。 。 。 . 调用没有两个查询参数的路由保留了原始的完整 向后兼容的事件列表响应.

## 执行会议和即时人员干预

`RoomExecutionCoordinator` 将一个已修改的执行会话绑定到运行中 `RoomRun`其储存使用比较和设定的修订,从而同时进行干预 请求不能默默地相互覆盖。 包含的记忆店是 \* 实施持久部署 同样的 `RoomExecutionSessionStore` 端口 .

```ts
import {
  InMemoryRoomExecutionSessionStore,
  RoomExecutionCoordinator,
} from "@agentplat/rooms";

const execution = new RoomExecutionCoordinator(
  roomService,
  new InMemoryRoomExecutionSessionStore(),
);

const session = await execution.openSession({
  tenantId: "tenant-a",
  roomId: room.id,
  sessionId: "execution-1",
  runId: run.id,
  agentRevisionId: "research-agent@4",
});

await execution.requestIntervention({
  tenantId: "tenant-a",
  roomId: room.id,
  sessionId: session.sessionId,
  expectedRevision: session.revision,
  operationId: "intervention-1",
  requestedByParticipantId: human.id,
  instruction: "Use the approved pricing assumptions.",
});
```

只有人类参与者才明确接受干预措施 `run.intervene` 允许,并且只在捆绑室运行仍在活动时。 稳定操作 ID 精确 重放"一能"并拒绝相冲突的再利用. 决议记录是否 适用或拒绝干预;没有扩大参与权, 工具权限或房间政策.

后继执行会话只有在失败的前身时才能引用 继续同一个房间的任务. `reconcileSession` 项目终端 `RoomRun` 状态到执行会话中,而不重放提供者效果.

### 持久干预派遣

`RunInterventionDispatcher` 索赔1项待理 以有限度的租约设立的检查站。 同工使用执行会议 修改为栅栏边界。 如果适配器呼叫失败, 索赔仍为 租赁和另一名工人在期满后才能重新试验 在各种尝试中,钥匙保持稳定.

`CognitiveRunInterventionAdapter` 映射到运行时 V2 认知 `intervention` 操作。 它将请求与认知会话联系在一起 修订、租户、代理人、房间运行、检查站、权威摘要和角色约束 消化系统 已完成的认知操作标志着采用的干预措施; 被拒绝、弃权或失败的结果被记录为被拒绝.

执行会话按修订顺序保存,可在 序列号。 执行会话将发言限制在256个,以 关联事件历史.

## 版本代理定义

`AgentDefinitionRegistry` 将稳定剂身份与不可改变身份区分开来, 内容处理定义修订。 修订会约束指令, 能力、工具、知识参考和SHA-256的运行时简介 消化系统 寿命周期状态通过比较和设置分别存储和推进:

```text
draft → published → deprecated
```

重新使用内容不同的语义版本被拒绝. 精确创建 重放返回现有版本 。 可配置新的执行会话 需要公布修订;然后登记册核实指定的会议室 参与者、注册代理身份和运行时平台,然后存储 修改会话中的ID和摘要.

内存登记商店支持当地的开发和测试. `@agentplat/rooms-postgres` 提供持久的多进程适配器.

## 统一直播视图

`AgentRoomLiveViewService` 结合了房间的总和,协调状态, 活动运行、执行会话、交接、人力贡献、外部 交付和增量活动。 其复合光标只跟踪每个附件 独立来源,而 API 则同时暴露 限制投票和a 版本为SSE流. 当商店提供房间扫描列表时,执行 会议、交易、计划、贡献、成员和交付 自动发现; 呼叫者不需要维护标识符列表.

PostgreSQL 部署可以使用统一的操作事件读取器作为 增量来源。 溪流与每个源进行交易 ,而单独的持久检查站则记录投影仪的进展.

## 持久的协调失败

在索赔项目上一直存在协调失误,而且有稳定的误差 代码、 分类、 编辑后的信件、 可重试性和下一个尝试时间戳. 瞬变/内部故障使用有限度的指数后退并保持相同 操作ID 跨越尝试。 政策、验证和配置失败 不自动重试.

## 类型规划和参与者成员

`AgentRoomPlannerBridge` 实现按订单打入房间任务的计划, 人的贡献,批准和代理Plat交易。 决定性的ID制作 重新启动回收等同体, 而重新规划则必须延长精确的前身 版本。 步骤只有在依赖之后才能逐步实现 完成; 事件驱动调节更新步骤状态, 解锁新准备 工作并记录终端完成或故障.

`RoomParticipantMembershipCoordinator` 已订正 `invited`, (中文(简体) ), `enabled`, (中文(简体) ), `suspended` 财务报告和审定财务报表 `left` 国家、路线、交易资格和 允许代理人在不改变以往参与者记录的情况下进行修改.

## 代理掌上电脑

`AgentRoomHandoffCoordinator` 限定的工作背景和所有权 代表与会者之间不依赖免费代表团文本。 A 类 Handoff 绑定源和目标参与者,源运行/任务,已公布代理 修订、选定的电文/艺术参考资料和非扩展权限 上限.

目标必须明确接受 `handoff.accept` 允许之前 应用程序可以绑定运行中的目标 `RoomRun`经修改后的过渡, 最大深度、自我授权拒绝、参与者-路径周期检测和 房间范围上下文验证会限制代表团。 终端目标运行 调和 Handoff 到 `completed` 或者说 `failed`;回收可能仅指a 失败的前身 .

## 持久的协调循环

`AgentRoomCoordinationRuntime` 为持续会议室提供修改后的收件箱 留言和接受代理Plat交易。 工人根据一项索赔 范围租赁、重复使用跨复试的稳定操作ID、路线信息 合格参与者和通过注射方式提供接受的工作 提供者中性执行端口.

设定 `automaticCoordination: {}` 打开 `RoomService` 使人类或物剂长期存在 信息、其会议室域名活动及其初始协调项目 仓库交易。 默认协调身份是 `room:<roomId>`· ; 应用程序可提供确定性 `coordinationId` 函数。 如果 仓库无法存储协调项, 完整消息 交易卷回.

跑道围栏的修饰和租赁所有权的丧失。 适配器失败 租赁期满后可收回索赔项目;成功 调度记录运行ID,并将房间协调预测转换到 `executing`, (中文(简体) ), `waiting_for_human` 或者说 `completed`。应用程序解决活动 物品在约束运行或人类贡献后完成.

`DefaultAgentRoomCoordinationExecutionPort` 是标准桥从 协调循环到 `RoomService`它从稳定的角度创造了决定性的任务 操作 ID, 选择已公布的代理修改, 引用普通 政策检查 `RoomRun`,在提供者发送前打开执行会话, ,并在完成后调节会话。 精确重试完成再利用 任务和运行。 已接受的交接器转换为目标任务, 并绑定 他们的跑步在终极状态是活跃的和和解的.

`RoomService.runTask` 接受可选后向兼容 `onStarted` 钩子 (a) 长期续租后,并在使用供应商之前。 这个 用于在 外部计算开始.

`AgentRoomCoordinationWorker` 不断发现协调状态 从执行的仓库中 `listReady`它支持限定货币, 投票加上醒目 租借心跳续展 优雅的停站和排水, 和总周期指标。 其可选 `beforePoll` 钩子可以推进 操作投影仪,然后要求新接受的处理.

### 注意检查站的执行

房间运行引用 `pre_step` 在提供者执行之前 `post_output` 在此之前 取得了成功的结果。 执行工具或外部工具的供应商 效力必须声明和援引 `pre_action`; 保护的任务在之前失败 在没有这种能力时发送供应商 `requireProtectedActionCheckpoints` 已启用。 执行选项默认 用于当前放行中的后向兼容性.

`InterventionAwareRoomRunCheckpointHandler` \* 减少长期干预 当前检查站通过 `RunInterventionDispatcher`应用 在继续工作之前,干预工作将推进执行会议的修订。 A 类 拒绝干预或检查站的决定没有扩大而关闭 权力、工具或政策.

## 人类的贡献

`HumanContributionCoordinator` 人类长期工作模式 核准。 请求含有指令、预期产出、依赖性、阻断 行为 任选任务和最后期限 经修改的过渡涵盖范围 `requested`, (中文(简体) ), `assigned`, (中文(简体) ), `in_progress`, (中文(简体) ), `completed`, (中文(简体) ), `canceled` 财务报告和审定财务报表 `expired`。 。 。 .

明确授权适用于请求、指派、完成和取消. 只有指定的人类参与者才能开始或完成工作,并参考 文物必须属于特工室 已完成的缴款可按顺序排列a 协调项目 `waiting_for_human`。 。 。 .

`WorkManagementProvider` 和交货储存合同保持外部任务 系统在提供者中立的发包箱边界后。 外部地位为 agentPlat 人类贡献的完成情况 权威协调信号.

`WorkManagementDeliveryRuntime` 将边界与一元化操作 排队、CAS索赔、有限度的租赁、指数式倒置、尝试限制、, 提供者查找调节和稳定的一能键。 提供者任务为 创建一次并更新,供以后的捐款修订。 计量报告队列 数和最老的待交付. `LocalWorkManagementProvider` 是一个 用于测试和局部开发的决定性参考适配器.

## 知识和室用工具桥梁

`KnowledgeBundleRegistry` 存储不可改变的、以内容为主的知识捆绑 订正。 每个语义版本绑定在一份SHA-256文摘上,文件是 大小/计数,精确的重试返回现有的修订。 发表 通过代理定义的参考捆绑 `knowledgeRefs`。 。 。 .

`registerAgentRoomToolBridges` 安装中立的供应商工具,用于列表和 阅读授权的知识、保存/搜索范围内存和释放 变相文物. 记忆和文物经过 `RoomService`,保留 租户隔离、政策界限和出处。 标准知识 解析器从已公布的代理修订而不是模型读取参考文献 输入.

## 促进会议

`promoteSessionToRoom` 解剖学上将完成的麻黄模拟变成 管理房间通过 `RoomService`会议发言人成为会议室与会者 和限定的会议记录成为普通会议室信息;无秒 采用了持久的模拟模型.

```ts
import { promoteSessionToRoom } from "@agentplat/rooms";

const promotion = await promoteSessionToRoom(service, {
  tenantId: "tenant-a",
  session: sessionResult,
  speakers,
  room: {
    title: "Approved negotiation",
    goal: "Review and operationalize the simulated agreement",
  },
});
```

需要完成的会议 `allowIncomplete: true`. 晋升记录来源 会话、转弯和时间戳元数据,使消费者不会错误输入的 最初写在房间生命周期内的留言记录.

## 代理交互配置( 源代码预览)

定义修改接受可选 `interaction` 绑定 :

```ts
const instruction = { schemaVersion: 1, interactionMode: "instruction" } as const;
const purpose = {
  schemaVersion: 1,
  interactionMode: "purpose",
  governanceId: "retention-governance-v1",
} as const;
// Pass either as `interaction` to AgentDefinitionRegistry.createRevision(...).
```

Omiting the field 保存了遗产指导行为和犬科摘要. 明确的约束包括在不可改变的定义摘要中。 使用 `resolveAgentInteractionBindingV1(definition)` 检查配置的模式; 元数据和运行时间配置文件不能覆盖它。 无效的约束被否决 .

目的修改为: **仅限候选人**: 存储和发布不验证 治理参考或激活执行. `resolvePublishedRevision` 财务报告和审定财务报表 默认的协调执行端口在工作前拒绝目的候选人 创建。 混合接收批次在发送前预先飞行. 指令 特工可以继续 在一个房间 包含目的候选人.

这不是一个全系统的施政执行主张:直接 `RoomService` 任务和自定义执行整合仍然是遗留的API,没有治理 头曰. 不将目的候选人复制到不受约束的参与者运行时间和 将此解释为支持目的执行。 初始记录和所有者授权的配置在源头实施. 选入指令执行配置描述如下; 目的激活 现在需要以下所述的合格的特派团组成. 见 [实施计划](https://npmcn.com/package/docs/agent-governance/implementation-plan.md)。 。 。 .

## 被动所有者治理( 源预览)

`AgentGovernanceServiceV1` 财务报告和审定财务报表 `InMemoryAgentGovernanceStoreV1` 仅提供所有者 目标/模式配置、范围已到期代表、修订 历史和两党所有权转让。 输入主机验证认证 和授权端口; 呼叫者提供的行为人ID不能确定所有权. 新配置开始被暂停; 已接受的指令代理现在可以使用 下述选择适用执行概况. 见 [配置和 API 使用情况](https://npmcn.com/package/docs/agent-governance/configuration.md)。 。 。 .

## 概念和评估(来源预览)

`AgentInceptionServiceV1` 存储来自持续会议室信息和 5项评估结果,与治理和范围证据挂钩。 它规定 仅用化学文摘社/专有性和惰性工作提案来重新评估. 使用 `InMemoryAgentInceptionStoreV1` 和同一个内幕治理商店. 见 [初始用户](https://npmcn.com/package/docs/agent-governance/inceptions.md)。 。 。 .

## 注意信号( 源预览)

`AttentionSignalServiceV1` 财务报告和审定财务报表 `InMemoryAttentionSignalStoreV1` 提供不可改变 信号/参考目录、经认证的观测、新鲜度覆盖和 极限持久评价唤醒. 拥有/删除配置使用已有 管理; 收藏家和工人的许可是分开的。 主机调度勾选 并提供一能评价汇。 见 [信号](https://npmcn.com/package/docs/agent-governance/signals.md)。 。 。 .

## 管理指令执行( 源代码预览)

`AgentExecutionControllerV1`, (中文(简体) ), `AgentExecutionLimitServiceV1` 财务报告和审定财务报表 `InMemoryAgentExecutionStoreV1` 添加适配器录入,不可改变的待处理任务绑定, 检查、强制限制和累积保留。 选择通过 客房服务 `executionGovernance` 财务报告和审定财务报表 `requireGovernedExecution` 选项。 激活 由所有者控制;目的模式需要合格的特派团组成. 见 [执行和对账](https://npmcn.com/package/docs/agent-governance/execution.md)。 。 。 .

## 限定目的任务周期(来源预览)

`PurposeMissionServiceV1` 将现有的会议室计划与特派团范围的发放结合起来, 目前的证据审议、指导性工作和结果审查。 传过来 `control()` 到执行控制器,并使用对接的任务/执行后端。 可选 `createPurposeRoomInputPortV1` 将普通消息引导到启动, 永远不要任务 . 目的执行只能通过这种构成;单独出版 仍然没有创造任何权威。 见 [特派团](https://npmcn.com/package/docs/agent-governance/missions.md)。 。 。 .

见 [管理连续性](https://npmcn.com/package/docs/agent-governance/continuity.md) 目标8:祖先预算、混合模式交易、模型替换和合格演化收入.

运行 [持续支助示范](https://npmcn.com/package/examples/agent-purpose-support/README.md) 比较指令和目的模式、所有者更正和进程重新启动与PostgreSQL.

## 版本内存和受控定义的更改(源文件配置)

`MemoryRevisionServiceV1` 添加个人选择/共享修改后内存 核查出入港、有效性、退休和不可改变的历史. `resolveMemoryRevisionSnapshotV1` 财务报告和审定财务报表 `registerMemoryRevisionReadToolV1` 共享 授权视图 . `AgentDefinitionChangeServiceV1` 组成现有的房间批准, 评价证据和治理,用于审查定义的选择/逆转. 见 [融合和限制](https://npmcn.com/package/docs/architecture/persistent-agent-learning-implementation.md)。 。 。 .

### 分担的定期预算和计划的后续行动

Opt-in source APIs 在所有计划/理由/任务/审查/直接之间添加一个共享账户 电话和其他模范工作,加时间戳意图和准备通知递送. 它们重新使用现有工作流程的结果所有权并保存未知的成本/交付 和解的结果。 供应商经核实的身份、日历/紧急情况 政策、价格和运输适应器。 见 [指南](https://npmcn.com/package/docs/planner/shared-budgets-and-notices.md) 财务报告和审定财务报表 [两个消费者实例](https://npmcn.com/package/examples/planner-operations.mjs)。分发为 待定;这些来源的API不安装工人或联系供应商.

## 常见问题

### @agentplat/rooms 是什么？

代理房间域,生命周期服务以及代理Plat的本地适配器\.

### 如何安装 @agentplat/rooms？

在项目目录运行 npm install @agentplat/rooms，或使用 pnpm add / yarn add / bun add。

### @agentplat/rooms 支持 TypeScript 吗？

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

### @agentplat/rooms 支持 ESM 还是 CommonJS？

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

### @agentplat/rooms 可以商用吗？

@agentplat/rooms 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @agentplat/rooms 的下载量有多少？

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

### @agentplat/rooms 还在维护吗？

最新版本 1\.5\.1 发布于 2026/11/04（4 天前）；至今共发布 28 个版本，其中过去 12 个月发布了 28 个；首次发布于 2026/07/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。