JaCaMo REST provides a REST API to interact with agents, artifacts and organisations.

Include jacamo-rest dependency in build.gradle:

repositories {
    mavenCentral()

    maven { url "https://raw.github.com/jacamo-lang/mvn-repo/master" }
    maven { url "http://jacamo.sourceforge.net/maven2" }

}

dependencies {
    compile 'org.jacamo:jacamo-rest:0.5'
}

and start the API server in your .jcm application file:

mas yourmas {

    ...

    // starts rest api on port 8080 (and zookeeper on 2181)
    platform: jacamo.rest.JCMRest("--main 2181 --restPort 8080")

}

• Each agent has REST endpoints to receive messages and be inspected.
• ZooKeeper is used for name service. Bob can send a message to marcos using its name. ZooKeeper maps the name to a URL.
• DF service is provided also by ZooKeeper.
• Java JAX-RS is used for the API.
• For more information, see the paper: Towards Jacamo-rest: A Resource-Oriented Abstraction for Managing Multi-Agent Systems
• Information for developers and how to contribute can be found at contributing.

• Full documentation: jacamo-rest 0.5
• All endpoints accepts OPTIONS returning allowed verbs

• GET /overview: Returns MAS overview and all links

• GET; POST /agents: Retrieves agents collection - works as white pages - (with links); append an agent.
• GET; DELETE ../{agentuid}: Returns agent data (mind, bb and intentions (obs 1); remove.
• GET; POST ../{agentuid}/plans Retrieves plans of the specified agent; append a plan.
• GET ../{agentuid}/log Returns log of the specified agent.
• POST ../{agentuid}/command Posts a new command.
• POST ../{agentname}/inbox Posts a new message.
• GET; POST ../{agentuid}/services Returns services provided by the specified agent; add a service to the agent.

(obs 1) /code is only provided in jacamo-web

• GET; POST /workspaces: Retrieves workspaces collection (with links); append a workspace.
• GET; POST ../{workspaceuid}/artifacts Retrieves artifacts collection; append an artifact.
• GET ../{workspaceuid}/artifacts/{artifactuid} Returns artifact data.
• GET /workspaces/{workspaceuid}/artifacts/{artifactuid}/properties/{obspropsuid} Returns obs props data.
• POST /workspaces/{workspaceuid}/artifacts/{artifactuid}/operations/{operationid}/execute Execute operation.

• GET /organisations: Retrieves organisations collection.
• GET ../{organisationuid} Returns organisation data (with links to artifacts).
• POST ../{organisationuid}/roles append a role.

• GET /services: Retrieves services collection and agents that provide them - works as yellow pages