entity.plugins.context module

class entity.plugins.context.WorkflowContext[source]

Bases: object

Simple context passed to plugins during execution.

__init__()[source]
Return type:

None

say(message)[source]

Store the final response only during the OUTPUT or ERROR stage.

Parameters:

message (str)

Return type:

None

property response: str | None

Return the response set by say().

class entity.plugins.context.PluginContext(resources, user_id)[source]

Bases: WorkflowContext

Extended context exposing memory and resources.

Parameters:

  • resources (Dict[str, Any])

  • user_id (str)

__init__(resources, user_id)[source]
Parameters:
Return type:

None

async log(level, category, message, **extra_fields)[source]

Log with automatic context injection.

Parameters:

  • level (LogLevel)

  • category (LogCategory)

  • message (str)

  • extra_fields (Any)

Return type:

None

async remember(key, value)[source]

Persist value namespaced by user_id.

Parameters:
Return type:

None

async recall(key, default=None)[source]

Retrieve stored value for key or default.

Parameters:

  • key (str)

  • default (Any | None)

Return type:

Any

say(message)[source]

Store the final response only during the OUTPUT or ERROR stage.

Parameters:

message (str)

Return type:

None

async load_state()[source]

Load persistent conversation state.

Return type:

None

async flush_state()[source]

Persist conversation state.

Return type:

None

listen()[source]

Return the last user message.

Return type:

str | None

conversation()[source]

Return conversation history including outputs.

Return type:

List[str]

get_resource(name)[source]

Return a resource by name.

Parameters:

name (str)

Return type:

Any

async tool_use(name, **kwargs)[source]

Execute a registered tool immediately using the sandbox.

Parameters:
Return type:

Any

queue_tool_use(name, **kwargs)[source]

Add a tool call to be executed later.

Parameters:
Return type:

None

async run_tool_queue()[source]

Execute all queued tools in order.

Return type:

None

discover_tools(**filters)[source]

Return registered tools filtered by filters.

Parameters:

filters (Any)