praval.app

Explicit application ownership for Praval runtimes.

Functions

get_default_app()	Return the default app that backs compatibility shims.
reset_default_app()	Reset the default app for tests.

Classes

PravalApp(*[, reef, provider_registry, ...])

Own agents and a Reef for explicit lifecycle cleanup.

class praval.app.PravalApp(*, reef=None, provider_registry=None, use_global_reef=False)

Bases: object

Own agents and a Reef for explicit lifecycle cleanup.

PravalApp does not isolate provider registries or redirect an agent’s Reef convenience methods in 0.8. Use it when explicit ownership and deterministic cleanup are useful, not as a dependency-injection boundary.

Parameters:

• reef (Optional[Reef])

• provider_registry (Optional[ProviderRegistry])

• use_global_reef (bool)

__init__(*, reef=None, provider_registry=None, use_global_reef=False)

Parameters:

• reef (Reef | None)

• provider_registry (ProviderRegistry | None)

• use_global_reef (bool)

Return type:

None

create_agent(name, **kwargs)

Create and retain an agent owned by this app.

Return type:

Agent

Parameters:

• name (str)

• kwargs (Any)

register_agent(agent)

Register an externally-created agent with this app.

Return type:

Agent

Parameters:

agent (Agent)

close()

Close all owned agents and the owned Reef when possible.

Return type:

None

praval.app.get_default_app()

Return the default app that backs compatibility shims.

Return type:

PravalApp

praval.app.reset_default_app()

Reset the default app for tests.

Return type:

PravalApp