Skip to content

ResponsesHostServer — Checkpoint Deserialization Blocked for MessageRole Type / Restore Not Working as Expected #5810

@cs609

Description

@cs609

When using ResponsesHostServer, checkpoint reading fails with the following warning:

WARNING agent_framework._workflows.checkpoint: Failed to read checkpoint file
/.checkpoints/conv
.../....json: Failed to decode pickled checkpoint data:
Checkpoint deserialization blocked for type
'azure.ai.agentserver.responses.models._generated.sdk.models.models._enums:MessageRole'.
To allow this type, either include its 'module:qualname' key in the 'allowed_types' set
passed to 'decode_checkpoint_value', or add it to 'allowed_checkpoint_types' on your
checkpoint storage (e.g., 'FileCheckpointStorage.allowed_checkpoint_types').

The hosting infrastructure owns the checkpoint — specifically ResponsesHostServer from the agent_framework_foundry_hosting package.
The WorkflowAgent must not already have a checkpoint storage configured at startup, as the hosting infrastructure owns it. If one is present at startup, a RuntimeError is raised.

Current Status:

Checkpoint save (initialize, save, create) is observed working correctly via locally and in the Foundry playground.
Checkpoint restore is not working as expected — deserialization fails due to the blocked MessageRole type, preventing the agent from resuming state from a previously saved checkpoint.

Could the team please look into this issue and provide an update on when a fix can be expected?

Metadata

Metadata

Assignees

Labels

agent hostingIssues related to agent hosting

Type

No type
No fields configured for issues without a type.

Projects

Status

No status

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions