Skip to content
Harmony docs

Records

Records are a list of values permanently stored in the browser and server. Values can be read by agents (if they are not secret) and written by agents (if they are mutable). Also, records may be embedded into any tool argument using $harmony.records.value_name or $harmony.secrets.secret_name.

Tools read_record and write_record can be used to read and write values (but not secrets). The value should be mutable to be available for write_record.

Data

  • Key is a records value name, under which it is accessible for humans and AIs.

  • Value is the value in records.

  • Secret controls whether a value is available for read_record. If selected, the value is only available for embedding using $harmony.secrets.secret_name. Secret values are openly stored in the browser extension records but are encrypted before sending to the server.

  • Mutable controls if a value can be modified using write_record.