@kanyun-ai-infra/agenthub 1.9.0 → 1.10.0

package/README.md

@@ -108,6 +108,23 @@ const ready = await agenthub.sessions.wait(session.sessionId); // status === "re
 > 要额外给槽位绑一个 Environment，才有资源规格定制、canary 灰度、drift 检测、
 > 一键回滚这些能力：完整走一遍见下方「完整参考」里的发布闭环六幕示例。
 
+### 代表用户调用（仅第一方服务）
+
+服务到服务的场景（门户、后台任务等）可以用**第一方服务 token** 声明「代表某个用户」：
+给客户端传 `actAs`（用户 LDAP），此后该客户端发出的**每个**请求——JSON、multipart
+上传、SSE（首连与带 `Last-Event-ID` 的重连）——都带代表声明头。
+
+```ts
+const agenthub = new PilotPlatformClient({
+  token: process.env.PILOT_SERVICE_TOKEN, // 第一方服务 token（actor:delegate）
+  actAs: "zhangsan", // 代表 zhangsan 行事
+});
+```
+
+仅第一方服务 token 可用：其他 token 带它会得到 403 `ACT_AS_NOT_ALLOWED`（服务端开关
+未开：403 `ACT_AS_DISABLED`；值不是用户标识：400 `ACT_AS_INVALID`）。空串 / 纯空白在
+构造时即抛。`defaultHeaders` 或单次请求的 `headers` 里写同名头不能覆盖 `actAs`。
+
 ## 核心模型
 
 ```text