# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dynamicfeed Ai Advisories API
  version: 1.0.0
extends: openapi/dynamicfeed-ai-advisories-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/advisories'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse recent security advisories
      effect: read
      questions:
      - What critical security advisories were published recently for npm packages?
      - Can I filter recent CVEs by minimum CVSS score?
      instructions:
      - text: Show recent advisories affecting {package}.
        slots:
          package: query.package
      - text: List {severity} advisories in the {ecosystem} ecosystem.
        slots:
          severity: query.severity
          ecosystem: query.ecosystem
      method: generated
      generated: '2026-10-01'
- target: $.paths['/advisories/check'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if a package version is vulnerable
      effect: read
      questions:
      - Is lodash 4.17.10 vulnerable, and which version fixes it?
      - How should I pass a Maven package to the vulnerability check?
      instructions:
      - text: Check whether {package} {version} is vulnerable.
        slots:
          package: query.package
          version: query.version
      - text: Look up all known vulnerabilities for {package} in {ecosystem}.
        slots:
          package: query.package
          ecosystem: query.ecosystem
      method: generated
      generated: '2026-10-01'