mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-11-01 06:42:06 +01:00
## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work > - The left nav is the main way people move between tasks, the inbox, and Agent Chat > - The nav has separate Inbox and Tasks rows that show overlapping work, and Chat is one row among many > - The side panel beside a chat shows the conversation's own artifacts, not the work the agent did > - People want Chat to be easy to find, and they want one place for their task views > - This pull request moves Chat to the top of Work, shows the agent's tasks and artifacts beside each chat, and adds an experimental flag that folds Inbox into Tasks > - The benefit is a shorter nav and a chat view that shows what the agent is working on. Both changes stay off until an operator enables them ## Linked Issues or Issue Description Refs #14706 (the secondary Agent Chat navigation this change builds on) Refs #14848 (reopen the last visited agent chat) **Subsystem affected** UI navigation (left nav, mobile tab bar), Agent Chat side panel, task list and inbox, and the company artifacts API. **Problem or motivation** Inbox and Tasks are two nav rows for overlapping work. Chat sits in the top group with no clear home. The chat rail lists only agents you already talked to, so you cannot see your other teammates there. The side panel beside a chat shows only the conversation's own artifacts. It does not show the tasks and files the agent made. **Proposed solution** With Agent Chat on, Chat leads the Work section and the rail lists every eligible agent. The chat side panel opens on the agent's tasks as cards, and the agent's artifacts are available from +. A new experimental flag, Combined Inbox + Task List, makes Inbox a set of views inside Tasks. **Alternatives considered** Rebuilding the inbox inside the task list. Instead, `/issues` hosts the existing Inbox component for inbox views and the existing task list for status views, so all inbox behaviour stays the same. **Roadmap alignment** Agent Chat (ROADMAP.md, "Agent Chat (including CEO Chat)"). All changes are behind experimental flags that are off by default. ## What Changed - **Agent Chat nav (streamlined shell):** Chat is the first row of Work, not a top-group row. Workspaces leaves the nav while Agent Chat is on. The mobile tab bar is Home · Chat · + · Tasks · Agents. The legacy shell keeps master's top-group Chat row. - **Chat rail:** `AgentConversationsSidebar` lists every eligible agent. The open chat is first, then conversations by recent activity, then the rest of the roster alphabetically. Terminated agents and agents you left are omitted unless you have history with them. The picker still marks only real conversations as "Open chat". - **Chat side panel:** a new default Tasks tab shows one card per task the agent created, was assigned, commented on, or acted on, newest first. It has the task list's filter popover and a sort control. **+ → Artifacts** shows the agent's artifacts as cards. Cards open in a new tab. Agent Chat off keeps the old Artifacts tab. - **Artifacts API:** `GET /api/companies/:companyId/artifacts` accepts `agentId`. The filter applies to documents, work products, and attachments by the agent each result is attributed to. The shared validator and the UI client carry the new parameter, and the OpenAPI entry picks it up from the shared schema. - **Combined Inbox + Task List flag (`enableCombinedInboxTasks`, off by default):** new card in Settings > Experimental. The Inbox row goes away and its badge moves to Tasks. A Views menu on `/issues` covers Mine, Unread, Blocked, Recent, Everything, All, Active, Backlog, and Done. Bare `/issues` opens the last-used view (default Mine). Links that carry `assignee`, `workspace`, `participantAgentId`, or `q` open All so the filter is kept. `/inbox/*` and `/issues/{all,active,backlog,done,recent}` redirect to the matching view. `/inbox/requests` stays its own page. - **Task detail breadcrumb:** the view key now decides the source, so quick-archive still works after a reload from an inbox view. - **Docs:** `doc/PRODUCT.md` and `doc/SPEC.md` describe the chat rail, the chat side panel, and the new flag. ## Verification - `cd ui && npx vitest run --no-file-parallelism src/components/chat src/components/task-side-panel/TaskSidePanel.test.tsx src/components/AgentConversationsSidebar.test.tsx src/components/Sidebar.test.tsx src/components/SidebarCompanyMenu.test.tsx src/components/Layout.test.tsx src/pages/AgentChats.test.tsx src/pages/InstanceExperimentalSettings.test.tsx src/lib/task-views.test.ts src/lib/issueDetailBreadcrumb.test.ts src/pages/Inbox.test.tsx src/pages/Issues.test.tsx src/App.test.tsx src/App.activity-routing.test.tsx src/components/MobileBottomNav.test.tsx src/components/CommandPalette.test.tsx`: 20 files, 356 tests pass. - `cd server && npx vitest run src/__tests__/company-artifacts-service.test.ts`: 13/13 pass, including the new agent-filter test across all three artifact sources. - The new rail test fails against the unmodified rail. - `pnpm check:token-gates`: all gates clean. - Manual: enable Agent Chat in Settings > Experimental. Open Chat. The rail lists all agents. Open a chat. The side panel shows the agent's tasks. Use **+ → Artifacts** to see the agent's artifacts. Then enable Combined Inbox + Task List. The Inbox row goes away, and Tasks shows a Views menu. - Snapshot baselines are intentionally not updated. See `doc/design/DECISION-SHEET.md`, "Per-change snapshot verification demoted to dormant (Jul 13 2026)". ## Risks - With both flags off, the app behaves like master. The only exception is the API: it accepts a new optional query parameter. - With Agent Chat on, the rail can list many agents in a large company. It uses the agent list the app already loads, and search filters it. - The Tasks panel reads at most 200 recently updated tasks per agent and says so when it reaches the limit. The Artifacts panel reads at most 500 of the agent's artifacts. - Combined Inbox + Task List changes what bare `/issues` opens for people who enable it. Deep links with a task filter still open All. ## Model Used - Claude (Anthropic), model ID `claude-opus-5-5`, through Claude Code with tool use (shell, file edit, test runs). Extended thinking was enabled. ## 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: scotttong <squadbot000@gmail.com> Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
735 lines
36 KiB
TypeScript
735 lines
36 KiB
TypeScript
import { useEffect, useState } 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";
|
|
|
|
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?: string;
|
|
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="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, GitHub, 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 tools, and other tool connectors stay available."
|
|
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 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="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="Paperclip Runner"
|
|
description="Allow new Codex agents to select the experimental Rust Paperclip Runner, including authenticated runner ingress when a sandbox requires it. Onboarding continues to use legacy adapters. 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>
|
|
);
|
|
}
|