Shiitake 扩展@fungi.computer/shiitake-extensions(中文(简体) )

真人特工背后的扩展: 一个特工问你的问题,目标 反复循环 计划 时间表 技能 家用电脑 及其子剂一足. 添加到任意 Shi 拥有一个名册的主机.

安装

npm install @fungi.computer/shiitake-extensions @fungi.computer/shiitake

对照完整的公开声明汇编,并安装 @modelcontextprotocol/[email protected];共享提供者 SDK 导入这些类型 通过可选的对等点。 这不需要供应商账户.

主机通行证 botanicalAgentExtensions 作为它的诗句 extensions 选项。 这个 仍然提供 SQLite 拥有者、 运行时提醒、 模型和指令源以及 任何工具的沙盒。 名册不提供供应商证书或资源 权限.

本地主机用途 botanicalExtensionsWithSkills(source) 换句话说 仅读 SkillSource 拥有发现和文件访问. skillsExtension({source}) 用途 页:1 prompt, (中文(简体) ), run_tools 财务报告和审定财务报表 commands 赠款:元数据输入即时, 时 skill.load({name, file?}) 返回正文或辅助文件通过 现有 execute 工具。 这是一个饲料操作,而不是一个顶级的工具。 这个 人类 /skills 命令列出每个发现的技巧,除此之外 SKILL.md 路径, 加上未加载其他条目的原因; 选择一个则显示其 说明。 命令在同步核心交易中运行, 所以 /skills 读取最新发现,在激活时和每个模型请求之前. 空目录表示没有安装技能; 无效的条目报告 a 修行因缘. 工具发现摘要保留在Forage的元数据界限内 并标出缩短的上市时间; 提示仍然列出每个被承认的技能。 这个 中心使用没有技能的共享名册,并增加了自己的范围 扩展名.

快速开始:读取承诺的目标

说明:该助手收到一个已打开的产品名册代理 并读取一个会话的入球位置。 新会话没有目标值 。 这个 帮助者既不请求模型工作,也不请求目标突变.

import {
  bindSessionExtension,
  type ShiitakeAgent,
} from "@fungi.computer/shiitake/client";
import { goalContract } from "@fungi.computer/shiitake-extensions/goal";
import { botanicalAgentExtensions } from "@fungi.computer/shiitake-extensions/roster";

export const extensions = botanicalAgentExtensions;

export async function readGoal(agent: ShiitakeAgent) {
  const session = agent.session("example-session");
  const goal = bindSessionExtension(session, goalContract);
  return goal.view(await session.read());
}

约束视图区分 unavailable, (中文(简体) ), stopped 有原因,还有 running 含有数值或 null现有 目标测试 绑定 同一合同,读取观察状态,发布命令并关闭所有者。 这个 帮手借那个特工 它的主人在宿主的生平结束时关闭.

核心概念

一个积极的目标就是在每次运行时保持安静的系统环境。 继续指示 仅适用于 " 目标 " 所允许的运行及其持续相关性 信息是在没有这一指示的情况下获得目标背景的。 两节都是 以UTF-8字节为界. 进球没有记录;页脚显示 只有活的入球("自14:02起的活的入球")或被暂停入球("目标被暂停") (/goal recept)")),而每个完成的入球在上个作品后会增加一行聊天. 其他扩展保留自己的显示策略.

已知限制:会议叉复制无正本的笔录条目 命令允许行。 因此, " 继承目标 " 失去推广来源 用于收缩音符的元数据,并显示为普通信息泡.

目标暂停停止续作,尚未被接受。 模式要求 完成或封堵是暂时的,直到成功解决;封堵 目标暂停,并像任何被暂停的目标一样恢复。 每个跑步的入球工具都用栅栏 目标修改所见,所以以后的后续命令(例如 父信件给子代理)可以完成,屏蔽,清除或恢复目标 被暂停的个人或授权人只接受的目标 完成儿童模式。 准确的会话记录为第一发包人 可以暂停或澄清孩子的目标 agents.goal,保留清晰的 理由和理由 clearedBy它只能恢复它所施加的暂停。 兄弟姐妹和 其他会议,包括后来派去工作的会议,都被拒绝。 一样 授权人了解其授权的哪些会议正在工作、等待或停止 目标仍然开放 agents.status。人员控制仍然有效 并拒绝经认证的代理电话 一个公开的决定等待 也停止继续进球 当一个没有工具的入球结束时 记录的子代理命令是实时的,目标提高 goal-waiting 注意和注意 重新检查计时器, 而不是计数档; 一旦孩子出现, 则会继续 和解或答复。 只有活的或暂停的进球在替换前询问 使用已观察到的修订,以避免取而代之的新目标;所取代的目标是: 记录为已清除。 当运行时间重新开始(一个枢纽部署或驱逐,一个本地 服务重启)中断入球转弯,转弯恢复并保持入球 活着 当会议的任何回合失败、无法复会或正在出现时,现场目标暂停 被某人(Esc)阻止,包括该人自己的信息("上个回合") 失败). 缺失的扩展源不能确定人类发送者 东道主的录取也可能缺乏.

目标共享线和持久行用 pauseCause: { kind, detail } 时 暂停和 null 活动时。 封闭的种类是 person, (中文(简体) ), blocked, (中文(简体) ), stalled, (中文(简体) ), cancelled, (中文(简体) ), failed,以及 no-terminal; 显示细节无效 文本,绝不是歧视者。 只有被封杀/被封杀的目标 goal-blocked 或者说 goal-stalled 注意, 远离主收件箱 inbox: false。 。 。 . 问题和这两类目标要求一个人参与Herdr活动; 被暂停、取消和失败的目标不会。 目前的目标状态是: 第7版. 被取代的预览"目标"行不迁移到这个表示.

每次运行都提供循环工具. loop.get, (中文(简体) ), loop.start 财务报告和审定财务报表 loop.stop 该模式本身可能会启动循环. loop.schedule_next 仅在活动自节奏循环的自运行中被接受; 略去它结束循环。 固定 Cadence 使用核心定时器并过期 7天后开始 阿尔马纳克按时间表重试失败录取,所以 一个被拒绝的事件不会成为另一个时间表的失败。 使用 记录出错和恢复时所有者的恢复命令.

人类 /goal, (中文(简体) ), /loop 财务报告和审定财务报表 /plan 流动额作为 whistle.catalog/v1 目录. 一个相容的客户端使同一服务器拥有 互动 人类指令目录、每个运行的工具模块和模型工具 发现是单独的合同。 检查主机已曝光的工具目录 依靠模型化操作.

国家和一生

问题

question.ask 产生一至四个决定问题。 它的命名空间是 question,其扩展身份为 botanical-session-question检查 forage.describe({path: "question.ask"}).inputSchema 以坚固的界限盟誓, 包括12个字符的问题头。 一个等待呼叫接收到人类 依次回答; mode: "continue" 将其停放并返回 askId现场直播 等待时间为实际执行期限的60秒,上限为10秒 几分钟。 在指导之前,还把问题搁置起来,以便穆尔能够提供指导. 每个会话最多举行四次公开"问",每跑一次直播"问".

捆绑 questionContract 从 /question 与 bindSessionExtension 读它 解码投影和调用 list, (中文(简体) ), answer 或者说 decline2. 人类的反应 包括一个 askId 和稳定 requestId在 不确定的反应:精确的重试返回其原始收据,而a 改变了有效载荷冲突。 用标签或非空回答每个问题 免费文本。 该模型没有解答操作.

这个 /answer 目录对话选择等待 询问并收集答案 每个问题。 多个选择使用逗号分隔标签; 引用标签 包含一个逗号。 每个选择也允许免费文本.

可选 onExpire 指定 afterMinutes (5至10 080)和一项行动: stop 明确要求模式不要继续; proceed_with_recommended 选择每个问题的第一个选项。 一个停放的回答或过期 承认一个 自我跟踪。 问主人关上后会清出注意力 现场服务员和耐用计时员共享相同的到期过渡. 重新开始恢复 调和承诺的答案,然后允许再次交付。 反转回答 在Mule保存成功工具结果之前,保留其交付收据。 如果有的话 崩溃会失去结果 并且没有重新任务收到 和解会发出答案 一次作为后续。 取消的运行会抑制重新发送 .

客户卡、目标/落点注意政策和外部通知是分开的 贡献; Ask 所有人不能提供这些表面.

所有者交易

收藏被命名为扩展名 。 系统、版本、迁移和 配置有助于其修订。 定时钩和命令 通过核心交易进行交易。 他们必须同步完成 不得执行外部 I/O .

扩展名通过接受命令的门发送提示,并通过核心唤醒 计时器。 已接受的提示是排队工作,而不是完成的模型回复 。 核心拥有 执行后重放光标并发布 。 停止的扩展显示其 理由;主机可以在不创建单独的背景循环的情况下恢复它.

添加主机组成的扩展名

家庭、子代理人和谈话-代理人名册由东道主组成,而不是 列入 botanicalAgentExtensions。 。 。 .

内容

主机创建 homeExtension({ computers })时 computers.read() 同步返回当前附件为 { name, attachmentId, port }。 。 。 . 每个 port 被主机限制在附件内 。 家从不创造 证书或绕过主机门。 添加返回的扩展名及其 导出 homeGrant (单位:千美元)state, (中文(简体) ), files, (中文(简体) ), prompt, (中文(简体) ), projection, (中文(简体) ), commands) (中文(简体) ). 家庭由东道主组成,不包括在 botanicalAgentExtensions编辑 Hub and demo 加上他们自己的计算机端口和赠款.

家庭记录一个代理镜附件选择。 没有记录的选择,运行 采用唯一附件一次。 零或多个附件要求一个人 选择 /home <name>。删除所选附件后,保留选择和 在一个人再次选择之前,不提供直接文件工具。 重排附件顺序 永不改变家 会话命令更改代理状态, 所以其他会话 在他们的下一场比赛中看到这个选择.

每跑一次就抓起自己的桌子,回家,然后迅速一次 这些工具是克纳帕斯克的 商标 read, (中文(简体) ), list, (中文(简体) ), glob,以及 grep,与 apply_patch 只有在家的时候 端口有本地补丁引擎. 微小路径和 computer://home/ 使用家谱; computer://<name>/ 使用另一个捕获附件。 补丁总是使用家 本地引擎和路径监狱。 返回的文件身份保留属于范围 端口 。 没有Home模型工具和共享文件模块.

特工范围 seed command是一个未公布的主机迁移操作。 这个 仅在没有选择时记录旧附件 id,包括当 附件是脱去的;后续种子调用不能覆盖人类的选择. 主办方保留控制门的人/操作者的授权. 家用检测 运动选择、捕获、分解、路由 并嘲笑真正的诗竹.

副剂

主机创建 subagentsExtension({ source }) 添加 subagentsGrant (单位:千美元)projection 财务报告和审定财务报表 commands人类 /agents 命令只崩溃或 每个会话和内存中扩展页脚行. source.read(sessionId, limit) 返回会话发送到或工作的代理 创造的,最新的第一, 盘点其余部分; source.open 这是主机的 已有代理访问。 每个孩子的身份是其所有者自己的会话状态: running 还在工作, done 闲置和 errored 失败。 请注意 等待一个人(一个问题,或请求延期的批准)是: needs you- 一个等待 代理发送工作是 waiting on <name>冷静,直到它升级 通过代理链,和 倒闭摘要中分开计算,只有孩子需要时才算琥珀 个人。 最多有256个孩子,最多8个所有者读取 在选择十五行之前。 需要你,等待代理员 和工作行在失败、不可用和闲置之前 源头最新订单. 明确增加儿童人数 not read永远 默数为闲. 公开决定优先于运行或 错误的会话:工作或失败都无法隐藏一个可回答的项目。 升级 升级的行名,或档案/消失导致晋升的行名. 折叠后的摘要保留了这些名称,甚至超出所列行。 A 类 needs you 问题带有其文本, 并有一个 解答操作 回答谈话。 无法读取的状态的孩子,永远无法读取 闲着.

当监视者读取父会话时, 行会刷新, 它们至少是一个 二岁. 当一排工作或等待, 他们每五秒钟投票一次 直到没有人读过父母30秒。 和家一样,扩展是 由东道方组成,不包括在 botanicalAgentExtensions。 。 。 .

对话代理人

@fungi.computer/shiitake-extensions/roster/conversation-agents 供应 共享本地、枢纽和牡蛎对话-代理组成。 东道方用品 其授权代理目录和 SQLite 拥有者; 接受名册记录 创建和发送只读页脚而不给予关系或 权力。 储存是懒惰的。 主机仍然负责创建 进入,代理访问和资源寿命.

App 或本地主机中的调度

使用 /schedules 用于 App 捆绑中的时间表和类型。 它进口 保留Almanac和Loop数据计划,而不是他们的本地引用客户端. 使用原住地融合 /schedules/client 页:1 readAgentSchedulePage, (中文(简体) ), controlAgentSchedule 财务报告和审定财务报表 controlAgentScheduleWithContent 已经 承认代理老板。 这些帮助者没有入住政策,没有储存或排班. 阅读与管理仍由主办方单独接纳.

API 参考和实例

这个 生成 API 引用 跟踪公众 入门口. 运行 pnpm --dir packages/shiitake-extensions run docs:write 从 更改它们之后的寄存器根,然后 pnpm --dir packages/shiitake-extensions run docs 以检查一致性. 软件包.json 拥有这些导出子路径 :

循环测试 练习排程和中跑暂停. 阿尔马纳克测试 练习录取和重试. 编目测试 检查人类互动合同. 这些固定装置在Shiitake上用假的扩展定义 模特们.

限制和错误

列入名册不是外部资源赠款。 主持人仍然承认每个 操作并拥有其目前的团队,计算机和证书政策. 一个命令 冲突需要新的观察; 重试相同的不确定请求 身份证明 没有目标的观点不能证明以前的目标已经完成. 关闭客户端视图不会暂停目标,停止循环或取消时间表.

贡献和许可证

在自有扩展名或目录外添加回归。 从根出:

pnpm --dir packages/shiitake-extensions run test
pnpm --dir packages/shiitake-extensions run typecheck

运行 pnpm run build, (中文(简体) ), pnpm run pack 财务报告和审定财务报表 pnpm run stranger 本包中. 保存的陌生人证明只安装了包裹 tarball 到新鲜npm 消费者,检查准确的运出文件,运行公共运行时间固定和 编译每个 JavaScript 入口, 严格节点Next 且没有库检查 跳过。 此资格不发布 npm 发布或推动仓库 分页.

麻省理工学院. 见 自由主义。 。 。 .