feat: more automated announcements (#8)

### Explanation Makes my life so much easier. ### Issue _No response_ ### Attestations - [x] I have read and agree to the [Code of Conduct](https://docs.nhcarrigan.com/community/coc/) - [x] I have read and agree to the [Community Guidelines](https://docs.nhcarrigan.com/community/guide/). - [x] My contribution complies with the [Contributor Covenant](https://docs.nhcarrigan.com/dev/covenant/). ### Dependencies - [x] I have pinned the dependencies to a specific patch version. ### Style - [x] I have run the linter and resolved any errors. - [x] My pull request uses an appropriate title, matching the conventional commit standards. - [x] My scope of feat/fix/chore/etc. correctly matches the nature of changes in my pull request. ### Tests - [ ] My contribution adds new code, and I have added tests to cover it. - [ ] My contribution modifies existing code, and I have updated the tests to reflect these changes. - [ ] All new and existing tests pass locally with my changes. - [ ] Code coverage remains at or above the configured threshold. ### Documentation _No response_ ### Versioning Minor - My pull request introduces a new non-breaking feature. Reviewed-on: #8 Co-authored-by: Naomi Carrigan <commits@nhcarrigan.com> Co-committed-by: Naomi Carrigan <commits@nhcarrigan.com>
2026-01-08 18:07:28 -08:00
parent e462c9472d
commit 922dee415a
25 changed files with 2553 additions and 179 deletions
@@ -0,0 +1,63 @@
+/**
+ * @copyright nhcarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+// eslint-disable-next-line @typescript-eslint/naming-convention -- 'Tis a class.
+import Anthropic from "@anthropic-ai/sdk";
+import {
+  announcementJsonSchema,
+  announcementSystemMessage,
+} from "../config/announcements.js";
+import { getAiCost } from "../utils/getAiCost.js";
+import type { AnnouncementResponse }
+  from "../interfaces/announcementResponse.js";
+
+/**
+ * Generates announcements for all platforms using AI.
+ * @param content - The main body of the announcement.
+ * @returns The announcements for all platforms, or null if the request fails.
+ */
+export const generateAnnouncements = async(
+  content: string,
+): Promise<{ cost: string; response: AnnouncementResponse } | null> => {
+  if (process.env.ANTHROPIC_KEY === undefined) {
+    return null;
+  }
+  const anthropic = new Anthropic({
+    apiKey:  process.env.ANTHROPIC_KEY,
+    timeout: 5 * 60 * 1000,
+  });
+  const response = await anthropic.beta.messages.create({
+    betas:      [ "structured-outputs-2025-11-13" ],
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- API requirement
+    max_tokens: 10_000,
+    messages:   [
+      {
+        content: content,
+        role:    "user",
+      },
+    ],
+    model:         "claude-opus-4-5-20251101",
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- API requirement
+    output_format: {
+      schema: announcementJsonSchema,
+      type:   "json_schema",
+    },
+    system: announcementSystemMessage,
+  });
+  const { usage, content: responseContent } = response;
+  const text = responseContent.find((m) => {
+    return m.type === "text";
+  });
+  if (text?.text === undefined) {
+    return null;
+  }
+
+  return {
+    cost:     getAiCost(usage),
+    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Being lazy.
+    response: JSON.parse(text.text) as AnnouncementResponse,
+  };
+};