@aglyn/plugins-outreach 1.0.0-beta.194 → 1.0.0-beta.196

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/plugins-outreach",
-  "version": "1.0.0-beta.194",
+  "version": "1.0.0-beta.196",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -25,19 +25,19 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/aglyn": "1.0.0-beta.194",
-    "@aglyn/shared-data-mdi": "1.0.0-beta.194",
-    "@aglyn/shared-ui-email-campaigns": "1.0.0-beta.194",
-    "@aglyn/shared-ui-jsx": "1.0.0-beta.194",
-    "@aglyn/shared-ui-next": "1.0.0-beta.194",
-    "@aglyn/shared-ui-snackstack": "1.0.0-beta.194",
-    "@aglyn/shared-util-email": "1.0.0-beta.194",
-    "@aglyn/shared-util-http": "1.0.0-beta.194",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.194",
-    "@aglyn/shared-util-tools": "1.0.0-beta.194",
-    "@aglyn/tenant-data-admin": "1.0.0-beta.194",
-    "@aglyn/tenant-feature-instance": "1.0.0-beta.194",
-    "@aglyn/tenant-runtime": "1.0.0-beta.194",
+    "@aglyn/aglyn": "1.0.0-beta.196",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.196",
+    "@aglyn/shared-ui-email-campaigns": "1.0.0-beta.196",
+    "@aglyn/shared-ui-jsx": "1.0.0-beta.196",
+    "@aglyn/shared-ui-next": "1.0.0-beta.196",
+    "@aglyn/shared-ui-snackstack": "1.0.0-beta.196",
+    "@aglyn/shared-util-email": "1.0.0-beta.196",
+    "@aglyn/shared-util-http": "1.0.0-beta.196",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.196",
+    "@aglyn/shared-util-tools": "1.0.0-beta.196",
+    "@aglyn/tenant-data-admin": "1.0.0-beta.196",
+    "@aglyn/tenant-feature-instance": "1.0.0-beta.196",
+    "@aglyn/tenant-runtime": "1.0.0-beta.196",
     "@swc/helpers": "0.5.23"
   },
   "peerDependencies": {

package/src/lib/components/curate-step-dialog.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { OutreachEnrollment, OutreachSequenceStep } from '../model/outreach.types';
+import type { OutreachApi } from './use-outreach-api';
+/**
+ * CURATE THE NEXT STEP OF AN ENROLLMENT (AGL-3324): Enrollments tab › row ›
+ * Curate next step.
+ *
+ * Step 2 of a sequence was written before the person replied, clicked or
+ * changed their site; this rewrites it for them now. The dialog asks the
+ * workspace's AI for the next email step's copy the moment it opens, shows
+ * it in the editor, and stores it only on "Use this" — through the save
+ * route, which validates it again and files "Curated step N" on the
+ * person's record. "Keep the template" clears a copy the enrollment already
+ * carried for the step, so the step goes back to the sequence's own words.
+ *
+ * When the AI cannot draft — the workspace has no generator, the member
+ * lacks the permission, the allotment is spent — the member can still write
+ * the copy themselves, from the step's own words.
+ */
+/** The next email step that has not gone out, or `null`. */
+export declare function outreachNextEmailStepIndex(enrollment: Pick<OutreachEnrollment, 'stepIndex' | 'status'>, steps: readonly OutreachSequenceStep[]): number | null;
+/** "Email 2 · step 3", as the sequence's preview names an email. */
+export declare function outreachEmailStepLabel(steps: readonly OutreachSequenceStep[], stepIndex: number): string;
+export interface OutreachCurateStepDialogProps {
+    /** The enrollment to curate, or `null` while closed. */
+    enrollment: OutreachEnrollment | null;
+    steps: readonly OutreachSequenceStep[];
+    api: OutreachApi;
+    onClose(): void;
+}
+export declare function OutreachCurateStepDialog(props: OutreachCurateStepDialogProps): import("react").JSX.Element;
+export declare namespace OutreachCurateStepDialog {
+    var displayName: string;
+}
+export default OutreachCurateStepDialog;

package/src/lib/components/curate-step-dialog.js

@@ -0,0 +1,235 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { Alert, Button, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, Stack, useMediaQuery, useTheme } from "@mui/material";
+import { useEffect, useState } from "react";
+import { OutreachCuratedStepEditor, outreachDraftState, outreachDraftToOverride, outreachMemberDraftStates } from "./curated-step-editor.js";
+import { OutreachLoading } from "./outreach-ui.js";
+/**
+ * CURATE THE NEXT STEP OF AN ENROLLMENT (AGL-3324): Enrollments tab › row ›
+ * Curate next step.
+ *
+ * Step 2 of a sequence was written before the person replied, clicked or
+ * changed their site; this rewrites it for them now. The dialog asks the
+ * workspace's AI for the next email step's copy the moment it opens, shows
+ * it in the editor, and stores it only on "Use this" — through the save
+ * route, which validates it again and files "Curated step N" on the
+ * person's record. "Keep the template" clears a copy the enrollment already
+ * carried for the step, so the step goes back to the sequence's own words.
+ *
+ * When the AI cannot draft — the workspace has no generator, the member
+ * lacks the permission, the allotment is spent — the member can still write
+ * the copy themselves, from the step's own words.
+ */ /** The next email step that has not gone out, or `null`. */ export function outreachNextEmailStepIndex(enrollment, steps) {
+    if (enrollment.status !== 'active' && enrollment.status !== 'paused') return null;
+    const index = steps.findIndex((step, position)=>position >= enrollment.stepIndex && step.kind === 'email');
+    return index >= 0 ? index : null;
+}
+/** "Email 2 · step 3", as the sequence's preview names an email. */ export function outreachEmailStepLabel(steps, stepIndex) {
+    const position = steps.slice(0, stepIndex + 1).filter((step)=>step.kind === 'email').length;
+    return `Email ${position} · step ${stepIndex + 1}`;
+}
+export function OutreachCurateStepDialog(props) {
+    var _ref;
+    var _enrollment_stepOverrides;
+    const { enrollment, steps, api } = props;
+    const theme = useTheme();
+    const narrow = useMediaQuery(theme.breakpoints.down('sm'));
+    const { enqueueSnackbar } = useSnackbar();
+    const [stage, setStage] = useState({
+        kind: 'drafting'
+    });
+    const stepIndex = enrollment ? outreachNextEmailStepIndex(enrollment, steps) : null;
+    const enrollmentId = (_ref = enrollment == null ? void 0 : enrollment.id) != null ? _ref : null;
+    const existing = stepIndex !== null ? enrollment == null ? void 0 : (_enrollment_stepOverrides = enrollment.stepOverrides) == null ? void 0 : _enrollment_stepOverrides[String(stepIndex)] : undefined;
+    useEffect(()=>{
+        if (!enrollmentId || stepIndex === null) return;
+        let cancelled = false;
+        setStage({
+            kind: 'drafting'
+        });
+        api.curateDrafts({
+            enrollmentId,
+            stepIndexes: [
+                stepIndex
+            ]
+        }).then((answer)=>{
+            if (cancelled) return;
+            const draft = answer.drafts.find((entry)=>entry.stepIndex === stepIndex);
+            if (!draft) {
+                setStage({
+                    kind: 'failed',
+                    message: 'No draft came back for this step. Try again.'
+                });
+                return;
+            }
+            setStage({
+                kind: 'editing',
+                draft: outreachDraftState(draft, steps, 'ai', {
+                    prompt: answer.prompt,
+                    model: answer.model
+                })
+            });
+        }).catch((error)=>{
+            if (!cancelled) setStage({
+                kind: 'failed',
+                message: error.message
+            });
+        });
+        return ()=>{
+            cancelled = true;
+        };
+    }, [
+        api,
+        enrollmentId,
+        stepIndex,
+        steps
+    ]);
+    const writeItYourself = ()=>{
+        if (stepIndex === null) return;
+        const [draft] = outreachMemberDraftStates(steps, [
+            stepIndex
+        ]);
+        if (draft) {
+            var _existing_subject, _existing_body;
+            // A copy the enrollment already carries is the better starting point.
+            setStage({
+                kind: 'editing',
+                draft: existing ? _extends({}, draft, {
+                    subject: (_existing_subject = existing.subject) != null ? _existing_subject : draft.subject,
+                    body: (_existing_body = existing.body) != null ? _existing_body : draft.body
+                }) : draft
+            });
+        }
+    };
+    const decide = async (draft)=>{
+        if (!enrollmentId || stepIndex === null) return;
+        if (draft.decision === 'pending') {
+            setStage({
+                kind: 'editing',
+                draft
+            });
+            return;
+        }
+        const override = outreachDraftToOverride(draft);
+        if (draft.decision === 'keep' && !existing) {
+            props.onClose();
+            return;
+        }
+        setStage({
+            kind: 'saving',
+            draft
+        });
+        try {
+            await api.saveCuratedStep(enrollmentId, stepIndex, override ? _extends({}, override.subject !== undefined ? {
+                subject: override.subject
+            } : {}, {
+                body: override.body,
+                source: override.source
+            }, override.edited ? {
+                edited: true
+            } : {}, override.prompt ? {
+                prompt: override.prompt
+            } : {}, override.model ? {
+                model: override.model
+            } : {}) : null);
+            enqueueSnackbar(override ? `Curated step ${stepIndex + 1}. It goes out as written.` : 'Template kept.', {
+                variant: 'success'
+            });
+            props.onClose();
+        } catch (error) {
+            enqueueSnackbar(error.message, {
+                variant: 'error',
+                allowDuplicate: true
+            });
+            setStage({
+                kind: 'editing',
+                draft: _extends({}, draft, {
+                    decision: 'pending'
+                })
+            });
+        }
+    };
+    const title = enrollment ? `Curate the next email for ${enrollment.contactName || enrollment.email}` : 'Curate the next email';
+    return /*#__PURE__*/ _jsxs(Dialog, {
+        open: Boolean(enrollment),
+        onClose: props.onClose,
+        fullWidth: true,
+        maxWidth: "md",
+        fullScreen: narrow,
+        "aria-label": title,
+        children: [
+            /*#__PURE__*/ _jsx(DialogTitle, {
+                children: title
+            }),
+            /*#__PURE__*/ _jsx(DialogContent, {
+                dividers: true,
+                children: /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 2,
+                    children: [
+                        stepIndex === null ? /*#__PURE__*/ _jsx(Alert, {
+                            severity: "info",
+                            children: "Every email in this sequence has gone out to this person."
+                        }) : null,
+                        stepIndex !== null ? /*#__PURE__*/ _jsx(DialogContentText, {
+                            children: `${outreachEmailStepLabel(steps, stepIndex)}, rewritten for this person from their record and your personal line. Nothing is sent until you confirm it.`
+                        }) : null,
+                        stage.kind === 'drafting' && stepIndex !== null ? /*#__PURE__*/ _jsx(OutreachLoading, {
+                            label: "Drafting the email…"
+                        }) : null,
+                        stage.kind === 'failed' ? /*#__PURE__*/ _jsxs(Stack, {
+                            spacing: 1,
+                            children: [
+                                /*#__PURE__*/ _jsx(Alert, {
+                                    severity: "warning",
+                                    children: stage.message
+                                }),
+                                /*#__PURE__*/ _jsx(Stack, {
+                                    direction: "row",
+                                    children: /*#__PURE__*/ _jsx(Button, {
+                                        size: "small",
+                                        onClick: writeItYourself,
+                                        children: "Write it yourself"
+                                    })
+                                })
+                            ]
+                        }) : null,
+                        (stage.kind === 'editing' || stage.kind === 'saving') && stepIndex !== null ? /*#__PURE__*/ _jsx(OutreachCuratedStepEditor, {
+                            draft: stage.draft,
+                            label: outreachEmailStepLabel(steps, stepIndex),
+                            onChange: (next)=>void decide(next),
+                            disabled: stage.kind === 'saving'
+                        }) : null
+                    ]
+                })
+            }),
+            /*#__PURE__*/ _jsx(DialogActions, {
+                children: /*#__PURE__*/ _jsx(Button, {
+                    onClick: props.onClose,
+                    disabled: stage.kind === 'saving',
+                    children: "Close"
+                })
+            })
+        ]
+    });
+}
+OutreachCurateStepDialog.displayName = 'OutreachCurateStepDialog';
+export default OutreachCurateStepDialog;
+
+//# sourceMappingURL=curate-step-dialog.js.map

package/src/lib/components/curate-step-dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/components/curate-step-dialog.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n'use client'\n\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  Alert,\n  Button,\n  Dialog,\n  DialogActions,\n  DialogContent,\n  DialogContentText,\n  DialogTitle,\n  Stack,\n  useMediaQuery,\n  useTheme,\n} from '@mui/material'\nimport { useEffect, useState } from 'react'\nimport type { OutreachEnrollment, OutreachSequenceStep } from '../model/outreach.types'\nimport {\n  OutreachCuratedStepEditor,\n  outreachDraftState,\n  outreachDraftToOverride,\n  outreachMemberDraftStates,\n  type OutreachCuratedDraftState,\n} from './curated-step-editor'\nimport { OutreachLoading } from './outreach-ui'\nimport type { OutreachApi } from './use-outreach-api'\n\n/**\n * CURATE THE NEXT STEP OF AN ENROLLMENT (AGL-3324): Enrollments tab › row ›\n * Curate next step.\n *\n * Step 2 of a sequence was written before the person replied, clicked or\n * changed their site; this rewrites it for them now. The dialog asks the\n * workspace's AI for the next email step's copy the moment it opens, shows\n * it in the editor, and stores it only on \"Use this\" — through the save\n * route, which validates it again and files \"Curated step N\" on the\n * person's record. \"Keep the template\" clears a copy the enrollment already\n * carried for the step, so the step goes back to the sequence's own words.\n *\n * When the AI cannot draft — the workspace has no generator, the member\n * lacks the permission, the allotment is spent — the member can still write\n * the copy themselves, from the step's own words.\n */\n\n/** The next email step that has not gone out, or `null`. */\nexport function outreachNextEmailStepIndex(\n  enrollment: Pick<OutreachEnrollment, 'stepIndex' | 'status'>,\n  steps: readonly OutreachSequenceStep[],\n): number | null {\n  if (enrollment.status !== 'active' && enrollment.status !== 'paused') return null\n  const index = steps.findIndex((step, position) => position >= enrollment.stepIndex && step.kind === 'email')\n  return index >= 0 ? index : null\n}\n\n/** \"Email 2 · step 3\", as the sequence's preview names an email. */\nexport function outreachEmailStepLabel(steps: readonly OutreachSequenceStep[], stepIndex: number): string {\n  const position = steps.slice(0, stepIndex + 1).filter((step) => step.kind === 'email').length\n  return `Email ${position} · step ${stepIndex + 1}`\n}\n\nexport interface OutreachCurateStepDialogProps {\n  /** The enrollment to curate, or `null` while closed. */\n  enrollment: OutreachEnrollment | null\n  steps: readonly OutreachSequenceStep[]\n  api: OutreachApi\n  onClose(): void\n}\n\ntype Stage =\n  | { kind: 'drafting' }\n  | { kind: 'failed'; message: string }\n  | { kind: 'editing'; draft: OutreachCuratedDraftState }\n  | { kind: 'saving'; draft: OutreachCuratedDraftState }\n\nexport function OutreachCurateStepDialog(props: OutreachCurateStepDialogProps) {\n  const { enrollment, steps, api } = props\n  const theme = useTheme()\n  const narrow = useMediaQuery(theme.breakpoints.down('sm'))\n  const { enqueueSnackbar } = useSnackbar()\n  const [stage, setStage] = useState<Stage>({ kind: 'drafting' })\n  const stepIndex = enrollment ? outreachNextEmailStepIndex(enrollment, steps) : null\n  const enrollmentId = enrollment?.id ?? null\n  const existing = stepIndex !== null ? enrollment?.stepOverrides?.[String(stepIndex)] : undefined\n\n  useEffect(() => {\n    if (!enrollmentId || stepIndex === null) return\n    let cancelled = false\n    setStage({ kind: 'drafting' })\n    api\n      .curateDrafts({ enrollmentId, stepIndexes: [stepIndex] })\n      .then((answer) => {\n        if (cancelled) return\n        const draft = answer.drafts.find((entry) => entry.stepIndex === stepIndex)\n        if (!draft) {\n          setStage({ kind: 'failed', message: 'No draft came back for this step. Try again.' })\n          return\n        }\n        setStage({\n          kind: 'editing',\n          draft: outreachDraftState(draft, steps, 'ai', { prompt: answer.prompt, model: answer.model }),\n        })\n      })\n      .catch((error) => {\n        if (!cancelled) setStage({ kind: 'failed', message: (error as Error).message })\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [api, enrollmentId, stepIndex, steps])\n\n  const writeItYourself = () => {\n    if (stepIndex === null) return\n    const [draft] = outreachMemberDraftStates(steps, [stepIndex])\n    if (draft) {\n      // A copy the enrollment already carries is the better starting point.\n      setStage({\n        kind: 'editing',\n        draft: existing\n          ? { ...draft, subject: existing.subject ?? draft.subject, body: existing.body ?? draft.body }\n          : draft,\n      })\n    }\n  }\n\n  const decide = async (draft: OutreachCuratedDraftState) => {\n    if (!enrollmentId || stepIndex === null) return\n    if (draft.decision === 'pending') {\n      setStage({ kind: 'editing', draft })\n      return\n    }\n    const override = outreachDraftToOverride(draft)\n    if (draft.decision === 'keep' && !existing) {\n      props.onClose()\n      return\n    }\n    setStage({ kind: 'saving', draft })\n    try {\n      await api.saveCuratedStep(\n        enrollmentId,\n        stepIndex,\n        override\n          ? {\n              ...(override.subject !== undefined ? { subject: override.subject } : {}),\n              body: override.body,\n              source: override.source,\n              ...(override.edited ? { edited: true } : {}),\n              ...(override.prompt ? { prompt: override.prompt } : {}),\n              ...(override.model ? { model: override.model } : {}),\n            }\n          : null,\n      )\n      enqueueSnackbar(\n        override ? `Curated step ${stepIndex + 1}. It goes out as written.` : 'Template kept.',\n        { variant: 'success' },\n      )\n      props.onClose()\n    } catch (error) {\n      enqueueSnackbar((error as Error).message, { variant: 'error', allowDuplicate: true })\n      setStage({ kind: 'editing', draft: { ...draft, decision: 'pending' } })\n    }\n  }\n\n  const title = enrollment\n    ? `Curate the next email for ${enrollment.contactName || enrollment.email}`\n    : 'Curate the next email'\n\n  return (\n    <Dialog open={Boolean(enrollment)} onClose={props.onClose} fullWidth maxWidth=\"md\" fullScreen={narrow} aria-label={title}>\n      <DialogTitle>{title}</DialogTitle>\n      <DialogContent dividers>\n        <Stack spacing={2}>\n          {stepIndex === null ? (\n            <Alert severity=\"info\">Every email in this sequence has gone out to this person.</Alert>\n          ) : null}\n          {stepIndex !== null ? (\n            <DialogContentText>\n              {`${outreachEmailStepLabel(steps, stepIndex)}, rewritten for this person from their record and your personal line. Nothing is sent until you confirm it.`}\n            </DialogContentText>\n          ) : null}\n          {stage.kind === 'drafting' && stepIndex !== null ? <OutreachLoading label=\"Drafting the email…\" /> : null}\n          {stage.kind === 'failed' ? (\n            <Stack spacing={1}>\n              <Alert severity=\"warning\">{stage.message}</Alert>\n              <Stack direction=\"row\">\n                <Button size=\"small\" onClick={writeItYourself}>\n                  Write it yourself\n                </Button>\n              </Stack>\n            </Stack>\n          ) : null}\n          {(stage.kind === 'editing' || stage.kind === 'saving') && stepIndex !== null ? (\n            <OutreachCuratedStepEditor\n              draft={stage.draft}\n              label={outreachEmailStepLabel(steps, stepIndex)}\n              onChange={(next) => void decide(next)}\n              disabled={stage.kind === 'saving'}\n            />\n          ) : null}\n        </Stack>\n      </DialogContent>\n      <DialogActions>\n        <Button onClick={props.onClose} disabled={stage.kind === 'saving'}>\n          Close\n        </Button>\n      </DialogActions>\n    </Dialog>\n  )\n}\nOutreachCurateStepDialog.displayName = 'OutreachCurateStepDialog'\n\nexport default OutreachCurateStepDialog\n"],"names":["useSnackbar","Alert","Button","Dialog","DialogActions","DialogContent","DialogContentText","DialogTitle","Stack","useMediaQuery","useTheme","useEffect","useState","OutreachCuratedStepEditor","outreachDraftState","outreachDraftToOverride","outreachMemberDraftStates","OutreachLoading","outreachNextEmailStepIndex","enrollment","steps","status","index","findIndex","step","position","stepIndex","kind","outreachEmailStepLabel","slice","filter","length","OutreachCurateStepDialog","props","api","theme","narrow","breakpoints","down","enqueueSnackbar","stage","setStage","enrollmentId","id","existing","stepOverrides","String","undefined","cancelled","curateDrafts","stepIndexes","then","answer","draft","drafts","find","entry","message","prompt","model","catch","error","writeItYourself","subject","body","decide","decision","override","onClose","saveCuratedStep","source","edited","variant","allowDuplicate","title","contactName","email","open","Boolean","fullWidth","maxWidth","fullScreen","aria-label","dividers","spacing","severity","label","direction","size","onClick","onChange","next","disabled","displayName"],"mappings":"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"}

package/src/lib/components/curated-step-editor.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type OutreachValidationIssue } from '../engine/sequence-validation';
+import type { OutreachCurateDraft, OutreachStepOverrideRequest } from '../model/outreach-api';
+import { type OutreachSequenceStep, type OutreachStepOverrideSource } from '../model/outreach.types';
+/**
+ * ONE PERSON'S COPY OF ONE STEP, AS THE MEMBER READS AND DECIDES IT
+ * (AGL-3324).
+ *
+ * The enroll dialog shows one of these under each person for every email
+ * step the AI drafted; the Enrollments tab shows one for the next step. The
+ * member edits the subject and the body, reads what the validator says,
+ * ticks the confirmation — a fourth attestation beside the three a cold
+ * contact asks for — and either USES the copy or KEEPS the template. Until
+ * they decide, nothing about the draft leaves the browser: the enroll and
+ * the save carry only what was used.
+ *
+ * Validated as they type, with the same rules the route applies again: a
+ * draft that breaks one cannot be used as it stands.
+ */
+/** What the member holds for one drafted step. */
+export interface OutreachCuratedDraftState {
+    stepIndex: number;
+    /** Whether the email starts a thread, and so has a subject of its own. */
+    startsThread: boolean;
+    subject: string;
+    body: string;
+    /** The words as they were drafted, so an edit can be told from a confirmation. */
+    original: {
+        subject: string;
+        body: string;
+    };
+    source: OutreachStepOverrideSource;
+    /** The member ticked the confirmation. */
+    confirmed: boolean;
+    /** Used, kept as the template, or still open. */
+    decision: 'pending' | 'use' | 'keep';
+    /** The AI's prompt and model, for the override's audit record. */
+    prompt?: string;
+    model?: string;
+}
+/** A drafted step as the route answered it, ready for the member. */
+export declare function outreachDraftState(draft: Pick<OutreachCurateDraft, 'stepIndex' | 'subject' | 'body'>, steps: readonly OutreachSequenceStep[], source: OutreachStepOverrideSource, audit?: {
+    prompt: string;
+    model: string;
+}): OutreachCuratedDraftState;
+/** The member's own starting point: the step's words, for them to rewrite by hand. */
+export declare function outreachMemberDraftStates(steps: readonly OutreachSequenceStep[], stepIndexes: readonly number[]): OutreachCuratedDraftState[];
+/** The request a USED draft becomes; `null` for one that was kept or is still open. */
+export declare function outreachDraftToOverride(draft: OutreachCuratedDraftState): OutreachStepOverrideRequest | null;
+/** The validator's verdict on the draft as it stands. */
+export declare function outreachDraftIssues(draft: OutreachCuratedDraftState): OutreachValidationIssue[];
+/** Whether the draft may be used as it stands: confirmed, and nothing the validator refuses. */
+export declare function outreachDraftUsable(draft: OutreachCuratedDraftState): boolean;
+export interface OutreachCuratedStepEditorProps {
+    draft: OutreachCuratedDraftState;
+    /** "Email 1 · step 1", as the sequence's preview names it. */
+    label: string;
+    onChange(next: OutreachCuratedDraftState): void;
+    disabled?: boolean;
+}
+export declare function OutreachCuratedStepEditor(props: OutreachCuratedStepEditorProps): import("react").JSX.Element;
+export declare namespace OutreachCuratedStepEditor {
+    var displayName: string;
+}
+export default OutreachCuratedStepEditor;