iii / worker
$worker

iii-state

v0.11.6-next.3

Distributed key-value state management with reactive change triggers.

engine module
baked into the iii engine; no separate install required.

functions

6

state::delete

function

Delete a value from state

request
  • keystringrequired
  • scopestringrequired
response
valueunknown

state::get

function

Get a value from state

request
  • keystringrequired
  • scopestringrequired
response
valueunknown

state::list

function

Get a group from state

request
  • scopestringrequired
response
valueunknown

state::list_groups

function

List all state groups

request
empty object
response
  • groupsstring[]required

state::set

function

Set a value in state

request
  • keystringrequired
  • scopestringrequired
  • valueunknownrequired
response
  • new_valueunknownrequired

    The value after the update

  • old_valueunknown

    The value before the update (None if key didn't exist)

state::update

function

Update a value in state

request
  • keystringrequired
  • opsone of[]required
    one of (6)
    variant 1
    • pathstringrequired

      Represents a path to a field in a JSON object

    • typestringrequiredenum: set
    • valueunknown
    variant 2
    • pathany of
      … expand 2 nested
      any of (2)
      variant 1
      any of (2)
      variant 1
      valuestring
      variant 2
      itemsstring[]
      variant 2
      valuenull
    • typestringrequiredenum: merge
    • valueunknownrequired
    variant 3
    • byinteger· int64required
    • pathstringrequired

      Represents a path to a field in a JSON object

    • typestringrequiredenum: increment
    variant 4
    • byinteger· int64required
    • pathstringrequired

      Represents a path to a field in a JSON object

    • typestringrequiredenum: decrement
    variant 5
    • pathstringrequired

      Represents a path to a field in a JSON object

    • typestringrequiredenum: append
    • valueunknownrequired
    variant 6
    • pathstringrequired

      Represents a path to a field in a JSON object

    • typestringrequiredenum: remove
  • scopestringrequired
response
  • errorsobject[]

    Errors encountered while applying ops. Successfully applied ops are still reflected in `new_value`. Field is omitted from JSON when empty for backward compatibility.

    • codestringrequired

      Stable error code, e.g. `"merge.path.too_deep"`.

    • doc_urlstring

      Optional documentation URL for this error class.

    • messagestringrequired

      Human-readable description with concrete numbers when applicable.

    • op_indexinteger· uintrequiredmin 0

      Index of the offending op within the original `ops` array.

  • new_valueunknownrequired

    The value after the update

  • old_valueunknown

    The value before the update (None if key didn't exist)

triggers

2

state

trigger

State trigger

invocation
  • condition_function_idstring

    Optional function ID to evaluate before invoking handler

  • keystring

    State key to watch (exact match filter)

  • scopestring

    State scope to watch (exact match filter)

return
  • event_typeall ofrequired

    Type of state change

    all of (1)
    variant 1
    valuestringenum: state:created, state:updated, state:deleted
  • keystringrequired

    State key

  • new_valueunknownrequired

    New value

  • old_valueunknown

    Previous value (null for created events)

  • scopestringrequired

    State scope

  • typestringrequired

    Always "state"

log

trigger

Log event trigger

invocation
  • levelany of

    Minimum log level to trigger on

    any of (2)
    variant 1
    valuestringenum: all, debug, info, warn, error
    variant 2
    valuenull
return
  • attributesunknownrequired

    Log attributes

  • bodystringrequired

    Log message body

  • instrumentation_scope_namestringrequired

    Instrumentation scope name

  • instrumentation_scope_versionstringrequired

    Instrumentation scope version

  • observed_timestamp_unix_nanointeger· uint64requiredmin 0

    Observed timestamp in nanoseconds

  • resourceunknownrequired

    OpenTelemetry resource

  • service_namestringrequired

    Service name

  • severity_numberinteger· uint32requiredmin 0

    Severity number (OpenTelemetry)

  • severity_textstringrequired

    Severity text (e.g. INFO, ERROR)

  • span_idstringrequired

    Span ID

  • timestamp_unix_nanointeger· uint64requiredmin 0

    Log timestamp in nanoseconds

  • trace_idstringrequired

    Trace ID