Hosted agents

1
import { z } from "zod";
2
3
// One natural-language action
4
await bctrl.runtimes.invocations.stagehand.act(runtime.id, {
5
  instruction: "Click the export button.",
6
});
7
8
// Inspect the page
9
await bctrl.runtimes.invocations.stagehand.observe(runtime.id, {
10
  instruction: "What filters are available?",
11
});
12
13
// Structured extraction
14
const result = await bctrl.runtimes.invocations.stagehand.extract(runtime.id, {
15
  instruction: "Extract the invoice total.",
16
  schema: z.object({ total: z.number() }),
17
});
18
19
// Multi-step agent flow
20
await bctrl.runtimes.invocations.stagehand.agent(runtime.id, {
21
  instruction: "Download every invoice from the last quarter.",
22
  maxSteps: 30,
23
});

1
await bctrl.runtimes.invocations.browserUse.agent(runtime.id, {
2
  instruction: "Find the cheapest flight to Lisbon and add it to the cart.",
3
  maxSteps: 50,
4
  useVision: "auto",
5
});

1
const invocation = await bctrl.runtimes.invocations.createAndWait(
2
  runtime.id,
3
  { action: "browserUse", instruction: "Reconcile this month's transactions." },
4
  { timeoutMs: 120_000 }
5
);
6
7
console.log(invocation.status, invocation.output);

1
await bctrl.runtimes.invocations.stagehand.agent(runtime.id, {
2
  instruction: "Summarize the dashboard.",
3
  aiProviderId: "aip_123",
4
  model: "claude-opus-4-8",
5
  temperature: 0.2,
6
});