Skip to content

Interface: DevServerConfig

Defined in: packages/core/src/server/DevServer.ts:67

Configuration for the development server.

Properties

debounce?

ts
readonly optional debounce: number;

Defined in: packages/core/src/server/DevServer.ts:85

Debounce interval in milliseconds. Prevents rapid-fire reloads when editors save multiple files.

Default

ts
300

dir

ts
readonly dir: string;

Defined in: packages/core/src/server/DevServer.ts:72

Directory to watch for file changes. Relative paths are resolved from the current working directory.


extensions?

ts
readonly optional extensions: string[];

Defined in: packages/core/src/server/DevServer.ts:78

File extension filter for watched files.

Default

ts
['.ts', '.js', '.mjs', '.mts']

onReload()?

ts
readonly optional onReload: (changedFile) => void;

Defined in: packages/core/src/server/DevServer.ts:102

Optional callback when a reload occurs. Useful for logging or triggering downstream updates.

Parameters

ParameterType
changedFilestring

Returns

void


server?

ts
readonly optional server: McpServerLike;

Defined in: packages/core/src/server/DevServer.ts:109

Optional MCP server reference for sending tool list change notifications. When provided, the dev server sends notifications/tools/list_changed on every reload, so the LLM client picks up changes automatically.


setup()

ts
readonly setup: (registry) => void | Promise<void>;

Defined in: packages/core/src/server/DevServer.ts:96

Setup callback invoked on every reload.

Receives a fresh ToolRegistry. The callback should:

  1. Import/define all tools
  2. Register them on the registry

This is called on initial startup and on every file change.

Parameters

ParameterType
registryToolRegistryLike

Returns

void | Promise<void>