OPAL

This is a repository for experimenting with an implementation of our language for coordinating learning systems for assistant tasks.

The Markdown documents in the docs/ directory are rendered with Madoko and published on every push to a directory on Adrian's server.

Building

Command Line

Provided you have Node.js and npm:

• Install the dependencies: npm install
• Build the examples: npm build
• Run one of the examples: node build/examples/schedule.js

Visual Studio

You can build OPAL using Visual Studio 2015. You will need both its Node.js Tools and an independent installation of the latest official Node.js, which you can get from nodejs.org. Here's how:

• Open the solution file.
• Right-click the npm item under the opal project and choose "Install Missing npm Packages." This gets the project's dependencies.
• Hit F5 to build and run the example program. Ignore the scary warning that Visual Studio for some reason emits.

Visual Studio Code

Visual Studio Code has great IDE support for TypeScript, but the build system is kind of broken. So you're probably best off using the command-line route to build and run the project.

Using the Office Examples

Our examples use the Office 365 API. To run them, you'll need to log in and authorize the OPAL application to access your data. Here's how to do that:

• Go to the office365Auth directory in this repository.
• Install the tool's dependencies: npm install
• Run the authorization script: node getOfficeAuthToken.js
• Your browser will open. Follow the link to log in.

The script puts your email address and a token in text files inside your home directory. The credentials expire after an hour.