feat(beta): introduce dynamic_agent tool factory

[vvlrff]

Summary

Adds a new advanced tool in autogen.beta.tools.dynamic that lets an Agent's LLM assemble an agent at runtime from a JSON spec it produces — name, system prompt, a subset of available tools, and an optional response schema — and immediately run it on a single objective.

What the parent LLM sees

A single tool with a JSON-schema'd argument:

create_and_run_agent(
    spec={
        "name": "math_helper",
        "prompt": ["You are precise."],
        "tool_names": ["calc"],
    },
    objective="Compute compound interest for 5y at 7% on 10k.",
) -> str

The tool reuses the existing AgentSpec model as its input, so the parent LLM may also pass a response_schema to constrain the child agent's reply to a structured shape:

create_and_run_agent(
    spec={
        "name": "extractor",
        "prompt": ["Extract numeric answer."],
        "tool_names": [],
        "response_schema": {
            "name": "Answer",
            "json_schema": {
                "type": "object",
                "properties": {"answer": {"type": "integer"}},
                "required": ["answer"],
            },
        },
    },
    objective="Compute 2+2.",
) -> str

What the developer writes

from autogen.beta import Agent
from autogen.beta.tools.dynamic import dynamic_agent

orchestrator = Agent(
    "orchestrator",
    config=cfg,
    tools=[
        read_file,
        grep,
        dynamic_agent(
            available_tools=[calc, web_search],
            config=cfg,
        ),
    ],
)

[vvlrff]

@marklysze If the implementation is satisfactory, I will add documentation after approval.

[marklysze]

Very handy, thanks @vvlrff!

[codecov]

Codecov Report

❌ Patch coverage is 93.47826% with 3 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
autogen/beta/tools/dynamic/factory.py	88.88%	1 Missing and 2 partials ⚠️

Files with missing lines	Coverage Δ
autogen/beta/tools/dynamic/__init__.py	100.00% <100.00%> (ø)
autogen/beta/tools/dynamic/handler.py	100.00% <100.00%> (ø)
autogen/beta/tools/dynamic/factory.py	88.88% <88.88%> (ø)

... and 36 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.