@dharma-ai-labs/agent-fabric-provider-adapters

中文文档
0.1.41发布于 2026/11/09MITTypeScriptES Module构建来源已验证近 30 天下载 3567

Capability-scoped Codex, Claude Code, Agy, and Hermes adapters for Dharma Agent Fabric

原始使用文档

@dharma-ai-labs/agent-fabric-provider-adapters

Capability-scoped local adapters for Codex, Claude Code, Agy, and Hermes Agent. Each adapter reports evidence discovery, task execution, continuation, Skill installation, activation, rollback, and usage support independently. Evidence support never implies that another capability is available. Agy 1.1.13 remains limited to partial read-only execution and evidence. Agy 1.1.15 adds content-bound Skill activation and transactional rollback through the Dharma CLI, but consequential task effects remain unavailable because Agy still lacks path- and command-scoped effect acknowledgements.

Hermes 0.20.4 uses its supported redacted JSONL session export, safe-mode one-shot task interface, project Skill trust command, and local Skill listing. The adapter permits read-only tasks only after Hermes reports a configured inference provider. Skill discovery and activation do not imply that model execution is configured.

The experimental retained Codex app-server session bridge is qualified on Linux only. Native Windows probes accepted a permission-profile declaration without enforcing it when the sandbox was not configured; the configured sandbox did not pass the permitted-read control. Other hosts therefore fail before provider dispatch with codex_session_sandbox_unqualified. Do not widen filesystem access or disable the sandbox to work around this gate. This restriction does not change ordinary enrollment, relay startup, or the separate provider task interfaces.

Named local Codex work retains the exact turn/start request and bounded, exact-thread/turn notifications in the encrypted local vault. Version 2 captures bind that request's text, workspace and restricted permission profile by hash; version 1 notification-only captures remain readable. Work prompts containing recognizable credentials are rejected before intent persistence or dispatch. Its success or failure receipt references hashes and explicit coverage; raw requests and notifications are never added to CLI output. Early events are attributed only after the provider identifies the turn. Missing scope, excluded credentials, interrupted turns and capture limits remain visible limitations. Existing raw-evidence retention applies to these captures.

The approved evidence outbox includes the request under the existing disclosure policy. This is request-and-notification evidence, not retained session context, verified skill adoption or an attestation of the execution model. acceptedLearningObservation remains false: local completion and capture do not establish server intake, an automatic policy counter, a replay evaluation, canary approval or a signed learning release.

Licensed under MIT.

Task Knowledge Transport

The task-local knowledge server uses MCP SDK server 2.3.0 over stdio, with a fresh server factory for each transport and an explicit 1,024-element raw tool-input budget. The existing document, page and response limits remain in force. The normal valid client continues after an oversized request is rejected; separate stdio clients retain their own receipt-pinned catalog scope.

This adapter does not expose an HTTP transport or bearer-authentication endpoint. These tests do not qualify an HTTP deployment, shared HTTP transport, audience validation or HTTP body limits. Introducing such a deployment requires separate transport and authorization qualification, not reuse of stdio evidence.

版本与发布记录

@dharma-ai-labs/agent-fabric-provider-adapters 共发布 40 个版本,首次发布于 2026/08/09;过去 12 个月发布了 40 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.41latest2026/11/093 天前
0.1.402026/11/066 天前
0.1.392026/10/3112 天前
0.1.372026/10/2122 天前
0.1.362026/10/1627 天前
0.1.352026/10/1627 天前

关于 @dharma-ai-labs/agent-fabric-provider-adapters 的常见问题

@dharma-ai-labs/agent-fabric-provider-adapters 是什么?

Capability-scoped Codex, Claude Code, Agy, and Hermes adapters for Dharma Agent Fabric

如何安装 @dharma-ai-labs/agent-fabric-provider-adapters?

在项目目录运行 npm install @dharma-ai-labs/agent-fabric-provider-adapters,或使用 pnpm add / yarn add / bun add。

@dharma-ai-labs/agent-fabric-provider-adapters 支持 TypeScript 吗?

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

@dharma-ai-labs/agent-fabric-provider-adapters 支持 ESM 还是 CommonJS?

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

@dharma-ai-labs/agent-fabric-provider-adapters 可以商用吗?

@dharma-ai-labs/agent-fabric-provider-adapters 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@dharma-ai-labs/agent-fabric-provider-adapters 的下载量有多少?

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

@dharma-ai-labs/agent-fabric-provider-adapters 还在维护吗?

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