Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ixo.world/llms.txt

Use this file to discover all available pages before exploring further.

Source: packages/oracle-runtime/src/plugins/portal/
AttributeValue
Visibilityon-demand
Stabilitystable
Categoryui
Default stateOn
Depends on

Summary

The Portal frontend declares its available browser tools on each request via state.browserTools. The plugin wraps each declared tool into a PluginTool and exposes a sub-agent (call_portal_agent) that the main agent can delegate to. If no browser tools are declared, the plugin contributes nothing.

Environment variables

This plugin has no required env vars.

What it contributes

  • Tools: none directly — tools are owned by the per-request sub-agent.
  • Sub-agents: call_portal_agent — built only when state.browserTools is non-empty.
  • Middleware: none.
  • HTTP routes: none.
  • Shared state: none.

Opt out / Opt in

const app = await createOracleApp({
  config,
  features: { portal: false }, // never load
  // features: { portal: true }, // force load (default)
});

When to use it

  • The user asks for an action the Portal frontend exposes as a browser tool (declared in state.browserTools).
  • A task needs a browser-side capability the server cannot do alone — open a URL in the user’s tab, click a Portal button, fill a form.

When NOT to use it

  • No browser tools are declared on this request — the sub-agent is not built.
  • The task can be completed purely server-side — use a server tool or a different sub-agent.

Add a sub-agent

Build a per-request sub-agent like Portal’s.

agui

Sibling FE-declared-tools plugin for AG-UI components.