@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/tools/ai-products-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/tools/ai-products-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  AI_CATALOG_DESCRIPTION_MAX_CHARS,\n  AI_CATALOG_OPTION_VALUE_MAX_CHARS,\n  AI_CATALOG_OPTION_VALUES_MAX,\n  AI_CATALOG_OPTIONS_MAX,\n  AI_CATALOG_PHOTO_MAX_CHARS,\n  AI_CATALOG_PRODUCTS,\n  AI_CATALOG_TAGS_MAX,\n  AI_CATEGORIES_MAX,\n  AI_CATEGORY_NAME_MAX_CHARS,\n  AI_DISCOUNT_CODE,\n  AI_DISCOUNT_MAX_FIXED_USD,\n  AI_DISCOUNT_MAX_PERCENT,\n  AI_DISCOUNTS_MAX,\n  AI_PRODUCT_CATEGORIES_MAX,\n  AI_PRODUCT_DESCRIPTION_MAX_CHARS,\n  AI_PRODUCT_NAME_MAX_CHARS,\n  AI_PRODUCT_OPTION_NAME_MAX_CHARS,\n  AI_PRODUCT_TAG_MAX_CHARS,\n  AI_PRODUCT_TAGS_MAX,\n  AI_PRODUCT_TYPES,\n  AI_PROPOSAL_WHY_MAX_CHARS,\n  type AiCatalogProduct,\n  type AiCategoriesProposal,\n  type AiDiscountKind,\n  type AiProductCopy,\n  type AiProductOption,\n  type AiProductType,\n  type AiProposedDiscount,\n} from '../model/ai-products'\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 tools commerce by AI answers through (AGL-2916), and the checks\n * that hold each answer to the commerce editor it proposes for.\n *\n * - `propose_product_copy` — one product's description, search listing, tags,\n *   categories and option names.\n * - `propose_catalog` — a store's first products, from a brief.\n * - `propose_categories_and_discounts` — store categories and a first set of\n *   discounts, from a brief.\n *\n * Each schema is kept small, and no field is nullable: \"none\" is an empty\n * string, an empty list or zero. A strict schema accepts no length keyword,\n * so every bound is stated in a description and enforced here. A check\n * returns a value only when nothing in the answer is broken, and otherwise\n * the violations and the parts at fault, for the generation call's one\n * re-ask.\n */\n\nexport const AI_PRODUCT_COPY_TOOL_NAME = 'propose_product_copy'\nexport const AI_CATALOG_TOOL_NAME = 'propose_catalog'\nexport const AI_CATEGORIES_TOOL_NAME = 'propose_categories_and_discounts'\n\nconst SEO_TITLE_MAX = SEO_LISTING_FIELDS.title.maxLength\nconst SEO_DESCRIPTION_MAX = SEO_LISTING_FIELDS.description.maxLength\n\nconst string = (description: string) => ({ type: 'string', description })\nconst strings = (description: string) => ({ type: 'array', items: { type: 'string' }, description })\n\n/* ------------------------------------------------------------------------ *\n * Shared reads\n * ------------------------------------------------------------------------ */\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/** One line: runs of white space folded to one space. */\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, ' ').trim())\n        .join('\\n')\n        .replace(/\\n{3,}/g, '\\n\\n')\n        .trim()\n    : ''\n\nconst MARKUP = /<\\/?[a-z][^>]*>/i\nconst MARKDOWN = /(^|\\n)\\s*#{1,6}\\s|\\*\\*[^*\\n]+\\*\\*|__[^_\\n]+__|!\\[[^\\]]*\\]\\(|\\[[^\\]]+\\]\\(https?:/\nconst EMOJI = /\\p{Extended_Pictographic}/u\nconst BRACKET = /[[\\]]/\nconst URL = /\\bhttps?:\\/\\/|\\bwww\\./i\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\n/** A piece of copy a shopper reads: there, within its length, and plain text. */\nfunction checkCopyText(\n  findings: Findings,\n  at: string,\n  raw: unknown,\n  bounds: { label: string; max: number; multiline?: boolean; brackets?: boolean },\n): string {\n  if (typeof raw !== 'string') {\n    fail(findings, at, 'type', `${bounds.label} must be text.`, raw)\n    return ''\n  }\n  const value = bounds.multiline ? paragraphs(raw) : line(raw)\n  if (!value) {\n    fail(findings, at, 'missing', `${bounds.label} is required.`, raw)\n    return ''\n  }\n  if (value.length > bounds.max) {\n    fail(findings, at, 'too-long', `${bounds.label} is ${value.length} characters; it may have ${bounds.max}.`, raw)\n  }\n  if (MARKUP.test(value) || MARKDOWN.test(value)) {\n    fail(findings, at, 'markup', `${bounds.label} is plain text, with no markup or formatting marks.`, raw)\n  }\n  if (EMOJI.test(value)) fail(findings, at, 'emoji', `${bounds.label} holds no emoji.`, raw)\n  if (URL.test(value)) fail(findings, at, 'link', `${bounds.label} holds no link.`, raw)\n  if (bounds.brackets === false && BRACKET.test(value)) {\n    fail(findings, at, 'bracket', `${bounds.label} is published as written, so it marks no missing fact in brackets.`, raw)\n  }\n  return value\n}\n\n/** Tags a shopper filters by: short, distinct, no `#`, no more than `max`. */\nfunction checkTags(findings: Findings, at: string, raw: unknown, max = AI_PRODUCT_TAGS_MAX): string[] {\n  if (!Array.isArray(raw)) {\n    fail(findings, at, 'type', 'Tags are a list of words or short phrases.', raw)\n    return []\n  }\n  const seen = new Set<string>()\n  const tags: string[] = []\n  raw.forEach((entry, index) => {\n    const tag = line(entry).replace(/^#+/, '').trim()\n    if (!tag) return\n    if (tag.length > AI_PRODUCT_TAG_MAX_CHARS || EMOJI.test(tag) || BRACKET.test(tag)) {\n      fail(findings, `${at}[${index}]`, 'tag', `A tag is a plain word or phrase of at most ${AI_PRODUCT_TAG_MAX_CHARS} characters.`, entry)\n      return\n    }\n    const key = tag.toLowerCase()\n    if (seen.has(key)) return\n    seen.add(key)\n    tags.push(tag)\n  })\n  if (tags.length > max) {\n    fail(findings, at, 'too-many', `A product carries at most ${max} tags.`, raw)\n  }\n  return tags\n}\n\n/** The claims and prices a set of copy may not make, as violations. */\nfunction claimViolations(samples: readonly AiStorefrontCopySample[], merchantWords: string): AiDoctrineViolation[] {\n  return storefrontClaimViolations(\n    findStorefrontClaims(samples, merchantWords),\n    findInventedPrices(samples, merchantWords),\n  )\n}\n\n/* ------------------------------------------------------------------------ *\n * One product's copy\n * ------------------------------------------------------------------------ */\n\nexport const AI_PRODUCT_COPY_TOOL: AiTool = {\n  name: AI_PRODUCT_COPY_TOOL_NAME,\n  description: 'Propose the storefront copy for one product. Every field is required.',\n  strict: true,\n  inputSchema: {\n    type: 'object',\n    additionalProperties: false,\n    required: ['description', 'seoTitle', 'seoDescription', 'tags', 'categoryIds', 'optionNames'],\n    properties: {\n      description: string(\n        `The product description shoppers read, in short paragraphs, at most ${AI_PRODUCT_DESCRIPTION_MAX_CHARS} characters.`,\n      ),\n      seoTitle: string(`The search result headline, published as written, at most ${SEO_TITLE_MAX} characters.`),\n      seoDescription: string(`The search result summary, at most ${SEO_DESCRIPTION_MAX} characters.`),\n      tags: strings(`At most ${AI_PRODUCT_TAGS_MAX} tags, each at most ${AI_PRODUCT_TAG_MAX_CHARS} characters.`),\n      categoryIds: strings(\n        `At most ${AI_PRODUCT_CATEGORIES_MAX} category ids from the list you were given; empty when none fits.`,\n      ),\n      optionNames: strings(\n        `One name per option the product has, in order, each at most ${AI_PRODUCT_OPTION_NAME_MAX_CHARS} characters; empty when it has none.`,\n      ),\n    },\n  },\n}\n\nexport interface AiProductCopyCheckContext {\n  /** The ids of the site's categories the request listed. */\n  categoryIds: readonly string[]\n  /** How many options the product has. */\n  optionCount: number\n  /** The merchant's own words about the product: its name, text and tags. */\n  merchantWords: string\n}\n\n/**\n * A product copy answer held to the editor: every field written and within\n * its length, plain text, the categories the request listed, one distinct\n * name per option, and no claim or price the copy may not make.\n */\nexport function checkAiProductCopy(\n  answer: Record<string, unknown>,\n  context: AiProductCopyCheckContext,\n): AiGenerationCheckResult<AiProductCopy> {\n  const findings: Findings = { violations: [], offending: {} }\n  const description = checkCopyText(findings, 'description', answer['description'], {\n    label: 'The description',\n    max: AI_PRODUCT_DESCRIPTION_MAX_CHARS,\n    multiline: true,\n  })\n  const seoTitle = checkCopyText(findings, 'seoTitle', answer['seoTitle'], {\n    label: 'The search title',\n    max: SEO_TITLE_MAX,\n    brackets: false,\n  })\n  const seoDescription = checkCopyText(findings, 'seoDescription', answer['seoDescription'], {\n    label: 'The search description',\n    max: SEO_DESCRIPTION_MAX,\n    brackets: false,\n  })\n  const tags = checkTags(findings, 'tags', answer['tags'])\n\n  const allowed = new Set(context.categoryIds)\n  const categoryIds: string[] = []\n  const rawCategories = answer['categoryIds']\n  if (!Array.isArray(rawCategories)) {\n    fail(findings, 'categoryIds', 'type', 'Categories are a list of ids.', rawCategories)\n  } else {\n    for (const entry of rawCategories) {\n      const id = line(entry)\n      if (!id || categoryIds.includes(id)) continue\n      if (!allowed.has(id)) {\n        fail(findings, 'categoryIds', 'category-unknown', 'Use only the category ids you were given.', rawCategories)\n        continue\n      }\n      categoryIds.push(id)\n    }\n    if (categoryIds.length > AI_PRODUCT_CATEGORIES_MAX) {\n      fail(findings, 'categoryIds', 'too-many', `A product goes in at most ${AI_PRODUCT_CATEGORIES_MAX} categories.`, rawCategories)\n    }\n  }\n\n  const optionNames: string[] = []\n  const rawOptions = answer['optionNames']\n  if (!Array.isArray(rawOptions)) {\n    fail(findings, 'optionNames', 'type', 'Option names are a list.', rawOptions)\n  } else {\n    if (rawOptions.length !== context.optionCount) {\n      fail(\n        findings,\n        'optionNames',\n        'option-count',\n        `The product has ${context.optionCount} ${context.optionCount === 1 ? 'option' : 'options'}; give one name for each.`,\n        rawOptions,\n      )\n    }\n    rawOptions.slice(0, context.optionCount).forEach((entry, index) => {\n      const name = line(entry)\n      if (!name || name.length > AI_PRODUCT_OPTION_NAME_MAX_CHARS || BRACKET.test(name) || EMOJI.test(name)) {\n        fail(findings, `optionNames[${index}]`, 'option-name', `An option name is a plain word or phrase of at most ${AI_PRODUCT_OPTION_NAME_MAX_CHARS} characters.`, entry)\n      }\n      optionNames.push(name)\n    })\n    if (new Set(optionNames.map((name) => name.toLowerCase())).size !== optionNames.length) {\n      fail(findings, 'optionNames', 'option-duplicate', 'Each option needs its own name.', rawOptions)\n    }\n  }\n\n  const samples: AiStorefrontCopySample[] = [\n    { at: 'description', text: description },\n    { at: 'seoTitle', text: seoTitle },\n    { at: 'seoDescription', text: seoDescription },\n    ...tags.map((tag, index) => ({ at: `tags[${index}]`, text: tag })),\n  ]\n  findings.violations.push(\n    ...claimViolations(samples, context.merchantWords),\n    ...detectOffVoiceCopy(samples, null),\n  )\n  const value = findings.violations.length\n    ? null\n    : { description, seoTitle, seoDescription, tags, categoryIds, optionNames }\n  return { value, violations: findings.violations, offending: findings.offending }\n}\n\n/* ------------------------------------------------------------------------ *\n * A store's first products\n * ------------------------------------------------------------------------ */\n\nexport const AI_CATALOG_TOOL: AiTool = {\n  name: AI_CATALOG_TOOL_NAME,\n  description: 'Propose the products of a new store, each a draft its owner completes. Every field is required.',\n  strict: true,\n  inputSchema: {\n    type: 'object',\n    additionalProperties: false,\n    required: ['products'],\n    properties: {\n      products: {\n        type: 'array',\n        description: `Between ${AI_CATALOG_PRODUCTS.min} and ${AI_CATALOG_PRODUCTS.max} products.`,\n        items: {\n          type: 'object',\n          additionalProperties: false,\n          required: ['name', 'type', 'description', 'tags', 'options', 'seoTitle', 'seoDescription', 'photo'],\n          properties: {\n            name: string(`Distinct within the list, at most ${AI_PRODUCT_NAME_MAX_CHARS} characters.`),\n            type: { type: 'string', enum: [...AI_PRODUCT_TYPES] },\n            description: string(`In short paragraphs, at most ${AI_CATALOG_DESCRIPTION_MAX_CHARS} characters.`),\n            tags: strings(`At most ${AI_CATALOG_TAGS_MAX} tags, each at most ${AI_PRODUCT_TAG_MAX_CHARS} characters.`),\n            options: {\n              type: 'array',\n              description: `The choices a shopper makes, at most ${AI_CATALOG_OPTIONS_MAX}; empty for a product with none.`,\n              items: {\n                type: 'object',\n                additionalProperties: false,\n                required: ['name', 'values'],\n                properties: {\n                  name: string(`At most ${AI_PRODUCT_OPTION_NAME_MAX_CHARS} characters.`),\n                  values: strings(\n                    `At most ${AI_CATALOG_OPTION_VALUES_MAX} distinct values, each at most ${AI_CATALOG_OPTION_VALUE_MAX_CHARS} characters.`,\n                  ),\n                },\n              },\n            },\n            seoTitle: string(`At most ${SEO_TITLE_MAX} characters.`),\n            seoDescription: string(`At most ${SEO_DESCRIPTION_MAX} characters.`),\n            photo: string(`What the product photo should show, in one sentence of at most ${AI_CATALOG_PHOTO_MAX_CHARS} characters.`),\n          },\n        },\n      },\n    },\n  },\n}\n\n/** A catalog answer held to the products editor and the storefront copy rules. */\nexport function checkAiCatalog(\n  answer: Record<string, unknown>,\n  context: { merchantWords: string },\n): AiGenerationCheckResult<AiCatalogProduct[]> {\n  const findings: Findings = { violations: [], offending: {} }\n  const raw = answer['products']\n  if (!Array.isArray(raw)) {\n    fail(findings, 'products', 'type', 'The products are a list.', raw)\n    return { value: null, violations: findings.violations, offending: findings.offending }\n  }\n  if (raw.length < AI_CATALOG_PRODUCTS.min || raw.length > AI_CATALOG_PRODUCTS.max) {\n    fail(findings, 'products', 'product-count', `Propose between ${AI_CATALOG_PRODUCTS.min} and ${AI_CATALOG_PRODUCTS.max} products.`, `${raw.length} products`)\n  }\n  const names = new Set<string>()\n  const products: AiCatalogProduct[] = []\n  const samples: AiStorefrontCopySample[] = []\n  raw.slice(0, AI_CATALOG_PRODUCTS.max).forEach((entry, index) => {\n    const at = `products[${index}]`\n    if (!isRecord(entry)) {\n      fail(findings, at, 'type', 'Each product is an object.', entry)\n      return\n    }\n    const name = checkCopyText(findings, `${at}.name`, entry['name'], {\n      label: 'A product name',\n      max: AI_PRODUCT_NAME_MAX_CHARS,\n      brackets: false,\n    })\n    if (name && names.has(name.toLowerCase())) {\n      fail(findings, `${at}.name`, 'name-duplicate', 'Each product needs its own name.', entry['name'])\n    }\n    names.add(name.toLowerCase())\n    const type = entry['type']\n    if (!(AI_PRODUCT_TYPES as readonly unknown[]).includes(type)) {\n      fail(findings, `${at}.type`, 'type', 'A product is physical, digital or a service.', type)\n    }\n    const description = checkCopyText(findings, `${at}.description`, entry['description'], {\n      label: 'A product description',\n      max: AI_CATALOG_DESCRIPTION_MAX_CHARS,\n      multiline: true,\n    })\n    const tags = checkTags(findings, `${at}.tags`, entry['tags'], AI_CATALOG_TAGS_MAX)\n    const options = checkCatalogOptions(findings, `${at}.options`, entry['options'])\n    const seoTitle = checkCopyText(findings, `${at}.seoTitle`, entry['seoTitle'], {\n      label: 'A search title',\n      max: SEO_TITLE_MAX,\n      brackets: false,\n    })\n    const seoDescription = checkCopyText(findings, `${at}.seoDescription`, entry['seoDescription'], {\n      label: 'A search description',\n      max: SEO_DESCRIPTION_MAX,\n      brackets: false,\n    })\n    const photo = checkCopyText(findings, `${at}.photo`, entry['photo'], {\n      label: 'What the photo shows',\n      max: AI_CATALOG_PHOTO_MAX_CHARS,\n      brackets: false,\n    })\n    samples.push(\n      { at: `${at}.name`, text: name },\n      { at: `${at}.description`, text: description },\n      { at: `${at}.seoTitle`, text: seoTitle },\n      { at: `${at}.seoDescription`, text: seoDescription },\n      ...tags.map((tag, tagIndex) => ({ at: `${at}.tags[${tagIndex}]`, text: tag })),\n    )\n    products.push({\n      name,\n      type: type as AiProductType,\n      description,\n      tags,\n      options,\n      seoTitle,\n      seoDescription,\n      photo,\n    })\n  })\n  findings.violations.push(...claimViolations(samples, context.merchantWords), ...detectOffVoiceCopy(samples, null))\n  return {\n    value: findings.violations.length ? null : products,\n    violations: findings.violations,\n    offending: findings.offending,\n  }\n}\n\nfunction checkCatalogOptions(findings: Findings, at: string, raw: unknown): AiProductOption[] {\n  if (!Array.isArray(raw)) {\n    fail(findings, at, 'type', 'Options are a list.', raw)\n    return []\n  }\n  if (raw.length > AI_CATALOG_OPTIONS_MAX) {\n    fail(findings, at, 'too-many', `A proposed product has at most ${AI_CATALOG_OPTIONS_MAX} options.`, raw)\n  }\n  const options: AiProductOption[] = []\n  raw.slice(0, AI_CATALOG_OPTIONS_MAX).forEach((entry, index) => {\n    const here = `${at}[${index}]`\n    const record = isRecord(entry) ? entry : {}\n    const name = line(record['name'])\n    if (!name || name.length > AI_PRODUCT_OPTION_NAME_MAX_CHARS || BRACKET.test(name)) {\n      fail(findings, `${here}.name`, 'option-name', `An option name is a plain word or phrase of at most ${AI_PRODUCT_OPTION_NAME_MAX_CHARS} characters.`, record['name'])\n    }\n    const values = Array.isArray(record['values']) ? record['values'].map(line).filter(Boolean) : []\n    if (!values.length || values.length > AI_CATALOG_OPTION_VALUES_MAX) {\n      fail(findings, `${here}.values`, 'too-many', `An option has between 1 and ${AI_CATALOG_OPTION_VALUES_MAX} values.`, record['values'])\n    }\n    if (values.some((value) => value.length > AI_CATALOG_OPTION_VALUE_MAX_CHARS || BRACKET.test(value))) {\n      fail(findings, `${here}.values`, 'option-values', `An option value is a plain word or phrase of at most ${AI_CATALOG_OPTION_VALUE_MAX_CHARS} characters.`, record['values'])\n    }\n    if (new Set(values.map((value) => value.toLowerCase())).size !== values.length) {\n      fail(findings, `${here}.values`, 'option-values', 'An option’s values are all different.', record['values'])\n    }\n    options.push({ name, values: values.slice(0, AI_CATALOG_OPTION_VALUES_MAX) })\n  })\n  if (new Set(options.map((option) => option.name.toLowerCase())).size !== options.length) {\n    fail(findings, at, 'option-duplicate', 'Each option needs its own name.', raw)\n  }\n  return options\n}\n\n/* ------------------------------------------------------------------------ *\n * Categories and discounts\n * ------------------------------------------------------------------------ */\n\nexport const AI_CATEGORIES_TOOL: AiTool = {\n  name: AI_CATEGORIES_TOOL_NAME,\n  description: 'Propose store categories and a first set of discounts, each created only if the owner accepts it. Every field is required.',\n  strict: true,\n  inputSchema: {\n    type: 'object',\n    additionalProperties: false,\n    required: ['categories', 'discounts'],\n    properties: {\n      categories: {\n        type: 'array',\n        description: `At most ${AI_CATEGORIES_MAX} categories; empty when the brief gives no reason for any.`,\n        items: {\n          type: 'object',\n          additionalProperties: false,\n          required: ['name', 'why'],\n          properties: {\n            name: string(`At most ${AI_CATEGORY_NAME_MAX_CHARS} characters.`),\n            why: string(`One sentence of at most ${AI_PROPOSAL_WHY_MAX_CHARS} characters.`),\n          },\n        },\n      },\n      discounts: {\n        type: 'array',\n        description: `At most ${AI_DISCOUNTS_MAX} discounts; empty when the brief gives no reason for any.`,\n        items: {\n          type: 'object',\n          additionalProperties: false,\n          required: ['name', 'code', 'kind', 'value', 'minimumOrderUsd', 'why'],\n          properties: {\n            name: string(`At most ${AI_CATEGORY_NAME_MAX_CHARS} characters.`),\n            code: string('The code a shopper types: 3 to 20 capital letters, digits, dashes or underscores; empty for a discount that applies on its own.'),\n            kind: { type: 'string', enum: ['percent', 'fixed', 'free_shipping'] },\n            value: {\n              type: 'number',\n              description: `percent: the percentage, 1 to ${AI_DISCOUNT_MAX_PERCENT}; fixed: dollars off, at most ${AI_DISCOUNT_MAX_FIXED_USD}; free_shipping: 0.`,\n            },\n            minimumOrderUsd: { type: 'number', description: 'The smallest order it applies to, in dollars; 0 for any order.' },\n            why: string(`One sentence of at most ${AI_PROPOSAL_WHY_MAX_CHARS} characters.`),\n          },\n        },\n      },\n    },\n  },\n}\n\n/** A categories answer held to the catalog and discount editors and the storefront copy rules. */\nexport function checkAiCategories(\n  answer: Record<string, unknown>,\n  context: { existingCategoryNames: readonly string[]; merchantWords: string },\n): AiGenerationCheckResult<Pick<AiCategoriesProposal, 'categories' | 'discounts'>> {\n  const findings: Findings = { violations: [], offending: {} }\n  const existing = new Set(context.existingCategoryNames.map((name) => line(name).toLowerCase()))\n  const samples: AiStorefrontCopySample[] = []\n\n  const categories: AiCategoriesProposal['categories'] = []\n  const rawCategories = answer['categories']\n  if (!Array.isArray(rawCategories)) {\n    fail(findings, 'categories', 'type', 'Categories are a list.', rawCategories)\n  } else {\n    if (rawCategories.length > AI_CATEGORIES_MAX) {\n      fail(findings, 'categories', 'too-many', `Propose at most ${AI_CATEGORIES_MAX} categories.`, `${rawCategories.length} categories`)\n    }\n    const seen = new Set<string>()\n    rawCategories.slice(0, AI_CATEGORIES_MAX).forEach((entry, index) => {\n      const at = `categories[${index}]`\n      const record = isRecord(entry) ? entry : {}\n      const name = checkCopyText(findings, `${at}.name`, record['name'], {\n        label: 'A category name',\n        max: AI_CATEGORY_NAME_MAX_CHARS,\n        brackets: false,\n      })\n      const key = name.toLowerCase()\n      if (name && existing.has(key)) {\n        fail(findings, `${at}.name`, 'category-exists', `The store already has a category named ${name}.`, record['name'])\n      } else if (name && seen.has(key)) {\n        fail(findings, `${at}.name`, 'category-duplicate', 'Each category needs its own name.', record['name'])\n      }\n      seen.add(key)\n      const why = checkCopyText(findings, `${at}.why`, record['why'], {\n        label: 'Why a category helps',\n        max: AI_PROPOSAL_WHY_MAX_CHARS,\n        brackets: false,\n      })\n      samples.push({ at: `${at}.name`, text: name }, { at: `${at}.why`, text: why })\n      categories.push({ name, why })\n    })\n  }\n\n  const discounts: AiProposedDiscount[] = []\n  const rawDiscounts = answer['discounts']\n  if (!Array.isArray(rawDiscounts)) {\n    fail(findings, 'discounts', 'type', 'Discounts are a list.', rawDiscounts)\n  } else {\n    if (rawDiscounts.length > AI_DISCOUNTS_MAX) {\n      fail(findings, 'discounts', 'too-many', `Propose at most ${AI_DISCOUNTS_MAX} discounts.`, `${rawDiscounts.length} discounts`)\n    }\n    const codes = new Set<string>()\n    rawDiscounts.slice(0, AI_DISCOUNTS_MAX).forEach((entry, index) => {\n      const at = `discounts[${index}]`\n      const record = isRecord(entry) ? entry : {}\n      const name = checkCopyText(findings, `${at}.name`, record['name'], {\n        label: 'A discount name',\n        max: AI_CATEGORY_NAME_MAX_CHARS,\n        brackets: false,\n      })\n      const typedCode = line(record['code']).toUpperCase()\n      if (typedCode && !AI_DISCOUNT_CODE.test(typedCode)) {\n        fail(findings, `${at}.code`, 'code', 'A code is 3 to 20 capital letters, digits, dashes or underscores.', record['code'])\n      } else if (typedCode && codes.has(typedCode)) {\n        fail(findings, `${at}.code`, 'code-duplicate', 'Each discount needs its own code.', record['code'])\n      }\n      if (typedCode) codes.add(typedCode)\n      const kind = record['kind']\n      const value = Number(record['value'])\n      const minimum = Number(record['minimumOrderUsd'])\n      let valuePct: number | null = null\n      let valueCents: number | null = null\n      if (kind === 'percent') {\n        if (!Number.isInteger(value) || value < 1 || value > AI_DISCOUNT_MAX_PERCENT) {\n          fail(findings, `${at}.value`, 'discount-value', `A percentage is a whole number from 1 to ${AI_DISCOUNT_MAX_PERCENT}.`, record['value'])\n        }\n        valuePct = value\n      } else if (kind === 'fixed') {\n        if (!Number.isFinite(value) || value <= 0 || value > AI_DISCOUNT_MAX_FIXED_USD) {\n          fail(findings, `${at}.value`, 'discount-value', `An amount off is more than 0 and at most ${AI_DISCOUNT_MAX_FIXED_USD} dollars.`, record['value'])\n        }\n        valueCents = Math.round(value * 100)\n      } else if (kind !== 'free_shipping') {\n        fail(findings, `${at}.kind`, 'type', 'A discount is a percentage, an amount off or free shipping.', kind)\n      }\n      if (!Number.isFinite(minimum) || minimum < 0 || minimum > 10_000) {\n        fail(findings, `${at}.minimumOrderUsd`, 'discount-minimum', 'A minimum order is between 0 and 10,000 dollars.', record['minimumOrderUsd'])\n      }\n      const why = checkCopyText(findings, `${at}.why`, record['why'], {\n        label: 'Why a discount helps',\n        max: AI_PROPOSAL_WHY_MAX_CHARS,\n        brackets: false,\n      })\n      // The discount's own amount is stated in its fields, so only its name\n      // and reason are read for a claim: \"15% off\" is the discount, not a price.\n      samples.push({ at: `${at}.name`, text: name }, { at: `${at}.why`, text: why })\n      discounts.push({\n        name,\n        code: typedCode || null,\n        kind: kind as AiDiscountKind,\n        valuePct,\n        valueCents,\n        minSubtotalCents: minimum > 0 ? Math.round(minimum * 100) : null,\n        why,\n      })\n    })\n  }\n\n  if (!categories.length && !discounts.length && !findings.violations.length) {\n    fail(findings, 'categories', 'empty', 'Propose at least one category or one discount.', answer)\n  }\n  findings.violations.push(\n    ...storefrontClaimViolations(findStorefrontClaims(samples, context.merchantWords)),\n    ...detectOffVoiceCopy(samples, null),\n  )\n  return {\n    value: findings.violations.length ? null : { categories, discounts },\n    violations: findings.violations,\n    offending: findings.offending,\n  }\n}\n"],"names":["SEO_LISTING_FIELDS","AI_CATALOG_DESCRIPTION_MAX_CHARS","AI_CATALOG_OPTION_VALUE_MAX_CHARS","AI_CATALOG_OPTION_VALUES_MAX","AI_CATALOG_OPTIONS_MAX","AI_CATALOG_PHOTO_MAX_CHARS","AI_CATALOG_PRODUCTS","AI_CATALOG_TAGS_MAX","AI_CATEGORIES_MAX","AI_CATEGORY_NAME_MAX_CHARS","AI_DISCOUNT_CODE","AI_DISCOUNT_MAX_FIXED_USD","AI_DISCOUNT_MAX_PERCENT","AI_DISCOUNTS_MAX","AI_PRODUCT_CATEGORIES_MAX","AI_PRODUCT_DESCRIPTION_MAX_CHARS","AI_PRODUCT_NAME_MAX_CHARS","AI_PRODUCT_OPTION_NAME_MAX_CHARS","AI_PRODUCT_TAG_MAX_CHARS","AI_PRODUCT_TAGS_MAX","AI_PRODUCT_TYPES","AI_PROPOSAL_WHY_MAX_CHARS","findInventedPrices","findStorefrontClaims","storefrontClaimViolations","detectOffVoiceCopy","AI_PRODUCT_COPY_TOOL_NAME","AI_CATALOG_TOOL_NAME","AI_CATEGORIES_TOOL_NAME","SEO_TITLE_MAX","title","maxLength","SEO_DESCRIPTION_MAX","description","string","type","strings","items","isRecord","value","Array","isArray","line","replace","trim","paragraphs","split","map","part","join","MARKUP","MARKDOWN","EMOJI","BRACKET","URL","fail","findings","at","code","message","violations","push","rule","paths","offending","checkCopyText","raw","bounds","label","multiline","length","max","test","brackets","checkTags","seen","Set","tags","forEach","entry","index","tag","key","toLowerCase","has","add","claimViolations","samples","merchantWords","AI_PRODUCT_COPY_TOOL","name","strict","inputSchema","additionalProperties","required","properties","seoTitle","seoDescription","categoryIds","optionNames","checkAiProductCopy","answer","context","allowed","rawCategories","id","includes","rawOptions","optionCount","slice","size","text","AI_CATALOG_TOOL","products","min","enum","options","values","photo","checkAiCatalog","names","checkCatalogOptions","tagIndex","here","record","filter","Boolean","some","option","AI_CATEGORIES_TOOL","categories","why","discounts","kind","minimumOrderUsd","checkAiCategories","existing","existingCategoryNames","rawDiscounts","codes","typedCode","toUpperCase","Number","minimum","valuePct","valueCents","isInteger","isFinite","Math","round","minSubtotalCents"],"mappings":"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"}

package/src/lib/tools/ai-seo-tool.d.ts

@@ -0,0 +1,162 @@
+/**
+ * @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 SeoListingFieldKey } from '@aglyn/aglyn/app-utils/seo-listing-fields';
+import type { AiSeoFieldValues, AiSeoFindingCode, AiSeoKeywordCoverage, AiSeoSiteFormField } from '../model/ai-seo';
+import type { AiTool } from '../providers/contract';
+import type { AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+import type { AiSeoPageFacts } from '../runtime/seo-page-facts';
+/**
+ * The strict tools SEO by AI answers through (AGL-2910), and the checks that
+ * hold each answer to the editor it proposes for.
+ *
+ * - `propose_search_listing` — one page's or one product's listing. BUILT
+ *   from the editor's own field list, the `seo-listing-fields` catalog the
+ *   SEO card draws its inputs from, so a field and its length are said once:
+ *   `ai-seo-tool.spec.ts` asserts the parity in both directions.
+ * - `propose_seo_fixes` — one batch of a site audit's page fixes.
+ * - `propose_site_listing` — the site's structured data and its guidance
+ *   for AI agents, the two fields `/llms.txt` leads with.
+ *
+ * A strict schema forbids extra keys, requires every key and says "no value"
+ * with `null`; it accepts no length keyword, so every length is stated in a
+ * description and enforced here. A check returns a value only when nothing
+ * in the answer is broken, and otherwise the violations and the parts at
+ * fault, for the generation call's one re-ask.
+ */
+/** Target keywords one listing may be asked to cover. */
+export declare const AI_SEO_MAX_KEYWORDS = 5;
+/** The most times one keyword may appear, per field, before it reads as stuffing. */
+export declare const AI_SEO_KEYWORD_LIMITS: Readonly<Partial<Record<SeoListingFieldKey, number>>>;
+/** How many times `keyword` appears in `text` as whole words, any case. */
+export declare function aiSeoKeywordCount(text: string | null | undefined, keyword: string): number;
+/** Keywords as a person typed them: trimmed, deduplicated, capped. */
+export declare function aiSeoKeywordList(raw: unknown): string[];
+/** Where a page already says each target keyword. */
+export declare function aiSeoKeywordCoverage(keywords: readonly string[], sources: {
+    title?: string | null;
+    description?: string | null;
+    h1?: string | null;
+    body?: string | null;
+}): AiSeoKeywordCoverage[];
+export declare const AI_SEO_FIELDS_TOOL_NAME = "propose_search_listing";
+/** The fields a listing proposal must fill; the image description may be left out. */
+export declare const AI_SEO_REQUIRED_FIELDS: ReadonlySet<SeoListingFieldKey>;
+/** Fields in the catalog's order, whatever order a caller named them in. */
+export declare function orderedSeoListingFields(fields: readonly SeoListingFieldKey[]): SeoListingFieldKey[];
+/** The strict tool for a listing with exactly these fields, each required and nullable. */
+export declare function aiSeoFieldsTool(fields: readonly SeoListingFieldKey[]): AiTool;
+export interface AiSeoFieldsCheckContext {
+    fields: readonly SeoListingFieldKey[];
+    /** Whether the listing has a social image; without one, an image description is dropped. */
+    hasImage: boolean;
+    keywords?: readonly string[];
+    /** Titles other pages of the site use, which this listing must not repeat. */
+    otherTitles?: readonly string[];
+}
+/**
+ * A listing answer held to the editor: every requested text field written,
+ * each within its length, no keyword past its per-field count, no word
+ * repeated to rank, no title another page uses.
+ */
+export declare function checkAiSeoFields(answer: Record<string, unknown>, context: AiSeoFieldsCheckContext): {
+    value: AiSeoFieldValues | null;
+    violations: AiDoctrineViolation[];
+    offending?: Record<string, unknown>;
+};
+export declare const AI_SEO_FIXES_TOOL_NAME = "propose_seo_fixes";
+/**
+ * How long an image description a batch proposes may be. Shorter than the
+ * `alt` ceiling: a description read aloud is better short, and it keeps the
+ * largest batch answer inside its measured budget.
+ */
+export declare const AI_SEO_FIX_ALT_MAX_CHARS: number;
+/** Undescribed images one page of a batch gets descriptions for; the rest wait for the next audit. */
+export declare const AI_SEO_FIX_IMAGES_PER_PAGE = 3;
+/** The undescribed images a batch asks about for a page, in page order. */
+export declare function aiSeoFixImages(page: Pick<AiSeoBatchPage, 'facts'>): AiSeoPageFacts['imagesMissingAlt'];
+/** The strict tool for one batch: a title, description, heading and image descriptions per page. */
+export declare function aiSeoFixesTool(screenIds: readonly string[]): AiTool;
+/** A batch page as the fixes prompt and check read it. */
+export interface AiSeoBatchPage {
+    screenId: string;
+    path: string;
+    name: string;
+    codes: ReadonlySet<AiSeoFindingCode>;
+    keywords: readonly string[];
+    seo: {
+        title?: string;
+        description?: string;
+        breadcrumb?: string;
+        image?: string;
+        imageAlt?: string;
+    } | undefined;
+    facts: AiSeoPageFacts;
+}
+/** The findings that let a batch answer propose each value. */
+export declare const AI_SEO_FIX_CODES: {
+    readonly title: readonly ["title-missing", "title-too-long", "title-duplicate", "keyword-missing"];
+    readonly description: readonly ["description-missing", "description-too-long", "description-duplicate", "keyword-missing"];
+    readonly h1: readonly ["h1-missing", "h1-thin"];
+};
+export interface AiSeoBatchAnswer {
+    title: string | null;
+    description: string | null;
+    h1: string | null;
+    imageAlts: Array<{
+        nodeId: string;
+        alt: string;
+    }>;
+}
+/**
+ * A batch answer held to the audit and the editor: values only where a
+ * finding asked for them, each within its length, no keyword past its count,
+ * no title another page uses, and image descriptions only for this page's
+ * undescribed images.
+ */
+export declare function checkAiSeoFixes(answer: Record<string, unknown>, pages: readonly AiSeoBatchPage[], titlesElsewhere: readonly string[]): {
+    value: Record<string, AiSeoBatchAnswer> | null;
+    violations: AiDoctrineViolation[];
+    offending?: Record<string, unknown>;
+};
+export declare const AI_SEO_SITE_TOOL_NAME = "propose_site_listing";
+/** The longest structured-data description the site SEO form accepts. */
+export declare const AI_SEO_ENTITY_DESCRIPTION_MAX_CHARS = 300;
+/** The longest agent guidance the site SEO form accepts. */
+export declare const AI_SEO_AGENT_GUIDANCE_MAX_CHARS = 1000;
+/** The entity types the tool offers, and the value the site SEO form stores for each. */
+export declare const AI_SEO_ENTITY_TYPE_VALUES: Readonly<Record<string, string>>;
+/** The site-wide proposal's strict tool: structured data and agent guidance, each nullable. */
+export declare function aiSeoSiteTool(): AiTool;
+export interface AiSeoSiteCheckContext {
+    /** The form fields that are blank on the site now; only these may be proposed. */
+    blank: ReadonlySet<AiSeoSiteFormField>;
+    /** Every word the site's pages show, for the contact details to be found in. */
+    siteText: string;
+}
+/**
+ * The site proposal held to the form and to the site: lengths, and a contact
+ * detail only when a page shows it. A detail no page shows is left out with
+ * a note rather than asked for again — asking again invites composing one.
+ */
+export declare function checkAiSeoSite(answer: Record<string, unknown>, context: AiSeoSiteCheckContext): {
+    value: {
+        values: Partial<Record<AiSeoSiteFormField, string>>;
+        notes: string[];
+    } | null;
+    violations: AiDoctrineViolation[];
+    offending?: Record<string, unknown>;
+};