# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Gitea Package API
  version: 1.0.0
extends: openapi/gitea-package-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/packages/{owner}'].get
  update:
    x-apievangelist-phrasing:
      intent: List an owner's packages
      effect: read
      questions:
      - Which packages has a user or organization published to the registry?
      - Can I filter an owner's packages by type, like only npm or container images?
      instructions:
      - text: List all packages owned by {owner}.
        slots:
          owner: path.owner
      - text: List {owner}'s {type} packages matching {q}.
        slots:
          owner: path.owner
          type: query.type
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/packages/{owner}/{type}/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: List all versions of a package
      effect: read
      questions:
      - Which versions of a package have been published?
      - Can I page through every release of one package?
      instructions:
      - text: List all versions of {type} package {name} owned by {owner}.
        slots:
          type: path.type
          name: path.name
          owner: path.owner
      - text: Show page {page} of versions for {owner}'s {type} package {name}.
        slots:
          page: query.page
          owner: path.owner
          type: path.type
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/packages/{owner}/{type}/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a package and all its versions
      effect: destructive
      questions:
      - How do I remove a whole package, every version included?
      - Can I delete an entire package from the registry at once?
      instructions:
      - text: Delete the entire {type} package {name} owned by {owner}.
        slots:
          type: path.type
          name: path.name
          owner: path.owner
      - text: Remove package {name} of type {type} and all its versions from {owner}.
        slots:
          type: path.type
          name: path.name
          owner: path.owner
      method: generated
      generated: '2026-09-26'
- target: $.paths['/packages/{owner}/{type}/{name}/-/latest'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the latest version of a package
      effect: read
      questions:
      - What is the newest published version of a package?
      - Can I find the latest release of a package without listing every version?
      instructions:
      - text: Get the latest version of {owner}'s {type} package {name}.
        slots:
          owner: path.owner
          type: path.type
          name: path.name
      - text: Tell me the most recent release of package {name} ({type}) from {owner}.
        slots:
          owner: path.owner
          type: path.type
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/packages/{owner}/{type}/{name}/-/link/{repo_name}'].post
  update:
    x-apievangelist-phrasing:
      intent: Link a package to a repository
      effect: write
      questions:
      - How do I connect a package to the repository that builds it?
      - Can a package show up on a repo's packages tab?
      instructions:
      - text: Link {owner}'s {type} package {name} to repository {repo_name}.
        slots:
          owner: path.owner
          type: path.type
          name: path.name
          repo_name: path.repo_name
      - text: Attach package {name} ({type}) owned by {owner} to repo {repo_name}.
        slots:
          owner: path.owner
          type: path.type
          name: path.name
          repo_name: path.repo_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/packages/{owner}/{type}/{name}/-/unlink'].post
  update:
    x-apievangelist-phrasing:
      intent: Unlink a package from its repository
      effect: write
      questions:
      - How do I detach a package from the repository it's linked to?
      - Can I remove the repo association from a package without deleting it?
      instructions:
      - text: Unlink {owner}'s {type} package {name} from its repository.
        slots:
          owner: path.owner
          type: path.type
          name: path.name
      - text: Detach package {name} ({type}) owned by {owner} from any repo.
        slots:
          owner: path.owner
          type: path.type
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/packages/{owner}/{type}/{name}/{version}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a specific package version
      effect: read
      questions:
      - What are the details of one specific version of a package?
      - Who published a given package version and when?
      instructions:
      - text: Get version {version} of {owner}'s {type} package {name}.
        slots:
          version: path.version
          owner: path.owner
          type: path.type
          name: path.name
      - text: Show details for {name} {version} ({type}) from {owner}.
        slots:
          version: path.version
          owner: path.owner
          type: path.type
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/packages/{owner}/{type}/{name}/{version}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one version of a package
      effect: destructive
      questions:
      - How do I delete a single bad release but keep the rest of the package?
      - Can I remove just one version of a package?
      instructions:
      - text: Delete version {version} of {owner}'s {type} package {name}.
        slots:
          version: path.version
          owner: path.owner
          type: path.type
          name: path.name
      - text: Remove only release {version} of package {name} ({type}) from {owner}.
        slots:
          version: path.version
          owner: path.owner
          type: path.type
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/packages/{owner}/{type}/{name}/{version}/files'].get
  update:
    x-apievangelist-phrasing:
      intent: List the files in a package version
      effect: read
      questions:
      - Which files make up a particular package version?
      - Can I see file sizes and hashes for a package release?
      instructions:
      - text: List the files in {name} {version} ({type}) owned by {owner}.
        slots:
          name: path.name
          version: path.version
          type: path.type
          owner: path.owner
      - text: Show the files and checksums for {owner}'s {type} package {name} version {version}.
        slots:
          name: path.name
          version: path.version
          type: path.type
          owner: path.owner
      method: generated
      generated: '2026-09-26'