Browser quickstart

The @tuist/condukt package runs Condukt's portable state machine through WebAssembly. The web application supplies inference and the complete tool registry.

Install the package#

Add the package from the npm registry:

bash

npm install @tuist/condukt

Create an agent#

javascript

import {createAgent, createHttpInference} from "@tuist/condukt"

const agent = await createAgent({
  inference: createHttpInference({
    endpoint: "/api/completions",
    model: "openrouter/auto",
  }),
  systemPrompt: "Help the developer understand this page.",
  tools: [{
    name: "read_page",
    description: "Read the public content on the page.",
    parameters: {type: "object", properties: {}},
    execute: () => document.querySelector("main").innerText,
  }],
})

createHttpInference sends provider-neutral completion requests to a same-origin endpoint. The server can own the provider credential so it never enters page JavaScript or WebAssembly memory.

Run a user turn#

run is an asynchronous event stream. Render the events that matter to the application:

javascript

for await (const event of agent.run("What can I do here?")) {
  if (event.type === "assistant_message") renderMessage(event.message)
  if (event.type === "tool_call") renderToolActivity(event.call)
  if (event.type === "complete") scrollToLatestMessage()
}

The same agent instance retains conversation history across turns. Call free() when the host no longer needs it.

Register narrow tools#

Browser tools are ordinary asynchronous functions. Treat the registry as an authority boundary:

Register only capabilities the current page should expose.
Validate arguments before performing navigation or network requests.
Limit response sizes before returning content to the model.
Pass the provided cancellation signal to fetch and other cancellable work.

A browser host does not receive filesystem or shell tools unless the application explicitly builds and registers equivalent capabilities.

Next, learn how to provide inference, define explicit tools, or inspect the complete browser package reference.