Deterministic Agentic Care Capability

naftiko: 1.0.0-alpha2
info:
  title: Deterministic Agentic Care Capability
  description: A deterministic capability for healthcare agentic flows — same patient/encounter inputs yield same shaped care-plan context for clinician agents.
  tags: [Naftiko, Healthcare, Deterministic, Agentic]
  created: '2026-05-01'
  modified: '2026-05-04'
binds:
- namespace: fhir-env
  keys: {FHIR_HOST: FHIR_HOST, FHIR_TOKEN: FHIR_TOKEN}
capability:
  consumes:
  - namespace: fhir
    type: http
    baseUri: https://{{FHIR_HOST}}
    authentication: {type: bearer, token: '{{FHIR_TOKEN}}'}
    resources:
    - name: patient
      path: /Patient/{{patient_id}}
      operations:
      - {name: get-patient, method: GET, inputParameters: [{name: patient_id, in: path}]}
    - name: care-plans
      path: /CarePlan
      operations: [{name: search-care-plans, method: GET}]
    - name: encounters
      path: /Encounter
      operations: [{name: search-encounters, method: GET}]
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: deterministic-agentic-care-capability-rest
    description: REST surface for deterministic care context.
    resources:
    - name: care-context
      path: /patients/{{patient_id}}/care-context
      operations:
      - {method: GET, name: get-care-context, inputParameters: [{name: patient_id, in: path, type: string}], call: fhir.get-patient}
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: deterministic-agentic-care-capability-mcp
    description: MCP for deterministic care context.
    tools:
    - name: get-care-context
      hints: {readOnly: true}
      inputParameters: [{name: patient_id, type: string, required: true}]
      call: fhir.get-patient
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: deterministic-agentic-care-capability-skills
    description: Skill for deterministic care.
    skills:
    - name: deterministic-agentic-care-capability
      description: Deterministic care context.
      location: file:///opt/naftiko/skills/deterministic-agentic-care-capability
      allowed-tools: get-care-context
      tools:
      - {name: get-care-context, from: {sourceNamespace: deterministic-agentic-care-capability-mcp, action: get-care-context}}