@botlearn-course/daemon 0.0.20-beta.9 → 0.0.21-beta.1

package/README.md

@@ -36,22 +36,22 @@ npx --yes --package @botlearn-course/daemon@latest botlearn-course-daemon course
 | `course doctor` | 打印 Auth 状态（不含 token）与 runtime 探测表（安装路径 / 版本 / 登录状态 / 安装提示）。 |
 | `--help` / `--version` | 帮助与版本。 |
 
-包内还包含供 BotLearn 托管 E2B Template 使用的内部命令
+包内还包含供 BotLearn 托管 sandbox 使用的内部命令
 `botlearn-sandbox-supervisor agent-service session`。它不是 BYOA 用户入口：生产环境只允许由
-Agent Service 以固定 argv 启动，通过 stdin 接收一次性 bootstrap。E2B 中 daemon/runtime 分别
+Agent Service 以固定 argv 启动，通过 stdin 接收一次性 bootstrap。sandbox 中 daemon/runtime 分别
 降权到 `botlearn-control`/`user` UID；继承 `NoNewPrivs=1`、无法使用 sudo 的平台保留 root control
 daemon，由 root-owned 固定 launcher 清空附加组后直接降权为 `user`。两条路径都为 DeepSeek
 设置 `no_new_privs`，runtime 用户本身没有 sudo 权限。托管启动链只执行
-`/opt` 下的固定 Node、supervisor、daemon、launcher 与 DeepSeek 文件，不信任 E2B 会开放给 runtime
+`/opt` 下的固定 Node、supervisor、daemon、launcher 与 DeepSeek 文件，不信任 provider 会开放给 runtime
 写入的 `/usr/local/bin`。
 `agent-service session --bootstrap-stdin` 同样属于受 supervisor 保护的内部协议，不应直接暴露给
 课程任务或 workspace shell。
 
 veFaaS Origin 的托管 workspace 使用用户级 NAS backing image。root bootstrap 完成 NFS、marker、
-ext4、loop mount 和固定 3 GiB 校验后，daemon 才发送 `sandbox.ready`。RuntimeSession 使用稳定路径
+ext4、`fuse2fs` mount 和固定 3 GiB 校验后，daemon 才发送 `sandbox.ready`。RuntimeSession 使用稳定路径
 `/workspace/sessions/{runtime_session_id}/workspace`，Sandbox generation 只参与写入隔离。磁盘写满
 统一上报 `workspace_user_quota_exceeded`。pause 和 cleanup 进入 drain 后，daemon 先停止 runtime
-writer，再通过 root launcher 执行 ext4 sync、loop unmount、backing image 和 NFS parent fsync；完成后
+writer，再通过 root launcher 执行 ext4 sync、`fuse2fs` unmount、backing image 和 NFS parent fsync；完成后
 才发送 `sandbox.drained` 并退出。
 
 ## 支持的 runtime

package/dist/agent-service-sandbox.d.ts

@@ -3,6 +3,13 @@ import type { WorkspaceScanMeasurement } from "./file-candidates.js";
 import { type RuntimeSkillProviderFactory } from "./runtime-skills.js";
 import { type PersistentSessionExecution, type PreparedPersistentTurn, type RunReportingClient } from "./run-dispatcher.js";
 import type { CourseRuntime, CourseRuntimeProfile, RunEvent, RunEventReceipt, RunFileCandidate, RunFileRecord, RunStartPayload } from "./types.js";
+export declare function workspaceDurabilityCapabilities(): string[];
+/**
+ * NAS 是运行时 workspace 的唯一持久事实来源，committed snapshot 只供前端查看。
+ * 任何 restore payload 都意味着对端仍在下发已删除的 S3 回写指令，必须 fail closed，
+ * 否则可能用落后的派生快照覆盖 NAS 中较新的内容。
+ */
+export declare function assertWorkspaceRestoreAllowed(requestedRestore: unknown): void;
 export interface AgentServiceSandboxOptions {
     wsUrl: string;
     sandboxId: string;
@@ -97,8 +104,8 @@ export declare class AgentServiceSandboxClient implements RunReportingClient, Pe
     private handleTurnStart;
     private handleTurnCancel;
     /**
-     * 幂等关闭一个 runtime session：终止其 runtime 子进程、删除 workspace/native state、
-     * 清空本地状态分片，并回 session.closed。未知 session 直接回 closed。
+     * 幂等关闭一个 runtime session：终止其 runtime 子进程并清空 session-local state。
+     * Durable Workspace 由独立身份拥有，关闭执行上下文不会删除学员文件。
      */
     private closeSession;
     private reconcileInterruptedCommand;