Adaptive Helpers

Generated from crates/node/adaptive.d.ts.

Import from nemo-relay-node/adaptive.

Adaptive plugin configuration helpers.

Interfaces

BackendSpec

Adaptive state backend selection.

1
export interface BackendSpec {
2
  kind: string;
3
  config?: Record<string, Json>;
4
}

StateConfig

Adaptive state configuration.

1
export interface StateConfig {
2
  backend: BackendSpec;
3
}

TelemetryConfig

Built-in adaptive telemetry settings.

1
export interface TelemetryConfig {
2
  subscriber_name?: string;
3
  learners?: string[];
4
}

AdaptiveHintsConfig

Built-in adaptive hints injection settings.

1
export interface AdaptiveHintsConfig {
2
  priority?: number;
3
  break_chain?: boolean;
4
  inject_header?: boolean;
5
  inject_body_path?: string;
6
}

ToolParallelismConfig

Built-in adaptive tool scheduling settings.

1
export interface ToolParallelismConfig {
2
  priority?: number;
3
  mode?: 'observe_only' | 'inject_hints' | 'schedule' | string;
4
}

AcgStabilityThresholds

ACG prompt-stability classification thresholds.

1
export interface AcgStabilityThresholds {
2
  stable_threshold?: number;
3
  semi_stable_threshold?: number;
4
  min_observations_for_full_confidence?: number;
5
}

AcgConfig

Adaptive cache-governor settings.

1
export interface AcgConfig {
2
  provider?: 'anthropic' | 'openai' | 'passthrough' | string;
3
  observation_window?: number;
4
  priority?: number;
5
  stability_thresholds?: AcgStabilityThresholds;
6
}

Config

Canonical config object for the top-level adaptive component.

1
export interface Config {
2
  version?: number;
3
  agent_id?: string;
4
  state?: StateConfig;
5
  telemetry?: TelemetryConfig;
6
  adaptive_hints?: AdaptiveHintsConfig;
7
  tool_parallelism?: ToolParallelismConfig;
8
  acg?: AcgConfig;
9
  policy?: ConfigPolicy;
10
}

ComponentSpec interface

Top-level adaptive component wrapper with fixed kind adaptive.

1
export interface ComponentSpec {
2
  kind: 'adaptive';
3
  enabled?: boolean;
4
  config: Config;
5
}

Functions

defaultConfig

Create a default adaptive component config.

Returns the minimal top-level adaptive config shape with version = 1 so callers can add state, telemetry, and scheduler settings incrementally.

Returns

A new adaptive config object.

Remarks

The returned object is detached from runtime state until it is wrapped with ComponentSpec and activated through the plugin system.

1
export declare function defaultConfig(): Config;

inMemoryBackend

Create an in-memory adaptive state backend spec.

Produces the backend descriptor for ephemeral adaptive state stored inside the current process rather than an external datastore.

Returns

An adaptive backend spec using in-memory storage.

Remarks

This backend does not persist state across process restarts.

1
export declare function inMemoryBackend(): BackendSpec;

redisBackend

Create a Redis-backed adaptive state backend spec.

Produces the backend descriptor expected by the adaptive plugin when state should be shared or persisted through Redis.

Parameters

• url: Redis connection URL for the backend.
• keyPrefix: Prefix applied to Redis keys.

Returns

An adaptive backend spec using Redis storage.

Remarks

The default key prefix namespaces runtime records under nemo_relay: unless a different prefix is supplied.

1
export declare function redisBackend(url: string, keyPrefix?: string): BackendSpec;

telemetryConfig

Create adaptive telemetry settings with runtime defaults applied.

Merges caller-supplied overrides onto the built-in telemetry config shape used by the adaptive plugin.

Parameters

• config: Partial telemetry settings to override.

Returns

A normalized adaptive telemetry config object.

Remarks

An empty learners array is supplied by default so callers can append learner names without checking for initialization first.

1
export declare function telemetryConfig(config?: TelemetryConfig): TelemetryConfig;

adaptiveHintsConfig

Create adaptive hint-injection settings with defaults applied.

Merges caller-supplied overrides onto the default config used by the adaptive hints injector.

Parameters

• config: Partial adaptive hints settings to override.

Returns

A normalized adaptive hints config object.

Remarks

By default the injector runs at priority 100, preserves the rest of the chain, and writes hints to nvext.agent_hints.

1
export declare function adaptiveHintsConfig(config?: AdaptiveHintsConfig): AdaptiveHintsConfig;

toolParallelismConfig

Create adaptive tool-parallelism settings with defaults applied.

Merges caller-supplied overrides onto the scheduler config shape used by the adaptive plugin’s tool parallelism component.

Parameters

• config: Partial tool scheduling settings to override.

Returns

A normalized tool-parallelism config object.

Remarks

The default mode is observe_only, so recommendations are produced without changing execution behavior unless the caller opts in.

1
export declare function toolParallelismConfig(config?: ToolParallelismConfig): ToolParallelismConfig;

acgConfig

Create adaptive cache-governor settings with defaults applied.

Merges caller-supplied overrides onto the Adaptive Cache Governor (ACG) config shape used by the adaptive plugin’s LLM execution intercept.

Parameters

• config: Partial Adaptive Cache Governor (ACG) settings to override.

Returns

A normalized adaptive cache-governor config object.

Remarks

Nested stability_thresholds values are defaulted individually so callers can override only the thresholds they need.

1
export declare function acgConfig(config?: AcgConfig): AcgConfig;

ComponentSpec function

Wrap adaptive config as a top-level component.

Produces the plugin component entry that can be inserted directly into plugin.defaultConfig().components.

Parameters

• config: Adaptive component configuration document.
• options: Optional component-level flags.

Returns

A plugin component spec for the adaptive plugin.

Remarks

Setting options.enabled = false keeps the config in the plugin document for validation while skipping runtime activation.

1
export declare function ComponentSpec(
2
  config: Config,
3
  options?: {
4
    enabled?: boolean;

Constants

ADAPTIVE_PLUGIN_KIND

1
export declare const ADAPTIVE_PLUGIN_KIND: 'adaptive';

Re-exports

• ConfigDiagnostic
• ConfigPolicy
• ConfigReport