@finalai / final-agent-provider
用于Final线束、计算机/设备沙箱和
频道。从 /harnesses， /sandboxes，或者 /channels/final.
/connections 提供了 defineFinalConnection 用于会话范围的最终MCP访问。
可选节点ACP适配器在下面公开 /runtime/*。沙箱适配器的使用
公共电脑及设备api；与计算机共享传输
@finalai/computers。注入运行时配置和凭据。
这个 computer 和 device 沙箱使用上下文进行身份验证
credentials.computersAccess() 和 credentials.deviceAccess() （{ baseUrl, token });
没有他们，他们就会失败 credential_missing.
创作帮助程序生成清单绑定。选择匹配 /runtime/*
适配器连接自己的CLI或ACP端点时。
defineFinalConnection() 请求主机的 final 在会话开始时绑定，
使用泛型 defineHostedConnection 实现。它的会议许可仍然
通过通常的凭证代理。的现有调用 url
保持静态。没有绑定阅读器的主机不能运行无url的定义；
请参阅存储库的 托管指南 用于布线要求。
托管模型引用
无服务器的Final、Pi、Codex和Claude帮助程序接受模型字符串，包括提供程序限定的引用，例如 openrouter/deepseek/deepseek-v4.1-flash。当安装的平台目录支持现有的短模型id时，它们仍然是有效的别名。SDK检查可打印的ASCII引用语法（最多200个字符）；安装的平台选择默认值，验证可用性并提供模型选择器建议。省略 model 继承平台默认值。主机集成商现在必须处理 serverless*ConfigSchema.parse(...).model 未定义并在分派之前解析默认值。局部编译不获取模型编目。
在已经支持的提供程序API上添加模型需要更新平台目录，而不是发布SDK。原生纳米代码模型必须使用平台支持的引擎策略。新的提供者协议仍然需要集成。
这个 modelZod(ids) 和 modelJson(ids, defaultId) helper为选择提供它们的第三方工具作者保留了明确的限制。
SDK 0.2.0删除 @finalai/agents/models 和 @finalai/final-agent-provider/harnesses/models，包括它们的模型数组、默认值、模型id联合和定价助手。使用字符串模型引用和已安装平台的线束描述来确定当前候选和默认值。定价属于托管平台。协议级的 ModelVendor 枚举可从 @finalai/final-agent-provider/harnesses.
工作空间设备出口
/sandboxes/egress 通过批准的最终设备提供提供商中立的Linux TCP/UDP/DNS路由。主机组成 createWorkspaceDeviceNetworking({ api, needed }) 通过通用提供程序 networking 选择。它们提供稳定的逻辑工作空间标识、持久的网络注册、当前参与者和原始特权沙箱会话。在引导围栏之前保留直接策略；在禁用状态下恢复它。默认情况下，配置和禁用请求同意。
这个 集成参考 指定所需的钩子、启动/恢复回退、绑定权限、拆除、MCP传输、故障行为、先决条件和提供者接受程度。在启用此功能之前先阅读它。Final Computer和Daytona使用他们的公共api；自定义提供程序可以组成相同的控制器和管理器。
在0.4中，被动计算机恢复遵循只读查看器契约，即使没有 网络扩展。使用普通简历执行。捆绑的适配器 每个句柄的缓存延迟设置失败；重新连接重试，而不是重播 在每个MCP轮询上部分完成的用户设置命令。