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 = "",
  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.

The oracle continues your conversation: it sees everything said so far, and its reading and reasoning stay in your history when it hands back. Ask the question itself; there is no need to restate the context.

@param question - The question @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 extraTools - Extra tools to offer the LLM, appended to the built-in set

Called from code, this runs on the caller's thread like any function: the system prompt, the reads, and the answer stay there. Wrap the call in thread { ... } for an isolated consult.

Parameters:

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

Returns: Result<string>

Throws: std::guard

(source)