@playcraft/common 0.1.36-beta1 → 0.1.37-beta

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

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

@@ -0,0 +1,197 @@
+import { z } from 'zod';
+export declare const CHAT_REALTIME_V2: "chatRealtimeV2";
+export type ChatRealtimeNegotiation = {
+    ok: true;
+    mode: typeof CHAT_REALTIME_V2;
+} | {
+    ok: false;
+    code: 'chat_realtime_unavailable';
+};
+/** Both sides must advertise the mode. Absence keeps history reads and refuses a new realtime turn. */
+export declare function negotiateChatRealtime(input: {
+    local: readonly string[];
+    remote: readonly string[];
+}): ChatRealtimeNegotiation;
+export declare const TURN_STATUSES: readonly ["starting", "running", "waiting_for_user", "completed", "failed", "interrupted"];
+export type TurnStatus = (typeof TURN_STATUSES)[number];
+export declare function canTransitionTurn(from: TurnStatus, to: TurnStatus): boolean;
+export declare const SAVE_STATUSES: readonly ["syncing", "delayed", "saved", "gap"];
+export type SaveStatus = (typeof SAVE_STATUSES)[number];
+export declare function canTransitionSave(from: SaveStatus, to: SaveStatus): boolean;
+export declare const replayPinEpochSchema: z.ZodObject<{
+    runtimeId: z.ZodString;
+    generation: z.ZodNumber;
+    runtimeEpoch: z.ZodNumber;
+    retainedFrom: z.ZodNumber;
+    highWater: z.ZodNumber;
+}, z.core.$strict>;
+export type ReplayPinEpoch = z.infer<typeof replayPinEpochSchema>;
+export declare const replayPinResultSchema: z.ZodObject<{
+    pinId: z.ZodString;
+    epochs: z.ZodArray<z.ZodObject<{
+        runtimeId: z.ZodString;
+        generation: z.ZodNumber;
+        runtimeEpoch: z.ZodNumber;
+        retainedFrom: z.ZodNumber;
+        highWater: z.ZodNumber;
+    }, z.core.$strict>>;
+    followBoundary: z.ZodObject<{
+        runtimeId: z.ZodString;
+        generation: z.ZodNumber;
+        runtimeEpoch: z.ZodNumber;
+        sourceSequence: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ReplayPinResult = z.infer<typeof replayPinResultSchema>;
+export declare const sourceAckEpochSchema: z.ZodObject<{
+    runtimeId: z.ZodString;
+    generation: z.ZodNumber;
+    runtimeEpoch: z.ZodNumber;
+    confirmedThrough: z.ZodNumber;
+}, z.core.$strict>;
+export declare const sourceAckSchema: z.ZodObject<{
+    leaseFence: z.ZodNumber;
+    epochs: z.ZodArray<z.ZodObject<{
+        runtimeId: z.ZodString;
+        generation: z.ZodNumber;
+        runtimeEpoch: z.ZodNumber;
+        confirmedThrough: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SourceAck = z.infer<typeof sourceAckSchema>;
+export declare function isMonotonicAck(previous: number, next: number): boolean;
+/** Retained lower bound past the cloud coverage means that prefix can no longer be read. */
+export declare function retainedRangeHasGap(retainedFrom: number, coveredThrough: number): boolean;
+export declare const liveChatFrameSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        runtimeId: z.ZodString;
+        generation: z.ZodNumber;
+        runtimeEpoch: z.ZodNumber;
+        sourceSequence: z.ZodNumber;
+    }, z.core.$strict>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    operationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodString;
+    payload: z.ZodUnknown;
+    occurredAt: z.ZodString;
+    payloadHash: z.ZodString;
+    kind: z.ZodLiteral<"live">;
+    persistence: z.ZodLiteral<"local">;
+}, z.core.$strict>;
+export type LiveChatFrame = z.infer<typeof liveChatFrameSchema>;
+export declare const durableChatFrameSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        runtimeId: z.ZodString;
+        generation: z.ZodNumber;
+        runtimeEpoch: z.ZodNumber;
+        sourceSequence: z.ZodNumber;
+    }, z.core.$strict>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    operationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodString;
+    payload: z.ZodUnknown;
+    occurredAt: z.ZodString;
+    payloadHash: z.ZodString;
+    kind: z.ZodLiteral<"durable">;
+    streamKind: z.ZodEnum<{
+        session: "session";
+        runtime: "runtime";
+        workspace: "workspace";
+    }>;
+    streamId: z.ZodString;
+    sequence: z.ZodNumber;
+}, z.core.$strict>;
+export type DurableChatFrame = z.infer<typeof durableChatFrameSchema>;
+export declare const chatControlFrameSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"control">;
+    event: z.ZodEnum<{
+        "source.ready": "source.ready";
+        "stream.ready": "stream.ready";
+        "stream.gap": "stream.gap";
+        "save.delayed": "save.delayed";
+    }>;
+}, z.core.$strict>;
+export type ChatControlFrame = z.infer<typeof chatControlFrameSchema>;
+export declare const browserChatFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    source: z.ZodObject<{
+        runtimeId: z.ZodString;
+        generation: z.ZodNumber;
+        runtimeEpoch: z.ZodNumber;
+        sourceSequence: z.ZodNumber;
+    }, z.core.$strict>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    operationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodString;
+    payload: z.ZodUnknown;
+    occurredAt: z.ZodString;
+    payloadHash: z.ZodString;
+    kind: z.ZodLiteral<"live">;
+    persistence: z.ZodLiteral<"local">;
+}, z.core.$strict>, z.ZodObject<{
+    source: z.ZodObject<{
+        runtimeId: z.ZodString;
+        generation: z.ZodNumber;
+        runtimeEpoch: z.ZodNumber;
+        sourceSequence: z.ZodNumber;
+    }, z.core.$strict>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    operationId: z.ZodOptional<z.ZodString>;
+    type: z.ZodString;
+    payload: z.ZodUnknown;
+    occurredAt: z.ZodString;
+    payloadHash: z.ZodString;
+    kind: z.ZodLiteral<"durable">;
+    streamKind: z.ZodEnum<{
+        session: "session";
+        runtime: "runtime";
+        workspace: "workspace";
+    }>;
+    streamId: z.ZodString;
+    sequence: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"control">;
+    event: z.ZodEnum<{
+        "source.ready": "source.ready";
+        "stream.ready": "stream.ready";
+        "stream.gap": "stream.gap";
+        "save.delayed": "save.delayed";
+    }>;
+}, z.core.$strict>], "kind">;
+export type BrowserChatFrame = z.infer<typeof browserChatFrameSchema>;
+/** Live and channel-status frames omit the SSE id. Durable uses the public sequence. */
+export declare function encodeSseFrame(frame: BrowserChatFrame): string;
+export type BrowserChatState = {
+    ready: boolean;
+    gap: boolean;
+    seenSourceEvents: string[];
+    durableCursor: number;
+    texts: string[];
+    saveStatus: SaveStatus;
+    turnStatus: TurnStatus;
+    durableSources: string[];
+};
+export declare function createBrowserChatState(): BrowserChatState;
+export declare function applyBrowserChatFrame(state: BrowserChatState, frame: BrowserChatFrame): BrowserChatState;
+export type ChatRealtimeFixture = {
+    readonly turnStatus: TurnStatus;
+    readonly frames: readonly BrowserChatFrame[];
+    emitText(text: string): LiveChatFrame;
+    requestApproval(approvalId: string): LiveChatFrame;
+    resumeAfterApproval(): void;
+    completeTurn(): LiveChatFrame;
+    delayArchive(): ChatControlFrame;
+    flushArchive(): DurableChatFrame[];
+};
+export declare function createChatRealtimeFixture(input: {
+    runtimeId?: string;
+    generation?: number;
+    runtimeEpoch?: number;
+    sessionId?: string;
+    operationId?: string;
+    now?: () => string;
+}): ChatRealtimeFixture;
+//# sourceMappingURL=chat-realtime.d.ts.map

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

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