Files
PaperClipAI/ui/src/pages/InstanceExperimentalSettings.tsx
T
DottaandClaude Opus 5.5 904c01d1a3 feat(mcp): graduate Assistant connections (MCP) out of experimental (#22015)
## Thinking Path

> - Paperclip is the open source app people use to manage AI agents for
work
> - Assistant connections (MCP) let an outside assistant, or another
Paperclip instance, sign in as a person and use the `/mcp/paperclip`
endpoint
> - The feature was behind the experimental `enablePublicMcp` setting.
The setting was off by default and in practice off on Cloud stacks
> - Instance-to-instance work (one person's agent files a task on a
colleague's instance) fails when the receiving instance has the setting
off
> - This pull request moves the feature out of Experimental. It is now
always on, and a stored or Cloud-managed "off" value is ignored
> - The benefit is that every authenticated instance with a public URL,
including Cloud workspaces, accepts assistant connections with no setup
step

## Linked Issues or Issue Description

**Subsystem affected**
Public MCP (`server/src/services/public-mcp/`), instance settings,
Connectors → Assistant Connection (MCP) setup page, Experimental
settings page.

**Problem or motivation**
A remote MCP connector on one instance cannot use another instance's
`/mcp/paperclip` unless an admin on the other instance finds and turns
on an experimental toggle. On Cloud, the toggle is off and is managed by
the fleet. Instance-to-instance delegation therefore does not work by
default.

**Proposed solution**
Remove the gate. Keep `enablePublicMcp` only as a compatibility key, the
same way `enableApps` was graduated: old stored rows, PATCH bodies and
Cloud managed configs still parse, but the effective value is always
`true`.

**Alternatives considered**
An instance-admin kill switch that defaults ON. I did not keep one. Each
person already controls access: a connection exists only after that
person approves OAuth consent for one company, and the person or an
admin can revoke it. Deployment policy (authenticated mode and a valid
public URL) still decides whether the endpoint exists. A second switch
would add a state that can silently break instance-to-instance work
again. A schema migration was also not needed: the value lives in the
`experimental` JSON column, and the stored key becomes inert.

**Roadmap alignment**
Requested by the maintainer to enable instance-to-instance
communication.

## What Changed

- `packages/shared`: `enablePublicMcp` is a deprecated compatibility
key. The schema default is `true`. The feature catalog entry is
"Assistant connections (compatibility)" with both defaults `true`.
- `server` instance settings: normalization always returns
`enablePublicMcp: true`. The Cloud managed overlay skips the key, so a
fleet value of `false` cannot disable it. Removed the key from the Cloud
staging experimental-key list. Removed the client-mirror policy step
that ran only when the toggle changed.
- `server` public MCP: personal discovery, OAuth, tools, setup and event
delivery no longer read instance settings (`isEnabled()` returns `true`
for the personal endpoint without a DB read). Dot, Grok and Muse agent
connections keep their own experimental settings.
- `server` Cloud paths: the client-mirror sync, the hosted event
authority, the ingress-handoff expiry worker and the idle sleep proof
treat the front door as enabled. The warm-standby `503
workspace_unclaimed` behavior is unchanged.
- `server` Dot/Grok gates: they no longer also require
`enablePublicMcp`. Error messages no longer tell people to enable
Assistant connections.
- `ui`: removed the Experimental toggle, the "Enable assistant
connections / Open Experimental settings" block on the Assistant
Connection page, and the "Enable Assistant connections (MCP)" hint in
Dot setup. Updated the Dot and Grok copy.
- Storybook: deleted the Experimental-setting story and removed the
"enable the experiment" step from the journey and presenter.
- Docs: `doc/public-mcp.md` ("Enable an instance", "Start from
Connections", `GET /api/mcp/setup`), `doc/openai-dot-runner.md`,
`doc/idle-grok-dispatch.md`, and the agent-access map.
- Tests: new red/green tests for "enabled with no setting stored" and "a
stored or managed off value is ignored". Removed the tests for the
"disabled" behavior, which no longer exists.

## Verification

- Red/green: with the old source and the new tests,
`instance-settings-readonly.test.ts`,
`instance-settings-service.test.ts` and `public-mcp.test.ts` fail (4
failures, and the public-MCP suite fails in `beforeAll` because
`isEnabled()` was `false` with no setting stored). With the new source
they pass.
- `server`: `public-mcp.test.ts`, instance-settings (readonly, service,
managed overlay), `managed-config`, `cloud-event-authority`,
`events-work`, `dot-runner`, `dot-oauth-onboarding` and
`agent-runtime-assignments`. 354 passed.
- Cloud client-mirror lifecycle
(`client-mirror-lifecycle.postgres.test.ts`, skipped in CI) passed
against a local Postgres 17 with
`PAPERCLIP_MCP_SLEEP_TEST_DATABASE_URL`. 6/6, plus `events-work` 28/28.
- Idle and sleep: `idle-incoming-wake` (service and route),
`idle-deadline-proof`, `idle-incoming-wake-capability`,
`idle-sleep-proof`, `client-mirror-ack`, `recovery-deadline-acceptance`
and `idle-completed-history` pass. The warm-standby test now also
asserts that discovery after the claim does no SQL read.
- `ui`: `InstanceExperimentalSettings`, `AssistantConnection`,
`NewAgentDialog`, `NewAgent` and `ExternalAgentInviteDialog.muse` pass.
267 passed.
- Typecheck: `packages/shared`, `server` and `ui` pass. `node
scripts/check-maps.mjs` passes.
- `pnpm verify`: see the CI checks on this PR.
- After the deploy: confirm
`/.well-known/oauth-protected-resource/mcp/paperclip` and `/mcp/setup`
return 200 on paperclip.staging without changing any setting.

## Risks

- Behavior change: instances that had the setting off now serve
discovery, OAuth and `/mcp/paperclip`. Security invariants are
unchanged: the endpoint is still mounted only in authenticated mode with
a valid public URL, OAuth still needs a real signed-in user's consent,
local implicit board authority cannot approve, and revocation works the
same way.
- Cloud sleep: on a managed stack, the MCP sleep proof blocks sleep
until the client mirror publishes the tenant front door to Cloud. The
client-mirror sync runs at boot and does this once. Stacks that already
had the flag on use this path today. A stack whose Cloud connector
cannot publish the mirror would stay awake. Watch fleet sleep after the
deploy.
- Personal public-MCP requests now read instance settings one time less.
- Fleet admin: the Cloud fleet catalog can still show and set
`enablePublicMcp`. The value is ignored. Removing it from the fleet
catalog is a separate change in the Cloud repo.
- No migration. The `0354` trigger still compares the stored key. That
causes at most one extra connector-runtime invalidation if an old client
writes the key.

> For core feature work, check [`ROADMAP.md`](ROADMAP.md) first and
discuss it in `#dev` before opening the PR. Feature PRs that overlap
with planned core work may need to be redirected — check the roadmap
first. See `CONTRIBUTING.md`.

## Model Used

- Claude Opus 5.5 (`claude-opus-5-5`) in Claude Code, with tool use
(shell, file edits, test execution).

## 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
- [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
- [x] I have added or updated tests where applicable
- [x] I have updated relevant documentation to reflect my changes
- [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 Opus 5.5 <noreply@anthropic.com>
2026-11-17 11:42:36 -06:00

833 lines
42 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 { QueryErrorState, useQueryView } from "@/components/QueryView";
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 { ClassicWorkspaceSetting } from "@/components/ClassicWorkspaceSetting";
import { describeError } from "@/api/errors";
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 id={`experimental-${settingKey}`} className="block scroll-mt-4 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 experimentalView = useQueryView(experimentalQuery);
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(describeError(error).body);
},
});
if (experimentalQuery.isLoading || experimentalView.kind === "reconnecting") {
return (
<div className="max-w-6xl space-y-6">
<ClassicWorkspaceSetting key="personal-workspace" />
<div className="text-sm text-muted-foreground">Loading experimental settings...</div>
</div>
);
}
if (experimentalView.kind === "error") {
return (
<div className="max-w-6xl space-y-6"><ClassicWorkspaceSetting key="personal-workspace" /> <QueryErrorState
size="page"
error={experimentalQuery.error}
action="load experimental settings"
onRetry={experimentalView.retry}
retrying={experimentalView.isFetching}
/>
</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>
<ClassicWorkspaceSetting key="personal-workspace" />
<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="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="In the Classic workspace, fold Inbox into Tasks. One Tasks row carries the unread badge, and a Views menu reaches every personal and organization task view."
footnote="Coordinator always includes personal views in Tasks. For Classic, turning this off restores its 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="Command/Ctrl+Enter to Submit"
description="Restore the previous keyboard shortcut for task replies and new tasks: Command/Ctrl+Enter submits, and Enter adds a new line."
footnote="Off by default: Enter submits, and Shift+Enter adds a new line."
checked={experimentalQuery.data?.enableLegacyComposerSubmit === true}
onCheckedChange={(checked) => toggleMutation.mutate({ enableLegacyComposerSubmit: checked })}
disabled={toggleMutation.isPending}
settingKey="enableLegacyComposerSubmit"
managed={managedKeys.enableLegacyComposerSubmit}
ariaLabel="Toggle Command/Ctrl+Enter to submit"
/>
<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="Durable app actions (MCP Tasks)"
description="Let connected apps run long actions, such as CI runs or deploys, as tasks Paperclip keeps track of. If an action outlasts a call, a restart, or a deploy, the agent collects the result later and the work is never started twice."
footnote="Applies to apps that support MCP Tasks. Turning this off stops new tasks; apps then answer as before."
checked={experimentalQuery.data?.enableMcpTasks === true}
onCheckedChange={(checked) => toggleMutation.mutate({ enableMcpTasks: checked })}
disabled={toggleMutation.isPending}
settingKey="enableMcpTasks"
managed={managedKeys.enableMcpTasks}
ariaLabel="Toggle durable app actions 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="Google Workspace connector (Paperclip)"
description="Show the built-in Google Workspace connector for Gmail, Drive, and Calendar while Google verification is pending."
footnote="Off by default. While off, Google apps are offered through Composio and Arcade instead, and the built-in connector cannot be set up or run."
checked={experimentalQuery.data?.enableGoogleWorkspaceConnector === true}
onCheckedChange={(checked) => toggleMutation.mutate({ enableGoogleWorkspaceConnector: checked })}
disabled={toggleMutation.isPending}
settingKey="enableGoogleWorkspaceConnector"
managed={managedKeys.enableGoogleWorkspaceConnector}
ariaLabel="Toggle Paperclip Google Workspace connector 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 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 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>
);
}