DTK0056: Cannot Change Command ID

Message

Cannot change the id of a command. Use register() to add new commands.

Cause

The handle returned by ctx.commands.register(...) exposes an update(patch) method that intentionally rejects an id field — palette state, keybinding overrides, and the palette renderer all key off the id.

Fix

To rename a command, unregister the old one and register a new one. Otherwise, omit id from the patch:

const handle = ctx.commands.register({ id: 'my-plugin:run', title: 'Run', handler })
handle.update({ title: 'Run again' }) // ✓
handle.update({ id: 'renamed' }) // ✗ DTK0056

Source

• packages/kit/src/node/host-commands.ts — the update closure returned from register throws DTK0056 when the patch carries an id field.