mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-11-16 20:12:20 +01:00
## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work > - The board UI is the main surface. Its load speed is a product requirement. > - The team wants to track page-load times over time and give each metric an owner and an SLO in Honeycomb. > - Server traces show only the server part of a page load. They do not show JavaScript start-up, lazy route code, rendering, or client-side navigation. > - Paperclip is also self-hosted by others. Browser tracing must stay off there, and it must not slow any page. > - This pull request adds real-user browser tracing for hosted Paperclip Cloud instances only. It loads lazily and sends a closed set of attributes. > - The benefit is one `page.load` measurement per page (named by route pattern), plus Web Vitals and API spans that join the server trace, ready for Honeycomb queries and SLOs. ## Linked Issues or Issue Description No public issue exists. Feature description: **Subsystem affected** Board UI (`ui/`), the authenticated session route (`server/src/routes/auth.ts`), and the shared session schema. **Problem or motivation** We cannot measure how long the all-tasks page or a task page takes to load for real users. Server traces stop at the API response. Most navigation is client side, and the standard OpenTelemetry document-load instrumentation does not cover it. Without a per-page browser measurement, no agent can own a page-load SLO. **Proposed solution** The server sends a `browserTracing` config in the authenticated session only when the instance is cloud managed and `PAPERCLIP_BROWSER_TRACES_ENDPOINT` is set. The browser then measures every hard load and client navigation in one shared recorder tied to the router's own route tree. After the page settles, it lazily loads an OpenTelemetry chunk that exports `page.load`, `web_vital.*`, and same-origin `/api/` fetch spans to Honeycomb. An allowlist removes every other attribute before export. **Alternatives considered** `@honeycombio/opentelemetry-web` was the first choice. Its defaults add the full page URL, query string, hash, referrer, and user agent to every span and to the resource, and it bundles log and metric pipelines. We would have to replace its exporter and remove most of its defaults. Plain OpenTelemetry web packages plus `web-vitals` are smaller and send only what we choose. Honeycomb needs only OTLP/HTTP and its ingest-key header. **Roadmap alignment** This is internal hosted-instance observability. It changes no product behavior and no self-hosted behavior. ## What Changed - `server/src/browser-tracing-config.ts`: resolves the browser tracing config. It returns `null` unless `isCloudManagedInstance()` is true and `PAPERCLIP_BROWSER_TRACES_ENDPOINT` is set. It accepts only a Honeycomb ingest key (`hcaik_` prefix), requires `https` (except loopback), and fails closed with one value-free warning on any invalid setting. Optional: `PAPERCLIP_BROWSER_TRACES_INGEST_KEY`, `_SAMPLE_RATE` (default 1), `_SERVICE_NAME` (default `paperclip-web`), `_ENVIRONMENT` (default `SENTRY_ENVIRONMENT`). - `GET /api/auth/get-session` adds `browserTracing` (config or `null`), the same delivery path as the front-end Sentry DSN. The shared `authSessionSchema` has the new optional field `browserTracingConfigSchema`. - `ui/src/lib/browser-tracing/page-load-recorder.ts` and `controller.ts` (main bundle, no OpenTelemetry imports): one `page.load` measurement per hard load (from navigation start) and per client navigation (from the history change). A measurement ends at the first painted frame where no full-page loading state is mounted and either every page-declared content signal is ready or no query without data is fetching. Redirects continue the measurement. A new navigation interrupts it. 30 s times out. The sample decision is made once per page session before any download. - `ui/src/components/PageLoadTracker.tsx`: `App` passes the same `<Route>` tree it renders, so every page is reported by route pattern (for example `/:companyPrefix/issues/:issueId`) with no per-page code. - `usePageContentReady` hook and blocking gates: `PaperclipLoading` (also the route `Suspense` fallback) blocks readiness. The task page uses the existing `issue-detail:navigate→content-paint` point. The plain all-tasks list signals when its first rows render. - `ui/src/lib/browser-tracing/sdk.ts` (lazy chunk, loaded after the page settles): OpenTelemetry web tracer, OTLP/HTTP exporter, fetch instrumentation for this origin's `/api/` only with `traceparent` sent only to this origin, `web-vitals` LCP/INP/CLS, and a context manager that makes the open `page.load` span the parent of its API calls. `span-sanitizer.ts` applies the closed attribute allowlist (no URLs, ids, query strings, status messages, or event attributes). Uncaught errors are not sent because Sentry already reports them. - New `ui` dev dependencies, pinned exactly. Each is needed, and the OpenTelemetry ones are the same versions the server already resolves: - `@opentelemetry/api@1.9.1` (already in the workspace): tracer and context API. - `@opentelemetry/sdk-trace-web@2.10.0`: the browser tracer provider, batch processor, and stack context manager. - `@opentelemetry/instrumentation-fetch@0.221.0`: fetch spans and `traceparent` injection. - `@opentelemetry/resources@2.10.0` (already a server dependency): the resource. - `@opentelemetry/otlp-transformer@0.221.0` (already a server dependency): OTLP JSON serialization for a 60-line `OtlpFetchExporter`. This replaces `@opentelemetry/exporter-trace-otlp-http`, which is a server optional peer: installing it in the workspace made the server's exact-version gate test see it as present. - `web-vitals@6.2.3`: LCP, INP, and CLS. All of them are in the lazy chunk only. The lockfile is not committed: `pr-trusted` rejects lockfile edits in pull requests, CI installs with `--no-frozen-lockfile` after the frozen attempt reports `ERR_PNPM_OUTDATED_LOCKFILE`, and the lockfile bot refreshes it after merge. - `tests/runner-e2e/source-sdk-public-inputs.json`: refreshed pins for the three shared files (the session schema is part of the pinned public SDK surface; the contract must live in `packages/shared`). - Docs: new `doc/browser-performance-tracing.md` (enablement, config, key handling, span and attribute list, page-load definitions, example Honeycomb queries and an SLO SLI). Pointers in `doc/observability.md` and the Honeycomb tracing skill. - Two App routing tests mock `PageLoadTracker` because they render `App` without a `QueryClientProvider`. ## Verification - `pnpm verify` returns exit 2 (broader verification required) because docs are global CI inputs. Required CI supplies the broad coverage. - Focused local tests, all pass: - `ui`: `vitest run src/lib/browser-tracing src/components/PageLoadTracker.test.tsx src/components/SentryGate.test.tsx src/api/auth.test.ts src/lib/issue-detail-performance src/pages/IssueDetail src/pages/Issues src/App src/components/CloudAccessGate.test.tsx src/components/IssuesList`: 17 files, 484 tests. - `server`: `browser-tracing-config.test.ts`, `auth-routes.test.ts`, `sentry.test.ts`: 63 passed, 5 skipped. - `packages/shared`: `validators/access.test.ts`: 19 passed. - New tests prove: the SDK module is never imported when the session config is `null`, absent, or signed out, or when the session is not sampled; route templates contain no ids, slugs, or tokens; a client navigation produces a `client` measurement under `/:companyPrefix/issues/:issueId`; `traceparent` goes only to this origin's `/api/` and not to a third-party or non-API URL; exported spans carry only allowlisted attributes. A mutation check (tracker forced on) turned the "never imports" tests red. - Typecheck: `ui` (`pnpm typecheck`), `server` (`pnpm --filter @paperclipai/server typecheck`), and `packages/shared` pass. - Real-browser run: a local dev server with a local OTLP collector and headless Chromium. The self-hosted session returned `browserTracing: null` with the endpoint set, and the page made 0 SDK and 0 collector requests. With a cloud session config injected into the session response, the collector received a hard `page.load` (route `/:companyPrefix/issues`, `ready_signal=idle`), a client `page.load` to `/:companyPrefix/issues/:issueId` (`ready_signal=content`), a back navigation, LCP/INP/CLS spans, and `/api/` fetch spans parented to the open `page.load` span. No task identifier, company id, task title, host, or URL appeared in the exported payload. No third-party request carried `traceparent`. - Bundle size (`ui` production build, initial JavaScript closure of `index.html`): before 3,813,986 B raw / 1,153,991 B gzip; after 3,820,743 B / 1,156,590 B (+6.8 KB raw, +2.6 KB gzip, +0.2%). The lazy SDK chunk is 84 KB raw / 27 KB gzip and is not fetched unless tracing is on and sampled. - Review fixes (each red on the old code, green on the new): the SDK now loads by a 35 s deadline even if the page never settles, so a timed-out hard load is exported (`controller.test.ts`); an agent chat with no saved task uses the idle rule instead of a content gate that never fires (`usePageContentReady.test.tsx`); the sample rate is rounded to exactly 1/N so Honeycomb's `SampleRate` weight matches (`browser-tracing-config.test.ts`). The real-browser run was repeated after the exporter change with the same result. ## Risks - Low risk for self-hosted installs: the server never sends a config, so no tracing code beyond the small recorder runs, and the SDK chunk is never fetched. - On hosted instances the feature is off until an operator sets `PAPERCLIP_BROWSER_TRACES_ENDPOINT` and an ingest key. When on, the controller wraps `history.pushState`/`replaceState` to time navigation starts and restores them on sign-out. - Every signed-in browser can read the ingest key, like the Sentry DSN. Only Honeycomb ingest keys (send-only) are accepted. A collector endpoint can keep the key server-side. - Hard-load API calls happen before the SDK loads, so they have no fetch spans. The hard-load `page.load` span is still recorded. - The browser-to-server trace join needs server tracing. The hosted image does not install the OpenTelemetry server peers today (`CLOUD_BUNDLED_SERVER_DEPS` is `@sentry/node` only). Browser spans work without it. - `ui/src/pages/IssueDetail.tsx` was already over 1,000 lines. This change adds 5 lines there for the task page content signal, next to the existing content-paint measure. ## Model Used - Claude Opus 5.5 (`claude-opus-5-5`) via Claude Code, with tool use (shell, file edits, local browser automation). Reasoning effort: low. ## Checklist - [x] I have included a thinking path that traces from project context to this change - [x] I have specified the model used (with version and capability details) - [x] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work - [x] I have searched GitHub for duplicate or related PRs and linked them above - [x] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have not referenced internal/instance-local Paperclip issues or links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip` URLs) - [x] My branch name describes the change (e.g. `docs/...`, `fix/...`) and contains no internal Paperclip ticket id or instance-derived details - [x] I have run tests locally and they pass - [x] I have added or updated tests where applicable - [x] I have updated relevant documentation to reflect my changes - [x] I have considered and documented any risks above - [ ] All Paperclip CI gates are green - [ ] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [ ] I will address all Greptile and reviewer comments before requesting merge 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Fable 5.2 <noreply@anthropic.com>
378 lines
16 KiB
TypeScript
378 lines
16 KiB
TypeScript
import { companyProjectsQuery } from "@/lib/company-projects-query";
|
|
import { QueryErrorState, useQueryView } from "@/components/QueryView";
|
|
import { useShowAgentCreatedTasks } from "../hooks/useShowAgentCreatedTasks";
|
|
import { useCoordinatorWorkspaceEnabled } from "../hooks/useCoordinatorWorkspaceEnabled";
|
|
import { CoordinatorTaskViews } from "./CoordinatorTaskViews";
|
|
import { useDesignSandbox } from "../context/DesignSandboxContext";
|
|
import { DesignSandboxTasks } from "./DesignSandboxTasks";
|
|
import { useEffect, useMemo, useCallback, useRef, useState } from "react";
|
|
import type { ReactNode } from "react";
|
|
import { useLocation, useNavigate, useSearchParams } from "@/lib/router";
|
|
import { useInfiniteQuery, useQuery } from "@tanstack/react-query";
|
|
import { issuesApi } from "../api/issues";
|
|
import { agentsApi } from "../api/agents";
|
|
import { heartbeatsApi } from "../api/heartbeats";
|
|
import { useCompany } from "../context/CompanyContext";
|
|
import { useBreadcrumbs } from "../context/BreadcrumbContext";
|
|
import { collectLiveIssueIds } from "../lib/liveIssueIds";
|
|
import { usePublishSharedQueryData, useSharedPollingQuery } from "@/hooks/useSharedPolling";
|
|
import { queryKeys } from "../lib/queryKeys";
|
|
import { createIssueDetailLocationState } from "../lib/issueDetailBreadcrumb";
|
|
import { EmptyState } from "../components/EmptyState";
|
|
import { IssuesList } from "../components/IssuesList";
|
|
import { readIssueSortParams, type IssueSort } from "../lib/issue-sort";
|
|
import { TaskViewsMenu } from "../components/TaskViewsMenu";
|
|
import { Button } from "@/components/ui/button";
|
|
import { CircleDot, Plus } from "lucide-react";
|
|
import type { Issue } from "@paperclipai/shared";
|
|
import { useStreamlinedUiEnabled } from "../hooks/useStreamlinedUiEnabled";
|
|
import { useCombinedInboxTasksEnabled } from "../hooks/useCombinedInboxTasksEnabled";
|
|
import { useDialogActions } from "../context/DialogContext";
|
|
import { useInboxBadge } from "../hooks/useInboxBadge";
|
|
import { Inbox } from "./Inbox";
|
|
import {
|
|
ORGANIZATION_SCOPED_PARAMS,
|
|
TASK_VIEW_PARAM,
|
|
loadLastTaskView,
|
|
normalizeTaskViewKey,
|
|
resolveInitialTaskView,
|
|
saveLastTaskView,
|
|
taskView,
|
|
type TaskViewKey,
|
|
} from "../lib/task-views";
|
|
import { useUpdateIssueMutation } from "../hooks/useUpdateIssueMutation";
|
|
import { usePageContentReady } from "../hooks/usePageContentReady";
|
|
|
|
const WORKSPACE_FILTER_ISSUE_LIMIT = 1000;
|
|
const ISSUES_PAGE_SIZE = 100;
|
|
export const ISSUES_ROW_PRESENTATION = "task" as const;
|
|
export const ISSUES_TOOLBAR_PRESENTATION = "collection" as const;
|
|
|
|
export function resolveIssuesPresentation(streamlinedUiEnabled: boolean) {
|
|
return streamlinedUiEnabled
|
|
? { rowPresentation: ISSUES_ROW_PRESENTATION, toolbarPresentation: ISSUES_TOOLBAR_PRESENTATION }
|
|
: { rowPresentation: "legacy" as const, toolbarPresentation: "legacy" as const };
|
|
}
|
|
|
|
export function getNextIssuesPageOffset(
|
|
loadedPageSize: number,
|
|
currentOffset: number,
|
|
pageSize: number = ISSUES_PAGE_SIZE,
|
|
): number | undefined {
|
|
return loadedPageSize >= pageSize ? currentOffset + pageSize : undefined;
|
|
}
|
|
|
|
export function mergeIssuePagesStable<T extends { id: string }>(pages: T[][]): T[] {
|
|
const seenIssueIds = new Set<string>();
|
|
const merged: T[] = [];
|
|
|
|
for (const page of pages) {
|
|
for (const issue of page) {
|
|
if (seenIssueIds.has(issue.id)) continue;
|
|
seenIssueIds.add(issue.id);
|
|
merged.push(issue);
|
|
}
|
|
}
|
|
|
|
return merged;
|
|
}
|
|
|
|
export function buildIssuesSearchUrl(currentHref: string, search: string): string | null {
|
|
const url = new URL(currentHref);
|
|
const currentSearch = url.searchParams.get("q") ?? "";
|
|
if (currentSearch === search) return null;
|
|
|
|
if (search.length > 0) {
|
|
url.searchParams.set("q", search);
|
|
} else {
|
|
url.searchParams.delete("q");
|
|
}
|
|
|
|
return `${url.pathname}${url.search}${url.hash}`;
|
|
}
|
|
|
|
/**
|
|
* Tasks — the single task surface after PAP-670 merged Inbox into it.
|
|
*
|
|
* This component only resolves `?view=` to a view and hands off: My-work views
|
|
* render the inbox list, organization views render the task collection. Both
|
|
* get the same Views control in their toolbar, so the switch reads as one page.
|
|
*/
|
|
export function Issues() {
|
|
const designSandbox = useDesignSandbox();
|
|
const { enabled: streamlinedUiEnabled } = useStreamlinedUiEnabled();
|
|
const { enabled: combinedInboxTasksEnabled } = useCombinedInboxTasksEnabled();
|
|
const { enabled: coordinatorEnabled } = useCoordinatorWorkspaceEnabled();
|
|
// The merged surface is Combined Inbox + Task List only. With the flag off, and always in
|
|
// the legacy shell, Tasks is the plain task list and Inbox keeps its pages.
|
|
return designSandbox ? <DesignSandboxTasks /> : coordinatorEnabled ? <CoordinatorTaskViews /> : streamlinedUiEnabled && combinedInboxTasksEnabled ? <StreamlinedTasks /> : <OrganizationIssues />;
|
|
}
|
|
|
|
function StreamlinedTasks() {
|
|
const navigate = useNavigate();
|
|
const [searchParams, setSearchParams] = useSearchParams();
|
|
const { selectedCompanyId } = useCompany();
|
|
const { openNewIssue } = useDialogActions();
|
|
const inboxBadge = useInboxBadge(selectedCompanyId);
|
|
|
|
const requestedView = searchParams.get(TASK_VIEW_PARAM);
|
|
const hasOrganizationScopedParam = ORGANIZATION_SCOPED_PARAMS.some(
|
|
(param) => (searchParams.get(param) ?? "").length > 0,
|
|
);
|
|
// Read the stored view once per mount so a later write can't yank the view
|
|
// out from under the user mid-session.
|
|
const [lastUsedView] = useState<TaskViewKey>(() => loadLastTaskView());
|
|
const view = resolveInitialTaskView(requestedView, hasOrganizationScopedParam, lastUsedView);
|
|
const definition = taskView(view);
|
|
|
|
// Make the resolved view addressable without dropping the params that
|
|
// brought the user here — and correct a requested view that was overridden
|
|
// (an inbox view carrying an organization filter opens All tasks).
|
|
useEffect(() => {
|
|
if (normalizeTaskViewKey(requestedView) === view) return;
|
|
setSearchParams((current) => {
|
|
const next = new URLSearchParams(current);
|
|
next.set(TASK_VIEW_PARAM, view);
|
|
return next;
|
|
}, { replace: true });
|
|
}, [requestedView, view, setSearchParams]);
|
|
|
|
const selectView = useCallback((next: TaskViewKey) => {
|
|
saveLastTaskView(next);
|
|
// A view switch starts clean: the previous view's search and filters are
|
|
// its own, not the new view's.
|
|
navigate(`/issues?${TASK_VIEW_PARAM}=${next}`);
|
|
}, [navigate]);
|
|
|
|
const viewsMenu = (
|
|
<TaskViewsMenu value={view} onChange={selectView} badgeCount={inboxBadge.inbox} />
|
|
);
|
|
|
|
if (definition.surface === "inbox") {
|
|
return (
|
|
<Inbox
|
|
tab={definition.inboxTab}
|
|
surfaceLabel="Tasks"
|
|
toolbarContext={(
|
|
<div className="flex min-w-0 items-center gap-2">
|
|
{viewsMenu}
|
|
<Button size="sm" variant="outline" aria-label="New Task" onClick={() => openNewIssue()}>
|
|
<Plus className="h-4 w-4 sm:mr-1" />
|
|
<span className="hidden sm:inline">New Task</span>
|
|
</Button>
|
|
</div>
|
|
)}
|
|
/>
|
|
);
|
|
}
|
|
|
|
return <OrganizationIssues toolbarContext={viewsMenu} initialStatuses={definition.statuses} />;
|
|
}
|
|
|
|
function OrganizationIssues({
|
|
toolbarContext,
|
|
initialStatuses,
|
|
}: { toolbarContext?: ReactNode; initialStatuses?: string[] } = {}) {
|
|
const { enabled: streamlinedUiEnabled } = useStreamlinedUiEnabled();
|
|
const issuesPresentation = resolveIssuesPresentation(streamlinedUiEnabled);
|
|
const { selectedCompanyId } = useCompany();
|
|
const { setBreadcrumbs } = useBreadcrumbs();
|
|
const location = useLocation();
|
|
const [searchParams, setSearchParams] = useSearchParams();
|
|
const fetchNextPageInFlightRef = useRef(false);
|
|
|
|
const urlSearch = searchParams.get("q") ?? "";
|
|
const [searchOverride, setSearchOverride] = useState<{ search: string; locationSearch: string } | null>(null);
|
|
const syncedSearch = useMemo(() => {
|
|
if (typeof window !== "undefined" && searchOverride?.locationSearch === window.location.search) {
|
|
return searchOverride.search;
|
|
}
|
|
return urlSearch;
|
|
}, [searchOverride, urlSearch, location.search]);
|
|
const showAgentCreatedTasks = useShowAgentCreatedTasks(selectedCompanyId, "paperclip:issues-view");
|
|
const sort = useMemo(() => readIssueSortParams(searchParams), [searchParams]);
|
|
const includeBlockedBy = sort?.sortField === "workflow";
|
|
const serverSortField = sort?.sortField === "created" ? "created" : "updated";
|
|
const serverSortDir = sort?.sortField === "created" || sort?.sortField === "updated" ? sort.sortDir : "desc";
|
|
const handleSortChange = useCallback((nextSort: IssueSort) => {
|
|
setSearchParams(current => {
|
|
const next = new URLSearchParams(current);
|
|
if (syncedSearch) next.set("q", syncedSearch);
|
|
else next.delete("q");
|
|
next.set("sortField", nextSort.sortField);
|
|
next.set("sortDir", nextSort.sortDir);
|
|
return next;
|
|
}, { replace: true });
|
|
}, [setSearchParams, syncedSearch]);
|
|
const routineTasksOnly = searchParams.get("originKind") === "routine_execution";
|
|
const includeAgentCreatedTasks = showAgentCreatedTasks || routineTasksOnly;
|
|
const originKind = routineTasksOnly ? "routine_execution" : undefined;
|
|
const handleRoutineTasksOnlyChange = useCallback((checked: boolean) => {
|
|
setSearchParams(current => {
|
|
const next = new URLSearchParams(current);
|
|
if (syncedSearch) next.set("q", syncedSearch);
|
|
else next.delete("q");
|
|
if (checked) next.set("originKind", "routine_execution");
|
|
else next.delete("originKind");
|
|
return next;
|
|
}, { replace: true });
|
|
}, [setSearchParams, syncedSearch]);
|
|
const participantAgentId = searchParams.get("participantAgentId") ?? undefined;
|
|
const initialWorkspaces = searchParams.getAll("workspace").filter((workspaceId) => workspaceId.length > 0);
|
|
const workspaceIdFilter = initialWorkspaces.length === 1 ? initialWorkspaces[0] : undefined;
|
|
const handleSearchChange = useCallback((search: string) => {
|
|
const nextUrl = buildIssuesSearchUrl(window.location.href, search);
|
|
if (!nextUrl) {
|
|
setSearchOverride(null);
|
|
return;
|
|
}
|
|
window.history.replaceState(window.history.state, "", nextUrl);
|
|
setSearchOverride({ search, locationSearch: window.location.search });
|
|
}, []);
|
|
|
|
const { data: agents } = useQuery({
|
|
queryKey: queryKeys.agents.list(selectedCompanyId!),
|
|
queryFn: () => agentsApi.list(selectedCompanyId!),
|
|
enabled: !!selectedCompanyId,
|
|
});
|
|
|
|
const { data: projects } = useQuery({
|
|
...companyProjectsQuery(selectedCompanyId!, { includeArchived: true }),
|
|
enabled: !!selectedCompanyId,
|
|
});
|
|
|
|
const liveRunsQueryKey = queryKeys.liveRuns(selectedCompanyId!);
|
|
const sharedLiveRuns = useSharedPollingQuery({
|
|
companyId: selectedCompanyId,
|
|
resourceKey: "live-runs",
|
|
queryKey: liveRunsQueryKey,
|
|
enabled: !!selectedCompanyId,
|
|
// Event-sourced via LiveUpdatesProvider (GitHub issue 9627); no interval poll needed.
|
|
refetchInterval: false,
|
|
leaderOnly: true,
|
|
});
|
|
const { data: liveRuns, dataUpdatedAt: liveRunsUpdatedAt } = useQuery({
|
|
queryKey: liveRunsQueryKey,
|
|
queryFn: () => heartbeatsApi.liveRunsForCompany(selectedCompanyId!),
|
|
enabled: sharedLiveRuns.enabled,
|
|
refetchInterval: sharedLiveRuns.refetchInterval,
|
|
});
|
|
usePublishSharedQueryData(sharedLiveRuns, liveRuns, liveRunsUpdatedAt);
|
|
|
|
const issueLinkState = useMemo(
|
|
() =>
|
|
createIssueDetailLocationState(
|
|
"Tasks",
|
|
`${location.pathname}${location.search}${location.hash}`,
|
|
"issues",
|
|
),
|
|
[location.pathname, location.search, location.hash],
|
|
);
|
|
|
|
useEffect(() => {
|
|
setBreadcrumbs([{ label: "Tasks" }]);
|
|
}, [setBreadcrumbs]);
|
|
|
|
const issuePageSize = workspaceIdFilter ? WORKSPACE_FILTER_ISSUE_LIMIT : ISSUES_PAGE_SIZE;
|
|
|
|
const issuesQuery = useInfiniteQuery({
|
|
queryKey: [
|
|
...queryKeys.issues.list(selectedCompanyId!),
|
|
"participant-agent",
|
|
participantAgentId ?? "__all__",
|
|
"workspace",
|
|
workspaceIdFilter ?? "__all__",
|
|
streamlinedUiEnabled ? "index" : "compact",
|
|
"with-routine-executions",
|
|
includeAgentCreatedTasks,
|
|
originKind,
|
|
"infinite",
|
|
issuePageSize,
|
|
serverSortField,
|
|
serverSortDir,
|
|
includeBlockedBy,
|
|
],
|
|
queryFn: ({ pageParam, signal }) => issuesApi.listCompact(selectedCompanyId!, {
|
|
projection: streamlinedUiEnabled ? "index" : undefined,
|
|
participantAgentId,
|
|
workspaceId: workspaceIdFilter,
|
|
includeRoutineExecutions: true,
|
|
includeAgentCreatedTasks,
|
|
originKind,
|
|
limit: issuePageSize,
|
|
offset: pageParam,
|
|
sortField: serverSortField,
|
|
sortDir: serverSortDir,
|
|
includeBlockedBy: includeBlockedBy || undefined,
|
|
}, { signal }),
|
|
initialPageParam: 0,
|
|
getNextPageParam: (lastPage, _allPages, lastPageParam) =>
|
|
getNextIssuesPageOffset(lastPage.length, lastPageParam, issuePageSize),
|
|
enabled: !!selectedCompanyId,
|
|
placeholderData: (previousData) => previousData,
|
|
});
|
|
|
|
const { data: issuePages, isFetchingNextPage, hasNextPage, fetchNextPage } = issuesQuery;
|
|
const issuesView = useQueryView(issuesQuery);
|
|
// The task list is loaded once its first page of rows has rendered.
|
|
usePageContentReady(!selectedCompanyId || (issuesView.kind !== "loading" && issuesView.kind !== "reconnecting"));
|
|
const issues = useMemo(() => mergeIssuePagesStable(issuePages?.pages ?? []) as Issue[], [issuePages]);
|
|
const liveIssueIds = useMemo(() => collectLiveIssueIds(liveRuns, issues), [issues, liveRuns]);
|
|
const hasMoreServerIssues = syncedSearch.trim().length === 0
|
|
&& hasNextPage === true;
|
|
const loadMoreServerIssues = useCallback(() => {
|
|
if (!hasNextPage || isFetchingNextPage || fetchNextPageInFlightRef.current) return;
|
|
fetchNextPageInFlightRef.current = true;
|
|
void fetchNextPage({ cancelRefetch: false }).finally(() => {
|
|
fetchNextPageInFlightRef.current = false;
|
|
});
|
|
}, [fetchNextPage, hasNextPage, isFetchingNextPage]);
|
|
|
|
// Optimistic, rolls back with a readable toast, and resends after an outage.
|
|
const updateIssue = useUpdateIssueMutation({ companyId: selectedCompanyId });
|
|
|
|
if (!selectedCompanyId) {
|
|
return (
|
|
<EmptyState
|
|
icon={CircleDot}
|
|
message={streamlinedUiEnabled
|
|
? "Select an organization to view tasks."
|
|
: "Select a company to view tasks."}
|
|
/>
|
|
);
|
|
}
|
|
|
|
if (issuesView.kind === "error") return <QueryErrorState size="page" error={issuesView.error} action="load tasks" onRetry={issuesView.retry} retrying={issuesView.isFetching} />;
|
|
|
|
return (
|
|
<IssuesList
|
|
issues={issues ?? []}
|
|
preloadTaskChats
|
|
isLoading={issuesView.kind === "loading" || issuesView.kind === "reconnecting"}
|
|
isLoadingMoreIssues={isFetchingNextPage}
|
|
agents={agents}
|
|
projects={projects}
|
|
liveIssueIds={liveIssueIds}
|
|
viewStateKey="paperclip:issues-view"
|
|
rowPresentation={issuesPresentation.rowPresentation}
|
|
toolbarPresentation={issuesPresentation.toolbarPresentation}
|
|
issueLinkState={issueLinkState}
|
|
initialAssignees={searchParams.get("assignee") ? [searchParams.get("assignee")!] : undefined}
|
|
initialWorkspaces={initialWorkspaces.length > 0 ? initialWorkspaces : undefined}
|
|
initialStatuses={initialStatuses}
|
|
toolbarContext={toolbarContext}
|
|
initialSearch={syncedSearch}
|
|
onSearchChange={handleSearchChange}
|
|
enableAgentCreatedVisibilityFilter
|
|
routineTasksOnly={routineTasksOnly}
|
|
onRoutineTasksOnlyChange={handleRoutineTasksOnlyChange}
|
|
sort={sort}
|
|
onSortChange={handleSortChange}
|
|
hasMoreIssues={hasMoreServerIssues}
|
|
onLoadMoreIssues={loadMoreServerIssues}
|
|
onUpdateIssue={(id, data) => updateIssue.mutate({ id, data })}
|
|
searchFilters={participantAgentId || workspaceIdFilter || originKind || includeBlockedBy ? { participantAgentId, workspaceId: workspaceIdFilter, originKind, ...(includeBlockedBy ? { includeBlockedBy: true } : {}) } : undefined}
|
|
/>
|
|
);
|
|
}
|