@playcraft/common 0.1.27 → 0.1.29

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

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

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

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

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

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

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

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

@@ -1,299 +0,0 @@
-import { z } from 'zod';
-import { eventStreamKindSchema, sourceEventIdSchema, sourceEventKey } from './events.js';
-import { hashOperationPayload } from './operations.js';
-export const CHAT_REALTIME_V2 = 'chatRealtimeV2';
-/** Both sides must advertise the mode. Absence keeps history reads and refuses a new realtime turn. */
-export function negotiateChatRealtime(input) {
-    if (input.local.includes(CHAT_REALTIME_V2) && input.remote.includes(CHAT_REALTIME_V2)) {
-        return { ok: true, mode: CHAT_REALTIME_V2 };
-    }
-    return { ok: false, code: 'chat_realtime_unavailable' };
-}
-export const TURN_STATUSES = [
-    'starting',
-    'running',
-    'waiting_for_user',
-    'completed',
-    'failed',
-    'interrupted',
-];
-const TURN_TRANSITIONS = {
-    starting: ['running', 'failed', 'interrupted'],
-    running: ['waiting_for_user', 'completed', 'failed', 'interrupted'],
-    waiting_for_user: ['running', 'failed', 'interrupted'],
-    completed: [],
-    failed: [],
-    interrupted: [],
-};
-export function canTransitionTurn(from, to) {
-    return TURN_TRANSITIONS[from].includes(to);
-}
-export const SAVE_STATUSES = ['syncing', 'delayed', 'saved', 'gap'];
-const SAVE_TRANSITIONS = {
-    syncing: ['delayed', 'saved', 'gap'],
-    delayed: ['syncing', 'saved', 'gap'],
-    saved: ['syncing', 'delayed', 'gap'],
-    gap: [],
-};
-export function canTransitionSave(from, to) {
-    return SAVE_TRANSITIONS[from].includes(to);
-}
-const sourceEpochSchema = z
-    .object({
-    runtimeId: z.string().min(1).max(128),
-    generation: z.number().int().nonnegative(),
-    runtimeEpoch: z.number().int().nonnegative(),
-})
-    .strict();
-export const replayPinEpochSchema = sourceEpochSchema
-    .safeExtend({
-    retainedFrom: z.number().int().positive(),
-    highWater: z.number().int().nonnegative(),
-})
-    .strict();
-export const replayPinResultSchema = z
-    .object({
-    pinId: z.string().min(1).max(128),
-    epochs: z.array(replayPinEpochSchema).min(1),
-    followBoundary: sourceEventIdSchema,
-})
-    .strict();
-export const sourceAckEpochSchema = sourceEpochSchema
-    .safeExtend({
-    confirmedThrough: z.number().int().nonnegative(),
-})
-    .strict();
-export const sourceAckSchema = z
-    .object({
-    leaseFence: z.number().int().nonnegative(),
-    epochs: z.array(sourceAckEpochSchema).min(1),
-})
-    .strict();
-export function isMonotonicAck(previous, next) {
-    return Number.isInteger(previous) && Number.isInteger(next) && next >= previous && previous >= 0;
-}
-/** Retained lower bound past the cloud coverage means that prefix can no longer be read. */
-export function retainedRangeHasGap(retainedFrom, coveredThrough) {
-    return retainedFrom > coveredThrough + 1;
-}
-const frameBodySchema = {
-    source: sourceEventIdSchema,
-    sessionId: z.string().min(1).max(128).optional(),
-    workspaceId: z.string().min(1).max(128).optional(),
-    operationId: z.string().min(1).max(128).optional(),
-    type: z.string().min(1).max(128),
-    payload: z.unknown(),
-    occurredAt: z.string().min(1),
-    payloadHash: z.string().length(64),
-};
-export const liveChatFrameSchema = z
-    .object({
-    kind: z.literal('live'),
-    persistence: z.literal('local'),
-    ...frameBodySchema,
-})
-    .strict();
-export const durableChatFrameSchema = z
-    .object({
-    kind: z.literal('durable'),
-    streamKind: eventStreamKindSchema,
-    streamId: z.string().min(1).max(128),
-    sequence: z.number().int().positive(),
-    ...frameBodySchema,
-})
-    .strict();
-export const chatControlFrameSchema = z
-    .object({
-    kind: z.literal('control'),
-    event: z.enum(['source.ready', 'stream.ready', 'stream.gap', 'save.delayed']),
-})
-    .strict();
-export const browserChatFrameSchema = z.discriminatedUnion('kind', [
-    liveChatFrameSchema,
-    durableChatFrameSchema,
-    chatControlFrameSchema,
-]);
-/** Live and channel-status frames omit the SSE id. Durable uses the public sequence. */
-export function encodeSseFrame(frame) {
-    const parsed = browserChatFrameSchema.parse(frame);
-    const data = JSON.stringify(parsed);
-    if (parsed.kind === 'durable') {
-        return `id: ${parsed.sequence}\nevent: durable\ndata: ${data}\n\n`;
-    }
-    if (parsed.kind === 'live') {
-        return `event: live\ndata: ${data}\n\n`;
-    }
-    return `event: ${parsed.event}\ndata: ${data}\n\n`;
-}
-export function createBrowserChatState() {
-    return {
-        ready: false,
-        gap: false,
-        seenSourceEvents: [],
-        durableCursor: 0,
-        texts: [],
-        saveStatus: 'syncing',
-        turnStatus: 'starting',
-        durableSources: [],
-    };
-}
-function textOf(payload) {
-    if (!payload || typeof payload !== 'object' || !('text' in payload))
-        return undefined;
-    const text = payload.text;
-    return typeof text === 'string' ? text : undefined;
-}
-function nextTurn(current, type) {
-    if (type === 'approval.requested' && canTransitionTurn(current, 'waiting_for_user'))
-        return 'waiting_for_user';
-    if (type === 'message.delta' && canTransitionTurn(current, 'running'))
-        return 'running';
-    if (type === 'turn.completed' && canTransitionTurn(current, 'completed'))
-        return 'completed';
-    if (type === 'turn.failed' && canTransitionTurn(current, 'failed'))
-        return 'failed';
-    if (type === 'turn.interrupted' && canTransitionTurn(current, 'interrupted'))
-        return 'interrupted';
-    return current;
-}
-function nextSave(current, to) {
-    return canTransitionSave(current, to) ? to : current;
-}
-export function applyBrowserChatFrame(state, frame) {
-    const parsed = browserChatFrameSchema.parse(frame);
-    if (parsed.kind === 'control') {
-        if (parsed.event === 'source.ready')
-            return state;
-        if (parsed.event === 'stream.gap')
-            return { ...state, gap: true, ready: false, saveStatus: nextSave(state.saveStatus, 'gap') };
-        if (parsed.event === 'save.delayed')
-            return { ...state, saveStatus: nextSave(state.saveStatus, 'delayed') };
-        if (state.gap)
-            return state;
-        return { ...state, ready: true };
-    }
-    if (parsed.kind === 'durable' && parsed.sequence <= state.durableCursor)
-        return state;
-    if (parsed.kind === 'durable' && parsed.sequence !== state.durableCursor + 1) {
-        return {
-            ...state,
-            gap: true,
-            ready: false,
-            saveStatus: nextSave(state.saveStatus, 'gap'),
-        };
-    }
-    const key = sourceEventKey(parsed.source);
-    const seen = state.seenSourceEvents.includes(key);
-    const texts = !seen && parsed.type === 'message.delta' ? [...state.texts, textOf(parsed.payload) ?? ''] : state.texts;
-    const seenSourceEvents = seen ? state.seenSourceEvents : [...state.seenSourceEvents, key];
-    const turnStatus = seen ? state.turnStatus : nextTurn(state.turnStatus, parsed.type);
-    if (parsed.kind === 'live') {
-        const keep = state.saveStatus === 'gap' || state.saveStatus === 'delayed' || state.durableSources.includes(key);
-        const saveStatus = keep ? state.saveStatus : nextSave(state.saveStatus, 'syncing');
-        return { ...state, texts, seenSourceEvents, turnStatus, saveStatus };
-    }
-    const durableSources = state.durableSources.includes(key) ? state.durableSources : [...state.durableSources, key];
-    const archiveCaughtUp = seenSourceEvents.every((item) => durableSources.includes(item));
-    const saveTarget = archiveCaughtUp ? 'saved' : state.saveStatus === 'delayed' ? 'delayed' : 'syncing';
-    return {
-        ...state,
-        texts,
-        seenSourceEvents,
-        turnStatus,
-        durableSources,
-        durableCursor: parsed.sequence,
-        saveStatus: state.saveStatus === 'gap' ? 'gap' : nextSave(state.saveStatus, saveTarget),
-    };
-}
-export function createChatRealtimeFixture(input) {
-    const runtimeId = input.runtimeId ?? 'rt_1';
-    const generation = input.generation ?? 1;
-    const runtimeEpoch = input.runtimeEpoch ?? 1;
-    const sessionId = input.sessionId ?? 'session_1';
-    const operationId = input.operationId ?? 'op_1';
-    const now = input.now ?? (() => '2026-09-24T00:00:00.000Z');
-    const frames = [];
-    const pending = [];
-    let sequence = 0;
-    let turnStatus = 'starting';
-    let publicSequence = 0;
-    function source() {
-        sequence += 1;
-        return { runtimeId, generation, runtimeEpoch, sourceSequence: sequence };
-    }
-    function pushLive(type, payload) {
-        const frame = liveChatFrameSchema.parse({
-            kind: 'live',
-            persistence: 'local',
-            source: source(),
-            sessionId,
-            operationId,
-            type,
-            payload,
-            occurredAt: now(),
-            payloadHash: hashOperationPayload(payload),
-        });
-        frames.push(frame);
-        pending.push(frame);
-        return frame;
-    }
-    return {
-        get turnStatus() {
-            return turnStatus;
-        },
-        get frames() {
-            return frames;
-        },
-        emitText(text) {
-            if (turnStatus !== 'starting' && turnStatus !== 'running') {
-                throw new Error(`turn_not_generating:${turnStatus}`);
-            }
-            turnStatus = 'running';
-            return pushLive('message.delta', { text });
-        },
-        requestApproval(approvalId) {
-            if (turnStatus !== 'running')
-                throw new Error(`approval_requires_running:${turnStatus}`);
-            turnStatus = 'waiting_for_user';
-            return pushLive('approval.requested', { approvalId });
-        },
-        resumeAfterApproval() {
-            if (turnStatus !== 'waiting_for_user')
-                throw new Error(`approval_not_waiting:${turnStatus}`);
-            turnStatus = 'running';
-        },
-        completeTurn() {
-            if (turnStatus !== 'running')
-                throw new Error(`turn_not_running:${turnStatus}`);
-            turnStatus = 'completed';
-            return pushLive('turn.completed', {});
-        },
-        delayArchive() {
-            const frame = chatControlFrameSchema.parse({ kind: 'control', event: 'save.delayed' });
-            frames.push(frame);
-            return frame;
-        },
-        flushArchive() {
-            const archived = pending.splice(0).map((live) => {
-                publicSequence += 1;
-                const durable = durableChatFrameSchema.parse({
-                    kind: 'durable',
-                    streamKind: 'session',
-                    streamId: sessionId,
-                    sequence: publicSequence,
-                    source: live.source,
-                    sessionId: live.sessionId,
-                    operationId: live.operationId,
-                    type: live.type,
-                    payload: live.payload,
-                    occurredAt: live.occurredAt,
-                    payloadHash: live.payloadHash,
-                });
-                frames.push(durable);
-                return durable;
-            });
-            return archived;
-        },
-    };
-}
-//# sourceMappingURL=chat-realtime.js.map