@playcraft/common 0.1.35-prod → 0.1.37-beta

package/dist/cloud-workspace/runtime/terminal-session.js

@@ -0,0 +1,178 @@
+import { z } from 'zod';
+/** Retained PTY bytes. Older bytes are dropped; a reconnect must not invent them as new output. */
+export const TERMINAL_OUTPUT_RETAINED_BYTES = 256 * 1024;
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+export function encodeTerminalBytes(bytes) {
+    let binary = '';
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary);
+}
+export function decodeTerminalBytes(value) {
+    const binary = atob(value);
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index += 1)
+        bytes[index] = binary.charCodeAt(index) & 0xff;
+    return bytes;
+}
+export const terminalClientFrameSchema = z.discriminatedUnion('type', [
+    z
+        .object({
+        type: z.literal('resume'),
+        streamId: z.string().trim().min(1).max(64).optional(),
+        offset: z.number().int().nonnegative(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('input'),
+        data: z.string().min(1).max(16_384),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('resize'),
+        cols: z.number().int().min(1).max(500),
+        rows: z.number().int().min(1).max(200),
+    })
+        .strict(),
+]);
+export const TERMINAL_REVOKE_REASONS = [
+    'terminal_destroyed',
+    'runtime_destroyed',
+    'grant_revoked',
+    'pty_unavailable',
+];
+export const terminalServerFrameSchema = z.discriminatedUnion('type', [
+    z
+        .object({
+        type: z.literal('output'),
+        streamId: z.string().min(1).max(64),
+        offset: z.number().int().nonnegative(),
+        data: z.string().min(1),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('gap'),
+        streamId: z.string().min(1).max(64),
+        offset: z.number().int().nonnegative(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('reset'),
+        streamId: z.string().min(1).max(64),
+        offset: z.number().int().nonnegative(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('exit'),
+        streamId: z.string().min(1).max(64),
+        code: z.number().int().nullable(),
+        signal: z.string().min(1).max(32).optional(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('revoked'),
+        reason: z.enum(TERMINAL_REVOKE_REASONS),
+    })
+        .strict(),
+]);
+export function createTerminalOutputLog() {
+    return { start: 0, end: 0, chunks: [] };
+}
+export function appendTerminalOutput(log, text, retain = TERMINAL_OUTPUT_RETAINED_BYTES) {
+    const bytes = encoder.encode(text);
+    if (bytes.length === 0)
+        return log;
+    return trimTerminalOutput({
+        start: log.start,
+        end: log.end + bytes.length,
+        chunks: [...log.chunks, { offset: log.end, data: encodeTerminalBytes(bytes) }],
+    }, retain);
+}
+export function terminalOutputSince(log, offset) {
+    if (offset < log.start) {
+        return { gap: true, offset: log.start, frames: [...log.chunks] };
+    }
+    if (offset >= log.end)
+        return { gap: false, offset: log.end, frames: [] };
+    const frames = [];
+    for (const chunk of log.chunks) {
+        const bytes = decodeTerminalBytes(chunk.data);
+        const end = chunk.offset + bytes.length;
+        if (end <= offset)
+            continue;
+        if (chunk.offset >= offset)
+            frames.push(chunk);
+        else {
+            frames.push({
+                offset,
+                data: encodeTerminalBytes(bytes.slice(offset - chunk.offset)),
+            });
+        }
+    }
+    return { gap: false, offset, frames };
+}
+function trimTerminalOutput(log, retain) {
+    let { start, end, chunks } = log;
+    while (end - start > retain && chunks.length > 1) {
+        const first = chunks[0];
+        const size = decodeTerminalBytes(first.data).length;
+        chunks = chunks.slice(1);
+        start = first.offset + size;
+    }
+    if (end - start > retain && chunks.length === 1) {
+        const only = chunks[0];
+        const bytes = decodeTerminalBytes(only.data);
+        const keep = bytes.slice(bytes.length - retain);
+        start = end - keep.length;
+        chunks = [{ offset: start, data: encodeTerminalBytes(keep) }];
+    }
+    return { start, end, chunks };
+}
+export function createTerminalView() {
+    return { text: '', offset: 0, gap: false };
+}
+/** Apply one server frame. Bytes at an offset already applied are ignored, not appended again. */
+export function reduceTerminalFrame(view, frame) {
+    if (frame.type === 'reset') {
+        return { text: '', offset: frame.offset, gap: false, streamId: frame.streamId };
+    }
+    if (frame.type === 'revoked')
+        return { ...view, revoked: frame.reason };
+    if (view.streamId && 'streamId' in frame && frame.streamId !== view.streamId)
+        return view;
+    if (frame.type === 'gap') {
+        if (frame.offset < view.offset)
+            return view;
+        return { ...view, streamId: frame.streamId, gap: true, offset: frame.offset };
+    }
+    if (frame.type === 'exit') {
+        return {
+            ...view,
+            streamId: frame.streamId,
+            exitCode: frame.code,
+            ...(frame.signal ? { exitSignal: frame.signal } : {}),
+        };
+    }
+    const bytes = decodeTerminalBytes(frame.data);
+    const end = frame.offset + bytes.length;
+    if (end <= view.offset)
+        return { ...view, streamId: view.streamId ?? frame.streamId };
+    if (frame.offset > view.offset) {
+        return { ...view, streamId: frame.streamId, gap: true };
+    }
+    const slice = frame.offset < view.offset ? bytes.slice(view.offset - frame.offset) : bytes;
+    return {
+        ...view,
+        streamId: frame.streamId,
+        offset: end,
+        text: view.text + decoder.decode(slice),
+    };
+}
+//# sourceMappingURL=terminal-session.js.map

package/dist/cloud-workspace/runtime/terminal-session.js.map

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

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

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+export declare const TERMINAL_STATUSES: readonly ["active", "destroyed"];
+export type TerminalStatus = (typeof TERMINAL_STATUSES)[number];
+export declare const terminalIdSchema: z.ZodString;
+export declare const terminalCreatePayloadSchema: z.ZodObject<{
+    terminalId: z.ZodOptional<z.ZodString>;
+    directoryName: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"root">]>>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type TerminalCreatePayload = z.infer<typeof terminalCreatePayloadSchema>;
+export declare const terminalRecordSchema: z.ZodObject<{
+    terminalId: z.ZodString;
+    workspaceId: z.ZodString;
+    directoryName: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"root">]>>;
+    environment: z.ZodString;
+    userId: z.ZodString;
+    runtimeId: z.ZodOptional<z.ZodString>;
+    generation: z.ZodOptional<z.ZodNumber>;
+    runtimeEpoch: z.ZodOptional<z.ZodNumber>;
+    processIdentity: z.ZodString;
+    cwd: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        destroyed: "destroyed";
+    }>;
+    createdAt: z.ZodString;
+    destroyedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type TerminalRecord = z.infer<typeof terminalRecordSchema>;
+export declare function terminalProcessIdentity(workspaceId: string, terminalId: string, cwd?: string): string;
+export declare function parseTerminalProcessIdentity(value: string): {
+    workspaceId?: string;
+    terminalId?: string;
+    cwd: string;
+};
+/** Client-chosen connection endpoints. Identity drafts persist leases without a display. */
+export declare const UNTRUSTED_DISPLAY_FIELDS: readonly ["displayUrl", "vncUrl", "websocketUrl", "host", "url", "novnc"];
+export type UntrustedDisplayField = (typeof UNTRUSTED_DISPLAY_FIELDS)[number];
+export declare const desktopAccessPayloadSchema: z.ZodObject<{}, z.core.$strict>;
+export type DesktopAccessPayload = z.infer<typeof desktopAccessPayloadSchema>;
+export declare const DESKTOP_DISPLAYS: readonly ["not_started", "ready"];
+export type DesktopDisplay = (typeof DESKTOP_DISPLAYS)[number];
+export declare const DESKTOP_HOLDERS: readonly ["none", "human"];
+export type DesktopHolder = (typeof DESKTOP_HOLDERS)[number];
+export declare const desktopLeaseRecordSchema: z.ZodObject<{
+    leaseId: z.ZodString;
+    environment: z.ZodString;
+    userId: z.ZodString;
+    takeoverRevision: z.ZodNumber;
+    status: z.ZodEnum<{
+        active: "active";
+        released: "released";
+    }>;
+    display: z.ZodEnum<{
+        ready: "ready";
+        not_started: "not_started";
+    }>;
+    expiresAt: z.ZodOptional<z.ZodString>;
+    streamGeneration: z.ZodOptional<z.ZodNumber>;
+    holder: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        human: "human";
+    }>>;
+    resourcePath: z.ZodOptional<z.ZodString>;
+    connectPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DesktopLeaseRecord = z.infer<typeof desktopLeaseRecordSchema>;
+export declare const desktopHealthSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        ready: "ready";
+        display_not_started: "display_not_started";
+        display_unavailable: "display_unavailable";
+    }>;
+    streamGeneration: z.ZodNumber;
+    holder: z.ZodEnum<{
+        none: "none";
+        human: "human";
+    }>;
+    agentInput: z.ZodEnum<{
+        open: "open";
+        revoked: "revoked";
+    }>;
+    holdExpiresAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DesktopHealth = z.infer<typeof desktopHealthSchema>;
+/** Identity that can be stored. Live paths and the current picture generation are omitted. */
+export declare function restingDesktopLease(value: unknown): DesktopLeaseRecord;
+/** Relative noVNC asset name. Rejects traversal and absolute URLs. */
+export declare function desktopResourceName(value: string): string | undefined;
+//# sourceMappingURL=terminals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminals.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/terminals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,iBAAiB,kCAAmC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB,aAAoC,CAAC;AAElE,eAAO,MAAM,2BAA2B;;;;kBAM7B,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;kBAgBtB,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,MAAM,CAEjG;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb,CAUA;AAED,4FAA4F;AAC5F,eAAO,MAAM,wBAAwB,2EAO3B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,eAAO,MAAM,0BAA0B,iCAAwB,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,gBAAgB,mCAAoC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,eAAO,MAAM,eAAe,4BAA6B,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAU7D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;kBAc1B,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;kBAQrB,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAWtE;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMrE"}

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

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+import { workspaceRelativePathSchema } from './files.js';
+import { workspaceSessionScopeSchema } from './workspace-directories.js';
+export const TERMINAL_STATUSES = ['active', 'destroyed'];
+export const terminalIdSchema = z.string().trim().min(1).max(128);
+export const terminalCreatePayloadSchema = z
+    .object({
+    terminalId: terminalIdSchema.optional(),
+    directoryName: workspaceSessionScopeSchema.optional(),
+    cwd: workspaceRelativePathSchema.optional(),
+})
+    .strict();
+export const terminalRecordSchema = z
+    .object({
+    terminalId: terminalIdSchema,
+    workspaceId: z.string().min(1).max(128),
+    directoryName: workspaceSessionScopeSchema.optional(),
+    environment: z.string().min(1).max(64),
+    userId: z.string().min(1).max(128),
+    runtimeId: z.string().min(1).max(128).optional(),
+    generation: z.number().int().nonnegative().optional(),
+    runtimeEpoch: z.number().int().nonnegative().optional(),
+    processIdentity: z.string().min(1).max(512),
+    cwd: z.string().max(512),
+    status: z.enum(TERMINAL_STATUSES),
+    createdAt: z.string().min(1),
+    destroyedAt: z.string().min(1).optional(),
+})
+    .strict();
+export function terminalProcessIdentity(workspaceId, terminalId, cwd = '') {
+    return cwd ? `term:${workspaceId}:${terminalId}|${cwd}` : `term:${workspaceId}:${terminalId}`;
+}
+export function parseTerminalProcessIdentity(value) {
+    const separator = value.indexOf('|');
+    const head = separator === -1 ? value : value.slice(0, separator);
+    const cwd = separator === -1 ? '' : value.slice(separator + 1);
+    const match = /^term:([^:]+):(.+)$/.exec(head);
+    return {
+        workspaceId: match?.[1],
+        terminalId: match?.[2],
+        cwd,
+    };
+}
+/** Client-chosen connection endpoints. Identity drafts persist leases without a display. */
+export const UNTRUSTED_DISPLAY_FIELDS = [
+    'displayUrl',
+    'vncUrl',
+    'websocketUrl',
+    'host',
+    'url',
+    'novnc',
+];
+export const desktopAccessPayloadSchema = z.object({}).strict();
+export const DESKTOP_DISPLAYS = ['not_started', 'ready'];
+export const DESKTOP_HOLDERS = ['none', 'human'];
+/** Server-assigned relative path. A client cannot choose a host or scheme. */
+const desktopRelativePathSchema = z
+    .string()
+    .min(1)
+    .max(240)
+    .regex(/^[A-Za-z0-9][A-Za-z0-9._/-]*$/)
+    .refine((value) => !value.includes('://') && !value.split('/').includes('..'));
+export const desktopLeaseRecordSchema = z
+    .object({
+    leaseId: z.string().min(1).max(128),
+    environment: z.string().min(1).max(64),
+    userId: z.string().min(1).max(128),
+    takeoverRevision: z.number().int().nonnegative(),
+    status: z.enum(['active', 'released']),
+    display: z.enum(DESKTOP_DISPLAYS),
+    expiresAt: z.string().min(1).optional(),
+    streamGeneration: z.number().int().nonnegative().optional(),
+    holder: z.enum(DESKTOP_HOLDERS).optional(),
+    resourcePath: desktopRelativePathSchema.optional(),
+    connectPath: desktopRelativePathSchema.optional(),
+})
+    .strict();
+export const desktopHealthSchema = z
+    .object({
+    status: z.enum(['ready', 'display_not_started', 'display_unavailable']),
+    streamGeneration: z.number().int().nonnegative(),
+    holder: z.enum(DESKTOP_HOLDERS),
+    agentInput: z.enum(['open', 'revoked']),
+    holdExpiresAt: z.string().datetime().optional(),
+})
+    .strict();
+/** Identity that can be stored. Live paths and the current picture generation are omitted. */
+export function restingDesktopLease(value) {
+    const parsed = desktopLeaseRecordSchema.parse(value);
+    return desktopLeaseRecordSchema.parse({
+        leaseId: parsed.leaseId,
+        environment: parsed.environment,
+        userId: parsed.userId,
+        takeoverRevision: parsed.takeoverRevision,
+        status: parsed.status,
+        display: 'not_started',
+        ...(parsed.expiresAt ? { expiresAt: parsed.expiresAt } : {}),
+    });
+}
+/** Relative noVNC asset name. Rejects traversal and absolute URLs. */
+export function desktopResourceName(value) {
+    const name = value.replace(/^\/+/, '');
+    if (!name || name.length > 240)
+        return undefined;
+    if (!/^[A-Za-z0-9][A-Za-z0-9._/-]*$/.test(name))
+        return undefined;
+    if (name.split('/').some((part) => part === '' || part === '.' || part === '..'))
+        return undefined;
+    return name;
+}
+//# sourceMappingURL=terminals.js.map

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

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

package/dist/cloud-workspace/runtime/turn-control.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+export declare const workspaceReviewTargetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"uncommittedChanges">;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"baseBranch">;
+    branch: z.ZodString;
+}, z.core.$strict>], "type">;
+export type WorkspaceReviewTarget = z.infer<typeof workspaceReviewTargetSchema>;
+export declare const workspaceReviewPayloadSchema: z.ZodObject<{
+    target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"uncommittedChanges">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"baseBranch">;
+        branch: z.ZodString;
+    }, z.core.$strict>], "type">;
+}, z.core.$strict>;
+export type WorkspaceReviewPayload = z.infer<typeof workspaceReviewPayloadSchema>;
+/** Steering appends text to one active turn; it cannot change that turn's execution settings. */
+export declare const workspaceSteerPayloadSchema: z.ZodObject<{
+    text: z.ZodString;
+    expectedTurnId: z.ZodString;
+}, z.core.$strict>;
+export type WorkspaceSteerPayload = z.infer<typeof workspaceSteerPayloadSchema>;
+/** Compaction operates on the bound conversation without accepting execution or thread overrides. */
+export declare const workspaceCompactPayloadSchema: z.ZodObject<{}, z.core.$strict>;
+export type WorkspaceCompactPayload = z.infer<typeof workspaceCompactPayloadSchema>;
+//# sourceMappingURL=turn-control.d.ts.map

package/dist/cloud-workspace/runtime/turn-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-control.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/turn-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,2BAA2B;;;;;4BAGtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,4BAA4B;;;;;;;kBAA6D,CAAC;AACvG,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,iGAAiG;AACjG,eAAO,MAAM,2BAA2B;;;kBAG7B,CAAC;AACZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,qGAAqG;AACrG,eAAO,MAAM,6BAA6B,iCAAwB,CAAC;AACnE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/cloud-workspace/runtime/turn-control.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+const branchSchema = z.string().trim().min(1).max(256).refine(branch => !branch.startsWith('-') && !branch.startsWith('/') && !branch.endsWith('/') && !branch.endsWith('.')
+    && !branch.includes('..') && !branch.includes('@{') && !branch.includes('//')
+    && !/[\s\u0000-\u001f\u007f~^:?*\[\\]/.test(branch)
+    && branch.split('/').every(part => part !== '.' && !part.startsWith('.') && !part.endsWith('.lock')), 'invalid_review_branch');
+export const workspaceReviewTargetSchema = z.discriminatedUnion('type', [
+    z.object({ type: z.literal('uncommittedChanges') }).strict(),
+    z.object({ type: z.literal('baseBranch'), branch: branchSchema }).strict(),
+]);
+export const workspaceReviewPayloadSchema = z.object({ target: workspaceReviewTargetSchema }).strict();
+/** Steering appends text to one active turn; it cannot change that turn's execution settings. */
+export const workspaceSteerPayloadSchema = z.object({
+    text: z.string().min(1).max(64_000).refine(text => text.trim().length > 0, 'empty_steer_text'),
+    expectedTurnId: z.string().min(1).max(128),
+}).strict();
+/** Compaction operates on the bound conversation without accepting execution or thread overrides. */
+export const workspaceCompactPayloadSchema = z.object({}).strict();
+//# sourceMappingURL=turn-control.js.map

package/dist/cloud-workspace/runtime/turn-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-control.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/turn-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CACrE,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;OACjG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;OAC1E,CAAC,kCAAkC,CAAC,IAAI,CAAC,MAAM,CAAC;OAChD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EACpG,uBAAuB,CAAC,CAAC;AAE3B,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACtE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5D,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;CAC3E,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAGvG,iGAAiG;AACjG,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,kBAAkB,CAAC;IAC9F,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CAC3C,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,qGAAqG;AACrG,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC"}