mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-11-04 19:28:46 +01:00
## Thinking Path > - Paperclip manages AI agents that perform work for a company. > - The shared Runner owns task admission, authority, receipts and finalization. > - An existing Grok Bot needs to receive assignments and return results through that Runner. > - The Bot also needs governed access when it starts work from its own conversation. > - This PR adds agent-purpose MCP access and routine webhook dispatch. > - It reuses the external-agent Rust Runner and keeps Grok capabilities explicit. > - The provider stays experimental until the real-client managed journeys pass. ## Linked Issues or Issue Description **Agent or provider** Grok Bot, distinct from the Grok Build coding runtime in #13882. **Why this adapter is useful** Users can assign work to an existing Bot, receive progress, questions, documents and files in Paperclip, and let the Bot initiate work under its agent permissions. **How the agent is invoked** A webhook-only routine delivers bounded references. Dedicated named-agent OAuth and MCP provide inbound calls. Setup follows [Grok routines](https://cursor.com/help/grok-bot/routines) and [custom plugins](https://cursor.com/help/grok-bot/connect-plugins). The current desktop app needs its Bot-generated Webhook URL navigation link when routine-row clicks fail. The GitHub search found related Grok Build runtime work, but no existing Grok Bot agent provider. This extends the roadmap’s existing agent, Runner, governance and artifact foundations. ## What Changed - Add default-off Grok Bot participation through the shared real Rust external backend, preserving native provider identity guarantees and distinguishing session closure from remote termination. - Bind agent OAuth to company, agent, client, gateway and authorizer; recheck permissions and task-bound execution authority without manufacturing a native identity. - Persist routine configuration, dispatch intents, authenticated acknowledgement and recovery holds. Store URL/key together in encrypted secret storage, use guarded public egress, and never automatically replay ambiguous HTTP delivery. - Reuse native tools, durable waiting, completion assessment and review. Add task-bound file grants through existing artifact storage; suppress proactive echo dispatch and synchronous result wake loops. - Enforce the current native deliverable work-mode policy at file-ticket issuance and use. Add operator retries for confirmed rejected wakes, with retained receipts, stable retry intent and current-authority checks. Recovery locks bindings before routine rows. Thread Stop resolves the selected run and its agent. - Cancel queued and preparing Stop targets before assignment creation, restore saved setup after a failed request and successful retry, and publish the Grok provider descriptor schema. Advance the versioned Copilot source declaration for the shared schema change; its qualification remains pending. - Filter task summaries with the shared privacy policy, preserve feedback admission when wake delivery is blocked, reconcile settled delivery receipts without restoring work authority, and bind every Stop control to its displayed run. Recovery records distinguish dispatch uncertainty from a revoked session. - Add resumable guided setup, credential replacement, consent, management, observed work status and stop/recovery controls, plus an interactive Storybook journey using the production task thread, question form and report card. Grok’s own apps remain available; Paperclip workspace and third-party tools are deferred. ## Verification - Five focused protocol, authorization, person MCP and Runner files: 192 tests pass. The Grok assigned-work case executes the actual Rust Runner, saves a document, uploads/deduplicates a file and reaches ordinary finalization. - Proactive intake/deduplication and renewed-session recovery pass. These use scripted clients and synthetic storage; they are not real-provider acceptance. - Repository typecheck, production build, token gates, map checks and Storybook build/catalog checks pass. The local full-suite campaign was stopped after macOS shared-memory exhaustion repeatedly prevented embedded PostgreSQL startup. No local aggregate pass is claimed. The first clean-worker CI run identified avatar fixture/configuration, flag defaults, feature-card ordering and OpenAPI route-coverage gaps; all four focused regressions pass after correction. Those regressions pass. The latest clean-worker CI run also found a Copilot source-hash declaration mismatch after the shared descriptor update; the corrected declaration passes all 28 integrity tests. The next review corrections pass 144 rendered UI tests, 21 OpenAPI tests and 82 Runner contract/integrity/history tests. The latest database fixtures were blocked at startup by host shared-memory exhaustion; clean-worker CI must execute their new regressions. Full current-head CI now passes: 54 successful checks and four intentional skips. The database regression uses the PostgreSQL driver result shape; file-policy, rejected-feedback and lock-order cases pass on clean workers. Current-head Greptile is 5/5 with no unresolved findings. - Rendered setup steps and outbound-only verification were walked through in Storybook. Simulation cannot enable Done without an authenticated-reply state. - Actual client OAuth, continued access, reconnect and one routine wake with an exact chat acknowledgement were observed separately. This candidate’s live authenticated challenge, assigned/proactive workflows, Linux managed artifact, restart and cleanup are not yet qualified. The provider stays disabled by default. - The separate Cloud ingress change forwards only exact task-bound upload/download paths and preserves host identity and header stripping. - Current Cloud policy reserves Test for pre-merge app/harness experiments; Staging accepts only master-derived revisions. Real-client qualification needs a supported, authorized deployment target and remains outstanding. ## Risks One append-only migration adds routine/dispatch state and extends shared bindings and file tickets. The unshipped migrations were regenerated after upstream consumed their original numbers. Rolling back code retains the durable rows; revoke grants and inspect unknown remote activity before resuming dispatch. Grok cannot confirm remote termination, stream its complete transcript or report spending. Plugins are account-wide and do not isolate credentials between Bots. Real-client managed acceptance remains required before enabling the experimental provider. ## Model Used OpenAI Codex based on GPT-6, with reasoning, code execution and browser/native UI tools. The exact deployment model ID and context-window size are not exposed by this runtime. ## 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 - [x] All Paperclip CI gates are green - [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge --------- Co-authored-by: Paperclip <noreply@paperclip.ing>
796 lines
40 KiB
TypeScript
796 lines
40 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="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="Show Connections in company settings and allow short acknowledgements while agents begin work."
|
|
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="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 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>
|
|
);
|
|
}
|