pxengine 0.1.113 → 0.1.115

package/dist/index.d.cts

@@ -3551,6 +3551,19 @@ interface PresentationJobOutput {
     slide_count: number;
     formats: PresentationFormats;
 }
+/** One planned slide in a deck outline (content only, no styling). */
+interface DeckOutlineSlide {
+    n?: number;
+    type?: string;
+    message?: string;
+    [key: string]: unknown;
+}
+/** The planned deck outline (deck_plan) shown for approval before rendering. */
+interface DeckOutline {
+    title?: string;
+    slides?: DeckOutlineSlide[];
+    [key: string]: unknown;
+}
 /**
  * Real-time progress information for long-running jobs.
  * Updated during AI generation, PDF/PPTX creation, and upload phases.
@@ -3578,6 +3591,19 @@ interface PresentationJobCardProps {
     status: "pending" | "running" | "complete" | "failed";
     slide_count?: number;
     formats?: PresentationFormats;
+    /** How the deck was generated: template (default) or legacy. */
+    generation_mode?: "template" | "legacy" | string;
+    /** Design template id used to render the deck. */
+    template_id?: string;
+    /** Saved version id after the deck is approved as the standard format. */
+    template_version_id?: string;
+    /** User review state for template-based decks. */
+    review_status?: "pending_outline_approval" | "pending_review" | "approved" | "auto" | string;
+    /**
+     * The planned deck outline (deck_plan) shown for approval BEFORE the deck is
+     * rendered. Present while `review_status === "pending_outline_approval"`.
+     */
+    outline?: DeckOutline;
     error?: string;
     /** Real-time progress information (populated during pending/running) */
     progress?: JobProgress$2;
@@ -3597,6 +3623,23 @@ interface PresentationJobCardProps {
      * Falls back to `${origin}/p/{job_id}`, then formats.html_url.
      */
     shareUrl?: string;
+    /**
+     * Approve-standard endpoint (POST). Defaults to
+     * `/api/presentations/{job_id}/approve-standard`. Locks this deck's format.
+     */
+    approveUrl?: string;
+    /**
+     * Approve-outline endpoint (POST). Defaults to
+     * `/api/presentations/{job_id}/approve-outline`. Proceeds to render the deck.
+     */
+    approveOutlineUrl?: string;
+    /** Regenerate endpoint (POST). Defaults to `/api/presentations/{job_id}/regenerate`. */
+    regenerateUrl?: string;
+    /**
+     * Hide the FINISHED-phase approve/regenerate buttons (the outline-approval
+     * phase is unaffected). Used when a host wrapper owns those actions.
+     */
+    hideApproval?: boolean;
     className?: string;
     /** Organization brand theme — when provided, the card adopts its colors. */
     theme?: WidgetTheme;
@@ -3623,6 +3666,21 @@ interface ReportTheme {
     secondary?: string;
     accent?: string;
 }
+/** One planned section in a report outline (content only, no styling). */
+interface ReportOutlineSection {
+    heading?: string;
+    body?: string;
+    takeaway?: string;
+    [key: string]: unknown;
+}
+/** The planned report outline (report_data) shown for approval. */
+interface ReportOutline {
+    title?: string;
+    subtitle?: string;
+    executive_summary?: string;
+    sections?: ReportOutlineSection[];
+    [key: string]: unknown;
+}
 /**
  * Real-time progress information for long-running research jobs.
  * Updated during web search, content generation, and upload phases.
@@ -3667,6 +3725,8 @@ interface ResearchReportJobCardProps {
     key_findings?: string[];
     /** HTML report URL */
     html_url?: string;
+    /** PDF export URL (paginated print export; may be absent if PDF rendering failed) */
+    pdf_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 */
@@ -3674,7 +3734,12 @@ interface ResearchReportJobCardProps {
     /** Saved version id after user approval */
     template_version_id?: string;
     /** User review state for template-based reports */
-    review_status?: "pending_review" | "approved" | "auto" | string;
+    review_status?: "pending_outline_approval" | "pending_review" | "approved" | "auto" | string;
+    /**
+     * The planned outline (report_data) shown for approval BEFORE the report is
+     * rendered. Present while `review_status === "pending_outline_approval"`.
+     */
+    outline?: ReportOutline;
     /** Dynamic theme colors generated based on topic */
     theme?: ReportTheme;
     /** Error message if job failed */
@@ -3694,8 +3759,20 @@ interface ResearchReportJobCardProps {
      * Approve endpoint (POST). Defaults to `/api/reports/{job_id}/approve`.
      */
     approveUrl?: string;
+    /**
+     * Approve-outline endpoint (POST). Defaults to
+     * `/api/reports/{job_id}/approve-outline`. Called from the outline-review
+     * phase to proceed to rendering the full report.
+     */
+    approveOutlineUrl?: string;
     /** Regenerate endpoint (POST). Defaults to `/api/reports/{job_id}/regenerate`. */
     regenerateUrl?: string;
+    /**
+     * Hide the FINISHED-phase approve/regenerate buttons (the outline-approval
+     * phase is unaffected). Used when a host wrapper owns those actions in its own
+     * action bar, so the card doesn't render duplicates.
+     */
+    hideApproval?: boolean;
     /** Additional CSS classes */
     className?: string;
     /** Callback when job completes */
@@ -3720,6 +3797,7 @@ interface ResearchReportJobOutput {
     key_findings?: string[];
     theme?: ReportTheme;
     html_url?: string;
+    pdf_url?: string;
     generation_mode?: string;
     template_id?: string;
     template_version_id?: string;

package/dist/index.d.ts

@@ -3551,6 +3551,19 @@ interface PresentationJobOutput {
     slide_count: number;
     formats: PresentationFormats;
 }
+/** One planned slide in a deck outline (content only, no styling). */
+interface DeckOutlineSlide {
+    n?: number;
+    type?: string;
+    message?: string;
+    [key: string]: unknown;
+}
+/** The planned deck outline (deck_plan) shown for approval before rendering. */
+interface DeckOutline {
+    title?: string;
+    slides?: DeckOutlineSlide[];
+    [key: string]: unknown;
+}
 /**
  * Real-time progress information for long-running jobs.
  * Updated during AI generation, PDF/PPTX creation, and upload phases.
@@ -3578,6 +3591,19 @@ interface PresentationJobCardProps {
     status: "pending" | "running" | "complete" | "failed";
     slide_count?: number;
     formats?: PresentationFormats;
+    /** How the deck was generated: template (default) or legacy. */
+    generation_mode?: "template" | "legacy" | string;
+    /** Design template id used to render the deck. */
+    template_id?: string;
+    /** Saved version id after the deck is approved as the standard format. */
+    template_version_id?: string;
+    /** User review state for template-based decks. */
+    review_status?: "pending_outline_approval" | "pending_review" | "approved" | "auto" | string;
+    /**
+     * The planned deck outline (deck_plan) shown for approval BEFORE the deck is
+     * rendered. Present while `review_status === "pending_outline_approval"`.
+     */
+    outline?: DeckOutline;
     error?: string;
     /** Real-time progress information (populated during pending/running) */
     progress?: JobProgress$2;
@@ -3597,6 +3623,23 @@ interface PresentationJobCardProps {
      * Falls back to `${origin}/p/{job_id}`, then formats.html_url.
      */
     shareUrl?: string;
+    /**
+     * Approve-standard endpoint (POST). Defaults to
+     * `/api/presentations/{job_id}/approve-standard`. Locks this deck's format.
+     */
+    approveUrl?: string;
+    /**
+     * Approve-outline endpoint (POST). Defaults to
+     * `/api/presentations/{job_id}/approve-outline`. Proceeds to render the deck.
+     */
+    approveOutlineUrl?: string;
+    /** Regenerate endpoint (POST). Defaults to `/api/presentations/{job_id}/regenerate`. */
+    regenerateUrl?: string;
+    /**
+     * Hide the FINISHED-phase approve/regenerate buttons (the outline-approval
+     * phase is unaffected). Used when a host wrapper owns those actions.
+     */
+    hideApproval?: boolean;
     className?: string;
     /** Organization brand theme — when provided, the card adopts its colors. */
     theme?: WidgetTheme;
@@ -3623,6 +3666,21 @@ interface ReportTheme {
     secondary?: string;
     accent?: string;
 }
+/** One planned section in a report outline (content only, no styling). */
+interface ReportOutlineSection {
+    heading?: string;
+    body?: string;
+    takeaway?: string;
+    [key: string]: unknown;
+}
+/** The planned report outline (report_data) shown for approval. */
+interface ReportOutline {
+    title?: string;
+    subtitle?: string;
+    executive_summary?: string;
+    sections?: ReportOutlineSection[];
+    [key: string]: unknown;
+}
 /**
  * Real-time progress information for long-running research jobs.
  * Updated during web search, content generation, and upload phases.
@@ -3667,6 +3725,8 @@ interface ResearchReportJobCardProps {
     key_findings?: string[];
     /** HTML report URL */
     html_url?: string;
+    /** PDF export URL (paginated print export; may be absent if PDF rendering failed) */
+    pdf_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 */
@@ -3674,7 +3734,12 @@ interface ResearchReportJobCardProps {
     /** Saved version id after user approval */
     template_version_id?: string;
     /** User review state for template-based reports */
-    review_status?: "pending_review" | "approved" | "auto" | string;
+    review_status?: "pending_outline_approval" | "pending_review" | "approved" | "auto" | string;
+    /**
+     * The planned outline (report_data) shown for approval BEFORE the report is
+     * rendered. Present while `review_status === "pending_outline_approval"`.
+     */
+    outline?: ReportOutline;
     /** Dynamic theme colors generated based on topic */
     theme?: ReportTheme;
     /** Error message if job failed */
@@ -3694,8 +3759,20 @@ interface ResearchReportJobCardProps {
      * Approve endpoint (POST). Defaults to `/api/reports/{job_id}/approve`.
      */
     approveUrl?: string;
+    /**
+     * Approve-outline endpoint (POST). Defaults to
+     * `/api/reports/{job_id}/approve-outline`. Called from the outline-review
+     * phase to proceed to rendering the full report.
+     */
+    approveOutlineUrl?: string;
     /** Regenerate endpoint (POST). Defaults to `/api/reports/{job_id}/regenerate`. */
     regenerateUrl?: string;
+    /**
+     * Hide the FINISHED-phase approve/regenerate buttons (the outline-approval
+     * phase is unaffected). Used when a host wrapper owns those actions in its own
+     * action bar, so the card doesn't render duplicates.
+     */
+    hideApproval?: boolean;
     /** Additional CSS classes */
     className?: string;
     /** Callback when job completes */
@@ -3720,6 +3797,7 @@ interface ResearchReportJobOutput {
     key_findings?: string[];
     theme?: ReportTheme;
     html_url?: string;
+    pdf_url?: string;
     generation_mode?: string;
     template_id?: string;
     template_version_id?: string;