SandboxFactory

Bases: Protocol

Per-call producer of a :class:Sandbox.

A factory is the only place :class:~autogen.beta.annotations.Variable parameters get resolved — backends themselves receive concrete values only. This isolates Variable / Context concerns from the execution surface.

Implementations return an async context manager so the underlying backend's lifecycle (container start / stop, remote sandbox creation / deletion) is explicit on every call.

open(context=None)

29
30
31
32
33
34
35
36
37
38
39

def open(
    self,
    context: "ConversationContext | None" = None,
) -> AbstractAsyncContextManager[Sandbox]:
    """Open a sandbox bound to ``context``.

    Variables registered on the factory (image, env_vars, credentials,
    …) are resolved against ``context.variables`` here. Backends that
    do not need Variables can ignore ``context``.
    """
    ...