@elevasis/ui 2.73.0 → 2.75.0

package/dist/features/content/index.d.ts

@@ -200,10 +200,25 @@ interface SidebarGroupNode {
 }
 type SidebarNode = SidebarSurfaceNode | SidebarGroupNode;
 
-/** D5: who/what executes a content pipeline step. */
+/**
+ * D5: who/what executes a content pipeline step.
+ *
+ * `'human'` was added on 2026-08-21, when the workspace shell started rendering its
+ * stepper from `steps[]`. Before that a step meant "a pass that writes a
+ * `content_item_attempts` row", so the stages a person walks -- picking files,
+ * framing them, sending the post -- were declared nowhere and lived as integer
+ * constants in one tenant's page. A catalog that describes only the automated half
+ * of a pipeline cannot be the thing a workspace renders, so the vocabulary widened
+ * to cover the whole sequence rather than the shell inventing a second one.
+ *
+ * A `'human'` step writes no attempt. That is expected, not a gap: `reviewMode`
+ * still says whether a decision gates it, and the surfaces that group by
+ * `stepKey` simply find no rows against it.
+ */
 declare const ContentPipelineStepActorSchema: z.ZodEnum<{
     agent: "agent";
     workflow: "workflow";
+    human: "human";
     vendor: "vendor";
 }>;
 type ContentPipelineStepActor = z.infer<typeof ContentPipelineStepActorSchema>;
@@ -1416,9 +1431,50 @@ declare const ContentSourceAssetResponseSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, z.core.$strip>;
+declare const ContentDistributionResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    organizationId: z.ZodString;
+    contentItemId: z.ZodString;
+    platform: z.ZodString;
+    format: z.ZodString;
+    status: z.ZodString;
+    adaptedBody: z.ZodNullable<z.ZodString>;
+    platformContent: z.ZodNullable<z.ZodUnknown>;
+    checklist: z.ZodNullable<z.ZodUnknown>;
+    mediaUrls: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"storage">;
+        bucket: z.ZodString;
+        path: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+    }, z.core.$strict>], "kind">>;
+    processingState: z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodEnum<{
+            error: "error";
+            success: "success";
+            running: "running";
+            no_result: "no_result";
+            skipped: "skipped";
+        }>;
+        attemptId: z.ZodString;
+        executionId: z.ZodNullable<z.ZodString>;
+        attemptedAt: z.ZodString;
+        data: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$loose>>;
+    publishMethod: z.ZodNullable<z.ZodString>;
+    publishedAt: z.ZodNullable<z.ZodString>;
+    platformPostId: z.ZodNullable<z.ZodString>;
+    platformUrl: z.ZodNullable<z.ZodString>;
+    metrics: z.ZodUnknown;
+    metricsUpdatedAt: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
 type ContentAssetCrop = z.infer<typeof ContentAssetCropSchema>;
 type ContentItemResponse = z.infer<typeof ContentItemResponseSchema>;
 type ContentSourceAssetResponse = z.infer<typeof ContentSourceAssetResponseSchema>;
+type ContentDistributionResponse = z.infer<typeof ContentDistributionResponseSchema>;
 
 /**
  * `deriveContentBoard` -- a pure function of `(items, pipeline, now)`. No React, no
@@ -2438,7 +2494,7 @@ interface ContentSidebarProps {
 declare const ContentSidebar: ({ workspaceItems, createItems, children }?: ContentSidebarProps) => react_jsx_runtime.JSX.Element;
 
 /**
- * Static two-entry default, built from {@link DEFAULT_CONTENT_VOCABULARY}. Exists for
+ * Static three-entry default, built from {@link DEFAULT_CONTENT_VOCABULARY}. Exists for
  * consumers that spread it at module load time (see `extend-content.md`), where a
  * tenant's declared vocabulary isn't available. `ContentSidebarMiddle` itself renders
  * the live, vocabulary-aware version instead of this constant.
@@ -2463,7 +2519,7 @@ interface ContentSidebarMiddleProps {
      * that section now holds review too.
      */
     createItems?: NavItem[];
-    /** Override the pipeline nav items. Defaults to the two-entry nav built from the tenant's declared vocabulary. */
+    /** Override the pipeline nav items. Defaults to the three-entry nav built from the tenant's declared vocabulary. */
     items?: NavItem[];
 }
 /**
@@ -2511,5 +2567,170 @@ interface MyReviewQueuePanelProps {
  */
 declare function MyReviewQueuePanel({ onItemClick, onSeeAll, showSectionLabel }: MyReviewQueuePanelProps): react_jsx_runtime.JSX.Element;
 
-export { AlternatesPanel, AssetCropEditor, CAPTION_STEP_KEY, CAPTION_WORKFLOW_ID, CONTENT_DERIVATIVES_BUCKET, CONTENT_ITEMS, CROP_ASPECT_OPTIONS, CaptionPanel, ContentDistributionDetailPage, ContentDistributionsPage, ContentItemReviewPage, ContentItemsPage, ContentOverviewPage, ContentPipelineBoardPage, ContentPipelineBoardPage as ContentPipelineWorkspacePage, ContentPipelinesPage, ContentReviewCard, ContentSidebar, ContentSidebarMiddle, DEFAULT_CONTENT_VOCABULARY, DERIVATIVE_JPEG_QUALITY, DERIVATIVE_MAX_WIDTH, IMAGE_ANALYSIS_WORKFLOW_ID, MyReviewQueuePanel, PayloadBody, PostPreview, ProcessingStateStrip, ReviewActionBar, SelectedAssetStrip, SlideAnalysisPanel, SourceAssetsPanel, contentManifest, cropStyle, derivativeObjectKey, deriveContentBoard, firstLine, formatElapsed, getContentItemIdentity, isDerivativeStale, lastLine, readStoredAnalysis, renderCropToJpeg, resolveContentStepResource, resolveContentVocabulary, swapFirstLine, swapLastLine, useContentConfig };
-export type { AlternatesPanelProps, AssetCropEditorProps, CaptionPanelProps, ContentAlternateOption, ContentBoard, ContentBoardCard, ContentBoardColumn, ContentBoardGate, ContentConfig, ContentDistributionDetailPageSlots, ContentDistributionsPageSlots, ContentFidelityCheck, ContentItemReviewPageSlots, ContentItemsPageSlots, ContentNoun, ContentOverviewPageSlots, ContentPayloadField, ContentPipelineBoardPageSlots, ContentPipelineBoardPageSlots as ContentPipelineWorkspacePageSlots, ContentPipelinesPageSlots, ContentProcessingStatus, ContentProcessingStep, ContentReviewAction, ContentReviewCardProps, ContentSidebarMiddleProps, ContentSidebarProps, ContentStepResourceBinding, ContentVocabulary, CropAspectOption, MyReviewQueuePanelProps, PayloadBodyProps, PostPreviewProps, PostPreviewSlide, ProcessingStateStripProps, RenderCropOptions, ReviewActionBarProps, ReviewMode, SelectedAssetStripProps, SlideAnalysisPanelProps, SourceAssetsPanelProps, StoredSlideAnalysis };
+/**
+ * What every step panel is handed, and the only thing the workspace shell owns.
+ *
+ * The shell fixes four things and nothing else: it remembers the work in progress,
+ * it moves between steps, it draws the stepper from the tenant's own step list, and
+ * it renders the panel that tenant's map names for the active step. Step count, step
+ * order, labels, actors, review modes, statuses, platforms and every screen a step
+ * puts up come from the model and from the composing app.
+ *
+ * `TDraft` is whatever the composing app's panels share and the shell has no opinion
+ * about -- a cloud-storage selection, per-slide crops, a chosen platform. It is
+ * carried, never read.
+ */
+interface ContentWorkspaceState<TDraft> {
+    /** The pipeline being walked, resolved from the organization model. */
+    pipeline: ContentPipelineTemplate;
+    /** Its steps, in declared order. Never assume a length or a particular member. */
+    steps: ContentPipelineStepEntry[];
+    /** The step on screen. */
+    step: ContentPipelineStepEntry;
+    /** Its index within {@link steps}. */
+    stepIndex: number;
+    /**
+     * The item, once something has written one. `null` before that.
+     *
+     * Kept live rather than held as the create response: a caption promoted by a panel
+     * changes `body`, and a preview reading the create snapshot would show the old one.
+     */
+    item: ContentItemResponse | null;
+    /** Adopt a written item -- after creating one, or on resuming an existing one. */
+    setItem: (item: ContentItemResponse | null) => void;
+    /**
+     * The item's body as it stands: the unsaved draft when a panel has reported one,
+     * the saved body otherwise.
+     *
+     * This is shell state rather than tenant draft state because every pipeline that
+     * writes a body has an in-progress one, and more than one step reads it -- the step
+     * that writes it, the preview beside it, and the step that sends it out. Leaving it
+     * to each app is how the two disagree.
+     */
+    body: string;
+    /** The unsaved body, or `null` when no panel has reported one. */
+    bodyDraft: string | null;
+    setBodyDraft: (draft: string | null) => void;
+    /**
+     * The distribution row for this item, or `null`. First row only -- a second
+     * platform is a second distribution and nothing here creates one yet.
+     */
+    distribution: ContentDistributionResponse | null;
+    /** Re-read the distributions after a panel has written one. */
+    refetchDistributions: () => void;
+    /** Whatever the composing app's own panels share. */
+    draft: TDraft;
+    /** Merge a patch, or replace via an updater. */
+    setDraft: (update: Partial<TDraft> | ((current: TDraft) => TDraft)) => void;
+    /** Move to a step by key. Ignored when the key names no step in this pipeline. */
+    goToStep: (stepKey: string) => void;
+    goToNextStep: () => void;
+    goToPreviousStep: () => void;
+    /** Whether a step can be opened right now, per the composing app's own rule. */
+    canOpenStep: (step: ContentPipelineStepEntry) => boolean;
+    /**
+     * Install a guard the shell awaits before leaving the active step, or clear it
+     * with `null`.
+     *
+     * This exists because some steps have work that only makes sense to finish on the
+     * way out -- rendering a crop, flushing an edit -- and the panel is the only thing
+     * that knows what that work is. Install it from an effect and clear it on unmount.
+     */
+    registerLeaveGuard: (guard: ((to: ContentPipelineStepEntry) => Promise<void> | void) | null) => void;
+    /** Drop everything and return to the start. */
+    restart: () => void;
+}
+/** A component registered to render one step. */
+type ContentStepPanel<TDraft> = ComponentType<ContentWorkspaceState<TDraft>>;
+/**
+ * Which panel renders which step, keyed by step key.
+ *
+ * An explicit map rather than a convention on the step key: a tenant that renames a
+ * step would otherwise silently lose its panel with nothing on screen to say so,
+ * whereas a missing entry here is reported. It also takes any component, so a tenant
+ * can use published panels for some steps and its own for the rest.
+ */
+type ContentStepPanelMap<TDraft> = Record<string, ContentStepPanel<TDraft>>;
+/** What the opening screen can do, when the composing app renders one. */
+interface ContentWorkspaceStartControls {
+    /** Begin a new item at the first step. */
+    onStartNew: () => void;
+    /** Pick up an existing item. The shell adopts it and opens `resumeAtStepKey`. */
+    onResume: (item: ContentItemResponse, resumeAtStepKey?: string) => void;
+}
+interface ContentWorkspaceShellProps<TDraft> {
+    /**
+     * Which pipeline to walk. Defaults to the content System's own
+     * `config.defaultPipelineId` when omitted.
+     */
+    pipelineId?: string;
+    /** See {@link ContentStepPanelMap}. */
+    panels: ContentStepPanelMap<TDraft>;
+    /** The starting value of the app's own shared draft. Also what `restart` returns to. */
+    initialDraft: TDraft;
+    title: string;
+    caption?: string;
+    /** Rendered at the right of the page title -- a credential badge, a mode switch. */
+    headerRight?: ReactNode;
+    /**
+     * The opening screen, before any step is shown: a resume picker, a template
+     * chooser, or nothing. Omit it and the shell opens on the first step.
+     */
+    renderStart?: (controls: ContentWorkspaceStartControls) => ReactNode;
+    /**
+     * Rendered on every step whatever panel is active, between the stepper and the
+     * panel. For the banner naming the work in progress, and for cross-step effects
+     * that must outlive the panel that started them.
+     */
+    renderPersistent?: (state: ContentWorkspaceState<TDraft>) => ReactNode;
+    /**
+     * The column beside the active panel -- typically the thing being built. Return
+     * `null` for a step that wants the full width, and the shell drops the column
+     * rather than rendering an empty one.
+     */
+    renderAside?: (state: ContentWorkspaceState<TDraft>) => ReactNode;
+    /**
+     * Whether a step is openable. Defaults to "any step at or before the furthest one
+     * reached", which is what makes going back free and going forward deliberate.
+     */
+    canOpenStep?: (step: ContentPipelineStepEntry, state: ContentWorkspaceState<TDraft>) => boolean;
+    /** Test id on the page root, so a composing app's tests can find its own workspace. */
+    testId?: string;
+}
+
+/**
+ * The frame a tenant's content pipeline is walked in.
+ *
+ * **It draws the stepper from the model, not from itself.** One `Stepper.Step` per
+ * entry in `ContentPipelineTemplate.steps`, using that entry's own label and order,
+ * its description below the row once the step is active, and the panel the composing
+ * app registered for its key. A pipeline with
+ * three steps renders three; one with seven renders seven; one that puts the caption
+ * second renders it second. Nothing here knows what a crop or a carousel is.
+ *
+ * **It owns only what every step shares** -- the item, its unsaved body, the
+ * distribution row, and where in the sequence you are. Everything else is the
+ * composing app's, carried through `draft` untouched. The panels are stateless and
+ * take this object; the app decides what they are.
+ *
+ * The reason the frame owns that much rather than less: those are exactly the values
+ * more than one step reads, and the two live defects in the page this replaced were
+ * both cross-step state bugs. Pushing them into each app reproduces those bugs once
+ * per tenant.
+ */
+declare function ContentWorkspaceShell<TDraft>({ pipelineId, panels, initialDraft, title, caption, headerRight, renderStart, renderPersistent, renderAside, canOpenStep, testId }: ContentWorkspaceShellProps<TDraft>): react_jsx_runtime.JSX.Element;
+
+/**
+ * The analysis step, ready to register.
+ *
+ * `SlideAnalysisPanel` was already universal -- it takes an item id and nothing else
+ * -- so what was missing was only the shape the shell calls it with. That is all this
+ * is: the panel, plus the two moves either side of it.
+ *
+ * Registers under whatever key the tenant's own step catalog uses; nothing here reads
+ * a step key.
+ */
+declare function ContentAnalysisStepPanel<TDraft>(state: ContentWorkspaceState<TDraft>): react_jsx_runtime.JSX.Element;
+
+export { AlternatesPanel, AssetCropEditor, CAPTION_STEP_KEY, CAPTION_WORKFLOW_ID, CONTENT_DERIVATIVES_BUCKET, CONTENT_ITEMS, CROP_ASPECT_OPTIONS, CaptionPanel, ContentAnalysisStepPanel, ContentDistributionDetailPage, ContentDistributionsPage, ContentItemReviewPage, ContentItemsPage, ContentOverviewPage, ContentPipelineBoardPage, ContentPipelineBoardPage as ContentPipelineWorkspacePage, ContentPipelinesPage, ContentReviewCard, ContentSidebar, ContentSidebarMiddle, ContentWorkspaceShell, DEFAULT_CONTENT_VOCABULARY, DERIVATIVE_JPEG_QUALITY, DERIVATIVE_MAX_WIDTH, IMAGE_ANALYSIS_WORKFLOW_ID, MyReviewQueuePanel, PayloadBody, PostPreview, ProcessingStateStrip, ReviewActionBar, SelectedAssetStrip, SlideAnalysisPanel, SourceAssetsPanel, contentManifest, cropStyle, derivativeObjectKey, deriveContentBoard, firstLine, formatElapsed, getContentItemIdentity, isDerivativeStale, lastLine, readStoredAnalysis, renderCropToJpeg, resolveContentStepResource, resolveContentVocabulary, swapFirstLine, swapLastLine, useContentConfig };
+export type { AlternatesPanelProps, AssetCropEditorProps, CaptionPanelProps, ContentAlternateOption, ContentBoard, ContentBoardCard, ContentBoardColumn, ContentBoardGate, ContentConfig, ContentDistributionDetailPageSlots, ContentDistributionsPageSlots, ContentFidelityCheck, ContentItemReviewPageSlots, ContentItemsPageSlots, ContentNoun, ContentOverviewPageSlots, ContentPayloadField, ContentPipelineBoardPageSlots, ContentPipelineBoardPageSlots as ContentPipelineWorkspacePageSlots, ContentPipelinesPageSlots, ContentProcessingStatus, ContentProcessingStep, ContentReviewAction, ContentReviewCardProps, ContentSidebarMiddleProps, ContentSidebarProps, ContentStepPanel, ContentStepPanelMap, ContentStepResourceBinding, ContentVocabulary, ContentWorkspaceShellProps, ContentWorkspaceStartControls, ContentWorkspaceState, CropAspectOption, MyReviewQueuePanelProps, PayloadBodyProps, PostPreviewProps, PostPreviewSlide, ProcessingStateStripProps, RenderCropOptions, ReviewActionBarProps, ReviewMode, SelectedAssetStripProps, SlideAnalysisPanelProps, SourceAssetsPanelProps, StoredSlideAnalysis };

package/dist/features/content/index.js

@@ -1,18 +1,18 @@
+import { useCloudStorageTemporaryLinks, useStorageSignedUrls, storageObjectRefKey } from '../../chunk-5SLRGUC4.js';
 import { PageContainer } from '../../chunk-BZZCNLT6.js';
 import '../../chunk-TUMSNGTX.js';
 import { FilterBar } from '../../chunk-PDHTXPSF.js';
-import { CustomModal, useContentItemSourceAssetDetails, useContentSourceAssets, useAddContentItemSourceAsset, useRemoveContentItemSourceAsset, useReorderContentItemSourceAssets, useUpdateContentItemSourceAsset, useCloudStorageTemporaryLinks, useContentItemAttempts, useExecuteAsync, useUpdateContentItem, useExecution, contentKeys, useContentItems, useContentDistributions, useContentConfig, isAwaitingReview, SubshellContentContainer, PageTitleCaption, CenteredErrorState, EmptyState, StatCard, getContentItemIdentity, usePaginationState, resolveCurrentContentStep, useContentItem, useReviewContentItem, resolveReviewTarget, useContentDistribution, useStorageSignedUrls, storageObjectRefKey, useContentPipelineSummary, deriveContentBoard, resolveContentWorkspaceRoute, useExecutions } from '../../chunk-OCVSPAKM.js';
-export { CONTENT_ITEMS, ContentSidebar, ContentSidebarMiddle, DEFAULT_CONTENT_VOCABULARY, MyReviewQueuePanel, contentManifest, deriveContentBoard, getContentItemIdentity, resolveContentStepResource, resolveContentVocabulary, useContentConfig } from '../../chunk-OCVSPAKM.js';
+import { CustomModal, useContentItemSourceAssetDetails, useContentSourceAssets, useAddContentItemSourceAsset, useRemoveContentItemSourceAsset, useReorderContentItemSourceAssets, useUpdateContentItemSourceAsset, useContentItemAttempts, useExecuteAsync, useUpdateContentItem, useExecution, contentKeys, useContentItems, useContentDistributions, useContentConfig, isAwaitingReview, SubshellContentContainer, PageTitleCaption, CenteredErrorState, EmptyState, StatCard, getContentItemIdentity, usePaginationState, resolveCurrentContentStep, useContentItem, useReviewContentItem, resolveReviewTarget, useContentDistribution, useContentDistributionMetrics, useContentPipelineSummary, deriveContentBoard, resolveContentWorkspaceRoute, useExecutions } from '../../chunk-SB3IHM5Y.js';
+export { CONTENT_ITEMS, ContentSidebar, ContentSidebarMiddle, DEFAULT_CONTENT_VOCABULARY, MyReviewQueuePanel, contentManifest, deriveContentBoard, getContentItemIdentity, resolveContentStepResource, resolveContentVocabulary, useContentConfig } from '../../chunk-SB3IHM5Y.js';
 import '../../chunk-R6NMRXNO.js';
 import '../../chunk-RBGVNPA6.js';
-import '../../chunk-MKH2KOAO.js';
-import '../../chunk-NHNTX6ZL.js';
+import '../../chunk-ZG6YJUT4.js';
 import '../../chunk-L7BZZ4SI.js';
-import { showSuccessNotification } from '../../chunk-U2H3TIHD.js';
+import { showSuccessNotification } from '../../chunk-ICHDIVQO.js';
 import '../../chunk-MISHPEJX.js';
 import { CardHeader } from '../../chunk-62GVNH5U.js';
 import '../../chunk-P45GQ3ZW.js';
-import '../../chunk-M7WWRZ5Z.js';
+import '../../chunk-2GIJBHZT.js';
 import '../../chunk-3KMDHCAR.js';
 import '../../chunk-2IFYDILW.js';
 import '../../chunk-BLXJEIQS.js';
@@ -20,7 +20,7 @@ import '../../chunk-UD657ICS.js';
 import '../../chunk-DD3CCMCZ.js';
 import '../../chunk-RNP5R5I3.js';
 import '../../chunk-RT4KRGZT.js';
-import { formatTimeAgo, formatRelativeTime } from '../../chunk-IBCEAVB2.js';
+import { formatTimeAgo, formatRelativeTime } from '../../chunk-A2SB32YV.js';
 import '../../chunk-Y6I3IC45.js';
 import '../../chunk-6SSQGWK7.js';
 import '../../chunk-BI5VDO2K.js';
@@ -29,7 +29,7 @@ import '../../chunk-TVTSASST.js';
 import '../../chunk-BRJ3QZ4E.js';
 import '../../chunk-Q7DJKLEN.js';
 import '../../chunk-I2KLQ2HA.js';
-import { Stack, Group, Text, Badge, Button, Textarea, Box, Loader, Accordion, Tooltip, Card, Alert, List, Paper, SegmentedControl, Slider, Title, Table, TextInput, Select, Modal, ActionIcon, Center, SimpleGrid, Pagination, Tabs, Anchor, Divider, Progress, Image as Image$1, UnstyledButton, ScrollArea } from '@mantine/core';
+import { Stack, Group, Text, Badge, Button, Textarea, Box, Loader, Accordion, Tooltip, Card, Alert, List, Paper, SegmentedControl, Slider, Title, Table, TextInput, Select, Modal, ActionIcon, Center, SimpleGrid, Pagination, Tabs, Anchor, Divider, Progress, Image as Image$1, Stepper, Grid, UnstyledButton, ScrollArea } from '@mantine/core';
 import { IconAlertTriangle, IconShieldCheck, IconShieldX, IconPhoto, IconGripVertical, IconCrop, IconArrowUp, IconArrowDown, IconUnlink, IconLink, IconPhotoOff, IconChevronLeft, IconChevronRight, IconCheck, IconSparkles, IconEye, IconArticle, IconArrowRight, IconClock, IconSend, IconSearch, IconFileText, IconExternalLink, IconListDetails, IconAlertCircle, IconLayoutGrid, IconShare, IconPlayerPlay, IconCircleCheck, IconCircleDashed, IconMaximize, IconCopy, IconDownload, IconArrowLeft, IconArrowsExchange, IconX, IconChecklist, IconRoute, IconInfoCircle, IconClockHour4 } from '@tabler/icons-react';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { useState, useRef, useCallback, useMemo, useEffect, Fragment as Fragment$1 } from 'react';
@@ -961,10 +961,13 @@ function SourceAssetsPanel({ itemId }) {
                         size: "xs",
                         placeholder: "Describe this slide",
                         value: draft ?? storedAltText,
-                        onChange: (event) => setAltDrafts((drafts) => ({
-                          ...drafts,
-                          [membership.sourceAssetId]: event.currentTarget.value
-                        }))
+                        onChange: (event) => {
+                          const value = event.currentTarget.value;
+                          setAltDrafts((drafts) => ({
+                            ...drafts,
+                            [membership.sourceAssetId]: value
+                          }));
+                        }
                       }
                     ),
                     draft !== void 0 && draft !== storedAltText && /* @__PURE__ */ jsx(
@@ -2314,17 +2317,18 @@ function ContentPipelinesPage({ headerActions } = {}) {
   ] }) }) });
 }
 var ACTOR_LEAD = {
-  vendor: "An outside service",
-  workflow: "An automated workflow",
-  agent: "An AI agent"
+  vendor: "An outside service handles",
+  workflow: "An automated workflow handles",
+  agent: "An AI agent handles",
+  human: "You do"
 };
 var REVIEW_VENUE_TAIL = {
   workspace: "and you review it on your own screen, in the moment",
   queue: "then it waits for your review",
-  none: "and moves on without review"
+  none: "with no review after it"
 };
 function describeStep(step) {
-  return `${ACTOR_LEAD[step.actor]} handles "${step.label}," ${REVIEW_VENUE_TAIL[step.reviewVenue]}.`;
+  return `${ACTOR_LEAD[step.actor]} "${step.label}," ${REVIEW_VENUE_TAIL[step.reviewVenue]}.`;
 }
 function StepRow({ step, resourceId }) {
   return /* @__PURE__ */ jsxs(Group, { gap: "sm", align: "flex-start", wrap: "nowrap", children: [
@@ -2740,6 +2744,13 @@ var QUERY_LIMIT = 100;
 function formatDate(value) {
   return value ? new Date(value).toLocaleDateString("en-US", { month: "short", day: "numeric", year: "numeric" }) : "\u2014";
 }
+function summarizeMetrics2(metrics) {
+  if (!metrics || typeof metrics !== "object" || Array.isArray(metrics)) return "\u2014";
+  const entries = Object.entries(metrics);
+  if (entries.length === 0) return "\u2014";
+  const shown = entries.slice(0, 2).map(([key, value]) => `${key} ${String(value)}`).join(" \xB7 ");
+  return entries.length > 2 ? `${shown} +${entries.length - 2}` : shown;
+}
 function ContentDistributionsPage({ headerActions } = {}) {
   const navigate = useNavigate();
   const contentConfig = useContentConfig();
@@ -2835,7 +2846,10 @@ function ContentDistributionsPage({ headerActions } = {}) {
           /* @__PURE__ */ jsx(Table.Th, { children: "Platform" }),
           /* @__PURE__ */ jsx(Table.Th, { children: "Format" }),
           /* @__PURE__ */ jsx(Table.Th, { children: "Status" }),
-          /* @__PURE__ */ jsx(Table.Th, { children: "Publish Method" }),
+          /* @__PURE__ */ jsx(Table.Th, { style: { whiteSpace: "nowrap" }, children: "Publish Method" }),
+          /* @__PURE__ */ jsx(Table.Th, { style: { whiteSpace: "nowrap" }, children: "Platform post ID" }),
+          /* @__PURE__ */ jsx(Table.Th, { children: "Metrics" }),
+          /* @__PURE__ */ jsx(Table.Th, { style: { whiteSpace: "nowrap" }, children: "Metrics updated" }),
           /* @__PURE__ */ jsx(Table.Th, { children: "Published" }),
           /* @__PURE__ */ jsx(Table.Th, {})
         ] }) }),
@@ -2866,6 +2880,9 @@ function ContentDistributionsPage({ headerActions } = {}) {
                 /* @__PURE__ */ jsx(Table.Td, { children: /* @__PURE__ */ jsx(Text, { size: "sm", children: distribution.format }) }),
                 /* @__PURE__ */ jsx(Table.Td, { children: /* @__PURE__ */ jsx(Badge, { size: "sm", variant: "light", children: distribution.status }) }),
                 /* @__PURE__ */ jsx(Table.Td, { children: /* @__PURE__ */ jsx(Text, { size: "sm", c: "dimmed", children: distribution.publishMethod ?? "\u2014" }) }),
+                /* @__PURE__ */ jsx(Table.Td, { children: /* @__PURE__ */ jsx(Text, { size: "xs", ff: "monospace", c: "dimmed", children: distribution.platformPostId ?? "\u2014" }) }),
+                /* @__PURE__ */ jsx(Table.Td, { children: /* @__PURE__ */ jsx(Text, { size: "xs", c: "dimmed", children: summarizeMetrics2(distribution.metrics) }) }),
+                /* @__PURE__ */ jsx(Table.Td, { children: /* @__PURE__ */ jsx(Text, { size: "sm", c: "dimmed", children: formatDate(distribution.metricsUpdatedAt) }) }),
                 /* @__PURE__ */ jsx(Table.Td, { children: /* @__PURE__ */ jsx(Text, { size: "sm", c: "dimmed", children: formatDate(distribution.publishedAt) }) }),
                 /* @__PURE__ */ jsx(Table.Td, { children: distribution.platformUrl && /* @__PURE__ */ jsx(
                   Anchor,
@@ -2962,6 +2979,22 @@ function MetricsDisplay({ metrics }) {
     /* @__PURE__ */ jsx(Text, { size: "sm", children: String(value) })
   ] }, key)) });
 }
+var METRIC_HISTORY_COLUMNS = [
+  { key: "views", label: "Views" },
+  { key: "reach", label: "Reach" },
+  { key: "likes", label: "Likes" },
+  { key: "comments", label: "Comments" },
+  { key: "shares", label: "Shares" },
+  { key: "saves", label: "Saves" },
+  { key: "engagements", label: "Engagements" },
+  { key: "profile_visits", label: "Profile Visits" },
+  { key: "profile_activity", label: "Profile Activity" },
+  { key: "follows", label: "Follows" },
+  { key: "clicks", label: "Clicks" }
+];
+function formatMetricValue(value) {
+  return value === void 0 ? "\u2014" : value.toLocaleString();
+}
 function ContentDistributionDetailPage({
   distributionId,
   headerActions
@@ -2971,6 +3004,8 @@ function ContentDistributionDetailPage({
   const distributionQuery = useContentDistribution(distributionId);
   const dist = distributionQuery.data;
   const itemQuery = useContentItem(dist?.contentItemId);
+  const metricsHistoryQuery = useContentDistributionMetrics(distributionId);
+  const metricsHistory = metricsHistoryQuery.data?.data ?? [];
   const [mediaOpened, { open: openMedia, close: closeMedia }] = useDisclosure(false);
   const [previewUrl, setPreviewUrl] = useState(null);
   const mediaEntries = useMemo(() => dist?.mediaUrls ?? [], [dist]);
@@ -3125,6 +3160,23 @@ function ContentDistributionDetailPage({
         /* @__PURE__ */ jsx(Divider, {}),
         /* @__PURE__ */ jsx(MetricsDisplay, { metrics: dist.metrics })
       ] }) }),
+      /* @__PURE__ */ jsx(Card, { withBorder: true, children: /* @__PURE__ */ jsxs(Stack, { gap: "sm", children: [
+        /* @__PURE__ */ jsx(Title, { order: 3, children: "Metrics History" }),
+        /* @__PURE__ */ jsx(Divider, {}),
+        metricsHistoryQuery.isLoading ? /* @__PURE__ */ jsx(Center, { p: "md", children: /* @__PURE__ */ jsx(Loader, { size: "sm" }) }) : metricsHistoryQuery.isError ? /* @__PURE__ */ jsx(CenteredErrorState, { error: metricsHistoryQuery.error, title: "Failed to load metrics history" }) : metricsHistory.length === 0 ? /* @__PURE__ */ jsx(Text, { size: "sm", c: "dimmed", children: "No metrics readings captured yet." }) : /* @__PURE__ */ jsx(Table.ScrollContainer, { minWidth: 900, children: /* @__PURE__ */ jsxs(Table, { children: [
+          /* @__PURE__ */ jsx(Table.Thead, { children: /* @__PURE__ */ jsxs(Table.Tr, { children: [
+            /* @__PURE__ */ jsx(Table.Th, { children: "Captured" }),
+            /* @__PURE__ */ jsx(Table.Th, { children: "Source" }),
+            METRIC_HISTORY_COLUMNS.map((column) => /* @__PURE__ */ jsx(Table.Th, { children: column.label }, column.key))
+          ] }) }),
+          /* @__PURE__ */ jsx(Table.Tbody, { children: metricsHistory.map((reading) => /* @__PURE__ */ jsxs(Table.Tr, { children: [
+            /* @__PURE__ */ jsx(Table.Td, { children: /* @__PURE__ */ jsx(Text, { size: "sm", c: "dimmed", children: formatDateTime3(reading.capturedAt) }) }),
+            /* @__PURE__ */ jsx(Table.Td, { children: /* @__PURE__ */ jsx(Text, { size: "sm", children: reading.source }) }),
+            METRIC_HISTORY_COLUMNS.map((column) => /* @__PURE__ */ jsx(Table.Td, { children: /* @__PURE__ */ jsx(Text, { size: "sm", children: formatMetricValue(reading.metrics[column.key]) }) }, column.key))
+          ] }, reading.id)) })
+        ] }) }),
+        /* @__PURE__ */ jsx(Text, { size: "xs", c: "dimmed", children: "An em dash means this platform does not report that metric -- it is never the same as zero." })
+      ] }) }),
       checklist.length > 0 ? /* @__PURE__ */ jsx(Card, { withBorder: true, children: /* @__PURE__ */ jsxs(Stack, { gap: "sm", children: [
         /* @__PURE__ */ jsxs(Group, { justify: "space-between", children: [
           /* @__PURE__ */ jsx(Title, { order: 3, children: "Checklist" }),
@@ -3251,5 +3303,204 @@ function ContentDistributionDetailPage({
     /* @__PURE__ */ jsx(CustomModal, { opened: mediaOpened, onClose: closeMedia, size: "xl", children: previewUrl ? /* @__PURE__ */ jsx(Image$1, { src: previewUrl, alt: "Media preview", fit: "contain" }) : null })
   ] });
 }
+function ContentWorkspaceShell({
+  pipelineId,
+  panels,
+  initialDraft,
+  title,
+  caption,
+  headerRight,
+  renderStart,
+  renderPersistent,
+  renderAside,
+  canOpenStep,
+  testId
+}) {
+  const { pipelines, defaultPipelineId } = useContentConfig();
+  const resolvedPipelineId = pipelineId ?? defaultPipelineId;
+  const pipeline = useMemo(
+    () => pipelines.find((entry) => entry.id === resolvedPipelineId),
+    [pipelines, resolvedPipelineId]
+  );
+  const steps = useMemo(() => pipeline?.steps ?? [], [pipeline]);
+  const [isStarted, setIsStarted] = useState(renderStart === void 0);
+  const [activeStepKey, setActiveStepKey] = useState(null);
+  const [furthestIndex, setFurthestIndex] = useState(0);
+  const [adoptedItem, setAdoptedItem] = useState(null);
+  const [bodyDraft, setBodyDraft] = useState(null);
+  const [draft, setDraftState] = useState(initialDraft);
+  const leaveGuardRef = useRef(null);
+  const itemId = adoptedItem?.id;
+  const liveItem = useContentItem(itemId);
+  const distributions = useContentDistributions({ contentItemId: itemId });
+  const item = useMemo(() => {
+    const live = liveItem.data;
+    return live !== void 0 && live.id === itemId ? live : adoptedItem;
+  }, [liveItem.data, itemId, adoptedItem]);
+  const distribution = useMemo(() => {
+    if (itemId === void 0) return null;
+    return distributions.data?.data.find((row) => row.contentItemId === itemId) ?? null;
+  }, [distributions.data, itemId]);
+  const stepIndex = useMemo(() => {
+    const index = steps.findIndex((step2) => step2.key === activeStepKey);
+    return index === -1 ? 0 : index;
+  }, [steps, activeStepKey]);
+  const step = steps[stepIndex];
+  const setDraft = useCallback((update) => {
+    setDraftState(
+      (current) => typeof update === "function" ? update(current) : { ...current, ...update }
+    );
+  }, []);
+  const setItem = useCallback((next) => {
+    setAdoptedItem(next);
+    setBodyDraft(null);
+  }, []);
+  const refetchDistributionsQuery = distributions.refetch;
+  const refetchDistributions = useCallback(() => void refetchDistributionsQuery(), [refetchDistributionsQuery]);
+  const registerLeaveGuard = useCallback((guard) => {
+    leaveGuardRef.current = guard;
+  }, []);
+  const goToStep = useCallback(
+    (stepKey) => {
+      const nextIndex = steps.findIndex((entry) => entry.key === stepKey);
+      const next = steps[nextIndex];
+      if (next === void 0) return;
+      const guard = leaveGuardRef.current;
+      void (async () => {
+        if (guard !== null && nextIndex > stepIndex) await guard(next);
+        setActiveStepKey(next.key);
+        setFurthestIndex((current) => Math.max(current, nextIndex));
+      })();
+    },
+    [steps, stepIndex]
+  );
+  const goToNextStep = useCallback(() => {
+    const next = steps[stepIndex + 1];
+    if (next !== void 0) goToStep(next.key);
+  }, [steps, stepIndex, goToStep]);
+  const goToPreviousStep = useCallback(() => {
+    const previous = steps[stepIndex - 1];
+    if (previous !== void 0) goToStep(previous.key);
+  }, [steps, stepIndex, goToStep]);
+  const restart = useCallback(() => {
+    setAdoptedItem(null);
+    setBodyDraft(null);
+    setDraftState(initialDraft);
+    setActiveStepKey(null);
+    setFurthestIndex(0);
+    leaveGuardRef.current = null;
+    setIsStarted(renderStart === void 0);
+  }, [initialDraft, renderStart]);
+  const state = useMemo(() => {
+    if (pipeline === void 0 || step === void 0) return null;
+    const base = {
+      pipeline,
+      steps,
+      step,
+      stepIndex,
+      item,
+      setItem,
+      body: bodyDraft ?? item?.body ?? "",
+      bodyDraft,
+      setBodyDraft,
+      distribution,
+      refetchDistributions,
+      draft,
+      setDraft,
+      goToStep,
+      goToNextStep,
+      goToPreviousStep,
+      registerLeaveGuard,
+      restart
+    };
+    const resolved = {
+      ...base,
+      canOpenStep: (candidate) => canOpenStep === void 0 ? steps.indexOf(candidate) <= furthestIndex : canOpenStep(candidate, resolved)
+    };
+    return resolved;
+  }, [
+    pipeline,
+    steps,
+    step,
+    stepIndex,
+    item,
+    setItem,
+    bodyDraft,
+    distribution,
+    refetchDistributions,
+    draft,
+    setDraft,
+    goToStep,
+    goToNextStep,
+    goToPreviousStep,
+    registerLeaveGuard,
+    restart,
+    canOpenStep,
+    furthestIndex
+  ]);
+  const startControls = useMemo(
+    () => ({
+      onStartNew: () => setIsStarted(true),
+      onResume: (resumed, resumeAtStepKey) => {
+        setItem(resumed);
+        setDraftState(initialDraft);
+        setFurthestIndex(steps.length === 0 ? 0 : steps.length - 1);
+        setActiveStepKey(resumeAtStepKey ?? steps[0]?.key ?? null);
+        setIsStarted(true);
+      }
+    }),
+    [setItem, initialDraft, steps]
+  );
+  const body = (() => {
+    if (pipeline === void 0) {
+      return /* @__PURE__ */ jsx(Alert, { color: "yellow", icon: /* @__PURE__ */ jsx(IconAlertTriangle, { size: 16 }), children: resolvedPipelineId === void 0 ? "The deployed Organization Model declares no content pipelines, so there is nothing to walk through here." : `The deployed Organization Model does not declare a "${resolvedPipelineId}" pipeline.` });
+    }
+    if (steps.length === 0 || state === null || step === void 0) {
+      return /* @__PURE__ */ jsxs(Alert, { color: "yellow", icon: /* @__PURE__ */ jsx(IconAlertTriangle, { size: 16 }), children: [
+        "The ",
+        /* @__PURE__ */ jsx("strong", { children: pipeline.label }),
+        " pipeline declares no steps, so there is nothing to render."
+      ] });
+    }
+    const Panel = panels[step.key];
+    const panelNode = Panel === void 0 ? /* @__PURE__ */ jsxs(Alert, { color: "yellow", icon: /* @__PURE__ */ jsx(IconAlertTriangle, { size: 16 }), children: [
+      "No panel is registered for the ",
+      /* @__PURE__ */ jsx("strong", { children: step.label }),
+      " step (",
+      /* @__PURE__ */ jsx("code", { children: step.key }),
+      "). Add one to the workspace's panel map."
+    ] }) : /* @__PURE__ */ jsx(Panel, { ...state });
+    const aside = renderAside?.(state) ?? null;
+    return /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(Stepper, { active: stepIndex, onStepClick: (next) => goToStep(steps[next]?.key ?? step.key), size: "sm", children: steps.map((entry) => /* @__PURE__ */ jsx(Stepper.Step, { label: entry.label, allowStepSelect: state.canOpenStep(entry) }, entry.key)) }),
+      step.description === void 0 || step.description === "" ? null : /* @__PURE__ */ jsx(Text, { size: "sm", c: "dimmed", children: step.description }),
+      renderPersistent?.(state),
+      aside === null ? panelNode : /* @__PURE__ */ jsxs(Grid, { gutter: "md", align: "flex-start", children: [
+        /* @__PURE__ */ jsx(Grid.Col, { span: { base: 12, lg: 7 }, children: panelNode }),
+        /* @__PURE__ */ jsx(Grid.Col, { span: { base: 12, lg: 5 }, children: /* @__PURE__ */ jsx(Paper, { withBorder: true, p: "md", children: aside }) })
+      ] })
+    ] });
+  })();
+  return /* @__PURE__ */ jsx(SubshellContentContainer, { children: /* @__PURE__ */ jsx(PageContainer, { children: /* @__PURE__ */ jsxs(Stack, { "data-testid": testId, children: [
+    /* @__PURE__ */ jsx(PageTitleCaption, { title, caption, rightSection: headerRight }),
+    !isStarted && renderStart !== void 0 ? renderStart(startControls) : body
+  ] }) }) });
+}
+function ContentAnalysisStepPanel(state) {
+  const { item, stepIndex, steps, goToNextStep, goToPreviousStep } = state;
+  if (item === null) {
+    return /* @__PURE__ */ jsx(Alert, { color: "yellow", icon: /* @__PURE__ */ jsx(IconAlertTriangle, { size: 16 }), children: "Nothing has been created yet, so there is nothing to analyse. Go back and finish the earlier steps first." });
+  }
+  return /* @__PURE__ */ jsxs(Stack, { children: [
+    /* @__PURE__ */ jsx(SlideAnalysisPanel, { itemId: item.id }),
+    /* @__PURE__ */ jsxs(Group, { justify: "space-between", children: [
+      stepIndex > 0 ? /* @__PURE__ */ jsxs(Button, { variant: "default", leftSection: /* @__PURE__ */ jsx(IconArrowLeft, { size: 16 }), onClick: goToPreviousStep, children: [
+        "Back to ",
+        steps[stepIndex - 1]?.label
+      ] }) : /* @__PURE__ */ jsx("span", {}),
+      stepIndex < steps.length - 1 && /* @__PURE__ */ jsx(Button, { rightSection: /* @__PURE__ */ jsx(IconArrowRight, { size: 16 }), onClick: goToNextStep, children: steps[stepIndex + 1]?.label })
+    ] })
+  ] });
+}
 
-export { AlternatesPanel, AssetCropEditor, CAPTION_STEP_KEY, CAPTION_WORKFLOW_ID, CONTENT_DERIVATIVES_BUCKET, CROP_ASPECT_OPTIONS, CaptionPanel, ContentDistributionDetailPage, ContentDistributionsPage, ContentItemReviewPage, ContentItemsPage, ContentOverviewPage, ContentPipelineBoardPage, ContentPipelineBoardPage as ContentPipelineWorkspacePage, ContentPipelinesPage, ContentReviewCard, DERIVATIVE_JPEG_QUALITY, DERIVATIVE_MAX_WIDTH, IMAGE_ANALYSIS_WORKFLOW_ID, PayloadBody, PostPreview, ProcessingStateStrip, ReviewActionBar, SelectedAssetStrip, SlideAnalysisPanel, SourceAssetsPanel, cropStyle, derivativeObjectKey, firstLine, formatElapsed, isDerivativeStale, lastLine, readStoredAnalysis, renderCropToJpeg, swapFirstLine, swapLastLine };
+export { AlternatesPanel, AssetCropEditor, CAPTION_STEP_KEY, CAPTION_WORKFLOW_ID, CONTENT_DERIVATIVES_BUCKET, CROP_ASPECT_OPTIONS, CaptionPanel, ContentAnalysisStepPanel, ContentDistributionDetailPage, ContentDistributionsPage, ContentItemReviewPage, ContentItemsPage, ContentOverviewPage, ContentPipelineBoardPage, ContentPipelineBoardPage as ContentPipelineWorkspacePage, ContentPipelinesPage, ContentReviewCard, ContentWorkspaceShell, DERIVATIVE_JPEG_QUALITY, DERIVATIVE_MAX_WIDTH, IMAGE_ANALYSIS_WORKFLOW_ID, PayloadBody, PostPreview, ProcessingStateStrip, ReviewActionBar, SelectedAssetStrip, SlideAnalysisPanel, SourceAssetsPanel, cropStyle, derivativeObjectKey, firstLine, formatElapsed, isDerivativeStale, lastLine, readStoredAnalysis, renderCropToJpeg, swapFirstLine, swapLastLine };