Files
PaperClipAI/ui/src/components/task-chat/TaskChatCompactInteractionCard.tsx
T
43b2d8be22 feat(dashboard): add an experimental areas and responsibilities dashboard (#22069)
## Thinking Path

> - Paperclip is the open source app people use to manage AI agents for
work
> - The dashboard is the first page a person sees in a company
> - The classic dashboard shows agents, runs, costs and recent tasks
> - It does not show what the person is responsible for, or if that work
goes well
> - People think in areas, such as Fundraising or Customers, and in the
things they own in each area
> - This pull request adds a dashboard built on areas and
responsibilities, behind an experimental setting that is off by default
> - The benefit is that a person sees what they own, how it is going,
and what agents do for it, on one page

## Linked Issues or Issue Description

No public issue exists for this work. The description follows the
feature request template.

**Subsystem affected**

Dashboard, navigation, the task conversation, routines, and the instance
experimental settings.

**Problem or motivation**

The classic dashboard counts agents and tasks. It does not say what a
person owns or if it goes well. People who run a company with agents
want to see their areas, the responsibilities in each area, the bar each
one must meet, and the agents and routines that serve it.

**Proposed solution**

A person owns responsibilities. Each responsibility belongs to an area
and has a bar, a number to reach. Projects, tasks and routines link to a
responsibility, and the page shows its status from those links. An agent
can interview the person and draft the dashboard. The person accepts or
declines each change, and any change can be undone from a saved version.

**Alternatives considered**

Add the same data to the classic dashboard. That page is a fixed set of
cards for company activity, so a second, person-centred page is clearer.
The setting lets a person pick one of the two.

**Roadmap alignment**

This is an experimental feature behind `enableResponsibilities`. It is
off by default and changes nothing for a person who leaves it off.

## What Changed

- Add the setting "Areas & Responsibilities dashboard"
(`enableResponsibilities`, off by default). On, Dashboard in the sidebar
opens the new page, and the classic dashboard link is not shown in the
sidebars or the command palette. Off, nothing changes.
- Add tables and migrations 0492 to 0497 for areas, responsibilities,
links to work, metrics, status reports, saved dashboard versions, and
model-call records for summaries.
- Add the API: areas, responsibilities, links, bars, metrics, status
reports, summaries, runs, automation, and the dashboard conversation
with versions and undo. Each route checks company access and writes to
the activity log.
- Add four task conversations with an agent: about a bar, about an
automation, about a routine, and about the whole dashboard. The agent
proposes a change. Nothing applies until a person accepts it.
- Add standing checks: routines that an agent carries out on its
heartbeat and reports.
- Add the Dashboard page: search, counts, areas that open and close, a
primary New area button, and a message box at the bottom of the page.
Add the responsibility page with its bar, metrics, work and routines.
- Add the Paperclip skill sections and runner API entries that let an
agent use these routes. The runner skill inventory is regenerated (166
to 174 rows).
- Keep the new runner API tests in their own file so
`runner-api.test.ts` stays at 985 lines.
- Onboarding is not changed. The onboarding changes that build on this
work are a separate pull request.

## Verification

- Type checks pass for `packages/db`, `packages/shared`, `server` (all
layers) and `ui`.
- `pnpm --filter @paperclipai/db check:migrations` passes. A new
`drizzle-kit generate` run produces no further change.
- Tests for every changed file pass: 26 server test files (3,009 tests),
116 UI test files (1,991 tests) and 28 shared test files (432 tests).
- The runner capability inventory checks pass.
- I started the app on a local database that already held earlier data.
Master's new migrations and these migrations applied without error. With
the setting on, the Dashboard and a responsibility page loaded with no
console or server errors. The More menu and the command palette show one
Dashboard.
- I did not run `pnpm verify`, the full local suite, or the browser
suites. Required CI covers them.
- The agent conversations are tested with simulated agents. No real
model has run them.

## Risks

- Medium. The change is large, and the setting is off by default. With
it off, the new routes refuse requests and the UI is unchanged.
- Migrations only add tables and columns. Two replace a CHECK
constraint, and one builds an index `CONCURRENTLY`. These two have the
`online_compatible` override with a reason in the file, and the second
one is listed in `MIGRATIONS_WITH_TOP_LEVEL_STATEMENTS`.
- Master can add migrations before this merges. The migrations then need
new numbers.
- `responsibilities.ts` (1,663 lines), `responsibility-summaries.ts`
(1,239 lines) and one Storybook fixture file (1,305 lines) are new files
over 1,000 lines. They each keep one cohesive unit together: the service
for one table family, the model-call path for summaries, and the
fixtures that the stories share. No existing file crosses 1,000 lines.

> 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

- Anthropic Claude: Claude Fable 5.2 (`claude-fable-5-2`) wrote most of
the change, with Claude Sonnet 5.5 (`claude-sonnet-5-5`) for the final
steps. Both used tool use, code execution and browser checks.

## 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
- [ ] 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
- [ ] I will address all Greptile and reviewer comments before
requesting merge

---------

Co-authored-by: Scott Tong <scott@scottsmbpm5max.lan>
Co-authored-by: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-17 20:45:44 -08:00

2163 lines
73 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { itemVerdictHref } from "@/lib/item-verdict-links";
import { Link } from "@/lib/router";
import {
useEffect,
useMemo,
useState,
type ComponentProps,
type ReactNode,
} from "react";
import {
Check,
CheckCircle2,
ChevronDown,
ChevronLeft,
ChevronRight,
Circle,
CircleHelp,
GitBranch,
ListChecks,
Loader2,
MessageSquareQuote,
Plug,
Repeat,
LayoutList,
Search,
Target,
X,
Zap,
} from "lucide-react";
import type { IssueDocument } from "@paperclipai/shared";
import type {
PaperclipQuestionResponse,
PaperclipQuestionSet,
} from "@paperclipai/adapter-utils";
import { InteractionPreparationNotice } from "@/components/InteractionPreparationNotice";
import { IssueThreadInteractionCard } from "@/components/IssueThreadInteractionCard";
import { ToolActionAuditHashCopy } from "@/components/ToolActionAuditHashCopy";
import { ConnectionIntentInteractionBody } from "@/features/connections/ConnectionIntentInteractionBody";
import { RoutineSuggestionCard } from "@/components/RoutineSuggestionCard";
import { BarProposalCard } from "@/components/responsibilities/BarProposalCard";
import { AutomationProposalCard } from "@/components/responsibilities/AutomationProposalCard";
import { DashboardChangesCard } from "@/components/responsibilities/DashboardChangesCard";
import { MarkdownBody } from "@/components/MarkdownBody";
import type { MentionOption } from "@/components/MarkdownEditor";
import { Button } from "@/components/ui/button";
import { Checkbox } from "@/components/ui/checkbox";
import { Textarea } from "@/components/ui/textarea";
import { Input } from "@/components/ui/input";
import { describeInteractionAudience } from "@/lib/interaction-audience";
import { interactionResolutionErrorMessage } from "@/lib/interaction-resolution-error";
import {
clearDraft,
loadStructuredDraft,
saveStructuredDraft,
} from "@/lib/composer-draft";
import {
isInteractionPreparingApproval,
buildIssueThreadInteractionSummary,
buildSuggestedTaskTree,
collectSuggestedTaskClientKeys,
normalizeRequestConfirmationTargetHref,
type AskUserQuestionsAnswer,
type AskUserQuestionsInteraction,
type IssueThreadInteraction,
type RequestCheckboxConfirmationInteraction,
type RequestConfirmationInteraction,
type RequestItemVerdictsInteraction,
type RequestItemVerdictValue,
type SuggestTasksInteraction,
type SuggestedTaskTreeNode,
} from "@/lib/issue-thread-interactions";
import { claimReviseDraftWork, clearReviseDraft, getReviseDraft, releaseReviseDraftWork, reviseDraftKey, updateReviseDraft, useReviseDraft } from "@/lib/revise-draft-store";
import { cn } from "@/lib/utils";
import { QuestionForm } from "./QuestionForm";
import { useCoordinatorWorkspaceEnabled } from "@/hooks/useCoordinatorWorkspaceEnabled";
import { CoordinatorTaskCommitment } from "@/components/coordinator/CoordinatorTaskCommitment";
import { CoordinatorInteractionReceipt } from "@/components/coordinator/CoordinatorInteractionReceipt";
import { useCoordinatorPresentation } from "@/components/coordinator/CoordinatorPresentation";
import { decisionReceiptHref } from "@/lib/decision-receipt-navigation";
import {
TaskChatComposerTakeoverControls,
TaskChatComposerTakeoverHeader,
useTaskChatComposerTakeoverActions,
} from "./TaskChatComposerTakeoverContext";
import { TaskChatPlanPreviewCard } from "./TaskChatPlanPreviewCard";
import { TaskChatRichInput } from "./TaskChatRichInput";
import { ANALYTICS_MASK_CLASS } from "@/lib/analytics/privacy";
const TAKEOVER_TEXTAREA_CLASS =
"min-h-16 resize-y border-0 bg-muted/35 text-sm shadow-none focus-visible:ring-0 focus-visible:ring-offset-0";
type SharedInteractionProps = Omit<
ComponentProps<typeof IssueThreadInteractionCard>,
"interaction" | "primaryActionOnRight"
>;
export interface TaskChatCompactInteractionCardProps extends SharedInteractionProps {
interaction: IssueThreadInteraction;
planDocument?: IssueDocument | null;
showPlanPreview?: boolean;
presentation?: "timeline" | "takeover";
draftKey?: string;
mentions?: MentionOption[];
}
const KIND_COPY = {
suggest_tasks: {
fallbackTitle: "Suggested tasks",
label: "Tasks",
icon: GitBranch,
},
ask_user_questions: {
fallbackTitle: "Questions",
label: "Questions",
icon: CircleHelp,
},
request_confirmation: {
fallbackTitle: "Confirmation",
label: "Confirmation",
icon: CheckCircle2,
},
request_checkbox_confirmation: {
fallbackTitle: "Choose options",
label: "Selection",
icon: ListChecks,
},
request_item_verdicts: {
fallbackTitle: "Review items",
label: "Review",
icon: MessageSquareQuote,
},
connection_intent: {
fallbackTitle: "Connect service",
label: "Connection",
icon: Plug,
},
suggest_routine: {
fallbackTitle: "Routine offer",
label: "Routine",
icon: Repeat,
},
propose_responsibility_bar: {
fallbackTitle: "Proposed bar",
label: "Bar",
icon: Target,
},
propose_automation: {
fallbackTitle: "Proposed automation",
label: "Automation",
icon: Zap,
},
propose_dashboard_changes: {
fallbackTitle: "Proposed dashboard changes",
label: "Dashboard",
icon: LayoutList,
},
} as const;
function statusLabel(status: IssueThreadInteraction["status"]): string {
return status.replaceAll("_", " ");
}
function statusTone(status: IssueThreadInteraction["status"]): string {
if (status === "pending") return "text-(--status-agent-running)";
if (status === "accepted" || status === "answered")
return "text-(--status-task-icon-done)";
if (status === "rejected" || status === "failed") return "text-destructive";
return "text-muted-foreground";
}
function StatusIcon({ status }: { status: IssueThreadInteraction["status"] }) {
if (status === "pending") {
return (
<Circle
aria-hidden
className={cn("h-3.5 w-3.5 fill-current", statusTone(status))}
/>
);
}
if (status === "accepted" || status === "answered") {
return (
<Check aria-hidden className={cn("h-3.5 w-3.5", statusTone(status))} />
);
}
if (status === "rejected" || status === "failed") {
return <X aria-hidden className={cn("h-3.5 w-3.5", statusTone(status))} />;
}
return (
<Circle aria-hidden className={cn("h-3.5 w-3.5", statusTone(status))} />
);
}
function InteractionShell({
interaction,
audienceLabel,
presentation,
children,
}: {
interaction: IssueThreadInteraction;
audienceLabel?: string | null;
presentation: "timeline" | "takeover";
children: ReactNode;
}) {
const kind = KIND_COPY[interaction.kind];
const Icon = kind.icon;
const title = (
<div className="flex min-w-0 items-center gap-2">
<Icon aria-hidden className="h-4 w-4 shrink-0 text-muted-foreground" />
<strong className="min-w-0 truncate text-sm font-medium text-foreground">
{interaction.title ?? kind.fallbackTitle}
</strong>
{interaction.kind === "request_confirmation" &&
interaction.payload.target?.type === "issue_document" &&
interaction.payload.target.key === "plan" ? (
<CompactTarget interaction={interaction} />
) : null}
{interaction.status !== "pending" ? (
<span
className="inline-flex shrink-0 items-center gap-1 text-xs capitalize text-muted-foreground"
data-testid="interaction-status-badge"
>
<StatusIcon status={interaction.status} />
{statusLabel(interaction.status)}
</span>
) : null}
</div>
);
return (
<article
className={cn(
"overflow-hidden",
presentation === "timeline" &&
"rounded-md border border-border bg-card/60",
)}
>
{presentation === "takeover" ? (
<TaskChatComposerTakeoverHeader>{title}</TaskChatComposerTakeoverHeader>
) : (
<header className="flex min-w-0 items-start gap-2 px-3 py-2.5">
<div className="min-w-0 flex-1">
{title}
{audienceLabel ? (
<p className="mt-0.5 pl-6 text-xs text-muted-foreground">
{audienceLabel}
</p>
) : null}
</div>
</header>
)}
<div
className={
presentation === "timeline"
? "border-t border-border/70 px-3 py-3"
: undefined
}
>
{children}
</div>
</article>
);
}
function InteractionActionError({ message }: { message: string | null }) {
return (
<div aria-live="assertive" data-testid="interaction-action-error">
{message ? (
<div className="mt-2 rounded-sm border border-destructive/60 bg-destructive/10 px-2.5 py-2 text-sm text-destructive">
{message}
</div>
) : null}
</div>
);
}
function Details({ children }: { children?: ReactNode }) {
if (!children) return null;
return (
<details className="mt-2">
<summary className="flex cursor-pointer list-none items-center gap-1 text-xs font-medium text-muted-foreground">
<ChevronDown aria-hidden className="h-3.5 w-3.5" /> Details
</summary>
<div className="mt-2 rounded-sm bg-muted/40 px-2.5 py-2 text-sm text-muted-foreground">
{children}
</div>
</details>
);
}
function ActionRow({
children,
hint,
}: {
children: ReactNode;
hint?: string | null;
}) {
return (
<div className="mt-3 flex flex-wrap items-center gap-2">
{hint ? (
<span className="mr-auto text-xs text-muted-foreground">{hint}</span>
) : (
<span className="mr-auto" />
)}
{children}
</div>
);
}
function targetLabel(
interaction:
| RequestConfirmationInteraction
| RequestCheckboxConfirmationInteraction
| RequestItemVerdictsInteraction,
) {
const target = interaction.payload.target;
if (!target) return null;
// A custom target key is a machine identifier for idempotency and stale
// detection (e.g. `github:org/repo:pull:16`), not display copy. Only show a
// custom target when the agent supplied a human label.
if (target.type === "custom" && !target.label) return null;
const label = target.label ?? (target.type === "issue_attachment" ? "Attachment" : target.key);
const revision =
target.type === "issue_attachment" || target.revisionNumber == null ? null : `v${target.revisionNumber}`;
return [label, revision].filter(Boolean).join(" · ");
}
function CompactTarget({
interaction,
}: {
interaction:
| RequestConfirmationInteraction
| RequestCheckboxConfirmationInteraction
| RequestItemVerdictsInteraction;
}) {
const target = interaction.payload.target;
const label = targetLabel(interaction);
if (!target || !label) return null;
const href = target.type === "issue_attachment"
? `/api/attachments/${encodeURIComponent(target.attachmentId)}/content`
: target.href ? normalizeRequestConfirmationTargetHref(target.href)
// A document on this chat opens in its document panel, like a reply's
// `#document-<key>` link, so the person can read what they are asked to review.
// Plan reviews keep their header chip; their plan preview opens the plan.
: target.type === "issue_document" && target.key !== "plan" && (target.issueId ?? interaction.issueId) === interaction.issueId
? `#document-${encodeURIComponent(target.key)}`
: null;
if (href) {
return (
<a
href={href}
target={target.type === "issue_attachment" ? "_blank" : undefined}
rel={target.type === "issue_attachment" ? "noreferrer" : undefined}
className="inline-flex rounded-sm border border-border px-2 py-0.5 font-mono text-xs text-foreground hover:bg-muted/60"
>
{label}
</a>
);
}
return (
<span className="inline-flex rounded-sm border border-border px-2 py-0.5 font-mono text-xs text-muted-foreground">
{label}
</span>
);
}
function PlanReviewPreview({
interaction,
planDocument,
}: {
interaction: RequestConfirmationInteraction;
planDocument?: IssueDocument | null;
}) {
const coordinator = useCoordinatorPresentation();
const target = interaction.payload.target;
if (target?.type !== "issue_document" || target.key !== "plan") return null;
const targetRevisionId = target.revisionId ?? null;
const targetRevision = target.revisionNumber ?? null;
const documentMatchesTarget = Boolean(
planDocument &&
(targetRevisionId != null
? planDocument.latestRevisionId === targetRevisionId
: targetRevision == null ||
planDocument.latestRevisionNumber === targetRevision),
);
return (
<TaskChatPlanPreviewCard
source={{
kind: "saved",
document: documentMatchesTarget ? planDocument : null,
revision: targetRevision,
fallbackTitle: target.label,
}}
href={coordinator ? decisionReceiptHref({ issueHref: `/issues/${interaction.issueId}`, interactionId: interaction.id, target }) : "#document-plan"}
testId="plan-review-preview"
ariaLabel={`Open ${target.label ?? (targetRevision == null ? "plan" : `plan revision ${targetRevision}`)}`}
/>
);
}
/** Plan approvals read as decisions on a named plan revision, not a generic confirmation. */
function planReviewReceiptSummary(interaction: IssueThreadInteraction, reason: string | null): string | null {
if (interaction.kind !== "request_confirmation") return null;
const target = interaction.payload.target;
if (target?.type !== "issue_document" || target.key !== "plan") return null;
const plan = target.revisionNumber == null ? "the plan" : `Plan v${target.revisionNumber}`;
if (interaction.status === "accepted") return `Approved ${plan}`;
if (interaction.status === "rejected") return reason ? `Requested changes to ${plan}: ${reason}` : `Requested changes to ${plan}`;
return null;
}
function receiptReason(interaction: IssueThreadInteraction): string | null {
const result = interaction.result;
if (!result) return null;
if ("reason" in result && typeof result.reason === "string")
return result.reason;
if (interaction.kind === "ask_user_questions") {
return (
interaction.result?.cancellationReason ??
interaction.result?.expirationReason?.replaceAll("_", " ") ??
null
);
}
return null;
}
function ReceiptDisclosure({
interaction,
externalReferences,
compact = false,
}: {
interaction: IssueThreadInteraction;
externalReferences?: SharedInteractionProps["externalReferences"];
compact?: boolean;
}) {
const reason = receiptReason(interaction);
const answerReason =
reason ??
(interaction.kind === "suggest_tasks"
? (interaction.result?.rejectionReason ?? null)
: null);
let request: ReactNode;
if (interaction.kind === "ask_user_questions") {
const questionSet = questionSetForInteraction(interaction);
const response = questionResponseForInteraction(interaction, questionSet);
request = (
<div className="grid gap-3">
{questionSet.description ? (
<p className="text-sm text-muted-foreground">
{questionSet.description}
</p>
) : null}
{questionSet.questions.map((question) => {
const answer = response?.answers[question.id];
const selected = (answer?.selectedOptionIds ?? []).map(
(optionId) =>
question.options?.find((option) => option.id === optionId)
?.label ?? optionId,
);
const values = [...selected, answer?.text, answer?.customText].filter(
(value): value is string => Boolean(value),
);
return (
<div key={question.id}>
{question.header ? (
<p className="text-xs font-medium text-muted-foreground">
{question.header}
</p>
) : null}
<p className="text-sm text-foreground">{question.prompt}</p>
{question.helpText ? (
<p className="mt-0.5 text-xs text-muted-foreground">
{question.helpText}
</p>
) : null}
<p className="mt-1 text-sm font-medium text-foreground">
Answer: {values.length > 0 ? values.join(", ") : "No answer"}
</p>
</div>
);
})}
</div>
);
} else if (interaction.kind === "request_checkbox_confirmation") {
const selected = new Set(interaction.result?.selectedOptionIds ?? []);
const selectedLabels = interaction.payload.options
.filter((option) => selected.has(option.id))
.map((option) => option.label);
request = (
<div>
<MarkdownBody className="text-sm text-foreground" externalReferences={externalReferences} mediaMode="reference">
{interaction.payload.prompt}
</MarkdownBody>
{interaction.status === "accepted" ? (
<p className="mt-1 text-sm font-medium text-foreground">
Answer:{" "}
{selectedLabels.length > 0
? selectedLabels.join(", ")
: "No options selected"}
</p>
) : null}
{interaction.payload.detailsMarkdown ? (
<div className="mt-2 text-sm">
<MarkdownBody externalReferences={externalReferences}>
{interaction.payload.detailsMarkdown}
</MarkdownBody>
</div>
) : null}
</div>
);
} else if (interaction.kind === "request_item_verdicts") {
const verdicts = new Map(
(interaction.result?.items ?? []).map((item) => [item.id, item]),
);
const decidedItems = interaction.payload.items.filter((item) =>
verdicts.has(item.id),
);
request = (
<div>
<p className="text-sm text-foreground">{interaction.payload.prompt}</p>
{decidedItems.length > 0 ? (
<ul className="mt-2 grid gap-1 text-sm">
{decidedItems.map((item) => {
const verdict = verdicts.get(item.id);
return (
<li key={item.id}>
<span className="font-medium">{item.label}</span> ·{" "}
{verdict?.verdict}
{verdict?.reason ? ` — ${verdict.reason}` : ""}
</li>
);
})}
</ul>
) : (
<p className="mt-1 text-sm font-medium text-foreground">
No verdicts submitted
</p>
)}
{interaction.payload.detailsMarkdown ? (
<div className="mt-2 text-sm">
<MarkdownBody externalReferences={externalReferences}>
{interaction.payload.detailsMarkdown}
</MarkdownBody>
</div>
) : null}
</div>
);
} else if (interaction.kind === "suggest_tasks") {
const created = new Set(
interaction.result?.createdTasks?.map((task) => task.clientKey) ?? [],
);
const createdTasks = interaction.payload.tasks.filter((task) =>
created.has(task.clientKey),
);
request = (
<div>
{createdTasks.length > 0 ? (
<ul className="grid gap-1 text-sm">
{createdTasks.map((task) => (
<li key={task.clientKey} className="font-medium">
{task.title}
</li>
))}
</ul>
) : interaction.status === "accepted" ? (
<p className="text-sm font-medium text-foreground">
No tasks created
</p>
) : null}
</div>
);
} else if (interaction.kind === "connection_intent") {
request = (
<p className="text-sm text-foreground">
{interaction.payload.requestingAgentName} requested access to{" "}
{interaction.payload.serviceName}.
</p>
);
} else if (interaction.kind === "suggest_routine") {
request = (
<p className="text-sm text-foreground">
Repeat {interaction.payload.title}: {interaction.payload.cadenceLabel}.
</p>
);
} else if (interaction.kind === "propose_responsibility_bar") {
request = (
<p className="text-sm text-foreground">
{interaction.payload.bar.standard} ({interaction.payload.templateLabel}: {interaction.payload.targetLabel}).
</p>
);
} else if (interaction.kind === "propose_automation") {
request = (
<p className="text-sm text-foreground">
{interaction.payload.title}: {interaction.payload.startLabel}.
</p>
);
} else if (interaction.kind === "propose_dashboard_changes") {
request = (
<p className="text-sm text-foreground">
{interaction.payload.message ?? (interaction.payload.changes.length === 1 ? "1 change to the dashboard." : `${interaction.payload.changes.length} changes to the dashboard.`)}
</p>
);
} else {
request = (
<div className="grid gap-2">
<MarkdownBody className="text-sm text-foreground" externalReferences={externalReferences} mediaMode="reference">
{interaction.payload.prompt}
</MarkdownBody>
{interaction.payload.detailsMarkdown ? (
<div className="text-sm">
<MarkdownBody externalReferences={externalReferences}>
{interaction.payload.detailsMarkdown}
</MarkdownBody>
</div>
) : null}
{interaction.payload.toolAction ? (
<div className="rounded-sm bg-muted/45 px-3 py-2.5 text-sm">
<p>
<strong>{interaction.payload.toolAction.toolDisplayName}</strong>{" "}
· {interaction.payload.toolAction.risk} risk
</p>
{interaction.payload.toolAction.expiresAt ? <p className="mt-1">
Expires{" "}
{new Date(
interaction.payload.toolAction.expiresAt,
).toLocaleString()}
</p> : null}
<div className="mt-2">
<MarkdownBody externalReferences={externalReferences}>
{interaction.payload.toolAction.previewMarkdown}
</MarkdownBody>
</div>
<pre className={cn("mt-2 max-h-40 overflow-auto whitespace-pre-wrap break-words font-mono text-xs", ANALYTICS_MASK_CLASS)}>
{interaction.payload.toolAction.argumentsSummaryJson}
</pre>
<ToolActionAuditHashCopy hash={interaction.payload.toolAction.argumentsHash} />
</div>
) : null}
{interaction.payload.secretProposal ? (
<dl className="grid gap-1 rounded-sm bg-muted/45 px-3 py-2.5 text-sm">
<div>
<dt className="text-xs text-muted-foreground">Secret</dt>
<dd>{interaction.payload.secretProposal.sourceSecretLabel}</dd>
</div>
<div>
<dt className="text-xs text-muted-foreground">Binding</dt>
<dd className="font-mono text-xs">
{interaction.payload.secretProposal.configPath} →{" "}
{interaction.payload.secretProposal.targetAgentName}
</dd>
</div>
<div>
<dt className="text-xs text-muted-foreground">Why</dt>
<dd>{interaction.payload.secretProposal.justification}</dd>
</div>
<div>
<dt className="text-xs text-muted-foreground">Expires</dt>
<dd>
{new Date(
interaction.payload.secretProposal.expiresAt,
).toLocaleString()}
</dd>
</div>
</dl>
) : null}
</div>
);
}
const detail = (
<div
className={
compact
? "space-y-3 pb-3 pl-7 pr-1"
: "mt-2 space-y-3 border-t border-border/60 pt-3"
}
>
{request}
{answerReason ? (
<p className="text-sm text-muted-foreground">
<span className="font-medium">Reason:</span> {answerReason}
</p>
) : null}
</div>
);
if (compact) {
const Icon = KIND_COPY[interaction.kind].icon;
const summary =
interaction.kind === "ask_user_questions" &&
interaction.status === "answered"
? "Questions answered"
: planReviewReceiptSummary(interaction, answerReason)
?? buildIssueThreadInteractionSummary(interaction);
return (
<details
className="group"
data-testid={
interaction.kind === "ask_user_questions" &&
interaction.status === "answered"
? "task-chat-answered-questions-receipt"
: "task-chat-interaction-receipt"
}
>
<summary className="flex min-h-8 cursor-pointer list-none items-center gap-2 rounded-sm px-1 py-1.5 text-sm leading-5 text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">
<span
className="flex w-6 shrink-0 items-center justify-center"
data-testid="task-chat-interaction-receipt-icon-slot"
>
<Icon
aria-hidden
className="h-3.5 w-3.5 shrink-0 text-muted-foreground"
data-testid="task-chat-interaction-receipt-icon"
/>
</span>
<span>{summary}</span>
<ChevronRight
aria-hidden
className="ml-auto h-3 w-3 shrink-0 text-muted-foreground opacity-0 transition-[opacity,transform] group-hover:opacity-70 group-focus-visible:opacity-70 group-open:rotate-90"
data-testid="task-chat-interaction-receipt-caret"
/>
</summary>
{detail}
</details>
);
}
return (
<details className="mt-2">
<summary className="cursor-pointer text-xs font-medium text-muted-foreground">
View original request and resolution
</summary>
{detail}
</details>
);
}
function questionSetForInteraction(
interaction: AskUserQuestionsInteraction,
): PaperclipQuestionSet {
if (interaction.payload.questionSet) return interaction.payload.questionSet;
return {
schema: "paperclip.question_set.v1",
...(interaction.title ? { title: interaction.title } : {}),
...(interaction.payload.submitLabel
? { submitLabel: interaction.payload.submitLabel }
: {}),
questions: interaction.payload.questions.map((question) => {
const freeText = question.options.find(
(option) => option.freeText === true,
);
return {
id: question.id,
prompt: question.prompt,
...(question.helpText ? { helpText: question.helpText } : {}),
required: question.required === true,
answerMode:
question.selectionMode === "multi"
? ("multi_select" as const)
: ("single_select" as const),
options: question.options
.filter((option) => option.freeText !== true)
.map((option) => ({
id: option.id,
label: option.label,
...(option.description ? { description: option.description } : {}),
})),
...(freeText
? {
customAnswer: {
enabled: true as const,
label: freeText.label,
...(freeText.description
? { placeholder: freeText.description }
: {}),
},
}
: {}),
};
}),
};
}
function questionResponseForInteraction(
interaction: AskUserQuestionsInteraction,
questionSet: PaperclipQuestionSet,
): PaperclipQuestionResponse | null {
if (!interaction.result?.answers) return null;
return {
schema: "paperclip.question_response.v1",
answers: Object.fromEntries(
interaction.result.answers.map((answer) => {
const question = questionSet.questions.find(
(candidate) => candidate.id === answer.questionId,
);
return [
answer.questionId,
question?.answerMode === "text"
? { ...(answer.otherText ? { text: answer.otherText } : {}) }
: {
selectedOptionIds: answer.optionIds,
...(answer.otherText ? { customText: answer.otherText } : {}),
},
];
}),
),
};
}
function AskUserQuestionsCard({
interaction,
onSubmitInteractionAnswers,
onCancelInteraction,
errorMessage,
draftKey,
onUploadImage,
mentions,
}: {
interaction: AskUserQuestionsInteraction;
onSubmitInteractionAnswers?: SharedInteractionProps["onSubmitInteractionAnswers"];
onCancelInteraction?: SharedInteractionProps["onCancelInteraction"];
errorMessage: (error: unknown) => string;
draftKey?: string;
onUploadImage?: SharedInteractionProps["onUploadImage"];
mentions?: MentionOption[];
}) {
const questionSet = questionSetForInteraction(interaction);
const initialResponse = questionResponseForInteraction(
interaction,
questionSet,
);
return (
<QuestionForm
id={interaction.id}
questionSet={questionSet}
initialResponse={initialResponse}
implicitCustomAnswer={interaction.payload.questionSet === undefined}
draftKey={draftKey}
disabled={!onSubmitInteractionAnswers}
imageUploadHandler={onUploadImage}
mentions={mentions}
onSubmit={async (response) => {
const answers: AskUserQuestionsAnswer[] = questionSet.questions.map(
(question) => {
const answer = response.answers[question.id];
const otherText =
question.answerMode === "text"
? (interaction.payload.questionSet ? answer?.text : answer?.text?.trim())
: answer?.customText?.trim();
return {
questionId: question.id,
optionIds:
question.answerMode === "text"
? []
: (answer?.selectedOptionIds ?? []),
...(otherText ? { otherText } : {}),
};
},
);
try {
await onSubmitInteractionAnswers?.(interaction, answers);
} catch (error) {
throw new Error(errorMessage(error));
}
}}
onCancel={
onCancelInteraction
? async () => {
try {
await onCancelInteraction(interaction);
} catch (error) {
throw new Error(errorMessage(error));
}
}
: undefined
}
/>
);
}
function ConfirmationCard({
interaction,
planDocument,
onAcceptInteraction,
onRejectInteraction,
externalReferences,
errorMessage,
draftKey,
showPlanPreview,
onUploadImage,
mentions,
}: {
interaction: RequestConfirmationInteraction;
planDocument?: IssueDocument | null;
onAcceptInteraction?: SharedInteractionProps["onAcceptInteraction"];
onRejectInteraction?: SharedInteractionProps["onRejectInteraction"];
externalReferences?: SharedInteractionProps["externalReferences"];
errorMessage: (error: unknown) => string;
draftKey?: string;
showPlanPreview: boolean;
onUploadImage?: SharedInteractionProps["onUploadImage"];
mentions?: MentionOption[];
}) {
const preparingApproval = isInteractionPreparingApproval(interaction);
const target = interaction.payload.target;
const sharedKey = reviseDraftKey(interaction.id, target?.type === "issue_document" ? target.revisionId : null);
const [draft, updateDraft] = useReviseDraft(sharedKey);
const { revising: rejecting, reason, working } = draft;
const setRejecting = (revising: boolean) => revising ? updateDraft({ revising }) : clearReviseDraft(sharedKey);
const setReason = (value: string) => updateDraft({ reason: value });
const [actionError, setActionError] = useState<string | null>(null);
const [revisionUploading, setRevisionUploading] = useState(false);
const isPlanConfirmation =
interaction.payload.target?.type === "issue_document" &&
interaction.payload.target.key === "plan";
const collectsRejectReason = Boolean(
isPlanConfirmation ||
interaction.payload.rejectRequiresReason ||
interaction.payload.allowDeclineReason ||
interaction.payload.declineReasonPlaceholder,
);
useEffect(() => {
if (!draftKey) return;
const legacyReason = loadStructuredDraft(draftKey, "");
const current = getReviseDraft(sharedKey);
if (legacyReason && !current.reason && !current.revising && !current.working) {
updateReviseDraft(sharedKey, { reason: legacyReason, revising: true });
}
clearDraft(draftKey);
}, [draftKey, sharedKey]);
useEffect(() => {
if (interaction.status !== "pending") clearReviseDraft(sharedKey);
}, [interaction.status, sharedKey]);
async function resolve(action: "accept" | "reject") {
if (
action === "reject" &&
interaction.payload.rejectRequiresReason &&
!reason.trim()
)
return;
if (!claimReviseDraftWork(sharedKey, action)) return;
setActionError(null);
try {
if (action === "accept") await onAcceptInteraction?.(interaction);
else await onRejectInteraction?.(interaction, reason.trim() || undefined);
if (draftKey) clearDraft(draftKey);
clearReviseDraft(sharedKey);
} catch (error) {
setActionError(errorMessage(error));
} finally {
releaseReviseDraftWork(sharedKey);
}
}
return (
<div>
{isPlanConfirmation && showPlanPreview ? (
<PlanReviewPreview
interaction={interaction}
planDocument={planDocument}
/>
) : isPlanConfirmation && rejecting ? null : (
<div className="space-y-2">
<MarkdownBody className="text-sm leading-5 text-foreground" externalReferences={externalReferences} mediaMode="reference">
{isPlanConfirmation
? "Do you accept this plan?"
: interaction.payload.prompt}
</MarkdownBody>
{!isPlanConfirmation ? (
<CompactTarget interaction={interaction} />
) : null}
</div>
)}
{!isPlanConfirmation && interaction.payload.detailsMarkdown ? (
<Details>
<MarkdownBody externalReferences={externalReferences}>
{interaction.payload.detailsMarkdown}
</MarkdownBody>
</Details>
) : null}
{interaction.payload.toolAction ? (
<div className="mt-3 space-y-2 rounded-sm bg-muted/45 px-3 py-2.5 text-sm">
<div className="flex flex-wrap items-center gap-2">
<strong>{interaction.payload.toolAction.toolDisplayName}</strong>
<span
className={cn(
"text-xs font-medium capitalize",
interaction.payload.toolAction.risk === "destructive"
? "text-destructive"
: "text-muted-foreground",
)}
>
{interaction.payload.toolAction.risk} risk
</span>
{interaction.payload.toolAction.expiresAt ? <span className="ml-auto text-xs text-muted-foreground">
Expires{" "}
{new Date(
interaction.payload.toolAction.expiresAt,
).toLocaleString()}
</span> : null}
</div>
<MarkdownBody externalReferences={externalReferences}>
{interaction.payload.toolAction.previewMarkdown}
</MarkdownBody>
<details>
<summary className="cursor-pointer text-xs font-medium text-muted-foreground">
Arguments
</summary>
<pre className={cn("mt-2 max-h-40 overflow-auto whitespace-pre-wrap break-words font-mono text-xs text-foreground", ANALYTICS_MASK_CLASS)}>
{interaction.payload.toolAction.argumentsSummaryJson}
</pre>
<ToolActionAuditHashCopy hash={interaction.payload.toolAction.argumentsHash} />
</details>
</div>
) : null}
{interaction.payload.secretProposal ? (
<dl className="mt-3 grid gap-2 rounded-sm bg-muted/45 px-3 py-2.5 text-sm">
<div>
<dt className="text-xs text-muted-foreground">Secret</dt>
<dd>{interaction.payload.secretProposal.sourceSecretLabel}</dd>
</div>
<div>
<dt className="text-xs text-muted-foreground">Binding</dt>
<dd className="font-mono text-xs">
{interaction.payload.secretProposal.configPath} →{" "}
{interaction.payload.secretProposal.targetAgentName}
</dd>
</div>
<div>
<dt className="text-xs text-muted-foreground">Why</dt>
<dd>{interaction.payload.secretProposal.justification}</dd>
</div>
<div>
<dt className="text-xs text-muted-foreground">Expires</dt>
<dd>
{new Date(
interaction.payload.secretProposal.expiresAt,
).toLocaleString()}
</dd>
</div>
</dl>
) : null}
{rejecting ? (
<div className={cn("space-y-2", !isPlanConfirmation && "mt-3")}>
<p
id={`${interaction.id}-reject-reason-label`}
className="text-xs font-medium leading-4 text-foreground"
>
{interaction.payload.rejectReasonLabel ?? "What should change?"}
{interaction.payload.rejectRequiresReason ? "" : " (optional)"}
</p>
{isPlanConfirmation ? (
<TaskChatRichInput
value={reason}
onChange={setReason}
placeholder={
interaction.payload.declineReasonPlaceholder ??
"Describe what should change"
}
imageUploadHandler={onUploadImage}
mentions={mentions}
disabled={working !== null}
autoFocus
onUploadingChange={setRevisionUploading}
onSubmit={() => {
if (!revisionUploading) void resolve("reject");
}}
ariaLabelledBy={`${interaction.id}-reject-reason-label`}
testId="plan-revision-composer"
showImageAttachControls={false}
/>
) : (
<Textarea
id={`${interaction.id}-reject-reason`}
value={reason}
onChange={(event) => setReason(event.target.value)}
placeholder={
interaction.payload.declineReasonPlaceholder ??
"Add a short note"
}
className={TAKEOVER_TEXTAREA_CLASS}
autoFocus
/>
)}
</div>
) : null}
<InteractionActionError message={actionError} />
{preparingApproval ? <InteractionPreparationNotice /> : null}
<ActionRow>
{rejecting ? (
<>
<Button
type="button"
size="sm"
variant="ghost"
disabled={working !== null}
onClick={() => {
setRejecting(false);
}}
>
Back
</Button>
<Button
type="button"
size="sm"
variant="outline"
disabled={
working !== null ||
revisionUploading ||
(Boolean(interaction.payload.rejectRequiresReason) &&
!reason.trim()) ||
!onRejectInteraction
}
onClick={() => void resolve("reject")}
>
{working === "reject" ? (
<Loader2 aria-hidden className="h-4 w-4 animate-spin" />
) : null}
{interaction.payload.rejectLabel ?? "Reject"}
</Button>
</>
) : (
<>
<Button
type="button"
size="sm"
variant="ghost"
disabled={working !== null || !onRejectInteraction}
onClick={() =>
collectsRejectReason
? setRejecting(true)
: void resolve("reject")
}
>
{interaction.payload.rejectLabel ?? "Reject"}
</Button>
<Button
type="button"
size="sm"
disabled={working !== null || preparingApproval || !onAcceptInteraction}
onClick={() => void resolve("accept")}
>
{working === "accept" ? (
<Loader2 aria-hidden className="h-4 w-4 animate-spin" />
) : null}
{interaction.payload.acceptLabel ?? "Approve"}
</Button>
</>
)}
</ActionRow>
</div>
);
}
function CheckboxConfirmationCard({
interaction,
onAcceptInteraction,
onRejectInteraction,
externalReferences,
errorMessage,
draftKey,
}: {
interaction: RequestCheckboxConfirmationInteraction;
onAcceptInteraction?: SharedInteractionProps["onAcceptInteraction"];
onRejectInteraction?: SharedInteractionProps["onRejectInteraction"];
externalReferences?: SharedInteractionProps["externalReferences"];
errorMessage: (error: unknown) => string;
draftKey?: string;
}) {
const restored = draftKey
? loadStructuredDraft<{ selected: string[]; reason: string }>(draftKey, {
selected: interaction.payload.defaultSelectedOptionIds ?? [],
reason: "",
})
: null;
const [selected, setSelected] = useState(
() =>
new Set(
restored?.selected ??
interaction.payload.defaultSelectedOptionIds ??
[],
),
);
const preparingApproval = isInteractionPreparingApproval(interaction);
const [rejecting, setRejecting] = useState(false);
const [reason, setReason] = useState(restored?.reason ?? "");
const [filter, setFilter] = useState("");
const [working, setWorking] = useState<"accept" | "reject" | null>(null);
const [actionError, setActionError] = useState<string | null>(null);
const collectsRejectReason = Boolean(
interaction.payload.rejectRequiresReason ||
interaction.payload.allowDeclineReason ||
interaction.payload.declineReasonPlaceholder,
);
const minimum = interaction.payload.minSelected ?? 0;
const maximum = interaction.payload.maxSelected ?? Number.POSITIVE_INFINITY;
const validCount = selected.size >= minimum && selected.size <= maximum;
const visibleOptions = interaction.payload.options.filter((option) => {
const query = filter.trim().toLowerCase();
return (
!query ||
option.label.toLowerCase().includes(query) ||
option.description?.toLowerCase().includes(query)
);
});
useEffect(() => {
if (draftKey)
saveStructuredDraft(draftKey, { selected: [...selected], reason });
}, [draftKey, reason, selected]);
function toggle(id: string) {
setSelected((current) => {
const next = new Set(current);
if (next.has(id)) next.delete(id);
else if (next.size < maximum) next.add(id);
return next;
});
}
async function resolve(action: "accept" | "reject") {
if (action === "accept" && !validCount) return;
if (
action === "reject" &&
interaction.payload.rejectRequiresReason &&
!reason.trim()
)
return;
setWorking(action);
setActionError(null);
try {
if (action === "accept")
await onAcceptInteraction?.(interaction, undefined, [...selected]);
else await onRejectInteraction?.(interaction, reason.trim() || undefined);
if (draftKey) clearDraft(draftKey);
} catch (error) {
setActionError(errorMessage(error));
} finally {
setWorking(null);
}
}
const countHint =
maximum < Number.POSITIVE_INFINITY
? `${selected.size} selected · choose ${minimum}–${maximum}`
: minimum > 0
? `${selected.size} selected · at least ${minimum}`
: `${selected.size} selected`;
return (
<div>
<div className="space-y-2">
<div id={`${interaction.id}-prompt`}>
<MarkdownBody className="text-sm leading-5 text-foreground" externalReferences={externalReferences} mediaMode="reference">
{interaction.payload.prompt}
</MarkdownBody>
</div>
<CompactTarget interaction={interaction} />
</div>
<div
className="mt-3 grid gap-1"
role="group"
aria-labelledby={`${interaction.id}-prompt`}
>
{interaction.payload.options.length > 10 ? (
<label className="relative mb-1 block">
<Search
className="pointer-events-none absolute left-2.5 top-2.5 h-4 w-4 text-muted-foreground"
aria-hidden
/>
<Input
value={filter}
onChange={(event) => setFilter(event.target.value)}
placeholder="Filter options"
aria-label="Filter options"
className="pl-8"
/>
</label>
) : null}
{visibleOptions.map((option) => (
<label
key={option.id}
className="flex cursor-pointer items-start gap-2 rounded-sm px-2 py-1.5 hover:bg-muted/50"
>
<Checkbox
checked={selected.has(option.id)}
onCheckedChange={() => toggle(option.id)}
className="mt-0.5"
/>
<span className="min-w-0">
<span className="block text-sm leading-5 text-foreground">
{option.label}
</span>
{option.description ? (
<span className="block text-xs leading-4 text-muted-foreground">
{option.description}
</span>
) : null}
</span>
</label>
))}
</div>
{interaction.payload.detailsMarkdown ? (
<Details>
<MarkdownBody externalReferences={externalReferences}>
{interaction.payload.detailsMarkdown}
</MarkdownBody>
</Details>
) : null}
{rejecting ? (
<div className="mt-3 space-y-1.5">
<label
htmlFor={`${interaction.id}-reject-reason`}
className="text-xs font-medium text-foreground"
>
{interaction.payload.rejectReasonLabel ?? "What should change?"}
{interaction.payload.rejectRequiresReason ? "" : " (optional)"}
</label>
<Textarea
id={`${interaction.id}-reject-reason`}
value={reason}
onChange={(event) => setReason(event.target.value)}
placeholder={
interaction.payload.declineReasonPlaceholder ?? "Add a short note"
}
className={TAKEOVER_TEXTAREA_CLASS}
autoFocus
/>
</div>
) : null}
<InteractionActionError message={actionError} />
{preparingApproval ? <InteractionPreparationNotice /> : null}
<ActionRow hint={countHint}>
{rejecting ? (
<>
<Button
type="button"
size="sm"
variant="ghost"
disabled={working !== null}
onClick={() => setRejecting(false)}
>
Back
</Button>
<Button
type="button"
size="sm"
variant="outline"
disabled={
working !== null ||
(Boolean(interaction.payload.rejectRequiresReason) &&
!reason.trim()) ||
!onRejectInteraction
}
onClick={() => void resolve("reject")}
>
{working === "reject" ? (
<Loader2 aria-hidden className="h-4 w-4 animate-spin" />
) : null}
{interaction.payload.rejectLabel ?? "Decline"}
</Button>
</>
) : (
<>
<Button
type="button"
size="sm"
variant="ghost"
disabled={working !== null || !onRejectInteraction}
onClick={() =>
collectsRejectReason
? setRejecting(true)
: void resolve("reject")
}
>
{interaction.payload.rejectLabel ?? "Decline"}
</Button>
<Button
type="button"
size="sm"
disabled={working !== null || preparingApproval || !validCount || !onAcceptInteraction}
onClick={() => void resolve("accept")}
>
{working === "accept" ? (
<Loader2 aria-hidden className="h-4 w-4 animate-spin" />
) : null}
{interaction.payload.acceptLabel ?? "Confirm selection"}
</Button>
</>
)}
</ActionRow>
</div>
);
}
function SuggestedTaskRow({
node,
selected,
onToggle,
}: {
node: SuggestedTaskTreeNode;
selected: Set<string>;
onToggle: (node: SuggestedTaskTreeNode) => void;
}) {
if (node.task.hiddenInPreview) return null;
const hiddenCount = collectSuggestedTaskClientKeys(node).filter(
(key) =>
key !== node.task.clientKey &&
node.children.some(
(child) => child.task.clientKey === key && child.task.hiddenInPreview,
),
).length;
return (
<li>
<label className="flex cursor-pointer items-start gap-2 rounded-sm px-2 py-1.5 hover:bg-muted/50">
<Checkbox
checked={selected.has(node.task.clientKey)}
onCheckedChange={() => onToggle(node)}
className="mt-0.5"
/>
<span className="min-w-0 flex-1">
<span className="block text-sm leading-5 text-foreground">
{node.task.title}
</span>
{hiddenCount > 0 ? (
<span className="block text-xs text-muted-foreground">
+ {hiddenCount} hidden follow-up
</span>
) : null}
</span>
</label>
{node.children.length > 0 ? (
<ul className="ml-4 border-l border-border/80 pl-2">
{node.children.map((child) => (
<SuggestedTaskRow
key={child.task.clientKey}
node={child}
selected={selected}
onToggle={onToggle}
/>
))}
</ul>
) : null}
</li>
);
}
function SuggestedTasksCard({
interaction,
onAcceptInteraction,
onRejectInteraction,
errorMessage,
draftKey,
coordinator = false,
}: {
interaction: SuggestTasksInteraction;
onAcceptInteraction?: SharedInteractionProps["onAcceptInteraction"];
onRejectInteraction?: SharedInteractionProps["onRejectInteraction"];
errorMessage: (error: unknown) => string;
draftKey?: string;
coordinator?: boolean;
}) {
const roots = useMemo(
() => buildSuggestedTaskTree(interaction.payload.tasks),
[interaction.payload.tasks],
);
const taskByKey = useMemo(
() =>
new Map(interaction.payload.tasks.map((task) => [task.clientKey, task])),
[interaction.payload.tasks],
);
const restored = draftKey
? loadStructuredDraft<{ selected: string[]; reason: string }>(draftKey, {
selected: interaction.payload.tasks.map((task) => task.clientKey),
reason: "",
})
: null;
const [selected, setSelected] = useState(
() =>
new Set(
restored?.selected ??
interaction.payload.tasks.map((task) => task.clientKey),
),
);
const [rejecting, setRejecting] = useState(false);
const [reason, setReason] = useState(restored?.reason ?? "");
const [filter, setFilter] = useState("");
const [working, setWorking] = useState<"accept" | "reject" | null>(null);
const [actionError, setActionError] = useState<string | null>(null);
useEffect(() => {
if (draftKey)
saveStructuredDraft(draftKey, { selected: [...selected], reason });
}, [draftKey, reason, selected]);
const visibleRoots = useMemo(() => {
const query = filter.trim().toLowerCase();
if (!query) return roots;
function retain(node: SuggestedTaskTreeNode): SuggestedTaskTreeNode | null {
const children = node.children
.map(retain)
.filter((child): child is SuggestedTaskTreeNode => child !== null);
const matches =
node.task.title.toLowerCase().includes(query) ||
node.task.description?.toLowerCase().includes(query);
return matches || children.length > 0 ? { ...node, children } : null;
}
return roots
.map(retain)
.filter((node): node is SuggestedTaskTreeNode => node !== null);
}, [filter, roots]);
function toggle(node: SuggestedTaskTreeNode) {
setSelected((current) => {
const next = new Set(current);
const subtree = collectSuggestedTaskClientKeys(node);
if (next.has(node.task.clientKey))
subtree.forEach((key) => next.delete(key));
else {
subtree.forEach((key) => next.add(key));
let parentKey = node.task.parentClientKey;
while (parentKey) {
next.add(parentKey);
parentKey = taskByKey.get(parentKey)?.parentClientKey;
}
}
return next;
});
}
async function resolve(action: "accept" | "reject", rejectionReason = reason) {
setWorking(action);
setActionError(null);
try {
if (action === "accept")
await onAcceptInteraction?.(interaction, [...selected]);
else await onRejectInteraction?.(interaction, rejectionReason.trim() || undefined);
if (draftKey) clearDraft(draftKey);
} catch (error) {
setActionError(errorMessage(error));
} finally {
setWorking(null);
}
}
return (
<div>
{(!coordinator || interaction.payload.tasks.length > 1) ? <p className="text-sm leading-5 text-foreground">Select the tasks to create.</p> : null}
{interaction.payload.tasks.length > 10 ? (
<label className="relative mt-3 block">
<Search
className="pointer-events-none absolute left-2.5 top-2.5 h-4 w-4 text-muted-foreground"
aria-hidden
/>
<Input
value={filter}
onChange={(event) => setFilter(event.target.value)}
placeholder="Filter suggested tasks"
aria-label="Filter suggested tasks"
className="pl-8"
/>
</label>
) : null}
<ul
className="mt-2 max-h-(--sz-28dvh) overflow-y-auto scrollbar-auto-hide"
aria-label="Suggested tasks"
>
{visibleRoots.map((node) => (
<SuggestedTaskRow
key={node.task.clientKey}
node={node}
selected={selected}
onToggle={toggle}
/>
))}
</ul>
{rejecting ? (
<div className="mt-3 space-y-1.5">
<label
htmlFor={`${interaction.id}-reject-reason`}
className="text-xs font-medium text-foreground"
>
{coordinator ? "What should change?" : "Why should these tasks change? (optional)"}
</label>
<Textarea
id={`${interaction.id}-reject-reason`}
value={reason}
onChange={(event) => setReason(event.target.value)}
placeholder="Add a short note"
className={TAKEOVER_TEXTAREA_CLASS}
autoFocus
/>
</div>
) : null}
<InteractionActionError message={actionError} />
{coordinator && interaction.payload.tasks.length > 1 ? (
<p className="mt-3 text-xs text-muted-foreground">{selected.size} of {interaction.payload.tasks.length} selected</p>
) : null}
<ActionRow
hint={coordinator ? null : `${selected.size} of ${interaction.payload.tasks.length} selected`}
>
{rejecting ? (
<>
<Button
type="button"
size="sm"
variant="ghost"
disabled={working !== null}
onClick={() => setRejecting(false)}
>
{coordinator ? "Cancel" : "Back"}
</Button>
<Button
type="button"
size="sm"
variant="outline"
disabled={working !== null || !onRejectInteraction || (coordinator && !reason.trim())}
onClick={() => void resolve("reject")}
>
{working === "reject" ? (
<Loader2 aria-hidden className="h-4 w-4 animate-spin" />
) : null}
{coordinator ? "Request revision" : "Send back"}
</Button>
</>
) : (
<>
{coordinator ? <Button type="button" size="sm" variant="ghost" disabled={working !== null || !onRejectInteraction}
onClick={() => { setReason(""); void resolve("reject", ""); }}>Reject</Button> : null}
<Button
type="button"
size="sm"
variant="ghost"
disabled={working !== null || !onRejectInteraction}
onClick={() => setRejecting(true)}
>
{coordinator ? "Revise…" : "Revise"}
</Button>
<Button
type="button"
size="sm"
disabled={
working !== null || selected.size === 0 || !onAcceptInteraction
}
onClick={() => void resolve("accept")}
>
{working === "accept" ? (
<Loader2 aria-hidden className="h-4 w-4 animate-spin" />
) : null}
{coordinator ? "Create" : "Create selected"}
</Button>
</>
)}
</ActionRow>
</div>
);
}
type VerdictDraft = {
verdict: RequestItemVerdictValue;
reason: string;
confirmed?: boolean;
};
function ItemVerdictsCard({
interaction,
onSubmitInteractionVerdicts,
externalReferences,
errorMessage,
draftKey,
}: {
interaction: RequestItemVerdictsInteraction;
onSubmitInteractionVerdicts?: SharedInteractionProps["onSubmitInteractionVerdicts"];
externalReferences?: SharedInteractionProps["externalReferences"];
errorMessage: (error: unknown) => string;
draftKey?: string;
}) {
const takeoverActions = useTaskChatComposerTakeoverActions();
const items = interaction.payload.items;
const resolvedById = useMemo(
() =>
new Map((interaction.result?.items ?? []).map((item) => [item.id, item])),
[interaction.result],
);
const firstPendingIndex = Math.max(
items.findIndex((item) => !resolvedById.has(item.id)),
0,
);
const restored = draftKey
? loadStructuredDraft<{
page: number;
drafts: Array<[string, VerdictDraft]>;
}>(draftKey, { page: firstPendingIndex, drafts: [] })
: null;
const [page, setPage] = useState(restored?.page ?? firstPendingIndex);
const [drafts, setDrafts] = useState<Map<string, VerdictDraft>>(
() => new Map(restored?.drafts ?? []),
);
const [working, setWorking] = useState(false);
const [actionError, setActionError] = useState<string | null>(null);
const enabledVerdicts = interaction.payload.verdicts ?? ["approve", "reject"];
const requireReasonOn = new Set(
interaction.payload.requireReasonOn ?? ["reject"],
);
useEffect(
() =>
setPage((current) => Math.min(current, Math.max(items.length - 1, 0))),
[items.length],
);
useEffect(() => {
setDrafts((current) => {
const next = new Map(current);
let changed = false;
for (const id of resolvedById.keys()) {
if (next.delete(id)) changed = true;
}
return changed ? next : current;
});
const nextPending = items.findIndex(
(candidate) => !resolvedById.has(candidate.id),
);
if (nextPending >= 0) setPage(nextPending);
}, [items, resolvedById]);
useEffect(() => {
if (draftKey) saveStructuredDraft(draftKey, { page, drafts: [...drafts] });
}, [draftKey, drafts, page]);
const item = items[page];
if (!item)
return (
<p className="text-sm text-muted-foreground">
No review items were provided.
</p>
);
const resolved = resolvedById.get(item.id);
const draft = drafts.get(item.id);
const itemHref = itemVerdictHref(item, interaction);
const rejectionNeedsConfirmation = Boolean(
!resolved &&
draft &&
requireReasonOn.has(draft.verdict) &&
(!draft.reason.trim() || draft.confirmed === false),
);
function advance() {
setPage((current) => Math.min(current + 1, items.length - 1));
}
function setVerdict(verdict: RequestItemVerdictValue) {
setDrafts((current) => {
const next = new Map(current);
const existing = next.get(item.id);
next.set(item.id, {
verdict,
reason: existing?.verdict === verdict ? existing.reason : "",
confirmed: !requireReasonOn.has(verdict),
});
return next;
});
if (!requireReasonOn.has(verdict)) advance();
}
function setReason(reason: string) {
setDrafts((current) => {
const next = new Map(current);
const existing = next.get(item.id);
if (existing)
next.set(item.id, { ...existing, reason, confirmed: false });
return next;
});
}
function confirmRejectionReason() {
if (!draft?.reason.trim()) return;
setDrafts((current) => {
const next = new Map(current);
const existing = next.get(item.id);
if (existing) next.set(item.id, { ...existing, confirmed: true });
return next;
});
advance();
}
async function submit() {
if (!onSubmitInteractionVerdicts) return;
const verdicts = [...drafts].map(([id, value]) => ({
id,
verdict: value.verdict,
...(value.reason.trim() ? { reason: value.reason.trim() } : {}),
}));
if (
verdicts.length === 0 ||
verdicts.some(
(entry) => requireReasonOn.has(entry.verdict) && !entry.reason,
)
)
return;
setWorking(true);
setActionError(null);
try {
await onSubmitInteractionVerdicts(interaction, verdicts);
if (draftKey) clearDraft(draftKey);
} catch (error) {
setActionError(errorMessage(error));
} finally {
setWorking(false);
}
}
const allDraftsValid =
drafts.size > 0 &&
[...drafts.values()].every(
(candidate) =>
!requireReasonOn.has(candidate.verdict) ||
Boolean(candidate.reason.trim() && candidate.confirmed !== false),
);
return (
<div>
<div className="mb-2 flex items-center text-xs text-muted-foreground">
<span>{drafts.size + resolvedById.size} decided</span>
<TaskChatComposerTakeoverControls>
<nav
className="flex shrink-0 items-center gap-1"
aria-label="Item pagination"
>
<Button
type="button"
size="icon-xs"
variant="ghost"
aria-label="Previous item"
disabled={working || page === 0}
onClick={() => setPage((current) => current - 1)}
>
<ChevronLeft aria-hidden />
</Button>
<span className="min-w-10 text-center tabular-nums">
{page + 1} of {items.length}
</span>
<Button
type="button"
size="icon-xs"
variant="ghost"
aria-label="Next item"
disabled={
working ||
page === items.length - 1 ||
rejectionNeedsConfirmation
}
onClick={() => setPage((current) => current + 1)}
>
<ChevronRight aria-hidden />
</Button>
</nav>
</TaskChatComposerTakeoverControls>
</div>
<div className="flex flex-wrap items-start justify-between gap-2">
<div className="min-w-0 flex-1">
<p className="text-sm font-medium leading-5 text-foreground">
{item.label}
</p>
{item.description ? (
<p className="text-xs leading-4 text-muted-foreground">
{item.description}
</p>
) : null}
</div>
{itemHref && !itemHref.startsWith("/api/") && (itemHref.startsWith("/") || itemHref.startsWith("#")) ? (
<Link to={itemHref} disableIssueQuicklook className="text-xs font-medium text-primary hover:underline">Open</Link>
) : itemHref ? (
<a
href={itemHref}
target="_blank"
rel="noreferrer"
className="text-xs font-medium text-primary hover:underline"
>
Open
</a>
) : null}
</div>
{item.previewMarkdown ? (
<div className="mt-2 rounded-sm bg-muted/40 px-2.5 py-2 text-xs">
<MarkdownBody externalReferences={externalReferences}>
{item.previewMarkdown}
</MarkdownBody>
</div>
) : null}
{resolved ? (
<p className="mt-3 inline-flex rounded-sm border border-border px-2 py-1 text-xs capitalize text-muted-foreground">
{resolved.verdict}
{resolved.reason ? ` · ${resolved.reason}` : ""}
</p>
) : (
<div
className="mt-3 flex flex-wrap gap-1.5"
role="group"
aria-label={`Verdict for ${item.label}`}
>
{enabledVerdicts.map((verdict) => (
<Button
key={verdict}
type="button"
size="sm"
variant="outline"
aria-pressed={draft?.verdict === verdict}
onClick={() => setVerdict(verdict)}
className={cn(
"min-w-24 justify-center capitalize",
verdict === "approve" &&
(draft?.verdict === verdict
? "border-emerald-500/60 bg-emerald-500/15 text-emerald-700 hover:bg-emerald-500/20 dark:text-emerald-300"
: "border-emerald-500/35 text-emerald-700 hover:bg-emerald-500/10 dark:text-emerald-300"),
verdict === "reject" &&
(draft?.verdict === verdict
? "border-destructive/60 bg-destructive/15 text-destructive hover:bg-destructive/20"
: "border-destructive/35 text-destructive hover:bg-destructive/10"),
)}
>
{verdict === "approve" ? (
<Check aria-hidden className="h-4 w-4" />
) : null}
{verdict === "reject" ? (
<X aria-hidden className="h-4 w-4" />
) : null}
{verdict}
</Button>
))}
</div>
)}
{!resolved && draft && requireReasonOn.has(draft.verdict) ? (
<div className="mt-2 space-y-1.5">
<label
htmlFor={`${interaction.id}-${item.id}-reason`}
className="text-xs font-medium text-foreground"
>
{interaction.payload.reasonLabel ?? "Reason"}
</label>
<Textarea
id={`${interaction.id}-${item.id}-reason`}
value={draft.reason}
onChange={(event) => setReason(event.target.value)}
placeholder="Add a short reason"
className={TAKEOVER_TEXTAREA_CLASS}
autoFocus
/>
<div className="flex justify-end">
<Button
type="button"
size="sm"
variant="outline"
disabled={!draft.reason.trim() || working}
onClick={confirmRejectionReason}
>
Submit rejection reason
</Button>
</div>
</div>
) : null}
{interaction.payload.detailsMarkdown ? (
<Details>
<MarkdownBody externalReferences={externalReferences}>
{interaction.payload.detailsMarkdown}
</MarkdownBody>
</Details>
) : null}
<InteractionActionError message={actionError} />
<ActionRow>
{takeoverActions?.skipButton}
<Button
type="button"
size="sm"
disabled={!allDraftsValid || working || !onSubmitInteractionVerdicts}
onClick={() => void submit()}
>
{working ? (
<Loader2 aria-hidden className="h-4 w-4 animate-spin" />
) : null}
{drafts.size > 0 ? `Apply ${drafts.size}` : "Apply decisions"}
</Button>
</ActionRow>
</div>
);
}
export function TaskChatCompactInteractionCard({
interaction,
planDocument,
showPlanPreview = true,
agentMap,
currentUserId,
userLabelMap,
onAcceptInteraction,
onRejectInteraction,
onSubmitInteractionAnswers,
onCancelInteraction,
onSubmitInteractionVerdicts,
onUploadImage,
externalReferences,
presentation = "timeline",
draftKey,
mentions,
}: TaskChatCompactInteractionCardProps) {
const { enabled: coordinatorEnabled } = useCoordinatorWorkspaceEnabled();
const creatorLabel = interaction.createdByAgentId
? agentMap?.get(interaction.createdByAgentId)?.name
: interaction.createdByUserId
? interaction.createdByUserId === currentUserId
? "You"
: userLabelMap?.get(interaction.createdByUserId)
: null;
const addresseeLabel = interaction.addresseeAgentId
? agentMap?.get(interaction.addresseeAgentId)?.name
: interaction.addresseeUserId
? interaction.addresseeUserId === currentUserId
? "You"
: (userLabelMap?.get(interaction.addresseeUserId) ??
interaction.addresseeUserId)
: null;
const audience = describeInteractionAudience({
interaction,
creatorLabel,
addresseeLabel,
});
const errorMessage = (error: unknown) =>
interactionResolutionErrorMessage(error, audience);
const audienceLabel =
interaction.status === "pending" && !audience.isOpen
? audience.shortSummary
: null;
const isResolvedPlanReview =
showPlanPreview &&
interaction.status !== "pending" &&
interaction.kind === "request_confirmation" &&
interaction.payload.target?.type === "issue_document" &&
interaction.payload.target.key === "plan";
if (coordinatorEnabled && interaction.kind === "suggest_tasks") {
return <CoordinatorTaskCommitment interaction={interaction}>
{interaction.status === "pending" ? <div className="p-4 space-y-3">
<h3 className="text-sm font-medium text-foreground">Suggested Task</h3>
{audienceLabel ? <p className="text-xs text-muted-foreground">{audienceLabel}</p> : null}
<SuggestedTasksCard interaction={interaction} onAcceptInteraction={onAcceptInteraction}
onRejectInteraction={onRejectInteraction} errorMessage={errorMessage} draftKey={draftKey} coordinator />
</div> : <div className="p-4"><ReceiptDisclosure interaction={interaction} externalReferences={externalReferences} compact /></div>}
</CoordinatorTaskCommitment>;
}
if (coordinatorEnabled && presentation === "timeline" && ["accepted", "answered", "rejected"].includes(interaction.status)
&& interaction.kind !== "connection_intent"
&& interaction.kind !== "request_item_verdicts"
&& !(interaction.kind === "request_confirmation" && (interaction.payload.toolAction || interaction.payload.secretProposal || interaction.payload.connectionAuthorization))) {
return <CoordinatorInteractionReceipt interaction={interaction} />;
}
if (interaction.kind === "suggest_routine") {
return <RoutineSuggestionCard interaction={interaction} />;
}
if (interaction.kind === "propose_responsibility_bar") {
return <BarProposalCard interaction={interaction} />;
}
if (interaction.kind === "propose_automation") {
return <AutomationProposalCard interaction={interaction} />;
}
if (interaction.kind === "propose_dashboard_changes") {
return <DashboardChangesCard interaction={interaction} />;
}
if (interaction.kind === "connection_intent") {
return (
<ConnectionIntentInteractionBody
interaction={interaction}
currentUserId={currentUserId}
addresseeLabel={addresseeLabel ?? "the addressed user"}
addresseeName={interaction.addresseeUserId ? userLabelMap?.get(interaction.addresseeUserId) : undefined}
/>
);
}
if (presentation === "timeline" && interaction.status !== "pending") {
return (
<>
{isResolvedPlanReview ? (
<div className="mb-2">
<PlanReviewPreview
interaction={interaction}
planDocument={planDocument}
/>
</div>
) : null}
<ReceiptDisclosure
interaction={interaction}
externalReferences={externalReferences}
compact
/>
</>
);
}
return (
<InteractionShell
interaction={interaction}
audienceLabel={audienceLabel}
presentation={presentation}
>
{interaction.status !== "pending" ? (
<ReceiptDisclosure
interaction={interaction}
externalReferences={externalReferences}
/>
) : interaction.kind === "ask_user_questions" ? (
<AskUserQuestionsCard
interaction={interaction}
onSubmitInteractionAnswers={onSubmitInteractionAnswers}
onCancelInteraction={
presentation === "timeline" ? onCancelInteraction : undefined
}
errorMessage={errorMessage}
draftKey={draftKey}
onUploadImage={onUploadImage}
mentions={mentions}
/>
) : interaction.kind === "request_confirmation" ? (
<ConfirmationCard
interaction={interaction}
planDocument={planDocument}
onAcceptInteraction={onAcceptInteraction}
onRejectInteraction={onRejectInteraction}
externalReferences={externalReferences}
errorMessage={errorMessage}
draftKey={draftKey}
showPlanPreview={showPlanPreview && presentation === "timeline"}
onUploadImage={onUploadImage}
mentions={mentions}
/>
) : interaction.kind === "request_checkbox_confirmation" ? (
<CheckboxConfirmationCard
interaction={interaction}
onAcceptInteraction={onAcceptInteraction}
onRejectInteraction={onRejectInteraction}
externalReferences={externalReferences}
errorMessage={errorMessage}
draftKey={draftKey}
/>
) : interaction.kind === "suggest_tasks" ? (
<SuggestedTasksCard
interaction={interaction}
onAcceptInteraction={onAcceptInteraction}
onRejectInteraction={onRejectInteraction}
errorMessage={errorMessage}
draftKey={draftKey}
/>
) : (
<ItemVerdictsCard
interaction={interaction}
onSubmitInteractionVerdicts={onSubmitInteractionVerdicts}
externalReferences={externalReferences}
errorMessage={errorMessage}
draftKey={draftKey}
/>
)}
</InteractionShell>
);
}