@playcraft/common 0.1.24 → 0.1.26

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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"}

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

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+export declare const agentConnectionActions: readonly ["ensure_opencode", "ensure_preview", "sync_model", "settled"];
+export declare const agentConnectionKinds: readonly ["session", "manager", "execution"];
+export declare const agentConnectionRequestSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        settled: "settled";
+        ensure_opencode: "ensure_opencode";
+        ensure_preview: "ensure_preview";
+        sync_model: "sync_model";
+    }>;
+    sessionId: z.ZodString;
+    requestId: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    workspaceId: z.ZodString;
+    kind: z.ZodEnum<{
+        session: "session";
+        execution: "execution";
+        manager: "manager";
+    }>;
+    runId: z.ZodOptional<z.ZodString>;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    claimToken: z.ZodOptional<z.ZodString>;
+    settledOnly: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const agentConnectionResultSchema: 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">;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        skipped: "skipped";
+    }>;
+    sandboxId: z.ZodNullable<z.ZodString>;
+    alreadyRunning: z.ZodBoolean;
+    skipped: z.ZodBoolean;
+    previewReady: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "outcome">;
+export declare const agentConnectionResponseSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    operationId: z.ZodString;
+    action: z.ZodEnum<{
+        settled: "settled";
+        ensure_opencode: "ensure_opencode";
+        ensure_preview: "ensure_preview";
+        sync_model: "sync_model";
+    }>;
+    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">;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            skipped: "skipped";
+        }>;
+        sandboxId: z.ZodNullable<z.ZodString>;
+        alreadyRunning: z.ZodBoolean;
+        skipped: z.ZodBoolean;
+        previewReady: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "outcome">;
+}, z.core.$strict>;
+export type AgentConnectionRequest = z.infer<typeof agentConnectionRequestSchema>;
+export type AgentConnectionResult = z.infer<typeof agentConnectionResultSchema>;
+export type AgentConnectionResponse = z.infer<typeof agentConnectionResponseSchema>;
+//# sourceMappingURL=agent-connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-connection.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,sBAAsB,yEAKzB,CAAC;AACX,eAAO,MAAM,oBAAoB,8CAA+C,CAAC;AAEjF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;kBAsBiD,CAAC;AAE3F,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;+BActC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQ/B,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

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

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+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 agentConnectionActions = [
+    'ensure_opencode',
+    'ensure_preview',
+    'sync_model',
+    'settled',
+];
+export const agentConnectionKinds = ['session', 'manager', 'execution'];
+export const agentConnectionRequestSchema = z
+    .object({
+    action: z.enum(agentConnectionActions),
+    sessionId,
+    requestId: uuid,
+    writerEpoch: z.number().int().positive().max(2_147_483_647),
+    workspaceId: identity,
+    kind: z.enum(agentConnectionKinds),
+    runId: uuid.optional(),
+    executionId: uuid.optional(),
+    issueId: uuid.optional(),
+    claimToken: identity.optional(),
+    settledOnly: z.boolean().default(false),
+})
+    .strict()
+    .refine((value) => {
+    if (value.kind === 'session')
+        return !value.runId && !value.executionId && !value.issueId && !value.claimToken;
+    if (value.kind === 'manager')
+        return Boolean(value.runId && value.claimToken) && !value.executionId && !value.issueId;
+    return Boolean(value.runId && value.executionId && value.issueId && value.claimToken);
+})
+    .refine((value) => new TextEncoder().encode(JSON.stringify(value)).byteLength <= 16_384);
+export const agentConnectionResultSchema = 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'),
+        status: z.enum(['completed', 'skipped', 'failed']),
+        sandboxId: z.string().min(1).max(128).nullable(),
+        alreadyRunning: z.boolean(),
+        skipped: z.boolean(),
+        previewReady: z.boolean(),
+        error: z.string().max(128).optional(),
+    })
+        .strict(),
+]);
+export const agentConnectionResponseSchema = z
+    .object({
+    requestId: uuid,
+    operationId: uuid,
+    action: z.enum(agentConnectionActions),
+    inputHash: z.string().regex(/^[a-f0-9]{64}$/),
+    result: agentConnectionResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-connection.js.map

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

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

package/dist/cloud-workspace/runtime/agent-issue-artifacts.d.ts

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+export declare const agentIssueArtifactActions: readonly ["list", "read"];
+export declare const agentIssueArtifactsRequestSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        read: "read";
+        list: "list";
+    }>;
+    requestId: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    issueId: z.ZodString;
+    relativePath: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** 与 Agent 读取工具同一上限。 */
+export declare const AGENT_ISSUE_ARTIFACT_MAX_CHARS: number;
+export declare const AGENT_ISSUE_ARTIFACT_MAX_ENTRIES = 1000;
+export declare const agentIssueArtifactsResultSchema: z.ZodUnion<readonly [z.ZodObject<{
+    outcome: z.ZodLiteral<"uncertain">;
+    error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"list">;
+    status: z.ZodEnum<{
+        no_sandbox: "no_sandbox";
+        listed: "listed";
+        no_execenv: "no_execenv";
+    }>;
+    files: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            file: "file";
+            dir: "dir";
+        }>;
+        size: z.ZodNumber;
+    }, z.core.$strict>>;
+    truncated: z.ZodBoolean;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"read">;
+    status: z.ZodEnum<{
+        read: "read";
+        no_sandbox: "no_sandbox";
+        not_found: "not_found";
+        no_execenv: "no_execenv";
+        too_large: "too_large";
+    }>;
+    content: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>]>;
+export declare const agentIssueArtifactsResponseSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    action: z.ZodEnum<{
+        read: "read";
+        list: "list";
+    }>;
+    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<"list">;
+        status: z.ZodEnum<{
+            no_sandbox: "no_sandbox";
+            listed: "listed";
+            no_execenv: "no_execenv";
+        }>;
+        files: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                file: "file";
+                dir: "dir";
+            }>;
+            size: z.ZodNumber;
+        }, z.core.$strict>>;
+        truncated: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"read">;
+        status: z.ZodEnum<{
+            read: "read";
+            no_sandbox: "no_sandbox";
+            not_found: "not_found";
+            no_execenv: "no_execenv";
+            too_large: "too_large";
+        }>;
+        content: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+export type AgentIssueArtifactsRequest = z.infer<typeof agentIssueArtifactsRequestSchema>;
+export type AgentIssueArtifactsResult = z.infer<typeof agentIssueArtifactsResultSchema>;
+export type AgentIssueArtifactsResponse = z.infer<typeof agentIssueArtifactsResponseSchema>;
+//# sourceMappingURL=agent-issue-artifacts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-issue-artifacts.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-issue-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,yBAAyB,2BAA4B,CAAC;AAEnE,eAAO,MAAM,gCAAgC;;;;;;;;;kBASuC,CAAC;AAErF,wBAAwB;AACxB,eAAO,MAAM,8BAA8B,QAAmB,CAAC;AAC/D,eAAO,MAAM,gCAAgC,OAAQ,CAAC;AAEtD,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA8B1C,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMnC,CAAC;AAEZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC"}

package/dist/cloud-workspace/runtime/agent-issue-artifacts.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+/**
+ * Issue 产物浏览（R3.16）：列出 / 读取某个 issue 最新一次执行的 execenv 输出。
+ *
+ * 用户能否访问这个 issue 仍由 Agent 判定；execenv 目录和沙箱由 Runtime 从
+ * `agent_executions` / `agent_sessions` 推导，调用方只给相对路径，越出 execenv 一律拒绝。
+ * 只读，不留回执。
+ */
+const uuid = z.string().uuid();
+export const agentIssueArtifactActions = ['list', 'read'];
+export const agentIssueArtifactsRequestSchema = z
+    .object({
+    action: z.enum(agentIssueArtifactActions),
+    requestId: uuid,
+    writerEpoch: z.number().int().positive().max(2_147_483_647),
+    issueId: uuid,
+    relativePath: z.string().max(1_024).optional(),
+})
+    .strict()
+    .refine((value) => value.action === 'list' || Boolean(value.relativePath?.trim()));
+/** 与 Agent 读取工具同一上限。 */
+export const AGENT_ISSUE_ARTIFACT_MAX_CHARS = 16 * 1024 * 1024;
+export const AGENT_ISSUE_ARTIFACT_MAX_ENTRIES = 1_000;
+export const agentIssueArtifactsResultSchema = z.union([
+    z.object({ outcome: z.literal('uncertain'), error: z.string().max(128) }).strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('list'),
+        /** no_execenv：还没有执行产物；no_sandbox：产物所在的沙箱已不在记录里。 */
+        status: z.enum(['listed', 'no_execenv', 'no_sandbox']),
+        files: z
+            .array(z
+            .object({
+            name: z.string().min(1).max(512),
+            type: z.enum(['file', 'dir']),
+            size: z.number().int().nonnegative(),
+        })
+            .strict())
+            .max(AGENT_ISSUE_ARTIFACT_MAX_ENTRIES),
+        truncated: z.boolean(),
+    })
+        .strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('read'),
+        status: z.enum(['read', 'no_execenv', 'no_sandbox', 'not_found', 'too_large']),
+        content: z.string().max(AGENT_ISSUE_ARTIFACT_MAX_CHARS).optional(),
+    })
+        .strict(),
+]);
+export const agentIssueArtifactsResponseSchema = z
+    .object({
+    requestId: uuid,
+    action: z.enum(agentIssueArtifactActions),
+    result: agentIssueArtifactsResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-issue-artifacts.js.map

package/dist/cloud-workspace/runtime/agent-issue-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-issue-artifacts.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-issue-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AAEH,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;AAE/B,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC;AAEnE,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC;KAC9C,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC;IACzC,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC;IAC3D,OAAO,EAAE,IAAI;IACb,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC;KACD,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAErF,wBAAwB;AACxB,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAC/D,MAAM,CAAC,MAAM,gCAAgC,GAAG,KAAK,CAAC;AAEtD,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC;IACrD,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,MAAM,CAAC;QACvB,mDAAmD;QACnD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;QACtD,KAAK,EAAE,CAAC;aACL,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;YAChC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC;aACD,MAAM,EAAE,CACZ;aACA,GAAG,CAAC,gCAAgC,CAAC;QACxC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;KACvB,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,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QAC9E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC,QAAQ,EAAE;KACnE,CAAC;SACD,MAAM,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC;KAC/C,MAAM,CAAC;IACN,SAAS,EAAE,IAAI;IACf,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC;IACzC,MAAM,EAAE,+BAA+B;CACxC,CAAC;KACD,MAAM,EAAE,CAAC"}

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

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+export declare const agentLifecycleActions: readonly ["allocate", "renew", "recycle", "prepare", "probe", "settled"];
+export declare const agentLifecycleKinds: readonly ["session", "manager", "execution"];
+export declare const agentLifecycleRequestSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        prepare: "prepare";
+        renew: "renew";
+        settled: "settled";
+        allocate: "allocate";
+        recycle: "recycle";
+        probe: "probe";
+    }>;
+    sessionId: z.ZodString;
+    requestId: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    workspaceId: z.ZodString;
+    kind: z.ZodEnum<{
+        session: "session";
+        execution: "execution";
+        manager: "manager";
+    }>;
+    runId: z.ZodOptional<z.ZodString>;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    claimToken: z.ZodOptional<z.ZodString>;
+    recycleReason: z.ZodOptional<z.ZodString>;
+    settledOnly: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const agentLifecycleSettledOutputSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        completed: "completed";
+        skipped: "skipped";
+    }>;
+    sandboxId: z.ZodNullable<z.ZodString>;
+    reused: z.ZodBoolean;
+    prepared: z.ZodBoolean;
+    recycled: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const agentLifecycleResultSchema: 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">;
+    status: z.ZodEnum<{
+        completed: "completed";
+        skipped: "skipped";
+    }>;
+    sandboxId: z.ZodNullable<z.ZodString>;
+    reused: z.ZodBoolean;
+    prepared: z.ZodBoolean;
+    recycled: z.ZodBoolean;
+}, z.core.$strict>], "outcome">;
+export declare const agentLifecycleResponseSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    operationId: z.ZodString;
+    action: z.ZodEnum<{
+        prepare: "prepare";
+        renew: "renew";
+        settled: "settled";
+        allocate: "allocate";
+        recycle: "recycle";
+        probe: "probe";
+    }>;
+    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">;
+        status: z.ZodEnum<{
+            completed: "completed";
+            skipped: "skipped";
+        }>;
+        sandboxId: z.ZodNullable<z.ZodString>;
+        reused: z.ZodBoolean;
+        prepared: z.ZodBoolean;
+        recycled: z.ZodBoolean;
+    }, z.core.$strict>], "outcome">;
+}, z.core.$strict>;
+export type AgentLifecycleRequest = z.infer<typeof agentLifecycleRequestSchema>;
+export type AgentLifecycleResult = z.infer<typeof agentLifecycleResultSchema>;
+export type AgentLifecycleResponse = z.infer<typeof agentLifecycleResponseSchema>;
+//# sourceMappingURL=agent-lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,qBAAqB,0EAWxB,CAAC;AACX,eAAO,MAAM,mBAAmB,8CAA+C,CAAC;AAEhF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;kBAwBkD,CAAC;AAE3F,eAAO,MAAM,iCAAiC;;;;;;;;;kBAQnC,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;+BAarC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQ9B,CAAC;AAEZ,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-lifecycle.js

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+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 agentLifecycleActions = [
+    'allocate',
+    'renew',
+    'recycle',
+    'prepare',
+    /**
+     * Read-only: is the session's bound sandbox running? `completed` = running, `skipped` = not
+     * running or gone. Anything else is uncertain. It extends nothing and keeps no receipt.
+     */
+    'probe',
+    'settled',
+];
+export const agentLifecycleKinds = ['session', 'manager', 'execution'];
+export const agentLifecycleRequestSchema = z
+    .object({
+    action: z.enum(agentLifecycleActions),
+    sessionId,
+    requestId: uuid,
+    writerEpoch: z.number().int().positive().max(2_147_483_647),
+    workspaceId: identity,
+    kind: z.enum(agentLifecycleKinds),
+    runId: uuid.optional(),
+    executionId: uuid.optional(),
+    issueId: uuid.optional(),
+    claimToken: identity.optional(),
+    recycleReason: z.string().min(1).max(128).optional(),
+    settledOnly: z.boolean().default(false),
+})
+    .strict()
+    .refine((value) => {
+    if (value.kind === 'session')
+        return !value.runId && !value.executionId && !value.issueId && !value.claimToken;
+    if (value.kind === 'manager')
+        return Boolean(value.runId && value.claimToken) && !value.executionId && !value.issueId;
+    return Boolean(value.runId && value.executionId && value.issueId && value.claimToken);
+})
+    .refine((value) => value.action === 'recycle' || value.recycleReason === undefined)
+    .refine((value) => new TextEncoder().encode(JSON.stringify(value)).byteLength <= 16_384);
+export const agentLifecycleSettledOutputSchema = z
+    .object({
+    status: z.enum(['completed', 'skipped']),
+    sandboxId: z.string().min(1).max(128).nullable(),
+    reused: z.boolean(),
+    prepared: z.boolean(),
+    recycled: z.boolean(),
+})
+    .strict();
+export const agentLifecycleResultSchema = 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'),
+        status: z.enum(['completed', 'skipped']),
+        sandboxId: z.string().min(1).max(128).nullable(),
+        reused: z.boolean(),
+        prepared: z.boolean(),
+        recycled: z.boolean(),
+    })
+        .strict(),
+]);
+export const agentLifecycleResponseSchema = z
+    .object({
+    requestId: uuid,
+    operationId: uuid,
+    action: z.enum(agentLifecycleActions),
+    inputHash: z.string().regex(/^[a-f0-9]{64}$/),
+    result: agentLifecycleResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-lifecycle.js.map

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

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