@playcraft/common 0.1.42 → 0.1.44-beta

package/dist/cloud-workspace/runtime/batch-runs.js

@@ -0,0 +1,232 @@
+import { z } from 'zod';
+import { workspaceDirectoryNameSchema, workspaceSessionScopeSchema } from './workspace-directories.js';
+import { batchRunDeliveryEvidenceSchema, batchRunPhaseSchema, batchRunSchema, batchSourceSnapshotRefSchema, } from './execution-admission.js';
+/**
+ * Cross-service protocol of the batch flow (design §2, §5, §8, §9).
+ * Business → Runtime: `/internal/batch-runs/*`; Runtime → sandbox: `/runtime/batch-*`;
+ * Runtime → Business: `/api/internal/cloud-batches/runs/events`.
+ */
+const uuid = z.string().uuid();
+const commitHash = z.string().regex(/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/);
+/* ---------------- Feature switches ---------------- */
+/** Runtime: unified admission for every directory execution. Off = normal chat does not queue. */
+export const EXECUTION_ADMISSION_ENABLED_ENV = 'CLOUD_EXECUTION_ADMISSION_ENABLED';
+/** Business + Runtime: new batch entry. Off = old production flow untouched. */
+export const BATCH_FLOW_V2_ENABLED_ENV = 'CLOUD_BATCH_FLOW_V2_ENABLED';
+/* ---------------- Source freeze ---------------- */
+export const batchSourceFreezeRequestSchema = z.object({
+    batchId: uuid,
+    workspaceId: uuid,
+    sourceDirectoryName: workspaceDirectoryNameSchema,
+    /** Directory of the conversation turn that called `create-batch`; absent for the panel. */
+    initiatorDirectoryName: workspaceSessionScopeSchema.optional(),
+    initiatorOperationId: z.string().min(1).max(128).optional(),
+    /** Optional idempotency key for sync-to-batch re-freeze (distinct from batchId). */
+    syncId: uuid.optional(),
+}).strict();
+/**
+ * `frozen`: snapshot captured and durable.
+ * `pending`: source directory busy with another turn — freeze runs after that turn and before the next.
+ */
+export const batchSourceFreezeResultSchema = z.discriminatedUnion('status', [
+    z.object({ status: z.literal('frozen'), snapshot: batchSourceSnapshotRefSchema }).strict(),
+    z.object({ status: z.literal('pending'), batchId: uuid }).strict(),
+    z.object({ status: z.literal('failed'), batchId: uuid, error: z.string().max(128) }).strict(),
+]);
+/** Sandbox `POST /runtime/batch-sources/freeze`. Synchronous; idempotent per batchId. */
+export const sandboxBatchSourceFreezeRequestSchema = z.object({
+    batchId: uuid,
+    workspaceId: uuid,
+    sourceDirectoryName: workspaceDirectoryNameSchema,
+    /** `remote_ref` pushes `refs/playcraft/batch/<batchId>/source`; `artifact` uploads to private storage. */
+    persist: z.enum(['remote_ref', 'artifact']),
+}).strict();
+/* ---------------- Member execution (Runtime → sandbox) ---------------- */
+const memberCommandBase = {
+    runId: uuid,
+    ownerFence: z.number().int().min(0),
+    workspaceId: uuid,
+    directoryName: workspaceDirectoryNameSchema,
+    /** Runtime-issued occupancy reference; the sandbox rejects member commands without it. */
+    occupancyId: uuid,
+};
+/** `POST /runtime/batch-members/prepare` — clone/restore from snapshot (or resume commit), install deps. */
+export const sandboxBatchMemberPrepareSchema = z.object({
+    ...memberCommandBase,
+    snapshot: batchSourceSnapshotRefSchema,
+    remixId: uuid.nullable(),
+    branchName: z.string().trim().min(1).max(512),
+    resumeFromCommit: commitHash.optional(),
+}).strict();
+/** `POST /runtime/batch-members/generate` — one unattended turn on the shared session base. */
+export const sandboxBatchMemberGenerateSchema = z.object({
+    ...memberCommandBase,
+    prompt: z.string().min(1).max(20_000),
+    model: z.string().min(1).max(200).optional(),
+    sessionId: z.string().min(1).max(128).optional(),
+}).strict();
+/** `POST /runtime/batch-members/deliver` — save exact commit, push, build from it, verify, publish. */
+export const sandboxBatchMemberDeliverSchema = z.object({
+    ...memberCommandBase,
+    pushRemote: z.boolean(),
+    fromCommit: commitHash.optional(),
+}).strict();
+/** `POST /runtime/batch-members/:runId/stop`. */
+export const sandboxBatchMemberStopSchema = z.object({ runId: uuid, ownerFence: z.number().int().min(0) }).strict();
+export const sandboxBatchMemberStateSchema = z.enum([
+    'idle', 'running', 'completed', 'failed', 'needs_user', 'stopping', 'stopped', 'unknown',
+]);
+/** Response of every member command and of `GET /runtime/batch-members/:runId`. Read-only query. */
+export const sandboxBatchMemberStatusSchema = z.object({
+    runId: uuid,
+    ownerFence: z.number().int().min(0),
+    phase: batchRunPhaseSchema,
+    state: sandboxBatchMemberStateSchema,
+    /** True only with proof that the native turn, its children and build/verify processes exited. */
+    writersStopped: z.boolean(),
+    sessionId: z.string().min(1).max(128).optional(),
+    operationId: z.string().min(1).max(128).optional(),
+    headCommit: commitHash.optional(),
+    evidence: batchRunDeliveryEvidenceSchema.optional(),
+    error: z.string().max(128).optional(),
+    updatedAt: z.string().datetime(),
+}).strict();
+/* ---------------- Runs (Business → Runtime) ---------------- */
+export const batchRunMemberInputSchema = z.object({
+    resultVersionId: uuid,
+    workspaceId: uuid,
+    directoryName: workspaceDirectoryNameSchema,
+    remixId: uuid.nullable(),
+    branchName: z.string().trim().min(1).max(512),
+    prompt: z.string().min(1).max(20_000),
+    model: z.string().min(1).max(200).optional(),
+    /** Resume delivery from this exact member commit (retry / post-sync redeliver). */
+    resumeFromCommit: commitHash.optional(),
+    /** Prior result version this sync run replaces in the product sense (old version stays readable). */
+    syncOfResultVersionId: uuid.optional(),
+}).strict();
+/** `POST /internal/batch-runs` — idempotent per resultVersionId. */
+export const submitBatchRunsRequestSchema = z.object({
+    batchId: uuid,
+    userId: z.string().min(1).max(128),
+    snapshot: batchSourceSnapshotRefSchema,
+    members: z.array(batchRunMemberInputSchema).min(1).max(50),
+}).strict();
+export const batchRunViewSchema = batchRunSchema.extend({
+    queuePosition: z.number().int().min(0).optional(),
+});
+/** `POST /internal/batch-runs/:runId/sync` — replace input of a not-yet-started Run. */
+export const replaceBatchRunSnapshotSchema = z.object({ snapshot: batchSourceSnapshotRefSchema }).strict();
+/**
+ * Running, stopping, or reconciling members cannot switch snapshot mid-execution.
+ * The caller stores `pending_sync` and applies it after the Run ends.
+ */
+export const replaceBatchRunSnapshotResultSchema = z.discriminatedUnion('status', [
+    z.object({ status: z.literal('replaced'), run: batchRunViewSchema }).strict(),
+    z.object({ status: z.literal('pending_sync'), runId: uuid }).strict(),
+]);
+/** Batch-level source fact. Present when the event is not about a member Run. */
+export const batchSourceEventSubjectSchema = z.object({
+    batchId: uuid,
+    workspaceId: uuid,
+    status: z.enum(['ready', 'failed', 'lost']),
+    snapshot: batchSourceSnapshotRefSchema.optional(),
+    error: z.string().max(128).optional(),
+}).strict();
+export const batchRunEventReasonSchema = z.enum([
+    'status_changed', 'phase_changed', 'queue_changed', 'recovered', 'source_lost', 'source_ready', 'source_failed',
+]);
+/**
+ * Runtime → Business `POST /api/internal/cloud-batches/runs/events`; at-least-once, ordered by revision.
+ * A member event carries `run`. A source freeze event carries `source` and no run.
+ * `source_ready` / `source_failed` are additive reason values.
+ */
+export const batchRunEventSchema = z.union([
+    z.object({ run: batchRunViewSchema, reason: batchRunEventReasonSchema }).strict(),
+    z.object({
+        source: batchSourceEventSubjectSchema,
+        reason: z.enum(['source_ready', 'source_failed', 'source_lost']),
+    }).strict(),
+]);
+/* ---------------- Projection for the panel (Business → frontend) ---------------- */
+export const batchSourceStatusSchema = z.enum(['freezing', 'waiting_source_idle', 'ready', 'failed', 'lost']);
+export const batchMemberDisplayStatusSchema = z.enum([
+    'waiting_source', 'source_failed', 'queued', 'preparing', 'generating', 'delivering',
+    'reconciling', 'stopping', 'pending_sync', 'succeeded', 'failed', 'cancelled',
+]);
+export const batchMemberViewSchema = z.object({
+    resultVersionId: uuid,
+    ordinal: z.number().int().min(0),
+    prompt: z.string(),
+    status: batchMemberDisplayStatusSchema,
+    queuePosition: z.number().int().min(0).optional(),
+    directoryName: workspaceDirectoryNameSchema.optional(),
+    remixId: uuid.nullable().optional(),
+    sessionId: z.string().optional(),
+    runId: uuid.optional(),
+    previewRef: z.string().optional(),
+    previewStale: z.boolean().optional(),
+    error: z.string().max(128).optional(),
+}).strict();
+export const batchViewSchema = z.object({
+    batchId: uuid,
+    workspaceId: uuid,
+    sourceDirectoryName: workspaceDirectoryNameSchema,
+    sourceStatus: batchSourceStatusSchema,
+    cancelRequested: z.boolean(),
+    counts: z.object({
+        queued: z.number().int().min(0),
+        running: z.number().int().min(0),
+        succeeded: z.number().int().min(0),
+        failed: z.number().int().min(0),
+        cancelled: z.number().int().min(0),
+    }).strict(),
+    members: z.array(batchMemberViewSchema),
+    createdAt: z.string().datetime(),
+}).strict();
+export const batchCreateAcceptedSchema = z.object({
+    flowVersion: z.literal('v2'),
+    accepted: z.literal(true),
+    batchId: uuid,
+    sourceStatus: batchSourceStatusSchema,
+    view: batchViewSchema,
+}).strict();
+export function isBatchFlowV2Enabled(env = process.env) {
+    return env[BATCH_FLOW_V2_ENABLED_ENV] === 'true';
+}
+/** When v2 is enabled, pause new batch intake during cutover (design §11 step 2). */
+export const BATCH_FLOW_V2_INTAKE_PAUSED_ENV = 'CLOUD_BATCH_V2_INTAKE_PAUSED';
+export function isBatchFlowV2IntakePaused(env = process.env) {
+    return env[BATCH_FLOW_V2_INTAKE_PAUSED_ENV] === 'true';
+}
+export function batchMemberDisplayStatus(run, source, pendingSync = false) {
+    if (!run)
+        return source === 'failed' || source === 'lost' ? 'source_failed' : 'waiting_source';
+    if (pendingSync && run.status !== 'queued')
+        return 'pending_sync';
+    switch (run.status) {
+        case 'queued': return 'queued';
+        case 'running': return run.phase === 'prepare' ? 'preparing' : run.phase === 'generate' ? 'generating' : 'delivering';
+        case 'reconciling': return 'reconciling';
+        case 'stopping': return 'stopping';
+        default: return run.status;
+    }
+}
+/* ---------------- Queue view for chat (Runtime → frontend) ---------------- */
+/** `GET /runtime/workspaces/:workspaceId/execution-queue` — open occupancies of the caller's sandbox. */
+export const executionQueueEntrySchema = z.object({
+    occupancyId: uuid,
+    workspaceId: uuid,
+    directoryName: workspaceSessionScopeSchema,
+    source: z.enum(['session_turn', 'preview_build', 'batch_run']),
+    status: z.enum(['queued', 'active', 'waiting_user', 'reconciling']),
+    operationId: z.string().optional(),
+    runId: uuid.optional(),
+    queuePosition: z.number().int().min(0).optional(),
+}).strict();
+export const executionQueueViewSchema = z.object({
+    workspaceMax: z.number().int().min(1),
+    sandboxMax: z.number().int().min(1),
+    entries: z.array(executionQueueEntrySchema),
+}).strict();
+//# sourceMappingURL=batch-runs.js.map

package/dist/cloud-workspace/runtime/batch-runs.js.map

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

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

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+export declare const RUNTIME_CAPABILITY_NAMES: readonly ["conversation", "files", "git", "parameters", "terminal", "desktop", "artifacts.singleFile"];
+export type RuntimeCapabilityName = (typeof RUNTIME_CAPABILITY_NAMES)[number];
+export declare const runtimeCapabilityNameSchema: z.ZodEnum<{
+    files: "files";
+    terminal: "terminal";
+    conversation: "conversation";
+    git: "git";
+    parameters: "parameters";
+    desktop: "desktop";
+    "artifacts.singleFile": "artifacts.singleFile";
+}>;
+export declare const capabilityStateSchema: z.ZodObject<{
+    name: z.ZodEnum<{
+        files: "files";
+        terminal: "terminal";
+        conversation: "conversation";
+        git: "git";
+        parameters: "parameters";
+        desktop: "desktop";
+        "artifacts.singleFile": "artifacts.singleFile";
+    }>;
+    ready: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type CapabilityState = z.infer<typeof capabilityStateSchema>;
+export declare const CORE_RUNTIME_PHASES: readonly ["starting", "awaiting_native", "restoring", "ready", "quiescing", "unavailable"];
+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";
+}>;
+export declare function capability(name: RuntimeCapabilityName, ready: boolean, reason?: string): CapabilityState;
+export declare function listDeclaredCapabilities(states: readonly CapabilityState[]): RuntimeCapabilityName[];
+export declare function unavailableRuntimeCapabilities(reason: string): CapabilityState[];
+//# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB,wGAQ3B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,eAAO,MAAM,2BAA2B;;;;;;;;EAAmC,CAAC;AAE5E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;kBAsB9B,CAAC;AAEL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,mBAAmB,4FAOtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,sBAAsB;;;;;;;EAA8B,CAAC;AAElE,wBAAgB,UAAU,CAAC,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAExG;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,qBAAqB,EAAE,CAEpG;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAEhF"}

package/dist/cloud-workspace/runtime/capabilities.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+export const RUNTIME_CAPABILITY_NAMES = [
+    'conversation',
+    'files',
+    'git',
+    'parameters',
+    'terminal',
+    'desktop',
+    'artifacts.singleFile',
+];
+export const runtimeCapabilityNameSchema = z.enum(RUNTIME_CAPABILITY_NAMES);
+export const capabilityStateSchema = z
+    .object({
+    name: runtimeCapabilityNameSchema,
+    ready: z.boolean(),
+    reason: z.string().min(1).max(128).optional(),
+})
+    .strict()
+    .superRefine((value, context) => {
+    if (value.ready && value.reason) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'ready capability cannot include a reason',
+            path: ['reason'],
+        });
+    }
+    if (!value.ready && !value.reason) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'unavailable capability requires a machine-readable reason',
+            path: ['reason'],
+        });
+    }
+});
+export const CORE_RUNTIME_PHASES = [
+    'starting',
+    'awaiting_native',
+    'restoring',
+    'ready',
+    'quiescing',
+    'unavailable',
+];
+export const coreRuntimePhaseSchema = z.enum(CORE_RUNTIME_PHASES);
+export function capability(name, ready, reason) {
+    return capabilityStateSchema.parse(reason === undefined ? { name, ready } : { name, ready, reason });
+}
+export function listDeclaredCapabilities(states) {
+    return states.filter((state) => state.ready).map((state) => state.name);
+}
+export function unavailableRuntimeCapabilities(reason) {
+    return RUNTIME_CAPABILITY_NAMES.map((name) => capability(name, false, reason));
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/cloud-workspace/runtime/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,cAAc;IACd,OAAO;IACP,KAAK;IACL,YAAY;IACZ,UAAU;IACV,SAAS;IACT,sBAAsB;CACd,CAAC;AAIX,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,IAAI,EAAE,2BAA2B;IACjC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CAC9C,CAAC;KACD,MAAM,EAAE;KACR,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IAC9B,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAChC,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,0CAA0C;YACnD,IAAI,EAAE,CAAC,QAAQ,CAAC;SACjB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClC,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,2DAA2D;YACpE,IAAI,EAAE,CAAC,QAAQ,CAAC;SACjB,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAIL,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,UAAU;IACV,iBAAiB;IACjB,WAAW;IACX,OAAO;IACP,WAAW;IACX,aAAa;CACL,CAAC;AAIX,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AAElE,MAAM,UAAU,UAAU,CAAC,IAA2B,EAAE,KAAc,EAAE,MAAe;IACrF,OAAO,qBAAqB,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AACvG,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAkC;IACzE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAAc;IAC3D,OAAO,wBAAwB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AACjF,CAAC"}

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