$worker

iii-bridge

v0.11.6-next.3

Connect to another iii instance over iii-sdk to expose and forward functions.

engine module

baked into the iii engine; no separate install required.

agent-ready brief for v0.11.6-next.3

install + config + dependencies + readme + api reference, all in one place. fetch as agent-context.md for an llm to consume.

full markdown

open as agent-context.md

the same content rendered as discrete blocks below is exposed as a single markdown document at /workers/iii-bridge.md?version=0.11.6-next.3. paste it into an llm prompt or pipe it through curl from a worker.

install

$iii worker add iii-bridge@0.11.6-next.3

dependencies

no dependencies for v0.11.6-next.3

readme

README.md

iii-bridge

Connects this III Engine instance to another III instance over iii-sdk so you can expose local functions to the remote instance and forward local calls to remote functions.

Sample Configuration

- name: iii-bridge
  config:
    url: ${REMOTE_III_URL:ws://0.0.0.0:49134}
    service_id: bridge-client
    service_name: bridge-client
    expose:
      - local_function: engine::log::info
        remote_function: engine::log::info

    forward:
      - local_function: remote::state::get
        remote_function: state::get
        timeout_ms: 5000

      - local_function: remote::state::set
        remote_function: state::set
        timeout_ms: 5000

      - local_function: remote::state::delete
        remote_function: state::delete
        timeout_ms: 5000

Configuration

Field	Type	Description
`url`	string	WebSocket URL of the remote III instance. Defaults to `III_URL` env var, otherwise `ws://0.0.0.0:49134`.
`service_id`	string	Service identifier to register with the remote instance.
`service_name`	string	Human-readable service name. Defaults to `service_id`.
`expose`	ExposeFunctionConfig[]	Functions from this instance to expose to the remote instance.
`forward`	ForwardFunctionConfig[]	Local function aliases that forward invocations to remote functions.

ExposeFunctionConfig

Field	Type	Description
`local_function`	string	Required. Local function the remote instance will call.
`remote_function`	string	Function path to register on the remote instance. Defaults to `local_function`.

ForwardFunctionConfig

Field	Type	Description
`local_function`	string	Required. Function path to register locally.
`remote_function`	string	Required. Remote function path to invoke when the local alias is called.
`timeout_ms`	number	Override the invocation timeout in milliseconds. Defaults to `30000`.

Functions

`bridge.invoke`

Invoke a function on the remote III instance and wait for its response.

Field	Type	Description
`function_id`	string	Required. Remote function ID to invoke.
`data`	any	Payload to send to the remote function.
`timeout_ms`	number	Override the invocation timeout in milliseconds.

Returns the remote function's response value directly.

`bridge.invoke_async`

Fire-and-forget invoke on the remote III instance.

Field	Type	Description
`function_id`	string	Required. Remote function ID to invoke.
`data`	any	Payload to send to the remote function.

api reference (json)

agent-api-reference.json

{
  "functions": [
    {
      "description": "Invoke a function on the remote III instance",
      "metadata": {},
      "name": "bridge.invoke",
      "request_schema": {},
      "response_schema": {}
    },
    {
      "description": "Fire-and-forget invoke on the remote III instance",
      "metadata": {},
      "name": "bridge.invoke_async",
      "request_schema": {},
      "response_schema": {}
    }
  ],
  "triggers": [
    {
      "description": "Log event trigger",
      "invocation_schema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "definitions": {
          "LogLevel": {
            "enum": [
              "all",
              "debug",
              "info",
              "warn",
              "error"
            ],
            "type": "string"
          }
        },
        "properties": {
          "level": {
            "anyOf": [
              {
                "$ref": "#/definitions/LogLevel"
              },
              {
                "type": "null"
              }
            ],
            "default": "all",
            "description": "Minimum log level to trigger on"
          }
        },
        "title": "LogTriggerConfig",
        "type": "object"
      },
      "metadata": {},
      "name": "log",
      "return_schema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "attributes": {
            "description": "Log attributes"
          },
          "body": {
            "description": "Log message body",
            "type": "string"
          },
          "instrumentation_scope_name": {
            "description": "Instrumentation scope name",
            "type": "string"
          },
          "instrumentation_scope_version": {
            "description": "Instrumentation scope version",
            "type": "string"
          },
          "observed_timestamp_unix_nano": {
            "description": "Observed timestamp in nanoseconds",
            "format": "uint64",
            "minimum": 0,
            "type": "integer"
          },
          "resource": {
            "description": "OpenTelemetry resource"
          },
          "service_name": {
            "description": "Service name",
            "type": "string"
          },
          "severity_number": {
            "description": "Severity number (OpenTelemetry)",
            "format": "uint32",
            "minimum": 0,
            "type": "integer"
          },
          "severity_text": {
            "description": "Severity text (e.g. INFO, ERROR)",
            "type": "string"
          },
          "span_id": {
            "description": "Span ID",
            "type": "string"
          },
          "timestamp_unix_nano": {
            "description": "Log timestamp in nanoseconds",
            "format": "uint64",
            "minimum": 0,
            "type": "integer"
          },
          "trace_id": {
            "description": "Trace ID",
            "type": "string"
          }
        },
        "required": [
          "attributes",
          "body",
          "instrumentation_scope_name",
          "instrumentation_scope_version",
          "observed_timestamp_unix_nano",
          "resource",
          "service_name",
          "severity_number",
          "severity_text",
          "span_id",
          "timestamp_unix_nano",
          "trace_id"
        ],
        "title": "LogCallRequest",
        "type": "object"
      }
    }
  ]
}