feat(tools): @tool docstring required + optional params excluded from required

feat(tools): @tool decorator with auto-generated JSON Schema

feat(tools): _py_to_json_type handles Optional[X] / X | None

feat(tools): _py_to_json_type for primitive types (str/int/float/bool)

feat(scaffold): package skeleton + smoke test