DF0048: Unknown Shared-State Key

Message

Unknown shared-state key "{key}".

Cause

The built-in devframe_state_read MCP tool was called with a key the host doesn't publish (or that the exposeSharedState filter excludes).

Example

// The host publishes only `my-plugin:counter`; an agent calls:
// devframe_state_read({ key: 'my-plugin:cuonter' }) → DF0048

Fix

Call the devframe_state_read tool without arguments to list the available keys, then retry with one of them.

Source

• packages/devframe/src/adapters/mcp/build-server.ts: readStateResult() throws this when the requested key is absent from the filtered key list.