Skip to content

Tool Registration Silently Fails When Tool Module has Import/Runtime Rrrors #20

@MFA-X-AI

Description

@MFA-X-AI

If a tool definition has an error during import (e.g., bad import) the framework continues without registering the tool and shows no warning or error. This makes misconfigurations easy to miss.

Steps to Reproduce

  1. Start from the “Advanced Orchestration” example: https://xaibo.ai/tutorial/advanced-orchestration/
  2. In a tool module, introduce an import error (e.g. typo import request instead of requests) or raise an exception at module import time.
  3. Run the agent and load/register the tool per the docs.
# tools/example.py
import request  # typo to trigger ImportError

def run(x: str) -> str:
    return x

Expected Behavior

  • The framework should surface the failure:

    • Fail-fast: raise with a clear traceback and which tool/module failed, or
    • Warn: log at ERROR/WARN level that the tool was skipped, including the exception and module path.
  • Option to run in strict=True mode to make any tool registration failure fatal.

Actual Behavior

  • No error or warning is emitted.
  • The tool simply isn’t registered (and the agent runs without it).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions