@playcraft/common 0.1.29 → 0.1.31

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

@@ -0,0 +1,213 @@
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+import { workspacePermissionModeSchema } from './permissions.js';
+import { checkpointKindSchema } from './checkpoints.js';
+import { workspaceSessionScopeSchema } from './workspace-directories.js';
+import { workspaceWorkModeSchema, workspaceComposerContextSchema } from './composer-context.js';
+import { workspaceReviewTargetSchema } from './turn-control.js';
+export const reasoningEffortSchema = z.enum(['low', 'medium', 'high', 'max']);
+export const OPERATION_KINDS = [
+    'runtime.ensure',
+    'runtime.destroy',
+    'session.create',
+    'session.turn',
+    'session.review',
+    'session.compact',
+    'session.steer',
+    'session.interrupt',
+    'session.approval.respond',
+    'file.write',
+    'git.commit',
+    'git.push',
+    'git.stage',
+    'git.unstage',
+    'git.discard',
+    'workspace.save',
+    'terminal.create',
+    'parameter.patch',
+    'skills.update',
+    'preview.publish',
+    'checkpoint.create',
+    'checkpoint.restore',
+];
+export const operationKindSchema = z.enum(OPERATION_KINDS);
+/** Kinds that steer a running turn; they touch neither workspace content nor the runtime itself. */
+export const TURN_CONTROL_OPERATION_KINDS = [
+    'session.interrupt',
+    'session.approval.respond',
+    'session.steer',
+];
+/** Kinds that steer the runtime or a running turn without changing workspace content. */
+export const CONTROL_OPERATION_KINDS = [
+    'runtime.ensure',
+    'runtime.destroy',
+    'session.compact',
+    ...TURN_CONTROL_OPERATION_KINDS,
+];
+export function isTurnControl(kind) {
+    return TURN_CONTROL_OPERATION_KINDS.includes(kind);
+}
+export function isWorkspaceMutation(kind) {
+    return !CONTROL_OPERATION_KINDS.includes(kind);
+}
+export const OPERATION_STATUSES = [
+    'queued',
+    'dispatched',
+    'accepted',
+    'completed',
+    'failed',
+    'interrupted',
+    'uncertain',
+];
+export const operationStatusSchema = z.enum(OPERATION_STATUSES);
+export const TERMINAL_OPERATION_STATUSES = ['completed', 'failed', 'interrupted'];
+const OPERATION_TRANSITIONS = {
+    queued: ['dispatched', 'failed', 'interrupted', 'uncertain'],
+    dispatched: ['accepted', 'failed', 'interrupted', 'uncertain'],
+    accepted: ['completed', 'failed', 'interrupted', 'uncertain'],
+    completed: [],
+    failed: [],
+    interrupted: [],
+    // accepted is only for unique native evidence via recoverUncertainOperation.
+    // A probe that merely finds an activity must not complete the operation.
+    uncertain: ['accepted', 'completed', 'failed', 'interrupted', 'uncertain'],
+};
+export function canTransitionOperation(from, to) {
+    return OPERATION_TRANSITIONS[from].includes(to);
+}
+export function assertOperationTransition(from, to) {
+    if (!canTransitionOperation(from, to)) {
+        throw new Error(`illegal_operation_transition:${from}:${to}`);
+    }
+}
+export const operationAcceptRequestSchema = z
+    .object({
+    clientRequestId: z.string().trim().min(1).max(128),
+    kind: operationKindSchema,
+    workspaceId: z.string().trim().min(1).max(128).optional(),
+    directoryName: workspaceSessionScopeSchema.optional(),
+    sessionId: z.string().trim().min(1).max(128).optional(),
+    expectedRevision: z.number().int().nonnegative().optional(),
+    payload: z.unknown(),
+    /**
+     * Sent with a turn on a session whose native thread was lost, letting the sandbox resume or
+     * replace that thread. Kept outside the payload: the session's history keeps growing, and a
+     * retry must still hash as the same request.
+     */
+    sessionRecovery: z
+        .object({
+        context: z.string().max(64_000),
+        modelConfigId: z.string().uuid().optional(),
+        reasoningEffort: reasoningEffortSchema.optional(),
+        permissionMode: workspacePermissionModeSchema.optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+/**
+ * Why a turn failed because its session has no usable Codex thread. Each is decided before the
+ * message reaches Codex, so the same turn may be sent again with a `sessionRecovery`.
+ */
+export const LOST_THREAD_ERRORS = ['native_not_recoverable', 'unknown_session', 'unknown_thread'];
+export function isLostThreadError(error) {
+    return LOST_THREAD_ERRORS.includes(error);
+}
+export const operationRecordSchema = z
+    .object({
+    operationId: z.string().min(1).max(128),
+    environment: z.string().min(1).max(64),
+    userId: z.string().min(1).max(128),
+    clientRequestId: z.string().min(1).max(128),
+    kind: operationKindSchema,
+    status: operationStatusSchema,
+    payloadHash: z.string().length(64),
+    workspaceId: z.string().min(1).max(128).optional(),
+    directoryName: workspaceSessionScopeSchema.optional(),
+    sessionId: z.string().min(1).max(128).optional(),
+    expectedRevision: z.number().int().nonnegative().optional(),
+    generation: z.number().int().nonnegative().optional(),
+    runtimeEpoch: z.number().int().nonnegative().optional(),
+    leaseFence: z.number().int().nonnegative().optional(),
+    nativeRequestId: z.string().min(1).max(128).optional(),
+    nativeThreadId: z.string().min(1).max(128).optional(),
+    nativeTurnId: z.string().min(1).max(128).optional(),
+    modelConfigId: z.string().uuid().optional(),
+    reasoningEffort: reasoningEffortSchema.optional(),
+    permissionMode: workspacePermissionModeSchema.optional(),
+    workMode: workspaceWorkModeSchema.optional(),
+    context: workspaceComposerContextSchema.optional(),
+    userText: z.string().optional(),
+    reviewTarget: workspaceReviewTargetSchema.optional(),
+    expectedTurnId: z.string().min(1).max(128).optional(),
+    nativeApprovalId: z.string().min(1).max(128).optional(),
+    sandboxOperationId: z.string().min(1).max(128).optional(),
+    checkpointId: z.string().min(1).max(128).optional(),
+    checkpointKind: checkpointKindSchema.optional(),
+    checkpointConsistent: z.boolean().optional(),
+    snapshotManifestKey: z.string().min(1).max(512).optional(),
+    snapshotChecksum: z.string().length(64).optional(),
+    snapshotStatus: z.enum(['complete', 'incomplete']).optional(),
+    terminalId: z.string().min(1).max(128).optional(),
+    cwd: z.string().max(512).optional(),
+    error: z.string().min(1).max(256).optional(),
+    createdAt: z.string().min(1),
+    updatedAt: z.string().min(1),
+})
+    .strict();
+export function operationScopeKey(input) {
+    return [
+        input.environment,
+        input.userId,
+        input.workspaceId ?? '-',
+        input.directoryName ?? 'basic',
+        input.sessionId ?? '-',
+        input.kind,
+        input.clientRequestId,
+    ].join(':');
+}
+export function hashOperationPayload(payload) {
+    return createHash('sha256').update(stableStringify(payload)).digest('hex');
+}
+export function resolveIdempotentAccept(existing, payloadHash) {
+    if (!existing)
+        return { action: 'create' };
+    if (existing.payloadHash === payloadHash)
+        return { action: 'reuse', operation: existing };
+    return { action: 'conflict', operation: existing };
+}
+export function transitionOperation(operation, to, patch = {}) {
+    assertOperationTransition(operation.status, to);
+    return operationRecordSchema.parse({
+        ...operation,
+        ...patch,
+        status: to,
+        updatedAt: new Date().toISOString(),
+    });
+}
+export function recoverUncertainOperation(operation, evidence) {
+    if (operation.status !== 'uncertain') {
+        throw new Error('uncertain_recovery_requires_uncertain');
+    }
+    const nativeThreadId = evidence.nativeThreadId.trim();
+    const nativeTurnId = evidence.nativeTurnId.trim();
+    if (!nativeThreadId || !nativeTurnId) {
+        throw new Error('native_evidence_required');
+    }
+    const to = evidence.kind === 'running' ? 'accepted' : evidence.status;
+    return transitionOperation(operation, to, { nativeThreadId, nativeTurnId });
+}
+export function stableStringify(value) {
+    return JSON.stringify(sortValue(value));
+}
+function sortValue(value) {
+    if (Array.isArray(value))
+        return value.map(sortValue);
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, nested]) => [key, sortValue(nested)]));
+    }
+    return value;
+}
+//# sourceMappingURL=operations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAG9E,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,gBAAgB;IAChB,iBAAiB;IACjB,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,mBAAmB;IACnB,0BAA0B;IAC1B,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,WAAW;IACX,aAAa;IACb,aAAa;IACb,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,eAAe;IACf,iBAAiB;IACjB,mBAAmB;IACnB,oBAAoB;CACZ,CAAC;AAIX,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAE3D,oGAAoG;AACpG,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,mBAAmB;IACnB,0BAA0B;IAC1B,eAAe;CAC4B,CAAC;AAE9C,yFAAyF;AACzF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,GAAG,4BAA4B;CACY,CAAC;AAE9C,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAQ,4BAAkD,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,CAAE,uBAA6C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,WAAW;IACX,QAAQ;IACR,aAAa;IACb,WAAW;CACH,CAAC;AAIX,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAU,CAAC;AAG3F,MAAM,qBAAqB,GAAwD;IACjF,MAAM,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,CAAC;IAC5D,UAAU,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,CAAC;IAC9D,QAAQ,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,CAAC;IAC7D,SAAS,EAAE,EAAE;IACb,MAAM,EAAE,EAAE;IACV,WAAW,EAAE,EAAE;IACf,6EAA6E;IAC7E,yEAAyE;IACzE,SAAS,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,CAAC;CAC3E,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,IAAqB,EAAE,EAAmB;IAC/E,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAqB,EAAE,EAAmB;IAClF,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAClD,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACzD,aAAa,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IACrD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACvD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC3D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB;;;;OAIG;IACH,eAAe,EAAE,CAAC;SACf,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;QAC/B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;QAC3C,eAAe,EAAE,qBAAqB,CAAC,QAAQ,EAAE;QACjD,cAAc,EAAE,6BAA6B,CAAC,QAAQ,EAAE;KACzD,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;CACd,CAAC;KACD,MAAM,EAAE,CAAC;AAKZ;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,wBAAwB,EAAE,iBAAiB,EAAE,gBAAgB,CAAU,CAAC;AAE3G,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,OAAQ,kBAAsD,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACvC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAClC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3C,IAAI,EAAE,mBAAmB;IACzB,MAAM,EAAE,qBAAqB;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAClD,aAAa,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IACrD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAChD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC3D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACrD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACvD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACrD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACtD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACrD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACnD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAC3C,eAAe,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IACjD,cAAc,EAAE,6BAA6B,CAAC,QAAQ,EAAE;IACxD,QAAQ,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IAC5C,OAAO,EAAE,8BAA8B,CAAC,QAAQ,EAAE;IAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IACpD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACrD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACvD,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACzD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACnD,cAAc,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IAC/C,oBAAoB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC5C,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC1D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAClD,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACjD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7B,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,MAAM,UAAU,iBAAiB,CAAC,KAQjC;IACC,OAAO;QACL,KAAK,CAAC,WAAW;QACjB,KAAK,CAAC,MAAM;QACZ,KAAK,CAAC,WAAW,IAAI,GAAG;QACxB,KAAK,CAAC,aAAa,IAAI,OAAO;QAC9B,KAAK,CAAC,SAAS,IAAI,GAAG;QACtB,KAAK,CAAC,IAAI;QACV,KAAK,CAAC,eAAe;KACtB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAOD,MAAM,UAAU,uBAAuB,CACrC,QAAqC,EACrC,WAAmB;IAEnB,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC3C,IAAI,QAAQ,CAAC,WAAW,KAAK,WAAW;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC1F,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,SAA0B,EAC1B,EAAmB,EACnB,QAAkE,EAAE;IAEpE,yBAAyB,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChD,OAAO,qBAAqB,CAAC,KAAK,CAAC;QACjC,GAAG,SAAS;QACZ,GAAG,KAAK;QACR,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;AACL,CAAC;AAWD,MAAM,UAAU,yBAAyB,CACvC,SAA0B,EAC1B,QAAgC;IAEhC,IAAI,SAAS,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,CAAC,cAAc,IAAI,CAAC,YAAY,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;IACtE,OAAO,mBAAmB,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;aAC7C,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;aACpD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CACpD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+export declare const PARAMETER_STATUSES: readonly ["missing", "invalid", "schema_only", "ready"];
+export type ParameterStatus = (typeof PARAMETER_STATUSES)[number];
+export declare const parameterErrorSchema: z.ZodObject<{
+    path: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export type ParameterError = z.infer<typeof parameterErrorSchema>;
+export declare const parameterFieldPathSchema: z.ZodArray<z.ZodString>;
+export declare const parameterPrimitiveSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+export type ParameterPrimitive = z.infer<typeof parameterPrimitiveSchema>;
+export declare const parameterDocumentSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        ready: "ready";
+        invalid: "invalid";
+        missing: "missing";
+        schema_only: "schema_only";
+    }>;
+    schemaPath: z.ZodOptional<z.ZodString>;
+    dataPath: z.ZodOptional<z.ZodString>;
+    themeId: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodUnknown>;
+    data: z.ZodOptional<z.ZodUnknown>;
+    schemaRevision: z.ZodOptional<z.ZodNumber>;
+    dataRevision: z.ZodOptional<z.ZodNumber>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type ParameterDocument = z.infer<typeof parameterDocumentSchema>;
+export declare const parameterPatchPayloadSchema: z.ZodObject<{
+    fieldPath: z.ZodArray<z.ZodString>;
+    value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+    expectedRevision: z.ZodNumber;
+}, z.core.$strict>;
+export type ParameterPatchPayload = z.infer<typeof parameterPatchPayloadSchema>;
+//# sourceMappingURL=parameters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/parameters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,kBAAkB,yDAA0D,CAAC;AAC1F,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;kBAKtB,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB,yBAG3B,CAAC;AAEX,eAAO,MAAM,wBAAwB,0EAKnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;kBAiDhC,CAAC;AACL,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,2BAA2B;;;;kBAM7B,CAAC;AACZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

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

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+import { workspaceRelativePathSchema } from './files.js';
+export const PARAMETER_STATUSES = ['missing', 'invalid', 'schema_only', 'ready'];
+export const parameterErrorSchema = z
+    .object({
+    path: workspaceRelativePathSchema,
+    reason: z.string().min(1).max(128),
+})
+    .strict();
+export const parameterFieldPathSchema = z
+    .array(z.string().trim().min(1).max(128).regex(/^[A-Za-z_][A-Za-z0-9_]*$/))
+    .min(1)
+    .max(16);
+export const parameterPrimitiveSchema = z.union([
+    z.string().max(4096),
+    z.number().finite(),
+    z.boolean(),
+    z.null(),
+]);
+export const parameterDocumentSchema = z
+    .object({
+    status: z.enum(PARAMETER_STATUSES),
+    schemaPath: workspaceRelativePathSchema.optional(),
+    dataPath: workspaceRelativePathSchema.optional(),
+    themeId: z.string().min(1).max(128).optional(),
+    schema: z.unknown().optional(),
+    data: z.unknown().optional(),
+    schemaRevision: z.number().int().nonnegative().optional(),
+    dataRevision: z.number().int().nonnegative().optional(),
+    errors: z.array(parameterErrorSchema).max(16).optional(),
+})
+    .strict()
+    .superRefine((value, context) => {
+    if (value.status === 'missing' && (value.schema !== undefined || value.data !== undefined)) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'missing parameters cannot include parsed documents',
+        });
+    }
+    if (value.status === 'schema_only' && (value.schema === undefined || value.data !== undefined || !value.schemaPath)) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'schema_only requires a parsed schema and no data document',
+        });
+    }
+    if (value.status === 'ready' &&
+        (value.schema === undefined || value.data === undefined || !value.schemaPath || !value.dataPath)) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'ready parameters require schema and data documents',
+        });
+    }
+    if (value.status === 'invalid' && (!value.errors || value.errors.length === 0)) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'invalid parameters require machine-readable errors',
+            path: ['errors'],
+        });
+    }
+    if (value.status === 'ready' && value.errors && value.errors.length > 0) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'ready parameters cannot include errors',
+            path: ['errors'],
+        });
+    }
+});
+export const parameterPatchPayloadSchema = z
+    .object({
+    fieldPath: parameterFieldPathSchema,
+    value: parameterPrimitiveSchema,
+    expectedRevision: z.number().int().nonnegative(),
+})
+    .strict();
+//# sourceMappingURL=parameters.js.map

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

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

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

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export declare const WORKSPACE_PERMISSION_MODES: readonly ["auto", "confirm", "read-only"];
+export declare const workspacePermissionModeSchema: z.ZodEnum<{
+    auto: "auto";
+    confirm: "confirm";
+    "read-only": "read-only";
+}>;
+export type WorkspacePermissionMode = z.infer<typeof workspacePermissionModeSchema>;
+/** An explicit answer is required; an absent decision must never grant permission. */
+export declare const workspaceApprovalResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"decision">;
+    accepted: z.ZodBoolean;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"permissions">;
+    accepted: z.ZodBoolean;
+    scope: z.ZodLiteral<"turn">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"user-input">;
+    answers: z.ZodRecord<z.ZodString, z.ZodObject<{
+        answers: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>], "kind">;
+export type WorkspaceApprovalResponse = z.infer<typeof workspaceApprovalResponseSchema>;
+//# sourceMappingURL=permissions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,0BAA0B,2CAA4C,CAAC;AACpF,eAAO,MAAM,6BAA6B;;;;EAAqC,CAAC;AAChF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,sFAAsF;AACtF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;4BAgB1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

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

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export const WORKSPACE_PERMISSION_MODES = ['auto', 'confirm', 'read-only'];
+export const workspacePermissionModeSchema = z.enum(WORKSPACE_PERMISSION_MODES);
+/** An explicit answer is required; an absent decision must never grant permission. */
+export const workspaceApprovalResponseSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('decision'), accepted: z.boolean() }).strict(),
+    z.object({
+        kind: z.literal('permissions'),
+        accepted: z.boolean(),
+        scope: z.literal('turn'),
+    }).strict(),
+    z.object({
+        kind: z.literal('user-input'),
+        answers: z.record(z.string().min(1).max(256), z.object({
+            answers: z.array(z.string().min(1).max(16_000)).min(1).max(32),
+        }).strict()).refine((answers) => Object.keys(answers).length > 0 && Object.keys(answers).length <= 32),
+    }).strict(),
+]);
+//# sourceMappingURL=permissions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAU,CAAC;AACpF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAGhF,sFAAsF;AACtF,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC1E,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACzE,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;QAC9B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;QACrB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;KACzB,CAAC,CAAC,MAAM,EAAE;IACX,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;QAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,CACf,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAC1B,CAAC,CAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;SAC/D,CAAC,CAAC,MAAM,EAAE,CACZ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;KAC5F,CAAC,CAAC,MAAM,EAAE;CACZ,CAAC,CAAC"}

package/dist/cloud-workspace/runtime/platform-endpoints.d.ts

@@ -0,0 +1,25 @@
+/** Routes a sandbox calls on the deployment that created it. */
+export declare const PLATFORM_ROUTES: {
+    readonly events: "/runtime/internal/events";
+    readonly eventsProbe: "/runtime/internal/events/probe";
+    readonly modelCredentials: "/runtime/internal/model-credentials";
+    readonly workspaceMcp: "/runtime/internal/workspace-mcp";
+    readonly gitCredentials: "/runtime/internal/git-credentials";
+    readonly cliCredentials: "/runtime/internal/cli-credentials";
+    readonly skillArtifacts: "/runtime/internal/skill-artifacts";
+    readonly previewReservations: "/runtime/internal/preview-reservations";
+    readonly previewCompletions: "/runtime/internal/preview-completions";
+    readonly previewFailures: "/runtime/internal/preview-failures";
+    readonly modelProxy: "/api/llm-proxy";
+};
+export type PlatformRoute = (typeof PLATFORM_ROUTES)[keyof typeof PLATFORM_ROUTES];
+/** Model calls include the platform config id; the rest of the path is fixed. */
+export declare function modelResponsesPath(configId: string): string;
+/** Connectivity checks the same proxy prefix without sending a model turn. */
+export declare function modelConnectivityPath(configId: string): string;
+/**
+ * Join a route onto a public entrance without dropping a deployment prefix such as `/__env/<name>`.
+ * A route that starts with `/` must not be resolved against the entrance as an absolute URL path.
+ */
+export declare function platformEndpoint(base: string, route: string): string;
+//# sourceMappingURL=platform-endpoints.d.ts.map

package/dist/cloud-workspace/runtime/platform-endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-endpoints.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/platform-endpoints.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,eAAO,MAAM,eAAe;;;;;;;;;;;;CAYlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEnF,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CASpE"}

package/dist/cloud-workspace/runtime/platform-endpoints.js

@@ -0,0 +1,37 @@
+/** Routes a sandbox calls on the deployment that created it. */
+export const PLATFORM_ROUTES = {
+    events: '/runtime/internal/events',
+    eventsProbe: '/runtime/internal/events/probe',
+    modelCredentials: '/runtime/internal/model-credentials',
+    workspaceMcp: '/runtime/internal/workspace-mcp',
+    gitCredentials: '/runtime/internal/git-credentials',
+    cliCredentials: '/runtime/internal/cli-credentials',
+    skillArtifacts: '/runtime/internal/skill-artifacts',
+    previewReservations: '/runtime/internal/preview-reservations',
+    previewCompletions: '/runtime/internal/preview-completions',
+    previewFailures: '/runtime/internal/preview-failures',
+    modelProxy: '/api/llm-proxy',
+};
+/** Model calls include the platform config id; the rest of the path is fixed. */
+export function modelResponsesPath(configId) {
+    return `/api/llm-proxy/v1/${configId}/responses`;
+}
+/** Connectivity checks the same proxy prefix without sending a model turn. */
+export function modelConnectivityPath(configId) {
+    return `/api/llm-proxy/v1/${configId}/connectivity`;
+}
+/**
+ * Join a route onto a public entrance without dropping a deployment prefix such as `/__env/<name>`.
+ * A route that starts with `/` must not be resolved against the entrance as an absolute URL path.
+ */
+export function platformEndpoint(base, route) {
+    const url = new URL(base);
+    const prefix = url.pathname.replace(/\/+$/, '');
+    const suffix = route.startsWith('/') ? route : `/${route}`;
+    const pathname = `${prefix}${suffix}`.replace(/\/{2,}/g, '/');
+    url.pathname = pathname === '' ? '/' : pathname;
+    url.search = '';
+    url.hash = '';
+    return url.toString().replace(/\/+$/, '');
+}
+//# sourceMappingURL=platform-endpoints.js.map

package/dist/cloud-workspace/runtime/platform-endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-endpoints.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/platform-endpoints.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,0BAA0B;IAClC,WAAW,EAAE,gCAAgC;IAC7C,gBAAgB,EAAE,qCAAqC;IACvD,YAAY,EAAE,iCAAiC;IAC/C,cAAc,EAAE,mCAAmC;IACnD,cAAc,EAAE,mCAAmC;IACnD,cAAc,EAAE,mCAAmC;IACnD,mBAAmB,EAAE,wCAAwC;IAC7D,kBAAkB,EAAE,uCAAuC;IAC3D,eAAe,EAAE,oCAAoC;IACrD,UAAU,EAAE,gBAAgB;CACpB,CAAC;AAIX,iFAAiF;AACjF,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,qBAAqB,QAAQ,YAAY,CAAC;AACnD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,OAAO,qBAAqB,QAAQ,eAAe,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAa;IAC1D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;IAC3D,MAAM,QAAQ,GAAG,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC9D,GAAG,CAAC,QAAQ,GAAG,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChD,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IAChB,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACd,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC"}

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

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+/** Presigned upload lifetime. The reservation expires with it. */
+export declare const PREVIEW_RESERVATION_TTL_MS: number;
+/** Document ticket lifetime. Callers must also cap it at the source grant expiry. */
+export declare const PREVIEW_TICKET_TTL_MS: number;
+/** PlayCraft HTML adapter limit. Larger sealed files are rejected before upload. */
+export declare const PREVIEW_HTML_MAX_BYTES: number;
+export declare const PREVIEW_LOG_TAIL_MAX = 8000;
+export declare const previewPublishPayloadSchema: z.ZodObject<{}, z.core.$strict>;
+export type PreviewPublishPayload = z.infer<typeof previewPublishPayloadSchema>;
+export declare const previewPublishResultSchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+    previewId: z.ZodString;
+    artifactId: z.ZodString;
+    status: z.ZodEnum<{
+        conflict: "conflict";
+        published: "published";
+    }>;
+    publishRevision: z.ZodNumber;
+    shellUrl: z.ZodString;
+    resourceBaseUrl: z.ZodString;
+    sourceVerified: z.ZodBoolean;
+    uploadedFiles: z.ZodLiteral<1>;
+    contentDigest: z.ZodString;
+    browserValidation: z.ZodLiteral<"pending">;
+}, z.core.$strict>;
+export type PreviewPublishResult = z.infer<typeof previewPublishResultSchema>;
+export declare const previewStatusSchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        pending: "pending";
+        ready: "ready";
+        empty: "empty";
+    }>;
+    previewId: z.ZodOptional<z.ZodString>;
+    artifactId: z.ZodOptional<z.ZodString>;
+    publishRevision: z.ZodOptional<z.ZodNumber>;
+    shellUrl: z.ZodOptional<z.ZodString>;
+    resourceBaseUrl: z.ZodOptional<z.ZodString>;
+    sourceVerified: z.ZodOptional<z.ZodBoolean>;
+    browserValidation: z.ZodOptional<z.ZodLiteral<"pending">>;
+    lastError: z.ZodOptional<z.ZodString>;
+    logTail: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type PreviewStatus = z.infer<typeof previewStatusSchema>;
+export declare const previewReservationSchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+    previewId: z.ZodString;
+    artifactId: z.ZodString;
+    uploadUrl: z.ZodString;
+    uploadGeneration: z.ZodNumber;
+    reservationExpiresAt: z.ZodString;
+    expectedPublishRevision: z.ZodNumber;
+    alreadyUploaded: z.ZodBoolean;
+}, z.core.$strict>;
+export type PreviewReservation = z.infer<typeof previewReservationSchema>;
+export declare function previewShellPath(previewId: string): string;
+export declare function previewResourceBasePath(previewId: string, artifactId: string): string;
+//# sourceMappingURL=previews.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"previews.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/previews.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kEAAkE;AAClE,eAAO,MAAM,0BAA0B,QAAiB,CAAC;AAEzD,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,QAAgB,CAAC;AAEnD,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,QAAmB,CAAC;AAEvD,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAK1C,eAAO,MAAM,2BAA2B,iCAAwB,CAAC;AACjE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;kBAe5B,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;kBAerB,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,wBAAwB;;;;;;;;;kBAY1B,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAErF"}

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

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+/** Presigned upload lifetime. The reservation expires with it. */
+export const PREVIEW_RESERVATION_TTL_MS = 15 * 60 * 1000;
+/** Document ticket lifetime. Callers must also cap it at the source grant expiry. */
+export const PREVIEW_TICKET_TTL_MS = 5 * 60 * 1000;
+/** PlayCraft HTML adapter limit. Larger sealed files are rejected before upload. */
+export const PREVIEW_HTML_MAX_BYTES = 50 * 1024 * 1024;
+export const PREVIEW_LOG_TAIL_MAX = 8_000;
+const digestSchema = z.string().regex(/^[a-f0-9]{64}$/);
+const idSchema = z.string().trim().min(1).max(128);
+export const previewPublishPayloadSchema = z.object({}).strict();
+export const previewPublishResultSchema = z
+    .object({
+    /** Originating operation's session, retained for publisher receipt verification. */
+    sessionId: idSchema.optional(),
+    previewId: idSchema,
+    artifactId: idSchema,
+    status: z.enum(['published', 'conflict']),
+    publishRevision: z.number().int().nonnegative(),
+    shellUrl: z.string().min(1).max(512),
+    resourceBaseUrl: z.string().min(1).max(512),
+    sourceVerified: z.boolean(),
+    uploadedFiles: z.literal(1),
+    contentDigest: digestSchema,
+    browserValidation: z.literal('pending'),
+})
+    .strict();
+export const previewStatusSchema = z
+    .object({
+    /** Legacy provenance metadata; workspace preview reads do not select by session. */
+    sessionId: idSchema.optional(),
+    status: z.enum(['empty', 'pending', 'ready']),
+    previewId: idSchema.optional(),
+    artifactId: idSchema.optional(),
+    publishRevision: z.number().int().nonnegative().optional(),
+    shellUrl: z.string().min(1).max(512).optional(),
+    resourceBaseUrl: z.string().min(1).max(512).optional(),
+    sourceVerified: z.boolean().optional(),
+    browserValidation: z.literal('pending').optional(),
+    lastError: z.string().min(1).max(256).optional(),
+    logTail: z.string().max(PREVIEW_LOG_TAIL_MAX).optional(),
+})
+    .strict();
+export const previewReservationSchema = z
+    .object({
+    /** Operation origin echo; the reserved preview itself is shared by the workspace. */
+    sessionId: idSchema.optional(),
+    previewId: idSchema,
+    artifactId: idSchema,
+    uploadUrl: z.string().url(),
+    uploadGeneration: z.number().int().positive(),
+    reservationExpiresAt: z.string().min(1),
+    expectedPublishRevision: z.number().int().nonnegative(),
+    alreadyUploaded: z.boolean(),
+})
+    .strict();
+export function previewShellPath(previewId) {
+    return `/runtime/previews/${encodeURIComponent(previewId)}/view`;
+}
+export function previewResourceBasePath(previewId, artifactId) {
+    return `/preview/${encodeURIComponent(previewId)}/artifacts/${encodeURIComponent(artifactId)}/`;
+}
+//# sourceMappingURL=previews.js.map

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

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