react-semaphor 0.1.503 → 0.1.505

package/dist/types/components/ai/tool-output-errors.d.ts

@@ -0,0 +1,2 @@
+export declare function hasToolOutputError(output: unknown): boolean;
+export declare function isRetryableToolOutputError(output: unknown): boolean;

package/dist/types/components/ai/tool-part-renderer.d.ts

@@ -0,0 +1,32 @@
+import { ToolUIPart, UIMessage } from 'ai';
+import { AddToDashboardProps } from './dashboard-assistant.js';
+/**
+ * Single source of truth for "would this tool part actually paint anything
+ * inside an assistant Turn?" Used by:
+ *   - ToolPartRenderer itself, to decide what to render
+ *   - PrintMessages, to decide whether to render the surrounding Turn
+ *     (and its eyebrow) at all
+ *
+ * The two views MUST stay in lockstep, otherwise an empty Turn with a bare
+ * "ASSISTANT" eyebrow can stack on top of the live status line at the
+ * bottom of the conversation.
+ */
+export declare function wouldToolPartPaint(part: {
+    type?: string;
+    state?: string;
+    output?: unknown;
+}, showTools: boolean): boolean;
+interface ToolPartRendererProps {
+    part: ToolUIPart;
+    idx: string | number;
+    messageId?: string;
+    showTools: boolean;
+    onAddToDashboard?: (params: AddToDashboardProps) => void;
+    messages?: UIMessage[];
+}
+/**
+ * Component that handles rendering of tool parts based on their state
+ * Centralizes all tool rendering logic in one place
+ */
+export declare function ToolPartRenderer({ part, idx, messageId, showTools, onAddToDashboard, messages, }: ToolPartRendererProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/types/components/appearance/dashboard-appearance-adapter.d.ts

@@ -0,0 +1,17 @@
+import { CSSProperties } from 'react';
+import { CompiledAppearance } from '../../lib/appearance/types.js';
+type AppearanceStyle = CSSProperties & Record<`--${string}`, string>;
+export type ResolvedDashboardAppearance = {
+    hasDashboardAppearance: boolean;
+    hasCardAppearance: boolean;
+    dashboardContainerStyle: AppearanceStyle;
+    dashboardCanvasStyle: AppearanceStyle;
+    gridMargin?: [number, number];
+    gridContainerPadding?: [number, number];
+    gridStyle: AppearanceStyle;
+    cardFrameStyle: AppearanceStyle;
+    cardGutterStyle: CSSProperties;
+};
+export declare function useDashboardAppearance(): ResolvedDashboardAppearance;
+export declare function buildDashboardAppearance(compiledAppearance: CompiledAppearance): ResolvedDashboardAppearance;
+export {};

package/dist/types/components/appearance/surface-appearance-adapter.d.ts

@@ -0,0 +1,21 @@
+import { CSSProperties } from 'react';
+import { BaseSurfaceAppearance, CompiledAppearance, InteractiveSurfaceAppearance } from '../../lib/appearance/types.js';
+export type BaseAppearanceSurface = 'interactive' | 'pagination';
+type SurfaceStyle = CSSProperties & Record<`--${string}`, string>;
+export type ResolvedSurfaceAppearance = {
+    hasAppearance: boolean;
+    containerStyle: SurfaceStyle;
+    controlStyle: SurfaceStyle;
+    chipStyle: SurfaceStyle;
+    contentStyle: SurfaceStyle;
+    dialogStyle: SurfaceStyle;
+};
+export declare function useSurfaceAppearance(surface: BaseAppearanceSurface): ResolvedSurfaceAppearance;
+export declare function buildSurfaceAppearance(compiledAppearance: CompiledAppearance, surface: BaseAppearanceSurface): ResolvedSurfaceAppearance;
+export declare function buildBaseSurfaceAppearance(appearance: (BaseSurfaceAppearance & Partial<InteractiveSurfaceAppearance>) | undefined, options?: {
+    containerBackground?: string;
+    mutedBackground?: string;
+    selectedStateBackground?: string;
+    includeRadiusVariables?: boolean;
+}): ResolvedSurfaceAppearance;
+export {};

package/dist/types/components/briefings/attachments/briefing-attachment-list.d.ts

@@ -0,0 +1,9 @@
+import { BriefingAttachment } from '../../../lib/types/briefing-types.js';
+type Props = {
+    attachments: BriefingAttachment[];
+    onChange: (attachments: BriefingAttachment[]) => void;
+    onAdd: () => void;
+    disabled?: boolean;
+};
+export declare function BriefingAttachmentList({ attachments, onChange, onAdd, disabled, }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/briefings/attachments/briefing-attachment-selector.d.ts

@@ -0,0 +1,27 @@
+import { MatrixCatalogEnvironment } from '../../../lib/matrix-table/use-matrix-card-catalog.js';
+import { BriefingAttachment, BriefingSource } from '../../../lib/types/briefing-types.js';
+import { BriefingAttachmentRuntimeInput } from '../../../lib/briefings/briefing-attachment-model.js';
+import { TDashboard } from '../../../lib/types/common-types.js';
+type Props = {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    source: BriefingSource;
+    dashboard?: TDashboard | null;
+    selectedSheetId?: string | null;
+    runtime?: BriefingAttachmentRuntimeInput;
+    metadataEnvironment?: MatrixCatalogEnvironment;
+    selectedAttachments: BriefingAttachment[];
+    availableDashboards?: Array<{
+        id: string;
+        title: string;
+        dashboard?: TDashboard;
+    }>;
+    /**
+     * Called with the full list of attachments the user wants on the
+     * Briefing when they click Add. Replaces the current attachments.
+     * Cancel / outside-click discards changes and does not invoke this.
+     */
+    onSubmit: (attachments: BriefingAttachment[]) => void;
+};
+export declare function BriefingAttachmentSelector(props: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/briefings/attachments/briefing-attachment-settings-dialog.d.ts

@@ -0,0 +1,16 @@
+import { BriefingAttachment } from '../../../lib/types/briefing-types.js';
+type Props = {
+    attachment: BriefingAttachment;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onChange: (attachment: BriefingAttachment) => void;
+    children: React.ReactNode;
+};
+/**
+ * Per-attachment settings popover. Rendered inline as a child of the chip
+ * trigger so it anchors to the chip and doesn't dim the panel background
+ * (a Dialog would). Format selection lives at the top of the popover
+ * since it's the most-changed setting.
+ */
+export declare function BriefingAttachmentSettingsPopover({ attachment, open, onOpenChange, onChange, children, }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/briefings/briefing-author/attachment-section.d.ts

@@ -0,0 +1,20 @@
+import { BriefingFormPatch } from '../../../lib/briefings/briefing-form-model.js';
+import { BriefingAttachmentRuntimeInput } from '../../../lib/briefings/briefing-attachment-model.js';
+import { BriefingAttachment, BriefingSource } from '../../../lib/types/briefing-types.js';
+import { TDashboard } from '../../../lib/types/common-types.js';
+import { MatrixCatalogEnvironment } from '../../../lib/matrix-table/use-matrix-card-catalog.js';
+export declare function AttachmentSection({ attachments, source, dashboard, selectedSheetId, runtime, metadataEnvironment, availableDashboards, disabled, onChange, }: {
+    attachments: BriefingAttachment[];
+    source: BriefingSource;
+    dashboard?: TDashboard;
+    selectedSheetId?: string | null;
+    runtime: BriefingAttachmentRuntimeInput;
+    metadataEnvironment?: MatrixCatalogEnvironment;
+    availableDashboards?: Array<{
+        id: string;
+        title: string;
+        dashboard?: TDashboard;
+    }>;
+    disabled: boolean;
+    onChange: (patch: BriefingFormPatch) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/briefings/briefing-author/author-actions.d.ts

@@ -0,0 +1,25 @@
+type AuthorAction = 'save' | 'plan' | 'run' | 'preview' | 'pause' | 'resume' | string | null;
+export declare function AuthorActions({ existing, activeView, scheduledReport, scheduleEnabled, customMessage, contentNoun, analyticalBriefingsEnabled, analysisUnavailable, canToggleScheduleStatus, paused, busy, draftDirty, hasActiveRun, pendingAction, canDiscard, onStatusChange, onEdit, onDiscard, onPlan, onRun, onSave, }: {
+    existing: boolean;
+    activeView: 'edit' | 'plan' | 'result';
+    scheduledReport: boolean;
+    scheduleEnabled: boolean;
+    customMessage: boolean;
+    contentNoun: 'report' | 'briefing';
+    analyticalBriefingsEnabled: boolean;
+    analysisUnavailable: boolean;
+    canToggleScheduleStatus: boolean;
+    paused: boolean;
+    busy: boolean;
+    draftDirty: boolean;
+    hasActiveRun: boolean;
+    pendingAction: AuthorAction;
+    canDiscard: boolean;
+    onStatusChange: (status: 'ACTIVE' | 'PAUSED') => void;
+    onEdit: () => void;
+    onDiscard: () => void;
+    onPlan: () => void;
+    onRun: () => void;
+    onSave: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/briefings/briefing-author/content-composers.d.ts

@@ -0,0 +1,9 @@
+import { BriefingFormDraft, BriefingFormPatch } from '../../../lib/briefings/briefing-form-model.js';
+type ComposerProps = {
+    draft: BriefingFormDraft;
+    onChange: (patch: BriefingFormPatch) => void;
+    onExpand: () => void;
+};
+export declare function EmailReportComposer({ draft, onChange, onExpand, }: ComposerProps): import("react/jsx-runtime").JSX.Element;
+export declare function AnalyticalBriefingComposer({ draft, onChange, onExpand, }: ComposerProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/briefings/briefing-author/defaults.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_ANALYTICAL_BRIEFING_INSTRUCTION = "Tell me what changed in the business and what is driving it.\n\nWatch:\n- Top-line movement versus the previous comparable period\n- KPI changes using the measures available in this dashboard or project\n- Largest positive and negative drivers using available breakdown fields\n- Notable changes by any available segment, product, customer, region, account, channel, location, or movement type\n- Important outliers, missing context, or data gaps that affect the read\n\nInclude in the briefing:\n- Executive summary in plain English\n- KPI comparison with current, previous, delta, and percent change when available\n- Driver table or chart when useful\n- 2-3 recommended next actions\n- Evidence link rather than raw SQL in the main body";

package/dist/types/components/briefings/briefing-author/delivery-section.d.ts

@@ -0,0 +1,56 @@
+import { BriefingFormDraft, BriefingFormPatch } from '../../../lib/briefings/briefing-form-model.js';
+import { BriefingDeliveryChannel, BriefingRecipient } from '../../../lib/types/briefing-types.js';
+export type DeliveryMode = Extract<BriefingDeliveryChannel, 'EMAIL' | 'SLACK'>;
+export type SlackIntegrationStatus = {
+    installed: boolean;
+    status: string;
+    channelDeliveryAvailable?: boolean;
+    capabilities?: {
+        canConfigure?: boolean;
+    };
+    workspace?: {
+        teamName?: string;
+        botUserId?: string;
+        appId?: string;
+        installedScopes?: string[];
+    } | null;
+};
+export type SlackPostableChannel = {
+    id: string;
+    name: string;
+    isPrivate: boolean;
+    isMember: boolean;
+    memberCount?: number;
+};
+export type SlackChannelsResponse = {
+    channels: SlackPostableChannel[];
+};
+export type SlackMentionStatus = {
+    linkedCount: number;
+    unlinkedCount: number;
+    resolvedCount: number;
+};
+export declare function DeliverySection({ draft, effectiveChannels, reportAuthoring, slackAllowed, deliveryMode, secondaryDeliveryMode, hasMultiChannelDelivery, slackStatus, slackLoading, slackChannels, selectedSlackChannelId, selectedSlackChannel, threadMentions, slackMentionStatus, slackError, apiServiceUrl, onChange, onDeliveryModeChange, onSecondaryDeliveryChange, onSlackChannelChange, onSlackMentionsChange, onSlackRefresh, }: {
+    draft: BriefingFormDraft;
+    effectiveChannels: BriefingDeliveryChannel[];
+    reportAuthoring: boolean;
+    slackAllowed: boolean;
+    deliveryMode: DeliveryMode;
+    secondaryDeliveryMode: DeliveryMode;
+    hasMultiChannelDelivery: boolean;
+    slackStatus: SlackIntegrationStatus | null;
+    slackLoading: boolean;
+    slackChannels: SlackPostableChannel[];
+    selectedSlackChannelId?: string | null;
+    selectedSlackChannel?: SlackPostableChannel;
+    threadMentions: BriefingRecipient[];
+    slackMentionStatus: SlackMentionStatus | null;
+    slackError: string | null;
+    apiServiceUrl?: string;
+    onChange: (patch: BriefingFormPatch) => void;
+    onDeliveryModeChange: (mode: DeliveryMode) => void;
+    onSecondaryDeliveryChange: () => void;
+    onSlackChannelChange: (channelId: string) => void;
+    onSlackMentionsChange: (mentions: BriefingRecipient[]) => void;
+    onSlackRefresh: () => void;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/components/briefings/briefing-author/form-primitives.d.ts

@@ -0,0 +1,20 @@
+export declare function RadioRow({ label, description, checked, onSelect, name, }: {
+    label: string;
+    description: string;
+    checked: boolean;
+    onSelect: () => void;
+    name: string;
+}): import("react/jsx-runtime").JSX.Element;
+type OutputOption = 'evidence' | 'sql' | 'html';
+export declare function OutputOptionsPopover({ includeEvidence, includeSql, includeHtml, onChange, }: {
+    includeEvidence: boolean;
+    includeSql: boolean;
+    includeHtml: boolean;
+    onChange: (option: OutputOption, checked: boolean) => void;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function CheckboxRow({ label, checked, onChange, }: {
+    label: string;
+    checked: boolean;
+    onChange: (next: boolean) => void;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/briefings/briefing-author/output.d.ts

@@ -0,0 +1,2 @@
+import { BriefingFormDraft } from '../../../lib/briefings/briefing-form-model.js';
+export declare function setArtifactFormatEnabled(formats: BriefingFormDraft['output']['artifactFormats'], format: BriefingFormDraft['output']['artifactFormats'][number], enabled: boolean): BriefingFormDraft['output']['artifactFormats'];

package/dist/types/components/briefings/briefing-author/policy.d.ts

@@ -0,0 +1,40 @@
+import { BriefingAuthorIntent } from '../../../briefings/creation.js';
+import { BriefingFormDraft } from '../../../lib/briefings/briefing-form-model.js';
+import { BriefingAttachment, BriefingDetail, BriefingRecipient, BriefingSource } from '../../../lib/types/briefing-types.js';
+export type BriefingAuthorSourceContext = {
+    source: BriefingSource;
+    label?: string;
+    detail?: string;
+};
+export declare function resolveBriefingAuthorTimezone(reportTimezone: unknown): string;
+export declare function resolveBriefingAuthorSourceContext(input: {
+    briefing?: BriefingDetail | null;
+    sourceContext?: BriefingAuthorSourceContext;
+}): BriefingAuthorSourceContext;
+export declare function createBriefingAuthorDraft(input: {
+    briefing?: BriefingDetail | null;
+    sourceContext?: BriefingAuthorSourceContext;
+    defaultRecipient?: BriefingRecipient | null;
+    intent?: BriefingAuthorIntent;
+    initialAttachments?: BriefingAttachment[];
+    initialName?: string;
+    initialMessage?: string;
+    timezone?: string;
+}): BriefingFormDraft;
+export declare function projectBriefingAuthorDelivery(input: {
+    draft: BriefingFormDraft;
+    scheduledReport: boolean;
+    identityResolved: boolean;
+    userType?: 'organization' | 'tenant';
+}): {
+    draft: BriefingFormDraft;
+    slackAllowed: boolean;
+    emailEnabled: boolean;
+    slackEnabled: boolean;
+};
+export declare function isBriefingReportAuthoring(input: {
+    isNew: boolean;
+    intent: BriefingAuthorIntent;
+    draft: BriefingFormDraft;
+}): boolean;
+export type { BriefingAuthorIntent } from '../../../briefings/creation.js';

package/dist/types/components/briefings/briefing-author/presentation-vocabulary.d.ts

@@ -0,0 +1,17 @@
+export type BriefingPresentationVocabulary = {
+    noun: 'report' | 'briefing';
+    titleNoun: 'Report' | 'Briefing';
+    plural: 'reports' | 'briefings';
+    authorLabel: string;
+    closeLabel: string;
+    untitledLabel: string;
+    editLabel: string;
+    expandedDescription: string;
+    previewResultLabel: string;
+    previewStoppedLabel: string;
+    previewLabel: string;
+    missingArtifactLabel: string;
+    emailHtmlPreviewTitle: string;
+    htmlArtifactTitle: string;
+};
+export declare function getBriefingPresentationVocabulary(reportMode: boolean): BriefingPresentationVocabulary;

package/dist/types/components/briefings/briefing-author/run-model.d.ts

@@ -0,0 +1,49 @@
+import { BriefingDeliveryChannel, BriefingRecipient, BriefingRun } from '../../../lib/types/briefing-types.js';
+import { isActiveBriefingRunStatus, isTerminalBriefingRunStatus } from '../use-briefing-run-polling.js';
+export declare const isTerminalRunStatus: typeof isTerminalBriefingRunStatus;
+export declare const isActiveRunStatus: typeof isActiveBriefingRunStatus;
+export declare function deliveryChannels(current: BriefingDeliveryChannel[], channel: BriefingDeliveryChannel, checked: boolean): BriefingDeliveryChannel[];
+export declare function creatorEmailRecipient(currentUser: {
+    email?: string | null;
+    name?: string | null;
+} | null | undefined): BriefingRecipient | null;
+export declare function useElapsedSeconds(startedAt: string | null | undefined): number | null;
+export declare function formatElapsed(seconds: number): string;
+export type EmailPreviewRecipient = {
+    label: string;
+    detail?: string;
+    type: 'email' | 'user' | 'tenant_user' | 'group';
+    memberCount?: number;
+    previewMembers?: Array<{
+        label: string;
+        detail?: string;
+        type: 'email' | 'user' | 'tenant_user';
+    }>;
+    hasMoreMembers?: boolean;
+};
+export type EmailPreviewArtifact = {
+    subject: string;
+    recipients: EmailPreviewRecipient[];
+    channels: string[];
+    body: string;
+    bodyHtml?: string;
+    attachments: string[];
+    attachmentNotice?: string;
+};
+export type SlackPreviewBlock = Record<string, unknown>;
+export type SlackPreviewArtifact = {
+    channel: string;
+    text: string;
+    blocks: SlackPreviewBlock[];
+    unfurl_links: false;
+    unfurl_media: false;
+    thread?: {
+        text: string;
+        blocks: SlackPreviewBlock[];
+        reply_broadcast: false;
+    };
+};
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function parseEmailPreviewArtifact(value: unknown): EmailPreviewArtifact | null;
+export declare function parseSlackPreviewArtifact(value: unknown): SlackPreviewArtifact | null;
+export declare function parseSavedRunEmailArtifact(run: BriefingRun): EmailPreviewArtifact | null;

package/dist/types/components/briefings/briefing-author/run-ui.d.ts

@@ -0,0 +1,81 @@
+import { BriefingPreviewPlan, BriefingPreviewRun, BriefingRun } from '../../../lib/types/briefing-types.js';
+import { EmailPreviewArtifact, SlackPreviewArtifact } from './run-model.js';
+type PendingAction = 'save' | 'run' | 'plan' | 'preview' | 'pause' | 'resume' | 'delete' | 'cancelRun' | 'deleteRun' | null;
+export declare function BriefingPlanReview({ previewPlan, previewRun, scopeLabel, }: {
+    previewPlan: BriefingPreviewPlan;
+    previewRun: BriefingPreviewRun | null;
+    scopeLabel?: string | null;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function LatestRunSummary({ run, onViewOutput, onDeleteRun, onRetryRun, retryDisabled, retryDisabledReason, deletePending, }: {
+    run: BriefingRun;
+    onViewOutput: () => void;
+    onDeleteRun?: () => void;
+    onRetryRun?: () => void;
+    retryDisabled?: boolean;
+    retryDisabledReason?: string;
+    deletePending?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function RunProgressDetails({ run }: {
+    run: BriefingPreviewRun | BriefingRun;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function RunExpectationBanner(): import("react/jsx-runtime").JSX.Element;
+export declare function BackgroundRunPill({ run, onExpand, }: {
+    run: BriefingPreviewRun | BriefingRun;
+    onExpand: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function RunCompletionBanner({ title, durationSeconds, status, onView, onDismiss, }: {
+    title: string;
+    durationSeconds: number | null;
+    status: 'success' | 'failed';
+    onView: () => void;
+    onDismiss: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function StickyActivityBar({ pendingAction, previewRun, savedActiveRun, onShowDetails, onCancelPreviewRun, onCancelSavedRun, onMinimizeRun, detailsVisible, }: {
+    pendingAction: PendingAction;
+    previewRun: BriefingPreviewRun | null;
+    savedActiveRun: BriefingRun | null;
+    onShowDetails: () => void;
+    onCancelPreviewRun?: () => void;
+    onCancelSavedRun?: () => void;
+    onMinimizeRun?: () => void;
+    detailsVisible: boolean;
+}): import("react/jsx-runtime").JSX.Element | null;
+export declare function EmailPackagePreview({ preview, onExpand, reportMode, }: {
+    preview: EmailPreviewArtifact;
+    onExpand?: () => void;
+    reportMode?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function SlackMessagePreview({ preview, onExpand, trustLine, reactions, }: {
+    preview: SlackPreviewArtifact;
+    onExpand?: () => void;
+    /** Optional italic footer line ("Runs with X's permissions · …"). */
+    trustLine?: string;
+    /** Mock reaction counts for the preview surface. Real reactions come back
+        after send and are surfaced separately on the briefing detail. */
+    reactions?: Array<{
+        emoji: string;
+        count: number;
+    }>;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function BriefingPreviewResult({ previewRun, onExpand, fullWidth, reportMode, }: {
+    previewRun: BriefingPreviewRun;
+    onExpand?: () => void;
+    fullWidth?: boolean;
+    reportMode?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function SavedRunResult({ run, onExpand, reportMode, onDeleteRun, onRetryRun, retryDisabled, retryDisabledReason, deletePending, }: {
+    run: BriefingRun;
+    onExpand?: () => void;
+    reportMode?: boolean;
+    onDeleteRun?: () => void;
+    onRetryRun?: () => void;
+    retryDisabled?: boolean;
+    retryDisabledReason?: string;
+    deletePending?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function LocalPreviewOutputCallout({ previewRun, isStale, onViewOutput, }: {
+    previewRun: BriefingPreviewRun;
+    isStale: boolean;
+    onViewOutput: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/briefings/briefing-author/schedule-model.d.ts

@@ -0,0 +1,3 @@
+export { DEFAULT_BRIEFING_SCHEDULE as DEFAULT_SCHEDULE_VM, buildBriefingScheduleExpr as buildScheduleExpr, describeBriefingSchedule as describeScheduleExpr, parseBriefingScheduleExpr, type BriefingScheduleCadence as ScheduleRepeats, type BriefingScheduleViewModel as ScheduleViewModel, } from '../../../briefings/schedule.js';
+export declare function formatTimeLabel(hour: number, minute: number): string;
+export declare const COMMON_TIMEZONES: string[];

package/dist/types/components/briefings/briefing-author/schedule-section.d.ts

@@ -0,0 +1,5 @@
+import { BriefingFormDraft, BriefingFormPatch } from '../../../lib/briefings/briefing-form-model.js';
+export declare function ScheduleSection({ schedule, onChange, }: {
+    schedule: BriefingFormDraft['schedule'];
+    onChange: (patch: BriefingFormPatch) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/briefings/briefing-author/schedule.d.ts

@@ -0,0 +1,8 @@
+export declare function ScheduleSubform({ scheduleExpr, timezone, onScheduleChange, }: {
+    scheduleExpr: string;
+    timezone: string;
+    onScheduleChange: (next: {
+        scheduleExpr: string;
+        timezone: string;
+    }) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/briefings/briefing-author/scope-picker.d.ts

@@ -0,0 +1,14 @@
+import { BriefingSource } from '../../../lib/types/briefing-types.js';
+type ScopePickerSourceContext = {
+    source: BriefingSource;
+    label?: string;
+    detail?: string;
+};
+export declare function ScopePicker({ source, resolvedSourceContext, sourceDetail, onChange, }: {
+    source: BriefingSource;
+    resolvedSourceContext: ScopePickerSourceContext;
+    /** Optional detail text shown after the label. `null` hides the detail. */
+    sourceDetail: string | null;
+    onChange: (next: BriefingSource) => void;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/briefings/briefing-author/slack-channel-picker.d.ts

@@ -0,0 +1,22 @@
+export type SlackPickerChannel = {
+    id: string;
+    name: string;
+    isPrivate: boolean;
+    memberCount?: number;
+};
+export type SlackChannelPickerProps = {
+    channels: SlackPickerChannel[];
+    selectedChannelId: string;
+    onChange: (channelId: string) => void;
+    destinationKind: 'channel' | 'dm';
+    /** Toggling kinds. DM is signposted but disabled in V1; the parent passes
+        a no-op that title-tooltips "coming in V2." Keeping the seam means we
+        don't have to refactor when DM ships. */
+    onDestinationKindChange?: (kind: 'channel' | 'dm') => void;
+    loading?: boolean;
+    /** When true, the entire field is non-interactive (e.g. workspace not
+        connected — the parent renders the connect-CTA elsewhere). */
+    disabled?: boolean;
+    className?: string;
+};
+export declare function SlackChannelPicker({ channels, selectedChannelId, onChange, destinationKind, onDestinationKindChange, loading, disabled, className, }: SlackChannelPickerProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/briefings/briefing-author/styles.d.ts

@@ -0,0 +1,4 @@
+export declare const captionCls = "text-[10px] font-medium uppercase tracking-[0.08em] text-muted-foreground";
+export declare const subtleBtnCls = "inline-flex h-7 items-center gap-1.5 rounded-control px-2 text-[12px] text-muted-foreground hover:bg-muted hover:text-foreground disabled:opacity-50";
+export declare const ghostBtnCls = "inline-flex h-7 items-center gap-1.5 rounded-control border border-border bg-background px-2.5 text-[12px] text-foreground hover:bg-muted disabled:opacity-50";
+export declare const primaryBtnCls = "inline-flex h-7 items-center gap-1.5 rounded-control bg-primary px-3 text-[12px] font-medium text-primary-foreground hover:bg-primary/90 disabled:opacity-50";

package/dist/types/components/briefings/briefing-author-dialog.d.ts

@@ -0,0 +1,24 @@
+import { BriefingAttachment, BriefingDetail } from '../../lib/types/briefing-types.js';
+import { BriefingAuthorIntent, BriefingAuthorProps, BriefingAuthorSourceContext } from './briefing-author.js';
+export type BriefingAuthorLaunchRequest = {
+    intent: BriefingAuthorIntent;
+    sourceContext: BriefingAuthorSourceContext;
+    initialAttachments?: BriefingAttachment[];
+    initialName?: string;
+    initialMessage?: string;
+    initialTimezone?: string;
+    availableDashboards?: Array<{
+        id: string;
+        title: string;
+        dashboard?: import('../../lib/types/common-types.js').TDashboard;
+    }>;
+    title?: string;
+};
+export type BriefingAuthorDialogProps = {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    launchRequest: BriefingAuthorLaunchRequest;
+    briefing?: BriefingDetail | null;
+    authorProps?: Omit<BriefingAuthorProps, 'briefing' | 'intent' | 'sourceContext' | 'initialAttachments' | 'initialName' | 'initialMessage' | 'initialTimezone' | 'availableDashboards' | 'title' | 'onCancel'>;
+};
+export declare function BriefingAuthorDialog({ open, onOpenChange, launchRequest, briefing, authorProps, }: BriefingAuthorDialogProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/briefings/briefing-author.d.ts

@@ -0,0 +1,72 @@
+import { cancelBriefingPreviewRun, cancelBriefingRun, createBriefing, deleteBriefing, deleteBriefingRun, getBriefing, getBriefingPreviewRun, getBriefingRun, pauseBriefing, polishBriefingText, previewBriefingPlan, resumeBriefing, runBriefingNow, runBriefingPreview, updateBriefing } from '../../lib/api/briefings-api.js';
+import { BriefingAttachment, BriefingDetail, BriefingRun, RunBriefingNowResponse } from '../../lib/types/briefing-types.js';
+import { TDashboard } from '../../lib/types/common-types.js';
+import { BriefingAuthorIntent, BriefingAuthorSourceContext } from './briefing-author/policy.js';
+export { formatElapsed, useElapsedSeconds } from './briefing-author/run-model.js';
+export { BackgroundRunPill, RunCompletionBanner } from './briefing-author/run-ui.js';
+export type BriefingAuthorClient = {
+    createBriefing: typeof createBriefing;
+    updateBriefing: typeof updateBriefing;
+    pauseBriefing: typeof pauseBriefing;
+    resumeBriefing: typeof resumeBriefing;
+    deleteBriefing: typeof deleteBriefing;
+    getBriefing: typeof getBriefing;
+    runBriefingNow: typeof runBriefingNow;
+    getBriefingRun: typeof getBriefingRun;
+    cancelBriefingRun: typeof cancelBriefingRun;
+    deleteBriefingRun: typeof deleteBriefingRun;
+    previewBriefingPlan: typeof previewBriefingPlan;
+    runBriefingPreview: typeof runBriefingPreview;
+    getBriefingPreviewRun: typeof getBriefingPreviewRun;
+    cancelBriefingPreviewRun: typeof cancelBriefingPreviewRun;
+    polishBriefingText: typeof polishBriefingText;
+};
+export type { BriefingAuthorIntent, BriefingAuthorSourceContext } from './briefing-author/policy.js';
+export type BriefingAuthorProps = {
+    apiServiceUrl?: string;
+    token?: string;
+    briefing?: BriefingDetail | null;
+    intent?: BriefingAuthorIntent;
+    initialAttachments?: BriefingAttachment[];
+    initialName?: string;
+    initialMessage?: string;
+    initialTimezone?: string;
+    availableDashboards?: Array<{
+        id: string;
+        title: string;
+        dashboard?: TDashboard;
+    }>;
+    sourceContext?: BriefingAuthorSourceContext;
+    title?: string;
+    hideHeader?: boolean;
+    className?: string;
+    client?: Partial<BriefingAuthorClient>;
+    generateRequestId?: () => string;
+    onSaved?: (briefing: BriefingDetail) => void;
+    onDeleted?: (briefingId: string) => void;
+    onRunStarted?: (response: RunBriefingNowResponse) => void;
+    onCancel?: () => void;
+    /**
+     * Fires when the user clicks "Run in background" on the active-run sticky
+     * strip. The parent is expected to track the run, render a persistent
+     * background-run UI (pill + completion banner), and close any modal/sheet
+     * that hosts the author so the user can navigate freely while the run
+     * continues server-side.
+     *
+     * Only ever called for *saved* runs — preview runs are short-lived
+     * synthetic things with no notification path, so the sticky bar hides
+     * the CTA in that case.
+     */
+    onMinimizeRun?: (input: {
+        briefing: BriefingDetail;
+        run: BriefingRun;
+    }) => void;
+    /**
+     * If provided, surfaces a "Back to briefings" affordance in the panel
+     * footer (and a back-chevron in the header) so the user can return to
+     * the parent list without closing the entire panel. Distinct from
+     * `onCancel`, which closes the panel entirely.
+     */
+    onBack?: () => void;
+};
+export declare function BriefingAuthor({ apiServiceUrl, token, briefing, intent, initialAttachments, initialName, initialMessage, initialTimezone, availableDashboards, sourceContext, title, hideHeader, className, client, generateRequestId, onSaved, onDeleted, onRunStarted, onCancel, onBack, onMinimizeRun, }: BriefingAuthorProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/briefings/briefing-html-frame.d.ts

@@ -0,0 +1,5 @@
+export declare function BriefingHtmlFrame({ html, title, className, }: {
+    html: string;
+    title?: string;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;