@aglyn/plugins-ai 1.0.0-beta.231 → 1.0.0-beta.232

package/src/lib/tools/ai-blog-post-tool.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @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 { AiTool } from '../providers/contract';
+import type { AiGenerationCheckResult } from '../runtime/ai-doctrine';
+/**
+ * The strict tool a site's first posts are written through (AGL-3676), and
+ * the check that holds each post to what the site's collection publishes.
+ *
+ * A post is published with the site, as its own words, so nothing in it may
+ * mark a gap for later: no square brackets, no link, no markup the entry
+ * renderer does not read. Its body is the markdown-lite the entry editor
+ * writes — `##` subheadings, `-` lists, `**bold**`, `*italic*` — and its
+ * title, excerpt and search description are plain text. The storefront copy
+ * rules hold every part (no health, financial or legal promise; no
+ * certification, award or endorsement the brief does not state; no price),
+ * and so does a rule of its own: no star rating, review score or testimonial
+ * nobody gave.
+ */
+export declare const AI_BLOG_POST_TOOL_NAME = "write_blog_post";
+/** A post's bounds, as the tool states them and its check holds them. */
+export declare const AI_BLOG_POST_LIMITS: {
+    readonly titleMax: 80;
+    readonly excerptMax: 200;
+    readonly bodyMin: 600;
+    readonly bodyMax: 4000;
+    readonly seoDescriptionMax: number;
+};
+/** A post as its check reads it. */
+export interface AiBlogPost {
+    title: string;
+    excerpt: string;
+    /** Markdown-lite. */
+    body: string;
+    seoDescription: string;
+}
+export declare const AI_BLOG_POST_TOOL: AiTool;
+/**
+ * A post's answer held to the collection it is published in and the copy
+ * rules. `merchantWords` are the brief and the site's own answers, the only
+ * source a stated claim or price may come from; `earlierTitles` are the posts
+ * already written, which this one must not repeat.
+ */
+export declare function checkAiBlogPost(answer: Record<string, unknown>, context: {
+    merchantWords: string;
+    earlierTitles?: readonly string[];
+}): AiGenerationCheckResult<AiBlogPost>;

package/src/lib/tools/ai-blog-post-tool.js

@@ -0,0 +1,175 @@
+/**
+ * @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 { SEO_LISTING_FIELDS } from "@aglyn/aglyn/app-utils/seo-listing-fields";
+import { findInventedPrices, findStorefrontClaims, storefrontClaimViolations } from "../model/ai-storefront-claims.js";
+import { detectOffVoiceCopy } from "../runtime/ai-doctrine-validators.js";
+/**
+ * The strict tool a site's first posts are written through (AGL-3676), and
+ * the check that holds each post to what the site's collection publishes.
+ *
+ * A post is published with the site, as its own words, so nothing in it may
+ * mark a gap for later: no square brackets, no link, no markup the entry
+ * renderer does not read. Its body is the markdown-lite the entry editor
+ * writes — `##` subheadings, `-` lists, `**bold**`, `*italic*` — and its
+ * title, excerpt and search description are plain text. The storefront copy
+ * rules hold every part (no health, financial or legal promise; no
+ * certification, award or endorsement the brief does not state; no price),
+ * and so does a rule of its own: no star rating, review score or testimonial
+ * nobody gave.
+ */ export const AI_BLOG_POST_TOOL_NAME = 'write_blog_post';
+/** A post's bounds, as the tool states them and its check holds them. */ export const AI_BLOG_POST_LIMITS = {
+    titleMax: 80,
+    excerptMax: 200,
+    bodyMin: 600,
+    bodyMax: 4000,
+    seoDescriptionMax: SEO_LISTING_FIELDS.description.maxLength
+};
+const string = (description)=>({
+        type: 'string',
+        description
+    });
+export const AI_BLOG_POST_TOOL = {
+    name: AI_BLOG_POST_TOOL_NAME,
+    description: 'Write one post of a new blog. Every field is required.',
+    strict: true,
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        required: [
+            'title',
+            'excerpt',
+            'body',
+            'seoDescription'
+        ],
+        properties: {
+            title: string(`Plain text, at most ${AI_BLOG_POST_LIMITS.titleMax} characters.`),
+            excerpt: string(`One or two plain sentences, at most ${AI_BLOG_POST_LIMITS.excerptMax} characters.`),
+            body: string(`Markdown-lite, ${AI_BLOG_POST_LIMITS.bodyMin} to ${AI_BLOG_POST_LIMITS.bodyMax} characters: short paragraphs, ## subheadings, - lists, **bold**. No title line.`),
+            seoDescription: string(`One plain sentence, at most ${AI_BLOG_POST_LIMITS.seoDescriptionMax} characters.`)
+        }
+    }
+};
+function fail(findings, at, code, message, value) {
+    findings.violations.push({
+        rule: null,
+        code,
+        message,
+        paths: [
+            at
+        ]
+    });
+    if (!(at in findings.offending)) findings.offending[at] = value;
+}
+const line = (value)=>typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '';
+/** Paragraphs: spaces folded within a line, at most one blank line between paragraphs. */ const paragraphs = (value)=>typeof value === 'string' ? value.replace(/\r\n?/g, '\n').split('\n').map((part)=>part.replace(/[ \t\f\v]+/g, ' ').trimEnd()).join('\n').replace(/\n{3,}/g, '\n\n').trim() : '';
+const HTML = /<\/?[a-z][^>]*>/i;
+const PLAIN_MARKS = /(^|\n)\s*#{1,6}\s|\*\*[^*\n]+\*\*|__[^_\n]+__|`/;
+const EMOJI = RegExp("[\\u00A9\\u00AE\\u203C\\u2049\\u2122\\u2139\\u2194-\\u2199\\u21A9-\\u21AA\\u231A-\\u231B\\u2328\\u23CF\\u23E9-\\u23F3\\u23F8-\\u23FA\\u24C2\\u25AA-\\u25AB\\u25B6\\u25C0\\u25FB-\\u25FE\\u2600-\\u2604\\u260E\\u2611\\u2614-\\u2615\\u2618\\u261D\\u2620\\u2622-\\u2623\\u2626\\u262A\\u262E-\\u262F\\u2638-\\u263A\\u2640\\u2642\\u2648-\\u2653\\u265F-\\u2660\\u2663\\u2665-\\u2666\\u2668\\u267B\\u267E-\\u267F\\u2692-\\u2697\\u2699\\u269B-\\u269C\\u26A0-\\u26A1\\u26A7\\u26AA-\\u26AB\\u26B0-\\u26B1\\u26BD-\\u26BE\\u26C4-\\u26C5\\u26C8\\u26CE-\\u26CF\\u26D1\\u26D3-\\u26D4\\u26E9-\\u26EA\\u26F0-\\u26F5\\u26F7-\\u26FA\\u26FD\\u2702\\u2705\\u2708-\\u270D\\u270F\\u2712\\u2714\\u2716\\u271D\\u2721\\u2728\\u2733-\\u2734\\u2744\\u2747\\u274C\\u274E\\u2753-\\u2755\\u2757\\u2763-\\u2764\\u2795-\\u2797\\u27A1\\u27B0\\u27BF\\u2934-\\u2935\\u2B05-\\u2B07\\u2B1B-\\u2B1C\\u2B50\\u2B55\\u3030\\u303D\\u3297\\u3299\\u{1F004}\\u{1F02C}-\\u{1F02F}\\u{1F094}-\\u{1F09F}\\u{1F0AF}-\\u{1F0B0}\\u{1F0C0}\\u{1F0CF}-\\u{1F0D0}\\u{1F0F6}-\\u{1F0FF}\\u{1F170}-\\u{1F171}\\u{1F17E}-\\u{1F17F}\\u{1F18E}\\u{1F191}-\\u{1F19A}\\u{1F1AE}-\\u{1F1E5}\\u{1F201}-\\u{1F20F}\\u{1F21A}\\u{1F22F}\\u{1F232}-\\u{1F23A}\\u{1F23C}-\\u{1F23F}\\u{1F249}-\\u{1F25F}\\u{1F266}-\\u{1F321}\\u{1F324}-\\u{1F393}\\u{1F396}-\\u{1F397}\\u{1F399}-\\u{1F39B}\\u{1F39E}-\\u{1F3F0}\\u{1F3F3}-\\u{1F3F5}\\u{1F3F7}-\\u{1F3FA}\\u{1F400}-\\u{1F4FD}\\u{1F4FF}-\\u{1F53D}\\u{1F549}-\\u{1F54E}\\u{1F550}-\\u{1F567}\\u{1F56F}-\\u{1F570}\\u{1F573}-\\u{1F57A}\\u{1F587}\\u{1F58A}-\\u{1F58D}\\u{1F590}\\u{1F595}-\\u{1F596}\\u{1F5A4}-\\u{1F5A5}\\u{1F5A8}\\u{1F5B1}-\\u{1F5B2}\\u{1F5BC}\\u{1F5C2}-\\u{1F5C4}\\u{1F5D1}-\\u{1F5D3}\\u{1F5DC}-\\u{1F5DE}\\u{1F5E1}\\u{1F5E3}\\u{1F5E8}\\u{1F5EF}\\u{1F5F3}\\u{1F5FA}-\\u{1F64F}\\u{1F680}-\\u{1F6C5}\\u{1F6CB}-\\u{1F6D2}\\u{1F6D5}-\\u{1F6E5}\\u{1F6E9}\\u{1F6EB}-\\u{1F6F0}\\u{1F6F3}-\\u{1F6FF}\\u{1F7DA}-\\u{1F7FF}\\u{1F80C}-\\u{1F80F}\\u{1F848}-\\u{1F84F}\\u{1F85A}-\\u{1F85F}\\u{1F888}-\\u{1F88F}\\u{1F8AE}-\\u{1F8AF}\\u{1F8BC}-\\u{1F8BF}\\u{1F8C2}-\\u{1F8CF}\\u{1F8D9}-\\u{1F8FF}\\u{1F90C}-\\u{1F93A}\\u{1F93C}-\\u{1F945}\\u{1F947}-\\u{1F9FF}\\u{1FA58}-\\u{1FA5F}\\u{1FA6E}-\\u{1FAFF}\\u{1FC00}-\\u{1FFFD}]", "u");
+const BRACKET = /[[\]]/;
+const URL = /\bhttps?:\/\/|\bwww\./i;
+/** A heading deeper than the entry renderer's subheadings, or a title line. */ const TITLE_HEADING = /(^|\n)\s*#\s/;
+/** A rating or review score nobody gave. */ const RATING = /\b\d(?:\.\d)?\s*(?:\/\s*(?:5|10)\b|out of (?:5|five|10|ten)\b|stars?\b)|\b(?:five|5|four|4)[- ]star\b|\brated\b|\breviews? (?:say|rave|agree)\b/i;
+/** One plain-text field: there, within its length, unmarked. */ function checkPlain(findings, at, raw, label, max) {
+    if (typeof raw !== 'string') {
+        fail(findings, at, 'type', `${label} must be text.`, raw);
+        return '';
+    }
+    const value = line(raw);
+    if (!value) {
+        fail(findings, at, 'missing', `${label} is required.`, raw);
+        return '';
+    }
+    if (value.length > max) fail(findings, at, 'too-long', `${label} is ${value.length} characters; it may have ${max}.`, raw);
+    if (HTML.test(value) || PLAIN_MARKS.test(value)) fail(findings, at, 'markup', `${label} is plain text, with no formatting marks.`, raw);
+    if (EMOJI.test(value)) fail(findings, at, 'emoji', `${label} holds no emoji.`, raw);
+    if (URL.test(value)) fail(findings, at, 'link', `${label} holds no link.`, raw);
+    if (BRACKET.test(value)) {
+        fail(findings, at, 'bracket', `${label} is published as written, so it marks no missing fact in brackets.`, raw);
+    }
+    return value;
+}
+/**
+ * A post's answer held to the collection it is published in and the copy
+ * rules. `merchantWords` are the brief and the site's own answers, the only
+ * source a stated claim or price may come from; `earlierTitles` are the posts
+ * already written, which this one must not repeat.
+ */ export function checkAiBlogPost(answer, context) {
+    var _context_earlierTitles;
+    const findings = {
+        violations: [],
+        offending: {}
+    };
+    const limits = AI_BLOG_POST_LIMITS;
+    const title = checkPlain(findings, 'title', answer['title'], 'The title', limits.titleMax);
+    if (title && ((_context_earlierTitles = context.earlierTitles) != null ? _context_earlierTitles : []).some((earlier)=>earlier.trim().toLowerCase() === title.toLowerCase())) {
+        fail(findings, 'title', 'title-duplicate', 'Another post already has this title; write about something else.', answer['title']);
+    }
+    const excerpt = checkPlain(findings, 'excerpt', answer['excerpt'], 'The excerpt', limits.excerptMax);
+    const seoDescription = checkPlain(findings, 'seoDescription', answer['seoDescription'], 'The search description', limits.seoDescriptionMax);
+    const raw = answer['body'];
+    const body = paragraphs(raw);
+    if (typeof raw !== 'string' || !body) {
+        fail(findings, 'body', 'missing', 'The body is required.', raw);
+    } else {
+        if (body.length < limits.bodyMin || body.length > limits.bodyMax) {
+            fail(findings, 'body', 'length', `The body is ${body.length} characters; write ${limits.bodyMin} to ${limits.bodyMax}.`, raw);
+        }
+        if (HTML.test(body)) fail(findings, 'body', 'markup', 'The body is markdown-lite, with no HTML.', raw);
+        if (TITLE_HEADING.test(body)) fail(findings, 'body', 'title-line', 'The title renders on its own; the body uses ## subheadings only.', raw);
+        if (EMOJI.test(body)) fail(findings, 'body', 'emoji', 'The body holds no emoji.', raw);
+        if (URL.test(body)) fail(findings, 'body', 'link', 'The body holds no link.', raw);
+        if (BRACKET.test(body)) {
+            fail(findings, 'body', 'bracket', 'The body is published as written, so it holds no square brackets: no links and no missing fact marked.', raw);
+        }
+    }
+    const samples = [
+        {
+            at: 'title',
+            text: title
+        },
+        {
+            at: 'excerpt',
+            text: excerpt
+        },
+        {
+            at: 'body',
+            text: body
+        },
+        {
+            at: 'seoDescription',
+            text: seoDescription
+        }
+    ];
+    for (const sample of samples){
+        const rating = RATING.exec(sample.text);
+        if (rating && !context.merchantWords.toLowerCase().includes(rating[0].toLowerCase())) {
+            fail(findings, sample.at, 'rating-invented', `The post gives a rating or review nobody gave. Remove: "${rating[0]}".`, sample.text);
+        }
+    }
+    findings.violations.push(...storefrontClaimViolations(findStorefrontClaims(samples, context.merchantWords), findInventedPrices(samples, context.merchantWords)), ...detectOffVoiceCopy(samples, null));
+    return {
+        value: findings.violations.length ? null : {
+            title,
+            excerpt,
+            body,
+            seoDescription
+        },
+        violations: findings.violations,
+        offending: findings.offending
+    };
+}
+
+//# sourceMappingURL=ai-blog-post-tool.js.map

package/src/lib/tools/ai-blog-post-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/tools/ai-blog-post-tool.ts"],"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\nimport { SEO_LISTING_FIELDS } from '@aglyn/aglyn/app-utils/seo-listing-fields'\nimport {\n  findInventedPrices,\n  findStorefrontClaims,\n  storefrontClaimViolations,\n  type AiStorefrontCopySample,\n} from '../model/ai-storefront-claims'\nimport type { AiTool } from '../providers/contract'\nimport type { AiGenerationCheckResult } from '../runtime/ai-doctrine'\nimport { detectOffVoiceCopy, type AiDoctrineViolation } from '../runtime/ai-doctrine-validators'\n\n/**\n * The strict tool a site's first posts are written through (AGL-3676), and\n * the check that holds each post to what the site's collection publishes.\n *\n * A post is published with the site, as its own words, so nothing in it may\n * mark a gap for later: no square brackets, no link, no markup the entry\n * renderer does not read. Its body is the markdown-lite the entry editor\n * writes — `##` subheadings, `-` lists, `**bold**`, `*italic*` — and its\n * title, excerpt and search description are plain text. The storefront copy\n * rules hold every part (no health, financial or legal promise; no\n * certification, award or endorsement the brief does not state; no price),\n * and so does a rule of its own: no star rating, review score or testimonial\n * nobody gave.\n */\n\nexport const AI_BLOG_POST_TOOL_NAME = 'write_blog_post'\n\n/** A post's bounds, as the tool states them and its check holds them. */\nexport const AI_BLOG_POST_LIMITS = {\n  titleMax: 80,\n  excerptMax: 200,\n  bodyMin: 600,\n  bodyMax: 4_000,\n  seoDescriptionMax: SEO_LISTING_FIELDS.description.maxLength,\n} as const\n\n/** A post as its check reads it. */\nexport interface AiBlogPost {\n  title: string\n  excerpt: string\n  /** Markdown-lite. */\n  body: string\n  seoDescription: string\n}\n\nconst string = (description: string) => ({ type: 'string', description })\n\nexport const AI_BLOG_POST_TOOL: AiTool = {\n  name: AI_BLOG_POST_TOOL_NAME,\n  description: 'Write one post of a new blog. Every field is required.',\n  strict: true,\n  inputSchema: {\n    type: 'object',\n    additionalProperties: false,\n    required: ['title', 'excerpt', 'body', 'seoDescription'],\n    properties: {\n      title: string(`Plain text, at most ${AI_BLOG_POST_LIMITS.titleMax} characters.`),\n      excerpt: string(`One or two plain sentences, at most ${AI_BLOG_POST_LIMITS.excerptMax} characters.`),\n      body: string(\n        `Markdown-lite, ${AI_BLOG_POST_LIMITS.bodyMin} to ${AI_BLOG_POST_LIMITS.bodyMax} characters: short paragraphs, ## subheadings, - lists, **bold**. No title line.`,\n      ),\n      seoDescription: string(`One plain sentence, at most ${AI_BLOG_POST_LIMITS.seoDescriptionMax} characters.`),\n    },\n  },\n}\n\ninterface Findings {\n  violations: AiDoctrineViolation[]\n  offending: Record<string, unknown>\n}\n\nfunction fail(findings: Findings, at: string, code: string, message: string, value: unknown): void {\n  findings.violations.push({ rule: null, code, message, paths: [at] })\n  if (!(at in findings.offending)) findings.offending[at] = value\n}\n\nconst line = (value: unknown): string => (typeof value === 'string' ? value.replace(/\\s+/g, ' ').trim() : '')\n\n/** Paragraphs: spaces folded within a line, at most one blank line between paragraphs. */\nconst paragraphs = (value: unknown): string =>\n  typeof value === 'string'\n    ? value\n        .replace(/\\r\\n?/g, '\\n')\n        .split('\\n')\n        .map((part) => part.replace(/[ \\t\\f\\v]+/g, ' ').trimEnd())\n        .join('\\n')\n        .replace(/\\n{3,}/g, '\\n\\n')\n        .trim()\n    : ''\n\nconst HTML = /<\\/?[a-z][^>]*>/i\nconst PLAIN_MARKS = /(^|\\n)\\s*#{1,6}\\s|\\*\\*[^*\\n]+\\*\\*|__[^_\\n]+__|`/\nconst EMOJI = /\\p{Extended_Pictographic}/u\nconst BRACKET = /[[\\]]/\nconst URL = /\\bhttps?:\\/\\/|\\bwww\\./i\n/** A heading deeper than the entry renderer's subheadings, or a title line. */\nconst TITLE_HEADING = /(^|\\n)\\s*#\\s/\n/** A rating or review score nobody gave. */\nconst RATING = /\\b\\d(?:\\.\\d)?\\s*(?:\\/\\s*(?:5|10)\\b|out of (?:5|five|10|ten)\\b|stars?\\b)|\\b(?:five|5|four|4)[- ]star\\b|\\brated\\b|\\breviews? (?:say|rave|agree)\\b/i\n\n/** One plain-text field: there, within its length, unmarked. */\nfunction checkPlain(findings: Findings, at: string, raw: unknown, label: string, max: number): string {\n  if (typeof raw !== 'string') {\n    fail(findings, at, 'type', `${label} must be text.`, raw)\n    return ''\n  }\n  const value = line(raw)\n  if (!value) {\n    fail(findings, at, 'missing', `${label} is required.`, raw)\n    return ''\n  }\n  if (value.length > max) fail(findings, at, 'too-long', `${label} is ${value.length} characters; it may have ${max}.`, raw)\n  if (HTML.test(value) || PLAIN_MARKS.test(value)) fail(findings, at, 'markup', `${label} is plain text, with no formatting marks.`, raw)\n  if (EMOJI.test(value)) fail(findings, at, 'emoji', `${label} holds no emoji.`, raw)\n  if (URL.test(value)) fail(findings, at, 'link', `${label} holds no link.`, raw)\n  if (BRACKET.test(value)) {\n    fail(findings, at, 'bracket', `${label} is published as written, so it marks no missing fact in brackets.`, raw)\n  }\n  return value\n}\n\n/**\n * A post's answer held to the collection it is published in and the copy\n * rules. `merchantWords` are the brief and the site's own answers, the only\n * source a stated claim or price may come from; `earlierTitles` are the posts\n * already written, which this one must not repeat.\n */\nexport function checkAiBlogPost(\n  answer: Record<string, unknown>,\n  context: { merchantWords: string; earlierTitles?: readonly string[] },\n): AiGenerationCheckResult<AiBlogPost> {\n  const findings: Findings = { violations: [], offending: {} }\n  const limits = AI_BLOG_POST_LIMITS\n  const title = checkPlain(findings, 'title', answer['title'], 'The title', limits.titleMax)\n  if (title && (context.earlierTitles ?? []).some((earlier) => earlier.trim().toLowerCase() === title.toLowerCase())) {\n    fail(findings, 'title', 'title-duplicate', 'Another post already has this title; write about something else.', answer['title'])\n  }\n  const excerpt = checkPlain(findings, 'excerpt', answer['excerpt'], 'The excerpt', limits.excerptMax)\n  const seoDescription = checkPlain(\n    findings,\n    'seoDescription',\n    answer['seoDescription'],\n    'The search description',\n    limits.seoDescriptionMax,\n  )\n  const raw = answer['body']\n  const body = paragraphs(raw)\n  if (typeof raw !== 'string' || !body) {\n    fail(findings, 'body', 'missing', 'The body is required.', raw)\n  } else {\n    if (body.length < limits.bodyMin || body.length > limits.bodyMax) {\n      fail(findings, 'body', 'length', `The body is ${body.length} characters; write ${limits.bodyMin} to ${limits.bodyMax}.`, raw)\n    }\n    if (HTML.test(body)) fail(findings, 'body', 'markup', 'The body is markdown-lite, with no HTML.', raw)\n    if (TITLE_HEADING.test(body)) fail(findings, 'body', 'title-line', 'The title renders on its own; the body uses ## subheadings only.', raw)\n    if (EMOJI.test(body)) fail(findings, 'body', 'emoji', 'The body holds no emoji.', raw)\n    if (URL.test(body)) fail(findings, 'body', 'link', 'The body holds no link.', raw)\n    if (BRACKET.test(body)) {\n      fail(findings, 'body', 'bracket', 'The body is published as written, so it holds no square brackets: no links and no missing fact marked.', raw)\n    }\n  }\n  const samples: AiStorefrontCopySample[] = [\n    { at: 'title', text: title },\n    { at: 'excerpt', text: excerpt },\n    { at: 'body', text: body },\n    { at: 'seoDescription', text: seoDescription },\n  ]\n  for (const sample of samples) {\n    const rating = RATING.exec(sample.text)\n    if (rating && !context.merchantWords.toLowerCase().includes(rating[0].toLowerCase())) {\n      fail(findings, sample.at, 'rating-invented', `The post gives a rating or review nobody gave. Remove: \"${rating[0]}\".`, sample.text)\n    }\n  }\n  findings.violations.push(\n    ...storefrontClaimViolations(\n      findStorefrontClaims(samples, context.merchantWords),\n      findInventedPrices(samples, context.merchantWords),\n    ),\n    ...detectOffVoiceCopy(samples, null),\n  )\n  return {\n    value: findings.violations.length ? null : { title, excerpt, body, seoDescription },\n    violations: findings.violations,\n    offending: findings.offending,\n  }\n}\n"],"names":["SEO_LISTING_FIELDS","findInventedPrices","findStorefrontClaims","storefrontClaimViolations","detectOffVoiceCopy","AI_BLOG_POST_TOOL_NAME","AI_BLOG_POST_LIMITS","titleMax","excerptMax","bodyMin","bodyMax","seoDescriptionMax","description","maxLength","string","type","AI_BLOG_POST_TOOL","name","strict","inputSchema","additionalProperties","required","properties","title","excerpt","body","seoDescription","fail","findings","at","code","message","value","violations","push","rule","paths","offending","line","replace","trim","paragraphs","split","map","part","trimEnd","join","HTML","PLAIN_MARKS","EMOJI","BRACKET","URL","TITLE_HEADING","RATING","checkPlain","raw","label","max","length","test","checkAiBlogPost","answer","context","limits","earlierTitles","some","earlier","toLowerCase","samples","text","sample","rating","exec","merchantWords","includes"],"mappings":"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"}

package/src/lib/usage/assist-usage.d.ts

@@ -18,6 +18,7 @@ import { type PublicAssistCredits } from './assist-credits';
 import { type AiOverageCapReason } from '../billing/ai-overage-gate';
 import type { AiRefusedBy } from '../model/ai-allotments';
 import { type AiAllotmentGate, type AiAllotmentRequestSubject } from './ai-allotments';
+import type { AiImageSize } from '../providers/image-contract';
 import { type AssistMeteredOrg, type FreeAssistAccount } from './assist-free-taste';
 import { type AiUsageKind } from '../model/ai-usage-by-user';
 export { assistMonthlyCeilingUsd } from './assist-ceiling';
@@ -153,6 +154,8 @@ export interface AssistTokenUsage {
      * catalog. Absent on every text exchange.
      */
     images?: number;
+    /** The size those pictures were made at (AGL-3602); 1K when absent. */
+    imageSize?: AiImageSize;
 }
 /**
  * What one exchange DRAWS FROM THE CUSTOMER, at the serving model's billed

package/src/lib/usage/assist-usage.js

@@ -793,9 +793,11 @@ async function reserveInTransaction(firestore, orgId, entitled, now, org, subjec
         feedback: null
     }, record.editOps && record.editOps > 0 ? {
         editOps: Math.floor(record.editOps)
-    } : {}, record.usage.images && record.usage.images > 0 ? {
+    } : {}, record.usage.images && record.usage.images > 0 ? _extends({
         images: Math.floor(record.usage.images)
-    } : {}, {
+    }, record.usage.imageSize ? {
+        imageSize: record.usage.imageSize
+    } : {}) : {}, {
         createdAt: serverTimestamp()
     }));
     // NO message counting here (AGL-2057). Both message counters are moved by