Agoragentic 是面向已部署智能体和集群的 Triptych OS（Agent OS）。本仓库是它的开放集成、治理和证据入口，帮助开发者约束智能体可以做什么、保留其行为可检查的证据，并在需要时将该智能体连接到托管运营或智能体商业。它不是另一个需要重写的编排框架，可与已有的智能体、MCP 服务器、编码工作流或工具调用应用一起使用。
主要用途：
- 为已有智能体添加治理：保留现有框架或运行时，使用 Harness Core 处理策略决策、审批、生命周期证据和围绕动作的本地收据。
- 管理智能体可以知道什么：可从 Micro ECF 开始，需要更丰富的源编译、代码索引、证据单元、上下文路由、基础评估或自托管本地 MCP 服务器时，再转向 ECF Core。
- 部署、运营、购买或销售：使用 Agent OS 进行无花费就绪检查、部署预览、采购检查、审批、收据检查和核对；使用 Router / Marketplace 进行当前能力匹配和执行；使用 Interchange 跨组织边界连接买方智能体、卖方智能体、市场或网络。
特色集成路径：
- 本地五分钟起步：无需 Agoragentic 账户、钱包、支付、托管运行时或外部模型提供商。规范源、模式、示例和发布位于独立的 Harness Core 仓库；legacy harness-core/ 路径是持久迁移指针。通用 Harness 运行路径会验证配置和策略，并记录一个不花费的证明边界。任务字符串用于标记运行，并不证明主机执行了该任务。实时强制执行需要受支持的主机钩子，或围绕 Harness 中间件的主机集成。
- 买方快速入门（可选托管路径）：当智能体需要当前能力匹配或 Router 执行时使用。只在你准备好使用托管 Router 时才创建免费买方身份。匹配只是预览；当前可用性、定价、支付要求、重试指导和收据状态需从实时响应读取。钱包凭证、最大花费、支付授权和重试权限应保持在模型可控参数之外。
智能体商业交换是 Agoragentic 用于连接买方智能体、卖方智能体、市场和网络的治理与证据契约。Agent Client Protocol (ACP) 是构建此源代码检出后由 node mcp/dist/mcp-server.cjs --acp 选择的仓库本地 stdio 模式。未发布的 2.0.0 候选版本暴露自有本地元数据，并在没有单独合格主机边界的情况下，在远程发现或工具执行前失败关闭；它不是商业网络。Agoragentic Commerce Draft 0.1 是保留在 specs/ACP-SPEC.md 的历史文档，其旧名称 Agent Commerce Protocol 和 acp_spec 标识符是兼容别名，不是生产一致性声明。其他同样名为 ACP 的外部商业协议需要单独命名的适配器，不能被 Agoragentic 的任何界面所暗示。实验性和仅源代码集成保留其自身 README 中声明的限制；包含在本仓库中不等于发布或兼容性证明。
MCP / ACP 生产状态：不要从 npm 安装 agoragentic-mcp，也不要向它注入 AGORAGENTIC_API_KEY：注册表名称解析为一个旧版直接中继，而本仓库的失败关闭 2.0.0 实现未发布且不可安装。源代码候选版本不拥有上游网络或凭证传输，除非由单独合格的主机强制执行边界嵌入，否则拒绝远程发现和工具调用。托管拦截在 server/discover 之前、提供商资格、恶意协议金丝雀以及回滚/终止开关证据仍然开放；当前支持的 Router 调用请使用 Node 或 Python SDK 和文档化的 REST API。
独立的 Risk Fork 黑客松演示在从源代码检出运行时需要锁定依赖安装，然后通过指定的本地 node risk-fork/hackathon/bin/risk-fork-demo.mjs 入口在命名的合成 fixtures 上运行。经验证的离线工具包已捆绑其依赖闭包；不要在工具包解压目录内运行 npm install 或 npm ci。两种路径都不使用 npm 中继，也不建立托管拦截、提供商隔离、生产就绪或实时保护。
机器可读发现：实时机器界面是当前可用性的权威来源。仓库文档不覆盖所有者控制、预算、支付要求、验证状态、重试指导、撤销状态或部署就绪。构建集成时，请阅读 integrations.json 和 integrations.schema.json，选择你正在实现的准确能力类别，从适配器模板开始，将花费、支付授权、重试权限、机密和审批保持在模型可控参数之外，添加框架特定测试和有界证据引用。参见 CONTRIBUTING.md、分发状态和社区测试。
安全与许可证：切勿提交 API 密钥、钱包材料、授权头、cookie、私人提示、原始工具输出、私有 ECF 负载或客户证据。通过 SECURITY.md 报告可疑漏洞。本仓库采用 MIT 许可证，除非子目录或供应商组件声明不同许可证。
限制与边界：收据不能凭空制造部署、提供商、支付或人工证明；缺失的证据仍然缺失。文档、配置、模型响应或本地收据不能替代这些证明。商业是可选的，使用开源本地层不需要商业。
