@anthusai/papyrus 1.2.0 → 1.4.0-next.1

package/components/reference-cyclotron-priming.tsx

@@ -0,0 +1,85 @@
+"use client";
+
+import { useState } from "react";
+import { primingStateText, type PrimingRequestView } from "../lib/relevance-status";
+
+export type PrimingFormInput = { url: string; label: string; explanation: string };
+
+/**
+ * A compact form that primes the running relevance cyclotron with a pasted
+ * URL. The next sweep reads the page, adds it to the cyclotron's example list
+ * and records the outcome, which this list shows beside each saved request.
+ */
+export function ReferenceCyclotronPriming({
+  labels,
+  requests,
+  onRequestPriming,
+}: {
+  labels: readonly string[];
+  requests: PrimingRequestView[];
+  onRequestPriming: (input: PrimingFormInput) => Promise<void> | void;
+}) {
+  const [url, setUrl] = useState("");
+  const [label, setLabel] = useState(labels[0] ?? "");
+  const [explanation, setExplanation] = useState("");
+  const [message, setMessage] = useState<string | null>(null);
+
+  async function submit() {
+    setMessage("Saving…");
+    try {
+      await onRequestPriming({ url, label, explanation });
+      setUrl("");
+      setExplanation("");
+      setMessage("Saved. The next sweep reads the page and adds it to the cyclotron.");
+    } catch (error) {
+      setMessage(error instanceof Error ? error.message : String(error));
+    }
+  }
+
+  return (
+    <section aria-label="Prime the relevance cyclotron" className="space-y-2 text-sm" data-reference-cyclotron-priming>
+      <form
+        className="flex flex-wrap items-end gap-3"
+        onSubmit={(event) => {
+          event.preventDefault();
+          void submit();
+        }}
+      >
+        <label className="flex min-w-64 flex-1 flex-col gap-1">
+          <span className="text-xs text-muted-foreground">Prime with a URL</span>
+          <input
+            aria-label="Priming URL"
+            onChange={(event) => setUrl(event.target.value)}
+            placeholder="https://"
+            required
+            type="url"
+            value={url}
+          />
+        </label>
+        <label className="flex flex-col gap-1">
+          <span className="text-xs text-muted-foreground">Label</span>
+          <select aria-label="Priming label" onChange={(event) => setLabel(event.target.value)} value={label}>
+            {labels.map((choice) => (
+              <option key={choice} value={choice}>{choice}</option>
+            ))}
+          </select>
+        </label>
+        <label className="flex min-w-48 flex-1 flex-col gap-1">
+          <span className="text-xs text-muted-foreground">Why (optional)</span>
+          <input aria-label="Priming explanation" onChange={(event) => setExplanation(event.target.value)} type="text" value={explanation} />
+        </label>
+        <button className="cyclotron-review-secondary" type="submit">Save</button>
+        {message ? <p className="basis-full text-xs" role="status">{message}</p> : null}
+      </form>
+      {requests.length ? (
+        <ul aria-label="Saved priming requests" className="space-y-1 text-xs text-muted-foreground">
+          {requests.slice(0, 10).map((view) => (
+            <li data-priming-request-state={view.outcome?.state ?? "waiting"} key={view.request.requestId}>
+              <span className="font-medium">{view.request.label}</span> {view.request.url} · {primingStateText(view)}
+            </li>
+          ))}
+        </ul>
+      ) : null}
+    </section>
+  );
+}

package/components/topic-steering-workspace.tsx

@@ -57,6 +57,8 @@ import {
   type KnowledgeQueryResponse,
   type NewsroomRecordPage,
   loadCyclotronStatus,
+  requestCyclotronPriming,
+  loadCyclotronPrimingRequests,
   requestCyclotronReviewRate,
 } from "./news-desk-taxonomy-client";
 import { listConsoleThreads } from "../lib/console-chat-client";
@@ -161,7 +163,13 @@ import {
   referenceCurationStatusForAction,
 } from "../lib/reference-policy";
 import { currentRelevanceDecisions } from "../lib/relevance-decisions";
-import { buildReviewRateRequest, DEMO_CYCLOTRON_STATUS } from "../lib/relevance-status";
+import {
+  buildPrimingRequest,
+  buildReviewRateRequest,
+  DEFAULT_RELEVANCE_CYCLOTRON,
+  DEMO_CYCLOTRON_STATUS,
+  type PrimingRequestView,
+} from "../lib/relevance-status";
 import type { CyclotronStatus } from "cyclotron/cyclotron-status";
 import {
   referenceDisplaySummary,
@@ -789,6 +797,23 @@ function NewsDeskDashboard({
     () => [...relevanceDecisions.values()].find((decision) => decision.cyclotronId)?.cyclotronId ?? null,
     [relevanceDecisions],
   );
+  const primingCyclotronId = relevanceCyclotronId ?? DEFAULT_RELEVANCE_CYCLOTRON.id;
+  const primingLabels = useMemo(
+    () => [...relevanceDecisions.values()].find((decision) => decision.classes.length)?.classes
+      ?? DEFAULT_RELEVANCE_CYCLOTRON.labels,
+    [relevanceDecisions],
+  );
+  const [primingRequests, setPrimingRequests] = useState<PrimingRequestView[]>([]);
+  useEffect(() => {
+    if (dashboard.isDemo) return;
+    let cancelled = false;
+    const refresh = () => loadCyclotronPrimingRequests(primingCyclotronId)
+      .then((views) => { if (!cancelled) setPrimingRequests(views); })
+      .catch(() => { if (!cancelled) setPrimingRequests([]); });
+    void refresh();
+    const timer = window.setInterval(() => { void refresh(); }, 30_000);
+    return () => { cancelled = true; window.clearInterval(timer); };
+  }, [dashboard.isDemo, primingCyclotronId]);
   const [cyclotronStatus, setCyclotronStatus] = useState<CyclotronStatus | null>(null);
   useEffect(() => {
     if (!relevanceCyclotronId) return;
@@ -3189,6 +3214,15 @@ function NewsDeskDashboard({
             disabled={controlsDisabled}
             initialReferenceLineageId={initialSelection.reference ?? pathnameReferenceLineageId}
             cyclotronStatus={cyclotronStatus}
+            cyclotronPriming={{
+              labels: primingLabels,
+              requests: primingRequests,
+              onRequest: async (input) => {
+                const request = buildPrimingRequest(input, authState.label, primingLabels);
+                if (!dashboard.isDemo) await requestCyclotronPriming(primingCyclotronId, request);
+                setPrimingRequests((current) => [{ request, outcome: null }, ...current]);
+              },
+            }}
             decisions={relevanceDecisions}
             onRequestReviewRate={relevanceCyclotronId ? async (choice) => {
               const request = buildReviewRateRequest(choice, authState.label);

package/lib/article-flow.ts

@@ -0,0 +1,95 @@
+import {
+  type ArticlePublicationItem,
+  getArticlePublicationItems,
+  type PublicationItem,
+} from "./publication-items";
+import { type LayoutCursor } from "./pretext-layout";
+import { type ArticleFlow, type PlacedTextRange, type SolvedFurniture } from "./layout-types";
+import { EMPTY_CURSOR } from "./layout-config";
+
+export function createArticleFlows(items: PublicationItem[]): Map<string, ArticleFlow> {
+  return new Map(
+    getArticlePublicationItems(items).map((article) => [
+      article.slug,
+      {
+        article,
+        currentCursor: { ...EMPTY_CURSOR },
+        placedRanges: [],
+        usedImageAssetIds: new Set<string>(),
+      },
+    ]),
+  );
+}
+
+export function getOrCreateFlow(flows: Map<string, ArticleFlow>, flowKey: string, article: ArticlePublicationItem): ArticleFlow {
+  const existing = flows.get(flowKey);
+  if (existing) return existing;
+  const flow = {
+    article,
+    currentCursor: { ...EMPTY_CURSOR },
+    placedRanges: [],
+    usedImageAssetIds: new Set<string>(),
+  };
+  flows.set(flowKey, flow);
+  return flow;
+}
+
+export function resetArticleFlow(flow: ArticleFlow): void {
+  flow.currentCursor = { ...EMPTY_CURSOR };
+  flow.placedRanges = [];
+  flow.usedImageAssetIds.clear();
+}
+
+export function requireKnownItem(itemId: string, itemsBySlug: Map<string, PublicationItem>): PublicationItem {
+  const item = itemsBySlug.get(itemId);
+  if (!item) throw new Error(`Layout references missing item ${itemId}`);
+  return item;
+}
+
+export function requireArticleItem(itemId: string, itemsBySlug: Map<string, PublicationItem>): ArticlePublicationItem {
+  const item = requireKnownItem(itemId, itemsBySlug);
+  if (item.type !== "article") throw new Error(`Layout articleFrame requires article item ${itemId}`);
+  return item;
+}
+
+export function createTextRange({
+  flow,
+  pageId,
+  blockId,
+  startCursor,
+  endCursor,
+  exhausted,
+}: {
+  flow: ArticleFlow;
+  pageId: string;
+  blockId: string;
+  startCursor: LayoutCursor;
+  endCursor: LayoutCursor;
+  exhausted: boolean;
+}): PlacedTextRange {
+  return {
+    articleId: flow.article.slug,
+    pageId,
+    blockId,
+    startCursor,
+    endCursor,
+    exhausted,
+  };
+}
+
+export function commitTextRange(flow: ArticleFlow, range: PlacedTextRange): void {
+  flow.currentCursor = { ...range.endCursor };
+  flow.placedRanges.push(range);
+}
+
+export function commitUsedImageFurniture(flow: ArticleFlow, furniture: SolvedFurniture[]): void {
+  for (const item of furniture) {
+    if (item.kind === "image") {
+      flow.usedImageAssetIds.add(item.assetId);
+      continue;
+    }
+    if (item.kind === "mediaCluster") {
+      for (const image of item.images) flow.usedImageAssetIds.add(image.assetId);
+    }
+  }
+}