skip to content
iii / worker
$worker

console

v1.9.10

Web console for iii — bundles the React UI and proxies the engine WebSocket on a single port.

iiiverified
1,072 installs35 in 7d3 today
install
$iii trigger compose::add worker=console@1.9.10
binarylicense: Apache-2.0adminconsoledashboarduiweb
  • macOS: arm64 · x64
  • Linux: arm64 · armv7 · x64
  • Windows: arm64 · x64 · x86
7functions3triggers1skills0depsv1.9.10version
repoiii-hq/workers

exact versions are immutable; binary and bundle artifacts are digest-pinned.

functions

7

console::on-config-change

function

Internal: re-apply the console's injectable-UI per-worker toggles when the console configuration entry changes.

request
empty object
response
  • okbooleanrequired

console::status

function

Return the console worker's runtime knobs: http_port, engine_url, and version.

request
empty object
response
  • engine_urlstringrequired

    iii engine WebSocket URL the worker is proxying to.

  • http_portinteger· uint16requiredmin 0

    TCP port the worker is serving the UI and `/ws` on.

  • versionstringrequired

    Worker version (matches `Cargo.toml`).

console::ui-content

function

Serve the console worker's injected console UI assets (content function for its console:script / console:style triggers).

request
  • pathstringrequired

    The asset path from the trigger config (e.g. `state/page.js`).

response
  • contentstringrequired

    The asset source, verbatim.

  • content_typestringrequired

    MIME type the console should serve the asset with.

console::ui-manifest

function

List the injected console UI assets currently loadable: path, kind (script/style), content hash, and style-lint warnings.

request
empty object
response
  • assetsobject[]required

    The loadable set: assets of per-worker-disabled workers are held but excluded here (and from tab syncs) until re-enabled.

    • hashstringrequired
    • kindstringrequiredenum: script, style

      Short asset kind — trigger type ids are `console:*`, kinds stay `script`/`style` in push payloads and the manifest.

    • pathstringrequired
    • warningsstring[]required
    • workerstring

      Best-effort registrant attribution. Not resolved in this build — always `null` (the `<worker>/` path prefix is the human-readable attribution).

  • disabledbooleanrequired

    `true` when the `injectable_ui` kill switch is off — the trigger types are unregistered and `/ui` + `/vendor` are not served.

  • workersobject[]required

    Per-worker summary — includes disabled workers (their toggle state lives in the console configuration's `injectableUi.disabledWorkers`).

    • assetsinteger· uintrequiredmin 0

      Number of registered assets (served only while enabled).

    • enabledbooleanrequired

      `false` while the worker is in the console configuration's `injectableUi.disabledWorkers` list.

    • workerstringrequired

      Worker name — the first segment of its asset paths.

console::workspace::close

function

Remove a screen from the console workspace wherever it is shown. Idempotent: an unmounted screen returns an empty `tab_ids`.

request
  • screenstringrequired
response
  • tab_idsstring[]required

    Tabs the screen was detached from; empty when it was not mounted.

console::workspace::list

function

List the console workspace the human sees: every tab with its columns and screens, plus which tab is active. Screens are `chat`, `traces`, `workers`, or `ext:<page>` for worker pages.

request
empty object
response
  • active_tab_idstringrequired
  • tabsobject[]required
    • activebooleanrequired
    • columnsinteger· uintrequiredmin 0
    • idstringrequired
    • namestring
    • screensstring[]required

      One entry per column; `null` is an empty column.

console::workspace::open

function

Show a screen to the human in the console workspace, next to the conversation. Reuses the tab that already shows it, else places it beside chat in the active tab, else opens a new chat + screen tab. Every browser on this engine updates. Use `ext:shell` for the file explorer, `ext:browser` for browser sessions, `ext:editor` for the editor, `workers` for the worker catalog.

request
  • activateboolean

    Make the tab holding the screen the active one (default true).

  • screenstringrequired

    `chat`, `traces`, `workers`, or `ext:<page-id>` for a worker page (`ext:shell`, `ext:browser`, `ext:editor`, ...).

response
  • activatedbooleanrequired
  • columninteger· uintrequiredmin 0
  • placementone ofrequired
    one of (4)
    variant 1
    valuestringenum: existing
    variant 2
    valuestringenum: empty_column
    variant 3
    valuestringenum: new_column
    variant 4
    valuestringenum: new_tab
  • screensstring[]required
  • tab_idstringrequired

triggers

3

console:assets

trigger

A console tab's live-update subscription. The trigger's function_id is the per-tab handler the console pushes sync/set/delete asset events to.

invocation
empty object
return
valueunknown

console:script

trigger

An ESM JavaScript asset injected into the console UI. `config.path` is the asset identity (re-registering a path overrides it); the trigger's function_id is the content function the console fetches source from.

invocation
  • pathstringrequired

    Asset identity. Convention: `<worker>/<name>.<ext>`. Re-registering a path overrides it.

return
valueunknown

console:style

trigger

A CSS asset injected into the console UI. Same contract as console:script with a .css path.

invocation
  • pathstringrequired

    Asset identity. Convention: `<worker>/<name>.<ext>`. Re-registering a path overrides it.

return
valueunknown