ars9/liqa

Files

T

ars9 0e47623a6b feat(browser,mcp): resolve environment and credentials from DB in exec

- POST /exec now accepts environmentId (UUID) and credentials (alias → UUID)
  instead of raw payloads; resolves entities via EnvironmentService and
  CredentialService before passing data to browserService.exec
- exec_code MCP tool updated with same schema: environmentId + credentials map
- CredentialModule imported into BrowserModule and McpModule
- docs(scenario): rewrite script runtime section for single context argument
- docs(mcp): update exec_code description to reflect new parameter shapes
- style: reorder imports across server source (formatter)

2026-04-14 18:09:28 +03:00

2.1 KiB

Raw Blame History

MCP tools

The MCP endpoint is exposed at /mcp (Streamable HTTP transport).

The server currently registers the following tools.

Sessions

Tool	Description
`list_sessions`	List stored sessions (paginated)
`delete_session`	Delete a session by UUID

Environments

Tool	Description
`list_environments`	List environments (paginated)
`get_environment`	Get one environment by UUID
`create_environment`	Create environment (`name`, `urls`)
`update_environment`	Update environment (`id`, optional `name`/`urls`)
`delete_environment`	Delete environment by UUID

urls is a free-form key/value map. Common keys: id_url, cabinet_url, admin_url.

Browser (ad-hoc)

Tool	Description
`open_url`	Open URL with optional `sessionName`, return page/title/content
`exec_code`	Execute Playwright JS — script receives a single `context` argument (see `scenario.md`). Optional `environmentId` (UUID) resolves environment from DB for `context.getEnv()`. Optional `credentials` (`{ alias: credentialUUID }`) resolves credentials from DB for `context.getCredential(alias)`.

Scenarios

Tool	Description
`list_scenarios`	List scenarios (paginated)
`get_scenario`	Get scenario with steps
`create_scenario`	Create scenario by `name`
`update_scenario`	Rename scenario
`delete_scenario`	Delete scenario
`create_scenario_step`	Add step to scenario
`get_scenario_step`	Get one step
`update_scenario_step`	Update step fields
`delete_scenario_step`	Delete step
`list_scenario_runs`	List runs for a scenario
`run_scenario`	Trigger run for scenario
`get_scenario_run`	Get run with step runs and logs
`wait_for_scenario_run`	Wait until run is `pass` or `fail`
`export_scenario`	Export scenario payload
`import_scenario`	Import scenario payload

Notes

Tool IDs and entity IDs are UUIDs.
create_scenario_step schema still accepts legacy type/sessionName fields for compatibility. Current scheduler executes execCode plus optional validateCode and does not branch by step type.

2.1 KiB Raw Blame History