@anthusai/papyrus 1.11.0 → 1.12.0

package/lib/prospectus-tenant.ts

@@ -0,0 +1,22 @@
+import {
+  PROSPECTUS_SESSION_COOKIE,
+  loadProspectusSessionSealingSecret,
+  openProspectusCookie,
+  type ProspectusSignedInSession,
+} from "./prospectus-session";
+import { tenantIdForProspectusAccount } from "./tenant-keys";
+
+type CookieReader = { get(name: string): { value: string } | undefined };
+
+/**
+ * The tenant of the publishing account the signed-in person selected, read from the sealed Prospectus session
+ * cookie. Returns undefined on a site without Prospectus, with no session, or with no account selected, so the
+ * caller falls back to the site's own tenant (PAPYRUS_TENANT_ID).
+ */
+export async function selectedTenantIdFromCookies(cookies: CookieReader, loadSecret: () => Promise<string | null> = loadProspectusSessionSealingSecret): Promise<string | undefined> {
+  const sealingSecret = await loadSecret();
+  if (!sealingSecret) return undefined;
+  const session = openProspectusCookie<ProspectusSignedInSession>(sealingSecret, PROSPECTUS_SESSION_COOKIE, cookies.get(PROSPECTUS_SESSION_COOKIE)?.value);
+  if (!session || session.accessTokenExpiresAt * 1000 <= Date.now()) return undefined;
+  return tenantIdForProspectusAccount(session.selectedAccountId);
+}

package/lib/relevance-decisions.ts

@@ -2,6 +2,15 @@ import type { SemanticRelationRecord } from "./category-repository";
 
 export const RELEVANCE_RELATION = "relevance_decision_is";
 
+/** What produced a suggestion beyond the model version, as the sweep recorded it. */
+export type RelevanceProvenance = {
+  labelSet: string[];
+  doctrineFingerprint: string | null;
+  teachingFingerprint: string | null;
+  teachingLabels: number;
+  primingExamples: number;
+};
+
 /** The relevance cyclotron's current decision about one reference, as the References tab shows it. */
 export type RelevanceDecisionView = {
   decisionRelationId: string;
@@ -19,6 +28,10 @@ export type RelevanceDecisionView = {
   /** Thumbs for a two-class decision with a positive label; per-class buttons otherwise. */
   reviewControl: "thumbs" | "labels";
   cyclotronId: string | null;
+  /** When the cyclotron made the suggestion, if the decision recorded it. */
+  decidedAt: string | null;
+  /** Null for decisions made before provenance was recorded. */
+  provenance: RelevanceProvenance | null;
 };
 
 /** What an editor submits from the review control. */
@@ -49,6 +62,20 @@ function parseMetadata(value: unknown): Record<string, unknown> {
   }
 }
 
+function parseProvenance(value: unknown): RelevanceProvenance | null {
+  const record = parseMetadata(value);
+  if (!Object.keys(record).length) return null;
+  const count = (entry: unknown) => (Number.isFinite(Number(entry)) ? Number(entry) : 0);
+  const text = (entry: unknown) => (typeof entry === "string" && entry ? entry : null);
+  return {
+    labelSet: Array.isArray(record.labelSet) ? record.labelSet.map(String) : [],
+    doctrineFingerprint: text(record.doctrineFingerprint),
+    teachingFingerprint: text(record.teachingFingerprint),
+    teachingLabels: count(record.teachingLabels),
+    primingExamples: count(record.primingExamples),
+  };
+}
+
 /**
  * Current decisions keyed by reference lineage, from relations the Newsroom
  * already loads: no extra request per row.
@@ -77,6 +104,8 @@ export function currentRelevanceDecisions(relations: SemanticRelationRecord[]):
       question: typeof metadata.question === "string" ? metadata.question : null,
       reviewControl: metadata.reviewControl === "thumbs" ? "thumbs" : "labels",
       cyclotronId: typeof metadata.cyclotronId === "string" ? metadata.cyclotronId : null,
+      decidedAt: typeof metadata.decidedAt === "string" ? metadata.decidedAt : null,
+      provenance: parseProvenance(metadata.provenance),
     });
   }
   return decisions;

package/lib/tenant-keys.ts

@@ -0,0 +1,32 @@
+export const TENANT_ID_ENVIRONMENT_VARIABLE = "PAPYRUS_TENANT_ID";
+const TENANT_KEY_SEPARATOR = "#";
+const TENANT_ID_PATTERN = /^[a-z0-9][a-z0-9-]{0,62}$/;
+
+export function validateTenantId(tenantId: string): string {
+  if (!TENANT_ID_PATTERN.test(tenantId)) {
+    throw new Error(`Tenant id "${tenantId}" must be lowercase letters, digits and hyphens, starting with a letter or digit.`);
+  }
+  return tenantId;
+}
+
+export function tenantIdFromEnvironment(environment: NodeJS.ProcessEnv = process.env): string | undefined {
+  const configured = environment[TENANT_ID_ENVIRONMENT_VARIABLE]?.trim();
+  return configured ? validateTenantId(configured) : undefined;
+}
+
+export function tenantScopedValue(tenantId: string | undefined, value: string): string {
+  if (!tenantId) return value;
+  const prefix = `${tenantId}${TENANT_KEY_SEPARATOR}`;
+  return value.startsWith(prefix) ? value : `${prefix}${value}`;
+}
+
+export function rowBelongsToTenant(tenantId: string | undefined, row: { tenantId?: string | null } | null | undefined): boolean {
+  if (!tenantId || !row) return true;
+  return row.tenantId === tenantId;
+}
+
+/** The tenant a Prospectus publishing account maps to: its id as lowercase letters, digits and hyphens. */
+export function tenantIdForProspectusAccount(accountId: string | null | undefined): string | undefined {
+  const normalized = (accountId ?? "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 63);
+  return normalized ? validateTenantId(normalized) : undefined;
+}

package/package.json

@@ -64,6 +64,7 @@
       "types": "./infra/amplify-app-shell.ts",
       "default": "./infra/index.js"
     },
+    "./components/administration-delegations-panel": "./components/administration-delegations-panel.tsx",
     "./components/ai-elements/conversation": "./components/ai-elements/conversation.tsx",
     "./components/ai-elements/model-selector": "./components/ai-elements/model-selector.tsx",
     "./components/ai-elements/prompt-input": "./components/ai-elements/prompt-input.tsx",
@@ -76,6 +77,7 @@
     "./components/article-video": "./components/article-video.tsx",
     "./components/blog-page-background": "./components/blog-page-background.tsx",
     "./components/board-card-excerpts": "./components/board-card-excerpts.tsx",
+    "./components/curation-delegation-client": "./components/curation-delegation-client.ts",
     "./components/dev-sandbox-editor-sign-in": "./components/dev-sandbox-editor-sign-in.tsx",
     "./components/markus-ir-preview": "./components/markus-ir-preview.tsx",
     "./components/news-desk-client-provider": "./components/news-desk-client-provider.tsx",
@@ -110,6 +112,8 @@
     "./components/reference-curation-controls": "./components/reference-curation-controls.tsx",
     "./components/reference-cyclotron-priming": "./components/reference-cyclotron-priming.tsx",
     "./components/reference-cyclotron-status": "./components/reference-cyclotron-status.tsx",
+    "./components/reference-cyclotron-suggestion": "./components/reference-cyclotron-suggestion.tsx",
+    "./components/reference-live-agreement": "./components/reference-live-agreement.tsx",
     "./components/reference-priming": "./components/reference-priming.tsx",
     "./components/reference-relevance-review": "./components/reference-relevance-review.tsx",
     "./components/reference-source-preview": "./components/reference-source-preview.tsx",
@@ -172,6 +176,8 @@
     "./lib/content-source-context": "./lib/content-source-context.ts",
     "./lib/content-types": "./lib/content-types.ts",
     "./lib/curation-client": "./lib/curation-client.ts",
+    "./lib/curation-delegation-helpers": "./lib/curation-delegation-helpers.ts",
+    "./lib/cyclotron-suggestions": "./lib/cyclotron-suggestions.ts",
     "./lib/define-site": "./lib/define-site.ts",
     "./lib/demo-amplify-outputs": "./lib/demo-amplify-outputs.ts",
     "./lib/dev-sandbox-editor-auth": "./lib/dev-sandbox-editor-auth.ts",
@@ -192,6 +198,7 @@
     "./lib/layout-types": "./lib/layout-types.ts",
     "./lib/layout-warnings": "./lib/layout-warnings.ts",
     "./lib/local-preview-seed": "./lib/local-preview-seed.ts",
+    "./lib/local-preview-tenant": "./lib/local-preview-tenant.ts",
     "./lib/local-preview": "./lib/local-preview.ts",
     "./lib/markus-body": "./lib/markus-body.ts",
     "./lib/markus-ir": "./lib/markus-ir.ts",
@@ -234,6 +241,7 @@
     "./lib/prospectus-session": "./lib/prospectus-session.ts",
     "./lib/prospectus-sign-in-routes": "./lib/prospectus-sign-in-routes.ts",
     "./lib/prospectus-site-identity": "./lib/prospectus-site-identity.ts",
+    "./lib/prospectus-tenant": "./lib/prospectus-tenant.ts",
     "./lib/public-placeholder-config": "./lib/public-placeholder-config.ts",
     "./lib/publication-cyclotron": "./lib/publication-cyclotron.ts",
     "./lib/publication-items": "./lib/publication-items.ts",
@@ -267,6 +275,7 @@
     "./lib/staging-gated-path": "./lib/staging-gated-path.ts",
     "./lib/staging-preview-object": "./lib/staging-preview-object.ts",
     "./lib/story-reporting-trail": "./lib/story-reporting-trail.ts",
+    "./lib/tenant-keys": "./lib/tenant-keys.ts",
     "./lib/test-editor-override": "./lib/test-editor-override.ts",
     "./lib/text-columns": "./lib/text-columns.ts",
     "./lib/themed-image": "./lib/themed-image.ts",
@@ -365,7 +374,7 @@
       "optional": true
     }
   },
-  "version": "1.11.0",
+  "version": "1.12.0",
   "dependencies": {
     "@aws-amplify/adapter-nextjs": "^1.7.3",
     "@aws-crypto/sha256-js": "5.2.0",

package/routes.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.11.0",
+  "version": "1.12.0",
   "routes": [
     {
       "file": "app/%5F_preview/[[...path]]/route.ts",