kind: uapf.resources.mapping

# Host-readable contract for the capability-backed service tasks. The three
# DMN decisions (assess-personal-data-risk, gdpr-processing-route,
# human-validation-gate) are NOT listed here: they are evaluated by the
# UAPF runtime against the dmn/ cornerstone and need no host resource.

targets:
  - id: agent.semantic-extractor
    type: ai_agent
    name: Semantic Extraction AI Agent
    description: |
      Host-provided agent fulfilling ai.redact@1, ai.extract@1 and
      event.emit@1. Implementation is the host's choice; this package
      supplies the BPMN flow, the DMN decision logic, the output schema
      and the guardrails.
    capabilities:
      - capability.ai.redact
      - capability.ai.extract
      - capability.event.emit

bindings:
  - source: { type: bpmn.serviceTask, ref: Task_DetectRedactPii }
    targetId: agent.semantic-extractor
    mode: autonomous
    contract:
      input:
        - { name: content, type: string, required: true }
      output:
        - { name: redactedContent,     type: string,  description: "Source text with PII masked." }
        - { name: detectedEntityTypes, type: array,   description: "PII TYPE names only, never values." }
        - { name: personasKodaPresent, type: boolean, description: "Latvian national ID regex hit." }
        - { name: financialDataPresent,type: boolean, description: "IBAN regex hit." }
        - { name: contactDataPresent,  type: boolean, description: "E-mail or phone regex hit." }
        - { name: piiCategoryCount,    type: number,  description: "Count of distinct PII categories detected." }
      timeout: "10s"
    requiredCapabilities: [capability.ai.redact]
    feeds: [assess-personal-data-risk]

  - source: { type: bpmn.serviceTask, ref: Task_ExtractSemantics }
    targetId: agent.semantic-extractor
    mode: autonomous
    contract:
      input:
        - { name: redactedContent, type: string, required: true }
        - { name: schemaRef,       type: string, required: true, description: "resources/schemas/vdvc-semantic-summary.schema.json" }
      output:
        - { name: semanticSummary,     type: object, description: "Validates against the VDVC v1.1 schema." }
        - { name: sensitivityControl,  type: object }
        - { name: aiConfidenceScore,   type: number, description: "Flat 0.0-1.0; consumed by human-validation-gate." }
        - { name: outputPiiErrorCount, type: number, description: "PII re-scan hits on extracted text; consumed by human-validation-gate." }
      timeout: "30s"
      retries: { maxAttempts: 2, backoffMs: 2000 }
    requiredCapabilities: [capability.ai.extract]
    feeds: [human-validation-gate]

  - source: { type: bpmn.serviceTask, ref: Task_EmitResult }
    targetId: agent.semantic-extractor
    mode: autonomous
    contract:
      input:
        - { name: eventType, type: string, required: true }
        - { name: payload,   type: object, required: true }
      timeout: "5s"
    requiredCapabilities: [capability.event.emit]