Logging

Stagehand logs log a LogLine object. You can override the default logger by passing in a custom logger function to the constructor.

const stagehand = new Stagehand({
	logger: (logLine: LogLine) => {
		console.log(`[${logLine.category}] ${logLine.message}`);
	},
});

Below is the list of fields in the LogLine object. message is the main log message content, and auxiliary contains parameters that can be used to provide additional context and color to the log.

You can see an example of a log line in OpenAIClient.ts. You’ll notice here how auxiliary contains a requestId and cachedResponse.

this.logger({
	category: "llm_cache",
	message: "LLM cache hit - returning cached response",
	level: 1,
	auxiliary: {
		requestId: {
			value: options.requestId,
			type: "string",
		},
		cachedResponse: {
			value: JSON.stringify(cachedResponse),
			type: "object",
		},
	}
});