Public API reference

Required Fenwild HTTP service origin with an optional path prefix.

Required named Bot access credential.

Stops startup, the live client, or a supervised runner.

WebSocket attempt deadline; defaults to 10 seconds, after a separate renewal request of up to 5 seconds.

Authority acknowledgement deadline; defaults to 10 seconds.

Local pending ceiling up to the authoritative maximum of eight.

Enabled by default: bounded startup retries for transient failures and a busy character, and recovery after an established session drops. A revoked or expired credential or an explicit control_superseded close always ends the pilot.

Initial recovery backoff delay.

Maximum recovery backoff delay.

Bounded credential-redacted trace capacity.

Bounded unread capacity of the reserved events() feed.

Bounded recent action-outcome capacity.

Receives owner-visible recording events.

Custom HTTP adapter for scoped POST /auth/session/renew. Defaults to global fetch; separate from socketFactory.

Custom standards-compatible WebSocket adapter.

Receives each change to connected, reconnecting or closed; a new pilot starts as connecting, which status() reports.

Reserved for event batches; the current server sends none, so it is not called.

Receives protocol errors from Fenwild, including the revoked or superseded verdict that ends a pilot, and a local recording_failed error when recordingSink throws. Socket failures are recorded in trace().

Handle a correlated authority rejection, then continue from later observations. Without this callback, the rejection stops the runner.

Discard uncertain local work after a timeout or disconnect and reconsider a fresh observation. Never retry the interrupted action or label it rejected. Without this callback the runner stops. Revocation, an explicit control_superseded close and deliberate shutdown still end the run.

The proposed action does not match an exact public action variant.

Authority rejected the action, for example as stale_intent, refused the connection, for example as character_in_use, or the recognized protocol message was invalid.

An in-flight action lost authoritative confirmation and must not be replayed blindly.

The configured pending-action ceiling is already full.

Fenwild no longer accepts the token because it was revoked or expired, while connected or at a reconnect; start again with a new token only.

Authority replaced this character’s control; the pilot stopped instead of reconnecting into that replacement. Bots on sibling characters run independently.

The connection ended before an operation could complete.

In-memory bounded PilotRecordingSink with snapshot() and clear().

Versioned document containing ordered owner-visible recording entries.

Observation, intent, outcome, Trading Post, market-tape or reserved event-batch entry.

Interface for an owner-controlled recording destination.

Reconstructed observation with market, history and recent outcomes; its event list stays empty today.

Current recording document version.

Build an identity-minimized learning input from an ordinary player snapshot.

Convert only authority-confirmed local demonstrations into a versioned dataset.

Combine independent journey-level splits while rejecting duplicate scenario and frame IDs.

Fit the deterministic bounded multiclass linear-softmax reference model on local CPU.

Report accuracy, per-label results, and confusion evidence for one split or the full corpus.

Score the supplied candidates (the reference set by default) by learned action type and return the best one. Candidates are parse-checked, not legality-checked.

The public baseline candidates: observe, the best-fitting carried heal, below half HP a rest inside the character's own Bank or the trip there, enable run, loot visible ground items, gather ready resources, or attack the nearest living NPC.

The deliberately simple default teacher that collect uses without --teacher.

Load an artifact as a normal PilotBrain for runPilot; it chooses among referencePilotCandidates.

Fail closed while loading a versioned dataset document.

Fail closed on incompatible features, labels, weights, versions, or metadata.

Validate public benchmark identity, thresholds, and reference reports.

Create a named token from a trusted browser-owner interface and return its secret once; it expires after 365 days.

List documented public token metadata for the owning character.

Revoke a named token and terminate its live realtime access.

The complete versioned public reference document.

Look up a public item and exact player-facing detail.

Look up a public NPC definition and exact drop table.

Look up a public service location and interaction range.

Look up an Artifice recipe.

Look up a combat style.

Query a signed world coordinate against the public movement grid.

Query a signed world coordinate against the public line-of-sight grid.

Report whether one tile step would cross a closed barrier edge.

Plan an advisory route with authority's movement rules; submit the final moveTo destination, not each step.

Derive the public Wilds level from a map row.