oracle

the code, thinks, and returns a direct verdict.

Reach for it before acting, when a second opinion is worth more than another attempt: is this plan sound, does this already exist, why does this bug persist, what is wrong with this design. It reads and reasons; it never changes anything.

Sharp and narrow, where explorerAgent is broad and descriptive. Ask the oracle to judge one thing; ask the explorer to survey many.

Functions

buildTools

buildTools(): any[]

Return the oracle's tools. Read-only by design: it inspects, consults, and judges, and a reviewer that can edit is no longer a reviewer.

Returns: any[]

(source)

oracleAgent

oracleAgent(
  question: string,
  context: string = "",
  maxCost: number = $20.00,
  maxTime: number = 15m,
  model: string = "",
  provider: string = "",
  session: string = "",
  extraTools: any[] = [],
): Result<string>

Ask for a second opinion on a hard problem: whether a plan is sound, whether the code already exists, why a bug persists, what is wrong with a design. Reads the code and returns a written analysis ending in a concrete recommendation. It never changes anything.

Pass a self-contained question: this agent starts fresh and cannot see your conversation. Include the plan, the relevant file paths, and what you have already tried.

@param question - The question, with all the context needed to answer it @param context - Extra material folded into the prompt, or "" @param maxCost - Hard spend cap @param maxTime - Hard wall-clock cap @param model - Model override, or "" for the ambient model @param provider - Provider for the model override @param session - Session name to share a thread across calls, or "" for isolated @param extraTools - Extra tools to offer the LLM, appended to the built-in set

Parameters:

Name	Type	Default
question	string
context	string	""
maxCost	number	$20.00
maxTime	number	15m
model	string	""
provider	string	""
session	string	""
extraTools	any[]	[]

Returns: Result<string>

Throws: std::guard

(source)