Skip to content
Registry

ade

(alias: console)v1.9.26

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

license: Apache-2.0adeadminconsoledashboarduiweb

Install

bash
iii trigger compose::add worker=ade@1.9.26

Run in your project with the iii engine running. Exact versions are immutable and digest-pinned.

Functions10

console::on-config-change

Function

Internal: re-apply the Console HTTP port and injectable-UI toggles when its 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::working-directory::inject-guidance

Function

Internal: append Console working-directory handoff guidance to Harness generations.

Request
  • generateobject
    • system_promptstring
    • toolsobject[]
      • namestringrequired
Response
  • mutationsobjectrequired
    • system_promptstring

console::working-directory::propose

Function

Propose switching the current session's working directory to a project created or cloned elsewhere; the console asks the user to confirm. Only when the user asked to continue there, never just to inspect a file.

Request
  • pathstringrequired

    Existing directory the user asked to continue working in.

  • reasonstring

    Short explanation shown with the confirmation.

  • session_idstring

    Authoritative Harness context. In-turn calls are stamped before dispatch.

  • turn_idstring

    Authoritative Harness turn. In-turn calls are stamped before dispatch.

Response
  • pathstringrequired
  • reasonstring
  • requires_confirmationbooleanrequired
  • session_idstringrequired

console::working-directory::stamp-session

Function

Internal: stamp the authoritative Harness session onto Console working-directory proposals.

Request
  • callany of
    any of (2)
    Variant 1
    • argumentsunknown
    Variant 2
    valuenull
  • session_idstring
  • turn_idstring
Response
any of (2)
Variant 1
  • decisionstringrequired
  • mutationsobjectrequired
    • argumentsunknownrequired
Variant 2
valuenull

console::workspace::close

Function

Remove a screen from the console workspace wherever it is shown. Pass `screen: chat` with `session_id` to close one pinned conversation panel. Idempotent: an unmounted screen returns an empty `tab_ids`.

Request
  • screenstringrequired
  • session_idstring

    With `screen: "chat"`, close only this conversation session panel.

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`, `chat:<session-id>`, `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 in the console workspace next to the conversation (reusing the tab that already shows it). Screens: `ext:shell` (files), `ext:browser`, `ext:editor`, `workers`, or `{"screen":"chat","session_id":"<id>"}` for a pinned chat.

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.

  • session_idstring

    With `screen: "chat"`, pin the panel to this conversation session.

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

Triggers3

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

Search the registry

Find workers, kits and executables, or jump to a page.