@playcraft/common 0.1.0 → 0.1.1

package/dist/cloud-workspace/runtime/agent-background-processes.d.ts

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+export declare const agentBackgroundProcessActions: readonly ["renew", "stop"];
+/** 三个 Worker 心跳周期（30 秒），容忍两次心跳延迟。 */
+export declare const AGENT_BACKGROUND_LEASE_MS = 90000;
+export declare const agentBackgroundProcessesRequestSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        renew: "renew";
+        stop: "stop";
+    }>;
+    sessionId: z.ZodString;
+    requestId: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    workspaceId: z.ZodString;
+    kind: z.ZodEnum<{
+        manager: "manager";
+        execution: "execution";
+    }>;
+    runId: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    claimToken: z.ZodString;
+}, z.core.$strict>;
+export declare const agentBackgroundProcessesResultSchema: z.ZodUnion<readonly [z.ZodObject<{
+    outcome: z.ZodLiteral<"uncertain">;
+    error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"renew">;
+    status: z.ZodEnum<{
+        none: "none";
+        renewed: "renewed";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"stop">;
+    status: z.ZodEnum<{
+        none: "none";
+        stopped: "stopped";
+    }>;
+}, z.core.$strict>]>;
+export declare const agentBackgroundProcessesResponseSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    action: z.ZodEnum<{
+        renew: "renew";
+        stop: "stop";
+    }>;
+    result: z.ZodUnion<readonly [z.ZodObject<{
+        outcome: z.ZodLiteral<"uncertain">;
+        error: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"renew">;
+        status: z.ZodEnum<{
+            none: "none";
+            renewed: "renewed";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"stop">;
+        status: z.ZodEnum<{
+            none: "none";
+            stopped: "stopped";
+        }>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+export type AgentBackgroundProcessesRequest = z.infer<typeof agentBackgroundProcessesRequestSchema>;
+export type AgentBackgroundProcessesResult = z.infer<typeof agentBackgroundProcessesResultSchema>;
+//# sourceMappingURL=agent-background-processes.d.ts.map

package/dist/cloud-workspace/runtime/agent-background-processes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-background-processes.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-background-processes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,eAAO,MAAM,6BAA6B,4BAA6B,CAAC;AACxE,qCAAqC;AACrC,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;kBAkB/C,CAAC;AAEJ,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;oBAkB/C,CAAC;AAEH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;kBAMxC,CAAC;AAEZ,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AACpG,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC"}

package/dist/cloud-workspace/runtime/agent-background-processes.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+/**
+ * 命令返回后仍在运行的后台进程（R3.22）：续保活与停止。
+ *
+ * 后台进程由 Runtime 的命令监督进程登记、沙箱内看守进程看管，归属按领取推导（Manager 按 run，
+ * Execution 按 execution），在本次执行结束时停止。调用方只声明会话与领取；沙箱、记录目录与
+ * 进程身份都由 Runtime 推导，不接受路径或 PID。
+ *
+ * - `renew`：把看守进程的保活续到当前时间起 `AGENT_BACKGROUND_LEASE_MS`。
+ * - `stop`：写入停止指令并等看守进程确认；看守进程已不在时 Runtime 自己按登记核对并停止。
+ */
+const identity = z.string().min(1).max(128);
+const uuid = z.string().uuid();
+export const agentBackgroundProcessActions = ['renew', 'stop'];
+/** 三个 Worker 心跳周期（30 秒），容忍两次心跳延迟。 */
+export const AGENT_BACKGROUND_LEASE_MS = 90_000;
+export const agentBackgroundProcessesRequestSchema = z
+    .object({
+    action: z.enum(agentBackgroundProcessActions),
+    sessionId: z.string().regex(/^[a-zA-Z0-9_-]{1,128}$/),
+    requestId: uuid,
+    writerEpoch: z.number().int().positive().max(2_147_483_647),
+    workspaceId: identity,
+    kind: z.enum(['manager', 'execution']),
+    runId: uuid,
+    executionId: uuid.optional(),
+    issueId: uuid.optional(),
+    claimToken: identity,
+})
+    .strict()
+    .refine((value) => value.kind === 'manager'
+    ? !value.executionId && !value.issueId
+    : Boolean(value.executionId && value.issueId));
+export const agentBackgroundProcessesResultSchema = z.union([
+    z.object({ outcome: z.literal('uncertain'), error: z.string().max(128) }).strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('renew'),
+        /** none：该归属没有存活的看守进程。 */
+        status: z.enum(['renewed', 'none']),
+    })
+        .strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('stop'),
+        /** stopped：已确认无存活进程；none：该归属从未登记后台进程。 */
+        status: z.enum(['stopped', 'none']),
+    })
+        .strict(),
+]);
+export const agentBackgroundProcessesResponseSchema = z
+    .object({
+    requestId: uuid,
+    action: z.enum(agentBackgroundProcessActions),
+    result: agentBackgroundProcessesResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-background-processes.js.map

package/dist/cloud-workspace/runtime/agent-background-processes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-background-processes.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-background-processes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;GASG;AAEH,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;AAE/B,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,OAAO,EAAE,MAAM,CAAU,CAAC;AACxE,qCAAqC;AACrC,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEhD,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC;KACnD,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC;IACrD,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC;IAC3D,WAAW,EAAE,QAAQ;IACrB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACtC,KAAK,EAAE,IAAI;IACX,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE;IACxB,UAAU,EAAE,QAAQ;CACrB,CAAC;KACD,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAChB,KAAK,CAAC,IAAI,KAAK,SAAS;IACtB,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO;IACtC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,CAChD,CAAC;AAEJ,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CAAC;IAC1D,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAClF,CAAC;SACE,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QAC7B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,yBAAyB;QACzB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;KACpC,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QAC7B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,yCAAyC;QACzC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;KACpC,CAAC;SACD,MAAM,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC;KACpD,MAAM,CAAC;IACN,SAAS,EAAE,IAAI;IACf,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC;IAC7C,MAAM,EAAE,oCAAoC;CAC7C,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/cloud-workspace/runtime/agent-chat-flush.d.ts

@@ -1,10 +1,9 @@
 import { z } from 'zod';
-export declare const agentChatFlushActions: readonly ["flush_opencode_message", "flush_codebuddy_projects", "settled"];
+export declare const agentChatFlushActions: readonly ["flush_opencode_message", "settled"];
 export declare const agentChatFlushRequestSchema: z.ZodObject<{
     action: z.ZodEnum<{
-        flush_opencode_message: "flush_opencode_message";
-        flush_codebuddy_projects: "flush_codebuddy_projects";
         settled: "settled";
+        flush_opencode_message: "flush_opencode_message";
     }>;
     requestId: z.ZodString;
     writerEpoch: z.ZodNumber;
@@ -30,9 +29,8 @@ export declare const agentChatFlushResponseSchema: z.ZodObject<{
     requestId: z.ZodString;
     operationId: z.ZodString;
     action: z.ZodEnum<{
-        flush_opencode_message: "flush_opencode_message";
-        flush_codebuddy_projects: "flush_codebuddy_projects";
         settled: "settled";
+        flush_opencode_message: "flush_opencode_message";
     }>;
     inputHash: z.ZodString;
     result: z.ZodUnion<readonly [z.ZodObject<{

package/dist/cloud-workspace/runtime/agent-chat-flush.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-chat-flush.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-chat-flush.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,eAAO,MAAM,qBAAqB,4EAIxB,CAAC;AAEX,eAAO,MAAM,2BAA2B;;;;;;;;;;;kBAS7B,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;oBAarC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;kBAQ9B,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}
+{"version":3,"file":"agent-chat-flush.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-chat-flush.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,eAAO,MAAM,qBAAqB,gDAAiD,CAAC;AAEpF,eAAO,MAAM,2BAA2B;;;;;;;;;;kBAS7B,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;oBAarC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;kBAQ9B,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/cloud-workspace/runtime/agent-chat-flush.js

@@ -4,7 +4,7 @@ import { z } from 'zod';
  *
  * 编辑器的事件监控在会话空闲时让沙箱内 Slot Manager 把本地聊天数据写到 `/mnt/memory`
  * （per-user COSFS 挂载），随后 Business 才记 artifact 元数据行。这里迁的是前半段：
- * 调用方只声明要落哪个 agent 的记录，沙箱、slot 与 Slot Manager 地址都由 Runtime 推导。
+ * 调用方只声明落盘动作，沙箱、slot 与 Slot Manager 地址都由 Runtime 推导。
  *
  * 元数据入库仍在调用方，因为那是数据库写入，不是沙箱访问。
  */
@@ -14,11 +14,7 @@ const branchName = z
     .min(1)
     .max(200)
     .refine((value) => !/[\x00-\x1f]/.test(value));
-export const agentChatFlushActions = [
-    'flush_opencode_message',
-    'flush_codebuddy_projects',
-    'settled',
-];
+export const agentChatFlushActions = ['flush_opencode_message', 'settled'];
 export const agentChatFlushRequestSchema = z
     .object({
     action: z.enum(agentChatFlushActions),

package/dist/cloud-workspace/runtime/agent-chat-flush.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-chat-flush.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-chat-flush.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AAEH,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;AAC/B,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,wBAAwB;IACxB,0BAA0B;IAC1B,SAAS;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC;IACrC,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC;IAC3D,SAAS,EAAE,IAAI;IACf,UAAU;IACV,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACxC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC;IAChD,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAClF,CAAC;SACE,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QAC7B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACvC,0FAA0F;QAC1F,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;QACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;KACtC,CAAC;SACD,MAAM,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,IAAI;IACjB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAC7C,MAAM,EAAE,0BAA0B;CACnC,CAAC;KACD,MAAM,EAAE,CAAC"}
+{"version":3,"file":"agent-chat-flush.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-chat-flush.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AAEH,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;AAC/B,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,wBAAwB,EAAE,SAAS,CAAU,CAAC;AAEpF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC;IACrC,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC;IAC3D,SAAS,EAAE,IAAI;IACf,UAAU;IACV,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACxC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC;IAChD,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAClF,CAAC;SACE,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QAC7B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACvC,0FAA0F;QAC1F,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;QACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;KACtC,CAAC;SACD,MAAM,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,IAAI;IACjB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAC7C,MAAM,EAAE,0BAA0B;CACnC,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/cloud-workspace/runtime/agent-command.d.ts

@@ -8,8 +8,8 @@ export declare const agentCommandRequestSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     }, z.core.$strict>;
     action: z.ZodEnum<{
         settled: "settled";
-        observe: "observe";
         start: "start";
+        observe: "observe";
         cancel: "cancel";
     }>;
     timeoutMs: z.ZodNumber;
@@ -35,8 +35,8 @@ export declare const agentCommandRequestSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     }, z.core.$strict>;
     action: z.ZodEnum<{
         settled: "settled";
-        observe: "observe";
         start: "start";
+        observe: "observe";
         cancel: "cancel";
     }>;
     timeoutMs: z.ZodNumber;
@@ -61,8 +61,8 @@ export declare const agentCommandRequestSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     }, z.core.$strict>;
     action: z.ZodEnum<{
         settled: "settled";
-        observe: "observe";
         start: "start";
+        observe: "observe";
         cancel: "cancel";
     }>;
     timeoutMs: z.ZodNumber;
@@ -81,11 +81,24 @@ export declare const agentCommandRequestSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     ledgerId: z.ZodString;
     toolCallId: z.ZodString;
 }, z.core.$strict>], "toolName">;
+/**
+ * 命令返回后仍在运行、已由平台登记的后台进程（R3.22）。本次执行结束时由平台停止；
+ * 模型只被告知，不管理。
+ */
+export declare const agentCommandBackgroundProcessSchema: z.ZodObject<{
+    pid: z.ZodNumber;
+    command: z.ZodString;
+}, z.core.$strict>;
+export declare const AGENT_COMMAND_BACKGROUND_MAX = 64;
 export declare const agentCommandOutputSchema: z.ZodObject<{
     stdout: z.ZodString;
     stderr: z.ZodString;
     exitCode: z.ZodNumber;
     truncated: z.ZodBoolean;
+    background: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        pid: z.ZodNumber;
+        command: z.ZodString;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
 export declare const agentCommandResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     outcome: z.ZodLiteral<"running">;
@@ -99,6 +112,10 @@ export declare const agentCommandResultSchema: z.ZodDiscriminatedUnion<[z.ZodObj
         stderr: z.ZodString;
         exitCode: z.ZodNumber;
         truncated: z.ZodBoolean;
+        background: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            pid: z.ZodNumber;
+            command: z.ZodString;
+        }, z.core.$strict>>>;
     }, z.core.$strict>;
 }, z.core.$strict>], "outcome">;
 export declare const agentCommandResponseSchema: z.ZodObject<{
@@ -122,9 +139,14 @@ export declare const agentCommandResponseSchema: z.ZodObject<{
             stderr: z.ZodString;
             exitCode: z.ZodNumber;
             truncated: z.ZodBoolean;
+            background: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                pid: z.ZodNumber;
+                command: z.ZodString;
+            }, z.core.$strict>>>;
         }, z.core.$strict>;
     }, z.core.$strict>], "outcome">;
 }, z.core.$strict>;
 export type AgentCommandRequest = z.infer<typeof agentCommandRequestSchema>;
 export type AgentCommandOutput = z.infer<typeof agentCommandOutputSchema>;
+export type AgentCommandBackgroundProcess = z.infer<typeof agentCommandBackgroundProcessSchema>;
 //# sourceMappingURL=agent-command.d.ts.map

package/dist/cloud-workspace/runtime/agent-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-command.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCA4CoD,CAAC;AAE3F,eAAO,MAAM,wBAAwB;;;;;kBAO1B,CAAC;AACZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;+BAInC,CAAC;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;kBAQ5B,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"agent-command.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCA4CoD,CAAC;AAE3F;;;GAGG;AACH,eAAO,MAAM,mCAAmC;;;kBAKrC,CAAC;AACZ,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,eAAO,MAAM,wBAAwB;;;;;;;;;kBAW1B,CAAC;AACZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;+BAInC,CAAC;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQ5B,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC"}

package/dist/cloud-workspace/runtime/agent-command.js

@@ -50,12 +50,27 @@ export const agentCommandRequestSchema = z
     ? Boolean(value.executionId && value.issueId)
     : !value.executionId && !value.issueId)
     .refine((value) => new TextEncoder().encode(JSON.stringify(value)).byteLength <= 60_000);
+/**
+ * 命令返回后仍在运行、已由平台登记的后台进程（R3.22）。本次执行结束时由平台停止；
+ * 模型只被告知，不管理。
+ */
+export const agentCommandBackgroundProcessSchema = z
+    .object({
+    pid: z.number().int().positive(),
+    command: z.string().max(200),
+})
+    .strict();
+export const AGENT_COMMAND_BACKGROUND_MAX = 64;
 export const agentCommandOutputSchema = z
     .object({
     stdout: z.string().max(65_536),
     stderr: z.string().max(65_536),
     exitCode: z.number().int(),
     truncated: z.boolean(),
+    background: z
+        .array(agentCommandBackgroundProcessSchema)
+        .max(AGENT_COMMAND_BACKGROUND_MAX)
+        .optional(),
 })
     .strict();
 export const agentCommandResultSchema = z.discriminatedUnion('outcome', [

package/dist/cloud-workspace/runtime/agent-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-command.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-command.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-command.ts"],"names":[],"mappings":"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"}

package/dist/cloud-workspace/runtime/agent-competitor-report.d.ts

@@ -0,0 +1,143 @@
+import { z } from 'zod';
+export declare const agentCompetitorReportActions: readonly ["read", "media", "rewrite", "keyframes"];
+export declare const agentCompetitorReportKinds: readonly ["manager", "execution"];
+export declare const agentCompetitorReportPurposes: readonly ["tool", "auto_publish"];
+/** 报告与 combined_data 正文上限，与 Agent 读取工具一致。 */
+export declare const AGENT_COMPETITOR_REPORT_MAX_CHARS: number;
+/** `media` 成功时的响应头，值为视频字节数。 */
+export declare const AGENT_COMPETITOR_VIDEO_LENGTH_HEADER = "x-playcraft-video-bytes";
+/** `keyframes` 最多返回几张，与 Business 每个变体的参考图上限一致。 */
+export declare const AGENT_COMPETITOR_KEYFRAMES_MAX = 5;
+export declare const agentCompetitorReportRequestSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        read: "read";
+        media: "media";
+        rewrite: "rewrite";
+        keyframes: "keyframes";
+    }>;
+    sessionId: z.ZodString;
+    requestId: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    workspaceId: z.ZodString;
+    kind: z.ZodEnum<{
+        manager: "manager";
+        execution: "execution";
+    }>;
+    runId: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    claimToken: z.ZodString;
+    purpose: z.ZodEnum<{
+        tool: "tool";
+        auto_publish: "auto_publish";
+    }>;
+    entryIndex: z.ZodOptional<z.ZodNumber>;
+    report: z.ZodOptional<z.ZodString>;
+    suggestionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const agentCompetitorReportResultSchema: z.ZodUnion<readonly [z.ZodObject<{
+    outcome: z.ZodLiteral<"uncertain">;
+    error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"read">;
+    status: z.ZodEnum<{
+        read: "read";
+        no_output: "no_output";
+        no_sandbox: "no_sandbox";
+    }>;
+    report: z.ZodNullable<z.ZodString>;
+    combinedData: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"media">;
+    status: z.ZodEnum<{
+        no_output: "no_output";
+        no_sandbox: "no_sandbox";
+        no_entry: "no_entry";
+        no_video: "no_video";
+        not_found: "not_found";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"rewrite">;
+    status: z.ZodEnum<{
+        no_output: "no_output";
+        no_sandbox: "no_sandbox";
+        written: "written";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"keyframes">;
+    status: z.ZodEnum<{
+        read: "read";
+        no_output: "no_output";
+        no_sandbox: "no_sandbox";
+        no_report: "no_report";
+        no_suggestion: "no_suggestion";
+    }>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>]>;
+export declare const agentCompetitorReportResponseSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    action: z.ZodEnum<{
+        read: "read";
+        media: "media";
+        rewrite: "rewrite";
+        keyframes: "keyframes";
+    }>;
+    result: z.ZodUnion<readonly [z.ZodObject<{
+        outcome: z.ZodLiteral<"uncertain">;
+        error: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"read">;
+        status: z.ZodEnum<{
+            read: "read";
+            no_output: "no_output";
+            no_sandbox: "no_sandbox";
+        }>;
+        report: z.ZodNullable<z.ZodString>;
+        combinedData: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"media">;
+        status: z.ZodEnum<{
+            no_output: "no_output";
+            no_sandbox: "no_sandbox";
+            no_entry: "no_entry";
+            no_video: "no_video";
+            not_found: "not_found";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"rewrite">;
+        status: z.ZodEnum<{
+            no_output: "no_output";
+            no_sandbox: "no_sandbox";
+            written: "written";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"keyframes">;
+        status: z.ZodEnum<{
+            read: "read";
+            no_output: "no_output";
+            no_sandbox: "no_sandbox";
+            no_report: "no_report";
+            no_suggestion: "no_suggestion";
+        }>;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+export type AgentCompetitorReportRequest = z.infer<typeof agentCompetitorReportRequestSchema>;
+export type AgentCompetitorReportPurpose = (typeof agentCompetitorReportPurposes)[number];
+export type AgentCompetitorReportResult = z.infer<typeof agentCompetitorReportResultSchema>;
+export type AgentCompetitorReportResponse = z.infer<typeof agentCompetitorReportResponseSchema>;
+//# sourceMappingURL=agent-competitor-report.d.ts.map

package/dist/cloud-workspace/runtime/agent-competitor-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-competitor-report.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-competitor-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,eAAO,MAAM,4BAA4B,oDAAqD,CAAC;AAC/F,eAAO,MAAM,0BAA0B,mCAAoC,CAAC;AAC5E,eAAO,MAAM,6BAA6B,mCAAoC,CAAC;AAE/E,6CAA6C;AAC7C,eAAO,MAAM,iCAAiC,QAAmB,CAAC;AAClE,+BAA+B;AAC/B,eAAO,MAAM,oCAAoC,4BAA4B,CAAC;AAC9E,kDAAkD;AAClD,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAIhD,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;kBAyB4C,CAAC;AAK5F,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAiD5C,CAAC;AAEH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMrC,CAAC;AAEZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAC9F,MAAM,MAAM,4BAA4B,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1F,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC"}

package/dist/cloud-workspace/runtime/agent-competitor-report.js

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+/**
+ * 竞品洞察报告的沙箱读写（R3.20）：`publish_competitor_report` 与收尾自动补发共用。
+ *
+ * 调用方只声明会话、领取（manager / execution）与用途；报告所在的输出目录和沙箱由
+ * Runtime 从 `agent_sessions` / `agent_executions` 推导，与 Business 同一规则：
+ * - `tool`：Manager 为会话的 `competitor` execenv，Execution 为该执行的 execenv（缺省按 issue 推）。
+ * - `auto_publish`：优先会话 playbook 的 `competitorReportOutputPath`，其次同上。
+ *
+ * - `read`：读 `report.json` 与 `combined_data.json` 正文（只读，不留回执）。
+ * - `media`：按 `combined_data.json` 解析后的条目下标读该条 `video_path` 的视频字节。
+ *   调用方不传路径；成功时响应体是 `application/octet-stream`，其余结果为 JSON。
+ * - `rewrite`：把富化后的报告整份写回 `report.json`（同内容覆盖，重试无副作用）。
+ * - `keyframes`（R3.21）：按建议 id 取 `generate_replica_variants` 的参考关键帧。报告、目标素材、
+ *   datasetDir 与候选路径都由 Runtime 从输出目录里的文件推导，规则与 Business 同一份；
+ *   字节以 base64 返回，最多 5 张、每张不超过 2 MiB（沿用 Business 原有常量）。
+ *
+ * 上传 COS 不是沙箱操作，仍在 Agent 用平台存储完成。
+ */
+const identity = z.string().min(1).max(128);
+const sessionId = z.string().regex(/^[a-zA-Z0-9_-]{1,128}$/);
+const uuid = z.string().uuid();
+export const agentCompetitorReportActions = ['read', 'media', 'rewrite', 'keyframes'];
+export const agentCompetitorReportKinds = ['manager', 'execution'];
+export const agentCompetitorReportPurposes = ['tool', 'auto_publish'];
+/** 报告与 combined_data 正文上限，与 Agent 读取工具一致。 */
+export const AGENT_COMPETITOR_REPORT_MAX_CHARS = 16 * 1024 * 1024;
+/** `media` 成功时的响应头，值为视频字节数。 */
+export const AGENT_COMPETITOR_VIDEO_LENGTH_HEADER = 'x-playcraft-video-bytes';
+/** `keyframes` 最多返回几张，与 Business 每个变体的参考图上限一致。 */
+export const AGENT_COMPETITOR_KEYFRAMES_MAX = 5;
+/** 单张关键帧上限（2 MiB）的 base64 长度。 */
+const KEYFRAME_BASE64_MAX_CHARS = Math.ceil((2 * 1024 * 1024) / 3) * 4;
+export const agentCompetitorReportRequestSchema = z
+    .object({
+    action: z.enum(agentCompetitorReportActions),
+    sessionId,
+    requestId: uuid,
+    writerEpoch: z.number().int().positive().max(2_147_483_647),
+    workspaceId: identity,
+    kind: z.enum(agentCompetitorReportKinds),
+    runId: uuid,
+    executionId: uuid.optional(),
+    issueId: uuid.optional(),
+    claimToken: identity,
+    purpose: z.enum(agentCompetitorReportPurposes),
+    entryIndex: z.number().int().nonnegative().max(9_999).optional(),
+    report: z.string().min(1).max(AGENT_COMPETITOR_REPORT_MAX_CHARS).optional(),
+    suggestionId: z.string().min(1).max(256).optional(),
+})
+    .strict()
+    .refine((value) => value.kind === 'manager'
+    ? !value.executionId && !value.issueId
+    : Boolean(value.executionId && value.issueId))
+    .refine((value) => (value.action === 'media') === (value.entryIndex !== undefined))
+    .refine((value) => (value.action === 'rewrite') === (value.report !== undefined))
+    .refine((value) => (value.action === 'keyframes') === (value.suggestionId !== undefined));
+/** no_output：推导不出输出目录；no_sandbox：会话 / 执行没有沙箱。 */
+const unavailable = ['no_output', 'no_sandbox'];
+export const agentCompetitorReportResultSchema = z.union([
+    z.object({ outcome: z.literal('uncertain'), error: z.string().max(128) }).strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('read'),
+        status: z.enum(['read', ...unavailable]),
+        /** null：文件不存在。 */
+        report: z.string().max(AGENT_COMPETITOR_REPORT_MAX_CHARS).nullable(),
+        combinedData: z.string().max(AGENT_COMPETITOR_REPORT_MAX_CHARS).nullable(),
+    })
+        .strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('media'),
+        /**
+         * 字节成功时不走 JSON。no_entry：下标没有对应条目；no_video：该条没有视频路径；
+         * not_found：文件不存在或为空。与 Business 一致，不校验扩展名、不设大小上限。
+         */
+        status: z.enum([...unavailable, 'no_entry', 'no_video', 'not_found']),
+    })
+        .strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('rewrite'),
+        status: z.enum(['written', ...unavailable]),
+    })
+        .strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('keyframes'),
+        /** no_report：报告缺失或不合法；no_suggestion：报告里没有这条建议。均返回空列表。 */
+        status: z.enum(['read', ...unavailable, 'no_report', 'no_suggestion']),
+        /** path 相对变体 seed 根目录（`recordings/<slug>/ai_assets/<name>`）；content 为 base64。 */
+        files: z
+            .array(z
+            .object({
+            path: z.string().min(1).max(1000),
+            content: z.string().min(1).max(KEYFRAME_BASE64_MAX_CHARS),
+        })
+            .strict())
+            .max(AGENT_COMPETITOR_KEYFRAMES_MAX),
+    })
+        .strict(),
+]);
+export const agentCompetitorReportResponseSchema = z
+    .object({
+    requestId: uuid,
+    action: z.enum(agentCompetitorReportActions),
+    result: agentCompetitorReportResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-competitor-report.js.map

package/dist/cloud-workspace/runtime/agent-competitor-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-competitor-report.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-competitor-report.ts"],"names":[],"mappings":"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"}