@ agentplat/ 房间

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

Opt-in后续源添加提供版本状态,授权 多室变化为现有 内存分类账. 见 渐进后续行动。 。 。 .

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

安装( 开发者预览)

明确安装协调预览 :

npm install @agentplat/rooms@next

全部留着 @agentplat/* 软件包在同一版本中。 npm 的默认 latest 标记可以指向更古老的预览。 见 释放通道 用于发行状态和版本选择.

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

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

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

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 端口 .

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的运行时简介 消化系统 寿命周期状态通过比较和设置分别存储和推进:

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会议发言人成为会议室与会者 和限定的会议记录成为普通会议室信息;无秒 采用了持久的模拟模型.

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 绑定 :

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,没有治理 头曰. 不将目的候选人复制到不受约束的参与者运行时间和 将此解释为支持目的执行。 初始记录和所有者授权的配置在源头实施. 选入指令执行配置描述如下; 目的激活 现在需要以下所述的合格的特派团组成. 见 实施计划。 。 。 .

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

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

概念和评估(来源预览)

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

注意信号( 源预览)

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

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

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

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

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

见 管理连续性 目标8:祖先预算、混合模式交易、模型替换和合格演化收入.

运行 持续支助示范 比较指令和目的模式、所有者更正和进程重新启动与PostgreSQL.

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

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

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

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