@playcraft/common 0.0.59 → 0.1.1

package/dist/cloud-workspace/runtime/agent-source-project.js

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+/**
+ * 会话来源工程与竞品分析技能的沙箱准备（R3.16）。
+ *
+ * 调用方只声明会话、领取和要准备的范围；仓库地址、分支、工作目录都由 Runtime 从
+ * `agent_sessions`（绑定项目、playbook 状态）、`projects` 与 `competitor_playbook_configs`
+ * 推导，Git 凭证也只在 Runtime 与沙箱之间使用。
+ */
+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 agentSourceProjectActions = [
+    'materialize',
+    'install_competitor_skill',
+    'settled',
+];
+export const agentSourceProjectKinds = ['session', 'manager', 'execution'];
+/**
+ * `session`：会话准备的完整顺序（绑定项目 > 来源工程 > 竞品仓库）。
+ * `competitor`：会话中途进入竞品模式时只 clone 竞品仓库；已绑定项目的会话不动工作目录。
+ */
+export const agentSourceProjectScopes = ['session', 'competitor'];
+export const agentSourceProjectRequestSchema = z
+    .object({
+    action: z.enum(agentSourceProjectActions),
+    sessionId,
+    requestId: uuid,
+    writerEpoch: z.number().int().positive().max(2_147_483_647),
+    workspaceId: identity,
+    kind: z.enum(agentSourceProjectKinds),
+    runId: uuid.optional(),
+    executionId: uuid.optional(),
+    issueId: uuid.optional(),
+    claimToken: identity.optional(),
+    scope: z.enum(agentSourceProjectScopes).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 === 'materialize' || value.scope === undefined)
+    .refine((value) => new TextEncoder().encode(JSON.stringify(value)).byteLength <= 16_384);
+/** 物化的来源：`none` 表示会话还没有可物化的来源（空工作目录不是错误）。 */
+export const agentSourceProjectSources = ['bound', 'source', 'competitor', 'none'];
+export const agentSourceProjectFailureCodes = [
+    'bound_no_repo',
+    'bound_clone_failed',
+    'source_incomplete',
+    'source_no_repo',
+    'source_clone_failed',
+    'competitor_clone_failed',
+];
+export const agentSourceProjectResultSchema = z.union([
+    z.object({ outcome: z.literal('uncertain'), error: z.string().max(128) }).strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('materialize'),
+        source: z.enum(agentSourceProjectSources),
+        /** ready：工作目录已是目标仓库；skipped：没有要物化的来源；failed：确定失败，目录未被替换。 */
+        status: z.enum(['ready', 'skipped', 'failed']),
+        reused: z.boolean(),
+        code: z.enum(agentSourceProjectFailureCodes).optional(),
+        /** 失败时给 Manager 看的原因，已脱敏。 */
+        message: z.string().max(1_024).optional(),
+    })
+        .strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('competitor_skill'),
+        /**
+         * installed：技能目录可用；unavailable：竞品会话但装不上（没配仓库 / 凭证 / clone
+         * 或 manifest 校验失败），提示词走降级分支；not_applicable：不是竞品会话。
+         */
+        status: z.enum(['installed', 'unavailable', 'not_applicable']),
+        skillDir: z.string().min(1).max(512).nullable(),
+    })
+        .strict(),
+]);
+export const agentSourceProjectResponseSchema = z
+    .object({
+    requestId: uuid,
+    operationId: uuid,
+    action: z.enum(agentSourceProjectActions),
+    inputHash: z.string().regex(/^[a-f0-9]{64}$/),
+    result: agentSourceProjectResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-source-project.js.map

package/dist/cloud-workspace/runtime/agent-source-project.js.map

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

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

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export declare const agentVariantChatEventsRequestSchema: z.ZodObject<{
+    writerEpoch: z.ZodNumber;
+    sessionId: z.ZodString;
+    batchId: z.ZodString;
+    variantIndex: z.ZodNumber;
+}, z.core.$strict>;
+export type AgentVariantChatEventsRequest = z.infer<typeof agentVariantChatEventsRequestSchema>;
+//# sourceMappingURL=agent-variant-chat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-variant-chat.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-variant-chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,eAAO,MAAM,mCAAmC;;;;;kBAQrC,CAAC;AAEZ,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC"}

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

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+/**
+ * 变体聊天实时流（R3.14）。
+ *
+ * 弹窗打开时把某个变体的 OpenCode `/event` 转到门户 SSE。变体进程监听的是进程池分配的动态
+ * 端口，不经沙箱入口，只能在沙箱内连 `127.0.0.1`，所以源头是「在沙箱里跑一条 curl 并流式
+ * 收集 stdout」，而不是一次 HTTP 请求。
+ *
+ * 调用方只声明要看哪个变体；沙箱、端口、会话标识与那条 curl 的清理标记都由 Runtime 从
+ * `agent_draft_variants` 与 `agent_sessions` 推导并持有。响应体是 `text/event-stream`，
+ * 字节原样透传，因此没有回执，也没有结果 schema。
+ */
+const uuid = z.string().uuid();
+export const agentVariantChatEventsRequestSchema = z
+    .object({
+    writerEpoch: z.number().int().positive().max(2_147_483_647),
+    sessionId: uuid,
+    batchId: uuid,
+    /** 批次内序号，从 1 开始。 */
+    variantIndex: z.number().int().positive().max(1_000),
+})
+    .strict();
+//# sourceMappingURL=agent-variant-chat.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-variant-chat.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-variant-chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AAEH,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;AAE/B,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC;KACjD,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC;IAC3D,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,IAAI;IACb,oBAAoB;IACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC;CACrD,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/cloud-workspace/runtime/agent-variant-git.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+export declare const agentVariantGitActions: readonly ["inspect", "push_state", "settled"];
+export declare const agentVariantGitRequestSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        settled: "settled";
+        inspect: "inspect";
+        push_state: "push_state";
+    }>;
+    requestId: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    sessionId: z.ZodString;
+    batchId: z.ZodString;
+    variantIndex: z.ZodNumber;
+    settledOnly: z.ZodDefault<z.ZodBoolean>;
+    sourceBranch: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const agentVariantGitResultSchema: z.ZodUnion<readonly [z.ZodObject<{
+    outcome: z.ZodLiteral<"uncertain">;
+    error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"inspect">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        changed: "changed";
+        empty: "empty";
+    }>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"push_state">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        pushed: "pushed";
+        unpushed: "unpushed";
+    }>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>]>;
+export declare const agentVariantGitResponseSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    operationId: z.ZodString;
+    action: z.ZodEnum<{
+        settled: "settled";
+        inspect: "inspect";
+        push_state: "push_state";
+    }>;
+    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<"inspect">;
+        status: z.ZodEnum<{
+            failed: "failed";
+            changed: "changed";
+            empty: "empty";
+        }>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"push_state">;
+        status: z.ZodEnum<{
+            failed: "failed";
+            pushed: "pushed";
+            unpushed: "unpushed";
+        }>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+export type AgentVariantGitAction = (typeof agentVariantGitActions)[number];
+export type AgentVariantGitRequest = z.infer<typeof agentVariantGitRequestSchema>;
+export type AgentVariantGitResult = z.infer<typeof agentVariantGitResultSchema>;
+export type AgentVariantGitResponse = z.infer<typeof agentVariantGitResponseSchema>;
+//# sourceMappingURL=agent-variant-git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-variant-git.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-variant-git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,eAAO,MAAM,sBAAsB,+CAAgD,CAAC;AAEpF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;kBAc2C,CAAC;AAErF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;oBAoBtC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQ/B,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5E,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-variant-git.js

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+/**
+ * 变体收尾前的只读 git 检查（R3.15）。
+ *
+ * 改码结束后用工作区脏文件和相对源分支的已提交 diff 判断有没有可玩交付，接管重跑发布前
+ * 再探一次分支是不是已经推过。调用方只声明变体和（inspect 时）源分支名；沙箱、工作目录
+ * 由 Runtime 从 `agent_draft_variants` 推导。本刀不执行 commit / push。
+ */
+const uuid = z.string().uuid();
+const gitRef = z
+    .string()
+    .min(1)
+    .max(200)
+    .refine((value) => !/[\x00-\x1f]/.test(value))
+    .refine((value) => /^[A-Za-z0-9._/-]+$/.test(value));
+export const agentVariantGitActions = ['inspect', 'push_state', 'settled'];
+export const agentVariantGitRequestSchema = z
+    .object({
+    action: z.enum(agentVariantGitActions),
+    requestId: uuid,
+    writerEpoch: z.number().int().positive().max(2_147_483_647),
+    sessionId: uuid,
+    batchId: uuid,
+    variantIndex: z.number().int().positive().max(1_000),
+    settledOnly: z.boolean().default(false),
+    /** 相对哪条源分支做 three-dot diff；仅 `inspect` 需要。 */
+    sourceBranch: gitRef.optional(),
+})
+    .strict()
+    .refine((value) => value.action !== 'inspect' || Boolean(value.sourceBranch))
+    .refine((value) => value.action === 'inspect' || value.sourceBranch === undefined);
+export const agentVariantGitResultSchema = z.union([
+    z.object({ outcome: z.literal('uncertain'), error: z.string().max(256) }).strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('inspect'),
+        /** changed：有可玩交付；empty：检查成功但没有；failed：git 命令没跑成。 */
+        status: z.enum(['changed', 'empty', 'failed']),
+        error: z.string().max(256).optional(),
+    })
+        .strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('push_state'),
+        /** pushed：HEAD 已在 origin；unpushed：还要提交或推送；failed：探测没跑成。 */
+        status: z.enum(['pushed', 'unpushed', 'failed']),
+        error: z.string().max(256).optional(),
+    })
+        .strict(),
+]);
+export const agentVariantGitResponseSchema = z
+    .object({
+    requestId: uuid,
+    operationId: uuid,
+    action: z.enum(agentVariantGitActions),
+    inputHash: z.string().regex(/^[a-f0-9]{64}$/),
+    result: agentVariantGitResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-variant-git.js.map

package/dist/cloud-workspace/runtime/agent-variant-git.js.map

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

package/dist/cloud-workspace/runtime/capabilities.d.ts

@@ -28,11 +28,11 @@ export declare const CORE_RUNTIME_PHASES: readonly ["starting", "awaiting_native
 export type CoreRuntimePhase = (typeof CORE_RUNTIME_PHASES)[number];
 export declare const coreRuntimePhaseSchema: z.ZodEnum<{
     ready: "ready";
+    unavailable: "unavailable";
     starting: "starting";
     awaiting_native: "awaiting_native";
     restoring: "restoring";
     quiescing: "quiescing";
-    unavailable: "unavailable";
 }>;
 export declare function capability(name: RuntimeCapabilityName, ready: boolean, reason?: string): CapabilityState;
 export declare function listDeclaredCapabilities(states: readonly CapabilityState[]): RuntimeCapabilityName[];

package/dist/cloud-workspace/runtime/chat-realtime-admission.d.ts

@@ -0,0 +1,53 @@
+import { CHAT_REALTIME_V2 } from './chat-realtime.js';
+/**
+ * Section 9 rows. A logical runtime may advertise chatRealtimeV2 only when every row
+ * passed and the section 1 measurement conditions were actually met.
+ */
+export declare const CHAT_REALTIME_ACCEPTANCE_ROWS: readonly ["paced_output", "archive_delay", "approval_and_stop", "early_notification_crash", "durable_before_live", "out_of_order_prefix", "refresh_snapshot", "non_owner_replica", "slow_subscriber", "ten_thousand_fragments", "revoke_and_disconnect", "crash_and_loss", "sqlite_commit_boundaries", "checkpoint_pin_disk", "native_jsonl_and_migration", "sandbox_disk_engine", "entry_proxy"];
+export type ChatRealtimeAcceptanceRow = (typeof CHAT_REALTIME_ACCEPTANCE_ROWS)[number];
+export type ChatRealtimeRowStatus = 'passed' | 'failed' | 'untested';
+export type ChatRealtimeAdmissionInput = {
+    logicalRuntimeId: string;
+    rows: Record<ChatRealtimeAcceptanceRow, ChatRealtimeRowStatus>;
+    networkBudgetMet: boolean;
+    percentileSampleMet: boolean;
+    browserPaintObserved: boolean;
+    fixedCodexVersion: string | null;
+    protocolMinor: number;
+    replacesCursorSemantics: boolean;
+    deletesUnconfirmedSources: boolean;
+};
+export type ChatRealtimeAdmission = {
+    advertise: true;
+    mode: typeof CHAT_REALTIME_V2;
+    logicalRuntimeId: string;
+} | {
+    advertise: false;
+    code: 'chat_realtime_unavailable';
+    logicalRuntimeId: string;
+    blockedBy: string[];
+};
+export type RealtimeTurnAdmission = {
+    ok: true;
+    mode: 'conversation' | typeof CHAT_REALTIME_V2;
+} | {
+    ok: false;
+    code: 'chat_realtime_unavailable';
+    history: 'read';
+    fallback: 'none';
+};
+export declare function closedChatRealtimeAdmission(logicalRuntimeId: string): ChatRealtimeAdmissionInput;
+/** Production advertisement. There is no environment override. */
+export declare function advertisedChatModes(logicalRuntimeId: string): readonly string[];
+export declare function mayAdvertiseChatRealtime(input: ChatRealtimeAdmissionInput): ChatRealtimeAdmission;
+/**
+ * A requested realtime upload is refused when this logical runtime does not advertise it.
+ * Refusal keeps history reads and does not select a whole-turn upload mode.
+ * An omitted upload stays on the existing conversation path.
+ */
+export declare function admitRealtimeTurn(input: {
+    requestedUpload?: string;
+    localModes: readonly string[];
+    remoteModes: readonly string[];
+}): RealtimeTurnAdmission;
+//# sourceMappingURL=chat-realtime-admission.d.ts.map

package/dist/cloud-workspace/runtime/chat-realtime-admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-realtime-admission.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/chat-realtime-admission.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAyB,MAAM,oBAAoB,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,6BAA6B,mYAkBhC,CAAC;AAEX,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvF,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAErE,MAAM,MAAM,0BAA0B,GAAG;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC,yBAAyB,EAAE,qBAAqB,CAAC,CAAC;IAC/D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,OAAO,CAAC;IACjC,yBAAyB,EAAE,OAAO,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,gBAAgB,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,2BAA2B,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3G,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,cAAc,GAAG,OAAO,gBAAgB,CAAA;CAAE,GAC5D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,2BAA2B,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF,wBAAgB,2BAA2B,CAAC,gBAAgB,EAAE,MAAM,GAAG,0BAA0B,CAehG;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAG/E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,0BAA0B,GAAG,qBAAqB,CAsBjG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,GAAG,qBAAqB,CAYxB"}

package/dist/cloud-workspace/runtime/chat-realtime-admission.js

@@ -0,0 +1,95 @@
+import { CLOUD_WORKSPACE_PROTOCOL_MINOR } from './protocol.js';
+import { CHAT_REALTIME_V2, negotiateChatRealtime } from './chat-realtime.js';
+/**
+ * Section 9 rows. A logical runtime may advertise chatRealtimeV2 only when every row
+ * passed and the section 1 measurement conditions were actually met.
+ */
+export const CHAT_REALTIME_ACCEPTANCE_ROWS = [
+    'paced_output',
+    'archive_delay',
+    'approval_and_stop',
+    'early_notification_crash',
+    'durable_before_live',
+    'out_of_order_prefix',
+    'refresh_snapshot',
+    'non_owner_replica',
+    'slow_subscriber',
+    'ten_thousand_fragments',
+    'revoke_and_disconnect',
+    'crash_and_loss',
+    'sqlite_commit_boundaries',
+    'checkpoint_pin_disk',
+    'native_jsonl_and_migration',
+    'sandbox_disk_engine',
+    'entry_proxy',
+];
+export function closedChatRealtimeAdmission(logicalRuntimeId) {
+    const rows = Object.fromEntries(CHAT_REALTIME_ACCEPTANCE_ROWS.map((row) => [row, 'untested']));
+    return {
+        logicalRuntimeId,
+        rows,
+        networkBudgetMet: false,
+        percentileSampleMet: false,
+        browserPaintObserved: false,
+        fixedCodexVersion: null,
+        protocolMinor: CLOUD_WORKSPACE_PROTOCOL_MINOR,
+        replacesCursorSemantics: false,
+        deletesUnconfirmedSources: false,
+    };
+}
+/** Production advertisement. There is no environment override. */
+export function advertisedChatModes(logicalRuntimeId) {
+    const decision = mayAdvertiseChatRealtime(closedChatRealtimeAdmission(logicalRuntimeId));
+    return decision.advertise ? [decision.mode] : [];
+}
+export function mayAdvertiseChatRealtime(input) {
+    const blockedBy = [];
+    if (!input.logicalRuntimeId.trim())
+        blockedBy.push('logical_runtime');
+    for (const row of CHAT_REALTIME_ACCEPTANCE_ROWS) {
+        if (input.rows[row] !== 'passed')
+            blockedBy.push(row);
+    }
+    if (!input.networkBudgetMet)
+        blockedBy.push('network_budget');
+    if (!input.percentileSampleMet)
+        blockedBy.push('percentile_sample');
+    if (!input.browserPaintObserved)
+        blockedBy.push('browser_paint');
+    if (!input.fixedCodexVersion?.trim())
+        blockedBy.push('fixed_codex_version');
+    if (input.protocolMinor !== CLOUD_WORKSPACE_PROTOCOL_MINOR)
+        blockedBy.push('protocol_minor');
+    if (input.replacesCursorSemantics)
+        blockedBy.push('cursor_semantics');
+    if (input.deletesUnconfirmedSources)
+        blockedBy.push('unconfirmed_sources');
+    if (blockedBy.length > 0) {
+        return {
+            advertise: false,
+            code: 'chat_realtime_unavailable',
+            logicalRuntimeId: input.logicalRuntimeId,
+            blockedBy,
+        };
+    }
+    return { advertise: true, mode: CHAT_REALTIME_V2, logicalRuntimeId: input.logicalRuntimeId };
+}
+/**
+ * A requested realtime upload is refused when this logical runtime does not advertise it.
+ * Refusal keeps history reads and does not select a whole-turn upload mode.
+ * An omitted upload stays on the existing conversation path.
+ */
+export function admitRealtimeTurn(input) {
+    if (input.requestedUpload === undefined || input.requestedUpload === 'conversation') {
+        return { ok: true, mode: 'conversation' };
+    }
+    if (input.requestedUpload !== CHAT_REALTIME_V2) {
+        return { ok: false, code: 'chat_realtime_unavailable', history: 'read', fallback: 'none' };
+    }
+    const negotiated = negotiateChatRealtime({ local: input.localModes, remote: input.remoteModes });
+    if (!negotiated.ok) {
+        return { ok: false, code: 'chat_realtime_unavailable', history: 'read', fallback: 'none' };
+    }
+    return { ok: true, mode: CHAT_REALTIME_V2 };
+}
+//# sourceMappingURL=chat-realtime-admission.js.map

package/dist/cloud-workspace/runtime/chat-realtime-admission.js.map

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