Skip to content

Command Palette Module incompatible with Directus 11.10.x - Zod v3/v4 version conflict #232

@invisible1988

Description

@invisible1988

Extension

Command Palette Module

Describe the Bug

The @directus-labs/command-palette-module extension causes Directus 11.10.x to crash on startup due to a Zod version incompatibility. The extension uses Zod v3.23.8 while Directus 11.10.x requires Zod v4.0.14, causing a runtime error in the websocket module.

Environment

  • Directus Version: 11.10.1 and 11.10.2 (tested both)
  • Extension Version: @directus-labs/[email protected]
  • Node Version: v22.18.0
  • Installation Method: Docker with pnpm

Expected Behavior

The command palette module should work with Directus 11.10.x without causing crashes.

Actual Behavior

Directus crashes with the following error:

file:///directus/node_modules/.pnpm/[email protected]/node_modules/zod/v4/core/schemas.js:865
const first = def.options[0]._zod.run;
^

TypeError: Cannot read properties of undefined (reading 'run')
at file:///directus/node_modules/.pnpm/[email protected]/node_modules/zod/v4/core/schemas.js:865:39
at Function.init (file:///directus/node_modules/.pnpm/[email protected]/node_modules/zod/v4/core/core.js:14:9)
at Module.discriminatedUnion (file:///directus/node_modules/.pnpm/[email protected]/node_modules/zod/v4/classic/schemas.js:561:12)
at file:///directus/node_modules/.pnpm/@directus+api@file+api_@[email protected][email protected]/node_modules/@directus/api/dist/websocket/messages.js:4:36

Root Cause Analysis

The issue is caused by a major version mismatch:

To Reproduce

  1. Install Directus 11.10.2
  2. Install @directus-labs/command-palette-module via pnpm
  3. Start Directus
  4. Directus crashes immediately on startup

Directus Version

11.10.x

Hosting Strategy

Self-Hosted (Docker Image)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions