const report = await agent.research({
  topic: 'State of AI agent commerce and x402 adoption in 2026',
  depth: 'deep',          // 'quick' | 'deep'
  maxCost: 2.50,
  memo: 'market landscape report',
});
// report.{ report_content, sources: [{ url, title? }], sources_count, topic, depth, report_gcs_uri }
console.log(report.report_content);
report.sources.forEach(s => console.log(s.url));

Options (ResearchToolOptions): topic (required) and depth ('quick' | 'deep', default deep). This is an async job — polls to completion by default; pass wait: false for a request_id.

Web search — `agent.webSearch(options)`

const out = await agent.webSearch({ query: 'x402 payment protocol spec', max_results: 10 });
// out.results: [{ url, title, description }], out.result_count

max_results defaults to 5.

Read a URL — `agent.webRead(options)`

const page = await agent.webRead({ url: 'https://example.com/article' });
// page.{ markdown, screenshot_url?, metadata: { title, description, statusCode? }, truncated? }

Returns the page rendered to clean markdown plus a screenshot URL — useful for grounding the agent on a specific source before acting.

Pricing

research cost varies by depth; web search and web read are low per-call. See current per-tool pricing at https://docs.oneshotagent.com/pricing.

Pass maxCost on research (variable by depth/sources). For broader person-specific intelligence (dossiers, social profiles, articles about a person), use the oneshot-enrichment skill.

Web search — agent.webSearch(options)

Read a URL — agent.webRead(options)

Pricing

Web search — `agent.webSearch(options)`

Read a URL — `agent.webRead(options)`

oneshot-research

OneShot — Research & Web

Deep research — agent.research(options)

Deep research — `agent.research(options)`