Skip to main content

Type Alias: WunderlandOptions

WunderlandOptions = object

Defined in: .source/wunderland/src/public/types.ts:113

Properties​

adaptiveExecution?​

optional adaptiveExecution?: WunderlandAdaptiveExecutionConfig

Defined in: .source/wunderland/src/public/types.ts:219

Runtime adaptive execution controls.

agentConfig?​

optional agentConfig?: WunderlandAgentConfig

Defined in: .source/wunderland/src/public/types.ts:115

Direct config object (control-plane).

approvals?​

optional approvals?: object

Defined in: .source/wunderland/src/public/types.ts:185

mode?​

optional mode?: WunderlandApprovalsMode

Default: 'deny-side-effects'

onRequest?​

optional onRequest?: (req) => Promise<boolean>

Called only for side-effect tools when mode='custom'. Return true to allow execution.

Parameters​
req​

ToolApprovalRequest

Returns​

Promise<boolean>

configDirOverride?​

optional configDirOverride?: string

Defined in: .source/wunderland/src/public/types.ts:121

Override the global Wunderland config directory used for env/config/usage storage.

configPath?​

optional configPath?: string

Defined in: .source/wunderland/src/public/types.ts:117

Optional path to agent.config.json (resolved relative to workingDirectory).

discovery?​

optional discovery?: WunderlandDiscoveryConfig

Defined in: .source/wunderland/src/public/types.ts:208

Capability discovery configuration.

extensions?​

optional extensions?: object

Defined in: .source/wunderland/src/public/types.ts:175

Extension sources (merged with preset extensions if both provided). Extensions are resolved from @framers/agentos-extensions-registry.

overrides?​

optional overrides?: Record<string, { enabled?: boolean; options?: unknown; priority?: number; }>

Per-extension overrides (enabled, priority, options).

productivity?​

optional productivity?: string[]

Productivity extension names (e.g. ['calendar-google', 'email-gmail']).

tools?​

optional tools?: string[]

Tool extension names (e.g. ['web-search', 'web-browser', 'giphy']).

voice?​

optional voice?: string[]

Voice provider extension names (e.g. ['speech-runtime', 'voice-synthesis']).

llm?​

optional llm?: Partial<{ apiKey: string; baseUrl?: string; fallback?: LLMProviderConfig; model: string; providerId: WunderlandProviderId | string; }>

Defined in: .source/wunderland/src/public/types.ts:125

LLM configuration (apiKey/model default from env when omitted).

logger?​

optional logger?: object

Defined in: .source/wunderland/src/public/types.ts:201

debug?​

optional debug?: (msg, meta?) => void

Parameters​
msg​

string

meta?​

unknown

Returns​

void

error?​

optional error?: (msg, meta?) => void

Parameters​
msg​

string

meta?​

unknown

Returns​

void

info?​

optional info?: (msg, meta?) => void

Parameters​
msg​

string

meta?​

unknown

Returns​

void

warn?​

optional warn?: (msg, meta?) => void

Parameters​
msg​

string

meta?​

unknown

Returns​

void

memory?​

optional memory?: generateText | generateText

Defined in: .source/wunderland/src/public/types.ts:200

Optional cognitive memory facade or raw cognitive memory manager. When provided, Wunderland exposes it on the returned app.

preset?​

optional preset?: string

Defined in: .source/wunderland/src/public/types.ts:153

Load a preset by ID — auto-configures tools, skills, extensions, and personality. Preset values are merged with explicit tools, skills, and extensions options (explicit options take precedence).

Example​

preset: 'research-assistant'

skills?​

optional skills?: "all" | string[] | { dirs?: string[]; includeDefaults?: boolean; names?: string[]; }

Defined in: .source/wunderland/src/public/types.ts:160

Skill sources (merged with preset skills if both provided):

  • 'all': all curated skills for the current platform
  • string[]: skill names from the curated registry
  • object: fine-grained control over skill loading

Union Members​

"all"

string[]

Type Literal​

{ dirs?: string[]; includeDefaults?: boolean; names?: string[]; }

dirs?​

optional dirs?: string[]

Additional skill directories to scan.

includeDefaults?​

optional includeDefaults?: boolean

Scan default dirs (./skills, ~/.codex/skills) — default: true.

names?​

optional names?: string[]

Curated skill names to load.

taskOutcomeTelemetry?​

optional taskOutcomeTelemetry?: WunderlandTaskOutcomeTelemetryConfig

Defined in: .source/wunderland/src/public/types.ts:217

Runtime task-outcome telemetry controls.

toolCalling?​

optional toolCalling?: object

Defined in: .source/wunderland/src/public/types.ts:210

Tool-calling behavior controls.

strictToolNames?​

optional strictToolNames?: boolean

Enforce strict OpenAI function names and fail when rewrites/collisions are needed.

toolFailureMode?​

optional toolFailureMode?: WunderlandToolFailureMode

Defined in: .source/wunderland/src/public/types.ts:215

Default tool-call failure behavior.

tools?​

optional tools?: "none" | "lazy" | "curated" | { curated?: ToolRegistryConfig; custom?: generateText[]; }

Defined in: .source/wunderland/src/public/types.ts:139

Tool sources:

  • 'none': no tools (pure chat)
  • 'lazy': meta tools only — agent discovers & enables packs on demand (default)
  • 'curated': curated tool packs eagerly loaded (requires optional deps)
  • object: curated + custom tools

userId?​

optional userId?: string

Defined in: .source/wunderland/src/public/types.ts:195

Optional default userId for guardrails/audit context.

workingDirectory?​

optional workingDirectory?: string

Defined in: .source/wunderland/src/public/types.ts:119

Defaults to process.cwd()

workspace?​

optional workspace?: Partial<WunderlandWorkspace>

Defined in: .source/wunderland/src/public/types.ts:123

Workspace location for tool execution state.