@playcraft/common 0.1.54 → 0.1.55-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";
+        ready: "ready";
+        reclaimed: "reclaimed";
+        failed: "failed";
+    }>>;
+}, 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<{
+            reclaimed: "reclaimed";
+            present: "present";
+            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-models.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Workspace model catalog shared by Runtime (model selection) and Model Proxy (provider failover).
+ *
+ * A workspace offers models, not provider configurations: configurations whose model names
+ * match after normalization are one model. The first configuration of a model is the provider a
+ * session starts on; the rest are the order Model Proxy fails over to.
+ */
+export declare const WORKSPACE_MODELS_SQL = "SELECT c.id AS \"configId\",c.model,c.provider,coalesce(c.is_default,false) AS \"isDefault\",\n    c.reasoning_efforts AS \"reasoningEfforts\"\n  FROM cloud_workspaces w\n  JOIN \"user\" u ON u.id=w.user_id AND u.account_status='active'\n  LEFT JOIN projects p ON p.id=w.project_id\n  JOIN ai_provider_configs c ON c.is_enabled=true AND c.model_kind='llm'\n    AND nullif(btrim(c.api_key),'') IS NOT NULL\n    AND ((c.user_id=u.id AND c.team_id IS NULL)\n      OR (c.user_id IS NULL AND c.team_id IS NULL)\n      OR (c.user_id IS NULL AND c.team_id=p.team_id AND EXISTS (\n        SELECT 1 FROM member m WHERE m.\"userId\"=u.id AND m.\"organizationId\"=c.team_id)))\n  WHERE w.id=$1 AND w.environment=$2 AND w.user_id=$3 AND w.status='active'\n    AND NOT EXISTS (SELECT 1 FROM user_blacklist b WHERE\n      (b.match_type='email' AND lower(trim(b.match_value))=lower(trim(u.email)))\n      OR (b.match_type='name' AND lower(trim(b.match_value))=lower(trim(u.name)))\n      OR (b.match_type='email_domain' AND right(lower(trim(u.email)),length(regexp_replace(lower(trim(b.match_value)),'^@',''))+1)='@'||regexp_replace(lower(trim(b.match_value)),'^@','')))\n  ORDER BY c.is_default DESC NULLS LAST,c.created_at,c.id";
+/** Provider prefixes such as `openai/` name the route, not the model. */
+export declare function normalizeModelName(model: string): string;
+/** The model name shown to people: the configured spelling without a provider prefix. */
+export declare function modelDisplayName(model: string): string;
+type WorkspaceModelRow = {
+    model: string;
+    provider: string;
+    isDefault: boolean;
+};
+export type WorkspaceModelGroup<T extends WorkspaceModelRow> = {
+    /** Display name shared by every member. */
+    name: string;
+    /** Members in failover order; the first is the model's default provider. */
+    members: T[];
+};
+/**
+ * Groups catalog rows by normalized model name. Within a model the default configuration leads,
+ * then providers keep the order the provider-grouped picker showed them in: a default's provider
+ * first, every other provider by its first row in the whole catalog.
+ */
+export declare function groupWorkspaceModels<T extends WorkspaceModelRow>(rows: readonly T[]): WorkspaceModelGroup<T>[];
+export {};
+//# sourceMappingURL=workspace-models.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-models.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/workspace-models.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,eAAO,MAAM,oBAAoB,msCAgByB,CAAC;AAE3D,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,KAAK,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAEjF,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,iBAAiB,IAAI;IAC7D,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,OAAO,EAAE,CAAC,EAAE,CAAC;CACd,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,iBAAiB,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAkB9G"}

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

@@ -0,0 +1,63 @@
+/**
+ * Workspace model catalog shared by Runtime (model selection) and Model Proxy (provider failover).
+ *
+ * A workspace offers models, not provider configurations: configurations whose model names
+ * match after normalization are one model. The first configuration of a model is the provider a
+ * session starts on; the rest are the order Model Proxy fails over to.
+ */
+// Never select credential columns: this catalog also reaches browser model selection.
+export const WORKSPACE_MODELS_SQL = `SELECT c.id AS "configId",c.model,c.provider,coalesce(c.is_default,false) AS "isDefault",
+    c.reasoning_efforts AS "reasoningEfforts"
+  FROM cloud_workspaces w
+  JOIN "user" u ON u.id=w.user_id AND u.account_status='active'
+  LEFT JOIN projects p ON p.id=w.project_id
+  JOIN ai_provider_configs c ON c.is_enabled=true AND c.model_kind='llm'
+    AND nullif(btrim(c.api_key),'') IS NOT NULL
+    AND ((c.user_id=u.id AND c.team_id IS NULL)
+      OR (c.user_id IS NULL AND c.team_id IS NULL)
+      OR (c.user_id IS NULL AND c.team_id=p.team_id AND EXISTS (
+        SELECT 1 FROM member m WHERE m."userId"=u.id AND m."organizationId"=c.team_id)))
+  WHERE w.id=$1 AND w.environment=$2 AND w.user_id=$3 AND w.status='active'
+    AND NOT EXISTS (SELECT 1 FROM user_blacklist b WHERE
+      (b.match_type='email' AND lower(trim(b.match_value))=lower(trim(u.email)))
+      OR (b.match_type='name' AND lower(trim(b.match_value))=lower(trim(u.name)))
+      OR (b.match_type='email_domain' AND right(lower(trim(u.email)),length(regexp_replace(lower(trim(b.match_value)),'^@',''))+1)='@'||regexp_replace(lower(trim(b.match_value)),'^@','')))
+  ORDER BY c.is_default DESC NULLS LAST,c.created_at,c.id`;
+/** Provider prefixes such as `openai/` name the route, not the model. */
+export function normalizeModelName(model) {
+    const name = model.trim().toLowerCase();
+    return name.slice(name.lastIndexOf('/') + 1);
+}
+/** The model name shown to people: the configured spelling without a provider prefix. */
+export function modelDisplayName(model) {
+    const name = model.trim();
+    return name.slice(name.lastIndexOf('/') + 1);
+}
+/**
+ * Groups catalog rows by normalized model name. Within a model the default configuration leads,
+ * then providers keep the order the provider-grouped picker showed them in: a default's provider
+ * first, every other provider by its first row in the whole catalog.
+ */
+export function groupWorkspaceModels(rows) {
+    const providerRank = new Map();
+    for (const row of [...rows.filter(item => item.isDefault), ...rows]) {
+        if (!providerRank.has(row.provider))
+            providerRank.set(row.provider, providerRank.size);
+    }
+    const groups = new Map();
+    for (const row of rows) {
+        const key = normalizeModelName(row.model);
+        const group = groups.get(key);
+        if (group)
+            group.members.push(row);
+        else
+            groups.set(key, { name: modelDisplayName(row.model), members: [row] });
+    }
+    // Array sort is stable: one provider's configurations keep their catalog order.
+    for (const group of groups.values()) {
+        group.members.sort((a, b) => Number(b.isDefault) - Number(a.isDefault)
+            || providerRank.get(a.provider) - providerRank.get(b.provider));
+    }
+    return [...groups.values()];
+}
+//# sourceMappingURL=workspace-models.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-models.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/workspace-models.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sFAAsF;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;0DAgBsB,CAAC;AAE3D,yEAAyE;AACzE,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC;AAWD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAA8B,IAAkB;IAClF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkC,CAAC;IACzD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK;YAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;;YAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,gFAAgF;IAChF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;eACjE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAE,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9B,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<{
+        content: "content";
+        state: "state";
+        preview: "preview";
+        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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"}