pxengine 0.1.105 → 0.1.106

package/dist/index.d.cts

@@ -3514,6 +3514,14 @@ interface ResearchReportJobCardProps {
     key_findings?: string[];
     /** HTML report URL */
     html_url?: string;
+    /** How the report was generated: template (default) or legacy */
+    generation_mode?: "template" | "legacy" | string;
+    /** Built-in template id used to render the report */
+    template_id?: string;
+    /** Saved version id after user approval */
+    template_version_id?: string;
+    /** User review state for template-based reports */
+    review_status?: "pending_review" | "approved" | "auto" | string;
     /** Dynamic theme colors generated based on topic */
     theme?: ReportTheme;
     /** Error message if job failed */
@@ -3524,6 +3532,17 @@ interface ResearchReportJobCardProps {
     pollUrl?: string;
     /** Auth token for polling requests */
     authToken?: string;
+    /**
+     * Shareable link copied when the user clicks Share.
+     * Falls back to `/r/{job_id}` on the current origin when not provided.
+     */
+    shareUrl?: string;
+    /**
+     * Approve endpoint (POST). Defaults to `/api/reports/{job_id}/approve`.
+     */
+    approveUrl?: string;
+    /** Regenerate endpoint (POST). Defaults to `/api/reports/{job_id}/regenerate`. */
+    regenerateUrl?: string;
     /** Additional CSS classes */
     className?: string;
     /** Callback when job completes */
@@ -3548,6 +3567,10 @@ interface ResearchReportJobOutput {
     key_findings?: string[];
     theme?: ReportTheme;
     html_url?: string;
+    generation_mode?: string;
+    template_id?: string;
+    template_version_id?: string;
+    review_status?: string;
 }
 
 declare const ResearchReportJobCard: React__default.FC<ResearchReportJobCardProps>;

package/dist/index.d.ts

@@ -3514,6 +3514,14 @@ interface ResearchReportJobCardProps {
     key_findings?: string[];
     /** HTML report URL */
     html_url?: string;
+    /** How the report was generated: template (default) or legacy */
+    generation_mode?: "template" | "legacy" | string;
+    /** Built-in template id used to render the report */
+    template_id?: string;
+    /** Saved version id after user approval */
+    template_version_id?: string;
+    /** User review state for template-based reports */
+    review_status?: "pending_review" | "approved" | "auto" | string;
     /** Dynamic theme colors generated based on topic */
     theme?: ReportTheme;
     /** Error message if job failed */
@@ -3524,6 +3532,17 @@ interface ResearchReportJobCardProps {
     pollUrl?: string;
     /** Auth token for polling requests */
     authToken?: string;
+    /**
+     * Shareable link copied when the user clicks Share.
+     * Falls back to `/r/{job_id}` on the current origin when not provided.
+     */
+    shareUrl?: string;
+    /**
+     * Approve endpoint (POST). Defaults to `/api/reports/{job_id}/approve`.
+     */
+    approveUrl?: string;
+    /** Regenerate endpoint (POST). Defaults to `/api/reports/{job_id}/regenerate`. */
+    regenerateUrl?: string;
     /** Additional CSS classes */
     className?: string;
     /** Callback when job completes */
@@ -3548,6 +3567,10 @@ interface ResearchReportJobOutput {
     key_findings?: string[];
     theme?: ReportTheme;
     html_url?: string;
+    generation_mode?: string;
+    template_id?: string;
+    template_version_id?: string;
+    review_status?: string;
 }
 
 declare const ResearchReportJobCard: React__default.FC<ResearchReportJobCardProps>;

package/dist/index.mjs

@@ -38973,7 +38973,7 @@ var ExportModal = ({ formats, title, onClose }) => {
           );
         })
       ] }),
-      /* @__PURE__ */ jsx147("p", { className: "text-xs text-zinc-600 mt-4 text-center", children: "Download links expire in 7 days" })
+      /* @__PURE__ */ jsx147("p", { className: "text-xs text-zinc-600 mt-4 text-center", children: "Download links expire in 90 days" })
     ] })
   ] });
 };
@@ -39543,6 +39543,19 @@ var ExpandIcon2 = () => /* @__PURE__ */ jsxs109("svg", { width: "14", height: "1
   /* @__PURE__ */ jsx148("line", { x1: "21", y1: "3", x2: "14", y2: "10" }),
   /* @__PURE__ */ jsx148("line", { x1: "3", y1: "21", x2: "10", y2: "14" })
 ] });
+var ShareIcon2 = () => /* @__PURE__ */ jsxs109("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.2", strokeLinecap: "round", strokeLinejoin: "round", children: [
+  /* @__PURE__ */ jsx148("path", { d: "M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71" }),
+  /* @__PURE__ */ jsx148("path", { d: "M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71" })
+] });
+var CheckIcon2 = () => /* @__PURE__ */ jsx148("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", strokeLinejoin: "round", children: /* @__PURE__ */ jsx148("polyline", { points: "20 6 9 17 4 12" }) });
+var RefreshIcon = () => /* @__PURE__ */ jsxs109("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.2", strokeLinecap: "round", strokeLinejoin: "round", children: [
+  /* @__PURE__ */ jsx148("polyline", { points: "23 4 23 10 17 10" }),
+  /* @__PURE__ */ jsx148("path", { d: "M20.49 15a9 9 0 1 1-2.12-9.36L23 10" })
+] });
+function formatTemplateLabel(templateId) {
+  if (!templateId) return null;
+  return templateId.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+}
 var FullscreenPreviewModal = ({ url, title, onClose }) => {
   useEffect7(() => {
     const onKey = (e) => {
@@ -39588,7 +39601,7 @@ var FullscreenPreviewModal = ({ url, title, onClose }) => {
 };
 var ResearchReportJobCard = (props) => {
   const {
-    job_id: _job_id,
+    job_id,
     title: initialTitle,
     status: initialStatus,
     topic: _initialTopic,
@@ -39599,11 +39612,18 @@ var ResearchReportJobCard = (props) => {
     executive_summary: initialSummary,
     key_findings: _initialFindings,
     html_url: initialHtmlUrl,
+    generation_mode: initialGenerationMode,
+    template_id: initialTemplateId,
+    template_version_id: initialTemplateVersionId,
+    review_status: initialReviewStatus,
     theme: initialTheme,
     error: initialError,
     progress: initialProgress,
     pollUrl,
     authToken,
+    shareUrl,
+    approveUrl,
+    regenerateUrl,
     className,
     onComplete,
     onFailed,
@@ -39618,11 +39638,23 @@ var ResearchReportJobCard = (props) => {
   const [wordCount, setWordCount] = useState11(initialWordCount ?? 0);
   const [summary, setSummary] = useState11(initialSummary || "");
   const [htmlUrl, setHtmlUrl] = useState11(initialHtmlUrl || "");
+  const [generationMode, setGenerationMode] = useState11(
+    initialGenerationMode || (initialHtmlUrl ? "template" : "")
+  );
+  const [templateId, setTemplateId] = useState11(initialTemplateId || "");
+  const [templateVersionId, setTemplateVersionId] = useState11(initialTemplateVersionId || "");
+  const [reviewStatus, setReviewStatus] = useState11(
+    initialReviewStatus || (initialHtmlUrl ? "pending_review" : "")
+  );
   const [theme, setTheme] = useState11(initialTheme || DEFAULT_THEME);
   const [error, setError] = useState11(initialError);
   const [progress, setProgress] = useState11(initialProgress);
   const [showPreview, setShowPreview] = useState11(false);
   const [previewScale, setPreviewScale] = useState11(1);
+  const [copied, setCopied] = useState11(false);
+  const [approving, setApproving] = useState11(false);
+  const [regenerating, setRegenerating] = useState11(false);
+  const [approveError, setApproveError] = useState11(null);
   const previewRef = useRef6(null);
   const intervalRef = useRef6(null);
   const onCompleteRef = useRef6(onComplete);
@@ -39640,6 +39672,18 @@ var ResearchReportJobCard = (props) => {
   useEffect7(() => {
     if (initialHtmlUrl) setHtmlUrl(initialHtmlUrl);
   }, [initialHtmlUrl]);
+  useEffect7(() => {
+    if (initialGenerationMode) setGenerationMode(initialGenerationMode);
+  }, [initialGenerationMode]);
+  useEffect7(() => {
+    if (initialTemplateId) setTemplateId(initialTemplateId);
+  }, [initialTemplateId]);
+  useEffect7(() => {
+    if (initialTemplateVersionId) setTemplateVersionId(initialTemplateVersionId);
+  }, [initialTemplateVersionId]);
+  useEffect7(() => {
+    if (initialReviewStatus) setReviewStatus(initialReviewStatus);
+  }, [initialReviewStatus]);
   useEffect7(() => {
     if (initialDepth) setDepth(initialDepth);
   }, [initialDepth]);
@@ -39707,6 +39751,10 @@ var ResearchReportJobCard = (props) => {
           setWordCount(output.word_count || 0);
           setSummary(output.executive_summary || "");
           setHtmlUrl(output.html_url || "");
+          if (output.generation_mode) setGenerationMode(output.generation_mode);
+          if (output.template_id) setTemplateId(output.template_id);
+          if (output.template_version_id) setTemplateVersionId(output.template_version_id);
+          if (output.review_status) setReviewStatus(output.review_status);
           if (output.theme) {
             setTheme(output.theme);
           }
@@ -39888,6 +39936,120 @@ var ResearchReportJobCard = (props) => {
       window.open(htmlUrl, "_blank", "noopener,noreferrer");
     }
   };
+  const resolveShareLink = () => {
+    if (shareUrl) return shareUrl;
+    if (typeof window !== "undefined" && job_id) {
+      return `${window.location.origin}/r/${job_id}`;
+    }
+    return htmlUrl;
+  };
+  const handleShare = async () => {
+    const link = resolveShareLink();
+    if (!link) return;
+    try {
+      await navigator.clipboard.writeText(link);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2e3);
+    } catch {
+      window.open(link, "_blank", "noopener,noreferrer");
+    }
+  };
+  const canApprove = generationMode === "template" && reviewStatus === "pending_review" && Boolean(job_id);
+  const canRegenerate = generationMode === "template" && reviewStatus === "pending_review" && Boolean(job_id);
+  const canShare = Boolean(hasHTML || job_id) && (generationMode !== "template" || reviewStatus !== "pending_review");
+  const handleApprove = async () => {
+    if (!job_id || approving) return;
+    const endpoint = approveUrl || `/api/reports/${job_id}/approve`;
+    setApproving(true);
+    setApproveError(null);
+    try {
+      const headers = { "Content-Type": "application/json" };
+      if (authToken) headers.Authorization = `Bearer ${authToken}`;
+      const res = await fetch(endpoint, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ label: title })
+      });
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.detail || err.error || `Approve failed (${res.status})`);
+      }
+      const data = await res.json();
+      const newStatus = data.review_status || "approved";
+      setReviewStatus(newStatus);
+      if (data.template_version_id) setTemplateVersionId(data.template_version_id);
+      if (data.template_id) setTemplateId(data.template_id);
+      if (onCompleteRef.current) {
+        onCompleteRef.current({
+          title,
+          depth,
+          section_count: sectionCount,
+          source_count: sourceCount,
+          word_count: wordCount,
+          executive_summary: summary,
+          html_url: htmlUrl,
+          generation_mode: generationMode,
+          template_id: data.template_id || templateId,
+          template_version_id: data.template_version_id || templateVersionId,
+          review_status: newStatus,
+          theme
+        });
+      }
+    } catch (e) {
+      setApproveError(e instanceof Error ? e.message : "Could not save report version");
+    } finally {
+      setApproving(false);
+    }
+  };
+  const handleRegenerate = async () => {
+    if (!job_id || regenerating) return;
+    const endpoint = regenerateUrl || `/api/reports/${job_id}/regenerate`;
+    setRegenerating(true);
+    setApproveError(null);
+    try {
+      const headers = { "Content-Type": "application/json" };
+      if (authToken) headers.Authorization = `Bearer ${authToken}`;
+      const res = await fetch(endpoint, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({})
+      });
+      if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err.detail || err.error || `Regenerate failed (${res.status})`);
+      }
+      const data = await res.json();
+      const out = data.output || data;
+      if (out.html_url) setHtmlUrl(out.html_url);
+      if (data.template_id || out.template_id) setTemplateId(data.template_id || out.template_id);
+      setReviewStatus("pending_review");
+      setTemplateVersionId("");
+      if (out.section_count !== void 0) setSectionCount(out.section_count);
+      if (out.title) setTitle(out.title);
+      if (onCompleteRef.current) {
+        onCompleteRef.current({
+          title: out.title || title,
+          depth,
+          section_count: out.section_count ?? sectionCount,
+          source_count: sourceCount,
+          word_count: wordCount,
+          executive_summary: summary,
+          html_url: out.html_url || htmlUrl,
+          generation_mode: "template",
+          template_id: data.template_id || out.template_id || templateId,
+          template_version_id: void 0,
+          review_status: "pending_review",
+          theme
+        });
+      }
+    } catch (e) {
+      setApproveError(e instanceof Error ? e.message : "Could not switch template");
+    } finally {
+      setRegenerating(false);
+    }
+  };
+  const templateLabel = formatTemplateLabel(templateId);
+  const isApproved = reviewStatus === "approved";
   return /* @__PURE__ */ jsxs109(Fragment6, { children: [
     /* @__PURE__ */ jsx148("div", { className: cn("w-full", className), children: /* @__PURE__ */ jsxs109("div", { className: "bg-zinc-900 border border-zinc-800 rounded-2xl overflow-hidden", children: [
       /* @__PURE__ */ jsx148(
@@ -39921,10 +40083,53 @@ var ResearchReportJobCard = (props) => {
               depth && sectionCount > 0 && " \xB7 ",
               sectionCount > 0 && `${sectionCount} sections`,
               sourceCount > 0 && ` \xB7 ${sourceCount} sources`,
-              wordCount > 0 && ` \xB7 ${formatWordCount(wordCount)} words`
-            ] })
+              wordCount > 0 && ` \xB7 ${formatWordCount(wordCount)} words`,
+              templateLabel && ` \xB7 ${templateLabel}`
+            ] }),
+            generationMode === "template" && /* @__PURE__ */ jsx148("p", { className: "text-xs mt-1", children: isApproved ? /* @__PURE__ */ jsx148("span", { className: "text-emerald-400/90", children: "Approved \u2014 future reports use this format" }) : reviewStatus === "pending_review" ? /* @__PURE__ */ jsx148("span", { className: "text-amber-400/90", children: "Review this report, then approve to lock the layout" }) : null })
           ] }),
-          /* @__PURE__ */ jsxs109("div", { className: "flex items-center gap-1.5 flex-shrink-0", children: [
+          /* @__PURE__ */ jsxs109("div", { className: "flex items-center gap-1.5 flex-shrink-0 flex-wrap justify-end", children: [
+            canRegenerate && /* @__PURE__ */ jsxs109(
+              "button",
+              {
+                onClick: handleRegenerate,
+                disabled: regenerating || approving,
+                title: "Try another report template with the same data",
+                className: "flex items-center gap-1.5 px-2.5 h-7 rounded-lg border border-zinc-700 bg-zinc-800 hover:border-zinc-500 text-zinc-300 text-xs font-medium transition-colors disabled:opacity-50",
+                children: [
+                  /* @__PURE__ */ jsx148(RefreshIcon, {}),
+                  /* @__PURE__ */ jsx148("span", { children: regenerating ? "Switching..." : "Regenerate" })
+                ]
+              }
+            ),
+            canApprove && /* @__PURE__ */ jsxs109(
+              "button",
+              {
+                onClick: handleApprove,
+                disabled: approving,
+                title: "Approve and save this report format for future runs",
+                className: "flex items-center gap-1.5 px-2.5 h-7 rounded-lg border border-emerald-700/50 bg-emerald-950/40 hover:border-emerald-500 text-emerald-300 text-xs font-medium transition-colors disabled:opacity-50",
+                children: [
+                  /* @__PURE__ */ jsx148(CheckIcon2, {}),
+                  /* @__PURE__ */ jsx148("span", { children: approving ? "Saving..." : "Approve" })
+                ]
+              }
+            ),
+            isApproved && /* @__PURE__ */ jsx148("span", { className: "flex items-center justify-center w-7 h-7 rounded-lg border border-emerald-500/40 bg-emerald-500/10 text-emerald-400", title: "Format saved", children: /* @__PURE__ */ jsx148(CheckIcon2, {}) }),
+            /* @__PURE__ */ jsx148(
+              "button",
+              {
+                onClick: handleShare,
+                disabled: !canShare,
+                title: !canShare && reviewStatus === "pending_review" ? "Approve the report to enable sharing" : copied ? "Copied!" : "Copy shareable link",
+                className: cn(
+                  "w-7 h-7 rounded-lg border flex items-center justify-center transition-all",
+                  copied ? "border-green-500/40 bg-green-500/10 text-green-400" : "border-zinc-700 bg-zinc-800 text-zinc-400 hover:border-zinc-500 hover:text-zinc-200",
+                  "disabled:opacity-30 disabled:cursor-not-allowed"
+                ),
+                children: copied ? /* @__PURE__ */ jsx148(CheckIcon2, {}) : /* @__PURE__ */ jsx148(ShareIcon2, {})
+              }
+            ),
             /* @__PURE__ */ jsxs109(
               "button",
               {
@@ -39955,6 +40160,7 @@ var ResearchReportJobCard = (props) => {
             )
           ] })
         ] }),
+        approveError && /* @__PURE__ */ jsx148("p", { className: "mt-3 text-xs text-red-400/90", children: approveError }),
         hasHTML && !compact && /* @__PURE__ */ jsx148("div", { className: "mt-4", children: /* @__PURE__ */ jsxs109(
           "div",
           {
@@ -43428,7 +43634,7 @@ function PlatformMetricsBanner({
   return /* @__PURE__ */ jsxs132(
     "div",
     {
-      className: "\n        grid grid-cols-1 gap-3 rounded-xl py-4 px-4 shadow-sm\n        md:flex md:overflow-x-auto md:gap-6 md:rounded-l-xl md:py-4 md:px-4 md:items-center md:gap-0 md:px-0 md:ml-8\n      ",
+      className: "\r\n        grid grid-cols-1 gap-3 rounded-xl py-4 px-4 shadow-sm\r\n        md:flex md:overflow-x-auto md:gap-6 md:rounded-l-xl md:py-4 md:px-4 md:items-center md:gap-0 md:px-0 md:ml-8\r\n      ",
       style: { backgroundColor: bgColor },
       children: [
         /* @__PURE__ */ jsxs132("div", { className: "flex flex-col items-center md:min-w-0", children: [