@playcraft/common 0.1.24 → 0.1.25

package/dist/cloud-workspace/runtime/native-history.js

@@ -0,0 +1,127 @@
+import { z } from 'zod';
+import { sessionRecoverabilitySchema } from './checkpoints.js';
+const TEXT_MAX = 20_000;
+const ITEM_MAX = 500;
+const ID_MAX = 128;
+export const nativeHistoryItemSchema = z
+    .object({
+    id: z.string().min(1).max(ID_MAX),
+    role: z.enum(['user', 'assistant']),
+    text: z.string().min(1).max(TEXT_MAX),
+})
+    .strict();
+/** Sandbox `thread/read` projection. Recoverability stays on the runtime session map. */
+export const nativeHistoryReadSchema = z
+    .object({
+    source: z.literal('native'),
+    sessionId: z.string().min(1).max(128),
+    workspaceId: z.string().min(1).max(128),
+    threadId: z.string().min(1).max(128),
+    threadName: z.string().min(1).max(200).optional(),
+    truncated: z.boolean(),
+    items: z.array(nativeHistoryItemSchema).max(ITEM_MAX),
+})
+    .strict();
+export const browserSessionHistorySchema = z.discriminatedUnion('source', [
+    nativeHistoryReadSchema.extend({ recoverability: sessionRecoverabilitySchema }).strict(),
+    z
+        .object({
+        source: z.literal('unmapped'),
+        sessionId: z.string().min(1).max(128),
+        workspaceId: z.string().min(1).max(128),
+    })
+        .strict(),
+]);
+/**
+ * Projects a `thread/read` result into user and assistant text.
+ * A different thread id, or a payload that is not an object, is refused.
+ * Tool, reasoning, and image parts are omitted rather than described.
+ */
+export function projectNativeThread(expectedThreadId, value) {
+    const thread = record(value);
+    const threadId = text(thread.id) ?? text(thread.threadId);
+    if (!threadId || threadId !== expectedThreadId || threadId.length > ID_MAX)
+        return undefined;
+    const name = text(thread.name)?.trim();
+    const threadName = name ? name.slice(0, 200) : undefined;
+    const collected = [];
+    const used = new Set();
+    let truncated = false;
+    const turns = Array.isArray(thread.turns) ? thread.turns : [];
+    for (const turn of turns) {
+        const items = Array.isArray(record(turn).items) ? record(turn).items : [];
+        for (const item of items) {
+            if (absorb(item, collected, used))
+                truncated = true;
+        }
+    }
+    if (collected.length > ITEM_MAX) {
+        truncated = true;
+        collected.splice(0, collected.length - ITEM_MAX);
+    }
+    return {
+        threadId,
+        ...(threadName ? { threadName } : {}),
+        truncated,
+        items: collected,
+    };
+}
+function absorb(value, collected, used) {
+    const item = record(value);
+    const kind = text(item.type);
+    let role;
+    let body = '';
+    if (kind === 'userMessage') {
+        role = 'user';
+        body = userText(item.content);
+    }
+    else if (kind === 'agentMessage') {
+        role = 'assistant';
+        body = text(item.text) ?? '';
+    }
+    else {
+        return false;
+    }
+    const trimmed = body.trim();
+    if (!role || !trimmed)
+        return false;
+    let truncated = false;
+    let next = trimmed;
+    if (next.length > TEXT_MAX) {
+        next = next.slice(0, TEXT_MAX);
+        truncated = true;
+    }
+    const id = uniqueId(text(item.id), collected.length + 1, used);
+    collected.push({ id, role, text: next });
+    return truncated;
+}
+function userText(content) {
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .map((part) => {
+        const row = record(part);
+        return text(row.type) === 'text' ? text(row.text) ?? '' : '';
+    })
+        .filter(Boolean)
+        .join('\n');
+}
+function uniqueId(preferred, index, used) {
+    const base = preferred && preferred.length <= ID_MAX ? preferred : `item_${index}`;
+    if (!used.has(base)) {
+        used.add(base);
+        return base;
+    }
+    const next = `${base}:${index}`.slice(0, ID_MAX);
+    used.add(next);
+    return next;
+}
+function text(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+//# sourceMappingURL=native-history.js.map

package/dist/cloud-workspace/runtime/native-history.js.map

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

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

@@ -0,0 +1,189 @@
+import { z } from 'zod';
+export declare const OPERATION_KINDS: readonly ["runtime.ensure", "runtime.destroy", "session.create", "session.turn", "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 type OperationKind = (typeof OPERATION_KINDS)[number];
+export declare const operationKindSchema: z.ZodEnum<{
+    "runtime.ensure": "runtime.ensure";
+    "runtime.destroy": "runtime.destroy";
+    "session.create": "session.create";
+    "session.turn": "session.turn";
+    "session.interrupt": "session.interrupt";
+    "session.approval.respond": "session.approval.respond";
+    "file.write": "file.write";
+    "git.commit": "git.commit";
+    "git.push": "git.push";
+    "git.stage": "git.stage";
+    "git.unstage": "git.unstage";
+    "git.discard": "git.discard";
+    "workspace.save": "workspace.save";
+    "terminal.create": "terminal.create";
+    "parameter.patch": "parameter.patch";
+    "skills.update": "skills.update";
+    "preview.publish": "preview.publish";
+    "checkpoint.create": "checkpoint.create";
+    "checkpoint.restore": "checkpoint.restore";
+}>;
+/** Kinds that steer a running turn; they touch neither workspace content nor the runtime itself. */
+export declare const TURN_CONTROL_OPERATION_KINDS: readonly ["session.interrupt", "session.approval.respond"];
+/** Kinds that steer the runtime or a running turn without changing workspace content. */
+export declare const CONTROL_OPERATION_KINDS: readonly ["runtime.ensure", "runtime.destroy", "session.interrupt", "session.approval.respond"];
+export declare function isTurnControl(kind: string): boolean;
+export declare function isWorkspaceMutation(kind: string): boolean;
+export declare const OPERATION_STATUSES: readonly ["queued", "dispatched", "accepted", "completed", "failed", "interrupted", "uncertain"];
+export type OperationStatus = (typeof OPERATION_STATUSES)[number];
+export declare const operationStatusSchema: z.ZodEnum<{
+    completed: "completed";
+    failed: "failed";
+    uncertain: "uncertain";
+    queued: "queued";
+    dispatched: "dispatched";
+    accepted: "accepted";
+    interrupted: "interrupted";
+}>;
+export declare const TERMINAL_OPERATION_STATUSES: readonly ["completed", "failed", "interrupted"];
+export type TerminalOperationStatus = (typeof TERMINAL_OPERATION_STATUSES)[number];
+export declare function canTransitionOperation(from: OperationStatus, to: OperationStatus): boolean;
+export declare function assertOperationTransition(from: OperationStatus, to: OperationStatus): void;
+export declare const operationAcceptRequestSchema: z.ZodObject<{
+    clientRequestId: z.ZodString;
+    kind: z.ZodEnum<{
+        "runtime.ensure": "runtime.ensure";
+        "runtime.destroy": "runtime.destroy";
+        "session.create": "session.create";
+        "session.turn": "session.turn";
+        "session.interrupt": "session.interrupt";
+        "session.approval.respond": "session.approval.respond";
+        "file.write": "file.write";
+        "git.commit": "git.commit";
+        "git.push": "git.push";
+        "git.stage": "git.stage";
+        "git.unstage": "git.unstage";
+        "git.discard": "git.discard";
+        "workspace.save": "workspace.save";
+        "terminal.create": "terminal.create";
+        "parameter.patch": "parameter.patch";
+        "skills.update": "skills.update";
+        "preview.publish": "preview.publish";
+        "checkpoint.create": "checkpoint.create";
+        "checkpoint.restore": "checkpoint.restore";
+    }>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    directoryName: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"root">]>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    expectedRevision: z.ZodOptional<z.ZodNumber>;
+    payload: z.ZodUnknown;
+    sessionRecovery: z.ZodOptional<z.ZodObject<{
+        context: z.ZodString;
+        modelConfigId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type OperationAcceptRequest = z.infer<typeof operationAcceptRequestSchema>;
+export type SessionRecovery = NonNullable<OperationAcceptRequest['sessionRecovery']>;
+/**
+ * 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 declare const LOST_THREAD_ERRORS: readonly ["native_not_recoverable", "unknown_session", "unknown_thread"];
+export declare function isLostThreadError(error: string | undefined): boolean;
+export declare const operationRecordSchema: z.ZodObject<{
+    operationId: z.ZodString;
+    environment: z.ZodString;
+    userId: z.ZodString;
+    clientRequestId: z.ZodString;
+    kind: z.ZodEnum<{
+        "runtime.ensure": "runtime.ensure";
+        "runtime.destroy": "runtime.destroy";
+        "session.create": "session.create";
+        "session.turn": "session.turn";
+        "session.interrupt": "session.interrupt";
+        "session.approval.respond": "session.approval.respond";
+        "file.write": "file.write";
+        "git.commit": "git.commit";
+        "git.push": "git.push";
+        "git.stage": "git.stage";
+        "git.unstage": "git.unstage";
+        "git.discard": "git.discard";
+        "workspace.save": "workspace.save";
+        "terminal.create": "terminal.create";
+        "parameter.patch": "parameter.patch";
+        "skills.update": "skills.update";
+        "preview.publish": "preview.publish";
+        "checkpoint.create": "checkpoint.create";
+        "checkpoint.restore": "checkpoint.restore";
+    }>;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        uncertain: "uncertain";
+        queued: "queued";
+        dispatched: "dispatched";
+        accepted: "accepted";
+        interrupted: "interrupted";
+    }>;
+    payloadHash: z.ZodString;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    directoryName: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"root">]>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    expectedRevision: z.ZodOptional<z.ZodNumber>;
+    generation: z.ZodOptional<z.ZodNumber>;
+    runtimeEpoch: z.ZodOptional<z.ZodNumber>;
+    leaseFence: z.ZodOptional<z.ZodNumber>;
+    nativeRequestId: z.ZodOptional<z.ZodString>;
+    nativeThreadId: z.ZodOptional<z.ZodString>;
+    nativeTurnId: z.ZodOptional<z.ZodString>;
+    modelConfigId: z.ZodOptional<z.ZodString>;
+    nativeApprovalId: z.ZodOptional<z.ZodString>;
+    sandboxOperationId: z.ZodOptional<z.ZodString>;
+    checkpointId: z.ZodOptional<z.ZodString>;
+    checkpointKind: z.ZodOptional<z.ZodEnum<{
+        file: "file";
+        coordinated: "coordinated";
+        best_effort: "best_effort";
+    }>>;
+    checkpointConsistent: z.ZodOptional<z.ZodBoolean>;
+    snapshotManifestKey: z.ZodOptional<z.ZodString>;
+    snapshotChecksum: z.ZodOptional<z.ZodString>;
+    snapshotStatus: z.ZodOptional<z.ZodEnum<{
+        incomplete: "incomplete";
+        complete: "complete";
+    }>>;
+    terminalId: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strict>;
+export type OperationRecord = z.infer<typeof operationRecordSchema>;
+export declare function operationScopeKey(input: {
+    environment: string;
+    userId: string;
+    kind: OperationKind;
+    clientRequestId: string;
+    workspaceId?: string;
+    directoryName?: string;
+    sessionId?: string;
+}): string;
+export declare function hashOperationPayload(payload: unknown): string;
+export type IdempotentAcceptResult = {
+    action: 'create';
+} | {
+    action: 'reuse';
+    operation: OperationRecord;
+} | {
+    action: 'conflict';
+    operation: OperationRecord;
+};
+export declare function resolveIdempotentAccept(existing: OperationRecord | undefined, payloadHash: string): IdempotentAcceptResult;
+export declare function transitionOperation(operation: OperationRecord, to: OperationStatus, patch?: Partial<Omit<OperationRecord, 'operationId' | 'status'>>): OperationRecord;
+export type NativeRecoveryEvidence = {
+    kind: 'running';
+    nativeThreadId: string;
+    nativeTurnId: string;
+} | {
+    kind: 'terminal';
+    nativeThreadId: string;
+    nativeTurnId: string;
+    status: TerminalOperationStatus;
+};
+export declare function recoverUncertainOperation(operation: OperationRecord, evidence: NativeRecoveryEvidence): OperationRecord;
+export declare function stableStringify(value: unknown): string;
+//# sourceMappingURL=operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/operations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,eAAe,6VAoBlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;EAA0B,CAAC;AAE3D,oGAAoG;AACpG,eAAO,MAAM,4BAA4B,4DAGI,CAAC;AAE9C,yFAAyF;AACzF,eAAO,MAAM,uBAAuB,iGAIS,CAAC;AAE9C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,eAAO,MAAM,kBAAkB,kGAQrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,eAAO,MAAM,qBAAqB;;;;;;;;EAA6B,CAAC;AAEhE,eAAO,MAAM,2BAA2B,iDAAkD,CAAC;AAC3F,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAcnF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,eAAe,GAAG,OAAO,CAE1F;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,eAAe,GAAG,IAAI,CAI1F;AAED,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmB9B,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,0EAA2E,CAAC;AAE3G,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEpE;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkCvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAUT;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE7D;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,CAAC;AAEvD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,eAAe,GAAG,SAAS,EACrC,WAAW,EAAE,MAAM,GAClB,sBAAsB,CAIxB;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,eAAe,EAC1B,EAAE,EAAE,eAAe,EACnB,KAAK,GAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,QAAQ,CAAC,CAAM,GACnE,eAAe,CAQjB;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACjE;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,uBAAuB,CAAC;CACjC,CAAC;AAEN,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,sBAAsB,GAC/B,eAAe,CAWjB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD"}

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

@@ -0,0 +1,192 @@
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+import { checkpointKindSchema } from './checkpoints.js';
+import { workspaceSessionScopeSchema } from './workspace-directories.js';
+export const OPERATION_KINDS = [
+    'runtime.ensure',
+    'runtime.destroy',
+    'session.create',
+    'session.turn',
+    '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',
+];
+/** Kinds that steer the runtime or a running turn without changing workspace content. */
+export const CONTROL_OPERATION_KINDS = [
+    'runtime.ensure',
+    'runtime.destroy',
+    ...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() })
+        .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(),
+    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":"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"}

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