Class: WebLLMChatCompletionsAdapter

Opinionated cross-environment LLM adapter for the WebLLM Chat Completions wire shape.

Remarks

Construction validates options eagerly via @nhtio/adk/batteries!validateOptions and throws @nhtio/adk/batteries!E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS on failure — config bugs fail loud, not at dispatch time. The returned instance is reusable: call WebLLMChatCompletionsAdapter.executor once per DispatchRunner configuration to obtain an @nhtio/adk!DispatchExecutorFn bound to the baseline plus optional executor-scope overrides.

Per-iteration overrides live on the active @nhtio/adk!DispatchContext's stash.webLLMChatCompletions slot and take highest precedence — they merge into the executor-scope shape on every iteration. helpers merge key-by-key across all three layers; every other field is replaced wholesale at the highest layer that sets it.

Constructors

Constructor

new WebLLMChatCompletionsAdapter(options: unknown): WebLLMChatCompletionsAdapter;

Parameters

Parameter	Type	Description
options	unknown	Constructor-baseline options. Re-validated on every iteration after per-dispatch and per-iteration overrides are layered in.

Returns

WebLLMChatCompletionsAdapter

Throws

@nhtio/adk/batteries!E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS when options does not satisfy @nhtio/adk/batteries!webLLMChatCompletionsOptionsSchema.

Properties

Property	Modifier	Type	Description
STASH_KEY	readonly	"webLLMChatCompletions"	Customary key for per-iteration overrides on ctx.stash. The adapter reads ctx.stash.get(WebLLMChatCompletionsAdapter.STASH_KEY, {}) at the start of every iteration and merges the value into the resolved options shape.

Methods

executor()

executor(overrides?: Partial<WebLLMChatCompletionsAdapterOptions>): DispatchExecutorFn;

Returns an @nhtio/adk!DispatchExecutorFn bound to this adapter's baseline plus optional executor-scope overrides. The returned function is reusable across iterations — every iteration re-merges with ctx.stash[STASH_KEY] and re-validates the result.

Parameters

Parameter	Type	Description
overrides?	Partial<WebLLMChatCompletionsAdapterOptions>	Optional executor-scope overrides. Higher precedence than the baseline, lower precedence than ctx.stash[STASH_KEY].

Returns

DispatchExecutorFn

An @nhtio/adk!DispatchExecutorFn suitable for DispatchRunner.

---

isAvailable()

isAvailable(): boolean;

Returns

boolean

---

preload()

preload(overrides?: Partial<WebLLMChatCompletionsAdapterOptions>): Promise<MLCEngineInterface>;

Parameters

Parameter	Type
overrides?	Partial<WebLLMChatCompletionsAdapterOptions>

Returns

Promise<MLCEngineInterface>

---

reset()

reset(): void;

Returns

void

---

isAvailable()

static isAvailable(): boolean;

Returns

boolean

---

isWebLLMChatCompletionsAdapter()

static isWebLLMChatCompletionsAdapter(value: unknown): value is WebLLMChatCompletionsAdapter;

Returns true when value is an WebLLMChatCompletionsAdapter instance.

Parameters

Parameter	Type	Description
value	unknown	The value to test.

Returns

value is WebLLMChatCompletionsAdapter

true when value is an WebLLMChatCompletionsAdapter instance.