@playcraft/common 0.1.36-beta1 → 0.1.37-beta

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

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

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

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

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

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+export declare const SESSION_RECOVERABILITY: readonly ["native", "history_only"];
+export type SessionRecoverability = (typeof SESSION_RECOVERABILITY)[number];
+export declare const sessionRecoverabilitySchema: z.ZodEnum<{
+    native: "native";
+    history_only: "history_only";
+}>;
+/**
+ * Titles are shown in a narrow session list, so the stored value is already the display value.
+ * An absent title means the session was never named; the browser labels those itself.
+ */
+export declare const SESSION_TITLE_MAX = 30;
+export declare const sessionTitleSchema: z.ZodString;
+/** Collapses a message into a title the list can show before a generated one arrives. */
+export declare function sessionTitleFromMessage(text: string | null | undefined): string;
+/**
+ * A session continued from one whose native context was lost sends the earlier conversation
+ * ahead of its first message, wrapped in these markers so the browser can fold it away.
+ */
+export declare const RECOVERED_CONTEXT_OPEN = "<playcraft-recovered-context>";
+export declare const RECOVERED_CONTEXT_CLOSE = "</playcraft-recovered-context>";
+/** Separates a leading recovered context from what the user actually typed. */
+export declare function splitRecoveredContext(text: string): {
+    context?: string;
+    text: string;
+};
+/** Stored operation records from earlier checkpoints still carry this field. */
+export declare const CHECKPOINT_KINDS: readonly ["coordinated", "file", "best_effort"];
+export type CheckpointKind = (typeof CHECKPOINT_KINDS)[number];
+export declare const checkpointKindSchema: z.ZodEnum<{
+    file: "file";
+    coordinated: "coordinated";
+    best_effort: "best_effort";
+}>;
+//# sourceMappingURL=checkpoints.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/checkpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB,qCAAsC,CAAC;AAC1E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5E,eAAO,MAAM,2BAA2B;;;EAAiC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,kBAAkB,aAAkD,CAAC;AAElF,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE/E;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AACtE,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAExE,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAQtF;AAED,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,iDAAkD,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/D,eAAO,MAAM,oBAAoB;;;;EAA2B,CAAC"}

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

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+export const SESSION_RECOVERABILITY = ['native', 'history_only'];
+export const sessionRecoverabilitySchema = z.enum(SESSION_RECOVERABILITY);
+/**
+ * Titles are shown in a narrow session list, so the stored value is already the display value.
+ * An absent title means the session was never named; the browser labels those itself.
+ */
+export const SESSION_TITLE_MAX = 30;
+export const sessionTitleSchema = z.string().trim().min(1).max(SESSION_TITLE_MAX);
+/** Collapses a message into a title the list can show before a generated one arrives. */
+export function sessionTitleFromMessage(text) {
+    return (text ?? '').replace(/\s+/g, ' ').trim().slice(0, SESSION_TITLE_MAX);
+}
+/**
+ * A session continued from one whose native context was lost sends the earlier conversation
+ * ahead of its first message, wrapped in these markers so the browser can fold it away.
+ */
+export const RECOVERED_CONTEXT_OPEN = '<playcraft-recovered-context>';
+export const RECOVERED_CONTEXT_CLOSE = '</playcraft-recovered-context>';
+/** Separates a leading recovered context from what the user actually typed. */
+export function splitRecoveredContext(text) {
+    if (!text.startsWith(RECOVERED_CONTEXT_OPEN))
+        return { text };
+    const end = text.indexOf(RECOVERED_CONTEXT_CLOSE);
+    if (end < 0)
+        return { text };
+    return {
+        context: text.slice(RECOVERED_CONTEXT_OPEN.length, end).trim(),
+        text: text.slice(end + RECOVERED_CONTEXT_CLOSE.length).replace(/^\s+/, ''),
+    };
+}
+/** Stored operation records from earlier checkpoints still carry this field. */
+export const CHECKPOINT_KINDS = ['coordinated', 'file', 'best_effort'];
+export const checkpointKindSchema = z.enum(CHECKPOINT_KINDS);
+//# sourceMappingURL=checkpoints.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/checkpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAU,CAAC;AAE1E,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;AAE1E;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAElF,yFAAyF;AACzF,MAAM,UAAU,uBAAuB,CAAC,IAA+B;IACrE,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,+BAA+B,CAAC;AACtE,MAAM,CAAC,MAAM,uBAAuB,GAAG,gCAAgC,CAAC;AAExE,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAClD,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE;QAC9D,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,CAAU,CAAC;AAEhF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/cloud-workspace/runtime/composer-context.d.ts

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+export declare const WORKSPACE_WORK_MODES: readonly ["execute", "plan"];
+export declare const workspaceWorkModeSchema: z.ZodEnum<{
+    execute: "execute";
+    plan: "plan";
+}>;
+export type WorkspaceWorkMode = z.infer<typeof workspaceWorkModeSchema>;
+export declare const workspaceContextFileSchema: z.ZodObject<{
+    directoryName: z.ZodString;
+    path: z.ZodString;
+    contentHash: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodObject<{
+        startLine: z.ZodNumber;
+        endLine: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkspaceContextFile = z.infer<typeof workspaceContextFileSchema>;
+export declare const workspaceContextSkillSchema: z.ZodObject<{
+    entryKey: z.ZodString;
+    lockHash: z.ZodString;
+}, z.core.$strict>;
+export type WorkspaceContextSkill = z.infer<typeof workspaceContextSkillSchema>;
+export declare const workspaceComposerContextSchema: z.ZodObject<{
+    files: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        directoryName: z.ZodString;
+        path: z.ZodString;
+        contentHash: z.ZodOptional<z.ZodString>;
+        range: z.ZodOptional<z.ZodObject<{
+            startLine: z.ZodNumber;
+            endLine: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+    skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        entryKey: z.ZodString;
+        lockHash: z.ZodString;
+    }, z.core.$strict>>>;
+    remixReferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        referenceId: z.ZodString;
+        directoryName: z.ZodString;
+        snapshotHash: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type WorkspaceComposerContext = z.infer<typeof workspaceComposerContextSchema>;
+/** Browser selections are references. Paths and skill bodies are resolved in the owning workspace. */
+export declare const workspaceComposerSelectionSchema: z.ZodObject<{
+    workMode: z.ZodOptional<z.ZodEnum<{
+        execute: "execute";
+        plan: "plan";
+    }>>;
+    context: z.ZodOptional<z.ZodObject<{
+        files: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            directoryName: z.ZodString;
+            path: z.ZodString;
+            contentHash: z.ZodOptional<z.ZodString>;
+            range: z.ZodOptional<z.ZodObject<{
+                startLine: z.ZodNumber;
+                endLine: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>>;
+        skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            entryKey: z.ZodString;
+            lockHash: z.ZodString;
+        }, z.core.$strict>>>;
+        remixReferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            referenceId: z.ZodString;
+            directoryName: z.ZodString;
+            snapshotHash: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkspaceComposerSelection = z.infer<typeof workspaceComposerSelectionSchema>;
+export declare const COMPOSER_CONTEXT_OPEN = "<playcraft-composer-context>";
+export declare const COMPOSER_CONTEXT_CLOSE = "</playcraft-composer-context>";
+/** Strip only the runtime-owned suffix, keeping the user's original text intact. */
+export declare function splitTurnContextText(text: string): {
+    text: string;
+    appendix?: string;
+};
+export declare function appendTurnContextText(text: string, appendix: string): string;
+//# sourceMappingURL=composer-context.d.ts.map

package/dist/cloud-workspace/runtime/composer-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-context.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/composer-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,oBAAoB,8BAA+B,CAAC;AACjE,eAAO,MAAM,uBAAuB;;;EAA+B,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B;;;;;;;;kBAQ5B,CAAC;AACZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,2BAA2B;;;kBAG7B,CAAC;AACZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;kBAazC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,sGAAsG;AACtG,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGlC,CAAC;AACZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AACpE,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AAEtE,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAItF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5E"}

package/dist/cloud-workspace/runtime/composer-context.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { workspaceRelativePathSchema } from './files.js';
+import { workspaceDirectoryNameSchema } from './workspace-directories.js';
+import { WORKSPACE_REMIX_REFERENCE_MAX_COUNT, workspaceContextRemixReferenceSchema } from './remix-references.js';
+export const WORKSPACE_WORK_MODES = ['execute', 'plan'];
+export const workspaceWorkModeSchema = z.enum(WORKSPACE_WORK_MODES);
+export const workspaceContextFileSchema = z.object({
+    directoryName: workspaceDirectoryNameSchema,
+    path: workspaceRelativePathSchema,
+    contentHash: z.string().regex(/^[a-f0-9]{64}$/).optional(),
+    range: z.object({
+        startLine: z.number().int().positive().max(1_000_000),
+        endLine: z.number().int().positive().max(1_000_000),
+    }).strict().refine(range => range.endLine >= range.startLine, 'invalid_context_range').optional(),
+}).strict();
+export const workspaceContextSkillSchema = z.object({
+    entryKey: z.string().min(1).max(128),
+    lockHash: z.string().regex(/^[a-f0-9]{64}$/),
+}).strict();
+export const workspaceComposerContextSchema = z.object({
+    files: z.array(workspaceContextFileSchema).max(12).default([]),
+    skills: z.array(workspaceContextSkillSchema).max(8).default([]),
+    remixReferences: z.array(workspaceContextRemixReferenceSchema).max(WORKSPACE_REMIX_REFERENCE_MAX_COUNT).optional(),
+}).strict().superRefine((value, ctx) => {
+    const fileKeys = value.files.map(file => `${file.directoryName}:${file.path}`);
+    if (new Set(fileKeys).size !== fileKeys.length)
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'duplicate_context_file', path: ['files'] });
+    if (new Set(value.skills.map(skill => skill.entryKey)).size !== value.skills.length)
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'duplicate_context_skill', path: ['skills'] });
+    const referenceIds = (value.remixReferences ?? []).map(reference => reference.referenceId);
+    if (new Set(referenceIds).size !== referenceIds.length)
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'duplicate_context_remix_reference', path: ['remixReferences'] });
+});
+/** Browser selections are references. Paths and skill bodies are resolved in the owning workspace. */
+export const workspaceComposerSelectionSchema = z.object({
+    workMode: workspaceWorkModeSchema.optional(),
+    context: workspaceComposerContextSchema.optional(),
+}).strict();
+export const COMPOSER_CONTEXT_OPEN = '<playcraft-composer-context>';
+export const COMPOSER_CONTEXT_CLOSE = '</playcraft-composer-context>';
+/** Strip only the runtime-owned suffix, keeping the user's original text intact. */
+export function splitTurnContextText(text) {
+    const start = text.lastIndexOf(`\n\n${COMPOSER_CONTEXT_OPEN}\n`);
+    if (start < 0 || !text.endsWith(`\n${COMPOSER_CONTEXT_CLOSE}`))
+        return { text };
+    return { text: text.slice(0, start), appendix: text.slice(start) };
+}
+export function appendTurnContextText(text, appendix) {
+    return appendix ? `${text}\n\n${COMPOSER_CONTEXT_OPEN}\n${appendix}\n${COMPOSER_CONTEXT_CLOSE}` : text;
+}
+//# sourceMappingURL=composer-context.js.map

package/dist/cloud-workspace/runtime/composer-context.js.map

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

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

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+/** HTTPS, or HTTP only when the host is loopback. No user info, query, or fragment. */
+export declare function assertPublicBaseUrl(value: string): string;
+export declare const sandboxListenSchema: z.ZodObject<{
+    host: z.ZodEnum<{
+        "127.0.0.1": "127.0.0.1";
+        "::1": "::1";
+    }>;
+    port: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const sandboxRuntimeConfigSchema: z.ZodObject<{
+    protocolMajor: z.ZodNumber;
+    protocolMinor: z.ZodNumber;
+    environment: z.ZodString;
+    runtimeId: z.ZodString;
+    userId: z.ZodString;
+    generation: z.ZodNumber;
+    runtimeEpoch: z.ZodNumber;
+    workspaceRoot: z.ZodString;
+    workspaceMode: z.ZodDefault<z.ZodEnum<{
+        single: "single";
+        multi: "multi";
+    }>>;
+    publicBaseUrl: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    checkpointObjects: z.ZodOptional<z.ZodBoolean>;
+    controlToken: z.ZodString;
+    cliVersion: z.ZodString;
+    codexVersion: z.ZodOptional<z.ZodString>;
+    imageDigest: z.ZodOptional<z.ZodString>;
+    stateDir: z.ZodString;
+    listen: z.ZodDefault<z.ZodObject<{
+        host: z.ZodEnum<{
+            "127.0.0.1": "127.0.0.1";
+            "::1": "::1";
+        }>;
+        port: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    gitGatewayOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    gitCredentialDirectory: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SandboxRuntimeConfig = z.infer<typeof sandboxRuntimeConfigSchema>;
+export declare function parseSandboxRuntimeConfig(input: unknown): SandboxRuntimeConfig;
+/**
+ * Replace only the public entrance a running sandbox uses. Derived routes follow that entrance. Identity, generation, epoch, and the control token stay as they are.
+ */
+export declare function applySandboxEndpointPatch(config: SandboxRuntimeConfig, patch: unknown): SandboxRuntimeConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBzD;AAaD,eAAO,MAAM,mBAAmB;;;;;;kBAKrB,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA4DnC,CAAC;AAEL,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAE9E;AAQD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,OAAO,GACb,oBAAoB,CAMtB"}