@graph8/sdk 0.370.0 → 0.374.0

package/blocks/company-intelligence/block.json

@@ -0,0 +1,318 @@
+{
+  "$schema": "../block.schema.json",
+  "id": "company-intelligence",
+  "title": "Company intelligence",
+  "summary": "Research your own website, then read what it found (profile, competitors, news, keywords), the wiki documents written from it and the six market research reports. Billable steps are confirmed.",
+  "features": [
+    "website research run with step-by-step progress; billable, confirmed, locked to the workspace's own website",
+    "company profile, competitors, brand news, products, keywords, audience questions and brand assets, each readable and re-collectable",
+    "wiki documents written from the research, read as safe formatted text and rewritten one at a time",
+    "six research reports: write one or all, retry, resume, stop, reset; read, edit, approve into the knowledge base, see the model's reasoning, delete",
+    "optional tab for a CRM company page (CompanyIntelligenceTab)",
+    "markdown and web content from the API is always drawn as text, never as HTML"
+  ],
+  "dependsOn": [
+    "foundation"
+  ],
+  "operations": [
+    "analyze_website_intelligence_analyze_post",
+    "approve_research_report_research_reports__report_id__approve_post",
+    "delete_research_report_research_reports__report_id__delete",
+    "generate_all_research_reports_research_reports_generate_all_post",
+    "generate_global_context_document_global_context_generate__doc_type__post",
+    "generate_research_report_research_reports_generate_post",
+    "get_all_intelligence_data_intelligence_all__website_url__get",
+    "get_global_context_tree_flat_global_context_tree_flat_get",
+    "get_global_context_tree_global_context_tree_get",
+    "get_intelligence_data_intelligence_data__data_type__get",
+    "get_intelligence_org_domain_intelligence_org_domain_get",
+    "get_intelligence_primary_website_intelligence_primary_website_get",
+    "get_intelligence_status_intelligence_status__task_id__get",
+    "get_latest_intelligence_task_intelligence_latest_task_get",
+    "get_research_report_research_reports__report_id__get",
+    "get_research_report_thinking_research_reports__report_id__thinking_get",
+    "get_research_workflow_status_research_reports_workflow_get",
+    "list_intelligence_documents_intelligence_documents_get",
+    "reset_intelligence_intelligence_delete",
+    "reset_research_workflow_research_reports_workflow_reset_post",
+    "resume_research_workflow_research_reports_workflow_resume_post",
+    "retry_intelligence_source_intelligence_retry_post",
+    "retry_research_report_research_reports_retry_post",
+    "stop_all_research_research_reports_stop_all_post",
+    "unapprove_research_report_research_reports__report_id__unapprove_post",
+    "update_research_report_research_reports__report_id__patch"
+  ],
+  "components": [
+    {
+      "name": "ResearchRun",
+      "file": "components/research-run.tsx",
+      "purpose": "Start the website research (billable, confirmed), follow it step by step, and reset it (destructive, confirmed with the real record count).",
+      "operations": [
+        "analyze_website_intelligence_analyze_post",
+        "get_intelligence_org_domain_intelligence_org_domain_get",
+        "get_intelligence_primary_website_intelligence_primary_website_get",
+        "get_intelligence_status_intelligence_status__task_id__get",
+        "get_latest_intelligence_task_intelligence_latest_task_get",
+        "list_intelligence_documents_intelligence_documents_get",
+        "reset_intelligence_intelligence_delete"
+      ],
+      "tiers": [
+        "read",
+        "billable",
+        "destructive"
+      ]
+    },
+    {
+      "name": "CompanyProfileCard",
+      "file": "components/company-profile.tsx",
+      "purpose": "The company profile the research collected (industry, size, funding, links) with counts of what else was found. Mount alone on any page.",
+      "operations": [
+        "get_all_intelligence_data_intelligence_all__website_url__get",
+        "get_intelligence_primary_website_intelligence_primary_website_get"
+      ],
+      "tiers": [
+        "read"
+      ]
+    },
+    {
+      "name": "IntelligenceSources",
+      "file": "components/intelligence-sources.tsx",
+      "purpose": "List of the collected data sources plus the ones of the last run that failed or have not finished.",
+      "operations": [
+        "get_intelligence_status_intelligence_status__task_id__get",
+        "get_latest_intelligence_task_intelligence_latest_task_get",
+        "list_intelligence_documents_intelligence_documents_get"
+      ],
+      "tiers": [
+        "read"
+      ]
+    },
+    {
+      "name": "SourceDetail",
+      "file": "components/source-detail.tsx",
+      "purpose": "Complete screen for one source: what it collected, when, edits, and re-collect it (billable, confirmed).",
+      "operations": [
+        "get_intelligence_data_intelligence_data__data_type__get",
+        "get_intelligence_primary_website_intelligence_primary_website_get",
+        "retry_intelligence_source_intelligence_retry_post"
+      ],
+      "tiers": [
+        "read",
+        "billable"
+      ]
+    },
+    {
+      "name": "SourceView",
+      "file": "components/source-view.tsx",
+      "purpose": "Read-only renderer for one source's data: profile, competitors, news, products, keywords, questions, trends, pages, brand assets; unknown shapes fall back to a readable tree.",
+      "operations": [],
+      "tiers": []
+    },
+    {
+      "name": "WikiDocuments",
+      "file": "components/wiki-documents.tsx",
+      "purpose": "The wiki documents written from the research, with search and a folder filter.",
+      "operations": [
+        "get_global_context_tree_flat_global_context_tree_flat_get"
+      ],
+      "tiers": [
+        "read"
+      ]
+    },
+    {
+      "name": "WikiDocumentDetail",
+      "file": "components/wiki-document-detail.tsx",
+      "purpose": "Complete screen for one wiki document: safe formatted content, state, version, and rewrite it from the research (billable, confirmed).",
+      "operations": [
+        "generate_global_context_document_global_context_generate__doc_type__post",
+        "get_global_context_tree_flat_global_context_tree_flat_get",
+        "get_intelligence_primary_website_intelligence_primary_website_get"
+      ],
+      "tiers": [
+        "read",
+        "billable"
+      ]
+    },
+    {
+      "name": "ResearchReports",
+      "file": "components/research-reports.tsx",
+      "purpose": "The six research reports and their workflow: write one or all, retry, resume, stop, reset; every cost confirmed with the number of reports.",
+      "operations": [
+        "generate_all_research_reports_research_reports_generate_all_post",
+        "generate_research_report_research_reports_generate_post",
+        "get_intelligence_primary_website_intelligence_primary_website_get",
+        "get_research_workflow_status_research_reports_workflow_get",
+        "reset_research_workflow_research_reports_workflow_reset_post",
+        "resume_research_workflow_research_reports_workflow_resume_post",
+        "retry_research_report_research_reports_retry_post",
+        "stop_all_research_research_reports_stop_all_post"
+      ],
+      "tiers": [
+        "read",
+        "write",
+        "billable",
+        "destructive"
+      ]
+    },
+    {
+      "name": "ReportDetail",
+      "file": "components/report-detail.tsx",
+      "purpose": "Complete screen for one research report: safe formatted text, edit (changed text only), approve into the knowledge base, recorded reasoning, write again, delete.",
+      "operations": [
+        "approve_research_report_research_reports__report_id__approve_post",
+        "delete_research_report_research_reports__report_id__delete",
+        "generate_research_report_research_reports_generate_post",
+        "get_intelligence_primary_website_intelligence_primary_website_get",
+        "get_research_report_research_reports__report_id__get",
+        "get_research_report_thinking_research_reports__report_id__thinking_get",
+        "unapprove_research_report_research_reports__report_id__unapprove_post",
+        "update_research_report_research_reports__report_id__patch"
+      ],
+      "tiers": [
+        "read",
+        "write",
+        "billable",
+        "destructive"
+      ]
+    },
+    {
+      "name": "CompanyIntelligenceTab",
+      "file": "components/company-intelligence-tab.tsx",
+      "purpose": "Optional tab for a CRM company detail page (mount through extraDetailTabs): the profile when the company is your own website, the competitor entry when it is a competitor your research found, otherwise an honest empty state.",
+      "operations": [
+        "get_all_intelligence_data_intelligence_all__website_url__get",
+        "get_intelligence_data_intelligence_data__data_type__get",
+        "get_intelligence_primary_website_intelligence_primary_website_get"
+      ],
+      "tiers": [
+        "read"
+      ]
+    },
+    {
+      "name": "CompanyIntelligenceScreen",
+      "file": "components/company-intelligence-screen.tsx",
+      "purpose": "Finished company-intelligence page: Overview (research run + profile), Sources, Documents and Reports tabs, each with a detail panel and deep links.",
+      "operations": [
+        "get_global_context_tree_global_context_tree_get",
+        "get_intelligence_primary_website_intelligence_primary_website_get",
+        "get_latest_intelligence_task_intelligence_latest_task_get",
+        "get_research_workflow_status_research_reports_workflow_get",
+        "list_intelligence_documents_intelligence_documents_get"
+      ],
+      "tiers": [
+        "read"
+      ]
+    }
+  ],
+  "hooks": [
+    {
+      "name": "useResearchTarget",
+      "file": "hooks/use-intelligence.ts",
+      "purpose": "Cached reads shared by the components: useResearchTarget (primary website + a suggestion), useLatestRun, useRunStatus, useSourceDocuments, useSourceEntry, useAllIntelligence, useWikiDocuments, useWikiStats, useWorkflow, and refreshIntelligence() to refresh them all after a write.",
+      "operations": [
+        "get_all_intelligence_data_intelligence_all__website_url__get",
+        "get_global_context_tree_flat_global_context_tree_flat_get",
+        "get_global_context_tree_global_context_tree_get",
+        "get_intelligence_data_intelligence_data__data_type__get",
+        "get_intelligence_org_domain_intelligence_org_domain_get",
+        "get_intelligence_primary_website_intelligence_primary_website_get",
+        "get_intelligence_status_intelligence_status__task_id__get",
+        "get_latest_intelligence_task_intelligence_latest_task_get",
+        "get_research_workflow_status_research_reports_workflow_get",
+        "list_intelligence_documents_intelligence_documents_get"
+      ]
+    }
+  ],
+  "lib": [
+    {
+      "file": "lib/intelligence-types.ts",
+      "purpose": "Open-payload types, defensive readers (text, num, rowsOf), canonicalDomain, safeHttpUrl, run/step helpers, the six report types, workflow slot helpers, and the changed-text-only report edit."
+    },
+    {
+      "file": "lib/safe-markdown.tsx",
+      "purpose": "SafeMarkdown: renders API markdown as React text nodes (headings, lists, tables, code, links to http(s) only). Never produces HTML; no dangerouslySetInnerHTML."
+    }
+  ],
+  "recipes": [
+    {
+      "file": "recipes/research-your-website.ts",
+      "title": "Research your own website and read the company profile",
+      "when": "Setting up company intelligence: primary website, billable run, poll, read the profile."
+    },
+    {
+      "file": "recipes/read-competitors-and-news.ts",
+      "title": "Read the competitors and the news the research found",
+      "when": "Feeding a briefing or digest from the collected competitors and brand news."
+    },
+    {
+      "file": "recipes/write-the-research-reports.ts",
+      "title": "Write the six research reports, follow them and approve one",
+      "when": "Building market research: count the missing reports, get a yes, write, poll, read, approve."
+    }
+  ],
+  "prerequisites": [
+    {
+      "id": "intelligence-scopes",
+      "description": "The graph8 key needs knowledge:read, knowledge:run and knowledge:delete (research and documents) and campaigns:read, campaigns:write, campaigns:run, campaigns:delete (research reports).",
+      "where": "api",
+      "verify": "g8.api.me.describeCurrentKey() lists those scopes."
+    },
+    {
+      "id": "credits",
+      "description": "Research runs, document rewrites and report writing use credits. The API quotes no price in advance, so a person confirms each one.",
+      "where": "api",
+      "verify": "The workspace owner knows the plan's credit balance (the API has no balance read)."
+    },
+    {
+      "id": "own-website",
+      "description": "The research is about the workspace's own website and is locked to the first one researched. A person decides which website that is.",
+      "where": "app",
+      "verify": "GET /api/v1/intelligence/primary-website returns has_website true after the first run."
+    }
+  ],
+  "scopes": [
+    "campaigns:delete",
+    "campaigns:read",
+    "campaigns:run",
+    "campaigns:write",
+    "knowledge:delete",
+    "knowledge:read",
+    "knowledge:run"
+  ],
+  "defaults": [
+    {
+      "decision": "Which website is researched",
+      "default": "The workspace's primary website once set; before that the company domain from the workspace settings is only suggested, a person confirms it",
+      "askHuman": true
+    },
+    {
+      "decision": "Run again when a run finished less than an hour ago",
+      "default": "No: the API returns that run and does no new work",
+      "askHuman": false
+    },
+    {
+      "decision": "Writing a research report",
+      "default": "Never automatic: a person confirms the number of reports first",
+      "askHuman": false
+    },
+    {
+      "decision": "Approving a report into the knowledge base",
+      "default": "Only when a person asks; approved reports are read by campaigns and the copilot",
+      "askHuman": true
+    },
+    {
+      "decision": "Editing a report",
+      "default": "Send only the changed text; a cleared text is sent as an empty string",
+      "askHuman": false
+    },
+    {
+      "decision": "Missing data",
+      "default": "Shown as unknown (a dash), never as zero and never guessed",
+      "askHuman": false
+    }
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "lucide-react": ">=0.400"
+  }
+}

package/blocks/company-intelligence/components/company-intelligence-screen.tsx

@@ -0,0 +1,114 @@
+"use client";
+
+/**
+ * CompanyIntelligenceScreen: the finished company-intelligence page. Four tabs (`?tab=`):
+ *   Overview   start, follow and reset the website research (ResearchRun) and read the company profile it collected.
+ *   Sources    everything the research collected, and the sources that failed; open one (`?id=<type>`) to read it and re-collect it.
+ *   Documents  the wiki documents written from the research; open one (`?id=`) to read it or write it again.
+ *   Reports    the six research reports and their workflow: write, retry, resume, stop, reset; open one (`?id=`) to read,
+ *              edit, approve into the knowledge base, see the reasoning, write again or delete.
+ * Every detail also opens as a full page with `?view=full`. Every write refreshes the shared read cache, so the stat strip and
+ * the lists update without a reload.
+ *
+ * Reality of the API: this is the research of YOUR OWN workspace website (locked to one website); it has no lookup for other
+ * companies and no technographics, org chart or briefing endpoints. The screen says so instead of inventing data. To show a
+ * company's intelligence on a CRM company page, mount `CompanyIntelligenceTab` in the CRM block's `extraDetailTabs`.
+ *
+ * SDK operations: none of its own; the stat strip reads listIntelligenceDocuments, getGlobalContextTree,
+ * getResearchWorkflowStatus and getLatestIntelligenceTask (all free reads). Everything billable or destructive is inside the parts
+ * it composes (ResearchRun, SourceDetail, WikiDocumentDetail, ResearchReports, ReportDetail), each behind ConfirmSpendDialog.
+ * Prerequisites: `intelligence`, `global-context` and `research-reports` in the proxy allowlist; credits for research.
+ */
+import type { ReactNode } from "react";
+import { Telescope } from "lucide-react";
+import { Button } from "@graph8/sdk/ui";
+import { useUrlState } from "@/g8/hooks/use-url-state";
+import { ScreenLayout } from "@/g8/components/screen/screen-layout";
+import type { StatItem } from "@/g8/components/screen/stat-strip";
+import { SplitView } from "@/g8/components/screen/split-view";
+import { EmptyValue } from "@/g8/components/screen/key-value-list";
+import { plural } from "@/g8/lib/plural";
+import { useLatestRun, useResearchTarget, useSourceDocuments, useWikiStats, useWorkflow } from "../hooks/use-intelligence";
+import { humanize, isReportDone, slotsOf, whenDate } from "../lib/intelligence-types";
+import { CompanyProfileCard } from "./company-profile";
+import { IntelligenceSources } from "./intelligence-sources";
+import { ReportDetail } from "./report-detail";
+import { ResearchReports } from "./research-reports";
+import { ResearchRun } from "./research-run";
+import { SourceDetail } from "./source-detail";
+import { WikiDocumentDetail } from "./wiki-document-detail";
+import { WikiDocuments } from "./wiki-documents";
+
+/** The record open in the detail panel, passed to the slot props. */
+export type IntelligenceRecord = { kind: "source" | "document" | "report"; id: string };
+
+export interface CompanyIntelligenceScreenProps {
+  toolbarActions?: ReactNode;
+  /** Buttons added to the open record's header. */
+  renderDetailActions?: (record: IntelligenceRecord) => ReactNode;
+  /** Tabs added after the built-in ones on the open record. */
+  extraDetailTabs?: { id: string; label: string; render: (record: IntelligenceRecord) => ReactNode }[];
+  className?: string;
+}
+
+type Tab = "overview" | "sources" | "documents" | "reports";
+const TABS = ["overview", "sources", "documents", "reports"] as const;
+
+export function CompanyIntelligenceScreen(props: CompanyIntelligenceScreenProps) {
+  const [tabValue, setTab] = useUrlState("tab", "overview");
+  const tab: Tab = (TABS as readonly string[]).includes(tabValue) ? (tabValue as Tab) : "overview";
+  const [id, setId] = useUrlState("id", "");
+  const [view, setView] = useUrlState("view", "");
+  const expanded = view === "full" && Boolean(id);
+  const target = useResearchTarget();
+  const docs = useSourceDocuments();
+  const wiki = useWikiStats();
+  const flow = useWorkflow(target.primary);
+  const latest = useLatestRun();
+
+  const close = () => { setId(""); setView(""); };
+  const panel = { onClose: close, onExpand: expanded ? undefined : () => setView("full"), onCollapse: expanded ? () => setView("") : undefined };
+  const slots = (record: IntelligenceRecord) => ({
+    extraActions: props.renderDetailActions?.(record),
+    extraTabs: (props.extraDetailTabs ?? []).map((t) => ({ id: t.id, label: t.label, content: t.render(record) })),
+  });
+  const split = (list: ReactNode, detail: ReactNode) => (
+    <SplitView detailOpen={Boolean(id)} onCloseDetail={close} expanded={expanded} onExpandedChange={(next) => setView(next ? "full" : "")} detailWidth="lg" list={list} detail={id ? detail : null} />
+  );
+
+  const reportSlots = slotsOf(flow.workflow ?? undefined);
+  const stats: StatItem[] = [
+    { label: "Sources collected", value: docs.docs ? docs.docs.length.toLocaleString() : <EmptyValue /> },
+    { label: "Wiki documents", value: wiki.stats ? `${wiki.stats.completed.toLocaleString()} of ${wiki.stats.total.toLocaleString()}` : <EmptyValue />, hint: wiki.stats ? "finished" : undefined },
+    { label: "Research reports", value: flow.workflow ? `${reportSlots.filter((s) => isReportDone(s.status)).length} of ${reportSlots.length || 6}` : <EmptyValue />, hint: flow.workflow ? "finished" : undefined },
+    { label: "Last research", value: latest.run?.status ? humanize(latest.run.status) : <EmptyValue />, hint: latest.run?.completed_at ? whenDate(latest.run.completed_at) ?? undefined : latest.run ? undefined : "none yet", tone: latest.run?.status === "failed" ? "negative" : "neutral" },
+  ];
+
+  return (
+    <ScreenLayout
+      title="Company intelligence"
+      description="What the research of your website found, and the documents and reports written from it."
+      icon={<Telescope className="size-5" />}
+      actions={<>{props.toolbarActions}{tab === "overview" ? null : <Button onClick={() => { setTab("overview"); close(); }}>Research website</Button>}</>}
+      tabs={[{ id: "overview", label: "Overview" }, { id: "sources", label: "Sources" }, { id: "documents", label: "Documents" }, { id: "reports", label: "Reports" }]}
+      activeTab={tab}
+      onTabChange={(next) => { setTab(next); close(); }}
+      stats={stats}
+      className={props.className}
+    >
+      {tab === "overview" ? (
+        <div className="space-y-4">
+          <ResearchRun />
+          <CompanyProfileCard onOpenSource={(type) => { setTab("sources"); setId(type); }} />
+          <p className="text-xs text-muted-foreground">{plural(docs.docs?.length ?? 0, "source")} collected. This is the research of your own website: there is no lookup for other companies.</p>
+        </div>
+      ) : tab === "sources" ? (
+        split(<IntelligenceSources idParam="id" selectedType={id} onSelect={(s) => setId(s.dataType)} />, <SourceDetail key={id} dataType={id} {...panel} {...slots({ kind: "source", id })} />)
+      ) : tab === "documents" ? (
+        split(<WikiDocuments idParam="id" selectedId={id} onSelect={(d) => setId(d.id)} />, <WikiDocumentDetail key={id} docId={id} {...panel} {...slots({ kind: "document", id })} />)
+      ) : (
+        split(<ResearchReports idParam="id" selectedId={id} onSelect={(s) => s.id && setId(s.id)} />, <ReportDetail key={id} reportId={id} {...panel} {...slots({ kind: "report", id })} />)
+      )}
+    </ScreenLayout>
+  );
+}

package/blocks/company-intelligence/components/company-intelligence-tab.tsx

@@ -0,0 +1,88 @@
+"use client";
+
+/**
+ * CompanyIntelligenceTab: an optional tab for a company's detail page. Mount it from the CRM block's `extraDetailTabs`:
+ *
+ *   <CompaniesScreen extraDetailTabs={[{ id: "intelligence", label: "Intelligence", render: (c) => <CompanyIntelligenceTab company={c} /> }]} />
+ *
+ * What it can honestly show: the company intelligence API researches YOUR OWN workspace website (it is locked to one
+ * website) and has no lookup for other companies. So the tab shows
+ *   - the full company profile when the company on screen IS your workspace's website,
+ *   - the competitor entry your research holds for it when the company is one of the competitors your research found,
+ *   - otherwise a clear note that there is nothing to show (it never invents firmographics, news or technology data).
+ *
+ * SDK operations, in order:
+ *   1. getIntelligencePrimaryWebsite  GET /intelligence/primary-website            (read, through useResearchTarget)
+ *   2. getAllIntelligenceData         GET /intelligence/all/{website_url}          (read, through CompanyProfileCard) own-company case
+ *   3. getIntelligenceData            GET /intelligence/data/competitor_discovery  (read, through useSourceEntry) competitor case
+ */
+import { Skeleton } from "@graph8/sdk/ui";
+import { Telescope } from "lucide-react";
+import { ApiError } from "@/g8/components/api-error";
+import { EmptyState } from "@/g8/components/empty-state";
+import { SectionCard } from "@/g8/components/screen/section-card";
+import { StatusPill } from "@/g8/components/screen/status-pill";
+import { useBrand } from "@/g8/hooks/use-brand";
+import { entryData, useResearchTarget, useSourceEntry } from "../hooks/use-intelligence";
+import { asArray, canonicalDomain, humanize, isRec, text } from "../lib/intelligence-types";
+import { CompanyProfileCard } from "./company-profile";
+
+/** The few company fields the tab reads; the CRM block's CompanyRecord satisfies it. */
+export interface TabCompany { name?: string | null; domain?: string | null; website?: string | null }
+
+export interface CompanyIntelligenceTabProps {
+  company: TabCompany;
+  /** Called when a person asks for the full intelligence screen. Omit it to hide the button. */
+  onOpenIntelligence?: () => void;
+  className?: string;
+}
+
+export function CompanyIntelligenceTab({ company, onOpenIntelligence, className }: CompanyIntelligenceTabProps) {
+  const brand = useBrand();
+  const host = canonicalDomain(company.domain ?? company.website) || null;
+  const target = useResearchTarget();
+  const own = Boolean(host && target.primaryDomain && host === target.primaryDomain);
+  const competitors = useSourceEntry("competitor_discovery", target.primary, Boolean(target.primary) && !own);
+  if (target.loading) return <Skeleton className="h-32 w-full" />;
+  if (target.error) return <ApiError error={target.error} title="Could not load company intelligence" onRetry={() => void target.refetch()} />;
+  if (!host) return <EmptyState title="No website on record" description="Add this company's website to see what your research knows about it." compact icon={<Telescope />} />;
+  if (own) {
+    return (
+      <div className={className}>
+        <CompanyProfileCard website={host} />
+        {onOpenIntelligence ? <button type="button" className="mt-3 text-sm underline underline-offset-2" onClick={onOpenIntelligence}>Open company intelligence</button> : null}
+      </div>
+    );
+  }
+  if (competitors.error && (competitors.error as { status?: number }).status !== 404) return <ApiError error={competitors.error} title="Could not load the competitors" onRetry={() => void competitors.refetch()} />;
+  const list = asArray(entryData(competitors.data ?? null)?.competitors).filter(isRec);
+  const match = list.find((c) => canonicalDomain(text(c.domain)) === host);
+  if (match) {
+    const pills = [text(match.competitive_type), text(match.similarity) ? `${text(match.similarity)} similarity` : null, text(match.confidence) ? `${text(match.confidence)} confidence` : null].filter(Boolean) as string[];
+    return (
+      <div className={className}>
+        <SectionCard title={text(match.name) ?? host} description="A competitor your company research found">
+          <div className="space-y-2 text-sm">
+            <div className="flex flex-wrap gap-1.5">{pills.map((p) => <StatusPill key={p} tone="info" quiet>{humanize(p)}</StatusPill>)}</div>
+            {text(match.description) ? <p>{text(match.description)}</p> : null}
+            {text(match.reasoning) ? <p className="text-muted-foreground">{text(match.reasoning)}</p> : null}
+          </div>
+        </SectionCard>
+        {onOpenIntelligence ? <button type="button" className="mt-3 text-sm underline underline-offset-2" onClick={onOpenIntelligence}>Open company intelligence</button> : null}
+      </div>
+    );
+  }
+  if (competitors.loading && !competitors.data && target.primary) return <Skeleton className="h-32 w-full" />;
+  return (
+    <EmptyState
+      className={className}
+      compact
+      icon={<Telescope />}
+      title="No intelligence for this company"
+      description={target.primary
+        ? `${brand.linkLabel} researches your own website (${target.primary}). It has no profile, news or technology data for other companies, and this one is not among the competitors your research found.`
+        : `${brand.linkLabel} researches your own website, and that research has not run yet. It has no profile, news or technology data for other companies.`}
+      action={onOpenIntelligence ? <button type="button" className="text-sm underline underline-offset-2" onClick={onOpenIntelligence}>Open company intelligence</button> : undefined}
+    />
+  );
+}

package/blocks/company-intelligence/components/company-profile.tsx

@@ -0,0 +1,68 @@
+"use client";
+
+/**
+ * CompanyProfileCard: the company profile the research collected (industry, size, funding, links) with a one-line count of
+ * what else was found (products, keywords, competitors, articles). Mount it alone on any page.
+ *
+ * SDK operations, in order:
+ *   1. getIntelligencePrimaryWebsite  GET /intelligence/primary-website   (read, through useResearchTarget) used when no `website` prop is given
+ *   2. getAllIntelligenceData         GET /intelligence/all/{website_url} (read)  every source collected for the website
+ * Nothing here is billable. A source that was not collected is said to be missing, never shown as zero.
+ */
+import { Building2 } from "lucide-react";
+import { Skeleton } from "@graph8/sdk/ui";
+import { ApiError } from "@/g8/components/api-error";
+import { EmptyState } from "@/g8/components/empty-state";
+import { SectionCard } from "@/g8/components/screen/section-card";
+import { EntityAvatar } from "@/g8/components/screen/entity-avatar";
+import { plural } from "@/g8/lib/plural";
+import { entryData, useAllIntelligence, useResearchTarget } from "../hooks/use-intelligence";
+import { asArray, canonicalDomain, safeHttpUrl, text, whenDate } from "../lib/intelligence-types";
+import { CompanyProfileFields } from "./source-view";
+
+export interface CompanyProfileCardProps {
+  /** A website or host. Default: the workspace's research website. */
+  website?: string | null;
+  /** Called with a source type when a person asks for the full source. */
+  onOpenSource?: (dataType: string) => void;
+  className?: string;
+}
+
+const FOUND: Array<[string, string, string, string]> = [
+  ["product_inventory", "products", "product", "Products"],
+  ["company_keywords", "keywords", "keyword", "Keywords"],
+  ["competitor_discovery", "competitors", "competitor", "Competitors"],
+  ["brand_news", "articles", "article", "News"],
+  ["audience_questions", "questions", "audience question", "Audience questions"],
+];
+
+export function CompanyProfileCard({ website, onOpenSource, className }: CompanyProfileCardProps) {
+  const target = useResearchTarget();
+  const host = canonicalDomain(website ?? target.primary) || null;
+  const all = useAllIntelligence(host);
+  if (target.loading && !website) return <Skeleton className="h-40 w-full" />;
+  if (!host) return <EmptyState title="No research website yet" description="Start the website research to build the company profile." compact icon={<Building2 />} />;
+  if (all.error) return <ApiError error={all.error} title="Could not load the company profile" onRetry={() => void all.refetch()} />;
+  if (all.loading || !all.entries) return <Skeleton className="h-40 w-full" />;
+  const profile = entryData(all.entries.company_enrichment);
+  const logo = safeHttpUrl(entryData(all.entries.visual_assets)?.logo_url);
+  const name = text(profile?.company_name) ?? host;
+  const collected = whenDate(all.entries.company_enrichment?.collected_at);
+  return (
+    <SectionCard className={className} title={name} description={host + (collected ? `, collected ${collected}` : "")} icon={<EntityAvatar name={name} imageUrl={logo ?? undefined} kind="company" size="sm" />}>
+      {profile ? <CompanyProfileFields data={profile} /> : <p className="text-sm text-muted-foreground">The company profile was not collected for this website.</p>}
+      <ul className="mt-3 flex flex-wrap gap-x-4 gap-y-1 border-t border-border pt-3 text-xs text-muted-foreground">
+        {FOUND.map(([type, key, noun, label]) => {
+          const data = entryData(all.entries?.[type]);
+          if (!data) return <li key={type}>{label}: not collected</li>;
+          const n = asArray(data[key]).length;
+          return (
+            <li key={type}>
+              {onOpenSource && n ? <button type="button" className="underline underline-offset-2" onClick={() => onOpenSource(type)}>{plural(n, noun)}</button> : plural(n, noun)}
+            </li>
+          );
+        })}
+      </ul>
+    </SectionCard>
+  );
+}

package/blocks/company-intelligence/components/intelligence-sources.tsx

@@ -0,0 +1,63 @@
+"use client";
+
+/**
+ * IntelligenceSources: the list of data sources the research collected (company profile, products, keywords, competitors,
+ * news, audience questions, brand assets ...), plus the sources of the last run that failed or have not finished, so a
+ * missing source is visible and can be re-collected. Click a row to open it.
+ *
+ * SDK operations, in order:
+ *   1. listIntelligenceDocuments  GET /intelligence/documents       (read)  the collected sources
+ *   2. getLatestIntelligenceTask  GET /intelligence/latest-task     (read)  the last run
+ *   3. getIntelligenceStatus      GET /intelligence/status/{task_id} (read) which steps of that run did not complete
+ * The API does not page this list (at most one row per source type); the header says how many there are.
+ */
+import { Database } from "lucide-react";
+import { Skeleton } from "@graph8/sdk/ui";
+import { ApiError } from "@/g8/components/api-error";
+import { EmptyState } from "@/g8/components/empty-state";
+import { RecordLink } from "@/g8/components/screen/record-link";
+import { StatusPill } from "@/g8/components/screen/status-pill";
+import { plural } from "@/g8/lib/plural";
+import { useLatestRun, useRunStatus, useSourceDocuments } from "../hooks/use-intelligence";
+import { humanize, runSteps, stepTone, text, titleize, whenDate } from "../lib/intelligence-types";
+
+export interface SourceRow { dataType: string; label: string; folder: string | null; collectedAt: string | null; state: string }
+
+export interface IntelligenceSourcesProps {
+  /** Called when a person opens a source. */
+  onSelect?: (source: SourceRow) => void;
+  /** The open source's type, to mark its row. */
+  selectedType?: string;
+  /** The URL param the owning screen reads for the open source, so Cmd-click opens it in a new tab. */
+  idParam?: string;
+  className?: string;
+}
+
+export function IntelligenceSources({ onSelect, selectedType, idParam, className }: IntelligenceSourcesProps) {
+  const { docs, error, refetch } = useSourceDocuments();
+  const { run } = useLatestRun();
+  const { status } = useRunStatus(run?.task_id);
+  if (error) return <ApiError error={error} title="Could not load the sources" onRetry={() => void refetch()} />;
+  if (!docs) return <Skeleton className="h-40 w-full" />;
+  const collected: SourceRow[] = docs.map((d) => ({ dataType: d.data_type, label: text(d.display_name) ?? humanize(d.data_type), folder: text(d.folder), collectedAt: d.collected_at ?? null, state: "completed" }));
+  const have = new Set(collected.map((r) => r.dataType));
+  const missing: SourceRow[] = runSteps(status ?? undefined).filter((s) => !have.has(s.key) && s.state !== "completed").map((s) => ({ dataType: s.key, label: titleize(s.key), folder: null, collectedAt: null, state: s.state }));
+  const rows = [...collected, ...missing];
+  if (rows.length === 0) return <EmptyState title="No sources yet" description="Start the website research and the sources it collects will appear here." icon={<Database />} />;
+  return (
+    <div className={className}>
+      <p className="mb-2 text-xs text-muted-foreground" role="status">All {plural(rows.length, "source")}{missing.length ? `, ${plural(missing.length, "source")} not collected` : ""}</p>
+      <ul className="divide-y divide-border rounded-md border border-border">
+        {rows.map((r) => (
+          <li key={r.dataType} aria-current={r.dataType === selectedType ? "true" : undefined} className="flex items-center justify-between gap-3 px-3 py-2 text-sm aria-[current=true]:bg-muted">
+            <div className="min-w-0">
+              <RecordLink id={r.dataType} param={idParam} onOpen={() => onSelect?.(r)}>{r.label}</RecordLink>
+              <div className="text-xs text-muted-foreground">{[r.folder, r.collectedAt ? `Collected ${whenDate(r.collectedAt)}` : null].filter(Boolean).join(", ") || "Not collected"}</div>
+            </div>
+            <StatusPill tone={stepTone(r.state)} quiet>{r.state === "completed" ? "Collected" : humanize(r.state)}</StatusPill>
+          </li>
+        ))}
+      </ul>
+    </div>
+  );
+}