@anthusai/papyrus 5.131.0-next.2 → 5.131.0-next.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  /**
2
- * The logic behind Administration > Policies > Writing guidelines, apart from React: what the editable form holds, how it becomes a guideline document, how each
3
- * field of a section's effective guidelines is labelled with where it came from, and the client for the guidelines door (`guidelinesRead` and `guidelinesWrite`).
4
- * Nothing here knows how a document is stored: every read and write is one of the `guidelines_*` operations (docs/plans/guidelines-as-data.md section 8).
2
+ * The logic behind Administration > Policies > Writing guidelines, apart from React: the types of the guidelines door, how each field of a section's effective
3
+ * guidelines is labelled with where it came from, change lines, and the checks drawn from a set. The files editor itself is `guideline-files.ts`. Nothing here
4
+ * knows how a set is stored: every read and write is one of the `guidelines_*` operations (docs/plans/guidelines-as-data.md section 8).
5
5
  */
6
6
  import type { ImageEnvelope, ImageOperationName, ImageOperations } from "../images/operations.generated";
7
7
 
@@ -18,73 +18,12 @@ export const NO_REASON_PROBLEM = "Say why you are changing the guidelines. The r
18
18
  export const NO_WRITING_WARNING = "This publication has no writing guidelines yet, so agents and the editorial checks have no house voice to follow. Write them here.";
19
19
  export const EDITORS_READ_ONLY = "You can read the writing guidelines. Only an admin can change them.";
20
20
 
21
- export const LIST_FIELDS = [
22
- { key: "tone", label: "Tone", hint: "How the writing should sound. One sentence per line." },
23
- { key: "sentenceStyle", label: "Sentence style", hint: "How sentences are built. One per line." },
24
- { key: "voicePatterns", label: "Voice patterns", hint: "Moves the voice makes, and moves it avoids. One per line." },
25
- { key: "structure", label: "Structure", hint: "How a story is laid out. One per line." },
26
- { key: "evidenceRules", label: "Evidence rules", hint: "What a claim needs before it is written. One per line." },
27
- ] as const;
28
- export const CHOICE_FIELDS = [
29
- { key: "audience", label: "Audience", hint: "Who the publication writes for." },
30
- { key: "editorialAim", label: "Editorial aim", hint: "What the writing is for." },
31
- ] as const;
32
- export const LOCKABLE_FIELDS: { key: string; label: string }[] = [
33
- { key: "voice", label: "Voice" }, { key: "audience", label: "Audience" }, { key: "editorialAim", label: "Editorial aim" }, { key: "headline", label: "Headline" }, { key: "glossary", label: "Glossary" },
34
- ];
35
21
  export const FIELD_LABELS: Record<string, string> = {
36
22
  voice: "Voice", audience: "Audience", editorialAim: "Editorial aim", headline: "Headline", tone: "Tone", sentenceStyle: "Sentence style", voicePatterns: "Voice patterns",
37
23
  structure: "Structure", evidenceRules: "Evidence rules", bodyMarkus: "Guidance in your own words", lexicon: "Words to prefer and avoid", glossary: "Glossary",
38
24
  exemplars: "Voice examples", constraints: "Binding rules",
39
25
  };
40
26
 
41
- export type GlossaryRow = { term: string; use: string; avoid: string };
42
- export type WritingForm = {
43
- voiceName: string; audience: string; editorialAim: string; lists: Record<string, string>; prefer: string; avoid: string; bodyMarkus: string;
44
- glossary: GlossaryRow[]; exemplars: { storyLineageId: string; note: string }[]; locked: string[];
45
- };
46
-
47
- export const textLines = (text: string): string[] => text.split("\n").map((line) => line.trim()).filter(Boolean);
48
- const joinLines = (items: unknown): string => (Array.isArray(items) ? items.filter((item) => typeof item === "string").join("\n") : "");
49
- const asText = (value: unknown): string => (typeof value === "string" ? value : "");
50
-
51
- export function formFromDocument(document: GuidelineDocument | null): WritingForm {
52
- const source = document ?? {};
53
- return {
54
- voiceName: asText(source.voice?.name), audience: asText(source.audience), editorialAim: asText(source.editorialAim),
55
- lists: Object.fromEntries(LIST_FIELDS.map((field) => [field.key, joinLines(source[field.key])])),
56
- prefer: joinLines(source.lexicon?.prefer), avoid: joinLines(source.lexicon?.avoid), bodyMarkus: asText(source.bodyMarkus),
57
- glossary: (Array.isArray(source.glossary) ? source.glossary : []).map((entry: any) => ({ term: asText(entry.term), use: asText(entry.use), avoid: joinLines(entry.avoid).split("\n").join(", ") })),
58
- exemplars: (Array.isArray(source.exemplars) ? source.exemplars : []).map((entry: any) => ({ storyLineageId: asText(entry.storyLineageId), note: asText(entry.note) })),
59
- locked: Array.isArray(source.locked) ? source.locked.filter((item: unknown) => typeof item === "string") : [],
60
- };
61
- }
62
-
63
- /**
64
- * The document a form makes. Fields the form does not edit (headline, binding rules, the legacy publication-only fields) are carried over from `base` untouched;
65
- * a section's document never carries the publication-only fields, so a section form leaves them out. An empty field is left out, never saved empty.
66
- */
67
- export function documentFromForm(form: WritingForm, base: GuidelineDocument | null, scope: "publication" | "section"): GuidelineDocument {
68
- const document: GuidelineDocument = { ...(base ?? {}), schemaVersion: 2 };
69
- const setOrDrop = (key: string, value: unknown, present: boolean) => { if (present) document[key] = value; else delete document[key]; };
70
- setOrDrop("voice", { ...(base?.voice ?? {}), name: form.voiceName.trim() }, form.voiceName.trim() !== "");
71
- setOrDrop("audience", form.audience.trim(), form.audience.trim() !== "");
72
- setOrDrop("editorialAim", form.editorialAim.trim(), form.editorialAim.trim() !== "");
73
- for (const field of LIST_FIELDS) { const lines = textLines(form.lists[field.key] ?? ""); setOrDrop(field.key, lines, lines.length > 0); }
74
- const prefer = textLines(form.prefer), avoid = textLines(form.avoid);
75
- setOrDrop("lexicon", { ...(prefer.length ? { prefer } : {}), ...(avoid.length ? { avoid } : {}) }, prefer.length + avoid.length > 0);
76
- setOrDrop("bodyMarkus", form.bodyMarkus, form.bodyMarkus.trim() !== "");
77
- const glossary = form.glossary.filter((row) => row.term.trim()).map((row) => ({
78
- term: row.term.trim(), ...(row.use.trim() ? { use: row.use.trim() } : {}), ...(row.avoid.trim() ? { avoid: row.avoid.split(",").map((word) => word.trim()).filter(Boolean) } : {}),
79
- }));
80
- setOrDrop("glossary", glossary, glossary.length > 0);
81
- const exemplars = form.exemplars.filter((row) => row.storyLineageId).map((row) => ({ storyLineageId: row.storyLineageId, ...(row.note.trim() ? { note: row.note.trim() } : {}) }));
82
- setOrDrop("exemplars", exemplars, exemplars.length > 0);
83
- if (scope === "publication") setOrDrop("locked", form.locked, form.locked.length > 0);
84
- else for (const key of ["locked", "constraints", "publicationKey", "judge", "checks", "density", "rules", "compare", "referenceSamples"]) delete document[key];
85
- return document;
86
- }
87
-
88
27
  export function reasonProblem(reason: string): string | null {
89
28
  return reason.trim() ? null : NO_REASON_PROBLEM;
90
29
  }
@@ -110,9 +49,6 @@ export function describeChange(change: { path: string; from?: unknown; to?: unkn
110
49
  return `${name}: changed from ${shown(change.from)} to ${shown(change.to)}`;
111
50
  }
112
51
 
113
- export const addExemplar = (rows: WritingForm["exemplars"], story: PublishedStory): WritingForm["exemplars"] =>
114
- rows.some((row) => row.storyLineageId === story.lineageId) ? rows : [...rows, { storyLineageId: story.lineageId, note: "" }];
115
-
116
52
  export function storyTitle(stories: PublishedStory[], lineageId: string): string {
117
53
  return stories.find((story) => story.lineageId === lineageId)?.title ?? lineageId;
118
54
  }
@@ -49,7 +49,11 @@ export type ImageOperationName =
49
49
  | "announcements_release"
50
50
  | "announcements_unlock"
51
51
  | "announcements_correct"
52
+ | "announcements_record_manual"
52
53
  | "announcements_withdraw"
54
+ | "announcements_where"
55
+ | "announcements_recent"
56
+ | "announcements_explain"
53
57
  | "ratings_set"
54
58
  ;
55
59
 
@@ -1293,6 +1297,22 @@ export type AnnouncementsCorrectResult = {
1293
1297
  id: string;
1294
1298
  };
1295
1299
 
1300
+ /** Record the address of a post a person made by hand for a manual Delivery: the Delivery becomes sent and its attempt names that person. */
1301
+ export type AnnouncementsRecordManualInput = {
1302
+ /** The Delivery's id. */
1303
+ delivery: string;
1304
+ /** The address of the post, an http or https URL. */
1305
+ url: string;
1306
+ };
1307
+
1308
+ export type AnnouncementsRecordManualResult = {
1309
+ id: string;
1310
+ state: string;
1311
+ resultUrl: string;
1312
+ /** The attempt that was written: number, at, outcome, by and url. */
1313
+ attempt: Record<string, unknown>;
1314
+ };
1315
+
1296
1316
  /** Withdraw a Delivery that went: this deletes a public post. */
1297
1317
  export type AnnouncementsWithdrawInput = {
1298
1318
  /** The Delivery's id. */
@@ -1303,6 +1323,188 @@ export type AnnouncementsWithdrawResult = {
1303
1323
  id: string;
1304
1324
  };
1305
1325
 
1326
+ /** Where a Story was announced: each Announcement that announces it, with one line for each live Delivery. */
1327
+ export type AnnouncementsWhereInput = {
1328
+ /** The lineage id of the Story. */
1329
+ story: string;
1330
+ };
1331
+
1332
+ export type AnnouncementsWhereResult = {
1333
+ story: string;
1334
+ announcements: ({
1335
+ id: string;
1336
+ kind: string;
1337
+ state: string;
1338
+ releaseAt: string;
1339
+ trigger?: string | null;
1340
+ createdBy?: string | null;
1341
+ /** The version of the Story the Announcement looked at. */
1342
+ versionLookedAt?: number | null;
1343
+ /** The one open review flag for a blocked draft, once for each Announcement: id, words, mark, reason and ask. */
1344
+ reviewFlag?: Record<string, unknown> | null;
1345
+ /** One line for each live Delivery, in channel order. */
1346
+ deliveries: ({
1347
+ /** The Delivery's id. */
1348
+ id: string;
1349
+ announcementId: string;
1350
+ channel: string;
1351
+ accountId: string;
1352
+ generation?: number;
1353
+ /** The Delivery's state. */
1354
+ state: string;
1355
+ /** The state in words, such as Sent or Blocked: check failed. */
1356
+ words: string;
1357
+ /** The Lucide icon of the state. */
1358
+ mark: string;
1359
+ /** The review in words and a mark: words, mark and approval (none, soft or hard). Null for a Delivery that will not go. */
1360
+ approval?: Record<string, unknown> | null;
1361
+ releaseAt?: string | null;
1362
+ lockAt?: string | null;
1363
+ /** The earliest time it is still waiting for. */
1364
+ dueAt?: string | null;
1365
+ waitingFor?: string | null;
1366
+ nextAttemptAt?: string | null;
1367
+ blockedReason?: string | null;
1368
+ /** How many attempts were opened. */
1369
+ attempts: number;
1370
+ /** The last attempt: number, at, outcome, code, words and mark. */
1371
+ lastAttempt?: Record<string, unknown> | null;
1372
+ resultUrl?: string | null;
1373
+ /** What needs a person's eye: Overdue (due, with no attempt), Outcome unknown (an attempt with no answer yet, until Caducus settles it), or a failed check. */
1374
+ attention: ({
1375
+ kind: "overdue" | "outcome_unknown" | "check_failed";
1376
+ words: string;
1377
+ mark: string;
1378
+ /** When it began, as a UTC time. */
1379
+ since?: string;
1380
+ })[];
1381
+ })[];
1382
+ /** In the list: the Stories it is about, each with lineageId and title. */
1383
+ stories?: Record<string, unknown>[];
1384
+ })[];
1385
+ };
1386
+
1387
+ /** The Announcements list: Announcements newest first, one line for each live Delivery, and every Delivery that is overdue. */
1388
+ export type AnnouncementsRecentInput = {
1389
+ /** The size of a page; 25 when left out. A page never splits Announcements released at the same moment. */
1390
+ limit?: number;
1391
+ /** The next value of the last page: shows the Announcements released before that time. */
1392
+ before?: string;
1393
+ };
1394
+
1395
+ export type AnnouncementsRecentResult = {
1396
+ announcements: ({
1397
+ id: string;
1398
+ kind: string;
1399
+ state: string;
1400
+ releaseAt: string;
1401
+ trigger?: string | null;
1402
+ createdBy?: string | null;
1403
+ /** The version of the Story the Announcement looked at. */
1404
+ versionLookedAt?: number | null;
1405
+ /** The one open review flag for a blocked draft, once for each Announcement: id, words, mark, reason and ask. */
1406
+ reviewFlag?: Record<string, unknown> | null;
1407
+ /** One line for each live Delivery, in channel order. */
1408
+ deliveries: ({
1409
+ /** The Delivery's id. */
1410
+ id: string;
1411
+ announcementId: string;
1412
+ channel: string;
1413
+ accountId: string;
1414
+ generation?: number;
1415
+ /** The Delivery's state. */
1416
+ state: string;
1417
+ /** The state in words, such as Sent or Blocked: check failed. */
1418
+ words: string;
1419
+ /** The Lucide icon of the state. */
1420
+ mark: string;
1421
+ /** The review in words and a mark: words, mark and approval (none, soft or hard). Null for a Delivery that will not go. */
1422
+ approval?: Record<string, unknown> | null;
1423
+ releaseAt?: string | null;
1424
+ lockAt?: string | null;
1425
+ /** The earliest time it is still waiting for. */
1426
+ dueAt?: string | null;
1427
+ waitingFor?: string | null;
1428
+ nextAttemptAt?: string | null;
1429
+ blockedReason?: string | null;
1430
+ /** How many attempts were opened. */
1431
+ attempts: number;
1432
+ /** The last attempt: number, at, outcome, code, words and mark. */
1433
+ lastAttempt?: Record<string, unknown> | null;
1434
+ resultUrl?: string | null;
1435
+ /** What needs a person's eye: Overdue (due, with no attempt), Outcome unknown (an attempt with no answer yet, until Caducus settles it), or a failed check. */
1436
+ attention: ({
1437
+ kind: "overdue" | "outcome_unknown" | "check_failed";
1438
+ words: string;
1439
+ mark: string;
1440
+ /** When it began, as a UTC time. */
1441
+ since?: string;
1442
+ })[];
1443
+ })[];
1444
+ /** In the list: the Stories it is about, each with lineageId and title. */
1445
+ stories?: Record<string, unknown>[];
1446
+ })[];
1447
+ /** Every Delivery that is due and has no attempt, read from the sparse due index. */
1448
+ overdue: ({
1449
+ /** The Delivery's id. */
1450
+ id: string;
1451
+ announcementId: string;
1452
+ channel: string;
1453
+ accountId: string;
1454
+ generation?: number;
1455
+ /** The Delivery's state. */
1456
+ state: string;
1457
+ /** The state in words, such as Sent or Blocked: check failed. */
1458
+ words: string;
1459
+ /** The Lucide icon of the state. */
1460
+ mark: string;
1461
+ /** The review in words and a mark: words, mark and approval (none, soft or hard). Null for a Delivery that will not go. */
1462
+ approval?: Record<string, unknown> | null;
1463
+ releaseAt?: string | null;
1464
+ lockAt?: string | null;
1465
+ /** The earliest time it is still waiting for. */
1466
+ dueAt?: string | null;
1467
+ waitingFor?: string | null;
1468
+ nextAttemptAt?: string | null;
1469
+ blockedReason?: string | null;
1470
+ /** How many attempts were opened. */
1471
+ attempts: number;
1472
+ /** The last attempt: number, at, outcome, code, words and mark. */
1473
+ lastAttempt?: Record<string, unknown> | null;
1474
+ resultUrl?: string | null;
1475
+ /** What needs a person's eye: Overdue (due, with no attempt), Outcome unknown (an attempt with no answer yet, until Caducus settles it), or a failed check. */
1476
+ attention: ({
1477
+ kind: "overdue" | "outcome_unknown" | "check_failed";
1478
+ words: string;
1479
+ mark: string;
1480
+ /** When it began, as a UTC time. */
1481
+ since?: string;
1482
+ })[];
1483
+ })[];
1484
+ /** Pass as before for the next page; null on the last page. */
1485
+ next: string | null;
1486
+ };
1487
+
1488
+ /** Why a Story was or was not announced, for each channel, naming the rule. Reads the rules; writes nothing. */
1489
+ export type AnnouncementsExplainInput = {
1490
+ /** The lineage id of the Story. */
1491
+ story: string;
1492
+ };
1493
+
1494
+ export type AnnouncementsExplainResult = {
1495
+ story: string;
1496
+ title?: string;
1497
+ stars?: number;
1498
+ channels: {
1499
+ channel: string;
1500
+ announced: boolean;
1501
+ /** The rule: announced, off, not_published, type_not_announced, section_not_announced, below_bar, below_floor, machine_five, story_not_reviewed, no_delivery or would_announce. */
1502
+ rule: string;
1503
+ words: string;
1504
+ delivery?: string;
1505
+ }[];
1506
+ };
1507
+
1306
1508
  /** Give a Story a star rating, 1 to 5. An agent may give only three or four stars, and only to a Story nobody has rated. */
1307
1509
  export type RatingsSetInput = {
1308
1510
  /** The lineage id of the Story. */
@@ -1366,7 +1568,11 @@ export interface ImageOperations {
1366
1568
  announcements_release: { input: AnnouncementsReleaseInput; result: AnnouncementsReleaseResult };
1367
1569
  announcements_unlock: { input: AnnouncementsUnlockInput; result: AnnouncementsUnlockResult };
1368
1570
  announcements_correct: { input: AnnouncementsCorrectInput; result: AnnouncementsCorrectResult };
1571
+ announcements_record_manual: { input: AnnouncementsRecordManualInput; result: AnnouncementsRecordManualResult };
1369
1572
  announcements_withdraw: { input: AnnouncementsWithdrawInput; result: AnnouncementsWithdrawResult };
1573
+ announcements_where: { input: AnnouncementsWhereInput; result: AnnouncementsWhereResult };
1574
+ announcements_recent: { input: AnnouncementsRecentInput; result: AnnouncementsRecentResult };
1575
+ announcements_explain: { input: AnnouncementsExplainInput; result: AnnouncementsExplainResult };
1370
1576
  ratings_set: { input: RatingsSetInput; result: RatingsSetResult };
1371
1577
  }
1372
1578
 
@@ -1418,7 +1624,11 @@ export const IMAGE_OPERATIONS = {
1418
1624
  announcements_release: { effect: "write", agentAllowed: true, agentRung: "publish_auto", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements release" },
1419
1625
  announcements_unlock: { effect: "write", agentAllowed: false, agentRung: "person", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements unlock" },
1420
1626
  announcements_correct: { effect: "write", agentAllowed: true, agentRung: "prepare", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements correct" },
1627
+ announcements_record_manual: { effect: "write", agentAllowed: false, agentRung: "person", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements record-manual" },
1421
1628
  announcements_withdraw: { effect: "write", agentAllowed: false, agentRung: "person", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements withdraw" },
1629
+ announcements_where: { effect: "read", agentAllowed: true, agentRung: "observe", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements where" },
1630
+ announcements_recent: { effect: "read", agentAllowed: true, agentRung: "observe", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements recent" },
1631
+ announcements_explain: { effect: "read", agentAllowed: true, agentRung: "observe", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements explain" },
1422
1632
  ratings_set: { effect: "write", agentAllowed: true, agentRung: "draft", agentRefusal: "human_required", group: "ratings", command: "papyrus ratings set" },
1423
1633
  } as const;
1424
1634
 
@@ -11,6 +11,8 @@ import {
11
11
  createStoryFromReference,
12
12
  type ContentActionError,
13
13
  } from "./content-actions-client";
14
+ import type { AnnouncementsDoor } from "./announcement-lines";
15
+ import { announcementsDoor } from "./announcements-door-client";
14
16
  import { createDemoArticlesBackend } from "./content-actions-demo";
15
17
  import { UNTYPED_ITEM_TYPE } from "./content-item-lifecycle";
16
18
  import { ALWAYS_PROJECTED, typeForNewStory, siteStoryTypes } from "./site-story-types";
@@ -111,6 +113,8 @@ export type ArticlesBackend = {
111
113
  };
112
114
  listRows: () => Promise<NewsroomArticleRow[]>;
113
115
  loadArticle: (id: string) => Promise<EditableArticle>;
116
+ /** The announcements door (reads only): where the Story was announced, one line for each Delivery. */
117
+ announcementsDoor: AnnouncementsDoor;
114
118
  };
115
119
 
116
120
  export function slugify(value: string): string {
@@ -350,6 +354,7 @@ export function createLiveArticlesBackend(): ArticlesBackend {
350
354
  actions: { deriveMarkus, saveItemDraft, publishItem, unpublishItem, moveStoryStage, scheduleStory, scheduleList, createStoryFromReference, setItemStars },
351
355
  listRows: () => loadArticleRows(dataClient()),
352
356
  loadArticle: (id) => loadEditableArticle(dataClient(), id),
357
+ announcementsDoor,
353
358
  };
354
359
  }
355
360
 
@@ -48,5 +48,12 @@ export const FIXTURE_TODAY: TodayOverview = {
48
48
  { automationId: "digest.weekly", title: "Weekly digest", state: "Did not run", whyCode: "disabled", why: "Disabled: the router starts nothing for a disabled automation" },
49
49
  { automationId: "newsletter.daily", title: "Daily summary", state: "Did not run", whyCode: "no_wake", why: "Nothing woke it today" },
50
50
  ],
51
+ sends: [
52
+ {
53
+ deliveryId: "announcement-weekly#email#site#g1", announcementId: "announcement-weekly", kind: "roundup", releasedAt: "2026-11-16T13:00:00Z", lists: ["weekly"], items: 5,
54
+ state: "sent", stateShown: "✓ Sent", stateWords: "Sent", attempts: 1, lastAttempt: "sent",
55
+ counts: { queued: 0, sent: 12, failed: 0, suppressed: 1, skipped: 2, delivered: 11, bounced: 1, complained: 0 }, countsText: "12 sent, 1 suppressed, 2 skipped, 11 delivered, 1 bounced", cost: null,
56
+ },
57
+ ],
51
58
  totals: { runs: 15, counts: { ...none, acted: 8, nothing: 4, asked: 1, failed: 1, unknown: 1 }, costUsd: 0.43, costKnownRuns: 14, costUnknownRuns: 1 },
52
59
  };
@@ -39,6 +39,29 @@ export type TodayRow = TodayCosts & {
39
39
 
40
40
  export type TodayDidNotRun = { automationId: string; title: string; state: "Did not run"; whyCode: "disabled" | "unsupported" | "no_wake"; why: string };
41
41
 
42
+ export type TodaySendCounts = Record<"queued" | "sent" | "failed" | "suppressed" | "skipped" | "delivered" | "bounced" | "complained", number>;
43
+
44
+ /** One email send: an email Delivery of an Announcement released in the day, with the counts Caducus's records add up to. */
45
+ export type TodaySend = {
46
+ deliveryId: string;
47
+ announcementId: string;
48
+ kind: string;
49
+ releasedAt: string;
50
+ lists: string[];
51
+ items: number;
52
+ state: string;
53
+ /** Where the send stands as a mark and its words, as the command line prints it. */
54
+ stateShown: string;
55
+ /** The same words without the mark: the page draws its own mark (a Lucide icon). */
56
+ stateWords: string;
57
+ attempts: number;
58
+ lastAttempt: string | null;
59
+ counts: TodaySendCounts;
60
+ countsText: string;
61
+ /** What Caducus charged, a decimal string, or null when nothing was charged. */
62
+ cost: string | null;
63
+ };
64
+
42
65
  export type TodayOverview = {
43
66
  state: "ready";
44
67
  asOf: string;
@@ -48,6 +71,7 @@ export type TodayOverview = {
48
71
  end: string;
49
72
  rows: TodayRow[];
50
73
  didNotRun: TodayDidNotRun[];
74
+ sends: TodaySend[];
51
75
  totals: TodayCosts & { runs: number; counts: TodayCounts };
52
76
  };
53
77
 
@@ -65,6 +89,22 @@ export const OTHER_WORDS: Record<"notFinished" | "beforeOutcomes", string> = {
65
89
  notFinished: "Not finished yet",
66
90
  beforeOutcomes: "Recorded before outcomes",
67
91
  };
92
+ /** The words of each send count, in the order a send lists them. A count of zero is left out; a send with none says so. */
93
+ export const SEND_COUNT_WORDS: Record<keyof TodaySendCounts, string> = {
94
+ queued: "Queued", sent: "Sent", failed: "Failed", suppressed: "Suppressed", skipped: "Skipped", delivered: "Delivered", bounced: "Bounced", complained: "Complained",
95
+ };
96
+ export const SEND_COUNT_ORDER = Object.keys(SEND_COUNT_WORDS) as (keyof TodaySendCounts)[];
97
+
98
+ export const NO_SEND_COST = "no cost recorded";
99
+
100
+ export function sendCostText(cost: string | null): string {
101
+ return cost === null ? NO_SEND_COST : dollars(Number(cost));
102
+ }
103
+
104
+ export function sendItemsText(items: number): string {
105
+ return `${items} item${items === 1 ? "" : "s"}`;
106
+ }
107
+
68
108
  export const OUTCOME_ORDER: TodayOutcome[] = ["acted", "nothing", "asked", "failed", "unknown"];
69
109
  export const OTHER_ORDER: ("notFinished" | "beforeOutcomes")[] = ["notFinished", "beforeOutcomes"];
70
110
 
package/package.json CHANGED
@@ -72,6 +72,8 @@
72
72
  "./components/ai-elements/suggestion": "./components/ai-elements/suggestion.tsx",
73
73
  "./components/ai-elements/tool": "./components/ai-elements/tool.tsx",
74
74
  "./components/amplify-client-provider": "./components/amplify-client-provider.tsx",
75
+ "./components/announcement-lines": "./components/announcement-lines.tsx",
76
+ "./components/announcement-marks": "./components/announcement-marks.tsx",
75
77
  "./components/announcements-panel": "./components/announcements-panel.tsx",
76
78
  "./components/archive-grid": "./components/archive-grid.tsx",
77
79
  "./components/archive-shell": "./components/archive-shell.tsx",
@@ -262,8 +264,10 @@
262
264
  "./lib/amplify-outputs-guard": "./lib/amplify-outputs-guard.ts",
263
265
  "./lib/amplify-outputs-path": "./lib/amplify-outputs-path.ts",
264
266
  "./lib/amplify-server-runtime": "./lib/amplify-server-runtime.ts",
267
+ "./lib/announcement-lines": "./lib/announcement-lines.ts",
265
268
  "./lib/announcements-client": "./lib/announcements-client.ts",
266
- "./lib/announcements-data": "./lib/announcements-data.ts",
269
+ "./lib/announcements-demo": "./lib/announcements-demo.ts",
270
+ "./lib/announcements-door-client": "./lib/announcements-door-client.ts",
267
271
  "./lib/announcements-fixture": "./lib/announcements-fixture.ts",
268
272
  "./lib/announcements-model": "./lib/announcements-model.ts",
269
273
  "./lib/approved-priming-proof-reports": "./lib/approved-priming-proof-reports.ts",
@@ -328,6 +332,7 @@
328
332
  "./lib/front-mosaic": "./lib/front-mosaic.ts",
329
333
  "./lib/furniture": "./lib/furniture.ts",
330
334
  "./lib/graphql-content-repository": "./lib/graphql-content-repository.ts",
335
+ "./lib/guidelines/guideline-files": "./lib/guidelines/guideline-files.ts",
331
336
  "./lib/guidelines/guidelines-door-client": "./lib/guidelines/guidelines-door-client.ts",
332
337
  "./lib/guidelines/writing-guidelines-admin": "./lib/guidelines/writing-guidelines-admin.ts",
333
338
  "./lib/hosted-cyclotron-status": "./lib/hosted-cyclotron-status.ts",
@@ -645,7 +650,7 @@
645
650
  "optional": true
646
651
  }
647
652
  },
648
- "version": "5.131.0-next.2",
653
+ "version": "5.131.0-next.3",
649
654
  "dependencies": {
650
655
  "@aws-amplify/adapter-nextjs": "^1.7.3",
651
656
  "@aws-crypto/sha256-js": "5.2.0",
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "5.131.0-next.2",
2
+ "version": "5.131.0-next.3",
3
3
  "routes": [
4
4
  {
5
5
  "file": "app/%5F_preview/[[...path]]/route.ts",
@@ -1,21 +0,0 @@
1
- import type { AnnouncementRow } from "./announcements-model";
2
-
3
- /** The announcement backend (PPY-9f4d66) is not in this repository's data API yet. */
4
- export class AnnouncementsBackendNotDeployed extends Error {
5
- constructor() {
6
- super("The announcement list needs the announcement backend (PPY-9f4d66), which is not deployed on this site yet.");
7
- }
8
- }
9
-
10
- export type AnnouncementsSource = { list: () => Promise<AnnouncementRow[]> };
11
-
12
- /**
13
- * STUB, named on purpose: the data layer for the dry-run preview and the audit list. When PPY-9f4d66 lands, replace this
14
- * with the operation behind `papyrus announcements list` (rows carry the Story, state, exact text, link, post id, cost
15
- * and error, per the plan's audit trail). Until then it fails clearly and the page says so; it never invents rows.
16
- */
17
- export const announcementsSource: AnnouncementsSource = {
18
- async list() {
19
- throw new AnnouncementsBackendNotDeployed();
20
- },
21
- };