# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Thehiveryiq Com Morso API
  version: 1.0.0
extends: openapi/thehiveryiq-com-morso-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: 6
- target: $.paths['/v1/morso/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the MORSO service health
      effect: read
      questions:
      - Is the MORSO excerpt receipt service up?
      - Can I ping MORSO before issuing excerpt receipts?
      instructions:
      - text: Check MORSO health.
      - text: Confirm the MORSO service is responding.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morso/issue'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue a MORSO excerpt from a sealed parent
      effect: write
      questions:
      - How do I issue a MORSO for an excerpt taken from a sealed parent document?
      - Can I supply my own excerpt commitment when issuing a MORSO?
      instructions:
      - text: Issue a MORSO for excerpt "{excerpt}" from parent {parent_mor} sealed as {sealed_parent}.
        slots:
          excerpt: requestBody.excerpt
          parent_mor: requestBody.parent_mor
          sealed_parent: requestBody.sealed_parent
      - text: Issue excerpt {excerpt} under parent MOR {parent_mor} and sealed parent {sealed_parent} with commitment {excerpt_commitment}.
        slots:
          excerpt: requestBody.excerpt
          parent_mor: requestBody.parent_mor
          sealed_parent: requestBody.sealed_parent
          excerpt_commitment: requestBody.excerpt_commitment
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morso/receipt'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a signed receipt for an excerpt
      effect: write
      questions:
      - How do I get a signed MORSO receipt proving an excerpt came from its parent?
      - What goes into a signed excerpt receipt request?
      instructions:
      - text: Create a signed MORSO receipt for excerpt "{excerpt}" of parent {parent_mor}, sealed {sealed_parent}.
        slots:
          excerpt: requestBody.excerpt
          parent_mor: requestBody.parent_mor
          sealed_parent: requestBody.sealed_parent
      - text: Receipt excerpt {excerpt} against sealed parent {sealed_parent} and MOR {parent_mor}.
        slots:
          excerpt: requestBody.excerpt
          sealed_parent: requestBody.sealed_parent
          parent_mor: requestBody.parent_mor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morso/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a MORSO receipt
      effect: read
      questions:
      - Is this MORSO excerpt receipt genuine?
      - Can I check a MORSO receipt's signature?
      instructions:
      - text: Verify MORSO receipt {receipt}.
        slots:
          receipt: requestBody.receipt
      - text: Check the signature on excerpt receipt {receipt}.
        slots:
          receipt: requestBody.receipt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morso/classify'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview how an excerpt would be classified
      effect: read
      questions:
      - Can I see how an excerpt would be classified without getting a signed receipt?
      - What classification would MORSO give this excerpt?
      instructions:
      - text: Classify excerpt "{excerpt}" from sealed parent {sealed_parent} as a preview.
        slots:
          excerpt: requestBody.excerpt
          sealed_parent: requestBody.sealed_parent
      - text: Preview the classification of {excerpt} against {sealed_parent} without signing.
        slots:
          excerpt: requestBody.excerpt
          sealed_parent: requestBody.sealed_parent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/morso/examples'].get
  update:
    x-apievangelist-phrasing:
      intent: Get example MORSO payloads
      effect: read
      questions:
      - Are there sample requests I can copy for MORSO?
      - What do MORSO example payloads look like?
      instructions:
      - text: Show MORSO examples.
      - text: Get sample MORSO requests to start from.
      method: generated
      generated: '2026-09-26'