nabta-aya v1.5.7

Aya Component

This component represents the Aya chatbot screen presentation layer

Installation

npm install --save nabta-aya

Props

Sample Usage

import Chatbot from 'nabta-aya';
import { navigateAndReset } from '../utils/navigationUtils';
import NabtaButton from './NabtaButton';
import Selector from './Selector';
import { addBeliefRun } from '../utils/bdi';
import { connect } from 'react-redux';
import { bindActionCreators } from 'redux';
import { LocalizationContext } from'./Translations';
import { refreshInfo } from '../utils/refreshInfo.js';
import { ntohm } from '../utils/process.js';
import implementMachine from '../utils/aya/implementMachine';
import typicalProcess from '../utils/aya/typicalProcess';
import renderMessageText from '../utils/aya/renderMessageText';
import buttonOnlyCallback from '../utils/aya/buttonOnlyCallback';
import componentDidMount from '../utils/aya/componentDidMount';
import { getSendButton, getBubbleColor } from '../utils/aya/themes';
import canGoBack from '../utils/aya/canGoBack';

const PASSWORDSTATES = ["loginPasswordState", "signupPasswordState", "startupIncorrectPasswordState",
"invalidPasswordState", "confirmOldPasswordState", "invalidOldPasswordState",
"invalidNewPasswordState"];

const CODESTATES = ["emailCodeState", "codeErrorState", "resendCodeState",
"newEmailState", "resendCodeToEmailState", "invalidCodeState"];

const SELECTORSTATES = ["weightState", "goalWeightState","heightState", "bdateState",
"whenConceivedState", "lastPeriodState", "cycleLengthState",
"tryingToConceivePeriodState", "familyMethodsState", "locationState",
"covid19_dob", "covid19_height", "covid19_weight", "covid19_base",
"lastBabyBDState", "lastMiscarriageDateState", "covid19_taken_temp_value"];

const HIDECLOSEMACHINES = ["startupMachine", "startupContMachine", "signupMachine",
"PrepareForMenopauseSignupMachine", "GetFitAndHealthySignupMachine",
"MonitorMyPregnancySignupMachine", "TrackMyCycleSignupMachine"];

class Aya extends Component {

    static navigationOptions = {
      headerShown: false,
    };
    static contextType = LocalizationContext;

    render(){
        return(
            <Chatbot
                avatar={require("../assets/aya.png")}
                bdiEnvironment={global.environment}
                machines={global.machines}
                navigation={this.props.navigation}
                NabtaButton={NabtaButton}
                Selector={Selector}
                userInfo={this.props.userInfo}
                updateUserInfo={this.props.updateUserInfo}
                translations={this.context.translations}
                addBeliefRun={addBeliefRun}
                refreshInfo={refreshInfo}
                implementMachine={implementMachine}
                typicalProcess={typicalProcess}
                renderMessageText={renderMessageText}
                getBubbleColor={getBubbleColor}
                getSendButton={getSendButton}
                buttonOnlyCallback={buttonOnlyCallback}
                setAppLanguage={this.context.setAppLanguage}
                navigateToHome={() => {
                    navigateAndReset(ntohm(this.props.userInfo.mode));
                }}
                componentDidMount={componentDidMount}
                canGoBack={canGoBack}
                PASSWORDSTATES={PASSWORDSTATES}
                CODESTATES={CODESTATES}
                SELECTORSTATES={SELECTORSTATES}
                HIDECLOSEMACHINES={HIDECLOSEMACHINES}
            />
        );
    }
}

createFsm

This is a function that creates proper finite state machines from an interpretation of the machines described in a yaml file.

Usage

 this.createFsm = createFsm.bind(this);
 let yaml = require('js-yaml');
 let doc = yaml.safeLoad(yamlString);
 global.machines = this.createFsm(doc);

initiateBDIEngine

This is a function that initiates Aya's BDI engine. It takes the following parameters: 1. initialBeliefs: a JS object with the beliefs the agent will begin with 2. initialState: a JS object of the initial agent state. For Aya, the most important state variable is fsm, which is the current finite state machine. 3. desires: a JS list of desires. Each desire is a JS object with a name (string) a machine it invokes when it is activated (string) and a function that takes the agent beliefs and returns a boolean whether or not this desire should be activated. An example of desires is:

[
    {
        name: 'signup',
        condition: beliefs => !beliefs.logged_in && beliefs.requested_signup,
        fsm: 'signupMachine'
    },
    {
        name: 'logout',
        condition: beliefs => beliefs.requested_logout,
        fsm: 'startupMachine'
    }
]

4. disablers: a JS list of belief items that should be removed when a particular machine is invoked (so not to keep activating the desire and re-loading the machine). Each of the disablers is a JS object with a machine name (string) and a JS object of beliefs that should be changed (disabled) when this machine is invoked. An example of disablers is:

[
    {
        machine: 'startupMachine',
        changes: {
            starting_up: false,
            requested_logout: false,
        }
    },
    {
        machine: 'signupMachine',
        changes: {
            requested_signup: false,
        }
    }
];