@playcraft/common 0.1.39-prod → 0.1.40-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-notifications.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { type PublicEvent } from './events.js';
+export type WorkspaceRefreshScope = 'state' | 'content' | 'preview' | 'artifact';
+export declare const WORKSPACE_NOTIFICATION_BATCH_SIZE = 128;
+export declare const workspaceNotificationPayloadSchema: z.ZodObject<{
+    scopes: z.ZodArray<z.ZodEnum<{
+        preview: "preview";
+        content: "content";
+        state: "state";
+        artifact: "artifact";
+    }>>;
+    chatSessionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        streamKind: z.ZodEnum<{
+            session: "session";
+            runtime: "runtime";
+            workspace: "workspace";
+        }>;
+        streamId: z.ZodString;
+        sequence: z.ZodNumber;
+        type: z.ZodString;
+        payload: z.ZodUnknown;
+        occurredAt: z.ZodString;
+        source: z.ZodOptional<z.ZodObject<{
+            runtimeId: z.ZodString;
+            generation: z.ZodNumber;
+            runtimeEpoch: z.ZodNumber;
+            sourceSequence: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type WorkspaceNotificationPayload = z.infer<typeof workspaceNotificationPayloadSchema>;
+/** Panels react to invalidations; conversation text and command output stay in the chat stream. */
+export declare function workspaceEventRefreshScope(event: Pick<PublicEvent, 'type' | 'payload'>): WorkspaceRefreshScope | 'none';
+/** A batch advances past every source event, including chat-only or other-directory changes. */
+export declare function workspaceEventNotification(workspaceId: string, events: PublicEvent[], directoryName: string, sessionDirectory: (sessionId: string) => string | undefined): PublicEvent | undefined;
+//# sourceMappingURL=workspace-notifications.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-notifications.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/workspace-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAGlE,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AACjF,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAErD,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKpC,CAAC;AACZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAY9F,mGAAmG;AACnG,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,qBAAqB,GAAG,MAAM,CAOvH;AAED,gGAAgG;AAChG,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EAAE,EACrB,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAC1D,WAAW,GAAG,SAAS,CA8BzB"}

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

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import { publicEventSchema } from './events.js';
+import { workspaceUiCommandSchema } from './workspace-ui.js';
+export const WORKSPACE_NOTIFICATION_BATCH_SIZE = 128;
+const CONTROL_EVENTS = new Set(['ui.command.requested', 'ui.command.resolved', 'batch.created']);
+export const workspaceNotificationPayloadSchema = z.object({
+    scopes: z.array(z.enum(['state', 'content', 'preview', 'artifact'])).max(4),
+    chatSessionIds: z.array(z.string().min(1).max(128)).max(WORKSPACE_NOTIFICATION_BATCH_SIZE).optional(),
+    events: z.array(publicEventSchema.refine(event => CONTROL_EVENTS.has(event.type)))
+        .max(WORKSPACE_NOTIFICATION_BATCH_SIZE).optional(),
+}).strict();
+const NO_REFRESH = new Set([
+    'message.delta', 'item/agentMessage/delta', 'item/commandExecution/outputDelta',
+    'item/commandExecution/terminalInteraction', 'item/started', 'thread/tokenUsage/updated',
+    'warning', 'ui.command.requested', 'ui.command.resolved',
+]);
+const STATE_REFRESH = new Set([
+    'session.created', 'thread/started', 'thread/status/changed', 'turn/started', 'error', 'terminal.created',
+]);
+const CONVERSATION_ITEMS = new Set(['agentMessage', 'reasoning', 'userMessage', 'imageView']);
+/** Panels react to invalidations; conversation text and command output stay in the chat stream. */
+export function workspaceEventRefreshScope(event) {
+    if (NO_REFRESH.has(event.type))
+        return 'none';
+    if (STATE_REFRESH.has(event.type))
+        return 'state';
+    if (event.type === 'preview.published' || event.type === 'preview.failed')
+        return 'preview';
+    if (['artifact.created', 'artifact.updated', 'artifact.removed'].includes(event.type))
+        return 'artifact';
+    if (event.type === 'item/completed' && CONVERSATION_ITEMS.has(String(record(record(event.payload).item).type)))
+        return 'none';
+    return 'content';
+}
+/** A batch advances past every source event, including chat-only or other-directory changes. */
+export function workspaceEventNotification(workspaceId, events, directoryName, sessionDirectory) {
+    const last = events.at(-1);
+    if (!last)
+        return undefined;
+    const scopes = new Set();
+    const chatSessionIds = new Set();
+    const controls = [];
+    for (const event of events) {
+        const payload = record(event.payload);
+        const directory = typeof payload.directoryName === 'string' ? payload.directoryName
+            : typeof payload.sessionId === 'string' ? sessionDirectory(payload.sessionId) : undefined;
+        if (directory !== undefined && directory !== directoryName)
+            continue;
+        if (typeof payload.sessionId === 'string' && payload.sessionId.length > 0 && payload.sessionId.length <= 128 &&
+            chatSessionIds.size < WORKSPACE_NOTIFICATION_BATCH_SIZE)
+            chatSessionIds.add(payload.sessionId);
+        const control = controlPayload(event.type, payload);
+        if (control)
+            controls.push({
+                streamKind: 'workspace', streamId: workspaceId, sequence: event.sequence,
+                type: event.type, payload: control, occurredAt: event.occurredAt,
+            });
+        const scope = workspaceEventRefreshScope(event);
+        if (scope !== 'none')
+            scopes.add(scope);
+    }
+    return {
+        streamKind: 'workspace', streamId: workspaceId, sequence: last.sequence,
+        type: 'workspace.notifications', payload: {
+            scopes: [...scopes],
+            ...(chatSessionIds.size ? { chatSessionIds: [...chatSessionIds] } : {}),
+            ...(controls.length ? { events: controls } : {}),
+        },
+        occurredAt: last.occurredAt,
+    };
+}
+function controlPayload(type, payload) {
+    if (type === 'ui.command.requested') {
+        const parsed = workspaceUiCommandSchema.safeParse(payload);
+        return parsed.success ? parsed.data : undefined;
+    }
+    if (type === 'ui.command.resolved' && typeof payload.commandId === 'string' &&
+        payload.commandId.length <= 256 && typeof payload.viewId === 'string' && payload.viewId.length <= 256) {
+        return { commandId: payload.commandId, viewId: payload.viewId };
+    }
+    if (type === 'batch.created' && typeof payload.batchId === 'string' && payload.batchId.length <= 256) {
+        return { batchId: payload.batchId };
+    }
+    return undefined;
+}
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value : {};
+}
+//# sourceMappingURL=workspace-notifications.js.map

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

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

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"}