@playcraft/common 0.1.35-prod → 0.1.37-beta

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

@@ -0,0 +1,178 @@
+import { z } from 'zod';
+import { isLocalWorkspaceGitAuthMode, workspaceGitAuthModeSchema, workspaceGitDirectAccessSchema } from './git-auth-mode.js';
+import { workspaceDirectoryRegistrationSchema } from './workspace-directories.js';
+import { batchSourceSnapshotSchema } from './batch-generation.js';
+/** Trusted control-plane registration; never merge this with a browser operation payload. */
+const boundWorkspaceRegistrationSchema = z
+    .object({
+    workspaceId: z.string().uuid(),
+    projectId: z.string().uuid(),
+    targetKind: z.enum(['main', 'remix']),
+    remixId: z.string().uuid().nullable(),
+    repositoryUrl: z.string().min(1).max(2048),
+    branchName: z.string().min(1).max(512),
+    directories: z.array(workspaceDirectoryRegistrationSchema).optional(),
+    /** A batch may bind repository metadata while retaining the original local basic checkout. */
+    preserveLocalBasic: z.boolean().optional(),
+    /** Present only while the remix draft has not been pushed. Checkout creates the branch from this commit. */
+    pendingFork: z.object({
+        sourceBranchName: z.string().min(1).max(512),
+        sourceCommit: z.string().regex(/^[a-f0-9]{40,64}$/),
+    }).strict().optional(),
+})
+    .strict()
+    .refine((value) => (value.targetKind === 'main') === (value.remixId === null));
+export const workspaceRegistrationSchema = z.union([
+    boundWorkspaceRegistrationSchema,
+    z.object({
+        workspaceId: z.string().uuid(),
+        projectId: z.null(),
+        targetKind: z.literal('standalone'),
+        remixId: z.null(),
+        repositoryUrl: z.null(),
+        branchName: z.null(),
+        directories: z.array(workspaceDirectoryRegistrationSchema).optional(),
+    }).strict(),
+]);
+/**
+ * Checkout instructions for an unpushed remix draft. Present only until that draft is pushed,
+ * so two registrations of the same workspace can differ here without being different bindings.
+ */
+export function remixPendingFork(input) {
+    if (input.targetKind !== 'remix' || input.pushedAt != null)
+        return undefined;
+    if (typeof input.sourceBranchName !== 'string' || !input.sourceBranchName)
+        return undefined;
+    if (typeof input.sourceCommit !== 'string' || !input.sourceCommit)
+        return undefined;
+    return { sourceBranchName: input.sourceBranchName, sourceCommit: input.sourceCommit };
+}
+/** Identity of a workspace binding. `pendingFork` is excluded because it appears and disappears. */
+export function sameWorkspaceRegistration(left, right) {
+    return (left.workspaceId === right.workspaceId &&
+        left.projectId === right.projectId &&
+        left.targetKind === right.targetKind &&
+        left.remixId === right.remixId &&
+        left.repositoryUrl === right.repositoryUrl &&
+        left.branchName === right.branchName &&
+        ('preserveLocalBasic' in left ? left.preserveLocalBasic : undefined) === ('preserveLocalBasic' in right ? right.preserveLocalBasic : undefined));
+}
+/** Ephemeral clone access, never part of a persisted Workspace binding or operation. */
+export const workspaceGitAccessSchema = z
+    .object({
+    username: z
+        .string()
+        .min(1)
+        .max(256)
+        .regex(/^[^:\r\n\0]+$/),
+    password: z
+        .string()
+        .min(1)
+        .max(8192)
+        .regex(/^[^\r\n\0]+$/),
+    issuedAt: z.string().datetime(),
+    expiresAt: z.string().datetime(),
+})
+    .strict()
+    .refine((value) => {
+    const lifetime = Date.parse(value.expiresAt) - Date.parse(value.issuedAt);
+    return lifetime > 0 && lifetime <= 15 * 60_000;
+});
+/** Controlled read entry. The canonical repository URL stays on the remote. */
+export const workspaceGitTransportSchema = z
+    .object({
+    kind: z.enum(['git-read-gateway-v1', 'git-gateway-v2']),
+    cloneUrl: z.string().min(1).max(2048),
+})
+    .strict();
+const cloneWorkspacePreparationSchema = z
+    .object({
+    mode: z.literal('clone'),
+    authMode: workspaceGitAuthModeSchema.optional(),
+    directAccess: workspaceGitDirectAccessSchema.nullable().optional(),
+    gitAccess: workspaceGitAccessSchema.optional(),
+    transport: workspaceGitTransportSchema.optional(),
+})
+    .strict()
+    .refine((value) => value.transport === undefined || value.gitAccess !== undefined)
+    .refine(value => isLocalWorkspaceGitAuthMode(value.authMode)
+    ? value.directAccess !== undefined && !value.gitAccess && !value.transport
+    : value.directAccess === undefined);
+export const workspacePreparationSchema = z.union([
+    cloneWorkspacePreparationSchema,
+    z.object({ mode: z.literal('empty') }).strict(),
+]);
+const LOOPBACK_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]']);
+export function parseWorkspaceGitGatewayOrigin(value) {
+    const url = new URL(value);
+    if (url.username ||
+        url.password ||
+        url.search ||
+        url.hash ||
+        (url.pathname !== '/' && url.pathname !== '') ||
+        (url.protocol !== 'https:' &&
+            !(url.protocol === 'http:' && LOOPBACK_HOSTS.has(url.hostname)))) {
+        throw new Error('invalid_git_gateway_origin');
+    }
+    return url.origin;
+}
+export function parseWorkspaceGitGatewayOrigins(value) {
+    if (!value?.trim())
+        return [];
+    return [
+        ...new Set(value
+            .split(',')
+            .map((item) => item.trim())
+            .filter(Boolean)
+            .map((item) => parseWorkspaceGitGatewayOrigin(item))),
+    ];
+}
+/** Proxy mode is rejected when no allowlisted origin is configured. */
+export function matchWorkspaceGitGatewayCloneUrl(cloneUrl, allowedOrigins, repositoryUrl) {
+    if (allowedOrigins.length === 0)
+        return { ok: false, reason: 'capability_missing' };
+    let gateway;
+    let repository;
+    try {
+        gateway = new URL(cloneUrl);
+        repository = new URL(repositoryUrl);
+    }
+    catch {
+        return { ok: false, reason: 'rejected' };
+    }
+    const allowed = new Set();
+    for (const origin of allowedOrigins) {
+        try {
+            allowed.add(parseWorkspaceGitGatewayOrigin(origin));
+        }
+        catch {
+            return { ok: false, reason: 'rejected' };
+        }
+    }
+    const request = /^\/workspace-git\/([a-f0-9]{64}|v2\/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$/.exec(gateway.pathname);
+    if (!request ||
+        gateway.username ||
+        gateway.password ||
+        gateway.search ||
+        gateway.hash ||
+        gateway.href !== `${gateway.origin}${gateway.pathname}` ||
+        gateway.origin === repository.origin ||
+        !allowed.has(gateway.origin) ||
+        (gateway.protocol !== 'https:' &&
+            !(gateway.protocol === 'http:' && LOOPBACK_HOSTS.has(gateway.hostname)))) {
+        return { ok: false, reason: 'rejected' };
+    }
+    return { ok: true, origin: gateway.origin, requestId: request[1] };
+}
+export const workspaceRegistrationRequestSchema = z
+    .object({
+    binding: workspaceRegistrationSchema,
+    generation: z.number().int().nonnegative(),
+    runtimeEpoch: z.number().int().nonnegative(),
+    leaseFence: z.number().int().nonnegative(),
+    preparation: workspacePreparationSchema.optional(),
+    cliCredentials: z.boolean().optional(),
+    sourceSnapshot: batchSourceSnapshotSchema.optional(),
+})
+    .strict();
+//# sourceMappingURL=workspace-binding.js.map

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

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

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

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+/** Stable directory identities never contain a branch name or a relative path. */
+export declare const workspaceDirectoryNameSchema: z.ZodString;
+export type WorkspaceDirectoryName = z.infer<typeof workspaceDirectoryNameSchema>;
+/** The workspace root is an orchestration session, never an engineering checkout. */
+export declare const workspaceSessionScopeSchema: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"root">]>;
+export type WorkspaceSessionScope = z.infer<typeof workspaceSessionScopeSchema>;
+export declare const workspaceDirectoryRegistrationSchema: z.ZodObject<{
+    workspaceId: z.ZodString;
+    directoryName: z.ZodString;
+    remixId: z.ZodNullable<z.ZodString>;
+    branchName: z.ZodString;
+    sourceCommit: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        pending: "pending";
+        failed: "failed";
+        ready: "ready";
+        reclaimed: "reclaimed";
+    }>>;
+}, z.core.$strict>;
+export type WorkspaceDirectoryRegistration = z.infer<typeof workspaceDirectoryRegistrationSchema>;
+export declare const workspaceDiskAdmissionSchema: z.ZodObject<{
+    usagePercent: z.ZodNumber;
+    collectedAt: z.ZodString;
+}, z.core.$strict>;
+export declare function workspaceDiskAdmission(usagePercent: number): 'allowed' | 'warning' | 'paused';
+/** Collected on demand; reclaimed checkouts retain identity without consuming local bytes. */
+export declare const workspaceDirectoryStatsSchema: z.ZodObject<{
+    workspaceId: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    lastUsedAt: z.ZodNullable<z.ZodString>;
+    directories: z.ZodArray<z.ZodObject<{
+        directoryName: z.ZodString;
+        sizeBytes: z.ZodNumber;
+        lastUsedAt: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            present: "present";
+            reclaimed: "reclaimed";
+            missing: "missing";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkspaceDirectoryStats = z.infer<typeof workspaceDirectoryStatsSchema>;
+//# sourceMappingURL=workspace-directories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-directories.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/workspace-directories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kFAAkF;AAClF,eAAO,MAAM,4BAA4B,aAAwE,CAAC;AAClH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,qFAAqF;AACrF,eAAO,MAAM,2BAA2B,0DAA6D,CAAC;AACtG,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;kBAOtC,CAAC;AACZ,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAElG,eAAO,MAAM,4BAA4B;;;kBAG9B,CAAC;AAEZ,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAG7F;AAED,8FAA8F;AAC9F,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;kBAU/B,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

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

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+/** Stable directory identities never contain a branch name or a relative path. */
+export const workspaceDirectoryNameSchema = z.string().max(80).regex(/^(?:basic|remix-[a-z0-9][a-z0-9-]{3,63})$/);
+/** The workspace root is an orchestration session, never an engineering checkout. */
+export const workspaceSessionScopeSchema = z.union([workspaceDirectoryNameSchema, z.literal('root')]);
+export const workspaceDirectoryRegistrationSchema = z.object({
+    workspaceId: z.string().uuid(),
+    directoryName: workspaceDirectoryNameSchema,
+    remixId: z.string().uuid().nullable(),
+    branchName: z.string().trim().min(1).max(512),
+    sourceCommit: z.string().regex(/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/).optional(),
+    status: z.enum(['pending', 'ready', 'reclaimed', 'failed']).optional(),
+}).strict();
+export const workspaceDiskAdmissionSchema = z.object({
+    usagePercent: z.number().finite().min(0).max(100),
+    collectedAt: z.string().datetime(),
+}).strict();
+export function workspaceDiskAdmission(usagePercent) {
+    const percent = workspaceDiskAdmissionSchema.shape.usagePercent.parse(usagePercent);
+    return percent >= 90 ? 'paused' : percent >= 70 ? 'warning' : 'allowed';
+}
+/** Collected on demand; reclaimed checkouts retain identity without consuming local bytes. */
+export const workspaceDirectoryStatsSchema = z.object({
+    workspaceId: z.string().uuid(),
+    sizeBytes: z.number().int().nonnegative().safe(),
+    lastUsedAt: z.string().datetime().nullable(),
+    directories: z.array(z.object({
+        directoryName: workspaceDirectoryNameSchema,
+        sizeBytes: z.number().int().nonnegative().safe(),
+        lastUsedAt: z.string().datetime().nullable(),
+        status: z.enum(['present', 'reclaimed', 'missing']),
+    }).strict()),
+}).strict();
+//# sourceMappingURL=workspace-directories.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-directories.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/workspace-directories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kFAAkF;AAClF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;AAGlH,qFAAqF;AACrF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,4BAA4B,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAGtG,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC9B,aAAa,EAAE,4BAA4B;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC7C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC,QAAQ,EAAE;IAC5E,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;CACvE,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,UAAU,sBAAsB,CAAC,YAAoB;IACzD,MAAM,OAAO,GAAG,4BAA4B,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACpF,OAAO,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1E,CAAC;AAED,8FAA8F;AAC9F,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE;IAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC5B,aAAa,EAAE,4BAA4B;QAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE;QAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC5C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;KACpD,CAAC,CAAC,MAAM,EAAE,CAAC;CACb,CAAC,CAAC,MAAM,EAAE,CAAC"}

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

@@ -0,0 +1,151 @@
+import { z } from 'zod';
+export declare const workspaceUiRangeSchema: z.ZodObject<{
+    startLine: z.ZodNumber;
+    endLine: z.ZodNumber;
+}, z.core.$strict>;
+/** Observed browser state, separate from references explicitly selected by the user. */
+export declare const workspaceUiSnapshotSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    viewId: z.ZodString;
+    workspaceId: z.ZodString;
+    directoryName: z.ZodString;
+    sessionId: z.ZodString;
+    revision: z.ZodNumber;
+    observedAt: z.ZodString;
+    panelOpen: z.ZodBoolean;
+    activeTab: z.ZodNullable<z.ZodString>;
+    openTabs: z.ZodArray<z.ZodString>;
+    activeFile: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        range: z.ZodOptional<z.ZodObject<{
+            startLine: z.ZodNumber;
+            endLine: z.ZodNumber;
+        }, z.core.$strict>>;
+        dirty: z.ZodBoolean;
+        loadState: z.ZodEnum<{
+            error: "error";
+            ready: "ready";
+            loading: "loading";
+        }>;
+    }, z.core.$strict>>;
+    activePreview: z.ZodOptional<z.ZodObject<{
+        artifactId: z.ZodOptional<z.ZodString>;
+        versionId: z.ZodOptional<z.ZodString>;
+        previewId: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            playable: "playable";
+            file: "file";
+            model: "model";
+            video: "video";
+            audio: "audio";
+            image: "image";
+            document: "document";
+        }>>;
+        versionCreatedAt: z.ZodOptional<z.ZodString>;
+        isCurrentVersion: z.ZodOptional<z.ZodBoolean>;
+        loadState: z.ZodEnum<{
+            error: "error";
+            ready: "ready";
+            loading: "loading";
+        }>;
+        viewport: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkspaceUiSnapshot = z.infer<typeof workspaceUiSnapshotSchema>;
+export declare const workspaceUiCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"open_file">;
+    path: z.ZodString;
+    range: z.ZodOptional<z.ZodObject<{
+        startLine: z.ZodNumber;
+        endLine: z.ZodNumber;
+    }, z.core.$strict>>;
+    commandId: z.ZodString;
+    viewId: z.ZodString;
+    workspaceId: z.ZodString;
+    directoryName: z.ZodString;
+    sessionId: z.ZodString;
+    expiresAt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"open_preview">;
+    artifactId: z.ZodOptional<z.ZodString>;
+    versionId: z.ZodOptional<z.ZodString>;
+    previewId: z.ZodOptional<z.ZodString>;
+    commandId: z.ZodString;
+    viewId: z.ZodString;
+    workspaceId: z.ZodString;
+    directoryName: z.ZodString;
+    sessionId: z.ZodString;
+    expiresAt: z.ZodString;
+}, z.core.$strip>], "kind">;
+export type WorkspaceUiCommand = z.infer<typeof workspaceUiCommandSchema>;
+export declare const workspaceUiResultSchema: z.ZodObject<{
+    commandId: z.ZodString;
+    viewId: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        opened: "opened";
+        rejected: "rejected";
+    }>;
+    reason: z.ZodOptional<z.ZodString>;
+    snapshot: z.ZodOptional<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        viewId: z.ZodString;
+        workspaceId: z.ZodString;
+        directoryName: z.ZodString;
+        sessionId: z.ZodString;
+        revision: z.ZodNumber;
+        observedAt: z.ZodString;
+        panelOpen: z.ZodBoolean;
+        activeTab: z.ZodNullable<z.ZodString>;
+        openTabs: z.ZodArray<z.ZodString>;
+        activeFile: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            range: z.ZodOptional<z.ZodObject<{
+                startLine: z.ZodNumber;
+                endLine: z.ZodNumber;
+            }, z.core.$strict>>;
+            dirty: z.ZodBoolean;
+            loadState: z.ZodEnum<{
+                error: "error";
+                ready: "ready";
+                loading: "loading";
+            }>;
+        }, z.core.$strict>>;
+        activePreview: z.ZodOptional<z.ZodObject<{
+            artifactId: z.ZodOptional<z.ZodString>;
+            versionId: z.ZodOptional<z.ZodString>;
+            previewId: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+            kind: z.ZodOptional<z.ZodEnum<{
+                playable: "playable";
+                file: "file";
+                model: "model";
+                video: "video";
+                audio: "audio";
+                image: "image";
+                document: "document";
+            }>>;
+            versionCreatedAt: z.ZodOptional<z.ZodString>;
+            isCurrentVersion: z.ZodOptional<z.ZodBoolean>;
+            loadState: z.ZodEnum<{
+                error: "error";
+                ready: "ready";
+                loading: "loading";
+            }>;
+            viewport: z.ZodOptional<z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkspaceUiResult = z.infer<typeof workspaceUiResultSchema>;
+export declare const WORKSPACE_UI_COMMAND_EVENT = "ui.command.requested";
+export declare const WORKSPACE_UI_RESULT_EVENT = "ui.command.resolved";
+//# sourceMappingURL=workspace-ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-ui.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/workspace-ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,sBAAsB;;;kBAG8C,CAAC;AAElF,wFAAwF;AACxF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqC3B,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAY5E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;2BAKnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAWlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B,yBAAyB,CAAC;AACjE,eAAO,MAAM,yBAAyB,wBAAwB,CAAC"}

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

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { workspaceRelativePathSchema } from './files.js';
+import { workspaceDirectoryNameSchema } from './workspace-directories.js';
+import { isWorkspaceArtifactOutputPath, WORKSPACE_ARTIFACT_KINDS } from './artifacts.js';
+const identity = z.string().min(1).max(256);
+const tab = z.string().min(1).max(2048);
+const loadState = z.enum(['loading', 'ready', 'error']);
+export const workspaceUiRangeSchema = z.object({
+    startLine: z.number().int().positive().max(1_000_000),
+    endLine: z.number().int().positive().max(1_000_000),
+}).strict().refine(value => value.endLine >= value.startLine, 'invalid_ui_range');
+/** Observed browser state, separate from references explicitly selected by the user. */
+export const workspaceUiSnapshotSchema = z.object({
+    version: z.literal(1),
+    viewId: identity,
+    workspaceId: identity,
+    directoryName: workspaceDirectoryNameSchema,
+    sessionId: identity,
+    revision: z.number().int().nonnegative(),
+    observedAt: z.string().datetime(),
+    panelOpen: z.boolean(),
+    activeTab: tab.nullable(),
+    openTabs: z.array(tab).max(32),
+    activeFile: z.object({
+        path: workspaceRelativePathSchema,
+        range: workspaceUiRangeSchema.optional(),
+        dirty: z.boolean(),
+        loadState,
+    }).strict().optional(),
+    activePreview: z.object({
+        artifactId: identity.optional(),
+        versionId: identity.optional(),
+        previewId: identity.optional(),
+        name: z.string().min(1).max(512).optional(),
+        path: workspaceRelativePathSchema.refine(isWorkspaceArtifactOutputPath, 'invalid_preview_output_path').optional(),
+        kind: z.enum(WORKSPACE_ARTIFACT_KINDS).optional(),
+        versionCreatedAt: z.string().datetime().optional(),
+        isCurrentVersion: z.boolean().optional(),
+        loadState,
+        viewport: z.object({
+            width: z.number().int().positive().max(16384),
+            height: z.number().int().positive().max(16384),
+        }).strict().optional(),
+    }).strict().superRefine((value, context) => {
+        const hasVersionDetails = [value.name, value.path, value.kind, value.versionCreatedAt, value.isCurrentVersion]
+            .some(field => field !== undefined);
+        if (hasVersionDetails && (!value.artifactId || !value.versionId))
+            context.addIssue({ code: z.ZodIssueCode.custom, message: 'preview_details_require_version' });
+    }).optional(),
+}).strict();
+const commandScope = {
+    commandId: identity,
+    viewId: identity,
+    workspaceId: identity,
+    directoryName: workspaceDirectoryNameSchema,
+    sessionId: identity,
+    expiresAt: z.string().datetime(),
+};
+// Native event envelopes may add tracing fields; only these validated fields are executable.
+export const workspaceUiCommandSchema = z.discriminatedUnion('kind', [
+    z.object({ ...commandScope, kind: z.literal('open_file'), path: workspaceRelativePathSchema,
+        range: workspaceUiRangeSchema.optional() }),
+    z.object({ ...commandScope, kind: z.literal('open_preview'), artifactId: identity.optional(),
+        versionId: identity.optional(), previewId: identity.optional() }),
+]);
+export const workspaceUiResultSchema = z.object({
+    commandId: identity,
+    viewId: identity,
+    status: z.enum(['opened', 'rejected', 'failed']),
+    reason: z.string().min(1).max(256).optional(),
+    snapshot: workspaceUiSnapshotSchema.optional(),
+}).strict().superRefine((value, context) => {
+    if (value.status === 'opened' && !value.snapshot)
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ['snapshot'], message: 'opened_requires_snapshot' });
+    if (value.snapshot && value.snapshot.viewId !== value.viewId)
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ['snapshot', 'viewId'], message: 'ui_view_mismatch' });
+});
+export const WORKSPACE_UI_COMMAND_EVENT = 'ui.command.requested';
+export const WORKSPACE_UI_RESULT_EVENT = 'ui.command.resolved';
+//# sourceMappingURL=workspace-ui.js.map

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

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

package/dist/database/operators.d.ts

@@ -0,0 +1,2 @@
+export { eq, inArray } from 'drizzle-orm';
+//# sourceMappingURL=operators.d.ts.map

package/dist/database/operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../../src/database/operators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/database/operators.js

@@ -0,0 +1,2 @@
+export { eq, inArray } from 'drizzle-orm';
+//# sourceMappingURL=operators.js.map

package/dist/database/operators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.js","sourceRoot":"","sources":["../../src/database/operators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/database/postgres-adapter.js

@@ -2,7 +2,7 @@
 // 现有 backend 已有自己的数据库初始化逻辑；common 这里提供一个可选 adapter，
 // 方便后续统一数据访问层。
 //
-// Pool 参数对齐 `packages/backend/src/core/database/index.ts`：
+// Pool 参数对齐 `packages/backend-business-server/src/core/database/index.ts`：
 // - keepAlive：阻止云 LB (Load Balancer, 负载均衡) 静默 RST 空闲连接
 // - idleTimeoutMillis：Pool 自身主动回收空闲连接，远短于云 LB idle timeout
 // - statement_timeout / query_timeout：查询兜底，防止请求挂死

package/dist/database/postgres-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"postgres-adapter.js","sourceRoot":"","sources":["../../src/database/postgres-adapter.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,oDAAoD;AACpD,eAAe;AACf,EAAE;AACF,2DAA2D;AAC3D,uDAAuD;AACvD,2DAA2D;AAC3D,kDAAkD;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAO1B,MAAM,UAAU,qBAAqB,CAAC,gBAAwB;IAC5D,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC;QACpB,gBAAgB;QAChB,GAAG,EAAE,EAAE;QACP,iBAAiB,EAAE,MAAM;QACzB,uBAAuB,EAAE,MAAM;QAC/B,SAAS,EAAE,IAAI;QACf,2BAA2B,EAAE,MAAM;QACnC,iBAAiB,EAAE,MAAM;QACzB,aAAa,EAAE,MAAM;KACtB,CAAC,CAAC;IACH,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACtB,CAAC"}
+{"version":3,"file":"postgres-adapter.js","sourceRoot":"","sources":["../../src/database/postgres-adapter.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,oDAAoD;AACpD,eAAe;AACf,EAAE;AACF,2EAA2E;AAC3E,uDAAuD;AACvD,2DAA2D;AAC3D,kDAAkD;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAO1B,MAAM,UAAU,qBAAqB,CAAC,gBAAwB;IAC5D,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC;QACpB,gBAAgB;QAChB,GAAG,EAAE,EAAE;QACP,iBAAiB,EAAE,MAAM;QACzB,uBAAuB,EAAE,MAAM;QAC/B,SAAS,EAAE,IAAI;QACf,2BAA2B,EAAE,MAAM;QACnC,iBAAiB,EAAE,MAAM;QACzB,aAAa,EAAE,MAAM;KACtB,CAAC,CAAC;IACH,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACtB,CAAC"}

package/dist/database/schema.d.ts

@@ -2,7 +2,7 @@
  * SQLite Schema for CLI Offline Mode
  *
  * ⚠️ 重要提示：
- * 此 schema 是 packages/backend/src/core/database/schema.ts（PostgreSQL）的简化版本。
+ * 此 schema 是 packages/backend-business-server/src/core/database/schema.ts（PostgreSQL）的简化版本。
  * 主要字段需要与 backend schema 保持同步，以确保项目导入/导出的兼容性。
  *
  * 主要差异：

package/dist/database/schema.js

@@ -3,7 +3,7 @@ import { sqliteTable, text, integer } from 'drizzle-orm/sqlite-core';
  * SQLite Schema for CLI Offline Mode
  *
  * ⚠️ 重要提示：
- * 此 schema 是 packages/backend/src/core/database/schema.ts（PostgreSQL）的简化版本。
+ * 此 schema 是 packages/backend-business-server/src/core/database/schema.ts（PostgreSQL）的简化版本。
  * 主要字段需要与 backend schema 保持同步，以确保项目导入/导出的兼容性。
  *
  * 主要差异：

package/dist/model-proxy/index.d.ts

@@ -0,0 +1,26 @@
+/** Values accepted by the internal model transport; executable code never crosses it. */
+export type ModelWireValue = null | boolean | number | string | ModelWireValue[] | {
+    [key: string]: ModelWireValue;
+};
+type WireHooks = {
+    callback?: (fn: (...args: unknown[]) => unknown) => string;
+    onCallback?: (id: string, args: unknown[]) => unknown;
+    signal?: AbortSignal;
+    onSignal?: (signal: AbortSignal) => void;
+};
+export declare function encodeModelValue(value: unknown, hooks?: WireHooks): ModelWireValue;
+export declare function decodeModelValue(value: ModelWireValue, hooks?: WireHooks): unknown;
+export type ModelOperationEvent = {
+    type: 'callback';
+    id: string;
+    args: ModelWireValue;
+} | {
+    type: 'result';
+    value: ModelWireValue;
+} | {
+    type: 'error';
+    status: number;
+    code: string;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/model-proxy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model-proxy/index.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,cAAc,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;CAAE,CAAC;AACrH,KAAK,SAAS,GAAG;IACf,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,KAAK,MAAM,CAAC;IAC3D,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACtD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CAC1C,CAAC;AAGF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,GAAE,SAAc,GAAG,cAAc,CA6BtF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,GAAE,SAAc,GAAG,OAAO,CA6BtF;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC"}