configure() — Customize the Session

The configure tool manages your Gasoline session — filter noise, store data, query the DOM, compare snapshots, validate API contracts, and control streaming.

Quick Reference

configure({action: "noise_rule", noise_action: "auto_detect"})       // Auto-filter noise
configure({action: "query_dom", selector: ".error-banner"})          // Query live DOM
configure({action: "store", store_action: "save", key: "baseline", data: {...}})  // Save data
configure({action: "clear", buffer: "all"})                          // Clear all buffers
configure({action: "health"})                                        // Server health
configure({action: "diff_sessions", session_action: "capture", name: "v1"})  // Snapshot

---

noise_rule — Filter Irrelevant Errors

Manages noise rules that suppress irrelevant errors — browser extension noise, analytics failures, framework internals.

Auto-detect noise

configure({action: "noise_rule", noise_action: "auto_detect"})

Scans current errors and identifies patterns that are likely noise (extension errors, analytics, third-party scripts). Creates rules automatically.

Add a manual rule

configure({action: "noise_rule",
           noise_action: "add",
           pattern: "analytics\\.google",
           category: "console",
           reason: "Google Analytics noise"})

Parameter	Type	Description
noise_action	string	add, remove, list, reset, auto_detect
pattern	string	Regex pattern to match against error messages
category	string	Buffer: console, network, or websocket
reason	string	Human-readable explanation of why this is noise
rules	array	Batch-add multiple rules at once
rule_id	string	ID of rule to remove (for remove action)

List current rules

configure({action: "noise_rule", noise_action: "list"})

Remove a rule

configure({action: "noise_rule", noise_action: "remove", rule_id: "rule-123"})

Reset all rules

configure({action: "noise_rule", noise_action: "reset"})

---

store — Persistent Key-Value Storage

Save and load JSON data that persists across sessions. Useful for storing baselines, configuration, or any data the AI needs to remember.

Save data

configure({action: "store",
           store_action: "save",
           namespace: "baselines",
           key: "homepage-vitals",
           data: {lcp: 1200, cls: 0.05}})

Load data

configure({action: "store",
           store_action: "load",
           namespace: "baselines",
           key: "homepage-vitals"})

List keys

configure({action: "store", store_action: "list"})
configure({action: "store", store_action: "list", namespace: "baselines"})

Delete a key

configure({action: "store", store_action: "delete", key: "homepage-vitals"})

Storage stats

configure({action: "store", store_action: "stats"})

Parameter	Type	Description
store_action	string	save, load, list, delete, stats
namespace	string	Logical grouping for keys
key	string	Storage key
data	object	JSON data to persist (for save)

---

query_dom — Live DOM Queries

Query the live DOM using CSS selectors. Returns element details: tag, attributes, text content, visibility, and children.

configure({action: "query_dom", selector: ".error-banner"})
configure({action: "query_dom", selector: "nav a", tab_id: 123})
configure({action: "query_dom", selector: "[role='alert']"})
configure({action: "query_dom", selector: "form input[type='email']"})

Parameter	Type	Description
selector	string	CSS selector to query
tab_id	number	Target specific tab (omit for active tab)

Response includes

Field	Description
Tag name	div, button, input, etc.
Class list	Current CSS classes
Text content	Visible text
Attributes	id, role, aria-, data-, type, value
Computed state	Visibility, disabled status
Children	Child elements (limited depth)

---

clear — Clear Buffers

Remove captured data from memory.

configure({action: "clear", buffer: "all"})
configure({action: "clear", buffer: "network"})
configure({action: "clear", buffer: "logs"})

Parameter	Type	Description
buffer	string	network, websocket, actions, logs, all

---

diff_sessions — Session Snapshots & Comparison

Capture named snapshots of the current session state and compare them to detect changes.

Capture a snapshot

configure({action: "diff_sessions", session_action: "capture", name: "before-deploy"})

Compare two snapshots

configure({action: "diff_sessions",
           session_action: "compare",
           compare_a: "before-deploy",
           compare_b: "after-deploy"})

List snapshots

configure({action: "diff_sessions", session_action: "list"})

Delete a snapshot

configure({action: "diff_sessions", session_action: "delete", name: "old-snapshot"})

Parameter	Type	Description
session_action	string	capture, compare, list, delete
name	string	Snapshot name
compare_a	string	First snapshot (baseline)
compare_b	string	Second snapshot (comparison target)

---

validate_api — API Contract Validation

Infer API schemas from captured traffic and validate consistency.

configure({action: "validate_api", operation: "analyze"})
configure({action: "validate_api", operation: "report", url: "/api/users"})
configure({action: "validate_api", operation: "clear"})

Parameter	Type	Description
operation	string	analyze (infer schemas), report (show results), clear (reset)
url	string	Filter by URL substring
ignore_endpoints	array	URL substrings to exclude from analysis

---

audit_log — MCP Tool Usage History

View a log of all MCP tool calls made during the session. Useful for debugging, compliance, and understanding AI agent behavior.

configure({action: "audit_log"})
configure({action: "audit_log", tool_name: "observe", limit: 20})
configure({action: "audit_log", since: "2026-02-07T10:00:00Z"})

Parameter	Type	Description
tool_name	string	Filter by tool name
session_id	string	Filter by MCP session ID
since	string	Only entries after this ISO 8601 timestamp
limit	number	Maximum entries to return

---

streaming — Real-Time Event Streaming

Enable or disable real-time event notifications. When enabled, Gasoline proactively notifies the AI about errors, performance regressions, and security issues as they happen.

configure({action: "streaming", streaming_action: "enable",
           events: ["errors", "performance", "security"],
           severity_min: "warning",
           throttle_seconds: 5})

configure({action: "streaming", streaming_action: "disable"})
configure({action: "streaming", streaming_action: "status"})

Parameter	Type	Description
streaming_action	string	enable, disable, status
events	array	Categories: errors, network_errors, performance, user_frustration, security, regression, anomaly, ci, all
severity_min	string	Minimum severity: info, warning, error
throttle_seconds	integer	Minimum seconds between notifications (1-60)

---

health — Server Health

Check the Gasoline server’s status, uptime, buffer usage, and connected clients.

configure({action: "health"})

No additional parameters. Returns server version, uptime, buffer occupancy, client count, and rate limit status.

---

test_boundary_start / test_boundary_end — Test Boundaries

Mark the start and end of a test run. Events within boundaries can be correlated for test-specific analysis.

configure({action: "test_boundary_start", test_id: "checkout-flow", label: "Guest Checkout Test"})

// ... run the test ...

configure({action: "test_boundary_end", test_id: "checkout-flow"})

Parameter	Type	Description
test_id	string	Unique identifier for the test
label	string	Human-readable description