运算( R)@fungi.computer/graft(中文(简体) )

此套件通过稳定剂呈现授权的Shiitake会话 客户协议 (ACP) v1. 编辑器和主机集成使用它来创建,加载, 快速并观察会话,而东道主仍然负责 授权.

只要真菌在Zed 或者另一个ACP编辑? 运行 fungi acp 看到了吗 在编辑器中使用真菌。 。 。 . (笑声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声).

安装或设置

npm install @fungi.computer/graft

严格的类型Script 消费者也安装 @modelcontextprotocol/[email protected]页:1 转录 Google GenAI 声明参考了这个可选对等点.

快开始

只要真菌在Zed 或者另一个ACP编辑? 运行 fungi acp 看到了吗 在编辑器中使用真菌。 。 。 . (笑声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声).

这个自成一体的例子在不批准的情况下初始化了非加太连接 访问任何会话。 用主机替换拒绝目录 接受创建或加载请求前授权的会议目录.

import * as acp from "@agentclientprotocol/sdk";
import { createHttpStream } from "@agentclientprotocol/sdk/experimental/http-client";
import {
  agentAcpMethods,
  type AuthorizedShiitakeSessionDirectory,
} from "@fungi.computer/graft";
import { createShiitakeAcpServer } from "@fungi.computer/graft/server";

const directory: AuthorizedShiitakeSessionDirectory = {
  create() {
    return Promise.reject(new Error("Session access is not granted"));
  },
  load() {
    return Promise.reject(new Error("Session access is not granted"));
  },
};
const server = createShiitakeAcpServer(directory);
const stream = createHttpStream("https://agent.test/acp", {
  fetch: (input, init) => server.handleRequest(new Request(input, init)),
});
try {
  await acp
    .client({ name: "graft-example" })
    .connectWith(stream, async (ctx) => {
      const initialized = await ctx.request(agentAcpMethods.initialize, {
        protocolVersion: acp.PROTOCOL_VERSION,
      });
      console.log(initialized.protocolVersion);
    });
} finally {
  await stream.writable.close();
  await server.close();
}

抓取适配器调用服务器进行中; 它不提出网络请求和 不需要模型或证书。 装入的运行时间证明 test/stranger/runtime.mjs 使用 节点. test/index.test.ts 额外证明会话 通过保持的非加太客户端创建、激励和清理.

核心概念

• 该目录拥有访问权限. 内容 create 财务报告和审定财务报表 load 方法返回 a 会话只有在主机授权后才具有约束力 。 它可以验证工作 目录,额外的目录,以及会话开幕前的MCP服务器.
• 师取自会州. 非加太适应器项目信息、工具 电话、进度、取消和终端结果。 它不拥有 记录或删除持久会话.
• 非加太公司的连接拥有其租约. 关闭会话或连接发布 其东道方提供的客户租赁和观察。 活动提示被取消 并允许在其会话中默认和解达5秒 关闭.
• 服务器是一个适配器. createShiitakeAcpServer 暴露同一个特工 通过维持的可流式HTTP运输;不提供 自行授权.

API 参考

软件包导出 createShiitakeAcpAgent,授权和适配器 类型,以及 agentAcpMethods 从 src/index.ts. HTTP 软件 服务器从 src/server.ts编辑 主机拥有的目录适配器在 src/session-directory.ts生成 API 参考 列入柏油丸.

实例

• test/index.test.ts 证明创建/ 装入/ 即时行为 , 通过维护的流媒体消息投影、取消和清理 ACP客户端.
• 私人本地 stdio 主机目前拒绝 ACP additionalDirectories 财务报告和审定财务报表 mcpServers;其他主机在其授权边界时可能支持它们 允许他们.

限制和错误

适配器支持文本和图像提示,嵌入文本或图像资源, 和文本或图像工具结果。 音频和其他二进制资源被拒绝. A 类 主机决定连接的目录、 MCP 服务器和会话 使用时。 非加太创建请求不能提供它们自己的稳定重试身份,所以 目录生成Shiitake的请求身份。 打电话者必须关闭非加太公司 连接,从而解除手表和授权租赁;关闭租赁 不删除会话.

贡献和许可证

运行 pnpm --filter @fungi.computer/graft test 《非加太国家议定书》 生命周期测试,以及 pnpm --filter @fungi.computer/graft build 汇编 软件包。 将装满的焦油丸当作陌生人安装:

pnpm install --frozen-lockfile
pnpm turbo:run run build [email protected]/graft
pnpm --filter @fungi.computer/graft run pack
pnpm --filter @fungi.computer/graft run stranger

陌生人的证明 包装的依赖关闭 并安装在新鲜的 用户已启用图书馆检查 。 软件包使用 MIT 许可证在 LICENSE。 。 。 .

编辑能力

适配器使用ACP SDK 1.7并稳定协议v1. 初始化返回 支持协议版本,即使一个编辑器提供了另一个版本 编辑器决定它是否可以继续。 仅当 授权主机目录提供它。 本地列表保存了工程会话 .

主机可能提供终端登录方法. 只有编辑才登广告 支持终端认证; 编辑器在 a 中运行登录命令 单独的交互式进程。 主机目录不获取本地 证书.

文本资源及时保留其URI和内容。 资源链接 保留他们的名字和URI 供特工授权的工具解决 图像, 包括嵌入式图像资源,请输入Shiitake 的限速录入 并持续作为皮伊图像的内容。 历史通过ACP回放图像. 音频和 其他二进制资源返回 invalid_params它们不是被悄悄抛弃的.

参考议定书: 初始化 财务报告和审定财务报表 内容。 。 。 .