成熟度：Public alpha。公共 API 支持 Pi 与 OpenCode adapter；两者都要求运营方提供 固定版本、固定 digest 的 Sandbox template。

在 Sandbox 中运行 Agent

Agent Runtime 从属于一个已经 ready 的 Sandbox。应用开发者保留 chat/session；Appaloft 管理隔离 执行、每个 Runtime 同时一个 active Run、fresh/continue lineage、事件 readback 和取消。

常见产品故事包括：

• Chat-to-App：用户让你的 SaaS 创建或修改应用。产品保留 chat 和用户 session；Appaloft 只接收 有边界的 task，并在会过期的 Sandbox 中执行。
• 代码库维护：支持或工程工作流准备好 workspace，让代码 Agent 修改，再把 Run event 与最终结果 回写到原始工单。
• 人工门控自动化：Run 遇到高风险能力时暂停；应用展示 capability、destination、request digest 与 expiry，再由用户决定是否 resolve。

当前 Agent operation 要求 product session。在正式提供 scoped 长期应用凭据前，后端示例不要把 deploy token 当成等价认证方式。

const workspace = await appaloft.workspaces.create({
  sandbox: sandboxInput,
  harness: "opencode",
});
const agent = workspace.agent;
const run = await agent.runs.create({ task: "Build the requested app in /workspace/app" });

SDK 中的 Agent 是 canonical Sandbox Agent Runtime 的便捷别名。SDK 默认使用已准入的 Pi/OpenCode template， 并生成 idempotency key；需要显式 pin 或 continuation 时可以传入 harnessTemplateId、context 或 idempotencyKey。资源方法失败时抛出 AppaloftSdkRequestError；不抛异常的完整 generated operation facade 保留在 appaloft.operations。

Run 事件会限制数量、深度和字符串大小，并递归 redact credential、secret、password、token 与 authorization 字段。它们不是 audit event，也不能代替完整模型 transcript。

Pi 在 Sandbox 内作为可终止后台进程运行；OpenCode 使用限制在 Sandbox provider 私有网络命名 空间内且不发布宿主机端口的 server，以及独立的 attached client process。取消会终止实际 client 进程，并防止迟到的成功结果覆盖 cancelled 状态。当前 managed template 只应开放 Sandbox 内部能力；外部发布和 secret 使用必须继续通过 Appaloft 控制面。

官方 examples 仓库提供完整源码： Chat-to-App、 人工审批和 Preview-to-Promotion。