Agent Things API

The Agent Things extension uses the existing Agent API transport to communicate with things; it does not add a new top-level HTTP endpoint family.

Load the browser libraries

<script src="/Agent.js"></script>
<script src="/Agent.Things.js"></script>
<script src="/Events.js"></script>

Events.js is required for immediate asynchronous readout events. Without it, use Agent API polling. When the page is hosted on a different origin, identify the Neuron used for events and set the Agent API host:

<meta name="NEURON" content="neuron.example.com" />
<script>
  AgentAPI.IO.SetHost("neuron.example.com", true);
</script>

Configure CORS and cookies/tokens deliberately; do not expose an Agent API secret in browser code.

Concentrator operations

The extension can:

get capabilities;
list all/root/child data sources;
test for and retrieve a node;
list root and child nodes.

All calls address the remote device by JID and accept optional device, service, and user tokens. Node calls add source ID, node ID, and optional partition.

Sensor operations

Synchronous methods wait for the readout result:

const result = await AgentAPI.Things.Sensor.ReadStandaloneDevice(
  jid,
  language,
  true,  // momentary
  false, // peak
  true,  // status
  false, // computed
  false, // identity
  false, // historical
  ["Temperature"],
  null, null, null
);

Use the StartReadout... variants for asynchronous or fragmented reads. Supply a stable request ID and handle events until completion.

Concentrator-node read

Add the extended address:

const result = await AgentAPI.Things.Sensor.ReadConcentratorNode(
  jid, language,
  true, false, true, false, false, false,
  ["Temperature"],
  null, null, null,
  nodeId, sourceId, partition
);

Exact optional-argument ordering follows the library shipped by the target Neuron. Pin or feature-detect the client version and test against that server build.

Robust event handling

correlate on request ID;
accept fragmented field batches;
retain timestamps, units, quality flags, and node identity;
stop only on completion/error;
cancel abandoned readouts;
ignore duplicates after reconnect;
render device-provided names as untrusted text.

Platform overview

Platform concepts

Neuro-Ledger

Extend the Neuron

Neuron Script

Protocols

IoT

Operate the Neuron

Load the browser libraries

Concentrator operations

Sensor operations

Concentrator-node read

Robust event handling

​Load the browser libraries

​Concentrator operations

​Sensor operations

​Concentrator-node read

​Robust event handling

Load the browser libraries

Concentrator operations

Sensor operations

Concentrator-node read

Robust event handling