Files
PaperClipAI/ui/src/pages/InstanceExperimentalSettings.tsx
T
TonioandClaude Fable 5.1 341b622604 feat(ui): Artifacts V1 behind an experimental setting — Artifacts page, panel tab and task thread (#17228)
## Thinking Path

> - Paperclip is the open source app people use to manage AI agents for
work
> - Agents produce artifacts: documents, files, pictures, video and
links. The app shows them on the Artifacts page, in the right panel's
Artifacts tab and in the task thread
> - The artifact directions lab (#17213) settled a presentation for
those surfaces, MVP V1, drawn from the PCLP-Core mocks. It is a
reference, not product code
> - Shipping it means product components on product data, token-only,
behind a switch, one surface at a time, so the current presentation
stays the default until the new one has been used
> - This pull request adds the switch (Settings > Experimental >
Artifacts V1), the `--artifact-*` tokens, the V1 primitives as product
components, and the V1 presentation on all three surfaces behind the
switch: the Artifacts page, the panel's Artifacts tab and the task
thread
> - The benefit is the redesign in the product, reversible by one
setting, with every existing behaviour of those surfaces kept

## Linked Issues or Issue Description

No public issue exists. This section follows the feature request
template; the plan is `doc/plans/2026-10-22-artifacts-mvp-v1.md`.

**Subsystem affected**

The web UI (`ui/`): the Artifacts page, the right panel's Artifacts tab
and the task thread. The experimental settings contract in
`packages/shared` and `server` gains one boolean.

**Problem or motivation**

The three artifact surfaces grew separately and their artifact
presentation is dated and inconsistent. The lab produced a measured
direction; nothing in the product uses it yet.

**Proposed solution**

An experimental setting, `enableArtifactsV1`, default off, with the same
plumbing as the other experimental settings. Product primitives under
`ui/src/components/artifacts/v1` (kind helpers and adapters, the sheet
and print artwork, the stack, the page tiles with the Paper Mono pill,
the row the panel and thread will share), driven by `--artifact-*`
tokens in `index.css` with light and dark values. With the setting on:
the Artifacts page shows one row of views (Tasks, All files, Images,
Videos, Documents, Text, Files) and the V1 tiles, a task with several
artifacts as a stack whose newest artifact is the first page, everything
else as single tiles; the panel's Artifacts tab is one flat list of V1
rows, newest first, with the expandable rows (Markdown review surface,
document annotations, deep links) keeping their behaviour behind the row
as their face; the thread shows a message's files as rows under its
footer and registered deliverables and documents as one row each. The
hover movement respects reduced motion.

**Alternatives considered**

Replacing the current cards outright: no fallback and three surfaces to
land at once. Mounting the lab's components: they are typed on lab
fixtures and keep lab-local tokens, which the token gates reject. The
primitives were ported instead and the lab stays a reference.

**Roadmap alignment**

Supports the "Artifacts & Work Products" theme in `ROADMAP.md`.
Presentation only; no data model change.

**Additional context**

No new API fields: the tiles show title, identifier, count and "Updated
…"; rows take sizes from the work-product and attachment payloads; a
picture's aspect ratio comes from the loaded image, 4:3 until it loads.
The plan records what each surface keeps and what it drops (run sections
in the panel; the "Images · N / Files · N" labels and the four-up grid
in the thread).

## What Changed

- Add the `enableArtifactsV1` experimental setting: shared type,
validator and feature catalog, server defaults and managed keys, the
`useArtifactsV1Enabled` hook, and the Settings > Experimental toggle (in
its alphabetical place).
- Add the `--artifact-*` tokens and the Artifacts V1 component rules to
`ui/src/index.css`: light values on `:root`, dark overrides, and the
hover movement under `prefers-reduced-motion: no-preference`.
- Add `ui/src/components/artifacts/v1/`: `kinds.ts` (kind treatment,
labels, glyphs, the server's media-kind rule, adapters from
`CompanyArtifact`), `geometry.ts` (the measured constants), `when.ts`,
`ArtifactSheet`, `ArtifactPrint`, `ArtifactStack`, `ArtifactFront`,
`ArtifactTile` (stack and single tiles, caption, grid), `ArtifactRow`
(the row and its inline group), `ArtifactsV1Filters`, with the mock's
SVG assets.
- Wire the Artifacts page: with the setting on, the toolbar's filter row
becomes the V1 views and the grid renders V1 tiles; the toolbar takes an
optional `filters` row for this. The old cards and kind filters stay the
default.
- Wire the panel's Artifacts tab (`IssuePropertiesArtifactsTab`): with
the setting on, one flat list of V1 rows, newest first; `DocumentRow`
and `MarkdownWorkProductRow` take a `face` render prop so the V1 row
fronts their unchanged expansion, review and deep-link behaviour;
`PanelFileRow` opens attachments and attachment-backed work products the
way the shipped card does (gallery, text tab, new tab) with open and
download beside the name; other work products are a link row with their
status.
- Wire the task thread: `TaskChatBubble` hangs a message's files under
its footer as V1 rows inline (pictures and video to the gallery, text to
a text tab, files to a new tab) in place of the media grid and file
chips; `TaskChatProtocolCard`'s resource rows render deliverables,
documents and attachments as one V1 row each, opening where the card
did.
- `ArtifactRow` keeps trailing controls beside its own control (no
nested interactive elements) and can be a link, an in-app anchor, a
new-tab anchor or a button; adapters read work products, documents,
attachments and message references.
- Add a catalogued Storybook story, `Components/Artifact V1 primitives`,
under `documents-artifacts`, on fixtures.
- Add tests: the primitives (kinds, dates, print fitting, tiles, rows),
the hook, the Artifacts page, the panel's Artifacts tab, the task-chat
bubble and the protocol card, each with the setting on and off; the
settings page and server tests list the new key.
- Add `doc/plans/2026-10-22-artifacts-mvp-v1.md`.

## Verification

- Run `cd ui && pnpm typecheck`: the Storybook catalog accepts the new
story, and `tsc -b` is clean apart from the five pre-existing
`PluginOrganizationSwitcher` errors.
- Run `pnpm check:token-gates` and `node scripts/check-maps.mjs`: clean.
- Run `cd ui && npx vitest run src/components/artifacts
src/components/issue-properties
src/components/task-chat/TaskChatBubble.test.tsx
src/components/task-chat/TaskChatBubble.artifactsV1.test.tsx
src/components/task-chat/TaskChatProtocolCard.test.tsx
src/components/task-chat/TaskChatProtocolCard.artifactsV1.test.tsx
src/pages/Artifacts.test.tsx src/hooks/useArtifactsV1Enabled.test.ts
src/pages/InstanceExperimentalSettings.test.tsx`: the suites pass (151
tests in the last run).
- Run `cd packages/shared && npx vitest run src/feature-catalog.test.ts`
and `cd server && npx vitest run
src/__tests__/instance-settings-service.test.ts`: pass.
- Manual: open Settings > Experimental, turn on Artifacts V1. On the
Artifacts page the view row reads Tasks, All files, Images, Videos,
Documents, Text, Files; tasks with several artifacts show as stacks,
hovering fans the pages and lifts the artwork (not under reduced
motion); Images shows single tiles with bordered prints. Open a task's
Artifacts tab: one list of rows, newest first; a Markdown work product
still expands into its review surface, a document still opens in its
tab. In the thread, a message's files sit under its footer as rows. Turn
the setting off: everything returns to the current presentation.
- Storybook: `Tasks and conversations / Documents, attachments, and work
products / Components / Artifact V1 primitives`.
- Not run: the full `pnpm test:run` and `pnpm build` (CI runs them), and
a browser pass against a dev instance with real artifacts on the three
surfaces; that pass is the remaining step before this leaves draft.

## Risks

- Off by default; with the setting off, the only changes on a product
path are an optional `filters` prop on the toolbar, an optional `face`
prop on two panel rows, a read of the setting in the bubble and the
protocol card, and the new token declarations.
- With the setting on, the Artifacts page's view tabs set two URL
parameters (`groupBy`, `kind`) at once; the group-by menu and search are
unchanged.
- A picture with unknown dimensions renders at 4:3 until it loads, then
the print refits once; the frame's height is fixed so nothing below it
moves.
- About thirty new `--artifact-*` tokens, namespaced and documented in
place.

## Model Used

- Claude Fable 5.1 by Anthropic, model ID `claude-fable-5-1`, used
through Claude Code in the desktop app. Extended reasoning was on.
Capabilities used: tool use (shell, file edits, a headless Playwright
browser for the lab's measurements, the Figma MCP server for the mocks
during the lab work) and image input. The context window is the Claude
Code session's; its exact size is not surfaced to the session.

## Checklist

- [x] I have included a thinking path that traces from project context
to this change
- [x] I have specified the model used (with version and capability
details)
- [x] I have checked ROADMAP.md and confirmed this PR does not duplicate
planned core work
- [x] I have searched GitHub for duplicate or related PRs and linked
them above (#17213 is the lab this builds on)
- [x] I have either (a) linked existing issues with `Fixes: #` / `Closes
#` / `Refs #` OR (b) described the issue in-PR following the relevant
issue template
- [x] I have not referenced internal/instance-local Paperclip issues or
links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip`
URLs)
- [x] My branch name describes the change (e.g. `docs/...`, `fix/...`)
and contains no internal Paperclip ticket id or instance-derived details
- [x] I have run tests locally and they pass (the suites listed above;
CI runs the full set)
- [x] I have added or updated tests where applicable
- [x] I have updated relevant documentation to reflect my changes (the
plan document; no command or product behaviour changes outside the
setting)
- [x] I have considered and documented any risks above
- [ ] All Paperclip CI gates are green
- [ ] Greptile is 5/5 with no open P2s, recommendations, or follow-ups
- [x] I will address all Greptile and reviewer comments before
requesting merge

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
2026-10-22 15:14:58 -07:00

820 lines
41 KiB
TypeScript

import { useEffect, useState, type ReactNode } from "react";
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import { AlertTriangle, FlaskConical, Lock, Play } from "lucide-react";
import type {
InstanceExperimentalSettings,
InstanceExperimentalSettingsWithManaged,
InstanceFeatureKey,
ManagedSettingMetadata,
PatchInstanceExperimentalSettings,
} from "@paperclipai/shared";
import { experimentalSettingKey } from "@paperclipai/shared";
import { instanceSettingsApi } from "@/api/instanceSettings";
import { useHiddenSettings } from "@/hooks/useHiddenSettings";
import { getWorktreeInstanceId, isWorktreeRuntime } from "../lib/worktree-branding";
import { useBreadcrumbs } from "../context/BreadcrumbContext";
import { queryKeys } from "../lib/queryKeys";
import { ToggleSwitch } from "@/components/ui/toggle-switch";
import { Badge } from "@/components/ui/badge";
import { Button } from "@/components/ui/button";
import { Card } from "@/components/ui/card";
import { Link } from "@/lib/router";
type WorktreeRunExecutionDisplayState =
| { kind: "off" }
| { kind: "armed"; activatedAt: string }
| { kind: "fail_closed"; reason: "missing_cutoff" | "missing_instance_id" | "instance_mismatch" };
/**
* Mirror of the server's `resolveWorktreeRunExecutionActivation` fail-closed
* ladder (server/src/services/instance-settings.ts) so the card never claims a
* copied/legacy row is arming execution. The derived fields are display-only —
* the PATCH the toggle sends still writes just the boolean.
*/
function resolveWorktreeRunExecutionDisplayState(
settings:
| Pick<
InstanceExperimentalSettings,
| "enableWorktreeRunExecution"
| "worktreeRunExecutionActivatedAt"
| "worktreeRunExecutionActivationInstanceId"
>
| undefined,
currentInstanceId: string | null,
): WorktreeRunExecutionDisplayState {
if (settings?.enableWorktreeRunExecution !== true) return { kind: "off" };
if (!settings.worktreeRunExecutionActivatedAt) return { kind: "fail_closed", reason: "missing_cutoff" };
if (!currentInstanceId) return { kind: "fail_closed", reason: "missing_instance_id" };
if (settings.worktreeRunExecutionActivationInstanceId !== currentInstanceId) {
return { kind: "fail_closed", reason: "instance_mismatch" };
}
return { kind: "armed", activatedAt: settings.worktreeRunExecutionActivatedAt };
}
function formatActivationTimestamp(iso: string): string {
const parsed = new Date(iso);
if (Number.isNaN(parsed.getTime())) return iso;
return parsed.toLocaleString(undefined, { dateStyle: "medium", timeStyle: "short" });
}
// PAP-11233: keep Conference Room code intact, but hide the user-facing opt-in for now.
const SHOW_CONFERENCE_ROOM_EXPERIMENTAL_SETTING = false;
function ManagedByCloudBadge() {
return (
<Badge variant="outline" className="text-muted-foreground">
<Lock aria-hidden="true" />
Managed by Paperclip Cloud
</Badge>
);
}
function ExperimentalToggleCard({
title,
description,
footnote,
checked,
onCheckedChange,
disabled,
settingKey,
managed,
ariaLabel,
}: {
title: string;
description: string;
footnote?: ReactNode;
checked: boolean;
onCheckedChange: (checked: boolean) => void;
disabled: boolean;
/** Flag key backing this card; operator-hidden keys render nothing. */
settingKey: InstanceFeatureKey;
managed?: ManagedSettingMetadata;
ariaLabel: string;
}) {
const { hidden: hiddenSettings } = useHiddenSettings();
const isManaged = managed?.managed === true;
if (hiddenSettings.has(experimentalSettingKey(settingKey))) return null;
return (
<Card className="block bg-transparent p-5">
<div className="flex items-start justify-between gap-4">
<div className="space-y-1.5">
<div className="flex flex-wrap items-center gap-2">
<h3 className="text-sm font-semibold">{title}</h3>
{isManaged ? <ManagedByCloudBadge /> : null}
</div>
<p className="max-w-2xl text-sm text-muted-foreground">{description}</p>
{footnote ? <p className="max-w-2xl text-xs text-muted-foreground">{footnote}</p> : null}
</div>
<ToggleSwitch
checked={checked}
onCheckedChange={(next) => {
if (isManaged) return;
onCheckedChange(next);
}}
disabled={disabled || isManaged}
aria-label={ariaLabel}
/>
</div>
</Card>
);
}
export function InstanceExperimentalSettings() {
const { setBreadcrumbs } = useBreadcrumbs();
const queryClient = useQueryClient();
const { hidden: hiddenSettings } = useHiddenSettings();
const [actionError, setActionError] = useState<string | null>(null);
useEffect(() => {
setBreadcrumbs([
{ label: "Settings", href: "/company/settings" },
{ label: "Experimental" },
]);
}, [setBreadcrumbs]);
const experimentalQuery = useQuery({
queryKey: queryKeys.instance.experimentalSettings,
queryFn: () => instanceSettingsApi.getExperimental(),
});
const toggleMutation = useMutation<
InstanceExperimentalSettingsWithManaged,
Error,
PatchInstanceExperimentalSettings,
{ previousSettings?: InstanceExperimentalSettingsWithManaged }
>({
mutationFn: async (patch: PatchInstanceExperimentalSettings) =>
instanceSettingsApi.updateExperimental(patch),
onMutate: async (patch) => {
await queryClient.cancelQueries({ queryKey: queryKeys.instance.experimentalSettings });
const previousSettings = queryClient.getQueryData<InstanceExperimentalSettingsWithManaged>(
queryKeys.instance.experimentalSettings,
);
if (previousSettings) {
queryClient.setQueryData<InstanceExperimentalSettingsWithManaged>(
queryKeys.instance.experimentalSettings,
{ ...previousSettings, ...patch },
);
}
return { previousSettings };
},
onSuccess: async (updatedSettings) => {
setActionError(null);
queryClient.setQueryData(queryKeys.instance.experimentalSettings, updatedSettings);
await Promise.all([
queryClient.invalidateQueries({ queryKey: queryKeys.instance.experimentalSettings }),
queryClient.invalidateQueries({ queryKey: queryKeys.adapters.all }),
queryClient.invalidateQueries({ queryKey: ["built-in-agents"] }),
queryClient.invalidateQueries({ queryKey: queryKeys.health }),
queryClient.invalidateQueries({ queryKey: ["apps"] }),
]);
},
onError: (error, _patch, context) => {
if (context?.previousSettings) {
queryClient.setQueryData(queryKeys.instance.experimentalSettings, context.previousSettings);
}
setActionError(error instanceof Error ? error.message : "Failed to update experimental settings.");
},
});
if (experimentalQuery.isLoading) {
return <div className="text-sm text-muted-foreground">Loading experimental settings...</div>;
}
if (experimentalQuery.error) {
return (
<div className="text-sm text-destructive">
{experimentalQuery.error instanceof Error
? experimentalQuery.error.message
: "Failed to load experimental settings."}
</div>
);
}
const inWorktree = isWorktreeRuntime();
// Present only on cloud-managed instances: keys the managed overlay controls
// render locked with the "Managed by Paperclip Cloud" badge. Self-hosted
// responses carry no `managedKeys`, so every card stays editable.
const managedKeys = experimentalQuery.data?.managedKeys ?? {};
const enableWorktreeRunExecution = experimentalQuery.data?.enableWorktreeRunExecution === true;
const worktreeRunExecutionManaged = managedKeys.enableWorktreeRunExecution?.managed === true;
const worktreeRunExecutionState = resolveWorktreeRunExecutionDisplayState(
experimentalQuery.data,
getWorktreeInstanceId(),
);
const enableEnvironments = experimentalQuery.data?.enableEnvironments === true;
const enableNativeRunner = experimentalQuery.data?.enableNativeRunner === true;
const enableChatConnectors = experimentalQuery.data?.enableChatConnectors === true;
const enableManagedSandboxOnly = experimentalQuery.data?.enableManagedSandboxOnly === true;
const enableIsolatedWorkspaces = experimentalQuery.data?.enableIsolatedWorkspaces === true;
const enableIsolatedWorkspacesByDefault =
experimentalQuery.data?.enableIsolatedWorkspacesByDefault === true;
// Streamlined left navigation is now the standard sidebar (PAP-12472); the
// experimental opt-out was retired, so it no longer surfaces a toggle here.
const enableStreamlinedUi = experimentalQuery.data?.enableStreamlinedUi !== false;
const enableConferenceRoomChat = experimentalQuery.data?.enableConferenceRoomChat === true;
const enableClassicTaskInterface = experimentalQuery.data?.enableClassicTaskInterface === true;
const enableIssuePlanDecompositions =
experimentalQuery.data?.enableIssuePlanDecompositions === true;
const enableExperimentalFileViewer =
experimentalQuery.data?.enableExperimentalFileViewer === true;
const enableExternalObjects = experimentalQuery.data?.enableExternalObjects === true;
const enableBuiltInAgents = experimentalQuery.data?.enableBuiltInAgents === true;
const enableBetaSkills = experimentalQuery.data?.enableBetaSkills === true;
const enableSummaries = experimentalQuery.data?.enableSummaries === true;
const enableStatusCards = experimentalQuery.data?.enableStatusCards === true;
const summariesManaged = managedKeys.enableSummaries?.managed === true;
const statusCardsManaged = managedKeys.enableStatusCards?.managed === true;
const statusCardsBlockedByManagedSummaries = summariesManaged && !enableSummaries;
const summariesRequiredByManagedStatusCards = statusCardsManaged && enableStatusCards;
const enableDecisions = experimentalQuery.data?.enableDecisions === true;
const enableGoalsSidebarLink = experimentalQuery.data?.enableGoalsSidebarLink === true;
const enableCases = experimentalQuery.data?.enableCases === true;
const enableServerInfoDebugView = experimentalQuery.data?.enableServerInfoDebugView === true;
const enablePaperclipDeveloperMode =
experimentalQuery.data?.enablePaperclipDeveloperMode === true;
const enableSimplifiedEnglishInteractions =
experimentalQuery.data?.enableSimplifiedEnglishInteractions === true;
const enableFirstTaskPlanProposal =
experimentalQuery.data?.enableFirstTaskPlanProposal === true;
const enableSmokeLab = experimentalQuery.data?.enableSmokeLab === true;
const autoRestartDevServerWhenIdle = experimentalQuery.data?.autoRestartDevServerWhenIdle === true;
const isVisible = (key: InstanceFeatureKey) => !hiddenSettings.has(experimentalSettingKey(key));
const showWorktreeRunExecution = inWorktree && isVisible("enableWorktreeRunExecution");
const showDeveloperSection = showWorktreeRunExecution || ([
"autoRestartDevServerWhenIdle",
"enableManagedSandboxOnly",
"enablePaperclipDeveloperMode",
"enableServerInfoDebugView",
"enableSmokeLab",
"enableIssuePlanDecompositions",
] satisfies InstanceFeatureKey[]).some(isVisible);
const showLegacySection = isVisible("enableClassicTaskInterface") || isVisible("enableGoalsSidebarLink");
return (
<div className="max-w-6xl space-y-6">
<div className="space-y-2">
<div className="flex items-center gap-2">
<FlaskConical className="h-5 w-5 text-muted-foreground" />
<h1 className="text-lg font-semibold">Experimental</h1>
</div>
<p className="text-sm text-muted-foreground">
Opt into features that are still being evaluated before they become default behavior.
</p>
</div>
<div
role="alert"
className="rounded-lg border border-amber-500/30 bg-amber-500/5 px-4 py-3"
>
<div className="flex items-start gap-3">
<AlertTriangle className="mt-0.5 h-4 w-4 shrink-0 text-amber-700" />
<div className="space-y-1 text-sm">
<p className="font-medium text-foreground">Experimental features may break at any time.</p>
<p className="text-muted-foreground">
These features are opt-in and come with no compatibility guarantees. They may change, break, or be
removed without notice. Avoid relying on them for critical or production workflows.
</p>
</div>
</div>
</div>
{actionError && (
<div className="rounded-md border border-destructive/40 bg-destructive/5 px-3 py-2 text-sm text-destructive">
{actionError}
</div>
)}
<section className="space-y-3" aria-labelledby="experimental-features-heading">
<div className="space-y-1">
<h2 id="experimental-features-heading" className="text-sm font-semibold">
Experimental features
</h2>
<p className="text-sm text-muted-foreground">
Optional product features that are still being evaluated.
</p>
</div>
<ExperimentalToggleCard
title="Agent Chat"
description="Talk to each agent in one ongoing conversation. Clarify goals and create tasks for execution. Chat leads the Work group and opens an agent rail beside the nav, and each chat's side panel shows the agent's tasks and artifacts as cards."
footnote="Turning this off preserves conversations and lets active runs finish, but prevents new messages."
checked={experimentalQuery.data?.enableAgentChat ?? false}
onCheckedChange={(checked) => toggleMutation.mutate({ enableAgentChat: checked })}
disabled={toggleMutation.isPending}
settingKey="enableAgentChat"
managed={managedKeys.enableAgentChat}
ariaLabel="Toggle agent chat experimental setting"
/>
<ExperimentalToggleCard
title="Artifacts V1"
description="Show artifacts the way the artifact directions lab settled: paper stacks and tiles on the Artifacts page, compact rows in the panel's Artifacts tab, and grouped rows in the task thread."
footnote="Presentation only. Turning this off restores the current cards; no data changes."
checked={experimentalQuery.data?.enableArtifactsV1 ?? false}
onCheckedChange={(checked) => toggleMutation.mutate({ enableArtifactsV1: checked })}
disabled={toggleMutation.isPending}
settingKey="enableArtifactsV1"
managed={managedKeys.enableArtifactsV1}
ariaLabel="Toggle artifacts V1 experimental setting"
/>
<ExperimentalToggleCard
title="Assistant connections (MCP)"
description="Connect Codex, Claude, and other assistants to your Paperclip organization. People sign in, select an organization once, and approve access to review work, delegate tasks, and add feedback."
footnote={<>Requires an authenticated instance with a configured public URL. Takes effect immediately. Turning this off blocks assistant calls and event delivery; work already delegated continues.{experimentalQuery.data?.enablePublicMcp && <> <Link className="underline" to="/apps/assistant-connection">Set up an assistant connection</Link></>}</>}
checked={experimentalQuery.data?.enablePublicMcp === true}
onCheckedChange={(checked) => toggleMutation.mutate({ enablePublicMcp: checked })}
disabled={toggleMutation.isPending}
settingKey="enablePublicMcp"
managed={managedKeys.enablePublicMcp}
ariaLabel="Toggle assistant connections experimental setting"
/>
<ExperimentalToggleCard
title="Beta skills"
description="Allow agents to pin beta releases of the Paperclip core skill. Disabling this returns every agent to the default live skill without removing saved pins."
checked={enableBetaSkills}
onCheckedChange={(checked) => toggleMutation.mutate({ enableBetaSkills: checked })}
disabled={toggleMutation.isPending}
settingKey="enableBetaSkills"
managed={managedKeys.enableBetaSkills}
ariaLabel="Toggle beta skills experimental setting"
/>
<ExperimentalToggleCard
title="Built-in Agents"
description="Show Paperclip-managed built-in agent surfaces, including built-in roster badges, the Built-in agents tab, and built-in agent setup controls."
checked={enableBuiltInAgents}
onCheckedChange={(checked) => toggleMutation.mutate({ enableBuiltInAgents: checked })}
disabled={toggleMutation.isPending}
settingKey="enableBuiltInAgents"
managed={managedKeys.enableBuiltInAgents}
ariaLabel="Toggle built-in agents experimental setting"
/>
<ExperimentalToggleCard
title="Cases"
description="Durable work products (blog posts, tweet storms…) that tasks create and iterate on. Adds the Cases tab and the agent case API."
footnote="Turning Cases off hides the tab and blocks the case API; existing case data is kept."
checked={enableCases}
onCheckedChange={(checked) => toggleMutation.mutate({ enableCases: checked })}
disabled={toggleMutation.isPending}
settingKey="enableCases"
managed={managedKeys.enableCases}
ariaLabel="Toggle cases experimental setting"
/>
<ExperimentalToggleCard
title="Chat connectors"
description="Connect agents to Slack, Discord, Microsoft Teams, and Telegram conversations."
footnote="Turning this off hides experimental chat setup and connected-task controls. Existing chat connections keep running. AgentMail, GitHub review bots, and tool connectors are controlled separately."
checked={enableChatConnectors}
onCheckedChange={(checked) => toggleMutation.mutate({ enableChatConnectors: checked })}
disabled={toggleMutation.isPending}
settingKey="enableChatConnectors"
managed={managedKeys.enableChatConnectors}
ariaLabel="Toggle chat connectors experimental setting"
/>
<ExperimentalToggleCard
title="Combined Inbox + Task List"
description="Fold Inbox into Tasks. One Tasks row carries the unread badge, and a Views menu reaches every inbox view (Mine, Unread, Blocked, Recent, Everything) and every task view."
footnote="Old Inbox links redirect to the matching view. Turning this off restores the separate Inbox; no data changes."
checked={experimentalQuery.data?.enableCombinedInboxTasks ?? false}
onCheckedChange={(checked) => toggleMutation.mutate({ enableCombinedInboxTasks: checked })}
disabled={toggleMutation.isPending}
settingKey="enableCombinedInboxTasks"
managed={managedKeys.enableCombinedInboxTasks}
ariaLabel="Toggle combined inbox and task list experimental setting"
/>
{SHOW_CONFERENCE_ROOM_EXPERIMENTAL_SETTING ? (
<ExperimentalToggleCard
title="Conference Room Chat"
description="Adds a Conference Room — one chat where you and your whole team work together — plus the live activity feed and the redesigned onboarding. Also restyles task threads as chat bubbles. Turn off anytime to restore the classic UI."
checked={enableConferenceRoomChat}
onCheckedChange={(checked) => toggleMutation.mutate({ enableConferenceRoomChat: checked })}
disabled={toggleMutation.isPending}
settingKey="enableConferenceRoomChat"
managed={managedKeys.enableConferenceRoomChat}
ariaLabel="Toggle conference room chat experimental setting"
/>
) : null}
<ExperimentalToggleCard
title="Decisions"
description="Show the Decisions item in the main sidebar — the attention home that surfaces the tasks awaiting your input — while the surface is still being evaluated."
checked={enableDecisions}
onCheckedChange={(checked) => toggleMutation.mutate({ enableDecisions: checked })}
disabled={toggleMutation.isPending}
settingKey="enableDecisions"
managed={managedKeys.enableDecisions}
ariaLabel="Toggle decisions experimental setting"
/>
<ExperimentalToggleCard
title="Enable Environments"
description="Show environment management in company settings and allow project and agent environment assignment controls."
checked={enableEnvironments}
onCheckedChange={(checked) => toggleMutation.mutate({ enableEnvironments: checked })}
disabled={toggleMutation.isPending}
settingKey="enableEnvironments"
managed={managedKeys.enableEnvironments}
ariaLabel="Toggle environments experimental setting"
/>
<ExperimentalToggleCard
title="Enable External Objects"
description="Detect external URLs in issues and show resolved status for pull requests, tickets, and other referenced work objects."
checked={enableExternalObjects}
onCheckedChange={(checked) => toggleMutation.mutate({ enableExternalObjects: checked })}
disabled={toggleMutation.isPending}
settingKey="enableExternalObjects"
managed={managedKeys.enableExternalObjects}
ariaLabel="Toggle external objects experimental setting"
/>
<ExperimentalToggleCard
title="Enable Isolated Workspaces"
description="Show execution workspace controls in project configuration and allow isolated workspace behavior for new and existing task runs."
checked={enableIsolatedWorkspaces}
onCheckedChange={(checked) => toggleMutation.mutate({ enableIsolatedWorkspaces: checked })}
disabled={toggleMutation.isPending}
settingKey="enableIsolatedWorkspaces"
managed={managedKeys.enableIsolatedWorkspaces}
ariaLabel="Toggle isolated workspaces experimental setting"
/>
<ExperimentalToggleCard
title="Experimental fast responses"
description="Allow short acknowledgements while agents begin work. Configure them in Settings → Connections."
checked={experimentalQuery.data?.enableFastResponses ?? false}
onCheckedChange={(checked) => toggleMutation.mutate({ enableFastResponses: checked })}
disabled={toggleMutation.isPending}
settingKey="enableFastResponses"
managed={managedKeys.enableFastResponses}
ariaLabel="Toggle fast responses experimental setting"
/>
<ExperimentalToggleCard
title="Experimental File Viewer"
description="Show task detail controls for browsing and previewing workspace files relative to a task."
checked={enableExperimentalFileViewer}
onCheckedChange={(checked) => toggleMutation.mutate({ enableExperimentalFileViewer: checked })}
disabled={toggleMutation.isPending}
settingKey="enableExperimentalFileViewer"
managed={managedKeys.enableExperimentalFileViewer}
ariaLabel="Toggle experimental file viewer setting"
/>
<ExperimentalToggleCard
title="First task: propose with a plan document"
description="When the user's first request is a single task, the chief of staff writes a short plan document and a checkbox card instead of a one-card confirmation. Applies to organizations created after the toggle is flipped."
checked={enableFirstTaskPlanProposal}
onCheckedChange={(checked) =>
toggleMutation.mutate({ enableFirstTaskPlanProposal: checked })
}
disabled={toggleMutation.isPending}
settingKey="enableFirstTaskPlanProposal"
managed={managedKeys.enableFirstTaskPlanProposal}
ariaLabel="Toggle first task plan proposal experimental setting"
/>
<ExperimentalToggleCard
title="GitHub review bots"
description="Connect agents to GitHub with their own App identity to review pull requests and respond to issues."
footnote="Independent of Chat connectors. Turning this off hides setup and management; existing bots keep running. GitHub tool connections stay available."
checked={experimentalQuery.data?.enableGitHubReviewBots === true}
onCheckedChange={(checked) => toggleMutation.mutate({ enableGitHubReviewBots: checked })}
disabled={toggleMutation.isPending}
settingKey="enableGitHubReviewBots"
managed={managedKeys.enableGitHubReviewBots}
ariaLabel="Toggle GitHub review bots experimental setting"
/>
<ExperimentalToggleCard
title="Grok Bot"
description="Connect an existing Grok Bot as an agent. Verify routine delivery and an authenticated reply before assigning work."
footnote="Requires Assistant connections (MCP), Paperclip Runner, and authenticated public HTTPS. Usage is not reported. Turning this off blocks Grok calls and new dispatch."
checked={experimentalQuery.data?.enableGrokBot === true}
onCheckedChange={checked => toggleMutation.mutate({ enableGrokBot: checked })}
disabled={toggleMutation.isPending}
settingKey="enableGrokBot" managed={managedKeys.enableGrokBot}
ariaLabel="Toggle Grok Bot experimental setting"
/>
<ExperimentalToggleCard
title="Memory connectors"
description="Connect Mem0, Zep, Supermemory, Cognee, and Honcho for long-term memory and context."
footnote="Turning this off hides setup for these connectors. Existing connections keep running."
checked={experimentalQuery.data?.enableMemoryConnectors === true}
onCheckedChange={(checked) => toggleMutation.mutate({ enableMemoryConnectors: checked })}
disabled={toggleMutation.isPending}
settingKey="enableMemoryConnectors"
managed={managedKeys.enableMemoryConnectors}
ariaLabel="Toggle memory connectors experimental setting"
/>
<ExperimentalToggleCard
title="Muse — Personal agent"
description="Connect your personal Meta Muse. Pair it, detect its receiver, and verify an independent background reply before assigning tasks."
footnote="Requires Paperclip Runner and an authenticated instance with a public HTTPS URL. Turning this off blocks new work; cleanup and stop evidence remain available. Provider usage and cost are unavailable."
checked={experimentalQuery.data?.enableMuse === true}
onCheckedChange={(checked) => toggleMutation.mutate({ enableMuse: checked })}
disabled={toggleMutation.isPending}
settingKey="enableMuse"
managed={managedKeys.enableMuse}
ariaLabel="Toggle Muse experimental setting"
/>
<ExperimentalToggleCard
title="OpenAI Dot"
description="Add OpenAI Dot as a standalone agent choice. Pair your Dot and verify event delivery before assigning work."
footnote="Requires Assistant connections (MCP) and an authenticated instance with a public HTTPS URL. Turning this off blocks Dot calls and new work; saved connections are kept."
checked={experimentalQuery.data?.enableOpenAiDot === true}
onCheckedChange={(checked) => toggleMutation.mutate({ enableOpenAiDot: checked })}
disabled={toggleMutation.isPending}
settingKey="enableOpenAiDot"
managed={managedKeys.enableOpenAiDot}
ariaLabel="Toggle OpenAI Dot experimental setting"
/>
<ExperimentalToggleCard
title="Paperclip Runner"
description="Allow agents to select Paperclip Runner, including authenticated runner ingress when a sandbox requires it. First-run setup offers qualified GitHub Copilot. Turning this off hides the choice without affecting existing native runs."
checked={enableNativeRunner}
onCheckedChange={(checked) =>
toggleMutation.mutate({ enableNativeRunner: checked })
}
disabled={toggleMutation.isPending}
settingKey="enableNativeRunner"
managed={managedKeys.enableNativeRunner}
ariaLabel="Toggle Paperclip Runner experimental setting"
/>
<ExperimentalToggleCard
title="Simplified English Interactions"
description="Instruct agents to write user interactions (plan confirmations, questions, suggested tasks, checkbox prompts) in ASD-STE100 Simplified Technical English, with brief context on what information the decision needs and what happens for each choice."
checked={enableSimplifiedEnglishInteractions}
onCheckedChange={(checked) =>
toggleMutation.mutate({ enableSimplifiedEnglishInteractions: checked })
}
disabled={toggleMutation.isPending}
settingKey="enableSimplifiedEnglishInteractions"
managed={managedKeys.enableSimplifiedEnglishInteractions}
ariaLabel="Toggle simplified english interactions experimental setting"
/>
<ExperimentalToggleCard
title="Status Cards"
description="Enable the experimental shared status-card board and its gated API. Existing card data is kept when this is disabled."
footnote="Enabling Status Cards also enables Summaries."
checked={enableStatusCards}
onCheckedChange={(checked) =>
toggleMutation.mutate(
checked
? { enableSummaries: true, enableStatusCards: true }
: { enableStatusCards: false },
)
}
disabled={toggleMutation.isPending || statusCardsBlockedByManagedSummaries}
settingKey="enableStatusCards"
managed={managedKeys.enableStatusCards}
ariaLabel="Toggle status cards experimental setting"
/>
<ExperimentalToggleCard
title="Streamlined UI"
description="Use the simplified main sidebar, shared Tasks and Inbox presentation, focused task detail layout, and contextual navigation across Agents, Routines, Skills, and Settings."
footnote="Turning this off restores the legacy shell and navigation. Task and page data are unchanged."
checked={enableStreamlinedUi}
onCheckedChange={(checked) => toggleMutation.mutate({ enableStreamlinedUi: checked })}
disabled={toggleMutation.isPending}
settingKey="enableStreamlinedUi"
managed={managedKeys.enableStreamlinedUi}
ariaLabel="Toggle Streamlined UI experimental setting"
/>
<ExperimentalToggleCard
title="Summaries"
description="Show Summarizer-generated status slots on project and workspace pages, with on-demand refresh and revision history. Existing summary data is kept when this is disabled."
footnote="Status Cards requires Summaries. Disabling Summaries also disables Status Cards."
checked={enableSummaries}
onCheckedChange={(checked) =>
toggleMutation.mutate(
checked || !enableStatusCards
? { enableSummaries: checked }
: { enableSummaries: false, enableStatusCards: false },
)
}
disabled={toggleMutation.isPending || summariesRequiredByManagedStatusCards}
settingKey="enableSummaries"
managed={managedKeys.enableSummaries}
ariaLabel="Toggle summaries experimental setting"
/>
{enableIsolatedWorkspaces && (
<ExperimentalToggleCard
title="Use Isolated Workspaces By Default"
description="Treat a project that has no execution workspace policy of its own as if it selected isolated workspaces, so its tasks get a per-task worktree instead of sharing the project checkout. A project that carries its own policy keeps it."
checked={enableIsolatedWorkspacesByDefault}
onCheckedChange={(checked) =>
toggleMutation.mutate({ enableIsolatedWorkspacesByDefault: checked })
}
disabled={toggleMutation.isPending}
settingKey="enableIsolatedWorkspacesByDefault"
managed={managedKeys.enableIsolatedWorkspacesByDefault}
ariaLabel="Toggle isolated workspaces by default experimental setting"
/>
)}
</section>
{showDeveloperSection ? (
<section className="space-y-3" aria-labelledby="developer-mode-heading">
<div className="space-y-1">
<h2 id="developer-mode-heading" className="text-sm font-semibold">
Paperclip Developer Mode
</h2>
<p className="text-sm text-muted-foreground">
Internal tools for developing, testing, and debugging Paperclip.
</p>
</div>
<ExperimentalToggleCard
title="Auto-Restart Dev Server When Idle"
description="In `pnpm dev:once`, wait for all queued and running local agent runs to finish, then restart the server automatically when backend changes or migrations make the current boot stale."
checked={autoRestartDevServerWhenIdle}
onCheckedChange={(checked) =>
toggleMutation.mutate({ autoRestartDevServerWhenIdle: checked })
}
disabled={toggleMutation.isPending}
settingKey="autoRestartDevServerWhenIdle"
managed={managedKeys.autoRestartDevServerWhenIdle}
ariaLabel="Toggle guarded dev-server auto-restart"
/>
<ExperimentalToggleCard
title="Managed Environment Only"
description="Hide the local environment and run all agents in the platform-managed environment."
checked={enableManagedSandboxOnly}
onCheckedChange={(checked) =>
toggleMutation.mutate({ enableManagedSandboxOnly: checked })
}
disabled={toggleMutation.isPending}
settingKey="enableManagedSandboxOnly"
managed={managedKeys.enableManagedSandboxOnly}
ariaLabel="Toggle managed environment only experimental setting"
/>
<ExperimentalToggleCard
title="Paperclip Developer Mode"
description="Show internal Paperclip maintainer tools and observability links, including Honeycomb trace queries on run pages."
checked={enablePaperclipDeveloperMode}
onCheckedChange={(checked) =>
toggleMutation.mutate({ enablePaperclipDeveloperMode: checked })
}
disabled={toggleMutation.isPending}
settingKey="enablePaperclipDeveloperMode"
managed={managedKeys.enablePaperclipDeveloperMode}
ariaLabel="Toggle Paperclip developer mode experimental setting"
/>
{showWorktreeRunExecution ? (
<Card className="block bg-transparent p-5">
<div className="flex flex-col gap-4">
<div className="flex items-start justify-between gap-4">
<div className="space-y-1.5">
<div className="flex flex-wrap items-center gap-2">
<h3 className="text-sm font-semibold">Run tasks in this worktree</h3>
{worktreeRunExecutionManaged ? <ManagedByCloudBadge /> : null}
</div>
<p className="max-w-2xl text-sm text-muted-foreground">
This is an isolated git-worktree preview instance. Turn this on to let the scheduler execute runs
here. Only tasks created after enabling will run automatically — copied/pre-existing tasks stay
parked. Toggling off and on resets the cutoff.
</p>
</div>
<ToggleSwitch
checked={enableWorktreeRunExecution}
onCheckedChange={(checked) => {
if (worktreeRunExecutionManaged) return;
toggleMutation.mutate({ enableWorktreeRunExecution: checked });
}}
disabled={toggleMutation.isPending || worktreeRunExecutionManaged}
aria-label="Toggle worktree run execution setting"
/>
</div>
{worktreeRunExecutionState.kind === "armed" ? (
<div className="flex items-center gap-2 rounded-md border border-emerald-500/30 bg-emerald-500/5 px-3 py-2 text-sm text-foreground">
<Play className="h-4 w-4 shrink-0 text-emerald-600" />
<span>
Running tasks created after{" "}
<span className="font-medium">
{formatActivationTimestamp(worktreeRunExecutionState.activatedAt)}
</span>
.
</span>
</div>
) : null}
{worktreeRunExecutionState.kind === "fail_closed" ? (
<div className="flex items-start gap-2 rounded-md border border-amber-500/30 bg-amber-500/5 px-3 py-2 text-sm">
<AlertTriangle className="mt-0.5 h-4 w-4 shrink-0 text-amber-700" />
<div className="space-y-0.5">
<p className="font-medium text-foreground">Execution is suppressed — effectively off.</p>
<p className="text-muted-foreground">
{worktreeRunExecutionState.reason === "instance_mismatch"
? "This setting was armed in a different instance and copied here, so no tasks run automatically."
: "This setting is missing its activation cutoff, so no tasks run automatically."}{" "}
Toggle it off and back on to arm execution for tasks created here.
</p>
</div>
</div>
) : null}
</div>
</Card>
) : null}
<ExperimentalToggleCard
title="Server Info Debug View"
description='Show a "Server" section in the account drawer with the current server restart time and running commit.'
checked={enableServerInfoDebugView}
onCheckedChange={(checked) =>
toggleMutation.mutate({ enableServerInfoDebugView: checked })
}
disabled={toggleMutation.isPending}
settingKey="enableServerInfoDebugView"
managed={managedKeys.enableServerInfoDebugView}
ariaLabel="Toggle server info debug view experimental setting"
/>
<ExperimentalToggleCard
title="Smoke Lab"
description='Add a "Smoke Lab" tab under Apps → Developer and an "Integration smoke" card on the dashboard for exercising every integration path against deterministic local fixtures (fake OAuth provider + loopback MCP servers). Private (non-public) deployments only.'
checked={enableSmokeLab}
onCheckedChange={(checked) => toggleMutation.mutate({ enableSmokeLab: checked })}
disabled={toggleMutation.isPending}
settingKey="enableSmokeLab"
managed={managedKeys.enableSmokeLab}
ariaLabel="Toggle smoke lab experimental setting"
/>
<ExperimentalToggleCard
title="Task Plan Decomposition"
description="Show accepted-plan decomposition history on task detail pages. Intended for debugging and validating subtask creation behavior while the presentation is still being refined."
checked={enableIssuePlanDecompositions}
onCheckedChange={(checked) =>
toggleMutation.mutate({ enableIssuePlanDecompositions: checked })
}
disabled={toggleMutation.isPending}
settingKey="enableIssuePlanDecompositions"
managed={managedKeys.enableIssuePlanDecompositions}
ariaLabel="Toggle task plan decomposition panel experimental setting"
/>
</section>
) : null}
{showLegacySection ? (
<section className="space-y-3" aria-labelledby="legacy-heading">
<div className="space-y-1">
<h2 id="legacy-heading" className="text-sm font-semibold">
Legacy
</h2>
<p className="text-sm text-muted-foreground">These features are going to be removed.</p>
</div>
<ExperimentalToggleCard
title="Classic Task Interface"
description="Restores the previous task detail page: the page-level header with inline description editing, the plain comment thread, and the fixed Properties sidebar. Chat-only features — streaming activity folding, inline plan and question cards, the three-mode composer — are unavailable in the classic view."
footnote="Switching takes effect immediately. No task data is affected."
checked={enableClassicTaskInterface}
onCheckedChange={(checked) =>
toggleMutation.mutate({ enableClassicTaskInterface: checked })
}
disabled={toggleMutation.isPending}
settingKey="enableClassicTaskInterface"
managed={managedKeys.enableClassicTaskInterface}
ariaLabel="Toggle classic task interface experimental setting"
/>
<ExperimentalToggleCard
title="Goals Sidebar Link"
description="Restore the Goals item in the main sidebar while the goals surface is being evaluated."
checked={enableGoalsSidebarLink}
onCheckedChange={(checked) =>
toggleMutation.mutate({ enableGoalsSidebarLink: checked })
}
disabled={toggleMutation.isPending}
settingKey="enableGoalsSidebarLink"
managed={managedKeys.enableGoalsSidebarLink}
ariaLabel="Toggle goals sidebar link experimental setting"
/>
</section>
) : null}
</div>
);
}