@kortix/ui 0.14.6 → 0.14.7

package/dist/customize/sections/view/secrets-view.js

@@ -14,6 +14,7 @@ import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigge
 import { Field, FieldDescription, FieldLabel } from '../../../primitives/field.js';
 import Hint from '../../../primitives/hint.js';
 import { HoverCard, HoverCardContent, HoverCardTrigger } from '../../../primitives/hover-card.js';
+import { Alert, AlertDescription, AlertTitle } from '../../../primitives/alert.js';
 import { InfoBanner } from '../../../primitives/info-banner.js';
 import { Input } from '../../../primitives/input.js';
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupSearch, InputGroupSearchClear, InputGroupSearchIcon, InputGroupSearchInput, } from '../../../primitives/input-group.js';
@@ -666,7 +667,7 @@ function SecretDialog({ open, onOpenChange, projectId, row, connectors, connecto
                     /* Read-only, because another flow assigned it. Same treatment
                        the git-connection secret always had, now covering the LLM
                        gateway and connector rows it was always true of. */
-                    _jsxs("div", { id: "secret-dialog-delivery", className: "border-border bg-sidebar rounded-md border p-3", children: [_jsx(Badge, { variant: selectedDelivery.tone, size: "sm", children: selectedDelivery.label }), _jsxs("p", { className: "text-muted-foreground mt-2 text-xs text-pretty", children: [selectedDelivery.description, " ", tI18nComplete.raw('text5740535823f9')] })] })) : (_jsxs(Select, { value: exposure, onValueChange: (next) => setPickedExposure(next), disabled: save.isPending, children: [_jsx(SelectTrigger, { id: "secret-dialog-delivery", className: "min-h-10 w-full", children: _jsx(SelectValue, {}) }), _jsx(SelectContent, { children: exposureOptions.map((option) => (_jsx(SelectItem, { value: option.exposure, description: option.description, children: option.label }, option.exposure))) })] })), !usageAssigned && (_jsx(FieldDescription, { children: selectedDelivery.description }))] }), strategy === 'runtime' && (_jsx(InfoBanner, { tone: "warning", title: tI18nComplete.raw('text4fb8319405f3'), children: tI18nComplete.raw('textdb71b63b5778') })), grantNotice && (_jsxs(InfoBanner, { tone: "warning", icon: _jsx(DangerTriangleSolid, { weight: "fill" }), title: grantNotice.title, className: "[&_[data-slot=alert-content]]:min-w-0", children: [_jsx("span", { className: "block text-pretty", children: grantNotice.body }), grantPlan.candidates.length > 0 && (_jsxs("div", { className: "mt-3 flex flex-wrap items-center gap-2", children: [grantPlan.candidates.length > 1 && (_jsxs(Select, { value: selectedGrantAgent ?? '', onValueChange: setGrantAgent, disabled: grant.isPending, children: [_jsx(SelectTrigger, { "aria-label": tI18nComplete.raw('text33e745179bcb'), className: "h-8 w-48", children: _jsx(SelectValue, { placeholder: tI18nComplete.raw('textb6890bc23a9c') }) }), _jsx(SelectContent, { children: grantPlan.candidates.map((candidate) => (_jsx(SelectItem, { value: candidate.name, description: agentGrantCandidateHint(candidate) ?? undefined, children: candidate.name }, candidate.name))) })] })), _jsxs(Button, { type: "button", size: "sm", onClick: startGrant, disabled: !selectedGrantAgent || grant.isPending, children: [grant.isPending ? _jsx(Loading, { className: "size-3.5 shrink-0" }) : null, agentGrantActionLabel(grantPlan, selectedGrantAgent)] })] })), grantPlan.candidates.length === 0 && (_jsx("span", { className: "text-muted-foreground mt-2 block text-xs text-pretty", children: tI18nComplete.raw('textf23c70160b5b') })), selectedGrantHint && (_jsx("span", { className: "text-muted-foreground mt-2 block text-xs text-pretty", children: selectedGrantHint })), grant.error && (_jsx("span", { className: "text-kortix-red mt-2 block text-xs text-pretty", children: agentGrantErrorMessage(grant.error) })), _jsx("pre", { className: "border-border bg-muted mt-2 overflow-x-auto rounded-sm border p-2 font-mono text-xs leading-relaxed", children: grantManifest })] })), needsHosts && (_jsxs("div", { className: "border-border bg-sidebar space-y-4 rounded-md border p-3", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium", children: tI18nComplete.raw('textd3297c00f7a2') }), _jsx("p", { className: "text-muted-foreground text-xs text-pretty", children: tI18nComplete.raw('text76f48924ee10') })] }), _jsxs(InfoBanner, { tone: "neutral", title: echoNotice.title, className: "[&_[data-slot=alert-content]]:min-w-0", children: [_jsx("span", { className: "block text-pretty", children: echoNotice.body }), _jsx("pre", { className: "border-border bg-muted mt-2 overflow-x-auto rounded-sm border p-2 font-mono text-xs leading-relaxed", children: echoNotice.probe }), _jsx(Link, { href: echoNotice.docsHref, target: "_blank", rel: "noreferrer", className: "text-muted-foreground hover:text-foreground mt-2 inline-block text-xs underline underline-offset-2", children: echoNotice.docsLabel })] }), _jsxs(Field, { children: [_jsx(FieldLabel, { htmlFor: "secret-dialog-hosts", children: tI18nComplete.raw('textbba9af131107') }), _jsx(Textarea, { id: "secret-dialog-hosts", value: hosts, onChange: (event) => setEditedHosts(event.target.value), placeholder: tI18nComplete.raw('text07de8e6e567f'), minHeight: 56, maxHeight: 112, variant: "outline", className: "font-mono text-xs", disabled: save.isPending }), _jsx(FieldDescription, { children: tI18nComplete.raw('text80befc2e0620') })] }), legacyDetail && (_jsxs("div", { className: "border-border bg-popover space-y-2 rounded-md border p-3", children: [_jsx("p", { className: "text-sm font-medium", children: legacyDetail.title }), _jsx("p", { className: "text-muted-foreground text-xs text-pretty", children: legacyDetail.body }), _jsx("dl", { className: "text-muted-foreground space-y-0.5 font-mono text-xs", children: legacyDetail.lines.map((line) => (_jsx("dd", { children: line }, line))) }), _jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => setLegacyInject(null), disabled: save.isPending, children: tI18nComplete.raw('text4a72652fb7e7') })] }))] })), row?.consumer === 'connector' && (_jsx("div", { className: "border-border bg-sidebar space-y-4 rounded-md border p-3", children: _jsxs(Field, { children: [_jsx(FieldLabel, { children: tI18nComplete.raw('textc3d2e79ebdd0') }), connectorsLoading ? (_jsxs("div", { className: "space-y-2", children: [_jsx(Skeleton, { className: "h-12 rounded-md" }), _jsx(Skeleton, { className: "h-12 rounded-md" })] })) : connectorOptions.length === 0 ? (_jsx(InfoBanner, { tone: "neutral", title: tI18nComplete.raw('text10798ef769fd'), children: tI18nComplete.raw('text0b834e60371f') })) : (_jsx("div", { className: "bg-popover overflow-hidden rounded-md border", children: connectorOptions.map((option, index) => (_jsxs("label", { className: cn('flex min-h-12 items-center gap-3 px-3 py-2', index > 0 && 'border-t', option.disabled ? 'cursor-not-allowed opacity-60' : 'cursor-pointer'), children: [_jsx(Checkbox, { checked: effectiveSelectedConnectorSlugSet.has(option.slug), disabled: option.disabled || save.isPending, onCheckedChange: (checked) => {
+                    _jsxs("div", { id: "secret-dialog-delivery", className: "border-border bg-sidebar rounded-md border p-3", children: [_jsx(Badge, { variant: selectedDelivery.tone, size: "sm", children: selectedDelivery.label }), _jsxs("p", { className: "text-muted-foreground mt-2 text-xs text-pretty", children: [selectedDelivery.description, " ", tI18nComplete.raw('text5740535823f9')] })] })) : (_jsxs(Select, { value: exposure, onValueChange: (next) => setPickedExposure(next), disabled: save.isPending, children: [_jsx(SelectTrigger, { id: "secret-dialog-delivery", className: "min-h-10 w-full", children: _jsx(SelectValue, {}) }), _jsx(SelectContent, { children: exposureOptions.map((option) => (_jsx(SelectItem, { value: option.exposure, description: option.description, children: option.label }, option.exposure))) })] })), !usageAssigned && (_jsx(FieldDescription, { children: selectedDelivery.description }))] }), strategy === 'runtime' && (_jsxs(Alert, { variant: "warning", children: [_jsx(AlertTitle, { children: tI18nComplete.raw('text4fb8319405f3') }), _jsx(AlertDescription, { children: tI18nComplete.raw('textdb71b63b5778') })] })), grantNotice && (_jsxs(InfoBanner, { tone: "warning", icon: _jsx(DangerTriangleSolid, { weight: "fill" }), title: grantNotice.title, className: "[&_[data-slot=alert-content]]:min-w-0", children: [_jsx("span", { className: "block text-pretty", children: grantNotice.body }), grantPlan.candidates.length > 0 && (_jsxs("div", { className: "mt-3 flex flex-wrap items-center gap-2", children: [grantPlan.candidates.length > 1 && (_jsxs(Select, { value: selectedGrantAgent ?? '', onValueChange: setGrantAgent, disabled: grant.isPending, children: [_jsx(SelectTrigger, { "aria-label": tI18nComplete.raw('text33e745179bcb'), className: "h-8 w-48", children: _jsx(SelectValue, { placeholder: tI18nComplete.raw('textb6890bc23a9c') }) }), _jsx(SelectContent, { children: grantPlan.candidates.map((candidate) => (_jsx(SelectItem, { value: candidate.name, description: agentGrantCandidateHint(candidate) ?? undefined, children: candidate.name }, candidate.name))) })] })), _jsxs(Button, { type: "button", size: "sm", onClick: startGrant, disabled: !selectedGrantAgent || grant.isPending, children: [grant.isPending ? _jsx(Loading, { className: "size-3.5 shrink-0" }) : null, agentGrantActionLabel(grantPlan, selectedGrantAgent)] })] })), grantPlan.candidates.length === 0 && (_jsx("span", { className: "text-muted-foreground mt-2 block text-xs text-pretty", children: tI18nComplete.raw('textf23c70160b5b') })), selectedGrantHint && (_jsx("span", { className: "text-muted-foreground mt-2 block text-xs text-pretty", children: selectedGrantHint })), grant.error && (_jsx("span", { className: "text-kortix-red mt-2 block text-xs text-pretty", children: agentGrantErrorMessage(grant.error) })), _jsx("pre", { className: "border-border bg-muted mt-2 overflow-x-auto rounded-sm border p-2 font-mono text-xs leading-relaxed", children: grantManifest })] })), needsHosts && (_jsxs("div", { className: "border-border bg-sidebar space-y-4 rounded-md border p-3", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium", children: tI18nComplete.raw('textd3297c00f7a2') }), _jsx("p", { className: "text-muted-foreground text-xs text-pretty", children: tI18nComplete.raw('text76f48924ee10') })] }), _jsxs(InfoBanner, { tone: "neutral", title: echoNotice.title, className: "[&_[data-slot=alert-content]]:min-w-0", children: [_jsx("span", { className: "block text-pretty", children: echoNotice.body }), _jsx("pre", { className: "border-border bg-muted mt-2 overflow-x-auto rounded-sm border p-2 font-mono text-xs leading-relaxed", children: echoNotice.probe }), _jsx(Link, { href: echoNotice.docsHref, target: "_blank", rel: "noreferrer", className: "text-muted-foreground hover:text-foreground mt-2 inline-block text-xs underline underline-offset-2", children: echoNotice.docsLabel })] }), _jsxs(Field, { children: [_jsx(FieldLabel, { htmlFor: "secret-dialog-hosts", children: tI18nComplete.raw('textbba9af131107') }), _jsx(Textarea, { id: "secret-dialog-hosts", value: hosts, onChange: (event) => setEditedHosts(event.target.value), placeholder: tI18nComplete.raw('text07de8e6e567f'), minHeight: 56, maxHeight: 112, variant: "outline", className: "font-mono text-xs", disabled: save.isPending }), _jsx(FieldDescription, { children: tI18nComplete.raw('text80befc2e0620') })] }), legacyDetail && (_jsxs("div", { className: "border-border bg-popover space-y-2 rounded-md border p-3", children: [_jsx("p", { className: "text-sm font-medium", children: legacyDetail.title }), _jsx("p", { className: "text-muted-foreground text-xs text-pretty", children: legacyDetail.body }), _jsx("dl", { className: "text-muted-foreground space-y-0.5 font-mono text-xs", children: legacyDetail.lines.map((line) => (_jsx("dd", { children: line }, line))) }), _jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => setLegacyInject(null), disabled: save.isPending, children: tI18nComplete.raw('text4a72652fb7e7') })] }))] })), row?.consumer === 'connector' && (_jsx("div", { className: "border-border bg-sidebar space-y-4 rounded-md border p-3", children: _jsxs(Field, { children: [_jsx(FieldLabel, { children: tI18nComplete.raw('textc3d2e79ebdd0') }), connectorsLoading ? (_jsxs("div", { className: "space-y-2", children: [_jsx(Skeleton, { className: "h-12 rounded-md" }), _jsx(Skeleton, { className: "h-12 rounded-md" })] })) : connectorOptions.length === 0 ? (_jsx(InfoBanner, { tone: "neutral", title: tI18nComplete.raw('text10798ef769fd'), children: tI18nComplete.raw('text0b834e60371f') })) : (_jsx("div", { className: "bg-popover overflow-hidden rounded-md border", children: connectorOptions.map((option, index) => (_jsxs("label", { className: cn('flex min-h-12 items-center gap-3 px-3 py-2', index > 0 && 'border-t', option.disabled ? 'cursor-not-allowed opacity-60' : 'cursor-pointer'), children: [_jsx(Checkbox, { checked: effectiveSelectedConnectorSlugSet.has(option.slug), disabled: option.disabled || save.isPending, onCheckedChange: (checked) => {
                                             setSelectedConnectorSlugs((current) => checked
                                                 ? [
                                                     ...new Set([

package/dist/customize/settings/tabs/general-tab.d.ts

@@ -34,7 +34,7 @@ export interface GeneralTabViewProps {
      *  `useQuery`/mutations, so it can't render under `renderToStaticMarkup`
      *  with no providers. */
     /** Whether the Delete-workspace section shows at all — gated on
-     *  `project.delete`, NOT the broader `project.write` gate
+     *  `project.delete`, NOT the broader `project.settings.write` gate
      *  `generalFieldsSlot`'s fields use. Deleting and editing are separate
      *  permissions, so a custom role can grant one without the other. */
     canDelete?: boolean;
@@ -44,6 +44,13 @@ export interface GeneralTabViewProps {
     onCloseArchiveDialog?: () => void;
     onConfirmArchive?: () => void;
     isArchivePending?: boolean;
+    /** `TransferWorkspaceEntry` — the second danger-zone row and its dialog.
+     *  A slot for the same reason the others are: the dialog owns its own
+     *  accounts query and mutation, so it cannot render under
+     *  `renderToStaticMarkup` with no providers. Shares the Delete section's
+     *  `canDelete` gate — the API's source gate for a transfer is the same
+     *  destructive tier that gates delete. */
+    transferSlot?: ReactNode;
 }
 export interface GeneralTabCopy {
     loadFailed: string;
@@ -64,7 +71,7 @@ export interface GeneralTabCopy {
  *  `ProfileTabView`/`ConnectedAccountsTabView` for the same split. Every
  *  prop is optional with a safe default so the bare `<GeneralTabView />`
  *  the test file renders shows the Delete-workspace section fully formed. */
-export declare function GeneralTabView({ copy, isLoading, isError, errorMessage, onRetry, generalFieldsSlot, canDelete, workspaceName, archiveOpen, onOpenArchiveDialog, onCloseArchiveDialog, onConfirmArchive, isArchivePending, }: GeneralTabViewProps): import("react").JSX.Element;
+export declare function GeneralTabView({ copy, isLoading, isError, errorMessage, onRetry, generalFieldsSlot, canDelete, workspaceName, archiveOpen, onOpenArchiveDialog, onCloseArchiveDialog, onConfirmArchive, isArchivePending, transferSlot, }: GeneralTabViewProps): import("react").JSX.Element;
 export interface RunProjectArchiveClient {
     archiveProject: (projectId: string) => Promise<unknown>;
 }

package/dist/customize/settings/tabs/general-tab.js

@@ -3,6 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { useEffect, useRef, useState } from 'react';
 import { Button } from '../../../primitives/button.js';
 import { Input } from '../../../primitives/input.js';
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '../../../primitives/select.js';
 import { SettingsRow, SettingsRowGroup } from '../../../primitives/settings-row.js';
 import { SettingsSubsectionHeader } from '../../../primitives/settings-subsection-header.js';
 import { Skeleton } from '../../../primitives/skeleton.js';
@@ -19,17 +20,30 @@ import { forgetLastProjectId } from '../../../internal/lib/onboarding/last-proje
 import { PROJECT_ACTIONS } from '../../../internal/lib/project-actions.js';
 import { useProjectCans } from '../../../internal/lib/use-project-can.js';
 import { useSettingsPanelStore } from '../../../internal/stores/settings-panel-store.js';
-import { archiveProject, getProject, updateProject, } from '@kortix/sdk';
+import { TransferWorkspaceEntry } from './transfer-workspace-dialog.js';
+import { archiveProject, getProject, setDefaultReasoningEffort, updateProject, } from '@kortix/sdk';
 import { contract, invalidateProjectIdentity, qk } from '@kortix/sdk/react';
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
 import { useUiRouter, useUiViewerId } from '../../../providers/ui-provider.js';
 import { SettingsTabHeader } from '../settings-tab-header.js';
-/** Asked for in ONE batched probe. `project.delete` and `project.write` are
+/** Asked for in ONE batched probe. `project.delete` and `project.settings.write` are
  *  separate permissions — see `ProjectSettingsGeneralProps.canDelete`. */
 const GENERAL_TAB_ACTIONS = [
-    PROJECT_ACTIONS.PROJECT_WRITE,
+    PROJECT_ACTIONS.PROJECT_SETTINGS_WRITE,
     PROJECT_ACTIONS.PROJECT_DELETE,
 ];
+/** The effort ladder the default-effort picker offers. These are models.dev
+ *  variant ids — technical values, shown capitalized like the composer's
+ *  own effort selector does (its `label`), never translated.
+ *
+ *  The API clamps the stored default at delivery to what the session's model
+ *  actually publishes (`effortVariantForPrompt`), so a pick the session's
+ *  model does not carry degrades to Automatic rather than breaking the turn;
+ *  the picker still offers the superset the catalog carries. */
+const DEFAULT_EFFORT_OPTIONS = ['none', 'low', 'medium', 'high', 'xhigh', 'max'];
+const DEFAULT_EFFORT_AUTOMATIC = '';
+/** `medium` → `Medium` — same casing rule as the composer's effort selector. */
+const effortOptionLabel = (value) => value.charAt(0).toUpperCase() + value.slice(1);
 export const DELETE_WORKSPACE_CONSEQUENCES = [
     'Every session in this workspace, with its files, history, and outputs',
     'All scheduled runs and triggers — they stop firing straight away',
@@ -61,8 +75,8 @@ const DEFAULT_GENERAL_COPY = {
  *  `ProfileTabView`/`ConnectedAccountsTabView` for the same split. Every
  *  prop is optional with a safe default so the bare `<GeneralTabView />`
  *  the test file renders shows the Delete-workspace section fully formed. */
-export function GeneralTabView({ copy = DEFAULT_GENERAL_COPY, isLoading = false, isError = false, errorMessage = '', onRetry = () => { }, generalFieldsSlot, canDelete = true, workspaceName = '', archiveOpen = false, onOpenArchiveDialog = () => { }, onCloseArchiveDialog = () => { }, onConfirmArchive = () => { }, isArchivePending = false, }) {
-    return (_jsxs("div", { className: "mx-auto w-full max-w-2xl space-y-8", children: [_jsx(SettingsTabHeader, { tab: "general" }), isLoading ? (_jsxs("div", { className: "space-y-5", children: [_jsx(Skeleton, { className: "h-40 rounded-md" }), _jsx(Skeleton, { className: "h-20 rounded-md" })] })) : isError ? (_jsx(ErrorState, { size: "sm", title: copy.loadFailed, description: errorMessage, action: _jsx(Button, { variant: "outline", size: "sm", onClick: onRetry, children: copy.retry }) })) : (_jsxs(_Fragment, { children: [generalFieldsSlot, canDelete ? (_jsxs("section", { className: "space-y-3", children: [_jsx(SettingsSubsectionHeader, { title: copy.dangerZone }), _jsx(SettingsRowGroup, { children: _jsx(SettingsRow, { label: copy.deleteWorkspace, description: copy.deleteDescription, children: _jsx(Button, { variant: "ghost", size: "sm", className: "text-destructive hover:bg-destructive/10 hover:text-destructive", onClick: onOpenArchiveDialog, children: copy.deleteWorkspace }) }) })] })) : null] })), _jsx(TypeToConfirmDialog, { open: archiveOpen, onOpenChange: (open) => {
+export function GeneralTabView({ copy = DEFAULT_GENERAL_COPY, isLoading = false, isError = false, errorMessage = '', onRetry = () => { }, generalFieldsSlot, canDelete = true, workspaceName = '', archiveOpen = false, onOpenArchiveDialog = () => { }, onCloseArchiveDialog = () => { }, onConfirmArchive = () => { }, isArchivePending = false, transferSlot, }) {
+    return (_jsxs("div", { className: "mx-auto w-full max-w-2xl space-y-8", children: [_jsx(SettingsTabHeader, { tab: "general" }), isLoading ? (_jsxs("div", { className: "space-y-5", children: [_jsx(Skeleton, { className: "h-40 rounded-md" }), _jsx(Skeleton, { className: "h-20 rounded-md" })] })) : isError ? (_jsx(ErrorState, { size: "sm", title: copy.loadFailed, description: errorMessage, action: _jsx(Button, { variant: "outline", size: "sm", onClick: onRetry, children: copy.retry }) })) : (_jsxs(_Fragment, { children: [generalFieldsSlot, canDelete ? (_jsxs("section", { className: "space-y-3", children: [_jsx(SettingsSubsectionHeader, { title: copy.dangerZone }), _jsxs(SettingsRowGroup, { children: [_jsx(SettingsRow, { label: copy.deleteWorkspace, description: copy.deleteDescription, children: _jsx(Button, { variant: "ghost", size: "sm", className: "text-destructive hover:bg-destructive/10 hover:text-destructive", onClick: onOpenArchiveDialog, children: copy.deleteWorkspace }) }), transferSlot] })] })) : null] })), _jsx(TypeToConfirmDialog, { open: archiveOpen, onOpenChange: (open) => {
                     if (!open)
                         onCloseArchiveDialog();
                 }, title: copy.deleteTitle, description: copy.deleteDialog(workspaceName), consequencesTitle: copy.consequencesTitle, consequences: copy.consequences, reassurance: copy.reassurance, 
@@ -125,7 +139,7 @@ export function withoutProject(data, projectId) {
  *  `GeneralProjectCard` (name — see this file's header comment for what's
  *  byte-identical) and extended with icon editing, reusing `ProjectIconField`
  *  / `buildProjectEditPatch` unmodified — see this file's header comment. */
-function GeneralWorkspaceCard({ project, canManage, }) {
+function GeneralWorkspaceCard({ project, canManage, canManageEffort, }) {
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
     const t = useTranslations('settings.workspace');
     const queryClient = useQueryClient();
@@ -157,6 +171,13 @@ function GeneralWorkspaceCard({ project, canManage, }) {
         onSettled: () => renameOnSettled(queryClient, project.project_id),
     });
     const { mutate: mutateName, isPending: isRenamePending } = renameMutation;
+    const effortMutation = useMutation({
+        mutationFn: (effort) => setDefaultReasoningEffort(project.project_id, effort),
+        onSuccess: (updated) => {
+            queryClient.setQueryData(qk.project.summary(project.project_id), updated);
+        },
+        onError: (error) => errorToast(error.message || t('updateFailed')),
+    });
     useEffect(() => {
         if (!canManage || isRenamePending)
             return;
@@ -215,7 +236,7 @@ function GeneralWorkspaceCard({ project, canManage, }) {
                         // Not `variant="popover"` any more: the group it now sits in is
                         // itself `bg-popover`, so a popover-tinted input would vanish into
                         // it. The default `bg-input` is what makes it read as a control.
-                        className: "h-8 w-56" })] })] }));
+                        className: "h-8 w-56" })] }), _jsx(SettingsRow, { label: t('defaultEffort'), description: t('defaultEffortDescription'), children: _jsxs(Select, { value: project.default_reasoning_effort ?? DEFAULT_EFFORT_AUTOMATIC, onValueChange: (v) => effortMutation.mutate(v === DEFAULT_EFFORT_AUTOMATIC ? null : v), disabled: !canManageEffort || effortMutation.isPending, children: [_jsx(SelectTrigger, { "aria-label": t('defaultEffort'), className: "h-8 w-40 shrink-0", children: _jsx(SelectValue, { placeholder: t('defaultEffortAutomatic') }) }), _jsxs(SelectContent, { align: "end", children: [_jsx(SelectItem, { value: DEFAULT_EFFORT_AUTOMATIC, children: t('defaultEffortAutomatic') }), DEFAULT_EFFORT_OPTIONS.map((effort) => (_jsx(SelectItem, { value: effort, children: effortOptionLabel(effort) }, effort)))] })] }) })] }));
 }
 /** Container: owns every hook (React Query, IAM probe, archive dialog state)
  *  and renders `GeneralTabView` with real data + slots. Only ever mounted
@@ -235,12 +256,13 @@ export function GeneralTab({ projectId }) {
     });
     const project = projectQuery.data;
     // Two DIFFERENT permissions, asked for separately. `project.delete` gates the
-    // Delete-workspace section; `project.write` gates the fields. Reading a
+    // Delete-workspace section; `project.settings.write` gates the fields. Reading a
     // `manager` role label instead would have hidden Delete from a custom role
     // that holds `project.delete`, and shown it to one that does not.
     const caps = useProjectCans(projectId, GENERAL_TAB_ACTIONS);
     const canDelete = caps[PROJECT_ACTIONS.PROJECT_DELETE]?.allowed === true;
-    const canEdit = caps[PROJECT_ACTIONS.PROJECT_WRITE]?.allowed === true;
+    const canEdit = caps[PROJECT_ACTIONS.PROJECT_SETTINGS_WRITE]?.allowed === true;
+    const canEditEffort = canEdit;
     const archiveMutation = useMutation({
         mutationFn: () => runProjectArchive(projectId, { archiveProject }, 
         // The archived project must stop being where `/` and the settings
@@ -283,8 +305,8 @@ export function GeneralTab({ projectId }) {
             ],
             reassurance: t('reassurance'),
             keepWorkspace: t('keepWorkspace'),
-        }, isLoading: projectQuery.isLoading, isError: projectQuery.isError, errorMessage: projectQuery.error?.message ?? '', onRetry: () => projectQuery.refetch(), generalFieldsSlot: project ? _jsx(GeneralWorkspaceCard, { project: project, canManage: canEdit }) : undefined, 
+        }, isLoading: projectQuery.isLoading, isError: projectQuery.isError, errorMessage: projectQuery.error?.message ?? '', onRetry: () => projectQuery.refetch(), generalFieldsSlot: project ? _jsx(GeneralWorkspaceCard, { project: project, canManage: canEdit, canManageEffort: canEditEffort }) : undefined, 
         // No git-repo slot: Git repo is its own Settings section since
         // 2026-09-03 (`project-settings-sections.ts`).
-        canDelete: canDelete, workspaceName: project?.name, archiveOpen: archiveOpen, onOpenArchiveDialog: () => setArchiveOpen(true), onCloseArchiveDialog: () => setArchiveOpen(false), onConfirmArchive: () => archiveMutation.mutate(), isArchivePending: archiveMutation.isPending }));
+        canDelete: canDelete, workspaceName: project?.name, archiveOpen: archiveOpen, onOpenArchiveDialog: () => setArchiveOpen(true), onCloseArchiveDialog: () => setArchiveOpen(false), onConfirmArchive: () => archiveMutation.mutate(), isArchivePending: archiveMutation.isPending, transferSlot: _jsx(TransferWorkspaceEntry, { projectId: projectId, currentAccountId: project?.account_id }) }));
 }

package/dist/customize/settings/tabs/transfer-workspace-dialog.d.ts

@@ -0,0 +1,4 @@
+export declare function TransferWorkspaceEntry({ projectId, currentAccountId, }: {
+    projectId: string;
+    currentAccountId?: string;
+}): import("react").JSX.Element;

package/dist/customize/settings/tabs/transfer-workspace-dialog.js

@@ -0,0 +1,82 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Transfer-workspace entry point — the settings row and its dialog.
+ *
+ * The API (POST /v1/projects/:id/transfer) refuses a caller who holds the
+ * destructive tier on the project but no rights on the TARGET organization,
+ * and answers with the target's project cap when the move would exceed its
+ * plan — so this dialog only has to pick a target and say plainly what
+ * moves: sessions, files, settings and member grants follow the project;
+ * the usage ledger stays with the organization that consumed it.
+ *
+ * The project may land in an organization the mover cannot see afterwards
+ * (they are not a member there) — the same outcome the Delete flow produces,
+ * so success leaves the project the same way: forget the remembered landing
+ * target, close the settings overlay, replace into the landing door.
+ */
+import { useMemo, useState } from 'react';
+import { Button } from '../../../primitives/button.js';
+import { ConfirmDialog } from '../../../primitives/confirm-dialog.js';
+import { SettingsRow } from '../../../primitives/settings-row.js';
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from '../../../primitives/select.js';
+import { errorToast, successToast } from '../../../primitives/toast.js';
+import { useSettingsPanelStore } from '../../../internal/stores/settings-panel-store.js';
+import { useUiRouter, useUiViewerId } from '../../../providers/ui-provider.js';
+import { useAccountsList } from '../../../internal/hooks/account/use-accounts-list.js';
+import { PROJECT_LANDING_PATH } from '../../../internal/lib/onboarding/landing-destination.js';
+import { forgetLastProjectId } from '../../../internal/lib/onboarding/last-project-cookie.js';
+import { transferProject } from '@kortix/sdk';
+import { qk } from '@kortix/sdk/react';
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { useTranslations } from '../../../i18n/index.js';
+export function TransferWorkspaceEntry({ projectId, currentAccountId, }) {
+    const t = useTranslations('settings.workspace');
+    const [open, setOpen] = useState(false);
+    return (_jsxs(_Fragment, { children: [_jsx(SettingsRow, { label: t('transferWorkspace'), description: t('transferDescription'), children: _jsx(Button, { variant: "ghost", size: "sm", className: "text-destructive hover:bg-destructive/10 hover:text-destructive", onClick: () => setOpen(true), children: t('transferWorkspace') }) }), _jsx(TransferWorkspaceDialog, { projectId: projectId, currentAccountId: currentAccountId, open: open, onOpenChange: setOpen })] }));
+}
+function TransferWorkspaceDialog({ projectId, currentAccountId, open, onOpenChange, }) {
+    const t = useTranslations('settings.workspace');
+    const queryClient = useQueryClient();
+    const router = useUiRouter();
+    const viewerId = useUiViewerId();
+    const [targetId, setTargetId] = useState('');
+    // Same freshness contract as every other account-list reader: fetch only
+    // while the dialog is open.
+    const accountsQuery = useAccountsList({ enabled: open });
+    // The target cannot be the account the project already lives in — the API
+    // refuses that anyway — and a stale `currentAccountId` (project query still
+    // in flight) is harmless: the API re-checks.
+    const targetOptions = useMemo(() => (accountsQuery.data ?? []).filter((account) => account.account_id !== currentAccountId), [accountsQuery.data, currentAccountId]);
+    const transferMutation = useMutation({
+        mutationFn: () => transferProject(projectId, targetId),
+        onSuccess: () => {
+            successToast(t('transferSuccess'));
+            // Same leave-the-project flow as Delete: the moved project must stop
+            // being the remembered landing target, the global overlay must close
+            // before the navigation lands, and Back must not return to a project
+            // the viewer may no longer see.
+            forgetLastProjectId(viewerId, projectId);
+            useSettingsPanelStore.getState().close();
+            // qk.projects.scope(): lists across every account plus the accountless
+            // slot — the project just changed accounts, so every list form is
+            // stale at once. The moved project's own caches are unreachable after
+            // the replace below (the old id's entries gcTime out).
+            queryClient.invalidateQueries({ queryKey: qk.projects.scope() });
+            onOpenChange(false);
+            router.replace(PROJECT_LANDING_PATH);
+        },
+        onError: (error) => errorToast(error.message || t('transferFailed')),
+    });
+    const targetName = targetOptions.find((account) => account.account_id === targetId)?.name;
+    const changeOpen = (next) => {
+        if (transferMutation.isPending)
+            return;
+        if (!next) {
+            setTargetId('');
+            transferMutation.reset();
+        }
+        onOpenChange(next);
+    };
+    return (_jsx(ConfirmDialog, { open: open, onOpenChange: changeOpen, title: t('transferTitle'), description: _jsxs("div", { className: "space-y-4", children: [_jsx("p", { children: t('transferDialog') }), accountsQuery.isLoading ? (_jsx("p", { children: t('transferLoadingTargets') })) : accountsQuery.isError ? (_jsx(Button, { variant: "outline", onClick: () => accountsQuery.refetch(), children: t('retry') })) : targetOptions.length === 0 ? (_jsx("p", { children: t('transferNoTargets') })) : (_jsxs(Select, { value: targetId, onValueChange: setTargetId, children: [_jsx(SelectTrigger, { className: "w-full", "aria-label": t('transferTargetLabel'), children: _jsx(SelectValue, { placeholder: t('transferTargetPlaceholder') }) }), _jsx(SelectContent, { children: targetOptions.map((account) => (_jsx(SelectItem, { value: account.account_id, children: account.name }, account.account_id))) })] }))] }), cancelLabel: t('keepWorkspace'), confirmLabel: targetName ? t('transferMoveTo', { name: targetName }) : t('transferMove'), confirmVariant: "destructive", confirmDisabled: !targetName || accountsQuery.isError, isPending: transferMutation.isPending, onConfirm: () => transferMutation.mutate() }));
+}

package/dist/files/project/api/runtime-files.js

@@ -194,12 +194,13 @@ export async function readFile(projectId, ref, filePath) {
     // text, and the JSON content read is byte-safe for it.
     if (hasExtension && getLanguageFromExt(name) !== 'plaintext') {
         const result = await readProjectFile(projectId, relativePath, ref);
-        return { type: 'text', content: result.content };
+        return { type: 'text', content: result.content, revision: result.revision };
     }
     // Unknown or missing extension: the bytes decide, text or binary.
     const bytes = await readRawBytes(projectId, relativePath, ref);
     if (isTextBytes(bytes)) {
-        return { type: 'text', content: new TextDecoder().decode(bytes), mimeType: 'text/plain; charset=utf-8' };
+        const result = await readProjectFile(projectId, relativePath, ref);
+        return { type: 'text', content: result.content, revision: result.revision, mimeType: 'text/plain; charset=utf-8' };
     }
     return { type: 'binary', content: '', mimeType: 'application/octet-stream' };
 }

package/dist/files/project/file-source.js

@@ -1,4 +1,9 @@
 'use client';
+import { useQueryClient } from '@tanstack/react-query';
+import { writeProjectFile } from '@kortix/sdk';
+import { fileContentKeys } from './hooks/use-file-content.js';
+import { useProjectCan } from '../../internal/lib/use-project-can.js';
+import { PROJECT_ACTIONS } from '../../internal/lib/project-actions.js';
 import { useMemo } from 'react';
 import { downloadFile, uploadFile } from './api/runtime-files.js';
 import { FilePathBreadcrumbs } from './components/file-breadcrumbs.js';
@@ -16,6 +21,8 @@ import { useBinaryBlob } from './hooks/use-binary-blob.js';
  */
 export function useProjectFileSource() {
     const ctx = useProjectContext();
+    const queryClient = useQueryClient();
+    const canWrite = useProjectCan(ctx?.projectId ?? '', PROJECT_ACTIONS.PROJECT_FILE_WRITE).allowed === true;
     return useMemo(() => ({
         id: 'project-ref',
         useFileContent,
@@ -25,6 +32,16 @@ export function useProjectFileSource() {
             ? downloadFile(ctx.projectId, ctx.ref, filePath, fileName)
             : Promise.reject(new Error('No project context for download')),
         upload: uploadFile,
+        editablePreview: canWrite,
+        save: ctx && canWrite ? async (filePath, file, revision) => {
+            if (!revision)
+                throw new Error('Reload the file before saving.');
+            await writeProjectFile(ctx.projectId, {
+                path: filePath.replace(/^\/workspace\//, '').replace(/^\//, ''), ref: ctx.ref,
+                content: await file.text(), expected_revision: revision,
+            });
+            await queryClient.invalidateQueries({ queryKey: fileContentKeys.all });
+        } : undefined,
         Breadcrumbs: FilePathBreadcrumbs,
-    }), [ctx]);
+    }), [ctx, canWrite, queryClient]);
 }

package/dist/files/project/hooks/use-file-content.js

@@ -20,6 +20,8 @@ export function useFileContent(filePath, options) {
         staleTime: options?.staleTime ?? 10_000,
         gcTime: 5 * 60_000,
         refetchOnWindowFocus: false,
+        // A revision used for edits must remain paired with the displayed text.
+        refetchOnMount: false,
         retry: (failureCount, error) => {
             const msg = error.message.toLowerCase();
             if (msg.includes('404') ||

package/dist/files/viewer/file-header.js

@@ -9,7 +9,7 @@ import { cn } from '../../lib/utils.js';
 import { WarningIcon as AlertTriangle, BracketsCurlyIcon as Braces, CheckIcon as Check, WarningCircleIcon as CircleAlert, CodeIcon as Code, EyeIcon as Eye, GlobeIcon as Globe, ArrowCounterClockwiseIcon as RotateCcw, FloppyDiskIcon as Save } from '@phosphor-icons/react';
 import { Download } from '../../internal/icons/download.js';
 export function FileHeader({ showHeader, Breadcrumbs, filePath, readOnly, hasUnsavedChanges, saveFlash, fileDiagErrorCount, fileDiagWarningCount, fileContent, isSaving, handleSave, latestContentRef, discardLabel, handleDiscard, isHtmlFile, isHtmlPreview, setIsHtmlPreview, isJsonFile, isJsonTreeView, setIsJsonTreeView, hasPreviewToggle, isMarkdownPreview, setIsMarkdownPreview, headerActions, handleDownload, blobUrl, rawBlob, tI18nHardcoded, tHardcodedUi }) {
-    return (_jsx(_Fragment, { children: showHeader && (_jsxs("div", { className: "border-border/50 flex h-10 shrink-0 items-center gap-2 border-b px-3 py-1.5", children: [_jsxs("div", { className: "flex min-w-0 flex-1 items-center gap-1", children: [Breadcrumbs && _jsx(Breadcrumbs, { filePath: filePath }), !readOnly && hasUnsavedChanges && (_jsxs(Badge, { variant: "warning", size: "sm", className: "shrink-0", children: [_jsx(StatusDot, { tone: "warning", pulse: true }), tI18nHardcoded.raw('i18nComplete.text7117f0807129')] })), !readOnly && saveFlash && !hasUnsavedChanges && (_jsxs(Badge, { variant: "success", size: "sm", className: "shrink-0", children: [_jsx(Check, { className: "h-3 w-3" }), tI18nHardcoded.raw('i18nComplete.textb5c120b316c2')] })), readOnly && (_jsx(Badge, { variant: "muted", size: "sm", className: "shrink-0 tracking-wider uppercase", children: tHardcodedUi.raw('featuresFilesComponentsFileContentRenderer.line554JsxTextViewOnly') })), (fileDiagErrorCount > 0 || fileDiagWarningCount > 0) && (_jsxs("span", { className: "inline-flex shrink-0 items-center gap-1.5", children: [fileDiagErrorCount > 0 && (_jsxs("span", { className: "text-destructive inline-flex items-center gap-0.5 text-xs font-medium tabular-nums", children: [_jsx(CircleAlert, { className: "h-3 w-3" }), fileDiagErrorCount] })), fileDiagWarningCount > 0 && (_jsxs("span", { className: "text-kortix-orange inline-flex items-center gap-0.5 text-xs font-medium tabular-nums", children: [_jsx(AlertTriangle, { className: "h-3 w-3" }), fileDiagWarningCount] }))] }))] }), _jsxs("div", { className: "flex shrink-0 items-center gap-0.5", children: [!readOnly && hasUnsavedChanges && fileContent?.type === 'text' && (_jsxs(_Fragment, { children: [_jsxs(Button, { variant: "default", size: "sm", className: "h-7 gap-1.5 px-3 text-xs font-medium", onClick: () => handleSave(latestContentRef.current), disabled: isSaving, title: tHardcodedUi.raw('featuresFilesComponentsFileContentRenderer.line586JsxAttrTitleSaveS'), children: [isSaving ? (_jsx(Loading, { className: "h-3.5 w-3.5" })) : (_jsx(Save, { className: "h-3.5 w-3.5" })), tI18nHardcoded.raw('i18nComplete.text1509f561f241')] }), _jsx(Hint, { label: discardLabel, side: "bottom", children: _jsx(Button, { variant: "ghost", size: "icon", "aria-label": discardLabel, className: "text-muted-foreground hover:text-foreground h-7 w-7 active:scale-[0.96]", onClick: handleDiscard, children: _jsx(RotateCcw, { className: "h-3.5 w-3.5" }) }) })] })), isHtmlFile && (_jsx(Hint, { label: isHtmlPreview ? tI18nHardcoded.raw('i18nComplete.text6ee818aa2de3') : 'Preview', side: "bottom", children: _jsx(Button, { variant: "ghost", size: "icon", "aria-label": isHtmlPreview ? tI18nHardcoded.raw('i18nComplete.text6ee818aa2de3') : 'Preview', "aria-pressed": isHtmlPreview, className: cn('h-7 w-7 active:scale-[0.96]', isHtmlPreview && 'text-primary'), onClick: () => setIsHtmlPreview((v) => !v), children: isHtmlPreview ? _jsx(Code, { className: "h-4 w-4" }) : _jsx(Globe, { className: "h-4 w-4" }) }) })), isJsonFile && fileContent?.type === 'text' && (_jsx(Hint, { label: isJsonTreeView
+    return (_jsx(_Fragment, { children: showHeader && (_jsxs("div", { className: "border-border/50 flex h-10 shrink-0 items-center gap-2 border-b px-3 py-1.5", children: [_jsxs("div", { className: "flex min-w-0 flex-1 items-center gap-1", children: [Breadcrumbs && _jsx(Breadcrumbs, { filePath: filePath }), !readOnly && hasUnsavedChanges && (_jsxs(Badge, { variant: "warning", size: "sm", className: "shrink-0", children: [_jsx(StatusDot, { tone: "warning", pulse: true }), tI18nHardcoded.raw('i18nComplete.text7117f0807129')] })), !readOnly && saveFlash && !hasUnsavedChanges && (_jsxs(Badge, { variant: "success", size: "sm", className: "shrink-0", children: [_jsx(Check, { className: "h-3 w-3" }), tI18nHardcoded.raw('i18nComplete.textb5c120b316c2')] })), readOnly && (_jsx(Badge, { variant: "muted", size: "sm", className: "shrink-0 tracking-wider uppercase", children: tHardcodedUi.raw('featuresFilesComponentsFileContentRenderer.line554JsxTextViewOnly') })), (fileDiagErrorCount > 0 || fileDiagWarningCount > 0) && (_jsxs("span", { className: "inline-flex shrink-0 items-center gap-1.5", children: [fileDiagErrorCount > 0 && (_jsxs("span", { className: "text-destructive inline-flex items-center gap-0.5 text-xs font-medium tabular-nums", children: [_jsx(CircleAlert, { className: "h-3 w-3" }), fileDiagErrorCount] })), fileDiagWarningCount > 0 && (_jsxs("span", { className: "text-kortix-orange inline-flex items-center gap-0.5 text-xs font-medium tabular-nums", children: [_jsx(AlertTriangle, { className: "h-3 w-3" }), fileDiagWarningCount] }))] }))] }), _jsxs("div", { className: "flex shrink-0 items-center gap-0.5", children: [!readOnly && hasUnsavedChanges && fileContent?.type === 'text' && (_jsxs(_Fragment, { children: [_jsxs(Button, { variant: "default", size: "sm", className: "h-7 gap-1.5 px-3 text-xs font-medium", onClick: () => { void handleSave(latestContentRef.current).catch(() => undefined); }, disabled: isSaving, title: tHardcodedUi.raw('featuresFilesComponentsFileContentRenderer.line586JsxAttrTitleSaveS'), children: [isSaving ? (_jsx(Loading, { className: "h-3.5 w-3.5" })) : (_jsx(Save, { className: "h-3.5 w-3.5" })), tI18nHardcoded.raw('i18nComplete.text1509f561f241')] }), _jsx(Hint, { label: discardLabel, side: "bottom", children: _jsx(Button, { variant: "ghost", size: "icon", "aria-label": discardLabel, className: "text-muted-foreground hover:text-foreground h-7 w-7 active:scale-[0.96]", onClick: handleDiscard, children: _jsx(RotateCcw, { className: "h-3.5 w-3.5" }) }) })] })), isHtmlFile && (_jsx(Hint, { label: isHtmlPreview ? tI18nHardcoded.raw('i18nComplete.text6ee818aa2de3') : 'Preview', side: "bottom", children: _jsx(Button, { variant: "ghost", size: "icon", "aria-label": isHtmlPreview ? tI18nHardcoded.raw('i18nComplete.text6ee818aa2de3') : 'Preview', "aria-pressed": isHtmlPreview, className: cn('h-7 w-7 active:scale-[0.96]', isHtmlPreview && 'text-primary'), onClick: () => setIsHtmlPreview((v) => !v), children: isHtmlPreview ? _jsx(Code, { className: "h-4 w-4" }) : _jsx(Globe, { className: "h-4 w-4" }) }) })), isJsonFile && fileContent?.type === 'text' && (_jsx(Hint, { label: isJsonTreeView
                                 ? tI18nHardcoded.raw('i18nComplete.text6ee818aa2de3')
                                 : tI18nHardcoded.raw('i18nComplete.text4f50bda41e87'), side: "bottom", children: _jsx(Button, { variant: "ghost", size: "icon", "aria-label": isJsonTreeView
                                     ? tI18nHardcoded.raw('i18nComplete.text6ee818aa2de3')

package/dist/files/viewer/file-preview-modal.d.ts

@@ -60,4 +60,4 @@ export interface FilePreviewModalProps extends FilePreviewState {
  *     hit that path, which is why only the mouse appeared broken.)
  * Z-index is dialog-depth aware so it always stacks above its host overlay.
  */
-export declare function FilePreviewModal({ selectedFilePath, panelMode, filePathList, currentFileIndex, onClose, onNext, onPrev, source, HistoryContent, statusSlot, extraActions, shareContext, historyLabel, embedded, targetLine, }: FilePreviewModalProps): import("react").JSX.Element | null;
+export declare function FilePreviewModal({ selectedFilePath, panelMode, filePathList, currentFileIndex, onClose: closePreview, onNext: nextPreview, onPrev: prevPreview, source, HistoryContent, statusSlot, extraActions, shareContext, historyLabel, embedded, targetLine, }: FilePreviewModalProps): import("react").JSX.Element | null;

package/dist/files/viewer/file-preview-modal.js

@@ -54,9 +54,19 @@ const NO_REFRESH = {
  *     hit that path, which is why only the mouse appeared broken.)
  * Z-index is dialog-depth aware so it always stacks above its host overlay.
  */
-export function FilePreviewModal({ selectedFilePath, panelMode, filePathList, currentFileIndex, onClose, onNext, onPrev, source, HistoryContent, statusSlot, extraActions, shareContext, historyLabel = "History", embedded = false, targetLine = null, }) {
+export function FilePreviewModal({ selectedFilePath, panelMode, filePathList, currentFileIndex, onClose: closePreview, onNext: nextPreview, onPrev: prevPreview, source, HistoryContent, statusSlot, extraActions, shareContext, historyLabel = "History", embedded = false, targetLine = null, }) {
     const tI18nHardcoded = useTranslations("hardcodedUi");
     const isOpen = panelMode === "viewer" && !!selectedFilePath;
+    const [dirty, setDirty] = useState(false);
+    const leave = (action) => {
+        if (dirty && !window.confirm('Discard unsaved changes?'))
+            return;
+        setDirty(false);
+        action();
+    };
+    const onClose = () => leave(closePreview);
+    const onNext = () => leave(nextPreview);
+    const onPrev = () => leave(prevPreview);
     // Embedded viewers start inline (in the side panel); "Expand" pops them to
     // the full-screen overlay. Non-embedded viewers are always full-screen.
     const [expanded, setExpanded] = useState(false);
@@ -264,7 +274,7 @@ export function FilePreviewModal({ selectedFilePath, panelMode, filePathList, cu
                             : "Expand", side: "bottom", children: _jsx(Button, { variant: "ghost", size: "icon", "aria-label": expanded
                                 ? tI18nHardcoded.raw("i18nComplete.textde12e3c7c7a8")
                                 : "Expand", "aria-pressed": expanded, className: "text-muted-foreground hover:text-foreground h-8 w-8 active:scale-[0.96]", onClick: () => setExpanded((v) => !v), children: expanded ? (_jsx(Minimize2, { className: "h-4 w-4" })) : (_jsx(Maximize2, { className: "h-4 w-4" })) }) })), _jsx(ButtonGroup, { className: "ml-1.5", children: _jsx(Hint, { label: tI18nHardcoded.raw("autoFeaturesFileViewerFilePreviewModalJsxAttrTitleClosea40d0510"), side: "bottom", children: _jsx(Button, { variant: "secondary", size: "icon-base", "aria-label": tI18nHardcoded.raw("autoFeaturesFileViewerFilePreviewModalJsxAttrTitleClosea40d0510"), className: "active:scale-[0.96]", onClick: onClose, children: _jsx(X, { className: "h-4 w-4" }) }) }) })] })] }));
-    const body = (_jsxs(_Fragment, { children: [_jsx("div", { className: "h-full w-full overflow-hidden px-3 pt-3 pb-2", children: _jsx(FileSourceProvider, { value: source, children: _jsx(FileContentRenderer, { filePath: selectedFilePath, reloadKey: reloadKey, showHeader: false, readOnly: true, targetLine: targetLine, markdownPreview: markdownPreview, onMarkdownPreviewChange: setMarkdownPreview }) }) }), historyPath && (_jsx("div", { className: "bg-popover border-border/60 animate-in slide-in-from-bottom-4 fade-in-0 absolute right-4 bottom-4 z-30 overflow-hidden rounded-md border shadow-md duration-normal", children: _jsx(HistoryContent, { filePath: historyPath, onClose: () => setHistoryPath(null) }) }))] }));
+    const body = (_jsxs(_Fragment, { children: [_jsx("div", { className: "h-full w-full overflow-hidden px-3 pt-3 pb-2", children: _jsx(FileSourceProvider, { value: source, children: _jsx(FileContentRenderer, { filePath: selectedFilePath, reloadKey: reloadKey, onUnsavedChange: setDirty, showHeader: !!source.editablePreview, readOnly: !source.editablePreview, targetLine: targetLine, markdownPreview: markdownPreview, onMarkdownPreviewChange: setMarkdownPreview }) }) }), historyPath && (_jsx("div", { className: "bg-popover border-border/60 animate-in slide-in-from-bottom-4 fade-in-0 absolute right-4 bottom-4 z-30 overflow-hidden rounded-md border shadow-md duration-normal", children: _jsx(HistoryContent, { filePath: historyPath, onClose: () => setHistoryPath(null) }) }))] }));
     const panelInner = (_jsxs(_Fragment, { children: [_jsx("div", { ref: toolbarRef, className: "border-border/40 bg-background/95 flex h-12 shrink-0 items-center gap-2 border-b px-3 backdrop-blur-sm", children: toolbar }), _jsx("div", { ref: contentRef, className: "relative min-h-0 flex-1 overflow-hidden", children: body })] }));
     // Inline (embedded, not expanded): fill the relative parent — the side panel —
     // instead of portaling to a full-screen overlay. No backdrop, no body lock.

package/dist/files/viewer/file-source.d.ts

@@ -5,6 +5,7 @@ import { type ComponentType, type ReactNode } from 'react';
  * their own typed hooks without conversion.
  */
 export interface FileContent {
+    revision?: string;
     type: 'text' | 'binary';
     content: string;
     patch?: FilePatch;
@@ -79,7 +80,8 @@ export interface FileSource {
      * instead of `upload`, so a source can refuse a save over a file someone
      * changed since it was read (a conditional write) rather than clobber it.
      */
-    save?: (filePath: string, file: File) => Promise<unknown>;
+    editablePreview?: boolean;
+    save?: (filePath: string, file: File, revision?: string) => Promise<unknown>;
     /**
      * Every byte the viewer shows comes from this source, which owns the
      * authorization. Previewers that otherwise read a sandbox path themselves

package/dist/files/viewer/use-file-content-state.js

@@ -61,6 +61,13 @@ export function useFileContentState({ filePath, onUnsavedChange, onSaved, readOn
     const contentRevision = useContentRevision(fileContent);
     const fetchRevision = useContentRevision(dataUpdatedAt || undefined);
     const [hasUnsavedChanges, setHasUnsavedChanges] = useState(false);
+    // A refetch may replace server content while CodeEditor retains a dirty draft.
+    // CAS must compare against the revision that draft started from.
+    const draftRevisionRef = useRef(fileContent?.revision);
+    useEffect(() => {
+        if (!hasUnsavedChanges)
+            draftRevisionRef.current = fileContent?.revision;
+    }, [hasUnsavedChanges, fileContent?.revision]);
     const [isSaving, setIsSaving] = useState(false);
     const [saveFlash, setSaveFlash] = useState(false);
     // Tracks the latest editor content so we can save from the header button.
@@ -120,12 +127,12 @@ export function useFileContentState({ filePath, onUnsavedChange, onSaved, readOn
     // HEIC conversion — converts the raw HEIC blob to a renderable JPEG URL
     const { url: heicImageUrl, isConverting: heicConverting } = useHeicBlob(isHeicImage ? rawBlob : null, fileName);
     const displayContent = fileContent?.content ?? '';
-    // Keep latestContentRef in sync with loaded content
+    // Refresh clean content only; header Save must keep the visible dirty draft.
     useEffect(() => {
-        if (fileContent?.content) {
-            latestContentRef.current = fileContent.content;
+        if (!hasUnsavedChanges) {
+            latestContentRef.current = fileContent?.content ?? '';
         }
-    }, [fileContent?.content]);
+    }, [fileContent?.content, hasUnsavedChanges]);
     // Reset state when the FILE changes — markdown defaults to rendered preview.
     //
     // `setIsMarkdownPreview` MUST NOT be a dependency here, and this effect must
@@ -167,15 +174,17 @@ export function useFileContentState({ filePath, onUnsavedChange, onSaved, readOn
     // Save handler — called by CodeEditor (Cmd+S) and by the header Save button.
     // When called from the header button we pass latestContentRef.current.
     // When called from CodeEditor's Cmd+S, CodeEditor passes its own localContent.
+    const draftGeneration = useRef(0);
     const handleSave = useCallback(async (content) => {
         if (readOnly)
             return;
+        const generation = draftGeneration.current;
         setIsSaving(true);
         try {
             const blob = new Blob([content], { type: 'text/plain;charset=utf-8' });
             const file = new File([blob], fileName, { type: 'text/plain' });
             if (source.save) {
-                await source.save(filePath, file);
+                await source.save(filePath, file, draftRevisionRef.current);
             }
             else {
                 const parentPath = filePath.substring(0, filePath.lastIndexOf('/'));
@@ -184,7 +193,15 @@ export function useFileContentState({ filePath, onUnsavedChange, onSaved, readOn
             // Refetch so fileContent.content (= originalContent for CodeEditor) updates.
             // CodeEditor's originalContent effect will then sync savedContent.current
             // to match localContent, clearing its internal hasChanges flag.
-            await refetch();
+            const refreshed = await refetch();
+            if (refreshed && typeof refreshed === 'object' && 'data' in refreshed) {
+                const data = refreshed.data;
+                if (data && typeof data === 'object' && 'revision' in data && typeof data.revision === 'string') {
+                    draftRevisionRef.current = data.revision;
+                }
+            }
+            if (draftGeneration.current !== generation)
+                return;
             setHasUnsavedChanges(false);
             setSaveFlash(true);
             if (saveFlashTimerRef.current)
@@ -199,6 +216,7 @@ export function useFileContentState({ filePath, onUnsavedChange, onSaved, readOn
                     ? err.message
                     : tI18nHardcoded.raw('i18nComplete.text27c2ccd962c2'),
             }));
+            throw err;
         }
         finally {
             setIsSaving(false);
@@ -216,6 +234,7 @@ export function useFileContentState({ filePath, onUnsavedChange, onSaved, readOn
     const handleEditorChange = useCallback((content) => {
         if (readOnly)
             return;
+        draftGeneration.current++;
         latestContentRef.current = content;
     }, [readOnly]);
     // Cmd+S handler for when CodeEditor is not mounted (e.g. markdown preview)
@@ -226,7 +245,7 @@ export function useFileContentState({ filePath, onUnsavedChange, onSaved, readOn
             if ((e.metaKey || e.ctrlKey) && e.key === 's') {
                 e.preventDefault();
                 if (hasUnsavedChanges && latestContentRef.current) {
-                    handleSave(latestContentRef.current);
+                    void handleSave(latestContentRef.current).catch(() => undefined);
                 }
             }
         };

package/dist/files/viewer/viewer-actions.js

@@ -148,8 +148,8 @@ function expiryLabel(expiresAt) {
 /**
  * `Copy link` and everything about the link behind it, in one popover.
  *
- * A file or app mint always makes a NEW public token (only transcripts are
- * reused server-side), so the popover reads the session's live shares first:
+ * A file or app mint always makes a NEW public token, so the popover reads
+ * the session's live shares first:
  *
  *   - a live link for this exact file or port → show it, copy it, see when it
  *     expires, revoke it;