@playcraft/common 0.1.36-beta1 → 0.1.37-beta

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

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+export declare const agentChatFlushActions: readonly ["flush_opencode_message", "settled"];
+export declare const agentChatFlushRequestSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        settled: "settled";
+        flush_opencode_message: "flush_opencode_message";
+    }>;
+    requestId: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    projectId: z.ZodString;
+    branchName: z.ZodString;
+    settledOnly: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const agentChatFlushResultSchema: z.ZodUnion<readonly [z.ZodObject<{
+    outcome: z.ZodLiteral<"uncertain">;
+    error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"flush">;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+    }>;
+    skipped: z.ZodBoolean;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>]>;
+export declare const agentChatFlushResponseSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    operationId: z.ZodString;
+    action: z.ZodEnum<{
+        settled: "settled";
+        flush_opencode_message: "flush_opencode_message";
+    }>;
+    inputHash: z.ZodString;
+    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<"flush">;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+        }>;
+        skipped: z.ZodBoolean;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+export type AgentChatFlushAction = (typeof agentChatFlushActions)[number];
+export type AgentChatFlushRequest = z.infer<typeof agentChatFlushRequestSchema>;
+export type AgentChatFlushResult = z.infer<typeof agentChatFlushResultSchema>;
+export type AgentChatFlushResponse = z.infer<typeof agentChatFlushResponseSchema>;
+//# sourceMappingURL=agent-chat-flush.d.ts.map

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

@@ -0,0 +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,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

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+/**
+ * 聊天记录落盘（R3.13）。
+ *
+ * 编辑器的事件监控在会话空闲时让沙箱内 Slot Manager 把本地聊天数据写到 `/mnt/memory`
+ * （per-user COSFS 挂载），随后 Business 才记 artifact 元数据行。这里迁的是前半段：
+ * 调用方只声明落盘动作，沙箱、slot 与 Slot Manager 地址都由 Runtime 推导。
+ *
+ * 元数据入库仍在调用方，因为那是数据库写入，不是沙箱访问。
+ */
+const uuid = z.string().uuid();
+const branchName = z
+    .string()
+    .min(1)
+    .max(200)
+    .refine((value) => !/[\x00-\x1f]/.test(value));
+export const agentChatFlushActions = ['flush_opencode_message', 'settled'];
+export const agentChatFlushRequestSchema = z
+    .object({
+    action: z.enum(agentChatFlushActions),
+    requestId: uuid,
+    writerEpoch: z.number().int().positive().max(2_147_483_647),
+    projectId: uuid,
+    branchName,
+    settledOnly: z.boolean().default(false),
+})
+    .strict();
+export const agentChatFlushResultSchema = z.union([
+    z.object({ outcome: z.literal('uncertain'), error: z.string().max(256) }).strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('flush'),
+        status: z.enum(['completed', 'failed']),
+        /** Slot Manager reported nothing to write; the caller must not record an artifact row. */
+        skipped: z.boolean(),
+        durationMs: z.number().int().nonnegative().max(3_600_000).optional(),
+        error: z.string().max(256).optional(),
+    })
+        .strict(),
+]);
+export const agentChatFlushResponseSchema = z
+    .object({
+    requestId: uuid,
+    operationId: uuid,
+    action: z.enum(agentChatFlushActions),
+    inputHash: z.string().regex(/^[a-f0-9]{64}$/),
+    result: agentChatFlushResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-chat-flush.js.map

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

@@ -0,0 +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,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

@@ -0,0 +1,152 @@
+import { z } from 'zod';
+export declare const agentCommandRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    toolName: z.ZodLiteral<"bash">;
+    input: z.ZodObject<{
+        command: z.ZodString;
+        cwd: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>;
+    action: z.ZodEnum<{
+        settled: "settled";
+        start: "start";
+        observe: "observe";
+        cancel: "cancel";
+    }>;
+    timeoutMs: z.ZodNumber;
+    kind: z.ZodEnum<{
+        execution: "execution";
+        manager: "manager";
+    }>;
+    sessionId: z.ZodString;
+    workspaceId: z.ZodString;
+    runId: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    triggeredByMessageId: z.ZodNullable<z.ZodString>;
+    claimToken: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    ledgerId: z.ZodString;
+    toolCallId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    toolName: z.ZodLiteral<"inspector-bash">;
+    input: z.ZodObject<{
+        command: z.ZodString;
+        cwd: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    action: z.ZodEnum<{
+        settled: "settled";
+        start: "start";
+        observe: "observe";
+        cancel: "cancel";
+    }>;
+    timeoutMs: z.ZodNumber;
+    kind: z.ZodEnum<{
+        execution: "execution";
+        manager: "manager";
+    }>;
+    sessionId: z.ZodString;
+    workspaceId: z.ZodString;
+    runId: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    triggeredByMessageId: z.ZodNullable<z.ZodString>;
+    claimToken: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    ledgerId: z.ZodString;
+    toolCallId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    toolName: z.ZodLiteral<"generate_replica_variants">;
+    input: z.ZodObject<{
+        suggestionIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    action: z.ZodEnum<{
+        settled: "settled";
+        start: "start";
+        observe: "observe";
+        cancel: "cancel";
+    }>;
+    timeoutMs: z.ZodNumber;
+    kind: z.ZodEnum<{
+        execution: "execution";
+        manager: "manager";
+    }>;
+    sessionId: z.ZodString;
+    workspaceId: z.ZodString;
+    runId: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    triggeredByMessageId: z.ZodNullable<z.ZodString>;
+    claimToken: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    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">;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"uncertain">;
+    error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    output: 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>;
+}, z.core.$strict>], "outcome">;
+export declare const agentCommandResponseSchema: z.ZodObject<{
+    ledgerId: z.ZodString;
+    toolCallId: z.ZodString;
+    toolName: z.ZodEnum<{
+        bash: "bash";
+        "inspector-bash": "inspector-bash";
+        generate_replica_variants: "generate_replica_variants";
+    }>;
+    inputHash: z.ZodString;
+    result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        outcome: z.ZodLiteral<"running">;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"uncertain">;
+        error: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        output: 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>;
+    }, 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

@@ -0,0 +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;;;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

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import { agentToolClaimShape } from './agent-tool-claim.js';
+const commandClaim = {
+    ...agentToolClaimShape,
+    action: z.enum(['start', 'observe', 'settled', 'cancel']),
+    timeoutMs: z.number().int().min(1).max(600_000),
+};
+const commandText = z.string().min(1).max(40_000);
+const commandCwd = z.string().min(1).max(4096).optional();
+export const agentCommandRequestSchema = z
+    .discriminatedUnion('toolName', [
+    z
+        .object({
+        ...commandClaim,
+        toolName: z.literal('bash'),
+        input: z
+            .object({
+            command: commandText,
+            cwd: commandCwd,
+            raw: z.boolean().optional(),
+        })
+            .strict(),
+    })
+        .strict(),
+    z
+        .object({
+        ...commandClaim,
+        toolName: z.literal('inspector-bash'),
+        input: z
+            .object({
+            command: commandText,
+            cwd: commandCwd,
+        })
+            .strict(),
+    })
+        .strict(),
+    z
+        .object({
+        ...commandClaim,
+        toolName: z.literal('generate_replica_variants'),
+        input: z
+            .object({
+            suggestionIds: z.array(z.string().min(1)).min(1).max(10),
+        })
+            .strict(),
+    })
+        .strict(),
+])
+    .refine((value) => value.kind === 'execution'
+    ? 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', [
+    z.object({ outcome: z.literal('running') }).strict(),
+    z.object({ outcome: z.literal('uncertain'), error: z.string().max(128) }).strict(),
+    z.object({ outcome: z.literal('settled'), output: agentCommandOutputSchema }).strict(),
+]);
+export const agentCommandResponseSchema = z
+    .object({
+    ledgerId: z.string().uuid(),
+    toolCallId: z.string(),
+    toolName: z.enum(['bash', 'inspector-bash', 'generate_replica_variants']),
+    inputHash: z.string().regex(/^[a-f0-9]{64}$/),
+    result: agentCommandResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-command.js.map

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

@@ -0,0 +1 @@
+{"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<{
+        execution: "execution";
+        manager: "manager";
+    }>;
+    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"}