@botlearn-course/daemon 0.0.7 → 0.0.8

package/dist/agent-service-client.js

@@ -17,8 +17,8 @@ export class AgentServiceRunClient {
     }
     url(path) {
         const base = this.baseUrl.replace(/\/+$/, "");
-        if (base.endsWith("/api/v1") && path.startsWith("/api/v1/")) {
-            return `${base}${path.slice("/api/v1".length)}`;
+        if (base.endsWith("/course/v1") && path.startsWith("/course/v1/")) {
+            return `${base}${path.slice("/course/v1".length)}`;
         }
         return `${base}${path}`;
     }
@@ -40,7 +40,7 @@ export class AgentServiceRunClient {
         return (raw ? JSON.parse(raw) : null);
     }
     async getRun() {
-        const payload = await this.request("GET", `/api/v1/agent-service/runs/${this.agentRunId}`);
+        const payload = await this.request("GET", `/course/v1/agent-service/runs/${this.agentRunId}`);
         this.traceId = payload.trace_id;
         return payload;
     }
@@ -48,14 +48,14 @@ export class AgentServiceRunClient {
         this.assertRunId(agentRunId);
         this.traceId = event.trace_id ?? this.traceId;
         const sanitized = redactSecretsDeep(event, 8, [this.runToken]);
-        await this.request("POST", `/api/v1/agent-service/runs/${agentRunId}/events`, sanitized);
+        await this.request("POST", `/course/v1/agent-service/runs/${agentRunId}/events`, sanitized);
     }
     async postFile(agentRunId, file) {
         this.assertRunId(agentRunId);
         const sanitized = redactSecretsDeep(file, 8, [this.runToken]);
         for (let attempt = 0; attempt < 3; attempt += 1) {
             try {
-                return await this.request("POST", `/api/v1/agent-service/runs/${agentRunId}/files`, sanitized);
+                return await this.request("POST", `/course/v1/agent-service/runs/${agentRunId}/files`, sanitized);
             }
             catch (err) {
                 const retryable = !(err instanceof CourseClientError) || err.status === 429 || err.status >= 500;
@@ -70,7 +70,7 @@ export class AgentServiceRunClient {
         this.assertRunId(agentRunId);
         const data = await readFile(absPath);
         assertNoInjectedCredentials(data, [this.runToken]);
-        const path = `/api/v1/agent-service/runs/${agentRunId}/files/${fileId}/content`;
+        const path = `/course/v1/agent-service/runs/${agentRunId}/files/${fileId}/content`;
         for (let attempt = 0; attempt < 3; attempt += 1) {
             let response;
             try {
@@ -102,10 +102,10 @@ export class AgentServiceRunClient {
     }
     async getRunRuntimeProfile(agentRunId) {
         this.assertRunId(agentRunId);
-        return this.request("GET", `/api/v1/agent-service/runs/${agentRunId}/runtime-profile`);
+        return this.request("GET", `/course/v1/agent-service/runs/${agentRunId}/runtime-profile`);
     }
     async heartbeat() {
-        await this.request("POST", `/api/v1/agent-service/runs/${this.agentRunId}/heartbeat`, { worker_id: this.workerId });
+        await this.request("POST", `/course/v1/agent-service/runs/${this.agentRunId}/heartbeat`, { worker_id: this.workerId });
     }
     assertRunId(value) {
         if (value !== this.agentRunId)

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

@@ -0,0 +1,108 @@
+import { type Logger } from "./log.js";
+import { type PersistentSessionExecution, type PreparedPersistentTurn, type RunReportingClient } from "./run-dispatcher.js";
+import type { CourseRuntime, CourseRuntimeProfile, RunEvent, RunFileCandidate, RunFileRecord, RunStartPayload } from "./types.js";
+export interface AgentServiceSandboxOptions {
+    wsUrl: string;
+    sandboxId: string;
+    sandboxToken: string;
+    runtimes: Map<string, CourseRuntime>;
+    daemonVersion: string;
+    log?: Logger;
+    random?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Long-running daemon client for one user-scoped managed sandbox (ADR-015).
+ *
+ * 一个 sandbox 内可承载多个 runtime session（CourseRun Session）。server 通过显式命令帧
+ * （session.open/activate/close、turn.start/cancel、sandbox.drain/shutdown/sync）驱动；
+ * daemon 同时只允许一个 active session，且整个 sandbox 同时只有一个 active turn。
+ */
+export declare class AgentServiceSandboxClient implements RunReportingClient, PersistentSessionExecution {
+    private readonly options;
+    private readonly log;
+    private readonly random;
+    private readonly sleep;
+    private readonly state;
+    private readonly dispatcher;
+    /** agent_run_id → TURN scope（session/attempt/activation），事件与文件帧路由用。 */
+    private readonly turnScopes;
+    /** 每 run 内嵌 profile（turn payload 自带时优先）。 */
+    private readonly runProfiles;
+    /** activate 时装配的 per-session profile，turn.start 复用。 */
+    private readonly sessionProfiles;
+    /** activation-scoped 模型短凭据；只保存在内存中，绝不进入 state.json。 */
+    private readonly activationContexts;
+    private readonly pendingAcks;
+    private readonly pendingFilePrepares;
+    private readonly pendingFileCommits;
+    private readonly fileGrants;
+    private readonly inflightCommands;
+    private socket;
+    private sandboxGeneration;
+    private connectionEpoch;
+    private outboundSeq;
+    private inboundSeq;
+    private activeSessionId;
+    /** 全局串行下当前正在执行 turn 的 session（persistNativeSession 路由用）。 */
+    private currentTurnSessionId;
+    private heartbeatMs;
+    private staleMs;
+    private stopped;
+    private permanentFailure;
+    private lifecycleChain;
+    constructor(options: AgentServiceSandboxOptions);
+    prepareTurn(payload: RunStartPayload): PreparedPersistentTurn;
+    persistNativeSession(nativeSessionId: string): void;
+    finishTurn(payload: RunStartPayload): void;
+    private completePendingActivationCleanup;
+    private recoverPendingActivationCleanups;
+    run(): Promise<void>;
+    stop(): void;
+    postEvent(agentRunId: string, event: RunEvent): Promise<void>;
+    postFile(agentRunId: string, file: RunFileCandidate): Promise<RunFileRecord>;
+    uploadFileContent(agentRunId: string, fileId: string, absPath: string, mimeType?: string): Promise<RunFileRecord>;
+    getRunRuntimeProfile(agentRunId: string): Promise<CourseRuntimeProfile>;
+    private connectOnce;
+    private handleHello;
+    private assertServerFrame;
+    private handleServerFrame;
+    /** sandbox.sync 只做对账：重放 spool、关闭待关 session、应用 drain/shutdown。 */
+    private applySync;
+    private handleSessionOpen;
+    private handleSessionActivate;
+    private handleTurnStart;
+    private handleTurnCancel;
+    /**
+     * 幂等关闭一个 runtime session：终止其 runtime 子进程、删除 workspace/native state、
+     * 清空本地状态分片，并回 session.closed。未知 session 直接回 closed。
+     */
+    private closeSession;
+    private reconcileInterruptedCommand;
+    private turnContextRevision;
+    private activationInstructions;
+    private validTurnPayload;
+    private scheduleLifecycle;
+    private currentLifecycleFence;
+    private isCurrentLifecycleFence;
+    private runIdsForSession;
+    private deactivateSession;
+    private sameTurnScope;
+    private matchesTurnScope;
+    private assertTurnScope;
+    private ackEventOrFile;
+    private acceptFileGrant;
+    private replaySpool;
+    private sendHeartbeat;
+    private sendCommandAck;
+    private sendControlFrame;
+    private sendSessionFrame;
+    private sendFrame;
+    private nextOutboundSeq;
+    private spoolFrameCount;
+    private spoolBytes;
+    private enforceSpoolLimit;
+    private rejectPending;
+    private rejectPendingFiles;
+    private persist;
+}