4693d770aa
## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work. > - Operators need a way to inspect files and work products created by agents across a company without opening each issue one by one. > - The existing issue detail surfaces already show attachments and outputs, but there was no company-level artifacts index or search-result affordance for artifact-like records. > - The backend needed a company-scoped artifacts projection API that preserves issue/run attribution and safe links back to source records. > - The UI needed a first-class Artifacts page, sidebar entry, reusable artifact cards, and deep-link handling that keeps company prefixes intact. > - This pull request adds the company artifacts API and page, then wires artifacts into search and issue output surfaces. > - The benefit is a single place to browse, filter, and open generated work products and attachments while preserving company boundaries. ## Linked Issues or Issue Description Fixes #7622. Feature request fields: - Problem/motivation: company operators need a consolidated artifacts surface for attachments and work products produced by agents. - Proposed solution: add a company-scoped artifacts projection endpoint, a board Artifacts route, reusable cards, sidebar navigation, and artifact search integration. - Alternatives considered: keep artifact discovery only on individual issue pages; that forces operators to know the source issue before finding generated outputs. - Roadmap alignment: checked `ROADMAP.md`; this is a focused board UI/API improvement and does not duplicate a listed roadmap item. ## What Changed - Added shared artifact types and validators. - Added a company-scoped artifact projection service/API with tests for attachment/work-product attribution. - Added Artifacts board UI route, API client, sidebar link, cards, filters, and storybook coverage. - Added artifact result handling to company search and issue output/deep-link flows. - Rebased the branch onto the latest `public-gh/master` state and resolved the route-test conflict by preserving both upstream team-catalog coverage and artifact route coverage. - Fixed a local Sidebar test helper so it no longer depends on a runtime-undefined `React.act` export in this dependency install. ## Verification - `pnpm --filter @paperclipai/ui exec vitest run src/components/artifacts/ArtifactCard.test.tsx src/api/artifacts.test.ts src/lib/company-routes.test.ts` - `pnpm --filter @paperclipai/ui exec vitest run src/pages/Artifacts.test.tsx src/pages/Search.test.tsx src/components/Sidebar.test.tsx` - `pnpm exec vitest run server/src/__tests__/company-artifacts-service.test.ts server/src/__tests__/company-search-service.test.ts server/src/__tests__/company-search-rate-limit-routes.test.ts server/src/__tests__/issue-agent-mutation-ownership-routes.test.ts` - Confirmed the PR diff does not include `pnpm-lock.yaml` or `.github/workflows/*`. - Duplicate search: no open PRs or issues found for `artifact page ArtifactCard` in `paperclipai/paperclip`. Screenshots are intentionally omitted per the internal task instruction not to add design screenshots or images to this PR unless they are specifically part of the work. I also attempted browser capture in this runner, but `agent-browser` failed to launch Chrome and Playwright Chromium is missing `libatk-1.0.so.0`. ## Risks - Low-to-medium risk: this adds a new API projection and UI surface, so attribution/link regressions could affect artifact navigation. - Company scoping is covered in the new service/API tests. - No database migrations are included. - No lockfile or workflow changes are included. > 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 OpenAI Codex, GPT-5 coding agent with tool use and local command execution. Exact hosted model identifier is not exposed in this runtime. ## Checklist - [x] I have included a thinking path that traces from project context to this change - [x] I have specified the model used (with version and capability details) - [x] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work - [x] I have searched GitHub for duplicate or related PRs and linked them above - [x] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have run tests locally and they pass - [x] I have added or updated tests where applicable - [ ] If this change affects the UI, I have included before/after screenshots (intentionally omitted per task instruction; browser capture unavailable in this runner) - [x] I have updated relevant documentation to reflect my changes - [x] I have considered and documented any risks above - [ ] All Paperclip CI gates are green - [ ] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge --------- Co-authored-by: Paperclip <noreply@paperclip.ing>
165 lines
5.9 KiB
TypeScript
165 lines
5.9 KiB
TypeScript
import { useEffect, useMemo, useRef, useState } from "react";
|
|
import { useInfiniteQuery } from "@tanstack/react-query";
|
|
import { Package, Search, X } from "lucide-react";
|
|
import { artifactsApi, type ArtifactKindFilter } from "../api/artifacts";
|
|
import { useCompany } from "../context/CompanyContext";
|
|
import { useBreadcrumbs } from "../context/BreadcrumbContext";
|
|
import { queryKeys } from "../lib/queryKeys";
|
|
import { EmptyState } from "../components/EmptyState";
|
|
import { PageSkeleton } from "../components/PageSkeleton";
|
|
import { ArtifactCard } from "../components/artifacts/ArtifactCard";
|
|
import { cn } from "@/lib/utils";
|
|
import { Input } from "@/components/ui/input";
|
|
|
|
const ARTIFACTS_PAGE_SIZE = 30;
|
|
const SEARCH_DEBOUNCE_MS = 250;
|
|
|
|
const KIND_FILTERS: { value: ArtifactKindFilter; label: string }[] = [
|
|
{ value: "all", label: "All" },
|
|
{ value: "image", label: "Images" },
|
|
{ value: "video", label: "Videos" },
|
|
{ value: "document", label: "Documents" },
|
|
{ value: "text", label: "Text" },
|
|
{ value: "file", label: "Files" },
|
|
];
|
|
|
|
export function Artifacts() {
|
|
const { selectedCompanyId } = useCompany();
|
|
const { setBreadcrumbs } = useBreadcrumbs();
|
|
const [kind, setKind] = useState<ArtifactKindFilter>("all");
|
|
const [draftQuery, setDraftQuery] = useState("");
|
|
const [query, setQuery] = useState("");
|
|
const loadMoreRef = useRef<HTMLDivElement | null>(null);
|
|
|
|
useEffect(() => {
|
|
setBreadcrumbs([{ label: "Artifacts" }]);
|
|
}, [setBreadcrumbs]);
|
|
|
|
useEffect(() => {
|
|
const handle = window.setTimeout(() => setQuery(draftQuery.trim()), SEARCH_DEBOUNCE_MS);
|
|
return () => window.clearTimeout(handle);
|
|
}, [draftQuery]);
|
|
|
|
const {
|
|
data,
|
|
isLoading,
|
|
isFetching,
|
|
isFetchingNextPage,
|
|
hasNextPage,
|
|
fetchNextPage,
|
|
error,
|
|
} = useInfiniteQuery({
|
|
queryKey: queryKeys.artifacts.list(selectedCompanyId!, kind, query),
|
|
queryFn: ({ pageParam }) =>
|
|
artifactsApi.list(selectedCompanyId!, {
|
|
kind,
|
|
q: query || undefined,
|
|
limit: ARTIFACTS_PAGE_SIZE,
|
|
cursor: pageParam,
|
|
}),
|
|
enabled: !!selectedCompanyId,
|
|
initialPageParam: undefined as string | undefined,
|
|
getNextPageParam: (lastPage) => lastPage.nextCursor ?? undefined,
|
|
});
|
|
|
|
useEffect(() => {
|
|
const target = loadMoreRef.current;
|
|
if (!target || !hasNextPage || isFetchingNextPage) return;
|
|
const observer = new IntersectionObserver((entries) => {
|
|
if (entries.some((entry) => entry.isIntersecting)) {
|
|
void fetchNextPage();
|
|
}
|
|
}, { rootMargin: "320px 0px" });
|
|
observer.observe(target);
|
|
return () => observer.disconnect();
|
|
}, [fetchNextPage, hasNextPage, isFetchingNextPage]);
|
|
|
|
const artifacts = useMemo(() => data?.pages.flatMap((page) => page.artifacts) ?? [], [data]);
|
|
const searching = query.length > 0;
|
|
|
|
if (!selectedCompanyId) {
|
|
return <EmptyState icon={Package} message="Select a company to view artifacts." />;
|
|
}
|
|
|
|
return (
|
|
<div className="w-full max-w-6xl space-y-5">
|
|
<div className="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
|
|
<div className="relative w-full sm:max-w-sm">
|
|
<Search className="pointer-events-none absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-muted-foreground" />
|
|
<Input
|
|
value={draftQuery}
|
|
onChange={(event) => setDraftQuery(event.currentTarget.value)}
|
|
placeholder="Search artifacts..."
|
|
aria-label="Search artifacts"
|
|
className="h-9 pl-9 pr-9 text-sm"
|
|
/>
|
|
{draftQuery.length > 0 ? (
|
|
<button
|
|
type="button"
|
|
onClick={() => setDraftQuery("")}
|
|
aria-label="Clear artifact search"
|
|
className="absolute right-2 top-1/2 inline-flex h-6 w-6 -translate-y-1/2 items-center justify-center rounded text-muted-foreground transition-colors hover:bg-accent/50 hover:text-foreground"
|
|
>
|
|
<X className="h-3.5 w-3.5" />
|
|
</button>
|
|
) : null}
|
|
</div>
|
|
|
|
<div className="flex flex-wrap items-center gap-1.5" role="tablist" aria-label="Filter artifacts by type">
|
|
{KIND_FILTERS.map((filter) => (
|
|
<button
|
|
key={filter.value}
|
|
type="button"
|
|
role="tab"
|
|
aria-selected={kind === filter.value}
|
|
onClick={() => setKind(filter.value)}
|
|
className={cn(
|
|
"rounded-md px-2.5 py-1 text-xs font-medium transition-colors",
|
|
kind === filter.value
|
|
? "bg-accent text-foreground"
|
|
: "text-muted-foreground hover:bg-accent/50 hover:text-foreground",
|
|
)}
|
|
>
|
|
{filter.label}
|
|
</button>
|
|
))}
|
|
</div>
|
|
</div>
|
|
|
|
{error && <p className="text-sm text-destructive">{error.message}</p>}
|
|
|
|
{isLoading ? (
|
|
<PageSkeleton variant="list" />
|
|
) : artifacts.length === 0 ? (
|
|
<EmptyState
|
|
icon={Package}
|
|
message={
|
|
searching
|
|
? "No artifacts match this search."
|
|
: kind === "all"
|
|
? "No artifacts yet. Outputs attached to issues will appear here."
|
|
: "No artifacts of this type yet."
|
|
}
|
|
/>
|
|
) : (
|
|
<>
|
|
<div className="grid grid-cols-1 gap-6 md:grid-cols-2 xl:grid-cols-3">
|
|
{artifacts.map((artifact) => (
|
|
<ArtifactCard key={`${artifact.source}:${artifact.id}`} artifact={artifact} />
|
|
))}
|
|
</div>
|
|
<div ref={loadMoreRef} className="flex min-h-10 items-center justify-center pb-2 text-xs text-muted-foreground">
|
|
{isFetchingNextPage
|
|
? "Loading more artifacts..."
|
|
: hasNextPage
|
|
? null
|
|
: isFetching
|
|
? "Updating artifacts..."
|
|
: null}
|
|
</div>
|
|
</>
|
|
)}
|
|
</div>
|
|
);
|
|
}
|